AL_ATTACH_AUDIO_STREAM_TO_VOICE(3)

💅 al_attach_audio_stream_to_voice(3) 💅

okay so this one is from the Library Functions Manual, and it is giving Allegro 5 API energy, bestie. Let’s get into it ✨

🌸 NAME 🌸

al_attach_audio_stream_to_voice — Allegro 5 API. That’s the whole name vibe 🫶

✨ SYNOPSIS ✨

#include <allegro5/allegro_audio.h>

bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream,
   ALLEGRO_VOICE *voice)

🎀 DESCRIPTION 🎀

So what it does: it attaches an audio stream to a voice. The same rules as al_attach_sample_instance_to_voice(3) apply — no cap. 💖

This may fail if the driver can’t create a voice with the buffer count and buffer size the stream uses. Like, the driver has to be able to match those numbers, and if it can’t, that’s a fail.

An audio stream attached directly to a voice has a number of limitations:

• The audio stream plays immediately and cannot be stopped.
• The stream position, speed, gain and panning cannot be changed.

🚨 At this time, we don’t recommend attaching audio streams directly to voices. Use a mixer inbetween. This is the “please don’t rawdog the voice attachment” warning, bestie — mixer inbetween is the move.

Returns true on success, false on failure. Simple as that 💀

---

👀 SEE ALSO 👀

• al_detach_voice(3)
• al_voice_has_attachments(3)

---

xoxo, signing off from Allegro reference manual with the footer tag al_attach_...am_to_voice(3) — date: not shown on this footer, so no fake date from me, bestie 💖🎀