Add drag-handle overlay to edit per-note playback start/duration offsets

src/engraving/api/v1/elements.h

@@ -1426,6 +1426,11 @@ class Note : public EngravingItem
     /// The tuning of this note, in cents.
     API_PROPERTY_T(qreal,  tuning,        TUNING)
 
+    /// The start time offset for playback, in ticks.
+    API_PROPERTY_T(int, playbackStartOffset, PLAYBACK_START_OFFSET)
+    /// The duration offset for playback, in ticks.
+    API_PROPERTY_T(int, playbackDurationOffset, PLAYBACK_DURATION_OFFSET)
+
     /// For notes on non-tab staves: the line this note is on.
     API_PROPERTY_T(int,    line,          LINE)
     /// For notes on non-tab staves: Whether this note is

src/engraving/dom/note.cpp

@@ -738,6 +738,8 @@ Note::Note(const Note& n, bool link)
     m_harmonic          = n.m_harmonic;
     m_hasParens         = n.m_hasParens;
     m_hideGeneratedParens = n.m_hideGeneratedParens;
+    m_playbackStartOffset = n.m_playbackStartOffset;
+    m_playbackDurationOffset = n.m_playbackDurationOffset;
 
     if (n.m_accidental) {
         add(new Accidental(*(n.m_accidental)));
@@ -3134,6 +3136,10 @@ PropertyValue Note::getProperty(Pid propertyId) const
         return fixed();
     case Pid::FIXED_LINE:
         return fixedLine();
+    case Pid::PLAYBACK_START_OFFSET:
+        return m_playbackStartOffset;
+    case Pid::PLAYBACK_DURATION_OFFSET:
+        return m_playbackDurationOffset;
     case Pid::HAS_PARENTHESES:
         return m_hasParens ? ParenthesesMode::BOTH : ParenthesesMode::NONE;
     case Pid::HIDE_GENERATED_PARENTHESES:
@@ -3242,6 +3248,12 @@ bool Note::setProperty(Pid propertyId, const PropertyValue& v)
     case Pid::FIXED_LINE:
         setFixedLine(v.toInt());
         break;
+    case Pid::PLAYBACK_START_OFFSET:
+        setPlaybackStartOffset(v.toInt());
+        break;
+    case Pid::PLAYBACK_DURATION_OFFSET:
+        setPlaybackDurationOffset(v.toInt());
+        break;
     case Pid::HAS_PARENTHESES:
         if (v.value<ParenthesesMode>() != ParenthesesMode::BOTH && v.value<ParenthesesMode>() != ParenthesesMode::NONE) {
             ASSERT_X("Notes cannot set left & right parens individually");
@@ -3308,6 +3320,10 @@ PropertyValue Note::propertyDefault(Pid propertyId) const
         return 0;
     case Pid::TPC2:
         return getProperty(Pid::TPC1);
+    case Pid::PLAYBACK_START_OFFSET:
+        return 0;
+    case Pid::PLAYBACK_DURATION_OFFSET:
+        return 0;
     case Pid::PITCH:
     case Pid::TPC1:
         return PropertyValue();

src/engraving/dom/note.h

@@ -434,6 +434,12 @@ class Note final : public EngravingItem
     bool isTrillCueNote() const { return m_isTrillCueNote; }
     void setIsTrillCueNote(bool v);
 
+    int playbackStartOffset() const { return m_playbackStartOffset; }
+    void setPlaybackStartOffset(int offset) { m_playbackStartOffset = offset; }
+
+    int playbackDurationOffset() const { return m_playbackDurationOffset; }
+    void setPlaybackDurationOffset(int offset) { m_playbackDurationOffset = offset; }
+
     SymId noteHead() const;
     bool isNoteName() const;
 
@@ -561,5 +567,8 @@ class Note final : public EngravingItem
 
     std::vector<LineAttachPoint> m_lineAttachPoints;
     TieJumpPointList m_jumpPoints { this };
+
+    int m_playbackStartOffset = 0;  // offset in ticks to add to chord's tick for playback start
+    int m_playbackDurationOffset = 0; // offset in ticks to add to chord's ticks for playback duration
 };
 } // namespace mu::engraving

src/engraving/dom/property.cpp

