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

NAME

6       Autograph - To draw graphs, each with a labeled background and each
7       displaying one or more curves.
8

SYNOPSIS

10       Each of the following routines draws a complete graph with a single
11       call:
12
13       EZY - Draws, in a manner determined by the current values of the
14       control parameters, a complete graph of a single curve through the
15       points (I,YDRA(I)), for I from 1 to NPTS. The argument GLAB may be used
16       to specify a "graph label", to be placed at the top of the graph.
17
18       EZXY - Draws, in a manner determined by the current values of the
19       control parameters, a complete graph of a single curve through the
20       points (XDRA(I),YDRA(I)), for I from 1 to NPTS.  The argument GLAB may
21       be used to specify a "graph label", to be placed at the top of the
22       graph.
23
24       EZMY - Draws, in a manner determined by the current values of the
25       control parameters, a complete graph of one or more curves, each
26       defined by a set of points (I,YDRA(I,J)) (or (I,YDRA(J,I)), depending
27       on the current value of ´ROW.´), for I from 1 to NPTS. The curve number
28       J runs from 1 to MANY. The argument GLAB may be used to specify a
29       "graph label", to be placed at the top of the graph.
30
31       EZMXY - Draws, in a manner determined by the current values of the
32       control parameters, a complete graph of one or more curves, each
33       defined by a set of points (XDRA(I),YDRA(I,J)) (or (XDRA(I),YDRA(J,I))
34       or (XDRA(I,J),YDRA(I,J)) or (XDRA(J,I),YDRA(J,I)), depending on the
35       current value of ´ROW.´), for I from 1 to NPTS. The curve number J runs
36       from 1 to MANY. The argument GLAB may be used to specify a "graph
37       label", to be placed at the top of the graph.
38
39       The following routines provide access to control parameters:
40
41       ANOTAT - Changes the values of certain primary control parameters,
42       purportedly having to do with "annotation" of a graph.
43
44       DISPLA - Changes the values of certain primary control parameters
45       purportedly having to do with the "display" of a graph.
46
47       AGSETC - Allows a user program to (in effect) store a character string
48       as the value of a specified single parameter.
49
50       AGSETF - Allows a user program to store a real number as the value of a
51       single parameter.
52
53       AGSETI - Allows a user program to store the real equivalent of an
54       integer as the value of a single parameter.
55
56       AGSETP - Allows a user program to reset the values of a group of
57       parameters containing one or more elements.
58
59       AGSETR - Allows a user program to store a real number as the value of a
60       single parameter.
61
62       AGGETC - Allows a user program to retrieve (in effect) the character-
63       string values of certain single parameters.
64
65       AGGETF - Allows a user program to retrieve the real value of a single
66       parameter.
67
68       AGGETI - Allows a user program to retrieve the integer equivalent of
69       the real value of a single parameter.
70
71       AGGETP - Allows a user program to get the values of a group of
72       parameters containing one or more elements.
73
74       AGGETR - Allows a user program to retrieve the real value of a single
75       parameter.
76
77       The following are lower-level user-callable routines:
78
79       AGSTUP - Performs "set-up" tasks required before AGBACK and AGCURV may
80       be called. Basically, AGSTUP examines the current values of the primary
81       control parameters for errors and computes from them and from its
82       arguments the values of secondary control parameters. The primary and
83       secondary control parameters together determine how the routines AGBACK
84       and AGCURV will behave.
85
86       AGBACK - Draws the background specified by the current values of the
87       control parameters - the primary parameters with default values or with
88       values supplied by the user, and the secondary parameters with values
89       computed by AGSTUP.
90
91       AGCURV - Draws a curve in a manner specified by the current values of
92       the control parameters - the primary parameters with default values or
93       with values supplied by the user, and the secondary parameters with
94       values computed by AGSTUP.
95
96       The following are other user-callable routines:
97
98       AGSAVE - Saves the current state of Autograph for later restoration by
99       AGRSTR.
100
101       AGRSTR - Restores a saved state of Autograph.
102
103       The following are non-user-callable, CHARACTER*16 functions:
104
105       AGBNCH - Provides an easy way to convert binary dash patterns into
106       character dash patterns.
107
108       AGDSHN - Provides an easy way to generate the names of parameters in
109       the group ´DASH/PATTERN.´, for use in calls to AGSETC and AGGETC.
110

