init_menu(3alleg4)

📦 version 4.4.3.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 init_menu — it's giving "build your own menu loop" ✨

okay bestie, welcome to the Allegro manual — yes, init_menu(3alleg4), the Allegro game programming library, we're doing this 💅

🌸 NAME 🌸

init_menu — low level initialisation of a menu. Allegro game programming library. no cap, that's literally the whole vibe 🎀

🦋 SYNOPSIS 🦋

#include <allegro.h>

MENU_PLAYER *init_menu(MENU *menu, int x, int y);

✨ DESCRIPTION ✨

so like. this function gives you lower level access to the exact same functionality as do_menu(), except — and this is the iconic part — it lets you combine a popup menu with your own program control structures. main character energy fr fr 👑

it initialises a menu, and returns a pointer to a menu player object that you can use with update_menu() and shutdown_menu(). those two are your new besties, keep them close 🫶

and the way that you could implement your own version of do_menu() with these functions?? obsessed. it's literally these lines:

MENU_PLAYER *player = init_menu(menu, x, y);

while (update_menu(player))
   ;

return shutdown_menu(player);

like. that's it. that's the whole loop. ate and left no crumbs 💅

🌈 SEE ALSO 🌈

go read those too, bestie, iykyk 💜

⭐ reminder: this is the low level one. if you just want the menu to do its thing without babysitting it, do_menu() is right there and it's slaying on your behalf.

okay that's the whole page 🍓 this was Allegro version 4.4.3, page init_menu(3alleg4) — mwah, go forth and pop up some menus 💖✨🎀

📦 where this page comes from