Track Class Reference

Abstract base class for an object holding data associated with points on a time axis. More...

#include <Track.h>

Inheritance diagram for Track:

Collaboration diagram for Track:

Classes
struct	Dispatcher
	Helper for recursive case of metafunction implementing Track::TypeSwitch. More...
struct	Executor
	Variadic template implements metafunction with specializations, to dispatch Track::TypeSwitch. More...
struct	Executor< R, ConcreteType >
	Base case of metafunction implementing Track::TypeSwitch generates operator () with nonvoid return. More...
struct	Executor< R, ConcreteType, Function, Functions... >
	Implements Track::TypeSwitch, its operator() invokes the first function that can accept ConcreteType*. More...
struct	Executor< R, const ConcreteType, Function, Functions... >
	Implements const overload of Track::TypeSwitch, its operator() invokes the first function that can accept ConcreteType*. More...
struct	Executor< void, ConcreteType >
	Base case of metafunction implementing Track::TypeSwitch generates operator () with void return. More...

Public Types
enum	LinkType : int { LinkType::None = 0, LinkType::Group = 2, LinkType::Aligned }
	For two tracks describes the type of the linkage. More...
enum	ChannelType { LeftChannel = 0, RightChannel = 1, MonoChannel = 2 }
using	AttachedObjects = ::AttachedTrackObjects
	Alias for my base type. More...
using	IntervalData = TrackIntervalData
using	Interval = TrackInterval
using	Intervals = std::vector< Interval >
using	ConstInterval = ConstTrackInterval
using	ConstIntervals = std::vector< ConstInterval >
using	Holder = std::shared_ptr< Track >
template<typename R = void>
using	Continuation = std::function< R() >
	Type of arguments passed as optional second parameter to TypeSwitch() cases. More...
using	Fallthrough = Continuation<>
	Type of arguments passed as optional second parameter to TypeSwitch<void>() cases. More...
Public Types inherited from ClientData::Site< Host, ClientData, ObjectCopyingPolicy, Pointer, ObjectLockingPolicy, RegistryLockingPolicy >
using	DataType = ClientData
using	DataPointer = Pointer< ClientData >
using	DataFactory = std::function< DataPointer(Host &) >
	Type of function from which RegisteredFactory is constructed; it builds attachments. More...

Public Member Functions
TrackId	GetId () const
template<typename Subclass = Track>
std::shared_ptr< Subclass >	SharedPointer ()
template<typename Subclass = const Track>
auto	SharedPointer () const -> typename std::enable_if< std::is_const< Subclass >::value, std::shared_ptr< Subclass > >::type
std::shared_ptr< Track >	SubstitutePendingChangedTrack ()
std::shared_ptr< const Track >	SubstitutePendingChangedTrack () const
std::shared_ptr< const Track >	SubstituteOriginalTrack () const
virtual bool	SupportsBasicEditing () const
	Whether this track type implements cut-copy-paste; by default, true. More...
virtual Holder	PasteInto (AudacityProject &) const =0
	Find or create the destination track for a paste, maybe in a different project. More...
virtual ConstIntervals	GetIntervals () const
	Report times on the track where important intervals begin and end, for UI to snap to. More...
virtual Intervals	GetIntervals ()
const std::shared_ptr< CommonTrackCell > &	GetTrackView ()
void	SetTrackView (const std::shared_ptr< CommonTrackCell > &pView)
const std::shared_ptr< CommonTrackCell > &	GetTrackControls ()
void	SetTrackControls (const std::shared_ptr< CommonTrackCell > &pControls)
int	GetIndex () const
void	SetIndex (int index)
virtual bool	LinkConsistencyCheck ()
bool	HasOwner () const
std::shared_ptr< TrackList >	GetOwner () const
LinkType	GetLinkType () const noexcept
bool	IsAlignedWithLeader () const
	Returns true if the leader track has link type LinkType::Aligned. More...
	Track ()
	Track (const Track &orig)
virtual	~ Track ()
void	Init (const Track &orig)
virtual Holder	Duplicate () const
virtual void	Merge (const Track &orig)
wxString	GetName () const
void	SetName (const wxString &n)
wxString	GetDefaultName () const
void	SetDefaultName (const wxString &n)
bool	GetSelected () const
virtual void	SetSelected (bool s)
void	EnsureVisible (bool modifyState=false)
virtual ChannelType	GetChannel () const
virtual double	GetOffset () const =0
void	Offset (double t)
virtual void	SetOffset (double o)
virtual void	SetPan (float)
virtual void	SetPanFromChannelType ()
virtual Holder	Cut (double WXUNUSED(t0), double WXUNUSED(t1))=0
virtual Holder	Copy (double WXUNUSED(t0), double WXUNUSED(t1), bool forClipboard=true) const =0
virtual void	Clear (double WXUNUSED(t0), double WXUNUSED(t1))=0
virtual void	Paste (double WXUNUSED(t), const Track *WXUNUSED(src))=0
virtual void	SyncLockAdjust (double oldT1, double newT1)
virtual void	Silence (double WXUNUSED(t0), double WXUNUSED(t1))=0
virtual void	InsertSilence (double WXUNUSED(t), double WXUNUSED(len))=0
bool	SameKindAs (const Track &track) const
template<typename R = void, typename ... Functions>
R	TypeSwitch (const Functions &...functions)
	Use this function rather than testing track type explicitly and making down-casts. More...
template<typename R = void, typename ... Functions>
R	TypeSwitch (const Functions &...functions) const
	Use this function rather than testing track type explicitly and making down-casts. More...
virtual void	WriteXML (XMLWriter &xmlFile) const =0
virtual bool	GetErrorOpening ()
virtual double	GetStartTime () const =0
virtual double	GetEndTime () const =0
bool	IsSyncLockSelected () const
void	Notify (int code=-1)
bool	Any () const
bool	IsSelected () const
bool	IsSelectedOrSyncLockSelected () const
bool	IsLeader () const
bool	IsSelectedLeader () const
void	AdjustPositions ()
void	WriteCommonXMLAttributes (XMLWriter &xmlFile, bool includeNameAndSelected=true) const
bool	HandleCommonXMLAttribute (const wxChar *attr, const wxChar *value)
Public Member Functions inherited from XMLTagHandler
	XMLTagHandler ()
virtual	~XMLTagHandler ()
virtual bool	HandleXMLTag (const wxChar *tag, const wxChar **attrs)=0
virtual void	HandleXMLEndTag (const wxChar *WXUNUSED(tag))
virtual void	HandleXMLContent (const wxString &WXUNUSED(content))
virtual XMLTagHandler *	HandleXMLChild (const wxChar *tag)=0
bool	ReadXMLTag (const char *tag, const char **attrs)
void	ReadXMLEndTag (const char *tag)
void	ReadXMLContent (const char *s, int len)
XMLTagHandler *	ReadXMLChild (const char *tag)
Public Member Functions inherited from ClientData::Site< Host, ClientData, ObjectCopyingPolicy, Pointer, ObjectLockingPolicy, RegistryLockingPolicy >
	~Site ()
	Site ()
	Site (const Site &other)
Site &	operator= (const Site &other)
	Site (Site &&other)
Site &	operator= (Site &&other)
size_t	size () const
	How many attachment pointers are in the Site. More...
template<typename Subclass = ClientData>
Subclass &	Get (const RegisteredFactory &key)
	Get reference to an attachment, creating on demand if not present, down-cast it to Subclass. More...
template<typename Subclass = const ClientData>
auto	Get (const RegisteredFactory &key) const -> typename std::enable_if< std::is_const< Subclass >::value, Subclass & >::type
	Get reference to an attachment, creating on demand if not present, down-cast it to Subclass. More...
template<typename Subclass = ClientData>
Subclass *	Find (const RegisteredFactory &key)
	Get a (bare) pointer to an attachment, or null, down-cast it to Subclass *; will not create on demand. More...
