set_hardware_volume(3)

set_hardware_volume(3) — Allegro manual 🎀

okay bestie, this is the Allegro page for set_hardware_volume, and it is lowkey about the biggest volume vibe there is: the hardware sound output volume. 💅

✨ NAME ✨

set_hardware_volume — alters the hardware sound output volume. Part of the Allegro game programming library. 🦋

🌸 SYNOPSIS 🌸

#include <allegro.h>

void set_hardware_volume(int digi_volume, int midi_volume);

💖 DESCRIPTION 💖

So, this routine alters the hardware sound output volume. You specify volumes for both digital samples and MIDI playback, as integers from 0 to 255, or you can pass a negative value to leave one of the settings unchanged. Values bigger than 255 will be reduced to 255 — the ceiling is real, no cap. 👑

• digi_volume — the digital samples volume: an integer from 0 to 255, or a negative value to leave this setting unchanged. Values bigger than 255 are reduced to 255.
• midi_volume — the MIDI playback volume: an integer from 0 to 255, or a negative value to leave this setting unchanged. Values bigger than 255 are reduced to 255.

This routine will use the hardware mixer to control the volume if it exists. And bestie, when it does, the volume of all the applications on your machine will be affected — yes, all of them, it's giving main character energy for real. 😭

If the hardware mixer does not exist, this routine does nothing. No mixer, no volume change, no drama. 🫶

🔥 SEE ALSO 🔥

• install_sound(3)
• set_volume(3)

Source: Allegro, version 4.4.3. The footer didn't include a date, so we're just gonna call it timeless, bestie. 💜