@coderline/alphatab 1.6.0-alpha.1428 → 1.6.0-alpha.1430

package/dist/alphaTab.core.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab v1.6.0-alpha.1428 (develop, build 1428)
+ * alphaTab v1.6.0-alpha.1430 (develop, build 1430)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -1411,12 +1411,6 @@ class SyncPointData {
          * Indicates for which repeat occurence this sync point is valid (e.g. 0 on the first time played, 1 on the second time played)
          */
         this.barOccurence = 0;
-        /**
-         * The modified tempo at which the cursor should move (aka. the tempo played within the external audio track).
-         * This information is used together with normal tempo changes to calculate how much faster/slower the
-         * cursor playback is performed to align with the audio track.
-         */
-        this.modifiedTempo = 0;
         /**
          * The audio offset marking the position within the audio track in milliseconds.
          * This information is used to regularly sync (or on seeking) to match a given external audio time axis with the internal time axis.
@@ -5843,7 +5837,6 @@ class SyncPointDataCloner {
     static clone(original) {
         const clone = new SyncPointData();
         clone.barOccurence = original.barOccurence;
-        clone.modifiedTempo = original.modifiedTempo;
         clone.millisecondOffset = original.millisecondOffset;
         return clone;
     }
@@ -7313,7 +7306,6 @@ class Score {
             automation.ratioPosition = Math.min(1, Math.max(0, syncPoint.barPosition));
             automation.type = AutomationType.SyncPoint;
             automation.syncPointValue = new SyncPointData();
-            automation.syncPointValue.modifiedTempo = syncPoint.modifiedTempo;
             automation.syncPointValue.millisecondOffset = syncPoint.millisecondOffset;
             automation.syncPointValue.barOccurence = syncPoint.barOccurence;
             if (syncPoint.barIndex < this.masterBars.length) {
@@ -7346,8 +7338,7 @@ class Score {
                         barIndex: masterBar.index,
                         barOccurence: syncPoint.syncPointValue.barOccurence,
                         barPosition: syncPoint.ratioPosition,
-                        millisecondOffset: syncPoint.syncPointValue.millisecondOffset,
-                        modifiedTempo: syncPoint.syncPointValue.modifiedTempo
+                        millisecondOffset: syncPoint.syncPointValue.millisecondOffset
                     });
                 }
             }
@@ -14714,9 +14705,6 @@ class GpifParser {
                                 case 'BarOccurrence':
                                     syncPointValue.barOccurence = GpifParser.parseIntSafe(vc.innerText, 0);
                                     break;
-                                case 'ModifiedTempo':
-                                    syncPointValue.modifiedTempo = GpifParser.parseFloatSafe(vc.innerText, 0);
-                                    break;
                                 case 'FrameOffset':
                                     const frameOffset = GpifParser.parseFloatSafe(vc.innerText, 0);
                                     syncPointValue.millisecondOffset = (frameOffset / GpifParser.SampleRate) * 1000;
@@ -22339,6 +22327,61 @@ class SynthEvent {
     }
 }
 
+/**
+ * Rerpresents a point to sync the alphaTab time axis with an external backing track.
+ */
+class BackingTrackSyncPoint {
+    constructor() {
+        /**
+         * The index of the masterbar to which this sync point belongs to.
+         * @remarks
+         * This property is purely informative for external use like in editors.
+         * It has no impact to the synchronization itself.
+         */
+        this.masterBarIndex = 0;
+        /**
+         * The occurence of the masterbar to which this sync point belongs to. The occurence
+         * is 0-based and increases with every repeated play of a masterbar (e.g. on repeats or jumps).
+         * @remarks
+         * This property is purely informative for external use like in editors.
+         * It has no impact to the synchronization itself.
+         */
+        this.masterBarOccurence = 0;
+        /**
+         * The BPM the synthesizer has at the exact tick position of this sync point.
+         */
+        this.synthBpm = 0;
+        /**
+         * The millisecond time position of the synthesizer when this sync point is reached.
+         */
+        this.synthTime = 0;
+        /**
+         * The midi tick position of the synthesizer when this sync point is reached.
+         */
+        this.synthTick = 0;
+        /**
+         * The millisecond time in the external media marking the synchronization point.
+         */
+        this.syncTime = 0;
+        /**
+         * The BPM the song will have virtually after this sync point to align the external media time axis
+         * with the one from the synthesizer.
+         */
+        this.syncBpm = 0;
+    }
+    /**
+     * Updates the synchronization BPM that will apply after this sync point.
+     * @param nextSyncPointSynthTime The synthesizer time of the next sync point after this one.
+     * @param nextSyncPointSyncTime The synchronization time of the next sync point after this one.
+     */
+    updateSyncBpm(nextSyncPointSynthTime, nextSyncPointSyncTime) {
+        const synthDuration = nextSyncPointSynthTime - this.synthTime;
+        const syncedDuration = nextSyncPointSyncTime - this.syncTime;
+        const modifiedTempo = (synthDuration / syncedDuration) * this.synthBpm;
+        this.syncBpm = modifiedTempo;
+    }
+}
+
 class MidiFileSequencerTempoChange {
     constructor(bpm, ticks, time) {
         this.bpm = bpm;
@@ -22346,14 +22389,6 @@ class MidiFileSequencerTempoChange {
         this.time = time;
     }
 }
-class BackingTrackSyncPointWithTime {
-    constructor(tick, time, modifiedTempo, millisecondOffset) {
-        this.alphaTabTick = tick;
-        this.alphaTabTime = time;
-        this.modifiedTempo = modifiedTempo;
-        this.millisecondOffset = millisecondOffset;
-    }
-}
 class MidiSequencerState {
     constructor() {
         this.tempoChanges = [];
@@ -22457,7 +22492,7 @@ class MidiFileSequencer {
             this._mainState.currentTempo = this._mainState.tempoChanges[0].bpm;
             this._mainState.modifiedTempo =
                 this._mainState.syncPoints.length > 0
-                    ? this._mainState.syncPoints[0].modifiedTempo
+                    ? this._mainState.syncPoints[0].syncBpm
                     : this._mainState.currentTempo;
             if (this.isPlayingMain) {
                 const metronomeVolume = this._synthesizer.metronomeVolume;
@@ -22628,7 +22663,7 @@ class MidiFileSequencer {
     }
     mainUpdateSyncPoints(syncPoints) {
         const state = this._mainState;
-        syncPoints.sort((a, b) => a.tick - b.tick); // just in case
+        syncPoints.sort((a, b) => a.synthTick - b.synthTick); // just in case
         state.syncPoints = [];
         if (syncPoints.length >= 0) {
             let bpm = 120;
@@ -22638,6 +22673,8 @@ class MidiFileSequencer {
             for (let i = 0; i < syncPoints.length; i++) {
                 const p = syncPoints[i];
                 let deltaTick = 0;
+                // TODO: merge interpolation into MidiFileGenerator where we already play through
+                // the time axis.
                 // remember state from previous sync point (or start). to handle linear interpolation
                 let previousModifiedTempo;
                 let previousMillisecondOffset;
@@ -22649,9 +22686,9 @@ class MidiFileSequencer {
                 }
                 else {
                     const previousSyncPoint = syncPoints[i - 1];
-                    previousModifiedTempo = previousSyncPoint.data.modifiedTempo;
-                    previousMillisecondOffset = previousSyncPoint.data.millisecondOffset;
-                    previousTick = previousSyncPoint.tick;
+                    previousModifiedTempo = previousSyncPoint.syncBpm;
+                    previousMillisecondOffset = previousSyncPoint.syncTime;
+                    previousTick = previousSyncPoint.synthTick;
                 }
                 // process time until sync point
                 // here it gets a bit tricky. if we have tempo changes on the synthesizer time axis (inbetween two sync points)
@@ -22659,27 +22696,31 @@ class MidiFileSequencer {
                 // otherwise the linear interpolation later in the lookup will fail.
                 // goal is to have always a linear increase between two points, no matter if the time axis is sliced by tempo changes or sync points
                 while (tempoChangeIndex < state.tempoChanges.length &&
-                    state.tempoChanges[tempoChangeIndex].ticks <= p.tick) {
+                    state.tempoChanges[tempoChangeIndex].ticks <= p.synthTick) {
                     deltaTick = state.tempoChanges[tempoChangeIndex].ticks - absTick;
                     if (deltaTick > 0) {
                         absTick += deltaTick;
                         absTime += deltaTick * (60000.0 / (bpm * state.division));
-                        const millisPerTick = (p.data.millisecondOffset - previousMillisecondOffset) / (p.tick - previousTick);
+                        const millisPerTick = (p.syncTime - previousMillisecondOffset) / (p.synthTick - previousTick);
                         const interpolatedMillisecondOffset = (absTick - previousTick) * millisPerTick + previousMillisecondOffset;
-                        state.syncPoints.push(new BackingTrackSyncPointWithTime(absTick, absTime, previousModifiedTempo, interpolatedMillisecondOffset));
+                        const syncPoint = new BackingTrackSyncPoint();
+                        syncPoint.synthTick = absTick;
+                        syncPoint.synthBpm = bpm;
+                        syncPoint.synthTime = absTime;
+                        syncPoint.syncTime = interpolatedMillisecondOffset;
+                        syncPoint.syncBpm = previousModifiedTempo;
                     }
                     bpm = state.tempoChanges[tempoChangeIndex].bpm;
                     tempoChangeIndex++;
                 }
-                deltaTick = p.tick - absTick;
+                deltaTick = p.synthTick - absTick;
                 absTick += deltaTick;
                 absTime += deltaTick * (60000.0 / (bpm * state.division));
-                state.syncPoints.push(new BackingTrackSyncPointWithTime(p.tick, absTime, p.data.modifiedTempo, p.data.millisecondOffset));
+                state.syncPoints.push(p);
             }
         }
         state.syncPointIndex = 0;
-        state.modifiedTempo =
-            state.syncPoints.length > 0 ? state.syncPoints[0].modifiedTempo : state.currentTempo;
+        state.modifiedTempo = state.syncPoints.length > 0 ? state.syncPoints[0].syncBpm : state.currentTempo;
     }
     currentTimePositionToTickPosition(timePosition) {
         const state = this._currentState;
@@ -22712,16 +22753,15 @@ class MidiFileSequencer {
         const syncPoints = state.syncPoints;
         if (syncPoints.length > 0) {
             let syncPointIndex = Math.min(state.syncPointIndex, syncPoints.length - 1);
-            if (timePosition < syncPoints[syncPointIndex].millisecondOffset) {
+            if (timePosition < syncPoints[syncPointIndex].syncTime) {
                 syncPointIndex = 0;
             }
-            while (syncPointIndex + 1 < syncPoints.length &&
-                syncPoints[syncPointIndex + 1].millisecondOffset <= timePosition) {
+            while (syncPointIndex + 1 < syncPoints.length && syncPoints[syncPointIndex + 1].syncTime <= timePosition) {
                 syncPointIndex++;
             }
             if (syncPointIndex !== state.syncPointIndex) {
                 state.syncPointIndex = syncPointIndex;
-                state.modifiedTempo = syncPoints[syncPointIndex].modifiedTempo;
+                state.modifiedTempo = syncPoints[syncPointIndex].syncBpm;
             }
         }
         else {
@@ -22737,18 +22777,18 @@ class MidiFileSequencer {
         this.updateSyncPoints(this._mainState, timePosition);
         const syncPointIndex = Math.min(mainState.syncPointIndex, syncPoints.length - 1);
         const currentSyncPoint = syncPoints[syncPointIndex];
-        const timeDiff = timePosition - currentSyncPoint.millisecondOffset;
+        const timeDiff = timePosition - currentSyncPoint.syncTime;
         let alphaTabTimeDiff;
         if (syncPointIndex + 1 < syncPoints.length) {
             const nextSyncPoint = syncPoints[syncPointIndex + 1];
-            const relativeTimeDiff = timeDiff / (nextSyncPoint.millisecondOffset - currentSyncPoint.millisecondOffset);
-            alphaTabTimeDiff = (nextSyncPoint.alphaTabTime - currentSyncPoint.alphaTabTime) * relativeTimeDiff;
+            const relativeTimeDiff = timeDiff / (nextSyncPoint.syncTime - currentSyncPoint.syncTime);
+            alphaTabTimeDiff = (nextSyncPoint.synthTime - currentSyncPoint.synthTime) * relativeTimeDiff;
         }
         else {
-            const relativeTimeDiff = timeDiff / (backingTrackLength - currentSyncPoint.millisecondOffset);
-            alphaTabTimeDiff = (mainState.endTime - currentSyncPoint.alphaTabTime) * relativeTimeDiff;
+            const relativeTimeDiff = timeDiff / (backingTrackLength - currentSyncPoint.syncTime);
+            alphaTabTimeDiff = (mainState.endTime - currentSyncPoint.synthTime) * relativeTimeDiff;
         }
-        return (currentSyncPoint.alphaTabTime + alphaTabTimeDiff) / this.playbackSpeed;
+        return (currentSyncPoint.synthTime + alphaTabTimeDiff) / this.playbackSpeed;
     }
     mainTimePositionToBackingTrack(timePosition, backingTrackLength) {
         const mainState = this._mainState;
@@ -22758,27 +22798,27 @@ class MidiFileSequencer {
         }
         timePosition *= this.playbackSpeed;
         let syncPointIndex = Math.min(mainState.syncPointIndex, syncPoints.length - 1);
-        if (timePosition < syncPoints[syncPointIndex].alphaTabTime) {
+        if (timePosition < syncPoints[syncPointIndex].synthTime) {
             syncPointIndex = 0;
         }
-        while (syncPointIndex + 1 < syncPoints.length && syncPoints[syncPointIndex + 1].alphaTabTime <= timePosition) {
+        while (syncPointIndex + 1 < syncPoints.length && syncPoints[syncPointIndex + 1].synthTime <= timePosition) {
             syncPointIndex++;
         }
         // NOTE: this logic heavily relies on the interpolation done in mainUpdateSyncPoints
         // we ensure that we have a linear increase between two points
         const currentSyncPoint = syncPoints[syncPointIndex];
-        const alphaTabTimeDiff = timePosition - currentSyncPoint.alphaTabTime;
+        const alphaTabTimeDiff = timePosition - currentSyncPoint.synthTime;
         let backingTrackPos;
         if (syncPointIndex + 1 < syncPoints.length) {
             const nextSyncPoint = syncPoints[syncPointIndex + 1];
-            const relativeAlphaTabTimeDiff = alphaTabTimeDiff / (nextSyncPoint.alphaTabTime - currentSyncPoint.alphaTabTime);
-            const backingTrackDiff = nextSyncPoint.millisecondOffset - currentSyncPoint.millisecondOffset;
-            backingTrackPos = currentSyncPoint.millisecondOffset + backingTrackDiff * relativeAlphaTabTimeDiff;
+            const relativeAlphaTabTimeDiff = alphaTabTimeDiff / (nextSyncPoint.synthTime - currentSyncPoint.synthTime);
+            const backingTrackDiff = nextSyncPoint.syncTime - currentSyncPoint.syncTime;
+            backingTrackPos = currentSyncPoint.syncTime + backingTrackDiff * relativeAlphaTabTimeDiff;
         }
         else {
-            const relativeAlphaTabTimeDiff = alphaTabTimeDiff / (mainState.endTime - currentSyncPoint.alphaTabTime);
-            const frameDiff = backingTrackLength - currentSyncPoint.millisecondOffset;
-            backingTrackPos = currentSyncPoint.millisecondOffset + frameDiff * relativeAlphaTabTimeDiff;
+            const relativeAlphaTabTimeDiff = alphaTabTimeDiff / (mainState.endTime - currentSyncPoint.synthTime);
+            const frameDiff = backingTrackLength - currentSyncPoint.syncTime;
+            backingTrackPos = currentSyncPoint.syncTime + frameDiff * relativeAlphaTabTimeDiff;
         }
         return backingTrackPos;
     }
@@ -31050,7 +31090,6 @@ class SyncPointDataSerializer {
         }
         const o = new Map();
         o.set("baroccurence", obj.barOccurence);
-        o.set("modifiedtempo", obj.modifiedTempo);
         o.set("millisecondoffset", obj.millisecondOffset);
         return o;
     }
@@ -31059,9 +31098,6 @@ class SyncPointDataSerializer {
             case "baroccurence":
                 obj.barOccurence = v;
                 return true;
-            case "modifiedtempo":
-                obj.modifiedTempo = v;
-                return true;
             case "millisecondoffset":
                 obj.millisecondOffset = v;
                 return true;
@@ -35824,17 +35860,6 @@ class MidiTickLookup {
     }
 }
 
-/**
- * Rerpresents a point to sync the alphaTab time axis with an external backing track.
- */
-class BackingTrackSyncPoint {
-    constructor(tick, data) {
-        this.tick = 0;
-        this.tick = tick;
-        this.data = data;
-    }
-}
-
 class MidiNoteDuration {
     constructor() {
         this.noteOnly = 0;
@@ -35855,6 +35880,14 @@ class RasgueadoInfo {
         this.brushInfos = [];
     }
 }
+class PlayThroughContext {
+    constructor() {
+        this.synthTick = 0;
+        this.synthTime = 0;
+        this.currentTempo = 0;
+        this.automationToSyncPoint = new Map();
+    }
+}
 /**
  * This generator creates a midi file using a score.
  */
@@ -35981,9 +36014,22 @@ class MidiFileGenerator {
         });
         return syncPoints;
     }
+    /**
+     * @internal
+     */
+    static buildModifiedTempoLookup(score) {
+        const syncPoints = [];
+        const context = MidiFileGenerator.playThroughSong(score, syncPoints, (_masterBar, _previousMasterBar, _currentTick, _currentTempo, _barOccurence) => {
+        }, (_barIndex, _currentTick, _currentTempo) => {
+        }, _endTick => {
+        });
+        return context.automationToSyncPoint;
+    }
     static playThroughSong(score, syncPoints, generateMasterBar, generateTracks, finish) {
         const controller = new MidiPlaybackController(score);
-        let currentTempo = score.tempo;
+        const playContext = new PlayThroughContext();
+        playContext.currentTempo = score.tempo;
+        playContext.syncPoints = syncPoints;
         let previousMasterBar = null;
         // store the previous played bar for repeats
         const barOccurence = new Map();
@@ -35996,23 +36042,11 @@ class MidiFileGenerator {
                 let occurence = barOccurence.has(index) ? barOccurence.get(index) : -1;
                 occurence++;
                 barOccurence.set(index, occurence);
-                generateMasterBar(bar, previousMasterBar, currentTick, currentTempo, occurence);
-                const barSyncPoints = bar.syncPoints;
-                if (barSyncPoints) {
-                    for (const syncPoint of barSyncPoints) {
-                        if (syncPoint.syncPointValue.barOccurence === occurence) {
-                            const tick = currentTick + bar.calculateDuration() * syncPoint.ratioPosition;
-                            syncPoints.push(new BackingTrackSyncPoint(tick, syncPoint.syncPointValue));
-                        }
-                    }
-                }
-                if (bar.tempoAutomations.length > 0) {
-                    currentTempo = bar.tempoAutomations[0].value;
-                }
-                generateTracks(index, currentTick, currentTempo);
-                if (bar.tempoAutomations.length > 0) {
-                    currentTempo = bar.tempoAutomations[bar.tempoAutomations.length - 1].value;
-                }
+                generateMasterBar(bar, previousMasterBar, currentTick, playContext.currentTempo, occurence);
+                const trackTempo = bar.tempoAutomations.length > 0 ? bar.tempoAutomations[0].value : playContext.currentTempo;
+                generateTracks(index, currentTick, trackTempo);
+                playContext.synthTick = currentTick;
+                MidiFileGenerator.processBarTime(bar, occurence, playContext);
             }
             controller.moveNext();
             previousMasterBar = bar;
@@ -36023,21 +36057,119 @@ class MidiFileGenerator {
         // but where it ends according to the BPM and the remaining ticks.
         if (syncPoints.length > 0) {
             const lastSyncPoint = syncPoints[syncPoints.length - 1];
-            const remainingTicks = controller.currentTick - lastSyncPoint.tick;
+            const remainingTicks = controller.currentTick - lastSyncPoint.synthTick;
             if (remainingTicks > 0) {
-                const syncPointData = new SyncPointData();
-                // last occurence of the last bar
-                syncPointData.barOccurence = barOccurence.get(score.masterBars.length - 1);
-                // same tempo as last point
-                syncPointData.modifiedTempo = lastSyncPoint.data.modifiedTempo;
-                // interpolated end from last syncPoint
-                syncPointData.millisecondOffset =
-                    lastSyncPoint.data.millisecondOffset +
-                        MidiUtils.ticksToMillis(remainingTicks, syncPointData.modifiedTempo);
-                syncPoints.push(new BackingTrackSyncPoint(controller.currentTick, syncPointData));
+                const backingTrackSyncPoint = new BackingTrackSyncPoint();
+                backingTrackSyncPoint.masterBarIndex = previousMasterBar.index;
+                backingTrackSyncPoint.masterBarOccurence = barOccurence.get(previousMasterBar.index) - 1;
+                backingTrackSyncPoint.synthTick = controller.currentTick;
+                backingTrackSyncPoint.synthBpm = playContext.currentTempo;
+                // we need to assume some BPM for the last interpolated point.
+                // if we have more than just a start point, we keep the BPM before the last manual sync point
+                // otherwise we have no customized sync BPM known and keep the synthesizer one.
+                backingTrackSyncPoint.syncBpm =
+                    syncPoints.length > 1 ? syncPoints[syncPoints.length - 2].syncBpm : lastSyncPoint.synthBpm;
+                backingTrackSyncPoint.synthTime =
+                    lastSyncPoint.synthTime + MidiUtils.ticksToMillis(remainingTicks, lastSyncPoint.synthBpm);
+                backingTrackSyncPoint.syncTime =
+                    lastSyncPoint.syncTime + MidiUtils.ticksToMillis(remainingTicks, backingTrackSyncPoint.syncBpm);
+                // update the previous sync point according to the new time
+                lastSyncPoint.updateSyncBpm(backingTrackSyncPoint.synthTime, backingTrackSyncPoint.syncTime);
+                syncPoints.push(backingTrackSyncPoint);
             }
         }
         finish(controller.currentTick);
+        return playContext;
+    }
+    static processBarTime(bar, occurence, context) {
+        const duration = bar.calculateDuration();
+        const barSyncPoints = bar.syncPoints;
+        const barStartTick = context.synthTick;
+        if (barSyncPoints) {
+            MidiFileGenerator.processBarTimeWithSyncPoints(bar, occurence, context);
+        }
+        else {
+            MidiFileGenerator.processBarTimeNoSyncPoints(bar, context);
+        }
+        // don't forget the part after the last tempo change
+        const endTick = barStartTick + duration;
+        const tickOffset = endTick - context.synthTick;
+        if (tickOffset > 0) {
+            context.synthTime += MidiUtils.ticksToMillis(tickOffset, context.currentTempo);
+            context.synthTick = endTick;
+        }
+    }
+    static processBarTimeWithSyncPoints(bar, occurence, context) {
+        const barStartTick = context.synthTick;
+        const duration = bar.calculateDuration();
+        let tempoChangeIndex = 0;
+        let tickOffset;
+        for (const syncPoint of bar.syncPoints) {
+            if (syncPoint.syncPointValue.barOccurence !== occurence) {
+                continue;
+            }
+            const syncPointTick = barStartTick + syncPoint.ratioPosition * duration;
+            // first process all tempo changes until this sync point
+            while (tempoChangeIndex < bar.tempoAutomations.length &&
+                bar.tempoAutomations[tempoChangeIndex].ratioPosition <= syncPoint.ratioPosition) {
+                const tempoChange = bar.tempoAutomations[tempoChangeIndex];
+                const absoluteTick = barStartTick + tempoChange.ratioPosition * duration;
+                tickOffset = absoluteTick - context.synthTick;
+                if (tickOffset > 0) {
+                    context.synthTick = absoluteTick;
+                    context.synthTime += MidiUtils.ticksToMillis(tickOffset, context.currentTempo);
+                }
+                context.currentTempo = tempoChange.value;
+                tempoChangeIndex++;
+            }
+            // process time until sync point
+            tickOffset = syncPointTick - context.synthTick;
+            if (tickOffset > 0) {
+                context.synthTick = syncPointTick;
+                context.synthTime += MidiUtils.ticksToMillis(tickOffset, context.currentTempo);
+            }
+            // update the previous sync point according to the new time
+            if (context.syncPoints.length > 0) {
+                context.syncPoints[context.syncPoints.length - 1].updateSyncBpm(context.synthTime, syncPoint.syncPointValue.millisecondOffset);
+            }
+            // create the new sync point
+            const backingTrackSyncPoint = new BackingTrackSyncPoint();
+            backingTrackSyncPoint.masterBarIndex = bar.index;
+            backingTrackSyncPoint.masterBarOccurence = occurence;
+            backingTrackSyncPoint.synthTick = syncPointTick;
+            backingTrackSyncPoint.synthBpm = context.currentTempo;
+            backingTrackSyncPoint.synthTime = context.synthTime;
+            backingTrackSyncPoint.syncTime = syncPoint.syncPointValue.millisecondOffset;
+            backingTrackSyncPoint.syncBpm = 0 /* calculated by next sync point */;
+            context.syncPoints.push(backingTrackSyncPoint);
+            context.automationToSyncPoint.set(syncPoint, backingTrackSyncPoint);
+        }
+        // process remaining tempo changes after all sync points
+        while (tempoChangeIndex < bar.tempoAutomations.length) {
+            const tempoChange = bar.tempoAutomations[tempoChangeIndex];
+            const absoluteTick = barStartTick + tempoChange.ratioPosition * duration;
+            tickOffset = absoluteTick - context.synthTick;
+            if (tickOffset > 0) {
+                context.synthTick = absoluteTick;
+                context.synthTime += MidiUtils.ticksToMillis(tickOffset, context.currentTempo);
+            }
+            context.currentTempo = tempoChange.value;
+            tempoChangeIndex++;
+        }
+    }
+    static processBarTimeNoSyncPoints(bar, context) {
+        // walk through the tempo changes
+        const barStartTick = context.synthTick;
+        const duration = bar.calculateDuration();
+        for (const changes of bar.tempoAutomations) {
+            const absoluteTick = barStartTick + changes.ratioPosition * duration;
+            const tickOffset = absoluteTick - context.synthTick;
+            if (tickOffset > 0) {
+                context.synthTick = absoluteTick;
+                context.synthTime += MidiUtils.ticksToMillis(tickOffset, context.currentTempo);
+            }
+            context.currentTempo = changes.value;
+        }
     }
     static toChannelShort(data) {
         const value = Math.max(-32768, Math.min(32767, data * 8 - 1));
@@ -61000,9 +61132,9 @@ class VersionInfo {
         print(`build date: ${VersionInfo.date}`);
     }
 }
-VersionInfo.version = '1.6.0-alpha.1428';
-VersionInfo.date = '2025-05-29T00:44:50.954Z';
-VersionInfo.commit = 'fa81a14da248f229511867324cee663ea70a72b3';
+VersionInfo.version = '1.6.0-alpha.1430';
+VersionInfo.date = '2025-05-29T22:21:21.689Z';
+VersionInfo.commit = '98a4c2bec8d71f2645008118d3b77fb40973e7fe';
 
 /**
  * A factory for custom layout engines.
@@ -62652,6 +62784,7 @@ class GpifWriter {
             : undefined;
         const millisecondPadding = initialSyncPoint ? initialSyncPoint.syncPointValue.millisecondOffset : 0;
         this.backingTrackFramePadding = (-1 * ((millisecondPadding / 1000) * GpifWriter.SampleRate)) | 0;
+        const modifiedTempoLookup = new Lazy(() => MidiFileGenerator.buildModifiedTempoLookup(score));
         for (const mb of score.masterBars) {
             for (const automation of mb.tempoAutomations) {
                 const tempoAutomation = automations.addElement('Automation');
@@ -62676,7 +62809,7 @@ class GpifWriter {
                     const value = syncPointAutomation.addElement('Value');
                     value.addElement('BarIndex').innerText = mb.index.toString();
                     value.addElement('BarOccurrence').innerText = syncPoint.syncPointValue.barOccurence.toString();
-                    value.addElement('ModifiedTempo').innerText = syncPoint.syncPointValue.modifiedTempo.toString();
+                    value.addElement('ModifiedTempo').innerText = modifiedTempoLookup.value.get(syncPoint).syncBpm.toString();
                     value.addElement('OriginalTempo').innerText = score.tempo.toString();
                     const frameOffset = (((syncPoint.syncPointValue.millisecondOffset - millisecondPadding) / 1000) *
                         GpifWriter.SampleRate) |

package/dist/alphaTab.d.ts

@@ -3092,17 +3092,48 @@ declare class BackingTrack {
  * Rerpresents a point to sync the alphaTab time axis with an external backing track.
  */
 declare class BackingTrackSyncPoint {
-    tick: number;
-    data: SyncPointData;
-    constructor(tick: number, data: SyncPointData);
-}
-
-declare class BackingTrackSyncPointWithTime {
-    alphaTabTick: number;
-    alphaTabTime: number;
-    modifiedTempo: number;
-    millisecondOffset: number;
-    constructor(tick: number, time: number, modifiedTempo: number, millisecondOffset: number);
+    /**
+     * The index of the masterbar to which this sync point belongs to.
+     * @remarks
+     * This property is purely informative for external use like in editors.
+     * It has no impact to the synchronization itself.
+     */
+    masterBarIndex: number;
+    /**
+     * The occurence of the masterbar to which this sync point belongs to. The occurence
+     * is 0-based and increases with every repeated play of a masterbar (e.g. on repeats or jumps).
+     * @remarks
+     * This property is purely informative for external use like in editors.
+     * It has no impact to the synchronization itself.
+     */
+    masterBarOccurence: number;
+    /**
+     * The BPM the synthesizer has at the exact tick position of this sync point.
+     */
+    synthBpm: number;
+    /**
+     * The millisecond time position of the synthesizer when this sync point is reached.
+     */
+    synthTime: number;
+    /**
+     * The midi tick position of the synthesizer when this sync point is reached.
+     */
+    synthTick: number;
+    /**
+     * The millisecond time in the external media marking the synchronization point.
+     */
+    syncTime: number;
+    /**
+     * The BPM the song will have virtually after this sync point to align the external media time axis
+     * with the one from the synthesizer.
+     */
+    syncBpm: number;
+    /**
+     * Updates the synchronization BPM that will apply after this sync point.
+     * @param nextSyncPointSynthTime The synthesizer time of the next sync point after this one.
+     * @param nextSyncPointSyncTime The synchronization time of the next sync point after this one.
+     */
+    updateSyncBpm(nextSyncPointSynthTime: number, nextSyncPointSyncTime: number): void;
 }
 
 /**
@@ -6492,13 +6523,7 @@ declare interface FlatSyncPoint {
      */
     barOccurence: number;
     /**
-     * The modified tempo at which the cursor should move (aka. the tempo played within the external audio track).
-     * This information is used together with normal tempo changes to calculate how much faster/slower the
-     * cursor playback is performed to align with the audio track.
-     */
-    modifiedTempo: number;
-    /**
-     * The uadio offset marking the position within the audio track in milliseconds.
+     * The audio offset marking the position within the audio track in milliseconds.
      * This information is used to regularly sync (or on seeking) to match a given external audio time axis with the internal time axis.
      */
     millisecondOffset: number;
@@ -9271,7 +9296,11 @@ declare class MidiFileGenerator {
      * @returns The generated sync points for usage in the backing track playback.
      */
     static generateSyncPoints(score: Score): BackingTrackSyncPoint[];
+    /* Excluded from this release type: buildModifiedTempoLookup */
     private static playThroughSong;
+    private static processBarTime;
+    private static processBarTimeWithSyncPoints;
+    private static processBarTimeNoSyncPoints;
     private static toChannelShort;
     private generateMasterBar;
     private generateBar;
@@ -9415,7 +9444,7 @@ declare class MidiFileSequencerTempoChange {
 declare class MidiSequencerState {
     tempoChanges: MidiFileSequencerTempoChange[];
     tempoChangeIndex: number;
-    syncPoints: BackingTrackSyncPointWithTime[];
+    syncPoints: BackingTrackSyncPoint[];
     firstProgramEventPerChannel: Map<number, SynthEvent>;
     firstTimeSignatureNumerator: number;
     firstTimeSignatureDenominator: number;
@@ -13656,12 +13685,6 @@ declare class SyncPointData {
      * Indicates for which repeat occurence this sync point is valid (e.g. 0 on the first time played, 1 on the second time played)
      */
     barOccurence: number;
-    /**
-     * The modified tempo at which the cursor should move (aka. the tempo played within the external audio track).
-     * This information is used together with normal tempo changes to calculate how much faster/slower the
-     * cursor playback is performed to align with the audio track.
-     */
-    modifiedTempo: number;
     /**
      * The audio offset marking the position within the audio track in milliseconds.
      * This information is used to regularly sync (or on seeking) to match a given external audio time axis with the internal time axis.