GINQ_CLIP(3NCARG)

✨ GINQ_CLIP ✨

okay so bestie, welcome to the ginq_clip page, from the NCAR GRAPHICS manual set (section 3NCARG, iykyk). this one's a lil inquiry routine and she's honestly so simple it's giving "one job, does it well" πŸ’…


🌸 NAME 🌸

ginq_clip β€” Inquire GKS clipping indicator. that's it, that's the whole name, she's lowkey iconic for it πŸ’–


πŸŽ€ DESCRIPTION πŸŽ€

ginq_clip (Inquire clipping indicator) β€” literally just goes and fetches the current value of the clipping indicator and the current clipping rectangle. two-for-one, no cap 🫢


✨ SYNOPSIS ✨

#include <ncarg/gks.h>

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

πŸ’œ DESCRIPTION πŸ’œ

so here's the tea on the arguments, bestie, pay attention because both of them are Output and neither one of them is here to be given anything, they're here to tell you stuff:

  • err_ind β€” (Output) πŸ’€ if the inquired values can't be returned correctly, you get a non-zero error indicator dropped into err_ind. otherwise it's a chill little zero. and if you're like "okay but what do the numbers MEAN" β€” go read the User's Guide for NCAR GKS-0A Graphics, she has the whole description of the error indicators, fr fr.
  • clip_ind_rect.clip_ind β€” (Output) 🌈 returns the current value of the clipping indicator, whether that got set by default or by you calling gset_clip_ind. and it comes back as one of these two vibes:
    • GIND_NO_CLIP β€” clipping is off, or deactivated. she's not clipping, she's resting πŸ’…
    • GIND_CLIP β€” clipping is on. data outside of the world coordinate window will not be plotted. periodt, it's not showing up, it's not invited πŸ‘‘
  • clip_ind_rect.clip_rect β€” (Glimit, Output) πŸ¦‹ four normalized device coordinates giving the corner points of the current clipping rectangle. that's four numbers, four corners, one rectangle, slay.

πŸ‘‘ ACCESS πŸ‘‘

to use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries. both of them. don't skip one, bestie, she will not run πŸ™ˆ


πŸ”₯ 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.


okay and that's the whole page, you ate it, you understood it, you're basically a GKS girlie now ⭐ so go inquire about your clipping and stay hydrated πŸ“

this was the UNIX version, dated March 1993, filed under GINQ_CLIP(3NCARG) β€” mwah, bye bestie πŸ’œπŸ§š