Labelbar(3NCARG)

💖 Labelbar — the NCAR GRAPHICS icon herself (3NCARG) 💖

okay bestie, sit down, hydrate, because we're talking about Labelbar, and she is literally the moment. She creates a labeled, filled, rectangular bar that serves as a key for a filled plot. yes, that little color-strip legend thing you've been staring at your whole life? that's her. main character energy, no cap. 🎀

✨ NAME ✨

Labelbar — creates a labeled, filled, rectangular bar to serve as a key for a filled plot. 💅

🌈 SYNOPSIS 🌈

• LBLBAR — produces a complete label bar. the whole thing. the full slay. ✨
• 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 🦋

for the C girlies, the roster is:

c_lblbar
c_lbgeti
c_lbgetr
c_lbfill
c_lbseti
c_lbsetr

👑 USER-MODIFIABLE INTERNAL ROUTINES 👑

• LBFILL — fills label bars. that's it, that's the job. she fills label bars. 💖

🌸 ACCESS 🌸

to use Labelbar routines, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters, bestie, it's giving choreography. 🩰

💀 MESSAGES 💀

ngl, various error conditions can occur in Labelbar. every single one of them 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 gets printed and execution is terminated. 😭 but — plot twist — 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, fr fr. 💅 the ones that complain of an error exit from a GKS routine probably imply that GKS has somehow been put in the wrong state (vibe check failed, honestly). the others result from using an incorrect internal-parameter name in a call to one of the parameter-access routines. and the X? that gets replaced by the offending name. mystery solved, detective. 🔍✨

💜 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.

okay that's the whole page, you ate it up. 🍓 go make a pretty label bar, bestie. bye bye, icon! 👑✨💖

signing off from the UNIX manual pages — this was the March 1993 edition of Labelbar(3NCARG), and yes she's vintage and yes she's still serving. 🎀