1PCLOQU(3NCARG) NCAR GRAPHICS PCLOQU(3NCARG)
2
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 PLCHLQ is an alternate name for the routine PCLOQU.
13
15 CALL PCLOQU (XPOS,YPOS,CHRS,SIZE,ANGD,CNTR)
16
18 #include <ncarg/ncargC.h>
19 void c_pcloqu (float xpos, float ypos, char *chrs,
21 float size, float angd, float cntr)
22
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 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 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 · 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 · 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 · 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 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 Note that SIZE is defined in such a way as to be consistent
77 with PCHIQU.
78 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 CNTR (an input expression of type REAL) is the centering option,
84 as follows:
85 · CNTR < 0. means that (XPOS,YPOS) is the center of
87 the left edge of the first character.
88 · CNTR > 0. means that (XPOS,YPOS) is the center of
90 the right edge of the last character.
91 · CNTR = 0. means that (XPOS,YPOS) is the midpoint of
93 the string.
94 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 Upon return from PCLOQU, all arguments are unchanged.
100
102 The C-binding argument descriptions are the same as the FORTRAN
103 argument descriptions.
104
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
112 To use PCLOQU or c_pcloqu, load the NCAR Graphics libraries ncarg,
113 ncarg_gks, and ncarg_c, preferably in that order.
114
116 Online: plotchar, pcdlsc, pcgetc, pcgeti, pcgetr, pchiqu, pcmequ,
117 pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr, ncarg_cbind.
118 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
120
122 Copyright (C) 1987-2007
123 University Corporation for Atmospheric Research
124 This documentation is free software; you can redistribute it and/or
126 modify it under the terms of the GNU General Public License as
127 published by the Free Software Foundation; either version 2 of the
128 License, or (at your option) any later version.
129 This software is distributed in the hope that it will be useful, but
131 WITHOUT ANY WARRANTY; without even the implied warranty of
132 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
133 General Public License for more details.
134 You should have received a copy of the GNU General Public License along
136 with this software; if not, write to the Free Software Foundation,
137 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
138UNIX March 1993 PCLOQU(3NCARG)