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

NAME

6       TDLBLA - This routine is called to put labels on a particular edge of a
7       box.
8

SYNOPSIS

10       CALL TDLBLA (IAXS, ILBL, NLBL, XAT0, XAT1, YAT0, YAT1, ANGD)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_tdlbla(int iaxs, char* ilbl, char* nlbl, float xat0, float xat1,
16       float yat0, float yat1, float angd)
17

DESCRIPTION

19       It is assumed that TDPARA has been called to define the reference
20       parallelogram to be a rectangle in 3-space lying in one corner of one
21       face of the box being labelled. The sides of this rectangle are assumed
22       to be vectors of length 1 (that is to say, the rectangle defines a unit
23       square within that face of the box). It is also assumed that the value
24       of the internal parameter 'CS2' has been set in the same way that
25       TDLBLS would reset it, using a code sequence like
26
27         CALL TDGETR ('CS1',CSM1)
28         CSM2=CSM1*MIN(UMAX-UMIN,VMAX-VMIN,WMAX-WMIN)
29         CALL TDSETR ('CS2',CSM2)
30
31       (where UMIN, UMAX, VMIN, VMAX, WMIN, and WMAX are as defined for a call
32       to TDLBLS).
33
34       The arguments of TDLBLA are as follows:
35
36       IAXS    (an input expression of type INTEGER) - says which edge of the
37               face is being labelled (1 => left, 2 => right, 3 => bottom, and
38               4 => top, where the meanings of "left", "right", "bottom", and
39               "top" are defined by the orientation of the reference
40               parallelogram).
41
42       ILBL    (input, of type CHARACTER) - a string to be used as an
43               informational label.  If the string is blank, no informational
44               label is written.
45
46       NLBL    (input, of type CHARACTER) - a string containing numeric
47               labels. The labels need not be in any particular order, but
48               they have to be separated by blanks and each has to be readable
49               using a FORTRAN format of the form "En.0", where "n" is the
50               length of the label. If the string is blank, no informational
51               label is written.
52
53       XAT0 and XAT1
54               (input expressions of type REAL) - the values of "X" associated
55               with the left and right edges of the face being labelled, where
56               "left" and "right" are defined in terms of the current
57               reference parallelogram.
58
59       YAT0 and YAT1
60               (input expressions of type REAL) - the values of "Y" associated
61               with the bottom and top edges of the face being labelled, where
62               "bottom" and "top" are defined in terms of the current
63               reference parallelogram.
64
65       ANGD    (an input expression of type REAL) - specifies the angle, in
66               degrees, at which the labels are to be written. This angle is
67               defined with reference to the current reference parallelogram.
68

C-BINDING DESCRIPTION

70       The C-binding argument descriptions are the same as the FORTRAN
71       argument descriptions.
72

ACCESS

74       To use TDLBLA or c_tdlbla, load the NCAR Graphics libraries ncarg,
75       ncarg_gks, and ncarg_c, preferably in that order.
76

SEE ALSO

78       Online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs,
79       tdinit, tditri, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack,
80       tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr,
81       tdsort, tdstri, tdstrs
82

84       Copyright (C) 1987-2009
85       University Corporation for Atmospheric Research
86       The use of this Software is governed by a License Agreement.
87
88
89
90UNIX                               July 1997                    TDLBLA(3NCARG)
Impressum