GCLWK(3NCARG)

✨ GCLWK β€” closes a GKS workstation ✨

okay bestie, welcome to the NCAR GRAPHICS corner of the manual, page GCLWK(3NCARG). this one is short, sweet, and honestly so satisfying. it's giving closure. literally. πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

CALL GCLWK (WKID)

that's it. one call. one argument. we love a low-effort queen. πŸ‘‘


πŸ¦‹ C-BINDING SYNOPSIS πŸ¦‹

for my C girlies, here's the same energy in a different font:

#include <ncarg/gks.h>

void gclose_ws(Gint ws_id);

yes, the header is ncarg/gks.h and yes, the function is gclose_ws β€” the Fortran girlies get GCLWK, the C girlies get gclose_ws, and everybody goes home happy. 🌈


🌸 DESCRIPTION 🌸

  • WKID β€” (Input, Integer) β€” the number that identifies the workstation you wanna close. and listen, this is the important part: WKID must be the exact same number you used in some previous GOPWK call. no making up new numbers. no "close enough". it's the same one. periodt. πŸ’–

πŸ’œ USAGE πŸ’œ

so what does closing a workstation actually do, you ask? so glad you asked bestie:

  • it updates the workstation (one last lil refresh, a goodbye kiss 🫢)
  • it removes its identifier from the set of open workstations
  • it releases the connection to the workstation
  • and the associated connection ID becomes available for re-use ♻️ β€” iconic recycling behaviour, we stan

basically it's the "okay bye, love you, text me when you're home" of GKS calls. πŸšͺ✨


πŸ”₯ ACCESS πŸ”₯

to use GKS routines, you gotta load the NCAR GKS-0A library, which is called ncarg_gks. load it. don't forget. i'm not gonna say it twice. (i will say it twice.) load ncarg_gks. πŸ’€


πŸ‘‘ SEE ALSO πŸ‘‘

Online:

  • gopks
  • gopwk
  • gacwk
  • gdawk
  • gclks
  • opngks
  • clsgks
  • gclear_ws

(notice gopwk in there? that's the one whose WKID you gotta match. iykyk. πŸ™ˆ)

Hardcopy:

  • User's Guide for NCAR GKS-0A Graphics
  • NCAR Graphics Fundamentals, UNIX Version

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, no cap. πŸ“ this was GCLWK(3NCARG) from the UNIX manual, dated March 1993 β€” yeah she's an elder but she still slays. mwah. πŸ’‹πŸ§šβ€β™€οΈ