TimeTrack.h

Go to the documentation of this file.

/**********************************************************************
 
  Audacity: A Digital Audio Editor
 
  TimeTrack.h
 
  Dr William Bland
 
**********************************************************************/
 
#ifndef __AUDACITY_TIMETRACK__
#define __AUDACITY_TIMETRACK__
 
#include "Track.h"
 
#include <algorithm>
 
class wxRect;
class BoundedEnvelope;
struct TrackPanelDrawingContext;
 
class TIME_TRACK_API TimeTrack final
   : public UniqueChannelTrack<>
{
 
 public:
 
   static wxString GetDefaultName();
 
   // Construct and also build all attachments
   static TimeTrack *New(AudacityProject &project);
 
   TimeTrack();
   TimeTrack(const TimeTrack &orig, ProtectedCreationArg&&,
      double *pT0 = nullptr, double *pT1 = nullptr);
 
   virtual ~TimeTrack();
 
   const TypeInfo &GetTypeInfo() const override;
   static const TypeInfo &ClassTypeInfo();
 
   bool SupportsBasicEditing() const override;
 
   Track::Holder PasteInto(AudacityProject &project, TrackList &list)
      const override;
 
   TrackListHolder Cut(double t0, double t1) override;
   TrackListHolder Copy(double t0, double t1, bool forClipboard) const override;
   void Clear(double t0, double t1) override;
   void Paste(double t, const Track &src) override;
   void
   Silence(double t0, double t1, ProgressReporter reportProgress = {}) override;
   void InsertSilence(double t, double len) override;
 
   // TimeTrack parameters
 
   void MoveTo(double /* t */) override {}
 
   // XMLTagHandler callback methods for loading and saving
 
   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;
 
   // Lock and unlock the track: you must lock the track before
   // doing a copy and paste between projects.
 
   // bool Lock();
   // bool Unlock();
 
   // Access the track's speed envelope
 
   BoundedEnvelope *GetEnvelope() { return mEnvelope.get(); }
   const BoundedEnvelope *GetEnvelope() const { return mEnvelope.get(); }
 
   // Get/Set the speed-warping range, as percentage of original speed (e.g. 90%-110%)
 
   double GetRangeLower() const;
   double GetRangeUpper() const;
 
   void SetRangeLower(double lower);
   void SetRangeUpper(double upper);
 
   bool GetDisplayLog() const { return mDisplayLog; }
   void SetDisplayLog(bool displayLog) { mDisplayLog = displayLog; }
   bool GetInterpolateLog() const;
   void SetInterpolateLog(bool interpolateLog);
 
   void testMe();
 
   size_t NIntervals() const override;
 
private:
   std::shared_ptr<WideChannelGroupInterval> DoGetInterval(size_t iInterval)
      override;
 
   void CleanState();
 
   void DoOnProjectTempoChange(
      const std::optional<double>& oldTempo, double newTempo) override;
 
   std::unique_ptr<BoundedEnvelope> mEnvelope;
   bool             mDisplayLog;
   bool             mRescaleXMLValues; // needed for backward-compatibility with older project files
 
   void Init(const TimeTrack &orig);
 
   using Holder = std::unique_ptr<TimeTrack>;
 
private:
   TrackListHolder Clone() const override;
};
 
ENUMERATE_TRACK_TYPE(TimeTrack);
 
 
#endif // __AUDACITY_TIMETRACK__