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

NAME

6       Labelbar - Creates a labeled, filled, rectangular bar to serve as a key
7       for a filled plot.
8

SYNOPSIS

10       LBLBAR - Produces a complete label bar.
11
12       LBGETI - Retrieves current integer parameter values.
13
14       LBGETR - Retrieves current real parameter values.
15
16       LBSETI - Sets integer parameter values.
17
18       LBSETR - Sets real parameter values.
19

C-BINDING SYNOPSIS

21       c_lblbar
22       c_lbgeti
23       c_lbgetr
24       c_lbfill
25       c_lbseti
26       c_lbsetr
27

USER-MODIFIABLE INTERNAL ROUTINES

29       LBFILL - Fills label bars.
30

ACCESS

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

MESSAGES

36       Various error conditions can occur in Labelbar.  Each of these results
37       in a call to the error-handling routine SETER, with a final argument
38       indicating that the error is recoverable; by default, an error message
39       is printed and execution is terminated, but, if you turn on error
40       recovery (as described in the "man" page for "error_handling"), you can
41       get control back.
42
43       The error messages are as follows; all should be more or less self-
44       explanatory.
45
46            LBGETI - UNCLEARED PRIOR ERROR
47            LBGETR - PARAMETER NAME NOT KNOWN - X
48            LBGETR - PARAMETER NAME TOO SHORT - X
49            LBGETR - UNCLEARED PRIOR ERROR
50            LBLBAR - ERROR EXIT FROM GQFACI
51            LBLBAR - ERROR EXIT FROM GQLWSC
52            LBLBAR - ERROR EXIT FROM GQPLCI
53            LBLBAR - ERROR EXIT FROM GQTXCI
54            LBLBAR - UNCLEARED PRIOR ERROR
55            LBSETI - UNCLEARED PRIOR ERROR
56            LBSETR - PARAMETER NAME NOT KNOWN - X
57            LBSETR - PARAMETER NAME TOO SHORT - X
58            LBSETR - UNCLEARED PRIOR ERROR
59
60       All of these should be more or less self-explanatory. Those that
61       complain of an error exit from a GKS routine probably imply that GKS
62       has somehow been put in the wrong state.  Others will result from using
63       an incorrect internal-parameter name in a call to one of the parameter-
64       access routines.  (The "X" will be replaced by the offending name.)
65

SEE ALSO

67       Online: labelbar_params, lbfill, lbgeti, lbgetr, lblbar, lbseti,
68       lbsetr, ncarg_cbind
69
70       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
71
73       Copyright (C) 1987-2007
74       University Corporation for Atmospheric Research
75
76       This documentation is free software; you can redistribute it and/or
77       modify it under the terms of the GNU General Public License as
78       published by the Free Software Foundation; either version 2 of the
79       License, or (at your option) any later version.
80
81       This software is distributed in the hope that it will be useful, but
82       WITHOUT ANY WARRANTY; without even the implied warranty of
83       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
84       General Public License for more details.
85
86       You should have received a copy of the GNU General Public License along
87       with this software; if not, write to the Free Software Foundation,
88       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
89
90
91
92UNIX                              March 1993                  Labelbar(3NCARG)
Impressum