DOKK / manpages / debian 13 / libsdl3-doc / SDL_SetAudioStreamGain.3.en
SDL_SetAudioStreamGain(3) SDL3 FUNCTIONS SDL_SetAudioStreamGain(3)

SDL_SetAudioStreamGain - Change the gain of an audio stream.

Defined in SDL3/SDL_audio.h

#include "SDL3/SDL.h"
bool SDL_SetAudioStreamGain(SDL_AudioStream *stream, float gain);

The gain of a stream is its volume; a larger gain means a louder output, with a gain of zero being silence.

Audio streams default to a gain of 1.0f (no change in output).

This is applied during SDL_GetAudioStreamData , and can be continuously changed to create various effects.

the stream on which the gain is being changed.
the gain. 1.0f is no change, 0.0f is silence.

Returns true on success or false on failure; call

SDL_GetError () for more information.

It is safe to call this function from any thread, as it holds a stream-specific mutex while running.

This function is available since SDL 3.2.0.

(3), SDL_GetAudioStreamGain(3)

SDL 3.2.10 Simple Directmedia Layer