al_create_voice(3)

al_create_voice(3) 💅

okay bestie, welcome to the Library Functions Manual corner of the Allegro 5 API ✨ this page is all about one lil function that sets up a voice, and no cap it’s giving audio-core main character energy 🎧💖

---

💖 NAME 💖

al_create_voice — Allegro 5 API 🫶

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_audio.h>

ALLEGRO_VOICE *al_create_voice(unsigned int freq,
                 ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)

---

🎀 DESCRIPTION 🎀

okay so what does it do? It creates a voice structure and allocates a voice from the digital sound driver 💖

The passed frequency (in Hz), sample format, and channel configuration are used as a hint to what kind of data will be sent to the voice. That’s the key word, bestie: hint 👀 The underlying sound driver is free to use non-matching values. For example, it may be the native format of the sound hardware. So don’t act surprised if the numbers come back different — that’s literally allowed 🌈

If a mixer is attached to the voice, the mixer will handle the conversion of all its input streams to the voice format, and care does not have to be taken for this 🫶 However, if you access the voice directly, make sure to not rely on the parameters passed to this function — instead, query the returned voice for the actual settings. Periodt. That’s the vibe check 💅

Reasonable default arguments are:

al_create_voice(44100, ALLEGRO_AUDIO_DEPTH_INT16, ALLEGRO_CHANNEL_CONF_2)

---

🌈 SEE ALSO 🌈

• al_destroy_voice(3) — that’s the one linked here, bestie 🫶

---

💖 from the Allegro reference manual, al_create_voice(3) — date not listed on this page, and that’s the whole sign-off vibe, no cap 🫶✨