TICKIT_RENDERBUFFER_GOTO(3)

💖 TICKIT_RENDERBUFFER_GOTO — Library Functions Manual 💖

okay bestie, so this is a page from the Library Functions Manual, and it's about two little functions in the tickit world that handle something called the virtual cursor position. it's giving "where am i pointing right now" energy, and honestly? iconic. 🎀

✨ NAME ✨

tickit_renderbuffer_goto, tickit_renderbuffer_ungoto — set or clear the virtual cursor position 🦋

🌸 SYNOPSIS 🌸

#include <tickit.h>

void tickit_renderbuffer_goto(TickitRenderBuffer *rb, int line, int col);
void tickit_renderbuffer_ungoto(TickitRenderBuffer *rb);

and don't forget, bestie, you gotta link with -ltickit 💅

🫶 DESCRIPTION 🫶

so tickit_renderbuffer_goto() sets the virtual cursor position to the line and col you hand it. and here's the thing — that position does NOT have to be inside the bounds of the buffer's extent, and it doesn't have to be inside the clipping region either. it can just. vibe out there. no cap. 💫

but if you move it outside of the clipping region, then no drawing operations will take effect — however!! the position will still get updated by those operations anyway, so the renderbuffer can keep checking for the moment it slides back into the area of effect once more. it's literally just waiting for its main character moment to return. 👑

also super important: this position is affected by the translation offset that tickit_renderbuffer_translate() gives you. 🧚

then there's tickit_renderbuffer_ungoto(), which clears the virtual cursor position. after you call it, the position is no longer defined, and the cursor-relative output functions will not operate. that's it, that's the vibe — the cursor is gone, the cursor-relative output functions are not operating, we simply don't know where we are anymore. 🙈

⭐ RETURN VALUE ⭐

these functions return no value. nothing. zero. void-coded fr fr. 💀

🔥 SEE ALSO 🔥

• tickit_renderbuffer_new(3)
• tickit_renderbuffer_get_cursorpos(3)
• tickit_renderbuffer_skip(3)
• tickit_renderbuffer_text(3)
• tickit_renderbuffer_erase(3)
• tickit_renderbuffer(7)
• tickit(7)

and that's the whole page, bestie!! 💖 huge shoutout to the Library Functions Manual for hosting this one, and this whole thing is filed under TICKIT_RENDERBUFFER_GOTO(3) — go forth and position your virtual cursor wherever your heart desires (even outside the clipping region, we don't judge). slay, stay hydrated, and may all your drawing operations take effect. 🎀✨🦋🌸💅