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.