La description

Cette fonction définit le gain maximum (volume) pour le son. Le volume perçu pour un son peut changer en fonction de la valeur de chute et de la position qu'il a par rapport à l' auditeur, mais en réglant le gain avec cette fonction, le volume total ne dépassera jamais la valeur de gain spécifiée. L'image ci-dessous montre comment le gain affecte le volume de l'émetteur lorsque la chute est supérieure à 0:

Cette fonction va changer le volume du son pendant qu'il est joué ainsi que tous les sons suivants joués à travers l'émetteur donné. Notez que sur certaines plates-formes, vous pouvez avoir un gain supérieur à 1, bien qu'une valeur de 1 soit considérée comme un «volume total» et que tout ce qui est supérieur puisse introduire un écrêtage audio.

NOTE: le volume final sera également influencé par le gain audio global qui a été défini par la fonction audio_master_gain.

Syntaxe:

audio_emitter_gain(emitter, gain);

Résultats:

N/A

Exemple:

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

Le code ci-dessus définit la variable "gain" à différentes valeurs, puis utilise cette même variable pour définir le gain de l'émetteur indexé dans la variable "s_emit".