al_register_sample_loader(3alleg5)

💖 al_register_sample_loader 💖

okay bestie, welcome to the Allegro 5 API — yes that's 3alleg5, that's the manual we're in, and today we're talking about teaching Allegro how to open your weird little audio file format. let's go 🎀

---

✨ NAME ✨

al_register_sample_loader — the glow-up that lets al_load_sample handle a brand new file extension, no cap 💅

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_audio.h>

bool al_register_sample_loader(const char *ext,
   ALLEGRO_SAMPLE *(*loader)(const char *filename))

---

🦋 DESCRIPTION 🦋

so here's the tea 🍓 — you call this and you're basically registering a handler for al_load_sample(3alleg5). the function you hand over? that's the one that's gonna be in charge of loading sample files that have the extension you picked.

the extension you pass in should include the leading dot (the . character). and the way it gets matched? case-insensitively. so like .WAV and .wav are the same vibe, she doesn't care ✨

the loader argument can be NULL — and that's you unregistering an entry, lowkey a breakup 💔

as for the return value: it gives you back true on success, false on error. and heads up 👑 — it also returns false if you try to unregister an entry that doesn't even exist. yeah. nothing to cancel, bestie 😭

ngl that last one is important: unregistering something that was never registered = false. don't be surprised, it's not a bug, it's just honest fr fr.

---

🌈 SEE ALSO 🌈

• al_register_sample_loader_f(3alleg5) — the fancy float-y sibling 🧚
• al_register_sample_saver(3alleg5) — for when you're saving instead of loading, iconic ⭐

---

and that's the whole page, bestie 🫶 — this was pulled straight from the Allegro reference manual, and yes, al_register_sample_loader(3alleg5) is the manual name, so if you ever need to cite her, that's the one 💜 go forth and load your samples 💅✨