al_update_display_region(3alleg5)

al_update_display_region 💅✨

okay bestie, so this one lives in the Allegro 5 API and it's genuinely one of those "small function, big main character energy" situations, iykyk 🫶

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_update_display_region(int x, int y, int width, int height)

---

💖 DESCRIPTION 💖

So here's the tea 🍓: al_update_display_region does exactly the same thing as al_flip_display(3alleg5) — same vibe, same job — but it tries to update only the region you specify. Just that lil rectangle. Nothing more. 💅

And like… with many drivers this is not possible, lowkey sad, but for some drivers it can genuinely improve performance, and when it works? Slay. 🔥

If it's not supported, don't panic — the function just falls back to the behavior of al_flip_display(3alleg5), so you're never left hanging. 🫶

Wanna know beforehand if your driver is gonna come through for you? You can query the support for this function using:

al_get_display_option(display, ALLEGRO_UPDATE_DISPLAY_REGION)

Vibe check your driver first, periodt. 👑

---

🌸 SEE ALSO 🌸

• al_flip_display(3alleg5)
• al_get_display_option(3alleg5)

---

ngl, if you're chasing frames and your driver plays nice, this is the moment. If not — it's still fine, it just does the al_flip_display thing. No cap. 💀

This lil page is part of the Allegro reference manual, and al_update_display_region is the section — so that's the whole vibe, bestie. Go forth and update your regions. 💜🎀🦋