NGPSWK(3NCARG)

📦 version 6.6.2, in epel 9, fedora 43, fedora 44

💅 NGPSWK 💅

okay bestie, so you know how the NCAR Graphics manual has its own whole thing going on? this page is NGPSWK(3NCARG) from the NCAR GRAPHICS crew, and it's literally the glow-up guide to picking the right PostScript workstation type. ✨

🌸 NAME 🌸

NGPSWK returns the workstation type, suitable for use as the third argument in a call to the NCAR GKS routine GOPWK, for the PostScript workstation whose attributes are specified in the function arguments. that's the whole job. that's the assignment. she's giving "tell me what you want and i'll tell you which number to use." 👑

🎀 SYNOPSIS 🎀

CALL NGPSWK(PSTYPE, ORIENT, COLOR)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_ngpswk(char *pstype, char *orient, char *color)

💖 DESCRIPTION 💖

  • PSTYPE — an input variable of type CHARACTER specifying the type of the PostScript file. it can be one of:
    • 'PS' — regular PostScript
    • 'EPS' — Encapsulated PostScript (can have only a single picture). one pic only, she's monogamous 💀
    • 'EPSI' — Encapsulated PostScript Interchange format (an EPS file containing a preview bitmap)
  • ORIENT — an input variable of type CHARACTER specifying the orientation of the output plot. it can be one of:
    • 'PORTRAIT' — portrait orientation (long side of page is vertical)
    • 'LANDSCAPE' — landscape orientation (long side of the page is horizontal)
  • COLOR — an input variable of type CHARACTER specifying whether the plot will be color or monochrome. it can be one of:
    • 'MONOCHROME' — the plot with be plotted with all graphics objects being plotted using the foreground color.
    • 'COLOR' — the plot will be plotted using color, if available, or intensities obtained from the NTSC color to black-and-white intensity mapping if gray-scale is available.
ngl the "with be plotted" is right there in the source and i'm not fixing it, that's canon, iykyk 🙈

✨ C-BINDING DESCRIPTION ✨

The C binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical, no notes, she's not doing extra work today. 🫶

🌈 USAGE 🌈

In specifying the arguments, only enough characters need be entered so that the values can be differentiated. For example, to specify color, using 'C' as the third argument would be sufficient. Either upper case or lower case is accepted.

so like, you can be lazy on purpose and she'll still understand you. abbreviation is a love language fr fr 💅

🔥 EXAMPLES 🔥

The invocation:

IWK = NGPSWK('EPS', 'LANDSCAPE', 'COLOR')

would return the value "27" for IWK. This is the workstation type that would be used as the third argument in a call to the GKS function GOPWK for a workstation that would produce Encapsulated color Postscript in landscape mode.

twenty-seven. remember her. she's iconic. 🎀

👑 ACCESS 👑

To use NGPSWK or c_ngpswk, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

in that order bestie, i'm not playing, the linker has main character energy and she's picky 😭

💀 MESSAGES 💀

Warning messages will be issued if one calls NGPSWK with unrecognizable arguments. The value 'PS' is used if the first argument is unrecognized; the value 'PORTRAIT' is used if the second argument is unrecognized; the value 'COLOR' is used if the third argument is unrecognized.

so she never crashes out, she just picks defaults for you and quietly judges. lowkey respectful, highkey passive aggressive. 🌸

🧚 SEE ALSO 🧚

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, go forth and pick your workstation type with confidence ✨

this was the UNIX version, dated April 1994, from the NCAR Graphics source — yes she's vintage, no she's not outdated, she ate and left no crumbs 💅🦋

📦 where this page comes from