@coderline/alphatab 1.6.0-alpha.1448 → 1.6.0-alpha.1450

package/dist/alphaTab.core.mjs

@@ -1,5 +1,5 @@
 /*!
- * alphaTab v1.6.0-alpha.1448 (develop, build 1448)
+ * alphaTab v1.6.0-alpha.1450 (develop, build 1450)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -22887,6 +22887,9 @@ class MidiFileSequencer {
         if (tempoChangeIndex !== state.tempoChangeIndex) {
             state.tempoChangeIndex = tempoChangeIndex;
             state.currentTempo = state.tempoChanges[state.tempoChangeIndex].bpm;
+            if (state.syncPoints.length === 0) {
+                state.syncPointTempo = state.currentTempo;
+            }
         }
     }
     currentUpdateSyncPoints(timePosition) {
@@ -36331,6 +36334,7 @@ class PlayThroughContext {
         this.synthTime = 0;
         this.currentTempo = 0;
         this.automationToSyncPoint = new Map();
+        this.createNewSyncPoints = false;
     }
 }
 /**
@@ -36383,7 +36387,7 @@ class MidiFileGenerator {
         }
         Logger.debug('Midi', 'Begin midi generation');
         this.syncPoints = [];
-        MidiFileGenerator.playThroughSong(this._score, this.syncPoints, (bar, previousMasterBar, currentTick, currentTempo, occurence) => {
+        MidiFileGenerator.playThroughSong(this._score, this.syncPoints, false, (bar, previousMasterBar, currentTick, currentTempo, occurence) => {
             this.generateMasterBar(bar, previousMasterBar, currentTick, currentTempo, occurence);
         }, (index, currentTick, currentTempo) => {
             for (const track of this._score.tracks) {
@@ -36449,11 +36453,12 @@ class MidiFileGenerator {
      * It correctly handles repeats and places sync points accoridng to their absolute midi tick when they
      * need to be considered for synchronization.
      * @param score The song for which to regenerate the sync points.
+     * @param createNew Whether a new set of sync points should be generated for the sync (start, stop and tempo changes).
      * @returns The generated sync points for usage in the backing track playback.
      */
