GINQ_CLIP(3NCARG)

📦 version 6.6.2, in epel 9, fedora 43, fedora 44

💖 GINQ_CLIP 💖

okay bestie, welcome to ginq_clip — that's the Inquire clipping indicator routine, from the NCAR Graphics family (manual section 3NCARG, if you're keeping track 🎀). she's here to do exactly one job and she does it flawlessly: she fetches the current value of the clipping indicator, plus the current clipping rectangle while she's at it. lowkey a two-for-one. obsessed. ✨

✨ SYNOPSIS ✨

#include <ncarg/gks.h>

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

🌸 DESCRIPTION 🌸

so here's the tea on the arguments 🍓:

  • err_ind — (Output) okay so if the inquired values cannot be returned correctly, a non-zero error indicator gets dropped into err_ind. otherwise you get a nice clean zero. and if you're like "what do the error indicators even mean", go read the "User's Guide for NCAR GKS-0A Graphics" — it's all spelled out in there. no cap. 📖
  • clip_ind_rect.clip_ind — (Output) this one hands you back the current value of the clipping indicator, whether it was set by default or by a call to gset_clip_ind. and it's giving two possible moods:
    • GIND_NO_CLIP — clipping is off, or deactivated. the data is free. she's unbothered. 💅
    • GIND_CLIP — clipping is on. data outside of the world coordinate window will not be plotted. boundaries are boundaries, periodt. 🚫
  • clip_ind_rect.clip_rect — (Glimit, Output) four normalized device coordinates that give you the corner points of the current clipping rectangle. that's the little box, bestie. the rectangle in question. 🌈

🔑 ACCESS 🔑

to use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries. that's the whole vibe check right there. ✅

👀 SEE ALSO 👀

Online:

  • set(3NCARG)
  • gset_clip_ind(3NCARG)
  • gset_win(3NCARG)
  • gsel_norm_tran(3NCARG)
  • gks(3NCARG)
  • ncarg_gks_cbind(3NCARG)

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.

and that's the whole page, bestie!! 💜 this one came out of the NCAR GRAPHICS universe, dropped on a UNIX system, and the version stamp on it is from March 1993 — like, a vintage icon fr fr. GINQ_CLIP(3NCARG) forever 🫶✨🎀

📦 where this page comes from