1Ngmisc_params(3NCARG) NCAR GRAPHICS Ngmisc_params(3NCARG)
2
6 Ngmisc_params - This document briefly describes all Ngmisc internal
7 parameters.
8
10 Parameter descriptions, in alphabetical order, of all Ngmisc internal
11 parameters follow. Each entry includes the name of a parameter, its
12 FORTRAN type, its default value, and a short description of the
13 parameter.
14 ´CA´ - Integer - 1
16 This parameter controls the type of line cap used in PostScript
17 output from NCAR GKS. If the value is 0, butt caps are used; if
18 the value is 1, round caps are used; if the value is 2,
19 projecting square caps are used. This value applies to the
20 specific workstation specified in a previous call to NGSETI to
21 set a value for the ´WO´ parameter (see below).
22 ´CL´ - Integer - 1
24 Specifies whether clipping to NDC space is on in NCAR GKS. A
25 value of "1" will turn clipping on and a value of "0" will turn
26 it off. This flag controls whether filled areas and polylines
27 are clipped if they go out of the world coordinate rectangle
28 that gets mapped onto NDC space. This clipping is not to be
29 confused with the clipping that is controlled by the GKS GSCLIP
30 function - that function controls whether clipping is to be done
31 to the viewport of the current normalization transformation, not
32 to NDC space itself (unless the viewport of the current
33 normalization transformation is the entirety of NDC space).
34 ´CM´ - Integer - 1
36 If CM equals 1, then the RGB color model is used for PostScript
37 output; if CM equals 0, then the CMYK color model is used for
38 PostScript output.
39 ´CO´ - Integer - 25
41 A positive integer specifying a scale factor for the integer
42 coordinate values in PostScript output from NCAR GKS. This
43 value will apply to the first PostScript workstation opened with
44 GOPWK after specifying the value for ´CO´. The default
45 coordinates in PostScript user space represent units of 1/72 of
46 an inch; for an 8 1/2 inch by 11 inch page in portrait mode, the
47 default PostScript user coordinate space is 0 to 612 in X
48 and 0 to 792 in Y. The value of ´CO´ will multiply the
49 PostScript user coordinates by the specified amount. Specifying
50 larger values for CO will increase the accuracy of coordinate
51 positions at the expense of larger files (more space is needed
52 to represent the larger integer coordinate values); smaller
53 numbers reduce the accuracy of coordinate positions, but reduce
54 file sizes.
55 ´CT´ - Integer - 0
57 Specifies whether NGDOTS will draw filled dots or circles. If
58 the value of CT is 0, then filled dots are drawn. If the value
59 of CT is not 0, then circles are drawn.
60 ´ER´ - Integer - 10
62 Specifies the maximum number of error messages that will be
63 issued by NCAR GKS before it terminates execution. ER must be
64 larger than zero.
65 ´FI´ - Real - 0.0005
67 A real number in the range 0. to 1. (normalized device
68 coordinate space) that specifies the spacing between fill lines
69 used in software fill in PostScript output from NCAR GKS. This
70 value applies to the specific workstation specified in a
71 previous call to NGSETI to set a value for the "WO" parameter
72 (see below).
73 ´FU´ - Integer - 0
75 Controls whether the background color is applied to the entirety
76 of a page, or just the viewport area, in PostScript output from
77 NCAR GKS. If the value is 0, then the background color applies
78 only to the viewport area; if the value is non-zero, then the
79 background color covers the entire page. This value applies to
80 the specific workstation specified in a previous call to NGSETI
81 to set a value for the ´WO´ parameter (see below).
82 ´HA´ - Real - 0.01
84 A real number in the range 0. to 1. (normalized device
85 coordinate space) that specifies the spacing between hatch lines
86 used in hatch-pattern filled areas in PostScript output from
87 NCAR GKS. This value applies to the specific workstation
88 specified in a previous call to NGSETI to set a value for the
89 ´WO´ parameter (see below).
90 ´IG´ - Integer - 0
92 A flag to indicate whether the clip rectangles in segment copies
93 should be transformed by using the current segment
94 transformation. The GKS standard says that the clip rectangles
95 should not be so transformed and this is the default.
96 ´JO´ - Integer - 1
98 Controls the type of line join used in PostScript output from
99 NCAR GKS. If the value is 0, miter joins are used; if the value
100 is 1, round joins are used; if the value is 2, bevel joins are
101 used. This value applies to the specific workstation specified
102 in a previous call to NGSETI to set a value for the ´WO´
103 parameter (see below).
104 ´LB´ - Integer - 1
106 Specifies the secondary logo color (this is applicable only for
107 logo type 5, in which case the secondary color is used for the
108 text string "UCAR").
109 ´LC´ - Integer - 1
111 Specifies the logo color (except in the case of an NCAR logo
112 being plotted to a PostScript workstation, in which case you
113 will get the full-color logo).
114 ´LT´ - Integer - 1
116 Specify the logo type. See the documentation for NGLOGO for a
117 list of the logo types, or execute "ncargex miex01" for an
118 example plot that lists the logo types.
119 ´LX´ - Integer - 36
121 Specifies the left X coordinate value to be used in positioning
122 PostScript output from NCAR GKS on the output page. This value
123 is in the default PostScript user space where one unit
124 corresponds to 1/72 inch. This value must be specified before
125 opening the PostScript workstation to which it will apply. See
126 descriptions for the parameters ´LY´, ´UX´, and ´UY´.
127 ´LY´ - Integer - 126
129 Specifies the lower Y coordinate value to be used in positioning
130 PostScript output from NCAR GKS on the output page. This value
131 is in the default PostScript user space where one unit
132 corresponds to 1/72 inch. This value must be specified before
133 opening the PostScript workstation to which it will apply. See
134 descriptions for the parameters ´LX´, ´UX´, and ´UY´.
135 ´MC´ - Integer - depends on the workstation type
137 The X11 workstation indicated by the integer should use a
138 "mixed" X color model. (-1) indicates the next X11 workstation
139 created.
140 ´ME´ - Character - depends on the workstation type
142 A character string that specifies the metafile name that will be
143 used by the next NCAR GKS GOPWK call that opens a GKS CGM or
144 PostScript workstation.
145 ´MI´ - Real - 10.
147 Controls the miter limit of line joins in PostScript output from
148 NCAR GKS. This applies only if line joins are specified as
149 mitered joins (see the description of the parameter ´JO´ above).
150 This value applies to the specific workstation specified in a
151 previous call to NGSETI to set a value for the ´WO´ parameter
152 (see below).
153 ´NO´ - Real - 1.0
155 A positive real number specifying a scale factor for the nominal
156 linewidth in PostScript output from NCAR GKS. Setting the value
157 larger than 1.0 will result in all line thicknesses being fatter
158 by that amount; setting the value smaller than 1.0 will result
159 in all line thicknesses being narrower by that amount. This
160 value applies to the specific workstation specified in a
161 previous call to NGSETI to set a value for the ´WO´ parameter
162 (see below).
163 ´OS´ - Real - 0.07
165 Specifies the logo size in normalized device coordinates (a
166 number between 0. and 1.). For example, a size specification of
167 0.1 would give a logo size one-tenth the maximum plot height.
168 ´OX´ - Real - 0.93
170 Specify the logo X-coordinate position in normalized device
171 coordinates.
172 ´OY´ - Real - 0.05
174 Specify the logo Y-coordinate position in normalized device
175 coordinates.
176 ´PA´ - Integer - 1300
178 Specifies the maximum size of paths used in PostScript output
179 from NCAR GKS. This value controls when software fill will be
180 used in place of hardware fill. Larger values result in
181 significant file size and interpretation time savings. This
182 value applies to the specific workstation specified in a
183 previous call to NGSETI to set a value for the ´WO´ parameter
184 (see below). The default value is compatible with the minimum
185 value specified in the Adobe PostScript specifications that is
186 to apply to all PostScript interpreters. A specific interpreter
187 may allow for significantly larger paths. See the documentation
188 for your local PostScript interpreter to determine this value.
189 ´PC´ - Integer - depends on the workstation type
191 The X11 workstation indicated by the integer should use a
192 "private" X color model. (-1) indicates the next X11
193 workstation created.
194 ´PE´ - Integer - 20
196 Percentage error allowed in matching requested colors in X
197 Window output where the window shares a single color map with
198 all the other current X windows. The value "0" is special and
199 is the same as the value "100" meaning that any color may be
200 selected. In the default environment all X11 windows share a
201 single color map and when a request is made to allocate a new
202 color, and there are no more colors left, then the nearest color
203 (to within the stated percentage) is selected. The "nearest
204 color" is the one in the current color table that is closest
205 using the normal distance metric in the RGB color cube. The
206 percentage error is measured as a percentage of lenght of a
207 diagonal of the RGB color cube.
208 ´PI´ - Character - blanks
210 A character string that will be used for the picture name of the
211 current picture in the PICTURE NAME element of an ncgm file.
212 The first picture must be named before the ncgm workstation is
213 opened and subsequent pictures must be named immediately after
214 creating the previous picture. Not all pictures need be named
215 and any picture that is not assigned a specific name is assigned
216 blanks in the PICTURE NAME field of the ncgm.
217 ´SC´ - Integer - depends on the workstation type
219 The X11 workstation indicated by the integer should use a
220 "shared" X color model. (-1) indicates the next X11 workstation
221 created.
222 ´SE´ - Character - 'GSEG'
224 Specifies a root name for segments created by NCAR GKS. In the
225 default case, the segment name used will be constructed from
226 GSEG by appending an integer constructed from the user id, the
227 process id, and the segment number. By default, the segments
228 are stored in the directory specified by the environment
229 variable TMPDIR (usually set internally at install time to
230 /tmp). If SE is changed away from the default setting, then the
231 segment name will be cunstructed using the value of SE as a root
232 and appending the segment number.
233 ´SS´ - Integer - 1
235 Specifies whether segments should be deleted when WISS is
236 closed. The default is to delete segments. Setting SS to a
237 non-default value will cause segments to be saved.
238 ´ST´ - Integer - 200
240 Specifies the maximum size of the operand stack used in
241 PostScript output from NCAR GKS. The primary effect of setting
242 this value controls how many points can be included in a
243 locally-defined macro for polylines and filled areas. Larger
244 values result in space savings. This value applies to the
245 specific workstation specified in a previous call to NGSETI to
246 set a value for the ´WO´ parameter (see below). The default
247 value is compatible with the minimum value specified in the
248 Adobe PostScript specifications that is to apply to all
249 PostScript interpreters.
250 ´UX´ - Integer - 576
252 Specifies the upper X coordinate value to be used in positioning
253 PostScript output from NCAR GKS on the output page. This value
254 is in the default PostScript user space where one unit
255 corresponds to 1/72 inch. This value must be specified before
256 opening the PostScript workstation to which it will apply. See
257 descriptions for the parameters "LX", "LY", and "UY".
258 ´UY´ - Integer - 666
260 An integer that specifies the upper Y coordinate value to be
261 used in positioning PostScript output from NCAR GKS on the
262 output page. This value is in the default PostScript user space
263 where one unit corresponds to 1/72 inch. This value must be
264 specified before opening the PostScript workstation to which it
265 will apply. See descriptions for the parameters "LX", "LY", and
266 "UX".
267 ´WO´ - Integer - none
269 An integer specifying the NCAR GKS workstation ID that will be
270 used for subsequent parameters that apply to a specific
271 workstation.
272
274 Online: nggetc, nggeti, nggetr, ngsetc, ngseti, ngsetr, ngpswk,
275 ncarg_cbind.
276 http://ngwww.ucar.edu/ngdoc/ng/gks/gkshome.html
278 Hardcopy: NCAR Graphics Fundamentals, UNIX Version;
280
282 Copyright (C) 1987-2007
283 University Corporation for Atmospheric Research
284 This documentation is free software; you can redistribute it and/or
286 modify it under the terms of the GNU General Public License as
287 published by the Free Software Foundation; either version 2 of the
288 License, or (at your option) any later version.
289 This software is distributed in the hope that it will be useful, but
291 WITHOUT ANY WARRANTY; without even the implied warranty of
292 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
293 General Public License for more details.
294 You should have received a copy of the GNU General Public License along
296 with this software; if not, write to the Free Software Foundation,
297 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
298UNIX April 1994 Ngmisc_params(3NCARG)