-    static generateSyncPoints(score) {
+    static generateSyncPoints(score, createNew = false) {
         const syncPoints = [];
-        MidiFileGenerator.playThroughSong(score, syncPoints, (_masterBar, _previousMasterBar, _currentTick, _currentTempo, _barOccurence) => {
+        MidiFileGenerator.playThroughSong(score, syncPoints, createNew, (_masterBar, _previousMasterBar, _currentTick, _currentTempo, _barOccurence) => {
         }, (_barIndex, _currentTick, _currentTempo) => {
         }, _endTick => {
         });
@@ -36464,17 +36469,18 @@ class MidiFileGenerator {
      */
     static buildModifiedTempoLookup(score) {
         const syncPoints = [];
-        const context = MidiFileGenerator.playThroughSong(score, syncPoints, (_masterBar, _previousMasterBar, _currentTick, _currentTempo, _barOccurence) => {
+        const context = MidiFileGenerator.playThroughSong(score, syncPoints, false, (_masterBar, _previousMasterBar, _currentTick, _currentTempo, _barOccurence) => {
         }, (_barIndex, _currentTick, _currentTempo) => {
         }, _endTick => {
         });
         return context.automationToSyncPoint;
     }
-    static playThroughSong(score, syncPoints, generateMasterBar, generateTracks, finish) {
+    static playThroughSong(score, syncPoints, createNewSyncPoints, generateMasterBar, generateTracks, finish) {
         const controller = new MidiPlaybackController(score);
         const playContext = new PlayThroughContext();
         playContext.currentTempo = score.tempo;
         playContext.syncPoints = syncPoints;
+        playContext.createNewSyncPoints = createNewSyncPoints;
         let previousMasterBar = null;
         // store the previous played bar for repeats
         const barOccurence = new Map();
@@ -36512,14 +36518,24 @@ class MidiFileGenerator {
                 // 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;
+                if (playContext.createNewSyncPoints) {
+                    backingTrackSyncPoint.syncBpm = lastSyncPoint.synthBpm;
+                    backingTrackSyncPoint.synthBpm = lastSyncPoint.synthBpm;
+                }
+                else if (syncPoints.length === 1) {
+                    backingTrackSyncPoint.syncBpm = lastSyncPoint.synthBpm;
+                }
+                else {
+                    backingTrackSyncPoint.syncBpm = syncPoints[syncPoints.length - 2].syncBpm;
+                }
                 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);
+                if (!playContext.createNewSyncPoints) {
+                    lastSyncPoint.updateSyncBpm(backingTrackSyncPoint.synthTime, backingTrackSyncPoint.syncTime);
+                }
                 syncPoints.push(backingTrackSyncPoint);
             }
         }
@@ -36530,7 +36546,10 @@ class MidiFileGenerator {
         const duration = bar.calculateDuration();
         const barSyncPoints = bar.syncPoints;
         const barStartTick = context.synthTick;
-        if (barSyncPoints) {
+        if (context.createNewSyncPoints) {
+            MidiFileGenerator.processBarTimeWithNewSyncPoints(bar, occurence, context);
+        }
+        else if (barSyncPoints) {
             MidiFileGenerator.processBarTimeWithSyncPoints(bar, occurence, context);
         }
         else {
@@ -36544,6 +36563,44 @@ class MidiFileGenerator {
             context.synthTick = endTick;
         }
     }
+    static processBarTimeWithNewSyncPoints(bar, occurence, context) {
+        // start marker
+        const barStartTick = context.synthTick;
+        if (bar.index === 0 && occurence === 0) {
+            context.currentTempo = bar.score.tempo;
+            const backingTrackSyncPoint = new BackingTrackSyncPoint();
+            backingTrackSyncPoint.masterBarIndex = bar.index;
+            backingTrackSyncPoint.masterBarOccurence = occurence;
+            backingTrackSyncPoint.synthTick = barStartTick;
+            backingTrackSyncPoint.synthBpm = context.currentTempo;
+            backingTrackSyncPoint.synthTime = context.synthTime;
+            backingTrackSyncPoint.syncBpm = context.currentTempo;
+            backingTrackSyncPoint.syncTime = context.synthTime;
+            context.syncPoints.push(backingTrackSyncPoint);
+        }
+        // walk tempo changes and create points
+        const duration = bar.calculateDuration();
+        for (const change of bar.tempoAutomations) {
+            const absoluteTick = barStartTick + change.ratioPosition * duration;
+            const tickOffset = absoluteTick - context.synthTick;
+            if (tickOffset > 0) {
+                context.synthTick = absoluteTick;
+                context.synthTime += MidiUtils.ticksToMillis(tickOffset, context.currentTempo);
+            }
+            if (change.value !== context.currentTempo) {
+                context.currentTempo = change.value;
+                const backingTrackSyncPoint = new BackingTrackSyncPoint();
+                backingTrackSyncPoint.masterBarIndex = bar.index;
+                backingTrackSyncPoint.masterBarOccurence = occurence;
+                backingTrackSyncPoint.synthTick = absoluteTick;
+                backingTrackSyncPoint.synthBpm = context.currentTempo;
+                backingTrackSyncPoint.synthTime = context.synthTime;
+                backingTrackSyncPoint.syncBpm = context.currentTempo;
+                backingTrackSyncPoint.syncTime = context.synthTime;
+                context.syncPoints.push(backingTrackSyncPoint);
+            }
+        }
+    }
     static processBarTimeWithSyncPoints(bar, occurence, context) {
         const barStartTick = context.synthTick;
         const duration = bar.calculateDuration();
@@ -42881,7 +42938,12 @@ class AlphaTabApiBase {
      * @remarks
      * This will not export or use any backing track media but will always use the synthesizer to generate the output.
      * This method works with any PlayerMode active but changing the mode during export can lead to unexpected side effects.
+     *
+     * See [Audio Export](https://www.alphatab.net/docs/guides/audio-export) for further guidance how to use this feature.
+     *
      * @param options The export options.
+     * @category Methods - Player
+     * @since 1.6.0
      * @returns An exporter instance to export the audio in a streaming fashion.
      */
     async exportAudio(options) {
@@ -61727,9 +61789,9 @@ class VersionInfo {
         print(`build date: ${VersionInfo.date}`);
     }
 }
-VersionInfo.version = '1.6.0-alpha.1448';
-VersionInfo.date = '2025-06-14T22:07:33.833Z';
-VersionInfo.commit = 'bfeddfaced057b74c2fa71fa58aa407467dd7460';
+VersionInfo.version = '1.6.0-alpha.1450';
+VersionInfo.date = '2025-06-15T01:20:26.410Z';
+VersionInfo.commit = 'a7639d9604a6fcdedff2883864b1008daae5cc64';
 
 /**
  * A factory for custom layout engines.

package/dist/alphaTab.d.ts

@@ -2965,7 +2965,12 @@ export declare class AlphaTabApiBase<TSettings> {
      * @remarks
      * This will not export or use any backing track media but will always use the synthesizer to generate the output.
      * This method works with any PlayerMode active but changing the mode during export can lead to unexpected side effects.
+     *
+     * See [Audio Export](https://www.alphatab.net/docs/guides/audio-export) for further guidance how to use this feature.
+     *
      * @param options The export options.
+     * @category Methods - Player
+     * @since 1.6.0
      * @returns An exporter instance to export the audio in a streaming fashion.
      */
     exportAudio(options: AudioExportOptions): Promise<IAudioExporter>;
@@ -9628,12 +9633,14 @@ declare class MidiFileGenerator {
      * It correctly handles repeats and places sync points accoridng to their absolute midi tick when they
      * need to be considered for synchronization.
      * @param score The song for which to regenerate the sync points.
+     * @param createNew Whether a new set of sync points should be generated for the sync (start, stop and tempo changes).
      * @returns The generated sync points for usage in the backing track playback.
      */
-    static generateSyncPoints(score: Score): BackingTrackSyncPoint[];
+    static generateSyncPoints(score: Score, createNew?: boolean): BackingTrackSyncPoint[];
     /* Excluded from this release type: buildModifiedTempoLookup */
     private static playThroughSong;
     private static processBarTime;
+    private static processBarTimeWithNewSyncPoints;
     private static processBarTimeWithSyncPoints;
     private static processBarTimeNoSyncPoints;
     private static toChannelShort;

package/dist/alphaTab.js

@@ -1,5 +1,5 @@
 /*!
- * alphaTab v1.6.0-alpha.1448 (develop, build 1448)
+ * alphaTab v1.6.0-alpha.1450 (develop, build 1450)
  *
  * Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
  *
@@ -22893,6 +22893,9 @@
             if (tempoChangeIndex !== state.tempoChangeIndex) {
                 state.tempoChangeIndex = tempoChangeIndex;
                 state.currentTempo = state.tempoChanges[state.tempoChangeIndex].bpm;
+                if (state.syncPoints.length === 0) {
+                    state.syncPointTempo = state.currentTempo;
+                }
             }
         }
         currentUpdateSyncPoints(timePosition) {
@@ -36337,6 +36340,7 @@
             this.synthTime = 0;
             this.currentTempo = 0;
             this.automationToSyncPoint = new Map();
+            this.createNewSyncPoints = false;
         }
     }
     /**
@@ -36389,7 +36393,7 @@
             }
             Logger.debug('Midi', 'Begin midi generation');
             this.syncPoints = [];
-            MidiFileGenerator.playThroughSong(this._score, this.syncPoints, (bar, previousMasterBar, currentTick, currentTempo, occurence) => {
+            MidiFileGenerator.playThroughSong(this._score, this.syncPoints, false, (bar, previousMasterBar, currentTick, currentTempo, occurence) => {
                 this.generateMasterBar(bar, previousMasterBar, currentTick, currentTempo, occurence);
             }, (index, currentTick, currentTempo) => {
                 for (const track of this._score.tracks) {
@@ -36455,11 +36459,12 @@
          * It correctly handles repeats and places sync points accoridng to their absolute midi tick when they
          * need to be considered for synchronization.
          * @param score The song for which to regenerate the sync points.
+         * @param createNew Whether a new set of sync points should be generated for the sync (start, stop and tempo changes).
          * @returns The generated sync points for usage in the backing track playback.
          */
-        static generateSyncPoints(score) {
+        static generateSyncPoints(score, createNew = false) {
             const syncPoints = [];
-            MidiFileGenerator.playThroughSong(score, syncPoints, (_masterBar, _previousMasterBar, _currentTick, _currentTempo, _barOccurence) => {
+            MidiFileGenerator.playThroughSong(score, syncPoints, createNew, (_masterBar, _previousMasterBar, _currentTick, _currentTempo, _barOccurence) => {
             }, (_barIndex, _currentTick, _currentTempo) => {
             }, _endTick => {
             });
@@ -36470,17 +36475,18 @@
          */
         static buildModifiedTempoLookup(score) {
             const syncPoints = [];
-            const context = MidiFileGenerator.playThroughSong(score, syncPoints, (_masterBar, _previousMasterBar, _currentTick, _currentTempo, _barOccurence) => {
+            const context = MidiFileGenerator.playThroughSong(score, syncPoints, false, (_masterBar, _previousMasterBar, _currentTick, _currentTempo, _barOccurence) => {
             }, (_barIndex, _currentTick, _currentTempo) => {
             }, _endTick => {
             });
             return context.automationToSyncPoint;
         }
-        static playThroughSong(score, syncPoints, generateMasterBar, generateTracks, finish) {
+        static playThroughSong(score, syncPoints, createNewSyncPoints, generateMasterBar, generateTracks, finish) {
             const controller = new MidiPlaybackController(score);
             const playContext = new PlayThroughContext();
             playContext.currentTempo = score.tempo;
             playContext.syncPoints = syncPoints;
+            playContext.createNewSyncPoints = createNewSyncPoints;
             let previousMasterBar = null;
             // store the previous played bar for repeats
             const barOccurence = new Map();
@@ -36518,14 +36524,24 @@
                     // 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;
+                    if (playContext.createNewSyncPoints) {
+                        backingTrackSyncPoint.syncBpm = lastSyncPoint.synthBpm;
+                        backingTrackSyncPoint.synthBpm = lastSyncPoint.synthBpm;
+                    }
+                    else if (syncPoints.length === 1) {
+                        backingTrackSyncPoint.syncBpm = lastSyncPoint.synthBpm;
+                    }
+                    else {
+                        backingTrackSyncPoint.syncBpm = syncPoints[syncPoints.length - 2].syncBpm;
+                    }
                     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);
+                    if (!playContext.createNewSyncPoints) {
+                        lastSyncPoint.updateSyncBpm(backingTrackSyncPoint.synthTime, backingTrackSyncPoint.syncTime);
+                    }
                     syncPoints.push(backingTrackSyncPoint);
                 }
             }
@@ -36536,7 +36552,10 @@
             const duration = bar.calculateDuration();
             const barSyncPoints = bar.syncPoints;
             const barStartTick = context.synthTick;
-            if (barSyncPoints) {
+            if (context.createNewSyncPoints) {
+                MidiFileGenerator.processBarTimeWithNewSyncPoints(bar, occurence, context);
+            }
+            else if (barSyncPoints) {
                 MidiFileGenerator.processBarTimeWithSyncPoints(bar, occurence, context);
             }
             else {
@@ -36550,6 +36569,44 @@
                 context.synthTick = endTick;
             }
         }
+        static processBarTimeWithNewSyncPoints(bar, occurence, context) {
+            // start marker
+            const barStartTick = context.synthTick;
+            if (bar.index === 0 && occurence === 0) {
+                context.currentTempo = bar.score.tempo;
+                const backingTrackSyncPoint = new BackingTrackSyncPoint();
+                backingTrackSyncPoint.masterBarIndex = bar.index;
+                backingTrackSyncPoint.masterBarOccurence = occurence;
+                backingTrackSyncPoint.synthTick = barStartTick;
+                backingTrackSyncPoint.synthBpm = context.currentTempo;
+                backingTrackSyncPoint.synthTime = context.synthTime;
+                backingTrackSyncPoint.syncBpm = context.currentTempo;
+                backingTrackSyncPoint.syncTime = context.synthTime;
+                context.syncPoints.push(backingTrackSyncPoint);
+            }
+            // walk tempo changes and create points
+            const duration = bar.calculateDuration();
+            for (const change of bar.tempoAutomations) {
+                const absoluteTick = barStartTick + change.ratioPosition * duration;
+                const tickOffset = absoluteTick - context.synthTick;
+                if (tickOffset > 0) {
+                    context.synthTick = absoluteTick;
+                    context.synthTime += MidiUtils.ticksToMillis(tickOffset, context.currentTempo);
+                }
+                if (change.value !== context.currentTempo) {
+                    context.currentTempo = change.value;
+                    const backingTrackSyncPoint = new BackingTrackSyncPoint();
+                    backingTrackSyncPoint.masterBarIndex = bar.index;
+                    backingTrackSyncPoint.masterBarOccurence = occurence;
+                    backingTrackSyncPoint.synthTick = absoluteTick;
+                    backingTrackSyncPoint.synthBpm = context.currentTempo;
+                    backingTrackSyncPoint.synthTime = context.synthTime;
+                    backingTrackSyncPoint.syncBpm = context.currentTempo;
+                    backingTrackSyncPoint.syncTime = context.synthTime;
+                    context.syncPoints.push(backingTrackSyncPoint);
+                }
+            }
+        }
         static processBarTimeWithSyncPoints(bar, occurence, context) {
             const barStartTick = context.synthTick;
             const duration = bar.calculateDuration();
@@ -42887,7 +42944,12 @@
          * @remarks
          * This will not export or use any backing track media but will always use the synthesizer to generate the output.
          * This method works with any PlayerMode active but changing the mode during export can lead to unexpected side effects.
+         *
+         * See [Audio Export](https://www.alphatab.net/docs/guides/audio-export) for further guidance how to use this feature.
+         *
          * @param options The export options.
+         * @category Methods - Player
+         * @since 1.6.0
          * @returns An exporter instance to export the audio in a streaming fashion.
          */
         async exportAudio(options) {
@@ -61733,9 +61795,9 @@
             print(`build date: ${VersionInfo.date}`);
         }
     }
-    VersionInfo.version = '1.6.0-alpha.1448';
-    VersionInfo.date = '2025-06-14T22:07:33.833Z';
-    VersionInfo.commit = 'bfeddfaced057b74c2fa71fa58aa407467dd7460';
+    VersionInfo.version = '1.6.0-alpha.1450';
+    VersionInfo.date = '2025-06-15T01:20:26.410Z';
+    VersionInfo.commit = 'a7639d9604a6fcdedff2883864b1008daae5cc64';
 
     /**
      * A factory for custom layout engines.