AGSETC - Allows a user program to (in effect) store a character string as the value of a specified single
Contents
Access
To use AGSETC or c_agsetc, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in
that order. To get smoother curves, drawn using spline interpolation, also load libdashsmth.o. Or, you
can use the ncargf77 command to compile your program and load the above libraries, then, to get smoother
curves, use the -dashsmth option.
C-Binding Description
The C-binding argument descriptions are the same as the FORTRAN argument descriptions.
C-Binding Synopsis
#include <ncarg/ncargC.h>
void c_agsetc (char *tpgn, char *cusr)
Copyright
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
UNIX March 1993 AGSETC(3NCARG)
Description
TPGN (an input expression of type CHARACTER) is a parameter identifier, as described for AGSETP,
above. The specified parameter must be one of those which intrinsically have values of type
character: 'LINE/END.', 'LABEL/NAME.', 'LINE/ TEXT.', or 'DASH/PATTERN/n.'
CUSR (an input expression of type CHARACTER) is the desired character string.
• If 'LINE/END.' is being set, only the first character of CUSR will be used.
• If 'LABEL/NAME.' is being set, the length of the string CUSR will be taken to be
"MAX(1,LEN(CUSR))".
• If the text of a label is being set, CUSR must either be of the exact length specified
by 'LINE/MAXIMUM.' (40 characters, by default) or shorter; if shorter, it must be
terminated by the character defined by 'LINE/END.' (default: a '$').
• If a dash pattern is being set, the length of CUSR will be taken to be the minimum of
"LEN(CUSR)" and the value specified by 'DASH/LENGTH.'.
Examples
Use the ncargex command to see the following relevant examples: agex05, agex06, agex07, agex08, agex09,
agex13, tagupw, tautog, fagaxlbl, fagovrvw.
Messages
See the autograph man page for a description of all Autograph error messages and/or informational
messages.
Name
AGSETC - Allows a user program to (in effect) store a character string as the value of a specified single
parameter.
See Also
Online: autograph, autograph_params, agback, agbnch, agchax, agchcu, agchil, agchnl, agcurv, agdshn,
aggetc, aggetf, aggeti, aggetp, aggetr, agpwrt, agrstr, agsave, agsetf, agseti, agsetp, agsetr, agstup,
agutol, anotat, displa, ezmxy, ezmy, ezxy, ezy
Hardcopy: NCAR Graphics Fundamentals, UNIX Version
Synopsis
CALL AGSETC (TPGN,CUSR)
Usage
This routine allows you to set the current value of Autograph parameters. For a complete list of
parameters available in this utility, see the autograph_params man page.
