free_audio_stream_buffer(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

💖 free_audio_stream_buffer(3) 💖

okay bestie, welcome to the Allegro manual — yes, the Allegro game programming library, we're doing retro audio streaming today and it's giving main character energy ✨

🎀 NAME 🎀

free_audio_stream_buffer — literally just tells the audio stream player that new data can be played now. that's it. that's the whole job. 💅

🦋 SYNOPSIS 🦋

#include <allegro.h>

void free_audio_stream_buffer(AUDIOSTREAM *stream);

✨ DESCRIPTION ✨

so here's the tea 🍓 — you call this function after get_audio_stream_buffer() hands you back a non-NULL address. calling it is your way of saying "bestie, I filled that spot with a brand new block of samples, go ahead and play it" 🔥

like, you're the one doing the loading, and this is how you hand the data back to the player. mutual trust. it's a whole relationship. 🫶

here's how it looks in practice:

mem_chunk = get_audio_stream_buffer(buffer);
if (mem_chunk != NULL) {
   /* Refill the stream buffer. */
   ...
   free_audio_stream_buffer(buffer);
}

see how get_audio_stream_buffer() gives you the chunk, you check it's not NULL, you refill it, and then you free it? iconic. no notes. ⭐

ngl if you call this without a non-NULL address from get_audio_stream_buffer() first, you're just out here vibing wrong — do the get first, then the free. that's the order. periodt. 💀

👑 SEE ALSO 👑

that's the whole page, babe! this little gem lives in Allegro, version 4.4.3 — go forth, stream your audio, and remember: get first, free after, always. mwah 💋🌈💜

📦 where this page comes from