audio_group_set_gain


La description

Cette fonction vous permet de fondre ou de masquer un groupe de sons sur une durée donnée ou de régler instantanément le gain de groupe. Le temps est mesuré en millisecondes et la fonction nécessite que vous saisissiez un niveau de gain final pour le groupe à avoir atteint à la fin de cette période. 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. Notez que sur certaines plateformes, vous pouvez avoir un gain supérieur à 1, bien qu'une valeur de 1 soit considérée comme "full volume" et que quelque chose de plus puisse introduire un écrêtage audio.


Syntaxe:

audio_group_set_gain(groupID, volume, time);


Argument La description
groupID L'index du groupe audio à arrêter (tel que défini dans la fenêtre Groupes audio )
volume La valeur finale pour le volume du groupe.
time La longueur du changement de gain en millisecondes.


Résultats:

N/A


Exemple:

if keyboard_check_pressed(vk_space)
   {
   audio_group_set_gain(audiogroup1, 0, 5000);
   }

Le code ci-dessus vérifie la présence de la touche "espace", puis réduit tout le son de "audiogroup1" à 0 pendant 5 secondes.