TICKIT_TERM_CHPEN(3)

💖 TICKIT_TERM_CHPEN 💖

okay bestie, welcome to the Library Functions Manual corner of the tickit cinematic universe 🎀 this one's about the two functions that decide what your terminal text looks like — the whole tickit_term_chpen and tickit_term_setpen situation. yes they're sisters. no they are NOT the same. let's get into it 💅

✨ NAME ✨

tickit_term_chpen, tickit_term_setpen — set the rendering attributes of the terminal 🦋

✨ SYNOPSIS ✨

#include <tickit.h>

void tickit_term_chpen(TickitTerm *tt, TickitPen *pen);
void tickit_term_setpen(TickitTerm *tt, TickitPen *pen);

Link with -ltickit.

✨ DESCRIPTION ✨

okay so picture this: your terminal has a whole vibe going on right now — colors, attributes, all of it. These two functions are how you change that vibe. The difference between them is literally the whole plot, so pay attention 🙈

tickit_term_chpen() — the selective queen 👑

tickit_term_chpen() changes the rendering attributes currently in effect in the terminal by setting those attributes specified in the given TickitPen instance. Attributes not present in pen stay exactly where they were — unmodified, untouched, living their best life. This operation does not bother them.

So like… you're only changing some of the things. The rest? Not invited to the makeover. 💅

tickit_term_setpen() — the full reset, no survivors 💀

tickit_term_setpen() changes the rendering attributes currently in effect in the terminal by setting all of the attributes to those given in the TickitPen instance. And here's the dramatic part: any attribute not present in pen gets reset back to its default value. Not "left alone". Not "gently preserved". Reset. Back to factory settings, bestie 😭

fr fr, this is the difference that will absolutely catch you off guard if you skim. chpen = patch the vibes. setpen = the vibes are now whatever you said they are, and anything you didn't mention is gone. choose wisely 🫶

the color downgrade moment 🌈

If the foreground or background colour is set to an index higher than the terminal can support, it will be converted to the best choice that is available from the palette of 8 or 16 colors. So you asked for the fancy color and the terminal said "bestie I only have 8 or 16, here's the closest match I can do" and honestly? It's doing its best and it ate ✨

✨ RETURN VALUE ✨

tickit_term_chpen() and tickit_term_setpen() return no value. They're void. They do the thing and they leave. No receipt, no follow-up text, no nothing. iconic behavior honestly 👑

✨ SEE ALSO ✨

• tickit_term_build(3)
• tickit_term_goto(3)
• tickit_term_print(3)
• tickit_term(7)
• tickit_pen(7)
• tickit(7)

and that's the whole page, no cap 🧚 go forth and set your terminal's rendering attributes with intention, bestie. this has been TICKIT_TERM_CHPEN(3), part of the tickit library functions manual — mwah, take care of her 💜🌸🍓