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

NAME

6       PCGETI - Retrieves the integral value of an internal parameter of type
7       INTEGER or REAL.
8

SYNOPSIS

10       CALL PCGETI (PNAM,IVAL)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_pcgeti (char *pnam, int *ival)
16

DESCRIPTION

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       IVAL        (an output variable of type INTEGER) is the name of the
30                   variable into which the value of the internal parameter
31                   specified by PNAM is to be retrieved.  If the internal
32                   parameter is a value "i" of type INTEGER, the value
33                   returned is "i".  If the internal parameter is a value "r"
34                   of type REAL, the value returned is "INT(r)".
35

C-BINDING DESCRIPTION

37       The C-binding argument descriptions are the same as the FORTRAN
38       argument descriptions.
39

USAGE

41       This routine allows you to retrieve the current value of Plotchar
42       parameters.  For a complete list of parameters available in this
43       utility, see the plotchar_params man page.
44

EXAMPLES

46       Use the ncargex command to see the following relevant examples: cpexcc,
47       vvexcc.
48

ACCESS

50       To use PCGETI or c_pcgeti, load the NCAR Graphics libraries ncarg,
51       ncarg_gks, and ncarg_c, preferably in that order.
52

SEE ALSO

54       Online: plotchar, plotchar_params, pcdlsc, pcgetc, pcgetr, pchiqu,
55       pcloqu, pcmequ, pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr,
56       ncarg_cbind.
57
58       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
59

61       Copyright (C) 1987-2007
62       University Corporation for Atmospheric Research
63
64       This documentation is free software; you can redistribute it and/or
65       modify it under the terms of the GNU General Public License as
66       published by the Free Software Foundation; either version 2 of the
67       License, or (at your option) any later version.
68
69       This software is distributed in the hope that it will be useful, but
70       WITHOUT ANY WARRANTY; without even the implied warranty of
71       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
72       General Public License for more details.
73
74       You should have received a copy of the GNU General Public License along
75       with this software; if not, write to the Free Software Foundation,
76       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
77
78
79
80UNIX                              March 1993                    PCGETI(3NCARG)
Impressum