TrackList Class Reference

A flat linked list of tracks supporting Add, Remove, Clear, and Contains, serialization of the list of tracks, event notifications. More...

#include <Track.h>

Inheritance diagram for TrackList:

Collaboration diagram for TrackList:

Public Types
using	iterator = TrackIter< Track >
using	const_iterator = TrackIter< const Track >
using	value_type = Track *
using	Updater = std::function< void(Track &dest, const Track &src) >
Public Types inherited from Observer::Publisher< TrackListEvent >
using	message_type = TrackListEvent
using	CallbackReturn = std::conditional_t< true, void, bool >
using	Callback = std::function< CallbackReturn(const TrackListEvent &) >
	Type of functions that can be connected to the Publisher. More...

Public Member Functions
	TrackList (AudacityProject *pOwner)
void	Swap (TrackList &that)
virtual	~TrackList ()
AudacityProject *	GetOwner ()
const AudacityProject *	GetOwner () const
wxString	MakeUniqueTrackName (const wxString &baseTrackName) const
	Returns string that contains baseTrackName, but is guaranteed to be unique among other tracks in that list. More...
iterator	begin ()
iterator	end ()
const_iterator	begin () const
const_iterator	end () const
const_iterator	cbegin () const
const_iterator	cend () const
template<typename TrackType = Track>
auto	Find (Track *pTrack) -> TrackIter< TrackType >
	Turn a pointer into a TrackIter (constant time); get end iterator if this does not own the track. More...
template<typename TrackType = const Track>
auto	Find (const Track *pTrack) const -> std::enable_if_t< std::is_const_v< TrackType >, TrackIter< TrackType > >
	Turn a pointer into a TrackIter (constant time); get end iterator if this does not own the track. More...
TrackIter< Track >	FindLeader (Track *pTrack)
TrackIter< const Track >	FindLeader (const Track *pTrack) const
template<typename TrackType = Track>
auto	Any () -> TrackIterRange< TrackType >
template<typename TrackType = const Track>
auto	Any () const -> std::enable_if_t< std::is_const_v< TrackType >, TrackIterRange< TrackType > >
template<typename TrackType = Track>
auto	Selected () -> TrackIterRange< TrackType >
template<typename TrackType = const Track>
auto	Selected () const -> std::enable_if_t< std::is_const_v< TrackType >, TrackIterRange< TrackType > >
template<typename TrackType = Track>
auto	Leaders () -> TrackIterRange< TrackType >
template<typename TrackType = const Track>
auto	Leaders () const -> std::enable_if_t< std::is_const_v< TrackType >, TrackIterRange< TrackType > >
template<typename TrackType = Track>
auto	SelectedLeaders () -> TrackIterRange< TrackType >
template<typename TrackType = const Track>
auto	SelectedLeaders () const -> std::enable_if_t< std::is_const_v< TrackType >, TrackIterRange< TrackType > >
void	Permute (const std::vector< TrackNodePointer > &permutation)
	For use in sorting: assume each iterator points into this list, no duplications. More...
Track *	FindById (TrackId id)
template<typename TrackKind >
TrackKind *	AddToHead (const std::shared_ptr< TrackKind > &t)
	Add a Track, giving it a fresh id. More...
template<typename TrackKind >
TrackKind *	Add (const std::shared_ptr< TrackKind > &t)
void	UnlinkChannels (Track &track)
	Removes linkage if track belongs to a group. More...
bool	MakeMultiChannelTrack (Track &first, int nChannels, bool aligned)
	Converts channels to a multichannel track. More...
ListOfTracks::value_type	Replace (Track *t, const ListOfTracks::value_type &with)
TrackNodePointer	Remove (Track *t)
	Remove the Track and return an iterator to what followed it. More...
void	Clear (bool sendEvent=true)
	Make the list empty. More...
bool	CanMoveUp (Track *t) const
bool	CanMoveDown (Track *t) const
bool	MoveUp (Track *t)
bool	MoveDown (Track *t)
bool	Move (Track *t, bool up)
bool	Contains (const Track *t) const
	Mainly a test function. Uses a linear search, so could be slow. More...
template<typename Subclass >
std::shared_ptr< Subclass >	Lock (const std::weak_ptr< Subclass > &wTrack)
bool	empty () const
size_t	size () const
double	GetStartTime () const
double	GetEndTime () const
double	GetMinOffset () const
std::shared_ptr< Track >	RegisterPendingChangedTrack (Updater updater, Track *src)
void	RegisterPendingNewTrack (const std::shared_ptr< Track > &pTrack)
void	UpdatePendingTracks ()
void	ClearPendingTracks (ListOfTracks *pAdded=nullptr)
bool	ApplyPendingTracks ()
bool	HasPendingTracks () const
Public Member Functions inherited from Observer::Publisher< TrackListEvent >
	Publisher (ExceptionPolicy *pPolicy=nullptr, Alloc a={})
	Constructor supporting type-erased custom allocation/deletion. More...
	Publisher (Publisher &&)=default
Publisher &	operator= (Publisher &&)=default
Subscription	Subscribe (Callback callback)
	Connect a callback to the Publisher; later-connected are called earlier. More...
Subscription	Subscribe (Object &obj, Return(Object::*callback)(Args...))
	Overload of Subscribe takes an object and pointer-to-member-function. More...
Public Member Functions inherited from ClientData::Base
virtual	~Base ()

Static Public Member Functions
static TrackList &	Get (AudacityProject &project)
static const TrackList &	Get (const AudacityProject &project)
static TrackList *	FindUndoTracks (const UndoStackElem &state)
static std::shared_ptr< TrackList >	Create (AudacityProject *pOwner)
template<typename TrackType >
static auto	SingletonRange (TrackType *pTrack) -> TrackIterRange< TrackType >
template<typename TrackType >
static auto	Channels (TrackType *pTrack) -> TrackIterRange< TrackType >
static bool	SwapChannels (Track &track)
	If the given track is one of a pair of channels, swap them. More...

Private Member Functions
	TrackList (const TrackList &that)=delete
TrackList &	operator= (const TrackList &)=delete
	TrackList (TrackList &&that)=delete
TrackList &	operator= (TrackList &&)=delete
void	clear ()=delete
Track *	DoAddToHead (const std::shared_ptr< Track > &t)
Track *	DoAdd (const std::shared_ptr< Track > &t)
template<typename TrackType = Track, typename Pred = typename TrackIterRange< TrackType >::iterator::FunctionType>
auto	Tracks (const Pred &pred={}) -> TrackIterRange< TrackType >
template<typename TrackType = const Track, typename Pred = typename TrackIterRange< TrackType >::iterator::FunctionType>
auto	Tracks (const Pred &pred={}) const -> std::enable_if_t< std::is_const_v< TrackType >, TrackIterRange< TrackType > >
Track *	GetPrev (Track *t, bool linked=false) const
Track *	GetNext (Track *t, bool linked=false) const
	Return a track in the list that comes after Track t. More...
template<typename TrackType >
TrackIter< TrackType >	MakeTrackIterator (TrackNodePointer iter) const
template<typename TrackType >
TrackIter< TrackType >	EndIterator () const
TrackIterRange< Track >	EmptyRange () const
bool	isNull (TrackNodePointer p) const
TrackNodePointer	getEnd () const
TrackNodePointer	getBegin () const
TrackNodePointer	getNext (TrackNodePointer p) const
	Move an iterator to the next node, if any; else stay at end. More...
TrackNodePointer	getPrev (TrackNodePointer p) const
	Move an iterator to the previous node, if any; else wrap to end. More...
void	RecalcPositions (TrackNodePointer node)
void	QueueEvent (TrackListEvent event)
void	SelectionEvent (const std::shared_ptr< Track > &pTrack)
void	PermutationEvent (TrackNodePointer node)
void	DataEvent (const std::shared_ptr< Track > &pTrack, int code)
void	EnsureVisibleEvent (const std::shared_ptr< Track > &pTrack, bool modifyState)
void	DeletionEvent (std::weak_ptr< Track > node, bool duringReplace)
void	AdditionEvent (TrackNodePointer node)
void	ResizingEvent (TrackNodePointer node)
void	SwapNodes (TrackNodePointer s1, TrackNodePointer s2)

Static Private Member Functions
template<typename TrackType , typename InTrackType >
static TrackIterRange< TrackType >	Channels_ (TrackIter< InTrackType > iter1)

Private Attributes
AudacityProject *	mOwner
ListOfTracks	mPendingUpdates
	Shadow tracks holding append-recording in progress; need to put them into a list so that GetLink() works. More...
std::vector< Updater >	mUpdaters
	This is in correspondence with mPendingUpdates. More...

Static Private Attributes
static long	sCounter = -1

Friends
class	Track

Additional Inherited Members
Static Public Attributes inherited from Observer::Publisher< TrackListEvent >
static constexpr bool	notifies_all
Protected Member Functions inherited from Observer::Publisher< TrackListEvent >
CallbackReturn	Publish (const TrackListEvent &message)
	Send a message to connected callbacks. More...

Detailed Description

A flat linked list of tracks supporting Add, Remove, Clear, and Contains, serialization of the list of tracks, event notifications.

Definition at line 1334 of file Track.h.

Member Typedef Documentation

const_iterator

using TrackList::const_iterator = TrackIter<const Track>

Definition at line 1391 of file Track.h.

iterator

using TrackList::iterator = TrackIter<Track>

Definition at line 1390 of file Track.h.

Updater

using TrackList::Updater = std::function< void(Track &dest, const Track &src) >

Definition at line 1729 of file Track.h.

value_type

using TrackList::value_type = Track *

Definition at line 1392 of file Track.h.

Constructor & Destructor Documentation

TrackList() [1/3]

TrackList::TrackList ( const TrackList &  that )

privatedelete

TrackList() [2/3]

TrackList::TrackList ( TrackList &&  that )

privatedelete

TrackList() [3/3]

TrackList::TrackList ( AudacityProject *  pOwner )

explicit

Definition at line 497 of file Track.cpp.

   : mOwner{ pOwner }
{
}

~TrackList()

TrackList::~TrackList ( )

virtual

Definition at line 539 of file Track.cpp.

{
   Clear(false);
}

References Clear().

Here is the call graph for this function:

