/* * The ManaPlus Client * Copyright (C) 2004-2009 The Mana World Development Team * Copyright (C) 2009-2010 The Mana Developers * Copyright (C) 2011-2019 The ManaPlus Developers * * This file is part of The ManaPlus Client. * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #ifndef SOUNDMANAGER_H #define SOUNDMANAGER_H #include "enums/simpletypes/skiperror.h" #include "listeners/configlistener.h" #include "localconsts.h" PRAGMA48(GCC diagnostic push) PRAGMA48(GCC diagnostic ignored "-Wshadow") #include PRAGMA48(GCC diagnostic pop) class SDLMusic; /** SoundManager * * \ingroup CORE */ class SoundManager final : public ConfigListener { public: SoundManager(); A_DELETE_COPY(SoundManager) ~SoundManager() override final; void optionChanged(const std::string &value) override final; /** * Installs the sound engine. */ void init(); void testAudio(); /** * Removes all sound functionalities. */ void close(); /** * Starts background music. * * @param fileName The name of the music file. */ void playMusic(const std::string &fileName, const SkipError skipError); /** * Stops currently running background music track. */ void stopMusic(); /** * Fades in background music. * * @param fileName The name of the music file. * @param ms Duration of fade-in effect (ms) */ // void fadeInMusic(const std::string &fileName, const int ms = 1000); /** * Fades out currently running background music track. * * @param ms Duration of fade-out effect (ms) */ void fadeOutMusic(const int ms); /** * Fades out a background music and play a new one. * * @param fileName The name of the music file. * @param ms Duration of fade-out effect (ms) */ void fadeOutAndPlayMusic(const std::string &fileName, const int ms); constexpr static int getMaxVolume() A_WARN_UNUSED { return MIX_MAX_VOLUME; } void setMusicVolume(const int volume); void setSfxVolume(const int volume); /** * Plays an item. * * @param path The resource path to the sound file. */ void playSfx(const std::string &path, const int x, const int y) const; /** * Plays an item for gui. * * @param path The resource path to the sound file. */ void playGuiSfx(const std::string &path); void playGuiSound(const std::string &name); void changeAudio(); void volumeOff() const; void volumeRestore() const; std::string getCurrentMusicFile() const noexcept2 A_WARN_UNUSED { return mCurrentMusicFile; } /** * The sound logic. * Currently used to check whether the music file can be freed after * a fade out, and whether new music has to be played. */ void logic(); void shutdown(); void setChannels(const int channels) const; private: /** Logs various info about sound device. */ static void info(); /** Halts and frees currently playing music. */ void haltMusic(); /** * When calling fadeOutAndPlayMusic(), * the music file below will then be played */ std::string mNextMusicFile; bool mInstalled; int mSfxVolume; int mMusicVolume; std::string mCurrentMusicFile; SDLMusic *mMusic; int mGuiChannel; bool mPlayBattle; bool mPlayGui; bool mPlayMusic; bool mFadeoutMusic; bool mCacheSounds; }; extern SoundManager soundManager; #endif // SOUNDMANAGER_H