@coderline/alphatab 1.6.0-alpha.1418 → 1.6.0-alpha.1421

package/dist/alphaTab.d.ts

@@ -192,7 +192,8 @@ declare class AlphaSynthBase implements IAlphaSynth {
     readonly playbackRangeChanged: IEventEmitterOfT<PlaybackRangeChangedEventArgs>;
     /* Excluded from this release type: hasSamplesForProgram */
     /* Excluded from this release type: hasSamplesForPercussion */
-    loadBackingTrack(_score: Score, _syncPoints: BackingTrackSyncPoint[]): void;
+    loadBackingTrack(_score: Score): void;
+    updateSyncPoints(_syncPoints: BackingTrackSyncPoint[]): void;
 }
 
 /**
@@ -350,6 +351,7 @@ declare class AlphaSynthWebWorkerApi implements IAlphaSynth {
     onOutputSamplesPlayed(samples: number): void;
     private onOutputReady;
     loadBackingTrack(_score: Score): void;
+    updateSyncPoints(_syncPoints: BackingTrackSyncPoint[]): void;
 }
 
 /**
@@ -1399,6 +1401,12 @@ export declare class AlphaTabApiBase<TSettings> {
      * @since 1.6.0
      */
     loadMidiForScore(): void;
+    /**
+     * Triggers an update of the sync points for the current score after modification within the data model
+     * @category Methods - Player
+     * @since 1.6.0
+     */
+    updateSyncPoints(): void;
     /**
      * Changes the volume of the given tracks.
      * @param tracks The tracks for which the volume should be changed.
@@ -3078,11 +3086,6 @@ declare class BackingTrack {
      * @json_ignore
      */
     rawAudioFile: Uint8Array | undefined;
-    /**
-     * The number of milliseconds the audio should be shifted to align with the song.
-     * (e.g. negative values allow skipping potential silent parts at the start of the file and directly start with the first note).
-     */
-    padding: number;
 }
 
 /**
@@ -3094,9 +3097,12 @@ declare class BackingTrackSyncPoint {
     constructor(tick: number, data: SyncPointData);
 }
 
-declare class BackingTrackSyncPointWithTime extends BackingTrackSyncPoint {
-    time: number;
-    constructor(tick: number, data: SyncPointData, time: number);
+declare class BackingTrackSyncPointWithTime {
+    alphaTabTick: number;
+    alphaTabTime: number;
+    modifiedTempo: number;
+    millisecondOffset: number;
+    constructor(tick: number, time: number, modifiedTempo: number, millisecondOffset: number);
 }
 
 /**
@@ -7038,7 +7044,12 @@ declare interface IAlphaSynth {
      * Loads the synchronization information from the given score (used for backing tracks and external media).
      * @param score
      */
-    loadBackingTrack(score: Score, syncPoints: BackingTrackSyncPoint[]): void;
+    loadBackingTrack(score: Score): void;
+    /**
+     * Updates the points used to synchronize the backing track with the synthesized audio for correct cursor placement.
+     * @param syncPoints
+     */
+    updateSyncPoints(syncPoints: BackingTrackSyncPoint[]): void;
     /**
      * Applies the given transposition pitches to be used during playback.
      * @param transpositionPitches a map defining the transposition pitches for midi channel.
@@ -8809,7 +8820,13 @@ declare class MasterBarTickLookup {
      * Gets or sets the MasterBar which is played.
      */
     masterBar: MasterBar;
+    /**
+     * The first beat in the bar.
+     */
     firstBeat: BeatTickLookup | null;
+    /**
+     * The last beat in the bar.
+     */
     lastBeat: BeatTickLookup | null;
     /**
      * Inserts `newNextBeat` after `currentBeat` in the linked list of items and updates.
@@ -9168,6 +9185,17 @@ declare class MidiFileGenerator {
     private addProgramChange;
     static buildTranspositionPitches(score: Score, settings: Settings): Map<number, number>;
     private generateChannel;
+    /**
+     * Generates the sync points for the given score without re-generating the midi itself.
+     * @remarks
+     * Use this method if a re-generation of the sync points after modification is required.
+     * 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.
+     * @returns The generated sync points for usage in the backing track playback.
+     */
+    static generateSyncPoints(score: Score): BackingTrackSyncPoint[];
+    private static playThroughSong;
     private static toChannelShort;
     private generateMasterBar;
     private generateBar;
@@ -9288,6 +9316,7 @@ declare class MidiFileSequencer {
     mainUpdateSyncPoints(syncPoints: BackingTrackSyncPoint[]): void;
     currentTimePositionToTickPosition(timePosition: number): number;
     private updateCurrentTempo;
+    private updateSyncPoints;
     mainTimePositionFromBackingTrack(timePosition: number, backingTrackLength: number): number;
     mainTimePositionToBackingTrack(timePosition: number, backingTrackLength: number): number;
     private tickPositionToTimePositionWithSpeed;
@@ -9365,7 +9394,10 @@ declare class MidiSequencerState {
 declare class MidiTickLookup {
     private _currentMasterBar;
     /* Excluded from this release type: masterBarLookup */
-    /* Excluded from this release type: masterBars */
+    /**
+     * A list of all {@link MasterBarTickLookup} sorted by time.
+     */
+    readonly masterBars: MasterBarTickLookup[];
     /**
      * The information about which bars are displayed via multi-bar rests.
      * The key is the start bar, and the value is the additional bars in sequential order.