apps/openmw/mwbase/soundmanager.hpp

Go to the documentation of this file.

#ifndef GAME_MWBASE_SOUNDMANAGER_H
#define GAME_MWBASE_SOUNDMANAGER_H

#include <string>

#include <boost/shared_ptr.hpp>

#include <components/settings/settings.hpp>

#include "../mwworld/ptr.hpp"

namespace Ogre
{
    class Vector3;
}

namespace MWWorld
{
    class CellStore;
}

namespace MWSound
{
    class Sound;
    class Sound_Decoder;
    typedef boost::shared_ptr<Sound_Decoder> DecoderPtr;
}

namespace MWBase
{
    typedef boost::shared_ptr<MWSound::Sound> SoundPtr;

    class SoundManager
    {
        public:
            /* These must all fit together */
            enum PlayMode {
                Play_Normal  = 0, /* tracked, non-looping, multi-instance, environment */
                Play_Loop    = 1<<0, /* Sound will continually loop until explicitly stopped */
                Play_NoEnv   = 1<<1, /* Do not apply environment effects (eg, underwater filters) */
                Play_NoTrack = 1<<2, /* (3D only) Play the sound at the given object's position
                                      * but do not keep it updated (the sound will not move with
                                      * the object and will not stop when the object is deleted. */

                Play_LoopNoEnv = Play_Loop | Play_NoEnv
            };
            enum PlayType {
                Play_TypeSfx   = 1<<3, /* Normal SFX sound */
                Play_TypeVoice = 1<<4, /* Voice sound */
                Play_TypeFoot  = 1<<5, /* Footstep sound */
                Play_TypeMusic = 1<<6, /* Music track */
                Play_TypeMovie = 1<<7, /* Movie audio track */
                Play_TypeMask  = Play_TypeSfx|Play_TypeVoice|Play_TypeFoot|Play_TypeMusic|Play_TypeMovie
            };

        private:

            SoundManager (const SoundManager&);

            SoundManager& operator= (const SoundManager&);

        public:

            SoundManager() {}

            virtual ~SoundManager() {}

            virtual void processChangedSettings(const Settings::CategorySettingVector& settings) = 0;

            virtual void stopMusic() = 0;

            virtual void streamMusic(const std::string& filename) = 0;

            virtual void startRandomTitle() = 0;

            virtual bool isMusicPlaying() = 0;

            virtual void playPlaylist(const std::string &playlist) = 0;

            virtual void say(const MWWorld::Ptr &reference, const std::string& filename) = 0;

            virtual void say(const std::string& filename) = 0;

            virtual bool sayDone(const MWWorld::Ptr &reference=MWWorld::Ptr()) const = 0;

            virtual void stopSay(const MWWorld::Ptr &reference=MWWorld::Ptr()) = 0;

            virtual SoundPtr playTrack(const MWSound::DecoderPtr& decoder, PlayType type) = 0;

            virtual SoundPtr playSound(const std::string& soundId, float volume, float pitch,
                                       PlayType type=Play_TypeSfx, PlayMode mode=Play_Normal,
                                       float offset=0) = 0;

            virtual SoundPtr playSound3D(const MWWorld::Ptr &reference, const std::string& soundId,
                                         float volume, float pitch, PlayType type=Play_TypeSfx,
                                         PlayMode mode=Play_Normal, float offset=0) = 0;

            virtual void stopSound3D(const MWWorld::Ptr &reference, const std::string& soundId) = 0;

            virtual void stopSound3D(const MWWorld::Ptr &reference) = 0;

            virtual void stopSound(const MWWorld::CellStore *cell) = 0;

            virtual void stopSound(const std::string& soundId) = 0;

            virtual void fadeOutSound3D(const MWWorld::Ptr &reference, const std::string& soundId, float duration) = 0;

            virtual bool getSoundPlaying(const MWWorld::Ptr &reference, const std::string& soundId) const = 0;

            virtual void pauseSounds(int types=Play_TypeMask) = 0;

            virtual void resumeSounds(int types=Play_TypeMask) = 0;

            virtual void update(float duration) = 0;

            virtual void setListenerPosDir(const Ogre::Vector3 &pos, const Ogre::Vector3 &dir, const Ogre::Vector3 &up) = 0;
    };
}

#endif