ncl_aggetc man page

AGGETC — Allows a user program to retrieve (in effect) the character-string values of certain single parameters.

Synopsis

CALL AGGETC (TPGN,CUSR)

C-Binding Synopsis

#include <ncarg/ncargC.h>

void c_aggetc (char *tpgn, char *cusr, int len)

Description

TPGN
(an input expression of type CHARACTER) is a parameter identifier, as described for AGGETP, 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 output variable of type CHARACTER) receives the desired character string. If CUSR is too short, only the beginning of the string will be put in it. If CUSR is too long, it will be padded with blanks on the end.

C-Binding Description

The C-binding argument descriptions are the same as the FORTRAN argument descriptions with the following exception:

len
The size of cusr as dimensioned in the calling program.

Usage

This routine allows you to retrieve the current value of Autograph parameters. For a complete list of parameters available in this utility, see the autograph_params man page.

Access

To use AGGETC or c_aggetc, 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.

Messages

See the autograph man page for a description of all Autograph error messages and/or informational messages.

See Also

Online: autograph, autograph_params, agback, agbnch, agchax, agchcu, agchil, agchnl, agcurv, agdshn, aggetf, aggeti, aggetp, aggetr, agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup, agutol, anotat, displa, ezmxy, ezmy, ezxy, ezy

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

Info

March 1993 UNIX NCAR GRAPHICS