NAME

       PWRIT - draws a specified text string at a specified position in the user coordinate
       system.  The call has arguments specifying the size, orientation, and centering of the
       string.

STATUS

       PWRIT is an earlier version of the routine WTSTR in which the number of characters in the
       text string was specified in an argument.  Both WTSTR and PWRIT are now considered
       obsolete.

       PWRIT continues to be provided for compatibility of early NCAR Graphics codes.  If you are
       writing new code, we suggest that you use the more general text writing routines of the
       Plotchar utility:  PLCHLQ, PLCHMQ, and PLCHHQ.

SYNOPSIS

       CALL PWRIT (PX,PY,CH,NC,IS,IO,IC)

DESCRIPTION

       PX          (an input expression of type REAL) defines the X user coordinate where the
                   text string is to be drawn.

       PY          (an input expression of type REAL) defines the Y user coordinate where the
                   text string is to be drawn.

       CH          (an input constant or variable of type CHARACTER) is the text string to be
                   drawn.

       NC          (an input expression of type INTEGER) specifies the number of characters in
                   the 'CH' text string.

       IS          (an input expression of type INTEGER) specifies the character width in plotter
                   address units (PAUs).

       IO          (an input expression of type INTEGER) specifies the rotation angle of the text
                   string.  IO is measured in degrees counter-clockwise from a horizontal
                   orientation.

       IC          (an input expression of type INTEGER) specifies the centering option, as
                   follows:

                   <0  (PX,PY) will be in the vertical center of the left edge of the leftmost
                       character in the original horizontal string.

                   =0  (PX,PY) will be in the center of the text extent rectangle.

                   >0  (PX,PY) will be in the vertical center of the right edge of the rightmost
                       character in the original horizontal string.

       A call to PWRIT causes the SPPS polyline buffer to be flushed and leaves the "pen" (for
       subsequent calls to FRSTPT, VECTOR, PLOTIF, and PLOTIT) at the location (PX,PY).

ACCESS

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

SEE ALSO

       Online: gtx, gstxal, gstxp, gstxfp, gschh, gschsp, gschup, gschxp, gscr, gstxci, spps,
       plotchar, plchhq, plchmq, plchlq, wtstr, plotif, seti, getsi

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

COPYRIGHT

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