Member Function Documentation

Add()

template<typename TrackKind >

TrackKind * TrackList::Add ( const std::shared_ptr< TrackKind > &  t )

inline

Definition at line 1567 of file Track.h.

         { return static_cast< TrackKind* >( DoAdd( t ) ); }

Referenced by ApplyPendingTracks(), LabelTrack::Create(), EffectBase::DoEffect(), anonymous_namespace{EditMenus.cpp}::FinishCopy(), AUPImportFileHandle::HandleLabelTrack(), AUPImportFileHandle::HandleNoteTrack(), AUPImportFileHandle::HandleTimeTrack(), AUPImportFileHandle::HandleWaveTrack(), EffectBase::Preview(), EffectBase::ReplaceProcessedTracks(), anonymous_namespace{Track.cpp}::TrackListRestorer::TrackListRestorer(), and LabelDialog::TransferDataFromWindow().

Here is the caller graph for this function:

AdditionEvent()

void TrackList::AdditionEvent ( TrackNodePointer  node )

private

Definition at line 625 of file Track.cpp.

{
   QueueEvent({ TrackListEvent::ADDITION, *node.first });
}

References TrackListEvent::ADDITION, and QueueEvent().

Referenced by ApplyPendingTracks(), DoAdd(), and DoAddToHead().

Here is the call graph for this function:

Here is the caller graph for this function:

AddToHead()

template<typename TrackKind >

TrackKind * TrackList::AddToHead ( const std::shared_ptr< TrackKind > &  t )

inline

Add a Track, giving it a fresh id.

Definition at line 1563 of file Track.h.

         { return static_cast< TrackKind* >( DoAddToHead( t ) ); }

Any() [1/2]

template<typename TrackType = Track>

auto TrackList::Any ( ) -> TrackIterRange< TrackType >

inline

Definition at line 1440 of file Track.h.

   {
      return Tracks< TrackType >();
   }

Referenced by anonymous_namespace{Track.cpp}::Accumulate(), ImportCommand::Apply(), LabelDefaultClickHandle::Click(), Effect::CopyInputTracks(), ExportMultipleDialog::CountTracksAndLabels(), ExportPlugin::CreateMixer(), anonymous_namespace{EditMenus.cpp}::CutCopyAvailableFlag(), LabelTrackView::DoKeyDown(), LyricsPanel::DoUpdateLyrics(), TrackPanel::DrawTracks(), anonymous_namespace{LabelMenus.cpp}::EditByLabel(), anonymous_namespace{LabelMenus.cpp}::EditClipboardByLabel(), ControlToolBar::EnableDisableButtons(), TranscriptionToolBar::EnableDisableButtons(), GetInfoCommand::ExploreTrackPanel(), ExportMultipleDialog::ExportMultipleByTrack(), LabelDialog::FindAllLabels(), anonymous_namespace{Snap.cpp}::FindCandidates(), anonymous_namespace{TimeShiftHandle.cpp}::FindCorrespondence(), anonymous_namespace{EditMenus.cpp}::ForEachCopiedWaveTrack(), GetAllSeqBlocks(), GetNumExportChannels(), TrackView::GetTotalHeight(), anonymous_namespace{EditMenus.cpp}::HasHiddenData(), MixerBoard::HasSolo(), ClipMoveState::Init(), LabelTracksExistFlag(), MakeUniqueTrackName(), anonymous_namespace{ExportMIDI.cpp}::NoteTracksExistFlag(), ProjectAudioManager::OnRecord(), LabelDialog::OnSelectCell(), ScreenshotBigDialog::OnShortTracks(), anonymous_namespace{TimerRecordDialog.cpp}::OnTimerRecord(), TranscriptionToolBar::PlayAtSpeed(), EffectBase::Preview(), EffectFindClipping::Process(), RealtimeEffectPanel::RealtimeEffectPanel(), SelectionStateChanger::SelectionStateChanger(), SelectionState::SelectNone(), SelectionState::SelectRangeOfTracks(), TracksExistFlag(), LabelDialog::TransferDataFromWindow(), TransportTracks::TransportTracks(), TrackPanel::UpdateVRulerSize(), VisitBlocks(), WaveTracksExistFlag(), ZoomInAvailableFlag(), ZoomOutAvailableFlag(), and SelectionStateChanger::~SelectionStateChanger().

Here is the caller graph for this function:

Any() [2/2]

template<typename TrackType = const Track>

auto TrackList::Any ( ) const -> std::enable_if_t< std::is_const_v<TrackType>, TrackIterRange< TrackType > >

inline

Definition at line 1447 of file Track.h.

   {
      return Tracks< TrackType >();
   }

ApplyPendingTracks()

bool TrackList::ApplyPendingTracks

(

)

Exception safety guarantee:

Strong

Definition at line 1145 of file Track.cpp.

{
   bool result = false;
 
   ListOfTracks additions;
   ListOfTracks updates;
   {
      // Always clear, even if one of the update functions throws
      auto cleanup = finally( [&] { ClearPendingTracks( &additions ); } );
      UpdatePendingTracks();
      updates.swap( mPendingUpdates );
   }
 
   // Remaining steps must be No-fail-guarantee so that this function
   // gives Strong-guarantee
 
   std::vector< std::shared_ptr<Track> > reinstated;
 
   for (auto &pendingTrack : updates) {
      if (pendingTrack) {
         pendingTrack->AttachedTrackObjects::ForEach([&](auto &attachment){
            attachment.Reparent( pendingTrack );
         });
         auto src = FindById( pendingTrack->GetId() );
         if (src)
            this->Replace(src, pendingTrack), result = true;
         else
            // Perhaps a track marked for pending changes got deleted by
            // some other action.  Recreate it so we don't lose the
            // accumulated changes.
            reinstated.push_back(pendingTrack);
      }
   }
 
   // If there are tracks to reinstate, append them to the list.
   for (auto &pendingTrack : reinstated)
      if (pendingTrack)
         this->Add( pendingTrack ), result = true;
 
   // Put the pending added tracks back into the list, preserving their
   // positions.
   bool inserted = false;
   ListOfTracks::iterator first;
   for (auto &pendingTrack : additions) {
      if (pendingTrack) {
         auto iter = ListOfTracks::begin();
         std::advance( iter, pendingTrack->GetIndex() );
         iter = ListOfTracks::insert( iter, pendingTrack );
         pendingTrack->SetOwner( shared_from_this(), {iter, this} );
         pendingTrack->SetId( TrackId{ ++sCounter } );
         if (!inserted) {
            first = iter;
            inserted = true;
         }
      }
   }
   if (inserted) {
      TrackNodePointer node{first, this};
      RecalcPositions(node);
      AdditionEvent(node);
      result = true;
   }
 
   return result;
}

References Add(), AdditionEvent(), PackedArray::begin(), ClearPendingTracks(), FindById(), mPendingUpdates, RecalcPositions(), Replace(), sCounter, and UpdatePendingTracks().

Referenced by ProjectAudioManager::OnCommitRecording().

Here is the call graph for this function:

Here is the caller graph for this function:

begin() [1/2]

iterator TrackList::begin ( )

inline

Definition at line 1393 of file Track.h.

{ return Any().begin(); }

Referenced by TimeShiftHandle::DoSlideVertical(), empty(), HasPendingTracks(), and EffectTruncSilence::ProcessAll().

Here is the caller graph for this function:

begin() [2/2]

const_iterator TrackList::begin ( ) const

inline

Definition at line 1395 of file Track.h.

{ return Any().begin(); }

CanMoveDown()

bool TrackList::CanMoveDown

(

Track *

t

)

const

Definition at line 911 of file Track.cpp.

{
   return GetNext(t, true) != NULL;
}

References GetNext().

Here is the call graph for this function:

CanMoveUp()

bool TrackList::CanMoveUp

(

Track *

t

)

const

Definition at line 906 of file Track.cpp.

{
   return GetPrev(t, true) != NULL;
}

References GetPrev().

Here is the call graph for this function:

cbegin()

const_iterator TrackList::cbegin ( ) const

inline

Definition at line 1397 of file Track.h.

{ return begin(); }

References PackedArray::begin().

Here is the call graph for this function:

cend()

const_iterator TrackList::cend ( ) const

inline

Definition at line 1398 of file Track.h.

{ return end(); }

References PackedArray::end().

Here is the call graph for this function:

Channels()

template<typename TrackType >

static auto TrackList::Channels ( TrackType *  pTrack ) -> TrackIterRange< TrackType >

inlinestatic

Definition at line 1544 of file Track.h.

   {
      return Channels_<TrackType>( pTrack->GetOwner()->FindLeader(pTrack) );
   }

