STSETR(3NCARG)

✨ STSETR ✨

okay bestie, welcome to the NCAR Graphics corner of the universe πŸ¦‹ this one lives in section 3NCARG and it's literally the lil' function that lets you set a REAL parameter. yes, the float girlies are getting their moment πŸ’…


πŸ’– NAME πŸ’–

STSETR β€” sets the value of an internal parameter of type REAL. no cap, that's the whole job description πŸŽ€


🌸 SYNOPSIS 🌸

CALL STSETR (CNM,RVL)

πŸ¦‹ C-BINDING SYNOPSIS πŸ¦‹

#include <ncarg/ncargC.h>

void c_stsetr(char *cnm, float rvl)

✨ DESCRIPTION ✨

  • CNM β€” (CHARACTER, input) the name of the parameter that's about to get a real value dropped on it πŸ‘‘ only the first three characters of CNM are actually examined, so don't waste your breath on the rest (jk, do it for readability, more on that in a sec). those three characters have to be entirely upper case OR entirely lower case β€” mixed case is simply not recognized, it's giving confused energy and the routine will not be picking up what you're putting down πŸ’€
pro tip from the manpage itself: it is recommended that the rest of the character string be used to improve the readability of the code. like, instead of 'DFM', use 'DFM - Differential Magnitude'. do it for the plot. do it for future you 🫢
  • RVL β€” (REAL, input) an expression, and whatever that expression evaluates to is the value that gets handed to the parameter specified by CNM. simple as 🧚

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are the exact same as the FORTRAN argument descriptions. same facts, different syntax, we love a bilingual icon πŸ’œ


πŸ’… USAGE πŸ’…

this routine is your girl for setting the current value of Streamlines parameters of type REAL. if you want the complete list of parameters available in this utility, go read the streamlines_params man page. it's all in there, i promise πŸ“


⭐ EXAMPLES ⭐

use the ncargex command to see the following relevant examples:

  • ffex00
  • ffex03
  • ffex04
  • fstream
  • stex01
  • stex02
  • stex03

go look at them, they ate πŸ”₯


πŸŽ€ ACCESS πŸŽ€

to use STSETR or c_stsetr, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c β€” preferably in that order. order matters bestie, don't be chaotic πŸ™ˆ


πŸ’€ MESSAGES πŸ’€

see the streamlines man page for a description of all Streamlines error messages and/or informational messages. every last one. no skipping 😭


πŸ‘‘ SEE ALSO πŸ‘‘

Online: stgetc, stgeti, stgetr, stinit, stream, streamlines, streamlines_params, strset, stsetc, stseti, stuixy, stumsl, stumta, stumxy, ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version


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


ngl, that license line is doing the most, but we respect it 🫑

and that's the whole page!! this one is from the NCAR GRAPHICS manual, dated April 1993, and the source line said UNIX β€” iconic vintage behavior, slay πŸ’–βœ¨πŸŽ€