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

NAME

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

SYNOPSIS

12       CALL SET(VL,VR,VB,VT,WL,WR,WB,WT,LF)
13

C-BINDING SYNOPSIS

15       #include <ncarg/ncargC.h>
16
17       void c_set(float vl, float vr, float vb, float vt, float wl, float wr,
18       float wb, float wt, int lf)
19

DESCRIPTION

21       VL          (an input expression of type REAL) defines the left margin
22                   of the viewport in fractional coordinates.
23
24       VR          (an input expression of type REAL) defines the right margin
25                   of the viewport in fractional coordinates.
26
27       VB          (an input expression of type REAL) defines the bottom
28                   margin of the viewport in fractional coordinates.
29
30       VT          (an input expression of type REAL) defines the top margin
31                   of the viewport in fractional coordinates.
32
33       WL          (an input expression of type REAL) defines the left margin
34                   of the window in user coordinates.
35
36       WR          (an input expression of type REAL) defines the right margin
37                   of the window in user coordinates.
38
39       WB          (an input expression of type REAL) defines the bottom
40                   margin of the window in user coordinates.
41
42       WT          (an input expression of type REAL) defines the top margin
43                   of the window in user coordinates.
44
45       LF          (an input expression of type INTEGER) defines the
46                   linear/log nature of the mapping, as follows:
47
48                   1  linear X, linear Y
49
50                   2  linear X, log Y
51
52                   3  log X, linear Y
53
54                   4  log X, log Y
55

C-BINDING DESCRIPTION

57       The C-binding argument descriptions are the same as the FORTRAN
58       argument descriptions.
59

USAGE

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

EXAMPLES

74       Use the ncargex command to see the following relevant examples:
75       fcoord1, fcoord2, splogy, sprevx.
76
77       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

ACCESS

84       To use SET or c_set, load the NCAR Graphics libraries ncarg, ncarg_gks,
85       and ncarg_c, preferably in that order.
86

SEE ALSO

88       Online: gsvp, gswn, getset, getusv, setusv, spps, spps_params,
89       ncarg_cbind
90
91       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-2009
96       University Corporation for Atmospheric Research
97       The use of this Software is governed by a License Agreement.
98
99
100
101UNIX                              March 1993                       SET(3NCARG)
Impressum