Referenced by AppendItem(), SelectTracksCommand::Apply(), SetTrackBase::Apply(), WaveTrackView::CaptureKey(), anonymous_namespace{ClipMenus.cpp}::ChannelsHaveDifferentClipBoundaries(), anonymous_namespace{TrackPanel.cpp}::ResizingChannelGroup::Children(), anonymous_namespace{TrackPanel.cpp}::Subgroup::Children(), anonymous_namespace{TrackPanel.cpp}::ChannelGroup::Children(), ProjectAudioManager::ChooseExistingRecordingTracks(), TrackPanelResizeHandle::Click(), CutlineHandle::Click(), EnvelopeHandle::Click(), WaveformPrefs::Commit(), MinimizeButtonHandle::CommitChanges(), TrackShifter::CommonMayMigrateTo(), WaveTrackView::CopySelectedText(), WaveTrackView::CutSelectedText(), anonymous_namespace{TrackMenus.cpp}::DoAlign(), anonymous_namespace{ClipMenus.cpp}::DoClipMove(), WaveTrackSubView::DoDetailedHitTest(), WaveformVRulerControls::DoHandleWheelRotation(), SpectrumVRulerControls::DoHandleWheelRotation(), ClipMoveState::DoHorizontalOffset(), anonymous_namespace{TrackMenus.cpp}::DoMixAndRender(), TrackUtilities::DoRemoveTrack(), anonymous_namespace{TrackMenus.cpp}::DoSortTracks(), TrackUtilities::DoTrackMute(), TrackUtilities::DoTrackSolo(), SpectrumVZoomHandle::DoZoom(), WaveformVZoomHandle::DoZoom(), TrackPanelResizeHandle::Drag(), anonymous_namespace{TrackPanel.cpp}::ChannelGroup::Draw(), TrackPanelResizerCell::Draw(), SpectrumView::Draw(), WaveformView::Draw(), ExportMultipleDialog::ExportMultipleByTrack(), anonymous_namespace{TrackPanel.cpp}::FindAdjustedChannelHeights(), anonymous_namespace{Mix.cpp}::FindBufferSize(), anonymous_namespace{ClipMenus.cpp}::FindClipBoundaries(), anonymous_namespace{ClipMenus.cpp}::FindClips(), anonymous_namespace{WaveClipTrimHandle.cpp}::FindClipsInChannels(), anonymous_namespace{RealtimeEffectManager.cpp}::FindStates(), anonymous_namespace{EditMenus.cpp}::ForEachCopiedWaveTrack(), MixerSource::GetChannel(), TrackView::GetChannelGroupHeight(), ContrastDialog::GetDB(), CommonTrackView::GetMinimizedHeight(), MixerTrackCluster::GetRight(), VampEffect::Init(), ClipMoveState::Init(), TrackPanelAx::IsFocused(), LOFImportFileHandle::lofOpenFiles(), AudioGraph::MakeChannelMap(), anonymous_namespace{EffectStage.cpp}::MakeInstances(), MixAndRender(), MixerSource::MixerSource(), TrackPanel::OnEnsureVisible(), FormatMenuTable::OnFormatChange(), WaveTrackMenuTable::OnMultiView(), anonymous_namespace{EditMenus.cpp}::OnPaste(), WaveTrackMenuTable::OnSetDisplay(), TrackMenuTable::OnSetName(), SpectrumVRulerMenuTable::OnSpectrumScaleType(), anonymous_namespace{EditMenus.cpp}::OnSplit(), WaveTrackMenuTable::OnSwapChannels(), WaveColorMenuTable::OnWaveColorChange(), WaveformVRulerMenuTable::OnWaveformScaleType(), WaveTrackView::PasteText(), SpectrumPrefs::Preview(), EffectLoudness::Process(), EffectNormalize::Process(), NyquistEffect::Process(), EffectSBSMS::Process(), EffectStereoToMono::Process(), VampEffect::Process(), EffectTruncSilence::ProcessIndependently(), NyquistEffect::ProcessOne(), PerTrackEffect::ProcessPass(), AudioIO::ProcessPlaybackSlices(), TrackPanel::RefreshTrack(), SpectrumPrefs::Rollback(), WaveTrackView::SelectAllText(), anonymous_namespace{WaveTrackAffordanceControls.cpp}::SelectedClipOfFocusedTrack(), SelectionState::SelectTrack(), SelectionState::SelectTrackLength(), GetInfoCommand::SendTracks(), TrackView::SetMinimized(), RateMenuTable::SetRate(), anonymous_namespace{TrackMenus.cpp}::SetTrackGain(), anonymous_namespace{TrackMenus.cpp}::SetTrackPan(), GainSliderHandle::SetValue(), PanSliderHandle::SetValue(), ScreenshotBigDialog::SizeTracks(), WaveTrackMenuTable::SplitStereo(), anonymous_namespace{WaveTrackControls.cpp}::Status1DrawFunction(), SwapNodes(), TrackPanelResizeHandle::TrackPanelResizeHandle(), AudioIO::TransformPlayBuffers(), AudioIoCallback::TransportState::TransportState(), UnlinkChannels(), and TrackPanel::UpdateTrackVRuler().

Channels_()

template<typename TrackType , typename InTrackType >

static TrackIterRange< TrackType > TrackList::Channels_ ( TrackIter< InTrackType >  iter1 )

inlinestaticprivate

Definition at line 1522 of file Track.h.

   {
      // Assume iterator filters leader tracks
      if (*iter1) {
         return {
            iter1.Filter( &Track::Any )
               .template Filter<TrackType>(),
            (++iter1).Filter( &Track::Any )
               .template Filter<TrackType>()
         };
      }
      else
         // empty range
         return {
            iter1.template Filter<TrackType>(),
            iter1.template Filter<TrackType>()
         };
   }

References Track::Any(), and TrackIter< TrackType >::Filter().

Here is the call graph for this function:

clear()

void TrackList::clear ( )

privatedelete

Clear()

void TrackList::Clear

(

bool

sendEvent = true

)

Make the list empty.

Definition at line 820 of file Track.cpp.

{
   // Null out the back-pointers to this in tracks, in case there
   // are outstanding shared_ptrs to those tracks, making them outlive
   // the temporary ListOfTracks below.
   for ( auto pTrack: *this )
   {
      pTrack->SetOwner({}, {});
      
      if (sendEvent)
         DeletionEvent(pTrack->shared_from_this(), false);
   }
   
   for ( auto pTrack: mPendingUpdates )
   {
      pTrack->SetOwner({}, {});
 
      if (sendEvent)
         DeletionEvent(pTrack, false);
   }
 
   ListOfTracks tempList;
   tempList.swap( *this );
 
   ListOfTracks updating;
   updating.swap( mPendingUpdates );
 
   mUpdaters.clear();
}

References DeletionEvent(), mPendingUpdates, and mUpdaters.

Referenced by ~TrackList().

Here is the call graph for this function:

Here is the caller graph for this function:

ClearPendingTracks()

void TrackList::ClearPendingTracks

(

ListOfTracks *

pAdded = nullptr

)

Exception safety guarantee:

No-fail

Definition at line 1104 of file Track.cpp.

{
   for (const auto &pTrack: mPendingUpdates)
      pTrack->SetOwner( {}, {} );
   mPendingUpdates.clear();
   mUpdaters.clear();
 
   if (pAdded)
      pAdded->clear();
 
   // To find the first node that remains after the first deleted one
   TrackNodePointer node;
   bool foundNode = false;
 
   for (auto it = ListOfTracks::begin(), stop = ListOfTracks::end();
        it != stop;) {
      if (it->get()->GetId() == TrackId{}) {
         do {
            if (pAdded)
               pAdded->push_back( *it );
            (*it)->SetOwner( {}, {} );
            DeletionEvent(*it, false);
            it = erase( it );
         }
         while (it != stop && it->get()->GetId() == TrackId{});
 
         if (!foundNode && it != stop) {
            node = (*it)->GetNode();
            foundNode = true;
         }
      }
      else
         ++it;
   }
 
   if (!empty()) {
      RecalcPositions(getBegin());
   }
}

References PackedArray::begin(), DeletionEvent(), empty(), PackedArray::end(), getBegin(), mPendingUpdates, mUpdaters, and RecalcPositions().

Referenced by ApplyPendingTracks(), ProjectAudioManager::CancelRecording(), and AudacityApp::OnExceptionInMainLoop().

Here is the call graph for this function:

Here is the caller graph for this function:

Contains()

bool TrackList::Contains

(

const Track *

t

)

const

Mainly a test function. Uses a linear search, so could be slow.

Definition at line 1005 of file Track.cpp.

{
   return make_iterator_range( *this ).contains( t );
}

References make_iterator_range().

Here is the call graph for this function:

Create()

std::shared_ptr< TrackList > TrackList::Create ( AudacityProject *  pOwner )

static

Definition at line 503 of file Track.cpp.

{
   return std::make_shared<TrackList>( pOwner );
}

Referenced by Effect::CopyInputTracks(), ProjectFileManager::DoSave(), anonymous_namespace{EditMenus.cpp}::DuplicateDiscardTrimmed(), anonymous_namespace{LabelMenus.cpp}::EditClipboardByLabel(), anonymous_namespace{EditMenus.cpp}::OnCopy(), anonymous_namespace{EditMenus.cpp}::OnCut(), anonymous_namespace{EditMenus.cpp}::OnSplitCut(), EffectBase::Preview(), EffectTwoPassSimpleMono::Process(), EffectManager::PromptUser(), ProjectFileManager::ReadProjectFile(), and ProjectFileIO::SaveProject().

Here is the caller graph for this function:

DataEvent()

void TrackList::DataEvent ( const std::shared_ptr< Track > &  pTrack, int  code  )

private

Definition at line 601 of file Track.cpp.

{
   QueueEvent({
      TrackListEvent::TRACK_DATA_CHANGE, pTrack, code });
}

References QueueEvent(), and TrackListEvent::TRACK_DATA_CHANGE.

Here is the call graph for this function:

DeletionEvent()

void TrackList::DeletionEvent ( std::weak_ptr< Track >  node, bool  duringReplace  )

private

Definition at line 619 of file Track.cpp.

{
   QueueEvent(
      { TrackListEvent::DELETION, std::move(node), duringReplace ? 1 : 0 });
}

References TrackListEvent::DELETION, and QueueEvent().

Referenced by Clear(), ClearPendingTracks(), and Remove().

Here is the call graph for this function:

Here is the caller graph for this function:

DoAdd()

Track * TrackList::DoAdd ( const std::shared_ptr< Track > &  t )

private

Definition at line 712 of file Track.cpp.

{
   push_back(t);
 
   auto n = getPrev( getEnd() );
 
   t->SetOwner(shared_from_this(), n);
   t->SetId( TrackId{ ++sCounter } );
   RecalcPositions(n);
   AdditionEvent(n);
   return back().get();
}

References AdditionEvent(), getEnd(), getPrev(), RecalcPositions(), and sCounter.

Here is the call graph for this function:

DoAddToHead()

Track * TrackList::DoAddToHead ( const std::shared_ptr< Track > &  t )

private

Definition at line 700 of file Track.cpp.

{
   Track *pTrack = t.get();
   push_front(ListOfTracks::value_type(t));
   auto n = getBegin();
   pTrack->SetOwner(shared_from_this(), n);
   pTrack->SetId( TrackId{ ++sCounter } );
   RecalcPositions(n);
   AdditionEvent(n);
   return front().get();
}

References AdditionEvent(), getBegin(), RecalcPositions(), sCounter, Track::SetId(), and Track::SetOwner().

Here is the call graph for this function:

empty()

bool TrackList::empty

(

)

const

Definition at line 1010 of file Track.cpp.

{
   return begin() == end();
}

References begin(), and end().

