CPCHCF(3NCARG)

✨ CPCHCF ✨ (that's a 3NCARG moment, from the NCAR GRAPHICS crew, bestie)

okay so real talk: CPCHCF is a little callback routine that Conpack hits up whenever it sniffs out a constant field. The default version? Does literally nothing. Zero. Nada. She's just vibing. But you can write your own version to take the wheel while that constant-field message gets drawn. 💅

🌸 SYNOPSIS 🌸

CALL CPCHCF (IFLG)

💖 DESCRIPTION 💖

• IFLG (INTEGER, input) — positive if an action is about to go down, negative if an action has just been completed. The action itself is whatever the absolute value of IFLG says it is, like this:
  • The value 1 implies the determination of the size of the label (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, which is done before the drawing of the label itself.
  • The value 3 implies the drawing of the label (by means of a call to PLCHHQ, in the package Plotchar).
  • The value 4 implies the drawing of the box around the label, which is done after the drawing of the label itself.

🦋 USAGE 🦋

okay so the #1 rule: you do not call CPCHCF yourself. This routine is not to be called by the user, periodt. Conpack calls it several times while a constant-field label is being drawn. 🙈

The default version of CPCHCF does nothing. A user-supplied replacement may change attributes such as color and line width — by calling the SPPS routine SETUSV or the appropriate GKS routines. ✨

The text of the label being written may be retrieved by means of a

CALL CPGETC ('CTM',CVAL)

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

CALL CPSETC ('CTM',CVAL)

⚠️ and this is the important part, bestie: changing the label text should only be done during a call with IFLG = 1 or 3 — and if you do it for one of those two values, you should also do it for the other. Don't play favorites. 😭

When CPCHCF is called, the parameter 'ZDV' will have been set to the value of the field; its value may be retrieved and used by CPCHCF. 👑

🎀 ACCESS 🎀

To use CPCHCF, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order, because we're not chaotic here. 🌈

🔥 SEE ALSO 🔥

Online: conpack, cpback, cpchcl, cpchhl, 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, cpsprs, cpsps1, cpsps2, ncarg_cbind

👑 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 — straight off a UNIX system, dated March 1993, filed under CPCHCF(3NCARG). iconic, historic, no cap. 🫶💜