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

NAME

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

SYNOPSIS

11       CALL CPCHLL (IFLG)
12

DESCRIPTION

14       IFLG        (INTEGER, input) is positive if an action is about to be
15                   taken, negative if an action has just been completed.  The
16                   action in question is defined by the absolute value of
17                   IFLG, as follows:
18
19                   ·      The value 1 implies the determination of the size of
20                          the label (by means of a call to PLCHHQ, in the
21                          package Plotchar, with ANGD=360.).
22
23                   ·      The value 2 implies the filling of the box around
24                          the label, which is done before the drawing of the
25                          label itself.
26
27                   ·      The value 3 implies the drawing of the label (by
28                          means of a call to PLCHHQ, in the package Plotchar).
29
30                   ·      The value 4 implies the drawing of the box around
31                          the label, which is done after the drawing of the
32                          label itself.
33

USAGE

35       The routine CPCHLL is not to be called by the user. It is called
36       several times by CPLBAM and/or CPLBDR while each contour-line label is
37       positioned and drawn. The default version of CPCHLL does nothing. A
38       user-supplied replacement may change attributes such as color and line
39       width (by calling the SPPS routine SETUSV or the appropriate GKS
40       routines). The text of the label may be retrieved by means of a "CALL
41       CPGETC ('CTM',CVAL)". The text of the label may be changed by means of
42       a "CALL CPSETC ('CTM',CVAL)"; this should only be done during a call
43       with IFLG = 1 or 3 and, if it is done for one of those values, it
44       should be done for the other.
45
46       When CPCHLL is called, the parameter 'PAI' will have been set to the
47       index of the appropriate contour level. Thus, parameters associated
48       with that level may easily be retrieved by calls to CPGETx.
49

ACCESS

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

SEE ALSO

55       Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpcica,
56       cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc, cpgeti,
57       cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb, cprect,
58       cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
59

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