NAME

       AGSETP - Allows a user program to reset the values of a group of parameters containing one or more
       elements.

SYNOPSIS

       CALL AGSETP (TPGN,FURA,LURA)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_agsetp (char *tpgn, float *fura, int lura)

DESCRIPTION

       TPGN        (an input expression of type CHARACTER) is a character string of the form 'k1/k2/ . . . kn.',
                   where  each  of  the  ki's is a keyword. The keyword k1 specifies a group of parameters, k2 a
                   subgroup of that group, k3 a subgroup of that subgroup, etc. The whole string is the name  of
                   some group of parameters the user wishes to set.

                   For  example,  'AXIS.' is the name of a 92-word group of parameters describing the four axes,
                   'AXIS/RIGHT.' is the name of a 23-word subgroup describing the right Y axis,

                        'AXIS/RIGHT/INTERSECTION.'

                   is the name of a 2-word further subgroup describing the intersection of the right Y axis with
                   the bottom of the grid window, and

                        'AXIS/RIGHT/INTERSECTION/USER.'

                   is the name of a single parameter specifying the point of intersection of the  right  Y  axis
                   with the bottom of the grid window as an X coordinate in the user coordinate system.

                   Obviously,  these  names  can  sometimes become rather long.  There are various ways in which
                   they may be shortened.  First, since the fifth and following characters of each  keyword  are
                   ignored, they may be omitted; this would shorten

                        'AXIS/RIGHT/INTERSECTION/USER.'

                   to

                        'AXIS/RIGH/INTE/USER.'

                   Even  fewer  characters  may be used, as long as no ambiguity of interpretation arises. To be
                   completely safe, use at least the first three characters of the group keyword  and  at  least
                   the  first  two  characters of each subgroup keyword; this would shorten the example above to
                   'AXI/RI/IN/US.'.  Moreover, certain group and subgroup keywords may be omitted entirely;  for
                   example,  'AXI/RI/IN/US.'  may  be  shortened  to 'RI/IN/US.'. Keywords which may be entirely
                   omitted are enclosed in brackets in the headings in the section "PARAMETERS".

                   Names may also be lengthened in various ways in order to improve  their  readability.  Blanks
                   may  be used as desired on either side of a keyword. Any sequence of characters not including
                   a slash or a period may be inserted after a keyword, separated from it by at least one blank.
                   For example, the name

                        'DASH PATTERN / CHARACTER WIDTH .'

                   is equivalent to, and considerably more meaningful than,

                        'DAS/CH.' (or even 'DASH/CHARACTER.')

       FURA        (an input array of type REAL, dimensioned LURA) contains new values for the parameters in the
                   group specified by TPGN, in the same order as they appear in the group. All  parameters  have
                   real values (because of a portability problem which arose in implementing the routines AGSETF
                   and AGSETR). Those which represent intrinsically integral quantities have a value of the form
                   "FLOAT(n)",   where   "n"  is  the  integral  quantity  being  represented.  Some  parameters
                   intrinsically take on character-string values; the real quantity stored as the value of  such
                   a  parameter  is typically an identifier allowing for later retrieval of the character string
                   from a character storage area inside Autograph. The routines AGSETC and AGGETC may be used to
                   set/get the character-string values of such parameters.

       LURA        (an input expression of type INTEGER) is the length of FURA (the number of real  elements  in
                   it). Its value may be less than, equal to, or greater than, the length of the parameter group
                   specified  by TPGN. The number of values transferred from FURA is the minimum of the two (but
                   not less than one). This means that if, for example, you only  wish  to  set  the  first  two
                   parameters of a 100-parameter group, you may do so by using LURA = 2.

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 example: agex06.

ACCESS

       To use AGSETP or c_agsetp, 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, agsetc, agsetf, agseti, 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                                     AGSETP(3NCARG)