NAME¶
TDLBLA - This routine is called to put labels on a particular edge of a box.
SYNOPSIS¶
CALL TDLBLA (IAXS, ILBL, NLBL, XAT0, XAT1, YAT0, YAT1, ANGD)
C-BINDING SYNOPSIS¶
#include <ncarg/ncargC.h>
void c_tdlbla(int iaxs, char* ilbl, char* nlbl, float xat0, float xat1, float
yat0, float yat1, float angd)
DESCRIPTION¶
It is assumed that TDPARA has been called to define the reference parallelogram
to be a rectangle in 3-space lying in one corner of one face of the box being
labelled. The sides of this rectangle are assumed to be vectors of length 1
(that is to say, the rectangle defines a unit square within that face of the
box). It is also assumed that the value of the internal parameter 'CS2' has
been set in the same way that TDLBLS would reset it, using a code sequence
like
CALL TDGETR ('CS1',CSM1)
CSM2=CSM1*MIN(UMAX-UMIN,VMAX-VMIN,WMAX-WMIN)
CALL TDSETR ('CS2',CSM2)
(where UMIN, UMAX, VMIN, VMAX, WMIN, and WMAX are as defined for a call to
TDLBLS).
The arguments of TDLBLA are as follows:
- IAXS
- (an input expression of type INTEGER) - says which edge of the face is
being labelled (1 => left, 2 => right, 3 => bottom, and 4 =>
top, where the meanings of "left", "right",
"bottom", and "top" are defined by the orientation of
the reference parallelogram).
- ILBL
- (input, of type CHARACTER) - a string to be used as an informational
label. If the string is blank, no informational label is written.
- NLBL
- (input, of type CHARACTER) - a string containing numeric labels. The
labels need not be in any particular order, but they have to be separated
by blanks and each has to be readable using a FORTRAN format of the form
"En.0", where "n" is the length of the label. If the
string is blank, no informational label is written.
- XAT0 and XAT1
- (input expressions of type REAL) - the values of "X" associated
with the left and right edges of the face being labelled, where
"left" and "right" are defined in terms of the current
reference parallelogram.
- YAT0 and YAT1
- (input expressions of type REAL) - the values of "Y" associated
with the bottom and top edges of the face being labelled, where
"bottom" and "top" are defined in terms of the current
reference parallelogram.
- ANGD
- (an input expression of type REAL) - specifies the angle, in degrees, at
which the labels are to be written. This angle is defined with reference
to the current reference parallelogram.
C-BINDING DESCRIPTION¶
The C-binding argument descriptions are the same as the FORTRAN argument
descriptions.
ACCESS¶
To use TDLBLA or c_tdlbla, load the NCAR Graphics libraries ncarg, ncarg_gks,
and ncarg_c, preferably in that order.
SEE ALSO¶
Online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs, tdinit,
tditri, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara,
tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort, tdstri, tdstrs
COPYRIGHT¶
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.