template<typename Subclass = const ClientData>
auto	Find (const RegisteredFactory &key) const -> typename std::enable_if< std::is_const< Subclass >::value, Subclass * >::type
	Get a (bare) pointer to an attachment, or null, down-cast it to Subclass *; will not create on demand. More...
template<typename ReplacementPointer >
void	Assign (const RegisteredFactory &key, ReplacementPointer &&replacement)
	Reassign Site's pointer to ClientData. More...

Static Public Member Functions
template<typename Subclass = Track>
static std::shared_ptr< Subclass >	SharedPointer (Track *pTrack)
template<typename Subclass = const Track>
static std::shared_ptr< Subclass >	SharedPointer (const Track *pTrack)
static void	FinishCopy (const Track *n, Track *dest)
Static Public Member Functions inherited from ClientData::Site< Host, ClientData, ObjectCopyingPolicy, Pointer, ObjectLockingPolicy, RegistryLockingPolicy >
static size_t	slots ()
	How many static factories have been registered with this specialization of Site. More...

Public Attributes
wxSize	vrulerSize

Protected Member Functions
void	SetLinkType (LinkType linkType)
void	DoSetLinkType (LinkType linkType) noexcept
void	SetChannel (ChannelType c) noexcept
Protected Member Functions inherited from ClientData::Site< Host, ClientData, ObjectCopyingPolicy, Pointer, ObjectLockingPolicy, RegistryLockingPolicy >
template<typename Function >
void	ForEach (const Function &function)
	Invoke function on each ClientData object that has been created in this. More...
template<typename Function >
void	ForEach (const Function &function) const
	Invoke function on each ClientData object that has been created in this. More...
template<typename Function >
ClientData *	FindIf (const Function &function)
	Return pointer to first attachment in this that is not null and satisfies a predicate, or nullptr. More...
template<typename Function >
const ClientData *	FindIf (const Function &function) const
	Return pointer to first attachment in this that is not null and satisfies a predicate, or nullptr. More...
void	BuildAll ()
	For each RegisteredFactory, if the corresponding attachment is absent in this, build and store it. More...

Protected Attributes
std::weak_ptr< TrackList >	mList
TrackNodePointer	mNode {}
	Holds iterator to self, so that TrackList::Find can be constant-time. More...
int	mIndex
	0-based position of this track in its TrackList More...
wxString	mName
wxString	mDefaultName
ChannelType	mChannel
double	mOffset
std::shared_ptr< CommonTrackCell >	mpView
std::shared_ptr< CommonTrackCell >	mpControls

Private Member Functions
void	SetId (TrackId id)
Track *	GetLinkedTrack () const
bool	HasLinkedTrack () const noexcept
	Returns true for leaders of multichannel groups. More...
TrackNodePointer	GetNode () const
	Retrieve mNode with debug checks. More...
void	SetOwner (const std::weak_ptr< TrackList > &list, TrackNodePointer node)
	Update mNode when Track is added to TrackList, or removed from it. More...
virtual Holder	Clone () const =0
virtual TrackKind	GetKind () const

Private Attributes
TrackId	mId
	Identifies the track only in-session, not persistently. More...
LinkType	mLinkType { LinkType::None }
bool	mSelected

Friends
class	TrackList
template<typename T >
std::enable_if< std::is_pointer< T >::value, T >::type	track_cast (Track *track)
	Encapsulate the checked down-casting of track pointers. More...
template<typename T >
std::enable_if< std::is_pointer< T >::value &&std::is_const< typename std::remove_pointer< T >::type >::value, T >::type	track_cast (const Track *track)
	Encapsulate the checked down-casting of track pointers. More...

Detailed Description

Abstract base class for an object holding data associated with points on a time axis.

Fundamental data object of Audacity, displayed in the TrackPanel. Classes derived form it include the WaveTrack, NoteTrack, LabelTrack and TimeTrack.

Definition at line 235 of file Track.h.

Member Typedef Documentation

AttachedObjects

using Track::AttachedObjects = ::AttachedTrackObjects

Alias for my base type.

Definition at line 272 of file Track.h.

ConstInterval

using Track::ConstInterval = ConstTrackInterval

Definition at line 330 of file Track.h.

ConstIntervals

using Track::ConstIntervals = std::vector< ConstInterval >

Definition at line 331 of file Track.h.

Continuation

template<typename R = void>

using Track::Continuation = std::function< R() >

Type of arguments passed as optional second parameter to TypeSwitch() cases.

Definition at line 502 of file Track.h.

Fallthrough

using Track::Fallthrough = Continuation<>

Type of arguments passed as optional second parameter to TypeSwitch<void>() cases.

Definition at line 504 of file Track.h.

Holder

using Track::Holder = std::shared_ptr<Track>

Definition at line 336 of file Track.h.

Interval

using Track::Interval = TrackInterval

Definition at line 328 of file Track.h.

IntervalData

using Track::IntervalData = TrackIntervalData

Definition at line 327 of file Track.h.

Intervals

using Track::Intervals = std::vector< Interval >

Definition at line 329 of file Track.h.

Member Enumeration Documentation

ChannelType

enum Track::ChannelType

Enumerator
LeftChannel
RightChannel
MonoChannel

Definition at line 274 of file Track.h.

   {
      LeftChannel = 0,
      RightChannel = 1,
      MonoChannel = 2
   };

LinkType

enum Track::LinkType : int

strong

For two tracks describes the type of the linkage.

Enumerator
None
Group
Aligned

Definition at line 243 of file Track.h.

                       : int {
       None = 0, //< No linkage
       Group = 2, //< Tracks are grouped together
       Aligned, //< Tracks are grouped and changes should be synchronized
   };

Constructor & Destructor Documentation

Track() [1/2]

Track::Track

(

)

Definition at line 49 of file Track.cpp.

:  vrulerSize(36,0)
{
   mSelected  = false;
 
   mIndex = 0;
 
   mOffset = 0.0;
 
   mChannel = MonoChannel;
}

References mChannel, mIndex, mOffset, MonoChannel, and mSelected.

Track() [2/2]

Track::Track

(

const Track &

orig

)

Definition at line 61 of file Track.cpp.

: vrulerSize( orig.vrulerSize )
{
   mIndex = 0;
   Init(orig);
   mOffset = orig.mOffset;
}

References Init(), mIndex, and mOffset.

Here is the call graph for this function:

~ Track()

virtual Track::~ Track ( )

virtual

Member Function Documentation

AdjustPositions()

void Track::AdjustPositions

(

)

Definition at line 1290 of file Track.cpp.

{
   auto pList = mList.lock();
   if (pList) {
      pList->RecalcPositions(mNode);
      pList->ResizingEvent(mNode);
   }
}

References mList, and mNode.

Any()

bool Track::Any

(

)

const

Definition at line 370 of file Track.cpp.

   { return true; }

Referenced by EffectLoudness::AllocBuffers(), TrackList::Channels_(), ExportPlugin::CreateMixer(), anonymous_namespace{NavigationMenus.cpp}::DoPrevTrack(), TrackList::EmptyRange(), Exporter::ExamineTracks(), ExportMixerDialog::ExportMixerDialog(), ProjectAudioManager::GetAllPlaybackTracks(), AUPImportFileHandle::HandleImport(), anonymous_namespace{ProjectFileManager.cpp}::ImportProject(), TrackActions::Handler::MuteTracks(), LabelEditActions::Handler::OnPasteNewLabel(), anonymous_namespace{MixerBoard.cpp}::PlayableTracksExistFlag(), EffectLoudness::Process(), EffectNormalize::Process(), and ProjectWindow::ZoomAfterImport().

Here is the caller graph for this function:

Clear()

virtual void Track::Clear ( double   WXUNUSEDt0, double   WXUNUSEDt1  )

pure virtual

Referenced by LabelEditActions::Handler::OnDeleteLabels(), and SyncLockAdjust().

Here is the caller graph for this function:

Clone()

virtual Holder Track::Clone ( ) const

privatepure virtual

Implemented in WaveTrack, TimeTrack, NoteTrack, and LabelTrack.

