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

NAME

6       TDPLCH - Draw a character string at a specified position in the plane
7       of the reference parallelogram.
8

SYNOPSIS

10       CALL TDPLCH (XPOS, YPOS, CHRS, SIZE, ANGD, CNTR)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_tdplch(float xpos, float ypos, char *chrs, float size, float
16       angd, float cntr)
17

DESCRIPTION

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

C-BINDING DESCRIPTION

56       The C-binding argument descriptions are the same as the FORTRAN
57       argument descriptions.
58

ACCESS

60       To use TDPLCH or c_tdplch, load the NCAR Graphics libraries ncarg,
61       ncarg_gks, and ncarg_c, preferably in that order.
62

SEE ALSO

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-2007
71       University Corporation for Atmospheric Research
72
73       This documentation is free software; you can redistribute it and/or
74       modify it under the terms of the GNU General Public License as
75       published by the Free Software Foundation; either version 2 of the
76       License, or (at your option) any later version.
77
78       This software is distributed in the hope that it will be useful, but
79       WITHOUT ANY WARRANTY; without even the implied warranty of
80       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
81       General Public License for more details.
82
83       You should have received a copy of the GNU General Public License along
84       with this software; if not, write to the Free Software Foundation,
85       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
86
87
88
89UNIX                               July 1997                    TDPLCH(3NCARG)
Impressum