al_get_display_mode(3alleg5)

✨ NAME ✨

al_get_display_mode — it's giving Allegro 5 API energy, bestie 💖

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

ALLEGRO_DISPLAY_MODE *al_get_display_mode(int index, ALLEGRO_DISPLAY_MODE *mode)

---

🎀 DESCRIPTION 🎀

okay so. this one snatches you a fullscreen mode, fr fr. 🖥️✨

here's the tea tho — do NOT be out here changing your display parameters between calling al_get_num_display_modes(3alleg5) and al_get_display_mode(3alleg5). like, the two of them are a package deal, a duo, main character energy together. mess with the display in between and the whole vibe check fails. 💀

and index? it's gotta be between 0 and the number returned from al_get_num_display_modes minus 1. so like, 0 through al_get_num_display_modes - 1, no cap. no out-of-bounds shenanigans, we don't do that here. 🙈

mode has to be an allocated ALLEGRO_DISPLAY_MODE structure — like, actually allocated, bestie, not just a vibe. 🫶

what does it give back?

• on failure → it returns NULL 😭
• on success → it returns the mode parameter you passed in, all glowed up and ready 💅

---

🦋 SEE ALSO 🦋

• ALLEGRO_DISPLAY_MODE(3alleg5)
• al_get_num_display_modes(3alleg5)

---

and that's the whole page, icon, you ate that 🍓✨ this lil' legend lives in the Allegro reference manual, and yeah, the page is literally called al_get_display_mode(3alleg5) — same name top and bottom, symmetrical queen 👑💜