/** * @file sound.cpp * * Implementation of functions setting up the audio pipeline. */ #include "sound.h" #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 void LoadMusic(SDL_RWops *handle) { #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, std::make_unique(), std::make_unique(sgOptions.Audio.nResamplingQuality), /*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.nSoundVolume, 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(path) != 0) { ErrSdl(); } #ifndef STREAM_ALL_AUDIO } else { SDL_RWops *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()).c_str(), __FILE__, __LINE__); } int error = snd->DSB.SetChunk(waveFile, dwBytes); SDL_RWclose(file); if (error != 0) { ErrSdl(); } } #endif return snd; } TSnd::~TSnd() { DSB.Stop(); DSB.Release(); } void snd_init() { sgOptions.Audio.nSoundVolume = CapVolume(sgOptions.Audio.nSoundVolume); gbSoundOn = sgOptions.Audio.nSoundVolume > VOLUME_MIN; sgbSaveSoundOn = gbSoundOn; sgOptions.Audio.nMusicVolume = CapVolume(sgOptions.Audio.nMusicVolume); gbMusicOn = sgOptions.Audio.nMusicVolume > 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.nSampleRate, AUDIO_S16, sgOptions.Audio.nChannels, sgOptions.Audio.nBufferSize)) { 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 SDL_RWops *handle = OpenAsset(trackPath, threadsafe); if (handle != nullptr) { LoadMusic(handle); if (!music->open()) { LogError(LogCategory::Audio, "Aulib::Stream::open (from music_start): {}", SDL_GetError()); CleanupMusic(); return; } music->setVolume(VolumeLogToLinear(sgOptions.Audio.nMusicVolume, VOLUME_MIN, VOLUME_MAX)); 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.nMusicVolume; sgOptions.Audio.nMusicVolume = volume; if (music) music->setVolume(VolumeLogToLinear(sgOptions.Audio.nMusicVolume, VOLUME_MIN, VOLUME_MAX)); return sgOptions.Audio.nMusicVolume; } int sound_get_or_set_sound_volume(int volume) { if (volume == 1) return sgOptions.Audio.nSoundVolume; sgOptions.Audio.nSoundVolume = volume; return sgOptions.Audio.nSoundVolume; } void music_mute() { if (music) music->setVolume(VolumeLogToLinear(VOLUME_MIN, VOLUME_MIN, VOLUME_MAX)); } void music_unmute() { if (music) music->setVolume(VolumeLogToLinear(sgOptions.Audio.nMusicVolume, VOLUME_MIN, VOLUME_MAX)); } } // namespace devilution