GSFACI(3NCARG)

💖 GSFACI 💖 — like, the fill area color index setter, bestie

okay so this is a page from the NCAR GRAPHICS manual, section 3NCARG, and it's about GSFACI — which, full name, is Set fill area color index. 🎨✨

✨ NAME ✨

GSFACI (Set fill area color index) — sets the fill area color index. that's it. that's the whole job. she sets the index. 💅

🌸 SYNOPSIS 🌸

CALL GSFACI (COLI)

🦋 C-BINDING SYNOPSIS 🦋

for my C girlies, it's giving:

#include <ncarg/gks.h>

void gset_fill_colr_ind(Gint fill_colr_ind);

💜 DESCRIPTION 💜

• COLI (Integer, Input) — a color index. that's the one (1) thing you hand her. an integer. a little number that means a color. 🎀

👑 USAGE 👑

okay so here's the tea, and it's actually important: every single filled area drawn with calls to the GFA output primitive is gonna get drawn in the color tied to index COLI, and it stays that way until you call GSFACI again with a new index. so like… she remembers. she's committed. she's your main character until you tell her otherwise. 🔥

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

• 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. so GSCR is the matchmaker, GSFACI is the… also a matchmaker, kind of. iykyk. 💞

and here's the little plot twist: if you 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. not you picking. the device picking. it's giving chaos, honestly. 😭

🫶 ACCESS 🫶

to use GKS routines, load the NCAR GKS-0A library ncarg_gks. load her up, she's ready. ⭐

🌈 SEE ALSO 🌈

Online: gfa, gsfais, gsfasi, gscr, gqfais, gqfasi, areas, gset_fill_colr_ind

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, no cap. this one's from the UNIX manual, dated March 1993 — yes she's vintage, yes she still slays, we love a timeless icon. 💖🌸🦋 periodt.