ParaScriptingAudio.h

//-----------------------------------------------------------------------------
// Copyright (C) 2007 - 2010 ParaEngine Co., All Rights Reserved.
// Date:    2010.6
// Description: API for Audio Engine. 
//-----------------------------------------------------------------------------
#pragma once
#include "AudioEngine2.h"

using namespace std;

namespace luabind
{
    namespace adl{
        class object;
    }
    using adl::object;  
}

namespace ParaScripting
{
    using namespace std;
    using namespace ParaEngine;
    using namespace luabind;

    class ParaAudioSource
    {
    public:
        CAudioSource2_ptr m_pAudioSource;
    public:
        ParaAudioSource() {};
        ParaAudioSource(CAudioSource2_ptr& pSource) : m_pAudioSource(pSource) {};

        bool IsValid() const;

        void release();

        bool play();

        const char* GetName();

        bool play2d(bool toLoop);


        bool play3d(float x, float y, float z, float soundstr, bool toLoop);
        
        void pause();

        void stop();

        void loop(bool toLoop);

        bool seek(float seconds, bool relative);

        float getTotalAudioTime();

        int getTotalAudioSize();

        float getCurrentAudioTime();

        int getCurrentAudioPosition();


        bool isValid() const;

        bool isPlaying() const;

        bool isPaused() const;

        bool isStopped() const;

        bool isLooping() const;

        void setPosition(float x, float y, float z);

        void setVelocity(float x, float y, float z);


        void setDirection(float x, float y, float z);

        void setRolloffFactor(float rolloff);


        void setStrength(float soundstrength);

        void setMinDistance(float minDistance);

        void setMaxDistance(float maxDistance);

        void setPitch(float pitch);

        void setVolume(float volume);

        void setMinVolume(float minVolume);

        void setMaxVolume(float maxVolume);

        void setInnerConeAngle(float innerAngle);

        void setOuterConeAngle(float outerAngle);

        void setOuterConeVolume(float outerVolume);
        
        void move(float x, float y, float z);

        void getPosition(float& x, float& y, float& z) const;

        void getVelocity(float& x, float& y, float& z) const;

        void getDirection(float& x, float& y, float& z) const;

        float getRolloffFactor() const;

        float getStrength() const;

        float getMinDistance() const;

        float getMaxDistance() const;

        float getPitch() const;

        float getVolume() const;

        float getMinVolume() const;

        float getMaxVolume() const;

        float getInnerConeAngle() const;

        float getOuterConeAngle() const;

        float getOuterConeVolume() const;
    };

    class PE_CORE_DECL ParaAudio
    {
    public:
        static bool IsAudioEngineEnabled();

        static void EnableAudioEngine(bool bEnable);
        

        static void SetVolume(float fVolume);

        static float GetVolume();
        
        static ParaAudioSource Create(const char* sName, const char* sWavePath, bool bStream);

        static ParaAudioSource Get(const char* sName);

        static ParaAudioSource CreateGet(const char* sName, const char* sWavePath, bool bStream);

        static void SetDistanceModel(int eDistModel);

        //
        // handy functions to play audio files.
        //

        static bool PlayWaveFile(const char* szWavePath, int nLoop);
        static bool PlayWaveFile1(const char* szWavePath);
        static int PlayMidiMsg(DWORD dwMsg);

        static bool StopWaveFile(const char* szWavePath, bool bImmediateStop);
        static bool StopWaveFile1(const char* szWavePath);

        static bool ReleaseWaveFile(const char* szWavePath);


        //
        // the audio listener
        //

        //Note that you will still have to set velocity after this call for proper doppler effects.
        //Use move() if you'd like to have cAudio automatically handle velocity for you. 
        //@param pos: New position for the listener. */
        //static void setPosition(float x, float y, float z);

        //@param dir: New direction vector for the listener. 
        //*/
        //static void setDirection(float x, float y, float z);

        //Default up vector is Y+, same as OpenGL.
        //@param up: New up vector for the listener. */
        //static void setUpVector(float x, float y, float z);

        //@param vel: New velocity for the listener. */
        //static void setVelocity(float x, float y, float z);

        //Velocity will be set to new position - last position 
        //@param pos: New position to move the listener to. */
        //static void move(const PARAVECTOR3& pos);

        //static void getPosition(float& x, float& y, float& z) const;

        //static void getDirection(float& x, float& y, float& z) const;

        //static void getUpVector(float& x, float& y, float& z) const;

        //static void getVelocity(float& x, float& y, float& z) const;
    };
}