Referenced by Duplicate(), and TrackList::RegisterPendingChangedTrack().

Here is the caller graph for this function:

Copy()

virtual Holder Track::Copy ( double   WXUNUSEDt0, double   WXUNUSEDt1, bool  forClipboard = true  ) const

pure virtual

Cut()

virtual Holder Track::Cut ( double   WXUNUSEDt0, double   WXUNUSEDt1  )

pure virtual

Referenced by SyncLockAdjust().

Here is the caller graph for this function:

DoSetLinkType()

void Track::DoSetLinkType ( LinkType  linkType )

protectednoexcept

Definition at line 193 of file Track.cpp.

{
   mLinkType = linkType;
}

Referenced by SetLinkType().

Here is the caller graph for this function:

Duplicate()

Track::Holder Track::Duplicate ( ) const

virtual

Definition at line 112 of file Track.cpp.

{
   // invoke "virtual constructor" to copy track object proper:
   auto result = Clone();
 
   if (mpView)
      // Copy view state that might be important to undo/redo
      mpView->CopyTo( *result );
 
   return result;
}

References Clone(), and mpView.

Referenced by WaveTrackFactory::DuplicateWaveTrack().

Here is the call graph for this function:

Here is the caller graph for this function:

EnsureVisible()

void Track::EnsureVisible

(

bool

modifyState = false

)

Definition at line 100 of file Track.cpp.

{
   auto pList = mList.lock();
   if (pList)
      pList->EnsureVisibleEvent( SharedPointer(), modifyState );
}

References mList, and SharedPointer().

Referenced by anonymous_namespace{LabelMenus.cpp}::DoAddLabel(), EffectUI::DoEffect(), anonymous_namespace{TrackMenus.cpp}::DoMixAndRender(), anonymous_namespace{EditMenus.cpp}::DoPasteNothingSelected(), anonymous_namespace{NavigationMenus.cpp}::DoPrevTrack(), TrackUtilities::DoRemoveTracks(), TrackPanel::OnMouseEvent(), TrackActions::Handler::OnNewLabelTrack(), TrackActions::Handler::OnNewStereoTrack(), TrackActions::Handler::OnNewTimeTrack(), TrackActions::Handler::OnNewWaveTrack(), LabelEditActions::Handler::OnPasteNewLabel(), EditActions::Handler::OnRedo(), NavigationActions::Handler::OnToggle(), EditActions::Handler::OnUndo(), TrackPanel::ProcessUIHandleResult(), and ProjectWindow::ZoomAfterImport().

Here is the call graph for this function:

Here is the caller graph for this function:

FinishCopy()

void Track::FinishCopy ( const Track *  n, Track *  dest  )

static

Definition at line 387 of file Track.cpp.

{
   if (dest) {
      dest->SetChannel(n->GetChannel());
      dest->SetLinkType(n->GetLinkType());
      dest->SetName(n->GetName());
   }
}

References GetChannel(), GetLinkType(), GetName(), SetChannel(), SetLinkType(), and SetName().

Referenced by anonymous_namespace{EditMenus.cpp}::DoPasteNothingSelected(), anonymous_namespace{LabelMenus.cpp}::EditClipboardByLabel(), anonymous_namespace{EditMenus.cpp}::FinishCopy(), and anonymous_namespace{ProjectFileManager.cpp}::ImportProject().

Here is the call graph for this function:

Here is the caller graph for this function:

GetChannel()

virtual ChannelType Track::GetChannel ( ) const

inlinevirtual

Reimplemented in WaveTrack.

Definition at line 441 of file Track.h.

{ return mChannel;}

Referenced by FinishCopy(), LinkConsistencyCheck(), and anonymous_namespace{NoteTrackControls.cpp}::MidiControlsDrawFunction().

Here is the caller graph for this function:

GetDefaultName()

wxString Track::GetDefaultName ( ) const

inline

Definition at line 428 of file Track.h.

{ return mDefaultName; }

Referenced by TimeTrack::CleanState(), TimeTrack::Init(), WaveTrack::Init(), LabelTrack::LabelTrack(), NoteTrack::NoteTrack(), and WaveTrack::WaveTrack().

Here is the caller graph for this function:

GetEndTime()

virtual double Track::GetEndTime ( ) const

pure virtual

Implemented in WaveTrack, TimeTrack, NoteTrack, and LabelTrack.

Referenced by WaveTrack::ClearAndPaste(), anonymous_namespace{TrackMenus.cpp}::DoAlign(), ExportMultipleDialog::ExportMultipleByTrack(), TrackList::GetEndTime(), StretchHandle::GetT1(), SelectActions::Handler::OnCursorTrackEnd(), ProjectAudioManager::OnRecord(), SelectActions::Handler::OnSelectCursorEnd(), SelectActions::Handler::OnSelectTrackStartToEnd(), NyquistEffect::ProcessOne(), SelectionState::SelectTrackLength(), and SyncLockAdjust().

Here is the caller graph for this function:

GetErrorOpening()

virtual bool Track::GetErrorOpening ( )

inlinevirtual

Reimplemented in WaveTrack.

Definition at line 799 of file Track.h.

{ return false; }

GetId()

TrackId Track::GetId ( ) const

inline

Definition at line 281 of file Track.h.

{ return mId; }

Referenced by TrackList::HasPendingTracks(), TrackPanelAx::IsFocused(), SetLinkType(), SubstituteOriginalTrack(), and SubstitutePendingChangedTrack().

Here is the caller graph for this function:

GetIndex()

int Track::GetIndex

(

)

const

Definition at line 164 of file Track.cpp.

{
   return mIndex;
}

References mIndex.

Referenced by SelectionState::ChangeSelectionOnShiftClick(), TrackList::RecalcPositions(), and SelectionState::SelectRangeOfTracks().

Here is the caller graph for this function:

GetIntervals() [1/2]

auto Track::GetIntervals ( )

virtual

This overload exposes the extra data of the intervals as non-const This overload exposes the extra data of the intervals as non-const

Reimplemented in WaveTrack, NoteTrack, and LabelTrack.

Definition at line 1249 of file Track.cpp.

{
   return {};
}

GetIntervals() [2/2]

auto Track::GetIntervals ( ) const

virtual

Report times on the track where important intervals begin and end, for UI to snap to.

Some intervals may be empty, and no ordering of the intervals is assumed.

Reimplemented in WaveTrack, NoteTrack, and LabelTrack.

Definition at line 1244 of file Track.cpp.

{
   return {};
}

Referenced by TrackShifter::InitIntervals().

Here is the caller graph for this function:

GetKind()

virtual TrackKind Track::GetKind ( ) const

inlineprivatevirtual

Reimplemented in WaveTrack, TimeTrack, NoteTrack, and LabelTrack.

Definition at line 483 of file Track.h.

{ return TrackKind::None; }

References None.

Referenced by SameKindAs(), and track_cast().

Here is the caller graph for this function:

GetLinkedTrack()

Track * Track::GetLinkedTrack ( ) const

private

Definition at line 203 of file Track.cpp.

{
   auto pList = mList.lock();
   if (!pList)
      return nullptr;
 
   if (!pList->isNull(mNode)) {
      if (HasLinkedTrack()) {
         auto next = pList->getNext( mNode );
         if ( !pList->isNull( next ) )
            return next.first->get();
      }
 
      if (mNode.first != mNode.second->begin()) {
         auto prev = pList->getPrev( mNode );
         if ( !pList->isNull( prev ) ) {
            auto track = prev.first->get();
            if (track && track->HasLinkedTrack())
               return track;
         }
      }
   }
 
   return nullptr;
}

References HasLinkedTrack(), mList, and mNode.

Referenced by TrackList::GetPrev(), IsLeader(), and LinkConsistencyCheck().

Here is the call graph for this function:

Here is the caller graph for this function:

GetLinkType()

Track::LinkType Track::GetLinkType ( ) const

noexcept

Definition at line 1312 of file Track.cpp.

