CPSCAE(3NCARG)

💖 CPSCAE 💖 — the NCAR Graphics one (man page section 3NCARG)

okay bestie, sit down, hydrate, because we're talking about CPSCAE from NCAR GRAPHICS. ✨

---

🌸 NAME 🌸

CPSCAE — the little routine that gets called over and over again by CPCICA while it's doing its thing. It updates one specific element of your cell array. And here's the slay part: the default version of CPSCAE can be replaced by you with a version that does something completely different. main character energy fr fr. 👑

---

✨ SYNOPSIS ✨

CALL CPSCAE (ICRA, ICA1, ICAM, ICAN, XCPF, YCPF, XCQF,
+ YCQF, IND1, IND2, ICAF, IAID)

---

🦋 DESCRIPTION 🦋

So the first eight arguments of CPSCAE are literally just describing your cell array, and they come straight from your own call to CPCICA. no middleman, no drama. 💅

• ICRA — (INTEGER array, dimensioned ICA1 by "n", where "n" is greater than or equal to the value of the argument ICAN, input/output) this is your cell array, bestie. Generally speaking, a user version of CPSCAE should only reset the value of the single element ICRA(IND1,IND2). just the one. one element. that's the vibe. 🎀
• ICA1 — (INTEGER, input) the first dimension of the FORTRAN array ICRA, which contains your cell array.
• ICAM — (INTEGER, input) the first dimension of your cell array.
• ICAN — (INTEGER, input) the second dimension of your cell array.
• XCPF and YCPF — (REAL, input) the coordinates, in the fractional coordinate system, of a point P. And P is the point at that corner of the rectangular area into which the cell array maps that corresponds to the cell (1,1). iykyk 📍
• XCQF and YCQF — (REAL, input) the coordinates, in the fractional coordinate system, of a point Q. And Q is the point at that corner of the rectangular area into which the cell array maps that corresponds to the cell (ICAM,ICAN). so P and Q are the two opposite corners, iconic. 📐
• IND1 and IND2 — (INTEGER, input) the indices of an element in the cell array that is to be reset. the chosen one. ⭐
• ICAF — (INTEGER, input) the value of the internal parameter 'CAF', which will be a negative integer (because, when 'CAF' is greater than or equal to zero, the routine CPSCAE is not called at all — it's giving ghosted 👻). Different values of 'CAF' may be used in a user version of CPSCAE to select different schemes for picking color indices. choose your fighter. 🌈
• IAID — (INTEGER, input) the value of the area identifier associated with the midpoint of the cell (IND1,IND2). The four possibilities are as described for the routine CPCICA. go read that one too, bestie. 🫶

---

💅 USAGE 💅

okay so real talk: CPSCAE is not called by the user. like, at all. nope. 🙈

When a user calls the routine CPCICA and the internal parameter 'CAF' is negative, CPSCAE is called by CPCICA exactly once for each cell in the cell array. every single one. no skips. 💯

The default version of CPSCAE just sets the cell's color index equal to the area identifier associated with the cell, if that area identifier is greater than or equal to zero; otherwise, it does nothing. literally nothing. it's at peace. 😌

A user-supplied version of CPSCAE may do something more complicated; for example, it may take into account both the value of the area identifier associated with the cell and the current value of the color index for the cell in determining the new value of the color index for the cell. now that's the level of customization we're talking about. 🔥

---

👑 ACCESS 👑

To use CPSCAE, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters bestie, don't play. 🎀

---

🌈 SEE ALSO 🌈

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

the whole friend group. go say hi. 🦋

---

📜 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 🫶 this one's from the UNIX manual, dated March 1993, and it lives under CPSCAE(3NCARG) — version vibes from way back, still serving. periodt. 💖✨