NAME

       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

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                     AGGETC(3NCARG)