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

NAME

6       PWRITY - draws text and other characters using polylines.
7

UTILITY

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

STATUS

13       PWRITY is obsolete.  It has been replaced by the PLCHHQ, PLCHMQ, and
14       PLCHLQ entries of the Plotchar utility.
15
16       PWRITY 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

SYNOPSIS

21       CALL PWRITY (X,Y,IDPC,NCHAR,JSIZE,JOR,JCTR)
22

DESCRIPTION

24       X           (an input parameter of type REAL) defining the X world
25                   coordinate of the text string to be drawn using polylines.
26
27       Y           (an input parameter of type REAL) defining the Y world
28                   coordinate of the text string to be drawn using polylines.
29
30       IDPC        (an input string of type CHARACTER) which are the
31                   characters to be drawn.
32
33       NCHAR       (an input parameter of type INTEGER) giving the number of
34                   characters in the IDPC string.
35
36       JSIZE       (an input parameter of type INTEGER) giving the width of
37                   the characters to be drawn.
38
39                   0  -   8./1023. NDCs
40                   1  -  12./1023. NDCs
41                   2  -  16./1023. NDCs
42                   3  -  24./1023. NDCs
43
44                   If greater than 3:
45
46                   FLOAT(JSIZE)/1023. NDCs
47
48                   One can relate these sizes to a viewport in normalized
49                   device coordinates (each axis runs 0. to 1.) by dividing by
50                   1023.  That is a character of width .05 would take up 5% of
51                   the possible picture width meaning that less than 20
52                   characters could fit on a line.
53
54                   Note that there is an important difference in how text
55                   sizes are handled in GKS versus PWRITY.  In GKS, text size
56                   is given in terms of character heights.  In PWRITY, text
57                   size (JSIZE) is given in character width.
58
59       JOR         (an input parameter of type INTEGER) giving the orientation
60                   at which the IDPC string is to be drawn.  JOR is measured
61                   counter-clockwise from the positive X axis.
62
63       JCTR        (an input parameter of type INTEGER) giving the centering
64                   option for the IDPC character string.
65
66                       0, (X,Y) is the center of the entire IDPC string.
67                      -1, (X,Y) is the center of the left edge of the
68                                first character.
69                       1  (X,Y) is the center of the right edge of the
70                                last character.
71

ACCESS

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

SEE ALSO

77       Online: pwrite_family, pwritx, plotchar, plchhq, plchmq, plchlq
78
79       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
80       NCAR GKS-0A Graphics
81

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