GINQ_NAME_OPEN_SEG(3NCARG)

✨ GINQ_NAME_OPEN_SEG ✨

okay so bestie, this one's from NCAR GRAPHICS and it lives in section 3NCARG of the manual, and it is literally the glow-up of "hey, what segment are we even in right now??" πŸ’…


🌸 NAME 🌸

ginq_name_open_seg β€” returns the name of the currently open segment 🫢


πŸŽ€ SYNOPSIS πŸŽ€

#include <ncarg/gks.h>

void ginq_name_open_seg(Gint *err_ind, Gint *name_open_seg);

πŸ’– DESCRIPTION πŸ’–

  • err_ind β€” (Output) so like, if the GKS state is SGOP (segment open, we're in our open segment era ✨), then err_ind comes back as "0". Otherwise β€” and I cannot stress this enough β€” err_ind is returned as "4". πŸ’€
  • name_open_seg β€” (Output) if the GKS state is SGOP (segment open, main character moment), then name_open_seg is returned as the number of the currently open segment πŸŽ‰. Otherwise? name_open_seg is undefined. Not zero, not empty, undefined β€” so don't you dare go reading it, that's giving chaos πŸ™ˆ.

🌈 ACCESS 🌈

To use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries. That's it, that's the whole vibe check πŸ‘‘


πŸ¦‹ SEE ALSO πŸ¦‹

Online: geval_tran_matrix(3NCARG), gaccum_tran_matrix(3NCARG), gclose_seg(3NCARG), gcreate_seg(3NCARG), gcopy_seg_ws(3NCARG), gdel_seg(3NCARG), ginq_set_seg_names(3NCARG), gset_seg_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 that's the whole page, no cap. it's giving UNIX, it's giving March 1993, and yes the source is literally just that date and platform bestie β€” iconic of it honestly. go forth and query your open segment, you absolute legend πŸ’–πŸŽ€πŸ¦‹