ALLEGRO_AUDIO_DEPTH(3)

💖 ALLEGRO_AUDIO_DEPTH 💖

okay so bestie, we're diving into the Allegro 5 API today — this is from the Library Functions Manual, section 3, and it's all about ALLEGRO_AUDIO_DEPTH. it's a little enum that tells you how audio samples are stored. not scary, i promise. 🎀

---

✨ NAME ✨

ALLEGRO_AUDIO_DEPTH — literally just the Allegro 5 API. that's the whole vibe. 💅

---

🦋 SYNOPSIS 🦋

like, here's how you actually get to it:

#include <allegro5/allegro_audio.h>

enum ALLEGRO_AUDIO_DEPTH

yes queen, it's an enum. she's a type. 🫶

---

🌸 DESCRIPTION 🌸

so what is this actually for? it describes a sample's depth (how many bits), its type (int or float), and its signedness (signed or unsigned). the whole thing in one neat little package.

here's the tea though — mixers only use 32-bit signed float (range -1..+1), or 16-bit signed integers. that's it. that's the whole menu for mixers. anything else is not getting mixed, periodt. 😭

and how does signedness work?? it's determined by an "unsigned" bit-flag that gets applied on top of the depth value. cute, right? a little bit-flag doing a lot of work. 🔥

so the actual depth values are:

• ALLEGRO_AUDIO_DEPTH_INT8 — 8-bit signed integer, bestie 💜
• ALLEGRO_AUDIO_DEPTH_INT16 — 16-bit signed integer, iconic 🌈
• ALLEGRO_AUDIO_DEPTH_INT24 — 24-bit signed integer, highkey fancy ⭐
• ALLEGRO_AUDIO_DEPTH_FLOAT32 — 32-bit float, main character energy 👑
• ALLEGRO_AUDIO_DEPTH_UNSIGNED — the bit-flag itself, flip it to make things unsigned 💅

---

🎀 For convenience 🎀

because the Allegro girlies are always thinking of us, they pre-combined the unsigned flag with the int depths so you don't have to:

• ALLEGRO_AUDIO_DEPTH_UINT8 — 8-bit unsigned 🍓
• ALLEGRO_AUDIO_DEPTH_UINT16 — 16-bit unsigned 🧚
• ALLEGRO_AUDIO_DEPTH_UINT24 — 24-bit unsigned 🦋

so instead of doing the flag math yourself, you just grab the UINT version. no cap, it's giving convenience. 💖

ngl, remember: convenience names or not, mixers still only touch 32-bit signed float and 16-bit signed int. don't come for me, that's just what the page says 💀

---

💫 sign-off 💫

and that's the page!! this was the Allegro reference manual edition of ALLEGRO_AUDIO_DEPTH(3), brought to you by the fine folks who maintain the Allegro docs. go make some noise, bestie 🌸✨🎀