GSCHUP(3NCARG)

✨ GSCHUP ✨ (aka GSCHUP(3NCARG), from the NCAR GRAPHICS fam 💖)

okay bestie, so this one is literally the glow-up button for your text angle. GSCHUP = Set character up vector, and it tells GKS which way is "up" for every piece of text you draw after you call it with GTX. it's giving "rotate my whole vibe" and honestly? iconic.

---

🌸 NAME 🌸

GSCHUP (Set character up vector) — specifies the angle at which subsequent text is to be drawn with GTX.

---

🎀 SYNOPSIS 🎀

CALL GSCHUP (CHUX, CHUY)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/gks.h>

void gset_char_up_vec(const Gvec *char_up_vec);

---

💅 DESCRIPTION 💅

• CHUX — (<span class="purple">Real, Input</span>) — gives the X (horizontal) world coordinate of a vector. yes bestie, an actual coordinate, not an angle. stay with me 🫶
• CHUY — (<span class="purple">Real, Input</span>) — gives the Y (vertical) world coordinate of a vector. same deal, but vertical.

---

🌈 USAGE 🌈

so the coordinates (CHUX, CHUY), measured relative to the point (0.,0.), literally establish a vector direction. that direction says which way is "up" for your individual characters. 🧚

and the way that it also does double duty?? that same direction sets the orientation of a whole text string, because the characters in a string get placed along a line perpendicular to the character up vector. no cap. 🔥

by default the character up vector is (0.,1.), so characters come out in their normal horizontal orientation — the standard, no-drama look. 💖

one thing to know: the magnitude of the up vector is not used, so (0.,23.) hits exactly the same as (0.,1.). length? irrelevant. direction? everything. slay. 👑

---

⭐ EXAMPLES ⭐

CALL GSCHUP(-1.,0.)

this one specifies the character up vector as (-1.,0.), and subsequent text written with GTX would be rotated 90 degrees from normal — perfect for a Y-axis label. main character axis energy, fr fr. 💜

CALL GSCHUP(1.,1.)

and this one specifies the character up vector as (1.,1.), so subsequent text written with GTX would be rotated -45 degress from normal. (yes, "degress". the original said it, so we're keeping it, no edits 💀)

---

🍓 ACCESS 🍓

to use GKS routines, load the NCAR GKS-0A library ncarg_gks. that's the plug. 🔌

---

💖 SEE ALSO 💖

Online: gtx, gstxp, gstxal, gstxfp, gschh, gschsp, gschxp, gscr, gstxci, gqtxp, gqtxal, gqtxfp, gqchh, gqchsp, gqchup, gqchxp, plotchar, gset_char_up_vec

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.

---

okay that's the whole page bestie, go rotate some text and absolutely ate 💅✨

sign-off: this lil masterpiece came from the UNIX manual, dated March 1993 — vintage but still serving looks 🎀🦋