ncl_tdplch man page

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

Info

July 1997 UNIX NCAR GRAPHICS