IParaAudioEngine.h

#pragma once
#include "PEtypes.h"

namespace ParaEngine
{
    enum ParaAudioFormats
    {
        EAF_8BIT_MONO, 
        EAF_8BIT_STEREO,
        EAF_16BIT_MONO,
        EAF_16BIT_STEREO
    };

    enum ParaAudioFlagsEnum
    {
        AUDIO_FLAG_Uninitialized = 0,
        AUDIO_FLAG_STOP_RELEASE,
        AUDIO_FLAG_STOP_IMMEDIATE,
    };
    enum ParaAudioDistanceModelEnum
    {
        Audio_DistModel_NONE = 0, 
        Audio_DistModel_INVERSE_DISTANCE, 
        Audio_DistModel_INVERSE_DISTANCE_CLAMPED, 
        Audio_DistModel_LINEAR_DISTANCE, 
        Audio_DistModel_LINEAR_DISTANCE_CLAMPED, 
        Audio_DistModel_EXPONENT_DISTANCE, 
        Audio_DistModel_EXPONENT_DISTANCE_CLAMPED,
    };

    class IAudioSourceEventHandler
    {
    public:
        virtual void onUpdate() = 0;

        virtual void onRelease() = 0;

        virtual void onPlay() = 0;

        virtual void onStop() = 0;

        virtual void onPause() = 0;
    };

    class IParaAudioSource
    {
    public:
        virtual bool play() = 0;

        virtual bool play2d(const bool& toLoop = false) = 0;

        virtual bool play3d(const PARAVECTOR3& position, const float& soundstr = 1.0 , const bool& toLoop = false) = 0;
        
        virtual void pause() = 0;

        virtual void stop() = 0;


        virtual void loop(const bool& toLoop) = 0;


        virtual bool seek(const float& seconds, bool relative = false) = 0;

        virtual float getTotalAudioTime() = 0;

        virtual int getTotalAudioSize() = 0;

        virtual int getCompressedAudioSize() = 0;

        virtual float getCurrentAudioTime() = 0;

        virtual int getCurrentAudioPosition() = 0;

        virtual int getCurrentCompressedAudioPosition() = 0;

        virtual bool update() = 0;

        virtual void release() = 0;

        virtual const bool isValid() const = 0;

        virtual const bool isPlaying() const = 0;

        virtual const bool isPaused() const = 0;

        virtual const bool isStopped() const = 0;

        virtual const bool isLooping() const = 0;


        virtual void setPosition(const PARAVECTOR3& position) = 0;


        virtual void setVelocity(const PARAVECTOR3& velocity) = 0;


        virtual void setDirection(const PARAVECTOR3& direction) = 0;


        virtual void setRolloffFactor(const float& rolloff) = 0;


        virtual void setStrength(const float& soundstrength) = 0;


        virtual void setMinDistance(const float& minDistance) = 0;


        virtual void setMaxDistance(const float& maxDistance) = 0;


        virtual void setPitch(const float& pitch) = 0;


        virtual void setVolume(const float& volume) = 0;


        virtual void setMinVolume(const float& minVolume) = 0;


        virtual void setMaxVolume(const float& maxVolume) = 0;


        virtual void setInnerConeAngle(const float& innerAngle) = 0;


        virtual void setOuterConeAngle(const float& outerAngle) = 0;


        virtual void setOuterConeVolume(const float& outerVolume) = 0;


        virtual void setDopplerStrength(const float& dstrength) = 0; 


        virtual void setDopplerVelocity(const PARAVECTOR3& dvelocity) = 0;


        virtual void move(const PARAVECTOR3& position) = 0;

        virtual const PARAVECTOR3 getPosition() const = 0;

        virtual const PARAVECTOR3 getVelocity() const = 0;

        virtual const PARAVECTOR3 getDirection() const = 0;

        virtual const float getRolloffFactor() const = 0;

        virtual const float getStrength() const = 0;

        virtual const float getMinDistance() const = 0;

        virtual const float getMaxDistance() const = 0;

        virtual const float getPitch() const = 0;

        virtual const float getVolume() const = 0;

        virtual const float getMinVolume() const = 0;

        virtual const float getMaxVolume() const = 0;

        virtual const float getInnerConeAngle() const = 0;

        virtual const float getOuterConeAngle() const = 0;

        virtual const float getOuterConeVolume() const = 0;

        virtual const float getDopplerStrength() const = 0;

        virtual const PARAVECTOR3 getDopplerVelocity() const = 0;

        virtual void registerEventHandler(IAudioSourceEventHandler* handler) = 0;

        virtual void unRegisterAllEventHandlers() = 0;
    };

    class IParaAudioEngine
    {
    public:
        virtual void Release() = 0;


        virtual bool initialize(const char* deviceName = 0x0, int outputFrequency = -1, int eaxEffectSlots = 4) = 0;

        virtual void shutDown() = 0;

        virtual void update() = 0;


        virtual IParaAudioSource* getSoundByName(const char* name) = 0;

        virtual void releaseAllSources() = 0;


        virtual void release(IParaAudioSource* source) = 0;


        virtual const char* getAvailableDeviceName(unsigned int index) = 0;
        

        virtual unsigned int getAvailableDeviceCount() = 0;
        

        virtual const char* getDefaultDeviceName() = 0;


        virtual IParaAudioSource* create(const char* name, const char* filename, bool stream = false) = 0;
        

        virtual IParaAudioSource* createFromMemory(const char* name, const char* data, size_t length, const char* extension) = 0;
        

        virtual IParaAudioSource* createFromRaw(const char* name, const char* data, size_t length, unsigned int frequency, ParaAudioFormats format) = 0;

    public:
        virtual void SetDistanceModel(ParaAudioDistanceModelEnum eDistModel) = 0;


        virtual void setPosition(const PARAVECTOR3& pos) = 0;

        virtual void setDirection(const PARAVECTOR3& dir) = 0;

        virtual void setUpVector(const PARAVECTOR3& up) = 0;

        virtual void setVelocity(const PARAVECTOR3& vel) = 0;

        virtual void setMasterVolume(const float& volume) = 0;


        virtual void move(const PARAVECTOR3& pos) = 0;

        virtual PARAVECTOR3 getPosition(void) const = 0;

        virtual PARAVECTOR3 getDirection(void) const = 0;

        virtual PARAVECTOR3 getUpVector(void) const = 0;

        virtual PARAVECTOR3 getVelocity(void) const = 0;

        virtual float getMasterVolume(void) const = 0;

        virtual void SetCoordinateSystem(int nLeftHand) = 0;
    };
}