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

NAME

6       GETUSV - gets the value of one of the internal parameters of SPPS.
7

SYNOPSIS

9       CALL GETUSV (VN,IV)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_getusv (char *vn, int *iv)
15

DESCRIPTION

17       VN          (an input constant or variable of type CHARACTER) is the
18                   name of a parameter; only the first two characters are
19                   meaningful.  Remember that, in FORTRAN, a constant of type
20                   CHARACTER is a string of characters enclosed in
21                   apostrophes.
22
23
24       IV          (an output variable of type INTEGER) is the current value
25                   of the parameter identified by VN, as described in the
26                   following table:
27
28                   Parameter   Description               Possible Values of IV
29                   Name (VN)
30                   ---------   -----------               ---------------------
31                    'LS'       Axis scaling              1 = linear X, linear Y
32                               ("Log Scaling" flag)      2 = linear X, log Y
33                                                         3 = log X,    linear Y
34                                                         4 = log X,    log Y
35
36                    'MI'       Axis direction reversal   1 = neither X nor Y
37                               ("MIrroring" flag - axis  2 = X, but not Y
38                               from maximum to minimum   3 = Y, but not X
39                               rather than min to max)   4 = both X and Y
40
41                    'MU'       Metacode output Unit      2
42
43                    'PB'       Pen-move Buffer size      2 to 50
44
45                   Both 'LS' and 'MI' are normally set by calling the routine
46                   SET, but can be set independently by calling SETUSV.
47
48                   The parameter 'MU' is set, prior to calling OPNGKS, to
49                   change the FORTRAN logical unit number to be used by GKS
50                   for metacode output.
51
52                   The parameter 'PB' sets the size of the SPPS polyline
53                   buffer.  The value "2" effectively turns buffering off.
54
55                   Obsolete    Description
56                   parameters
57                   ----------  -----------
58                    'XF'       X axis exponent for plotter coordinates
59                               (The PAU range would be 1 to 2**XF - 1 in X)
60                    'YF'       Y axis exponent for plotter coordinates
61                               (The PAU range would be 1 to 2**YF - 1 in Y)
62                    'IR'       Red color intensity (relative to green and blue)
63                    'IG'       Green color intensity (relative to red and blue)
64                    'IB'       Blue color intensity (relative to red and green)
65                    'IM'       Maximum color index to be used
66                    'IN'       Overall color intensity
67                    'II'       Restore color index
68                    'LW'       Line width scale factor in thousandths
69                               (2000 means double the default line width)
70                    'MS'       Marker size in thousandths
71                               (2000 means double the default marker size)
72
73                   The values of the parameters 'XF' and 'YF' are the same as
74                   the values of the arguments IX and IY in calls to the
75                   routines SETI and GETSI.
76
77                   The parameters 'IR', 'IG', 'IB', 'IM', 'IN', and 'II' were
78                   all part of a color-setting scheme meant to allow overall
79                   intensity to be set independently of color.  This scheme is
80                   now obsolete; it has been replaced by normal GKS color
81                   setting through the routines GSCR, GSPLCI, GSFACI, GSPMCI,
82                   and GSTXCI.  The corresponding GKS inquiry routines to
83                   determine current color settings are GQCR, GQPLCI, GQFACI,
84                   GQPMCI, and GQTXCI.  See Section 6 of "User's Guide for
85                   NCAR GKS-0A Graphics."
86
87                   The parameter 'LW' is replaced by the GKS line width scale
88                   factor routine, GSLWSC, which has the corresponding query
89                   function GQLWSC.
90
91                   The parameter 'MS' is replaced by the GKS marker size scale
92                   factor routine, GSMKSC, which has the corresponding query
93                   function GQMKSC.
94

C-BINDING DESCRIPTION

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

EXAMPLES

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

ACCESS

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

SEE ALSO

107       Online: gqcr,gqplci, gqfaci, gqpmci, gqtxci, gqmksc, gqlwsc, spps,
108       spps_params, getset, getsi, plotif, set, setsi, setusv, ncarg_cbind
109
110       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
111       NCAR GKS-0A Graphics
112
114       Copyright (C) 1987-2009
115       University Corporation for Atmospheric Research
116       The use of this Software is governed by a License Agreement.
117
118
119
120UNIX                              March 1993                    GETUSV(3NCARG)
Impressum