@@ -519,6 +519,9 @@ static constexpr PropertyMetaData propertyList[] = {
 
     { Pid::SHARED_PART_ENABLED,                 P_TYPE::BOOL,                      PropertyGroup::NONE,       false, "sharedPartEnabled",               QT_TRANSLATE_NOOP("engraving/propertyName", "shared part enabled") },
 
+    { Pid::PLAYBACK_START_OFFSET,               P_TYPE::INT,                       PropertyGroup::APPEARANCE, false, "playbackStartOffset",             QT_TRANSLATE_NOOP("engraving/propertyName", "playback start offset") },
+    { Pid::PLAYBACK_DURATION_OFFSET,            P_TYPE::INT,                       PropertyGroup::APPEARANCE, false, "playbackDurationOffset",          QT_TRANSLATE_NOOP("engraving/propertyName", "playback duration offset") },
+
     { Pid::END,                                 P_TYPE::INT,                       PropertyGroup::NONE,       false, "++end++",                         nullptr }
 };
 /* *INDENT-ON* */

src/engraving/dom/property.h

@@ -528,6 +528,9 @@ enum class Pid : short {
 
     SHARED_PART_ENABLED,
 
+    PLAYBACK_START_OFFSET,
+    PLAYBACK_DURATION_OFFSET,
+
     END
 };
 

src/engraving/playback/renderers/noterenderer.cpp

@@ -128,6 +128,26 @@ void NoteRenderer::render(const Note* note, const RenderingContext& ctx, mpe::Pl
         return;
     }
 
+    if (note->playbackStartOffset() != 0 || note->playbackDurationOffset() != 0) {
+        // playbackStartOffset()/playbackDurationOffset() are ticks relative to the note's own
+        // nominal position - apply them on top of ctx's nominal tick range rather than
+        // recomputing from the chord's own tick()/ticks(). The chord's tick()/ticks() are its
+        // notated position/duration, which for a grace note or a note inside a repeated section
+        // is NOT the same as when/how long it actually plays - ctx.nominalPositionStartTick/
+        // nominalPositionEndTick already reflect that (see GraceChordCtx::buildCtx), whereas
+        // chord->tick() would collapse a grace note's "before the beat" timing back to the
+        // principal note's tick.
+        const int nominalStartTick = ctx.nominalPositionStartTick;
+        const int nominalEndTick = ctx.nominalPositionEndTick + note->playbackDurationOffset();
+        const int effectiveStartTick = std::max(0, nominalStartTick + note->playbackStartOffset());
+        const int effectiveDurationTicks = std::max(1, nominalEndTick - effectiveStartTick);
+
+        auto effectiveTnD = timestampAndDurationFromStartAndDurationTicks(ctx.score, effectiveStartTick, effectiveDurationTicks,
+                                                                          ctx.positionTickOffset);
+        noteCtx.timestamp = effectiveTnD.timestamp;
+        noteCtx.duration = effectiveTnD.duration;
+    }
+
     const Tie* tieFor = note->tieFor();
     if (tieFor && tieFor->playSpanner()) {
         if (tieFor->isPartialTie()) {

src/engraving/rw/read500/tread.cpp

@@ -3470,6 +3470,8 @@ bool TRead::readProperties(Note* n, XmlReader& e, ReadContext& ctx)
     } else if (tag == "overrideBendVisibilityRules") {
         n->setOverrideBendVisibilityRules(e.readBool());
     } else if (TRead::readProperty(n, tag, e, ctx, Pid::HIDE_GENERATED_PARENTHESES)) {
+    } else if (TRead::readProperty(n, tag, e, ctx, Pid::PLAYBACK_START_OFFSET)) {
+    } else if (TRead::readProperty(n, tag, e, ctx, Pid::PLAYBACK_DURATION_OFFSET)) {
     } else if (readItemProperties(n, e, ctx)) {
     } else {
         return false;

src/engraving/rw/write/twrite.cpp

@@ -2506,7 +2506,8 @@ void TWrite::write(const Note* item, XmlWriter& xml, WriteContext& ctx)
     }
     for (Pid id : { Pid::PITCH, Pid::CENT_OFFSET, Pid::TPC1, Pid::TPC2, Pid::SMALL, Pid::MIRROR_HEAD, Pid::DOT_POSITION,
                     Pid::HEAD_SCHEME, Pid::HEAD_GROUP, Pid::USER_VELOCITY, Pid::PLAY, Pid::TUNING, Pid::FRET, Pid::STRING,
-                    Pid::GHOST, Pid::DEAD, Pid::HEAD_TYPE, Pid::FIXED, Pid::FIXED_LINE }) {
+                    Pid::GHOST, Pid::DEAD, Pid::HEAD_TYPE, Pid::FIXED, Pid::FIXED_LINE,
+                    Pid::PLAYBACK_START_OFFSET, Pid::PLAYBACK_DURATION_OFFSET }) {
         writeProperty(item, xml, id);
     }
 

