SampleTrack.h

Go to the documentation of this file.

/**********************************************************************
 
Audacity: A Digital Audio Editor
 
SampleTrack.h
@brief abstract Track sub-type that maps times to sample values
 
Paul Licameli split from WaveTrack.h
 
**********************************************************************/
 
#ifndef __AUDACITY_SAMPLE_TRACK__
#define __AUDACITY_SAMPLE_TRACK__
 
#include "AudioIOSequences.h"
#include "PlayableTrack.h"
#include "SampleCount.h"
#include "SampleFormat.h"
 
enum class sampleFormat : unsigned;
 
class SampleTrack;
 
class SAMPLE_TRACK_API SampleTrack /* not final */
   : public PlayableTrack
   , public PlayableSequence
{
public:
   SampleTrack();
   SampleTrack(const SampleTrack &other, ProtectedCreationArg&&);
   ~SampleTrack() override;
 
   // Fix the otherwise ambiguous lookup of these virtual function names
   using ChannelGroup::GetStartTime;
   using ChannelGroup::GetEndTime;
   using Track::IsLeader;
 
   const TypeInfo &GetTypeInfo() const override;
   static const TypeInfo &ClassTypeInfo();
 
   virtual sampleFormat GetSampleFormat() const = 0;
 
   using WideSampleSequence::GetFloats;
 
   bool GetFloats(float *buffer, sampleCount start, size_t len,
      fillFormat fill = FillFormat::fillZero, bool mayThrow = true,
      sampleCount * pNumWithinClips = nullptr) const
   {
      constexpr auto backwards = false;
      return GetFloats(
         0, 1, &buffer, start, len, backwards, fill, mayThrow, pNumWithinClips);
   }
};
 
ENUMERATE_TRACK_TYPE(SampleTrack)
 
class SAMPLE_TRACK_API WritableSampleTrack /* not final */
   : public SampleTrack
   , public virtual RecordableSequence
{
public:
   WritableSampleTrack();
   WritableSampleTrack(
      const WritableSampleTrack &other, ProtectedCreationArg&&);
   ~WritableSampleTrack() override;
 
   // Resolve lookup ambiguity
   using Track::IsLeader;
 
   // Needed to resolve ambiguity with WideSampleSequence::GetRate, when this
   // abstract interface is used directly.
   // Expect the concrete subclass to define a common override for them.
   using RecordableSequence::GetRate;
 
   const TypeInfo &GetTypeInfo() const override;
   static const TypeInfo &ClassTypeInfo();
};
 
ENUMERATE_TRACK_TYPE(WritableSampleTrack)
 
#endif