SPPS_params(3NCARG)

✨ SPPS_params ✨ (the NCAR Graphics manual, bestie edition)

okay so this is SPPS_params from the NCAR GRAPHICS manual pages, and it's literally just the full rundown of every internal parameter of SPPS. no cap, every single one. let's go 🫢


🌸 NAME 🌸

SPPS_params β€” this document briefly describes all of the internal parameters of SPPS. yes, all of them. we're not skipping a single one, babe.


πŸ’… DESCRIPTION πŸ’…

So when you call GETUSV and SETUSV β€” those are the routines that reach into SPPS's internal parameters and grab them or set them β€” the arguments VN and IV work like this:

  • VN β€” an input constant or variable of type CHARACTER, and it's the name of a parameter. Only the first two characters actually matter, so don't stress about the rest. And remember, in FORTRAN, a constant of type CHARACTER is a string of characters wrapped in apostrophes. periodt.
  • IV β€” an input or output value of type INTEGER. It's either the current value of the parameter named by VN getting returned to you, or the new value you want that parameter to have. and like… here's the whole table, okay, stay with me:

πŸŽ€ Parameter Name (VN) β€” the live ones πŸŽ€

  • 'LS' β€” Axis scaling (the "Log Scaling" flag). Possible values of IV:
    • 1 = linear X, linear Y
    • 2 = linear X, log Y
    • 3 = log X, linear Y
    • 4 = log X, log Y
  • 'MI' β€” Axis direction reversal (the "MIrroring" flag β€” meaning the axis goes from maximum to minimum rather than min to max). Possible values of IV:
    • 1 = neither X nor Y
    • 2 = X, but not Y
    • 3 = Y, but not X
    • 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

Both 'LS' and 'MI' are normally set by calling the routine SET, but lowkey you can set them independently by calling SETUSV. main character energy, honestly.

The parameter 'MU' is set, prior to calling OPNGKS, to change the FORTRAN logical unit number to be used by GKS for metacode output.

The parameter 'PB' sets the size of the SPPS polyline buffer. And heads up β€” the value "2" effectively turns buffering off. just so you know πŸ’€

🌈 Obsolete parameters (gone but not forgotten) 🌈

  • '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)

The values of the parameters 'XF' and 'YF' are the same as the values of the arguments IX and IY in calls to the routines SETI and GETSI.

The parameters 'IR', 'IG', 'IB', 'IM', 'IN', and 'II' were all part of a color-setting scheme meant to allow overall intensity to be set independently of color. That scheme is now obsolete β€” it's been replaced by normal GKS color setting through the routines GSCR, GSPLCI, GSFACI, GSPMCI, and GSTXCI. The corresponding GKS inquiry routines to determine current color settings are GQCR, GQPLCI, GQFACI, GQPMCI, and GQTXCI. See Section 6 of "User's Guide for NCAR GKS-0A Graphics."

The parameter 'LW' is replaced by the GKS line width scale factor routine, GSLWSC, which has the corresponding query function GQLWSC.

The parameter 'MS' is replaced by the GKS marker size scale factor routine, GSMKSC, which has the corresponding query function GQMKSC.


πŸ¦‹ USAGE πŸ¦‹

Values of SPPS parameters are set by calling the routine SETUSV and retrieved by calling the routine GETUSV. that's it. that's the whole vibe. πŸ’–


⭐ SEE ALSO ⭐

Online: gscr,gsplci, gsfaci, gspmci, gstxci, gsmksc, gslwsc, spps, getset, getsi, getusv, plotif, set, setsi, setusv

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


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 dropped way back in March 1993 on UNIX, and it's still out here repping SPPS_params(3NCARG) in the NCAR Graphics manual. iconic behavior, fr fr. go set some parameters, you got this πŸ’œβœ¨