1SETUSV(3NCARG) NCAR GRAPHICS SETUSV(3NCARG)
2
6 SETUSV - sets the value of one of the internal parameters of SPPS.
7
9 CALL SETUSV (VN,IV)
10
12 #include <ncarg/ncargC.h>
13 void c_setusv (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 input expression of type INTEGER) is the desired new
25 value of the parameter identified by VN, as described in
26 the 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 SETUSV or c_setusv, load the NCAR Graphics libraries ncarg,
104 ncarg_gks, and ncarg_c, preferably in that order.
105
107 Online: gscr,gsplci, gsfaci, gspmci, gstxci, gsmksc, gslwsc, spps,
108 spps_params, getset, getsi, getusv, plotif, set, setsi, ncarg_cbind
109 Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
111 NCAR GKS-0A Graphics
112
114 Copyright (C) 1987-2007
115 University Corporation for Atmospheric Research
116 This documentation is free software; you can redistribute it and/or
118 modify it under the terms of the GNU General Public License as
119 published by the Free Software Foundation; either version 2 of the
120 License, or (at your option) any later version.
121 This software is distributed in the hope that it will be useful, but
123 WITHOUT ANY WARRANTY; without even the implied warranty of
124 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
125 General Public License for more details.
126 You should have received a copy of the GNU General Public License along
128 with this software; if not, write to the Free Software Foundation,
129 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
130UNIX March 1993 SETUSV(3NCARG)