1TDPLCH(3NCARG) NCAR GRAPHICS TDPLCH(3NCARG)
2
3
4
6 TDPLCH - Draw a character string at a specified position in the plane
7 of the reference parallelogram.
8
10 CALL TDPLCH (XPOS, YPOS, CHRS, SIZE, ANGD, CNTR)
11
13 #include <ncarg/ncargC.h>
14
15 void c_tdplch(float xpos, float ypos, char *chrs, float size, float
16 angd, float cntr)
17
19 The arguments of TDPLCH are as follows:
20
21 XPOS and YPOS
22 (input expressions of type REAL) - the parallelogram
23 coordinates of a point relative to which the character string
24 is to be positioned.
25
26 CHRS (input, of type CHARACTER) - a string suitable for input to the
27 PLOTCHAR routine PLCHHQ.
28
29 SIZE (an input expression of type REAL) - specifies the width of the
30 characters to be used as a multiple of the "X" dimension of the
31 reference parallelogram. If the reference parallelogram is not
32 a square, distortion of the characters is to be expected: for
33 example, if the reference parallelogram is twice as wide as it
34 is high, then the same will be true of characters drawn by
35 TDPLCH.
36
37 ANGD (an input expression of type REAL) - specifies the angle, in
38 degrees, at which the character string is to be drawn relative
39 to the reference parallelogram (0 => in the direction of
40 positive X, 90 => in the direction of positive Y, 180 => in the
41 direction of negative X, and so on).
42
43 CNTR (an input expression of type REAL) - specifies how the
44 character string is to be centered relative to the point
45 (XPOS,YPOS) within the reference parallelogram. If CNTR = -1,
46 the leading edge of the character string will be placed at
47 (XPOS,YPOS); if CNTR = 0, the center of the character string
48 will be placed at (XPOS,YPOS); and if CNTR = +1, the trailing
49 edge of the character string will be placed at (XPOS,YPOS).
50 Other values may be used, with the logical results; for
51 example, if CNTR = -.5, the point halfway between the leading
52 edge and the center of the character string will be placed at
53 (XPOS,YPOS).
54
56 The C-binding argument descriptions are the same as the FORTRAN
57 argument descriptions.
58
60 To use TDPLCH or c_tdplch, load the NCAR Graphics libraries ncarg,
61 ncarg_gks, and ncarg_c, preferably in that order.
62
64 Online: tdclrs, tdctri, tddtri, tdgeti, tdgetr, tdgrds, tdgrid, tdgtrs,
65 tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack,
66 tdpack_params, tdpara, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort,
67 tdstri, tdstrs
68
70 Copyright (C) 1987-2009
71 University Corporation for Atmospheric Research
72 The use of this Software is governed by a License Agreement.
73
74
75
76UNIX July 1997 TDPLCH(3NCARG)