1AGSETP(3NCARG) NCAR GRAPHICS AGSETP(3NCARG)
2
6 AGSETP - Allows a user program to reset the values of a group of
7 parameters containing one or more elements.
8
10 CALL AGSETP (TPGN,FURA,LURA)
11
13 #include <ncarg/ncargC.h>
14 void c_agsetp (char *tpgn, float *fura, int lura)
16
18 TPGN (an input expression of type CHARACTER) is a character
19 string of the form 'k1/k2/ . . . kn.', where each of the
20 ki's is a keyword. The keyword k1 specifies a group of
21 parameters, k2 a subgroup of that group, k3 a subgroup of
22 that subgroup, etc. The whole string is the name of some
23 group of parameters the user wishes to set.
24 For example, 'AXIS.' is the name of a 92-word group of
26 parameters describing the four axes, 'AXIS/RIGHT.' is the
27 name of a 23-word subgroup describing the right Y axis,
28 'AXIS/RIGHT/INTERSECTION.'
30 is the name of a 2-word further subgroup describing the
32 intersection of the right Y axis with the bottom of the
33 grid window, and
34 'AXIS/RIGHT/INTERSECTION/USER.'
36 is the name of a single parameter specifying the point of
38 intersection of the right Y axis with the bottom of the
39 grid window as an X coordinate in the user coordinate
40 system.
41 Obviously, these names can sometimes become rather long.
43 There are various ways in which they may be shortened.
44 First, since the fifth and following characters of each
45 keyword are ignored, they may be omitted; this would
46 shorten
47 'AXIS/RIGHT/INTERSECTION/USER.'
49 to
51 'AXIS/RIGH/INTE/USER.'
53 Even fewer characters may be used, as long as no ambiguity
55 of interpretation arises. To be completely safe, use at
56 least the first three characters of the group keyword and
57 at least the first two characters of each subgroup keyword;
58 this would shorten the example above to 'AXI/RI/IN/US.'.
59 Moreover, certain group and subgroup keywords may be
60 omitted entirely; for example, 'AXI/RI/IN/US.' may be
61 shortened to 'RI/IN/US.'. Keywords which may be entirely
62 omitted are enclosed in brackets in the headings in the
63 section "PARAMETERS".
64 Names may also be lengthened in various ways in order to
66 improve their readability. Blanks may be used as desired on
67 either side of a keyword. Any sequence of characters not
68 including a slash or a period may be inserted after a
69 keyword, separated from it by at least one blank. For
70 example, the name
71 'DASH PATTERN / CHARACTER WIDTH .'
73 is equivalent to, and considerably more meaningful than,
75 'DAS/CH.' (or even 'DASH/CHARACTER.')
77 FURA (an input array of type REAL, dimensioned LURA) contains
80 new values for the parameters in the group specified by
81 TPGN, in the same order as they appear in the group. All
82 parameters have real values (because of a portability
83 problem which arose in implementing the routines AGSETF and
84 AGSETR). Those which represent intrinsically integral
85 quantities have a value of the form "FLOAT(n)", where "n"
86 is the integral quantity being represented. Some parameters
87 intrinsically take on character-string values; the real
88 quantity stored as the value of such a parameter is
89 typically an identifier allowing for later retrieval of the
90 character string from a character storage area inside
91 Autograph. The routines AGSETC and AGGETC may be used to
92 set/get the character-string values of such parameters.
93 LURA (an input expression of type INTEGER) is the length of FURA
95 (the number of real elements in it). Its value may be less
96 than, equal to, or greater than, the length of the
97 parameter group specified by TPGN. The number of values
98 transferred from FURA is the minimum of the two (but not
99 less than one). This means that if, for example, you only
100 wish to set the first two parameters of a 100-parameter
101 group, you may do so by using LURA = 2.
102
104 The C-binding argument descriptions are the same as the FORTRAN
105 argument descriptions.
106
108 This routine allows you to set the current value of Autograph
109 parameters. For a complete list of parameters available in this
110 utility, see the autograph_params man page.
111
113 Use the ncargex command to see the following relevant example: agex06.
114
116 To use AGSETP or c_agsetp, load the NCAR Graphics libraries ncarg,
117 ncarg_gks, and ncarg_c, preferably in that order. To get smoother
118 curves, drawn using spline interpolation, also load libdashsmth.o. Or,
119 you can use the ncargf77 command to compile your program and load the
120 above libraries, then, to get smoother curves, use the -dashsmth
121 option.
122
124 See the autograph man page for a description of all Autograph error
125 messages and/or informational messages.
126
128 Online: autograph, autograph_params, agback, agbnch, agchax, agchcu,
129 agchil, agchnl, agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr,
130 agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetr, agstup, agutol,
131 anotat, displa, ezmxy, ezmy, ezxy, ezy
132 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
134
136 Copyright (C) 1987-2007
137 University Corporation for Atmospheric Research
138 This documentation is free software; you can redistribute it and/or
140 modify it under the terms of the GNU General Public License as
141 published by the Free Software Foundation; either version 2 of the
142 License, or (at your option) any later version.
143 This software is distributed in the hope that it will be useful, but
145 WITHOUT ANY WARRANTY; without even the implied warranty of
146 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
147 General Public License for more details.
148 You should have received a copy of the GNU General Public License along
150 with this software; if not, write to the Free Software Foundation,
151 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
152UNIX March 1993 AGSETP(3NCARG)