NAME

       PWRZS - A character-plotting routine for plotting characters in three-space when using SRFACE.

SYNOPSIS

       CALL PWRZS (X,Y,Z,ID,N,ISIZE,LINE,ITOP,ICNT)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_pwrzs (float x, float y, float z, char *id,
       int n, int isize, int line, int itop, int icnt)

DESCRIPTION

       X,Y,Z       Positioning  coordinates for the characters to be drawn.  These are floating point numbers in
                   the same three-space as used in SRFACE.

       ID          Character string to be drawn. ID is of type CHARACTER.

       N           The number of characters in ID.

       ISIZE       Size of the character:

                   • If between 0 and 3, ISIZE is 1., 1.5, 2., or 3. times a standard width equal to 1/128th  of
                     the screen width.

                   • If greater than 3, ISIZE is the character width in plotter address units.

       LINE        The direction in which the characters are to be written.

                        1 = +X -1 = -X
                        2 = +Y -2 = -Y
                        3 = +Z -3 = -Z

       ITOP        The  direction  from the center of the first character to the top of the first character (the
                   potential values for ITOP are the same as those for LINE as  given  above).  Note  that  LINE
                   cannot equal ITOP even in absolute value.

       ICNT        Centering option.

                   -1 (X,Y,Z)  is the center of the left edge of the first character.

                   0 (X,Y,Z)   is the center of the entire string.

                   1 (X,Y,Z)   is the center of the right edge of the last character.

                   Note  that  the  hidden  character  problem  is solved correctly for characters near, but not
                   inside, the three-space object.

C-BINDING DESCRIPTION

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

USAGE

       Call PWRZS after calling SRFACE and before calling FRAME.

EXAMPLES

       Use the ncargex command to see the following relevant examples: fsrpwrzs, tpwrzs.

ACCESS

       To use PWRZS or c_pwrzs, load the NCAR Graphics libraries ncarg, ncarg_gks, and  ncarg_c,  preferably  in
       that order.

SEE ALSO

       Online: surface, surface_params, ezsrfc, setr, srface.  ncarg_cbind.

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                      PWRZS(3NCARG)