GSCHUP(3NCARG)

✨ GSCHUP 💅 (Set character up vector)

okay so bestie, welcome to the glow-up page for GSCHUP from the NCAR GRAPHICS manual, part of the 3NCARG crew 🎀. This lil routine does one iconic job: it sets the angle at which all your subsequent text gets drawn with GTX. that's it. that's the whole vibe. ✨

---

🌸 SYNOPSIS 🌸

CALL GSCHUP (CHUX, CHUY)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/gks.h>

void gset_char_up_vec(const Gvec *char_up_vec);

---

💖 DESCRIPTION 💖

• CHUX — (Real, Input) — this is the X (horizontal) world coordinate of a vector. yes bestie, a whole coordinate. 👑
• CHUY — (Real, Input) — and this is the Y (vertical) world coordinate of that same vector. slay.

---

🌈 USAGE 🌈

so here's the tea ☕: the coordinates (CHUX, CHUY), taken relative to the point (0.,0.), establish a vector direction. That direction tells the system which way is "up" for each individual character 🔥. It also sets the orientation of an entire text string — because the characters in a string get placed along a line that's perpendicular to the character up vector. it's giving geometry. it's giving perpendicularity. we love her. 💅

By default, the character up vector is (0.,1.), which means characters get drawn in their normal, horizontal, unbothered orientation 🫶.

and ngl, the magnitude of the up vector is not used at all — so (0.,23.) is literally the same as (0.,1.). no cap. same energy. same result. ✨

---

🎀 EXAMPLES 🎀

CALL GSCHUP(-1.,0.)

this would specify the character up vector as (-1.,0.), and any subsequent text written with GTX would be rotated 90 degrees from normal 🔄 — which is exactly what you want for a Y-axis label. main character axis-labeling energy. 👑

CALL GSCHUP(1.,1.)

and this one would specify the character up vector as (1.,1.), so subsequent text written with GTX would be rotated -45 degrees from normal. diagonal. dramatic. obsessed. 😭💖

---

💜 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.

---

and that's the whole page bestie — this one dropped on the UNIX side of the NCAR GRAPHICS manual back in March 1993, filed under GSCHUP(3NCARG). rotate your text, stay perpendicular, and go slay some axis labels 💅✨💖