al_get_num_display_modes(3alleg5)

💖 al_get_num_display_modes 💖

okay so bestie, this is the Allegro 5 API page for al_get_num_display_modes, and it's literally the most "how many vibes are available" function ever. let's get into it 🦋

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

int al_get_num_display_modes(void)

no args, no drama, just a number coming back at you 🫶

---

🌸 DESCRIPTION 🌸

so the way this works is: you ask, and it tells you the number of available fullscreen display modes for whatever display parameters you've currently got set. it's giving headcount energy. 👑

and like, it's not just guessing — it goes and uses the values you set with al_set_new_display_refresh_rate(3alleg5) and al_set_new_display_flags(3alleg5) to figure out how many modes actually match. so whatever you configured, that's what it's counting against. iykyk ✨

and here's the little cheat code: if you set the new display parameters to zero, you get a list of all the modes for the default driver. no filtering, no gatekeeping, just everything. periodt. 💅

---

👀 SEE ALSO 👀

• al_get_display_mode(3alleg5) — go here next bestie, it's the matching bestie function fr fr 🎀

---

and that's the whole page!! this cutie lives in the Allegro reference manual and it's the same name up top and down bottom because symmetry slays 💖 go count some modes, you main character, you 🌈⭐