GETUSV(3NCARG)

💖 GETUSV — bestie edition 💖

okay so this is GETUSV from the NCAR Graphics crew (the 3NCARG manual, if we're being official ✨), and it's literally just: you ask, it tells you. it's giving "what's the vibe of this internal SPPS parameter rn" and honestly? iconic.

---

✨ NAME ✨

GETUSV — grabs the value of one of the internal parameters of SPPS. that's it. that's the whole job. 🫶

---

🌸 SYNOPSIS 🌸

CALL GETUSV (VN,IV)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_getusv (char *vn, int *iv)

---

💅 DESCRIPTION 💅

okay so the two args, let's get into it:

• VN — an input constant or variable of type CHARACTER, and it's the name of a parameter. and listen, only the first two characters are meaningful, so don't be out here writing a whole novel in there. also reminder bestie: in FORTRAN, a constant of type CHARACTER is just a string of characters wrapped in apostrophes. that's the rule. 👑
• IV — an output variable of type INTEGER, and it comes back holding the current value of the parameter that VN pointed at. which parameters, you ask? say less:

the live parameters, in all their glory:

• 'LS' — Axis scaling (the "Log Scaling" flag). possible values of IV:
  1. 1 = linear X, linear Y
  2. 2 = linear X, log Y
  3. 3 = log X, linear Y
  4. 4 = log X, log Y
• 'MI' — Axis direction reversal (the "MIrroring" flag — axis runs from maximum to minimum rather than min to max). possible values of IV:
  1. 1 = neither X nor Y
  2. 2 = X, but not Y
  3. 3 = Y, but not X
  4. 4 = both X and Y
• 'MU' — Metacode output Unit. possible value of IV: 2
• 'PB' — Pen-move Buffer size. possible values of IV: 2 to 50

and now the lore 📖:

• both 'LS' and 'MI' are normally set by calling the routine SET, but lowkey you can also set them independently by calling SETUSV. your call bestie.
• 'MU' gets set prior to calling OPNGKS, and it changes the FORTRAN logical unit number that GKS uses for metacode output.
• 'PB' sets the size of the SPPS polyline buffer. and heads up: the value "2" effectively turns buffering off. no buffer, no problem. 💀

the obsolete parameters (aka the throwbacks, retired but still on the roster):

• 'XF' — X axis exponent for plotter coordinates. (the PAU range would be 1 to 2**XF - 1 in X)
• 'YF' — Y axis exponent for plotter coordinates. (the PAU range would be 1 to 2**YF - 1 in Y)
• 'IR' — Red color intensity (relative to green and blue)
• 'IG' — Green color intensity (relative to red and blue)
• 'IB' — Blue color intensity (relative to red and green)
• 'IM' — Maximum color index to be used
• 'IN' — Overall color intensity
• 'II' — Restore color index
• 'LW' — Line width scale factor in thousandths (2000 means double the default line width)
• 'MS' — Marker size in thousandths (2000 means double the default marker size)

more lore, because there's always more:

• the values of 'XF' and 'YF' are the same as the values of the arguments IX and IY in calls to the routines SETI and GETSI. same energy, different name. ✨
• 'IR', 'IG', 'IB', 'IM', 'IN', and 'II' were all part of a color-setting scheme meant to let you set overall intensity independently of color. that scheme is now obsolete — it got replaced by normal GKS color setting through the routines GSCR, GSPLCI, GSFACI, GSPMCI, and GSTXCI. and if you wanna inquire about current color settings, the corresponding GKS inquiry routines are GQCR, GQPLCI, GQFACI, GQPMCI, and GQTXCI. see Section 6 of "User's Guide for NCAR GKS-0A Graphics." 📚
• 'LW' is replaced by the GKS line width scale factor routine, GSLWSC, which has the corresponding query function GQLWSC. glow-up achieved. 💅
• 'MS' is replaced by the GKS marker size scale factor routine, GSMKSC, which has the corresponding query function GQMKSC. also glow-up. 💅

---

🎀 C-BINDING DESCRIPTION 🎀

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. no notes. copy-paste energy but make it official. 😌

---

⭐ EXAMPLES ⭐

use the ncargex command to see the following relevant examples: (none).

yeah. none. nothing. empty. the void. we simply have no examples for you bestie, go read the other pages. 🙈

---

🌈 ACCESS 🌈

to use GETUSV or c_getusv, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters, don't fight it. 👑

---

👑 SEE ALSO 👑

Online: gqcr, gqplci, gqfaci, gqpmci, gqtxci, gqmksc, gqlwsc, spps, spps_params, getset, getsi, plotif, set, setsi, setusv, ncarg_cbind

Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

---

💜 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 page bestie!! 🫶 this lil' slice of NCAR Graphics history comes to you from the UNIX manual, dated March 1993, on the GETUSV(3NCARG) page. yeah it's older than most of us and it still ate. periodt. 💖✨🎀