A kind of Track used to 'warp time'. More...

#include <TimeTrack.h>

Inheritance diagram for TimeTrack:

Collaboration diagram for TimeTrack:

Public Member Functions
	TimeTrack ()

	TimeTrack (const TimeTrack &orig, ProtectedCreationArg &&, double pT0=nullptr, double pT1=nullptr)
	Copy-Constructor - create a NEW TimeTrack:: which is an independent copy of the original. More...

virtual	~TimeTrack ()

const TypeInfo &	GetTypeInfo () const override

bool	SupportsBasicEditing () const override
	Whether this track type implements cut-copy-paste; by default, true. More...

Track::Holder	PasteInto (AudacityProject &project, TrackList &list) const override

TrackListHolder	Cut (double t0, double t1) override
	Create tracks and modify this track. More...

TrackListHolder	Copy (double t0, double t1, bool forClipboard) const override
	Create new tracks and don't modify this track. More...

void	Clear (double t0, double t1) override

void	Paste (double t, const Track &src) override
	Weak precondition allows overrides to replicate one channel into many. More...

void	Silence (double t0, double t1, ProgressReporter reportProgress={}) override

void	InsertSilence (double t, double len) override

void	MoveTo (double) override
	Change start time to given time point. More...

bool	HandleXMLTag (const std::string_view &tag, const AttributesList &attrs) override

void	HandleXMLEndTag (const std::string_view &tag) override

XMLTagHandler *	HandleXMLChild (const std::string_view &tag) override

void	WriteXML (XMLWriter &xmlFile) const override

BoundedEnvelope *	GetEnvelope ()

const BoundedEnvelope *	GetEnvelope () const

double	GetRangeLower () const

double	GetRangeUpper () const

void	SetRangeLower (double lower)

void	SetRangeUpper (double upper)

bool	GetDisplayLog () const

void	SetDisplayLog (bool displayLog)

bool	GetInterpolateLog () const

void	SetInterpolateLog (bool interpolateLog)

void	testMe ()

size_t	NIntervals () const override
	Report the number of intervals. More...

Public Member Functions inherited from UniqueChannelTrack< Base >
size_t	NChannels () const override
	Report the number of channels. More...

std::shared_ptr< Channel >	DoGetChannel (size_t iChannel) override
	Retrieve a channel. More...

Public Member Functions inherited from Track
TrackId	GetId () const

template<typename Subclass = Track>
std::shared_ptr< Subclass >	SharedPointer ()

template<typename Subclass = const Track>
auto	SharedPointer () const -> std::enable_if_t< std::is_const_v< Subclass >, std::shared_ptr< Subclass > >

std::shared_ptr< Track >	SubstitutePendingChangedTrack ()

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

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

virtual const TypeInfo &	GetTypeInfo () const =0

virtual const TypeNames &	GetTypeNames () const

virtual bool	SupportsBasicEditing () const
	Whether this track type implements cut-copy-paste; by default, true. More...

virtual Holder	PasteInto (AudacityProject &project, TrackList &list) const =0

virtual bool	LinkConsistencyFix (bool doFix=true)
	Check consistency of channel groups, and maybe fix it. More...

bool	LinkConsistencyCheck ()
	Do the non-mutating part of consistency fix only and return status. More...

bool	HasOwner () const

std::shared_ptr< TrackList >	GetOwner () const

TrackList *	GetHolder () const

LinkType	GetLinkType () const noexcept

ChannelGroupData &	GetGroupData ()

const ChannelGroupData &	GetGroupData () const
	May make group data on demand, but consider that logically const. More...

	Track ()

	Track (const Track &orig, ProtectedCreationArg &&)

Track &	operator= (const Track &orig)=delete

virtual	~Track ()

void	Init (const Track &orig)

virtual TrackListHolder	Duplicate () const
	public nonvirtual duplication function that invokes Clone() More...

const wxString &	GetName () const
	Name is always the same for all channels of a group. More...

void	SetName (const wxString &n)

bool	GetSelected () const
	Selectedness is always the same for all channels of a group. More...

virtual void	SetSelected (bool s)

void	OnProjectTempoChange (double newTempo)
	method to set project tempo on track More...

virtual TrackListHolder	Cut (double t0, double t1)=0
	Create tracks and modify this track. More...

virtual TrackListHolder	Copy (double t0, double t1, bool forClipboard=true) const =0
	Create new tracks and don't modify this track. More...

virtual void	Clear (double t0, double t1)=0

virtual void	Paste (double t, const Track &src)=0
	Weak precondition allows overrides to replicate one channel into many. More...

void	Paste (double t, const TrackList &src)

virtual void	SyncLockAdjust (double oldT1, double newT1)

