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.