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

NAME

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

SYNOPSIS

10       SUBROUTINE AGUTOL (IAXS,FUNS,IDMA,VINP,VOTP)
11

DESCRIPTION

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

USAGE

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

ACCESS

52       To use AGUTOL, load the NCAR Graphics libraries ncarg, ncarg_gks, and
53       ncarg_c, preferably in that order.
54

SEE ALSO

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-2007
65       University Corporation for Atmospheric Research
66
67       This documentation is free software; you can redistribute it and/or
68       modify it under the terms of the GNU General Public License as
69       published by the Free Software Foundation; either version 2 of the
70       License, or (at your option) any later version.
71
72       This software is distributed in the hope that it will be useful, but
73       WITHOUT ANY WARRANTY; without even the implied warranty of
74       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
75       General Public License for more details.
76
77       You should have received a copy of the GNU General Public License along
78       with this software; if not, write to the Free Software Foundation,
79       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
80
81
82
83UNIX                              March 1993                    AGUTOL(3NCARG)
Impressum