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

NAME

6       CPLBAM - Adds label boxes (for the informational label, high and low
7       labels, and contour-line labels) to an area map. The ultimate object of
8       this will usually be to prevent contour lines drawn by CPCLDM from
9       passing through labels or to prevent fill of the label boxes as contour
10       bands are filled.
11

SYNOPSIS

13       CALL CPLBAM (ZDAT, RWRK, IWRK, IAMA)
14

C-BINDING SYNOPSIS

16       #include <ncarg/ncargC.h>
17
18       void c_cplbam (float *zdat, float *rwrk, int *iwrk,
19       int *iama)
20

DESCRIPTION

22       The first three arguments are arrays used in the last call to CPRECT,
23       CPSPS1, or CPSPS2, the contents of which must not have been changed
24       since that call.
25
26       ZDAT        (REAL array, dimensioned as specified in the last call to
27                   CPRECT, CPSPS1, or CPSPS2, input) is the data array.
28
29       RWRK        (REAL array, dimensioned as specified in the last call to
30                   CPRECT, CPSPS1, or CPSPS2, input/output) is the real
31                   workspace array.
32
33       IWRK        (INTEGER array, dimensioned as specified in the last call
34                   to CPRECT, CPSPS1, or CPSPS2, input/output) is the integer
35                   workspace array.
36
37       IAMA        (INTEGER array, dimensioned as specified in a call to
38                   ARINAM) is the array holding the area map to which the
39                   label boxes are to be added.
40

C-BINDING DESCRIPTION

42       The C-binding argument descriptions are the same as the FORTRAN
43       argument descriptions.
44

USAGE

46       The routine CPLBAM, which adds label boxes to an area map, may be
47       called at any time after the initialization call to CPRECT, CPSPS1, or
48       CPSPS2.  If, during the last call to CPRECT, CPSPS1, or CPSPS2, the
49       data being contoured were found to be essentially constant, then the
50       box for the constant field label is added to the area map.  Otherwise,
51       boxes for the informational label, the high and low labels, and/or the
52       contour line labels are added, as follows:
53
54       ·  A box for the informational label is added only if the parameter
55          'ILT', which specifies the text of that label, is non-blank.
56
57       ·  Boxes for the high labels are added only if the parameter 'HIT',
58          which specifies the text of those labels, is non-blank.
59
60       ·  Boxes for the low labels are added only if the parameter 'LOT',
61          which specifies the text of those labels, is non-blank.
62
63       ·  Boxes for the contour line labels are added only if the parameter
64          'LLP', which specifies how those labels are to be positioned, has an
65          absolute value of 2 or 3, and if, for some I between 1 and 'NCL',
66          inclusive, the Ith element of the parameter array 'CLU' has a value
67          implying that contour lines at the contour level specified by the
68          Ith element of 'CLV' are to be labeled.
69

EXAMPLES

71       Use the ncargex command to see the following relevant examples:
72       ccpcldm, ccplbam, ccpllb, ccpllc, ccplll, ccpllo, ccpllp, ccpllt,
73       ccpllw, ccppc, ccppc1, ccppc2, ccppc3, ccppc4, ccprc, ccpscam, colcon,
74       cpex01, cpex02, cpex03, cpex04, cpex06, cbex01, vvex01, fcover, ffex03,
75       ffex05.
76

ACCESS

78       To use CPLBAM or c_cplbam, load the NCAR Graphics libraries ncarg,
79       ncarg_gks, and ncarg_c, preferably in that order.
80

MESSAGES

82       See the conpack man page for a description of all Conpack error
83       messages and/or informational messages.
84

SEE ALSO

86       Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll,
87       cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc,
88       cpgeti, cpgetr, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb, cprect,
89       cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
90
91       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
92

94       Copyright (C) 1987-2007
95       University Corporation for Atmospheric Research
96
97       This documentation is free software; you can redistribute it and/or
98       modify it under the terms of the GNU General Public License as
99       published by the Free Software Foundation; either version 2 of the
100       License, or (at your option) any later version.
101
102       This software is distributed in the hope that it will be useful, but
103       WITHOUT ANY WARRANTY; without even the implied warranty of
104       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
105       General Public License for more details.
106
107       You should have received a copy of the GNU General Public License along
108       with this software; if not, write to the Free Software Foundation,
109       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
110
111
112
113
114UNIX                              March 1993                    CPLBAM(3NCARG)
Impressum