IAudioCapture.h

// Copyright (c) 2008-2010 Raynaldo (Wildicv) Rivera, Joshua (Dark_Kilauea) Jones
// This file is part of the "cAudio Engine"
// For conditions of distribution and use, see copyright notice in cAudio.h

#ifndef IAUDIOCAPTURE_H
#define IAUDIOCAPTURE_H

#include "EAudioFormats.h"
#include "cAudioDefines.h"
#include "ICaptureEventHandler.h"

namespace cAudio
{
        class IAudioCapture
        {
        public:
                IAudioCapture() { }
                virtual ~IAudioCapture() { }


                virtual bool initialize(const char* deviceName = 0x0, unsigned int frequency = 22050, AudioFormats format = EAF_16BIT_MONO, unsigned int internalBufferSize = 8192) = 0;
                virtual bool isSupported() = 0;
                virtual bool isReady() = 0;

                virtual void updateCaptureBuffer(bool force = false) = 0;
                virtual void shutdown() = 0;


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

                virtual unsigned int getAvailableDeviceCount() = 0;

                virtual const char* getDefaultDeviceName() = 0;

                virtual const char* getDeviceName() = 0;
                virtual unsigned int getFrequency() = 0;
                virtual AudioFormats getFormat() = 0;

                virtual unsigned int getInternalBufferSize() = 0;

                virtual unsigned int getSampleSize() = 0;


                virtual bool setDevice(const char* deviceName) = 0;

                virtual bool setFrequency(unsigned int frequency) = 0;

                virtual bool setFormat(AudioFormats format) = 0;

                virtual bool setInternalBufferSize(unsigned int internalBufferSize) = 0;


                virtual bool beginCapture() = 0;
                virtual void stopCapture() = 0;

                virtual unsigned int getCapturedAudio(void* outputBuffer, unsigned int outputBufferSize) = 0;

                virtual unsigned int getCurrentCapturedAudioSize() = 0;


                virtual void registerEventHandler(ICaptureEventHandler* handler) = 0;

                virtual void unRegisterEventHandler(ICaptureEventHandler* handler) = 0;
                virtual void unRegisterAllEventHandlers() = 0;
        
        };


        CAUDIO_API IAudioCapture* createAudioCapture(bool initializeDefault = true);


        CAUDIO_API void destroyAudioCapture(IAudioCapture* capture);


        CAUDIO_API bool isAudioCaptureThreadRunning();
};

#endif