SoundBuffer.h

Go to the documentation of this file.

//
// C++ Interface: Audio::SoundBuffer
//

#ifndef __AUDIO__SOUND_BUFFER__INCLUDED__
#define __AUDIO__SOUND_BUFFER__INCLUDED__

#include "Exceptions.h"
#include "Format.h"

namespace Audio {

    class SoundBuffer
    {
    private:
        void *buffer;
        unsigned int byteCapacity;
        unsigned int bytesUsed;
        
        Format format;
        
    public:
        SoundBuffer() throw();
        
        SoundBuffer(unsigned int capacity, const Format &format) throw(OutOfMemoryException);
        
        SoundBuffer(const SoundBuffer &other) throw(OutOfMemoryException);
        
        void reserve(unsigned int capacity) throw(OutOfMemoryException);
        
        void reserve(unsigned int capacity, const Format &format) throw(OutOfMemoryException);
        
        unsigned int getByteCapacity() const throw() { return byteCapacity; }
        
        unsigned int getSampleCapacity() const throw() { return byteCapacity / format.frameSize(); }
        
        unsigned int getUsedBytes() const throw()  { return bytesUsed; }
        
        void* getBuffer() throw() { return buffer; }
        
        const void* getBuffer() const throw() { return buffer; }
        
        const Format& getFormat() const { return format; }
        
        void setFormat(const Format &newFormat) throw() { format = newFormat; bytesUsed = 0; }
        
        void setUsedBytes(unsigned int used) throw() { bytesUsed = used; }
        
        unsigned int getSampleCount() const throw() { return bytesUsed / format.frameSize(); }
        
        void reformat(const Format &newFormat) throw(Exception);
        
        SoundBuffer& operator=(const SoundBuffer &other) throw(OutOfMemoryException);
        
        void swap(SoundBuffer &other) throw();
        
        void optimize() throw();
        void clear();
    };

};

#endif//__AUDIO__SOUND_BUFFER__INCLUDED__