Changes the maximum gain (volume) for an emitter.


audio_emitter_gain(emitter, gain);

Argument Description
emitter The index of the emitter to change.
gain The maximum gain (default 1).

Returns: N/A


This function sets the maximum gain (volume) for the sound. The perceived volume for a sound can change depending on the fall-off value and the position it has relative to the listener, but by setting the gain with this function, the full volume will never exceed the specified gain value. The image below illustrates how gain affects the volume of the emitter when fall-off is greater than 0:

This function will change the volume of the sound while it is being played as well all subsequent sounds played through the given emitter.

NOTE: the final volume will also be influenced by the global audio gain that has been set by the function audio_master_gain.


if up
   gain += 0.05;
   if gain >= 1 up = false;
   gain += 0.05;
   if gain <= 0 up = true;
audio_emitter_gain(s_emit, gain);

The above code sets the variable "gain" to different values and then uses that same variable to set the gain of the emitter indexed in the variable "s_emit".

Back: Audio Emitters
Next: audio_emitter_pitch
© Copyright YoYo Games Ltd. 2015 All Rights Reserved