1CPLBAM(3NCARG) NCAR GRAPHICS CPLBAM(3NCARG)
2
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
13 CALL CPLBAM (ZDAT, RWRK, IWRK, IAMA)
14
16 #include <ncarg/ncargC.h>
17 void c_cplbam (float *zdat, float *rwrk, int *iwrk,
19 int *iama)
20
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 ZDAT (REAL array, dimensioned as specified in the last call to
27 CPRECT, CPSPS1, or CPSPS2, input) is the data array.
28 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 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 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
42 The C-binding argument descriptions are the same as the FORTRAN
43 argument descriptions.
44
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 · 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 · Boxes for the high labels are added only if the parameter 'HIT',
58 which specifies the text of those labels, is non-blank.
59 · Boxes for the low labels are added only if the parameter 'LOT',
61 which specifies the text of those labels, is non-blank.
62 · 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
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
78 To use CPLBAM or c_cplbam, load the NCAR Graphics libraries ncarg,
79 ncarg_gks, and ncarg_c, preferably in that order.
80
82 See the conpack man page for a description of all Conpack error
83 messages and/or informational messages.
84
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 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
92
94 Copyright (C) 1987-2009
95 University Corporation for Atmospheric Research
96 The use of this Software is governed by a License Agreement.
98UNIX March 1993 CPLBAM(3NCARG)