1TDLBLA(3NCARG) NCAR GRAPHICS TDLBLA(3NCARG)
2
6 TDLBLA - This routine is called to put labels on a particular edge of a
7 box.
8
10 CALL TDLBLA (IAXS, ILBL, NLBL, XAT0, XAT1, YAT0, YAT1, ANGD)
11
13 #include <ncarg/ncargC.h>
14 void c_tdlbla(int iaxs, char* ilbl, char* nlbl, float xat0, float xat1,
16 float yat0, float yat1, float angd)
17
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 CALL TDGETR ('CS1',CSM1)
28 CSM2=CSM1*MIN(UMAX-UMIN,VMAX-VMIN,WMAX-WMIN)
29 CALL TDSETR ('CS2',CSM2)
30 (where UMIN, UMAX, VMIN, VMAX, WMIN, and WMAX are as defined for a call
32 to TDLBLS).
33 The arguments of TDLBLA are as follows:
35 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 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 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 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 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 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
70 The C-binding argument descriptions are the same as the FORTRAN
71 argument descriptions.
72
74 To use TDLBLA or c_tdlbla, load the NCAR Graphics libraries ncarg,
75 ncarg_gks, and ncarg_c, preferably in that order.
76
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-2007
85 University Corporation for Atmospheric Research
86 This documentation is free software; you can redistribute it and/or
88 modify it under the terms of the GNU General Public License as
89 published by the Free Software Foundation; either version 2 of the
90 License, or (at your option) any later version.
91 This software is distributed in the hope that it will be useful, but
93 WITHOUT ANY WARRANTY; without even the implied warranty of
94 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
95 General Public License for more details.
96 You should have received a copy of the GNU General Public License along
98 with this software; if not, write to the Free Software Foundation,
99 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
100UNIX July 1997 TDLBLA(3NCARG)