TrackSpectrumTransformer Class Reference

Subclass of SpectrumTransformer that rewrites a track. More...

#include <SpectrumTransformer.h>

Inheritance diagram for TrackSpectrumTransformer:

Collaboration diagram for TrackSpectrumTransformer:

Public Member Functions
	TrackSpectrumTransformer (WaveChannel *pOutputTrack, bool needsOutput, eWindowFunctions inWindowType, eWindowFunctions outWindowType, size_t windowSize, unsigned stepsPerWindow, bool leadingPadding, bool trailingPadding)
	~TrackSpectrumTransformer () override
bool	Process (const WindowProcessor &processor, const WaveChannel &channel, size_t queueLength, sampleCount start, sampleCount len)
	Invokes Start(), ProcessSamples(), and Finish() More...
Public Member Functions inherited from SpectrumTransformer
	SpectrumTransformer (bool needsOutput, eWindowFunctions inWindowType, eWindowFunctions outWindowType, size_t windowSize, unsigned stepsPerWindow, bool leadingPadding, bool trailingPadding)
virtual	~SpectrumTransformer ()
bool	NeedsOutput () const
bool	Start (size_t queueLength)
	Call once before a sequence of calls to ProcessSamples; Invokes DoStart. More...
bool	ProcessSamples (const WindowProcessor &processor, const float *buffer, size_t len)
	Call multiple times. More...
bool	Finish (const WindowProcessor &processor)
virtual std::unique_ptr< Window >	NewWindow (size_t windowSize)
	Allocates a window to place in the queue. More...
virtual bool	DoStart ()
	Called before any calls to ProcessWindow. More...
virtual void	DoOutput (const float *outBuffer, size_t mStepSize)=0
	Called within ProcessSamples if output was requested. More...
virtual bool	DoFinish ()
	Called after the last call to ProcessWindow(). More...
size_t	TotalQueueSize () const
	Useful functions to implement WindowProcesser: More...
size_t	CurrentQueueSize () const
	How many windows in the queue have been filled? More...
bool	QueueIsFull () const
Window &	Nth (int n)
	Access the queue, so you can inspect and modify any window in it. More...
Window &	Newest ()
Window &	Latest ()

Static Public Member Functions
static bool	PostProcess (WaveTrack &outputTrack, sampleCount len)
	Final flush and trimming of tail samples. More...

Protected Member Functions
bool	DoStart () override
	Called before any calls to ProcessWindow. More...
void	DoOutput (const float *outBuffer, size_t mStepSize) override
	Called within ProcessSamples if output was requested. More...
bool	DoFinish () override
	Called after the last call to ProcessWindow(). More...

Private Attributes
WaveChannel *const	mOutputTrack
const WaveChannel *	mpChannel = nullptr

Additional Inherited Members
Public Types inherited from SpectrumTransformer
using	FloatVector = std::vector< float >
using	WindowProcessor = std::function< bool(SpectrumTransformer &) >
	Type of function that transforms windows in the queue. More...
Protected Attributes inherited from SpectrumTransformer
const size_t	mWindowSize
const size_t	mSpectrumSize
const unsigned	mStepsPerWindow
const size_t	mStepSize
const bool	mLeadingPadding
const bool	mTrailingPadding

Detailed Description

Subclass of SpectrumTransformer that rewrites a track.

Definition at line 186 of file SpectrumTransformer.h.

Constructor & Destructor Documentation

TrackSpectrumTransformer()

TrackSpectrumTransformer::TrackSpectrumTransformer ( WaveChannel *  pOutputTrack, bool  needsOutput, eWindowFunctions  inWindowType, eWindowFunctions  outWindowType, size_t  windowSize, unsigned  stepsPerWindow, bool  leadingPadding, bool  trailingPadding  )

inline

Precondition

!(inWindowType == eWinFuncRectangular && outWindowType eWinFuncRectangular)

windowSize % stepsPerWindow == 0

windowSize is a power of 2

!needsOutput || pOutputTrack != nullptr

Definition at line 193 of file SpectrumTransformer.h.

      : SpectrumTransformer{ needsOutput, inWindowType, outWindowType,
         windowSize, stepsPerWindow, leadingPadding, trailingPadding
      }
      , mOutputTrack{ pOutputTrack }
   {
      assert(!needsOutput || pOutputTrack != nullptr);
   }

~TrackSpectrumTransformer()

TrackSpectrumTransformer::~TrackSpectrumTransformer ( )

overridedefault

Member Function Documentation

DoFinish()

bool TrackSpectrumTransformer::DoFinish ( )

overrideprotectedvirtual

