1PWRIT(3NCARG)                    NCAR GRAPHICS                   PWRIT(3NCARG)
2
3
4

NAME

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

STATUS

11       PWRIT is an earlier version of the routine WTSTR in which the number of
12       characters in the text string was specified in an argument.  Both WTSTR
13       and PWRIT are now considered obsolete.
14
15       PWRIT continues to be provided for compatibility of early NCAR Graphics
16       codes.  If you are writing new code, we suggest that you use the more
17       general text writing routines of the Plotchar utility:  PLCHLQ, PLCHMQ,
18       and PLCHHQ.
19

SYNOPSIS

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

DESCRIPTION

24       PX          (an input expression of type REAL) defines the X user
25                   coordinate where the text string is to be drawn.
26
27       PY          (an input expression of type REAL) defines the Y user
28                   coordinate where the text string is to be drawn.
29
30       CH          (an input constant or variable of type CHARACTER) is the
31                   text string to be drawn.
32
33       NC          (an input expression of type INTEGER) specifies the number
34                   of characters in the 'CH' text string.
35
36       IS          (an input expression of type INTEGER) specifies the
37                   character width in plotter address units (PAUs).
38
39       IO          (an input expression of type INTEGER) specifies the
40                   rotation angle of the text string.  IO is measured in
41                   degrees counter-clockwise from a horizontal orientation.
42
43       IC          (an input expression of type INTEGER) specifies the
44                   centering option, as follows:
45
46                   <0  (PX,PY) will be in the vertical center of the left edge
47                       of the leftmost character in the original horizontal
48                       string.
49
50                   =0  (PX,PY) will be in the center of the text extent
51                       rectangle.
52
53                   >0  (PX,PY) will be in the vertical center of the right
54                       edge of the rightmost character in the original
55                       horizontal string.
56
57       A call to PWRIT causes the SPPS polyline buffer to be flushed and
58       leaves the "pen" (for subsequent calls to FRSTPT, VECTOR, PLOTIF, and
59       PLOTIT) at the location (PX,PY).
60

ACCESS

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

SEE ALSO

66       Online: gtx, gstxal, gstxp, gstxfp, gschh, gschsp, gschup, gschxp,
67       gscr, gstxci, spps, plotchar, plchhq, plchmq, plchlq, wtstr, plotif,
68       seti, getsi
69
70       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
71       NCAR GKS-0A Graphics
72
74       Copyright (C) 1987-2009
75       University Corporation for Atmospheric Research
76       The use of this Software is governed by a License Agreement.
77
78
79
80UNIX                              March 1993                     PWRIT(3NCARG)
Impressum