GOPWK(3NCARG)

✨ GOPWK — okay bestie, let's open a workstation 💖

so this is GOPWK from NCAR GRAPHICS (that's the manual, the NCARG one, hi 👋). Full name of the vibe? Open workstation. Yeah. It opens a GKS workstation. That's it, that's the job. 🎀

---

🌸 SYNOPSIS 🌸

CALL GOPWK (WKID, CONID, WKTYPE)

---

🦋 C-BINDING SYNOPSIS 🦋

like, if you're in C, you're calling this instead:

#include <ncarg/gks.h>

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

---

💅 DESCRIPTION 💅

okay so here are your three inputs, and yes you have to give all three, no skipping:

• WKID — (Integer, Input) — this is the little name tag 🏷️ you give your workstation. Every single GKS function that needs to know which workstation you mean will ask for this number later, so remember it. And in NCAR GKS? WKID can be any non-negative integer. any. go feral.
• CONID — (Integer, Input) — the connection identifier. bestie, this one is a shapeshifter: it means completely different things depending on which workstation type you picked. the whole tea is in the USAGE section below, don't skip it. 👀
• WKTYPE — (Integer, Input) — tells GKS which kind 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, in all their glory:
  • 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.

twenty-one flavors of workstation, we love a menu 😌✨

---

🌈 USAGE 🌈

okay this is where CONID finally explains itself. buckle up.

🍓 types 1 (CGM) and 3 (WISS)

for workstation types 1 (CGM) or 3 (WISS), the connection ID is used as a Fortran logical unit number.

you can have at most one workstation of type 1 open at a time, and the same rule applies to workstations of type 3. (one each. that's the limit. respect it 💀)

but — plot twist — you can have workstations of types 1 and 3 open simultaneously, and they must have distinct connection IDs. so like, share the love but not the unit number.

🫶 also: to use the GFLASH package or any GKS segmentation functions, WISS must be opened first. opening order matters, bestie, it's giving prerequisite.

🧚 type 7

for workstations of type 7, the connection ID is the X11 window ID for the existing window (you can grab it from xwininfo, for example). it's a pre-existing window, so you gotta hand over its ID. periodt.

💜 type 8

for workstations of type 8, an X11 window gets created at open-workstation time. so the connection ID is irrelevant for type 8. just pass whatever, it's not the moment.

⭐ type 10

for workstations of type 10, the ASCII text is written to standard output and the connection ID is irrelevant here too. text dump goes brrr onto stdout.

---

💀 and the ceiling: there can be a maximum of fifteen simultaneously open workstations of all types. fifteen. that's the whole budget, across every type combined. no cap.

---

👑 ACCESS 👑

to use GKS routines, load the NCAR GKS-0A library: ncarg_gks.

---

🌸 SEE ALSO 🌸

Online: gopks, gacwk, gdawk, gclwk, gclks, opngks, clsgks, gopen_ws

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.

---

and that's the whole page, bestie 🎀 this one's a UNIX manpage, GOPWK(3NCARG), dated March 1993 — iconic, vintage, still slaying. go open that workstation. ✨🦋💅