1AGUTOL(3NCARG) NCAR GRAPHICS AGUTOL(3NCARG)
2
3
4
6 AGUTOL - Provides a way for the user to change the user-system-to-
7 label-system mapping for one or more of the four axes.
8
10 SUBROUTINE AGUTOL (IAXS,FUNS,IDMA,VINP,VOTP)
11
13 IAXS (an input expression of type INTEGER) is the number of the
14 axis. The values 1, 2, 3, and 4 imply the left, right,
15 bottom, and top axes, respectively.
16
17 FUNS (an input expression of type REAL) is the value of
18 'AXIS/s/FUNCTION.', which may be used to select the desired
19 mapping function for the axis IAXS. It is recommended that
20 the default value (zero) be used to specify the identity
21 mapping. The value may be integral ("1.", "2.", etc.) and
22 serve purely to select the code to be executed or it may be
23 the value of an actual parameter in the equations defining
24 the mapping.
25
26 IDMA (an input expression of type INTEGER) specifies the
27 direction of the mapping. A value greater than zero
28 indicates that VINP is a value in the user system and that
29 VOTP is to be a value in the label system, a value less
30 than zero the opposite. The mappings in one direction must
31 be the mathematical inverses of the mappings in the other
32 direction.
33
34 VINP (an input expression of type REAL) is an input value in one
35 coordinate system.
36
37 VOTP (an output variable of type REAL) is an output value in the
38 other coordinate system.
39
41 This routine is not called by the user program, but by Autograph
42 itself. It defines the user-system-to-label-system mapping for all four
43 axes. The default version makes the label system match the user system
44 on all four axes. The user may supply his own version of this routine
45 to change the mapping on one or more of the axes. Mappings defined by
46 the subroutine must be continuous and monotonic.
47
48 Note: A user version of AGUTOL should not call any other Autograph
49 routine.
50
52 To use AGUTOL, load the NCAR Graphics libraries ncarg, ncarg_gks, and
53 ncarg_c, preferably in that order.
54
56 Online: autograph, agback, agbnch, agchax, agchcu, agchil, agchnl,
57 agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agpwrt, agrstr,
58 agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup, anotat, displa,
59 ezmxy, ezmy, ezxy, ezy
60
61 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
62
64 Copyright (C) 1987-2009
65 University Corporation for Atmospheric Research
66 The use of this Software is governed by a License Agreement.
67
68
69
70UNIX March 1993 AGUTOL(3NCARG)