[ << 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
, StaffEllipsis
, StaffSpacing
, StaffSymbol
, SustainPedalLineSpanner
, TimeSignature
, UnaCordaPedalLineSpanner
and VerticalAxisGroup
.
This context sets the following properties:
- Set grob property
staff-padding
inScript
to0.75
. - Set translator property
clefGlyph
to"clefs.percussion"
. - Set translator property
clefPosition
to0
. - Set translator property
createSpacing
to#t
. - Set translator property
ignoreFiguredBassRest
to#f
. - Set translator property
instrumentName
to'()
. - Set translator property
localAlterations
to'()
. - Set translator property
ottavationMarkups
to:'((4 . "29") (3 . "22") (2 . "15") (1 . "8") (-1 . "8") (-2 . "15") (-3 . "22") (-4 . "29"))
- Set translator property
shortInstrumentName
to'()
.
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):
Alteration_glyph_engraver
Set the
glyph-name-alist
of all grobs having theaccidental-switch-interface
to the value of the context’salterationGlyphs
property, when defined.Properties (read)
alterationGlyphs
(list)Alist mapping alterations to accidental glyphs. Alterations are given as exact numbers, e.g., -1/2 for flat. This applies to all grobs that can print accidentals.
Axis_group_engraver
Group all objects created in this context in a
VerticalAxisGroup
spanner.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-empty
set 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):
VerticalAxisGroup
.Bar_engraver
Create barlines. This engraver is controlled through the
whichBar
property. 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.Music types accepted:
ad-hoc-jump-event
,coda-mark-event
,dal-segno-event
,fine-event
,section-event
,segno-mark-event
andvolta-span-event
Properties (read)
doubleRepeatBarType
(string)Bar line to insert where the end of one
\repeat volta
coincides with the start of another. The default is ‘:..:’.doubleRepeatSegnoBarType
(string)Bar line to insert where an in-staff segno coincides with the end of one
\repeat volta
and the beginning of another. The default is ‘:|.S.|:’.endRepeatBarType
(string)Bar line to insert at the end of a
\repeat volta
. The default is ‘:|.’.endRepeatSegnoBarType
(string)Bar line to insert where an in-staff segno coincides with the end of a
\repeat volta
. The default is ‘:|.S’.fineBarType
(string)Bar line to insert at
\fine
. Where there is also a repeat bar line, the repeat bar line takes precedence and this value is appended to it as an annotation. The default is ‘|.’.fineSegnoBarType
(string)Bar line to insert where an in-staff segno coincides with
\fine
. The default is ‘|.S’.fineStartRepeatSegnoBarType
(string)Bar line to insert where an in-staff segno coincides with
\fine
and the start of a\repeat volta
. The default is ‘|.S.|:’.measureBarType
(string)Bar line to insert at a measure boundary.
repeatCommands
(list)A list of commands related to volta-style repeats. In general, each element is a list,
'(command args…)
, but a command with no arguments may be abbreviated to a symbol; e.g.,'((start-repeat))
may be given as'(start-repeat)
.
end-repeat
End a repeated section.
start-repeat
Start a repeated section.
volta text
If text is markup, start a volta bracket with that label; if text is
#f
, end a volta bracket.sectionBarType
(string)Bar line to insert at
\section
. Where there is also a repeat bar line, the repeat bar line takes precedence and this value is appended to it as an annotation. The default is ‘||’.segnoBarType
(string)Bar line to insert at an in-staff segno. The default is ‘S’.
segnoStyle
(symbol)A symbol that indicates how to print a segno:
bar-line
ormark
.startRepeatBarType
(string)Bar line to insert at the start of a
\repeat volta
. The default is ‘.|:’.startRepeatSegnoBarType
(string)Bar line to insert where an in-staff segno coincides with the start of a
\repeat volta
. The default is ‘S.|:’.underlyingRepeatBarType
(string)Bar line to insert at points of repetition or departure where no bar line would normally appear, for example at the end of a system broken in mid measure where the next system begins with a segno. Where there is also a repeat bar line, the repeat bar line takes precedence and this value is appended to it as an annotation. The default is ‘||’.
whichBar
(string)The current bar line type, or
'()
if there is no bar line. Setting this explicitly in user code is deprecated. Use\bar
or related commands to set it.Properties (write)
currentBarLine
(graphical (layout) object)Set to the
BarLine
thatBar_engraver
has created in the current timestep.forbidBreak
(boolean)If set to
#t
, prevent a line break at this point.This engraver creates the following layout object(s):
BarLine
.Clef_engraver
Determine 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
andClefModifier
.Collision_engraver
Collect
NoteColumns
, and as soon as there are two or more, put them in aNoteCollision
object.This engraver creates the following layout object(s):
NoteCollision
.Cue_clef_engraver
Determine 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
cueClefPosition
andcueClefGlyph
.This engraver creates the following layout object(s):
ClefModifier
,CueClef
andCueEndClef
.Dot_column_engraver
Engrave 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):
DotColumn
.Figured_bass_engraver
Make figured bass numbers.
Music types accepted:
bass-figure-event
andrest-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
andBassFigureLine
.Figured_bass_position_engraver
Position figured bass alignments over notes.
This engraver creates the following layout object(s):
BassFigureAlignmentPositioning
.Fingering_column_engraver
Find potentially colliding scripts and put them into a
FingeringColumn
object; that will fix the collisions.This engraver creates the following layout object(s):
FingeringColumn
.Font_size_engraver
Put
fontSize
intofont-size
grob property.Properties (read)
fontSize
(number)The relative size of all grobs in a context.
Grob_pq_engraver
Administrate 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_engraver
Create 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
instrumentName
property labels the staff in the first system, and theshortInstrumentName
property 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):
InstrumentName
.Ledger_line_engraver
Create the spanner to draw ledger lines, and notices objects that need ledger lines.
This engraver creates the following layout object(s):
LedgerLineSpanner
.Merge_mmrest_numbers_engraver
Engraver 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_engraver
Apply a procedure to any grob acknowledged.
Music types accepted:
apply-output-event
Piano_pedal_align_engraver
Align 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
andUnaCordaPedalLineSpanner
.Pure_from_neighbor_engraver
Coordinates items that get their pure heights from their neighbors.
Rest_collision_engraver
Handle 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):
RestCollision
.Script_row_engraver
Determine order in horizontal side position elements.
This engraver creates the following layout object(s):
ScriptRow
.Separating_line_group_engraver
Generate objects for computing spacing parameters.
Properties (read)
createSpacing
(boolean)Create
StaffSpacing
objects? Should be set for staves.Properties (write)
hasStaffSpacing
(boolean)True if
currentCommandColumn
contains items that will affect spacing.This engraver creates the following layout object(s):
StaffSpacing
.Skip_typesetting_engraver
Create a
StaffEllipsis
whenskipTypesetting
is used.Properties (read)
skipTypesetting
(boolean)If true, no typesetting is done, speeding up the interpretation phase. Useful for debugging large scores.
This engraver creates the following layout object(s):
StaffEllipsis
.Staff_collecting_engraver
Maintain the
stavesFound
variable.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_engraver
Create the constellation of five (default) staff lines.
Music types accepted:
staff-span-event
This engraver creates the following layout object(s):
StaffSymbol
.Time_signature_engraver
Create a
TimeSignature
whenevertimeSignatureFraction
changes.Music types accepted:
time-signature-event
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):
TimeSignature
.
[ << Translation ] | [Top][Contents][Index] | [ Backend >> ] |
[ < Devnull ] | [ Up : Contexts ] | [ DrumVoice > ] |