1PCGETC(3NCARG) NCAR GRAPHICS PCGETC(3NCARG)
2
3
4
6 PCGETC - Retrieves the current character value of an internal
7 parameter.
8
10 CALL PCGETC (PNAM,CVAL)
11
13 #include <ncarg/ncargC.h>
14
15 void c_pcgetc (char *pnam, char *cval, int len)
16
18 PNAM (an input constant or variable of type CHARACTER) specifies
19 the name of the parameter to get. The name must appear as
20 the first two characters of the string. If the internal
21 parameter is one of the two (´BC´ and ´CC´) that are
22 arrays, the index of the desired array element may appear,
23 enclosed in parentheses, in columns 3 and following. Other
24 characters may be used to document the use of the parameter
25 being retrieved; for example, instead of just ´MA´, one can
26 use ´MA - MAPPING FLAG´ and, instead of ´CC(10)´, one can
27 use ´CC(10) - SPECIAL COLOR 10´.
28
29 CVAL (an output variable of type CHARACTER) is the name of the
30 variable into which the value of the internal parameter
31 specified by PNAM is to be retrieved.
32
34 The C-binding argument descriptions are the same as the FORTRAN
35 argument descriptions with the following exception:
36
37 len The size of cval as dimensioned in the calling program.
38
40 This routine allows you to retrieve the current value of Plotchar
41 parameters. For a complete list of parameters available in this
42 utility, see the plotchar_params man page.
43
45 To use PCGETC or c_pcgetc, load the NCAR Graphics libraries ncarg,
46 ncarg_gks, and ncarg_c, preferably in that order.
47
49 See the plotchar man page for a description of all Plotchar error
50 messages and/or informational messages.
51
53 Online: plotchar, plotchar_params, pcdlsc, pcgeti, pcgetr, pchiqu,
54 pcloqu, pcmequ, pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr,
55 ncarg_cbind.
56
57 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
58
60 Copyright (C) 1987-2007
61 University Corporation for Atmospheric Research
62
63 This documentation is free software; you can redistribute it and/or
64 modify it under the terms of the GNU General Public License as
65 published by the Free Software Foundation; either version 2 of the
66 License, or (at your option) any later version.
67
68 This software is distributed in the hope that it will be useful, but
69 WITHOUT ANY WARRANTY; without even the implied warranty of
70 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
71 General Public License for more details.
72
73 You should have received a copy of the GNU General Public License along
74 with this software; if not, write to the Free Software Foundation,
75 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
76
77
78
79UNIX March 1993 PCGETC(3NCARG)