virtual void	Silence (double t0, double t1, ProgressReporter reportProgress={})=0

virtual void	InsertSilence (double t, double len)=0

bool	SameKindAs (const Track &track) const

template<typename R = void, typename ... Functions>
R	TypeSwitch (const Functions &...functions)

template<typename R = void, typename ... Functions>
R	TypeSwitch (const Functions &...functions) const

virtual void	WriteXML (XMLWriter &xmlFile) const =0

virtual std::optional< TranslatableString >	GetErrorOpening () const

void	Notify (bool allChannels, int code=-1)

bool	Any () const

bool	IsSelected () const

bool	IsLeader () const override

bool	IsSelectedLeader () const

void	AdjustPositions ()

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

bool	HandleCommonXMLAttribute (const std::string_view &attr, const XMLAttributeValueView &valueView)

const std::optional< double > &	GetProjectTempo () const

Public Member Functions inherited from XMLTagHandler
	XMLTagHandler ()

virtual	~XMLTagHandler ()

virtual bool	HandleXMLTag (const std::string_view &tag, const AttributesList &attrs)=0

virtual void	HandleXMLEndTag (const std::string_view &WXUNUSED(tag))

virtual void	HandleXMLContent (const std::string_view &WXUNUSED(content))

virtual XMLTagHandler *	HandleXMLChild (const std::string_view &tag)=0

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 -> std::enable_if_t< std::is_const< Subclass >::value, Subclass & >
	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 -> std::enable_if_t< std::is_const< Subclass >::value, Subclass * >
	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...

Public Member Functions inherited from ChannelGroup
virtual	~ChannelGroup ()

double	GetStartTime () const
	Get the minimum of Start() values of intervals, or 0 when none. More...

double	GetEndTime () const
	Get the maximum of End() values of intervals, or 0 when none. More...

void	ShiftBy (double t)
	Change start time by given duration. More...

virtual void	MoveTo (double o)=0
	Change start time to given time point. More...

virtual bool	IsLeader () const =0

ChannelGroupData &	GetGroupData ()
	Make attachment site on demand as needed. More...

const ChannelGroupData &	GetGroupData () const

ChannelGroupData *	FindGroupData ()
	Do not make attachment site on demand if absent. More...

const ChannelGroupData *	FindGroupData () const
	Do not make attachment site on demand if absent. More...

void	Init (const ChannelGroup &other)
	Copy, including cloning of attached objects. More...

void	DestroyGroupData ()
	Leave all attachments null. More...

std::unique_ptr< ChannelGroupData >	DetachGroupData ()
	Move attachments out. More...

void	AssignGroupData (std::unique_ptr< ChannelGroupData > pGroupData)
	Replace any previous attachments. More...

template<typename ChannelType = Channel>
std::shared_ptr< ChannelType >	GetChannel (size_t iChannel)
	Retrieve a channel, cast to the given type. More...

template<typename ChannelType = const Channel>
auto	GetChannel (size_t iChannel) const -> std::enable_if_t< std::is_const_v< ChannelType >, std::shared_ptr< ChannelType > >

template<typename ChannelType = Channel>
IteratorRange< ChannelIterator< ChannelType > >	Channels ()
	Get range of channels with mutative access. More...

template<typename ChannelType = const Channel>
auto	Channels () const -> std::enable_if_t< std::is_const_v< ChannelType >, IteratorRange< ChannelIterator< ChannelType > > >
	Get range of channels with read-only access. More...

template<typename IntervalType = Interval>
std::shared_ptr< IntervalType >	GetInterval (size_t iInterval)
	Retrieve an interval, cast to the given type. More...

template<typename IntervalType = const Interval>
auto	GetInterval (size_t iInterval) const -> std::enable_if_t< std::is_const_v< IntervalType >, std::shared_ptr< IntervalType > >

template<typename IntervalType = Interval>
IteratorRange< IntervalIterator< IntervalType > >	Intervals ()
	Get range of intervals with mutative access. More...

template<typename IntervalType = const Interval>
auto	Intervals () const -> std::enable_if_t< std::is_const_v< IntervalType >, IteratorRange< IntervalIterator< IntervalType > > >
	Get range of intervals with read-only access. More...

Public Member Functions inherited from Channel
virtual	~Channel ()

ChannelGroup &	GetChannelGroup ()
	Channel object's lifetime is assumed to be nested in its Track's. More...

const ChannelGroup &	GetChannelGroup () const
	Channel object's lifetime is assumed to be nested in its Track's. More...

size_t	GetChannelIndex () const

size_t	ReallyGetChannelIndex () const

size_t	NIntervals () const
	Report the number of intervals. More...

template<typename IntervalType = Interval>
std::shared_ptr< IntervalType >	GetInterval (size_t iInterval)
	Retrieve an interval, cast to the given type. More...

