1ANOTAT(3NCARG)                   NCAR GRAPHICS                  ANOTAT(3NCARG)
2
3
4

NAME

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

SYNOPSIS

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

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_anotat(char *xlab, char *ylab, int lbac, int lset, \
16       int ndsh, char *dshc[])
17

DESCRIPTION

19       XLAB        (an input expression of type CHARACTER) defines a new "x-
20                   axis label". (If the first character of this expression is
21                   "CHAR(0)", no new "x-axis label" is defined; the current
22                   one will continue to be used.) A character string defining
23                   a new X-axis label must either be of the exact length
24                   specified by the current value of 'LINE/MAXIMUM.' (default:
25                   40 characters), or shorter; if shorter, it must be
26                   terminated by the character defined by the current value of
27                   'LINE/END.' (default: a '$'). The string becomes the new
28                   text of line number -100 of the label 'B'.
29
30       YLAB        (an input expression of type CHARACTER) defines a new "y-
31                   axis label". (If the first character of this expression is
32                   "CHAR(0)", no new "y-axis label" is defined; the current
33                   one will continue to be used.) A character string defining
34                   a new Y-axis label must either be of the exact length
35                   specified by the current value of 'LINE/MAXIMUM.' (default:
36                   40 characters), or shorter; if shorter, it must be
37                   terminated by the character defined by the current value of
38                   'LINE/END.' (default: a '$'). The string becomes the new
39                   text of line number 100 of the label 'L'.
40
41       LBAC        (an input expression of type INTEGER), if non-zero, must
42                   have the integer value 1, 2, 3, or 4, the real equivalent
43                   of which is to become the new value of 'BACKGROUND.'. (If
44                   LBAC is zero, no change is to be made in the current
45                   value.)  The value "1" specifies a perimeter background,
46                   the value "2" a grid background, the value "3" a half-axis
47                   background, and the value "4" no background at all.
48
49                   See the discussion of 'BACKGROUND.', in the
50                   autograph_params man page.
51
52       LSET        (an input expression of type INTEGER), if non-zero, must
53                   have the absolute value 1, 2, 3, or 4, the real equivalent
54                   of which is to be stored (by means of a call to AGSETI) as
55                   the new value of 'SET.'. If LSET is zero, no change is to
56                   be made in the current value of 'SET.'.
57
58                   See the discussion of 'SET.', in the autograph_params man
59                   page.
60
61       NDSH        (an input expression of type INTEGER), if zero, specifies
62                   that no change is to be made in the parameters which
63                   specify the dashed-line patterns to be used for curves.
64
65                   ·      If NDSH is non-zero, it specifies an integer value
66                          whose real equivalent is to be stored as the new
67                          value of 'DASH/ SELECTOR.' (which has the default
68                          value "1.").
69
70                   ·      If NDSH is negative, 'DASH/SELECTOR.' is set
71                          negative, forcing EZMY and EZMXY to use internally-
72                          defined "alphabetic" patterns for the MANY curves
73                          drawn ("A" for the first, "B" for the second, . . .,
74                          "Z" for the 26th, "A" for the 27th, etc.). The
75                          routines EZY and EZXY are unaffected.
76
77                   ·      If NDSH is greater than zero, it must be less than
78                          or equal to 26, and the next argument, DSHC, must
79                          contain NDSH dashed-line patterns comprising the new
80                          "user" set of patterns. The fact that
81                          'DASH/SELECTOR.' is set positive forces EZMY and
82                          EZMXY to use this set of patterns. (The routines EZY
83                          and EZXY always use the first pattern in this set.)
84                          The contents of the array DSHC are copied to storage
85                          local to Autograph and pointers to them are
86                          installed as the values of 'DASH/PATTERNS/1.',
87                          '.../2.', etc.
88
89                   See the discussion of 'DASH.', in the autograph_params man
90                   page.
91
92       DSHC        (an input array of type CHARACTER, dimensioned NDSH) is
93                   meaningful only when NDSH is greater than zero. In this
94                   case, it must be an array of NDSH character strings, each
95                   of the length specified by the current value of 'DASH/
96                   LENGTH.'. Each character string represents a dashed-line
97                   pattern; dollar signs mean "pen down", quotes mean "pen
98                   up", and other characters mean "draw me".
99
100                   See the discussion of 'DASH.', in the autograph_params man
101                   page.
102

C-BINDING DESCRIPTION

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

USAGE

108       This routine sets internal parameter values.  For a complete list of
109       parameters available in this utility, see the autograph_params man
110       page.
111

EXAMPLES

113       Use the ncargex command to see the following relevant examples: agex08,
114       agex10, agex13, bnchmk, sprevx.
115

ACCESS

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

SEE ALSO

121       Online: autograph, autograph_params, agback, agbnch, agchax, agchcu,
122       agchil, agchnl, agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr,
123       agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup,
124       agutol, displa, ezmxy, ezmy, ezxy, ezy
125
127       Copyright (C) 1987-2009
128       University Corporation for Atmospheric Research
129       The use of this Software is governed by a License Agreement.
130
131
132
133UNIX                              March 1993                    ANOTAT(3NCARG)
Impressum