GINQ_CHAR_SPACE(3NCARG)

💖 GINQ_CHAR_SPACE(3NCARG) 💖

okay bestie, so this is a page from the NCAR GRAPHICS manual (the 3NCARG corner of the library, iykyk) and it's about one little function: ginq_char_space. It's giving "quiet overachiever" — it doesn't do anything, it just asks things. Specifically it retrieves the current value for character spacing. 🎀

✨ SYNOPSIS ✨

#include <ncarg/gks.h>

void ginq_char_space(Gint *err_ind, Gdouble *char_space);

two pointers in, vibes out. she's not returning anything, she's writing into your variables. periodt. 💅

🌸 DESCRIPTION 🌸

• err_ind (Output) — bestie this is the did it work flag. If the inquired value cannot be returned correctly, a non-zero error indicator gets dropped in here. Otherwise you get a zero, and you can relax. 🫶 If you're like "what do these error numbers even mean", go consult the "User's Guide for NCAR GKS-0A Graphics" — it has a whole description of the meaning of the error indicators. not me sending you to another doc but that's literally where the answers live.
• char_space (Output) — and here's the actual tea ☕: this contains the current value for character spacing. Where did that value come from? Either it's the default, or somebody set it with a call to gset_char_space. That's it, that's the whole vibe. 💖

🔑 ACCESS 🔑

To use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries. no cap, if you don't link those two you're gonna have a bad time. 😭

👀 SEE ALSO 👀

Online: gtext(3NCARG), gset_text_path(3NCARG), gset_text_align(3NCARG), gset_text_font_prec(3NCARG), gset_char_ht(3NCARG), gset_char_space(3NCARG), gset_char_up_vec(3NCARG), gset_char_expan(3NCARG), gset_colr_rep(3NCARG), gset_text_colr_ind(3NCARG), ginq_text_path(3NCARG), ginq_text_align(3NCARG), ginq_text_font_prec(3NCARG), ginq_char_ht(3NCARG), ginq_char_up_vec(3NCARG), ginq_char_expan(3NCARG), plotchar(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)

like genuinely that's a whole friend group of gset_* and ginq_* functions — this one is literally the sibling of ginq_char_expan and ginq_char_ht. go say hi. ✨

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.

real talk: that License Agreement is not optional, she's legally binding, so read it before you go wild. 🙈

okay that's the whole page, you ate it up 💅 the source is the UNIX version, dated March 1993 — yes she's an icon, yes she's vintage, and she still slays. bye bestie, go space some characters. 🦋🌸