1GRIDAL(3NCARG)                   NCAR GRAPHICS                  GRIDAL(3NCARG)
2
3
4

NAME

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

UTILITY

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

SYNOPSIS

14        CALL GRIDAL (MJRX, MNRX, MJRY, MNRY, IXLB, IYLB, IGPH,
15       + XINT, YINT)
16

C-BINDING SYNOPSIS

18       #include <ncarg/ncargC.h>
19
20       void c_gridal (int mjrx, int mnrx, int mjry, int mnry,
21       int ixlb, int iylb, int igph, float xint, float yint)
22

DESCRIPTION

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
31                   ·      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
45                   ·      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
57       IXLB        (an input expression of type INTEGER) is defined as
58                   follows:
59
60                   ·      IXLB = -1 implies that no X axis is to be drawn.
61
62                   ·      IXLB = 0 implies that the X axis is to be drawn
63                          unlabeled.
64
65                   ·      IXLB = 1 implies that the X axis is to be drawn and
66                          labeled.
67
68       IYLB        (an input expression of type INTEGER) is defined as
69                   follows:
70
71                   ·      IYLB = -1 implies that no Y axis is to be drawn.
72
73                   ·      IYLB = 0 implies that the Y axis is to be drawn
74                          unlabeled.
75
76                   ·      IYLB = 1 implies that the Y axis is to be drawn and
77                          labeled.
78
79       IGPH        (an input expression of type INTEGER) specifies the
80                   background type, as follows:
81
82
83                             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
95       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

C-BINDING DESCRIPTION

103       The C-binding argument descriptions are the same as the FORTRAN
104       argument descriptions.
105

EXAMPLES

107       Use the ncargex command to see the following relevant examples: tgrida,
108       ccpga, ccpmpxy.
109

ACCESS

111       To use GRIDAL or c_gridal, load the NCAR Graphics libraries ncarg,
112       ncarg_gks, and ncarg_c, preferably in that order.
113

MESSAGES

115       See the gridall man page for a description of all Gridall error
116       messages and/or informational messages.
117

SEE ALSO

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
123       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
124
125       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
126
128       Copyright (C) 1987-2009
129       University Corporation for Atmospheric Research
130       The use of this Software is governed by a License Agreement.
131
132
133
134UNIX                              March 1993                    GRIDAL(3NCARG)
Impressum