ncl_pwritx(3)

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

NAME

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

SYNOPSIS

21       CALL PWRITX (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.  There may also be embedded
32                   function codes describing how certain characters are to be
33                   drawn.
34
35       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
39       JSIZE       (an input parameter of type INTEGER) giving the width of
40                   the characters to be drawn.
41
42                           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
48                           If greater than 3:
49
50                           Principal characters =          JSIZE
51                           Indexical characters =  (13/21)*JSIZE
52                        Cartographic characters =  ( 9/21)*JSIZE
53
54                   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
60                   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
65       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
69       JCTR        (an input parameter of type INTEGER) giving the centering
70                   option for the IDPC character string.
71
72                       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

ACCESS

79       To use PWRITX, load the NCAR Graphics libraries ncarg, ncarg_gks,
80       ncarg_c, and ncarg_c, preferably in that order.
81

COPYRIGHT

89       Copyright (C) 1987-2009
90       University Corporation for Atmospheric Research
91       The use of this Software is governed by a License Agreement.
92
93
94
95UNIX                              March 1993                    PWRITX(3NCARG)