1SET(3NCARG) NCAR GRAPHICS SET(3NCARG)
2
6 SET - defines the mapping between fractional and user coordinates: sets
7 the values of the SPPS internal parameters 'LS' (axis linear/log
8 scaling) and 'MI' (axis mirror imaging); defines GKS normalization
9 transformation 1.
10
12 CALL SET(VL,VR,VB,VT,WL,WR,WB,WT,LF)
13
15 #include <ncarg/ncargC.h>
16 void c_set(float vl, float vr, float vb, float vt, float wl, float wr,
18 float wb, float wt, int lf)
19
21 VL (an input expression of type REAL) defines the left margin
22 of the viewport in fractional coordinates.
23 VR (an input expression of type REAL) defines the right margin
25 of the viewport in fractional coordinates.
26 VB (an input expression of type REAL) defines the bottom
28 margin of the viewport in fractional coordinates.
29 VT (an input expression of type REAL) defines the top margin
31 of the viewport in fractional coordinates.
32 WL (an input expression of type REAL) defines the left margin
34 of the window in user coordinates.
35 WR (an input expression of type REAL) defines the right margin
37 of the window in user coordinates.
38 WB (an input expression of type REAL) defines the bottom
40 margin of the window in user coordinates.
41 WT (an input expression of type REAL) defines the top margin
43 of the window in user coordinates.
44 LF (an input expression of type INTEGER) defines the
46 linear/log nature of the mapping, as follows:
47 1 linear X, linear Y
49 2 linear X, log Y
51 3 log X, linear Y
53 4 log X, log Y
55
57 The C-binding argument descriptions are the same as the FORTRAN
58 argument descriptions.
59
61 Note that in setting the limits of the viewport and the window, the
62 left margin can have a user coordinate value that is larger than the
63 user coordinate value at the right margin. This means the X axis scale
64 will run from a maximum value at the left to a minimum value at the
65 right. Likewise the bottom value can exceed the top value meaning that
66 the Y axis can run from a maximum at the bottom to a minimum at the
67 top. This reversal of the axes is referred to as "mirror imaging". It
68 represents a substantial functional enhancement over what is provided
69 in GKS. That is why NCAR Graphics SET calls using fractional and user
70 coordinates are in general preferred over GKS calls to GSVP and GSWN
71 using normalized device coordinates and world coordinates.
72
74 Use the ncargex command to see the following relevant examples:
75 fcoord1, fcoord2, splogy, sprevx.
76 sprevx shows the use of routine SET for an X axis scaling reversal,
78 splogy shows the use of routine SET for logarithmic scaling of the Y
79 axis, fcoord1 shows the mapping from GKS world coordinates to GKS
80 normalized device coordinates, and fcoord2 shows the mapping from NCAR
81 Graphics user coordinates to GKS normalized device coordinates.
82
84 To use SET or c_set, load the NCAR Graphics libraries ncarg, ncarg_gks,
85 and ncarg_c, preferably in that order.
86
88 Online: gsvp, gswn, getset, getusv, setusv, spps, spps_params,
89 ncarg_cbind
90 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
92 Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics;
93
95 Copyright (C) 1987-2007
96 University Corporation for Atmospheric Research
97 This documentation is free software; you can redistribute it and/or
99 modify it under the terms of the GNU General Public License as
100 published by the Free Software Foundation; either version 2 of the
101 License, or (at your option) any later version.
102 This software is distributed in the hope that it will be useful, but
104 WITHOUT ANY WARRANTY; without even the implied warranty of
105 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
106 General Public License for more details.
107 You should have received a copy of the GNU General Public License along
109 with this software; if not, write to the Free Software Foundation,
110 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
111UNIX March 1993 SET(3NCARG)