OptionalsourceMeasure: SourceMeasureOptionalstaffLine: StaffLineThe x-width of possibly existing: repetition start line, clef, key, rhythm.
ProtectedboundingProtectedconnectorsVexFlow StaveConnectors (vertical lines)
The x-width of possibly existing: repetition end line, clef.
ProtectedfirstOptionalformatCall this function (if present) to x-format all the voices in the measure
Whether a metronome mark is drawn on this staff measure (they are drawn on the first visible staff).
Whether or not this measure is nothing but rest(s). Also see SourceMeasure.allRests, which is not the same, because a source measure can have multiple staffs/graphicalMeasures.
The clef of the first note of the measure (the clef the measure starts with).
Used to show key, rhythm changes at the end of the system, has MeasureNumber < 0, because never set.
ProtectedlastRepeat unit drawn in place of this measure's note content, if any.
The minimum possible x-width of all staff entries without overlapping.
Only exists on multiple rest measure (VexFlowMultiRestMeasure). See isMultiRestMeasure() function.
octaveOffset according to active clef
Will be set by music system builder while building systems.
ProtectedstaveThe VexFlow Stave (= one measure in a staffline)
ProtectedtupletsIntermediate object to construct tuplets
The repetition instructions given as words or symbols (coda, dal segno..)
The VexFlow Ties in the measure
The VexFlow Voices in the measure
Whether a backend replaces this measure's note content with a repeat sign.
adds the given clef to the begin of the measure. This has to update/increase BeginInstructionsWidth.
adds the given clef to the end of the measure. This has to update/increase EndInstructionsWidth.
Add a [[StaffEntry]] (along with its [[BoundingBox]]) to the current Measure.
adds the given key to the begin of the measure. This has to update/increase BeginInstructionsWidth.
the new valid key.
the old cancelled key. Needed to show which accidentals are not valid any more.
the valid clef. Needed to put the accidentals on the right y-positions.
Adds a measure number to the top left corner of the measure This method is not used currently in favor of the calculateMeasureNumberPlacement method in the MusicSheetCalculator.ts
adds the given rhythm to the begin of the measure. This has to update/increase BeginInstructionsWidth.
ProtectedaddAdds a repetition instruction (e.g. Segno, D.S. al Fine) as a VexFlow StaveRepetition to the measure's stave (or as a Volta for endings).
the instruction to add
the created VF.Repetition, or undefined if a volta (ending) was added instead
Check if a Repetition starts at the next Measure.
Places each note at the height of its drawn note head, relative to its voice entry, e.g. where a click finds it (GraphicalMusicSheet.GetNearestNote()). A voice entry is at the top of its Vexflow note's bounding box (see VexFlowVoiceEntry.applyBordersFromVexflow()), e.g. the stem tip of a note with its stem up, and stems differ in length: the stems of grace notes and cue notes are shorter, those of 32nd notes longer. A note's x: see VexFlowStaffEntry.calculateXPosition(). Called at the end of draw() (note.setIndex() needs to have been called).
ProtectedcreateCreate the articulations for all notes of the current staff entry
ProtectedcreateCreates vexflow fingering elements. Note that this is currently only used for Left and Right fingering positions, not Above and Below, in which case they are instead added via MusicSheetCalculator.calculateFingerings() as Labels with bounding boxes.
ProtectedcreateProtectedcreateCreate the ornaments for all notes of the current staff entry
ProtectedcreateDraw this measure on a VexFlow CanvasContext
Check if this Measure is a Repetition Ending.
Check if this Measure is a Repetition Ending.
Complete the creation of VexFlow Beams in this measure
Complete the creation of VexFlow Tuplets in this measure
Iterate from start to end and find the [[GraphicalStaffEntry]] with the same absolute timestamp.
Formats the voices of this measure's vertical measure, i.e. of all its staves (see VexFlowMusicSheetCalculator.formatMeasures()), to the width of this measure's stave.
OptionallastFormats: Map<SourceMeasure, IVerticalMeasureFormat>For a series of formats, like the skyline calculation's (see SkyBottomLineCalculator), which formats every measure, and so each vertical measure once per staff: the last format of each vertical measure in the series. A format that would just repeat the last one of its vertical measure is skipped: it would compute the same result again (see isRepeatedFormat()). Without lastFormats, the measure is always formatted.
Returns all the graphicalVoiceEntries of a given Voice.
the voice for which the graphicalVoiceEntries shall be returned.
returns the x-width (in units) of a given measure line {SystemLinesEnum}.
the x-width in osmd units
ProtectedgetFinds the gaps between the existing notes within a measure. Problem here is, that the graphicalVoiceEntry does not exist yet and that Tied notes are not present in the normal voiceEntries. To handle this, calculation with absolute timestamps is needed. And the graphical notes have to be analysed directly (and not the voiceEntries, as it actually should be -> needs refactoring)
the voice for which the ghost notes shall be searched.
Return the VexFlow Stave corresponding to this graphicalMeasure
Returns all the voices that are present in this measure
Check a whole [[Measure]] for the presence of multiple Voices (used for Stem direction).
Check if the all the [[GraphicalMeasure]]'s [[StaffEntry]]s (their minimum Length) have the same duration with the [[SourceMeasure]].
Returns whether this object is an instance of the class, e.g. isInstanceOfClass(GraphicalMeasure).
The class, or its name (e.g. GraphicalMeasure.name). A name is unreliable in minified builds: they rename the classes, and give different classes the same name, e.g. "a" to GraphicalMeasure and GraphicalNote.
This method is called after the StaffEntriesScaleFactor has been set. Here the final x-positions of the staff entries have to be set. (multiply the minimal positions with the scaling factor, considering the BeginInstructionsWidth)
Creates a line from 'top' to this measure, of type 'lineType'
Reset all the geometric values and parameters of this measure and put it in an initialized state. This is needed to evaluate a measure a second time by system builder.
Sets the number of stafflines that are rendered, so that they are centered properly
Set the x-position relative to the staffline (y-Position is always 0 relative to the staffline).
Sets the overall x-width of the measure.
ProtectedupdateAfter re-running the formatting on the VexFlow Stave, update the space needed by Instructions (in VexFlow: StaveModifiers)
Represents a measure in the music sheet (one measure in one staff line)