Referenced by anonymous_namespace{Track.cpp}::Accumulate(), ClearPendingTracks(), ProjectFileManager::Import(), ApplyMacroDialog::OnApplyToFiles(), and size().

Here is the call graph for this function:

Here is the caller graph for this function:

EmptyRange()

auto TrackList::EmptyRange ( ) const

private

Definition at line 635 of file Track.cpp.

{
   auto it = const_cast<TrackList*>(this)->getEnd();
   return {
      { it, it, it, &Track::Any },
      { it, it, it, &Track::Any }
   };
}

References Track::Any(), and getEnd().

Here is the call graph for this function:

end() [1/2]

iterator TrackList::end ( )

inline

Definition at line 1394 of file Track.h.

{ return Any().end(); }

Referenced by TimeShiftHandle::DoSlideVertical(), empty(), FindUndoTracks(), HasPendingTracks(), MakeMultiChannelTrack(), and RecalcPositions().

Here is the caller graph for this function:

end() [2/2]

const_iterator TrackList::end ( ) const

inline

Definition at line 1396 of file Track.h.

{ return Any().end(); }

EndIterator()

template<typename TrackType >

TrackIter< TrackType > TrackList::EndIterator ( ) const

inlineprivate

Definition at line 1670 of file Track.h.

   {
      auto e = const_cast<TrackList*>(this)->getEnd();
      return { e, e, e };
   }

EnsureVisibleEvent()

void TrackList::EnsureVisibleEvent ( const std::shared_ptr< Track > &  pTrack, bool  modifyState  )

private

Definition at line 607 of file Track.cpp.

{
   QueueEvent({ TrackListEvent::TRACK_REQUEST_VISIBLE,
      pTrack, static_cast<int>(modifyState) });
}

References QueueEvent(), and TrackListEvent::TRACK_REQUEST_VISIBLE.

Here is the call graph for this function:

Find() [1/2]

template<typename TrackType = const Track>

auto TrackList::Find ( const Track *  pTrack ) const -> std::enable_if_t< std::is_const_v<TrackType>, TrackIter< TrackType > >

inline

Turn a pointer into a TrackIter (constant time); get end iterator if this does not own the track.

const overload will only produce iterators over const TrackType

Definition at line 1414 of file Track.h.

   {
      if (!pTrack || pTrack->GetOwner().get() != this)
         return EndIterator<TrackType>();
      else
         return MakeTrackIterator<TrackType>( pTrack->GetNode() );
   }

Find() [2/2]

template<typename TrackType = Track>

auto TrackList::Find ( Track *  pTrack ) -> TrackIter< TrackType >

inline

Turn a pointer into a TrackIter (constant time); get end iterator if this does not own the track.

Definition at line 1402 of file Track.h.

   {
      if (!pTrack || pTrack->GetOwner().get() != this)
         return EndIterator<TrackType>();
      else
         return MakeTrackIterator<TrackType>( pTrack->GetNode() );
   }

Referenced by TimeShiftHandle::DoSlideVertical(), anonymous_namespace{TimeShiftHandle.cpp}::FindCorrespondence(), anonymous_namespace{TrackView.cpp}::TrackPositioner::OnUpdate(), and RecalcPositions().

Here is the caller graph for this function:

FindById()

Track * TrackList::FindById

(

TrackId

id

)

Definition at line 689 of file Track.cpp.

{
   // Linear search.  Tracks in a project are usually very few.
   // Search only the non-pending tracks.
   auto it = std::find_if( ListOfTracks::begin(), ListOfTracks::end(),
      [=](const ListOfTracks::value_type &ptr){ return ptr->GetId() == id; } );
   if (it == ListOfTracks::end())
      return {};
   return it->get();
}

References PackedArray::begin(), and PackedArray::end().

Referenced by ApplyPendingTracks(), TrackPanelAx::IsFocused(), and UpdatePendingTracks().

Here is the call graph for this function:

Here is the caller graph for this function:

FindLeader() [1/2]

TrackIter< const Track > TrackList::FindLeader ( const Track *  pTrack ) const

inline

Definition at line 1432 of file Track.h.

   {
      return const_cast<TrackList*>(this)->
         FindLeader( const_cast<Track*>(pTrack) ).Filter< const Track >();
   }

FindLeader() [2/2]

auto TrackList::FindLeader

(

Track *

pTrack

)

Definition at line 645 of file Track.cpp.

{
   auto iter = Find(pTrack);
   while( *iter && ! ( *iter )->IsLeader() )
      --iter;
   return iter.Filter( &Track::IsLeader );
}

References ActiveProjects::Find(), and Track::IsLeader().

Referenced by TrackPanel::FindTrackRect(), TrackPanel::RefreshTrack(), TrackFocus::Set(), and SwapNodes().

Here is the call graph for this function:

Here is the caller graph for this function:

FindUndoTracks()

TrackList * TrackList::FindUndoTracks ( const UndoStackElem &  state )

static

Definition at line 1395 of file Track.cpp.

{
   auto &exts = state.state.extensions;
   auto end = exts.end(),
      iter = std::find_if(exts.begin(), end, [](auto &pExt){
         return dynamic_cast<TrackListRestorer*>(pExt.get());
      });
   if (iter != end)
      return static_cast<TrackListRestorer*>(iter->get())->mpTracks.get();
   return nullptr;
}

References end(), UndoState::extensions, exts, and UndoStackElem::state.

Referenced by anonymous_namespace{HistoryWindow.cpp}::SpaceUsageCalculator::Calculate(), ProjectFileManager::Compact(), and EstimateRemovedBlocks().

Here is the call graph for this function:

Here is the caller graph for this function:

Get() [1/2]

TrackList & TrackList::Get ( AudacityProject &  project )

static

Definition at line 487 of file Track.cpp.

{
   return project.AttachedObjects::Get< TrackList >( key );
}

References key.

