PasteOverPreservingClips.cpp File Reference

#include "PasteOverPreservingClips.h"
#include "WaveClip.h"
#include "WaveTrack.h"

Include dependency graph for PasteOverPreservingClips.cpp:

Go to the source code of this file.

Functions
ClipData	CollectClipData (const WaveTrack &oldTrack, sampleCount start, sampleCount len)
	Collect clip boundary and name information. More...
void	PasteOverPreservingClips (const ClipData &data, WaveTrack &oldTrack, sampleCount start, sampleCount len, const WaveTrack &newContents)
	Substitute new contents into existing track, preserving clip boundaries. More...

Function Documentation

CollectClipData()

ClipData CollectClipData	(	const WaveTrack &	oldTrack,
		sampleCount	start,
		sampleCount	len
	)

Collect clip boundary and name information.

Parameters

start	beginning position to paste over in oldTrack
len	length to paste over in oldTrack

Precondition

oldTrack.IsLeader()

Definition at line 18 of file PasteOverPreservingClips.cpp.

{
   assert(oldTrack.IsLeader());
   ClipData results;
   auto &[clipStartEndTimes, clipRealStartEndTimes, clipNames] = results;
 
   double lenT = oldTrack.LongSamplesToTime(len);
   // 'start' is the sample offset in 't', the passed in track
   // 'startT' is the equivalent time value
   double startT = oldTrack.LongSamplesToTime(start);
 
   for (const auto &clip : oldTrack.GetClips()) {
      auto clipStartT = clip->GetPlayStartTime();
      auto clipEndT = clip->GetPlayEndTime();
      if (clipEndT <= startT)
         continue;   // clip is not within selection
      if (clipStartT >= startT + lenT)
         continue;   // clip is not within selection
 
      //save the actual clip start/end so that we can rejoin them after we paste.
      clipRealStartEndTimes.emplace_back(clipStartT, clipEndT);
 
      if (clipStartT < startT)  // does selection cover the whole clip?
         clipStartT = startT; // don't copy all the NEW clip
      if(clipEndT > startT + lenT)  // does selection cover the whole clip?
         clipEndT = startT + lenT; // don't copy all the NEW clip
 
      //save them
      clipStartEndTimes.emplace_back(clipStartT, clipEndT);
      clipNames.push_back(clip->GetName());
   }
   return results;
}

References WaveTrack::GetClips(), WaveTrack::IsLeader(), and WideSampleSequence::LongSamplesToTime().

Referenced by EffectEqualization::Process().

Here is the call graph for this function:

Here is the caller graph for this function:

PasteOverPreservingClips()

void PasteOverPreservingClips	(	const ClipData &	data,
		WaveTrack &	oldTrack,
		sampleCount	start,
		sampleCount	len,
		const WaveTrack &	newContents
	)

Substitute new contents into existing track, preserving clip boundaries.

Parameters

start	beginning position to paste over in oldTrack
len	length to paste over in oldTrack
newContents	begins at offset 0

Precondition

oldTrack.IsLeader()

newContents.IsLeader()

oldTrack.NChannels() == newContents.NChannels()

Definition at line 53 of file PasteOverPreservingClips.cpp.

{
   assert(oldTrack.IsLeader());
   assert(newContents.IsLeader());
   assert(oldTrack.NChannels() == newContents.NChannels());
   const auto &[clipStartEndTimes, clipRealStartEndTimes, clipNames] = data;
 
   //newContents has one waveclip for the total length, even though
   //oldTrack might have whitespace separating multiple clips
   //we want to maintain the original clip structure, so
   //only paste the intersections of the new clip.
 
   // now move the appropriate bit of the output back to the track
   // (this could be enhanced in the future to use the tails)
   double lenT = oldTrack.LongSamplesToTime(len);
   // 'start' is the sample offset in 't', the passed in track
   // 'startT' is the equivalent time value
   double startT = oldTrack.LongSamplesToTime(start);
 
   //now go through and replace the old clips with NEW
   for (unsigned int i = 0; i < clipStartEndTimes.size(); ++i) {
      //remove the old audio and get the NEW
      auto [start, end] = clipStartEndTimes[i];
      oldTrack.Clear(start, end);
   
      auto toClipOutput = newContents.Copy(start - startT, end - startT);
      oldTrack.Paste(start, *toClipOutput);
 
      //Restore original clip's name
      auto newClip = oldTrack.GetClipAtTime(start + 0.5 / oldTrack.GetRate());
      newClip->SetName(clipNames[i]);
 
      //if the clip was only partially selected, the Paste will have created a
      // split line.  Join is needed to take care of this
      //This is not true when the selection is fully contained within one clip
      // (second half of conditional)
      auto [realStart, realEnd] = clipRealStartEndTimes[i];
      if ((realStart  != start || realEnd != end) &&
         !(realStart <= startT && realEnd >= startT + lenT))
         oldTrack.Join(realStart, realEnd);
   }
}

References WaveTrack::Clear(), WaveTrack::Copy(), PackedArray::end(), WaveTrack::GetClipAtTime(), WaveTrack::GetRate(), WaveTrack::IsLeader(), WaveTrack::Join(), WideSampleSequence::LongSamplesToTime(), WaveTrack::NChannels(), WaveTrack::Paste(), and WaveClip::SetName().

Referenced by EffectEqualization::Process().

Here is the call graph for this function:

Here is the caller graph for this function: