GOPEN_GKS(3NCARG)

📦 version 6.6.2.dfsg.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

gopen_gks — bestie, this is the one that opens the GKS package 💅 like it's the bouncer at the club and GKS isn't getting in until you say so

This page lives in the NCAR GRAPHICS manual, section 3NCARG, iykyk 🎀

🌸 SYNOPSIS 🌸

#include <ncarg/gks.h>

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

💖 DESCRIPTION 💖

  • err_file (Input) — okay so this is the place where error messages get written. Like, where do the complaints go? Here. Typically this should be "stdout". That's it, that's the vibe 🫶
  • mem_unit (Input) — the dimension of an internal buffer, lowkey iconic. Currently in NCAR GKS-0A, mem_unit is ignored. Not me passing a value that literally does nothing 😭 the function said "I'll take it" and then never looked at it again 💀

🦋 USAGE 🦋

So here's the thing bestie, the order matters, no cap. To get output to any workstation, these three have to be called in exactly this order:

  1. gopen_gks
  2. gopen_ws
  3. gactivate_ws

That sequence. In that order. Periodt 👑

BUT — plot twist ✨ — for jobs producing only CGM output, you can skip the whole three-call situation entirely and replace gopen_gks, gopen_ws, and gactivate_ws with a single call to the SPPS function c_opngks(). One call instead of three?? Ate. 💅

🎀 ACCESS 🎀

To use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries. Both. Yes, both. Don't fight it 🌈

💜 SEE ALSO 💜

Online: 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: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

Like, go read the friends, they're all linked up, it's giving a whole friend group 🧚

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
🫶 reminder bestie: the use of this Software is governed by a License Agreement. Read it. Respect it. Slay responsibly. 💖

And that's the page, fr fr 🌸 this was the UNIX version, dated March 1993 (vintage but still main character energy), from GOPEN_GKS(3NCARG) in the NCAR GRAPHICS set. bye bestie, go open some GKS 💅✨

📦 where this page comes from