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

NAME

6       Ngmisc_params - This document briefly describes all Ngmisc internal
7       parameters.
8

DESCRIPTION

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

SEE ALSO

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)
Impressum