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 drawPage() for each system from LazyDrawSystemWindows; reset after.

    LazyDrawSystemsFromIndex: number = -1

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

    LazyDrawSystemsToIndexExcl: number = Number.POSITIVE_INFINITY
    LazyDrawSystemWindows: Map<MusicSystem, { fromX: number; toX: number }> = undefined

    Lazy horizontal rendering: when set, drawPage() draws only the systems in this map, each with its own draw x-window (see LazyDrawFromXUnits): a batch can reach several systems, e.g. after forced system breaks. Set by OpenSheetMusicDisplay.renderAppendGrowingHorizontal() per batch; reset after.

    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, and to the labels of a measure's staff entries (see VexFlowMusicSheetDrawer.drawMeasure()), which are drawn with their measure.

    LazySkipPageLabels: boolean = false

    Lazy horizontal rendering: when true, drawPage() skips the page-level labels (title/credits) and the bounding boxes (see drawableBoundingBoxElement). They are drawn once, on the final batch, when the page is drawn to its full width.

    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

    • Draws the lyric lines (extenders, e.g. "dich___") of a staff line. They are positioned relative to the staff line (see MusicSheetCalculator.calculateLyricExtend()), because the staff lines are spaced vertically only after the lyrics are positioned. They are drawn at their absolute position without changing them, so that drawing the laid-out sheet again (e.g. in an incremental render) draws them at the same position.

      Parameters

      • lyricLines: GraphicalLine[]

        the lyric lines of the staff line

      • staffLine: StaffLine

        the staff line the lyric lines are positioned relative to

      Returns void

    • 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 system elements (instrument braces and group brackets at the left edge, and the sky and bottom lines of the stafflines, see skyLineVisible). True for non-lazy and for a system's first lazy-horizontal batch, which owns its left edge (LazyDrawFromXUnits is -Infinity); false for continuation batches, so a system'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

    • Lazy rendering: whether drawPage() draws the system with the given index (see LazyDrawSystemsFromIndex).

      Parameters

      • systemIndex: number

        the index of the system, counted through the systems of all pages

      Returns boolean

      true if the system is in the draw range of the batch, or if the render isn't lazy