al_set_sample_instance_pan(3alleg5)

💖 al_set_sample_instance_pan — Allegro 5 API 💖

okay bestie, so we're in the Allegro 5 API today and this one is genuinely one of my faves because it's the "which speaker tho" button for your audio. let's get into it 🎧✨

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_audio.h>

bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val)

like yes, one function, two args, we love a low-effort icon 💅

---

🦋 DESCRIPTION 🦋

so you pass in your sample instance spl and a float val, and it sets the pan value on that sample instance. that's it. that's the whole vibe.

and the val numbers? lemme break it down because it's giving stereo geometry:

• -1.0 — plays the sample only through the left speaker 🫶
• +1.0 — plays it only through the right speaker 💅
• 0.0 — the sample is centre balanced, dead middle, main character in the middle of the stage 👑

and then there's the special value ALLEGRO_AUDIO_PAN_NONE(3alleg5) — this one disables panning entirely and plays the sample at its original level. and lowkey important: this will be louder than a pan value of 0.0. like yes it's technically the "no notes" option and it goes harder. not a bug, just facts ✨

🙈 note: panning samples with more than two channels doesn't work yet. like bestie it's giving unfinished business, so don't come for me if you try it with your fancy multichannel stuff.

---

🌈 what it gives back

• returns true on success 💖
• returns false on failure 😭
• and it will fail if the sample instance is attached directly to a voice. no cap, that's a hard no.

---

🎀 SEE ALSO 🎀

• al_get_sample_instance_pan(3alleg5)
• ALLEGRO_AUDIO_PAN_NONE(3alleg5)

---

and that's the whole page fr fr. this little gem lives in the Allegro reference manual (the al_set_sample_instance_pan(3alleg5) page, if you're keeping track 📝). go pan something, you got this 🧚💜