{
    return mLinkType;
}

References mLinkType.

Referenced by FinishCopy(), WaveClipTrimHandle::HitAnywhere(), WaveTrack::LinkConsistencyCheck(), and WaveTrackMenuTable::OnSwapChannels().

Here is the caller graph for this function:

GetName()

wxString Track::GetName ( ) const

inline

Definition at line 426 of file Track.h.

{ return mName; }

Referenced by ProjectFileManager::AddImportedTracks(), LabelDialog::AddLabels(), CompareAudioCommand::Apply(), TrackInfo::CloseTitleDrawFunction(), TrackUtilities::DoMoveTrack(), TrackUtilities::DoRemoveTrack(), anonymous_namespace{TrackMenus.cpp}::DoSortTracks(), anonymous_namespace{TrackPanel.cpp}::DrawTrackName(), FinishCopy(), MixerBoard::GetMusicalInstrumentBitmap(), anonymous_namespace{TrackPanel.cpp}::GetTrackNameExtent(), TimeTrack::Init(), WaveTrack::Init(), WaveTrack::Join(), LinkConsistencyCheck(), WaveTrack::LinkConsistencyCheck(), WaveTrack::MakeNewClipName(), MixAndRender(), WaveTrackMenuTable::OnMergeStereo(), TrackMenuTable::OnSetName(), anonymous_namespace{SpectrumView.cpp}::SpectrogramSettingsHandler::OnSpectrogramSettings(), WaveTrackMenuTable::OnSplitStereo(), WaveTrackMenuTable::OnSplitStereoMono(), WaveTrackMenuTable::OnSwapChannels(), EffectFindClipping::Process(), RateMenuTable::SetRate(), WaveTrackMenuTable::SplitStereo(), and WriteCommonXMLAttributes().

Here is the caller graph for this function:

GetNode()

TrackNodePointer Track::GetNode ( ) const

private

Retrieve mNode with debug checks.

Definition at line 129 of file Track.cpp.

{
   wxASSERT(mList.lock() == NULL || this == mNode.first->get());
   return mNode;
}

References mList, and mNode.

Referenced by TrackList::GetNext(), TrackList::GetPrev(), TrackList::MoveDown(), TrackList::MoveUp(), and TrackList::Remove().

Here is the caller graph for this function:

GetOffset()

virtual double Track::GetOffset ( ) const

pure virtual

Implemented in WaveTrack, TimeTrack, NoteTrack, and LabelTrack.

Referenced by anonymous_namespace{TrackMenus.cpp}::DoAlign(), TrackList::GetMinOffset(), SelectActions::Handler::OnCursorTrackStart(), and SelectionState::SelectTrackLength().

Here is the caller graph for this function:

GetOwner()

std::shared_ptr<TrackList> Track::GetOwner ( ) const

inline

Definition at line 379 of file Track.h.

{ return mList.lock(); }

Referenced by TrackShifter::CommonMayMigrateTo(), IsAlignedWithLeader(), WaveTrack::LinkConsistencyCheck(), WaveTrack::PasteWaveTrack(), and WaveTrackAffordanceControls::WaveTrackAffordanceControls().

Here is the caller graph for this function:

GetSelected()

bool Track::GetSelected ( ) const

inline

Definition at line 431 of file Track.h.

{ return mSelected; }

Referenced by ClipParameters::ClipParameters(), TrackInfo::CloseTitleDrawFunction(), anonymous_namespace{NavigationMenus.cpp}::DoPrevTrack(), TrackArt::DrawBackgroundWithSelection(), anonymous_namespace{WaveformView.cpp}::DrawClipWaveform(), TrackInfo::DrawCloseButton(), anonymous_namespace{NoteTrackView.cpp}::DrawNoteTrack(), AudioIoCallback::FillOutputBuffers(), anonymous_namespace{ClipMenus.cpp}::FindClipBoundaries(), anonymous_namespace{ClipMenus.cpp}::FindClips(), SelectionState::HandleListSelection(), StretchHandle::HitTest(), IsSelected(), IsSelectedOrSyncLockSelected(), IsSyncLockSelected(), TrackInfo::MinimizeSyncLockDrawFunction(), anonymous_namespace{PlayableTrackControls.cpp}::MuteOrSoloDrawFunction(), EditActions::Handler::OnPaste(), NavigationActions::Handler::OnToggle(), EffectChangeSpeed::Process(), Generator::Process(), EffectRepeat::Process(), EffectSBSMS::Process(), Effect::ProcessPass(), TrackPanelAx::SetFocus(), LabelTrack::SetSelected(), and WriteCommonXMLAttributes().

Here is the caller graph for this function:

GetStartTime()

virtual double Track::GetStartTime ( ) const

pure virtual

Implemented in WaveTrack, TimeTrack, NoteTrack, and LabelTrack.

Referenced by anonymous_namespace{TrackMenus.cpp}::DoAlign(), ExportMultipleDialog::ExportMultipleByTrack(), TrackList::GetStartTime(), StretchHandle::GetT0(), SelectActions::Handler::OnSelectStartCursor(), SelectActions::Handler::OnSelectTrackStartToEnd(), and NyquistEffect::ProcessOne().

Here is the caller graph for this function:

GetTrackControls()

const std::shared_ptr< CommonTrackCell > & Track::GetTrackControls

(

)

Definition at line 154 of file Track.cpp.

{
   return mpControls;
}

References mpControls.

Referenced by CommonTrackControls::TrackControls().

Here is the caller graph for this function:

GetTrackView()

const std::shared_ptr< CommonTrackCell > & Track::GetTrackView

(

)

Definition at line 144 of file Track.cpp.

{
   return mpView;
}

References mpView.

Referenced by TrackView::Get().

Here is the caller graph for this function:

HandleCommonXMLAttribute()

bool Track::HandleCommonXMLAttribute	(	const wxChar *	attr,
		const wxChar *	value
	)

Definition at line 1269 of file Track.cpp.

{
   long nValue = -1;
   wxString strValue( value );
   if ( mpView && mpView->HandleXMLAttribute( attr, value ) )
      ;
   else if ( mpControls && mpControls->HandleXMLAttribute( attr, value ) )
      ;
   else if (!wxStrcmp(attr, wxT("name")) &&
      XMLValueChecker::IsGoodString(strValue)) {
      SetName( strValue );
      return true;
   }
   else if (!wxStrcmp(attr, wxT("isSelected")) &&
         XMLValueChecker::IsGoodInt(strValue) && strValue.ToLong(&nValue)) {
      this->SetSelected(nValue != 0);
      return true;
   }
   return false;
}

References XMLValueChecker::IsGoodInt(), XMLValueChecker::IsGoodString(), mpControls, mpView, SetName(), and SetSelected().

Referenced by LabelTrack::HandleXMLTag(), NoteTrack::HandleXMLTag(), TimeTrack::HandleXMLTag(), and WaveTrack::HandleXMLTag().

Here is the call graph for this function:

Here is the caller graph for this function:

HasLinkedTrack()

bool Track::HasLinkedTrack ( ) const

privatenoexcept

Returns true for leaders of multichannel groups.

Definition at line 229 of file Track.cpp.

{
    return mLinkType != LinkType::None;
}

References mLinkType, and None.

Referenced by GetLinkedTrack(), TrackList::GetNext(), TrackList::GetPrev(), IsLeader(), and LinkConsistencyCheck().

Here is the caller graph for this function:

HasOwner()

bool Track::HasOwner ( ) const

inline

Definition at line 377 of file Track.h.

{ return static_cast<bool>(GetOwner());}

References TrackList::GetOwner().

Here is the call graph for this function:

Init()

void Track::Init

(

const Track &

orig

)

Definition at line 70 of file Track.cpp.

{
   mId = orig.mId;
 
   mDefaultName = orig.mDefaultName;
   mName = orig.mName;
 
   mSelected = orig.mSelected;
   mLinkType = orig.mLinkType;
   mChannel = orig.mChannel;
}

