CPCHIL(3NCARG)

💖 CPCHIL 💖 — the NCAR Graphics one, bestie

okay so this is a page from the NCAR Graphics manual (you're in the 3NCARG section, iykyk) and it's about a lil routine called CPCHIL. She's a callback, she's a vibe, and she mostly does absolutely nothing unless you make her do something. Let's get into it 🎀

---

✨ NAME ✨

CPCHIL — she gets called by the Conpack routines while the informational label is being drawn. The default version? Does nothing. Nada. Zero. But you can write your own version to take control while the label is being drawn. main character energy fr 💅

---

✨ SYNOPSIS ✨

CALL CPCHIL (IFLG)

---

✨ DESCRIPTION ✨

• IFLG — (INTEGER, input) is positive if an action is about to be taken, and negative if an action has just been completed. The action in question is defined by the absolute value of IFLG, 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.

so like, sign tells you when, magnitude tells you what. periodt 🫶

---

✨ USAGE ✨

Okay so the biggest thing, bestie, listen up: CPCHIL is not to be called by the user. 🚫 Not you. Not me. She's not for us to invoke directly. She gets called several times by CPLBAM and/or CPLBDR while the informational label is positioned and drawn.

The default version of CPCHIL does nothing. Literally nothing. She's just vibing.

But — and this is the fun part — a user-supplied replacement may change attributes such as color and line width (by calling the SPPS routine SETUSV or the appropriate GKS routines). Glow-up time ✨

Wanna get the text of the label? Retrieve it with:

CALL CPGETC ('CTM',CVAL)

Wanna change the text of the label? Do it with:

CALL CPSETC ('CTM',CVAL)

⚠️ but be careful: this should only be done during a call with IFLG = 1 or IFLG = 3, and, if it's done for one of those values, it should be done for the other. Both or neither, no cap. Don't be picking favorites 💀

---

✨ ACCESS ✨

To use CPCHIL, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. Order matters, don't fight it 🌸

---

✨ SEE ALSO ✨

Online: conpack, cpback, cpchcf, cpchcl, cpchhl, 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

like an entire group chat of related routines, and yes you should go say hi to all of them 🦋

---

✨ 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!! 💜 this one dropped way back in March 1993 under the UNIX manual listing, and it's still out here serving CPCHIL(3NCARG) realness. iconic, honestly 👑✨