1AGGETC(3NCARG) NCAR GRAPHICS AGGETC(3NCARG)
2
3
4
6 AGGETC - Allows a user program to retrieve (in effect) the character-
7 string values of certain single parameters.
8
10 CALL AGGETC (TPGN,CUSR)
11
13 #include <ncarg/ncargC.h>
14
15 void c_aggetc (char *tpgn, char *cusr, int len)
16
18 TPGN (an input expression of type CHARACTER) is a parameter
19 identifier, as described for AGGETP, 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
24 CUSR (an output variable of type CHARACTER) receives the desired
25 character string. If CUSR is too short, only the beginning
26 of the string will be put in it. If CUSR is too long, it
27 will be padded with blanks on the end.
28
30 The C-binding argument descriptions are the same as the FORTRAN
31 argument descriptions with the following exception:
32
33 len The size of cusr as dimensioned in the calling program.
34
36 This routine allows you to retrieve the current value of Autograph
37 parameters. For a complete list of parameters available in this
38 utility, see the autograph_params man page.
39
41 To use AGGETC or c_aggetc, load the NCAR Graphics libraries ncarg,
42 ncarg_gks, and ncarg_c, preferably in that order. To get smoother
43 curves, drawn using spline interpolation, also load libdashsmth.o. Or,
44 you can use the ncargf77 command to compile your program and load the
45 above libraries, then, to get smoother curves, use the -dashsmth
46 option.
47
49 See the autograph man page for a description of all Autograph error
50 messages and/or informational messages.
51
53 Online: autograph, autograph_params, agback, agbnch, agchax, agchcu,
54 agchil, agchnl, agcurv, agdshn, aggetf, aggeti, aggetp, aggetr, agpwrt,
55 agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup, agutol,
56 anotat, displa, ezmxy, ezmy, ezxy, ezy
57
58 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
59
61 Copyright (C) 1987-2007
62 University Corporation for Atmospheric Research
63
64 This documentation is free software; you can redistribute it and/or
65 modify it under the terms of the GNU General Public License as
66 published by the Free Software Foundation; either version 2 of the
67 License, or (at your option) any later version.
68
69 This software is distributed in the hope that it will be useful, but
70 WITHOUT ANY WARRANTY; without even the implied warranty of
71 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
72 General Public License for more details.
73
74 You should have received a copy of the GNU General Public License along
75 with this software; if not, write to the Free Software Foundation,
76 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
77
78
79
80UNIX March 1993 AGGETC(3NCARG)