CPCHHL(3NCARG)

💖 CPCHHL 💖 — the NCAR Graphics bestie you never call yourself

okay so real talk, this is a page from the NCAR Graphics manual, section 3NCARG, and it's about a little routine called CPCHHL. she's a callback, a vibe, a whole mood. let's get into it 🫶

✨ NAME ✨

CPCHHL — bestie, this one gets called by the Conpack routines whenever high/low labels are being drawn. the default version? does literally nothing. a user-written version may be supplied to provide control as the labels are drawn. no cap.

🌸 SYNOPSIS 🌸

CALL CPCHHL (IFLG)

💅 DESCRIPTION 💅

• IFLG — (INTEGER, input) is positive if an action is about to be taken, and negative if an action has just been completed. which action tho? that's decided by the absolute value of IFLG, like so:
  • The value 1 implies the determination of the size of the label for a high (by means of a call to PLCHHQ, in the package Plotchar, with ANGD = 360.).
  • The value 2 implies the filling of the box around the label for a high, which is done before the drawing of the label itself.
  • The value 3 implies the drawing of the label for a high (by means of a call to PLCHHQ, in the package Plotchar).
  • The value 4 implies the drawing of the box around the label for a high, which is done after the drawing of the label itself.
  • The value 5 implies the determination of the size of the label for a low (by means of a call to PLCHHQ, in the package Plotchar, with ANGD = 360.).
  • The value 6 implies the filling of the box around the label for a low, which is done before the drawing of the label itself.
  • The value 7 implies the drawing of the label for a low (by means of a call to PLCHHQ, in the package Plotchar).
  • The value 8 implies the drawing of the box around the label for a low, which is done after the drawing of the label itself.

🦋 USAGE 🦋

so listen. the routine CPCHHL is not to be called by the user. periodt. it gets called several times by CPLBAM and/or CPLBDR while each high or low label is positioned and drawn. the default version of CPCHHL does nothing (iconic behaviour honestly).

a user-supplied replacement may change attributes such as color and line width — and the way you do that is by calling the SPPS routine SETUSV or the appropriate GKS routines.

the text of the label may be retrieved by means of a

CALL CPGETC ('CTM',CVAL)

and the text of the label may be changed by means of a

CALL CPSETC ('CTM',CVAL)

⚠️ but bestie, careful: that CPSETC should only be done during a call with IFLG = 1, 3, 5, or 7. and if it is done for one of the two values 5 and 7, it should also be done for the other. do not skip that, fr fr.

when CPCHHL is called, the parameter 'ZDV' will have been set to the value of the high or low being labelled; its value may be retrieved and used by CPCHHL. 👑

🌈 ACCESS 🌈

to use CPCHHL, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. that's the whole vibe check. ✨

🎀 SEE ALSO 🎀

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

iykyk. go read them all, they're giving lore. 📚

👑 COPYRIGHT 👑

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.

and that's the whole page, bestie 💜 she's from the UNIX manual, dated March 1993, and she lives at CPCHHL(3NCARG) forever and ever. slay, no notes, go forth and label those highs and lows. 🦋✨💖