src/engraving/tests/note_tests.cpp

@@ -149,6 +149,14 @@ TEST_F(Engraving_NoteTests, note)
     EXPECT_EQ(n->userVelocity(), 71);
     delete n;
 
+    // playback start/duration offset
+    note->setPlaybackStartOffset(120);
+    note->setPlaybackDurationOffset(-60);
+    n = toNote(ScoreRW::writeReadElement(note));
+    EXPECT_EQ(n->playbackStartOffset(), 120);
+    EXPECT_EQ(n->playbackDurationOffset(), -60);
+    delete n;
+
     // tuning
     note->setTuning(1.3);
     n = toNote(ScoreRW::writeReadElement(note));

src/notation/CMakeLists.txt

@@ -36,6 +36,7 @@ target_sources(notation PRIVATE
     inotationselectionfilter.h
     inotationselectionrange.h
     inotationautomation.h
+    inotationnoteoffsets.h
     inotationinteraction.h
     inotationstyle.h
     inotationundostack.h
@@ -83,6 +84,8 @@ target_sources(notation PRIVATE
     internal/notationcontextconfiguration.h
     internal/notationautomation.cpp
     internal/notationautomation.h
+    internal/notationnoteoffsets.cpp
+    internal/notationnoteoffsets.h
     internal/notationelements.cpp
     internal/notationelements.h
     internal/notationinteraction.cpp

src/notation/imasternotation.h

@@ -72,6 +72,7 @@ class IMasterNotation
     virtual void initNotationSoloMuteState(const INotationPtr notation) = 0;
 
     virtual INotationAutomationPtr automation() const = 0;
+    virtual INotationNoteOffsetsPtr noteOffsets() const = 0;
 };
 
 using IMasterNotationPtr = std::shared_ptr<IMasterNotation>;

src/notation/inotation_fwd.h

@@ -84,4 +84,7 @@ using INotationPlaybackPtr = std::shared_ptr<INotationPlayback>;
 
 class INotationAutomation;
 using INotationAutomationPtr = std::shared_ptr<INotationAutomation>;
+
+class INotationNoteOffsets;
+using INotationNoteOffsetsPtr = std::shared_ptr<INotationNoteOffsets>;
 }

src/notation/inotationnoteoffsets.h

