AL_SET_SAMPLE_INSTANCE_GAIN(3)

✨ al_set_sample_instance_gain(3) ✨

okay so the header on this one is doing the classic al_set_sam...stance_gain(3) truncation moment, and the manual name is Library Functions Manual from the Allegro reference manual — hi bestie, welcome to the audio corner 💖🎧

🌸 NAME 🌸

al_set_sample_instance_gain - Allegro 5 API 🎀

🦋 SYNOPSIS 🦋

#include <allegro5/allegro_audio.h>

bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val)

🎀 DESCRIPTION 🎀

So this function sets the playback gain of the sample instance. That’s the gain vibe for playback, iykyk. 🎚️✨

• It returns true on success and false on failure. Periodt.
• It will fail if the sample instance is attached directly to a voice. Yep, that’s the caveat, bestie — not a vibe to ignore 😭💀

⚠️ real talk: the fail condition is literally “sample instance is attached directly to a voice.” That’s it. No cap.

🦋 SEE ALSO 🦋

• al_get_sample_instance_gain(3) — the getter bestie linked right there, obviously 👑✨

---

and that’s the whole page, bestie 🫶 Cute sign-off: source/version is the Allegro reference manual, the footer tag is al_set_sam...stance_gain(3), and the original footer doesn’t show a separate date here — so I’m not inventing one, fr fr 💅✨