1GETUSV(3NCARG) NCAR GRAPHICS GETUSV(3NCARG)
2
6 GETUSV - gets the value of one of the internal parameters of SPPS.
7
9 CALL GETUSV (VN,IV)
10
12 #include <ncarg/ncargC.h>
13 void c_getusv (char *vn, int *iv)
15
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 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 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 '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 'MU' Metacode output Unit 2
42 'PB' Pen-move Buffer size 2 to 50
44 Both 'LS' and 'MI' are normally set by calling the routine
46 SET, but can be set independently by calling SETUSV.
47 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 The parameter 'PB' sets the size of the SPPS polyline
53 buffer. The value "2" effectively turns buffering off.
54 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 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 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 The parameter 'LW' is replaced by the GKS line width scale
88 factor routine, GSLWSC, which has the corresponding query
89 function GQLWSC.
90 The parameter 'MS' is replaced by the GKS marker size scale
92 factor routine, GSMKSC, which has the corresponding query
93 function GQMKSC.
94
96 The C-binding argument descriptions are the same as the FORTRAN
97 argument descriptions.
98
100 Use the ncargex command to see the following relevant examples: (none).
101
103 To use GETUSV or c_getusv, load the NCAR Graphics libraries ncarg,
104 ncarg_gks, and ncarg_c, preferably in that order.
105
107 Online: gqcr,gqplci, gqfaci, gqpmci, gqtxci, gqmksc, gqlwsc, spps,
108 spps_params, getset, getsi, plotif, set, setsi, setusv, ncarg_cbind
109 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.
117UNIX March 1993 GETUSV(3NCARG)