1Autograph_params(3NCARG) NCAR GRAPHICS Autograph_params(3NCARG)
2
6 Autograph_params - This document briefly describes all Autograph
7 internal parameters.
8
10 The Autograph control parameters reside in the labeled common block
11 AGCONP. There are currently 485 of them, of which 336 are "primary" and
12 149 are "secondary". Primary control parameters have default values and
13 are subject to change by a user program to produce some desired effect
14 on the behavior of Autograph and/or on the nature of a graph being
15 drawn. Secondary control parameters are computed by Autograph itself
16 and are not normally subject to change by a user program.
17 User access to these parameters is provided by the routines AGGETC,
19 AGGETF, AGGETI, AGGETP, AGGETR, AGSETC, AGSETF, AGSETI, AGSETP, and
20 AGSETR. The first argument in a call to one of these routines is a
21 character string naming a group of parameters (perhaps containing only
22 a single parameter) which the user wishes to "set" or "get". Each such
23 string has the form ´k1/k2/k3/ . . . kn.´, where k1 is a keyword
24 identifying a major group of parameters, k2 is a keyword identifying a
25 subgroup of that major group, k3 is a keyword identifying a further
26 subgroup of that subgroup, and so on. Only the first three characters
27 of k1 and the first two characters of the others need be used; also,
28 certain keywords may be omitted.
29 Because of certain portability considerations, all of the parameters
31 have real values. The routine AGSETP may be used to set the real values
32 of the parameters in any group, and the routine AGGETP to retrieve
33 those values. Either of the routines AGSETF or AGSETR may be used to
34 set the real value of a single parameter and either of the routines
35 AGGETF or AGGETR may be used to get the real value of a single
36 parameter.
37 Some parameters may only take on discrete integral values (like "0.",
39 "1.", "-6.", or "65535.") and are used in roles for which integers
40 would normally be used. The routine AGSETI may be used to set the
41 integer value of a single parameter of this type and the routine AGGETI
42 may be used to get the integer value of a single parameter of this
43 type.
44 Other parameters intrinsically represent character strings; the real
46 value of the parameter is an identifier, generated when the character
47 string is passed to Autograph and enabling the character string to be
48 retrieved from Autograph´s character storage space when it is needed.
49 The routine AGSETC must be used to set the character-string value
50 associated with a single parameter of this type and the routine AGGETC
51 must be used to get the character-string value associated with a single
52 parameter of this type.
53 Many parameters have a limited range of acceptable values. What
55 generally happens when a parameter is given an out-of-range value is
56 that Autograph (usually the routine AGSTUP) resets that value to the
57 value at the nearer end of the acceptable range.
58 Setting certain parameters (individually, rather than as part of a
60 multi-parameter group) implies, as a side effect, "special action" by
61 the routine AGSETP (which may be called directly by the user or
62 indirectly by way of a user call to AGSETC, AGSETF, AGSETI, or AGSETR).
63 For example, setting the parameter ´BACKGROUND.´ to request a
64 particular background type causes a number of other parameters to be
65 changed in order to achieve the desired result.
66 Each of the named parameter groups is described below. Square brackets
68 are used to mark portions of a name which may be omitted; the notation
69 ´k1/k2/ . . . [ki/]...kn.´ indicates that the keyword ki and the
70 following slash may be omitted. In each description, the simplest form
71 of the name is given. If a multi-parameter group is named, its
72 subgroups are listed, in the order in which they occur in the group. If
73 a single parameter is named, the default value of that parameter is
74 given and any "special action" by AGSETP is described.
75 ´PRIMARY.´
77 Simplest form of name: ´PRI.´
78 This group consists of all 336 primary control parameters, in
80 the order in which they appear below. It was originally provided
81 to give users the capability of saving and restoring the state
82 of Autograph. The routines AGSAVE and AGRSTR (which see) should
83 now be used for this purpose.
84 ´FRAME.´
86 Simplest form of name: ´FRA.´
87 An integral real number specifying when a frame advance is to be
89 done by the routines EZY, EZXY, EZMY, and EZMXY and having one
90 of three possible values:
91 · The value "1." specifies a frame advance after drawing a
93 graph.
94 · The value "2." specifies no frame advance at all.
96 · The value "3." specifies a frame advance before drawing a
98 graph.
99 Default value: "1." (frame advance after drawing graph).
101 ´SET.´ Simplest form of name: ´SET.´
103 An integral real number specifying whether or not the arguments
105 of the last call to "SET" are used to determine the linear/log
106 nature of the current graph, the position of the grid window
107 and/or the X/Y minimum/maximum values.
108 (Note: The routine SET is part of the package called SPPS. Its
110 first four arguments specify a portion of the plotter frame, its
111 next four arguments specify the minimum and maximum X and Y
112 coordinate values to be mapped to that portion, and its ninth
113 argument specifies the linear/log nature of the mapping. The
114 routine GETSET, which is also a part of SPPS, is used to
115 retrieve the arguments of the last call to SET.)
116 Giving ´SET.´ a value (individually, rather than as part of a
118 group) has both an immediate effect and a delayed effect. The
119 immediate effect, which occurs in the routine AGSETP, is to
120 return most of the parameters in the groups ´GRID.´, ´X.´, and
121 ´Y.´ to their default values. (Exceptions are ´X/LOGARITHMIC.´
122 and ´Y/LOGARITHMIC.´, which may have values making them immune
123 to such resetting.) The delayed effect, which occurs in the
124 routine AGSTUP, depends on the value given to ´SET.´.
125 There are eight acceptable values of ´SET.´, four of which are
127 just the negatives of the other four. Using a negated value
128 suppresses the drawing of curves by the routines EZY, EZXY,
129 EZMY, and EZMXY. Acceptable absolute values of ´SET.´ are as
130 follows:
131 · The value "1." means that the arguments of the last SET
133 call are not to be used by AGSTUP.
134 · The value "2." means that, in AGSTUP, ´X/LOGARITHMIC.´
136 and ´Y/LOGARITHMIC.´ are to be given values ("0." or
137 "-1.") consistent with the ninth argument of the last
138 SET call and that parameters in the group ´GRID.´ are to
139 be given values consistent with the first four arguments
140 of the last SET call.
141 · The value "3." means that, in AGSTUP, ´X/LOGARITHMIC.´
143 and ´Y/LOGARITHMIC.´ are to be given values ("0." or
144 "-1.") consistent with the ninth argument of the last
145 SET call and that the other parameters in the groups ´X.´
146 and ´Y.´ are to be given values consistent with the fifth
147 through eighth arguments of the last SET call.
148 · The value "4." implies a combination of the actions
150 specified by the values "2." and "3.".
151 Default value: "1." (no arguments of last SET call used).
153 Special action by AGSETP: As described above, if ´SET.´ is set
155 (individually, rather than as part of a group) to any value by
156 an AGSETP call, the parameters in the groups ´GRID.´, ´X.´, and
157 ´Y.´ are reset to their default values. The parameter
158 ´X/LOGARITHMIC.´ is reset to its default value ("0.") only if it
159 has the value "+1."; a value of "-1." is not changed;
160 ´Y/LOGARITHMIC.´ is treated similarly.
161 ´ROW.´ Simplest form of name: ´ROW.´
163 An integral real number specifying the assumed dimensioning of X
165 and Y coordinate data arrays used in calls to the routines EZMY
166 and EZMXY. There are four possibilities:
167 · The value "-2." means that both X and Y arrays are
169 subscripted by curve number and point number, in that
170 order.
171 · The value "-1." means that Y arrays are subscripted by
173 curve number and point number, in that order, but that X
174 arrays are subscripted by point number only. (The same X-
175 coordinate data is used for all the curves.)
176 · Either of the values "0." or "1." means that Y arrays are
178 subscripted by point number and curve number, in that
179 order, but that X arrays are subscripted by point number
180 only. (The same X-coordinate data is used for all of the
181 curves.)
182 · The value "+2." means that both X and Y arrays are
184 subscripted by point number and curve number, in that
185 order.
186 Default value: "1." (Y by point and curve numbers, X by point
188 number only).
189 ´INVERT.´
191 Simplest form of name: ´INV.´
192 An integral real number having the value "0." or "1."; giving it
194 the value "1." causes the routines AGSTUP and AGCURV to behave
195 as if arguments defining X-coordinate data had been interchanged
196 with arguments defining Y-coordinate data, thus, in some sense,
197 allowing one to graph "X as a function of Y". This parameter is
198 principally intended for users of the routines EZY, EZXY, EZMY,
199 and EZMXY.
200 Default value: "0." (no inversion of X and Y arguments).
202 ´WINDOW.´
204 Simplest form of name: ´WIN.´
205 An integral real number having the value "0." or "1."; giving it
207 the value "1." causes the routine AGCURV to use the subroutine
208 AGQURV, rather than AGKURV, for drawing curves. The result is
209 that curve portions falling outside the grid window are omitted.
210 See the AGCURV man page.
211 Default value: "0." (no windowing of curves).
213 ´BACKGROUND.´
215 Simplest form of name: ´BAC.´
216 An integral real number specifying the type of background to be
218 drawn by AGBACK. There are four acceptable values:
219 · The value "1." specifies a "perimeter" background.
221 · The value "2." specifies a "grid" background.
223 · The value "3." specifies a "half-axis" background.
225 · The value "4." specifies no background at all.
227 Default value: "1." (a "perimeter" background).
229 Special action by AGSETP: If ´BACKGROUND.´ is set (individually,
231 rather than as part of a group) by a call to AGSETP, the desired
232 background is created by changing the following parameters:
233 ´[AXIS/]s/CONTROL.´
235 ´[AXIS/]s/[TICKS/]MAJOR/[LENGTH/]INWARD.´
236 ´[AXIS/]s/[TICKS/]MINOR/[LENGTH/]INWARD.´
237 ´LABEL/CONTROL.´
238 where "s" stands for "LEFT", "RIGHT", "BOTTOM", and "TOP". This
240 determines which of the axes are plotted, how long the inward-
241 pointing portions of major and minor tick marks are to be, and
242 whether or not informational labels are to be plotted. Values
243 used are as follows:
244 The value "1." (perimeter background) sets:
246 ´s/CONTROL.´ to "4." for all s;
248 ´s/MAJOR/INWARD.´ to ".015" for all s;
249 ´s/MINOR/INWARD.´ to ".010" for all s;
250 ´LABEL/CONTROL.´ to "2.".
251 The value "2." (grid background) sets:
253 ´s/CONTROL.´ to "4." for "s" = "LEFT" and "BOTTOM",
255 ´s/CONTROL.´ to "-1." for "s" = "RIGHT" and "TOP";
256 ´s/MAJOR/INWARD.´ to "1." for all s;
257 ´s/MINOR/INWARD.´ to "1." for all s;
258 ´LABEL/CONTROL.´ to "2.".
259 The value "3." (half-axis background) sets:
261 ´s/CONTROL.´ to "4." for "s" = "LEFT" and "BOTTOM",
263 ´s/CONTROL.´ to "-1." for "s" = "RIGHT" and "TOP";
264 ´s/MAJOR/INWARD.´ to ".015" for all s;
265 ´s/MINOR/INWARD.´ to ".010" for all s;
266 ´LABEL/CONTROL.´ to "2.".
267 The value "4." (no background) sets:
269 ´s/CONTROL.´ to "0." for all s;
271 ´s/MAJOR/INWARD.´ to ".015 for all s;
272 ´s/MINOR/INWARD.´ to ".010" for all s;
273 ´LABEL/CONTROL.´ to "0.".
274 The default values of these thirteen parameters correspond to
276 the default value of ´BACKGROUND.´. Note that, if they are
277 changed directly, the value of ´BACKGROUND.´ may not reflect the
278 actual nature of the background defined by them.
279 ´NULL.´
281 Simplest form of name: ´NUL.´
282 This group contains the two "nulls" (or "special values")
284 ´NULL/1.´ and ´NULL/2.´.
285 ´NULL/1.´
287 Simplest form of name: ´NUL/1.´
288 A real number "null 1", used in the following ways by Autograph:
290 · Certain parameters have by default, or may be given, the
292 value "null 1", specifying that the routine AGSTUP is to
293 choose values for them. The value chosen for a given
294 parameter is not back-stored in place of the "null 1";
295 thus, a unique value will be chosen for each graph drawn.
296 · If a curve point specified by the user has X and/or Y
298 coordinates equal to "null 1", that curve point is
299 ignored. It is not used in computing minimum and maximum
300 values. Curve segments on either side of it are not
301 drawn.
302 Default value: "1.E36" (an arbitrary value).
304 Special action by AGSETP: If ´NULL/1.´ is changed (individually,
306 rather than as part of a group) by an AGSETP call, the entire
307 list of primary parameters is scanned - any value equal to the
308 old "null 1" is replaced by the new one.
309 ´NULL/2.´
311 Simplest form of name: ´NUL/2.´
312 A real number "null 2". Certain parameters may be given the
314 value "null 2", specifying that the routine AGSTUP is to choose
315 values for them. The value chosen for a given parameter is back-
316 stored in place of the "null 2"; thus, a unique value may be
317 chosen for the first graph of a series and then used for all
318 remaining graphs in the series.
319 Default value: "2.E36" (an arbitrary value).
321 Special action by AGSETP: If ´NULL/2.´ is changed (individually,
323 rather than as part of a group) by an AGSETP call, the entire
324 list of primary parameters is scanned - any value equal to the
325 old "null 2" is replaced by the new one.
326 ´GRAPH.´
328 Simplest form of name: ´GRA.´
329 A group of four parameters describing the position of the "graph
331 window" within the plotter frame. A graph drawn by Autograph
332 (including labels) is forced to lie entirely within this window.
333 Subgroups and the number of parameters in each are as follows:
334 ´GRAPH/LEFT.´ (1)
336 ´GRAPH/RIGHT.´ (1)
337 ´GRAPH/BOTTOM.´ (1)
338 ´GRAPH/TOP.´ (1)
339 ´GRAPH/LEFT.´
341 Simplest form of name: ´GRA/LE.´
342 A real number between "0." and "1." specifying the position of
344 the left edge of the graph window as a fraction of the distance
345 from the left edge to the right edge of the plotter frame.
346 Default value: "0." (left edge of plotter frame).
348 ´GRAPH/RIGHT.´
350 Simplest form of name: ´GRA/RI.´
351 A real number between "0." and "1." specifying the position of
353 the right edge of the graph window as a fraction of the distance
354 from the left edge to the right edge of the plotter frame.
355 Default value: "1." (right edge of plotter frame).
357 ´GRAPH/BOTTOM.´
359 Simplest form of name: ´GRA/BO.´
360 A real number between "0." and "1." specifying the position of
362 the bottom edge of the graph window as a fraction of the
363 distance from the bottom edge to the top edge of the plotter
364 frame.
365 Default value: "0." (bottom edge of plotter frame).
367 ´GRAPH/TOP.´
369 Simplest form of name: ´GRA/TO.´
370 A real number between "0." and "1." specifying the position of
372 the top edge of the graph window as a fraction of the distance
373 from the bottom edge to the top edge of the plotter frame.
374 Default value: "0." (top edge of plotter frame).
376 ´GRID.´
378 Simplest form of name: ´GRI.´
379 A group of five parameters describing the position and shape of
381 the "grid window" within the graph window. Subgroups and the
382 number of parameters in each are as follows:
383 ´GRID/LEFT.´ (1)
385 ´GRID/RIGHT.´ (1)
386 ´GRID/BOTTOM.´ (1)
387 ´GRID/TOP.´ (1)
388 ´GRID/SHAPE.´ (1)
389 ´GRID/LEFT.´
391 Simplest form of name: ´GRI/LE.´
392 A real number between "0." and "1." specifying the position of
394 the left edge of the area in which the grid window is to be
395 placed, stated as a fraction of the distance from the left edge
396 to the right edge of the graph window.
397 Default value: ".15".
399 ´GRID/RIGHT.´
401 Simplest form of name: ´GRI/RI.´
402 A real number between "0." and "1." specifying the position of
404 the right edge of the area in which the grid window is to be
405 placed, stated as a fraction of the distance from the left edge
406 to the right edge of the graph window.
407 Default value: ".95".
409 ´GRID/BOTTOM.´
411 Simplest form of name: ´GRI/BO.´
412 A real number between "0." and "1." specifying the position of
414 the bottom edge of the area in which the grid window is to be
415 placed, stated as a fraction of the distance from the bottom
416 edge to the top edge of the graph window.
417 Default value: ".15".
419 ´GRID/TOP.´
421 Simplest form of name: ´GRI/TO.´
422 A real number between "0." and "1." specifying the position of
424 the top edge of the area in which the grid window is to be
425 placed, stated as a fraction of the distance from the bottom
426 edge to the top edge of the graph window.
427 Default value: ".95".
429 ´GRID/SHAPE.´
431 Simplest form of name: ´GRI/SH.´
432 A real number specifying the shape of the grid window. The grid
434 window, whatever its shape, is centered in, and made as large as
435 possible in, the area specified by the first four parameters in
436 the group ´GRID.´. The value of ´GRID/SHAPE.´ falls in one of
437 four possible ranges, as follows:
438 · A value less than "0." specifies the negative of the
440 desired ratio of the grid window´s width to its height.
441 For example, the value "-2." specifies a grid window
442 which is twice as wide as it is high.
443 · The value "0." specifies a grid window of exactly the
445 same shape as the area specified by the first four
446 parameters in the group ´GRID.´. The grid window
447 therefore fills that area completely.
448 · A value "s" between "0." and "1." specifies a grid window
450 whose shape is determined by the range of the user´s
451 coordinate data, reverting to the shape of the area
452 specified by the first four arguments in the group
453 ´GRID.´ if the ratio of the shorter side of the grid
454 window to the longer side of the grid window would
455 thereby be made less than "s". For example, if "s" were
456 given the value ".5" and the user X coordinate data
457 ranged in value from "0." to "10." and the user Y
458 coordinate data ranged in value from "0." to "15.", the
459 grid window would be made two-thirds as wide as it was
460 high; however, if the Y coordinate data ranged in value
461 from "0." to "100.", the grid window would not be made
462 one-tenth as wide as it is high, but would instead be
463 made to fill the entire area specified by the first four
464 arguments of the group ´GRID.´.
465 · A value "s" greater than or equal to "1." specifies a
467 grid window whose shape is determined by the range of the
468 user´s coordinate data, reverting to a square if the
469 ratio of the longer side of the grid window to the
470 shorter side of the grid window would thereby be made
471 greater than "s".
472 Note that, if ´GRID/SHAPE.´ is given a value greater than "0.",
474 Autograph assumes that the user´s X and Y coordinate data have
475 the same units (both in inches, for example) and that the
476 outline of a real two-dimensional object is to be graphed
477 without distortion. The grid window is shaped in such a way as
478 to accomplish this. This feature should not be used when either
479 ´X/LOGARITHMIC.´ or ´Y/LOGARITHMIC.´ has a non-zero value; doing
480 so will yield strange results.
481 Note that either "-1." or "+1." produces a square and that
483 "-1.61803398874989" produces a golden rectangle.
484 Default value: "0.".
486 ´X.´
488 Simplest form of name: ´X.´
489 A group of seven parameters specifying the mapping of the user´s
491 X-coordinate data onto the horizontal axis of the grid window.
492 Subgroups and the number of parameters in each are as follows:
493 ´X/MINIMUM.´ (1)
495 ´X/MAXIMUM.´ (1)
496 ´X/LOGARITHMIC.´ (1)
497 ´X/ORDER.´ (1)
498 ´X/NICE.´ (1)
499 ´X/SMALLEST.´ (1)
500 ´X/LARGEST.´ (1)
501 See also ´SET.´ and ´INVERT.´, above.
503 ´X/MINIMUM.´
505 Simplest form of name: ´X/MI.´
506 A real number specifying the minimum user X coordinate to be
508 considered. This parameter normally has the value "null 1",
509 specifying that the routine AGSTUP should examine the user´s X-
510 coordinate data and find the minimum value for itself.
511 If the value "null 2" is used, it will be replaced, the next
513 time AGSTUP is called, by an actual minimum value computed by
514 AGSTUP.
515 If a non-null value is used, AGSTUP will not examine the user´s
517 X-coordinate data; the given value will be considered to be the
518 minimum.
519 If both ´X/MINIMUM.´ and ´X/MAXIMUM.´ are given non-null values,
521 the former should have a lesser value than the latter.
522 Default value: "1.E36" ("null 1").
524 ´X/MAXIMUM.´
526 Simplest form of name: ´X/MA.´
527 Analogous to ´X/MINIMUM.´, above; it specifies the way in which
529 the maximum X coordinate is to be determined.
530 Default value: "1.E36" ("null 1").
532 ´X/LOGARITHMIC.´
534 Simplest form of name: ´X/LO.´
535 An integral real number having one of the values "-1.", "0.", or
537 "+1.":
538 · The value "0." specifies that the mapping of user X
540 coordinates onto the horizontal axis of the grid window
541 is to be linear.
542 · The values "-1." and "+1." specify that the mapping is to
544 be logarithmic, in which case all user X-coordinate data
545 must be greater than zero.
546 · The value "-1." is immune to change when ´SET.´ (which
548 see, above) is reset; the value "+1." is not.
549 Default value: "0." (linear X mapping).
551 ´X/ORDER.´
553 Simplest form of name: ´X/OR.´
554 An integral real number having one of the values "0." or "1.":
556 · The value "0." specifies that the values of user X
558 coordinates mapped to the horizontal axis of the grid
559 window should increase from left to right.
560 · The value "1." specifies that user X coordinates should
562 decrease from left to right.
563 Default value: "0." (increase from left to right).
565 ´X/NICE.´
567 Simplest form of name: ´X/NI.´
568 An integral real number having one of the values "-1.", "0.", or
570 "+1.":
571 · The value "-1." specifies that user X-coordinate data are
573 to be mapped onto the horizontal axis of the grid window
574 in such a way as to force major-tick positions at the
575 endpoints of the bottom X axis.
576 · The value "+1." specifies that user X-coordinate data are
578 to be mapped onto the horizontal axis of the grid window
579 in such a way as to force major-tick positions at the
580 endpoints of the top X axis.
581 · The value "0." specifies that the X-coordinate data are
583 to be mapped so as to range from the left edge of the
584 grid window to the right edge of the grid window; major-
585 tick positions are not forced at the ends of either X
586 axis.
587 Default value: "-1." (bottom axis "nice").
589 ´X/SMALLEST.´
591 Simplest form of name: ´X/SM.´
592 This parameter comes into play when AGSTUP is called upon to
594 compute the minimum X coordinate (when ´X/MINIMUM.´ has a null
595 value); if the value of ´X/SMALLEST.´ is non-null, values less
596 than it will not be considered in the computation.
597 Default value: "1.E36" ("null 1").
599 ´X/LARGEST.´
601 Simplest form of name: ´X/LA.´
602 This parameter comes into play when AGSTUP is called upon to
604 compute the maximum X coordinate (when ´X/MAXIMUM.´ has a null
605 value); if the value of ´X/LARGEST.´ is non-null, values greater
606 than it will not be considered in the computation.
607 Default value: "1.E36" ("null 1").
609 ´Y.´
611 Simplest form of name: ´Y.´
612 A group of seven parameters specifying the mapping of the user´s
614 Y-coordinate data onto the vertical axis of the grid window.
615 Subgroups and the number of parameters in each are as follows:
616 ´Y/MINIMUM.´ (1)
618 ´Y/MAXIMUM.´ (1)
619 ´Y/LOGARITHMIC.´ (1)
620 ´Y/ORDER.´ (1)
621 ´Y/NICE.´ (1)
622 ´Y/SMALLEST.´ (1)
623 ´Y/LARGEST.´ (1)
624 See also ´SET.´ and ´INVERT.´, above.
626 ´Y/MINIMUM.´
628 Simplest form of name: ´Y/MI.´
629 Analogous to ´X/MINIMUM.´, above; it specifies the way in which
631 the minimum Y coordinate is to be determined.
632 Default value: "1.E36" ("null 1").
634 ´Y/MAXIMUM.´
636 Simplest form of name: ´Y/MA.´
637 Analogous to ´X/MAXIMUM.´, above; it specifies the way in which
639 the maximum Y coordinate is to be determined.
640 Default value: "1.E36" ("null 1").
642 ´Y/LOGARITHMIC.´
644 Simplest form of name: ´Y/LO.´
645 Analogous to ´X/LOGARITHMIC.´, above; it specifies whether the
647 mapping of Y coordinates is linear or logarithmic.
648 Default value: "0." (linear Y).
650 ´Y/ORDER.´
652 Simplest form of name: ´Y/OR.´
653 Analogous to ´X/ORDER.´, above; it specifies whether Y-
655 coordinates increase or decrease from bottom to top.
656 Default value: "0." (increase from bottom to top).
658 ´Y/NICE.´
660 Simplest form of name: ´Y/NI.´
661 Analogous to ´X/NICE.´, above; it specifies whether the left Y
663 axis, the right Y axis, or neither, is to be "nice".
664 Default value: "-1." (left axis "nice").
666 ´Y/SMALLEST.´
668 Simplest form of name: ´Y/SM.´
669 Analogous to ´X/SMALLEST.´, above; comes into play when AGSTUP
671 is called upon to compute the minimum Y coordinate.
672 Default value: "1.E36" ("null 1").
674 ´Y/LARGEST.´
676 Simplest form of name: ´Y/LA.´
677 Analogous to ´X/LARGEST.´, above; comes into play when AGSTUP is
679 called upon to compute the maximum Y coordinate.
680 Default value: "1.E36" ("null 1").
682 ´AXIS.´
684 Simplest form of name: ´AXI.´
685 A group of 92 parameters describing four axes: the left axis,
687 the right axis, the bottom axis, and the top axis. Subgroups
688 and the number of parameters in each are as follows:
689 ´[AXIS/]LEFT.´ (23)
691 ´[AXIS/]RIGHT.´ (23)
692 ´[AXIS/]BOTTOM.´ (23)
693 ´[AXIS/]TOP.´ (23)
694 The elements of the subgroups are interleaved in the group; that
696 is to say, the first elements of the four subgroups constitute
697 elements 1 through 4 of the group, the second elements of the
698 four subgroups constitute elements 5 through 8 of the group, and
699 so on.
700 ´[AXIS/]s.´
702 (where "s" means "any one of the keywords LEFT, RIGHT, BOTTOM,
703 or TOP".)
704 Simplest form of name: ´s.´
706 A group of 23 parameters describing the axis specified by "s".
708 Subgroups and the number of parameters in each are as follows:
709 ´[AXIS/]s/CONTROL.´ (1)
711 ´[AXIS/]s/LINE.´ (1)
712 ´[AXIS/]s/INTERSECTION.´ (2)
713 ´[AXIS/]s/FUNCTION.´ (1)
714 ´[AXIS/]s/TICKS.´ (10)
715 ´[AXIS/]s/NUMERIC.´ (8)
716 ´[AXIS/]s/CONTROL.´
718 Simplest form of name: ´s/CO.´
719 An integral real number having one of the values "-1.", "0.",
721 "1.", "2.", "3.", or "4." and controlling certain aspects of the
722 drawing of the axis specified by "s", as follows:
723 · The value "-1." specifies that only the line portion of
725 the axis may be drawn; tick marks and numeric labels are
726 suppressed.
727 · The value "0." specifies that no portion of the axis may
729 be drawn.
730 · A positive value specifies that all portions of the axis
732 may be drawn and specifies what actions Autograph may
733 take to prevent numeric-label overlap problems, as
734 follows:
735 · The value "1." specifies that numeric labels may not be
737 shrunk or rotated.
738 · The value "2." specifies that numeric labels may be
740 shrunk, but not rotated.
741 · The value "3." specifies that numeric labels may be
743 rotated, but not shrunk.
744 · The value "4." specifies that numeric labels may be both
746 shrunk and/or rotated.
747 Default value: "4." for all "s" (all axes drawn, numeric labels
749 may be shrunk and/or rotated).
750 ´[AXIS/]s/LINE.´
752 Simplest form of name: ´s/LI.´
753 An integral real number having one of the values "0." or "1.":
755 · The value "0." specifies that the line portion of the
757 axis specified by "s" may be drawn.
758 · The value "1." suppresses the line portion of the axis
760 specified by "s".
761 Default value: "0." for all "s" (line portions of all axes may
763 be drawn).
764 ´[AXIS/]s/INTERSECTION.´
766 Simplest form of name: ´s/IN.´
767 A group of two parameters
769 ´[AXIS/]s/INTERSECTION/GRID.´
771 ´[AXIS/]s/INTERSECTION/USER.´
772 each having the default value "1.E36" ("null 1"). Giving either
774 of them a non-null value causes the axis specified by "s" to be
775 moved away from its normal position on one edge of the grid
776 window. If both are given non-null values, ´.../USER.´ takes
777 precedence over ´.../GRID.´.
778 If the left Y axis or the right Y axis is moved, it remains
780 vertical, but intersects the bottom of the grid window at a
781 specified X coordinate. Similarly, if the bottom X axis or the
782 top X axis is moved, it remains horizontal, but intersects the
783 left edge of the grid at a specified Y coordinate.
784 No axis may be moved outside the current graph window; if an
786 attempt is made to do so, the axis is moved as far as the edge
787 and no farther.
788 ´[AXIS/]s/INTERSECTION/GRID.´
790 Simplest form of name: ´s/IN/GR.´
791 A real number which, if not equal to the current "null 1",
793 specifies, in the grid coordinate system, the X coordinate (if
794 "s" = "LEFT" or "RIGHT") or the Y coordinate (if "s" = "BOTTOM"
795 or "TOP") of the point of intersection of the axis specified by
796 "s" with the perpendicular sides of the grid window.
797 Default value: "1.E36" ("null 1") for all "s" (axes lie on the
799 edges of the grid window).
800 ´[AXIS/]s/INTERSECTION/USER.´
802 Simplest form of name: ´s/IN/US.´
803 A real number which, if not equal to the current "null 1",
805 specifies, in the user coordinate system, the X coordinate (if
806 "s" = "LEFT" or "RIGHT") or the Y coordinate (if "s" = "BOTTOM"
807 or "TOP") of the point of intersection of the axis specified by
808 "s" with the perpendicular sides of the grid window.
809 Default value: "1.E36" ("null 1") for all "s" (axes lie on the
811 edges of the grid window).
812 ´[AXIS/]s/FUNCTION.´
814 Simplest form of name: ´s/FU.´
815 A real number, passed as an argument to the subroutine AGUTOL;
817 this subroutine defines the user-system-to-label-system
818 mappings, and thus the label coordinate systems, for all the
819 axes. The default version of AGUTOL defines the identity mapping
820 for all axes; a user version may be substituted to define any
821 desired set of mappings. It is intended that ´AXIS/s/FUNCTION.´
822 be used within a user version of AGUTOL as a function selector.
823 It is further recommended that the value "0." select the
824 identity mapping, thus providing a way to re-create the default
825 situation.
826 Tick marks on the axis specified by "s" are positioned in the
828 label coordinate system. Numeric labels on the axis give values
829 in the label coordinate system.
830 See the AGUTOL man page.
832 Default value: "0." for all "s" (identity mapping for all axes).
834 ´[AXIS/]s/TICKS.´
836 Simplest form of name: ´s/TI.´
837 A group of ten parameters describing the tick marks, if any,
839 which are to be a part of the axis specified by "s". Subgroups
840 and the number of parameters in each are as follows:
841 ´[AXIS/]s/[TICKS/]MAJOR.´ (6)
843 ´[AXIS/]s/[TICKS/]MINOR.´ (4)
844 ´[AXIS/]s/[TICKS/]MAJOR.´
846 Simplest form of name: ´s/MA.´
847 A group of six parameters describing the major tick marks, if
849 any, which are to be a part of the axis specified by "s".
850 Subgroups and the number of parameters in each are as follows:
851 ´[AXIS/]s/[TICKS/]MAJOR/SPACING.´ (3)
853 ´[AXIS/]s/[TICKS/]MAJOR/PATTERN.´ (1)
854 ´[AXIS/]s/[TICKS/]MAJOR/LENGTH.´ (2)
855 ´[AXIS/]s/[TICKS/]MAJOR/SPACING.´
857 Simplest form of name: ´s/MA/SP.´
858 A group of three parameters describing the way in which major
860 tick marks, if any, are to be spaced along the axis specified by
861 "s". Subgroups and the number of parameters in each are as
862 follows:
863 ´[AXIS/]s/[TICKS/]MAJOR/[SPACING/]TYPE.´ (1)
865 ´[AXIS/]s/[TICKS/]MAJOR/[SPACING/]BASE.´ (1)
866 ´[AXIS/]s/[TICKS/]MAJOR/[SPACING/]COUNT.´ (1)
867 ´[AXIS/]s/[TICKS/]MAJOR/[SPACING/]TYPE.´
869 Simplest form of name: ´s/MA/TY.´
870 A real number specifying where major tick marks are to be placed
872 along the axis specified by "s" (that is to say, at what values
873 in the label coordinate system along that axis). Let "b"
874 represent the value of the parameter ´.../BASE.´ (described
875 next) and "k" represent an arbitrary integer. Then, there are
876 six acceptable values of ´.../TYPE.´:
877 · The value "0." specifies that no major tick marks are to
879 be drawn on the axis.
880 · The value "1." specifies major tick marks at values of
882 the form plus or minus b times k.
883 · The value "2." specifies major tick marks at values of
885 the form plus or minus b times 10 to the power k.
886 · The value "3." specifies major tick marks at values of
888 the form plus or minus b to the power k.
889 · The value "null 1" specifies that Autograph should use a
891 value "1.", "2.", or "3." - whichever it considers best.
892 · The value "null 2" specifies that Autograph should use a
894 value "1.", "2.", or "3." - whichever it considers best -
895 and replace the "null 2" by that value.
896 Notice that major tick marks on a linear axis may be spaced
898 logarithmically and that major tick marks on a logarithmic axis
899 may be spaced linearly; this is sometimes useful.
900 Default value: "1.E36" ("null 1") for all "s" (Autograph spaces
902 major tick marks as it sees fit).
903 ´[AXIS/]s/[TICKS/]MAJOR/[SPACING/]BASE.´
905 Simplest form of name: ´s/MA/BA.´
906 A real number which, if greater than zero and non-null,
908 specifies the base value ("b", in the preceding parameter
909 description) used in spacing major tick marks in the label
910 coordinate system along the axis specified by "s". A negative or
911 zero value suppresses major tick marks on the axis. A null value
912 causes Autograph to pick an appropriate base value and, if the
913 null was a "null 2", to backstore that value in place of the
914 "null 2".
915 Default value: "1.E36" ("null 1") for all "s" (Autograph picks
917 the base values).
918 ´[AXIS/]s/[TICKS/]MAJOR/[SPACING/]COUNT.´
920 Simplest form of name: ´s/MA/CO.´
921 A real number, having an integral value "n" greater than or
923 equal to 0. A negative value is treated as if it were a zero.
924 The value n is only used when major tick marks are to be spaced
925 linearly and the base value ("b", in the preceding parameter
926 descriptions) is to be chosen by Autograph. In this case, n is a
927 rough estimate of the minimum number of major tick marks to be
928 placed on the axis specified by "s". The actual number used may
929 vary between "n+2" and "5n/2+4" (approximately).
930 Default value: "6." for all "s" (somewhere between 8 and 19
932 major tick marks per linear axis).
933 ´[AXIS/]s/[TICKS/]MAJOR/PATTERN.´
935 Simplest form of name: ´s/MA/PA.´
936 A real number specifying the dashed-line pattern to be used for
938 major tick marks on the axis specified by "s". Normally, its
939 integer equivalent is a 16-bit integer in which "0" bits specify
940 "pen-up" segments (gaps) 3 plotter units long and "1" bits
941 specify "pen-down" segments (solids) 3 plotter units long. The
942 value "0." turns off the major tick marks, the value "65535."
943 (decimal) = "177777." (octal) makes them solid lines. If the
944 value "null 1" is used, the next call to AGSTUP resets it to
945 "65535." (decimal).
946 Default value: "1.E36" ("null 1") for all "s" (solid-line
948 patterns).
949 ´[AXIS/]s/[TICKS/]MAJOR/LENGTH.´
951 Simplest form of name: ´s/MA/LE.´
952 A group of two parameters determining the length of the outward-
954 pointing and inward-pointing portions of the major tick marks on
955 the axis specified by "s". Subgroups and the number of
956 parameters in each are as follows:
957 ´[AXIS/]s/[TICKS/]MAJOR/[LENGTH/]OUTWARD.´ (1)
959 ´[AXIS/]s/[TICKS/]MAJOR/[LENGTH/]INWARD.´ (1)
960 ´[AXIS/]s/[TICKS/]MAJOR/[LENGTH/]OUTWARD.´
962 Simplest form of name: ´s/MA/OU.´
963 A real number specifying the length of the outward-pointing
965 portion of each major tick mark on the axis specified by "s".
966 The value must be of the form "e", "1.+e", or "-e", where "e" is
967 greater than or equal to "0." and less than "1." and represents
968 a fraction of the smaller dimension of the grid window.
969 Note: "Outward" is defined relative to the normal position of
971 the axis "s", even when that axis has been moved away from its
972 normal position.
973 · When a value "e" is used, each major tick mark extends
975 outward "e" units from the axis.
976 · When a value "1.+e" is used, each major tick mark extends
978 outward to the farther edge of the grid window and then
979 "e" units beyond that edge. (If the axis is not moved
980 away from its normal position, "1.+e" has the same effect
981 as "e".)
982 · When a value "-e" is used, the first "e" units of the
984 inward-pointing portion of each major tick mark are
985 erased. (This can be used to create off-axis major tick
986 marks - for whatever that may be worth.)
987 Default value: "0." for all "s" (all major ticks point inward).
989 ´[AXIS/]s/[TICKS/]MAJOR/[LENGTH/]INWARD.´
991 Simplest form of name: ´s/MA/IN.´
992 A real number specifying the length of the inward-pointing
994 portion of each tick mark on the axis specified by "s". The
995 value must be of the form "e", "1.+e", or "-e", where e is
996 greater than or equal to "0." and less than "1." and represents
997 a fraction of the smaller dimension of the grid window.
998 Note: "Inward" is defined relative to the normal position of
1000 the axis "s", even when that axis has been moved away from its
1001 normal position.
1002 · When a value "e" is used, each major tick mark extends
1004 inward "e" units from the axis.
1005 · When a value "1.+e" is used, each major tick mark extends
1007 inward to the farther edge of the grid window and then
1008 "e" units beyond that edge. This feature is used to
1009 create grid backgrounds.
1010 · When a value "-e" is used, the first "e" units of the
1012 outward-pointing portion of each major tick mark are
1013 erased.
1014 Default value: ".015" for all "s" (all major ticks point
1016 inward).
1017 ´[AXIS/]s/[TICKS/]MINOR.´
1019 Simplest form of name: ´s/MI.´
1020 A group of four parameters describing the minor tick marks, if
1022 any, which are to be a part of the axis specified by "s".
1023 Subgroups and the number of parameters in each are as follows:
1024 ´[AXIS/]s/[TICKS/]MINOR/SPACING.´ (1)
1026 ´[AXIS/]s/[TICKS/]MINOR/PATTERN.´ (1)
1027 ´[AXIS/]s/[TICKS/]MINOR/LENGTH.´ (2)
1028 ´[AXIS/]s/[TICKS/]MINOR/SPACING.´
1030 Simplest form of name: ´s/MI/SP.´
1031 A real number specifying the desired number of minor tick marks
1033 to be distributed between each pair of major tick marks on the
1034 axis specified by "s". Acceptable values are as follows:
1035 · A value less than "1." suppresses minor tick marks
1037 completely.
1038 · A value greater than or equal to "1." which is non-
1040 null should be integral; it specifies the number of
1041 minor tick marks directly.
1042 · The values "null 1" and "null 2" specify that
1044 Autograph is to choose a reasonable integral value; if
1045 a "null 2" is specified, it is replaced by the
1046 integral value chosen.
1047 The minor tick marks, if any, are spaced linearly in the label
1049 coordinate system along the axis specified by "s". Note that
1050 the appropriate value for the usual sort of logarithmic axis is
1051 "8."; this causes the minor tick marks between two major tick
1052 marks at label-system values 10**n and 10**n+1 to be placed at
1053 the label-system values 2*10**n, 3*10**n, 4*10**n, . . .,
1054 9*10**n.
1055 Default value: "1.E36" ("null 1") for all "s" (Autograph chooses
1057 appropriate values).
1058 ´[AXIS/]s/[TICKS/]MINOR/PATTERN.´
1060 Simplest form of name: ´s/MI/PA.´
1061 A real number specifying the dashed-line pattern to be used for
1063 minor tick marks on the axis specified by "s"; analogous to
1064 ´[AXIS/]s/[TICKS/]MAJOR/PATTERN.´, described above.
1065 Default value: "1.E36" ("null 1") for all "s" (solid-line
1067 patterns).
1068 ´[AXIS/]s/[TICKS/]MINOR/LENGTH.´
1070 Simplest form of name: ´s/MI/LE.´
1071 A group of two parameters determining the length of the outward-
1073 pointing and inward-pointing portions of the minor tick marks on
1074 the axis specified by "s". Subgroups and the number of
1075 parameters in each are as follows:
1076 ´[AXIS/]s/[TICKS/]MINOR/[LENGTH/]OUTWARD.´ (1)
1078 ´[AXIS/]s/[TICKS/]MINOR/[LENGTH/]INWARD.´ (1)
1079 ´[AXIS/]s/[TICKS/]MINOR/[LENGTH/]OUTWARD.´
1081 Simplest form of name: ´s/MI/OU.´
1082 A real number specifying the length of the outward-pointing
1084 portion of each minor tick mark on the axis specified by "s";
1085 analogous to ´...MAJOR/[LENGTH/]OUTWARD.´, described above.
1086 Default value: "0." for all "s" (all minor ticks point inward).
1088 ´[AXIS/]s/[TICKS/]MINOR/[LENGTH/]INWARD.´
1090 Simplest form of name: ´s/MI/IN.´
1091 A real number specifying the length of the inward-pointing
1093 portion of each minor tick mark on the axis specified by "s";
1094 analogous to ´...MAJOR/[LENGTH/]INWARD.´, described above.
1095 Default value: ".010" for all "s" (all minor ticks point
1097 inward).
1098 ´[AXIS/]s/NUMERIC.´
1100 Simplest form of name: ´s/NU.´
1101 A group of eight parameters describing the numeric labels, if
1103 any, which are to be a part of the axis specified by "s".
1104 Subgroups and the number of parameters in each are as follows:
1105 ´[AXIS/]s/[NUMERIC/]TYPE.´ (1)
1107 ´[AXIS/]s/[NUMERIC/]EXPONENT.´ (1)
1108 ´[AXIS/]s/[NUMERIC/]FRACTION.´ (1)
1109 ´[AXIS/]s/[NUMERIC/]ANGLE.´ (2)
1110 ´[AXIS/]s/[NUMERIC/]OFFSET.´ (1)
1111 ´[AXIS/]s/[NUMERIC/]WIDTH.´ (2)
1112 ´[AXIS/]s/[NUMERIC/]TYPE.´
1114 Simplest form of name: ´s/TY.´
1115 The three parameters
1117 ´[AXIS/]s/[NUMERIC/]TYPE.´
1119 ´[AXIS/]s/[NUMERIC/]EXPONENT.´
1120 ´[AXIS/]s/[NUMERIC/]FRACTION.´
1121 will be described together, because they are so closely
1123 interdependent. They specify the type of numeric labels to be
1124 used (at major-tick positions) on the axis specified by "s". A
1125 fourth parameter,
1126 ´[AXIS/]s/[TICKS/]MAJOR/[SPACING/]TYPE.´,
1128 described above, also affects the type of numeric labels to be
1130 used. I shall refer to these four parameters in the ensuing
1131 discussion using short forms of their names (´s/ TYPE.´,
1132 ´s/EXPO.´, ´s/FRAC.´, and ´s/MAJOR/TYPE.´, respectively).
1133 All four have the default value "null 1" (except for the first,
1135 which has the default value "0." for "s" = "RIGHT" and "TOP"),
1136 leaving Autograph free to choose values which are consistent
1137 with each other and with other parameters describing the axis
1138 specified by "s". Any one or more of them may be given the value
1139 "null 2" (in which case an actual value chosen by Autograph is
1140 backstored over the "null 2") or an actual integral real value.
1141 Setting ´s/TYPE.´ to "0.":
1143 This turns off the numeric labels on the axis specified by "s".
1145 The other three parameters are then ignored.
1146 Setting ´s/TYPE.´ to "1.":
1148 This selects "scientific" notation. Each numeric label is
1150 written in the form
1151 [-] [i] [.] [f] x 10 e
1153 where brackets enclose portions which may be independently
1155 present or absent and "e" is a superscript exponent.
1156 The parameter ´s/EXPO.´ specifies the length of "i" (the number
1158 of characters), thus also specifying the value of the exponent
1159 "e". If ´s/EXPO.´ has a value less than or equal to zero, "i" is
1160 omitted. If ´s/EXPO.´ is less than zero and has the integral
1161 absolute value "n", the fraction "f" is forced to have "n"
1162 leading zeroes.
1163 The parameter ´s/FRAC.´ specifies the length of "f" (the number
1165 of characters). If ´s/FRAC.´ is less than or equal to zero, "f"
1166 is omitted. If ´s/FRAC.´ is less than zero, the decimal point is
1167 omitted.
1168 If "[i] [.] [f]" has the value "1.", the first part of the label
1170 is omitted, leaving only "10 e".
1171 If the entire label has the value "0.", the single character "0"
1173 is used.
1174 The value of ´s/MAJOR/TYPE.´ is immaterial.
1176 Setting ´s/TYPE.´ to "2.":
1178 This selects "exponential" notation, the exact nature of which
1180 depends on the value of ´s/MAJOR/TYPE.´, as follows:
1181 · If ´s/MAJOR/TYPE.´ has the value "1." (all major ticks at
1183 values of the form plus or minus b times k), each numeric
1184 label is written in the form
1185 [-] [i] [.] [f] x 10 e
1187 where brackets enclose portions which may be
1189 independently present or absent and "e" is a superscript
1190 exponent.
1191 The parameter ´s/EXPO.´ specifies the integral value of
1193 the exponent "e".
1194 The parameter ´s/FRAC.´ specifies the length of "f" (the
1196 number of characters). If ´s/FRAC.´ is less than or equal
1197 to zero, f is omitted. If ´s/FRAC.´ is less than zero,
1198 the decimal point is omitted.
1199 If the label value is exactly zero, the single character
1201 "0" is used.
1202 · If ´s/MAJOR/TYPE.´ has the value "2." (all major ticks at
1204 values of the form plus or minus b times 10 to the power
1205 k), each numeric label is written in the form
1206 [-] [i] [.] [f] x 10 e
1208 where brackets enclose portions which may be
1210 independently present or absent and "e" is a superscript
1211 exponent.
1212 The parameter ´s/EXPO.´ specifies the integral value of
1214 the exponent "e" when "k" equals "0." The value of "e" is
1215 ´s/EXPO.´ plus "k".
1216 The parameter ´s/FRAC.´ specifies the length of "f" (the
1218 number of characters). If ´s/FRAC.´ is less than or equal
1219 to zero, "f" is omitted. If ´s/FRAC.´ is less than zero,
1220 the decimal point is omitted.
1221 If the label value is exactly zero, the single character
1223 "0" is used.
1224 · If ´s/MAJOR/TYPE.´ has the value "3." (all major ticks at
1226 values of the form plus or minus b to the power k), each
1227 numeric label is written in the form
1228 [-] [i] [.] [f] e
1230 where brackets enclose portions which may be
1232 independently present or absent and "e" is a superscript
1233 exponent.
1234 The parameter ´s/EXPO.´ is ignored. The value of "e" is
1236 "k".
1237 The parameter ´s/FRAC.´ specifies the length of "f" (the
1239 number of characters). If ´s/FRAC.´ is less than or equal
1240 to zero, "f" is omitted. If ´s/FRAC.´ is less than zero,
1241 the decimal point is omitted.
1242 Note that "[i] [.] [f]" expresses the value of "b".
1244 Setting ´s/TYPE.´ to "3.":
1246 This selects "no-exponent" notation, the exact nature of which
1248 depends on the value of ´s/MAJOR/TYPE.´, as follows:
1249 · If ´s/MAJOR/TYPE.´ has the value "1." (all major ticks at
1251 values of the form plus or minus b times k), each numeric
1252 label is written in the form
1253 [-] [i] [.] [f]
1255 where brackets enclose portions which may be
1257 independently present or absent.
1258 The parameter ´s/EXPO.´ is ignored.
1260 The parameter ´s/FRAC.´ specifies the length of "f" (the
1262 number of characters). If ´s/FRAC.´ is less than or equal
1263 to zero, "f" is omitted. If ´s/FRAC.´ is less than zero,
1264 the decimal point is omitted.
1265 If the label value is exactly zero, the single character
1267 "0" is used.
1268 · If ´s/MAJOR/TYPE.´ has the value "2." (all major ticks at
1270 values of the form plus or minus b times 10 to the power
1271 k), each numeric label is written in the form
1272 [-] [i] [.] [f]
1274 where brackets enclose portions which may be
1276 independently present or absent.
1277 The parameter ´s/EXPO.´ is ignored.
1279 The length of "f" (the number of characters) is specified
1281 by the function
1282 MAX(´s/FRAC.´,0) - k
1284 if this quantity is greater than zero, and
1286 MIN(´s/FRAC.´,0)
1288 otherwise. This may appear somewhat formidable, but it
1290 produces a simple, desirable result. Suppose, for
1291 example, that ´s/FRAC.´ = "1.", "b" = "3.6", and "k"
1292 ranges from "-3" to "+3"; the labels produced are
1293 .0036, .036, .36, 3.6, 36., 360., and 3600.
1295 The parameter ´s/FRAC.´ may be viewed as specifying the
1297 length of "f" when "k" is zero. If the function value is
1298 less than or equal to zero, "f" is omitted; if it is less
1299 than zero, the decimal point is omitted.
1300 · If ´s/MAJOR/TYPE.´ has the value "3." (all major ticks at
1302 values of the form plus or minus b to the power k), each
1303 numeric label is written in the form
1304 [-] [i] [.] [f]
1306 if "k" is greater than or equal to zero, and in the form
1308 [-] 1/ [i] [.] [f]
1310 if "k" is less than zero. Brackets enclose portions which
1312 may be independently present or absent.
1313 The parameter ´s/EXPO.´ is ignored.
1315 The length of "f" (the number of characters) is specified
1317 by the function
1318 ´s/FRAC.´ * ABS(k)
1320 if "k" is non-zero, or
1322 MIN(´s/FRAC.´,0)
1324 if "k" is zero. Again, this function produces a simple
1326 result. Suppose that ´s/FRAC.´ = "1.", "b" = "1.1", and
1327 "k" ranges from "-3" to "+3"; the labels produced are
1328 1/1.331, 1/1.21, 1/1.1, 1., 1.1, 1.21, and 1.331
1330 The parameter ´s/FRAC.´ may be viewed as specifying the
1332 length of "f" when "k" is equal to 1. If the function
1333 value is less than or equal to zero, "f" is omitted; if
1334 it is less than zero, the decimal point is omitted.
1335 Another example: Suppose ´s/FRAC.´ = "-1.", "b" = "2.",
1337 and "k" ranges from "-4" to "+4"; the labels produced are
1338 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, and 16
1340 Default value: "1.E36" ("null 1") for all three for all
1342 "s" (Autograph chooses values to use), except for
1343 ´RIGHT/[NUMERIC/]TYPE.´ and
1345 ´TOP/[NUMERIC/]TYPE.´,
1346 which are zeroed to suppress the numeric labels on the
1348 right and top axes.
1349 ´[AXIS/]s/[NUMERIC/]EXPONENT.´
1351 Simplest form of name: ´s/EX.´
1352 See the discussion of ´[AXIS/]s/[NUMERIC/]TYPE.´, above.
1354 ´[AXIS/]s/[NUMERIC/]FRACTION.´
1356 Simplest form of name: ´s/FR.´
1357 See the discussion of ´[AXIS/]s/[NUMERIC/]TYPE.´, above.
1359 ´[AXIS/]s/[NUMERIC/]ANGLE.´
1361 Simplest form of name: ´s/AN.´
1362 A group of two integral real numbers specifying the orientation
1364 angle of numeric labels on the axis specified by "s". Subgroups
1365 and the number of parameters in each are as follows:
1366 ´[AXIS/]s/[NUMERIC/]ANGLE/1ST.´ (1)
1368 ´[AXIS/]s/[NUMERIC/]ANGLE/2ND.´ (1)
1369 ´[AXIS/]s/[NUMERIC/]ANGLE/1ST.´
1371 Simplest form of name: ´s/AN/1S.´
1372 An integral real number having one of the values "0.", "90.",
1374 "180.", or "270." (plus or minus a small multiple of "360."),
1375 specifying the user´s first choice for the orientation angle of
1376 numeric labels on the axis specified by "s". The value is stated
1377 in degrees counter-clockwise from a left-to-right horizontal
1378 vector.
1379 The routine AGSTUP decides whether the first choice or the
1381 second choice is to be used. The second choice is used only when
1382 the first choice leads to overlap problems and the current value
1383 of ´[AXIS/]s/CONTROL.´ is a "3." or a "4." and the second
1384 choice works out better than the first. If AGSTUP decides to use
1385 the first choice, it leaves the first-choice parameter with a
1386 positive value; if it decides to use the second choice, it
1387 leaves the first-choice parameter with a negative value. Values
1388 are made positive or negative by adding and subtracting
1389 multiples of "360.".
1390 Default value: "0." for all "s" (horizontal labels preferred on
1392 all axes).
1393 ´[AXIS/]s/[NUMERIC/]ANGLE/2ND.´
1395 Simplest form of name: ´s/AN/2N.´
1396 An integral real number having one of the values "0.", "90.",
1398 "180.", or "270." (plus or minus a small multiple of "360."),
1399 specifying the user´s second choice for the orientation angle of
1400 numeric labels on the axis specified by "s". The value is stated
1401 in degrees counter-clockwise from a left-to-right horizontal
1402 vector. See the description of the preceding parameter.
1403 Default value: "90." for all "s" (vertical labels, readable from
1405 the right, on all axes).
1406 ´[AXIS/]s/[NUMERIC/]OFFSET.´
1408 Simplest form of name: ´s/OF.´
1409 A real number specifying the desired position of numeric labels
1411 relative to the axis specified by "s".
1412 If the value is positive, numeric labels are to be placed toward
1414 the outside of the grid. If the value is negative, numeric
1415 labels are to be placed toward the inside of the grid. In either
1416 of these two cases, the magnitude of the value specifies the
1417 distance from the line portion of the axis to the nearest part
1418 of any numeric label, stated as a fraction of the smaller
1419 dimension of the grid window. Note: "Inside" and "outside" are
1420 defined relative to the normal position of the axis "s", even
1421 when that axis has been moved away from its normal position.
1422 If the value is exactly zero, each numeric label is centered on
1424 the axis. In this case, the line portion of the axis is
1425 suppressed and major and minor tick marks are moved outward so
1426 as not to overlap the numeric labels.
1427 Default value: ".015" for all "s" (all labels outside the grid).
1429 ´[AXIS/]s/[NUMERIC/]WIDTH.´
1431 Simplest form of name: ´s/WI.´
1432 A group of two real parameters specifying the widths of
1434 characters to be used in numeric labels on the axis specified by
1435 "s". Subgroups and the number of parameters in each are as
1436 follows:
1437 ´[AXIS/]s/[NUMERIC/]WIDTH/MANTISSA.´ (1)
1439 ´[AXIS/]s/[NUMERIC/]WIDTH/EXPONENT.´ (1)
1440 ´[AXIS/]s/[NUMERIC/]WIDTH/MANTISSA.´
1442 Simplest form of name: ´s/WI/MA.´
1443 A real number specifying the width of characters to be used in
1445 the "mantissa" of each numeric label on the axis specified by
1446 "s", expressed as a fraction of the smaller dimension of the
1447 grid window.
1448 Default value: ".015" for all "s".
1450 ´[AXIS/]s/[NUMERIC/]WIDTH/EXPONENT.´
1452 Simplest form of name: ´s/WI/EX.´
1453 A real number specifying the width of characters to be used in
1455 the exponent of each numeric label on the axis specified by "s",
1456 expressed as a fraction of the smaller dimension of the grid
1457 window.
1458 Default value: ".010" for all "s".
1460 ´DASH.´
1462 Simplest form of name: ´DAS.´
1463 A group of thirty parameters, the first of which determines what
1465 dashed-line patterns are to be used by the routines EZMY and
1466 EZMXY and the rest of which describe the "user" set of dashed-
1467 line patterns (as opposed to the "alphabetic" set, which is
1468 defined by code in the subroutine AGCURV and is not subject to
1469 change by the user). Subgroups and the number of parameters in
1470 each are as follows:
1471 ´DASH/SELECTOR.´ (1)
1473 ´DASH/LENGTH.´ (1)
1474 ´DASH/CHARACTER.´ (1)
1475 ´DASH/DOLLAR-QUOTE.´ (1)
1476 ´DASH/PATTERNS.´ (26)
1477 ´DASH/SELECTOR.´
1479 Simplest form of name: ´DAS/SE.´
1480 The parameter ´DASH/SELECTOR.´ is given a negative integral
1482 value to specify that the routines EZMY and EZMXY should use the
1483 "alphabetic" set of 26 dashed-line patterns for the curves they
1484 draw and a positive integral value "n", less than or equal to
1485 26, to specify that EZMY and EZMXY should use the first "n"
1486 patterns in the "user" set of dashed-line patterns, as defined
1487 by the current values of the remaining parameters in the group
1488 ´DASH.´.
1489 Each of the patterns in the "alphabetic" set specifies a solid
1491 line interrupted periodically by a letter of the alphabet. Each
1492 of the patterns in the "user" set is as defined by the user. The
1493 default "user" set produces all solid lines.
1494 The routines EZY and EZXY, which draw but one curve per call,
1496 always use the first of the patterns in the "user" set; they are
1497 unaffected by the value of ´DASH/SELECTOR.´.
1498 The selected pattern set is used in a circular fashion. For
1500 example, if ´DASH/SELECTOR.´ has the value "3." and EZMY is used
1501 to draw nine curves, pattern 1 is used for curves 1, 4, and 7,
1502 pattern 2 for curves 2, 5, and 8, and pattern 3 for curves 3, 6,
1503 and 9.
1504 Default value: "+1." (The first element of the "user" set of
1506 dashed-line patterns is to be used by EZMY and EZMXY.)
1507 ´DASH/LENGTH.´
1509 Simplest form of name: ´DAS/LE.´
1510 An integral real number specifying how long character-string
1512 dashed-line patterns are expected to be. In a user call to
1513 ANOTAT with a positive fifth argument (implying that the sixth
1514 argument is an array of character-string dashed-line patterns)
1515 or in a user call to AGSETC setting ´DASH/PATTERN/n.´ (in which
1516 case the second argument is such a pattern), the specified
1517 character strings must be of the length specified by the current
1518 value of ´DASH/LENGTH.´.
1519 Default value: "8." (dashed-line patterns are expected to be
1521 eight characters long).
1522 ´DASH/CHARACTER.´
1524 Simplest form of name: ´DAS/CH.´
1525 A real number specifying the width of each character (other than
1527 a dollar sign or a quote) which is drawn along a curve as
1528 directed by a character-string dashed-line pattern (whether from
1529 the "alphabetic" set or from the "user" set). This width is
1530 expressed as a fraction of the smaller dimension of the grid
1531 window.
1532 Default value: ".010"
1534 ´DASH/DOLLAR-QUOTE.´
1536 Simplest form of name: ´DAS/DO.´
1537 A real number specifying the line length corresponding to a
1539 dollar sign (solid) or a quote (gap) in a character-string
1540 dashed-line pattern, expressed as a fraction of the smaller
1541 dimension of the grid window.
1542 Default value: ".010"
1544 ´DASH/PATTERNS.´
1546 Simplest form of name: ´DAS/PA.´
1547 A group of 26 parameters defining the "user" set of dashed-line
1549 patterns. Subgroups and the number of parameters in each are as
1550 follows:
1551 ´DASH/PATTERNS/1.´ (1)
1553 ´DASH/PATTERNS/2.´ (1)
1554 .
1555 .
1556 .
1557 ´DASH/PATTERNS/26.´ (1)
1558 ´DASH/PATTERNS/n.´
1560 Simplest form of name: ´DAS/PA/n.´
1561 (The symbol "n" represents an integer between "1" and "26",
1563 inclusive.) An integral real number defining the "n"th dashed-
1564 line pattern in the "user" set.
1565 If the value is positive, it must be between "0." and "65535.",
1567 inclusive, and is interpreted as a 16-bit binary pattern in
1568 which each "0" bit specifies a "pen-up" gap segment 3 plotter
1569 units long and each "1" bit specifies a "pen-down" solid segment
1570 3 plotter units long. Such a pattern may be defined by a user
1571 call to AGSETF, AGSETI, or AGSETR.
1572 If the value is negative, it serves as an identifier, allowing
1574 Autograph to retrieve, from its character storage space, a
1575 character string in which each single quote specifies a "pen-up"
1576 gap segment, each dollar sign specifies a "pen-down" solid
1577 segment, and each other character is simply to be drawn as a
1578 part of the line. Such a pattern may be defined by a user call
1579 to AGSETC.
1580 Note that the function "AGDSHN" allows a user to easily generate
1582 the name of the "n"th dash pattern.
1583 Default values: "65535." for all "n" (solid lines).
1585 ´LABEL.´
1587 Simplest form of name: ´LAB.´
1588 A group of 3+10n parameters, where "n" is the current value of
1590 ´LABEL/BUFFER/LENGTH.´ (8, by default) describing up to "n"
1591 informational labels. These labels are a part of the background
1592 drawn by a call to the routine AGBACK. Subgroups and the number
1593 of parameters in each are as follows:
1594 ´LABEL/CONTROL.´ (1)
1596 ´LABEL/BUFFER/LENGTH.´ (1)
1597 ´LABEL/BUFFER/CONTENTS.´ (10n)
1598 ´LABEL/NAME.´ (1)
1599 ´LABEL/CONTROL.´
1601 Simplest form of name: ´LAB/CO.´
1602 An integral real number having the value "0.", "1.", or "2.".
1604 Values greater than "2." are changed to a "2." by the next
1605 AGSTUP call. Values less than "0." are changed to a "0." by the
1606 next AGSTUP call; negative values have a special use, however
1607 (see below).
1608 · The value "0." disables the drawing of informational
1610 labels. They remain defined, however.
1611 · The value "1." enables the drawing of informational
1613 labels and specifies that they may not be shrunk in
1614 response to overlap problems.
1615 · The value "2." enables the drawing of informational
1617 labels and specifies that they may be shrunk in response
1618 to overlap problems.
1619 Default value: "2." (labels enabled, shrinkable).
1621 Special action by AGSETP: An AGSETP call which sets this
1623 parameter (individually, rather than as part of a group) to a
1624 negative value results in the deletion of all currently defined
1625 labels. Note that the negative value is changed to a zero by the
1626 next AGSTUP call; thus, the drawing of informational labels is
1627 disabled until re-enabled by the user.
1628 ´LABEL/BUFFER.´
1630 Simplest form of name: ´LAB/BU.´
1631 A group of 1+10n parameters, where "n" is the current value of
1633 ´LABEL/BUFFER/LENGTH.´ (8, by default). Subgroups and the number
1634 of parameters in each are as follows:
1635 ´LABEL/BUFFER/LENGTH.´ (1)
1637 ´LABEL/BUFFER/CONTENTS.´ (10n)
1638 ´LABEL/BUFFER/LENGTH.´
1640 Simplest form of name: ´LAB/BU/LE.´
1641 An integral real number specifying the number of 10-word label
1643 definitions the label buffer will hold. A user program may need
1644 to retrieve, but must not set, the value of this parameter,
1645 since its value must match the second dimension of the label
1646 buffer.
1647 Increasing the size of the label buffer requires modifying the
1649 Autograph source code.
1650 Default value: "8.".
1652 ´LABEL/BUFFER/CONTENTS.´
1654 Simplest form of name: ´LAB/BU/CO.´
1655 This parameter group may be thought of as an array FLLB,
1657 dimensioned 10 x n, containing up to n 10-word label
1658 definitions. For a second subscript j,
1659 · FLLB(1,j) is either a real "0.", saying that no label is
1661 defined by this 10-word block, or it is non-zero, in
1662 which case it identifies a character string in
1663 Autograph´s character-string storage area; the character
1664 string serves as a name for the label defined by this
1665 10-word block. When FLLB(1,j) is non-zero:
1666 · FLLB(2,j) is either a "0.", to enable drawing of the
1668 label, or a "1.", to disable drawing of the label,
1669 · FLLB(3,j) and FLLB(4,j) are the X and Y coordinates of
1671 the label´s "basepoint", in the grid coordinate system,
1672 · FLLB(5,j) and FLLB(6,j) are the X and Y components of the
1674 label´s "offset vector", stated as signed fractions of
1675 the smaller dimension of the grid window,
1676 · FLLB(7,j) is an integral real number "0.", "90.", "180.",
1678 or "270.", specifying the angle at which the label´s
1679 "baseline" emanates from the end of its offset vector,
1680 · FLLB(8,j) is an integral real number specifying how the
1682 lines of the label are to be positioned relative to the
1683 end of the offset vector ("-1." to line up the left ends,
1684 "0." to line up the centers, or "+1." to line up the
1685 right ends),
1686 · FLLB(9,j) is an integral real count of the number of
1688 lines belonging to the label, and
1689 · FLLB(10,j) is an integral real pointer specifying the
1691 second subscript (in the line buffer) of the first line
1692 of the label (the one having the largest line number),
1693 or, if no lines belong to the label, a "0.".
1694 It is not recommended that a user program change the contents of
1696 this buffer directly. Label definitions should be accessed
1697 indirectly by means of the parameters ´LABEL/NAME.´ and
1698 ´LABEL/[DEFINITION/]...´.
1699 Default values: The label buffer contains four pre-defined
1701 labels, corresponding to the four edges of the grid window.
1702 They are as follows:
1703 Label name: ´L´ ´R´ ´B´
1706 Suppression flag: 0. 0. 0.
1708 Basepoint X: 0. 1. .5
1710 Basepoint Y: .5 .5 0.
1712 Offset X: -.015 +.015 0.
1714 Offset Y: 0. 0. -.015
1716 Baseline angle: 90. 90. 0.
1718 Centering option: 0. 0. 0.
1720 Line count: 1. 1. 1.
1722 First-line index: 1. 2. 3.
1724 The description of ´LINE/BUFFER/CONTENTS.´, below, gives the
1726 default values for the definitions of the lines which belong to
1727 these labels.
1728 ´LABEL/BUFFER/NAMES.´
1730 Simplest form of name: ´LAB/BU/NA.´
1731 This group is a subset of the previous one. It provides a way of
1733 retrieving the names of all currently-defined labels.
1734 ´LABEL/NAME.´
1736 Simplest form of name: ´LAB/NA.´
1737 An integral real pointer which, if non-zero, specifies a
1739 particular label in the label buffer - the one which is to be
1740 referenced by the parameter group ´LABEL/DEFINITION.´ (which
1741 see, below).
1742 Setting ´LABEL/NAME.´ is the required first step in accessing a
1744 particular label definition.
1745 Default value: "0." (undefined).
1747 Special action by AGSETP: To access the definition of a
1749 particular label, one must first call AGSETC with ´LABEL/NAME.´
1750 as the first argument and the name of the label one wishes to
1751 access as the second argument. This causes AGSETP (which is
1752 called by AGSETC) to search for the definition of the desired
1753 label in the label buffer. If that definition is not found, a
1754 new one is made up and inserted in the label buffer. In either
1755 case, ´LABEL/NAME.´ is given a real value whose integer
1756 equivalent specifies the second subscript of the label
1757 definition in the label buffer.
1758 The definition of a new label has the name specified by the
1760 user, a suppression flag "0.", a basepoint (.5,.5), an offset
1761 vector (0.,0.), a baseline angle "0.", a centering option "0.",
1762 a line count "0.", and a first-line index "0.".
1763 ´LABEL/DEFINITION.´
1765 Simplest form of name: ´LAB/DE.´
1766 A set of nine parameters defining the label specified by the
1768 current value of ´LABEL/NAME.´. If ´LABEL/NAME.´ has the value
1769 "0.", referencing this group or a parameter in it causes an
1770 error exit. Subgroups and the number of parameters in each are
1771 as follows:
1772 ´LABEL/[DEFINITION/]SUPPRESSION.´ (1)
1774 ´LABEL/[DEFINITION/]BASEPOINT.´ (2)
1775 ´LABEL/[DEFINITION/]OFFSET.´ (2)
1776 ´LABEL/[DEFINITION/]ANGLE.´ (1)
1777 ´LABEL/[DEFINITION/]CENTERING.´ (1)
1778 ´LABEL/[DEFINITION/]LINES.´ (1)
1779 ´LABEL/[DEFINITION/]INDEX.´ (1)
1780 ´LABEL/[DEFINITION/]SUPPRESSION.´
1782 Simplest form of name: ´LAB/SU.´
1783 An integral real "suppression flag" having the value "0." or
1785 "1." and specifying whether drawing of the label specified by
1786 ´LABEL/NAME.´ is enabled ("0.") or disabled ("1.").
1787 Default value for a new label: "0." (label enabled).
1789 Special action by AGSETP: If a user program attempts to set this
1791 parameter (individually, rather than as part of a group) to a
1792 negative value, the lines of the label specified by
1793 ´LABEL/NAME.´ are deleted and ´LINE/NUMBER.´ is zeroed. If the
1794 negative value is less than "-1.", the label is deleted as well
1795 and ´LABEL/NAME.´ is zeroed. (Deleting a label means that its
1796 name cell is set to "0.".)
1797 ´LABEL/[DEFINITION/]BASEPOINT.´
1799 Simplest form of name: ´LAB/BA.´
1800 A set of two parameters specifying the X and Y coordinates of
1802 the basepoint of the label specified by ´LABEL/NAME.´, in the
1803 grid coordinate system. The label is positioned relative to this
1804 basepoint. Subgroups and the number of parameters in each are as
1805 follows:
1806 ´LABEL/[DEFINITION/]BASEPOINT/X.´ (1)
1808 ´LABEL/[DEFINITION/]BASEPOINT/Y.´ (1)
1809 ´LABEL/[DEFINITION/]BASEPOINT/X.´
1811 Simplest form of name: ´LAB/BA/X.´
1812 The X coordinate of the basepoint of the label specified by
1814 ´LABEL/NAME.´. The value "0." refers to the left edge of the
1815 grid window, the value "1." to the right edge of the grid
1816 window.
1817 Default value for a new label: ".5" (centered).
1819 ´LABEL/[DEFINITION/]BASEPOINT/Y.´
1821 Simplest form of name: ´LAB/BA/Y.´
1822 The Y coordinate of the basepoint of the label specified by
1824 ´LABEL/NAME.´. The value "0." refers to the bottom edge of the
1825 grid window, the value "1." to the top edge of the grid window.
1826 Default value for a new label: ".5" (centered).
1828 ´LABEL/[DEFINITION/]OFFSET.´
1830 Simplest form of name: ´LAB/OF.´
1831 A set of two parameters specifying the X and Y components of the
1833 offset vector of the label specified by ´LABEL/NAME.´, as signed
1834 fractions of the smaller dimension of the grid window. The
1835 offset vector has its basepoint at the label basepoint.
1836 Subgroups and the number of parameters in each are as follows:
1837 ´LABEL/[DEFINITION/]OFFSET/X.´ (1)
1839 ´LABEL/[DEFINITION/]OFFSET/Y.´ (1)
1840 ´LABEL/[DEFINITION/]OFFSET/X.´
1842 Simplest form of name: ´LAB/OF/X.´
1843 The X component of the offset vector of the label specified by
1845 ´LABEL/NAME.´ - negative toward the left edge, positive toward
1846 the right edge, of the grid window. The magnitude represents a
1847 fraction of the smaller dimension of the grid window.
1848 Default value for a new label: "0." (zero-length vector).
1850 ´LABEL/[DEFINITION/]OFFSET/Y.´
1852 Simplest form of name: ´LAB/OF/Y.´
1853 The Y component of the offset vector of the label specified by
1855 ´LABEL/NAME.´ - negative toward the bottom edge, positive toward
1856 the top edge, of the grid window. The magnitude represents a
1857 fraction of the smaller dimension of the grid window.
1858 Default value for a new label: "0." (zero-length vector).
1860 ´LABEL/[DEFINITION/]ANGLE.´
1862 Simplest form of name: ´LAB/AN.´
1863 An integral real number having one of the values "0.", "90.",
1865 "180.", or "270.", and specifying the direction in which the
1866 baseline of the label specified by ´LABEL/NAME.´ emanates from
1867 the end of its offset vector, measured counter-clockwise from a
1868 left-to-right horizontal vector. All the lines of a label are
1869 written parallel to its baseline and in the direction of the
1870 baseline.
1871 Default value for a new label: "0." (horizontal, left to right).
1873 ´LABEL/[DEFINITION/]CENTERING.´
1875 Simplest form of name: ´LAB/CE.´
1876 An integral real number specifying the alignment of the lines of
1878 the label specified by ´LABEL/NAME.´ with the end of its offset
1879 vector. A negative value aligns the left ends, a zero value the
1880 centers, and a positive value the right ends, of the lines.
1881 Default value for a new label: "0." (centers aligned).
1883 ´LABEL/[DEFINITION/]LINES.´
1885 Simplest form of name: ´LAB/LI.´
1886 An integral real number specifying the number of lines in the
1888 label specified by ´LABEL/NAME.´.
1889 This parameter is updated by Autograph as lines are added to or
1891 deleted from the label and should not be set by a user program.
1892 Default value for a new label: "0." (no lines).
1894 ´LABEL/[DEFINITION/]INDEX.´
1896 Simplest form of name: ´LAB/IN.´
1897 An integral real number specifying the second subscript (in the
1899 line buffer) of the first line belonging to the label specified
1900 by ´LABEL/NAME.´ - a zero if no line belongs to the label.
1901 This parameter is updated by Autograph as lines are added to or
1903 deleted from the label and should not be set by a user program.
1904 Default value for a new label: "0." (no lines).
1906 ´LINE.´
1908 Simplest form of name: ´LIN.´
1909 A group of 4+6n parameters, where "n" is the current value of
1911 ´LINE/BUFFER/LENGTH.´ (16, by default) describing up to "n"
1912 lines, each of which is a part of some informational label.
1913 Subgroups and the number of parameters in each are as follows:
1914 ´LINE/MAXIMUM.´ (1)
1916 ´LINE/END.´ (1)
1917 ´LINE/BUFFER/LENGTH.´ (1)
1918 ´LINE/BUFFER/CONTENTS.´ (6n)
1919 ´LINE/NUMBER.´ (1)
1920 ´LINE/MAXIMUM.´
1922 Simplest form of name: ´LIN/MA.´
1923 An integral real number specifying the assumed maximum length of
1925 a character string delivered to Autograph for use as the text of
1926 a label line. Such a character string may occur as the first
1927 argument of a call to ANOTAT (defining the text of line "100."
1928 in the label ´L´), as the second argument of a call to ANOTAT
1929 (defining the text of line "-100." in the label ´B´), as the
1930 last argument of a call to one of the routines EZY, EZXY, EZMY,
1931 or EZMXY (defining the text of line "100." in the label ´T´), or
1932 as the second argument of a call to AGSETC whose first argument
1933 is
1934 ´LINE/[DEFINITION/]TEXT.´
1936 (defining the text of any line). In each of these cases, the
1938 character string must be of the length specified by
1939 ´LINE/MAXIMUM.´ or shorter. If it is shorter, its last character
1940 must be the character specified by ´LINE/END.´, described below.
1941 This parameter may be given any desired non-negative integral
1943 value.
1944 Default value: "40.".
1946 ´LINE/END.´
1948 Simplest form of name: ´LIN/EN.´
1949 A character string whose first character is the one used to mark
1951 the end of a character string defining the text of a label line
1952 (in calls to ANOTAT, EZY, EZXY, EZMY, EZMXY, and AGSETC), when
1953 that character string is shorter than the current maximum
1954 specified by ´LINE/MAXIMUM.´ (as described above).
1955 The terminator character does not become a part of the text of
1957 the line. It is stripped off, so that only the preceding
1958 characters constitute the text of the line.
1959 Default value: "´$´".
1961 ´LINE/BUFFER.´
1963 Simplest form of name: ´LIN/BU.´
1964 A group of 1+6n parameters, where "n" is the current value of
1966 ´LINE/BUFFER/LENGTH.´ (16, by default). Subgroups and the number
1967 of parameters in each are as follows:
1968 ´LINE/BUFFER/LENGTH.´ (1)
1970 ´LINE/BUFFER/CONTENTS.´ (6n)
1971 ´LINE/BUFFER/LENGTH.´
1973 Simplest form of name: ´LIN/BU/LE.´
1974 An integral real number specifying the number of 6-word line
1976 definitions the line buffer will hold. A user program may need
1977 to retrieve, but must not set, the value of this parameter,
1978 since its value must match the second dimension of the line
1979 buffer.
1980 Increasing the size of the line buffer requires modifying the
1982 Autograph source code.
1983 Default value: "16.".
1985 ´LINE/BUFFER/CONTENTS.´
1987 Simplest form of name: ´LIN/BU/CO.´
1988 This group may be thought of as an array FLLN, dimensioned 6 x
1990 n, containing up to n 6-word line definitions. For a second
1991 subscript j,
1992 · FLLN(1,j) is either a real "null 1", saying that no label
1994 line is defined by this 6-word block, or an integral real
1995 "line number", saying that it does define a label line,
1996 in which case:
1997 · FLLN(2,j) is either "0.", to enable drawing of the line,
1999 or "1.", to disable drawing of the line.
2000 · FLLN(3,j) is the real width of each character of the
2002 line, stated as a fraction of the smaller dimension of
2003 the grid window.
2004 · FLLN(4,j) is an integral real number serving as the
2006 identifier of the character string defining the text of
2007 the line and enabling it to be retrieved from Autograph´s
2008 internal character storage space.
2009 · FLLN(5,j) is an integral real count of the number of
2011 characters in the text of the line.
2012 · FLLN(6,j) is an integral real number specifying the
2014 second subscript (in the line buffer) of the next line of
2015 the label to which this line belongs (that one of the
2016 remaining lines in the chain with the largest line
2017 number) or, if there is no next line, a "0.".
2018 It is not recommended that a user program change the contents of
2020 this buffer directly. Line definitions should be accessed
2021 indirectly by means of the parameters ´LINE/NUMBER.´ and
2022 ´LINE/[DEFINITION/]...´.
2023 Default values: The line buffer contains four pre-defined lines,
2025 each of which belongs to one of the four pre-defined labels.
2026 They are as follows:
2027 Label name ´L´ ´R´ ´B´ ´T´
2030 Line number +100. -100. -100. +100.
2032 Suppression flag 0. 0. 0. 0.
2034 Character width .015 .015 .015 .020
2036 Text pointed to ´Y´ ´ ´ (a blank) ´X´ ´ ´ (a blank)
2038 Text length 1. 0. 1. 0.
2040 Next-line index 0. 0. 0. 0.
2042 The description of ´LABEL/BUFFER/CONTENTS.´, above, gives
2044 default values for the definitions of the four labels which
2045 contain these lines.
2046 ´LINE/NUMBER.´
2048 Simplest form of name: ´LIN/NU.´
2049 An integral real pointer which, if non-zero, specifies a
2051 particular line in the line buffer - the one which is to be
2052 referenced by the parameter group ´LINE/DEFINITION.´ (which see,
2053 below).
2054 Setting this parameter is the required first step in accessing a
2056 particular line definition.
2057 Default value: "0." (undefined).
2059 Special action by AGSETP: To access the definition of a
2061 particular line of a particular label, one must ensure that
2062 ´LABEL/NAME.´ (which see, above) is set. Then, one must call
2063 AGSETI with ´LINE/NUMBER.´ as the first argument and the number
2064 of the line one wishes to access as the second argument. This
2065 causes AGSETP (which is called by AGSETI) to search the line
2066 buffer for the definition of a line belonging to the label
2067 specified by the current value of ´LABEL/NAME.´ and having the
2068 desired line number. If no such definition is found, a new one
2069 is made up, inserted in the line buffer, and linked into the
2070 proper place in the chain of lines belonging to the label. In
2071 either case, ´LINE/NUMBER.´ is given an integral real value
2072 specifying the second subscript of the line definition in the
2073 line buffer.
2074 The definition of a new line has the number specified by the
2076 user, a suppression flag "0.", a character width ".015", a
2077 pointer to the text string "´ ´ (a single blank)", and a text
2078 length of "1.".
2079 Note: The "line numbers" are used to identify the lines of a
2081 label and to specify their positions relative to each other and
2082 to the baseline of the label. Lines having positive line numbers
2083 are drawn above the label baseline, lines having zero line
2084 numbers are drawn along the label baseline, and lines having
2085 negative line numbers are drawn below the label baseline. A line
2086 having a greater line number than another line is drawn above
2087 that line. ("Above" and "below" are used here from the viewpoint
2088 of someone reading the label.) The magnitudes of the line
2089 numbers in no way affect inter-line spacing, which is determined
2090 by Autograph itself.
2091 ´LINE/DEFINITION.´
2093 Simplest form of name: ´LIN/DE.´
2094 A group of five parameters defining the line specified by
2096 ´LINE/NUMBER.´. If ´LINE/NUMBER.´ has the value "0.",
2097 referencing a parameter in this group causes an error exit.
2098 Subgroups and the number of parameters in each are as follows:
2099 ´LINE/[DEFINITION/]SUPPRESSION.´ (1)
2101 ´LINE/[DEFINITION/]CHARACTER.´ (1)
2102 ´LINE/[DEFINITION/]TEXT.´ (1)
2103 ´LINE/[DEFINITION/]LENGTH.´ (1)
2104 ´LINE/[DEFINITION/]INDEX.´ (1)
2105 ´LINE/[DEFINITION/]SUPPRESSION.´
2107 Simplest form of name: ´LIN/SU.´
2108 An integral real number having the value "0." or "1." and
2110 specifying whether drawing of the line specified by
2111 ´LINE/NUMBER.´ is enabled ("0.") or disabled ("1.").
2112 Default value for a new line: "0." (line enabled).
2114 Special action by AGSETP: If a user program attempts to set this
2116 parameter (individually, rather than as a part of a group) to a
2117 negative value, the line specified by ´LINE/NUMBER.´ is deleted
2118 and ´LINE/NUMBER.´ is reset to "0.". (Deleting a line means
2119 that it is unlinked from the chain of lines belonging to its
2120 label and that its number cell is set to "null 1".)
2121 ´LINE/[DEFINITION/]CHARACTER.´
2123 Simplest form of name: ´LIN/CH.´
2124 A real number specifying the desired width of each character of
2126 the line specified by ´LINE/NUMBER.´, stated as a fraction of
2127 the smaller dimension of the grid window.
2128 Default value for a new line: ".015".
2130 ´LINE/[DEFINITION/]TEXT.´
2132 Simplest form of name: ´LIN/TE.´
2133 An integral real number serving as an identifier for a character
2135 string stored away in Autograph´s internal character storage
2136 space.
2137 Default value for a new line: "´ ´ (a single blank)".
2139 Special action by AGSETP: When this parameter is set by a call
2141 to AGSETC, the character string appearing as the second argument
2142 of AGSETC is stored in a character storage array inside
2143 Autograph, an identifier allowing for later retrieval of the
2144 string is generated, and the value of that identifier is stored
2145 (by AGSETP, which is called by AGSETC) as the parameter value.
2146 At that time, the length of the string is determined and
2147 ´LINE/[DEFINITION/]LENGTH.´ is set. See ´LINE/MAXIMUM.´ and
2148 ´LINE/TERMINATOR.´, above.
2149 ´LINE/[DEFINITION/]LENGTH.´
2151 Simplest form of name: ´LIN/LE.´
2152 An integral real count of the number of characters in the text
2154 of the line specified by ´LINE/NUMBER.´. Setting this parameter
2155 less than or equal to zero suppresses the drawing of the line.
2156 See also the description of ´LINE/[DEFINITION/]TEXT.´, above.
2157 Default value for a new line: "1." (one character - a blank).
2159 ´LINE/[DEFINITION/]INDEX.´
2161 Simplest form of name: ´LIN/IN.´
2162 An integral real number specifying the second subscript (in the
2164 line buffer) of the next line of the label - a zero if there is
2165 no next line.
2166 This parameter is updated by Autograph as lines are added to or
2168 deleted from the label and should not be set by a user program.
2169 ´SECONDARY.´
2171 Simplest form of name: ´SEC.´
2172 A group of 149 "secondary" control parameters. These are not
2174 normally set by a user program, but are computed by Autograph
2175 itself (the routine AGSTUP). Their values may be of use in some
2176 applications. Subgroups and the number of parameters in each are
2177 as follows:
2178 ´SECONDARY/GRAPH.´ (4)
2180 ´SECONDARY/USER.´ (4)
2181 ´SECONDARY/CURVE.´ (4)
2182 ´SECONDARY/DIMENSIONS.´ (3)
2183 ´SECONDARY/AXIS.´ (80)
2184 ´SECONDARY/LABEL.´ (54)
2185 ´SECONDARY/GRAPH.´
2187 Simplest form of name: ´SEC/GR.´
2188 A group of four real numbers specifying the X coordinates of the
2190 left and right edges of the graph window and the Y coordinates
2191 of the bottom and top edges of the graph window, in the grid
2192 coordinate system. These values are used by Autograph to
2193 determine whether a point whose coordinates are expressed in the
2194 grid coordinate system lies inside or outside the graph window.
2195 If the parameters in the group ´GRID.´ have their default values
2197 (".15", ".95", ".15", ".95", and "0."), these four parameters
2198 will be given the values "-.1875", "1.0625", "-.1875", and
2199 "1.0625". Note that -.1875 = (0.-.15)/(.95-.15) and that 1.0625
2200 = (1.-.15)/(.95-.15).
2201 ´SECONDARY/USER.´
2203 Simplest form of name: ´SEC/US.´
2204 A set of four real numbers specifying the X coordinates of the
2206 left and right edges of the grid window and the Y coordinates of
2207 the bottom and top edges of the grid window, in the user
2208 coordinate system. These values are used in mapping user curve
2209 points into the grid window. The routines AGSTUP, AGBACK, and
2210 AGCURV use these four numbers as arguments 5 through 8 in calls
2211 to the system-plot-package routine SET.
2212 ´SECONDARY/CURVE.´
2214 Simplest form of name: ´SEC/CU.´
2215 A group of four real numbers specifying the X coordinates of the
2217 left and right edges of the grid (curve) window and the Y
2218 coordinates of the bottom and top edges of the grid (curve)
2219 window. The X coordinates are stated as fractions of the
2220 distance from left to right, and the Y coordinates as fractions
2221 of the distance from bottom to top, in the plotter frame. The
2222 routines AGSTUP, AGBACK, and AGCURV use these four numbers as
2223 arguments 1 through 4 in calls to the system-plot-package
2224 routine SET. If the parameters in the groups ´GRAPH.´ and
2225 ´GRID.´ have their default values, these four parameters are
2226 given the values ".15", ".95", ".15", and ".95".
2227 ´SECONDARY/DIMENSIONS.´
2229 Simplest form of name: ´SEC/DI.´
2230 A group of three real numbers, the first two of which specify
2232 the width and height of the grid window and the third of which
2233 is equal to the smaller of the first two. Each is stated as a
2234 number of plotter units. If the parameters in the groups
2235 ´GRAPH.´ and ´GRID.´ have their default values and the plotter
2236 being used has 1024x1024 addressable positions, then each of
2237 these three parameters will be given the value 818.4 = (.95-.15)
2238 * 1023.
2239 ´SECONDARY/AXIS.´
2241 Simplest form of name: ´SEC/AX.´
2242 A group of eighty parameters having to do with the drawing of
2244 the four axes. Subgroups and the number of parameters in each
2245 are as follows:
2246 ´SECONDARY/[AXIS/]LEFT.´ (20)
2248 ´SECONDARY/[AXIS/]RIGHT.´ (20)
2249 ´SECONDARY/[AXIS/]BOTTOM.´ (20)
2250 ´SECONDARY/[AXIS/]TOP.´ (20)
2251 The parameters from the subgroups are interleaved in the group;
2253 that is to say, the first elements of the subgroups comprise
2254 elements 1 through 4 of the group, the second elements of the
2255 subgroups comprise elements 5 through 8 of the group, and so on.
2256 ´SECONDARY/[AXIS/]s.´
2258 Simplest form of name: ´SEC/s.´
2259 A group of twenty parameters having to do with the drawing of
2261 the axis specified by "s", where "s" is one of the keywords
2262 "LEFT", "RIGHT", "BOTTOM", or "TOP". Subgroups and the number of
2263 parameters in each are as follows:
2264 ´SECONDARY/[AXIS/]s/POSITION.´ (6)
2266 ´SECONDARY/[AXIS/]s/TICKS.´ (3)
2267 ´SECONDARY/[AXIS/]s/NUMERIC.´ (11)
2268 ´SECONDARY/[AXIS/]s/POSITION.´
2270 Simplest form of name: ´SEC/s/PO.´
2271 A group of six real numbers, the first three of which describe a
2273 point at the beginning of axis "s" and the last three of which
2274 describe a point at the end of axis "s". The first two numbers
2275 of each triplet are the X and Y coordinates of the point, in the
2276 grid coordinate system. The third number of each triplet is a
2277 user-system X or Y coordinate (an X coordinate for a horizontal
2278 axis, a Y coordinate for a vertical axis) of the point.
2279 ´SECONDARY/[AXIS/]s/TICKS.´
2281 Simplest form of name: ´SEC/s/TI.´
2282 A group of three real numbers, specifying the values Autograph
2284 has chosen to use for the primary parameters
2285 ´[AXIS/]s/[TICKS/]MAJOR/[SPACING/]TYPE.´
2287 ´[AXIS/]s/[TICKS/]MAJOR/[SPACING/]BASE.´
2288 ´[AXIS/]s/[TICKS/]MINOR/SPACING.´
2289 (which see, above). These secondary parameters are used to hold
2291 the values Autograph chooses for the corresponding primary
2292 parameters so as not to disturb "null 1" values of those primary
2293 parameters.
2294 ´SECONDARY/[AXIS/]s/NUMERIC.´
2296 Simplest form of name: ´SEC/s/NU.´
2297 A group of eleven real numbers having to do with the generation
2299 of numeric labels on the axis specified by "s". The first three
2300 of these specify the values Autograph has chosen to use for the
2301 primary parameters
2302 ´[AXIS/]s/[NUMERIC/]TYPE.´
2304 ´[AXIS/]s/[NUMERIC/]EXPONENT.´
2305 ´[AXIS/]s/[NUMERIC/]FRACTION.´
2306 (which see, above). The secondary parameters are used so as not
2308 to disturb "null 1" values of the primary parameters.
2309 The fourth parameter is an integral real count of the number of
2311 characters in the longest numeric-label mantissa on the axis
2312 "s".
2313 The fifth parameter is an integral real count of the number of
2315 characters in the longest numeric-label exponent on the axis
2316 "s".
2317 The sixth parameter is the necessary multiplicative "reduction
2319 factor" (between "0." and "1.") to be applied to the sizes of
2320 numeric labels on the axis "s" in order to make them fit without
2321 overlap problems.
2322 The seventh, eighth, ninth, and tenth parameters are real
2324 numbers specifying the width of the space required by numeric
2325 labels to the left (outward), to the right (inward), at the
2326 beginning and at the end of the axis "s" - each is stated as a
2327 fraction of the width or height of the grid window, depending on
2328 the orientation of the axis "s".
2329 The eleventh parameter indicates the linear/log nature of the
2331 axis specified by "s".
2332 ´SECONDARY/LABEL.´
2334 Simplest form of name: ´SEC/LA.´
2335 A group of fifty-four parameters describing the six "label
2337 boxes", each of which provides a mechanism for moving and/or
2338 shrinking a particular group of labels in attempting to keep any
2339 label in that group from overlapping an axis or extending
2340 outside the current graph window. Subgroups and the number of
2341 parameters in each are as follows:
2342 ´SECONDARY/LABEL/LEFT.´ (9)
2344 ´SECONDARY/LABEL/RIGHT.´ (9)
2345 ´SECONDARY/LABEL/BOTTOM.´ (9)
2346 ´SECONDARY/LABEL/TOP.´ (9)
2347 ´SECONDARY/LABEL/CENTER.´ (9)
2348 ´SECONDARY/LABEL/GRAPH.´ (9)
2349 The parameters of the subgroups are interleaved in the group.
2351 The first elements of the subgroups form elements 1 through 6 of
2352 the group, the second elements of the subgroups form elements 7
2353 through 12 of the group, and so on.
2354 ´SECONDARY/LABEL/b.´
2356 Simplest form of name: ´SEC/LA/b.´
2357 where the keyword "b" specifies the label box, as follows:
2359 · If "b" = "LEFT", label box 1 is specified. It contains
2361 all labels having a basepoint on the left edge of the
2362 grid window and a leftward-pointing offset vector. These
2363 labels are to be moved leftward as required to avoid
2364 overlapping any numeric labels on either Y axis.
2365 · If "b" = "RIGHT", label box 2 is specified. It contains
2367 all labels having a basepoint on the right edge of the
2368 grid window and a rightward-pointing offset vector. These
2369 labels are to be moved rightward as required to avoid
2370 overlapping any numeric labels on either Y axis.
2371 · If "b" = "BOTTOM", label box 3 is specified. It contains
2373 all labels having a basepoint on the bottom edge of the
2374 grid window and a downward-pointing offset vector. These
2375 labels are to be moved downward as required to avoid
2376 overlapping any numeric labels on either X axis.
2377 · If "b" = "TOP", label box 4 is specified. It contains all
2379 labels having a basepoint on the top edge of the grid
2380 window and an upward-pointing offset vector. These labels
2381 are to be moved upward as required to avoid overlapping
2382 any numeric labels on either X axis.
2383 · If "b" = "CENTER", label box 5 is specified. It contains
2385 all labels having a basepoint on some edge of the grid
2386 window and an inward-pointing offset vector. These labels
2387 are to be moved inward as required to avoid overlapping
2388 numeric labels on any axis.
2389 · If "b" = "GRAPH", label box 6 is specified. It contains
2391 all labels not specifically assigned to one of the other
2392 boxes. These labels are not moved, but may still be
2393 shrunk as required to avoid their running outside the
2394 grid window.
2395 Prior to a call to AGSTUP, the nine parameters in this group are
2397 undefined. Following an AGSTUP call, but preceding an AGBACK
2398 call, they have what I shall call "interim" values. Following an
2399 AGBACK call, they have what I shall call "final" values.
2400 The first parameter in the group is a "reduction factor" for the
2402 widths of characters in the labels in box "b". This parameter
2403 may have the interim value "0.", specifying that no actual value
2404 has yet been computed, or "1.", specifying that the user has
2405 prohibited shrinkage of labels in box "b" (by giving
2406 ´LABEL/CONTROL.´ the value "1."). The final value of the
2407 reduction factor may be "-1.", specifying that minimum-sized
2408 labels were used, but even they led to overlap problems, or a
2409 value between "0." and "1.", specifying the actual reduction
2410 factor applied when the labels were drawn.
2411 The next four parameters in the group specify the grid-system X
2413 coordinates of the left and right edges, and the grid-system Y
2414 coordinates of the bottom and top edges, of label box "b". The
2415 interim values specify the box in which the labels must be made
2416 to fit in order to avoid overlap, the final values the box in
2417 which the labels were actually made to fit.
2418 The last four parameters in the group specify the grid-system X
2420 coordinates of the left and right edges, and the grid-system Y
2421 coordinates of the bottom and top edges, of the label box "b"
2422 which would result if all the labels were reduced to minimum
2423 size. The interim values specify an unmoved box, the final
2424 values a (possibly) moved box.
2425
2427 Online: agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agrstr, agsave,
2428 agsetc, agsetf, agseti, agsetp, agsetr, anotat, displa
2429 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
2431
2433 Copyright (C) 1987-2009
2434 University Corporation for Atmospheric Research
2435 The use of this Software is governed by a License Agreement.
2436UNIX March 1993 Autograph_params(3NCARG)