al_show_na...ile_dialog(3)

💖 NAME 💖

okay so bestie, this page is al_show_na...ile_dialog(3) from the Library Functions Manual, and it's literally all about the Allegro 5 API function below 👑✨

• al_show_native_file_dialog — Allegro 5 API 🎀

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_native_dialog.h>

bool al_show_native_file_dialog(ALLEGRO_DISPLAY *display,
   ALLEGRO_FILECHOOSER *dialog)

---

🦋 DESCRIPTION 🦋

So the whole vibe is: show the dialog window 💅. The display can be NULL, and if it isn't, then the given display is treated as the parent if possible 🌸.

Fair warning, bestie: this function blocks the calling thread until it returns 😭. So you may want to spawn a thread with al_create_thread(3) and call it from inside that thread. That's the move 🫶.

It returns true on success and false on failure. No cap 💀.

Note: On Android, ALLEGRO_EVENT_DISPLAY_HALT_DRAWING(3) and ALLEGRO_EVENT_DISPLAY_RESUME_DRAWING(3) need to be handled before this function returns. This means that you must call it from a different thread. Like, actually different-thread different-thread 🙈.

---

mwah 💋 — signed off by the Allegro reference manual, page al_show_na...ile_dialog(3) 🎀✨