GQCLIP(3NCARG)

💖 GQCLIP 💖

okay bestie, welcome to GQCLIP from the NCAR GRAPHICS cinematic universe ✨ — she lives in section 3NCARG and her whole job is asking the graphics system one very important question: are we clipping right now, and if so, WHERE? 🎀

✨ NAME ✨

GQCLIP (Inquire clipping indicator) — she retrieves the current value of the clipping indicator plus the current clipping rectangle. Two-for-one, no cap. 🫶

🌸 SYNOPSIS 🌸

CALL GQCLIP (ERRIND, ICLIP, CLRECT)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/gks.h>

void ginq_clip(Gint *err_ind, Gclip *clip_ind_rect);

💅 DESCRIPTION 💅

• ERRIND (Integer, Output) — if the inquired values can't be returned correctly, you get a non-zero error indicator dropped into ERRIND; otherwise it's a zero, and we're chilling. 😌 For the whole lore on what the error indicators mean, go consult the "User's Guide for NCAR GKS-0A Graphics" — she's the source, fr fr.
• ICLIP (Integer, Output) — hands you back the current value of the clipping indicator, whether that's the default or whatever got set by a call to GSCLIP. Here's the tea:
  • 0 — clipping is off, or deactivated. 💀
  • 1 — clipping is on. Data outside of the world coordinate window will not be plotted. 🚫
• CLRECT (Real, Array(4)) — four normalized device coordinates giving the corner points of the current clipping rectangle, in the order XMIN, XMAX, YMIN, YMAX. Periodt. 👑

🔥 ACCESS 🔥

To use GKS routines, load the NCAR GKS-0A library ncarg_gks. That's it, that's the access. 🌈

🎀 SEE ALSO 🎀

• Online: set, gsclip, gswn, gselnt, ginq_clip
• Hardcopy: "User's Guide for NCAR GKS-0A Graphics"

iykyk, that hardcopy guide is the main character of this whole saga. 📚💖

👑 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 iconic lil entry is dated March 1993, it's from the UNIX corner of the world, and yes it really is GQCLIP(3NCARG) — the 3NCARG is giving "I'm a library function" energy and honestly? slay. 💅✨🌸