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

NAME

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

SYNOPSIS

14       CALL GETSET (VL,VR,VB,VT,WL,WR,WB,WT,LS)
15

C-BINDING SYNOPSIS

17       #include <ncarg/ncargC.h>
18
19       void c_getset(float *vl, float *vr, float *vb, float *vt, float *wl,
20       float *wr, float *wb, float *wt, int *lf)
21

DESCRIPTION

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

C-BINDING DESCRIPTION

59       The C-binding argument descriptions are the same as the FORTRAN
60       argument descriptions.
61

USAGE

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

EXAMPLES

76       Use the ncargex command to see the following relevant examples: arex01,
77       mpex07, mpex09, cpexcc.
78

ACCESS

80       To use GETSET or c_getset, load the NCAR Graphics libraries ncarg,
81       ncarg_gks, and ncarg_c, preferably in that order.
82

SEE ALSO

84       Online: gqnt, set, getusv, setusv, spps, spps_params, ncarg_cbind
85
86       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
87       NCAR GKS-0A Graphics
88

90       Copyright (C) 1987-2009
91       University Corporation for Atmospheric Research
92       The use of this Software is governed by a License Agreement.
93
94
95
96UNIX                              March 1993                    GETSET(3NCARG)
Impressum