GOPEN_GKS(3NCARG)

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

πŸ’– NAME πŸ’–

gopen_gks (aka Open GKS) β€” bestie, this is the one that opens the GKS package. First move of the whole graphics era, no cap. ✨

This lil cutie lives in the NCAR GRAPHICS section of the manual, page GOPEN_GKS(3NCARG) if you're keeping receipts. πŸ“–πŸ’…


✨ SYNOPSIS ✨

#include <ncarg/gks.h>

void gopen_gks(const char *err_file, size_t mem_unit);

πŸŽ€ DESCRIPTION πŸŽ€

Okay so she takes two arguments, and here's the tea on both of them:

  • err_file (Input) β€” the place where all the error messages get sent. Typically this should be "stdout". Like, that's the vibe. That's where the drama goes. πŸ—£οΈπŸ’¬
  • mem_unit (Input) β€” the dimension of an internal buffer. But ngl, currently in NCAR GKS-0A, mem_unit is ignored. She's just there. Decorative. A little main character who does nothing. πŸ™ˆ Ignore her back, it's only fair.

🌸 USAGE 🌸

Okay so if you want output to any workstation, you have to call these three in this exact order, bestie. The pipeline is real:

  1. gopen_gks
  2. gopen_ws
  3. gactivate_ws

In that order. Periodt. Don't shuffle them like a playlist, they will not slay out of sequence. πŸ’€

BUT β€” if your job is producing only CGM output, then you can skip the whole three-call ritual and just replace gopen_gks, gopen_ws, and gactivate_ws with a single call to the SPPS function c_opngks(). One call, all the same energy. Efficient queen behavior. πŸ‘‘


πŸ’œ ACCESS πŸ’œ

Wanna use the GKS C-binding routines? Then you gotta load the ncarg_gks and ncarg_c libraries. Both. Load them. That's the toll to get in. 🎟️✨


πŸ¦‹ SEE ALSO πŸ¦‹

Online, the whole friend group, go read them too:

  • gopen_ws(3NCARG)
  • gactivate_ws(3NCARG)
  • gdeactivate_ws(3NCARG)
  • gclose_ws(3NCARG)
  • gclose_gks(3NCARG)
  • gupd_ws(3NCARG)
  • opngks(3NCARG)
  • clsgks(3NCARG)
  • gks(3NCARG)
  • ncarg_gks_cbind(3NCARG)

Hardcopy, for when you want the physical lore:

  • User's Guide for NCAR GKS-0A Graphics
  • 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.

Fr fr, read the License Agreement. It's giving legally binding. πŸ“œπŸ’…

And that's the whole page, bestie β€” sourced from the UNIX manual, dated March 1993, filed under GOPEN_GKS(3NCARG). Iconic then, iconic now. Go open that GKS package. Slay. 🫢🌸✨

πŸ“¦ where this page comes from