set_color(3)

💖 set_color(3) 💖

okay bestie, we're in section 3 of the gstream manual and today's main character is set_color 🎀 she's short, she's sweet, she sets a colour, and honestly? iconic behaviour.

✨ SYNOPSIS ✨

#include <gstream.h>

void set_color(int clr);

like, that's it. one include, one function, one int. we love a low-maintenance queen 💅

🌸 DESCRIPTION 🌸

So. set_color sets the colour that your font gets drawn in 🎨 That's the whole job. She takes the colour you hand her and that's what your text is gonna show up as.

Now, if you want the detailed discussion of how colours actually work here — the whole lore, the deep cuts, the extended universe — you gotta go read the documentation for Allegro, specifically under textout ✨ Because here's the tea: gstream is literally just passing this colour variable straight through to the string drawing function. No middleman, no glow-up, no transformation. So the exact same rules that apply to normal textouts apply to this too. Whatever Allegro says about textout colours? That's the law here, fr fr.

And the default? It's -1 💖 so if you never call this function at all, that's what you're rolling with.

heads up bestie: because it's a direct pass-through, don't expect gstream to do any interpretation or fixing for you. Same rules as normal textouts, periodt. 🫶

👑 SEE ALSO 👑

• gstream-get_color(3) — the other half of this duo, go check her out too 💜

and that's the whole page!! short and slay 🌈 this gem comes to you from the gstream manual, version 1.6 — mwah, take care of her 💅✨🦋