TICKIT_SETCTL_INT(3)

💖 TICKIT_SETCTL_INT(3) 💖

okay bestie, so this is a page from the Library Functions Manual, and it's all about poking at the integer control knobs on a Tickit toplevel instance. yes, that's the whole vibe. let's get into it 🫶

✨ NAME ✨

tickit_setctl_int — set an integer toplevel instance control

🌸 SYNOPSIS 🌸

#include <tickit.h>

bool tickit_getctl_int(Tickit *tt, TickitCtl ctl, int *value);
bool tickit_setctl_int(Tickit *tt, TickitCtl ctl, int value);

Link with -ltickit.

not the two functions showing up in that order in the synopsis, when the page is named after the setter 🙈 she contains multitudes, we love her for it

🦋 DESCRIPTION 🦋

ok so. tickit_setctl_int() does a toplevel instance control operation — it sets the value of a numeric instance control option. that's it, that's the job, and it does it slayfully 💅

tickit_getctl_int() is the other half of the duo: it obtains the value of an instance control setting. like, it gets it. reading is fundamental, bestie 📖

and if you wanna know the full list of possible TickitCtl values and what each one actually means?? go read tickit(7). that's where the lore lives, iykyk ✨

🔥 RETURN VALUE 🔥

• tickit_getctl_int() returns a true value if it recognised the requested control and managed to return the current value of it. and false if not. so like... if it doesn't recognise the control, no value for you, sorry babe 😭
• tickit_setctl_int() returns a true value if it recognised the requested control and managed to request the instance to change it. and false if not. same energy, different verb 💜

fr fr: read these. a false here is not a crash, it's just the function being like "girl idk what control that is" 🙈

🌈 SEE ALSO 🌈

• tickit(7)

and that's the whole page, bestie!! you ate it up, no crumbs left 👑

kisses from the TICKIT_SETCTL_INT(3) page itself, living in the Library Functions Manual, no date on the tin but she's iconic regardless** 🎀