GINQ_SET_SEG_NAMES(3NCARG)

ginq_set_seg_names 💖

okay so bestie, this one lives in the NCAR GRAPHICS manual, section 3NCARG, and it's literally the vibe check for your segment names ✨ It tells you which segment names are currently in use. No cap.

✨ NAME ✨

ginq_set_seg_names — retrieves what segment names are currently in use 🦋

✨ 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 ✨

okay so here's the rundown of every single argument, and yes we're doing all of them 💅

• num_elems_appl_list — (Input) the number of elements in the application list you wanna request. like, how many you're asking for, bestie 🎀
• start_pos — (Input) the first set member requested. where you're starting from, periodt.
• err_ind — (Output) if the GKS state is WSOP (workstation open), WSAC (workstation active), or SGOP (segment open), then err_ind gets returned as "0" 💚 otherwise err_ind gets returned as "7" 😭
• length_list — (Output) the number of segment names that are currently in use. the actual count, fr fr 🔥
• seg_names.num_ints — (Gint, Output) the number of segment names returned 👑
• seg_names.ints — (Gint *, Output) if the GKS state is WSOP (workstation open), WSAC (workstation active), or SGOP (segment open), and if start_pos is non-negative, then seg_names.ints is returned as the list of segment names starting with element "start_pos" and ending with element "start_pos + num_elems_appl_list - 1" or "start_pos + length_list - 1", whichever is less 🍓 otherwise seg_names.num_ints is undefined — like, genuinely undefined, not "undefined but probably fine". watch out 💀

✨ USAGE ✨

for NCAR GKS, segment names are integers between 0 and 99 inclusive (see the man page for gcreate_seg(3NCARG)) 🌸

✨ ACCESS ✨

to use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries 🫶

✨ SEE ALSO ✨

Online: geval_tran_matrix(3NCARG), gaccum_tran_matrix(3NCARG), gclose_seg(3NCARG), gcreate_seg(3NCARG), gcopy_seg_ws(3NCARG), ginq_name_open_seg(3NCARG), gdel_seg(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 ✨

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

bestie pls don't forget: seg_names.num_ints is undefined in that one case. i'm not being dramatic, the manpage literally says undefined. protect ur data 💜

and that's the whole page, gorgeous 🌈 sign-off time: this was the UNIX version, dated March 1993, and the page is GINQ_SET_SEG_NAMES(3NCARG). iconic, honestly. bye bestie, go retrieve some segment names 💅✨