template<typename IntervalType = const Interval>
auto	GetInterval (size_t iInterval) const -> std::enable_if_t< std::is_const_v< IntervalType >, std::shared_ptr< IntervalType > >

template<typename IntervalType = Interval>
IteratorRange< IntervalIterator< IntervalType > >	Intervals ()
	Get range of intervals with mutative access. More...

template<typename IntervalType = const Interval>
auto	Intervals () const -> std::enable_if_t< std::is_const_v< IntervalType >, IteratorRange< IntervalIterator< IntervalType > > >
	Get range of intervals with read-only access. More...

Static Public Member Functions
static wxString	GetDefaultName ()

static TimeTrack *	New (AudacityProject &project)

static const TypeInfo &	ClassTypeInfo ()

Static Public Member Functions inherited from Track
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 const TypeInfo &	ClassTypeInfo ()

Static Public Member Functions inherited from ClientData::Site< Host, ClientData, ObjectCopyingPolicy, Pointer, ObjectLockingPolicy, RegistryLockingPolicy >
static size_t	numFactories ()
	How many static factories have been registered with this specialization of Site. More...

Private Types
using	Holder = std::unique_ptr< TimeTrack >

Private Member Functions
std::shared_ptr< WideChannelGroupInterval >	DoGetInterval (size_t iInterval) override
	Retrieve an interval. More...

void	CleanState ()

void	DoOnProjectTempoChange (const std::optional< double > &oldTempo, double newTempo) override

void	Init (const TimeTrack &orig)
	Copy the metadata from another track but not the points. More...

TrackListHolder	Clone () const override

Private Attributes
std::unique_ptr< BoundedEnvelope >	mEnvelope

bool	mDisplayLog

bool	mRescaleXMLValues

Additional Inherited Members
Public Types inherited from Track
using	AttachedObjects = ::AttachedTrackObjects
	Alias for my base type. More...

using	Holder = std::shared_ptr< Track >

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 Types inherited from ChannelGroup
enum class	LinkType : int { None = 0 , Group = 2 , Aligned }
	For two tracks describes the type of the linkage. More...

using	Attachments = ClientData::Site< ChannelGroupData, ClientData::Cloneable<>, ClientData::DeepCopying >

using	Interval = WideChannelGroupInterval

Public Types inherited from Channel
using	Interval = ChannelInterval

Protected Member Functions inherited from UniqueChannelTrack< Base >
ChannelGroup &	DoGetChannelGroup () const override
	Subclass must override. More...

Protected Member Functions inherited from Track
void	SetLinkType (LinkType linkType, bool completeList=true)

virtual void	DoOnProjectTempoChange (const std::optional< double > &oldTempo, double newTempo)=0

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...

virtual std::shared_ptr< Channel >	DoGetChannel (size_t iChannel)=0
	Retrieve a channel. More...

virtual std::shared_ptr< Interval >	DoGetInterval (size_t iInterval)=0
	Retrieve an interval. More...

Protected Member Functions inherited from Channel
virtual ChannelGroup &	DoGetChannelGroup () const =0
	Subclass must override. More...

virtual ChannelGroup &	ReallyDoGetChannelGroup () const
	This is temporary! It defaults to call the above. More...

Protected Attributes inherited from Track
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...

Detailed Description

A kind of Track used to 'warp time'.

Definition at line 22 of file TimeTrack.h.

Member Typedef Documentation

◆ Holder

using TimeTrack::Holder = std::unique_ptr<TimeTrack>

private

Definition at line 123 of file TimeTrack.h.

Constructor & Destructor Documentation

◆ TimeTrack() [1/2]

TimeTrack::TimeTrack ( )

Definition at line 49 of file TimeTrack.cpp.

{
   CleanState();
}

References CleanState().

Here is the call graph for this function:

◆ TimeTrack() [2/2]

TimeTrack::TimeTrack	(	const TimeTrack &	orig,
		ProtectedCreationArg &&	a,
		double *	pT0 = `nullptr`,
		double *	pT1 = `nullptr`
	)

Copy-Constructor - create a NEW TimeTrack:: which is an independent copy of the original.

Calls TimeTrack::Init() to copy the track metadata, then does a bunch of manipulations on the Envelope:: members in order to copy one to the other - unfortunately both lack a copy-constructor to encapsulate this.

Parameters

orig	The original track to copy from
pT0	if not null, then the start of the sub-range to copy
pT1	if not null, then the end of the sub-range to copy