Called after the last call to ProcessWindow().

Returns

false to abort processing. Default implementation just returns true.

Reimplemented from SpectrumTransformer.

Definition at line 373 of file SpectrumTransformer.cpp.

{
   return SpectrumTransformer::DoFinish();
}

References SpectrumTransformer::DoFinish().

Referenced by MyTransformer::DoFinish(), and SpectralDataManager::Worker::DoFinish().

Here is the call graph for this function:

Here is the caller graph for this function:

DoOutput()

void TrackSpectrumTransformer::DoOutput ( const float *  outBuffer, size_t  mStepSize  )

overrideprotectedvirtual

Called within ProcessSamples if output was requested.

Implements SpectrumTransformer.

Definition at line 104 of file SpectrumTransformer.cpp.

{
   mOutputTrack->Append((constSamplePtr)outBuffer, floatSample, mStepSize);
}

References WaveChannel::Append(), floatSample, mOutputTrack, and SpectrumTransformer::mStepSize.

Here is the call graph for this function:

DoStart()

bool TrackSpectrumTransformer::DoStart ( )

overrideprotectedvirtual

Called before any calls to ProcessWindow.

More queue initializations can be done here.

Returns

false to abort processing. Default implementation just returns true.

Reimplemented from SpectrumTransformer.

Definition at line 395 of file SpectrumTransformer.cpp.

{
   return SpectrumTransformer::DoStart();
}

References SpectrumTransformer::DoStart().

Referenced by MyTransformer::DoStart(), and SpectralDataManager::Worker::DoStart().

Here is the call graph for this function:

Here is the caller graph for this function:

PostProcess()

bool TrackSpectrumTransformer::PostProcess ( WaveTrack &  outputTrack, sampleCount  len  )

static

Final flush and trimming of tail samples.

Definition at line 378 of file SpectrumTransformer.cpp.

{
   outputTrack.Flush();
   auto tLen = outputTrack.LongSamplesToTime(len);
   // Filtering effects always end up with more data than they started with.
   // Delete this 'tail'.
   outputTrack.Clear(tLen, outputTrack.GetEndTime());
   return true;
}

References WaveTrack::Clear(), WaveTrack::Flush(), WaveTrack::GetEndTime(), and WideSampleSequence::LongSamplesToTime().

Referenced by EffectNoiseReduction::Worker::Process(), and SpectralDataManager::ProcessTracks().

Here is the call graph for this function:

Here is the caller graph for this function:

Process()

bool TrackSpectrumTransformer::Process	(	const WindowProcessor &	processor,
		const WaveChannel &	channel,
		size_t	queueLength,
		sampleCount	start,
		sampleCount	len
	)

Invokes Start(), ProcessSamples(), and Finish()

Definition at line 341 of file SpectrumTransformer.cpp.

{
   mpChannel = &channel;
 
   if (!Start(queueLength))
      return false;
 
   auto bufferSize = channel.GetMaxBlockSize();
   FloatVector buffer(bufferSize);
 
   bool bLoopSuccess = true;
   auto samplePos = start;
   while (bLoopSuccess && samplePos < start + len) {
      //Get a blockSize of samples (smaller than the size of the buffer)
      const auto blockSize = limitSampleBufferSize(
         std::min(bufferSize, channel.GetBestBlockSize(samplePos)),
         start + len - samplePos);
 
      //Get the samples from the track and put them in the buffer
      channel.GetFloats(buffer.data(), samplePos, blockSize);
      samplePos += blockSize;
      bLoopSuccess = ProcessSamples(processor, buffer.data(), blockSize);
   }
 
   if (!Finish(processor))
      return false;
 
   return bLoopSuccess;
}

References SpectrumTransformer::Finish(), WaveChannel::GetBestBlockSize(), WaveChannel::GetFloats(), WaveChannel::GetMaxBlockSize(), limitSampleBufferSize(), min(), mpChannel, SpectrumTransformer::ProcessSamples(), and SpectrumTransformer::Start().

Referenced by SpectralDataManager::Worker::Process(), SpectralDataManager::Worker::ProcessOvertones(), and SpectralDataManager::Worker::ProcessSnapping().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

mOutputTrack

WaveChannel* const TrackSpectrumTransformer::mOutputTrack

private

Definition at line 219 of file SpectrumTransformer.h.

Referenced by DoOutput().

mpChannel

const WaveChannel* TrackSpectrumTransformer::mpChannel = nullptr

private

Definition at line 220 of file SpectrumTransformer.h.

Referenced by Process().

---

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

• SpectrumTransformer.h
• SpectrumTransformer.cpp