@coderline/alphatab 1.3.0-alpha.663 → 1.3.0-alpha.675

package/dist/alphaTab.d.ts

@@ -342,6 +342,19 @@ declare enum StaveProfile {
     TabMixed = 4
 }
 
+/**
+ * Lists the different modes in which the staves and systems are arranged.
+ */
+declare enum SystemsLayoutMode {
+    /**
+     * Use the automatic alignment system provided by alphaTab (default)
+     */
+    Automatic = 0,
+    /**
+     * Use the systems layout and sizing information stored from the score model.
+     */
+    UseModelLayout = 1
+}
 /**
  * The display settings control how the general layout and display of alphaTab is done.
  * @json
@@ -388,6 +401,10 @@ declare class DisplaySettings {
      * Gets or sets the padding between the music notation and the border.
      */
     padding: number[] | null;
+    /**
+     * Gets how the systems should be layed out.
+     */
+    systemsLayoutMode: SystemsLayoutMode;
 }
 
 /**
@@ -1857,6 +1874,16 @@ declare class Track {
      * Gets or sets the short name of this track.
      */
     shortName: string;
+    /**
+     * Defines how many bars are placed into the systems (rows) when displaying
+     * the track unless a value is set in the systemsLayout.
+     */
+    defaultSystemsLayout: number;
+    /**
+     * Defines how many bars are placed into the systems (rows) when displaying
+     * the track.
+     */
+    systemsLayout: number[];
     /**
      * Gets or sets a mapping on which staff liens particular percussion instruments
      * should be shown.
@@ -1937,6 +1964,16 @@ declare class Score {
      * @json_add addTrack
      */
     tracks: Track[];
+    /**
+     * Defines how many bars are placed into the systems (rows) when displaying
+     * multiple tracks unless a value is set in the systemsLayout.
+     */
+    defaultSystemsLayout: number;
+    /**
+     * Defines how many bars are placed into the systems (rows) when displaying
+     * multiple tracks.
+     */
+    systemsLayout: number[];
     /**
      * Gets or sets the rendering stylesheet for this song.
      */
@@ -2100,6 +2137,14 @@ declare class MasterBar {
      * Gets or sets a value indicating whether the master bar is an anacrusis (aka. pickup bar)
      */
     isAnacrusis: boolean;
+    /**
+     * Gets a percentual scale for the size of the bars when displayed in a multi-track layout.
+     */
+    displayScale: number;
+    /**
+     * An absolute width of the bar to use when displaying in a multi-track layout.
+     */
+    displayWidth: number;
     /**
      * Calculates the time spent in this bar. (unit: midi ticks)
      */
@@ -2262,6 +2307,16 @@ declare class Bar {
      * @json_ignore
      */
     isMultiVoice: boolean;
+    /**
+     * A relative scale for the size of the bar when displayed. The scale is relative
+     * within a single line (system/stave group). The sum of all scales in one line make the total width,
+     * and then this individual scale gives the relative size.
+     */
+    displayScale: number;
+    /**
+     * An absolute width of the bar to use when displaying in single track display scenarios.
+     */
+    displayWidth: number;
     get masterBar(): MasterBar;
     get isEmpty(): boolean;
     addVoice(voice: Voice): void;
@@ -6250,6 +6305,8 @@ declare class StaveGroup {
      * The width that the content bars actually need
      */
     width: number;
+    computedWidth: number;
+    totalBarDisplayScale: number;
     isLast: boolean;
     masterBarsRenderers: MasterBarsRenderers[];
     staves: StaveTrackGroup[];
@@ -6259,7 +6316,7 @@ declare class StaveGroup {
     addMasterBarRenderers(tracks: Track[], renderers: MasterBarsRenderers): MasterBarsRenderers | null;
     addBars(tracks: Track[], barIndex: number): MasterBarsRenderers | null;
     revertLastBar(): MasterBarsRenderers | null;
-    updateWidth(): number;
+    private updateWidthFromLastBar;
     private calculateAccoladeSpacing;
     private getStaveTrackGroup;
     addStaff(track: Track, staff: RenderStaff): void;
@@ -6425,6 +6482,7 @@ declare class BarRendererBase {
     x: number;
     y: number;
     width: number;
+    computedWidth: number;
     height: number;
     index: number;
     topOverflow: number;
@@ -6450,6 +6508,16 @@ declare class BarRendererBase {
     get resources(): RenderingResources;
     get settings(): Settings;
     get scale(): number;
+    /**
+     * Gets the scale with which the bar should be displayed in case the model
+     * scale should be respected.
+     */
+    get barDisplayScale(): number;
+    /**
+     * Gets the absolute width in which the bar should be displayed in case the model
+     * scale should be respected.
+     */
+    get barDisplayWidth(): number;
     private _wasFirstOfLine;
     get isFirstOfLine(): boolean;
     get isLast(): boolean;
@@ -6546,6 +6614,23 @@ declare class TuningContainerGlyph extends RowContainerGlyph {
     addTuning(tuning: Tuning, trackLabel: string): void;
 }
 
+/**
+ * Lists the different modes in which the staves and systems are arranged.
+ */
+declare enum InternalSystemsLayoutMode {
+    /**
+     * Use the automatic alignment system provided by alphaTab (default)
+     */
+    Automatic = 0,
+    /**
+     * Use the relative scaling information stored in the score model.
+     */
+    FromModelWithScale = 1,
+    /**
+     * Use the absolute size information stored in the score model.
+     */
+    FromModelWithWidths = 2
+}
 /**
  * This is the base class for creating new layouting engines for the score renderer.
  */
@@ -6558,6 +6643,7 @@ declare abstract class ScoreLayout {
     protected scoreInfoGlyphs: Map<NotationElement, TextGlyph>;
     protected chordDiagrams: ChordDiagramContainerGlyph | null;
     protected tuningGlyph: TuningContainerGlyph | null;
+    systemsLayoutMode: InternalSystemsLayoutMode;
     protected constructor(renderer: ScoreRenderer);
     abstract get firstBarX(): number;
     abstract get supportsResize(): boolean;
@@ -7027,4 +7113,4 @@ declare namespace index_d {
   };
 }
 
-export { AlphaTabApi, AlphaTabError, AlphaTabErrorType, CoreSettings, DisplaySettings, FileLoadError, FingeringMode, FormatError, ImporterSettings, LayoutMode, LogLevel, Logger, NotationMode, NotationSettings, PlayerSettings, ProgressEventArgs, RenderingResources, ResizeEventArgs, ScrollMode, Settings, StaveProfile, TabRhythmMode, VibratoPlaybackSettings, index_d$4 as exporter, index_d$5 as importer, VersionInfo as meta, index_d$3 as midi, index_d$2 as model, index_d$1 as rendering, index_d as synth };
+export { AlphaTabApi, AlphaTabError, AlphaTabErrorType, CoreSettings, DisplaySettings, FileLoadError, FingeringMode, FormatError, ImporterSettings, LayoutMode, LogLevel, Logger, NotationMode, NotationSettings, PlayerSettings, ProgressEventArgs, RenderingResources, ResizeEventArgs, ScrollMode, Settings, StaveProfile, SystemsLayoutMode, TabRhythmMode, VibratoPlaybackSettings, index_d$4 as exporter, index_d$5 as importer, VersionInfo as meta, index_d$3 as midi, index_d$2 as model, index_d$1 as rendering, index_d as synth };