Definition at line 79 of file TimeTrack.cpp.

   : UniqueChannelTrack{ orig, std::move(a) }
{
   Init(orig); // this copies the TimeTrack metadata (name, range, etc)
 
   auto len = DBL_MAX;
   if (pT0 && pT1) {
      len = *pT1 - *pT0;
      mEnvelope = std::make_unique<BoundedEnvelope>( *orig.mEnvelope, *pT0, *pT1 );
   }
   else
      mEnvelope = std::make_unique<BoundedEnvelope>( *orig.mEnvelope );
 
   SetRangeLower(orig.GetRangeLower());
   SetRangeUpper(orig.GetRangeUpper());
 
   mEnvelope->SetTrackLen( len );
   mEnvelope->SetOffset(0);
}

References GetRangeLower(), GetRangeUpper(), Init(), mEnvelope, SetRangeLower(), and SetRangeUpper().

Here is the call graph for this function:

◆ ~TimeTrack()

TimeTrack::~TimeTrack ( )

virtual

Definition at line 108 of file TimeTrack.cpp.

109{

110}

Member Function Documentation

◆ ClassTypeInfo()

auto TimeTrack::ClassTypeInfo ( )

static

Definition at line 144 of file TimeTrack.cpp.

{
   return typeInfo();
}

References typeInfo().

Here is the call graph for this function:

◆ CleanState()

void TimeTrack::CleanState ( )

private

Definition at line 54 of file TimeTrack.cpp.

{
   mEnvelope = std::make_unique<BoundedEnvelope>(true, TIMETRACK_MIN, TIMETRACK_MAX, 1.0);
 
   SetRangeLower( 0.2 );
   SetRangeUpper( 2.0 );
   mDisplayLog = false;
 
   mEnvelope->SetTrackLen(DBL_MAX);
   mEnvelope->SetOffset(0);
 
   //Time track is always unique
   SetName(GetDefaultName());
}

References GetDefaultName(), mDisplayLog, mEnvelope, Track::SetName(), SetRangeLower(), SetRangeUpper(), TIMETRACK_MAX, and TIMETRACK_MIN.

Referenced by TimeTrack().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Clear()

void TimeTrack::Clear	(	double	t0,
		double	t1
	)

overridevirtual

May assume precondition: t0 <= t1

Precondition: IsLeader()

Implements Track.

Definition at line 205 of file TimeTrack.cpp.

{
   assert(IsLeader());
   auto sampleTime = 1.0 / GetRate(*this);
   mEnvelope->CollapseRegion( t0, t1, sampleTime );
}

References anonymous_namespace{TimeTrack.cpp}::GetRate(), Track::IsLeader(), and mEnvelope.

Referenced by Cut().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Clone()

TrackListHolder TimeTrack::Clone ( ) const

overrideprivatevirtual

Subclass responsibility implements only a part of Duplicate(), copying the track data proper (not associated data such as for groups and views)

Parameters

unstretchInterval If set, this time interval's stretching must be applied.

Precondition: !unstretchInterval.has_value() || unstretchInterval->first < unstretchInterval->second; IsLeader()

Postcondition: result: NChannels() == result->NChannels()

Implements Track.

Definition at line 237 of file TimeTrack.cpp.

{
   assert(IsLeader());
   auto result = std::make_shared<TimeTrack>(*this, ProtectedCreationArg{});
   result->Init(*this);
   return TrackList::Temporary(nullptr, result, nullptr);
}

References Track::IsLeader(), and TrackList::Temporary().

Here is the call graph for this function:

◆ Copy()

TrackListHolder TimeTrack::Copy	(	double	t0,
		double	t1,
		bool	forClipboard
	)		const

overridevirtual

Create new tracks and don't modify this track.

Returns: non-NULL or else throw Note that subclasses may want to distinguish tracks stored in a clipboard from those stored in a project May assume precondition: t0 <= t1 Should invoke Track::Init

Precondition: IsLeader

Postcondition: result: result->NChannels() == NChannels()

Implements Track.

Definition at line 187 of file TimeTrack.cpp.

{
   auto track =
      std::make_shared<TimeTrack>(*this, ProtectedCreationArg{}, &t0, &t1);
   track->Init(*this);
   return TrackList::Temporary(nullptr, track, nullptr);
}

References TrackList::Temporary().

Referenced by Cut().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Cut()

TrackListHolder TimeTrack::Cut	(	double	t0,
		double	t1
	)

overridevirtual

Create tracks and modify this track.

Returns: non-NULL or else throw May assume precondition: t0 <= t1

Precondition: IsLeader()

Postcondition: result: result->NChannels() == NChannels()

Implements Track.

Definition at line 179 of file TimeTrack.cpp.

{
   assert(IsLeader());
   auto result = Copy(t0, t1, false);
   Clear(t0, t1);
   return result;
}

References Clear(), Copy(), and Track::IsLeader().

Here is the call graph for this function:

