1Autograph(3NCARG) NCAR GRAPHICS Autograph(3NCARG)
2
6 Autograph - To draw graphs, each with a labeled background and each
7 displaying one or more curves.
8
10 Each of the following routines draws a complete graph with a single
11 call:
12 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 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 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 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 The following routines provide access to control parameters:
40 ANOTAT - Changes the values of certain primary control parameters,
42 purportedly having to do with "annotation" of a graph.
43 DISPLA - Changes the values of certain primary control parameters
45 purportedly having to do with the "display" of a graph.
46 AGSETC - Allows a user program to (in effect) store a character string
48 as the value of a specified single parameter.
49 AGSETF - Allows a user program to store a real number as the value of a
51 single parameter.
52 AGSETI - Allows a user program to store the real equivalent of an
54 integer as the value of a single parameter.
55 AGSETP - Allows a user program to reset the values of a group of
57 parameters containing one or more elements.
58 AGSETR - Allows a user program to store a real number as the value of a
60 single parameter.
61 AGGETC - Allows a user program to retrieve (in effect) the character-
63 string values of certain single parameters.
64 AGGETF - Allows a user program to retrieve the real value of a single
66 parameter.
67 AGGETI - Allows a user program to retrieve the integer equivalent of
69 the real value of a single parameter.
70 AGGETP - Allows a user program to get the values of a group of
72 parameters containing one or more elements.
73 AGGETR - Allows a user program to retrieve the real value of a single
75 parameter.
76 The following are lower-level user-callable routines:
78 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 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 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 The following are other user-callable routines:
97 AGSAVE - Saves the current state of Autograph for later restoration by
99 AGRSTR.
100 AGRSTR - Restores a saved state of Autograph.
102 The following are non-user-callable, CHARACTER*16 functions:
104 AGBNCH - Provides an easy way to convert binary dash patterns into
106 character dash patterns.
107 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
112 #include <ncarg/ncargC.h>
113 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
139 AGCHAX - Provides a way for the user to change the color, intensity,
140 line style, etc., of various portions of the axes.
141 AGCHCU - Provides a way for the user to change the color, intensity,
143 line style, etc., of curves drawn by Autograph.
144 AGCHIL - Provides a way for the user to change the color, intensity,
146 text style, etc., of the informational labels.
147 AGCHNL - Provides a way for the user to substitute arbitrary character
149 strings for the numeric labels generated by Autograph.
150 AGPWRT - Provides a way for the user to change the style of all text
152 strings drawn by Autograph.
153 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
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 To get smoother curves, drawn using spline interpolation, also load
162 libdashsmth.o
163 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
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 AGEXAX (CALLED BY AGSTUP) - USER-SYSTEM-TO-LABEL-SYSTEM MAPPING IS NOT
190 MONOTONIC
191 This probably means that you have replaced the default routine
193 AGUTOL with a version of your own, and you´ve blown it.
194 AGGETC - PARAMETER TO GET IS NOT INTRINSICALLY OF TYPE CHARACTER
196 The argument TPGN specifies a parameter which is not intrinsically
198 of type character. See the description in the AGGETC man page.
199 AGGETP OR AGSETP - ATTEMPT TO ACCESS LABEL ATTRIBUTES BEFORE SETTING
201 LABEL NAME
202 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 AGGETP OR AGSETP - ATTEMPT TO ACCESS LINE ATTRIBUTES BEFORE SETTING
208 LINE NUMBER
209 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 AGGETP OR AGSETP - ILLEGAL KEYWORD USED IN PARAMETER IDENTIFIER
215 The argument TPGN contains an unrecognizable keyword.
217 AGKURV - NUMBER OF POINTS IS .LE. 0
219 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 AGNUMB - MANTISSA TOO LONG
225 AGNUMB - EXPONENT TOO LARGE
226 AGNUMB - ZERO-LENGTH MANTISSA
227 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 AGQURV - NUMBER OF POINTS IS .LE. 0
234 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 AGRSTR - ERROR ON READ
240 AGRSTR - END-OF-FILE ON READ
241 Probably the unit specified by IFNO was not positioned properly.
243 AGSAVE - ERROR ON WRITE
245 A system error has occurred as a result of the attempted "WRITE".
247 AGSETC - PARAMETER TO SET IS NOT INTRINSICALLY OF TYPE CHARACTER
249 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 AGSETP - ATTEMPT TO DEFINE LINE OF NON-EXISTENT LABEL
255 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 AGSETP - LABEL LIST OVERFLOW - SEE AUTOGRAPH SPECIALIST
261 The user has attempted to define more labels than Autograph can
263 handle; a modification of Autograph is required.
264 AGSETP - LINE LIST OVERFLOW - SEE AUTOGRAPH SPECIALIST
266 The user has attempted to define more label lines than Autograph
268 can handle; a modification of Autograph is required.
269 AGSTCH - CHARACTER-STRING BUFFER OVERFLOW - SEE CONSULTANT
271 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 AGSTCH - CHARACTER-STRING INDEX OVERFLOW - SEE CONSULTANT
277 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 AGSTUP - GRAPH WINDOW IMPROPERLY SPECIFIED
283 The parameters in the group named ´GRAPH.´ have improper values.
285 AGSTUP - GRID WINDOW IMPROPERLY SPECIFIED
287 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 AGSTUP - s LABELS IMPROPERLY SPECIFIED
296 (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
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 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
311
313 Copyright (C) 1987-2007
314 University Corporation for Atmospheric Research
315 This documentation is free software; you can redistribute it and/or
317 modify it under the terms of the GNU General Public License as
318 published by the Free Software Foundation; either version 2 of the
319 License, or (at your option) any later version.
320 This software is distributed in the hope that it will be useful, but
322 WITHOUT ANY WARRANTY; without even the implied warranty of
323 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
324 General Public License for more details.
325 You should have received a copy of the GNU General Public License along
327 with this software; if not, write to the Free Software Foundation,
328 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
329UNIX March 1993 Autograph(3NCARG)