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.

UNIX                                               March 1993                                     CPCHLL(3NCARG)