◆ DoGetInterval()

std::shared_ptr< WideChannelGroupInterval > TimeTrack::DoGetInterval ( size_t iInterval )

overrideprivatevirtual

Retrieve an interval.

Postcondition: result: !(iInterval < NIntervals()) || result

Implements ChannelGroup.

Definition at line 341 of file TimeTrack.cpp.

{
   return {};
}

◆ DoOnProjectTempoChange()

void TimeTrack::DoOnProjectTempoChange	(	const std::optional< double > &	oldTempo,
		double	newTempo
	)

overrideprivatevirtual

Precondition: IsLeader()

Implements Track.

Definition at line 69 of file TimeTrack.cpp.

{
   assert(IsLeader());
   if (!oldTempo.has_value())
      return;
   const auto ratio = *oldTempo / newTempo;
   mEnvelope->RescaleTimesBy(ratio);
}

References Track::IsLeader(), and mEnvelope.

Here is the call graph for this function:

◆ GetDefaultName()

wxString TimeTrack::GetDefaultName ( )

static

Definition at line 36 of file TimeTrack.cpp.

{
   return _("Time Track");
}

References _.

Referenced by CleanState().

Here is the caller graph for this function:

◆ GetDisplayLog()

bool TimeTrack::GetDisplayLog ( ) const

inline

Definition at line 94 of file TimeTrack.h.

94{ return mDisplayLog; }

Referenced by anonymous_namespace{TimeTrackView.cpp}::DrawHorzRulerAndCurve(), anonymous_namespace{TimeTrackView.cpp}::DrawTimeTrack(), anonymous_namespace{EnvelopeHandle.cpp}::GetTimeTrackData(), and Init().

Here is the caller graph for this function:

◆ GetEnvelope() [1/2]

BoundedEnvelope * TimeTrack::GetEnvelope ( )

inline

Definition at line 83 of file TimeTrack.h.

83{ return mEnvelope.get(); }

Referenced by anonymous_namespace{TimeTrackView.cpp}::DrawHorzRulerAndCurve(), anonymous_namespace{TimeTrackView.cpp}::DrawTimeTrack(), AUPImportFileHandle::HandleEnvelope(), and testMe().

Here is the caller graph for this function:

◆ GetEnvelope() [2/2]

const BoundedEnvelope * TimeTrack::GetEnvelope ( ) const

inline

Definition at line 84 of file TimeTrack.h.

84{ return mEnvelope.get(); }

◆ GetInterpolateLog()

bool TimeTrack::GetInterpolateLog ( ) const

Definition at line 245 of file TimeTrack.cpp.

{
   return mEnvelope->GetExponential();
}

References mEnvelope.

Referenced by TimeTrackMenuTable::OnTimeTrackLogInt().

Here is the caller graph for this function:

◆ GetRangeLower()

double TimeTrack::GetRangeLower ( ) const

Definition at line 112 of file TimeTrack.cpp.

{
   return mEnvelope->GetRangeLower();
}

References mEnvelope.

Referenced by anonymous_namespace{TimeTrackView.cpp}::DrawHorzRulerAndCurve(), anonymous_namespace{TimeTrackView.cpp}::DrawTimeTrack(), anonymous_namespace{EnvelopeHandle.cpp}::GetTimeTrackData(), HandleXMLEndTag(), HandleXMLTag(), TimeTrackMenuTable::OnSetTimeTrackRange(), PasteInto(), and TimeTrack().

Here is the caller graph for this function:

◆ GetRangeUpper()

double TimeTrack::GetRangeUpper ( ) const

Definition at line 117 of file TimeTrack.cpp.

{
   return mEnvelope->GetRangeUpper();
}

References mEnvelope.

Referenced by anonymous_namespace{TimeTrackView.cpp}::DrawHorzRulerAndCurve(), anonymous_namespace{TimeTrackView.cpp}::DrawTimeTrack(), anonymous_namespace{EnvelopeHandle.cpp}::GetTimeTrackData(), HandleXMLEndTag(), HandleXMLTag(), TimeTrackMenuTable::OnSetTimeTrackRange(), PasteInto(), and TimeTrack().

Here is the caller graph for this function:

◆ GetTypeInfo()

auto TimeTrack::GetTypeInfo ( ) const

overridevirtual

Implements Track.

Definition at line 139 of file TimeTrack.cpp.

{
   return typeInfo();
}

References typeInfo().

Here is the call graph for this function:

◆ HandleXMLChild()

XMLTagHandler * TimeTrack::HandleXMLChild ( const std::string_view & tag )

overridevirtual

Implements XMLTagHandler.

Definition at line 308 of file TimeTrack.cpp.

{
   if (tag == "envelope")
      return mEnvelope.get();
 
  return NULL;
}

