ncl_cpchil man page

CPCHIL — Called by Conpack routines as the informational label is drawn. The default version does nothing. A user-written version may be supplied to provide control as the label is drawn.

Synopsis

CALL CPCHIL (IFLG)

Description

IFLG

(INTEGER, input) is positive if an action is about to be taken, negative if an action has just been completed. The action in question is defined by the absolute value of IFLG, as follows:

·
The value 1 implies the determination of the size of the label (by means of a call to PLCHHQ, in the package Plotchar, with ANGD=360.).
·
The value 2 implies the filling of the box around the label, which is done before the drawing of the label itself.
·
The value 3 implies the drawing of the label (by means of a call to PLCHHQ, in the package Plotchar).
·
The value 4 implies the drawing of the box around the label, which is done after the drawing of the label itself.

Usage

The routine CPCHIL is not to be called by the user. It is called several times by CPLBAM and/or CPLBDR while the informational label is positioned and drawn. The default version of CPCHIL does nothing. A user-supplied replacement may change attributes such as color and line width (by calling the SPPS routine SETUSV or the appropriate GKS routines). The text of the label may be retrieved by means of a "CALL CPGETC ('CTM',CVAL)". The text of the label may be changed by means of a "CALL CPSETC ('CTM',CVAL)"; this should only be done during a call with IFLG = 1 or IFLG = 3, and, if it is done for one of those values, it should be done for the other.

Access

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

See Also

Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchll, cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc, cpgeti, cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb, cprect, cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind

Info

March 1993 UNIX NCAR GRAPHICS