Jak 2/3 - New Custom Audio Functions

[Nick0778]

This PR implements the following custom audio functions:

• is-any-sound-playing?
• is-sound-playing?
• pause-all-sounds
• resume-all-sounds

I also made changes to main, default-menu and scene, to automatically pause and resume any custom audio when opening or closing the Progress Menu, the Debug Menu, or the Popup Menu, as well as during cutscenes.

Example of usage:

(when (not (is-any-sound-playing?))
   (play-sound-file "TORN010.wav" (the int (* (-> *setting-control* user-default dialog-volume) 100.0)))
   )

(when (not (is-sound-playing? "TORN010.wav"))
   (play-sound-file "TORN010.wav" (the int (* (-> *setting-control* user-default dialog-volume) 100.0)))
   )

(when (is-any-sound-playing?)
   (pause-all-sounds)
   )

[Zedb0T]

You would need to scope these changes, being able to play custom audio during the progress menu or cutscenes is a feature that is used in mods like Jak the chicken for custom cutscenes and Mario legacy for pause/title menu music

[Nick0778]

You would need to scope these changes, being able to play custom audio during the progress menu or cutscenes is a feature that is used in mods like Jak the chicken for custom cutscenes and Mario legacy for pause/title menu music

So, would you recommend that I remove these changes from the engine code to allow people to do those kinds of things in their mods?

[Nick0778]

Actually, the changes in scene are meant to stop custom audio when a cutscene ends (the problem is that I made it stop all custom audios) in case there's any custom audio playing during the cutscene for voice acting or anything else. They also allow the cutscene to be paused in Debug Mode by pressing X, and completely stop the custom audio when speeding up or slowing down the cutscene, since I haven't implemented a system to handle that with custom audio.

But yeah, if it's better to remove these changes, I can do that.