Skip to main content

display.lastSystemFillThreshold

since 1.9.0
display.lastSystemFillThresholdJavaScriptlastSystemFillThresholdJavaScriptdisplay.lastSystemFillThresholdJSONlastSystemFillThresholdJSONDisplay.LastSystemFillThreshold.netdisplay.lastSystemFillThresholdAndroid

The minimum fullness ratio at which the last system in a flow is justified to fill the available staff width. The "fullness" of a system is its natural unjustified width divided by the available staff width. The last system is stretched to full width only when its fullness is greater than or equal to this threshold; otherwise it renders at its natural width.

Following industry convention (Dorico, MuseScore), a sparsely populated final system looks better compact than spread across the full page. The threshold lets users tune where that boundary sits.

Common values:

  • 1 (default) — never justify the last system. Equivalent to the legacy justifyLastSystem = false behaviour.
  • 0 — always justify the last system, even when sparse. Equivalent to the legacy justifyLastSystem = true behaviour.
  • 0.4–0.7 — Dorico/MuseScore-style: justify when the last system is reasonably full, leave compact when only a few bars trail.

The threshold is bypassed when the last system is naturally wider than the available staff width - in that case the system still compresses to fit, since otherwise content would overflow horizontally.

Values outside [0, 1] are clamped.

lastSystemFillThreshold: number = 1;