Provided by: libncarg-dev_6.6.2-10build2_amd64 
NAME
GRIDAL - Draws any of the supported types of backgrounds. Each of the other background-drawing routines
is implemented by a call to GRIDAL.
UTILITY
This routine is part of the Gridall utility in NCAR Graphics. To see the overview man page for this
utility, type "man gridall".
SYNOPSIS
CALL GRIDAL (MJRX, MNRX, MJRY, MNRY, IXLB, IYLB, IGPH,
+ XINT, YINT)
C-BINDING SYNOPSIS
#include <ncarg/ncargC.h>
void c_gridal (int mjrx, int mnrx, int mjry, int mnry,
int ixlb, int iylb, int igph, float xint, float yint)
DESCRIPTION
MJRX, MNRX, MJRY, and MNRY
(input expressions of type INTEGER) specify the major and minor divisions of the horizontal
(X) and vertical (Y) axes of the current viewport. The meanings of these parameters depend on
the current setting of the internal parameter ´LS´ of SPPS:
• If the value of ´LS´ implies that the axis is linear: MJRX(Y) specifies the number of
major divisions of the X(Y) axis and MNRX(Y) specifies the number of minor divisions
within each major division. In each case, the value specifies the number of spaces
between grid lines or ticks rather than the number of lines or ticks. Including the
ones at the ends of the axes, there is always one more major division line or mark
than the number of major divisions specified by MJRX(Y). Similarly, there is always
one less minor division line or tick per major division than the number of minor
divisions per major division specified by MNRX(Y).
• If the value of ´LS´ implies that the axis is logarithmic: Each major division point
occurs at a value 10**MJRX(Y) times the previous point. For example, if the minimum X-
axis value were 3., the maximum X-axis value 3000. and MJRX 1, then the major division
points would be 3., 30., 300., and 3000. If MNRX(Y).LE.10, there are nine minor
divisions within each major division. For example, between 3. and 30., there would be
minor division points at 6., 9., 12., . . . 27. If MNRX(Y).GT.10., minor divisions
are omitted.
IXLB (an input expression of type INTEGER) is defined as follows:
• IXLB = -1 implies that no X axis is to be drawn.
• IXLB = 0 implies that the X axis is to be drawn unlabeled.
• IXLB = 1 implies that the X axis is to be drawn and labeled.
IYLB (an input expression of type INTEGER) is defined as follows:
• IYLB = -1 implies that no Y axis is to be drawn.
• IYLB = 0 implies that the Y axis is to be drawn unlabeled.
• IYLB = 1 implies that the Y axis is to be drawn and labeled.
IGPH (an input expression of type INTEGER) specifies the background type, as follows:
IGPH X axis Y axis
---- ------ ------
0 grid grid
1 grid perim
2 grid halfax
4 perim grid
5 perim perim
6 perim halfax
8 halfax grid
9 halfax perim
10 halfax halfax
XINT and YINT
(input expressions of type REAL), if IGPH has the value 10, are the user coordinates of the
point of intersection of the two axes. For other values of IGPH for which one of the axes is
of type HALFAX, XINT and/or YINT specify the position of that axis.
C-BINDING DESCRIPTION
The C-binding argument descriptions are the same as the FORTRAN argument descriptions.
EXAMPLES
Use the ncargex command to see the following relevant examples: tgrida, ccpga, ccpmpxy.
ACCESS
To use GRIDAL or c_gridal, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in
that order.
MESSAGES
See the gridall man page for a description of all Gridall error messages and/or informational messages.
SEE ALSO
Online: gridall, gridall_params, gacolr, gagetc, gageti, gagetr, gasetc, gaseti, gasetr, grid, gridl,
halfax, labmod, perim, periml, tick4, ticks, ncarg_cbind.
Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
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 GRIDAL(3NCARG)