GINQ_CHAR_UP_VEC(3NCARG)

πŸ’– GINQ_CHAR_UP_VEC πŸ’–

okay so bestie, welcome to ginq_char_up_vec, a lil function from the NCAR GRAPHICS manual page family (you'll see it filed under 3NCARG in the UNIX section, dated March 1993 β€” vintage but make it fashion ✨).


✨ NAME ✨

ginq_char_up_vec β€” it retrieves the current value of the character up vector πŸŽ€

like, it inquires. it asks the question. it does not set anything, it's giving main character observation energy πŸ’…


🌸 SYNOPSIS 🌸

#include <ncarg/gks.h>

void ginq_char_up_vec(Gint *err_ind, Gvec *char_up_vec);

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's the tea on the parameters, one by one, no skips πŸ”₯

  • err_ind β€” (Output) β€” if the inquired values can't be returned correctly, a non-zero error indicator gets dropped into err_ind. otherwise? it's a zero. bestie if you wanna know what the error indicators mean, you gotta go consult the "User's Guide for NCAR GKS-0A Graphics" β€” that's the lore, i don't make the rules πŸ“–
  • char_up_vec.delta_x β€” (Gfloat, Output) β€” gives the X world coordinate of a the up vector. (yes, "a the". iconic typo energy, we keep it exactly as written πŸ’€)
  • char_up_vec.delta_y β€” (Gfloat, Output) β€” gives the Y world coordinate of a the up vector.

🧚 USAGE 🧚

so the up vector is literally that vector formed by the two coordinate points (0.,0.) and (char_up_vec.delta_x,char_up_vec.delta_y). that's the whole vibe. πŸ“

and if you want more details on the meaning of the character up vector, go see gset_char_up_vec β€” she's the one who sets it, this function just asks about it 🫢


πŸ‘‘ ACCESS πŸ‘‘

to use the GKS C-binding routines, you gotta load the ncarg_gks and ncarg_c libraries. load them. both. no cap πŸ”₯


🌈 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_expan(3NCARG), plotchar(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)

Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

seriously, the whole friend group is linked above. this one's just the "hey what's the up vector rn" girlie in the squad πŸ’œ

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! πŸŽ€ source + version: NCAR GRAPHICS, UNIX, March 1993, GINQ_CHAR_UP_VEC(3NCARG) β€” mwah, go read the error indicator guide, ily, bye πŸ’–βœ¨