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.

UNIX                                                July 1997                                     TDPLCH(3NCARG)