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

NAME

6       HALFAX - Draws orthogonal axes intersecting at a specified point and
7       with a specified set of labels.
8

SYNOPSIS

10       CALL HALFAX (MJRX,MNRX,MJRY,MNRY,XINT,YINT,IXLB,IYLB)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_halfax (int mjrx, int mnrx, int mjry, int mnry,
16       float xint, float yint, int ixlb, int iylb)
17

DESCRIPTION

19       MJRX, MNRX, MJRY, and MNRY
20                   (input expressions of type INTEGER) specify the major and
21                   minor divisions of the horizontal (X) and vertical (Y) axes
22                   of the current viewport. The meanings of these parameters
23                   depend on the current setting of the internal parameter
24                   ´LS´ of SPPS:
25
26                   ·      If the value of ´LS´ implies that the axis is
27                          linear: MJRX(Y) specifies the number of major
28                          divisions of the X(Y) axis and MNRX(Y) specifies the
29                          number of minor divisions within each major
30                          division. In each case, the value specifies the
31                          number of spaces between grid lines or ticks rather
32                          than the number of lines or ticks. Including the
33                          ones at the ends of the axes, there is always one
34                          more major division line or mark than the number of
35                          major divisions specified by MJRX(Y). Similarly,
36                          there is always one less minor division line or tick
37                          per major division than the number of minor
38                          divisions per major division specified by MNRX(Y).
39
40                   ·      If the value of ´LS´ implies that the axis is
41                          logarithmic: Each major division point occurs at a
42                          value 10**MJRX(Y) times the previous point. For
43                          example, if the minimum X-axis value were 3., the
44                          maximum X-axis value 3000. and MJRX 1, then the
45                          major division points would be 3., 30., 300., and
46                          3000. If MNRX(Y).LE.10, there are nine minor
47                          divisions within each major division. For example,
48                          between 3. and 30., there would be minor division
49                          points at 6., 9., 12., .  . . 27. If MNRX(Y).GT.10.,
50                          minor divisions are omitted.
51
52       XINT and YINT
53                   (input expressions of type REAL) are the user coordinates
54                   of the point of intersection of the two axes.
55
56       IXLB        (an input expression of type INTEGER) is defined as
57                   follows:
58
59                   ·      IXLB = -1 implies that no X axis is to be drawn.
60
61                   ·      IXLB = 0 implies that the X axis is to be drawn
62                          unlabeled.
63
64                   ·      IXLB = 1 implies that the X axis is to be drawn and
65                          labeled.
66
67       IYLB        (an input expression of type INTEGER) is defined as
68                   follows:
69
70                   ·      IYLB = -1 implies that no Y axis is to be drawn.
71
72                   ·      IYLB = 0 implies that the Y axis is to be drawn
73                          unlabeled.
74
75                   ·      IYLB = 1 implies that the Y axis is to be drawn and
76                          labeled.
77

C-BINDING DESCRIPTION

79       The C-binding argument descriptions are the same as the FORTRAN
80       argument descriptions.
81

USAGE

83       The statement
84
85          CALL HALFAX (MJRX,MNRX,MJRY,MNRY,XINT,YINT,IXLB,IYLB)
86
87       is equivalent to
88
89          CALL GRIDAL (MJRX,MNRX,MJRY,MNRY,IXLB,IYLB,10,XINT,YINT)
90

EXAMPLES

92       Use the ncargex command to see the following relevant example: tgrida.
93

ACCESS

95       To use HALFAX or c_halfax, load the NCAR Graphics libraries ncarg,
96       ncarg_gks, and ncarg_c, preferably in that order.
97

SEE ALSO

99       Online: gridall, gacolr, gagetc, gageti, gagetr, gasetc, gaseti,
100       gasetr, grid, gridal, gridl, labmod, perim, periml, tick4, ticks,
101       ncarg_cbind.
102
103       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
104
106       Copyright (C) 1987-2007
107       University Corporation for Atmospheric Research
108
109       This documentation is free software; you can redistribute it and/or
110       modify it under the terms of the GNU General Public License as
111       published by the Free Software Foundation; either version 2 of the
112       License, or (at your option) any later version.
113
114       This software is distributed in the hope that it will be useful, but
115       WITHOUT ANY WARRANTY; without even the implied warranty of
116       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
117       General Public License for more details.
118
119       You should have received a copy of the GNU General Public License along
120       with this software; if not, write to the Free Software Foundation,
121       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
122
123
124
125UNIX                              March 1993                    HALFAX(3NCARG)
Impressum