OpenSheetMusicDisplay
    Preparing search index...

    Class MusicSheetDrawerAbstract

    Draw a [[GraphicalMusicSheet]] (through the .drawSheet method)

    The drawing is implemented with a top-down approach, starting from a music sheet, going through pages, systems, staffs... ... and ending in notes, beams, accidentals and other symbols. It's worth to say, that this class just draws the symbols and graphical elements, using the positions that have been computed before. But in any case, some of these previous positioning algorithms need the sizes of the concrete symbols (NoteHeads, sharps, flats, keys...). Therefore, there are some static functions on the 'Bounding Boxes' section used to compute these symbol boxes at the beginning for the later use in positioning algorithms.

    This class also includes the resizing and positioning of the symbols due to user interaction like zooming or panning.

    Hierarchy (View Summary)

    Index

    Constructors

    Properties

    bottomLineVisible: boolean = false
    drawableBoundingBoxElement: string = "None"
    drawingParameters: DrawingParameters
    graphicalMusicSheet: GraphicalMusicSheet
    LazyDrawFromXUnits: number = Number.NEGATIVE_INFINITY

    Lazy horizontal rendering (RenderSingleHorizontalStaffline): draw only graphical objects whose right edge x (in OSMD units) lies in (LazyDrawFromXUnits, LazyDrawToXUnits] -- the measures and spanning elements that first entered the drawn frontier this batch. ±Infinity (default) draws everything. Set by OpenSheetMusicDisplay.renderAppendGrowingHorizontal() per batch; reset after.

    LazyDrawSystemsFromIndex: number = -1

    Lazy rendering: when >= 0, drawPage() draws only the systems of (the first) page whose index is within [LazyDrawSystemsFromIndex, LazyDrawSystemsToIndexExcl), leaving the already-drawn systems above untouched in the shared backend. -1 (default) draws every system. Set by OpenSheetMusicDisplay.renderAppend() before each appended batch; reset to -1 after.

    LazyDrawSystemsToIndexExcl: number = Number.POSITIVE_INFINITY
    LazyDrawToXUnits: number = Number.POSITIVE_INFINITY
    LazyForcePageLabels: boolean = false

    Lazy horizontal rendering: when true, drawLabel() ignores the x-window gate. Scoped (set/restored) to the page-label loop in drawPage(), since those labels span the full page width and must all be drawn even though their left edges lie behind the final batch's frontier.

    LazySkipPageLabels: boolean = false

    Lazy horizontal rendering: when true, drawPage() skips the page-level labels (title/credits). They are drawn once, on the final batch, when the page has reached its full width and they sit at their final (re-centered) positions -- drawing them earlier would place them under a still-growing page.

    midiPlaybackAvailable: boolean
    skyLineVisible: boolean = false
    splitScreenLineColor: number
    textMeasurer: ITextMeasurer

    Accessors

    Methods

    • Parameters

      • bbox: BoundingBox
      • color: string = undefined
      • drawCross: boolean = false
      • labelText: string = undefined
      • layer: number = 0

      Returns Node

    • Lazy horizontal rendering: whether an object with this bounding box falls in the current draw x-window (its right edge first entered the drawn frontier this batch). True when not lazy-horizontal.

      Parameters

      • rightXUnits: number

      Returns boolean

    • Lazy horizontal rendering: whether to draw the once-only left-edge system elements (instrument braces and group brackets). True for non-lazy and for the first lazy-horizontal batch, which owns the left edge (LazyDrawFromXUnits is -Infinity); false for continuation batches, so a single-system score's brace isn't redrawn on top of itself every batch. (Vertical lazy keeps the x-window at ±Infinity and draws each system's brace once via the per-system gate, so this stays true there.)

      Returns boolean