al_set_menu_item_icon(3)

💅 al_set_menu_item_icon(3) 💅

okay so we're in the Library Functions Manual, bestie, and this is the Allegro 5 API page for giving a menu item an icon. very main character energy ✨

---

🎀 NAME 🎀

al_set_menu_item_icon — the Allegro 5 API function that sets a menu item's icon, periodt 💅

---

📜 SYNOPSIS 📜

copy this exactly, no cap:

#include <allegro5/allegro_native_dialog.h>

void al_set_menu_item_icon(ALLEGRO_MENU *menu, int pos, ALLEGRO_BITMAP *icon)

---

🌸 DESCRIPTION 🌸

okay so this one sets the icon for the specified menu item. iconic, literally.

but bestie, listen: the menu assumes ownership of the ALLEGRO_BITMAP and may invalidate the pointer, so you must clone it if you wish to continue using it. no cap, that part is important 😭

⚠️ ownership vibe check: the menu takes the bitmap, and that pointer can get invalidated. clone it if you still wanna keep using it. fr fr.

if a video bitmap is passed, it will automatically be converted to a memory bitmap, so it is preferable to pass a memory bitmap. highkey the move is a memory bitmap 🫶

---

⭐ SINCE ⭐

5.1.0 — she's been serving since 5.1.0, and that's that on that 🎀

---

🔥 SEE ALSO 🔥

• al_get_menu_item_icon(3) — the getter bestie, for when you want to grab that icon energy back 👑
• al_clone_bitmap(3) — clone that bitmap so you don't lose it, periodt 💜

---

💖 okay that's the whole tea, bestie — source: Allegro reference manual, page: al_set_menu_item_icon(3), and the footer doesn't show a date, so no date to spill 🌈💅