Provided by: libncarg-dev_6.6.2.dfsg.1-10build2_amd64 
NAME
Gridall_params - This document briefly describes all Gridall internal parameters.
DESCRIPTION
GRIDAL has twenty-two internal parameters, each of which affects, in some way, the behavior of the
routines that draw backgrounds. The current value of a parameter may be retrieved by calling GAGETC,
GAGETI, and/or GAGETR and it may be reset by calling GASETC, GASETI, and/or GASETR; certain parameters
may also be reset by calling other, older, routines (GACOLR, LABMOD, TICKS, and TICK4).
Parameter descriptions, in alphabetical order, of all Gridall internal parameters follow. Each
description begins with a line giving the parameter name and the intrinsic FORTRAN type of the parameter.
´CAX´ - Integer
The polyline color index to be used for drawing the axes. A negative value implies that no change
is to be made in the polyline color index before drawing the axes. The default value of ´CAX´ is
-1; its value may be changed by calling GASETI, GASETR, or GACOLR (argument KAXS) .
´CLB´ - Integer
The polyline/text color index to be used for drawing labels. (Both are affected because the labels
may be drawn using calls to WTSTR or calls to PLCHHQ.) A negative value implies that no change is
to be made in the polyline and text color indices before drawing the labels. The default value of
´CLB´ is -1; its value may be changed by calling GASETI, GASETR, or GACOLR (argument KLBL).
´CMJ´ - Integer
The polyline color index to be used for major ticks and/or grid lines. A negative value implies
that no change is to be made in the polyline color index before drawing major ticks/grid lines.
The default value of ´CMJ´ is -1; its value may be changed by calling GASETI, GASETR, or GACOLR
(argument KMJT).
´CMN´ - Integer
The polyline color index to be used for minor ticks and/or grid lines. A negative value implies
that no change is to be made in the polyline color index before drawing minor ticks/grid lines.
The default value of ´CMN´ is -1; its value may be changed by calling GASETI, GASETR, or GACOLR
(argument KMNT).
´LTY´ - Integer
The labeling type. The value 0 implies that the SPPS routine WTSTR is to be called to draw labels,
the value 1 that the Plotchar routine PLCHHQ is to be called. The default value of ´LTY´ is 0; its
value may be changed by calling GASETI or GASETR.
´WAX´ - Real
The line width to be used for drawing the axes. A value less than or equal to zero implies that no
change is to be made in the line width scale factor before drawing the axes. The default value of
´WAX´ is 0; its value may be changed by calling GASETI or GASETR.
´WLB´ - Real
The line width to be used for drawing labels. (Labels drawn using calls to the Plotchar routine
PLCHHQ are affected by this; those drawn using calls to the SPPS routine WTSTR are not.) A value
less than or equal to zero implies that no change is to be made in the line width scale factor
before drawing the labels. The default value of ´WLB´ is 0; its value may be changed by calling
GASETI or GASETR.
´WMJ´ - Real
The line width to be used for major ticks and/or grid lines. A value less than or equal to zero
implies that no change is to be made in the line width scale factor before drawing. The default
value of ´WMJ´ is 0; its value may be changed by calling GASETI or GASETR.
´WMN´ - Real
The line width to be used for minor ticks and/or grid lines. A value less than or equal to zero
implies that no change is to be made in the line width scale factor before drawing. The default
value of ´WMN´ is 0; its value may be changed by calling GASETI or GASETR.
´XLF´ - Character
The format to be used for labels on the X axis. The character string must begin with a left
parenthesis and end with a right parenthesis and it must not exceed ten characters in length.
Conversions of types E, F, G, and I are allowed. The default value of ´XLF´ is ´(E10.3)´; its
value may be changed by calling GASETC or LABMOD (argument FMTX).
´XLL´ - Integer
The length of each X-axis label. If ´XLL´ is given a non-zero value "n" and LBLX is a string
produced by the format ´XLF´, then the label will be the substring LBLX(1:n). If, on the other
hand, ´XLL´ = 0, then the label will be the substring LBLX(m:n), where LBLX(m:m) is the first non-
blank character in LBLX and LBLX(n:n) is the last non-blank character following LBLX(m:m). Using a
non-zero value for ´XLL´ causes labels to be centered differently than if a zero value is used.
The default value of ´XLL´ is 0; its value may be changed by calling GASETI, GASETR, or LABMOD
(argument NUMX).
´XLO´ - Real
The (vertical) distance of an X-axis label from the X axis. Values between 0 and 1 are interpreted
as fractions of the width of the plotter frame, while values greater than 1 are interpreted as
plotter address units (PAUs). The value is interpreted as the distance from the bottom edge of the
viewport to the nearest Y address of an X-axis label; negative values may be used to put labels
above the viewport. The value 0 is treated as equivalent to 20 and the value 1 is treated as
equivalent to -20-h, where h is the height of the viewport in plotter address units. The default
value of ´XLO´ is 20, which means 20 PAUs; its value may be changed by calling GASETI, GASETR, or
LABMOD (argument IYDC). (Note that the LABMOD argument IXDC corresponds to ´YLO´ and that the
LABMOD argument IYDC corresponds to ´XLO´, which is perhaps somewhat counterintuitive.)
´XLS´ - Real
The size (width) of characters in X-axis labels. Values between 0 and 1 are interpreted as
fractions of the width of the plotter frame, while values greater than or equal to 1 are
interpreted as plotter address units (PAUs). The integral values 0., 1., 2., and 3. mean 8, 12,
16, and 24 PAUs, respectively. Values less than zero are treated as zero. The default value of
´XLS´ is 10, which means 10 PAUs; its value may be changed by calling GASETI, GASETR, or LABMOD
(argument ISZX).
´XMJ´ - Real
The length of major ticks on the X axis. ABS(´XMJ´) specifies the length of major ticks on the X
axis; values between 0 and 1 are interpreted as fractions of the width of the plotter frame, while
values greater than or equal to 1 are interpreted as plotter address units (PAUs). If ´XMJ´ is
positive, the ticks point inward; if ´XMJ´ is negative, the ticks point outward. The default value
of ´XMJ´ is 12, which means 12 PAUs; its value may be changed by calling GASETI, GASETR, or TICKS
(argument LMJX).
´XMN´ - Real
The length of minor ticks on the X axis. ABS(´XMN´) specifies the length of minor ticks on the X
axis; values between 0 and 1 are interpreted as fractions of the width of the plotter frame, while
values greater than or equal to 1 are interpreted as plotter address units (PAUs). If ´XMN´ is
positive, the ticks point inward; if ´XMN´ is negative, the ticks point outward. The default value
of ´XMN´ is 8, which means 8 PAUs; its value may be changed by calling GASETI, GASETR, or TICKS
(argument LMNX).
´XOR´ - Integer
The orientation of X-axis labels. The value 0 implies the use of horizontal labels, while the
value 1 implies the use of vertical labels. The default value is 0; its value may be changed by
calling GASETI, GASETR, or LABMOD (argument IXOR).
´YLF´ - Character
The format to be used for labels on the Y axis. The character string must begin with a left
parenthesis and end with a right parenthesis and it must not exceed ten characters in length.
Conversions of types E, F, G, and I are allowed. The default value of ´YLF´ is ´(E10.3)´; its
value may be changed by calling GASETC or LABMOD (argument FMTY).
´YLL´ - Integer
The length of each Y-axis label. If ´YLL´ is given a non-zero value "n" and LBLY is a string
produced by the format ´YLF´, then the label will be the substring LBLY(1:n). If, on the other
hand, ´YLL´ = 0, then the label will be the substring LBLY(m:n), where LBLY(m:m) is the first non-
blank character in LBLY and LBLY(n:n) is the last non-blank character following LBLY(m:m). Using a
non-zero value for ´YLL´ causes labels to be centered differently than if a zero value is used.
The default value of ´YLL´is 0; its value may be changed by calling GASETI, GASETR, or LABMOD
(argument NUMY).
´YLO´ - Real
The (horizontal) offset distance of a Y-axis label from the Y axis. Values between 0 and 1 are
interpreted as fractions of the width of the plotter frame, while values greater than 1 are
interpreted as plotter address units (PAUs). The value is interpreted as the distance from the
left edge of the viewport to the nearest X address of a Y-axis label; negative values may be used
to put labels to the right of the viewport. The value 0 is treated as equivalent to 20 and the
value 1 is treated as equivalent to -20-w, where w is the width of the viewport in plotter address
units. The default value of ´YLO´ is 20, which means 20 PAUs; its value may be changed by calling
GASETI, GASETR, or LABMOD (argument IXDC). (Note that the LABMOD argument IXDC corresponds to
´YLO´ and that the LABMOD argument IYDC corresponds to ´XLO´, which is perhaps somewhat
counterintuitive.)
´YLS´ - Real
The size (width) of characters in Y-axis labels. Values between 0 and 1 are interpreted as
fractions of the width of the plotter frame, while values greater than or equal to 1 are
interpreted as plotter address units (PAUs). The integral values 0., 1., 2., and 3. mean 8, 12,
16, and 24 PAUs, respectively. Values less than zero are treated as zero. The default value of
´YLS´ is 10, which means 10 PAUs; its value may be changed by calling GASETI, GASETR, or LABMOD
(argument ISZY).
´YMJ´ - Real
The length of major ticks on the Y axis. ABS(´YMJ´) specifies the length of major ticks on the Y
axis; values between 0 and 1 are interpreted as fractions of the width of the plotter frame, while
values greater than or equal to 1 are interpreted as plotter address units (PAUs). If ´YMJ´ is
positive, the ticks point inward; if ´YMJ´ is negative, the ticks point outward. The default value
of ´YMJ´ is 12, which means 12 PAUs; its value may be changed by calling GASETI, GASETR, or TICKS
(argument LMJY).
´YMN´ - Real
The length of minor ticks on the Y axis. ABS(´YMN´) specifies the length of minor ticks on the Y
axis; values between 0 and 1 are interpreted as fractions of the width of the plotter frame, while
values greater than or equal to 1 are interpreted as plotter address units (PAUs). If ´YMN´ is
positive, the ticks point inward; if ´YMN´ is negative, the ticks point outward. The default value
of ´YMN´ is 8, which means 8 PAUs; its value may be changed by calling GASETI, GASETR, or TICKS
(argument LMNY).
SEE ALSO
Online: gridall, gacolr, gagetc, gageti, gagetr, gasetc, gaseti, gasetr, labmod, tick4, ticks.
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.
UNIX March 1993 Gridall_params(3NCARG)