al_set_sample_instance_gain(3alleg5)

💖 al_set_sample_instance_gain — Allegro 5 API 💖

okay bestie, welcome to the allegro5 manual, the section for the al_set_sample_instance_gain function. yes this is the glow-up your sample instance has been waiting for ✨

---

✨ NAME ✨

al_set_sample_instance_gain — the Allegro 5 API function that sets a sample instance's playback gain, no cap 🎀

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_audio.h>

bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val)

like. look at her. iconic signature fr fr 💅

---

🦋 DESCRIPTION 🦋

so what does she even do?? she sets the playback gain of the sample instance. that's it, that's the whole vibe. the spl is your sample instance and val is the gain you're giving her. slay.

she returns true on success and false on failure — so always check the return value, bestie, don't just assume it ate 🙈

⚠️ and heads up: she will fail if the sample instance is attached directly to a voice. like, not a vibe, not negotiable, it just won't work. if that's your setup you're gonna get false back and you're gonna have to deal with it 💀

---

💜 SEE ALSO 💜

• al_get_sample_instance_gain(3alleg5) — the little sister function that reads the gain back out, go say hi 🫶

---

and that's the whole page, periodt 🎀 this came to you straight from the Allegro reference manual — the al_set_sample_instance_gain(3alleg5) page, so you know the source. no date on this one, she's timeless like that ⭐💖