1GETSET(3NCARG) NCAR GRAPHICS GETSET(3NCARG)
2
6 GETSET - returns a set of values which, if used as arguments in a call
7 to SET, will cause normalization transformation 1, axis linear/log
8 scaling (internal parameter 'LS'), and axis mirror imaging (internal
9 parameter 'MI') to be defined in such a way as to duplicate the
10 combined effects of the current normalization transformation, axis
11 scaling, and axis mirror imaging.
12
14 CALL GETSET (VL,VR,VB,VT,WL,WR,WB,WT,LS)
15
17 #include <ncarg/ncargC.h>
18 void c_getset(float *vl, float *vr, float *vb, float *vt, float *wl,
20 float *wr, float *wb, float *wt, int *lf)
21
23 VL (an output variable of type REAL) defines the left margin
24 of the viewport in fractional coordinates.
25 VR (an output variable of type REAL) defines the right margin
27 of the viewport in fractional coordinates.
28 VB (an output variable of type REAL) defines the bottom margin
30 of the viewport in fractional coordinates.
31 VT (an output variable of type REAL) defines the top margin of
33 the viewport in fractional coordinates.
34 WL (an output variable of type REAL) defines the left margin
36 of the window in user coordinates.
37 WR (an output variable of type REAL) defines the right margin
39 of the window in user coordinates.
40 WB (an output variable of type REAL) defines the bottom margin
42 of the window in user coordinates.
43 WT (an output variable of type REAL) defines the top margin of
45 the window in user coordinates.
46 LS (an output variable of type INTEGER) defines the linear/log
48 nature of the mapping, as follows:
49 1 linear X, linear Y
51 2 linear X, log Y
53 3 log X, linear Y
55 4 log X, log Y
57
59 The C-binding argument descriptions are the same as the FORTRAN
60 argument descriptions.
61
63 Note that in setting the limits of the viewport and the window, the
64 left margin can have a user coordinate value that is larger than the
65 user coordinate value at the right margin. This means the X axis scale
66 will run from a maximum value at the left to a minimum value at the
67 right. Likewise the bottom value can exceed the top value meaning that
68 the Y axis can run from a maximum at the bottom to a minimum at the
69 top. This reversal of the axes is referred to as "mirror imaging". It
70 represents a substantial functional enhancement over what is provided
71 in GKS. That is why NCAR Graphics SET calls using fractional and user
72 coordinates are in general preferred over GKS calls to GSVP and GSWN
73 using normalized device coordinates and world coordinates.
74
76 Use the ncargex command to see the following relevant examples: arex01,
77 mpex07, mpex09, cpexcc.
78
80 To use GETSET or c_getset, load the NCAR Graphics libraries ncarg,
81 ncarg_gks, and ncarg_c, preferably in that order.
82
84 Online: gqnt, set, getusv, setusv, spps, spps_params, ncarg_cbind
85 Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
87 NCAR GKS-0A Graphics
88
90 Copyright (C) 1987-2007
91 University Corporation for Atmospheric Research
92 This documentation is free software; you can redistribute it and/or
94 modify it under the terms of the GNU General Public License as
95 published by the Free Software Foundation; either version 2 of the
96 License, or (at your option) any later version.
97 This software is distributed in the hope that it will be useful, but
99 WITHOUT ANY WARRANTY; without even the implied warranty of
100 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
101 General Public License for more details.
102 You should have received a copy of the GNU General Public License along
104 with this software; if not, write to the Free Software Foundation,
105 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
106UNIX March 1993 GETSET(3NCARG)