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

NAME

6       SPPS_params - This document briefly describes all of the internal
7       parameters of SPPS.
8

DESCRIPTION

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

USAGE

94       Values of SPPS parameters are set by calling the routine SETUSV and
95       retrieved by calling the routine GETUSV.
96

SEE ALSO

98       Online: gscr,gsplci, gsfaci, gspmci, gstxci, gsmksc, gslwsc, spps,
99       getset, getsi, getusv, plotif, set, setsi, setusv
100
101       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
102       NCAR GKS-0A Graphics
103
105       Copyright (C) 1987-2009
106       University Corporation for Atmospheric Research
107       The use of this Software is governed by a License Agreement.
108
109
110
111UNIX                              March 1993               SPPS_params(3NCARG)
Impressum