al_attach_sam...ance_to_voice(3alleg5)

✨ NAME ✨

al_attach_sample_instance_to_voice — it's giving Allegro 5 API, bestie 💖

This one lives in the 3alleg5 section of the Allegro reference manual, and it's a whole little audio-hookup moment.

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_audio.h>

bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl,
   ALLEGRO_VOICE *voice)

---

🎀 DESCRIPTION 🎀

Okay so what this does is attach a sample instance to a voice, which is what lets it actually play. Slay. 🎶

But here's the tea, and you need to hear it: the instance's gain and loop mode get ignored — literally not even looked at, they just sit there like 🙈 — and the instance must have the same frequency, channel configuration and depth (including signed-ness!!) as the voice. No mixing and matching, no cap. ✋

Also, heads up: this function may fail if the selected driver doesn't support preloading sample data. Not her fault, it's a driver thing. 💀

At this time, we don't recommend attaching sample instances directly to voices. Use a mixer inbetween. 🫶 (yes this is in the actual docs, they said it, not me)

It returns true on success and false on failure. Periodt. ⭐

---

👑 SEE ALSO 👑

• al_detach_voice(3alleg5)
• al_voice_has_attachments(3alleg5)

---

Anyway bestie that's the whole page — brought to you by the Allegro reference manual, section 3alleg5. Go forth and attach responsibly 💅✨🎀🦋