GSTXCI(3NCARG)

πŸ’– GSTXCI β€” the NCAR Graphics girlies' guide to setting ur text color index πŸ’–

okay so bestie, welcome to the GSTXCI page, straight out of the NCAR GRAPHICS manual (section 3NCARG, if u were wondering πŸŽ€). this is the one that handles what color ur text is gonna be. it's giving palette control, it's giving main character energy, and honestly? it's so easy. let's go πŸ¦‹


✨ NAME ✨

GSTXCI β€” short for Set text color index β€” sets the text color index. that's it. that's the whole job. she's simple, she's iconic, she slays πŸ’…


✨ SYNOPSIS ✨

the classic Fortran girlie way:

CALL GSTXCI (COLI)

✨ C-BINDING SYNOPSIS ✨

for the C girlies, u gotta pull in the header first:

#include <ncarg/gks.h>

void gset_text_colr_ind(Gint text_colr_ind);

no cap, that's the whole signature 🫢


✨ DESCRIPTION ✨

  • COLI β€” (Integer, Input) β€” a color index. just a lil number, bestie, that's all she needs 🌸

✨ USAGE ✨

so here's the tea β˜• β€” every text string u draw with calls to the GTX output primitive is gonna get drawn with whatever color is associated with index COLI... and it stays that way until u call GSTXCI again and hand it a new index. she's loyal like that, she holds the vibe until u tell her otherwise πŸ’–

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

  • 0 is the background color index πŸŒ™
  • 1 is the foreground color index ⭐

color values get hooked up to those indices by calling the GKS routine GSCR. and here's the lil plot twist 🫒 β€” if u use a color index that has no user-assigned color value set in a GSCR call, then a device-dependent color value gets assigned to that index. so basically the device picks for u. unpredictable queen behavior, lowkey πŸ™ˆ


✨ ACCESS ✨

to use GKS routines, load the NCAR GKS-0A library ncarg_gks. load her up and ur good to go ✨


✨ SEE ALSO ✨

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

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


Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.

bestie pls respect the license, it's the rules fr fr πŸ™

and that's the whole page!! this was the UNIX version, dated March 1993, page GSTXCI(3NCARG) β€” ty for coming to my ted talk, go forth and color ur text, u absolute icon πŸ‘‘πŸ’œβœ¨