References mEnvelope.

◆ HandleXMLEndTag()

void TimeTrack::HandleXMLEndTag ( const std::string_view & tag )

override

Definition at line 298 of file TimeTrack.cpp.

{
   if(mRescaleXMLValues)
   {
      mRescaleXMLValues = false;
      mEnvelope->RescaleValues(GetRangeLower(), GetRangeUpper());
      mEnvelope->SetRange(TIMETRACK_MIN, TIMETRACK_MAX);
   }
}

References GetRangeLower(), GetRangeUpper(), mEnvelope, mRescaleXMLValues, TIMETRACK_MAX, and TIMETRACK_MIN.

Here is the call graph for this function:

◆ HandleXMLTag()

bool TimeTrack::HandleXMLTag	(	const std::string_view &	tag,
		const AttributesList &	attrs
	)

overridevirtual

Implements XMLTagHandler.

Definition at line 254 of file TimeTrack.cpp.

{
   if (tag == "timetrack") {
      mRescaleXMLValues = true; // will be set to false if upper/lower is found
 
      long nValue;
 
      for (auto pair : attrs)
      {
         auto attr = pair.first;
         auto value = pair.second;
 
         if (this->Track::HandleCommonXMLAttribute(attr, value))
            ;
         else if (attr == "rangelower")
         {
            SetRangeLower( value.Get(GetRangeLower()) );
            mRescaleXMLValues = false;
         }
         else if (attr == "rangeupper")
         {
            SetRangeUpper( value.Get(GetRangeUpper()) );
            mRescaleXMLValues = false;
         }
         else if (attr == "displaylog" && value.TryGet(nValue))
         {
            SetDisplayLog(nValue != 0);
            //TODO-MB: This causes a graphical glitch, TrackPanel should probably be Refresh()ed after loading.
            //         I don't know where to do this though.
         }
         else if (attr == "interpolatelog" && value.TryGet(nValue))
         {
            SetInterpolateLog(nValue != 0);
         }
 
      } // while
      if(mRescaleXMLValues)
         mEnvelope->SetRange(0.0, 1.0); // this will be restored to the actual range later
      return true;
   }
 
   return false;
}

References GetRangeLower(), GetRangeUpper(), Track::HandleCommonXMLAttribute(), mEnvelope, mRescaleXMLValues, SetDisplayLog(), SetInterpolateLog(), SetRangeLower(), and SetRangeUpper().

Here is the call graph for this function:

◆ Init()

void TimeTrack::Init ( const TimeTrack & orig )

private

Copy the metadata from another track but not the points.

Copies the Name, DefaultName, Range and Display data from the source track

Parameters

orig	the TimeTrack to copy from

Definition at line 101 of file TimeTrack.cpp.

{
   Track::Init(orig);
   SetName(orig.GetName());
   SetDisplayLog(orig.GetDisplayLog());
}

References GetDisplayLog(), Track::GetName(), Track::Init(), SetDisplayLog(), and Track::SetName().

Referenced by TimeTrack().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ InsertSilence()

void TimeTrack::InsertSilence	(	double	t,
		double	len
	)

overridevirtual

May assume precondition: t0 <= t1

Precondition: IsLeader()

Implements Track.

Definition at line 231 of file TimeTrack.cpp.

{
   assert(IsLeader());
   mEnvelope->InsertSpace(t, len);
}

References Track::IsLeader(), and mEnvelope.

Here is the call graph for this function:

◆ MoveTo()

void TimeTrack::MoveTo ( double o )

inlineoverridevirtual

Change start time to given time point.

Implements ChannelGroup.

Definition at line 66 of file TimeTrack.h.

66{}

◆ New()

TimeTrack * TimeTrack::New ( AudacityProject & project )

static

Definition at line 41 of file TimeTrack.cpp.

{
   auto &tracks = TrackList::Get( project );
   auto result = tracks.Add(std::make_shared<TimeTrack>());
   result->AttachedTrackObjects::BuildAll();
   return result;
}

References TrackList::Get(), project, and tracks.

Here is the call graph for this function:

◆ NIntervals()

size_t TimeTrack::NIntervals ( ) const

overridevirtual

Report the number of intervals.

Implements ChannelGroup.

Definition at line 335 of file TimeTrack.cpp.

{
   return 0;
}

◆ Paste()

void TimeTrack::Paste	(	double	t,
		const Track &	src
	)

overridevirtual

Weak precondition allows overrides to replicate one channel into many.

Precondition: IsLeader(); SameKindAs(src); src.NChannels() == 1 || src.NChannels() == NChannels()

Implements Track.

Definition at line 212 of file TimeTrack.cpp.

