GQSGUS(3NCARG)

💖 GQSGUS — the "who's on the guest list" routine 💖

okay bestie, so this one is from the NCAR Graphics manual (that's the <pink>3NCARG</pink> bit, iykyk), and it's genuinely one of my faves because it's just... asking the universe which segments are currently in use. that's it. that's the whole vibe. a headcount. a vibe check for your segment list. ✨

🌸 NAME 🌸

GQSGUS (Inquire set of segment names in use) — literally retrieves what segment names are currently in use. it's giving census. it's giving "hey who's here". 💅

🎀 SYNOPSIS 🎀

CALL GQSGUS(N,ERRIND,OL,SGNA)

✨ C-BINDING SYNOPSIS ✨

#include <ncarg/gks.h>

void ginq_set_seg_names(Gint num_elems_appl_list, Gint start_pos, Gint
*err_ind, Gint_list *seg_names, Gint *length_list);

🦋 DESCRIPTION 🦋

here's the tea on every single argument, no skips:

• N (Integer, Input) — the set member requested. like, which one do you want, bestie. 🫶
• ERRIND (Integer, Output) — if the GKS state is WSOP (workstation open), WSAC (workstation active), or SGOP (segment open), then ERRIND is returned as "0"; otherwise ERRIND is returned as "7". so basically 0 means we're good and 7 means the state is not it. 😭
• OL (Integer, Output) — the number of segment names that are currently in use. the headcount, the total, the how-many-people-showed-up. 🔥
• SGNA (Integer, Output) — if the GKS state is WSOP (workstation open), WSAC (workstation active), or SGOP (segment open), and if OL is larger than zero, then SGNA is returned as the name in the Nth element of the list of segment names that are currently in use; otherwise SGNA is undefined. ⚠️ yeah, undefined. we don't love that, but we respect it. 💀

💜 USAGE 💜

okay so for NCAR GKS, segment names are integers between 0 and 99 inclusive (see the man page for GCRSG). cute little range, love that for them. 🍓

now the move — if one wants to obtain a list of all segment names that are currently in use, then the procedure usually is first to determines the number of segment names currently in use by making an initial call to GQSGUS with first argument of "1". 🧚

if ERRIND is returned as "0", then OL will tell you how many segments are currently in use. iconic. ✨

then, to get the list of all segment names currently in use, call GQSGUS in a loop on N from 1 to OL and retrieve the N values of SGNA returned from such calls. it's a loop, it's a little grind, but it's the way, and it works. periodt. 💅

🌈 ACCESS 🌈

to use GKS routines, load the NCAR GKS-0A library ncarg_gks. that's the whole instruction. go forth. 👑

⭐ SEE ALSO ⭐

Online: gevtm, gactm, gclsg, gcrsg, gcsgwk, gqopsg, gdsg, gssgt., ginq_set_seg_names

Hardcopy: "User's Guide for NCAR GKS-0A Graphics"

👑 COPYRIGHT 👑

Copyright (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.

bestie reminder: this is the GQSGUS page from the UNIX manual, dated March 1993 — yes she's vintage, yes she still slays, no cap. 💖 🎀 💅 🦋 🌸 🫶 ✨

bye ily, go ask your segments who they are 🌈💜