@@ -0,0 +1,39 @@
+/*
+ * SPDX-License-Identifier: GPL-3.0-only
+ * MuseScore-Studio-CLA-applies
+ *
+ * MuseScore Studio
+ * Music Composition & Notation
+ *
+ * Copyright (C) 2026 MuseScore Limited
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 3 as
+ * published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+#pragma once
+
+#include "async/notification.h"
+
+namespace mu::notation {
+class INotationNoteOffsets
+{
+public:
+    virtual ~INotationNoteOffsets() = default;
+
+    virtual bool isEditModeEnabled() const = 0;
+    virtual void setEditModeEnabled(bool enabled) = 0;
+    virtual muse::async::Notification editModeEnabledChanged() const = 0;
+};
+
+using INotationNoteOffsetsPtr = std::shared_ptr<INotationNoteOffsets>;
+}

src/notation/internal/masternotation.cpp

@@ -51,6 +51,7 @@
 #include "excerptnotation.h"
 #include "masternotationparts.h"
 #include "notationautomation.h"
+#include "notationnoteoffsets.h"
 #include "types/scorecreateoptions.h"
 
 #ifdef MUE_BUILD_ENGRAVING_PLAYBACK
@@ -92,6 +93,7 @@ MasterNotation::MasterNotation(project::INotationProject* project, const muse::m
 #endif
 
     m_notationAutomation = std::make_shared<NotationAutomation>(undoStack());
+    m_notationNoteOffsets = std::make_shared<NotationNoteOffsets>();
 
     m_parts->partsChanged().onNotify(this, [this]() {
         notifyAboutNotationChanged();
@@ -766,6 +768,11 @@ INotationAutomationPtr MasterNotation::automation() const
     return m_notationAutomation;
 }
 
+INotationNoteOffsetsPtr MasterNotation::noteOffsets() const
+{
+    return m_notationNoteOffsets;
+}
+
 void MasterNotation::initNotationSoloMuteState(const INotationPtr notation)
 {
     IF_ASSERT_FAILED(notation) {

src/notation/internal/masternotation.h

@@ -74,6 +74,7 @@ class MasterNotation : public IMasterNotation, public Notation, public std::enab
     void initNotationSoloMuteState(const INotationPtr notation) override;
 
     INotationAutomationPtr automation() const override;
+    INotationNoteOffsetsPtr noteOffsets() const override;
 
 private:
     friend class project::NotationProject;
@@ -102,6 +103,7 @@ class MasterNotation : public IMasterNotation, public Notation, public std::enab
     muse::async::Notification m_excerptsChanged;
     INotationPlaybackPtr m_notationPlayback = nullptr;
     INotationAutomationPtr m_notationAutomation = nullptr;
+    INotationNoteOffsetsPtr m_notationNoteOffsets = nullptr;
     muse::async::Notification m_hasPartsChanged;
 
     mutable ExcerptNotationList m_potentialExcerpts;

src/notation/internal/notationnoteoffsets.cpp

@@ -0,0 +1,44 @@
+/*
+ * SPDX-License-Identifier: GPL-3.0-only
+ * MuseScore-Studio-CLA-applies
+ *
+ * MuseScore Studio
+ * Music Composition & Notation
+ *
+ * Copyright (C) 2026 MuseScore Limited
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 3 as
+ * published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+#include "notationnoteoffsets.h"
+
+using namespace mu::notation;
+
+bool NotationNoteOffsets::isEditModeEnabled() const
+{
+    return m_isEditModeEnabled;
+}
+
+void NotationNoteOffsets::setEditModeEnabled(bool enabled)
+{
+    if (m_isEditModeEnabled == enabled) {
+        return;
+    }
+    m_isEditModeEnabled = enabled;
+    m_editModeEnabledChanged.notify();
+}
+
+muse::async::Notification NotationNoteOffsets::editModeEnabledChanged() const
+{
+    return m_editModeEnabledChanged;
+}

src/notation/internal/notationnoteoffsets.h

@@ -0,0 +1,40 @@
+/*
+ * SPDX-License-Identifier: GPL-3.0-only
+ * MuseScore-Studio-CLA-applies
+ *
+ * MuseScore Studio
+ * Music Composition & Notation
+ *
+ * Copyright (C) 2026 MuseScore Limited
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 3 as
+ * published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+#pragma once
+
+#include "../inotationnoteoffsets.h"
+
+#include "async/notification.h"
+
+namespace mu::notation {
+class NotationNoteOffsets : public INotationNoteOffsets
+{
+public:
+    bool isEditModeEnabled() const override;
+    void setEditModeEnabled(bool enabled) override;
+    muse::async::Notification editModeEnabledChanged() const override;
+
+private:
+    bool m_isEditModeEnabled = false;
+    muse::async::Notification m_editModeEnabledChanged;
+};
+}

src/notationscene/inotationcommandscontroller.h

@@ -89,6 +89,9 @@ class INotationCommandsController : MODULE_CONTEXT_INTERFACE
     virtual bool isAutomationModeEnabled() const = 0;
     virtual muse::async::Notification automationModeEnabledChanged() const = 0;
 
+    virtual bool isNoteOffsetEditModeEnabled() const = 0;
+    virtual muse::async::Notification noteOffsetEditModeEnabledChanged() const = 0;
+
     virtual bool isDebuggingCommandEnabled(const muse::rcommand::Command& command) const = 0;
     virtual muse::async::Notification debuggingOptionsChanged() const = 0;
 };