CPCHCL(3NCARG)

NAME
CPCHCL - Called by the Conpack routines CPCLDM and CPCLDR. The default version does nothing. A user-written version may be supplied to provide control as contour lines are drawn.

SYNOPSIS
CALL CPCHCL (IFLG)

DESCRIPTION

IFLG
    (INTEGER, input) is +1 if a line is about to be drawn, -1 if a line has just been drawn.

USAGE
The routine CPCHCL is not to be called by the user. It is called by the Conpack routines CPCLDM and CPCLDR just before and just after the contour lines at each level are drawn. The default version of CPCHCL 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).

If the element of the parameter array 'CLU' corresponding to 'PAI' = -1 has been set non-zero to request the drawing of the edge of the grid, then CPCHCL will be called before and after that is done. Similarly, if the element of 'CLU' corresponding to 'PAI' = -2 has been set non-zero, then CPCHCL will be called before and after the drawing of the edges of the special-value areas, and, if the element of 'CLU' corresponding to 'PAI' = -3 has been set non-zero, then CPCHCL will be called before and after the drawing of the edges of the out-of-range areas.

When CPCHCL is called, the parameter 'PAI' will have been set to the index of the appropriate contour level (between 1 and 'NCL') or to one of the values -1, -2, or -3. By retrieving the value of 'PAI', CPCHCL can find out what line is being drawn; also, a CPGETx call to retrieve an element of a parameter array like 'CLD' will automatically get the correct one for the line being drawn.

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

SEE ALSO
Online: conpack, cpback, cpchcf, cpchhl, cpchil, 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

COPYRIGHT
Copyright (C) 1987-2009
University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.