FRAME(3NCARG)

💖 FRAME — the FRAME(3NCARG) glow-up 💖

okay bestie, so we're deep in the NCAR GRAPHICS section of the manual and this one is literally just called FRAME. it's giving "one job, does it well." let's get into it 🫶

---

✨ NAME ✨

FRAME — moves you along to the next picture (that's the case when you're doing CGM output), or else it just pauses in the window of most recent creation (that's the X11 output vibe). and listen: a mouse click or a key click in the window that's on pause? that causes all active workstations to be cleared. no cap. 🖱️⌨️

---

🌸 SYNOPSIS 🌸

CALL FRAME

that's it. that's the whole thing. iconic behavior honestly 💅

---

🦋 C-BINDING SYNOPSIS 🦋

for the C girlies:

#include <ncarg/ncargC.h>

void c_frame()

---

🎀 USAGE 🎀

so here's the tea ☕ — if you've got a CGM workstation open, calling FRAME makes an END_PICTURE CGM element get generated. boom. done.

and if you've got open X windows? it updates all workstations and then pauses in the window of most recent creation. then after a mouse click or a key click in that window on pause, all workstations get cleared. periodt.

lowkey important: FRAME is most applicable when you're in an environment with a single active workstation. if you're out here using multiple workstations, you should genuinely consider the more versatile NGPICT routine instead. NGPICT has the option of issuing a "<READY>" prompt when a window is on pause. that's a whole feature bestie. 🙈

and if you wanna use NGPICT to replace routine FRAME for a single CGM workstation, you do:

CALL NGPICT(WKID,1)

where WKID is the workstation ID for the metafile, and that second argument flags a CLEAR WORKSTATION. slay. 🌈

---

⭐ EXAMPLES ⭐

use the ncargex command to see the following relevant examples: agex06

go look at it. it's right there. 👑

---

🔥 ACCESS 🔥

to use FRAME or c_frame, you load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. (the order matters, bestie, don't come for me.) 🧚

---

👑 SEE ALSO 👑

Online: sflush, ngpict, spps, spps_params, ncarg_cbind

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

---

💜 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 lil writeup lives under the UNIX manual name, it's from way back in March 1993 (yes, she's vintage, she's an icon), and the page tag is FRAME(3NCARG). mwah 💋 🎀