ClipInterface.h

Go to the documentation of this file.

/*  SPDX-License-Identifier: GPL-2.0-or-later */
/*!********************************************************************
 
  Audacity: A Digital Audio Editor
 
  ClipInterface.h
 
  Matthieu Hodgkinson
 
**********************************************************************/
#pragma once
 
#include "AudioSegmentSampleView.h"
#include "Observer.h"
#include "SampleCount.h"
#include "SampleFormat.h"
 
class STRETCHING_SEQUENCE_API ClipTimes
{
public:
   virtual ~ClipTimes();
 
   virtual sampleCount GetVisibleSampleCount() const = 0;
 
   virtual int GetRate() const = 0;
 
   virtual double GetPlayStartTime() const = 0;
 
   virtual double GetPlayEndTime() const = 0;
 
   virtual sampleCount TimeToSamples(double time) const = 0;
 
   virtual double GetStretchRatio() const = 0;
};
 
enum class PitchAndSpeedPreset
{
   Default,
   OptimizeForVoice,
};
 
class STRETCHING_SEQUENCE_API ClipInterface : public ClipTimes
{
public:
   ~ClipInterface() override;
 
   virtual AudioSegmentSampleView GetSampleView(
      size_t iChannel, sampleCount start, size_t length,
      bool mayThrow = true) const = 0;
 
   virtual size_t NChannels() const = 0;
 
   virtual int GetCentShift() const = 0;
 
   [[nodiscard]] virtual Observer::Subscription
   SubscribeToCentShiftChange(std::function<void(int)> cb) const = 0;
 
   virtual PitchAndSpeedPreset GetPitchAndSpeedPreset() const = 0;
 
   [[nodiscard]] virtual Observer::Subscription
   SubscribeToPitchAndSpeedPresetChange(
      std::function<void(PitchAndSpeedPreset)> cb) const = 0;
};
 
using ClipConstHolders = std::vector<std::shared_ptr<const ClipInterface>>;