References mChannel, mDefaultName, mId, mLinkType, mName, and mSelected.

Referenced by PlayableTrack::Init(), TimeTrack::Init(), and Track().

Here is the caller graph for this function:

InsertSilence()

virtual void Track::InsertSilence ( double   WXUNUSEDt, double   WXUNUSEDlen  )

pure virtual

IsAlignedWithLeader()

bool Track::IsAlignedWithLeader

(

)

const

Returns true if the leader track has link type LinkType::Aligned.

Definition at line 1317 of file Track.cpp.

{
   if (auto owner = GetOwner())
   {
      auto leader = *owner->FindLeader(this);
      return leader != this && leader->GetLinkType() == Track::LinkType::Aligned;
   }
   return false;
}

References Aligned, and GetOwner().

Referenced by WaveClipTrimHandle::HitAnywhere().

Here is the call graph for this function:

Here is the caller graph for this function:

IsLeader()

bool Track::IsLeader

(

)

const

Definition at line 379 of file Track.cpp.

{
    return !GetLinkedTrack() || HasLinkedTrack();
}

References GetLinkedTrack(), and HasLinkedTrack().

Referenced by anonymous_namespace{FileMenus.cpp}::DoExport(), anonymous_namespace{TrackMenus.cpp}::DoMixAndRender(), anonymous_namespace{TrackPanel.cpp}::DrawTrackName(), AudioIoCallback::FillOutputBuffers(), TrackList::FindLeader(), IsSelectedLeader(), TrackList::Leaders(), EffectLoudness::Process(), EffectNormalize::Process(), NyquistEffect::Process(), and StereoRequiredFlag().

Here is the call graph for this function:

Here is the caller graph for this function:

IsSelected()

bool Track::IsSelected

(

)

const

Definition at line 373 of file Track.cpp.

   { return GetSelected(); }

References GetSelected().

Referenced by ProjectAudioManager::ChooseExistingRecordingTracks(), ExportPlugin::CreateMixer(), anonymous_namespace{TrackMenus.cpp}::DoPanTracks(), Exporter::ExamineTracks(), ExportMixerDialog::ExportMixerDialog(), ProjectAudioManager::GetAllPlaybackTracks(), IsSelectedLeader(), IsSyncLockSelected(), ProjectAudioManager::OnRecord(), SelectActions::Handler::OnSelectSyncLockSel(), EffectTruncSilence::ProcessIndependently(), and TrackList::Selected().

Here is the call graph for this function:

Here is the caller graph for this function:

IsSelectedLeader()

bool Track::IsSelectedLeader

(

)

const

Definition at line 384 of file Track.cpp.

   { return IsSelected() && IsLeader(); }

References IsLeader(), and IsSelected().

Referenced by TrackList::SelectedLeaders().

Here is the call graph for this function:

Here is the caller graph for this function:

IsSelectedOrSyncLockSelected()

bool Track::IsSelectedOrSyncLockSelected

(

)

const

Definition at line 376 of file Track.cpp.

   { return GetSelected() || IsSyncLockSelected(); }

References GetSelected(), and IsSyncLockSelected().

Referenced by anonymous_namespace{TrackMenus.cpp}::DoAlign(), EffectTruncSilence::DoRemoval(), EditActions::Handler::OnCut(), and EffectReverse::Process().

Here is the call graph for this function:

Here is the caller graph for this function:

IsSyncLockSelected()

bool Track::IsSyncLockSelected

(

)

const

Definition at line 254 of file Track.cpp.

{
#ifdef EXPERIMENTAL_SYNC_LOCK
   auto pList = mList.lock();
   if (!pList)
      return false;
 
   auto p = pList->GetOwner();
   if (!p || !ProjectSettings::Get( *p ).IsSyncLocked())
      return false;
 
   auto shTrack = this->SubstituteOriginalTrack();
   if (!shTrack)
      return false;
 
   const auto pTrack = shTrack.get();
   auto trackRange = TrackList::SyncLockGroup( pTrack );
 
   if (trackRange.size() <= 1) {
      // Not in a sync-locked group.
      // Return true iff selected and of a sync-lockable type.
      return (IsSyncLockableNonLabelTrack( pTrack ) ||
              track_cast<const LabelTrack*>( pTrack )) && GetSelected();
   }
 
   // Return true iff any track in the group is selected.
   return *(trackRange + &Track::IsSelected).begin();
#endif
 
   return false;
}

References ProjectSettings::Get(), GetSelected(), IsSelected(), anonymous_namespace{Track.cpp}::IsSyncLockableNonLabelTrack(), ProjectSettings::IsSyncLocked(), mList, SubstituteOriginalTrack(), and TrackList::SyncLockGroup().

Referenced by ClipParameters::ClipParameters(), TrackArt::DrawBackgroundWithSelection(), anonymous_namespace{WaveformView.cpp}::DrawClipWaveform(), IsSelectedOrSyncLockSelected(), TrackInfo::MinimizeSyncLockDrawFunction(), EditActions::Handler::OnPaste(), SelectActions::Handler::OnSelectSyncLockSel(), EffectChangeSpeed::Process(), EffectRepeat::Process(), and EffectSBSMS::Process().

Here is the call graph for this function:

Here is the caller graph for this function:

LinkConsistencyCheck()

bool Track::LinkConsistencyCheck ( )

virtual

Reimplemented in WaveTrack.

Definition at line 397 of file Track.cpp.

{
   // Sanity checks for linked tracks; unsetting the linked property
   // doesn't fix the problem, but it likely leaves us with orphaned
   // sample blocks instead of much worse problems.
   bool err = false;
   if (HasLinkedTrack())
   {
      auto link = GetLinkedTrack();
      if (link)
      {
         // A linked track's partner should never itself be linked
         if (link->HasLinkedTrack())
         {
            wxLogWarning(
               wxT("Left track %s had linked right track %s with extra right track link.\n   Removing extra link from right track."),
               GetName(), link->GetName());
            err = true;
            link->SetLinkType(LinkType::None);
         }
 
         // Channels should be left and right
         if ( !(  (GetChannel() == Track::LeftChannel &&
                     link->GetChannel() == Track::RightChannel) ||
                  (GetChannel() == Track::RightChannel &&
                     link->GetChannel() == Track::LeftChannel) ) )
         {
            wxLogWarning(
               wxT("Track %s and %s had left/right track links out of order. Setting tracks to not be linked."),
               GetName(), link->GetName());
            err = true;
            SetLinkType(LinkType::None);
         }
      }
      else
      {
         wxLogWarning(
            wxT("Track %s had link to NULL track. Setting it to not be linked."),
            GetName());
         err = true;
         SetLinkType(LinkType::None);
      }
   }
 
   return ! err;
}

References GetChannel(), GetLinkedTrack(), GetName(), HasLinkedTrack(), LeftChannel, None, RightChannel, and SetLinkType().

Referenced by WaveTrack::LinkConsistencyCheck().

Here is the call graph for this function:

Here is the caller graph for this function:

Merge()

void Track::Merge ( const Track &  orig )

virtual

Reimplemented in WaveTrack, and PlayableTrack.

Definition at line 107 of file Track.cpp.

{
   mSelected = orig.mSelected;
}

References mSelected.

Referenced by PlayableTrack::Merge().

Here is the caller graph for this function:

Notify()

void Track::Notify

(

int

code = -1

)

Definition at line 286 of file Track.cpp.

{
   auto pList = mList.lock();
   if (pList)
      pList->DataEvent( SharedPointer(), code );
}

References mList, and SharedPointer().

Referenced by WaveTrack::SetGain(), PlayableTrack::SetMute(), SetName(), WaveTrack::SetPan(), and PlayableTrack::SetSolo().

Here is the call graph for this function:

Here is the caller graph for this function:

Offset()

void Track::Offset ( double  t )

inline

Definition at line 444 of file Track.h.

{ SetOffset(GetOffset() + t); }

Referenced by TrackShifter::DoHorizontalOffset(), Effect::Preview(), and StretchHandle::Stretch().

