GINQ_TEXT_PATH(3NCARG)

✨ GINQ_TEXT_PATH ✨

okay bestie, welcome to the NCAR GRAPHICS corner of the manual, this one's called ginq_text_path and it's a lil function from section 3NCARG and honestly? she's giving quietly essential. 💖

🌸 NAME 🌸

ginq_text_path — retrieves the current text path 🦋

✨ SYNOPSIS ✨

#include <ncarg/gks.h>

void ginq_text_path(Gint *err_ind, Gtext_path *text_path);

💅 DESCRIPTION 💅

okay so here's the tea, two arguments, both of them Output, both of them doing their own lil job:

• err_ind (Output) — if the inquired value literally cannot be returned correctly, you get a non-zero error indicator dropped into err_ind. otherwise? a nice lil zero. 🫶 and if you wanna know what any of those error indicators actually mean, go consult the "User's Guide for NCAR GKS-0A Graphics", that's where the lore lives.
• text_path (Output) — returns the current text path, whatever it is rn, whether that's the default or something you set by calling gset_text_path. the legal values are, and I'm being so serious, exactly these four:
  • GPATH_RIGHT — draws successive characters in the string so that character n+l appears to the right of character n. this is text path "right" and it is the default, she's the main character. 👑
  • GPATH_LEFT — draws character n+1 to the left of character n. this is text path "left".
  • GPATH_UP — draws character n+1 above character n. this is text path "up".
  • GPATH_DOWN — draws character n+1 below character n. this is text path "down".

not me being obsessed with how the only difference between these is vibes and direction. character n+1 just going places. literally. 😭

🎀 ACCESS 🎀

to use the GKS C-binding routines, you gotta load the ncarg_gks and ncarg_c libraries. no cap, both of them. 🧚

🌈 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_space(3NCARG)
• ginq_char_up_vec(3NCARG)
• ginq_char_expan(3NCARG)
• plotchar(3NCARG)
• gks(3NCARG)
• ncarg_gks_cbind(3NCARG)

Hardcopy:

• User's Guide for NCAR GKS-0A Graphics
• NCAR Graphics Fundamentals, UNIX Version

(yeah it references itself up there, ginq_text_path(3NCARG), iconic behaviour honestly 💀)

👑 COPYRIGHT 👑

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.

and that's the whole page bestie, UNIX, March 1993, GINQ_TEXT_PATH(3NCARG) — go forth and inquire about text paths, you got this 💜✨🎀