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

NAME

6       PCMEQU - Draws characters of "medium quality". It does this by drawing
7       lines, just as PCHIQU does, but it does not produce quite such fancy
8       characters. No function codes may be used. Using PCMEQU to draw a given
9       string of characters will create a larger metafile than if PCLOQU were
10       used, which may be a disadvantage. However, it may also be more
11       dependable, in that it does not depend on capabilities the translator
12       may or may not have.
13
14       PLCHMQ is an alternate name for the routine PCMEQU.
15

SYNOPSIS

17       CALL PCMEQU (XPOS,YPOS,CHRS,SIZE,ANGD,CNTR)
18

C-BINDING SYNOPSIS

20       #include <ncarg/ncargC.h>
21
22       void c_pcmequ (float xpos, float ypos, char *chrs,
23       float size, float angd, float cntr)
24

DESCRIPTION

26       XPOS,YPOS   (input expressions of type REAL) specify positioning
27                   coordinates for the characters to be drawn. If the internal
28                   parameter ´MA´ has the value 0, these are given in the
29                   current user coordinate system; otherwise, they are given
30                   in an arbitrary X/Y coordinate system, as implied by the
31                   value of ´MA´ and the nature of the routine CPMPXY. (For
32                   example, if ´MA´ has the value 1 and the default version of
33                   CPMPXY is being used, then XPOS is a longitude, in degrees,
34                   and YPOS is a latitude, in degrees.)  The argument CNTR
35                   (described below) specifies how the characters are to be
36                   positioned relative to the point (XPOS,YPOS).
37
38       CHRS        (an input constant or variable of type CHARACTER) contains
39                   a character string to be drawn. The number of characters in
40                   CHRS is taken to be LEN(CHRS); to use characters "m"
41                   through "n" from a character variable CHRS, use the
42                   FORTRAN-77 substring notation "CHRS(m:n)". The string may
43                   include any of the 95 characters space, exclamation point,
44                   double quote, pound sign, dollar sign, percent sign,
45                   ampersand, apostrophe, left parenthesis, right parenthesis,
46                   asterisk, plus sign, comma, minus sign, period, slash, 0-9,
47                   colon, semi-colon, less than sign, equals sign, greater
48                   than sign, question mark, at sign, A-Z, left square
49                   bracket, backslash, right square bracket, hat, underscore,
50                   backwards quote, a-z, left curly bracket, vertical bar,
51                   right curly bracket, and tilde. Function codes, like those
52                   in calls to PCHIQU, may not be used.
53
54       SIZE        (an input expression of type REAL) specifies the desired
55                   character size. If the internal parameter ´MA´ is zero,
56                   then the following comments apply:
57
58                   ·      If SIZE is less than or equal to zero, its absolute
59                          value specifies the size as a multiple of a default
60                          digitized size on a 1024x1024 grid, on which blanks
61                          are 16 units wide.
62
63                   ·      If SIZE is greater than zero, but less than one, it
64                          specifies the desired width of a blank as a fraction
65                          of the distance across the plotter frame. This is
66                          the recommended scheme.
67
68                   ·      If SIZE is greater than or equal to one, it
69                          specifies the desired width of a blank in plotter
70                          coordinates, as defined by default or by a user´s
71                          call to the SPPS routine SETI.  Note that use of the
72                          routine SETI is now discouraged.
73
74                   If ´MA´ is nonzero, then SIZE is the desired width of a
75                   blank as a value in the X/Y coordinate system in which XPOS
76                   and YPOS are given.
77
78                   Capital letters are 4/6 as wide as a blank and, by default,
79                   7/4 as high as they are wide (the internal parameter ´HW´
80                   may be used to change the latter value). The distance from
81                   the center of each character to the center of the next is
82                   constant and is equal to one blank width.
83
84                   Note that, if the desired character height ("h") is known,
85                   one should use SIZE = (6/7) * h.
86
87                   SIZE is defined in such a way as to be consistent with
88                   PCHIQU. If one changes a "CALL PCHIQU" to a "CALL PCMEQU"
89                   (assuming that no function codes are used in the string, of
90                   course), the results will be much the same, but the length
91                   of the string will be different. If one uses SIZE less than
92                   zero and one has reset the PCHIQU internal parameter ´PW´
93                   to something other than 16, the difference in the output of
94                   the two routines will be greater.
95
96       ANGD        (an input expression of type REAL) is the angle, in degrees
97                   counterclockwise from the positive X axis, at which the
98                   character string is to be written.
99
100       CNTR        (an input expression of type REAL) is the centering option,
101                   as follows:
102
103                   ·      CNTR = -1. means that (XPOS,YPOS) is the center of
104                          the left edge of the first character.
105
106                   ·      CNTR = 1. means that (XPOS,YPOS) is the center of
107                          the right edge of the last character.
108
109                   ·      CNTR = s means that (XPOS,YPOS) is a point obtained
110                          by linear interpolation along the line joining the
111                          two points mentioned above (the first point being
112                          associated with the value -1 and the second with the
113                          value +1). The value "0."  gives the midpoint of the
114                          line.
115
116                   Upon return from PCMEQU, all arguments are unchanged.
117

C-BINDING DESCRIPTION

119       The C-binding argument descriptions are the same as the FORTRAN
120       argument descriptions.
121

EXAMPLES

123       Use the ncargex command to see the following relevant examples: cbex01,
124       epltch, spset1, spset2, tpltch.
125

ACCESS

127       To use PCMEQU or c_pcmequ, load the NCAR Graphics libraries ncarg,
128       ncarg_gks, and ncarg_c, preferably in that order.
129

SEE ALSO

131       Online: plotchar, pcdlsc, pcgetc, pcgeti, pcgetr, pchiqu, pcloqu,
132       pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr, ncarg_cbind.
133
134       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
135
137       Copyright (C) 1987-2009
138       University Corporation for Atmospheric Research
139       The use of this Software is governed by a License Agreement.
140
141
142
143UNIX                              March 1993                    PCMEQU(3NCARG)
Impressum