@coderline/alphatab 1.3.0-alpha.194 → 1.3.0-alpha.206

package/dist/alphaTab.d.ts

@@ -869,6 +869,12 @@ declare class PlayerSettings {
      * Gets or sets whether the triplet feel should be applied/played during audio playback.
      */
     playTripletFeel: boolean;
+    /**
+     * Gets or sets how many milliseconds of audio samples should be buffered in total.
+     * Larger buffers cause a delay from when audio settings like volumes will be applied.
+     * Smaller buffers can cause audio crackling due to constant buffering that is happening.
+     */
+    bufferTimeInMilliseconds: number;
 }
 
 /**
@@ -3805,6 +3811,21 @@ declare class PlayerStateChangedEventArgs {
     constructor(state: PlayerState, stopped: boolean);
 }
 
+/**
+ * Represents the info when the playback range changed.
+ */
+declare class PlaybackRangeChangedEventArgs {
+    /**
+     * The new playback range.
+     */
+    readonly playbackRange: PlaybackRange | null;
+    /**
+     * Initializes a new instance of the {@link PlaybackRangeChangedEventArgs} class.
+     * @param range The range.
+     */
+    constructor(playbackRange: PlaybackRange | null);
+}
+
 /**
  * Represents the info when the time in the synthesizer changes.
  */
@@ -4028,6 +4049,10 @@ interface IAlphaSynth {
      * The event is fired when certain midi events were sent to the audio output device for playback.
      */
     readonly midiEventsPlayed: IEventEmitterOfT<MidiEventsPlayedEventArgs>;
+    /**
+     * The event is fired when the playback range within the player was updated.
+     */
+    readonly playbackRangeChanged: IEventEmitterOfT<PlaybackRangeChangedEventArgs>;
 }
 
 /**
@@ -4442,11 +4467,6 @@ declare class BoundsLookup {
      * Finishes the lookup for optimized access.
      */
     finish(): void;
-    /**
-     * Adds a new note to the lookup.
-     * @param bounds The note bounds to add.
-     */
-    addNote(bounds: NoteBounds): void;
     /**
      * Adds a new stave group to the lookup.
      * @param bounds The stave group bounds to add.
@@ -4480,6 +4500,12 @@ declare class BoundsLookup {
      * @returns The beat bounds if it was rendered, or null if no boundary information is available.
      */
     findBeat(beat: Beat): BeatBounds | null;
+    /**
+     * Tries to find the bounds of a given beat.
+     * @param beat The beat to find.
+     * @returns The beat bounds if it was rendered, or null if no boundary information is available.
+     */
+    findBeats(beat: Beat): BeatBounds[] | null;
     /**
      * Tries to find a beat at the given absolute position.
      * @param x The absolute X-position of the beat to find.
@@ -4927,14 +4953,21 @@ declare class AlphaTabApiBase<TSettings> {
     playedBeatChanged: IEventEmitterOfT<Beat>;
     private onPlayedBeatChanged;
     private _beatMouseDown;
+    private _noteMouseDown;
     private _selectionStart;
     private _selectionEnd;
     beatMouseDown: IEventEmitterOfT<Beat>;
     beatMouseMove: IEventEmitterOfT<Beat>;
     beatMouseUp: IEventEmitterOfT<Beat | null>;
+    noteMouseDown: IEventEmitterOfT<Note>;
+    noteMouseMove: IEventEmitterOfT<Note>;
+    noteMouseUp: IEventEmitterOfT<Note | null>;
     private onBeatMouseDown;
+    private onNoteMouseDown;
     private onBeatMouseMove;
+    private onNoteMouseMove;
     private onBeatMouseUp;
+    private onNoteMouseUp;
     private updateSelectionCursor;
     private setupClickHandling;
     private cursorSelectRange;
@@ -4966,6 +4999,8 @@ declare class AlphaTabApiBase<TSettings> {
     private onPlayerPositionChanged;
     midiEventsPlayed: IEventEmitterOfT<MidiEventsPlayedEventArgs>;
     private onMidiEventsPlayed;
+    playbackRangeChanged: IEventEmitterOfT<PlaybackRangeChangedEventArgs>;
+    private onPlaybackRangeChanged;
 }
 
 /**
@@ -6568,7 +6603,7 @@ interface ISynthOutput {
     /**
      * Called when the output should be opened.
      */
-    open(): void;
+    open(bufferTimeInMilliseconds: number): void;
     /**
      * Called when the output should start the playback.
      */
