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

NAME

6       WTSTR - 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       WTSTR specifies character sizes in Plotter Address Units (PAUs), which
12       are no longer used in NCAR Graphics; thus, WTSTR is considered an
13       obsolete routine.
14
15       The current recognized coordinate systems are GKS world coordinates,
16       GKS normalized device coordinates, NCAR Graphics fractional
17       coordinates, and NCAR Graphics user coordinates.  See the NCAR Graphics
18       document "NCAR Graphics Fundamentals, UNIX Version" for a description
19       of these coordinate systems.
20
21       WTSTR continues to be provided for compatibility of early NCAR Graphics
22       codes.  If you are writing new code, we suggest that you use the more
23       general text writing routines of the Plotchar utility:  PLCHLQ, PLCHMQ,
24       and PLCHHQ.
25
26       The following definition of the PAU Coordinate System is included for
27       the purpose of interpreting and converting PAU codes:
28
29       The plotter coordinates of a point are integers IPX and IPY, where IPX
30       is between 1 and 2**MX and IPY is between 1 and 2**MY.  MX and MY are
31       internal parameters of SPPS; each has the default value 10.  Values of
32       MX and MY can be set by the routine SETI and retrieved by the routine
33       GETSI.
34

SYNOPSIS

36       CALL WTSTR(PX,PY,CH,IS,IO,IC)
37

DESCRIPTION

39       PX          (an input expression of type REAL) defines the X user
40                   coordinate where the text string is to be drawn.
41
42       PY          (an input expression of type REAL) defines the Y user
43                   coordinate where the text string is to be drawn.
44
45       CH          (an input constant or variable of type CHARACTER) is the
46                   text string to be drawn.
47
48       IS          (an input expression of type INTEGER) specifies the
49                   character width in plotter address units (PAUs).
50
51       IO          (an input expression of type INTEGER) specifies the
52                   rotation angle of the text string.  IO is measured in
53                   degrees counter-clockwise from a horizontal orientation.
54
55       IC          (an input expression of type INTEGER) specifies the
56                   centering option, as follows:
57
58                   <0  (PX,PY) will be in the vertical center of the left edge
59                       of the leftmost character in the original horizontal
60                       string.
61
62                   =0  (PX,PY) will be in the center of the text extent
63                       rectangle.
64
65                   >0  (PX,PY) will be in the vertical center of the right
66                       edge of the rightmost character in the original
67                       horizontal string.
68
69       A call to WTSTR causes the SPPS polyline buffer to be flushed and
70       leaves the "pen" (for subsequent calls to FRSTPT, VECTOR, PLOTIF, and
71       PLOTIT) at the location (PX,PY).
72

ACCESS

74       To use WTSTR, load the NCAR Graphics libraries ncarg, ncarg_gks, and
75       ncarg_c, preferably in that order.
76

SEE ALSO

78       Online: gtx, gstxal, gstxp, gstxfp, gschh, gschsp, gschup, gschxp,
79       gscr, gstxci, spps, plotchar, plchhq, plchmq, plchlq, pwrit, plotif,
80       seti, getsi
81
82       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
83       NCAR GKS-0A Graphics
84

86       Copyright (C) 1987-2007
87       University Corporation for Atmospheric Research
88
89       This documentation is free software; you can redistribute it and/or
90       modify it under the terms of the GNU General Public License as
91       published by the Free Software Foundation; either version 2 of the
92       License, or (at your option) any later version.
93
94       This software is distributed in the hope that it will be useful, but
95       WITHOUT ANY WARRANTY; without even the implied warranty of
96       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
97       General Public License for more details.
98
99       You should have received a copy of the GNU General Public License along
100       with this software; if not, write to the Free Software Foundation,
101       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
102
103
104
105UNIX                              March 1993                     WTSTR(3NCARG)
Impressum