Player.h

Go to the documentation of this file.

//Luke Lenhart, 2008
//See /docs/License.txt for details on how this code may be used.

#pragma once

#include "../base/Setup.h"

#ifdef MPMA_COMPILE_AUDIO

#include "Buffer.h"
#include "../base/ReferenceCount.h"
#include "AL_Include.h"

namespace AUDIO
{
    enum RenderMode
    {
        POSITIONAL=0x200,
        FIXED
    };

    //internal data common to all player objects
    struct InternalSharedPlayerData
    {
        inline InternalSharedPlayerData(): player(0), isPlaying(false), isBufferStatic(false)
            {}

        ALuint player;
        Buffer buffer;

        bool isPlaying;
        bool isBufferStatic;
    };

    class Player: public MPMA::ReferenceCountedData<InternalSharedPlayerData>
    {
    public:
        virtual ~Player();

        bool Play(Buffer &buffer, RenderMode mode);

        void Stop();

        bool IsPlaying() const;

        void SetVolume(float value);
        static void SetDefaultVolume(float value);

        void SetPitchMultiplier(float value);
        static void SetDefaultPitchMultiplier(float value);

        void SetPosition(float x, float y, float z);
        template <typename VectorType>
        inline void SetPosition(const VectorType &pos)
            { SetPosition(pos[0], pos[1], pos[2]); }

        void SetVelocity(float x, float y, float z);
        template <typename VectorType>
        inline void SetVelocity(const VectorType &vel)
            { SetVelocity(vel[0], vel[1], vel[2]); }

        void SetCone(float dirX, float dirY, float dirZ, float coneInnerAngle, float coneOutterAngle, float coneOutterAngleVolume);
        template <typename VectorType>
        inline void SetCone(const VectorType &dir, float coneInnerAngle, float coneOutterAngle, float coneOutterAngleVolume)
            { SetCone(dir[0], dir[1], dir[2], coneInnerAngle, coneOutterAngle, coneOutterAngleVolume); }

        void SetDistanceVolumeLimits(float minVolume, float maxVolume);
        static void SetDefaultDistanceVolumeLimits(float minVolume, float maxVolume);

        void SetReferenceDistance(float value);
        static void SetDefaultReferenceDistance(float value);

        void SetMaxDistance(float value);
        static void SetDefaultMaxDistance(float value);

        void SetRolloffFactor(float value);
        static void SetDefaultRolloffFactor(float value);

        //TODO: effects (reverb etc)

    private:

        //Sets up a player to match our state (what openal calls a source)
        void InitPlayer();
    };
}

#endif //#ifdef MPMA_COMPILE_AUDIO