Here is the caller graph for this function:

Paste()

virtual void Track::Paste ( double   WXUNUSEDt, const Track *  WXUNUSEDsrc  )

pure virtual

Referenced by SyncLockAdjust().

Here is the caller graph for this function:

PasteInto()

virtual Holder Track::PasteInto ( AudacityProject &  ) const

pure virtual

Find or create the destination track for a paste, maybe in a different project.

Returns

A smart pointer to the track; its use_count() can tell whether it is new

Implemented in WaveTrack, TimeTrack, NoteTrack, and LabelTrack.

Referenced by anonymous_namespace{EditMenus.cpp}::DoPasteNothingSelected().

Here is the caller graph for this function:

SameKindAs()

bool Track::SameKindAs ( const Track &  track ) const

inline

Definition at line 497 of file Track.h.

      { return GetKind() == track.GetKind(); }

References GetKind().

Referenced by TrackShifter::CommonMayMigrateTo(), and anonymous_namespace{TimeShiftHandle.cpp}::FindCorrespondence().

Here is the call graph for this function:

Here is the caller graph for this function:

SetChannel()

void Track::SetChannel ( ChannelType  c )

protectednoexcept

Definition at line 198 of file Track.cpp.

{
    mChannel = c;
}

Referenced by FinishCopy(), and WaveTrack::LinkConsistencyCheck().

Here is the caller graph for this function:

SetDefaultName()

void Track::SetDefaultName ( const wxString &  n )

inline

Definition at line 429 of file Track.h.

{ mDefaultName = n; }

Referenced by TimeTrack::CleanState(), TimeTrack::Init(), WaveTrack::Init(), LabelTrack::LabelTrack(), NoteTrack::NoteTrack(), and WaveTrack::WaveTrack().

Here is the caller graph for this function:

SetId()

void Track::SetId ( TrackId  id )

inlineprivate

Definition at line 283 of file Track.h.

{ mId = id; }

References id.

Referenced by TrackList::DoAdd(), TrackList::DoAddToHead(), TrackList::RegisterPendingNewTrack(), and TrackList::Replace().

Here is the caller graph for this function:

SetIndex()

void Track::SetIndex

(

int

index

)

Definition at line 169 of file Track.cpp.

{
   mIndex = index;
}

References mIndex.

Referenced by TrackList::RecalcPositions().

Here is the caller graph for this function:

SetLinkType()

void Track::SetLinkType ( LinkType  linkType )

protected

Definition at line 174 of file Track.cpp.

{
   auto pList = mList.lock();
   if (pList && !pList->mPendingUpdates.empty()) {
      auto orig = pList->FindById( GetId() );
      if (orig && orig != this) {
         orig->SetLinkType(linkType);
         return;
      }
   }
 
   DoSetLinkType(linkType);
 
   if (pList) {
      pList->RecalcPositions(mNode);
      pList->ResizingEvent(mNode);
   }
}

References DoSetLinkType(), GetId(), mList, and mNode.

Referenced by FinishCopy(), WaveTrack::HandleXMLTag(), LinkConsistencyCheck(), and WaveTrack::LinkConsistencyCheck().

Here is the call graph for this function:

Here is the caller graph for this function:

SetName()

void Track::SetName

(

const wxString &

n

)

Definition at line 82 of file Track.cpp.

{
   if ( mName != n ) {
      mName = n;
      Notify();
   }
}

References mName, and Notify().

Referenced by Effect::AddedAnalysisTrack::AddedAnalysisTrack(), SetTrackStatusCommand::ApplyInner(), TimeTrack::CleanState(), FinishCopy(), HandleCommonXMLAttribute(), ImportMIDI(), TimeTrack::Init(), WaveTrack::Init(), LabelTrack::LabelTrack(), Effect::ModifiedAnalysisTrack::ModifiedAnalysisTrack(), NoteTrack::NoteTrack(), and WaveTrack::WaveTrack().

Here is the call graph for this function:

Here is the caller graph for this function:

SetOffset()

virtual void Track::SetOffset ( double  o )

inlinevirtual

Reimplemented in TimeTrack, WaveTrack, and LabelTrack.

Definition at line 445 of file Track.h.

{ mOffset = o; }

Referenced by NoteTrack::Clear(), NoteTrack::HandleXMLTag(), ImportMIDI(), NoteTrack::Paste(), and NoteTrack::Trim().

Here is the caller graph for this function:

SetOwner()

void Track::SetOwner ( const std::weak_ptr< TrackList > &  list, TrackNodePointer  node  )

private

Update mNode when Track is added to TrackList, or removed from it.

Definition at line 135 of file Track.cpp.

{
   // BUG: When using this function to clear an owner, we may need to clear
   // focused track too.  Otherwise focus could remain on an invisible (or deleted) track.
   mList = list;
   mNode = node;
}

References mList, and mNode.

Referenced by TrackList::DoAdd(), TrackList::DoAddToHead(), TrackList::Permute(), TrackList::RegisterPendingChangedTrack(), TrackList::Remove(), TrackList::Replace(), and TrackList::SwapNodes().

Here is the caller graph for this function:

SetPan()

virtual void Track::SetPan ( float  )

inlinevirtual

Reimplemented in WaveTrack.

Definition at line 447 of file Track.h.

{ ;}

Referenced by SetTrackAudioCommand::ApplyInner().

Here is the caller graph for this function:

SetPanFromChannelType()

virtual void Track::SetPanFromChannelType ( )

inlinevirtual

Reimplemented in WaveTrack.

Definition at line 448 of file Track.h.

{ ;};

SetSelected()

void Track::SetSelected ( bool  s )

virtual

Reimplemented in LabelTrack.

Definition at line 90 of file Track.cpp.

{
   if (mSelected != s) {
      mSelected = s;
      auto pList = mList.lock();
      if (pList)
         pList->SelectionEvent( SharedPointer() );
   }
}

References mList, mSelected, and SharedPointer().

Referenced by SetTrackStatusCommand::ApplyInner(), anonymous_namespace{EditMenus.cpp}::DoPasteNothingSelected(), HandleCommonXMLAttribute(), LabelEditActions::Handler::OnPasteNewLabel(), and LabelTrack::SetSelected().

Here is the call graph for this function:

Here is the caller graph for this function:

SetTrackControls()

void Track::SetTrackControls

(

const std::shared_ptr< CommonTrackCell > &

pControls

)

Definition at line 159 of file Track.cpp.

{
   mpControls = pControls;
}

References mpControls.

Referenced by CommonTrackControls::TrackControls().

Here is the caller graph for this function:

SetTrackView()

void Track::SetTrackView

(

const std::shared_ptr< CommonTrackCell > &

pView

)

Definition at line 149 of file Track.cpp.

{
   mpView = pView;
}

References mpView.

Referenced by TrackView::Get().

Here is the caller graph for this function:

SharedPointer() [1/4]

template<typename Subclass = Track>

std::shared_ptr<Subclass> Track::SharedPointer ( )

inline

Definition at line 291 of file Track.h.

   {
      // shared_from_this is injected into class scope by base class
      // std::enable_shared_from_this<Track>
      return std::static_pointer_cast<Subclass>( shared_from_this() );
   }

Referenced by SelectHandle::AdjustSelection(), SelectionState::ChangeSelectionOnShiftClick(), CoarseTrackShifter::CoarseTrackShifter(), DEFINE_ATTACHED_VIRTUAL_OVERRIDE(), SpectrumView::DoDraw(), TimeShiftHandle::Drag(), EnsureVisible(), TrackPanelAx::GetFocus(), SelectHandle::HandleCenterFrequencyClick(), ClipMoveState::Init(), LabelTrackShifter::LabelTrackShifter(), SelectHandle::MoveSnappingFreqSelection(), NoteTrackShifter::NoteTrackShifter(), Notify(), TimeTrack::PasteInto(), EffectStereoToMono::ProcessOne(), SelectionState::SelectTrack(), TrackFocus::Set(), TrackPanelAx::SetFocus(), SetSelected(), SharedPointer(), anonymous_namespace{MIDIPlay.h}::MIDIPlay::StartOtherStream(), SubstituteOriginalTrack(), SubstitutePendingChangedTrack(), and WaveTrackShifter::WaveTrackShifter().

