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

NAME

6       CPCHIL - Called by Conpack routines as the informational label is
7       drawn.  The default version does nothing.  A user-written version may
8       be supplied to provide control as the label is drawn.
9

SYNOPSIS

11       CALL CPCHIL (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 package
21                       Plotchar, with ANGD=360.).
22
23                   ·   The value 2 implies the filling of the box around the
24                       label, which is done before the drawing of the label
25                       itself.
26
27                   ·   The value 3 implies the drawing of the label (by means
28                       of a call to PLCHHQ, in the package Plotchar).
29
30                   ·   The value 4 implies the drawing of the box around the
31                       label, which is done after the drawing of the label
32                       itself.
33

USAGE

35       The routine CPCHIL is not to be called by the user. It is called
36       several times by CPLBAM and/or CPLBDR while the informational label is
37       positioned and drawn. The default version of CPCHIL 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 IFLG = 3, and, if it is done for one of those values,
44       it should be done for the other.
45

ACCESS

47       To use CPCHIL, load the NCAR Graphics libraries ncarg, ncarg_gks, and
48       ncarg_c, preferably in that order.
49

SEE ALSO

51       Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchll, cpcica,
52       cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc, cpgeti,
53       cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb, cprect,
54       cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
55

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