1Ngmisc_params(3NCARG) NCAR GRAPHICS Ngmisc_params(3NCARG)
2
3
4
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
15 ´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
23 ´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
35 ´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
40 ´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
56 ´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
61 ´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
66 ´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
74 ´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
83 ´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
91 ´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
97 ´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
105 ´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
110 ´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
115 ´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
120 ´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
128 ´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
136 ´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
141 ´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
146 ´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
154 ´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
164 ´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
169 ´OX´ - Real - 0.93
170 Specify the logo X-coordinate position in normalized device
171 coordinates.
172
173 ´OY´ - Real - 0.05
174 Specify the logo Y-coordinate position in normalized device
175 coordinates.
176
177 ´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
190 ´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
195 ´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
209 ´PH´ - Integer - 792
210 Specification, in points, of the PDF output page height.
211
212 ´PI´ - Character - blanks
213 A character string that will be used for the picture name of the
214 current picture in the PICTURE NAME element of an ncgm file.
215 The first picture must be named before the ncgm workstation is
216 opened and subsequent pictures must be named immediately after
217 creating the previous picture. Not all pictures need be named
218 and any picture that is not assigned a specific name is assigned
219 blanks in the PICTURE NAME field of the ncgm.
220
221 ´PW´ - Integer - 612
222 Specification, in points, of the PDF output page width.
223
224 ´SC´ - Integer - depends on the workstation type
225 The X11 workstation indicated by the integer should use a
226 "shared" X color model. (-1) indicates the next X11 workstation
227 created.
228
229 ´SH´ - Integer - 612
230 Specification, in points, of the PS output page height.
231
232 ´SE´ - Character - 'GSEG'
233 Specifies a root name for segments created by NCAR GKS. In the
234 default case, the segment name used will be constructed from
235 GSEG by appending an integer constructed from the user id, the
236 process id, and the segment number. By default, the segments
237 are stored in the directory specified by the environment
238 variable TMPDIR (usually set internally at install time to
239 /tmp). If SE is changed away from the default setting, then the
240 segment name will be cunstructed using the value of SE as a root
241 and appending the segment number.
242
243 ´SW´ - Integer - 792
244 Specification, in points, of the PS output page width.
245
246 ´SS´ - Integer - 1
247 Specifies whether segments should be deleted when WISS is
248 closed. The default is to delete segments. Setting SS to a
249 non-default value will cause segments to be saved.
250
251 ´ST´ - Integer - 200
252 Specifies the maximum size of the operand stack used in
253 PostScript output from NCAR GKS. The primary effect of setting
254 this value controls how many points can be included in a
255 locally-defined macro for polylines and filled areas. Larger
256 values result in space savings. This value applies to the
257 specific workstation specified in a previous call to NGSETI to
258 set a value for the ´WO´ parameter (see below). The default
259 value is compatible with the minimum value specified in the
260 Adobe PostScript specifications that is to apply to all
261 PostScript interpreters.
262
263 ´UX´ - Integer - 576
264 Specifies the upper X coordinate value to be used in positioning
265 PostScript output from NCAR GKS on the output page. This value
266 is in the default PostScript user space where one unit
267 corresponds to 1/72 inch. This value must be specified before
268 opening the PostScript workstation to which it will apply. See
269 descriptions for the parameters "LX", "LY", and "UY".
270
271 ´UY´ - Integer - 666
272 An integer that specifies the upper Y coordinate value to be
273 used in positioning PostScript output from NCAR GKS on the
274 output page. This value is in the default PostScript user space
275 where one unit corresponds to 1/72 inch. This value must be
276 specified before opening the PostScript workstation to which it
277 will apply. See descriptions for the parameters "LX", "LY", and
278 "UX".
279
280 ´WO´ - Integer - none
281 An integer specifying the NCAR GKS workstation ID that will be
282 used for subsequent parameters that apply to a specific
283 workstation.
284
286 Online: nggetc, nggeti, nggetr, ngsetc, ngseti, ngsetr, ngpswk,
287 ncarg_cbind.
288
289 http://ngwww.ucar.edu/ngdoc/ng/gks/gkshome.html
290
291 Hardcopy: NCAR Graphics Fundamentals, UNIX Version;
292
294 Copyright (C) 1987-2009
295 University Corporation for Atmospheric Research
296 The use of this Software is governed by a License Agreement.
297
298
299
300UNIX April 1994 Ngmisc_params(3NCARG)