ncl_getusv - Man Page

CALL GETUSV (VN,IV)

#include <ncarg/ncargC.h>

void c_getusv (char *vn, int *iv)

VN

(an input constant or variable of type CHARACTER) is the name of a parameter; only the first two characters are meaningful.  Remember that, in FORTRAN, a constant of type CHARACTER is a string of characters enclosed in apostrophes.

IV

(an output variable of type INTEGER) is the current value of the parameter identified by VN, as described in the following table:

Parameter   Description               Possible Values of IV
Name (VN)
---------   -----------               ---------------------
 'LS'       Axis scaling              1 = linear X, linear Y
            ("Log Scaling" flag)      2 = linear X, log Y
                                      3 = log X,    linear Y
                                      4 = log X,    log Y

 'MI'       Axis direction reversal   1 = neither X nor Y
            ("MIrroring" flag - axis  2 = X, but not Y
            from maximum to minimum   3 = Y, but not X
            rather than min to max)   4 = both X and Y

 'MU'       Metacode output Unit      2

 'PB'       Pen-move Buffer size      2 to 50

Both 'LS' and 'MI' are normally set by calling the routine SET, but can be set independently by calling SETUSV.

The parameter 'MU' is set, prior to calling OPNGKS, to change the FORTRAN logical unit number to be used by GKS for metacode output.

The parameter 'PB' sets the size of the SPPS polyline buffer. The value "2" effectively turns buffering off.

Obsolete    Description
parameters
----------  -----------
 'XF'       X axis exponent for plotter coordinates
            (The PAU range would be 1 to 2**XF - 1 in X)
 'YF'       Y axis exponent for plotter coordinates
            (The PAU range would be 1 to 2**YF - 1 in Y)
 'IR'       Red color intensity (relative to green and blue)
 'IG'       Green color intensity (relative to red and blue)
 'IB'       Blue color intensity (relative to red and green)
 'IM'       Maximum color index to be used
 'IN'       Overall color intensity
 'II'       Restore color index
 'LW'       Line width scale factor in thousandths
            (2000 means double the default line width)
 'MS'       Marker size in thousandths
            (2000 means double the default marker size)

The values of the parameters 'XF' and 'YF' are the same as the values of the arguments IX and IY in calls to the routines SETI and GETSI.

The parameters 'IR', 'IG', 'IB', 'IM', 'IN', and 'II' were all part of a color-setting scheme meant to allow overall intensity to be set independently of color.  This scheme is now obsolete; it has been replaced by normal GKS color setting through the routines GSCR, GSPLCI, GSFACI, GSPMCI, and GSTXCI. The corresponding GKS inquiry routines to determine current color settings are GQCR, GQPLCI, GQFACI, GQPMCI, and GQTXCI.  See Section 6 of "User's Guide for NCAR GKS-0A Graphics."

The parameter 'LW' is replaced by the GKS line width scale factor routine, GSLWSC, which has the corresponding query function GQLWSC.

The parameter 'MS' is replaced by the GKS marker size scale factor routine, GSMKSC, which has the corresponding query function GQMKSC.

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

Use the ncargex command to see the following relevant examples:  (none).

To use GETUSV or c_getusv, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

Online: gqcr,gqplci, gqfaci, gqpmci, gqtxci, gqmksc, gqlwsc, spps, spps_params, getset, getsi, plotif, set, setsi, setusv, ncarg_cbind

Hardcopy:   NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.