Referenced by SelectUtilities::ActivatePlayRegion(), ProjectFileManager::AddImportedTracks(), SelectHandle::AdjustSelection(), AdornedRulerPanel::AdornedRulerPanel(), AnyTracksSelectedPred(), AppendItem(), ImportCommand::Apply(), ScreenshotCommand::Apply(), SelectTimeCommand::Apply(), SelectTracksCommand::Apply(), SetLabelCommand::Apply(), SetTrackBase::Apply(), BrushHandleHitTest(), TrackSelectHandle::CalculateRearrangingThresholds(), TrackPanelResizeHandle::Cancel(), ProjectAudioManager::CancelRecording(), anonymous_namespace{Track.cpp}::TrackListRestorer::CanUndoOrRedo(), Exporter::CheckMix(), ProjectAudioManager::ChooseExistingRecordingTracks(), ButtonHandle::Click(), TrackPanelResizeHandle::Click(), LabelDefaultClickHandle::Click(), LabelGlyphHandle::Click(), BrushHandle::Click(), SelectHandle::Click(), TimeShiftHandle::Click(), BackgroundHandle::Click(), anonymous_namespace{EditMenus.cpp}::CutCopyAvailableFlag(), ProjectAudioIO::DefaultOptionsFactory(), anonymous_namespace{LabelMenus.cpp}::DoAddLabel(), anonymous_namespace{TrackMenus.cpp}::DoAlign(), anonymous_namespace{SelectMenus.cpp}::DoBoundaryMove(), anonymous_namespace{ClipMenus.cpp}::DoClipLeftOrRight(), LOFImportFileHandle::doDurationAndScrollOffset(), LabelTrackView::DoEditLabels(), EffectUI::DoEffect(), anonymous_namespace{FileMenus.cpp}::DoExport(), DoImportMIDI(), LabelTrackView::DoKeyDown(), SelectUtilities::DoListSelection(), anonymous_namespace{TrackMenus.cpp}::DoMixAndRender(), anonymous_namespace{TransportMenus.cpp}::DoMoveToLabel(), TrackUtilities::DoMoveTrack(), anonymous_namespace{NavigationMenus.cpp}::DoNextTrack(), anonymous_namespace{TrackMenus.cpp}::DoPanTracks(), anonymous_namespace{EditMenus.cpp}::DoPasteNothingSelected(), anonymous_namespace{EditMenus.cpp}::DoPasteText(), anonymous_namespace{NavigationMenus.cpp}::DoPrevTrack(), ProjectAudioManager::DoRecord(), TrackUtilities::DoRemoveTrack(), TrackUtilities::DoRemoveTracks(), ProjectFileManager::DoSave(), SelectUtilities::DoSelectSomething(), anonymous_namespace{SelectUtilities.cpp}::DoSelectTimeAndAudioTracks(), SelectUtilities::DoSelectTimeAndTracks(), anonymous_namespace{TrackMenus.cpp}::DoSortTracks(), TrackUtilities::DoTrackMute(), TrackUtilities::DoTrackSolo(), LyricsPanel::DoUpdateLyrics(), ProjectWindow::DoZoomFit(), anonymous_namespace{ViewMenus.cpp}::DoZoomFitV(), ButtonHandle::Drag(), TrackPanelResizeHandle::Drag(), LabelTextHandle::Drag(), NoteTrackVZoomHandle::Drag(), SpectrumVZoomHandle::Drag(), WaveformVZoomHandle::Drag(), TimeTrackVZoomHandle::Drag(), BrushHandle::Drag(), SelectHandle::Drag(), TimeShiftHandle::Drag(), TrackSelectHandle::Drag(), anonymous_namespace{DropoutDetector.cpp}::DropoutSubscription::DropoutSubscription(), EditableTracksSelectedPred(), cloud::ShareAudioToolbar::EnableDisableButtons(), ControlToolBar::EnableDisableButtons(), TranscriptionToolBar::EnableDisableButtons(), EstimateRemovedBlocks(), Exporter::ExamineTracks(), TimerRecordDialog::ExecutePostRecordActions(), GetInfoCommand::ExploreTrackPanel(), ExportCL::Export(), ExportFFmpeg::Export(), ExportFLAC::Export(), ExportMP3::Export(), ExportOGG::Export(), ExportPCM::Export(), ExportWavPack::Export(), cloud::audiocom::ShareAudioDialog::ExportProject(), anonymous_namespace{ClipMenus.cpp}::FindClipBoundaries(), anonymous_namespace{ClipMenus.cpp}::FindClips(), ProjectWindow::FixScrollbars(), SpectrumView::ForAll(), ProjectFileIO::GenerateDoc(), Get(), GetAllSeqBlocks(), FrequencyPlotDialog::GetAudio(), ContrastDialog::GetDB(), GetPropertiesOfSelected(), CompareAudioCommand::GetSelection(), SliderHandle::GetSlider(), ScreenshotCommand::GetTrackRect(), TrackPanelAx::GetTracks(), ProjectWindow::GetZoomOfToFit(), LabelGlyphHandle::HandleGlyphDragRelease(), AUPImportFileHandle::HandleImport(), AUPImportFileHandle::HandleLabelTrack(), AUPImportFileHandle::HandleNoteTrack(), AUPImportFileHandle::HandleTimeTrack(), AUPImportFileHandle::HandleWaveTrack(), SelectHandle::HitTest(), ProjectFileManager::Import(), AUPImportFileHandle::Import(), anonymous_namespace{ProjectFileManager.cpp}::ImportProject(), EffectEqualization::Init(), NyquistEffect::Init(), anonymous_namespace{LabelMenus.cpp}::LabelsSelectedFlag(), LabelTracksExistFlag(), LOFImportFileHandle::lofOpenFiles(), MixerBoard::MixerBoard(), anonymous_namespace{SelectMenus.cpp}::MoveWhenAudioInactive(), anonymous_namespace{TrackMenus.cpp}::MuteTracks(), anonymous_namespace{SelectMenus.cpp}::NearestZeroCrossing(), WaveTrack::New(), LabelTrack::New(), NoteTrack::New(), TimeTrack::New(), anonymous_namespace{ExportMIDI.cpp}::NoteTracksExistFlag(), ApplyMacroDialog::OnApplyToFiles(), ProjectManager::OnCloseWindow(), ViewActions::Handler::OnCollapseAllTracks(), ProjectAudioManager::OnCommitRecording(), anonymous_namespace{EditMenus.cpp}::OnCopy(), anonymous_namespace{LabelMenus.cpp}::OnCopyLabels(), SelectActions::Handler::OnCursorTrackEnd(), SelectActions::Handler::OnCursorTrackStart(), anonymous_namespace{EditMenus.cpp}::OnCut(), anonymous_namespace{LabelMenus.cpp}::OnCutLabels(), anonymous_namespace{EditMenus.cpp}::OnDelete(), anonymous_namespace{LabelMenus.cpp}::OnDeleteLabels(), anonymous_namespace{EditMenus.cpp}::OnDisjoin(), anonymous_namespace{LabelMenus.cpp}::OnDisjoinLabels(), anonymous_namespace{EditMenus.cpp}::OnDuplicate(), AudacityApp::OnExceptionInMainLoop(), ViewActions::Handler::OnExpandAllTracks(), anonymous_namespace{FileMenus.cpp}::OnExportLabels(), anonymous_namespace{ExportMIDI.cpp}::OnExportMIDI(), NavigationActions::Handler::OnFirstTrack(), ContrastDialog::OnGetBackground(), ContrastDialog::OnGetForeground(), anonymous_namespace{FileMenus.cpp}::OnImportLabels(), anonymous_namespace{EditMenus.cpp}::OnJoin(), anonymous_namespace{LabelMenus.cpp}::OnJoinLabels(), NavigationActions::Handler::OnLastTrack(), WaveTrackMenuTable::OnMergeStereo(), anonymous_namespace{LabelMenus.cpp}::OnNewLabelTrack(), anonymous_namespace{WaveTrackMenuItems.cpp}::OnNewStereoTrack(), anonymous_namespace{TimeTrackMenuItems.cpp}::OnNewTimeTrack(), anonymous_namespace{WaveTrackMenuItems.cpp}::OnNewWaveTrack(), anonymous_namespace{FileMenus.cpp}::OnOpen(), anonymous_namespace{EditMenus.cpp}::OnPaste(), anonymous_namespace{LabelMenus.cpp}::OnPasteNewLabel(), anonymous_namespace{Printing.cpp}::OnPrint(), ProjectAudioManager::OnRecord(), anonymous_namespace{EditMenus.cpp}::OnRedo(), anonymous_namespace{TrackMenus.cpp}::OnResample(), SelectActions::Handler::OnSelectAll(), SelectActions::Handler::OnSelectCursorEnd(), SelectActions::Handler::OnSelectStartCursor(), SelectActions::Handler::OnSelectSyncLockSel(), SelectActions::Handler::OnSelectTrackStartToEnd(), ScreenshotBigDialog::OnShortTracks(), anonymous_namespace{EditMenus.cpp}::OnSilence(), anonymous_namespace{LabelMenus.cpp}::OnSilenceLabels(), anonymous_namespace{EditMenus.cpp}::OnSplit(), anonymous_namespace{EditMenus.cpp}::OnSplitCut(), anonymous_namespace{LabelMenus.cpp}::OnSplitCutLabels(), anonymous_namespace{EditMenus.cpp}::OnSplitDelete(), anonymous_namespace{LabelMenus.cpp}::OnSplitDeleteLabels(), anonymous_namespace{LabelMenus.cpp}::OnSplitLabels(), anonymous_namespace{EditMenus.cpp}::OnSplitNew(), WaveTrackMenuTable::OnSwapChannels(), anonymous_namespace{TimerRecordDialog.cpp}::OnTimerRecord(), anonymous_namespace{TrackMenus.cpp}::OnTrackMoveBottom(), anonymous_namespace{TrackMenus.cpp}::OnTrackMoveDown(), anonymous_namespace{TrackMenus.cpp}::OnTrackMoveTop(), anonymous_namespace{TrackMenus.cpp}::OnTrackMoveUp(), anonymous_namespace{EditMenus.cpp}::OnTrim(), anonymous_namespace{EditMenus.cpp}::OnUndo(), anonymous_namespace{TrackView.cpp}::TrackPositioner::OnUpdate(), ProjectFileManager::OpenProjectFile(), TimeTrack::PasteInto(), anonymous_namespace{MixerBoard.cpp}::PlayableTracksExistFlag(), TranscriptionToolBar::PlayAtSpeed(), ProjectAudioManager::PlayPlayRegion(), TrackSelectHandle::Preview(), NyquistEffect::Process(), SpectralDataManager::ProcessTracks(), TrackPanel::ProcessUIHandleResult(), ProjectFileManager::ReadProjectFile(), RealtimeEffectPanel::RealtimeEffectPanel(), ProjectWindow::RedrawProject(), ButtonHandle::Release(), LabelTextHandle::Release(), NoteTrackButtonHandle::Release(), NoteTrackVZoomHandle::Release(), SpectrumVZoomHandle::Release(), WaveformVZoomHandle::Release(), TimeTrackVZoomHandle::Release(), AffordanceHandle::Release(), LabelDefaultClickHandle::RestoreState(), anonymous_namespace{Track.cpp}::TrackListRestorer::RestoreUndoRedoState(), ProjectManager::SafeToOpenProjectInto(), ProjectFileIO::SaveCopy(), LabelDefaultClickHandle::SaveState(), ProjectWindow::ScrollingLowerBoundTime(), anonymous_namespace{SelectMenus.cpp}::SeekWhenAudioInactive(), NoteTrackAffordanceHandle::SelectAt(), SelectUtilities::SelectNone(), GetInfoCommand::SendClips(), GetInfoCommand::SendEnvelopes(), GetInfoCommand::SendLabels(), GetInfoCommand::SendTracks(), TrackFocus::Set(), ScreenshotBigDialog::SizeTracks(), ProjectWindow::SkipEnd(), WaveTrackMenuTable::SplitStereo(), ProjectSelectionManager::SSBL_GetRate(), StereoRequiredFlag(), anonymous_namespace{Track.cpp}::TrackListRestorer::TrackListRestorer(), anonymous_namespace{TrackView.cpp}::TrackPositioner::TrackPositioner(), TracksExistFlag(), ProjectSettings::UpdatePrefs(), RealtimeEffectPanel::PrefsListenerHelper::UpdatePrefs(), WaveTracksExistFlag(), WaveTracksSelectedFlag(), ProjectFileIO::WriteXML(), ProjectWindow::ZoomAfterImport(), ZoomInAvailableFlag(), and ZoomOutAvailableFlag().

Get() [2/2]

const TrackList & TrackList::Get ( const AudacityProject &  project )

static

Definition at line 492 of file Track.cpp.

{
   return Get( const_cast< AudacityProject & >( project ) );
}

References Get().

Here is the call graph for this function:

getBegin()

TrackNodePointer TrackList::getBegin ( ) const

inlineprivate

Definition at line 1684 of file Track.h.

   { return { const_cast<TrackList*>(this)->ListOfTracks::begin(),
              const_cast<TrackList*>(this)}; }

References PackedArray::begin().

Referenced by ClearPendingTracks(), DoAddToHead(), and Permute().

Here is the call graph for this function:

Here is the caller graph for this function:

getEnd()

TrackNodePointer TrackList::getEnd ( ) const

inlineprivate

Definition at line 1681 of file Track.h.

   { return { const_cast<TrackList*>(this)->ListOfTracks::end(),
              const_cast<TrackList*>(this)}; }

References PackedArray::end().

Referenced by DoAdd(), EmptyRange(), Remove(), and size().

Here is the call graph for this function:

Here is the caller graph for this function:

GetEndTime()

double TrackList::GetEndTime

(

)

const

Definition at line 1053 of file Track.cpp.

{
   return Accumulate(*this, &Track::GetEndTime, -DBL_MAX, std::max);
}

References anonymous_namespace{Track.cpp}::Accumulate(), and Track::GetEndTime().

Referenced by SelectTimeCommand::Apply(), LOFImportFileHandle::doDurationAndScrollOffset(), ExportMultipleDialog::ExportMultipleByLabel(), and AdornedRulerPanel::StartQPPlay().

Here is the call graph for this function:

Here is the caller graph for this function:

GetMinOffset()

double TrackList::GetMinOffset

(

)

const

Definition at line 1043 of file Track.cpp.

{
   return Accumulate(*this, &Track::GetOffset, DBL_MAX, std::min);
}

References anonymous_namespace{Track.cpp}::Accumulate(), Track::GetOffset(), and min().