{
   bool bOk = src.TypeSwitch<bool>([&](const TimeTrack &tt) {
      auto sampleTime = 1.0 / GetRate(*this);
      mEnvelope->PasteEnvelope(t, tt.mEnvelope.get(), sampleTime);
      return true;
   });
 
   if (!bOk)
      // THROW_INCONSISTENCY_EXCEPTION // ?
      (void)0;// intentionally do nothing.
}

References anonymous_namespace{TimeTrack.cpp}::GetRate(), mEnvelope, and Track::TypeSwitch().

Here is the call graph for this function:

◆ PasteInto()

Track::Holder TimeTrack::PasteInto	(	AudacityProject &	project,
		TrackList &	list
	)		const

overridevirtual

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

Precondition: IsLeader()

Parameters

list	to which any newly created tracks are added; but left unchanged if an existing track is found in the project instead

Returns: A smart pointer to a leader track

Implements Track.

Definition at line 154 of file TimeTrack.cpp.

{
   assert(IsLeader());
   // Maintain uniqueness of the time track!
   std::shared_ptr<TimeTrack> pNewTrack;
   if (auto pTrack = *TrackList::Get(project).Any<TimeTrack>().begin())
      // leave list unchanged
      pNewTrack = pTrack->SharedPointer<TimeTrack>();
   else {
      pNewTrack = std::make_shared<TimeTrack>();
      list.Add(pNewTrack);
   }
 
   // Should come here only for .aup3 import, not for paste (because the
   // track is skipped in cut/copy commands)
   // And for import we agree to replace the track contents completely
   pNewTrack->CleanState();
   pNewTrack->Init(*this);
   pNewTrack->Paste(0.0, *this);
   pNewTrack->SetRangeLower(this->GetRangeLower());
   pNewTrack->SetRangeUpper(this->GetRangeUpper());
   return pNewTrack;
}

References TrackList::Add(), PackedArray::begin(), TrackList::Get(), GetRangeLower(), GetRangeUpper(), Track::IsLeader(), and project.

Here is the call graph for this function:

◆ SetDisplayLog()

void TimeTrack::SetDisplayLog ( bool displayLog )

inline

Definition at line 95 of file TimeTrack.h.

95{ mDisplayLog = displayLog; }

Referenced by HandleXMLTag(), Init(), TimeTrackMenuTable::OnTimeTrackLin(), and TimeTrackMenuTable::OnTimeTrackLog().

Here is the caller graph for this function:

◆ SetInterpolateLog()

void TimeTrack::SetInterpolateLog ( bool interpolateLog )

Definition at line 250 of file TimeTrack.cpp.

                                                     {
   mEnvelope->SetExponential(interpolateLog);
}

References mEnvelope.

Referenced by HandleXMLTag(), and TimeTrackMenuTable::OnTimeTrackLogInt().

Here is the caller graph for this function:

◆ SetRangeLower()

void TimeTrack::SetRangeLower ( double lower )

Definition at line 122 of file TimeTrack.cpp.

{
   mEnvelope->SetRangeLower( lower );
}

References mEnvelope.

Referenced by CleanState(), HandleXMLTag(), TimeTrackMenuTable::OnSetTimeTrackRange(), and TimeTrack().

Here is the caller graph for this function:

◆ SetRangeUpper()

void TimeTrack::SetRangeUpper ( double upper )

Definition at line 127 of file TimeTrack.cpp.

{
   mEnvelope->SetRangeUpper( upper );
}

References mEnvelope.

Referenced by CleanState(), HandleXMLTag(), TimeTrackMenuTable::OnSetTimeTrackRange(), and TimeTrack().

Here is the caller graph for this function:

◆ Silence()

void TimeTrack::Silence	(	double	t0,
		double	t1,
		ProgressReporter	reportProgress = `{}`
	)

overridevirtual

Precondition: IsLeader()

Implements Track.

Definition at line 225 of file TimeTrack.cpp.

{
   assert(IsLeader());
}

References Track::IsLeader().

Here is the call graph for this function:

◆ SupportsBasicEditing()

bool TimeTrack::SupportsBasicEditing ( ) const

overridevirtual

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

Reimplemented from Track.

Definition at line 149 of file TimeTrack.cpp.

{
   return false;
}

◆ testMe()

void TimeTrack::testMe ( )

Definition at line 346 of file TimeTrack.cpp.

