GSET_TEXT_COLR_IND(3NCARG)

✨ GSET_TEXT_COLR_IND ✨

okay bestie, welcome to the NCAR GRAPHICS corner of the manual — this one's about gset_text_colr_ind, aka "Set text color index", and it literally just sets the text color index. that's it. that's the whole job. and honestly? she ate. 💅

🌸 NAME 🌸

gset_text_colr_ind (Set text color index) — sets the text color index. iconic, concise, no notes.

🎀 SYNOPSIS 🎀

#include <ncarg/gks.h>

void gset_text_colr_ind(Gint text_colr_ind);

💖 DESCRIPTION 💖

• text_colr_ind — (Input) A color index. just a lil number that tells your text which color to be. that's her.

🦋 USAGE 🦋

so here's the tea ☕: every single text string you draw with calls to the gtext output primitive is gonna be drawn with the color associated with index text_colr_ind — and it keeps doing that until you call gset_text_colr_ind again and assign a new index. so like, she's not a one-time thing, she's a vibe you set and it stays set. periodt.

for all GKS output primitives, color gets assigned using a color index. the color indices run from 0 to 255, where:

• 0 is the background color index
• 1 is the foreground color index

color values get associated with indices by calling the GKS routine gset_colr_rep. and here's the lowkey important part 👀: if you use a color index that has no user-assigned color value set in a gset_colr_rep call, then a device-dependent color value will be assigned to that index. so like, it's not undefined, it's not an error — it's just the device deciding for you, iykyk.

🌈 ACCESS 🌈

to use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries. that's the whole vibe check. 🔥

👑 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), 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), ncarg_gks_cbind(3NCARG)

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.

ngl, "governed by a License Agreement" is giving main character energy in a legal sense. respect the license bestie, fr fr. 🫶

and that's the whole page, bestie! this was the UNIX version of the GSET_TEXT_COLR_IND(3NCARG) manual, dated March 1993 — yes, she's vintage, and yes, she still slays. 💖✨🎀