Here is the call graph for this function:

GetNext()

Track * TrackList::GetNext ( Track *  t, bool  linked = false  ) const

private

Return a track in the list that comes after Track t.

Definition at line 851 of file Track.cpp.

{
   if (t) {
      auto node = t->GetNode();
      if ( !isNull( node ) ) {
         if ( linked && t->HasLinkedTrack() )
            node = getNext( node );
 
         if ( !isNull( node ) )
            node = getNext( node );
 
         if ( !isNull( node ) )
            return node.first->get();
      }
   }
 
   return nullptr;
}

References getNext(), Track::GetNode(), Track::HasLinkedTrack(), and isNull().

Referenced by CanMoveDown(), and MoveDown().

Here is the call graph for this function:

Here is the caller graph for this function:

getNext()

TrackNodePointer TrackList::getNext ( TrackNodePointer  p ) const

inlineprivate

Move an iterator to the next node, if any; else stay at end.

Definition at line 1689 of file Track.h.

   {
      if ( isNull(p) )
         return p;
      auto q = p;
      ++q.first;
      return q;
   }

Referenced by GetNext(), and Remove().

Here is the caller graph for this function:

GetOwner() [1/2]

AudacityProject * TrackList::GetOwner ( )

inline

Definition at line 1376 of file Track.h.

{ return mOwner; }

Referenced by EffectBase::FindProject(), and EffectBase::Preview().

Here is the caller graph for this function:

GetOwner() [2/2]

const AudacityProject * TrackList::GetOwner ( ) const

inline

Definition at line 1377 of file Track.h.

{ return mOwner; }

GetPrev()

Track * TrackList::GetPrev ( Track *  t, bool  linked = false  ) const

private

Definition at line 870 of file Track.cpp.

{
   if (t) {
      TrackNodePointer prev;
      auto node = t->GetNode();
      if ( !isNull( node ) ) {
         // linked is true and input track second in team?
         if (linked) {
            prev = getPrev( node );
            if( !isNull( prev ) &&
                !t->HasLinkedTrack() && t->GetLinkedTrack() )
               // Make it the first
               node = prev;
         }
 
         prev = getPrev( node );
         if ( !isNull( prev ) ) {
            // Back up once
            node = prev;
 
            // Back up twice sometimes when linked is true
            if (linked) {
               prev = getPrev( node );
               if( !isNull( prev ) &&
                   !(*node.first)->HasLinkedTrack() && (*node.first)->GetLinkedTrack() )
                  node = prev;
            }
 
            return node.first->get();
         }
      }
   }
 
   return nullptr;
}

References Track::GetLinkedTrack(), Track::GetNode(), getPrev(), Track::HasLinkedTrack(), and isNull().

Referenced by CanMoveUp(), and MoveUp().

Here is the call graph for this function:

Here is the caller graph for this function:

getPrev()

TrackNodePointer TrackList::getPrev ( TrackNodePointer  p ) const

inlineprivate

Move an iterator to the previous node, if any; else wrap to end.

Definition at line 1699 of file Track.h.

   {
      if (p == getBegin())
         return getEnd();
      else {
         auto q = p;
         --q.first;
         return q;
      }
   }

Referenced by DoAdd(), GetPrev(), RecalcPositions(), and size().

Here is the caller graph for this function:

GetStartTime()

double TrackList::GetStartTime

(

)

const

Definition at line 1048 of file Track.cpp.

{
   return Accumulate(*this, &Track::GetStartTime, DBL_MAX, std::min);
}

References anonymous_namespace{Track.cpp}::Accumulate(), Track::GetStartTime(), and min().

Referenced by AdornedRulerPanel::StartQPPlay().

Here is the call graph for this function:

Here is the caller graph for this function:

HasPendingTracks()

bool TrackList::HasPendingTracks

(

)

const

Definition at line 1337 of file Track.cpp.

{
   if ( !mPendingUpdates.empty() )
      return true;
   if (end() != std::find_if(begin(), end(), [](const Track *t){
      return t->GetId() == TrackId{};
   }))
      return true;
   return false;
}

References begin(), end(), Track::GetId(), and mPendingUpdates.

Referenced by anonymous_namespace{Track.cpp}::TrackListRestorer::CanUndoOrRedo().

Here is the call graph for this function:

Here is the caller graph for this function:

isNull()

bool TrackList::isNull ( TrackNodePointer  p ) const

inlineprivate

Definition at line 1678 of file Track.h.

   { return (p.second == this && p.first == ListOfTracks::end())
      || (p.second == &mPendingUpdates && p.first == mPendingUpdates.end()); }

References PackedArray::end().

Referenced by GetNext(), GetPrev(), RecalcPositions(), Remove(), and SwapNodes().

Here is the call graph for this function:

Here is the caller graph for this function:

Leaders() [1/2]

template<typename TrackType = Track>

auto TrackList::Leaders ( ) -> TrackIterRange< TrackType >

inline

Definition at line 1474 of file Track.h.

   {
      return Tracks< TrackType >( &Track::IsLeader );
   }

References Track::IsLeader().

Referenced by ExportMultipleDialog::CountTracksAndLabels(), ExportMultipleDialog::ExportMultipleByTrack(), ScreenshotCommand::GetTrackRect(), TrackSelectHandle::Preview(), NyquistEffect::Process(), and MixerBoard::UpdateTrackClusters().

Here is the call graph for this function:

Here is the caller graph for this function:

Leaders() [2/2]

template<typename TrackType = const Track>

auto TrackList::Leaders ( ) const -> std::enable_if_t< std::is_const_v<TrackType>, TrackIterRange< TrackType > >

inline

Definition at line 1481 of file Track.h.

   {
      return Tracks< TrackType >( &Track::IsLeader );
   }

References Track::IsLeader().

Here is the call graph for this function:

Lock()

template<typename Subclass >

std::shared_ptr< Subclass > TrackList::Lock ( const std::weak_ptr< Subclass > &  wTrack )

inline

Definition at line 1606 of file Track.h.

   {
      auto pTrack = wTrack.lock();
      if (pTrack) {
         auto pList = pTrack->mList.lock();
         if (pTrack && this == pList.get())
            return pTrack;
      }
      return {};
   }

Referenced by SelectHandle::AdjustSelection(), SelectionState::ChangeSelectionOnShiftClick(), ButtonHandle::Click(), BrushHandle::Click(), SelectHandle::Click(), ButtonHandle::Drag(), LabelTextHandle::Drag(), NoteTrackVZoomHandle::Drag(), SpectrumVZoomHandle::Drag(), WaveformVZoomHandle::Drag(), TimeTrackVZoomHandle::Drag(), BrushHandle::Drag(), SelectHandle::Drag(), SliderHandle::GetSlider(), TrackPanel::ProcessUIHandleResult(), ButtonHandle::Release(), LabelTextHandle::Release(), NoteTrackButtonHandle::Release(), NoteTrackVZoomHandle::Release(), SpectrumVZoomHandle::Release(), WaveformVZoomHandle::Release(), TimeTrackVZoomHandle::Release(), LabelDefaultClickHandle::RestoreState(), and NoteTrackAffordanceHandle::SelectAt().

Here is the caller graph for this function:

MakeMultiChannelTrack()

bool TrackList::MakeMultiChannelTrack	(	Track &	first,
		int	nChannels,
		bool	aligned
	)

Converts channels to a multichannel track.

Parameters

first	and the following must be in this list. Tracks should not be a part of another group (not linked)
nChannels	number of channels, for now only 2 channels supported
aligned	if true, the link type will be set to Track::LinkType::Aligned, or Track::LinkType::Group otherwise

Returns

true on success, false if some prerequisites do not met

Definition at line 763 of file Track.cpp.

{
   if (nChannels != 2)
      return false;
 
   auto list = track.mList.lock();
   if (list.get() == this)
   {
      if (*list->FindLeader(&track) != &track)
         return false;
 
      auto first = list->Find(&track);
      auto canLink = [&]() -> bool {
         int count = nChannels;
         for (auto it = first, end = TrackList::end(); it != end && count; ++it)
         {
            if ((*it)->HasLinkedTrack())
               return false;
            --count;
         }
         return count == 0;
      }();
 
      if (!canLink)
         return false;
 
      (*first)->SetChannel(Track::LeftChannel);
      auto second = std::next(first);
      (*second)->SetChannel(Track::RightChannel);
      (*first)->SetLinkType(aligned ? Track::LinkType::Aligned : Track::LinkType::Group);
   }
   else
      THROW_INCONSISTENCY_EXCEPTION;
   return true;
}

References Track::Aligned, end(), Track::Group, Track::LeftChannel, Track::mList, Track::RightChannel, and THROW_INCONSISTENCY_EXCEPTION.

Referenced by ProjectAudioManager::DoRecord(), and EffectBase::Preview().

Here is the call graph for this function:

Here is the caller graph for this function:

MakeTrackIterator()

template<typename TrackType >

TrackIter< TrackType > TrackList::MakeTrackIterator ( TrackNodePointer  iter ) const

inlineprivate

Definition at line 1661 of file Track.h.

   {
      auto b = const_cast<TrackList*>(this)->getBegin();
      auto e = const_cast<TrackList*>(this)->getEnd();
      return { b, iter, e };
   }

MakeUniqueTrackName()

wxString TrackList::MakeUniqueTrackName

(

const wxString &

baseTrackName

)

const

Returns string that contains baseTrackName, but is guaranteed to be unique among other tracks in that list.

Parameters

baseTrackName

String to be put into the template

Returns

Formatted string: "[baseTrackName] [N]"

Definition at line 544 of file Track.cpp.

{
   int n = 1;
   while(true)
   {
      auto name = wxString::Format("%s %d", baseTrackName, n++);
 
      bool found {false};
      for(const auto track : Any())
      {
         if(track->GetName() == name)
         {
            found = true;
            break;
         }
      }
      if(!found)
         return name;
   }
}

References Any(), and name.

Referenced by LabelTrack::Create(), and EffectBase::DoEffect().

Here is the call graph for this function:

Here is the caller graph for this function:

Move()

bool TrackList::Move ( Track *  t, bool  up  )

inline

Definition at line 1598 of file Track.h.

