clip.hh

Go to the documentation of this file.

 // This Source Code Form is licensed MPL-2.0: http://mozilla.org/MPL/2.0
#pragma once
 
#include <ase/trkn-utils.hh>
#include <ase/project.hh>
#include <ase/eventlist.hh>
#include <ase/midievent.hh>
 
namespace Ase {
 
constexpr const uint MIDI_NOTE_ID_FIRST = 0x10000001;
constexpr const uint MIDI_NOTE_ID_LAST = 0xfffffffe;
 
class ClipImpl : public GadgetImpl, public virtual Clip {
  friend class TrackImpl;
public:
  struct CmpNoteTicks { int operator() (const ClipNote &a, const ClipNote &b) const; };
  using OrderedEventsV = OrderedEventList<ClipNote,CmpNoteTicks>;
private:
  SelectableWeakref<tracktion::Clip> clip_;
  class ClipStateListener;
  std::unique_ptr<ClipStateListener> state_listener_;
public:
  class Generator;
protected:
  explicit ClipImpl         (tracktion::Clip &clip);
  virtual ~ClipImpl         ();
  ssize_t  clip_index       () const;
  ClipNoteS all_notes   () const override;
  void      all_notes   (const ClipNoteS &notes) override;
  int64     end_tick    () const override;
  void      end_tick    (int64 etick) override;
public:
  using OrderedEventsP = OrderedEventsV::ConstP;
  OrderedEventsP tick_events    () const;
  ProjectImpl*   project        () const;
  int64          start_tick     () const override;
  int64          stop_tick      () const override;
  void           assign_range   (int64 starttick, int64 stoptick) override;
  ClipNoteS      list_all_notes () override;
  int32          change_batch   (const ClipNoteS &notes, const String &undogroup) override;
  bool           is_muted       () const override;
  void           set_muted      (bool muted) override;
  double         volume         () const override;
  void           volume         (double db) override;
  double         pan            () const override;
  void           pan            (double pan) override;
  void           update_telemetry ();
  void           remove_self     () override;
  TelemetryFieldS telemetry      () const override;
  static ClipImplP from_trkn    (tracktion::Clip&);
  ASE_DEFINE_MAKE_SHARED (ClipImpl);
};
 
class ClipImpl::Generator {
  using EventS = ClipImpl::OrderedEventsP;
  int64  last_ = I63MAX;
  int64  xtick_ = 0; // external tick (API)
  int64  itick_ = 0; // internal tick (clip position)
  int64  start_offset_ = 0;
  int64  loop_start_ = 0;
  int64  loop_end_ = I63MAX;
  EventS events_;
  bool   muted_ = false;
  friend class ClipImpl;
public:
  using Receiver = std::function<void (int64 tick, MidiEvent &event)>;
  explicit Generator  () = default;
  void  setup         (const ClipImpl &clip);
  void  jumpto        (int64 target_tick);
  int64 generate      (int64 target_tick, const Receiver &receiver);
  bool  muted         () const { return muted_; }
  void  muted         (bool b) { muted_ = b; }
  int64 start_offset  () const { return start_offset_; }
  int64 loop_start    () const { return loop_start_; }
  int64 loop_end      () const { return loop_end_; }
  int64 play_length   () const { return last_; }
  int64 play_position () const { return xtick_; }
  bool  done          () const { return play_position() >= play_length(); }
  int64 clip_position () const { return itick_; }
};
using ClipImplGeneratorS = std::vector<ClipImpl::Generator>;
 
 
// == Implementation Details ==
inline int
ClipImpl::CmpNoteTicks::operator() (const ClipNote &a, const ClipNote &b) const
{
  // tick is neccessary primary key for playback
  const int tcmp = Aux::compare_lesser (a.tick, b.tick);
  if (ASE_ISLIKELY (tcmp))
    return tcmp;
  const int kcmp = Aux::compare_lesser (a.key, b.key);
  if (ASE_ISLIKELY (kcmp))
    return kcmp;
  const int ccmp = Aux::compare_lesser (a.channel, b.channel);
  if (ASE_ISLIKELY (ccmp))
    return ccmp;
  // allow selected to "override" a previous unselected element
  const int scmp = Aux::compare_lesser (a.selected, b.selected);
  if (ASE_UNLIKELY (scmp))
    return scmp;
  return Aux::compare_lesser (a.id, b.id);
}
 
String stringify_clip_note (const ClipNote &n);
 
} // Ase