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-2007
75       University Corporation for Atmospheric Research
76
77       This documentation is free software; you can redistribute it and/or
78       modify it under the terms of the GNU General Public License as
79       published by the Free Software Foundation; either version 2 of the
80       License, or (at your option) any later version.
81
82       This software is distributed in the hope that it will be useful, but
83       WITHOUT ANY WARRANTY; without even the implied warranty of
84       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
85       General Public License for more details.
86
87       You should have received a copy of the GNU General Public License along
88       with this software; if not, write to the Free Software Foundation,
89       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
90
91
92
93UNIX                              March 1993                     PWRIT(3NCARG)
Impressum