1GRIDAL(3NCARG) NCAR GRAPHICS GRIDAL(3NCARG)
2
6 GRIDAL - Draws any of the supported types of backgrounds. Each of the
7 other background-drawing routines is implemented by a call to GRIDAL.
8
10 This routine is part of the Gridall utility in NCAR Graphics. To see
11 the overview man page for this utility, type "man gridall".
12
14 CALL GRIDAL (MJRX, MNRX, MJRY, MNRY, IXLB, IYLB, IGPH,
15 + XINT, YINT)
16
18 #include <ncarg/ncargC.h>
19 void c_gridal (int mjrx, int mnrx, int mjry, int mnry,
21 int ixlb, int iylb, int igph, float xint, float yint)
22
24 MJRX, MNRX, MJRY, and MNRY
25 (input expressions of type INTEGER) specify the major and
26 minor divisions of the horizontal (X) and vertical (Y) axes
27 of the current viewport. The meanings of these parameters
28 depend on the current setting of the internal parameter
29 ´LS´ of SPPS:
30 · If the value of ´LS´ implies that the axis is
32 linear: MJRX(Y) specifies the number of major
33 divisions of the X(Y) axis and MNRX(Y) specifies the
34 number of minor divisions within each major
35 division. In each case, the value specifies the
36 number of spaces between grid lines or ticks rather
37 than the number of lines or ticks. Including the
38 ones at the ends of the axes, there is always one
39 more major division line or mark than the number of
40 major divisions specified by MJRX(Y). Similarly,
41 there is always one less minor division line or tick
42 per major division than the number of minor
43 divisions per major division specified by MNRX(Y).
44 · If the value of ´LS´ implies that the axis is
46 logarithmic: Each major division point occurs at a
47 value 10**MJRX(Y) times the previous point. For
48 example, if the minimum X-axis value were 3., the
49 maximum X-axis value 3000. and MJRX 1, then the
50 major division points would be 3., 30., 300., and
51 3000. If MNRX(Y).LE.10, there are nine minor
52 divisions within each major division. For example,
53 between 3. and 30., there would be minor division
54 points at 6., 9., 12., . . . 27. If MNRX(Y).GT.10.,
55 minor divisions are omitted.
56 IXLB (an input expression of type INTEGER) is defined as
58 follows:
59 · IXLB = -1 implies that no X axis is to be drawn.
61 · IXLB = 0 implies that the X axis is to be drawn
63 unlabeled.
64 · IXLB = 1 implies that the X axis is to be drawn and
66 labeled.
67 IYLB (an input expression of type INTEGER) is defined as
69 follows:
70 · IYLB = -1 implies that no Y axis is to be drawn.
72 · IYLB = 0 implies that the Y axis is to be drawn
74 unlabeled.
75 · IYLB = 1 implies that the Y axis is to be drawn and
77 labeled.
78 IGPH (an input expression of type INTEGER) specifies the
80 background type, as follows:
81 IGPH X axis Y axis
84 ---- ------ ------
85 0 grid grid
86 1 grid perim
87 2 grid halfax
88 4 perim grid
89 5 perim perim
90 6 perim halfax
91 8 halfax grid
92 9 halfax perim
93 10 halfax halfax
94 XINT and YINT
96 (input expressions of type REAL), if IGPH has the value 10,
97 are the user coordinates of the point of intersection of
98 the two axes. For other values of IGPH for which one of the
99 axes is of type HALFAX, XINT and/or YINT specify the
100 position of that axis.
101
103 The C-binding argument descriptions are the same as the FORTRAN
104 argument descriptions.
105
107 Use the ncargex command to see the following relevant examples: tgrida,
108 ccpga, ccpmpxy.
109
111 To use GRIDAL or c_gridal, load the NCAR Graphics libraries ncarg,
112 ncarg_gks, and ncarg_c, preferably in that order.
113
115 See the gridall man page for a description of all Gridall error
116 messages and/or informational messages.
117
119 Online: gridall, gridall_params, gacolr, gagetc, gageti, gagetr,
120 gasetc, gaseti, gasetr, grid, gridl, halfax, labmod, perim, periml,
121 tick4, ticks, ncarg_cbind.
122 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
124 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
126
128 Copyright (C) 1987-2007
129 University Corporation for Atmospheric Research
130 This documentation is free software; you can redistribute it and/or
132 modify it under the terms of the GNU General Public License as
133 published by the Free Software Foundation; either version 2 of the
134 License, or (at your option) any later version.
135 This software is distributed in the hope that it will be useful, but
137 WITHOUT ANY WARRANTY; without even the implied warranty of
138 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
139 General Public License for more details.
140 You should have received a copy of the GNU General Public License along
142 with this software; if not, write to the Free Software Foundation,
143 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
144UNIX March 1993 GRIDAL(3NCARG)