al_register_bitmap_loader_f(3alleg5)

✨ al_register_bitmap_loader_f — Allegro 5 API ✨

okay bestie, pull up a chair, we're doing the allegro5 manual today and honestly? this one is a lil hidden gem 💎

---

🎀 NAME 🎀

al_register_bitmap_loader_f — that's the whole thing, that's the name, it's giving Allegro 5 API and we love her for it 🫶

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

bool al_register_bitmap_loader_f(const char *extension,
   ALLEGRO_BITMAP *(*fs_loader)(ALLEGRO_FILE *fp, int flags))

look at that signature. she's got a function pointer and everything. very main character energy, no cap 💅

---

💖 DESCRIPTION 💖

so basically, this function registers a handler for al_load_bitmap_f(3alleg5). like, you're telling Allegro "hey, when someone loads a bitmap file with this extension, use this function of mine to do it." iconic delegation behavior, honestly 👑

here's the tea on the arguments:

• extension — the file extension you're claiming. it should include the leading dot (.), so like .png, not png. and ngl, it gets matched case-insensitively, so .PNG and .png are the same vibe ✨
• fs_loader — your loader function. it takes an ALLEGRO_FILE *fp and an int flags, and hands you back an ALLEGRO_BITMAP *. 🦋 and hmm, important: this argument may be NULL — that's how you unregister an entry. yes bestie, NULL is the "actually nvm, forget this one" button 🙈

and what does she return?

• true on success 🎉
• false on error 😭
• and specifically? she returns false if you try to unregister an entry that doesn't exist. so don't come for entries that were never there, she will simply say no 💀

---

👑 SEE ALSO 👑

• al_register_bitmap_loader(3alleg5) — the sibling, the other one, go read her too fr fr 🌈

---

that's the whole page, bestie. now go register some loaders, you absolute legend 🧚

this came to you straight from the <b>Allegro reference manual</b> — that's the source/version, and the page signs off as <b>al_register_bitmap_loader_f(3alleg5)</b>. mwah, bye 💜