From 12156a7bd05edcde7a5bc09ff80f7529c6649dca Mon Sep 17 00:00:00 2001 From: YYBartT Date: Wed, 4 Dec 2024 16:52:09 +0100 Subject: [PATCH] docs(general): note on error when audio group isn't loaded https://github.com/YoYoGames/GameMaker-Bugs/issues/235 Added a note to the Audio Groups page that mentions an error will be shown in the console when an audio group isn't loaded --- .../Asset_Management/Audio/Audio_Groups/Audio_Groups.htm | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Asset_Management/Audio/Audio_Groups/Audio_Groups.htm b/Manual/contents/GameMaker_Language/GML_Reference/Asset_Management/Audio/Audio_Groups/Audio_Groups.htm index 8bb25fd82..0c86268a0 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Asset_Management/Audio/Audio_Groups/Audio_Groups.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Asset_Management/Audio/Audio_Groups/Audio_Groups.htm @@ -4,7 +4,7 @@ Audio Groups - + @@ -19,6 +19,7 @@

Audio Groups

You can create these audio groups from the Audio Groups window - which can be opened from The Tools Menu at the top of the IDE - and you can assign your audio assets to a specific group from the Sound Properties Window.

Each audio group has its own gain. The gain of all sounds in an audio group is multiplied by that audio group's gain. The default value is 1 but it can be changed using audio_group_set_gain and retrieved using audio_group_get_gain respectively.

 All audio groups can be accessed in code through a constant that GameMaker defines for each of the groups. The default audio group is audiogroup_default. To get the name of the group as a string you can use audio_group_name.

+

 Trying to play a sound using the audio_play_sound* functions from an audio group that's not loaded will not play anything and return a sound instance index of -1. An error message is also output to the console.

Function Reference

Group Info