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.