AGSETP(3NCARG)

💖 AGSETP 💖

okay bestie, listen up — this is the NCAR Graphics page for AGSETP, and it's genuinely one of the most useful little routines in the whole Autograph situation. no cap.

---

✨ NAME ✨

AGSETP — it lets your program reset the values of a whole group of parameters, even when that group has one or more elements in it. like, a group. multiple. at once. iconic behavior honestly.

---

🌸 SYNOPSIS 🌸

CALL AGSETP (TPGN,FURA,LURA)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

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

---

💅 DESCRIPTION 💅

TPGN

so TPGN is an input expression of type CHARACTER, and it's a character string shaped like 'k1/k2/ . . . kn.' — where each one of those ki's is a keyword. keyword k1 names a group of parameters, k2 names a subgroup of that group, k3 names a subgroup of that subgroup, and so on forever until you run out of slashes. the whole entire string together is the name of some group of parameters that you, the user, want to set. periodt.

let's get concrete, because examples are everything:

• 'AXIS.' is the name of a 92-word group of parameters describing the four axes 🫶
• 'AXIS/RIGHT.' is the name of a 23-word subgroup describing the right Y axis
• '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
• '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

ngl, these names can sometimes get rather long 😭. but there are various ways to shorten them, and this is the fun part:

1. the fifth-and-beyond trick — since the fifth and following characters of each keyword are ignored, they may be omitted. so this:

'AXIS/RIGHT/INTERSECTION/USER.'

becomes this:

'AXIS/RIGH/INTE/USER.'

2. the even-shorter trick — 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. that would shorten the example above to 'AXI/RI/IN/US.'. slay.
3. the full-omit trick — 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". iykyk.

and guess what — names may also be lengthened in various ways in order 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.')

okay that's genuinely a glow-up ✨

FURA

FURA is an input array of type REAL, dimensioned LURA, and it holds the new values for the parameters in the group specified by TPGN, in the same order as they appear in the group.

⚠️ okay important lore: all parameters have real values — because of a portability problem which arose in implementing the routines AGSETF and AGSETR. not a vibe, but we deal.

• 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. 🎀

LURA

LURA is an input expression of type INTEGER, and it's the length of FURA — like, the number of real elements in it.

its value may be less than, equal to, or greater than the length of the parameter group specified by TPGN. the number of values transferred from FURA is the minimum of the two (but not less than one). which means: if, for example, you only wish to set the first two parameters of a 100-parameter group, you may do so by using LURA = 2. so efficient. main character energy fr fr 👑

---

🧚 C-BINDING DESCRIPTION 🧚

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different language bestie.

---

🌟 USAGE 🌟

this routine allows you to set the current value of Autograph parameters. for a complete list of parameters available in this utility, see the autograph_params man page. go look at it. seriously. 🫶

---

🍓 EXAMPLES 🍓

use the ncargex command to see the following relevant example: agex06.

---

👑 ACCESS 👑

to use AGSETP or c_agsetp, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters, bestie, don't test me.

to get smoother curves, drawn using spline interpolation, also load libdashsmth.o. ✨

or — alternate route — you can use the ncargf77 command to compile your program and load the above libraries, then, to get smoother curves, use the -dashsmth option. two paths, same slay.

---

💌 MESSAGES 💌

see the autograph man page for a description of all Autograph error messages and/or informational messages. if something's wrong, that's where the tea is. ☕

---

🌈 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, 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 was the UNIX version, dated March 1993, filed under AGSETP(3NCARG) — go set some parameters, you absolute icon 💅✨