1CPCHCL(3NCARG)                   NCAR GRAPHICS                  CPCHCL(3NCARG)
2
3
4

NAME

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

SYNOPSIS

11       CALL CPCHCL (IFLG)
12

DESCRIPTION

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

USAGE

18       The routine CPCHCL is not to be called by the user. It is called by the
19       Conpack routines CPCLDM and CPCLDR just before and just after the
20       contour lines at each level are drawn. The default version of CPCHCL
21       does nothing. A user-supplied replacement may change attributes such as
22       color and line width (by calling the SPPS routine SETUSV or the
23       appropriate GKS routines).
24
25       If the element of the parameter array 'CLU' corresponding to 'PAI' = -1
26       has been set non-zero to request the drawing of the edge of the grid,
27       then CPCHCL will be called before and after that is done. Similarly, if
28       the element of 'CLU' corresponding to 'PAI' = -2 has been set non-zero,
29       then CPCHCL will be called before and after the drawing of the edges of
30       the special-value areas, and, if the element of 'CLU' corresponding to
31       'PAI' = -3 has been set non-zero, then CPCHCL will be called before and
32       after the drawing of the edges of the out-of-range areas.
33
34       When CPCHCL is called, the parameter 'PAI' will have been set to the
35       index of the appropriate contour level (between 1 and 'NCL') or to one
36       of the values -1, -2, or -3. By retrieving the value of 'PAI', CPCHCL
37       can find out what line is being drawn; also, a CPGETx call to retrieve
38       an element of a parameter array like 'CLD' will automatically get the
39       correct one for the line being drawn.
40

ACCESS

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

SEE ALSO

46       Online: conpack, cpback, cpchcf, cpchhl, cpchil, cpchll, cpcica,
47       cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc, cpgeti,
48       cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb, cprect,
49       cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
50

52       Copyright (C) 1987-2007
53       University Corporation for Atmospheric Research
54
55       This documentation is free software; you can redistribute it and/or
56       modify it under the terms of the GNU General Public License as
57       published by the Free Software Foundation; either version 2 of the
58       License, or (at your option) any later version.
59
60       This software is distributed in the hope that it will be useful, but
61       WITHOUT ANY WARRANTY; without even the implied warranty of
62       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
63       General Public License for more details.
64
65       You should have received a copy of the GNU General Public License along
66       with this software; if not, write to the Free Software Foundation,
67       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
68
69
70
71
72UNIX                              March 1993                    CPCHCL(3NCARG)
Impressum