AGCHNL(3NCARG)

✨ AGCHNL — the NCAR Graphics glow-up page ✨

okay bestie, welcome to the NCAR Graphics corner of the manual, where we're talking about AGCHNL. 💖

---

🌸 NAME 🌸

AGCHNL — it's literally your backstage pass: it lets you swap out the numeric labels Autograph generates for any character string your heart desires. Months, Roman numerals, your cat's name, whatever. No cap.

---

🎀 SYNOPSIS 🎀

SUBROUTINE AGCHNL (IAXS,VILS,CHRM,MCIM,NCIM,IPXM,
+ CHRE,MCIE,NCIE)

---

🦋 DESCRIPTION 🦋

okay so here's the whole cast of characters, and every single one of them matters, so pay attention 🫶

• IAXS — (an input expression of type INTEGER) this is the number of the axis being drawn. And the mapping is iconic in its simplicity: 1, 2, 3, and 4 mean the left, right, bottom, and top axes respectively. Periodt.
• VILS — (an input expression of type REAL) the value that's gonna be represented by the numeric label, expressed in the label system for the axis. 🚨 You must NOT alter the value of VILS. Hands off, bestie. 🚨
• CHRM — (an input variable of type CHARACTER) on entry, this holds the mantissa of the numeric label, exactly as it would look if AGCHNL made zero changes. And here's the little detail that trips people up: if the numeric label includes a "times" symbol, that symbol is represented by a blank in CHRM. (peep IPXM below for the deets 👀) CHRM may be modified. Go off. 💅
• MCIM — (an input expression of type INTEGER) the length of CHRM — as in, the maximum number of characters it can hold. 🚨 The value of MCIM must not be altered. Do not touch. Fr fr. 🚨
• NCIM — (an input variable of type INTEGER) on entry, this is the number of meaningful characters in CHRM. And listen — if you change CHRM, you should change NCIM accordingly. Keep it consistent, bestie, it's giving attention to detail. ✨
• IPXM — (an input variable of type INTEGER) on entry, this is zero if there's no "times" symbol in CHRM. If it's non-zero, then it's the index of a character position in CHRM — that's where the "times" symbol lives. And if AGCHNL changes the position of the "times" symbol in CHRM, removes it, or adds it? Then the value of IPXM must be changed. You gotta keep that index honest. 🙈
• CHRE — (an input variable of type CHARACTER) on entry, this holds the exponent of the numeric label, as it would appear if AGCHNL made no changes. CHRE may be modified. Slay. 🌈
• MCIE — (an input expression of type INTEGER) the length of CHRE — the maximum number of characters it can hold. 🚨 The value of MCIE must not be altered. Nope nope nope. 🚨
• NCIE — (an input variable of type INTEGER) on entry, the number of meaningful characters in CHRE. Same rule as its mantissa sibling: if CHRE is changed, NCIE should be changed accordingly. 💜

---

💅 USAGE 💅

okay this is the part where I hold your hand, bestie, because it's lowkey important:

This routine is not called by the user program. Nope — it's called by Autograph itself, right after the character string representing each numeric label has been generated, and just before it gets written onto the graph. 📝✨

So you're not the one dialing the phone — Autograph is, and you're the one answering. 🫶 You get to change the character string in any desired way. And the payoff? Axes can be labeled using the names of the months, Roman numerals, etc. Main character energy for your graph. 👑

⚠️ Note: a user version of AGCHNL should not call any other Autograph routine. Just don't. It's a boundary thing. 💀

---

🧚 ACCESS 🧚

To use AGCHNL, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. Order matters, iykyk. 🔥

---

👑 SEE ALSO 👑

Online: autograph, agback, agbnch, agchax, agchcu, agchil, agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup, agutol, anotat, displa, ezmxy, ezmy, ezxy, ezy

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.

---

and that's the whole page, bestie 🎀 this one comes to you from the UNIX manual, dated March 1993, filed under AGCHNL(3NCARG) — and yes, we ate. 💅✨🦋