ncl_labelbar - Man Page

Creates a labeled, filled, rectangular bar to serve as a key for a filled plot.

Synopsis

LBLBAR - Produces a complete label bar.

LBGETI - Retrieves current integer parameter values.

LBGETR - Retrieves current real parameter values.

LBSETI - Sets integer parameter values.

LBSETR - Sets real parameter values.

C-Binding Synopsis

c_lblbar
c_lbgeti
c_lbgetr
c_lbfill
c_lbseti
c_lbsetr

User-Modifiable Internal Routines

LBFILL - Fills label bars.

Access

To use Labelbar routines, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

Messages

Various error conditions can occur in Labelbar.  Each of these results in a call to the error-handling routine SETER, with a final argument indicating that the error is recoverable; by default, an error message is printed and execution is terminated, but, if you turn on error recovery (as described in the "man" page for "error_handling"), you can get control back.

The error messages are as follows; all should be more or less self-explanatory.

LBGETI - UNCLEARED PRIOR ERROR
LBGETR - PARAMETER NAME NOT KNOWN - X
LBGETR - PARAMETER NAME TOO SHORT - X
LBGETR - UNCLEARED PRIOR ERROR
LBLBAR - ERROR EXIT FROM GQFACI
LBLBAR - ERROR EXIT FROM GQLWSC
LBLBAR - ERROR EXIT FROM GQPLCI
LBLBAR - ERROR EXIT FROM GQTXCI
LBLBAR - UNCLEARED PRIOR ERROR
LBSETI - UNCLEARED PRIOR ERROR
LBSETR - PARAMETER NAME NOT KNOWN - X
LBSETR - PARAMETER NAME TOO SHORT - X
LBSETR - UNCLEARED PRIOR ERROR

All of these should be more or less self-explanatory. Those  that complain of an error exit from a GKS routine probably  imply that GKS has somehow been put in the wrong state. Others will result from using an incorrect internal-parameter name in a call to one of the parameter-access routines.  (The "X" will be replaced by the offending name.)

See Also

Online: labelbar_params, lbfill, lbgeti, lbgetr, lblbar, lbseti, lbsetr, ncarg_cbind

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

Info

March 1993 UNIX NCAR GRAPHICS