@coderline/alphatab 1.8.0-alpha.1660 → 1.8.0-alpha.1668

package/dist/alphaTab.d.ts

@@ -4934,11 +4934,24 @@ declare class Beat {
      * Gets or sets the pickstroke applied on this beat.
      */
     pickStroke: PickStroke;
+    /**
+     * Whether this beat has a tremolo picking effect.
+     */
     get isTremolo(): boolean;
     /**
-     * Gets or sets the speed of the tremolo effect.
+     * The tremolo picking effect.
+     */
+    tremoloPicking?: TremoloPickingEffect;
+    /**
+     * The speed of the tremolo.
+     * @deprecated Set {@link tremoloPicking} instead.
      */
-    tremoloSpeed: Duration | null;
+    get tremoloSpeed(): Duration | null;
+    /**
+     * The speed of the tremolo.
+     * @deprecated Set {@link tremoloPicking} instead.
+     */
+    set tremoloSpeed(value: Duration | null);
     /**
      * Gets or sets whether a crescendo/decrescendo is applied on this beat.
      */
@@ -7561,6 +7574,17 @@ export declare class EngravingSettings {
      * in case of multi-voice note head overlaps.
      */
     multiVoiceDisplacedNoteHeadSpacing: number;
+    /**
+     * Calculates the stem height for a note of the given duration.
+     * @param duration The duration to calculate the height respecting flag sizes.
+     * @param hasFlag True if we need to respect flags, false if we have beams.
+     * @returns The total stem height
+     */
+    getStemLength(duration: Duration, hasFlag: boolean): number;
+    /**
+     * The space needed by flags on the stem-side from top to bottom to place.
+     */
+    stemFlagHeight: Map<Duration, number>;
     static readonly bravuraMetadata: SmuflMetadata;
 }
 
@@ -7958,6 +7982,10 @@ declare interface EngravingSettingsJson {
      * in case of multi-voice note head overlaps.
      */
     multiVoiceDisplacedNoteHeadSpacing?: number;
+    /**
+     * The space needed by flags on the stem-side from top to bottom to place.
+     */
+    stemFlagHeight?: Map<Duration | keyof typeof Duration | Lowercase<keyof typeof Duration>, number>;
 }
 
 /**
@@ -8959,7 +8987,7 @@ declare interface IAlphaTexImporterState {
     currentTupletDenominator: number;
     readonly syncPoints: FlatSyncPoint[];
     readonly slurs: Map<string, Note>;
-    readonly percussionArticulationNames: Map<string, number>;
+    readonly percussionArticulationNames: Map<string, string>;
     readonly lyrics: Map<number, Lyrics[]>;
     readonly staffHasExplicitDisplayTransposition: Set<Staff>;
     readonly staffHasExplicitTuning: Set<Staff>;
@@ -9541,6 +9569,16 @@ declare interface ImporterSettingsJson {
  * @public
  */
 declare class InstrumentArticulation {
+    /**
+     * An internal ID to identify this articulation for purposes like
+     * mapping during exports.The exact meaning of the ID is not defined and dependes on the
+     * importer source.
+     */
+    id: number;
+    /**
+     * A unique id for this articulation.
+     */
+    get uniqueId(): string;
     /**
      * Gets or sets the type of the element for which this articulation is for.
      */
@@ -9578,7 +9616,8 @@ declare class InstrumentArticulation {
      * Gets or sets which midi key to use when playing the note.
      */
     outputMidiNumber: number;
-    constructor(elementType?: string, staffLine?: number, outputMidiNumber?: number, noteHeadDefault?: MusicFontSymbol, noteHeadHalf?: MusicFontSymbol, noteHeadWhole?: MusicFontSymbol, techniqueSymbol?: MusicFontSymbol, techniqueSymbolPlacement?: TechniqueSymbolPlacement);
+    constructor(elementType?: string, staffLine?: number, outputMidiNumber?: number, noteHeadDefault?: MusicFontSymbol, noteHeadHalf?: MusicFontSymbol, noteHeadWhole?: MusicFontSymbol, techniqueSymbol?: MusicFontSymbol, techniqueSymbolPlacement?: TechniqueSymbolPlacement, id?: number);
+
     getSymbol(duration: Duration): MusicFontSymbol;
 }
 
@@ -11409,6 +11448,8 @@ export declare namespace model {
         BeatBeamingMode,
         BeatSubElement,
         BeatStyle,
+        TremoloPickingEffect,
+        TremoloPickingStyle,
         BendPoint,
         BendStyle,
         BendType,
@@ -11620,9 +11661,12 @@ declare enum MusicFontSymbol {
     TextTupletBracketStartLongStem = 57857,
     TextTuplet3LongStem = 57858,
     TextTupletBracketEndLongStem = 57859,
-    Tremolo3 = 57890,
-    Tremolo2 = 57889,
     Tremolo1 = 57888,
+    Tremolo2 = 57889,
+    Tremolo3 = 57890,
+    Tremolo4 = 57891,
+    Tremolo5 = 57892,
+    BuzzRoll = 57898,
     Flag8thUp = 57920,
     Flag8thDown = 57921,
     Flag16thUp = 57922,
@@ -15812,6 +15856,53 @@ declare enum TrackSubElement {
     StringTuning = 3
 }
 
+/**
+ * Describes a tremolo picking effect.
+ * @json
+ * @json_strict
+ * @cloneable
+ * @public
+ */
+declare class TremoloPickingEffect {
+    /**
+     * The minimum number of marks for the tremolo picking effect to be valid.
+     */
+    static readonly minMarks = 0;
+    /**
+     * The max number of marks for the tremolo picking effect to be valid.
+     */
+    static readonly maxMarks = 5;
+    /**
+     * The number of marks for the tremolo.
+     * A mark is equal to a single bar shown for a default tremolos.
+     */
+    marks: number;
+    /**
+     * The style of the tremolo picking.
+     */
+    style: TremoloPickingStyle;
+    /**
+     * The number of marks define the note value of the note repetition.
+     * e.g. a single mark is an 8th note.
+     */
+    get duration(): Duration;
+}
+
+/**
+ * The style of tremolo affecting mainly the display of the effect.
+ * @public
+ */
+declare enum TremoloPickingStyle {
+    /**
+     * A classic tremolo expressed by diagonal bars on the stem.
+     */
+    Default = 0,
+    /**
+     * A buzz roll tremolo expressed by a 'z' shaped symbol.
+     */
+    BuzzRoll = 1
+}
+
 /**
  * This public enumeration lists all feels of triplets.
  * @public