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

NAME

6       PCLOQU - Draws characters of "low quality" by calling the GKS
7       character-drawing routines. No function codes may be used.  Using
8       PCLOQU to draw a given string of characters will create a smaller
9       metafile than if PCHIQU or PCMEQU were used; the results will depend on
10       capabilities of the translator.
11
12       PLCHLQ is an alternate name for the routine PCLOQU.
13

SYNOPSIS

15       CALL PCLOQU (XPOS,YPOS,CHRS,SIZE,ANGD,CNTR)
16

C-BINDING SYNOPSIS

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

DESCRIPTION

24       XPOS,YPOS   (input expressions of type REAL) specify positioning
25                   coordinates for the characters to be drawn. If the internal
26                   parameter ´MA´ has the value 0, these are given in the
27                   current user coordinate system; otherwise, they are given
28                   in an arbitrary X/Y coordinate system, as implied by the
29                   value of ´MA´ and the nature of the routine CPMPXY. (For
30                   example, if ´MA´ has the value 1 and the default version of
31                   CPMPXY is being used, then XPOS is a longitude, in degrees,
32                   and YPOS is a latitude, in degrees.)  The argument CNTR
33                   (described below) specifies how the characters are to be
34                   positioned relative to the point (XPOS,YPOS).
35
36       CHRS        (an input constant or variable of type CHARACTER) contains
37                   a character string to be drawn. The number of characters in
38                   CHRS is taken to be LEN(CHRS); to use characters "m"
39                   through "n" from a character variable CHRS, use the
40                   FORTRAN-77 substring notation "CHRS(m:n)". The string may
41                   include any of the 95 characters space, exclamation point,
42                   double quote, pound sign, dollar sign, percent sign,
43                   ampersand, apostrophe, left parenthesis, right parenthesis,
44                   asterisk, plus sign, comma, minus sign, period, slash, 0-9,
45                   colon, semi-colon, less than sign, equals sign, greater
46                   than sign, question mark, at sign, A-Z, left square
47                   bracket, backslash, right square bracket, hat, underscore,
48                   backwards quote, a-z, left curly bracket, vertical bar,
49                   right curly bracket, and tilde. Function codes, like those
50                   in calls to PCHIQU, may not be used.
51
52       SIZE        (an input expression of type REAL) specifies the desired
53                   character size. If the internal parameter ´MA´ is zero,
54                   then the following comments apply:
55
56                   ·      If SIZE is less than or equal to zero, its absolute
57                          value specifies the size as a multiple of a default
58                          digitized size on a 1024x1024 grid, on which blanks
59                          are 16 units wide.
60
61                   ·      If SIZE is greater than zero, but less than one, it
62                          specifies the desired width of a blank as a fraction
63                          of the distance across the plotter frame. This is
64                          the recommended scheme.
65
66                   ·      If SIZE is greater than or equal to one, it
67                          specifies the desired width of a blank in plotter
68                          coordinates, as defined by default or by a user´s
69                          call to the SPPS routine SETI.  Note that use of the
70                          routine SETI is now discouraged.
71
72                   If ´MA´ is nonzero, then SIZE is the desired width of a
73                   blank as a value in the X/Y coordinate system in which XPOS
74                   and YPOS are given.
75
76                   Note that SIZE is defined in such a way as to be consistent
77                   with PCHIQU.
78
79       ANGD        (an input expression of type REAL) is the angle, in degrees
80                   counterclockwise from the positive X axis, at which the
81                   character string is to be written.
82
83       CNTR        (an input expression of type REAL) is the centering option,
84                   as follows:
85
86                   ·      CNTR < 0. means that (XPOS,YPOS) is the center of
87                          the left edge of the first character.
88
89                   ·      CNTR > 0. means that (XPOS,YPOS) is the center of
90                          the right edge of the last character.
91
92                   ·      CNTR = 0. means that (XPOS,YPOS) is the midpoint of
93                          the string.
94
95                   Note that this argument is not quite the same as that for
96                   PCHIQU (though it does include the three most useful
97                   cases).
98
99                   Upon return from PCLOQU, all arguments are unchanged.
100

C-BINDING DESCRIPTION

102       The C-binding argument descriptions are the same as the FORTRAN
103       argument descriptions.
104

EXAMPLES

106       Use the ncargex command to see the following relevant examples: arex01,
107       tcnqck, tcnsmt, tcnsup, tconre, tezmap, tgflas, tgrida, thafto, thstgr,
108       tisohr, tisosr, tlblba, tpltch, tpwrzi, tpwrzs, tsoftf, tstrml, tthree,
109       tvelvc.
110

ACCESS

112       To use PCLOQU or c_pcloqu, load the NCAR Graphics libraries ncarg,
113       ncarg_gks, and ncarg_c, preferably in that order.
114

SEE ALSO

116       Online: plotchar, pcdlsc, pcgetc, pcgeti, pcgetr, pchiqu, pcmequ,
117       pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr, ncarg_cbind.
118
119       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
120
122       Copyright (C) 1987-2009
123       University Corporation for Atmospheric Research
124       The use of this Software is governed by a License Agreement.
125
126
127
128UNIX                              March 1993                    PCLOQU(3NCARG)
Impressum