al_load_sample(3)

💖 al_load_sample(3) 💖

okay so bestie, welcome to al_load_sample(3) from the Library Functions Manual — aka the Allegro 5 API corner of the universe. it’s giving audio-loading main character energy, and we’re gonna get through it together 🫶✨

---

✨ NAME ✨

al_load_sample — Allegro 5 API 💅

---

🦋 SYNOPSIS 🦋

#include <allegro5/allegro_audio.h>

ALLEGRO_SAMPLE *al_load_sample(const char *filename)

---

🌸 DESCRIPTION 🌸

So this one loads a few different audio file formats, and it picks based on their extension — like, the filename tells it what vibe it’s dealing with 🎀

⚠️ heads up, bestie: this stores the entire file in memory at once, which may be time consuming. no cap, it’s a whole “load it all now” situation.

If you want to read the file as it is needed instead, use al_load_audio_stream(3) or al_play_audio_stream(3) — those are the streaming girlies, iykyk 🌈

It returns the sample on success, and NULL on failure. periodt.

💀 Note: the allegro_audio library does not support any audio file formats by default. You must use the allegro_acodec addon, or register your own format handler. literally cannot stress this enough — no default formats, bestie, none 😭

---

🎀 SEE ALSO 🎀

• al_register_sample_loader(3) 🔥
• al_init_acodec_addon(3) 🌟

---

with love from the Allegro reference manual (source/version vibes), page al_load_sample(3) — and this footer didn’t print a date, so no fake date here, bestie 💜🫶💅