C-BINDING SYNOPSIS

112       #include <ncarg/ncargC.h>
113
114       c_ezy
115       c_ezxy
116       c_ezmy
117       c_ezmxy
118       c_anotat
119       c_displa
120       c_agsetc
121       c_agsetf
122       c_agseti
123       c_agsetp
124       c_agsetr
125       c_aggetc
126       c_aggetf
127       c_aggeti
128       c_aggetp
129       c_aggetr
130       c_agstup
131       c_agback
132       c_agcurv
133       c_agsave
134       c_agrstr
135       c_agbnch
136       c_agdshn
137

USER-MODIFIABLE INTERNAL ROUTINES

139       AGCHAX - Provides a way for the user to change the color, intensity,
140       line style, etc., of various portions of the axes.
141
142       AGCHCU - Provides a way for the user to change the color, intensity,
143       line style, etc., of curves drawn by Autograph.
144
145       AGCHIL - Provides a way for the user to change the color, intensity,
146       text style, etc., of the informational labels.
147
148       AGCHNL - Provides a way for the user to substitute arbitrary character
149       strings for the numeric labels generated by Autograph.
150
151       AGPWRT - Provides a way for the user to change the style of all text
152       strings drawn by Autograph.
153
154       AGUTOL - Provides a way for the user to change the user-system-to-
155       label-system mapping for one or more of the four axes.
156

ACCESS

158       To use the Autograph Fortran or C routines, load the NCAR Graphics
159       libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.
160
161       To get smoother curves, drawn using spline interpolation, also load
162       libdashsmth.o
163
164       Autograph contains a routine AGPWRT, which it calls to draw labels.
165       This routine just passes its arguments on to the system-plot-package
166       routine PWRIT. To use one of the fancier character-drawers, like
167       Plotchar, just compile a routine AGPWRT to replace the default version;
168       it has the same arguments as PWRIT and may either draw the character
169       string itself, or just pass the arguments on to a desired character-
170       drawer.  You can also modify AGPWRT so that Autograph will access
171       character fonts that are different from the default font.  In  its
172       distributed form, AGPWRT calls PWRIT. Consult the documentation in the
173       code.  The file AGUPWRT on the distribution tape contains an
174       implementation of AGPWRTX that allows Autograph to access the PWRITX
175       character set.  See the documentation in the code for AGUPWRTX.   See
176       your NCAR Graphics site representative to learn how to access the code.
177

MESSAGES