@@ -6623,6 +6658,7 @@ declare class AlphaSynth implements IAlphaSynth {
     private _countInVolume;
     private _playedEventsQueue;
     private _midiEventsPlayedFilter;
+    private _notPlayedSamples;
     /**
      * Gets the {@link ISynthOutput} used for playing the generated samples.
      */
@@ -6655,7 +6691,7 @@ declare class AlphaSynth implements IAlphaSynth {
      * Initializes a new instance of the {@link AlphaSynth} class.
      * @param output The output to use for playing the generated samples.
      */
-    constructor(output: ISynthOutput);
+    constructor(output: ISynthOutput, bufferTimeInMilliseconds: number);
     play(): boolean;
     private playInternal;
     pause(): void;
@@ -6674,9 +6710,9 @@ declare class AlphaSynth implements IAlphaSynth {
     resetChannelStates(): void;
     setChannelSolo(channel: number, solo: boolean): void;
     setChannelVolume(channel: number, volume: number): void;
-    private onAudioSettingsUpdate;
     private onSamplesPlayed;
     private checkForFinish;
+    private stopOneTimeMidi;
     private updateTimePosition;
     readonly ready: IEventEmitter;
     readonly readyForPlayback: IEventEmitter;
@@ -6688,6 +6724,7 @@ declare class AlphaSynth implements IAlphaSynth {
     readonly stateChanged: IEventEmitterOfT<PlayerStateChangedEventArgs>;
     readonly positionChanged: IEventEmitterOfT<PositionChangedEventArgs>;
     readonly midiEventsPlayed: IEventEmitterOfT<MidiEventsPlayedEventArgs>;
+    readonly playbackRangeChanged: IEventEmitterOfT<PlaybackRangeChangedEventArgs>;
 }
 
 /**
@@ -6733,7 +6770,7 @@ declare class AlphaSynthWebWorkerApi implements IAlphaSynth {
     set isLooping(value: boolean);
     get playbackRange(): PlaybackRange | null;
     set playbackRange(value: PlaybackRange | null);
-    constructor(player: ISynthOutput, alphaSynthScriptFile: string, logLevel: LogLevel);
+    constructor(player: ISynthOutput, alphaSynthScriptFile: string, logLevel: LogLevel, bufferTimeInMilliseconds: number);
     destroy(): void;
     play(): boolean;
     pause(): void;
@@ -6761,6 +6798,7 @@ declare class AlphaSynthWebWorkerApi implements IAlphaSynth {
     readonly stateChanged: IEventEmitterOfT<PlayerStateChangedEventArgs>;
     readonly positionChanged: IEventEmitterOfT<PositionChangedEventArgs>;
     readonly midiEventsPlayed: IEventEmitterOfT<MidiEventsPlayedEventArgs>;
+    readonly playbackRangeChanged: IEventEmitterOfT<PlaybackRangeChangedEventArgs>;
     onOutputSampleRequest(): void;
     onOutputSamplesPlayed(samples: number): void;
     private onOutputReady;
@@ -6774,6 +6812,8 @@ type index_d_PlayerState = PlayerState;
 declare const index_d_PlayerState: typeof PlayerState;
 type index_d_PlayerStateChangedEventArgs = PlayerStateChangedEventArgs;
 declare const index_d_PlayerStateChangedEventArgs: typeof PlayerStateChangedEventArgs;
+type index_d_PlaybackRangeChangedEventArgs = PlaybackRangeChangedEventArgs;
+declare const index_d_PlaybackRangeChangedEventArgs: typeof PlaybackRangeChangedEventArgs;
 type index_d_PositionChangedEventArgs = PositionChangedEventArgs;
 declare const index_d_PositionChangedEventArgs: typeof PositionChangedEventArgs;
 type index_d_AlphaSynthWebWorkerApi = AlphaSynthWebWorkerApi;
@@ -6784,6 +6824,7 @@ declare namespace index_d {
     index_d_PlaybackRange as PlaybackRange,
     index_d_PlayerState as PlayerState,
     index_d_PlayerStateChangedEventArgs as PlayerStateChangedEventArgs,
+    index_d_PlaybackRangeChangedEventArgs as PlaybackRangeChangedEventArgs,
     index_d_PositionChangedEventArgs as PositionChangedEventArgs,
     index_d_AlphaSynthWebWorkerApi as AlphaSynthWebWorkerApi,
   };