GUWK(3NCARG)

✨ NAME ✨

GUWK (aka Update workstation) — bestie, this one makes sure your workstation is current and actually reflects all the requests you've been throwing at it. Like a vibe check for your graphics state. 💅

🌸 SYNOPSIS 🌸

CALL GUWK(WKID,REGFL)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/gks.h>

void gupd_ws(Gint ws_id, Gupd_regen_flag upd_regen_flag);

💖 DESCRIPTION 💖

• WKID (Integer, Input) — the number that IDs the workstation you wanna update. And listen, WKID has to be the exact same number you used in some previous GOPWK call. No random numbers, no improvising, okay? 😭
• REGFL (Integer, Input) — a flag that says whether the current picture should be regenerated. The possible values are literally just "0" for postpone and "1" for perform. And for the workstation types supported in NCAR GKS? This flag should always be set to "0". Always. Every time. Periodt. 👑

🎀 USAGE 🎀

Okay so calling GUWK flushes all the GKS buffers, which brings the workstation up to date. That's the whole point. ✨

But heads up bestie — GUWK does not flush any NCAR Graphics buffers sitting above GKS, like the pen-move buffer in SPPS (go check the man page for plotif if you wanna know more). So don't be surprised when those hang around. 🙈

🌈 ACCESS 🌈

Wanna use GKS routines? You gotta load the NCAR GKS-0A library, which is ncarg_gks. That's the move. 🫶

⭐ SEE ALSO ⭐

Online: sflush, plotif, gupd_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 came from the UNIX manual, dated March 1993, under GUWK(3NCARG) in the NCAR GRAPHICS collection. iconic, timeless, fr fr. 💜✨