content_time_warp.h

// SPDX-FileCopyrightText: © 2026 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#pragma once
 
#include <span>
#include <vector>
 
#include "dsp/position.h"
#include "dsp/tempo_map_qml_adapter.h"
#include "dsp/tick_types.h"
#include "utils/units.h"
 
#include <QObject>
#include <QtQmlIntegration/qqmlintegration.h>
 
namespace zrythm::dsp
{

class ContentTimeWarp : public QObject
{
  Q_OBJECT
  QML_ELEMENT
  QML_UNCREATABLE ("")
 
public:
  struct WarpPoint
  {
    ContentTick  content_ticks;
    TimelineTick timeline_delta_ticks;
  };
 
  ContentTimeWarp (
    const TempoMapWrapper   &tempo_map_wrapper,
    const TimelinePosition * clip_position,
    const ContentPosition *  clip_length,
    QObject *                parent = nullptr);
  ~ContentTimeWarp () override = default;
 
  std::span<const WarpPoint> warpPoints () const { return warp_points_; }

  TimelineTick contentToTimeline (ContentTick content) const;

  Q_INVOKABLE double contentToTimelineTicksRelative (double contentTicks) const;

  Q_INVOKABLE double
  timelineTicksRelativeToContent (double timelineTicksRelative) const;

  units::sample_t contentToTimelineSamples (ContentTick content) const;

  ContentTick timelineToContent (TimelineTick timeline) const;

  void configure_as_project (units::bpm_t source_bpm = units::bpm (0.0));
  void configure_as_source (units::bpm_t source_bpm);
  void configure_as_warped (
    units::bpm_t               source_bpm,
    std::span<const WarpPoint> user_markers);

  bool is_identity () const;
 
Q_SIGNALS:
  void mapChanged ();
 
private:
  void rebuild ();
  void connect_for_mode ();
  void disconnect_all ();
 
  // Source-mode exact conversions (bypass warp points for exact results
  // even beyond the current clip length). Both are pure functions of the
  // tempo map, clip_position_, and source BPM.
  //
  // @pre clip_position_ != nullptr — Source mode requires a known clip
  //      start position (asserted).
  TimelineTick source_content_to_timeline (ContentTick content) const;
  ContentTick  source_timeline_to_content (TimelineTick timeline) const;
 
  enum class Mode
  {
    Project,
    Source,
    Warped
  };
 
  const TempoMapWrapper   &tempo_map_wrapper_;
  const TimelinePosition * clip_position_;
  const ContentPosition *  clip_length_;
  units::bpm_t             source_bpm_ = units::bpm (0.0);
  Mode                     mode_ = Mode::Project;
  std::vector<WarpPoint>   user_markers_;
  std::vector<WarpPoint>   warp_points_;
 
  QMetaObject::Connection tempo_conn_;
  QMetaObject::Connection pos_conn_;
  QMetaObject::Connection len_conn_;
};

TimelineTick
warp_lookup (
  std::span<const ContentTimeWarp::WarpPoint> warp_points,
  ContentTick                                 content_ticks);

ContentTick
reverse_warp_lookup (
  std::span<const ContentTimeWarp::WarpPoint> warp_points,
  TimelineTick                                timeline_delta_ticks);
 
} // namespace zrythm::dsp