179       Autograph routines detect certain errors and, in response, call the
180       routine SETER, which is an adapted version of a PORT error handler.
181       Currently, all such errors are treated as being fatal and cause
182       termination of the job. An error message is logged before the job is
183       terminated. Each such message includes the name of the routine which
184       detected the error and may be accompanied by supplementary information
185       aimed at allowing the user to easily identify the call that caused the
186       error. The possible error messages are as follows (in alphabetical
187       order):
188
189       AGEXAX (CALLED BY AGSTUP) - USER-SYSTEM-TO-LABEL-SYSTEM MAPPING IS NOT
190       MONOTONIC
191
192            This probably means that you have replaced the default routine
193            AGUTOL with a version of your own, and you´ve blown it.
194
195       AGGETC - PARAMETER TO GET IS NOT INTRINSICALLY OF TYPE CHARACTER
196
197            The argument TPGN specifies a parameter which is not intrinsically
198            of type character. See the description in the AGGETC man page.
199
200       AGGETP OR AGSETP - ATTEMPT TO ACCESS LABEL ATTRIBUTES BEFORE SETTING
201       LABEL NAME
202
203            The parameter ´LABEL/NAME.´ must be set prior to the call which
204            gave the error message, specifying which label´s attributes are
205            being referenced.
206
207       AGGETP OR AGSETP - ATTEMPT TO ACCESS LINE ATTRIBUTES BEFORE SETTING
208       LINE NUMBER
209
210            The parameter ´LINE/NUMBER.´ must be set prior to the call which
211            gave the error message, specifying which label line´s attributes
212            are being referenced.
213
214       AGGETP OR AGSETP - ILLEGAL KEYWORD USED IN PARAMETER IDENTIFIER
215
216            The argument TPGN contains an unrecognizable keyword.
217
218       AGKURV - NUMBER OF POINTS IS .LE. 0
219
220            The argument NEXY, in a call to AGCURV, is less than or equal to
221            zero. The routine AGKURV is called by AGCURV to draw un-windowed
222            curves.
223
224       AGNUMB - MANTISSA TOO LONG
225       AGNUMB - EXPONENT TOO LARGE
226       AGNUMB - ZERO-LENGTH MANTISSA
227
228            AGNUMB is called by AGAXIS to generate a character string
229            expressing the value of a real number. You should not be able to
230            generate any of AGNUMB´s error messages. If you do, see the
231            Autograph specialist.
232
233       AGQURV - NUMBER OF POINTS IS .LE. 0
234
235            The argument NEXY, in a call to AGCURV, is less than or equal to
236            zero. The routine AGQURV is called by AGCURV to draw windowed
237            curves.
238
239       AGRSTR - ERROR ON READ
240       AGRSTR - END-OF-FILE ON READ
241
242            Probably the unit specified by IFNO was not positioned properly.
243
244       AGSAVE - ERROR ON WRITE
245
246            A system error has occurred as a result of the attempted "WRITE".
247
248       AGSETC - PARAMETER TO SET IS NOT INTRINSICALLY OF TYPE CHARACTER
249
250            This means that the argument TPGN specifies some parameter other
251            than one of the acceptable possibilities. See the description in
252            the AGSETC man page.
253
254       AGSETP - ATTEMPT TO DEFINE LINE OF NON-EXISTENT LABEL
255
256            The user has attempted to define a line of a label without first
257            specifying which label; ´LABEL/NAME.´ must be set prior to the
258            call which gave the error message.
259
260       AGSETP - LABEL LIST OVERFLOW - SEE AUTOGRAPH SPECIALIST
261
262            The user has attempted to define more labels than Autograph can
263            handle; a modification of Autograph is required.
264
265       AGSETP - LINE LIST OVERFLOW - SEE AUTOGRAPH SPECIALIST
266
267            The user has attempted to define more label lines than Autograph
268            can handle; a modification of Autograph is required.
269
270       AGSTCH - CHARACTER-STRING BUFFER OVERFLOW - SEE CONSULTANT
271
272            The routine AGSTCH is called by AGSETC to stash the character
273            string in Autograph´s character storage space.  The available
274            storage space has been exhausted.  See the consultant.
275
276       AGSTCH - CHARACTER-STRING INDEX OVERFLOW - SEE CONSULTANT
277
278            The routine AGSTCH is called by AGSETC to stash the character
279            string in Autograph´s character storage space.  Too many such
280            strings have been stored. See the consultant.
281
282       AGSTUP - GRAPH WINDOW IMPROPERLY SPECIFIED
283
284            The parameters in the group named ´GRAPH.´ have improper values.
285
286       AGSTUP - GRID WINDOW IMPROPERLY SPECIFIED
287
288            The parameters in the group named ´GRID.´ have improper values.
289            This is most likely to occur when ´SET.´ has the value "2." or
290            "4.", specifying that the edges of the grid window are to be as
291            implied by the last call to the plot package routine SET. Check to
292            make sure that the portion of the plotter frame specified by the
293            last SET call is within the current graph window.
294
295       AGSTUP - s LABELS IMPROPERLY SPECIFIED
296
297            (where "s" = "LEFT", "RIGHT", "BOTTOM", "TOP", or "INTERIOR"). Re-
298            read the paragraph "THE LABEL BOXES", in the section "OVERVIEW".
299            You have defined a label with a basepoint on one edge of the grid
300            window and an offset vector pointing outward, some part of which
301            extends inside the grid window (or vice-versa). This is not
302            allowed.
303

SEE ALSO

305       Online: autograph, autograph_params, agback, agbnch, agchax, agchcu,
306       agchil, agchnl, agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr,
307       agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup,
308       agutol, anotat, displa, ezmxy, ezmy, ezxy, ezy
309
310       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
311
313       Copyright (C) 1987-2009
314       University Corporation for Atmospheric Research
315       The use of this Software is governed by a License Agreement.
316
317
318
319UNIX                              March 1993                 Autograph(3NCARG)
Impressum