#include <WaveTrackSink.h>

Inheritance diagram for WaveTrackSink:

Collaboration diagram for WaveTrackSink:

Public Member Functions
	WaveTrackSink (WaveTrack &left, WaveTrack *pRight, sampleCount start, bool isGenerator, bool isProcessor, sampleFormat effectiveFormat)

	~WaveTrackSink () override

bool	AcceptsBuffers (const Buffers &buffers) const override
	Accepts buffers only if there is at least one channel. More...

bool	Acquire (Buffers &data) override
	Guarantee empty space in Buffers before they are written. More...

bool	Release (const Buffers &data, size_t curBlockSize) override
	Acknowledge receipt of data in Buffers, which caller may then Advance() More...

void	Flush (Buffers &data, double t0, double t1)

Public Member Functions inherited from AudioGraph::Sink
virtual	~Sink ()

virtual bool	AcceptsBuffers (const Buffers &buffers) const =0

virtual bool	Acquire (Buffers &data)=0
	Guarantee empty space in Buffers before they are written. More...

virtual bool	Release (const Buffers &data, size_t curBlockSize)=0
	Acknowledge receipt of data in Buffers, which caller may then Advance() More...

Private Member Functions
void	DoConsume (Buffers &data)

Private Attributes
WaveTrack &	mLeft

WaveTrack *const	mpRight

const std::shared_ptr< WaveTrack >	mGenLeft

const std::shared_ptr< WaveTrack >	mGenRight

const bool	mIsProcessor

const sampleFormat	mEffectiveFormat

sampleCount	mOutPos

Additional Inherited Members
Public Types inherited from AudioGraph::Sink
using	Buffers = AudioGraph::Buffers

Detailed Description

Definition at line 25 of file WaveTrackSink.h.

Constructor & Destructor Documentation

◆ WaveTrackSink()

WaveTrackSink::WaveTrackSink	(	WaveTrack &	left,
		WaveTrack *	pRight,
		sampleCount	start,
		bool	isGenerator,
		bool	isProcessor,
		sampleFormat	effectiveFormat
	)

Parameters

effectiveFormat This argument affects processors only, not generators

Definition at line 21 of file WaveTrackSink.cpp.

   : mLeft{ left }, mpRight{ pRight }
   , mGenLeft{ isGenerator ? left.EmptyCopy() : nullptr }
   , mGenRight{ pRight && isGenerator ? pRight->EmptyCopy() : nullptr }
   , mIsProcessor{ isProcessor }
   , mEffectiveFormat{ effectiveFormat }
   , mOutPos{ start }
{
}

◆ ~WaveTrackSink()

WaveTrackSink::~WaveTrackSink ( )

overridedefault

Member Function Documentation

◆ AcceptsBuffers()

bool WaveTrackSink::AcceptsBuffers ( const Buffers & buffers ) const

overridevirtual

Accepts buffers only if there is at least one channel.

Implements AudioGraph::Sink.

Definition at line 35 of file WaveTrackSink.cpp.

{
   return buffers.Channels() > 0;
}

References AudioGraph::Buffers::Channels().

Here is the call graph for this function:

◆ Acquire()

bool WaveTrackSink::Acquire ( Buffers & data )

overridevirtual

Guarantee empty space in Buffers before they are written.

Returns: success

Postcondition: result: !result || data.BlockSize() <= data.Remaining()

Implements AudioGraph::Sink.

Definition at line 40 of file WaveTrackSink.cpp.

{
   if (data.BlockSize() <= data.Remaining()) {
      // post is satisfied
   }
   else
      // Output buffers have (mostly) filled
      // (less than one block remains; maybe nonzero because of samples
      // discarded for initial latency correction)
      DoConsume(data);
   return true;
}

References AudioGraph::Buffers::BlockSize(), DoConsume(), and AudioGraph::Buffers::Remaining().

Here is the call graph for this function:

◆ DoConsume()

void WaveTrackSink::DoConsume ( Buffers & data )

private

Precondition: data.Channels() > 0

Postcondition: data.BlockSize() <= data.Remaining()

Definition at line 59 of file WaveTrackSink.cpp.

