TICKIT_WINDOW_EXPOSE(3)

💅 tickit_window_expose — bestie edition 💅

ok so this is a page from the Library Functions Manual, section 3, and it's all about tickit_window_expose. yes the man page name is literally the title, we love a self-titled icon 👑

✨ NAME ✨

tickit_window_expose — mark an area of a window for re-rendering 🎨

🌸 SYNOPSIS 🌸

#include <tickit.h>

void tickit_window_expose(TickitWindow *win, const TickitRect *exposed);

Link with -ltickit.

🦋 DESCRIPTION 🦋

ok so tickit_window_expose() takes the given area of the given window and marks it as needing to be re-rendered. the way that works is it makes the window receive a TICKIT_EV_EXPOSE event the next time tickit_window_flush(3) gets called. and listen — exposed can be NULL, which means "the whole entire window, bestie", no cap.

🫶 if the window, or any of its parents, are hidden, then this function has no effect. like, nothing. zero. nada. it's giving invisible 💀

otherwise? okay so otherwise it enqueues the corresponding area on the root window as being damaged, which causes a TICKIT_EV_EXPOSE event to propagate upwards from the root the next time tickit_window_flush(3) is called. and here's the plot twist: this will propagate up to any window occupying that area, meaning that this window or others may receive it 👀 so like, don't assume it's only your window getting the event, ok?

🌈 RETURN VALUE 🌈

tickit_window_expose() returns no value. it's a void function, it simply does the thing and leaves. main character energy, no receipts 💅

🎀 SEE ALSO 🎀

• tickit_window_new(3)
• tickit_window_flush(3)
• tickit_window_bind_event(3)
• tickit_window(7)
• tickit(7)

and that's the whole page, bestie!! 🍓 this was TICKIT_WINDOW_EXPOSE(3) from the Library Functions Manual — go forth and expose those windows, you absolute icon 💖✨👑