AGSETC(3NCARG)

✨ AGSETC ✨

okay bestie, welcome to the NCAR Graphics corner of the manual, page AGSETC(3NCARG). this one's a lil function that lets your program slide a character string in as the value of one specific parameter. it's giving "set and forget" energy 💅

---

🎀 NAME 🎀

AGSETC — allows a user program to (in effect) store a character string as the value of a specified single parameter. that's it, that's the whole vibe.

---

🌸 SYNOPSIS 🌸

CALL AGSETC (TPGN,CUSR)

🌈 C-BINDING SYNOPSIS 🌈

#include <ncarg/ncargC.h>

void c_agsetc (char *tpgn, char *cusr)

---

💖 DESCRIPTION 💖

• TPGN — an input expression of type CHARACTER, and it's a parameter identifier, exactly like the one described for AGSETP, above. here's the catch tho: the parameter you pick must be one of the ones that intrinsically have values of type character. so your options are literally just these four: 'LINE/END.', 'LABEL/NAME.', 'LINE/TEXT.', or 'DASH/PATTERN/n.'. no cap.
• CUSR — an input expression of type CHARACTER, and it's the character string you actually want. but bestie, the rules change depending on what you're setting, so let's break it down:
  • if you're setting 'LINE/END.', only the first character of CUSR gets used. that's it. one (1) character. the rest is just background noise ✨
  • if you're setting 'LABEL/NAME.', the length of the string CUSR gets taken to be "MAX(1,LEN(CUSR))". yes, that's the actual expression, copy it down.
  • if you're setting the text of a label, CUSR has to either be exactly the length specified by 'LINE/MAXIMUM.' (40 characters, by default) or be shorter. and if it is shorter, it has to be terminated by the character defined by 'LINE/END.' — which defaults to a '$'. miss that terminator and it's giving chaos 😭
  • if you're setting a dash pattern, the length of CUSR gets taken to be the minimum of "LEN(CUSR)" and whatever value 'DASH/LENGTH.' says.

🫶 C-BINDING DESCRIPTION 🫶

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same facts, different font. slay.

---

💜 USAGE 💜

this routine lets you set the current value of Autograph parameters. and if you want the complete list of parameters available in this utility, go read the autograph_params man page. it's all in there, i promise.

---

⭐ EXAMPLES ⭐

use the ncargex command to see these relevant examples, bestie:

agex05, agex06, agex07, agex08, agex09, agex13, tagupw, tautog, fagaxlbl, fagovrvw

---

🦋 ACCESS 🦋

to use AGSETC or c_agsetc, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order, don't be chaotic about it.

want smoother curves, drawn using spline interpolation? then also load libdashsmth.o. or, alternatively, you can just use the ncargf77 command to compile your program and load all the libraries above — and then, for those smoother curves, use the -dashsmth option. two paths, both valid, pick your fighter ✨

---

🔥 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, aggetp, aggetr, agpwrt, agrstr, agsave, 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 came straight off the UNIX manual, dated March 1993, so yeah she's vintage and she ate. go set some character strings, you've got this 🫶✨💅