Add RangeIndicatorSequence view for clips and synth pieces

Close #33

Author: CrSjimo

AGENTS.md

@@ -154,7 +154,7 @@ View-model bindings maintain explicit document-to-view and view-to-document maps
 
 Use a recursive checkout, CMake 3.19+, Qt 6.10-compatible development packages, Ninja, and a C++20 compiler. During vcpkg installation, expose the Qt CMake directory through `QT_DIR`/`Qt6_DIR` and retain those variables for overlay ports.
 
-Do not perform any build, test, run, or automatic formatting operations unless explicitly requested by the user.
+Do not perform any test, build, run, or automatic formatting operations unless explicitly requested by the user. Also do not include any of these operations in the plan unless explicitly requested by the user.
 
 ```sh
 git submodule update --init --recursive

src/libs/3rdparty/scopicflow

@@ -11,6 +11,8 @@
 
 #include <QAKQuick/quickactioncontext.h>
 
+#include <ScopicFlowCore/RangeIndicatorInteractionController.h>
+
 #include <coreplugin/ProjectWindowInterface.h>
 
 #include <synth/ProjectSynthesisContext.h>
@@ -27,10 +29,15 @@ namespace SynthVisualizer::Internal {
 
     SynthesisPieceTrackAddOn::~SynthesisPieceTrackAddOn() = default;
 
-    QAbstractItemModel *SynthesisPieceTrackAddOn::pieceModel() const {
+    SynthesisPieceModel *SynthesisPieceTrackAddOn::pieceModel() const {
         return m_pieceModel;
     }
 
+    sflow::RangeIndicatorInteractionController *
+        SynthesisPieceTrackAddOn::rangeIndicatorInteractionController() const {
+        return m_rangeIndicatorInteractionController;
+    }
+
     void SynthesisPieceTrackAddOn::initialize() {
         auto windowInterface = windowHandle()->cast<Core::ProjectWindowInterface>();
         if (!windowInterface) {
@@ -43,6 +50,8 @@ namespace SynthVisualizer::Internal {
             qCWarning(lcSynthesisPieceTrackAddOn) << "The project synthesis context is unavailable";
         }
         m_pieceModel = new SynthesisPieceModel(synthesisContext, this);
+        m_rangeIndicatorInteractionController =
+            new sflow::RangeIndicatorInteractionController(this);
 
         QQmlComponent component(
             Core::RuntimeInterface::qmlEngine(),

src/plugins/synthvisualizer/internal/addon/SynthesisPieceTrackAddOn.cpp

@@ -6,28 +6,33 @@
 
 #include <CoreApi/windowinterface.h>
 
-class QAbstractItemModel;
+namespace sflow {
+    class RangeIndicatorInteractionController;
+}
 
 namespace SynthVisualizer::Internal {
 
     class SynthesisPieceModel;
 
     class SynthesisPieceTrackAddOn : public Core::WindowInterfaceAddOn {
         Q_OBJECT
-        Q_PROPERTY(QAbstractItemModel *pieceModel READ pieceModel CONSTANT)
+        Q_PROPERTY(SynthesisPieceModel *pieceModel READ pieceModel CONSTANT)
+        Q_PROPERTY(sflow::RangeIndicatorInteractionController *rangeIndicatorInteractionController READ rangeIndicatorInteractionController CONSTANT)
 
     public:
         explicit SynthesisPieceTrackAddOn(QObject *parent = nullptr);
         ~SynthesisPieceTrackAddOn() override;
 
-        QAbstractItemModel *pieceModel() const;
+        SynthesisPieceModel *pieceModel() const;
+        sflow::RangeIndicatorInteractionController *rangeIndicatorInteractionController() const;
 
         void initialize() override;
         void extensionsInitialized() override;
         bool delayedInitialize() override;
 
     private:
         SynthesisPieceModel *m_pieceModel{};
+        sflow::RangeIndicatorInteractionController *m_rangeIndicatorInteractionController{};
     };
 
 }

src/plugins/synthvisualizer/internal/addon/SynthesisPieceTrackAddOn.h

@@ -7,8 +7,14 @@
 #include <utility>
 
 #include <QFileInfo>
+#include <QSet>
 #include <QVariant>
 
+#include <SVSCraftCore/SVSCraftNamespace.h>
+
+#include <ScopicFlowCore/RangeIndicatorViewModel.h>
+#include <ScopicFlowCore/RangeSequenceViewModel.h>
+
 #include <dspxmodelORM/SingingClip.h>
 
 #include <coreplugin/ProjectWindowInterface.h>
@@ -20,6 +26,8 @@ namespace SynthVisualizer::Internal {
 
     SynthesisPieceModel::SynthesisPieceModel(QObject *parent)
         : QAbstractListModel(parent) {
+        m_rangeIndicatorSequenceViewModel =
+            new sflow::RangeSequenceViewModel(this, "position", "length");
     }
 
     SynthesisPieceModel::SynthesisPieceModel(Synth::ProjectSynthesisContext *context, QObject *parent)
@@ -28,6 +36,7 @@ namespace SynthVisualizer::Internal {
     }
 
     SynthesisPieceModel::~SynthesisPieceModel() {
+        clearRangeIndicators();
         disconnectPieceSignals();
         disconnectClipSignals();
         disconnect(m_windowHandleConnection);
@@ -83,6 +92,10 @@ namespace SynthVisualizer::Internal {
         Q_EMIT singingClipChanged();
     }
 
+    sflow::RangeSequenceViewModel *SynthesisPieceModel::rangeIndicatorSequenceViewModel() const {
+        return m_rangeIndicatorSequenceViewModel;
+    }
+
     int SynthesisPieceModel::rowCount(const QModelIndex &parent) const {
         return parent.isValid() ? 0 : m_pieces.size();
     }
@@ -159,6 +172,26 @@ namespace SynthVisualizer::Internal {
         );
     }
 
+    QObject *SynthesisPieceModel::pieceForRangeIndicator(
+        sflow::RangeIndicatorViewModel *viewItem) const {
+        return m_pieceMap.value(viewItem);
+    }
+
+    bool SynthesisPieceModel::isPieceTaskActive(QObject *pieceObject) const {
+        auto piece = qobject_cast<Synth::SynthesisPiece *>(pieceObject);
+        return piece && (piece->state() == Synth::SynthesisPiece::Queued ||
+                         piece->state() == Synth::SynthesisPiece::Synthesizing);
+    }
+
+    QString SynthesisPieceModel::verifiedDiagnosticFilePath(QObject *pieceObject) const {
+        auto piece = qobject_cast<Synth::SynthesisPiece *>(pieceObject);
+        if (!piece) {
+            return {};
+        }
+        const auto path = piece->diagnosticFilePath();
+        return path.isEmpty() || !QFileInfo::exists(path) ? QString() : path;
+    }
+
     void SynthesisPieceModel::setSynthesisContext(Synth::ProjectSynthesisContext *context) {
         if (m_context == context) {
             return;
@@ -209,6 +242,8 @@ namespace SynthVisualizer::Internal {
         }
         endResetModel();
 
+        reconcileRangeIndicators();
+
         for (auto piecePointer : std::as_const(m_pieces)) {
             auto piece = piecePointer.data();
             if (!piece) {
@@ -227,6 +262,7 @@ namespace SynthVisualizer::Internal {
         if (!piece) {
             return;
         }
+        updateRangeIndicator(piece);
         for (int row = 0; row < m_pieces.size(); ++row) {
             if (m_pieces.at(row) != piece) {
                 continue;
@@ -249,6 +285,9 @@ namespace SynthVisualizer::Internal {
     }
 
     void SynthesisPieceModel::updateClipPosition() {
+        for (auto piece : m_rangeIndicatorViewItemMap.keys()) {
+            updateRangeIndicator(piece);
+        }
         if (m_pieces.isEmpty()) {
             return;
         }
@@ -257,6 +296,72 @@ namespace SynthVisualizer::Internal {
         });
     }
 
+    void SynthesisPieceModel::reconcileRangeIndicators() {
+        QSet<Synth::SynthesisPiece *> livePieces;
+        for (const auto piecePointer : std::as_const(m_pieces)) {
+            if (auto piece = piecePointer.data()) {
+                livePieces.insert(piece);
+            }
+        }
+
+        for (auto piece : m_rangeIndicatorViewItemMap.keys()) {
+            if (livePieces.contains(piece)) {
+                continue;
+            }
+            auto viewItem = m_rangeIndicatorViewItemMap.take(piece);
+            m_pieceMap.remove(viewItem);
+            m_rangeIndicatorSequenceViewModel->removeItem(viewItem);
+            viewItem->deleteLater();
+        }
+
+        for (auto piece : std::as_const(livePieces)) {
+            auto viewItem = m_rangeIndicatorViewItemMap.value(piece);
+            if (!viewItem) {
+                viewItem = new sflow::RangeIndicatorViewModel(this);
+                m_rangeIndicatorViewItemMap.insert(piece, viewItem);
+                m_pieceMap.insert(viewItem, piece);
+                updateRangeIndicator(piece);
+                m_rangeIndicatorSequenceViewModel->insertItem(viewItem);
+            } else {
+                updateRangeIndicator(piece);
+            }
+        }
+    }
+
+    void SynthesisPieceModel::updateRangeIndicator(Synth::SynthesisPiece *piece) {
+        auto viewItem = m_rangeIndicatorViewItemMap.value(piece);
+        if (!viewItem || !m_singingClip) {
+            return;
+        }
+        viewItem->setPosition(qRound(m_singingClip->start() + piece->position()));
+        viewItem->setLength(qRound(piece->length()));
+        viewItem->setContent(statusText(piece));
+        switch (piece->state()) {
+            case Synth::SynthesisPiece::Ready:
+                viewItem->setType(SVS::SVSCraft::CT_Accent);
+                break;
+            case Synth::SynthesisPiece::Failed:
+                viewItem->setType(SVS::SVSCraft::CT_Error);
+                break;
+            case Synth::SynthesisPiece::Idle:
+            case Synth::SynthesisPiece::Stale:
+            case Synth::SynthesisPiece::Queued:
+            case Synth::SynthesisPiece::Synthesizing:
+                viewItem->setType(SVS::SVSCraft::CT_Normal);
+                break;
+        }
+    }
+
+    void SynthesisPieceModel::clearRangeIndicators() {
+        const auto viewItems = m_pieceMap.keys();
+        for (auto viewItem : viewItems) {
+            m_rangeIndicatorSequenceViewModel->removeItem(viewItem);
+            delete viewItem;
+        }
+        m_rangeIndicatorViewItemMap.clear();
+        m_pieceMap.clear();
+    }
+
     QString SynthesisPieceModel::statusText(const Synth::SynthesisPiece *piece) const {
         switch (piece->state()) {
             case Synth::SynthesisPiece::Idle:

src/plugins/synthvisualizer/internal/model/SynthesisPieceModel.cpp

@@ -10,6 +10,7 @@
 #include <QMetaObject>
 #include <QPair>
 #include <QPointer>
+#include <QString>
 #include <qqmlintegration.h>
 
 namespace Core {
@@ -26,13 +27,19 @@ namespace Synth {
     enum class SynthesisTaskType;
 }
 
+namespace sflow {
+    class RangeIndicatorViewModel;
+    class RangeSequenceViewModel;
+}
+
 namespace SynthVisualizer::Internal {
 
     class SynthesisPieceModel : public QAbstractListModel {
         Q_OBJECT
         QML_ELEMENT
         Q_PROPERTY(Core::ProjectWindowInterface *windowHandle READ windowHandle WRITE setWindowHandle NOTIFY windowHandleChanged)
         Q_PROPERTY(dspx::SingingClip *singingClip READ singingClip WRITE setSingingClip NOTIFY singingClipChanged)
+        Q_PROPERTY(sflow::RangeSequenceViewModel *rangeIndicatorSequenceViewModel READ rangeIndicatorSequenceViewModel CONSTANT)
 
     public:
         enum Role {
@@ -58,12 +65,17 @@ namespace SynthVisualizer::Internal {
         dspx::SingingClip *singingClip() const;
         void setSingingClip(dspx::SingingClip *clip);
 
+        sflow::RangeSequenceViewModel *rangeIndicatorSequenceViewModel() const;
+
         int rowCount(const QModelIndex &parent = {}) const override;
         QVariant data(const QModelIndex &index, int role) const override;
         QHash<int, QByteArray> roleNames() const override;
 
         Q_INVOKABLE bool cancelPieceTask(QObject *piece);
         Q_INVOKABLE void resynthesizePiece(QObject *piece, int fromType, bool readCache, bool writeCache);
+        Q_INVOKABLE QObject *pieceForRangeIndicator(sflow::RangeIndicatorViewModel *viewItem) const;
+        Q_INVOKABLE bool isPieceTaskActive(QObject *piece) const;
+        Q_INVOKABLE QString verifiedDiagnosticFilePath(QObject *piece) const;
 
     Q_SIGNALS:
         void windowHandleChanged();
@@ -74,6 +86,9 @@ namespace SynthVisualizer::Internal {
         void rebuild();
         void updatePiece(Synth::SynthesisPiece *piece);
         void updateClipPosition();
+        void reconcileRangeIndicators();
+        void updateRangeIndicator(Synth::SynthesisPiece *piece);
+        void clearRangeIndicators();
         QString statusText(const Synth::SynthesisPiece *piece) const;
         QString taskTypeText(Synth::SynthesisTaskType type) const;
         QPair<double, double> absoluteRange(const Synth::SynthesisPiece *piece) const;
@@ -88,6 +103,9 @@ namespace SynthVisualizer::Internal {
         QList<QMetaObject::Connection> m_contextConnections;
         QList<QMetaObject::Connection> m_pieceConnections;
         QList<QMetaObject::Connection> m_clipConnections;
+        sflow::RangeSequenceViewModel *m_rangeIndicatorSequenceViewModel{};
+        QHash<Synth::SynthesisPiece *, sflow::RangeIndicatorViewModel *> m_rangeIndicatorViewItemMap;
+        QHash<sflow::RangeIndicatorViewModel *, Synth::SynthesisPiece *> m_pieceMap;
     };
 
 }