al_wait_for_vsync(3)

✨ NAME ✨

al_wait_for_vsync — Allegro 5 API, bestie 💖. It’s a page from the Library Functions Manual, and the whole thing is al_wait_for_vsync(3).

🦋 SYNOPSIS 🦋

#include <allegro5/allegro.h>

bool al_wait_for_vsync(void)

💅 DESCRIPTION 💅

Okay so this function waits for the beginning of a vertical retrace. That’s the vibe. ✨ Some driver/card/monitor combinations may not be capable of this, and that is genuinely not your fault. 🙈

Also, important note: al_flip_display(3) usually already waits for the vertical retrace, so unless you are doing something special, there is no reason to call this function. Like, none. Don’t be extra for no reason. 💀

It returns false if not possible, and true if successful. That’s it. Periodt.

🎀 SEE ALSO 🎀

• al_flip_display(3) — the one that usually already handles the vertical retrace waiting for you. 🫶

---

Cute sign-off: source/version is the Allegro reference manual, and the footer didn’t list a date, so I’m not inventing one. Stay slay, bestie. 💖✨