al_store_state(3alleg5)

✨ NAME ✨

al_store_state — the Allegro 5 API function that's literally out here saving your thread's state like a screenshot of the vibe 💾✨ (yes bestie, this page lives in the 3alleg5 manual, iykyk)

---

🌸 SYNOPSIS 🌸

void al_store_state(ALLEGRO_STATE *state, int flags)

---

🎀 DESCRIPTION 🎀

okay so picture this: you're deep in your thread, everything's set up just how you like it, and you want to keep that moment. that's what al_store_state does — it stores part of the state of the current thread into the ALLEGRO_STATE object you hand it. no cap. 🫶

and the flags parameter? that's the fun part. it can take any bit-combination of these flags, so mix and match however you want:

• ALLEGRO_STATE_NEW_DISPLAY_PARAMETERS — grabs new_display_format, new_display_refresh_rate, and new_display_flags 💅
• ALLEGRO_STATE_NEW_BITMAP_PARAMETERS — grabs new_bitmap_format and new_bitmap_flags 🎨
• ALLEGRO_STATE_DISPLAY — grabs current_display 👑
• ALLEGRO_STATE_TARGET_BITMAP — grabs target_bitmap 🎯
• ALLEGRO_STATE_BLENDER — grabs blender 🌀
• ALLEGRO_STATE_TRANSFORM — grabs current_transformation 🦋
• ALLEGRO_STATE_PROJECTION_TRANSFORM — grabs current_projection_transformation 🌈
• ALLEGRO_STATE_NEW_FILE_INTERFACE — grabs new_file_interface 📁
• ALLEGRO_STATE_BITMAP — the combo meal: same as ALLEGRO_STATE_NEW_BITMAP_PARAMETERS and ALLEGRO_STATE_TARGET_BITMAP 🍓
• ALLEGRO_STATE_ALL — all of the above, the whole entire menu, absolutely ate 🔥

ngl bestie, if you're gonna save it, you might as well know how to put it back — that's what al_restore_state is for 😭

---

💖 SEE ALSO 💖

• al_restore_state(3alleg5)
• ALLEGRO_STATE(3alleg5)

---

and that's the whole page, babe 💜 this was al_store_state(3alleg5) straight out of the Allegro reference manual — go store that state, you icon, periodt ✨👑