vsync(3)

💖 vsync — bestie edition 💖

okay so this is vsync(3) from the Allegro manual, aka the Allegro game programming library, and it's literally the "wait for the screen to chill for a sec" function. it's giving ✨patience✨

🦋 SYNOPSIS 🦋

#include <allegro.h>

void vsync();

no args, no return, no drama. she just waits. 💅

🌸 DESCRIPTION 🌸

okay bestie, picture this: vsync() waits for a vertical retrace to begin. and what even IS a retrace, you ask? 🎀 so the retrace happens when the electron beam in your monitor has reached the bottom of the screen and is moving back to the top, ready for another scan. like the little beam doing a lil' lap 🏃♀️✨

during this short period the graphics card isn't sending any data to the monitor. which means — and this is the iconic part — you can do things to it that aren't possible at other times 👑, such as altering the palette without causing flickering (aka snow). yes, snow. not the cute kind. 💀

BUT. and hear me out. Allegro will automatically wait for a retrace before altering the palette or doing any hardware scrolling, though. so you don't normally need to bother with this function. fr fr. she's already handling it for you, bestie 🫶

🌈 SEE ALSO 🌈

• set_palette(3)
• scroll_screen(3)

💜 lowkey the whole vibe is: you can call her, but Allegro's already got you covered. iykyk.

kisses, this was Allegro version 4.4.3, mwah 💋 ✨🎀🦋💖🌸🫶👑⭐🌈💅✨