NAME

       ANOTAT - Changes the values of certain primary control parameters, purportedly having to
       do with "annotation" of a graph.

SYNOPSIS

       ANOTAT (XLAB,YLAB,LBAC,LSET,NDSH,DSHC)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_anotat(char *xlab, char *ylab, int lbac, int lset, \
       int ndsh, char *dshc[])

DESCRIPTION

       XLAB        (an input expression of type CHARACTER) defines a new "x-axis label". (If the
                   first character of this expression is "CHAR(0)", no new "x-axis label" is
                   defined; the current one will continue to be used.) A character string
                   defining a new X-axis label must either be of the exact length specified by
                   the current value of 'LINE/MAXIMUM.' (default: 40 characters), or shorter; if
                   shorter, it must be terminated by the character defined by the current value
                   of 'LINE/END.' (default: a '$'). The string becomes the new text of line
                   number -100 of the label 'B'.

       YLAB        (an input expression of type CHARACTER) defines a new "y-axis label". (If the
                   first character of this expression is "CHAR(0)", no new "y-axis label" is
                   defined; the current one will continue to be used.) A character string
                   defining a new Y-axis label must either be of the exact length specified by
                   the current value of 'LINE/MAXIMUM.' (default: 40 characters), or shorter; if
                   shorter, it must be terminated by the character defined by the current value
                   of 'LINE/END.' (default: a '$'). The string becomes the new text of line
                   number 100 of the label 'L'.

       LBAC        (an input expression of type INTEGER), if non-zero, must have the integer
                   value 1, 2, 3, or 4, the real equivalent of which is to become the new value
                   of 'BACKGROUND.'. (If LBAC is zero, no change is to be made in the current
                   value.)  The value "1" specifies a perimeter background, the value "2" a grid
                   background, the value "3" a half-axis background, and the value "4" no
                   background at all.

                   See the discussion of 'BACKGROUND.', in the autograph_params man page.

       LSET        (an input expression of type INTEGER), if non-zero, must have the absolute
                   value 1, 2, 3, or 4, the real equivalent of which is to be stored (by means of
                   a call to AGSETI) as the new value of 'SET.'. If LSET is zero, no change is to
                   be made in the current value of 'SET.'.

                   See the discussion of 'SET.', in the autograph_params man page.

       NDSH        (an input expression of type INTEGER), if zero, specifies that no change is to
                   be made in the parameters which specify the dashed-line patterns to be used
                   for curves.

                   •      If NDSH is non-zero, it specifies an integer value whose real
                          equivalent is to be stored as the new value of 'DASH/ SELECTOR.' (which
                          has the default value "1.").

                   •      If NDSH is negative, 'DASH/SELECTOR.' is set negative, forcing EZMY and
                          EZMXY to use internally-defined "alphabetic" patterns for the MANY
                          curves drawn ("A" for the first, "B" for the second, . . ., "Z" for the
                          26th, "A" for the 27th, etc.). The routines EZY and EZXY are
                          unaffected.

                   •      If NDSH is greater than zero, it must be less than or equal to 26, and
                          the next argument, DSHC, must contain NDSH dashed-line patterns
                          comprising the new "user" set of patterns. The fact that
                          'DASH/SELECTOR.' is set positive forces EZMY and EZMXY to use this set
                          of patterns. (The routines EZY and EZXY always use the first pattern in
                          this set.)  The contents of the array DSHC are copied to storage local
                          to Autograph and pointers to them are installed as the values of
                          'DASH/PATTERNS/1.', '.../2.', etc.

                   See the discussion of 'DASH.', in the autograph_params man page.

       DSHC        (an input array of type CHARACTER, dimensioned NDSH) is meaningful only when
                   NDSH is greater than zero. In this case, it must be an array of NDSH character
                   strings, each of the length specified by the current value of 'DASH/ LENGTH.'.
                   Each character string represents a dashed-line pattern; dollar signs mean "pen
                   down", quotes mean "pen up", and other characters mean "draw me".

                   See the discussion of 'DASH.', in the autograph_params man page.

C-BINDING DESCRIPTION

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

USAGE

       This routine sets internal parameter values.  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: agex08, agex10, agex13,
       bnchmk, sprevx.

ACCESS

       To use ANOTAT or c_anotat, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c,
       preferably in that order.

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, agsetp, agsetr, agstup, agutol, displa, ezmxy, ezmy, ezxy, ezy

COPYRIGHT

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