GSTXFP(3NCARG)

✨ GSTXFP — the "set text font and precision" glow-up ✨

okay bestie, so this is a page from the NCAR GRAPHICS manual, and today's main character is GSTXFP. Sit down, hydrate, and let's get into it 💅

---

🌸 NAME 🌸

GSTXFP — aka Set text font and precision — sets the text font and precision. That's it. That's the whole job. It picks the font, it picks the precision, and then every GTX call after that is serving whatever you chose. 🎀

---

🦋 SYNOPSIS 🦋

CALL GSTXFP (FONT, PREC)

---

💜 C-BINDING SYNOPSIS 💜

#include <ncarg/gks.h>

void gset_text_font_prec(const Gtext_font_prec *text_font_prec);

---

✨ DESCRIPTION ✨

💖 FONT 💖

FONT (Integer, Input) — this is the font you want to use in all the subsequent calls to the GTX output primitive. The options are literally:

• 1 — ASCII font (this one's the default, no cap)
• -2 — Hershey cartographic Roman
• -3 — Hershey cartographic Greek
• -4 — Hershey simplex Roman
• -5 — Hershey simplex Greek
• -6 — Hershey simplex script
• -7 — Hershey complex Roman
• -8 — Hershey complex Greek
• -9 — Hershey complex script
• -10 — Hershey complex italic
• -11 — Hershey complex Cyrillic
• -12 — Hershey duplex Roman
• -13 — Hershey triplex Roman
• -14 — Hershey triplex italic
• -15 — Hershey Gothic German
• -16 — Hershey Gothic English
• -17 — Hershey Gothic Italian
• -18 — Hershey math symbols
• -19 — Hershey symbol set 1
• -20 — Hershey symbol set 2

Now, real talk: the Hershey fonts are not standardized by GKS. They're locally implemented in NCAR GKS-0A. And GKS is very strict about this — it requires that locally implemented fonts get assigned negative font numbers. So that's why everything Hershey here is rocking a minus sign, iykyk.

Wanna actually see the Hershey fonts? Go look at the plots produced from the PLOTCHAR example (run ncargex epltch to get a metafile) and check out the plot titled PLCHHQ - FONTCAP DATABASES ADDED 6/90. The font numbers over there are the absolute values of the value for FONT described right here. (PLOTCHAR has no need to follow the strictures that GKS imposes on font names for GSTXFP — it's living its own life, periodt.)

🎀 PREC 🎀

PREC (Integer, Input) — this is the precision used in subsequent calls to the GTX output primitive, for the font type FONT. Options are:

• 0 — String precision (good). This is the GKS default.
• 1 — Character precision (better).
• 2 — Stroke precision (best). This is the default for NCAR GSK-0A.

---

🌈 USAGE 🌈

Okay so here's the tea, and it's a big one:

• If you access the Hershey fonts via GSTXFP and GTX, then the characters are not stroked until viewing time.
• If you access the Hershey fonts via PLOTCHAR, then the characters are stroked by PLOTCHAR itself.

This can make a significant difference in metafile sizes. So like… choose wisely, bestie 💀

---

🫶 ACCESS 🫶

To use GKS routines, load the NCAR GKS-0A library ncarg_gks.

---

⭐ SEE ALSO ⭐

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

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 — written for the UNIX manual, dated March 1993, filed under GSTXFP(3NCARG). iconic behavior from 1993 honestly, we stan a legacy manpage 🦋✨💖