1PWRITX(3NCARG) NCAR GRAPHICS PWRITX(3NCARG)
2
6 PWRITX - draws text and other characters using polylines.
7
9 This routine is part of the Pwrite_family utility in NCAR Graphics. To
10 see the overview man page for this utility, type "man pwrite_family".
11
13 PWRITX is obsolete. It has been replaced by the PLCHHQ, PLCHMQ, and
14 PLCHLQ entries of the Plotchar utility.
15 PWRITX continues to be provided for compatibility of early NCAR
17 Graphics codes. If you are writing new code, we suggest that you use
18 Plotchar.
19
21 CALL PWRITX (X,Y,IDPC,NCHAR,JSIZE,JOR,JCTR)
22
24 X (an input parameter of type REAL) defining the X world
25 coordinate of the text string to be drawn using polylines.
26 Y (an input parameter of type REAL) defining the Y world
28 coordinate of the text string to be drawn using polylines.
29 IDPC (an input string of type CHARACTER) which are the
31 characters to be drawn. There may also be embedded
32 function codes describing how certain characters are to be
33 drawn.
34 NCHAR (an input parameter of type INTEGER) giving the number of
36 characters in the IDPC string. NCHAR includes a count of
37 all characters in the string including the function codes.
38 JSIZE (an input parameter of type INTEGER) giving the width of
40 the characters to be drawn.
41 0 - 1.0 * the size of the digitized
43 characters in the database
44 1 - 1.5 * digitized size
45 2 - 2.0 * digitized size
46 3 - 3.0 * digitized size
47 If greater than 3:
49 Principal characters = JSIZE
51 Indexical characters = (13/21)*JSIZE
52 Cartographic characters = ( 9/21)*JSIZE
53 One can relate these sizes to a viewport in normalized
55 device coordinates (each axis runs 0. to 1.) by dividing by
56 1023. That is a character of width .05 would take up 5% of
57 the possible picture width meaning that less than 20
58 characters could fit on a line.
59 Note that there is an important difference in how text
61 sizes are handled in GKS versus PWRITX. In GKS, text size
62 is given in terms of character heights. In PWRITX, text
63 size (JSIZE) is given in character width.
64 JOR (an input parameter of type INTEGER) giving the orientation
66 at which the IDPC string is to be drawn. JOR is measured
67 counter-clockwise from the positive X axis.
68 JCTR (an input parameter of type INTEGER) giving the centering
70 option for the IDPC character string.
71 0, (X,Y) is the center of the entire IDPC string.
73 -1, (X,Y) is the center of the left edge of the
74 first character.
75 1 (X,Y) is the center of the right edge of the
76 last character.
77
79 To use PWRITX, load the NCAR Graphics libraries ncarg, ncarg_gks,
80 ncarg_c, and ncarg_c, preferably in that order.
81
83 Online: pwrite_family, pwrity, plotchar, plchhq, plchmq, plchlq
84 Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
86 NCAR GKS-0A Graphics
87
89 Copyright (C) 1987-2007
90 University Corporation for Atmospheric Research
91 This documentation is free software; you can redistribute it and/or
93 modify it under the terms of the GNU General Public License as
94 published by the Free Software Foundation; either version 2 of the
95 License, or (at your option) any later version.
96 This software is distributed in the hope that it will be useful, but
98 WITHOUT ANY WARRANTY; without even the implied warranty of
99 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
100 General Public License for more details.
101 You should have received a copy of the GNU General Public License along
103 with this software; if not, write to the Free Software Foundation,
104 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
105UNIX March 1993 PWRITX(3NCARG)