NAME¶
GETSET - returns a set of values which, if used as arguments in a call to SET,
will cause normalization transformation 1, axis linear/log scaling (internal
parameter 'LS'), and axis mirror imaging (internal parameter 'MI') to be
defined in such a way as to duplicate the combined effects of the current
normalization transformation, axis scaling, and axis mirror imaging.
SYNOPSIS¶
CALL GETSET (VL,VR,VB,VT,WL,WR,WB,WT,LS)
C-BINDING SYNOPSIS¶
#include <ncarg/ncargC.h>
void c_getset(float *vl, float *vr, float *vb, float *vt, float *wl, float *wr,
float *wb, float *wt, int *lf)
DESCRIPTION¶
- VL
- (an output variable of type REAL) defines the left margin of the viewport
in fractional coordinates.
- VR
- (an output variable of type REAL) defines the right margin of the viewport
in fractional coordinates.
- VB
- (an output variable of type REAL) defines the bottom margin of the
viewport in fractional coordinates.
- VT
- (an output variable of type REAL) defines the top margin of the viewport
in fractional coordinates.
- WL
- (an output variable of type REAL) defines the left margin of the window in
user coordinates.
- WR
- (an output variable of type REAL) defines the right margin of the window
in user coordinates.
- WB
- (an output variable of type REAL) defines the bottom margin of the window
in user coordinates.
- WT
- (an output variable of type REAL) defines the top margin of the window in
user coordinates.
- LS
- (an output variable of type INTEGER) defines the linear/log nature of the
mapping, as follows:
- 1
- linear X, linear Y
- 2
- linear X, log Y
- 3
- log X, linear Y
- 4
- log X, log Y
C-BINDING DESCRIPTION¶
The C-binding argument descriptions are the same as the FORTRAN argument
descriptions.
USAGE¶
Note that in setting the limits of the viewport and the window, the left margin
can have a user coordinate value that is larger than the user coordinate value
at the right margin. This means the X axis scale will run from a maximum value
at the left to a minimum value at the right. Likewise the bottom value can
exceed the top value meaning that the Y axis can run from a maximum at the
bottom to a minimum at the top. This reversal of the axes is referred to as
"mirror imaging". It represents a substantial functional enhancement
over what is provided in GKS. That is why NCAR Graphics SET calls using
fractional and user coordinates are in general preferred over GKS calls to
GSVP and GSWN using normalized device coordinates and world coordinates.
EXAMPLES¶
Use the ncargex command to see the following relevant examples: arex01, mpex07,
mpex09, cpexcc.
ACCESS¶
To use GETSET or c_getset, load the NCAR Graphics libraries ncarg, ncarg_gks,
and ncarg_c, preferably in that order.
SEE ALSO¶
Online: gqnt, set, getusv, setusv, spps, spps_params, ncarg_cbind
Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A
Graphics
COPYRIGHT¶
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.