Scroll to navigation

Labelbar(3NCARG) NCAR GRAPHICS Labelbar(3NCARG)

NAME

Labelbar - 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

COPYRIGHT

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.

March 1993 UNIX