GOPEN_WS(3NCARG)

✨ GOPEN_WS 💖 (aka Open workstation)

okay bestie, so this is a page from the NCAR GRAPHICS manual, and the function is gopen_ws — which literally just opens a GKS workstation. that's the whole job. it's giving "small but mighty" 💅

---

🎀 SYNOPSIS 🎀

#include <ncarg/gks.h>

void gopen_ws(Gint ws_id, const char *conn_id, Gint ws_type);

---

🌸 DESCRIPTION 🌸

• ws_id (Input) — bestie this is just a number you're assigning to a workstation, like a little name tag 🏷️ so you can refer back to it. every single subsequent call to a GKS function that needs a workstation identifier is gonna use this. in NCAR GKS, ws_id can be any non-negative integer. periodt.
• conn_id (Input) — a connection identifier, and no it does NOT mean the same thing for every workstation type. it's lowkey a chameleon 🦎 (check the USAGE section below, i got you).
• ws_type (Input) — this one says which specific type of output device you're targeting. every GKS package has its own implementation-dependent set of workstation types it supports. the legal ones in NCAR GKS are:
  • 1 — NCGM
  • 3 — WISS
  • 7 — pre-existing X11 window.
  • 8 — non-existing X11 window.
  • 10 — text dump of graphics output.
  • 11 — PDF in portrait mode.
  • 12 — PDF in landscape mode.
  • 20 — color PostScript in portrait mode.
  • 21 — color Encapsulated PostScript (EPS) in portrait mode.
  • 22 — color Encapsulated PostScript Interchange format (EPSI) in portrait mode.
  • 23 — monochrome PostScript in portrait mode.
  • 24 — monochrome Encapsulated PostScript (EPS) in portrait mode.
  • 25 — monochrome Encapsulated PostScript Interchange format (EPSI) in portrait mode.
  • 26 — color PostScript in landscape mode.
  • 27 — color Encapsulated PostScript (EPS) in landscape mode.
  • 28 — color Encapsulated PostScript Interchange format (EPSI) in landscape mode.
  • 29 — monochrome PostScript in landscape mode.
  • 30 — monochrome Encapsulated PostScript (EPS) in landscape mode.
  • 31 — monochrome Encapsulated PostScript Interchange format (EPSI) in landscape mode.

---

🦋 USAGE 🦋

• for workstation types of 1 (CGM) the connection ID is the name of the CGM file. and bestie, you can have at most one workstation of type 1 open at a time. one. that's it. 🙈
• for workstations of type 3 (WISS) the connection ID is irrelevant. you can have at most one workstation of type 3 open. you CAN have workstations of types 1 and 3 open simultaneously, and they must have distinct connection IDs. also — if you wanna use the GFLASH package or any GKS segmentation functions, WISS must be opened first. no skipping the line 🎟️
• for workstations of type 7 the connection ID is the X11 window ID for the existing window. pass that number as a string, okay? like, "3" for an X11 window ID of 3. quotes matter, bestie ✨
• for workstations of type 8 an X11 window gets created at open workstation time. the connection ID is irrelevant for type 8.
• for workstations of type 10, the ASCII text is written to standard output, and the connection ID is irrelevant.

🚨 heads up: there can be a maximum of fifteen simultaneously open workstations of all types. fifteen. that's your whole roster. no more main characters. 💀

---

🔑 ACCESS 🔑

to use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries. that's the whole vibe check. 🫶

---

👀 SEE ALSO 👀

• Online: gopen_gks(3NCARG), gactivate_ws(3NCARG), gdeactivate_ws(3NCARG), gclose_ws(3NCARG), gclose_gks(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

---

💜 COPYRIGHT 💜

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, you ate that 🍓 and just so you know the source vibe on this one is UNIX, dated March 1993 — yeah she's an elder icon but she still slays 👑💖 bye bestie!!