Ngmisc_params(3NCARG)

📦 version 6.6.2, in epel 9, fedora 43, fedora 44

💖 NAME 💖

Ngmisc_params — and btw this whole thing lives in the NCAR GRAPHICS manual, section 3NCARG. It's the doc that briefly describes all the Ngmisc internal parameters, like every single one, no skips.

✨ DESCRIPTION ✨

Okay bestie, here's the vibe: this is a rundown of all the Ngmisc internal parameters, alphabetically, no gatekeeping. Every entry hands you the parameter name, its FORTRAN type, its default value, and a lil description of what it actually does. Let's get into it 💅

🎀 'CA' — Integer — default 1

This one controls the type of line cap used in PostScript output from NCAR GKS.

  • value 0 → butt caps
  • value 1 → round caps
  • value 2 → projecting square caps

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 — default 1

Specifies whether clipping to NDC space is on in NCAR GKS. A value of "1" turns clipping on, and a value of "0" turns it off.

This flag controls whether filled areas and polylines get clipped if they go out of the world coordinate rectangle that gets mapped onto NDC space.

⚠️ Do not confuse this clipping with the clipping controlled by the GKS GSCLIP function — that function controls whether clipping is done to the viewport of the current normalization transformation, not to NDC space itself (unless the viewport of the current normalization transformation happens to be the entirety of NDC space, which, okay, then it's the same thing).

🎀 'CM' — Integer — default 1

  • CM equals 1 → the RGB color model is used for PostScript output
  • CM equals 0 → the CMYK color model is used for PostScript output

Pick your fighter ✨

🎀 'CO' — Integer — default 25

A positive integer specifying a scale factor for the integer coordinate values in PostScript output from NCAR GKS.

This value applies to the first PostScript workstation opened with GOPWK after specifying the value for 'CO'.

Okay so context, because this one's important: 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' multiplies the PostScript user coordinates by the specified amount.

  • bigger values for CO → more accurate coordinate positions, but bigger files (more space is needed to represent the larger integer coordinate values)
  • smaller numbers → less accurate coordinate positions, but smaller file sizes

Trade-offs, bestie, it's giving balance 😭

🎀 'CT' — Integer — default 0

Specifies whether NGDOTS draws filled dots or circles.

  • value of CT is 0 → filled dots are drawn
  • value of CT is not 0 → circles are drawn

🎀 'ER' — Integer — default 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. Non-negotiable.

🎀 'FI' — Real — default 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 — default 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.

  • value is 0 → the background color applies only to the viewport area
  • value is non-zero → 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 — default 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 — default 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. So like, default behavior = standard behavior, we love a compliant icon 👑

🎀 'JO' — Integer — default 1

Controls the type of line join used in PostScript output from NCAR GKS.

  • value is 0 → miter joins
  • value is 1 → round joins
  • value is 2 → bevel joins

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 — default 1

Specifies the secondary logo color.

(Heads up: this is applicable only for logo type 5, in which case the secondary color is used for the text string "UCAR".)

🎀 'LC' — Integer — default 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. Fancy ✨)

🎀 'LT' — Integer — default 1

Specify the logo type.

For a list of the logo types, go read the documentation for NGLOGO, or just run:

ncargex miex01

for an example plot that lists the logo types. Iconic, honestly.

🎀 'LX' — Integer — default 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 — default 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 — default 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 — default 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 — default 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 — default 1.0

A positive real number specifying a scale factor for the nominal linewidth in PostScript output from NCAR GKS.

  • set it larger than 1.0 → all line thicknesses get fatter by that amount
  • set it smaller than 1.0 → all line thicknesses get 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 — default 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. Math, but make it fashion 💅

🎀 'OX' — Real — default 0.93

Specify the logo X-coordinate position in normalized device coordinates.

🎀 'OY' — Real — default 0.05

Specify the logo Y-coordinate position in normalized device coordinates.

🎀 'PA' — Integer — default 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 — so go read the documentation for your local PostScript interpreter to determine this value. iykyk 🔥

🎀 'PC' — Integer — default 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 — default 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 length of a diagonal of the RGB color cube. Geometry jumpscare, but okay we move 🧚

🎀 'PH' — Integer — default 792

Specification, in points, of the PDF output page height.

  • PI — Character — defaults to blanks 💖

A character string that's gonna be the picture name for the current picture, dropped into the PICTURE NAME element of an ncgm file. Bestie, listen: the first picture has to be named before the ncgm workstation gets opened, and every picture after that has to be named immediately after you create the previous one. Not every picture needs a name tho — any picture that doesn't get one just gets blanks in the PICTURE NAME field of the ncgm. 🎀

  • PW — Integer — defaults to 612 ✨

The PDF output page width, specified in points.

  • SC — Integer — default depends on the workstation type 🌈

The X11 workstation indicated by the integer should use a "shared" X color model. (-1) means the next X11 workstation created.

  • SH — Integer — defaults to 612 🦋

The PS output page height, specified in points.

  • SE — Character — defaults to 'GSEG' 🌸

Sets a root name for segments created by NCAR GKS. In the default case, the segment name gets built from GSEG by appending an integer made out of the user id, the process id, and the segment number. By default the segments live in the directory named by the environment variable TMPDIR (which is usually set internally at install time to /tmp). If you change SE away from the default, then the segment name gets constructed using the value of SE as a root and appending the segment number.

  • SW — Integer — defaults to 792 💜

The PS output page width, specified in points.

  • SS — Integer — defaults to 1 🫶

Says whether segments should be deleted when WISS is closed. Default behaviour is to delete the segments. Setting SS to a non-default value makes the segments get saved instead.

  • ST — Integer — defaults to 200 🔥

The maximum size of the operand stack used in PostScript output from NCAR GKS. The main thing this value controls is how many points can fit in a locally-defined macro for polylines and filled areas. Bigger values = space savings, periodt. This value applies to the specific workstation you named in a previous call to NGSETI to set a value for the WO parameter (peep below 👀). The default value is compatible with the minimum value specified in the Adobe PostScript specifications that's meant to apply to all PostScript interpreters.

  • UX — Integer — defaults to 576 ⭐

The upper X coordinate value used when positioning PostScript output from NCAR GKS on the output page. This value is in the default PostScript user space, where one unit = 1/72 inch. You must set this before opening the PostScript workstation it's gonna apply to. Go read the descriptions for the parameters LX, LY, and UY too. 💅

  • UY — Integer — defaults to 666 🧚

An integer that's the upper Y coordinate value used when positioning PostScript output from NCAR GKS on the output page. This value is in the default PostScript user space, where one unit = 1/72 inch. You must set this before opening the PostScript workstation it's gonna apply to. See the descriptions for the parameters LX, LY, and UX. 🌟

  • WO — Integer — default: none 💀

An integer naming the NCAR GKS workstation ID that'll be used for any subsequent parameters that apply to a specific workstation.

✨ SEE ALSO ✨

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
that's a wrap bestie 💖 this lil page ships as part of the UNIX manual, dated April 1994, under the name Ngmisc_params(3NCARG). go forth and set ur params, queen 👑✨
📦 where this page comes from