{
   // Satisfy pre of GetReadPosition()
   assert(data.Channels() > 0);
   const auto inputBufferCnt = data.Position();
   if (inputBufferCnt > 0) {
      // Some data still unwritten
      if (mIsProcessor) {
         mLeft.Set(data.GetReadPosition(0),
            floatSample, mOutPos, inputBufferCnt, mEffectiveFormat);
         if (mpRight)
            mpRight->Set(data.GetReadPosition(1),
               floatSample, mOutPos, inputBufferCnt, mEffectiveFormat);
      }
      else if (mGenLeft) {
         mGenLeft->Append(data.GetReadPosition(0),
            floatSample, inputBufferCnt);
         if (mGenRight)
            mGenRight->Append(data.GetReadPosition(1),
               floatSample, inputBufferCnt);
      }
      // Satisfy post
      data.Rewind();
      // Bump to the next track position
      mOutPos += inputBufferCnt;
   }
   else {
      // Position is zero, therefore Remaining() is a positive multiple of
      // block size
   }
   // assert the post
   assert(data.BlockSize() <= data.Remaining());
}

References AudioGraph::Buffers::BlockSize(), AudioGraph::Buffers::Channels(), floatSample, AudioGraph::Buffers::GetReadPosition(), mEffectiveFormat, mGenLeft, mGenRight, mIsProcessor, mLeft, mOutPos, mpRight, AudioGraph::Buffers::Position(), AudioGraph::Buffers::Remaining(), AudioGraph::Buffers::Rewind(), and WaveTrack::Set().

Referenced by Acquire(), and Flush().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Flush()

void WaveTrackSink::Flush	(	Buffers &	data,
		double	t0,
		double	t1
	)

Precondition: data.Channels() > 0

Postcondition: data.BlockSize() <= data.Remaining()

Definition at line 93 of file WaveTrackSink.cpp.

{
   DoConsume(data);
   if (mGenLeft) {
      // Transfer the data from the temporary tracks to the actual ones
      mGenLeft->Flush();
      // mT1 gives us the NEW selection. We want to replace up to GetSel1().
      PasteTimeWarper warper{ t1, t0 + mGenLeft->GetEndTime() };
      mLeft.ClearAndPaste(t0, t1, mGenLeft.get(), true, true, &warper);
      if (mGenRight) {
         mGenRight->Flush();
         mpRight->ClearAndPaste(t0, t1, mGenRight.get(), true, true, &warper);
      }
   }
}

References WaveTrack::ClearAndPaste(), DoConsume(), mGenLeft, mGenRight, mLeft, and mpRight.

Here is the call graph for this function:

◆ Release()

bool WaveTrackSink::Release	(	const Buffers &	data,
		size_t	curBlockSize
	)

overridevirtual

Acknowledge receipt of data in Buffers, which caller may then Advance()

Returns: success

Precondition: AcceptsBuffers(data); curBlockSize <= data.BlockSize()

Implements AudioGraph::Sink.

Definition at line 53 of file WaveTrackSink.cpp.

{
   // May become non-trivial later
   return true;
}

Member Data Documentation

◆ mEffectiveFormat

const sampleFormat WaveTrackSink::mEffectiveFormat

private

Definition at line 55 of file WaveTrackSink.h.

Referenced by DoConsume().

◆ mGenLeft

const std::shared_ptr<WaveTrack> WaveTrackSink::mGenLeft

private

Definition at line 53 of file WaveTrackSink.h.

Referenced by DoConsume(), and Flush().

◆ mGenRight

const std::shared_ptr<WaveTrack> WaveTrackSink::mGenRight

private

Definition at line 53 of file WaveTrackSink.h.

Referenced by DoConsume(), and Flush().

◆ mIsProcessor

const bool WaveTrackSink::mIsProcessor

private

Definition at line 54 of file WaveTrackSink.h.

Referenced by DoConsume().

◆ mLeft

WaveTrack& WaveTrackSink::mLeft

private

Definition at line 51 of file WaveTrackSink.h.

Referenced by DoConsume(), and Flush().

◆ mOutPos

sampleCount WaveTrackSink::mOutPos

private

Definition at line 57 of file WaveTrackSink.h.

Referenced by DoConsume().

◆ mpRight

WaveTrack* const WaveTrackSink::mpRight

private

Definition at line 52 of file WaveTrackSink.h.

Referenced by DoConsume(), and Flush().

The documentation for this class was generated from the following files:

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ WaveTrackSink()

◆ ~WaveTrackSink()

Member Function Documentation

◆ AcceptsBuffers()

◆ Acquire()

◆ DoConsume()

◆ Flush()

◆ Release()

Member Data Documentation

◆ mEffectiveFormat

◆ mGenLeft

◆ mGenRight

◆ mIsProcessor

◆ mLeft

◆ mOutPos

◆ mpRight