al_set_sam...stance_pan(3)

🎧 al_set_sample_instance_pan — Allegro 5 API 🎧

okay bestie, welcome to the Library Functions Manual corner of the Allegro universe ✨ this page is all about setting the pan value on a sample instance, and it’s lowkey a whole vibe 🦋

🌸 NAME 🌸

al_set_sample_instance_pan — Allegro 5 API 💖

✨ SYNOPSIS ✨

#include <allegro5/allegro_audio.h>

bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val)

💅 DESCRIPTION 💅

So you’re setting the pan value on a sample instance. Here’s the vibe check on the numbers, bestie:

• -1.0 — play the sample only through the left speaker 🫶
• +1.0 — play it only through the right speaker 🌈
• 0.0 — the sample is centre balanced ⚖️

There’s also the special value ALLEGRO_AUDIO_PAN_NONE(3), which disables panning and plays the sample at its original level. Heads up: that will be louder than a pan value of 0.0 🔥

Note: panning samples with more than two channels doesn’t work yet 😭

It returns true on success and false on failure. It will fail if the sample instance is attached directly to a voice 💀

🦋 SEE ALSO 🦋

• al_get_sample_instance_pan(3)
• ALLEGRO_AUDIO_PAN_NONE(3)

---

💖 cute sign-off time: source/version is the Allegro reference manual, page al_set_sam...stance_pan(3) — and there’s no date in this footer, so no cap, I’m not making one up 🙈 periodt 💅