1LABMOD(3NCARG) NCAR GRAPHICS LABMOD(3NCARG)
2
6 LABMOD - Presets parameters controlling the appearance of labels drawn
7 by GRIDAL, GRIDL,... et al. LABMOD itself does no plotting and, in
8 order to have any effect, must be called prior to the background-
9 drawing routines for which it is presetting parameters.
10
12 CALL LABMOD (FMTX, FMTY, NUMX, NUMY, ISZX, ISZY, IXDC,
13 + IYDC, IXOR)
14
16 #include <ncarg/ncargC.h>
17 void c_labmod (char *fmtx, char *fmty, int numx, int numy,
19 int iszx, int iszy, int ixdc, int iydc, int ixor)
20
22 FMTX and FMTY
23 (input expressions of type CHARACTER) contain format
24 specifications for the X-axis and Y-axis numerical labels
25 produced by GRIDAL, GRIDL, HALFAX, or PERIML. The
26 specification must begin with a left parenthesis and end
27 with a right parenthesis and must not be more than ten
28 characters long. Conversions of types E, F, G, and I are
29 allowed; for example, one might use FMTX=´(F8.2)´ and
30 FMTY=´(E10.0)´. The default for both formats is ´(E10.3)´.
31 NOTE: I formats are allowed by this version of Gridall;
33 they were not allowed by previous versions.
34 NUMX (an input expression of type INTEGER), if non-zero, is the
36 number of characters in each X-axis numeric label; if LBLX
37 is a string produced by the format FMTX, then the label
38 will be the substring LBLX(1:NUMX). If NUMX is 0, then the
39 label will be the substring LBLX(m:n), where LBLX(m:m) is
40 the first non-blank character in LBLX, and LBLX(n:n) is the
41 last non-blank character following LBLX(m:m). Using a non-
42 zero NUMX causes the labels to be centered differently than
43 if a zero value is used. The default value for NUMX is 0.
44 NUMY (an input expression of type INTEGER) is defined just like
46 NUMX, but applies to Y-axis numeric labels.
47 ISZX and ISZY
49 (input expressions of type INTEGER) are character sizes for
50 the labels, specified in plotter address units, just as for
51 the SPPS routines PWRIT and WTSTR. The default value for
52 both is 10.
53 IXDC (an input expression of type INTEGER) is the decrement, in
55 plotter address units (PAUs - by default, the plotter frame
56 is 1023 PAUs in width and height), from the left edge of
57 the current viewport to the nearest X address of the label
58 specified by FMTY, NUMY, and ISZY. For example, if the
59 horizontal extent of the current viewport is defined by the
60 normalized device coordinates .1 and .9, and if IXDC is 60,
61 and if there has been no call to the SPPS routine SETI
62 (which can change the size of a PAU), then labels on the Y
63 axis will end at plotter coordinate 43 (.1*1023+1-60).
64 Negative values may be used to put labels on the other side
65 of the viewport; in the example given, changing IXDC to
66 -878 (-.8*1023 -60) would put the labels on the right side
67 of the viewport, with their left edges 60 plotter-
68 coordinate units away from the edge of the viewport. There
69 are two special values of IXDC:
70 · If IXDC=0, the Y-axis labels will end 20 plotter
72 address units to the left of the viewport
73 (equivalent to using IXDC=20).
74 · If IXDC=1, Y-axis labels will begin 20 plotter
76 address units to the right of the viewport
77 (equivalent to using IXDC=-20-w, where w is the
78 width of the viewport, in plotter address units).
79 The default value of IXDC is 20.
81 When HALFAX is called or when GRIDAL is called with IGPH =
83 2, 6, or 10, IXDC is the distance from the Y axis, rather
84 than from the minimum viewport coordinate, and the special
85 values 0 and 1 are equivalent to 20 and -20.
86 IYDC (an input expression of type INTEGER) is the decrement, in
88 plotter address units (PAUs - by default, the plotter frame
89 is 1023 PAUs in width and height), from the bottom edge of
90 the current viewport to the nearest Y address of the label
91 specified by FMTX, NUMX, and ISZX. Note that negative
92 values may be used to put labels above the viewport. There
93 are two special values of IYDC:
94 · If IYDC=0, the top of the X-axis labels will be 20
96 plotter address units below the bottom edge of the
97 viewport (equivalent to using IYDC=20).
98 · If IYDC=1, the bottom of the X-axis labels will be
100 20 plotter address units above the top edge of the
101 viewport (equivalent to using IYDC=-20-h, where h is
102 the height of the viewport, in plotter address
103 units).
104 The default value of IYDC is 20.
106 When HALFAX is called or when GRIDAL is called with IGPH =
108 8, 9, or 10, IYDC is the distance from the X axis, rather
109 than from the minimum viewport coordinate, and the special
110 values 0 and 1 are equivalent to 20 and -20.
111 IXOR (an input expression of type INTEGER) specifies the
113 orientation of the X-axis labels:
114 · IXOR = 0 implies the use of horizontal labels.
116 · IXOR = 1 implies the use of vertical labels.
118 The default orientation is horizontal.
120
122 The C-binding argument descriptions are the same as the FORTRAN
123 argument descriptions.
124
126 This routine allows you to set the current value of Gridall parameters.
127 For a complete list of parameters available in this utility, see the
128 gridall_params man page.
129
131 Use the ncargex command to see the following relevant examples: bnchmk,
132 tgrida, ccpga, ccpmpxy.
133
135 To use LABMOD or c_labmod, load the NCAR Graphics libraries ncarg,
136 ncarg_gks, and ncarg_c, preferably in that order.
137
139 Online: gridall, gridall_params, gacolr, gagetc, gageti, gagetr,
140 gasetc, gaseti, gasetr, grid, gridal, gridl, halfax, perim, periml,
141 tick4, ticks, ncarg_cbind.
142 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
144 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
146
148 Copyright (C) 1987-2007
149 University Corporation for Atmospheric Research
150 This documentation is free software; you can redistribute it and/or
152 modify it under the terms of the GNU General Public License as
153 published by the Free Software Foundation; either version 2 of the
154 License, or (at your option) any later version.
155 This software is distributed in the hope that it will be useful, but
157 WITHOUT ANY WARRANTY; without even the implied warranty of
158 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
159 General Public License for more details.
160 You should have received a copy of the GNU General Public License along
162 with this software; if not, write to the Free Software Foundation,
163 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
164UNIX March 1993 LABMOD(3NCARG)