set_volume(3alleg4)

✨ set_volume ✨

okay bestie, you found it — the set_volume page from the Allegro manual (that's section 3alleg4 btw, Allegro game programming library, we love her 💖). It does exactly one thing and it does it iconically: it messes with how loud your sound is. Globally. Periodt.

💅 NAME 💅

set_volume — alters the global sound output volume. Allegro game programming library. that's the whole vibe, no notes 🎀

🌸 SYNOPSIS 🌸

#include <allegro.h>

void set_volume(int digi_volume, int midi_volume);

🦋 DESCRIPTION 🦋

So like, this function alters the global sound output volume. That's it. That's the job. 👑

You're passing in volumes for both digital samples and MIDI playback — yes, both, she's an overachiever. They're integers from 0 to 255. That's the range. Live within it. 🌈

And listen, the fun part:

• pass a negative value and it leaves one of the settings unchanged — so if you only wanna touch the digi volume, you can just vibe-check the MIDI one by yeeting a negative in there 🙈
• values bigger than 255 get reduced to 255. not an error, not a crash, she just caps you. humble behavior honestly 💀

⚠️ real talk though — this routine will not alter the volume of the hardware mixer if it exists. i.e. only your application will be affected. so don't go thinking you're turning down the whole machine, bestie, because you are NOT. it's giving main character energy for your app only. 😭

⭐ SEE ALSO ⭐

• install_sound(3alleg4) — go set up your sound first, babe 🫶
• set_hardware_volume(3alleg4) — for when you actually DO wanna touch the hardware mixer 👀

and that's the whole page, slay 💅✨

this little icon dropped in Allegro version 4.4.3, set_volume(3alleg4), and she's been serving ever since. no cap. go make some noise 🎀🦋💖