.TH LABMOD 3NCARG "March 1993" UNIX "NCAR GRAPHICS"
.na
.nh
.SH NAME
LABMOD - Presets parameters controlling the appearance of
labels drawn by GRIDAL, GRIDL,... et al. LABMOD itself does
no plotting and, in order to have any effect, must be called
prior to the background-drawing routines for which it is
presetting parameters.
.SH SYNOPSIS
 CALL LABMOD (FMTX, FMTY, NUMX, NUMY, ISZX, ISZY, IXDC, 
.br
+ IYDC, IXOR)
.SH C-BINDING SYNOPSIS
#include <ncarg/ncargC.h>
.sp
void c_labmod (char *fmtx, char *fmty, int numx, int numy, 
.br
int iszx, int iszy, int ixdc, int iydc, int ixor)
.SH DESCRIPTION 
.IP "FMTX and FMTY" 12
(input expressions of type CHARACTER) contain
format specifications for the X-axis and Y-axis numerical
labels produced by GRIDAL, GRIDL, HALFAX, or PERIML. The
specification must begin with a left parenthesis and end
with a right parenthesis and must not be more than ten
characters long. Conversions of types E, F, G, and I are
allowed; for example, one might use FMTX=\'(F8.2)\' and
FMTY=\'(E10.0)\'. The default for both formats is \'(E10.3)\'.
.sp
NOTE: I formats are allowed by this version of Gridall; they
were not allowed by previous versions.
.IP NUMX 12
(an input expression of type INTEGER), if non-zero,
is the number of characters in each X-axis numeric label;
if LBLX is a string produced by the format FMTX, then the
label will be the substring LBLX(1:NUMX). If NUMX is 0,
then the label will be the substring LBLX(m:n), where
LBLX(m:m) is the first non-blank character in LBLX, and
LBLX(n:n) is the last non-blank character following
LBLX(m:m). Using a non-zero NUMX causes the labels to be
centered differently than if a zero value is used. The
default value for NUMX is 0.
.IP NUMY 12
(an input expression of type INTEGER) is defined just
like NUMX, but applies to Y-axis numeric labels.
.IP "ISZX and ISZY" 12
(input expressions of type INTEGER) are
character sizes for the labels, specified in plotter
address units, just as for the SPPS routines PWRIT and
WTSTR. The default value for both is 10.
.IP "IXDC" 12
(an input expression of type INTEGER) is the
decrement, in plotter address units (PAUs - by default, the
plotter frame is 1023 PAUs in width and height), from the
left edge of the current viewport to the nearest X address
of the label specified by FMTY, NUMY, and ISZY. For
example, if the horizontal extent of the current viewport
is defined by the normalized device coordinates .1 and .9,
and if IXDC is 60, and if there has been no call to the
SPPS routine SETI (which can change the size of a PAU),
then labels on the Y axis will end at plotter coordinate 43
(.1*1023+1-60). Negative values may be used to put labels
on the other side of the viewport; in the example given,
changing IXDC to -878 (-\.8*1023 -60) would put the labels
on the right side of the viewport, with their left edges 60
plotter-coordinate units away from the edge of the
viewport. There are two special values of IXDC:
.RS
.IP \(bu
If IXDC=0, the Y-axis labels will end 20 plotter address
units to the left of the viewport (equivalent to using
IXDC=20).
.IP \(bu
If IXDC=1, Y-axis labels will begin 20 plotter address
units to the right of the viewport (equivalent to using
IXDC=-20-w, where w is the width of the viewport, in
plotter address units).
.RE
.IP ""
The default value of IXDC is 20.
.sp
When HALFAX is called or when GRIDAL is called with IGPH =
2, 6, or 10, IXDC is the distance from the Y axis, rather
than from the minimum viewport coordinate, and the special
values 0 and 1 are equivalent to 20 and -20.
.IP IYDC 12
(an input expression of type INTEGER) is the
decrement, in plotter address units (PAUs - by default, the
plotter frame is 1023 PAUs in width and height), from the
bottom edge of the current viewport to the nearest Y
address of the label specified by FMTX, NUMX, and ISZX.
Note that negative values may be used to put labels above
the viewport. There are two special values of IYDC:
.RS
.IP \(bu 
If IYDC=0, the top of the X-axis labels will be 20 plotter
address units below the bottom edge of the viewport
(equivalent to using IYDC=20).
.IP \(bu
If IYDC=1, the bottom of the X-axis labels will be 20
plotter address units above the top edge of the viewport
(equivalent to using IYDC=-20-h, where h is the height of
the viewport, in plotter address units).
.RE
.IP ""
The default value of IYDC is 20.
.sp
When HALFAX is called or when GRIDAL is called with IGPH =
8, 9, or 10, IYDC is the distance from the X axis, rather
than from the minimum viewport coordinate, and the special
values 0 and 1 are equivalent to 20 and -20.
.IP IXOR 12
(an input expression of type INTEGER) specifies the
orientation of the X-axis labels:
.RS
.IP \(bu
IXOR = 0 implies the use of horizontal labels.
.IP \(bu
IXOR = 1 implies the use of vertical labels.
.RE
.IP ""
The default orientation is horizontal.
.SH C-BINDING DESCRIPTION
The C-binding argument descriptions are the same as the FORTRAN 
argument descriptions.
.SH USAGE
This routine allows you to set the current value of
Gridall parameters.  For a complete list of parameters available
in this utility, see the gridall_params man page.
.SH EXAMPLES
Use the ncargex command to see the following relevant
examples: 
bnchmk,
tgrida,
ccpga,
ccpmpxy.
.SH ACCESS
To use LABMOD or c_labmod, load the NCAR Graphics libraries ncarg, ncarg_gks,
and ncarg_c, preferably in that order.  
.SH SEE ALSO
Online:
gridall,
gridall_params,
gacolr,
gagetc,
gageti,
gagetr,
gasetc,
gaseti,
gasetr,
grid,
gridal,
gridl,
halfax,
perim,
periml,
tick4,
ticks,
ncarg_cbind.
.sp
Hardcopy:
NCAR Graphics Contouring and Mapping Tutorial
.sp
Hardcopy:
NCAR Graphics Fundamentals, UNIX Version
.SH COPYRIGHT
Copyright (C) 1987-2000
.br
University Corporation for Atmospheric Research
.br

This documentation is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as published
by the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This software is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this software; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA.
