al_set_display_icons(3alleg5)

💖 al_set_display_icons — Allegro 5 API 💖

okay bestie, so you're in the 3alleg5 manual, which is literally the Allegro reference manual, and today's main character is al_set_display_icons. it's giving "let me pick the lil pictures that show up for my window" energy. let's go 🦋

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_set_display_icons(ALLEGRO_DISPLAY *display,
   int num_icons, ALLEGRO_BITMAP *icons[])

---

🌸 DESCRIPTION 🌸

so this one changes the icons that are associated with your display (aka your window). and not just one icon, bestie — you can hand it multiple icons and they get used in different contexts, like the window frame, the taskbar, the alt-tab popup… all the places your lil window face shows up. 🌈

the number of icons must be at least one. no icons at all? not a vibe. that's a no. 💀

Note: if the underlying OS needs an icon of a size you did not provide, then one of your bitmaps gets scaled up or down to the required size. and which bitmap it picks? implementation dependent, babes. the OS chooses, not you. 🙈

---

⭐ SINCE ⭐

5.0.9, 5.1.5

like, this has been around since 5.0.9 and 5.1.5. vintage but iconic. 👑

---

🫶 SEE ALSO 🫶

• al_set_display_icon(3alleg5) — the singular version, one icon only, the lil sibling
• al_set_window_title(3alleg5) — for naming your window too, because branding is everything 💅

---

that's the whole page fr fr, no cap. this came to you from the Allegro reference manual, page al_set_display_icons(3alleg5) — go forth and give your window a face, bestie 🎀✨💖