/** * @file sound.cpp * * Implementation of functions setting up the audio pipeline. */ #include "sound.h" #include #include #include #include #include #include #include #include #include #include #include "engine/assets.hpp" #include "init.h" #include "options.h" #include "utils/log.hpp" #include "utils/math.h" #include "utils/sdl_mutex.h" #include "utils/stdcompat/algorithm.hpp" #include "utils/stdcompat/optional.hpp" #include "utils/stdcompat/shared_ptr_array.hpp" #include "utils/stubs.h" namespace devilution { bool gbSndInited; /** The active background music track id. */ _music_id sgnMusicTrack = NUM_MUSIC; bool gbMusicOn = true; /** Specifies whether sound effects are enabled. */ bool gbSoundOn = true; namespace { std::optional music; #ifdef DISABLE_STREAMING_MUSIC std::unique_ptr musicBuffer; #endif std::unique_ptr CreateDecoder(bool isMp3) { if (isMp3) return std::make_unique(); return std::make_unique(); } std::string GetMp3Path(const char *path) { std::string mp3Path = path; const std::string::size_type dot = mp3Path.find_last_of('.'); mp3Path.replace(dot + 1, mp3Path.size() - (dot + 1), "mp3"); return mp3Path; } void LoadMusic(SDL_RWops *handle, bool isMp3) { #ifdef DISABLE_STREAMING_MUSIC size_t bytestoread = SDL_RWsize(handle); musicBuffer.reset(new char[bytestoread]); SDL_RWread(handle, musicBuffer.get(), bytestoread, 1); SDL_RWclose(handle); handle = SDL_RWFromConstMem(musicBuffer.get(), bytestoread); #endif music.emplace(handle, CreateDecoder(isMp3), std::make_unique(*sgOptions.Audio.resamplingQuality), /*closeRw=*/true); } void CleanupMusic() { music = std::nullopt; sgnMusicTrack = NUM_MUSIC; #ifdef DISABLE_STREAMING_MUSIC musicBuffer = nullptr; #endif } std::list> duplicateSounds; std::optional duplicateSoundsMutex; SoundSample *DuplicateSound(const SoundSample &sound) { auto duplicate = std::make_unique(); if (duplicate->DuplicateFrom(sound) != 0) return nullptr; auto *result = duplicate.get(); decltype(duplicateSounds.begin()) it; { const std::lock_guard lock(*duplicateSoundsMutex); duplicateSounds.push_back(std::move(duplicate)); it = duplicateSounds.end(); --it; } result->SetFinishCallback([it]([[maybe_unused]] Aulib::Stream &stream) { const std::lock_guard lock(*duplicateSoundsMutex); duplicateSounds.erase(it); }); return result; } /** Maps from track ID to track name in spawn. */ const char *const SpawnMusicTracks[NUM_MUSIC] = { "Music\\sTowne.wav", "Music\\sLvlA.wav", "Music\\sLvlA.wav", "Music\\sLvlA.wav", "Music\\sLvlA.wav", "Music\\DLvlE.wav", "Music\\DLvlF.wav", "Music\\sintro.wav", }; /** Maps from track ID to track name. */ const char *const MusicTracks[NUM_MUSIC] = { "Music\\DTowne.wav", "Music\\DLvlA.wav", "Music\\DLvlB.wav", "Music\\DLvlC.wav", "Music\\DLvlD.wav", "Music\\DLvlE.wav", "Music\\DLvlF.wav", "Music\\Dintro.wav", }; int CapVolume(int volume) { return clamp(volume, VOLUME_MIN, VOLUME_MAX); } } // namespace void ClearDuplicateSounds() { const std::lock_guard lock(*duplicateSoundsMutex); duplicateSounds.clear(); } void snd_play_snd(TSnd *pSnd, int lVolume, int lPan) { if (pSnd == nullptr || !gbSoundOn) { return; } uint32_t tc = SDL_GetTicks(); if (tc - pSnd->start_tc < 80) { return; } SoundSample *sound = &pSnd->DSB; if (sound->IsPlaying()) { sound = DuplicateSound(*sound); if (sound == nullptr) return; } sound->Play(lVolume, *sgOptions.Audio.soundVolume, lPan); pSnd->start_tc = tc; } std::unique_ptr sound_file_load(const char *path, bool stream) { auto snd = std::make_unique(); snd->start_tc = SDL_GetTicks() - 80 - 1; #ifndef STREAM_ALL_AUDIO if (stream) { #endif if (snd->DSB.SetChunkStream(GetMp3Path(path), /*isMp3=*/true, /*logErrors=*/false) != 0) { SDL_ClearError(); if (snd->DSB.SetChunkStream(path, /*isMp3=*/false, /*logErrors=*/true) != 0) { ErrSdl(); } } #ifndef STREAM_ALL_AUDIO } else { bool isMp3 = true; SDL_RWops *file = OpenAsset(GetMp3Path(path).c_str()); if (file == nullptr) { SDL_ClearError(); isMp3 = false; file = OpenAsset(path); if (file == nullptr) { ErrDlg("OpenAsset failed", path, __FILE__, __LINE__); } } size_t dwBytes = SDL_RWsize(file); auto waveFile = MakeArraySharedPtr(dwBytes); if (SDL_RWread(file, waveFile.get(), dwBytes, 1) == 0) { ErrDlg("Failed to read file", fmt::format("{}: {}", path, SDL_GetError()), __FILE__, __LINE__); } int error = snd->DSB.SetChunk(waveFile, dwBytes, isMp3); SDL_RWclose(file); if (error != 0) { ErrSdl(); } } #endif return snd; } TSnd::~TSnd() { DSB.Stop(); DSB.Release(); } void snd_init() { sgOptions.Audio.soundVolume.SetValue(CapVolume(*sgOptions.Audio.soundVolume)); gbSoundOn = *sgOptions.Audio.soundVolume > VOLUME_MIN; sgbSaveSoundOn = gbSoundOn; sgOptions.Audio.musicVolume.SetValue(CapVolume(*sgOptions.Audio.musicVolume)); gbMusicOn = *sgOptions.Audio.musicVolume > VOLUME_MIN; // Initialize the SDL_audiolib library. Set the output sample rate to // 22kHz, the audio format to 16-bit signed, use 2 output channels // (stereo), and a 2KiB output buffer. if (!Aulib::init(*sgOptions.Audio.sampleRate, AUDIO_S16, *sgOptions.Audio.channels, *sgOptions.Audio.bufferSize)) { LogError(LogCategory::Audio, "Failed to initialize audio (Aulib::init): {}", SDL_GetError()); return; } LogVerbose(LogCategory::Audio, "Aulib sampleRate={} channels={} frameSize={} format={:#x}", Aulib::sampleRate(), Aulib::channelCount(), Aulib::frameSize(), Aulib::sampleFormat()); duplicateSoundsMutex.emplace(); gbSndInited = true; } void snd_deinit() { if (gbSndInited) { Aulib::quit(); duplicateSoundsMutex = std::nullopt; } gbSndInited = false; } void music_stop() { if (music) CleanupMusic(); } void music_start(uint8_t nTrack) { const char *trackPath; assert(nTrack < NUM_MUSIC); music_stop(); if (gbMusicOn) { if (spawn_mpq) trackPath = SpawnMusicTracks[nTrack]; else trackPath = MusicTracks[nTrack]; #ifdef DISABLE_STREAMING_MUSIC const bool threadsafe = false; #else const bool threadsafe = true; #endif bool isMp3 = true; SDL_RWops *handle = OpenAsset(GetMp3Path(trackPath).c_str()); if (handle == nullptr) { SDL_ClearError(); handle = OpenAsset(trackPath, threadsafe); isMp3 = false; } if (handle != nullptr) { LoadMusic(handle, isMp3); if (!music->open()) { LogError(LogCategory::Audio, "Aulib::Stream::open (from music_start): {}", SDL_GetError()); CleanupMusic(); return; } music->setVolume(VolumeLogToLinear(*sgOptions.Audio.musicVolume, VOLUME_MIN, VOLUME_MAX)); if (!diablo_is_focused()) music_mute(); if (!music->play(/*iterations=*/0)) { LogError(LogCategory::Audio, "Aulib::Stream::play (from music_start): {}", SDL_GetError()); CleanupMusic(); return; } sgnMusicTrack = (_music_id)nTrack; } } } void sound_disable_music(bool disable) { if (disable) { music_stop(); } else if (sgnMusicTrack != NUM_MUSIC) { music_start(sgnMusicTrack); } } int sound_get_or_set_music_volume(int volume) { if (volume == 1) return *sgOptions.Audio.musicVolume; sgOptions.Audio.musicVolume.SetValue(volume); if (music) music->setVolume(VolumeLogToLinear(*sgOptions.Audio.musicVolume, VOLUME_MIN, VOLUME_MAX)); return *sgOptions.Audio.musicVolume; } int sound_get_or_set_sound_volume(int volume) { if (volume == 1) return *sgOptions.Audio.soundVolume; sgOptions.Audio.soundVolume.SetValue(volume); return *sgOptions.Audio.soundVolume; } void music_mute() { if (music) music->mute(); } void music_unmute() { if (music) music->unmute(); } } // namespace devilution