AGGETP(3NCARG)

💖 AGGETP — bestie edition 💖

ok so you're in the NCAR Graphics / Autograph corner of the world and you need to get a whole group of parameters at once? That's this one, bestie. AGGETP pulls the current values of a group of parameters that has one or more elements. no cap.

---

✨ NAME ✨

AGGETP — lets your program grab the values of a group of parameters containing one or more elements. it's giving "gimme the whole group, not just one lil guy" 🫶

---

✨ SYNOPSIS ✨

CALL AGGETP (TPGN,FURA,LURA)

---

✨ C-BINDING SYNOPSIS ✨

#include <ncarg/ncargC.h>

void c_aggetp (char *tpgn, float *fura, int lura)

---

✨ DESCRIPTION ✨

• TPGN — an input expression of type CHARACTER. It's a character string shaped like 'k1/k2/ . . . kn.', where every ki is a keyword. The keyword k1 names a group of parameters, k2 names a subgroup of that group, k3 a subgroup of that subgroup, and so on forever and ever. The whole string is the name of some group of parameters you want to get at. periodt.

So like, for example, 'AXIS.' is the name of a 92-word group of parameters describing the four axes, and 'AXIS/RIGHT.' is the name of a 23-word subgroup describing the right Y axis. Then

'AXIS/RIGHT/INTERSECTION.'

is the name of a 2-word further subgroup describing the intersection of the right Y axis with the bottom of the grid window, and

'AXIS/RIGHT/INTERSECTION/USER.'

is the name of a single parameter specifying the point of intersection of the right Y axis with the bottom of the grid window as an X coordinate in the user coordinate system. icon behavior honestly. 👑

Obviously these names can sometimes get rather long. no shade, it's just how it is. There are various ways to shorten them:

1. Since the fifth and following characters of each keyword are ignored, you can just omit them. That would shorten

'AXIS/RIGHT/INTERSECTION/USER.'

to

'AXIS/RIGH/INTE/USER.'

2. Even fewer characters may be used, as long as no ambiguity of interpretation arises. To be completely safe, use at least the first three characters of the group keyword and at least the first two characters of each subgroup keyword; this would shorten the example above to 'AXI/RI/IN/US.'. 💅
3. Moreover, certain group and subgroup keywords may be omitted entirely; for example, 'AXI/RI/IN/US.' may be shortened to 'RI/IN/US.'. Keywords which may be entirely omitted are enclosed in brackets in the headings in the section "PARAMETERS".

Names may also be lengthened in various ways to improve their readability. Blanks may be used as desired on either side of a keyword. Any sequence of characters not including a slash or a period may be inserted after a keyword, separated from it by at least one blank. For example, the name

'DASH PATTERN / CHARACTER WIDTH .'

is equivalent to, and considerably more meaningful than,

'DAS/CH.' (or even 'DASH/CHARACTER.')

see, glow-up ✨

• FURA — an input array of type REAL, dimensioned LURA, containing new values for the parameters in the group specified by TPGN, in the same order as they appear in the group. All parameters have real values (because of a portability problem which arose in implementing the routines AGSETF and AGSETR — not our fault, bestie, it's a legacy thing 💀). Those which represent intrinsically integral quantities have a value of the form "FLOAT(n)", where "n" is the integral quantity being represented. Some parameters intrinsically take on character-string values; the real quantity stored as the value of such a parameter is typically an identifier allowing for later retrieval of the character string from a character storage area inside Autograph. The routines AGSETC and AGGETC may be used to set/get the character-string values of such parameters. iykyk 🎀
• LURA — an input expression of type INTEGER, the length of FURA. Its value may be less than, equal to, or greater than the length of the group specified by TPGN. The number of values transferred into FURA is the minimum of the two (but not less than one). You may, for example, get the first two parameters of a 100-parameter group by using LURA = 2. slay, partial grabs are valid. 🍓

---

✨ C-BINDING DESCRIPTION ✨

The C-binding argument description is the same as the FORTRAN argument description. literally the same, fr fr. 🌈

---

✨ USAGE ✨

This routine allows you to retrieve the current value of Autograph parameters. For a complete list of parameters available in this utility, see the autograph_params man page. go read it, bestie, it's the lore. 📖

---

✨ ACCESS ✨

To use AGGETP or c_aggetp, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters, no cap.

To get smoother curves, drawn using spline interpolation, also load libdashsmth.o. Or, you can use the ncargf77 command to compile your program and load the above libraries, then, to get smoother curves, use the -dashsmth option. smooth curves = main character energy 🦋

---

✨ MESSAGES ✨

See the autograph man page for a description of all Autograph error messages and/or informational messages. if something's screaming at you, that's where the answers live 😭

---

✨ SEE ALSO ✨

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

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

the whole friend group 💖

---

✨ COPYRIGHT ✨

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

---

ok so that's the whole page, you ate it, you read it, you understood it. the whole squad: AGGETP 💖 ✨ 🎀 🦋 🌸 💅 🫶 😭 🔥 👑 🌈 ⭐ 💀 🙈 🍓 🧚 💜

this was AGGETP from the NCAR GRAPHICS manual, and this particular page was living under the UNIX volume, dated March 1993. vintage but still iconic, fr fr.