1Plotchar(3NCARG) NCAR GRAPHICS Plotchar(3NCARG)
2
6 Plotchar - Allows a user to draw characters of high, medium, or low
7 quality.
8
10 PCHIQU (or PLCHHQ) - Draws high quality characters. By default, it uses
11 the same database as the old NCAR Graphics routine PWRITX, but it can
12 also use characters from any of the fontcap-defined databases, it has
13 an improved interface, and it has many more capabilities than PWRITX.
14 PCMEQU (or PLCHMQ) - Draws characters of "medium quality". It does this
16 by drawing lines, just as PCHIQU does, but it does not produce quite
17 such fancy characters. No function codes may be used. Using PCMEQU to
18 draw a given string of characters will create a larger metafile than if
19 PCLOQU were used, which may be a disadvantage. However, it may also be
20 more dependable, in that it does not depend on capabilities the
21 translator may or may not have.
22 PCLOQU (or PLCHLQ) - Draws characters of "low quality" by calling the
24 GKS character-drawing routines. No function codes may be used. Using
25 PCLOQU to draw a given string of characters will create a smaller
26 metafile than if PCHIQU or PCMEQU were used; the results will depend on
27 capabilities of the translator.
28 PCGETC - Retrieves the character value of a specified internal
30 parameter.
31 PCGETI - Retrieves the integer value of a specified internal parameter.
33 PCGETR - Retrieves the real value of a specified internal parameter.
35 PCRSET - Resets the values of all internal parameters to the default
36 state.
37 PCSETC - Gives a new character value to a specified internal parameter.
39 PCSETI - Gives a new integer value to a specified internal parameter.
41 PCSETR - Gives a new real value to a specified internal parameter.
43 PCPNWI - A function of type CHARACTER*16 that, given the name of an
45 internal parameter array and an index, has as its value the name of the
46 specified element of the internal parameter array.
47 PCDLSC - Defines the default list of "special colors" used by PCHIQU in
49 drawing certain characters from the filled fonts. Such a call will
50 define color indices IFCI, IFCI+1, IFCI+2, . . . , IFCI+15 and it will
51 set all elements of the internal parameter array ´CC´ corresponding to
52 indices 1 through 16. At the moment, although such a call does define a
53 set of sixteen colors (ranging from blue to red) and set the elements
54 of ´CC´, it´s a bit pointless, since there are no characters for which
55 the special colors are used. In the future, there will be a few such
56 (like the state highway symbol, which is normally drawn in a particular
57 pair of colors); at that time, the routine will be of more use.
58 PLCHHQ - An alternate name for the routine PCHIQU.
60 PLCHMQ - An alternate name for the routine PCMEQU.
62 PLCHLQ - An alternate name for the routine PCLOQU.
64
66 #include <ncarg/ncargC.h>
67 c_pchiqu
69 c_pcmequ
70 c_pcloqu
71 c_pcgetc
72 c_pcgeti
73 c_pcgetr
74 c_pcrset
75 c_pcsetc
76 c_pcseti
77 c_pcsetr
78 c_pcpnwi
79 c_pcdlsc
80 c_plchhq
81 c_plchmq
82 c_plchlq
83
85 PCMPXY - This routine is normally not called directly by the user
86 (though it can be). It is called by PCHIQU and by PCMEQU when the user
87 has set the mapping flag ´MA´ nonzero to request mapping of characters
88 from one X/Y coordinate system to another.
89
91 To use Plotchar routines, load the NCAR Graphics libraries ncarg,
92 ncarg_gks, and ncarg_c, preferably in that order.
93
95 Various error conditions can occur in Plotchar. Each of these results
96 in a call to the error-handling routine SETER, with a final argument
97 indicating that the error is recoverable; by default, an error message
98 is printed and execution is terminated, but, if you turn on error
99 recovery (as described in the "man" page for "error_handling"), you can
100 get control back.
101 The error messages are as follows; all should be more or less self-
103 explanatory.
104 PCDLSC - FIRST COLOR INDEX IS LESS THAN ZERO
106 PCDLSC - UNCLEARED PRIOR ERROR
107 PCGETC - UNCLEARED PRIOR ERROR
108 PCGETC - UNRECOGNIZED PARAMETER NAME
109 PCGETI - UNCLEARED PRIOR ERROR
110 PCGETR - BOX COLOR ARRAY INDEX IS OUT OF RANGE
111 PCGETR - COLOR ARRAY INDEX IS OUT OF RANGE
112 PCGETR - UNCLEARED PRIOR ERROR
113 PCGETR - UNRECOGNIZED PARAMETER NAME
114 PCHIQU - UNCLEARED PRIOR ERROR
115 PCLOQU - UNCLEARED PRIOR ERROR
116 PCMEQU - UNCLEARED PRIOR ERROR
117 PCPNWI - INTERNAL ERROR - SEE CONSULTANT
118 PCPNWI - PARAMETER NAME TOO SHORT
119 PCSETC - UNCLEARED PRIOR ERROR
120 PCSETC - UNRECOGNIZED FONT NAME
121 PCSETC - UNRECOGNIZED PARAMETER NAME
122 PCSETI - UNCLEARED PRIOR ERROR
123 PCSETR - BOX COLOR ARRAY INDEX IS OUT OF RANGE
124 PCSETR - COLOR ARRAY INDEX IS OUT OF RANGE
125 PCSETR - UNCLEARED PRIOR ERROR
126 PCSETR - UNRECOGNIZED PARAMETER NAME
127 PLCHHQ - DATASET NOT LOADED CORRECTLY
128 PLCHHQ - ERROR EXIT FROM GQCNTN
129 PLCHHQ - ERROR EXIT FROM GQFACI
130 PLCHHQ - ERROR EXIT FROM GQFAIS
131 PLCHHQ - ERROR EXIT FROM GQLWSC
132 PLCHHQ - ERROR EXIT FROM GQNT
133 PLCHHQ - ERROR EXIT FROM GQPLCI
134 PLCHHQ - ERROR EXIT FROM GQTXCI
135 PLCHHQ - INTERNAL LOGIC ERROR (NCRA TOO BIG) - SEE CONSULTANT
136 PLCHHQ - INTERNAL LOGIC ERROR (NDGU = 0) - SEE CONSULTANT
137 PLCHHQ - INTERNAL LOGIC ERROR (NPCS TOO BIG) - SEE CONSULTANT
138 PLCHHQ - INTERNAL LOGIC ERROR (XCP1 OR XCP2 = OORV) - SEE
139 CONSULTANT
140 PLCHHQ - INTERNAL LOGIC ERROR (XCRA/YCRA TOO SMALL) - SEE
141 CONSULTANT
142 PLCHHQ - UNCLEARED PRIOR ERROR
143 PLCHLQ - ERROR EXIT FROM GQCHH
144 PLCHLQ - ERROR EXIT FROM GQCHUP
145 PLCHLQ - ERROR EXIT FROM GQCNTN
146 PLCHLQ - ERROR EXIT FROM GQNT
147 PLCHLQ - ERROR EXIT FROM GQTXAL
148 PLCHLQ - ERROR EXIT FROM GQTXP
149 PLCHLQ - UNCLEARED PRIOR ERROR
150 PLCHMQ - UNCLEARED PRIOR ERROR
151
154 Online: plotchar_params, pcdlsc, pcgetc, pcgeti, pcgetr, pchiqu,
155 pcloqu, pcmequ, pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr,
156 ncarg_cbind.
157 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
159
161 Copyright (C) 1987-2007
162 University Corporation for Atmospheric Research
163 This documentation is free software; you can redistribute it and/or
165 modify it under the terms of the GNU General Public License as
166 published by the Free Software Foundation; either version 2 of the
167 License, or (at your option) any later version.
168 This software is distributed in the hope that it will be useful, but
170 WITHOUT ANY WARRANTY; without even the implied warranty of
171 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
172 General Public License for more details.
173 You should have received a copy of the GNU General Public License along
175 with this software; if not, write to the Free Software Foundation,
176 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
177UNIX March 1993 Plotchar(3NCARG)