ncl_cplbam man page

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

Synopsis

CALL CPLBAM (ZDAT, RWRK, IWRK, IAMA)

C-Binding Synopsis

#include <ncarg/ncargC.h>

void c_cplbam (float *zdat, float *rwrk, int *iwrk,
int *iama)

Description

The first three arguments are arrays used in the last call  to CPRECT, CPSPS1, or CPSPS2, the contents of which must  not have been changed since that call.

ZDAT

(REAL array, dimensioned as specified in the last call  to CPRECT, CPSPS1, or CPSPS2, input) is the data array.

RWRK

(REAL array, dimensioned as specified in the last call  to CPRECT, CPSPS1, or CPSPS2, input/output) is the real  workspace array.

IWRK

(INTEGER array, dimensioned as specified in the last  call to CPRECT, CPSPS1, or CPSPS2, input/output) is the  integer workspace array.

IAMA

(INTEGER array, dimensioned as specified in a call to  ARINAM) is the array holding the area map to which the  label boxes are to be added.

C-Binding Description

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

Usage

The routine CPLBAM, which adds label boxes to an area map, may be called at any time after the initialization call to CPRECT, CPSPS1, or CPSPS2.  If, during the last call to CPRECT, CPSPS1, or CPSPS2, the data being contoured were found to be essentially constant, then the box for the constant field label is added to the area map.  Otherwise, boxes for the informational label, the high and low labels, and/or the contour line labels are added, as follows:

Examples

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

Access

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

Messages

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

See Also

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

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

Info

March 1993 UNIX NCAR GRAPHICS