GCLRWK(3NCARG)

✨ GCLRWK ✨ (aka the "Clear Workstation" era)

okay bestie, sit down, hydrate, and let me tell you about GCLRWK from the NCAR GRAPHICS collection 💖 this is a 3NCARG manual page and it's literally the little routine that goes "clear the screen, girl" so your workstation can start fresh 🧼✨

---

🌸 NAME 🌸

GCLRWK (Clear workstation) — clears a workstation. that's it. that's the whole job. and she does it flawlessly 💅

---

🎀 SYNOPSIS 🎀

CALL GCLRWK (WKID, COFL)

two arguments, no drama, we love a low-maintenance queen 👑

---

🦋 C-BINDING SYNOPSIS 🦋

for my C girlies, she also has a glow-up version:

#include <ncarg/gks.h>

void gclear_ws(Gint ws_id, Gctrl_flag  ctrl_flag);

same energy, different syntax, and yes the double space before ctrl_flag is exactly how it's written, don't come for me 🙈

---

✨ DESCRIPTION ✨

let's meet the cast 🌈

• WKID — (Integer, Input) — a number identifying the workstation to be cleared. IMPORTANT: WKID must be the same as that used in some previous GOPWK call. like, she needs to know who she's clearing, bestie. no stranger danger clears 🫶
• COFL — (Integer, Input) — clear the workstation display surface. the options are:
  • 0 — check to see if the display surface is empty. If so, do not issue a clear surface command. she's polite, she checks first, she doesn't do unnecessary work 💅
  • 1 — issue a clear surface command whether the surface has been written to or not. she's gonna clear it regardless. no questions asked. main character energy 🔥

---

💜 USAGE 💜

okay this is the part where it gets ✨workstation-type-specific✨ so pay attention, iykyk:

• for workstations of type "1" (CGM), GCLRWK is interpreted as a picture termination in CGM generation. so if COFL = 0 and no output primitives have been written in the current picture, then a call to GCLRWK is a "do nothing"; otherwise, it generates an END PICTURE element (as well as other picture initializing elements). and if COFL = 1, then a call to GCLRWK generates an END PICTURE. periodt 💫
• for workstations of types "7" or "8" (see the man page for GOPWK for a description of workstation types — yes bestie, go read it, it's giving essential lore 📖), clear workstations erases all primitives that appear on the screen. every single one. wiped. gone. iconic 🧽
• for all other workstation types, clear workstation simply updates the workstation. chill. lowkey. no notes 🌸

---

👑 ACCESS 👑

to use GKS routines, load the NCAR GKS-0A library ncarg_gks. that's the whole key to the kingdom, go get it 🗝️✨

---

🌟 SEE ALSO 🌟

Online besties: gopwk, gacwk, gdawk, gclwk, gclear_ws

Hardcopy besties: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

go read those too, they're part of the family 🫶

---

💖 COPYRIGHT 💖

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.

---

fr fr, that license agreement is not optional. respect it like you respect a COFL = 1 clear command 😤

and that's the whole page, bestie 🎀 this was GCLRWK(3NCARG) from the NCAR Graphics collection, straight outta UNIX, dated March 1993 — vintage but she ate and left no crumbs 💅✨ bye love u, go clear a workstation 🦋