ncarg_spps_params(3)

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

COPYRIGHT

105       Copyright (C) 1987-2007
106       University Corporation for Atmospheric Research
107
108       This documentation is free software; you can redistribute it and/or
109       modify it under the terms of the GNU General Public License as
110       published by the Free Software Foundation; either version 2 of the
111       License, or (at your option) any later version.
112
113       This software is distributed in the hope that it will be useful, but
114       WITHOUT ANY WARRANTY; without even the implied warranty of
115       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
116       General Public License for more details.
117
118       You should have received a copy of the GNU General Public License along
119       with this software; if not, write to the Free Software Foundation,
120       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
121
122
123
124UNIX                              March 1993               SPPS_params(3NCARG)

NAME

DESCRIPTION

USAGE

SEE ALSO

COPYRIGHT