ncl_setusv man page

SETUSV — sets the value of one of the internal parameters of SPPS.



C-Binding Synopsis

#include <ncarg/ncargC.h>

void c_setusv (char *vn, int iv)


(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.

(an input expression of type INTEGER) is the desired new 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
----------  -----------
 '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.

C-Binding Description

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 SETUSV or c_setusv, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

See Also

Online: gscr,gsplci, gsfaci, gspmci, gstxci, gsmksc, gslwsc, spps, spps_params, getset, getsi, getusv, plotif, set, setsi, ncarg_cbind

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