timebase.h

// SPDX-FileCopyrightText: © 2026 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
 
#pragma once
 
#include <optional>
 
#include <QObject>
#include <QPointer>
#include <QtQmlIntegration/qqmlintegration.h>
 
namespace zrythm::dsp
{

namespace timebase
{
 
Q_NAMESPACE

enum class Timebase : std::uint8_t
{
  Musical,
  Absolute,
};
Q_ENUM_NS (Timebase)
 

class TimebaseProvider : public QObject
{
  Q_OBJECT
  Q_PROPERTY (
    Timebase effectiveTimebase READ effectiveTimebase NOTIFY
      effectiveTimebaseChanged)
  QML_ELEMENT
  QML_UNCREATABLE ("")
 
public:
  explicit TimebaseProvider (QObject * parent = nullptr);

  void setSource (TimebaseProvider * source);

  void setOverride (Timebase t);
  void clearOverride ();
 
  [[nodiscard]] bool hasOverride () const { return override_.has_value (); }
  [[nodiscard]] std::optional<Timebase> overrideValue () const
  {
    return override_;
  }

  [[nodiscard]] Timebase effectiveTimebase () const;
 
  Q_SIGNAL void effectiveTimebaseChanged ();
  Q_SIGNAL void overrideChanged ();
 
private:
  static constexpr int kMaxChainDepth = 64;
 
  void recompute_and_emit_if_changed ();
 
  QPointer<TimebaseProvider> source_;
  std::optional<Timebase>    override_;
  Timebase                   cached_effective_ = Timebase::Musical;
};
 
} // namespace timebase

using Timebase = timebase::Timebase;
using TimebaseProvider = timebase::TimebaseProvider;
 
} // namespace zrythm::dsp
 
Q_DECLARE_METATYPE (zrythm::dsp::timebase::Timebase)