| [ << Translation ] | [Top][Contents][Index] | [ Backend >> ] |
| [ < Devnull ] | [ Up : Contexts ] | [ DrumVoice > ] |
2.1.5 DrumStaff
Handles typesetting for percussion.
This context also accepts commands for the following context(s):
Staff.
This context creates the following layout object(s):
BarLine, BassFigure, BassFigureAlignment, BassFigureAlignmentPositioning, BassFigureBracket, BassFigureContinuation, BassFigureLine, Clef, ClefModifier, CueClef, CueEndClef, DotColumn, FingeringColumn, InstrumentName, LedgerLineSpanner, NoteCollision, RestCollision, ScriptRow, SostenutoPedalLineSpanner, StaffSpacing, StaffSymbol, SustainPedalLineSpanner, TimeSignature, UnaCordaPedalLineSpanner and VerticalAxisGroup.
This context sets the following properties:
- Set grob-property
staff-paddingin Script to0.75. - Set translator property
clefGlyphto"clefs.percussion". - Set translator property
clefPositionto0. - Set translator property
createSpacingto#t. - Set translator property
ignoreFiguredBassRestto#f. - Set translator property
instrumentNameto'(). - Set translator property
localAlterationsto'(). - Set translator property
ottavationMarkupsto:'((4 . "29") (3 . "22") (2 . "15") (1 . "8") (-1 . "8") (-2 . "15") (-3 . "22") (-4 . "29"))
- Set translator property
shortInstrumentNameto'().
This is not a ‘Bottom’ context; search for such a one will commence after creating an implicit context of type DrumVoice.
Context DrumStaff can contain CueVoice, DrumVoice and NullVoice.
This context is built from the following engraver(s):
Axis_group_engraverGroup all objects created in this context in a
VerticalAxisGroupspanner.Properties (read)
currentCommandColumn(graphical (layout) object)Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
hasAxisGroup(boolean)True if the current context is contained in an axis group.
keepAliveInterfaces(list)A list of symbols, signifying grob interfaces that are worth keeping a staff with
remove-emptyset around for.Properties (write)
hasAxisGroup(boolean)True if the current context is contained in an axis group.
This engraver creates the following layout object(s):
Bar_engraverCreate barlines. This engraver is controlled through the
whichBarproperty. If it has no bar line to create, it will forbid a linebreak at this point. This engraver is required to trigger the creation of clefs at the start of systems.Properties (read)
whichBar(string)This property is read to determine what type of bar line to create.
Example:
\set Staff.whichBar = ".|:"This will create a start-repeat bar in this staff only. Valid values are described in ‘scm/bar-line.scm’.
Properties (write)
forbidBreak(boolean)If set to
#t, prevent a line break at this point.This engraver creates the following layout object(s):
Clef_engraverDetermine and set reference point for pitches.
Properties (read)
clefGlyph(string)Name of the symbol within the music font.
clefPosition(number)Where should the center of the clef symbol go, measured in half staff spaces from the center of the staff.
clefTransposition(integer)Add this much extra transposition. Values of 7 and -7 are common.
clefTranspositionStyle(symbol)Determines the way the ClefModifier grob is displayed. Possible values are ‘default’, ‘parenthesized’ and ‘bracketed’.
explicitClefVisibility(vector)‘break-visibility’ function for clef changes.
forceClef(boolean)Show clef symbol, even if it has not changed. Only active for the first clef after the property is set, not for the full staff.
This engraver creates the following layout object(s):
Clef and ClefModifier.
Collision_engraverCollect
NoteColumns, and as soon as there are two or more, put them in aNoteCollisionobject.This engraver creates the following layout object(s):
Cue_clef_engraverDetermine and set reference point for pitches in cued voices.
Properties (read)
clefTransposition(integer)Add this much extra transposition. Values of 7 and -7 are common.
cueClefGlyph(string)Name of the symbol within the music font.
cueClefPosition(number)Where should the center of the clef symbol go, measured in half staff spaces from the center of the staff.
cueClefTransposition(integer)Add this much extra transposition. Values of 7 and -7 are common.
cueClefTranspositionStyle(symbol)Determines the way the ClefModifier grob is displayed. Possible values are ‘default’, ‘parenthesized’ and ‘bracketed’.
explicitCueClefVisibility(vector)‘break-visibility’ function for cue clef changes.
middleCCuePosition(number)The position of the middle C, as determined only by the clef of the cue notes. This can be calculated by looking at
cueClefPositionandcueClefGlyph.This engraver creates the following layout object(s):
ClefModifier, CueClef and CueEndClef.
Dot_column_engraverEngrave dots on dotted notes shifted to the right of the note. If omitted, then dots appear on top of the notes.
This engraver creates the following layout object(s):
Figured_bass_engraverMake figured bass numbers.
Music types accepted:
bass-figure-event and rest-event
Properties (read)
figuredBassAlterationDirection(direction)Where to put alterations relative to the main figure.
figuredBassCenterContinuations(boolean)Whether to vertically center pairs of extender lines. This does not work with three or more lines.
figuredBassFormatter(procedure)A routine generating a markup for a bass figure.
ignoreFiguredBassRest(boolean)Don’t swallow rest events.
implicitBassFigures(list)A list of bass figures that are not printed as numbers, but only as extender lines.
useBassFigureExtenders(boolean)Whether to use extender lines for repeated bass figures.
This engraver creates the following layout object(s):
BassFigure, BassFigureAlignment, BassFigureBracket, BassFigureContinuation and BassFigureLine.
Figured_bass_position_engraverPosition figured bass alignments over notes.
This engraver creates the following layout object(s):
Fingering_column_engraverFind potentially colliding scripts and put them into a
FingeringColumnobject; that will fix the collisions.This engraver creates the following layout object(s):
Font_size_engraverPut
fontSizeintofont-sizegrob property.Properties (read)
fontSize(number)The relative size of all grobs in a context.
Grob_pq_engraverAdministrate when certain grobs (e.g., note heads) stop playing.
Properties (read)
busyGrobs(list)A queue of
(end-moment . grob)cons cells. This is for internal (C++) use only. This property contains the grobs which are still busy (e.g. note heads, spanners, etc.).Properties (write)
busyGrobs(list)A queue of
(end-moment . grob)cons cells. This is for internal (C++) use only. This property contains the grobs which are still busy (e.g. note heads, spanners, etc.).Instrument_name_engraverCreate a system start text for instrument or vocal names.
Properties (read)
currentCommandColumn(graphical (layout) object)Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
instrumentName(markup)The name to print left of a staff. The
instrumentNameproperty labels the staff in the first system, and theshortInstrumentNameproperty labels following lines.shortInstrumentName(markup)See
instrumentName.shortVocalName(markup)Name of a vocal line, short version.
vocalName(markup)Name of a vocal line.
This engraver creates the following layout object(s):
Ledger_line_engraverCreate the spanner to draw ledger lines, and notices objects that need ledger lines.
This engraver creates the following layout object(s):
Merge_mmrest_numbers_engraverEngraver to merge multi-measure rest numbers in multiple voices.
This works by gathering all multi-measure rest numbers at a time step. If they all have the same text and there are at least two only the first one is retained and the others are hidden.
Output_property_engraverApply a procedure to any grob acknowledged.
Music types accepted:
Piano_pedal_align_engraverAlign piano pedal symbols and brackets.
Properties (read)
currentCommandColumn(graphical (layout) object)Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
This engraver creates the following layout object(s):
SostenutoPedalLineSpanner, SustainPedalLineSpanner and UnaCordaPedalLineSpanner.
Pure_from_neighbor_engraverCoordinates items that get their pure heights from their neighbors.
Rest_collision_engraverHandle collisions of rests.
Properties (read)
busyGrobs(list)A queue of
(end-moment . grob)cons cells. This is for internal (C++) use only. This property contains the grobs which are still busy (e.g. note heads, spanners, etc.).This engraver creates the following layout object(s):
Script_row_engraverDetermine order in horizontal side position elements.
This engraver creates the following layout object(s):
Separating_line_group_engraverGenerate objects for computing spacing parameters.
Properties (read)
createSpacing(boolean)Create
StaffSpacingobjects? Should be set for staves.Properties (write)
hasStaffSpacing(boolean)True if the current
CommandColumncontains items that will affect spacing.This engraver creates the following layout object(s):
Staff_collecting_engraverMaintain the
stavesFoundvariable.Properties (read)
stavesFound(list of grobs)A list of all staff-symbols found.
Properties (write)
stavesFound(list of grobs)A list of all staff-symbols found.
Staff_symbol_engraverCreate the constellation of five (default) staff lines.
Music types accepted:
This engraver creates the following layout object(s):
Time_signature_engraverCreate a TimeSignature whenever
timeSignatureFractionchanges.Music types accepted:
Properties (read)
initialTimeSignatureVisibility(vector)break visibility for the initial time signature.
partialBusy(boolean)Signal that \partial acts at the current timestep.
timeSignatureFraction(fraction, as pair)A pair of numbers, signifying the time signature. For example,
'(4 . 4)is a 4/4 time signature.This engraver creates the following layout object(s):
| [ << Translation ] | [Top][Contents][Index] | [ Backend >> ] |
| [ < Devnull ] | [ Up : Contexts ] | [ DrumVoice > ] |