al_set_display_icons(3)

🎀 NAME 🎀

al_set_display_icons — Allegro 5 API

Okay bestie, this is al_set_display_icons(3) from the Library Functions Manual, and it’s literally the “give your window a cute icon situation” function. Manual name folded in near the top like a lil name tag. 💖

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

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

💅 DESCRIPTION 💅

Changes the icons associated with the display — yep, the window. You can hand over multiple icons so they can be used in different contexts, like the window frame, taskbar, and alt-tab popup. The number of icons must be at least one. No zero-icon nonsense, bestie. 🫶

⚠️ Note: If the underlying OS requires an icon of a size not provided, then one of the bitmaps will be scaled up or down to the required size. The choice of bitmap is implementation dependent. So the OS might resize one of your baddies, and which one it picks is up to the implementation. 👀

🦋 SINCE 🦋

5.0.9, 5.1.5 — this one has been around since those versions, periodt. ✨

🌈 SEE ALSO 🌈

• al_set_display_icon(3)
• al_set_window_title(3)

Go check those out too, they’re in the same icon/window-title friend group. 💅

---

Source/version: Allegro reference manual; page: al_set_display_icons(3) — date: not printed on the original footer, so no fake timestamp from me, bestie. 💋