{ return up ? MoveUp(t) : MoveDown(t); }

MoveDown()

bool TrackList::MoveDown

(

Track *

t

)

Definition at line 992 of file Track.cpp.

{
   if (t) {
      Track *n = GetNext(t, true);
      if (n) {
         SwapNodes(t->GetNode(), n->GetNode());
         return true;
      }
   }
 
   return false;
}

References GetNext(), Track::GetNode(), and SwapNodes().

Here is the call graph for this function:

MoveUp()

bool TrackList::MoveUp

(

Track *

t

)

Definition at line 979 of file Track.cpp.

{
   if (t) {
      Track *p = GetPrev(t, true);
      if (p) {
         SwapNodes(p->GetNode(), t->GetNode());
         return true;
      }
   }
 
   return false;
}

References Track::GetNode(), GetPrev(), and SwapNodes().

Here is the call graph for this function:

operator=() [1/2]

TrackList & TrackList::operator= ( const TrackList &  )

privatedelete

operator=() [2/2]

TrackList & TrackList::operator= ( TrackList &&  )

privatedelete

PermutationEvent()

void TrackList::PermutationEvent ( TrackNodePointer  node )

private

Definition at line 614 of file Track.cpp.

{
   QueueEvent({ TrackListEvent::PERMUTED, *node.first });
}

References TrackListEvent::PERMUTED, and QueueEvent().

Referenced by Permute(), and SwapNodes().

Here is the call graph for this function:

Here is the caller graph for this function:

Permute()

void TrackList::Permute

(

const std::vector< TrackNodePointer > &

permutation

)

For use in sorting: assume each iterator points into this list, no duplications.

Definition at line 675 of file Track.cpp.

{
   for (const auto iter : permutation) {
      ListOfTracks::value_type track = *iter.first;
      erase(iter.first);
      Track *pTrack = track.get();
      pTrack->SetOwner(shared_from_this(),
         { insert(ListOfTracks::end(), track), this });
   }
   auto n = getBegin();
   RecalcPositions(n);
   PermutationEvent(n);
}

References PackedArray::end(), getBegin(), PermutationEvent(), RecalcPositions(), and Track::SetOwner().

Here is the call graph for this function:

QueueEvent()

void TrackList::QueueEvent ( TrackListEvent  event )

private

Definition at line 588 of file Track.cpp.

{
   BasicUI::CallAfter( [wThis = weak_from_this(), event = std::move(event)]{
      if (auto pThis = wThis.lock())
         pThis->Publish(event);
   } );
}

References BasicUI::CallAfter().

Referenced by AdditionEvent(), DataEvent(), DeletionEvent(), EnsureVisibleEvent(), PermutationEvent(), ResizingEvent(), and SelectionEvent().

Here is the call graph for this function:

Here is the caller graph for this function:

RecalcPositions()

void TrackList::RecalcPositions ( TrackNodePointer  node )

private

Definition at line 565 of file Track.cpp.

{
   if ( isNull( node ) )
      return;
 
   Track *t;
   int i = 0;
 
   auto prev = getPrev( node );
   if ( !isNull( prev ) ) {
      t = prev.first->get();
      i = t->GetIndex() + 1;
   }
 
   const auto theEnd = end();
   for (auto n = Find( node.first->get() ); n != theEnd; ++n) {
      t = *n;
      t->SetIndex(i++);
   }
 
   UpdatePendingTracks();
}

References end(), Find(), Track::GetIndex(), getPrev(), isNull(), Track::SetIndex(), and UpdatePendingTracks().

Referenced by ApplyPendingTracks(), ClearPendingTracks(), DoAdd(), DoAddToHead(), Permute(), Remove(), and SwapNodes().

Here is the call graph for this function:

Here is the caller graph for this function:

RegisterPendingChangedTrack()

std::shared_ptr< Track > TrackList::RegisterPendingChangedTrack	(	Updater	updater,
		Track *	src
	)

Definition at line 1059 of file Track.cpp.

{
   std::shared_ptr<Track> pTrack;
   if (src) {
      pTrack = src->Clone(); // not duplicate
      // Share the satellites with the original, though they do not point back
      // to the pending track
      ((AttachedTrackObjects&)*pTrack) = *src; // shallow copy
   }
 
   if (pTrack) {
      mUpdaters.push_back( updater );
      mPendingUpdates.push_back( pTrack );
      auto n = mPendingUpdates.end();
      --n;
      pTrack->SetOwner(shared_from_this(), {n, &mPendingUpdates});
   }
 
   return pTrack;
}

References Track::Clone(), mPendingUpdates, mUpdaters, and updater.

Referenced by ProjectAudioManager::DoRecord().

Here is the call graph for this function:

Here is the caller graph for this function:

RegisterPendingNewTrack()

void TrackList::RegisterPendingNewTrack

(

const std::shared_ptr< Track > &

pTrack

)

Definition at line 1080 of file Track.cpp.

{
   Add<Track>( pTrack );
   pTrack->SetId( TrackId{} );
}

Referenced by ProjectAudioManager::DoRecord().

Here is the caller graph for this function:

Remove()

TrackNodePointer TrackList::Remove

(

Track *

t

)

Remove the Track and return an iterator to what followed it.

Definition at line 799 of file Track.cpp.

{
   auto result = getEnd();
   if (t) {
      auto node = t->GetNode();
      t->SetOwner({}, {});
 
      if ( !isNull( node ) ) {
         ListOfTracks::value_type holder = *node.first;
 
         result = getNext( node );
         erase(node.first);
         if ( !isNull( result ) )
            RecalcPositions(result);
 
         DeletionEvent(t->shared_from_this(), false);
      }
   }
   return result;
}

References DeletionEvent(), getEnd(), getNext(), Track::GetNode(), isNull(), RecalcPositions(), and Track::SetOwner().

Referenced by EffectBase::DoEffect(), EffectBase::ReplaceProcessedTracks(), and AddedAnalysisTrack::~AddedAnalysisTrack().

Here is the call graph for this function:

Here is the caller graph for this function:

Replace()

auto TrackList::Replace	(	Track *	t,
		const ListOfTracks::value_type &	with
	)

Replace first track with second track, give back a holder Give the replacement the same id as the replaced

Definition at line 725 of file Track.cpp.

{
   ListOfTracks::value_type holder;
   if (t && with) {
      auto node = t->GetNode();
      t->SetOwner({}, {});
 
      holder = *node.first;
 
      Track *pTrack = with.get();
      *node.first = with;
      pTrack->SetOwner(shared_from_this(), node);
      pTrack->SetId( t->GetId() );
      RecalcPositions(node);
 
      DeletionEvent(t->shared_from_this(), true);
      AdditionEvent(node);
   }
   return holder;
}

References Track::SetId(), and Track::SetOwner().

Referenced by ApplyPendingTracks(), ModifiedAnalysisTrack::ModifiedAnalysisTrack(), EffectBase::ReplaceProcessedTracks(), and ModifiedAnalysisTrack::~ModifiedAnalysisTrack().

Here is the call graph for this function:

Here is the caller graph for this function:

ResizingEvent()

void TrackList::ResizingEvent ( TrackNodePointer  node )

private

Definition at line 630 of file Track.cpp.

{
   QueueEvent({ TrackListEvent::RESIZING, *node.first });
}

References QueueEvent(), and TrackListEvent::RESIZING.

Here is the call graph for this function:

Selected() [1/2]

template<typename TrackType = Track>

auto TrackList::Selected ( ) -> TrackIterRange< TrackType >

inline

Definition at line 1457 of file Track.h.

   {
      return Tracks< TrackType >( &Track::IsSelected );
   }

References Track::IsSelected().

Referenced by AnyTracksSelectedPred(), SelectionState::ChangeSelectionOnShiftClick(), EffectBase::CountWaveTracks(), EditableTracksSelectedPred(), anonymous_namespace{LabelMenus.cpp}::EditByLabel(), anonymous_namespace{LabelMenus.cpp}::EditClipboardByLabel(), TranscriptionToolBar::EnableDisableButtons(), ExportMultipleDialog::ExportMultipleByTrack(), EffectTruncSilence::FindSilences(), anonymous_namespace{EditMenus.cpp}::ForEachCopiedWaveTrack(), FrequencyPlotDialog::GetAudio(), GetPropertiesOfSelected(), anonymous_namespace{LabelMenus.cpp}::GetRegionsByLabel(), CompareAudioCommand::GetSelection(), EffectEqualization::Init(), NyquistEffect::Init(), EffectScienFilter::Init(), EffectCompressor::InitPass1(), anonymous_namespace{LabelMenus.cpp}::LabelsSelectedFlag(), ContrastDialog::OnGetBackground(), ContrastDialog::OnGetForeground(), EffectBase::Preview(), EffectFindClipping::Process(), EffectNoiseReduction::Worker::Process(), EffectTruncSilence::ProcessAll(), StereoRequiredFlag(), and WaveTracksSelectedFlag().

Here is the call graph for this function:

Here is the caller graph for this function:

Selected() [2/2]

template<typename TrackType = const Track>

auto TrackList::Selected ( ) const -> std::enable_if_t< std::is_const_v<TrackType>, TrackIterRange< TrackType > >

inline

Definition at line 1464 of file Track.h.

   {
      return Tracks< TrackType >( &Track::IsSelected );
   }

References Track::IsSelected().

Here is the call graph for this function:

SelectedLeaders() [1/2]

template<typename TrackType = Track>

auto TrackList::SelectedLeaders ( ) -> TrackIterRange< TrackType >

inline

Definition at line 1491 of file Track.h.

   {
      return Tracks< TrackType >( &Track::IsSelectedLeader );
   }

References Track::IsSelectedLeader().

Referenced by EffectBase::CountWaveTracks(), ContrastDialog::GetDB(), and TrackPanel::GetSelectedTrackCount().

Here is the call graph for this function:

Here is the caller graph for this function:

SelectedLeaders() [2/2]

template<typename TrackType = const Track>

auto TrackList::SelectedLeaders ( ) const -> std::enable_if_t< std::is_const_v<TrackType>, TrackIterRange< TrackType > >

inline

Definition at line 1498 of file Track.h.

   {
      return Tracks< TrackType >( &Track::IsSelectedLeader );
   }

