ANOTAT(3NCARG)

💅 ANOTAT — the NCAR Graphics glow-up page (3NCARG) 💅

okay bestie, so this is ANOTAT, from the NCAR Graphics crew. What it does? It changes the values of certain primary control parameters, purportedly having to do with "annotation" of a graph. yes the original really says "purportedly". iconic. we love a self-aware manpage. 🎀

---

✨ SYNOPSIS ✨

ANOTAT (XLAB,YLAB,LBAC,LSET,NDSH,DSHC)

---

🌈 C-BINDING SYNOPSIS 🌈

#include <ncarg/ncargC.h>

void c_anotat(char *xlab, char *ylab, int lbac, int lset, \
int ndsh, char *dshc[])

---

🦋 DESCRIPTION 🦋

let's go through the args one by one, no skips, we're thorough here 💖

• XLAB — an input expression of type CHARACTER, and it defines a new "x-axis label". (careful babes: if the first character of this expression is "CHAR(0)", then no new "x-axis label" gets defined and the current one just keeps on keeping on.) A character string defining a new X-axis label must either be of the exact length specified by the current value of 'LINE/MAXIMUM.' (default: 40 characters), or shorter; if shorter, it must be terminated by the character defined by the current value of 'LINE/END.' (default: a '$'). The string becomes the new text of line number -100 of the label 'B'.
• YLAB — an input expression of type CHARACTER, defining a new "y-axis label". (same deal as above: if the first character is "CHAR(0)", no new "y-axis label" is defined and the current one stays.) A character string defining a new Y-axis label must either be of the exact length specified by the current value of 'LINE/MAXIMUM.' (default: 40 characters), or shorter; if shorter, it must be terminated by the character defined by the current value of 'LINE/END.' (default: a '$'). The string becomes the new text of line number 100 of the label 'L'.
• LBAC — an input expression of type INTEGER. If it's non-zero, it must have the integer value 1, 2, 3, or 4, and the real equivalent of that becomes the new value of 'BACKGROUND.'. (If LBAC is zero, nothing changes, the current value just vibes.) So: value 1 = a perimeter background, value 2 = a grid background, value 3 = a half-axis background, and value 4 = no background at all. 💀

go read the discussion of 'BACKGROUND.' in the autograph_params man page, iykyk.

• LSET — an input expression of type INTEGER. If it's non-zero, it must have the absolute value 1, 2, 3, or 4, and the real equivalent of that gets stored (by means of a call to AGSETI) as the new value of 'SET.'. If LSET is zero, no change is made to the current value of 'SET.'.

again, the discussion of 'SET.' lives in the autograph_params man page. go look. 🫶

• NDSH — an input expression of type INTEGER. If it's zero, that means no change is to be made in the parameters which specify the dashed-line patterns to be used for curves.
  • If NDSH is non-zero, it specifies an integer value whose real equivalent is to be stored as the new value of 'DASH/ SELECTOR.' (which has the default value "1.").
  • If NDSH is negative, 'DASH/SELECTOR.' is set negative, forcing EZMY and EZMXY to use internally-defined "alphabetic" patterns for the MANY curves drawn ("A" for the first, "B" for the second, . . ., "Z" for the 26th, "A" for the 27th, etc.). The routines EZY and EZXY are unaffected. 🚫
  • If NDSH is greater than zero, it must be less than or equal to 26, and the next argument, DSHC, must contain NDSH dashed-line patterns comprising the new "user" set of patterns. The fact that 'DASH/SELECTOR.' is set positive forces EZMY and EZMXY to use this set of patterns. (The routines EZY and EZXY always use the first pattern in this set.) The contents of the array DSHC are copied to storage local to Autograph and pointers to them are installed as the values of 'DASH/PATTERNS/1.', '.../2.', etc.

and yes, see the discussion of 'DASH.' in the autograph_params man page. it's a whole thing. 💅

• DSHC — an input array of type CHARACTER, dimensioned NDSH. It's meaningful only when NDSH is greater than zero. In this case, it must be an array of NDSH character strings, each of the length specified by the current value of 'DASH/ LENGTH.'. Each character string represents a dashed-line pattern; dollar signs mean "pen down", quotes mean "pen up", and other characters mean "draw me". ✏️✨

you already know what I'm gonna say. discussion of 'DASH.', autograph_params man page. go bestie.

---

🌸 C-BINDING DESCRIPTION 🌸

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different syntax, we love consistency. 💜

---

⭐ USAGE ⭐

This routine sets internal parameter values. For a complete list of parameters available in this utility, see the autograph_params man page.

---

🎀 EXAMPLES 🎀

Use the ncargex command to see the following relevant examples: agex08, agex10, agex13, bnchmk, sprevx.

---

👑 ACCESS 👑

To use ANOTAT or c_anotat, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. yes the order matters, don't be chaotic. 🙈

---

🔥 SEE ALSO 🔥

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

---

🫶 COPYRIGHT 🫶

Copyright (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.

---

that's the whole page bestie, you ate that 💅✨ this was the UNIX version, dated March 1993, straight from the NCAR Graphics archives — stay iconic, go annotate a graph, mwah 🎀🦋