NAME

       CPCHLL - Called by Conpack routines as contour line labels are drawn.  The default version
       does nothing.  A user-written version may be supplied to provide control as the labels are
       drawn.

SYNOPSIS

       CALL CPCHLL (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 CPCHLL is not to be called by the user. It is called several times by CPLBAM
       and/or CPLBDR while each contour-line label is positioned and drawn. The default version
       of CPCHLL 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 3 and, if it is done for one of those values, it
       should be done for the other.

       When CPCHLL is called, the parameter 'PAI' will have been set to the index of the
       appropriate contour level. Thus, parameters associated with that level may easily be
       retrieved by calls to CPGETx.

ACCESS

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

SEE ALSO

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