NAME

       AGSETC - Allows a user program to (in effect) store a character string as the value of a specified single
       parameter.

SYNOPSIS

       CALL AGSETC (TPGN,CUSR)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_agsetc (char *tpgn, char *cusr)

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.'.

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

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.

EXAMPLES

       Use  the  ncargex command to see the following relevant examples: agex05, agex06, agex07, agex08, agex09,
       agex13, tagupw, tautog, fagaxlbl, fagovrvw.

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.

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,
       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

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)