Here is the caller graph for this function:

SharedPointer() [2/4]

template<typename Subclass = const Track>

auto Track::SharedPointer ( ) const -> typename std::enable_if< std::is_const<Subclass>::value, std::shared_ptr<Subclass> >::type

inline

Definition at line 299 of file Track.h.

   {
      // shared_from_this is injected into class scope by base class
      // std::enable_shared_from_this<Track>
      return std::static_pointer_cast<Subclass>( shared_from_this() );
   }

SharedPointer() [3/4]

template<typename Subclass = const Track>

static std::shared_ptr<Subclass> Track::SharedPointer ( const Track *  pTrack )

inlinestatic

Definition at line 315 of file Track.h.

   { return pTrack ? pTrack->SharedPointer<Subclass>() : nullptr; }

References SharedPointer().

Here is the call graph for this function:

SharedPointer() [4/4]

template<typename Subclass = Track>

static std::shared_ptr<Subclass> Track::SharedPointer ( Track *  pTrack )

inlinestatic

Definition at line 311 of file Track.h.

   { return pTrack ? pTrack->SharedPointer<Subclass>() : nullptr; }

References SharedPointer().

Here is the call graph for this function:

Silence()

virtual void Track::Silence ( double   WXUNUSEDt0, double   WXUNUSEDt1  )

pure virtual

SubstituteOriginalTrack()

std::shared_ptr< const Track > Track::SubstituteOriginalTrack

(

)

const

Definition at line 1219 of file Track.cpp.

{
   auto pList = mList.lock();
   if (pList) {
      const auto id = GetId();
      const auto pred = [=]( const ListOfTracks::value_type &ptr ) {
         return ptr->GetId() == id; };
      const auto end = pList->mPendingUpdates.end();
      const auto it = std::find_if( pList->mPendingUpdates.begin(), end, pred );
      if (it != end) {
         const auto &list2 = (const ListOfTracks &) *pList;
         const auto end2 = list2.end();
         const auto it2 = std::find_if( list2.begin(), end2, pred );
         if ( it2 != end2 )
            return *it2;
      }
   }
   return SharedPointer();
}

References GetId(), id, mList, and SharedPointer().

Referenced by IsSyncLockSelected().

Here is the call graph for this function:

Here is the caller graph for this function:

SubstitutePendingChangedTrack() [1/2]

std::shared_ptr< Track > Track::SubstitutePendingChangedTrack

(

)

Definition at line 1198 of file Track.cpp.

{
   // Linear search.  Tracks in a project are usually very few.
   auto pList = mList.lock();
   if (pList) {
      const auto id = GetId();
      const auto end = pList->mPendingUpdates.end();
      auto it = std::find_if(
         pList->mPendingUpdates.begin(), end,
         [=](const ListOfTracks::value_type &ptr){ return ptr->GetId() == id; } );
      if (it != end)
         return *it;
   }
   return SharedPointer();
}

References GetId(), mList, and SharedPointer().

Referenced by TrackPanel::DrawTracks(), SubstitutePendingChangedTrack(), and ProjectFileIO::WriteXML().

Here is the call graph for this function:

Here is the caller graph for this function:

SubstitutePendingChangedTrack() [2/2]

std::shared_ptr< const Track > Track::SubstitutePendingChangedTrack

(

)

const

Definition at line 1214 of file Track.cpp.

{
   return const_cast<Track*>(this)->SubstitutePendingChangedTrack();
}

References SubstitutePendingChangedTrack().

Here is the call graph for this function:

SupportsBasicEditing()

bool Track::SupportsBasicEditing ( ) const

virtual

Whether this track type implements cut-copy-paste; by default, true.

Reimplemented in TimeTrack.

Definition at line 1239 of file Track.cpp.

{
   return true;
}

Referenced by SelectActions::Handler::OnCursorTrackEnd(), SelectActions::Handler::OnCursorTrackStart(), EditActions::Handler::OnCut(), SelectActions::Handler::OnSelectSyncLockSel(), and EditActions::Handler::OnSplitCut().

Here is the caller graph for this function:

SyncLockAdjust()

void Track::SyncLockAdjust ( double  oldT1, double  newT1  )

virtual

Reimplemented in WaveTrack, and LabelTrack.

Definition at line 293 of file Track.cpp.

{
   if (newT1 > oldT1) {
      // Insert space within the track
 
      if (oldT1 > GetEndTime())
         return;
 
      auto tmp = Cut(oldT1, GetEndTime());
 
      Paste(newT1, tmp.get());
   }
   else if (newT1 < oldT1) {
      // Remove from the track
      Clear(newT1, oldT1);
   }
}

References Clear(), Cut(), GetEndTime(), and Paste().

Referenced by EditActions::Handler::OnPaste().

Here is the call graph for this function:

Here is the caller graph for this function:

TypeSwitch() [1/2]

template<typename R = void, typename ... Functions>

R Track::TypeSwitch ( const Functions &...  functions )

inline

Use this function rather than testing track type explicitly and making down-casts.

A variadic function taking any number of function objects, each taking a pointer to Track or a subclass, maybe const-qualified, and maybe a second argument which is a fall-through continuation.

Each of the function objects (and supplied continuations) returns R (or a type convertible to R). Calls the first in the sequence that accepts the actual type of the track.

If no function accepts the track, do nothing and return R{} if R is not void.

If one of the functions invokes the call-through, then the next following applicable function is called.

Template Parameters

R	Return type of this function and each function argument
Functions	callable types deduced from arguments

Parameters

functions

typically lambdas, taking a pointer to a track subclass, and optionally a fall-through call-back

Definition at line 709 of file Track.h.

   {
      using WaveExecutor =
         Executor< R, WaveTrack,  Functions... >;
      using NoteExecutor =
         Executor< R, NoteTrack,  Functions... >;
      using LabelExecutor =
         Executor< R, LabelTrack, Functions... >;
      using TimeExecutor =
         Executor< R, TimeTrack,  Functions... >;
      using DefaultExecutor =
         Executor< R, Track >;
      enum { All = sizeof...( functions ) };
 
      static_assert(
         (1u << All) - 1u ==
            (WaveExecutor::SetUsed |
             NoteExecutor::SetUsed |
             LabelExecutor::SetUsed |
             TimeExecutor::SetUsed),
         "Uncallable case in Track::TypeSwitch"
      );
 
      switch (GetKind()) {
         case TrackKind::Wave:
            return WaveExecutor{} (this,  functions...);
#if defined(USE_MIDI)
         case TrackKind::Note:
            return NoteExecutor{} (this,  functions...);
#endif
         case TrackKind::Label:
            return LabelExecutor{}(this, functions...);
         case TrackKind::Time:
            return TimeExecutor{} (this,  functions...);
         default:
            return DefaultExecutor{} (this);
      }
   }

References All, Label, Note, Time, and Wave.

Referenced by SetClipCommand::ApplyInner(), SetEnvelopeCommand::ApplyInner(), WaveTrack::Merge(), LabelEditActions::Handler::OnCopyLabels(), LabelEditActions::Handler::OnCutLabels(), LabelEditActions::Handler::OnDisjoinLabels(), LabelEditActions::Handler::OnJoinLabels(), LabelEditActions::Handler::OnSilenceLabels(), LabelEditActions::Handler::OnSplitCutLabels(), LabelEditActions::Handler::OnSplitDeleteLabels(), LabelEditActions::Handler::OnSplitLabels(), LabelTrack::Paste(), NoteTrack::Paste(), TimeTrack::Paste(), LabelTrack::PasteOver(), NyquistEffect::ProcessOne(), and StretchHandle::Stretch().

Here is the caller graph for this function:

TypeSwitch() [2/2]

