TimeTrack.cpp

Go to the documentation of this file.

/**********************************************************************
 
  Audacity: A Digital Audio Editor
 
  TimeTrack.cpp
 
  Dr William Bland
 
*******************************************************************//*******************************************************************/
 
 
#include "TimeTrack.h"
 
#include <cfloat>
#include <wx/wxcrtvararg.h>
#include "Envelope.h"
#include "Mix.h"
#include "Project.h"
#include "ProjectRate.h"
 
 
//TODO-MB: are these sensible values?
#define TIMETRACK_MIN 0.01
#define TIMETRACK_MAX 10.0
 
static ProjectFileIORegistry::ObjectReaderEntry readerEntry{
   "timetrack",
   TimeTrack::New
};
 
wxString TimeTrack::GetDefaultName()
{
   return _("Time Track");
}
 
TimeTrack *TimeTrack::New( AudacityProject &project )
{
   auto &tracks = TrackList::Get( project );
   auto result = tracks.Add(std::make_shared<TimeTrack>());
   result->AttachedTrackObjects::BuildAll();
   return result;
}
 
TimeTrack::TimeTrack()
{
   CleanState();
}
 
void TimeTrack::CleanState()
{
   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());
}
 
void TimeTrack::DoOnProjectTempoChange(
   const std::optional<double>& oldTempo, double newTempo)
{
   assert(IsLeader());
   if (!oldTempo.has_value())
      return;
   const auto ratio = *oldTempo / newTempo;
   mEnvelope->RescaleTimesBy(ratio);
}
 
TimeTrack::TimeTrack(const TimeTrack &orig, ProtectedCreationArg &&a,
   double *pT0, double *pT1
)  : 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);
}
 
// Copy the track metadata but not the contents.
void TimeTrack::Init(const TimeTrack &orig)
{
   Track::Init(orig);
   SetName(orig.GetName());
   SetDisplayLog(orig.GetDisplayLog());
}
 
TimeTrack::~TimeTrack()
{
}
 
double TimeTrack::GetRangeLower() const
{
   return mEnvelope->GetRangeLower();
}
 
double TimeTrack::GetRangeUpper() const
{
   return mEnvelope->GetRangeUpper();
}
 
void TimeTrack::SetRangeLower(double lower)
{
   mEnvelope->SetRangeLower( lower );
}
 
void TimeTrack::SetRangeUpper(double upper)
{
   mEnvelope->SetRangeUpper( upper );
}
 
static const Track::TypeInfo &typeInfo()
{
   static const Track::TypeInfo info{
      { "time", "time", XO("Time Track") }, true, &Track::ClassTypeInfo() };
   return info;
}
 
auto TimeTrack::GetTypeInfo() const -> const TypeInfo &
{
   return typeInfo();
}
 
auto TimeTrack::ClassTypeInfo() -> const TypeInfo &
{
   return typeInfo();
}
 
bool TimeTrack::SupportsBasicEditing() const
{
   return false;
}
 
Track::Holder TimeTrack::PasteInto(AudacityProject &project, TrackList &list)
   const
{
   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;
}
 
TrackListHolder TimeTrack::Cut(double t0, double t1)
{
   assert(IsLeader());
   auto result = Copy(t0, t1, false);
   Clear(t0, t1);
   return result;
}
 
TrackListHolder TimeTrack::Copy(double t0, double t1, bool) const
{
   auto track =
      std::make_shared<TimeTrack>(*this, ProtectedCreationArg{}, &t0, &t1);
   track->Init(*this);
   return TrackList::Temporary(nullptr, track, nullptr);
}
 
namespace {
double GetRate(const Track &track) {
   if (auto pList = track.GetOwner()) {
      if (auto pProject = pList->GetOwner())
         return ProjectRate::Get(*pProject).GetRate();
   }
   return 44100.0;
}
}
 
void TimeTrack::Clear(double t0, double t1)
{
   assert(IsLeader());
   auto sampleTime = 1.0 / GetRate(*this);
   mEnvelope->CollapseRegion( t0, t1, sampleTime );
}
 
void TimeTrack::Paste(double t, const Track &src)
{
   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.
}
 
void TimeTrack::Silence(
   double WXUNUSED(t0), double WXUNUSED(t1), ProgressReporter)
{
   assert(IsLeader());
}
 
void TimeTrack::InsertSilence(double t, double len)
{
   assert(IsLeader());
   mEnvelope->InsertSpace(t, len);
}
 
TrackListHolder TimeTrack::Clone() const
{
   assert(IsLeader());
   auto result = std::make_shared<TimeTrack>(*this, ProtectedCreationArg{});
   result->Init(*this);
   return TrackList::Temporary(nullptr, result, nullptr);
}
 
bool TimeTrack::GetInterpolateLog() const
{
   return mEnvelope->GetExponential();
}
 
void TimeTrack::SetInterpolateLog(bool interpolateLog) {
   mEnvelope->SetExponential(interpolateLog);
}
 
bool TimeTrack::HandleXMLTag(const std::string_view& tag, const AttributesList &attrs)
{
   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;
}
 
void TimeTrack::HandleXMLEndTag(const std::string_view&  WXUNUSED(tag))
{
   if(mRescaleXMLValues)
   {
      mRescaleXMLValues = false;
      mEnvelope->RescaleValues(GetRangeLower(), GetRangeUpper());
      mEnvelope->SetRange(TIMETRACK_MIN, TIMETRACK_MAX);
   }
}
 
XMLTagHandler *TimeTrack::HandleXMLChild(const std::string_view& tag)
{
   if (tag == "envelope")
      return mEnvelope.get();
 
  return NULL;
}
 
void TimeTrack::WriteXML(XMLWriter &xmlFile) const
// may throw
{
   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"));
}
 
size_t TimeTrack::NIntervals() const
{
   return 0;
}
 
std::shared_ptr<WideChannelGroupInterval>
TimeTrack::DoGetInterval(size_t iInterval)
{
   return {};
}
 
void TimeTrack::testMe()
{
   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 );
     }*/
}
 
static Mixer::WarpOptions::DefaultWarp::Scope installer{
[](const AudacityProject *pProject) -> const BoundedEnvelope*
{
   if (pProject) {
      auto &list = TrackList::Get(*pProject);
      if (auto pTimeTrack = *list.Any<const TimeTrack>().begin())
         return pTimeTrack->GetEnvelope();
   }
   return nullptr;
} };