engravingDefaults
The "engravingDefaults" structure contains key/value pairs defining recommended defaults for line widths etc., as follows, with all measurements expressed in staff spaces:
| Key name | Description |
|---|---|
| "textFontFamily" | An array containing the text font family (or families, in descending order of preference) that are ideally paired with this music font; this list may also use the generic font family values defined in CSS, i.e. serif, sans-serif, cursive, fantasy, and monospace. Generic font family names should be listed after specific font families. |
| "staffLineThickness" | The thickness of each staff line |
| "stemThickness" | The thickness of a stem |
| "beamThickness" | The thickness of a beam |
| "beamSpacing" | The distance between the inner edge of the primary and outer edge of subsequent secondary beams |
| "legerLineThickness" | The thickness of a leger line (normally somewhat thicker than a staff line) |
| "legerLineExtension" | The amount by which a leger line should extend either side of a notehead, scaled proportionally with the notehead's size, e.g. when scaled down as a grace note |
| "slurEndpointThickness" | The thickness of the end of a slur |
| "slurMidpointThickness" | The thickness of the mid-point of a slur (i.e. its thickest point) |
| "tieEndpointThickness" | The thickness of the end of a tie |
| "tieMidpointThickness" | The thickness of the mid-point of a tie |
| "thinBarlineThickness" | The thickness of a thin barline, e.g. a normal barline, or each of the lines of a double barline |
| "thickBarlineThickness" | The thickness of a thick barline, e.g. in a final barline or a repeat barline |
| "dashedBarlineThickness" | The thickness of a dashed barline |
| "dashedBarlineDashLength" | The length of the dashes to be used in a dashed barline |
| "dashedBarlineGapLength" | The length of the gap between dashes in a dashed barline |
| "barlineSeparation" | The default distance between multiple thin barlines when locked together, e.g. between two thin barlines making a double barline, measured from the right-hand edge of the left barline to the left-hand edge of the right barline. |
| "thinThickBarlineSeparation" | The default distance between a pair of thin and thick barlines when locked together, e.g. between the thin and thick barlines making a final barline, or between the thick and thin barlines making a start repeat barline. |
| "repeatBarlineDotSeparation" | The default horizontal distance between the dots and the inner barline of a repeat barline, measured from the edge of the dots to the edge of the barline. |
| "bracketThickness" | The thickness of the vertical line of a bracket grouping staves together |
| "subBracketThickness" | The thickness of the vertical line of a sub-bracket grouping staves belonging to the same instrument together |
| "hairpinThickness" | The thickness of a crescendo/diminuendo hairpin |
| "octaveLineThickness" | The thickness of the dashed line used for an octave line |
| "pedalLineThickness" | The thickness of the line used for piano pedaling |
| "repeatEndingLineThickness" | The thickness of the brackets drawn to indicate repeat endings |
| "arrowShaftThickness" | The thickness of the line used for the shaft of an arrow |
| "lyricLineThickness" | The thickness of the lyric extension line to indicate a melisma in vocal music |
| "textEnclosureThickness" | The thickness of a box drawn around text instructions (e.g. rehearsal marks) |
| "tupletBracketThickness" | The thickness of the brackets drawn either side of tuplet numbers |
| "hBarThickness" | The thickness of the horizontal line drawn between two vertical lines, known as the H-bar, in a multi-bar rest |
Below is a dummy "engravingDefaults" structure, with some of the values filled in:
{
...
"engravingDefaults": {
"textFontFamily" : [ "Academico", "Century Schoolbook", "serif" ],
"staffLineThickness": 0.1,
"stemThickness": 0.1,
"beamThickness": 0.5,
"beamSpacing": 0.25,
"legerLineThickness": 0.2,
"legerLineExtension": 0.2,
...
},
...
}