ALLEGRO_AUDIO_PAN_NONE(3alleg5)

💖 NAME 💖

ALLEGRO_AUDIO_PAN_NONE — the Allegro 5 API's lil magic number that says "bestie, do NOT pan this one" 🎀 (it lives in the 3alleg5 manual, iykyk)

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_audio.h>

#define ALLEGRO_AUDIO_PAN_NONE      (-1000.0f)

---

🌸 DESCRIPTION 🌸

okay so listen. ALLEGRO_AUDIO_PAN_NONE is a special value for the pan property of sample instances and audio streams. You drop this value in when you want to disable panning on a sample instance or an audio stream, and it'll play them with no attenuation — none of that volume-dipping that the panning support would otherwise imply. no cap. 🫶

and here's the tea, bestie, because this is the part that trips people up: ALLEGRO_AUDIO_PAN_NONE is NOT the same as a pan value of 0.0 (which is centered). Why? Because when panning is enabled, Allegro tries to maintain a constant sound power level as a sample gets panned from left to right. The whole vibe is: a sound coming out of one speaker should sound exactly as loud as it does when it's split over two speakers. 💅

and the consequence of that? a sample with a pan value of 0.0 will be 3 dB softer than the original level. yes, literally. that's the price of physics being physics. 💀

(Please correct us if this is wrong.) — direct quote from the Allegro devs, and honestly? icon behaviour. they said "we're pretty sure but yell at us if not" and that's main character energy fr fr. 🙈

---

that's the whole page, babe — short, sweet, and absolutely essential if you've ever wondered why your centered sound is mysteriously quieter than your unpanned one. 🌈

signing off with love from the Allegro reference manual 💖 and remember the name on the door: ALLEGRO_AUDIO_PAN_NONE(3alleg5) ⭐ slay, go forth, and pan responsibly 🎀🦋