bionic (3) ngmisc_params.3NCARG.gz
NAME
Ngmisc_params - This document briefly describes all Ngmisc internal parameters.
DESCRIPTION
Parameter descriptions, in alphabetical order, of all Ngmisc internal parameters follow. Each entry
includes the name of a parameter, its FORTRAN type, its default value, and a short description of the
parameter.
´CA´ - Integer - 1
This parameter controls the type of line cap used in PostScript output from NCAR GKS. If the
value is 0, butt caps are used; if the value is 1, round caps are used; if the value is 2,
projecting square caps are used. This value applies to the specific workstation specified in a
previous call to NGSETI to set a value for the ´WO´ parameter (see below).
´CL´ - Integer - 1
Specifies whether clipping to NDC space is on in NCAR GKS. A value of "1" will turn clipping on
and a value of "0" will turn it off. This flag controls whether filled areas and polylines are
clipped if they go out of the world coordinate rectangle that gets mapped onto NDC space. This
clipping is not to be confused with the clipping that is controlled by the GKS GSCLIP function -
that function controls whether clipping is to be done to the viewport of the current normalization
transformation, not to NDC space itself (unless the viewport of the current normalization
transformation is the entirety of NDC space).
´CM´ - Integer - 1
If CM equals 1, then the RGB color model is used for PostScript output; if CM equals 0, then the
CMYK color model is used for PostScript output.
´CO´ - Integer - 25
A positive integer specifying a scale factor for the integer coordinate values in PostScript
output from NCAR GKS. This value will apply to the first PostScript workstation opened with GOPWK
after specifying the value for ´CO´. The default coordinates in PostScript user space represent
units of 1/72 of an inch; for an 8 1/2 inch by 11 inch page in portrait mode, the default
PostScript user coordinate space is 0 to 612 in X and 0 to 792 in Y. The value of ´CO´
will multiply the PostScript user coordinates by the specified amount. Specifying larger values
for CO will increase the accuracy of coordinate positions at the expense of larger files (more
space is needed to represent the larger integer coordinate values); smaller numbers reduce the
accuracy of coordinate positions, but reduce file sizes.
´CT´ - Integer - 0
Specifies whether NGDOTS will draw filled dots or circles. If the value of CT is 0, then filled
dots are drawn. If the value of CT is not 0, then circles are drawn.
´ER´ - Integer - 10
Specifies the maximum number of error messages that will be issued by NCAR GKS before it
terminates execution. ER must be larger than zero.
´FI´ - Real - 0.0005
A real number in the range 0. to 1. (normalized device coordinate space) that specifies the
spacing between fill lines used in software fill in PostScript output from NCAR GKS. This value
applies to the specific workstation specified in a previous call to NGSETI to set a value for the
"WO" parameter (see below).
´FU´ - Integer - 0
Controls whether the background color is applied to the entirety of a page, or just the viewport
area, in PostScript output from NCAR GKS. If the value is 0, then the background color applies
only to the viewport area; if the value is non-zero, then the background color covers the entire
page. This value applies to the specific workstation specified in a previous call to NGSETI to
set a value for the ´WO´ parameter (see below).
´HA´ - Real - 0.01
A real number in the range 0. to 1. (normalized device coordinate space) that specifies the
spacing between hatch lines used in hatch-pattern filled areas in PostScript output from NCAR GKS.
This value applies to the specific workstation specified in a previous call to NGSETI to set a
value for the ´WO´ parameter (see below).
´IG´ - Integer - 0
A flag to indicate whether the clip rectangles in segment copies should be transformed by using
the current segment transformation. The GKS standard says that the clip rectangles should not be
so transformed and this is the default.
´JO´ - Integer - 1
Controls the type of line join used in PostScript output from NCAR GKS. If the value is 0, miter
joins are used; if the value is 1, round joins are used; if the value is 2, bevel joins are used.
This value applies to the specific workstation specified in a previous call to NGSETI to set a
value for the ´WO´ parameter (see below).
´LB´ - Integer - 1
Specifies the secondary logo color (this is applicable only for logo type 5, in which case the
secondary color is used for the text string "UCAR").
´LC´ - Integer - 1
Specifies the logo color (except in the case of an NCAR logo being plotted to a PostScript
workstation, in which case you will get the full-color logo).
´LT´ - Integer - 1
Specify the logo type. See the documentation for NGLOGO for a list of the logo types, or execute
"ncargex miex01" for an example plot that lists the logo types.
´LX´ - Integer - 36
Specifies the left X coordinate value to be used in positioning PostScript output from NCAR GKS on
the output page. This value is in the default PostScript user space where one unit corresponds to
1/72 inch. This value must be specified before opening the PostScript workstation to which it
will apply. See descriptions for the parameters ´LY´, ´UX´, and ´UY´.
´LY´ - Integer - 126
Specifies the lower Y coordinate value to be used in positioning PostScript output from NCAR GKS
on the output page. This value is in the default PostScript user space where one unit corresponds
to 1/72 inch. This value must be specified before opening the PostScript workstation to which it
will apply. See descriptions for the parameters ´LX´, ´UX´, and ´UY´.
´MC´ - Integer - depends on the workstation type
The X11 workstation indicated by the integer should use a "mixed" X color model. (-1) indicates
the next X11 workstation created.
´ME´ - Character - depends on the workstation type
A character string that specifies the metafile name that will be used by the next NCAR GKS GOPWK
call that opens a GKS CGM or PostScript workstation.
´MI´ - Real - 10.
Controls the miter limit of line joins in PostScript output from NCAR GKS. This applies only if
line joins are specified as mitered joins (see the description of the parameter ´JO´ above). This
value applies to the specific workstation specified in a previous call to NGSETI to set a value
for the ´WO´ parameter (see below).
´NO´ - Real - 1.0
A positive real number specifying a scale factor for the nominal linewidth in PostScript output
from NCAR GKS. Setting the value larger than 1.0 will result in all line thicknesses being fatter
by that amount; setting the value smaller than 1.0 will result in all line thicknesses being
narrower by that amount. This value applies to the specific workstation specified in a previous
call to NGSETI to set a value for the ´WO´ parameter (see below).
´OS´ - Real - 0.07
Specifies the logo size in normalized device coordinates (a number between 0. and 1.). For
example, a size specification of 0.1 would give a logo size one-tenth the maximum plot height.
´OX´ - Real - 0.93
Specify the logo X-coordinate position in normalized device coordinates.
´OY´ - Real - 0.05
Specify the logo Y-coordinate position in normalized device coordinates.
´PA´ - Integer - 1300
Specifies the maximum size of paths used in PostScript output from NCAR GKS. This value controls
when software fill will be used in place of hardware fill. Larger values result in significant
file size and interpretation time savings. This value applies to the specific workstation
specified in a previous call to NGSETI to set a value for the ´WO´ parameter (see below). The
default value is compatible with the minimum value specified in the Adobe PostScript
specifications that is to apply to all PostScript interpreters. A specific interpreter may allow
for significantly larger paths. See the documentation for your local PostScript interpreter to
determine this value.
´PC´ - Integer - depends on the workstation type
The X11 workstation indicated by the integer should use a "private" X color model. (-1) indicates
the next X11 workstation created.
´PE´ - Integer - 20
Percentage error allowed in matching requested colors in X Window output where the window shares a
single color map with all the other current X windows. The value "0" is special and is the same
as the value "100" meaning that any color may be selected. In the default environment all X11
windows share a single color map and when a request is made to allocate a new color, and there are
no more colors left, then the nearest color (to within the stated percentage) is selected. The
"nearest color" is the one in the current color table that is closest using the normal distance
metric in the RGB color cube. The percentage error is measured as a percentage of lenght of a
diagonal of the RGB color cube.
´PH´ - Integer - 792
Specification, in points, of the PDF output page height.
´PI´ - Character - blanks
A character string that will be used for the picture name of the current picture in the PICTURE
NAME element of an ncgm file. The first picture must be named before the ncgm workstation is
opened and subsequent pictures must be named immediately after creating the previous picture. Not
all pictures need be named and any picture that is not assigned a specific name is assigned blanks
in the PICTURE NAME field of the ncgm.
´PW´ - Integer - 612
Specification, in points, of the PDF output page width.
´SC´ - Integer - depends on the workstation type
The X11 workstation indicated by the integer should use a "shared" X color model. (-1) indicates
the next X11 workstation created.
´SH´ - Integer - 612
Specification, in points, of the PS output page height.
´SE´ - Character - 'GSEG'
Specifies a root name for segments created by NCAR GKS. In the default case, the segment name
used will be constructed from GSEG by appending an integer constructed from the user id, the
process id, and the segment number. By default, the segments are stored in the directory
specified by the environment variable TMPDIR (usually set internally at install time to /tmp). If
SE is changed away from the default setting, then the segment name will be cunstructed using the
value of SE as a root and appending the segment number.
´SW´ - Integer - 792
Specification, in points, of the PS output page width.
´SS´ - Integer - 1
Specifies whether segments should be deleted when WISS is closed. The default is to delete
segments. Setting SS to a non-default value will cause segments to be saved.
´ST´ - Integer - 200
Specifies the maximum size of the operand stack used in PostScript output from NCAR GKS. The
primary effect of setting this value controls how many points can be included in a locally-defined
macro for polylines and filled areas. Larger values result in space savings. This value applies
to the specific workstation specified in a previous call to NGSETI to set a value for the ´WO´
parameter (see below). The default value is compatible with the minimum value specified in the
Adobe PostScript specifications that is to apply to all PostScript interpreters.
´UX´ - Integer - 576
Specifies the upper X coordinate value to be used in positioning PostScript output from NCAR GKS
on the output page. This value is in the default PostScript user space where one unit corresponds
to 1/72 inch. This value must be specified before opening the PostScript workstation to which it
will apply. See descriptions for the parameters "LX", "LY", and "UY".
´UY´ - Integer - 666
An integer that specifies the upper Y coordinate value to be used in positioning PostScript output
from NCAR GKS on the output page. This value is in the default PostScript user space where one
unit corresponds to 1/72 inch. This value must be specified before opening the PostScript
workstation to which it will apply. See descriptions for the parameters "LX", "LY", and "UX".
´WO´ - Integer - none
An integer specifying the NCAR GKS workstation ID that will be used for subsequent parameters that
apply to a specific workstation.
SEE ALSO
Online: nggetc, nggeti, nggetr, ngsetc, ngseti, ngsetr, ngpswk, ncarg_cbind.
http://ngwww.ucar.edu/ngdoc/ng/gks/gkshome.html
Hardcopy: NCAR Graphics Fundamentals, UNIX Version;
COPYRIGHT
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.