AUDIOSTREAM(3)

💖 AUDIOSTREAM(3) — the Allegro manual, but make it cute 💖

okay bestie, gather round, we're talking about AUDIOSTREAM — a struct from the Allegro game programming library that literally just... stores an audiostream. that's it. that's the whole job. iconique.

✨ SYNOPSIS ✨

#include <allegro.h>

typedef struct AUDIOSTREAM

🎀 DESCRIPTION 🎀

so inside this little guy lives exactly one field, and here it is:

• int voice; — the hardware voice used for the sample 🌸

that's the member, bestie. it's giving minimalism.

Now for the tea: an AUDIOSTREAM is a structure holding an audiostream, which is basically a convenience wrapper around a SAMPLE structure. what's it for? two very main character reasons:

• it lets you double buffer sounds that are too big to fit into memory 💅
• or it lets you do clever things like generating the sound wave real time ✨

🫶 heads up though: you should not modify the value of the voice directly. don't do it. not even a little. no cap.

but!! the good news is you can use all of the voice functions in the chapter "Digital sample routines" to modify the properties of the sound — like the frequency, for example. so you're not powerless, you just gotta go through the proper channels, iykyk. 👑

🌈 SEE ALSO 🌈

• play_audio_stream(3)
• exstream(3)

and that's the whole page, bestie!! 🦋 this lil writeup came from the Allegro manual, version 4.4.3, and yes the header/footer both said AUDIOSTREAM(3) because that's just how manpages do. mwah, go make some beautiful real-time sound waves, you absolute legend 💖✨🎀