al_play_audio_stream_f(3)

💖 NAME 💖

al_play_audio_stream_f — Allegro 5 API

okay so hii bestie 💅 this is the al_play_audio_stream_f(3) page from the Library Functions Manual, and it's literally here to load + play audio from a stream. Let's get into it.

✨ SYNOPSIS ✨

#include <allegro5/allegro_audio.h>

ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident)

🌸 DESCRIPTION 🌸

So this function loads and plays an audio file from an ALLEGRO_FILE(3) stream, and streaming it is needed. That's the vibe. This API can only play one audio stream at a time — yes, one, periodt.

It also requires a default mixer to be set, which is typically done via al_reserve_samples(3), but can also be done via al_set_default_mixer(3). Don't skip that step, bestie 😭.

The file type is determined by the passed ident parameter, which is a file name extension including the leading dot. So don't forget the dot part, iykyk.

Returns the stream on success, NULL on failure.

okay important warning: you must not destroy the returned stream. It will be automatically destroyed when the addon is shut down. On success the file should be considered owned by the audio stream, and will be closed when the audio stream is destroyed. On failure the file will be closed.

Note: the allegro_audio library does not support any audio file formats by default. You must use the allegro_acodec addon, or register your own format handler. no cap, that's the whole tea 🍵.

🦋 SEE ALSO 🦋

• al_play_audio_stream(3)
• al_load_audio_stream_f(3)

⭐ SINCE ⭐

5.2.8

[Unstable API]: New API.

---

mwah 💋 — source/version: Allegro reference manual; date: not printed in the footer, bestie, so that's the whole situation. Page: al_play_audio_stream_f(3) 🫶✨.