@coderline/alphatab 1.8.0-alpha.1656 → 1.8.0-alpha.1667

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.
+     */
+    get tremoloSpeed(): Duration | null;
+    /**
+     * The speed of the tremolo.
+     * @deprecated Set {@link tremoloPicking} instead.
      */
-    tremoloSpeed: Duration | null;
+    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>;
 }
 
 /**
@@ -11409,6 +11437,8 @@ export declare namespace model {
         BeatBeamingMode,
         BeatSubElement,
         BeatStyle,
+        TremoloPickingEffect,
+        TremoloPickingStyle,
         BendPoint,
         BendStyle,
         BendType,
@@ -11620,9 +11650,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 +15845,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