GQCNTN(3NCARG)

💖 GQCNTN 💖 — aka the NCAR GRAPHICS era, bestie

okay so bestie, welcome to the NCAR Graphics section of the manual (3NCARG, yes, we're fancy), and today's main character is GQCNTN. she's short, she's sweet, she does exactly one (1) thing, and honestly? iconic for it. ✨

🎀 NAME 🎀

GQCNTN — which stands for Inquire current normalization transformation number — literally just goes and retrieves the number of the current normalization transformation. that's it. that's the whole job. no notes. 💅

✨ SYNOPSIS ✨

CALL GQCNTN (ERRIND, CTNR)

like, that's the vibe. two arguments, go off. 🦋

🧚 C-BINDING SYNOPSIS 🧚

for the C girlies (we see you, we love you):

#include <ncarg/gks.h>

void ginq_cur_norm_tran_num(Gint *err_ind, Gint *norm_tran_num);

same energy, different font. 💜

🌸 DESCRIPTION 🌸

okay so here's the tea on the arguments, and yes you need both:

• ERRIND — (Integer, Output) — if the inquired value can't be returned correctly, you get a non-zero error indicator dropped in here. if everything's chill, you get a zero. 🫶 and if you wanna know what those error indicators actually mean, go consult "User's Guide for NCAR GKS-0A Graphics" — she has the lore, i'm just the messenger.
• CTNR — (Integer, Output) — this one returns the current normalization transformation number. and where does that number come from? either it's the default, or somebody set it with a call to GSELNT. so like, it's giving ✨ provenance ✨.

ngl both of these are Output args, so don't come in here thinking you're passing values in. you're receiving. it's a receiving moment. 🙈

🔥 ACCESS 🔥

wanna actually use the GKS routines? load the NCAR GKS-0A library, ncarg_gks. periodt. that's the whole access situation. 💅

👑 SEE ALSO 👑

Online: gselnt, gqmntn, gqnt, getset, ginq_cur_norm_tran_num — go read the whole friend group, they're all connected, iykyk. 🌈

Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version — yes, actual paper, yes, it's vintage, yes, it ate. 📚

💀 COPYRIGHT 💀

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

(so like… respect the license bestie, it's not optional. 🙏)

and that's the whole page!! sign-off time: this lil doc came from the UNIX world, dated March 1993, and lives under the header GQCNTN(3NCARG). she's been here since before most of us were born and she's still slaying. 💖✨🦋