1ANOTAT(3NCARG) NCAR GRAPHICS ANOTAT(3NCARG)
2
6 ANOTAT - Changes the values of certain primary control parameters,
7 purportedly having to do with "annotation" of a graph.
8
10 ANOTAT (XLAB,YLAB,LBAC,LSET,NDSH,DSHC)
11
13 #include <ncarg/ncargC.h>
14 void c_anotat(char *xlab, char *ylab, int lbac, int lset, \
16 int ndsh, char *dshc[])
17
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 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 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 See the discussion of 'BACKGROUND.', in the
50 autograph_params man page.
51 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 See the discussion of 'SET.', in the autograph_params man
59 page.
60 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 · 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 · 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 · 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 See the discussion of 'DASH.', in the autograph_params man
90 page.
91 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 See the discussion of 'DASH.', in the autograph_params man
101 page.
102
104 The C-binding argument descriptions are the same as the FORTRAN
105 argument descriptions.
106
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
113 Use the ncargex command to see the following relevant examples: agex08,
114 agex10, agex13, bnchmk, sprevx.
115
117 To use ANOTAT or c_anotat, load the NCAR Graphics libraries ncarg,
118 ncarg_gks, and ncarg_c, preferably in that order.
119
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-2007
128 University Corporation for Atmospheric Research
129 This documentation is free software; you can redistribute it and/or
131 modify it under the terms of the GNU General Public License as
132 published by the Free Software Foundation; either version 2 of the
133 License, or (at your option) any later version.
134 This software is distributed in the hope that it will be useful, but
136 WITHOUT ANY WARRANTY; without even the implied warranty of
137 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
138 General Public License for more details.
139 You should have received a copy of the GNU General Public License along
141 with this software; if not, write to the Free Software Foundation,
142 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
143UNIX March 1993 ANOTAT(3NCARG)