ncl_pcgetc - Man Page

CALL PCGETC (PNAM,CVAL)

#include <ncarg/ncargC.h>

void c_pcgetc (char *pnam, char *cval, int len)

PNAM

(an input constant or variable 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´.

CVAL

(an output variable of type CHARACTER) is the name of the variable into which the value of the internal parameter specified by PNAM is to be retrieved.

The C-binding argument descriptions are the same as the FORTRAN  argument descriptions with the following exception:

len

The size of cval as dimensioned in the calling program.

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.

To use PCGETC or c_pcgetc, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.  

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

Online: plotchar, plotchar_params, pcdlsc, pcgeti, pcgetr, pchiqu, pcloqu, pcmequ, pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr, ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.