@coderline/alphatab 1.3.0-alpha.849 → 1.3.0-alpha.854

package/dist/alphaTab.d.ts

@@ -2399,6 +2399,7 @@ declare class Note {
     get isStringed(): boolean;
     /**
      * Gets or sets the fret on which this note is played on the instrument.
+     * 0 is the nut.
      */
     fret: number;
     /**
@@ -2716,6 +2717,13 @@ declare class Note {
     static getStringTuning(staff: Staff, noteString: number): number;
     get realValue(): number;
     get realValueWithoutHarmonic(): number;
+    /**
+     * Calculates the real note value of this note as midi key respecting the given options.
+     * @param applyTranspositionPitch Whether or not to apply the transposition pitch of the current staff.
+     * @param applyHarmonic Whether or not to apply harmonic pitches to the note.
+     * @returns The calculated note value as midi key.
+     */
+    calculateRealValue(applyTranspositionPitch: boolean, applyHarmonic: boolean): number;
     get harmonicPitch(): number;
     get initialBendValue(): number;
     get displayValue(): number;
@@ -5992,6 +6000,11 @@ interface IAlphaSynth {
      * @param midi
      */
     loadMidiFile(midi: MidiFile): void;
+    /**
+     * Applies the given transposition pitches to be used during playback.
+     * @param transpositionPitches a map defining the transposition pitches for midi channel.
+     */
+    applyTranspositionPitches(transpositionPitches: Map<number, number>): void;
     /**
      * Sets the mute state of a channel.
      * @param channel The channel number
@@ -6817,6 +6830,14 @@ declare class MidiFileGenerator {
      * at a given midi tick position.
      */
     readonly tickLookup: MidiTickLookup;
+    /**
+     * Gets or sets whether transposition pitches should be applied to the individual midi events or not.
+     */
+    applyTranspositionPitches: boolean;
+    /**
+     * Gets the transposition pitches for the individual midi channels.
+     */
+    readonly transpositionPitches: Map<number, number>;
     /**
      * Initializes a new instance of the {@link MidiFileGenerator} class.
      * @param score The score for which the midi file should be generated.
@@ -6830,6 +6851,7 @@ declare class MidiFileGenerator {
     generate(): void;
     private generateTrack;
     private addProgramChange;
+    static buildTranspositionPitches(score: Score, settings: Settings): Map<number, number>;
     private generateChannel;
     private static toChannelShort;
     private generateMasterBar;
@@ -7186,6 +7208,7 @@ declare class AlphaSynth implements IAlphaSynth {
      * @param midi The midi file to load
      */
     loadMidiFile(midi: MidiFile): void;
+    applyTranspositionPitches(transpositionPitches: Map<number, number>): void;
     setChannelMute(channel: number, mute: boolean): void;
     resetChannelStates(): void;
     setChannelSolo(channel: number, solo: boolean): void;
@@ -7300,6 +7323,7 @@ declare class AlphaSynthWebWorkerApi implements IAlphaSynth {
     loadSoundFontFromUrl(url: string, append: boolean, progress: (e: ProgressEventArgs) => void): void;
     resetSoundFonts(): void;
     loadMidiFile(midi: MidiFile): void;
+    applyTranspositionPitches(transpositionPitches: Map<number, number>): void;
     setChannelMute(channel: number, mute: boolean): void;
     resetChannelStates(): void;
     setChannelSolo(channel: number, solo: boolean): void;