NAME¶
PCGETR - Retrieves the real value of an internal parameter of type REAL or
INTEGER.
SYNOPSIS¶
CALL PCGETR (PNAM,RVAL)
C-BINDING SYNOPSIS¶
#include <ncarg/ncargC.h>
void c_pcgetr (char *pnam, float *rval)
DESCRIPTION¶
- PNAM
- (an input expression of type CHARACTER) specifies the name of the
parameter to get. The name must appear as the first two characters of the
string. If the internal parameter is one of the two (´BC´
and ´CC´) that are arrays, the index of the desired array
element may appear, enclosed in parentheses, in columns 3 and following.
Other characters may be used to document the use of the parameter being
retrieved; for example, instead of just ´MA´, one can use
´MA - MAPPING FLAG´ and, instead of ´CC(10)´,
one can use ´CC(10) - SPECIAL COLOR 10´.
- RVAL
- (an output variable of type REAL) is the name of the variable into which
the value of the internal parameter specified by PNAM is to be retrieved.
If the internal parameter is a value "r" of type REAL, the value
returned is "r". If the internal parameter is a value
"i" of type INTEGER, the value returned is
"REAL(i)".
C-BINDING DESCRIPTION¶
The C-binding argument descriptions are the same as the FORTRAN argument
descriptions.
USAGE¶
This routine allows you to retrieve the current value of Plotchar parameters.
For a complete list of parameters available in this utility, see the
plotchar_params man page.
EXAMPLES¶
Use the ncargex command to see the following relevant examples: cpexcc, epltch,
vvexcc, fpchiqu.
ACCESS¶
To use PCGETR or c_pcgetr, load the NCAR Graphics libraries ncarg, ncarg_gks,
and ncarg_c, preferably in that order.
MESSAGES¶
See the plotchar man page for a description of all Plotchar error messages
and/or informational messages.
SEE ALSO¶
Online: plotchar, plotchar_params, pcdlsc, pcgetc, pcgeti, pchiqu, pcloqu,
pcmequ, pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr, ncarg_cbind.
Hardcopy: NCAR Graphics Fundamentals, UNIX Version
COPYRIGHT¶
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.