1AGSETC(3NCARG) NCAR GRAPHICS AGSETC(3NCARG)
2
6 AGSETC - Allows a user program to (in effect) store a character string
7 as the value of a specified single parameter.
8
10 CALL AGSETC (TPGN,CUSR)
11
13 #include <ncarg/ncargC.h>
14 void c_agsetc (char *tpgn, char *cusr)
16
18 TPGN (an input expression of type CHARACTER) is a parameter
19 identifier, as described for AGSETP, above. The specified
20 parameter must be one of those which intrinsically have
21 values of type character: 'LINE/END.', 'LABEL/NAME.',
22 'LINE/ TEXT.', or 'DASH/PATTERN/n.'
23 CUSR (an input expression of type CHARACTER) is the desired
25 character string.
26 · If 'LINE/END.' is being set, only the first
28 character of CUSR will be used.
29 · If 'LABEL/NAME.' is being set, the length of the
31 string CUSR will be taken to be "MAX(1,LEN(CUSR))".
32 · If the text of a label is being set, CUSR must
34 either be of the exact length specified by
35 'LINE/MAXIMUM.' (40 characters, by default) or
36 shorter; if shorter, it must be terminated by the
37 character defined by 'LINE/END.' (default: a '$').
38 · If a dash pattern is being set, the length of CUSR
40 will be taken to be the minimum of "LEN(CUSR)" and
41 the value specified by 'DASH/LENGTH.'.
42
44 The C-binding argument descriptions are the same as the FORTRAN
45 argument descriptions.
46
48 This routine allows you to set the current value of Autograph
49 parameters. For a complete list of parameters available in this
50 utility, see the autograph_params man page.
51
53 Use the ncargex command to see the following relevant examples: agex05,
54 agex06, agex07, agex08, agex09, agex13, tagupw, tautog, fagaxlbl,
55 fagovrvw.
56
58 To use AGSETC or c_agsetc, load the NCAR Graphics libraries ncarg,
59 ncarg_gks, and ncarg_c, preferably in that order. To get smoother
60 curves, drawn using spline interpolation, also load libdashsmth.o. Or,
61 you can use the ncargf77 command to compile your program and load the
62 above libraries, then, to get smoother curves, use the -dashsmth
63 option.
64
66 See the autograph man page for a description of all Autograph error
67 messages and/or informational messages.
68
70 Online: autograph, autograph_params, agback, agbnch, agchax, agchcu,
71 agchil, agchnl, agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr,
72 agpwrt, agrstr, agsave, agsetf, agseti, agsetp, agsetr, agstup, agutol,
73 anotat, displa, ezmxy, ezmy, ezxy, ezy
74 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
76
78 Copyright (C) 1987-2007
79 University Corporation for Atmospheric Research
80 This documentation is free software; you can redistribute it and/or
82 modify it under the terms of the GNU General Public License as
83 published by the Free Software Foundation; either version 2 of the
84 License, or (at your option) any later version.
85 This software is distributed in the hope that it will be useful, but
87 WITHOUT ANY WARRANTY; without even the implied warranty of
88 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
89 General Public License for more details.
90 You should have received a copy of the GNU General Public License along
92 with this software; if not, write to the Free Software Foundation,
93 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
94UNIX March 1993 AGSETC(3NCARG)