arranger_view.hpp

Go to the documentation of this file.

#pragma once

 
#include <pulp/timeline/model.hpp>
#include <pulp/timeline_editor/edit_intent.hpp>
#include <pulp/timeline_editor/track_edit_intent.hpp>
#include <pulp/view/hit_metrics.hpp>
#include <pulp/view/view.hpp>
 
#include <cstddef>
#include <functional>
#include <optional>
 
namespace pulp::timeline_view {


struct ArrangerLayout {
    timebase::TickPosition origin_tick{};
    double px_per_tick = 0.0;
    float track_height_px = 64.0f;
    float lane_left_px = 0.0f;
    float ruler_height_px = 24.0f;

    float x_for_tick(timebase::TickPosition tick) const noexcept;
    timebase::TickPosition tick_for_x(float x) const noexcept;
    float y_for_track_index(std::size_t index) const noexcept;
};

enum class ArrangerRefusal : std::uint8_t {
    NestedSequenceContent,
};

class ArrangerView : public view::View {
  public:
    using ClipFactory = std::function<std::optional<timeline::Clip>(timebase::TickPosition start)>;
    using TrackFactory = std::function<std::optional<timeline::Track>()>;
 
    ArrangerView();

    void set_project(const timeline::Project* project, timeline::ItemId sequence_id);
    void set_layout(const ArrangerLayout& layout);
    void set_host(timeline_editor::EditIntentHost* host);
    void set_track_edit_host(timeline_editor::TrackEditIntentHost* host);
    void set_track_arrangement_host(timeline_editor::TrackArrangementIntentHost* host);
    void set_hit_metrics(const view::HitMetrics& metrics);
    void set_clip_factory(ClipFactory factory);
    void set_track_factory(TrackFactory factory);
 
    const ArrangerLayout& layout() const noexcept { return layout_; }

    std::optional<view::Rect> clip_rect(timeline::ItemId track_id,
                                        timeline::ItemId clip_id) const;

    const std::vector<ArrangerRefusal>& refusals() const noexcept { return refusals_; }
    void clear_refusals() { refusals_.clear(); }

    bool gesture_open() const noexcept {
        return drag_.has_value() || header_drag_.has_value() || track_create_press_.has_value();
    }
 
    // ── View ─────────────────────────────────────────────────────────────
 
    void paint(canvas::Canvas& canvas) override;
    bool wants_mouse_input() const override { return true; }
    void on_mouse_down(view::Point position) override;
    void on_mouse_drag(view::Point position) override;
    void on_mouse_up(view::Point position) override;
    void on_mouse_cancel(view::Point position) override;
 
  private:
    struct Drag {
        timeline::ItemId track_id;
        timeline::ItemId clip_id;
        std::int64_t grab_offset_ticks = 0;
        timebase::TickDuration duration{};
        timeline::MusicalTimeRange believed{};
        bool opened = false;
    };

    struct HeaderDrag {
        timeline::ItemId track_id;
        float pointer_down_y = 0.0f;
        float grab_offset_y = 0.0f;
        bool moved = false;
        std::optional<timeline::ItemId> expected_before_track_id;
    };

    struct TrackCreatePress {
        view::Point pointer_down{};
        bool moved = false;
    };
 
    const timeline::Sequence* sequence() const;
    const timeline::Track* track_at(view::Point position, std::size_t& index_out) const;
    const timeline::Clip* clip_at(const timeline::Track& track, view::Point position) const;
 
    void emit_move(const Drag& drag, timeline::GesturePhase phase,
                   timeline::MusicalTimeRange replacement);
    void submit(const timeline_editor::EditIntent& intent);
    void submit(const timeline_editor::TrackEditIntent& intent);
    void submit(const timeline_editor::TrackCreateIntent& intent);
 
    const timeline::Project* project_ = nullptr;
    timeline::ItemId sequence_id_{};
    ArrangerLayout layout_{};
    timeline_editor::EditIntentHost* host_ = nullptr;
    timeline_editor::TrackEditIntentHost* track_edit_host_ = nullptr;
    timeline_editor::TrackArrangementIntentHost* track_arrangement_host_ = nullptr;
    view::HitMetrics metrics_ = view::HitMetrics::for_pointer(view::PointerType::mouse);
    ClipFactory clip_factory_;
    TrackFactory track_factory_;
    std::optional<Drag> drag_;
    std::optional<HeaderDrag> header_drag_;
    std::optional<TrackCreatePress> track_create_press_;
    std::vector<ArrangerRefusal> refusals_;
};

 
} // namespace pulp::timeline_view