PCSETR(3NCARG)

πŸ“¦ version 6.6.2, in epel 9, fedora 43, fedora 44

πŸ’– PCSETR β€” the NCAR Graphics girlie's guide πŸ’–

okay so bestie, welcome to PCSETR from the NCAR Graphics manual (3NCARG, she's an icon, she's been serving since 1987 ✨). This one's short and sweet: it sets an internal parameter. That's it. That's the whole vibe. But let's do it properly because we don't do sloppy here πŸ’…


✨ NAME ✨

PCSETR β€” sets the value of an internal parameter of type REAL or INTEGER. fr fr, that's the job description 🫢


🌸 SYNOPSIS 🌸

CALL PCSETR (PNAM,RVAL)

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

#include <ncarg/ncargC.h>

void c_pcsetr (char *pnam, float rval)

πŸ’œ DESCRIPTION πŸ’œ

  • PNAM β€” an input constant or variable of type CHARACTER, and it's the name of the parameter you're setting. The way this works: the name has to show up as the first two characters of the string. Now if the internal parameter you're after is one of the two array ones (BC and CC), you can also drop the index of the array element you want, wrapped in parentheses, starting in column 3 and onward πŸ‘‘. And here's the cute part β€” the leftover characters are yours to use as documentation for what that parameter is doing. Like, instead of just MA you can write MA - MAPPING FLAG, and instead of CC(10) you can write CC(10) - SPECIAL COLOR 10. Lowkey a little self-documenting moment, we love that for us 🌈
  • RVAL β€” an input expression of type REAL, and it's the value getting assigned to whatever internal parameter PNAM points at. Here's the tea tho: if that internal parameter is of type REAL, the value it gets is RVAL. But if the internal parameter is of type INTEGER, then what it actually gets is INT(RVAL). No cap, it just truncates like that πŸ™ˆ

πŸ’… C-BINDING DESCRIPTION πŸ’…

The C-binding argument descriptions are literally the same as the FORTRAN argument descriptions. Same energy, different wrapper πŸŽ€


🌟 USAGE 🌟

This routine lets you set the current value of Plotchar parameters. And if you want the complete list of parameters available in this utility, go read the plotchar_params man page β€” she has the full menu, bestie, go check her out πŸ’–


πŸ“ EXAMPLES πŸ“

Use the ncargex command to see the following relevant examples: elblba, cbex01, epltch, tconpa, tlblba, fpcfonts, fpchiqu. Seven of them. Go look, they ate πŸ”₯


πŸ‘‘ ACCESS πŸ‘‘

To use PCSETR or c_pcsetr, you load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c β€” and preferably in that order, okay? In that order. Trust the process 🫢


πŸ’€ MESSAGES πŸ’€

See the plotchar man page for a description of all Plotchar error messages and/or informational messages. If something's wrong, she'll tell you ✨


🌈 SEE ALSO 🌈

Online: plotchar, plotchar_params, pcdlsc, pcgetc, pcgeti, pcgetr, pchiqu, pcloqu, pcmequ, pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, 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.


okay that's the whole page bestie, you're officially a PCSETR expert, main character energy only πŸ’–βœ¨πŸ¦‹

signing off from the UNIX manual, March 1993, page PCSETR(3NCARG) β€” yeah she's vintage but she's still serving πŸ‘‘πŸ’…πŸŽ€

πŸ“¦ where this page comes from