NAME

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

SYNOPSIS

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

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_tdplch(float xpos, float ypos, char *chrs, float size, float angd, float cntr)

DESCRIPTION

       The arguments of TDPLCH are as follows:

       XPOS and YPOS
               (input expressions of type REAL) - the parallelogram coordinates of a point relative to which the
               character string is to be positioned.

       CHRS    (input, of type CHARACTER) - a string suitable for input to the PLOTCHAR routine PLCHHQ.

       SIZE    (an input expression of type REAL) - specifies the width of the characters to be used as a
               multiple of the "X" dimension of the reference parallelogram. If the reference parallelogram is
               not a square, distortion of the characters is to be expected: for example, if the reference
               parallelogram is twice as wide as it is high, then the same will be true of characters drawn by
               TDPLCH.

       ANGD    (an input expression of type REAL) - specifies the angle, in degrees, at which the character
               string is to be drawn relative to the reference parallelogram (0 => in the direction of positive
               X, 90 => in the direction of positive Y, 180 => in the direction of negative X, and so on).

       CNTR    (an input expression of type REAL) - specifies how the character string is to be centered
               relative to the point (XPOS,YPOS) within the reference parallelogram.  If CNTR = -1, the leading
               edge of the character string will be placed at (XPOS,YPOS); if CNTR = 0, the center of the
               character string will be placed at (XPOS,YPOS); and if CNTR = +1, the trailing edge of the
               character string will be placed at (XPOS,YPOS).  Other values may be used, with the logical
               results; for example, if CNTR = -.5, the point halfway between the leading edge and the center of
               the character string will be placed at (XPOS,YPOS).

C-BINDING DESCRIPTION

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

ACCESS

       To use TDPLCH or c_tdplch, 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, tdlbla, tdlbls,
       tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara, 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.