ClipTimeAndPitchSource Class Reference

#include <ClipTimeAndPitchSource.h>

Inheritance diagram for ClipTimeAndPitchSource:

Collaboration diagram for ClipTimeAndPitchSource:

Public Member Functions
	ClipTimeAndPitchSource (const ClipInterface &, double durationToDiscard, PlaybackDirection)
void	Pull (float *const *, size_t samplesPerChannel) override
size_t	NChannels () const
Public Member Functions inherited from TimeAndPitchSource
virtual	~TimeAndPitchSource ()
virtual void	Pull (float *const *, size_t samplesPerChannel)=0

Private Attributes
const ClipInterface &	mClip
sampleCount	mLastReadSample = 0
const PlaybackDirection	mPlaybackDirection
ChannelSampleViews	mChannelSampleViews

Detailed Description

Definition at line 23 of file ClipTimeAndPitchSource.h.

Constructor & Destructor Documentation

ClipTimeAndPitchSource()

ClipTimeAndPitchSource::ClipTimeAndPitchSource	(	const ClipInterface &	clip,
		double	durationToDiscard,
		PlaybackDirection	direction
	)

Definition at line 35 of file ClipTimeAndPitchSource.cpp.

    : mClip { clip }
    , mLastReadSample { GetLastReadSample(clip, durationToDiscard, direction) }
    , mPlaybackDirection { direction }
{
}

Member Function Documentation

NChannels()

size_t ClipTimeAndPitchSource::NChannels

(

)

const

Definition at line 90 of file ClipTimeAndPitchSource.cpp.

{
   return mClip.NChannels();
}

References mClip, and ClipInterface::NChannels().

Referenced by ClipSegment::NChannels().

Here is the call graph for this function:

Here is the caller graph for this function:

Pull()

void ClipTimeAndPitchSource::Pull ( float *const *  buffers, size_t  samplesPerChannel  )

overridevirtual

Implements TimeAndPitchSource.

Definition at line 44 of file ClipTimeAndPitchSource.cpp.

{
   const auto forward = mPlaybackDirection == PlaybackDirection::forward;
   const auto remainingSamplesInClip =
      forward ? mClip.GetVisibleSampleCount() - mLastReadSample :
                mLastReadSample;
   const auto numSamplesToRead =
      limitSampleBufferSize(samplesPerChannel, remainingSamplesInClip);
   if (numSamplesToRead > 0u)
   {
      constexpr auto mayThrow = false;
      const auto start =
         forward ? mLastReadSample : mLastReadSample - numSamplesToRead;
      const auto nChannels = mClip.NChannels();
      ChannelSampleViews newViews;
      for (auto i = 0u; i < nChannels; ++i)
      {
         auto channelView = mClip.GetSampleView(i, start, numSamplesToRead);
         // Query `samplesPerChannel` samples ; `AudioSegmentSampleView::Copy`
         // will zero from `numSamplesToRead` to `samplesPerChannel` if needed.
         channelView.Copy(buffers[i], samplesPerChannel);
         newViews.push_back(std::move(channelView));
         if (!forward)
            ReverseSamples(
               reinterpret_cast<samplePtr>(buffers[i]), floatSample, 0,
               numSamplesToRead);
      }
      mChannelSampleViews = std::move(newViews);
      mLastReadSample +=
         forward ?
            sampleCount { numSamplesToRead } :
            // Cast to `sampleCount` before negating ;
            // on x86, size_t is 32 bits, but sampleCount will store it as 64
            // bits. Result : -1 becomes 2^32-1 and adding it to mLastReadSample
            // will not overflow, which is actually wanted in that case to
            // become a reasonably small value again :)
            -sampleCount { numSamplesToRead };
   }
   else
   {
      for (auto i = 0u; i < mClip.NChannels(); ++i)
         std::fill(buffers[i], buffers[i] + samplesPerChannel, 0.f);
   }
}

References AudioSegmentSampleView::Copy(), floatSample, forward, ClipInterface::GetSampleView(), ClipTimes::GetVisibleSampleCount(), limitSampleBufferSize(), mChannelSampleViews, mClip, mLastReadSample, mPlaybackDirection, ClipInterface::NChannels(), and ReverseSamples().

Here is the call graph for this function:

Member Data Documentation

mChannelSampleViews

ChannelSampleViews ClipTimeAndPitchSource::mChannelSampleViews

private

Definition at line 39 of file ClipTimeAndPitchSource.h.

Referenced by Pull().

mClip

const ClipInterface& ClipTimeAndPitchSource::mClip

private

Definition at line 36 of file ClipTimeAndPitchSource.h.

Referenced by NChannels(), and Pull().

mLastReadSample

sampleCount ClipTimeAndPitchSource::mLastReadSample = 0

private

Definition at line 37 of file ClipTimeAndPitchSource.h.

Referenced by Pull().

mPlaybackDirection

const PlaybackDirection ClipTimeAndPitchSource::mPlaybackDirection

private

Definition at line 38 of file ClipTimeAndPitchSource.h.

Referenced by Pull().

---

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

• ClipTimeAndPitchSource.h
• ClipTimeAndPitchSource.cpp