IAudioCapture.h

// Copyright (c) 2008-2011 Raynaldo (Wildicv) Rivera, Joshua (Dark_Kilauea) Jones, Murat (wolfmanfx) Sari
// This file is part of the "cAudio Engine"
// For conditions of distribution and use, see copyright notice in cAudio.h
 
#pragma once
 
#include "EAudioFormats.h"
#include "cAudioDefines.h"
#include "ICaptureEventHandler.h"
 
namespace cAudio
{
        // Is responsible to create/destroy a capture buffer
        class  AudioCaptureBuffer;
 
        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 isReady() = 0;
 
                virtual void updateCaptureBuffer(bool force = false) = 0;
                virtual void shutdown() = 0;
 
 
                virtual bool isUpdateThreadRunning() = 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 AudioCaptureBuffer* getCapturedAudioBuffer() = 0;
 
                virtual unsigned int getCurrentCapturedAudioSize() = 0;
 
 
                virtual void registerEventHandler(ICaptureEventHandler* handler) = 0;
 
                virtual void unRegisterEventHandler(ICaptureEventHandler* handler) = 0;
                virtual void unRegisterAllEventHandlers() = 0;  
        };
 
        // Is responsible to create/destroy a capture buffer
        class  AudioCaptureBuffer
        {
        public:
                AudioCaptureBuffer(size_t inlength)
                {
                        length = inlength;
                        buffer = new char[length];
                }
 
                AudioCaptureBuffer(const AudioCaptureBuffer& p)
                {
                        buffer = p.buffer;
                        length = p.length;
                }
 
                ~AudioCaptureBuffer()
                {
                        delete buffer;
                        buffer = NULL;
                }
 
                const char* getReadBuffer() const
                {
                        return buffer;
                }
 
                char* getWriteBuffer()
                {
                        return buffer;
                }
 
                size_t getLength() const
                {
                        return length;
                }
 
        private:
                char* buffer;
                size_t length;
        };
};