Fonctions de base sur les sons

Il existe cinq fonctions de base ayant trait aux sons, deux pour lire un son, une pour vérifier si un son est actuellement en cours de lecture et deux autres pour arrêter les sons. La plupart d'entres elles prennent comme argument l'index du son. Le nom du son représente son index. Mais il vous est possible de stocker cet index dans une variable puis de l'utiliser.

sound_play(index) Joue une seule fois le son indiqué. Si le son est de type musique d'arrière-plan, la musique d'arrière-plan courante sera interrompue.
sound_loop(index) Joue en continu le son indiqué. Si le son est de type arrière-plan, la musique d'arrière-plan courante sera interrompue.
sound_stop(index) Arrête le son indiqué. Dans le cas où plusieurs sons de même index sont en cours de lecture, tous les sons seront stoppés.
sound_stop_all() Arrête tous les sons.
sound_isplaying(index) Retourne si le son indiqué (ou une copie de ce son) est en cours de lecture. Veuillez noter que cette fonction retourne true lorsque le son est joué à travers les hauts-parleurs. Après avoir appelé la fonction pour jouer un son, ce dernier n'atteint pas immédiatement les hauts-parleurs. Aussi, la fonction peut retourner false comme valeur pendant un certain laps de temps. De façon similaire, lorsque vous arrêtez un son, vous pouvez encore l'entendre pendant un certain temps (à cause de l'écho) et la fonction retournera alors true.

Il est possible d'utiliser des effets sonores plus évolués. En particulier, vous pourrez changer le volume et le pan, c'est à dire si le son doit arriver du haut-parleur de gauche ou de droite. Dans tous les cas, le volume peut seulement être réduit. Ces fonctions ne fonctionnent pas pour les fichiers joués par le lecteur multimédia (comme les fichiers mp3).

sound_volume(index, value) Change le volume du son indiqué (0 = faible, 1 = fort).
sound_global_volume(value) Change le volume global de tous les sons (0 = faible, 1 = fort).
sound_fade(index, value, time) Change le volume du son indiqué avec une nouvelle valeur (0 = faible, 1 = fort) pendant la période de temps mentionnée (en millisecondes). Cela peut être utile pour créer un effet de fading out ou in sur une musique.
sound_pan(index, value) Change le pan du son indiqué (-1 = gauche, 0 = centre, 1 = droit).
sound_background_tempo(factor) Change le tempo de la musique d'arrière-plan (si c'est un fichier midi). factor indique le facteur avec lequel le tempo doit être multiplié. Une valeur de 1 correspond à un tempo normal. De plus grandes valeurs indiqueront un tempo plus rapide alors que de plus petites valeurs signifieront un tempo plus lent. Doit être compris entre 0.01 et 100.

En plus des fichiers midi et wave (et des fichiers mp3), il existe un quatrième type de fichier musical : les fichiers de musique directe (direct music files). Ceux-ci ont l'extension .sgt. Ces fichiers font référence souvent à d'autres fichiers décrivant la bande (band) ou l'information de style. Pour trouver ces fichiers, le système de sons doit connaître précisément où ces sons sont localisés. A cet effet, vous pourrez utiliser les fonctions suivantes pour déterminer le répertoire de recherche de ces fichiers. Veuillez noter que c'est à vous d'ajouter ces fichiers. Game Maker n'inclue pas automatiquement ce genre de fichiers supplémentaires.

sound_set_search_directory(dir) Détermine le répertoire dans lequel les fichiers de type musique directe (direct music files) seront cherchés. La chaîne dir ne doit pas comprendre de backslash (\) à la fin.