al_reserve_samples(3)

al_reserve_samples(3) 🎀

okay bestie, welcome to the Library Functions Manual page for al_reserve_samples(3) from the Allegro 5 API — yes, she’s iconic, yes, she handles audio sample reservations ✨

---

💖 NAME 💖

al_reserve_samples — Allegro 5 API 🎧

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_audio.h>

bool al_reserve_samples(int reserve_samples)

---

🎀 DESCRIPTION 🎀

So al_reserve_samples(int reserve_samples) reserves a number of sample instances, and attaches them to the default mixer. If no default mixer is set when this function is called, then it will create one and attach it to the default voice. If no default voice has been set, it, too, will be created. slay 💅

⚠️ Careful, bestie: if you call this function a second time with a smaller number of samples, then the excess internal sample instances will be destroyed. That causes some sounds to stop, and some instances returned by al_lock_sample_id(3) to be invalidated. no cap, that’s the important part 😭

This diagram illustrates the structures that are set up:

                                                    sample instance 1
                                                  / sample instance 2
              default voice <-- default mixer <---         .
                                                  \        .
                                                    sample instance N

Returns true on success, false on error. al_install_audio(3) must have been called first. periodt 🌸

---

🦋 SEE ALSO 🦋

• al_set_default_mixer(3)
• al_play_sample(3)

---

that’s the whole page, bestie 🫶 — source/version vibes: Allegro reference manual; page: al_reserve_samples(3); date: not listed in the original footer, so I’m not making one up 💀✨