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

NAME

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

SYNOPSIS

10       CALL PCGETR (PNAM,RVAL)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_pcgetr (char *pnam, float *rval)
16

DESCRIPTION

18       PNAM        (an input expression of type CHARACTER) specifies the name
19                   of the parameter to get. The name must appear as the first
20                   two characters of the string. If the internal parameter is
21                   one of the two (´BC´ and ´CC´) that are arrays, the index
22                   of the desired array element may appear, enclosed in
23                   parentheses, in columns 3 and following. Other characters
24                   may be used to document the use of the parameter being
25                   retrieved; for example, instead of just ´MA´, one can use
26                   ´MA - MAPPING FLAG´ and, instead of ´CC(10)´, one can use
27                   ´CC(10) - SPECIAL COLOR 10´.
28
29       RVAL        (an output variable of type REAL) 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 "r" of type REAL, the value returned
33                   is "r".  If the internal parameter is a value "i" of type
34                   INTEGER, the value returned is "REAL(i)".
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       epltch, vvexcc, fpchiqu.
48

ACCESS

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

MESSAGES

54       See the plotchar man page for a description of all Plotchar error
55       messages and/or informational messages.
56

SEE ALSO

58       Online: plotchar, plotchar_params, pcdlsc, pcgetc, pcgeti, pchiqu,
59       pcloqu, pcmequ, pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr,
60       ncarg_cbind.
61
62       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
63

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