al_register_bitmap_saver_f(3alleg5)

💖 al_register_bitmap_saver_f 💖

okay bestie, welcome to the Allegro reference manual ✨ this one's a lil niche but it's literally so useful, stay with me 🫶

✨ NAME ✨

al_register_bitmap_saver_f — Allegro 5 API 👑

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

bool al_register_bitmap_saver_f(const char *extension,
   bool (*fs_saver)(ALLEGRO_FILE *fp, ALLEGRO_BITMAP *bmp))

---

🎀 DESCRIPTION 🎀

So basically, this is how you tell Allegro "hey, when someone wants to save a bitmap with this file extension, run this function." 💅 It hooks your handler up to al_save_bitmap_f(3alleg5), and the function you hand over gets called whenever a bitmap is being saved to a file with that extension. iconic behavior, honestly.

The extension you pass in should include the leading dot (.) character — like, don't be out here rawdogging it with "png", it wants ".png" bestie 😭. And it gets matched case-insensitively, so ".PNG" and ".png" are the same vibe, no drama 🌈.

The fs_saver argument can be NULL if you wanna unregister an entry. yes, you can just ghost it like that 💀.

It returns true on success, and false on error. And ngl, it also returns false if you try to unregister an entry that doesn't even exist — so don't come for an entry that was never there, it will not be having it 🙈.

---

👑 SEE ALSO 👑

• al_register_bitmap_saver(3alleg5) — the sibling, go say hi 🦋

---

that's the whole page, you ate it, no crumbs ✨ this was brought to you by the Allegro reference manual, page al_register_bitmap_saver_f(3alleg5), mwah 💋💖