Gflash(3NCARG)

💖 NAME 💖

Gflash — bestie, this is the whole vibe: it lets you store up segments of a picture so you can drop them into any picture you make later. Like saving a little clip and pasting it into your next masterpiece. ✨

🌸 SYNOPSIS 🌸

Four routines, one glow-up squad:

• GFLAS1 — starts the storage of plotting instructions. 🎬
• GFLAS2 — stops the storage of plotting instructions. ✋
• GFLAS3 — inserts saved plotting instructions into the output stream. 💫
• GFLAS4 — associates the filename of a previously generated picture segment with an id suitable for use with GFLAS3. 🔗

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

c_gflas1
c_gflas2
c_gflas3
c_gflas4

🎀 ACCESS 🎀

To use Gflash C or Fortran routines, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — and preferably in that order, bestie. Order matters, it's giving choreography. 💅

👑 MESSAGES 👑

When error conditions are detected, the support routine SETER is called in such a way that it writes a message to the standard error file (as defined by I1MACH(4)) and then terminates execution. So yeah, not a soft launch — it's a full exit. 😭

The possible error messages are as follows:

• GFLAS1 CALLED CONSECUTIVELY WITHOUT AN INTERVENING GFLAS2 CALL — You must terminate the usage of one FLASH buffer before reusing it. One at a time, queen. 🙈
• THE NON-NCAR GKS PACKAGE IS NOT LEVEL 2 — Gflash requires GKS level 2A or higher in order to function in a non-NCAR GKS environment. Gotta be level 2A+ to sit with us. ⭐
• WISS MUST BE OPEN BEFORE CALL TO GFLAS1 — Gflash entries must have access to the appropriate GKS segmentation functions in order to work. This is accomplished by making a call to the GKS entry GOPWK to open WISS.
• MAXIMUM NUMBER OF OPEN WORKSTATIONS ALLOWED IS 100 — You have called GFLAS1 with more than 100 different identifiers. Girl, 100 is the limit. 🫶
• BUFFER IDENTIFIER .LT. 0, OR .GT. 99 — The argument to Gflash is out of the described range.
• GKS MUST BE OPEN BEFORE A CALL TO GFLAS1 — You have tried calling GFLAS1 without opening GKS. A call to the GKS entry GOPWK is required before calling any Gflash entry.
• GFLAS2 CALLED WITHOUT CALLING GFLAS1 — GFLAS2 terminates the GFLAS1 job of writing plotting instructions to disk. GFLAS2 has no functionality if not called in the legal sequence.
• WISS NOT OPEN AT GFLAS2 TIME — Gflash entries must have access to the appropriate GKS segmentation functions in order to work. This is accomplished by making a call to the GKS entry GOPWK to open WISS.
• GFLAS3 CALLED WITHOUT CALLING GFLAS2 OR GFLAS4 — GFLAS3 has no access to the plotting instructions that it is to insert into the output metafile unless a call to either GFLAS2 or GFLAS4 is made first. No receipts, no insert. 💀
• THE NON-NCAR GKS PACKAGE IS NOT LEVEL 2 — Gflash requires GKS level 2A or higher in order to function in a non-NCAR GKS environment. (Yes bestie, it said it twice. It's that serious.) 🔥
• WISS MUST BE OPEN BEFORE A CALL TO GFLAS4 — Gflash entries must have access to the appropriate GKS segmentation functions in order to work. This is accomplished by making a call to the GKS entry GOPWK to open WISS.
• MAXIMUM NUMBER OF WORKSTATIONS ALLOWED IS 100 — You have called GFLAS1 with more than 100 different identifiers.
• GKS MUST BE OPEN BEFORE A CALL TO GFLAS4 — You have tried calling GFLAS4 without opening the NCAR GKS package. (The GFLAS4 subroutine is an option only if you are using the NCAR GKS package.) 👑
• CANNOT BE CALLED WHILE GFLAS1 IS STILL OPEN — Call GFLAS2 to complete the GFLAS1/GFLAS2 sequence before attempting to call GFLAS4. Close the chapter first, then start the new one. 📖

🌈 SEE ALSO 🌈

Online: gflas1, gflas2, gflas3, gflas4, ncarg_cbind.

Hardcopy: 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.

okay that's the whole page, no cap 💅 this came from the NCAR GRAPHICS manual, Gflash(3NCARG), and it's dated March 1993 — the UNIX flavoured one. go store those segments bestie, you're gonna eat 🍓✨