References Track::IsSelectedLeader().

Here is the call graph for this function:

SelectionEvent()

void TrackList::SelectionEvent ( const std::shared_ptr< Track > &  pTrack )

private

Definition at line 596 of file Track.cpp.

{
   QueueEvent({ TrackListEvent::SELECTION_CHANGE, pTrack });
}

References QueueEvent(), and TrackListEvent::SELECTION_CHANGE.

Here is the call graph for this function:

SingletonRange()

template<typename TrackType >

static auto TrackList::SingletonRange ( TrackType *  pTrack ) -> TrackIterRange< TrackType >

inlinestatic

Definition at line 1508 of file Track.h.

   {
      return pTrack->GetOwner()->template Any<TrackType>()
         .StartingWith( pTrack ).EndingAfter( pTrack );
   }

References TrackIterRange< TrackType >::EndingAfter(), and TrackIterRange< TrackType >::StartingWith().

Referenced by anonymous_namespace{ClipMenus.cpp}::FindClipBoundaries(), anonymous_namespace{ClipMenus.cpp}::FindClips(), EffectLoudness::Process(), and EffectNormalize::Process().

Here is the call graph for this function:

Here is the caller graph for this function:

size()

size_t TrackList::size

(

)

const

Definition at line 1015 of file Track.cpp.

{
   int cnt = 0;
 
   if (!empty())
      cnt = getPrev( getEnd() ).first->get()->GetIndex() + 1;
 
   return cnt;
}

References empty(), getEnd(), and getPrev().

Referenced by ScreenshotCommand::Apply(), anonymous_namespace{EditMenus.cpp}::EstimateCopiedBlocks(), and ProjectSettings::UpdatePrefs().

Here is the call graph for this function:

Here is the caller graph for this function:

Swap()

void TrackList::Swap

(

TrackList &

that

)

Definition at line 519 of file Track.cpp.

{
   auto SwapLOTs = [](
      ListOfTracks &a, const std::weak_ptr< TrackList > &aSelf,
      ListOfTracks &b, const std::weak_ptr< TrackList > &bSelf )
   {
      a.swap(b);
      for (auto it = a.begin(), last = a.end(); it != last; ++it)
         (*it)->SetOwner(aSelf, {it, &a});
      for (auto it = b.begin(), last = b.end(); it != last; ++it)
         (*it)->SetOwner(bSelf, {it, &b});
   };
 
   const auto self = shared_from_this();
   const auto otherSelf = that.shared_from_this();
   SwapLOTs( *this, self, that, otherSelf );
   SwapLOTs( this->mPendingUpdates, self, that.mPendingUpdates, otherSelf );
   mUpdaters.swap(that.mUpdaters);
}

SwapChannels()

bool TrackList::SwapChannels ( Track &  track )

static

If the given track is one of a pair of channels, swap them.

Returns

success

Definition at line 654 of file Track.cpp.

{
   if (!track.HasLinkedTrack())
      return false;
   auto pOwner = track.GetOwner();
   if (!pOwner)
      return false;
   auto pPartner = pOwner->GetNext(&track, false);
   if (!pPartner)
      return false;
 
   // Swap channels, avoiding copying of GroupData
   auto pData = move(track.mpGroupData);
   assert(pData);
   pOwner->MoveUp(pPartner);
   pPartner->mpGroupData = move(pData);
   pPartner->SetChannel(Track::LeftChannel);
   track.SetChannel(Track::RightChannel);
   return true;
}

References Track::GetOwner(), Track::HasLinkedTrack(), Track::LeftChannel, Track::mpGroupData, Track::RightChannel, and Track::SetChannel().

Referenced by WaveTrackMenuTable::OnSwapChannels().

Here is the call graph for this function:

Here is the caller graph for this function:

SwapNodes()

void TrackList::SwapNodes ( TrackNodePointer  s1, TrackNodePointer  s2  )

private

Definition at line 920 of file Track.cpp.

{
   // if a null pointer is passed in, we want to know about it
   wxASSERT(!isNull(s1));
   wxASSERT(!isNull(s2));
 
   // Deal with first track in each team
   s1 = ( * FindLeader( s1.first->get() ) )->GetNode();
   s2 = ( * FindLeader( s2.first->get() ) )->GetNode();
 
   // Safety check...
   if (s1 == s2)
      return;
 
   // Be sure s1 is the earlier iterator
   if ((*s1.first)->GetIndex() >= (*s2.first)->GetIndex())
      std::swap(s1, s2);
 
   // For saving the removed tracks
   using Saved = std::vector< ListOfTracks::value_type >;
   Saved saved1, saved2;
 
   auto doSave = [&] ( Saved &saved, TrackNodePointer &s ) {
      size_t nn = Channels( s.first->get() ).size();
      saved.resize( nn );
      // Save them in backwards order
      while( nn-- )
         saved[nn] = *s.first, s.first = erase(s.first);
   };
 
   doSave( saved1, s1 );
   // The two ranges are assumed to be disjoint but might abut
   const bool same = (s1 == s2);
   doSave( saved2, s2 );
   if (same)
      // Careful, we invalidated s1 in the second doSave!
      s1 = s2;
 
   // Reinsert them
   auto doInsert = [&] ( Saved &saved, TrackNodePointer &s ) {
      Track *pTrack;
      for (auto & pointer : saved)
         pTrack = pointer.get(),
         // Insert before s, and reassign s to point at the new node before
         // old s; which is why we saved pointers in backwards order
         pTrack->SetOwner(shared_from_this(),
            s = { insert(s.first, pointer), this } );
   };
   // This does not invalidate s2 even when it equals s1:
   doInsert( saved2, s1 );
   // Even if s2 was same as s1, this correctly inserts the saved1 range
   // after the saved2 range, when done after:
   doInsert( saved1, s2 );
 
   // Now correct the Index in the tracks, and other things
   RecalcPositions(s1);
   PermutationEvent(s1);
}

References Channels(), FindLeader(), isNull(), PermutationEvent(), RecalcPositions(), Track::SetOwner(), and anonymous_namespace{NoteTrack.cpp}::swap().

Referenced by MoveDown(), and MoveUp().

Here is the call graph for this function:

Here is the caller graph for this function:

Tracks() [1/2]

template<typename TrackType = Track, typename Pred = typename TrackIterRange< TrackType >::iterator::FunctionType>

auto TrackList::Tracks ( const Pred &  pred = {} ) -> TrackIterRange< TrackType >

inlineprivate

Definition at line 1633 of file Track.h.

                                      {} )
         -> TrackIterRange< TrackType >
   {
      auto b = getBegin(), e = getEnd();
      return { { b, b, e, pred }, { b, e, e, pred } };
   }

Tracks() [2/2]

template<typename TrackType = const Track, typename Pred = typename TrackIterRange< TrackType >::iterator::FunctionType>

auto TrackList::Tracks ( const Pred &  pred = {} ) const -> std::enable_if_t< std::is_const_v<TrackType>, TrackIterRange< TrackType > >

inlineprivate

Definition at line 1646 of file Track.h.

                                      {} ) const
         -> std::enable_if_t< std::is_const_v<TrackType>,
            TrackIterRange< TrackType >
         >
   {
      auto b = const_cast<TrackList*>(this)->getBegin();
      auto e = const_cast<TrackList*>(this)->getEnd();
      return { { b, b, e, pred }, { b, e, e, pred } };
   }

UnlinkChannels()

void TrackList::UnlinkChannels

(

Track &

track

)

Removes linkage if track belongs to a group.

Definition at line 747 of file Track.cpp.

{
   auto list = track.mList.lock();
   if (list.get() == this)
   {
      auto channels = TrackList::Channels(&track);
      for (auto c : channels)
      {
          c->SetLinkType(Track::LinkType::None);
          c->SetChannel(Track::ChannelType::MonoChannel);
      }
   }
   else
      THROW_INCONSISTENCY_EXCEPTION;
}

References Channels(), Track::mList, Track::None, and THROW_INCONSISTENCY_EXCEPTION.

Referenced by WaveTrackMenuTable::SplitStereo().

Here is the call graph for this function:

Here is the caller graph for this function:

UpdatePendingTracks()

void TrackList::UpdatePendingTracks

(

)

Definition at line 1086 of file Track.cpp.

{
   auto pUpdater = mUpdaters.begin();
   for (const auto &pendingTrack : mPendingUpdates) {
      // Copy just a part of the track state, according to the update
      // function
      const auto &updater = *pUpdater;
      auto src = FindById( pendingTrack->GetId() );
      if (pendingTrack && src) {
         if (updater)
            updater( *pendingTrack, *src );
         pendingTrack->DoSetLinkType(src->GetLinkType());
      }
      ++pUpdater;
   }
}

References FindById(), mPendingUpdates, mUpdaters, anonymous_namespace{LogWindow.cpp}::pUpdater, and updater.

Referenced by ApplyPendingTracks(), ProjectAudioManager::DoRecord(), TrackPanel::ProcessUIHandleResult(), and RecalcPositions().

Here is the call graph for this function:

Here is the caller graph for this function:

Friends And Related Function Documentation

Track

friend class Track

friend

Definition at line 1554 of file Track.h.

Member Data Documentation

mOwner

AudacityProject* TrackList::mOwner

private

Definition at line 1774 of file Track.h.

mPendingUpdates

ListOfTracks TrackList::mPendingUpdates

private

Shadow tracks holding append-recording in progress; need to put them into a list so that GetLink() works.

Beware, they are in a disjoint iteration sequence from ordinary tracks

Definition at line 1778 of file Track.h.

Referenced by ApplyPendingTracks(), Clear(), ClearPendingTracks(), HasPendingTracks(), RegisterPendingChangedTrack(), and UpdatePendingTracks().

mUpdaters

std::vector< Updater > TrackList::mUpdaters

private

This is in correspondence with mPendingUpdates.

Definition at line 1780 of file Track.h.

Referenced by Clear(), ClearPendingTracks(), RegisterPendingChangedTrack(), and UpdatePendingTracks().

sCounter

long TrackList::sCounter = -1

staticprivate

Definition at line 1726 of file Track.h.

Referenced by ApplyPendingTracks(), DoAdd(), and DoAddToHead().

---

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

• Track.h
• Track.cpp