{
   GetEnvelope()->Flatten(0.0);
   GetEnvelope()->InsertOrReplace(0.0, 0.2);
   GetEnvelope()->InsertOrReplace(5.0 - 0.001, 0.2);
   GetEnvelope()->InsertOrReplace(5.0 + 0.001, 1.3);
   GetEnvelope()->InsertOrReplace(10.0, 1.3);
 
   double value1 = GetEnvelope()->Integral(2.0, 13.0);
   double expected1 = (5.0 - 2.0) * 0.2 + (13.0 - 5.0) * 1.3;
   double value2 = GetEnvelope()->IntegralOfInverse(2.0, 13.0);
   double expected2 = (5.0 - 2.0) / 0.2 + (13.0 - 5.0) / 1.3;
   if( fabs(value1 - expected1) > 0.01 )
     {
       wxPrintf( "TimeTrack:  Integral failed! expected %f got %f\n", expected1, value1);
     }
   if( fabs(value2 - expected2) > 0.01 )
     {
       wxPrintf( "TimeTrack:  IntegralOfInverse failed! expected %f got %f\n", expected2, value2);
     }
 
   /*double reqt0 = 10.0 - .1;
   double reqt1 = 10.0 + .1;
   double t0 = warp( reqt0 );
   double t1 = warp( reqt1 );
   if( t0 > t1 )
     {
       wxPrintf( "TimeTrack:  Warping reverses an interval! [%.2f,%.2f] -> [%.2f,%.2f]\n",
          reqt0, reqt1,
          t0, t1 );
     }*/
}

References Envelope::Flatten(), GetEnvelope(), Envelope::InsertOrReplace(), Envelope::Integral(), and Envelope::IntegralOfInverse().

Here is the call graph for this function:

◆ WriteXML()

void TimeTrack::WriteXML ( XMLWriter & xmlFile ) const

overridevirtual

Implements Track.

Definition at line 316 of file TimeTrack.cpp.

{
   assert(IsLeader());
   xmlFile.StartTag(wxT("timetrack"));
   this->Track::WriteCommonXMLAttributes( xmlFile );
 
   //xmlFile.WriteAttr(wxT("channel"), mChannel);
   //xmlFile.WriteAttr(wxT("offset"), mOffset, 8);
   xmlFile.WriteAttr(wxT("rangelower"), GetRangeLower(), 12);
   xmlFile.WriteAttr(wxT("rangeupper"), GetRangeUpper(), 12);
   xmlFile.WriteAttr(wxT("displaylog"), GetDisplayLog());
   xmlFile.WriteAttr(wxT("interpolatelog"), GetInterpolateLog());
 
   mEnvelope->WriteXML(xmlFile);
 
   xmlFile.EndTag(wxT("timetrack"));
}

References Track::WriteCommonXMLAttributes(), and wxT().

Here is the call graph for this function:

Member Data Documentation

◆ mDisplayLog

bool TimeTrack::mDisplayLog

private

Definition at line 113 of file TimeTrack.h.

Referenced by CleanState().

◆ mEnvelope

std::unique_ptr<BoundedEnvelope> TimeTrack::mEnvelope

private

Definition at line 112 of file TimeTrack.h.

Referenced by CleanState(), Clear(), DoOnProjectTempoChange(), GetInterpolateLog(), GetRangeLower(), GetRangeUpper(), HandleXMLChild(), HandleXMLEndTag(), HandleXMLTag(), InsertSilence(), Paste(), SetInterpolateLog(), SetRangeLower(), SetRangeUpper(), and TimeTrack().

◆ mRescaleXMLValues

bool TimeTrack::mRescaleXMLValues

private

Definition at line 114 of file TimeTrack.h.

Referenced by HandleXMLEndTag(), and HandleXMLTag().

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

Public Member Functions

Static Public Member Functions

Private Types

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Holder

Constructor & Destructor Documentation

◆ TimeTrack() [1/2]

◆ TimeTrack() [2/2]

◆ ~TimeTrack()

Member Function Documentation

◆ ClassTypeInfo()

◆ CleanState()

◆ Clear()

◆ Clone()

◆ Copy()

◆ Cut()

◆ DoGetInterval()

◆ DoOnProjectTempoChange()

◆ GetDefaultName()

◆ GetDisplayLog()

◆ GetEnvelope() [1/2]

◆ GetEnvelope() [2/2]

◆ GetInterpolateLog()

◆ GetRangeLower()

◆ GetRangeUpper()

◆ GetTypeInfo()

◆ HandleXMLChild()

◆ HandleXMLEndTag()

◆ HandleXMLTag()

◆ Init()

◆ InsertSilence()

◆ MoveTo()

◆ New()

◆ NIntervals()

◆ Paste()

◆ PasteInto()

◆ SetDisplayLog()

◆ SetInterpolateLog()

◆ SetRangeLower()

◆ SetRangeUpper()

◆ Silence()

◆ SupportsBasicEditing()

◆ testMe()

◆ WriteXML()

Member Data Documentation

◆ mDisplayLog

◆ mEnvelope

◆ mRescaleXMLValues