template<typename R = void, typename ... Functions>

R Track::TypeSwitch ( const Functions &...  functions ) const

inline

Use this function rather than testing track type explicitly and making down-casts.

A variadic function taking any number of function objects, each taking a pointer to Track or a subclass, maybe const-qualified, and maybe a second argument which is a fall-through continuation.

Each of the function objects (and supplied continuations) returns R (or a type convertible to R). Calls the first in the sequence that accepts the actual type of the track.

If no function accepts the track, do nothing and return R{} if R is not void.

If one of the functions invokes the call-through, then the next following applicable function is called.

Template Parameters

R	Return type of this function and each function argument
Functions	callable types deduced from arguments

Parameters

functions

typically lambdas, taking a pointer to a track subclass, and optionally a fall-through call-back

This is the overload for const tracks, only taking callable arguments that accept first arguments that are pointers to const.

Definition at line 755 of file Track.h.

   {
      using WaveExecutor =
         Executor< R, const WaveTrack,  Functions... >;
      using NoteExecutor =
         Executor< R, const NoteTrack,  Functions... >;
      using LabelExecutor =
         Executor< R, const LabelTrack, Functions... >;
      using TimeExecutor =
         Executor< R, const TimeTrack,  Functions... >;
      using DefaultExecutor =
         Executor< R, const Track >;
      enum { All = sizeof...( functions ) };
 
      static_assert(
         (1u << All) - 1u ==
            (WaveExecutor::SetUsed |
             NoteExecutor::SetUsed |
             LabelExecutor::SetUsed |
             TimeExecutor::SetUsed),
         "Uncallable case in Track::TypeSwitch"
      );
 
      switch (GetKind()) {
         case TrackKind::Wave:
            return WaveExecutor{} (this,  functions...);
#if defined(USE_MIDI)
         case TrackKind::Note:
            return NoteExecutor{} (this,  functions...);
#endif
         case TrackKind::Label:
            return LabelExecutor{}(this, functions...);
         case TrackKind::Time:
            return TimeExecutor{} (this,  functions...);
         default:
            return DefaultExecutor{} (this);
      }
   }

References All, Label, Note, Time, and Wave.

WriteCommonXMLAttributes()

void Track::WriteCommonXMLAttributes	(	XMLWriter &	xmlFile,
		bool	includeNameAndSelected = true
	)		const

Definition at line 1255 of file Track.cpp.

{
   if (includeNameAndSelected) {
      xmlFile.WriteAttr(wxT("name"), GetName());
      xmlFile.WriteAttr(wxT("isSelected"), this->GetSelected());
   }
   if ( mpView )
      mpView->WriteXMLAttributes( xmlFile );
   if ( mpControls )
      mpControls->WriteXMLAttributes( xmlFile );
}

References GetName(), GetSelected(), mpControls, mpView, and XMLWriter::WriteAttr().

Referenced by LabelTrack::WriteXML(), TimeTrack::WriteXML(), and WaveTrack::WriteXML().

Here is the call graph for this function:

Here is the caller graph for this function:

WriteXML()

virtual void Track::WriteXML ( XMLWriter &  xmlFile ) const

pure virtual

Implemented in WaveTrack, TimeTrack, NoteTrack, and LabelTrack.

Friends And Related Function Documentation

track_cast [1/2]

template<typename T >

std::enable_if< std::is_pointer<T>::value && std::is_const< typename std::remove_pointer< T >::type >::value, T >::type track_cast ( const Track *  track )

friend

Encapsulate the checked down-casting of track pointers.

Eliminates possibility of error – and not quietly casting away const

Typical usage:

if (auto wt = track_cast<const WaveTrack*>(track)) { ... }

This overload for const pointers can cast only to other const pointer types.

Definition at line 909 of file Track.h.

{
   using BareType = typename std::remove_pointer< T >::type;
   if (track &&
       CompatibleTrackKinds( track_kind<BareType>(), track->GetKind() ))
      return reinterpret_cast<T>(track);
   else
      return nullptr;
}

track_cast [2/2]

template<typename T >

std::enable_if< std::is_pointer<T>::value, T >::type track_cast ( Track *  track )

friend

Encapsulate the checked down-casting of track pointers.

Eliminates possibility of error – and not quietly casting away const

Typical usage:

if (auto wt = track_cast<const WaveTrack*>(track)) { ... }

Definition at line 891 of file Track.h.

{
   using BareType = typename std::remove_pointer< T >::type;
   if (track &&
       CompatibleTrackKinds( track_kind<BareType>(), track->GetKind() ))
      return reinterpret_cast<T>(track);
   else
      return nullptr;
}

TrackList

friend class TrackList

friend

Definition at line 251 of file Track.h.

Member Data Documentation

mChannel

ChannelType Track::mChannel

protected

Definition at line 407 of file Track.h.

Referenced by WaveTrack::GetChannel(), WaveTrack::GetChannelIgnoringPan(), WaveTrack::HandleXMLTag(), Init(), WaveTrack::SetPanFromChannelType(), and Track().

mDefaultName

wxString Track::mDefaultName

protected

Definition at line 264 of file Track.h.

Referenced by Init().

mId

TrackId Track::mId

private

Identifies the track only in-session, not persistently.

Definition at line 254 of file Track.h.

Referenced by Init().

mIndex

int Track::mIndex

protected

0-based position of this track in its TrackList

Definition at line 262 of file Track.h.

Referenced by GetIndex(), SetIndex(), and Track().

mLinkType

LinkType Track::mLinkType { LinkType::None }

private

Definition at line 255 of file Track.h.

Referenced by GetLinkType(), HasLinkedTrack(), and Init().

mList

std::weak_ptr<TrackList> Track::mList

protected

Back pointer to owning TrackList

Definition at line 258 of file Track.h.

Referenced by AdjustPositions(), EnsureVisible(), GetLinkedTrack(), GetNode(), IsSyncLockSelected(), TrackList::MakeMultiChannelTrack(), Notify(), SetLinkType(), SetOwner(), SetSelected(), SubstituteOriginalTrack(), SubstitutePendingChangedTrack(), and TrackList::UnlinkChannels().

mName

wxString Track::mName

protected

Definition at line 263 of file Track.h.

Referenced by Init(), and SetName().

mNode

TrackNodePointer Track::mNode {}

protected

Holds iterator to self, so that TrackList::Find can be constant-time.

mNode's pointer to std::list might not be this TrackList, if it's a pending update track

Definition at line 261 of file Track.h.

Referenced by AdjustPositions(), GetLinkedTrack(), GetNode(), SetLinkType(), and SetOwner().

mOffset

double Track::mOffset

protected

Definition at line 408 of file Track.h.

Referenced by LabelTrack::GetOffset(), NoteTrack::GetOffset(), WaveTrack::NewestOrNewClip(), WaveTrack::RightmostOrNewClip(), WaveTrack::SetOffset(), and Track().

mpControls

std::shared_ptr<CommonTrackCell> Track::mpControls

protected

Definition at line 833 of file Track.h.

Referenced by GetTrackControls(), HandleCommonXMLAttribute(), TrackList::RegisterPendingChangedTrack(), SetTrackControls(), and WriteCommonXMLAttributes().

mpView

std::shared_ptr<CommonTrackCell> Track::mpView

protected

Definition at line 832 of file Track.h.

Referenced by Duplicate(), GetTrackView(), HandleCommonXMLAttribute(), TrackList::RegisterPendingChangedTrack(), SetTrackView(), and WriteCommonXMLAttributes().

mSelected

bool Track::mSelected

private

Definition at line 267 of file Track.h.

Referenced by Init(), Merge(), SetSelected(), and Track().

vrulerSize

wxSize Track::vrulerSize

mutable

Definition at line 354 of file Track.h.

Referenced by SpectrumVRulerControls::DoUpdateVRuler(), WaveformVRulerControls::DoUpdateVRuler(), and TrackPanel::UpdateTrackVRuler().

---

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

• Track.h
• Track.cpp