AudioGraphBuffers.h

Go to the documentation of this file.

/**********************************************************************
 
  Audacity: A Digital Audio Editor
 
  @file AudioGraphBuffers.h
  @brief Buffers that mediate data transfer between a Source and a Sink
 
  Paul Licameli split from PerTrackEffect.h
 
**********************************************************************/
 
#ifndef __AUDACITY_AUDIO_GRAPH_BUFFERS__
#define __AUDACITY_AUDIO_GRAPH_BUFFERS__
 
#include "SampleFormat.h"
#include <vector>
 
namespace AudioGraph {
 
class AUDIO_GRAPH_API Buffers {
public:
   explicit Buffers(size_t blockSize = 512);
   Buffers(unsigned nChannels, size_t blockSize, size_t nBlocks,
      size_t padding = 0);
   unsigned Channels() const { return mBuffers.size(); }
   size_t BufferSize() const { return mBufferSize; }
   size_t BlockSize() const { return mBlockSize; }
   size_t Position() const {
      return mBuffers.empty() ? 0
         : Positions()[0]
            - reinterpret_cast<const float*>(GetReadPosition(0));
   }
   size_t Remaining() const { return BufferSize() - Position(); }
   bool IsRewound() const { return BufferSize() == Remaining(); }
   void Reinit(unsigned nChannels, size_t blockSize, size_t nBlocks,
      size_t padding = 0);
   float *const *Positions() const { return mPositions.data(); }
 
   void Discard(size_t drop, size_t keep);
 
   void Advance(size_t count);
 
   void Rewind();
 
   size_t Rotate();
 
 
   constSamplePtr GetReadPosition(unsigned iChannel) const;
 
 
   float &GetWritePosition(unsigned iChannel);
 
   void ClearBuffer(unsigned iChannel, size_t n);
private:
   std::vector<std::vector<float>> mBuffers;
   std::vector<float *> mPositions;
   size_t mBufferSize{ 0 };
   size_t mBlockSize{ 0 };
};
}
#endif