Stream.h

Go to the documentation of this file.

//
// C++ Interface: Audio::Codec
//
#ifndef __AUDIO_STREAM_H__INCLUDED__
#define __AUDIO_STREAM_H__INCLUDED__

#include <string>
#include "Exceptions.h"
#include "Format.h"

namespace Audio {

    class Stream
    {
    private:
        std::string filePath;
        Format streamFormat;
        
        void* curBufferPos;
    
    protected:
        class NoBufferException : public Exception {
        public:
            NoBufferException() {}
            NoBufferException(const NoBufferException &other) : Exception(other) {}
            explicit NoBufferException(const std::string &message) : Exception(message) {}
        };
        
    protected:
        Stream(const std::string& path) throw(Exception);
        
        Format& getFormatInternal() throw() { return streamFormat; }
    
    public:
        virtual ~Stream();
        
        const std::string& getPath() const throw() { return filePath; };
        
        const Format& getFormat() const throw() { return streamFormat; }
        
        double getLength() throw(Exception);
        
        unsigned int read(void *buffer, unsigned int bufferSize) throw(Exception);
        
        double getPosition() const throw();
        
        void seek(double position) throw(Exception);
        
        // The following section contains all the virtual functions that need be implemented
        // by a concrete Stream class. All are protected, so the stream interface is independent
        // of implementations.
    protected:
        
        virtual double getLengthImpl() const throw(Exception) = 0;
        
        virtual double getPositionImpl() const throw() = 0;
        
        virtual void seekImpl(double position) throw(Exception) = 0;
        
        virtual void getBufferImpl(void *&buffer, unsigned int &bufferSize) throw(Exception) = 0;
        
        virtual void nextBufferImpl() throw(Exception) = 0;
    };

};

#endif//__AUDIO_STREAM_H__INCLUDED__