Avec cette fonction, vous pouvez fondre ou atténuer un son sur une durée donnée, ou le régler instantanément. Le temps est mesuré en millisecondes et la fonction nécessite que vous saisissiez un niveau de gain final pour que le son atteigne la fin de ce temps. Ce gain peut être compris entre 0 (silencieux) et 1 (plein volume) et l'échelle est linéaire, de sorte qu'une valeur de 0,5 serait égale à la moitié du volume. Pour modifier instantanément le gain, réglez simplement l'argument time sur 0.
Cette fonction affectera toutes les instances du son en cours de lecture dans la pièce si l'index est une ressource sonore, et le volume final sera le volume auquel toutes les autres occurrences du son seront jouées. Cependant, si vous avez utilisé l'index renvoyé par une fonction audio_play_sound cela affectera seulement cette instance du son.
audio_sound_gain(index, volume, time);
| Argument | La description |
|---|---|
| index | L'indice du son pour régler le gain pour. |
| volume | Valeur pour le volume de la musique. |
| time | La longueur de la variation du gain en millisecondes. |
N/A
if val
{
var snd = audio_play_sound(snd_fountain);
audio_sound_gain(snd, 0, 0);
audio_sound_gain(snd, 1, 5000);
}
Le code ci-dessus vérifie une variable et si elle retourne true il assignera alors l'indice d'un son à lire à la variable locale "snd". Cette variable est ensuite utilisée pour réduire le volume de ce son spécifique à 0 et passer au volume total pendant 5 secondes.