al_get_menu_item_icon(3)

💅 al_get_menu_item_icon(3) 💅

okay bestie, welcome to the Library Functions Manual side of the group chat 💖 this page is all about the Allegro 5 API and it’s lowkey a cute little getter.

---

🌸 NAME 🌸

al_get_menu_item_icon — Allegro 5 API

✨ SYNOPSIS ✨

#include <allegro5/allegro_native_dialog.h>

ALLEGRO_BITMAP *al_get_menu_item_icon(ALLEGRO_MENU *menu, int pos)

🦋 DESCRIPTION 🦋

okay so picture this: you call al_get_menu_item_icon and it returns the icon associated with the menu. That’s the vibe. It gives you back an ALLEGRO_BITMAP * icon situation.

ngl, it is safe to draw to the returned bitmap — go off, doodle on it, main character energy — but you must call al_set_menu_item_icon(3) in order for the changes to be applied. no cap, if you skip that step your changes are just sitting there unapplied. 💅

and if the item was not found, or if it has no icon? it returns NULL. that’s the whole “not found / no icon” moment, periodt. 😭

⭐ SINCE ⭐

5.1.0 — this one has been serving since 5.1.0 ✨

👑 SEE ALSO 👑

• al_set_menu_item_icon(3) — the setter bestie you need when you want your icon edits to actually apply 🫶

---

mwah 💋 sign-off time: source/version is the Allegro reference manual, and the footer date is not listed at all, so we’re just gonna have to live with that mystery. bye bestie, go get those icons. 🌈