Next: , Previous: DrumStaff, Up: Contexts


DrumVoice

A voice on a percussion staff.

This context also accepts commands for the following context(s):

Voice

This context creates the following layout objects:

Beam, BendAfter, BreathingSign, CombineTextScript, Dots, DoublePercentRepeatCounter, DoublePercentRepeat, DynamicLineSpanner, DynamicText, Hairpin, InstrumentSwitch, LaissezVibrerTieColumn, LaissezVibrerTie, MultiMeasureRestNumber, MultiMeasureRestText, MultiMeasureRest, NoteColumn, NoteHead, NoteSpacing, PercentRepeatCounter, PercentRepeat, PhrasingSlur, RepeatSlash, RepeatTieColumn, RepeatTie, Rest, ScriptColumn, Script, Slur, StemTremolo, Stem, TextScript, TextSpanner, TieColumn, Tie, TrillPitchAccidental, TrillPitchGroup, TrillPitchHead, TrillSpanner, TupletBracket and TupletNumber.

This context sets the following properties:

This context is a `bottom' context; it can not contain other contexts.

This context is built from the following engravers:

Skip_event_swallow_translator
Swallow \skip.
Tuplet_engraver
Catch tuplet events and generate appropriate bracket.

Music types accepted:

tuplet-span-event

Properties (read)

tupletFullLength (boolean)
If set, the tuplet is printed up to the start of the next note.
tupletFullLengthNote (boolean)
If set, end at the next note, otherwise end on the matter (time sigs, etc.) before the note.
This engraver creates the following layout objects: TupletBracket and TupletNumber.
Drum_notes_engraver
Generate noteheads.

Music types accepted:

note-event

Properties (read)

drumStyleTable (hash table)
A hash table containing mapping drums to layout settings. Predefined values: `drums-style', `timbales-style', `congas-style', `bongos-style' and `percussion-style'.

The layout style is a hash table, containing the drum-pitches (e.g. the symbol `hihat') as key, and a list (notehead-style script vertical-position) as values.

This engraver creates the following layout objects: NoteHead and Script.
Grob_pq_engraver
Administrate when certain grobs (eg. note heads) stop playing

Properties (read)

busyGrobs (list)
a queue of (end-moment . GROB) conses. 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) conses. This is for internal (C++) use only. This property contains the grobs which are still busy (e.g. note heads, spanners, etc.)

Text_spanner_engraver
Create text spanner from an event.

Music types accepted:

text-span-event

This engraver creates the following layout objects: TextSpanner.

Multi_measure_rest_engraver
Engraves multi-measure rests that are produced with R. Reads measurePosition and internalBarNumber to determine what number to print over the MultiMeasureRest. Reads measureLength to determine if it should use a whole rest or a breve rest to represent 1 measure

Music types accepted:

multi-measure-text-event and multi-measure-rest-event

Properties (read)

internalBarNumber (integer)
Contains the current barnumber. This property is used for internal timekeeping, among others by the Accidental_engraver.
restNumberThreshold (number)
If a multimeasure rest has more measures than this, a number is printed.
breakableSeparationItem (layout object)
The breakable items in this time step, for this staff.
currentCommandColumn (layout object)
Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
measurePosition (moment)
How much of the current measure have we had. This can be set manually to create incomplete measures.
measureLength (moment)
Length of one measure in the current time signature.
This engraver creates the following layout objects: MultiMeasureRest, MultiMeasureRestNumber and MultiMeasureRestText.
Skip_event_swallow_translator
Swallow \skip.
Instrument_switch_engraver
Create a cue text for taking instrument.

Properties (read)

instrumentCueName (markup)
Name to print if another instrument is to be taken.
This engraver creates the following layout objects: InstrumentSwitch.
Grace_engraver
Set font size and other properties for grace notes.

Properties (read)

graceSettings (list)
Overrides for grace notes. This property should be manipulated through the add-grace-property function.

Tuplet_engraver
Catch tuplet events and generate appropriate bracket.

Music types accepted:

tuplet-span-event

Properties (read)

tupletFullLength (boolean)
If set, the tuplet is printed up to the start of the next note.
tupletFullLengthNote (boolean)
If set, end at the next note, otherwise end on the matter (time sigs, etc.) before the note.
This engraver creates the following layout objects: TupletBracket and TupletNumber.
Tie_engraver
Generate ties between noteheads of equal pitch.

Music types accepted:

tie-event

Properties (read)

tieWaitForNote (boolean)
If true, tied notes do not have to follow each other directly. This can be used for writing out arpeggios
Properties (write)
tieMelismaBusy (boolean)
Signal whether a tie is present.
This engraver creates the following layout objects: Tie and TieColumn.
Slur_engraver
Build slur grobs from slur events

Music types accepted:

slur-event

Properties (read)

slurMelismaBusy (boolean)
Signal if a slur is present.
doubleSlurs (boolean)
When set, two slurs are created for every slurred note, one above and one below the chord.
This engraver creates the following layout objects: Slur.
Phrasing_slur_engraver
Print phrasing slurs. Similar to Slur_engraver

Music types accepted:

phrasing-slur-event

This engraver creates the following layout objects: PhrasingSlur.

Note_spacing_engraver
Generates NoteSpacing, an object linking horizontal lines for use in spacing.

This engraver creates the following layout objects: NoteSpacing.

Rhythmic_column_engraver
Generates NoteColumn, an objects that groups stems, noteheads and rests.

This engraver creates the following layout objects: NoteColumn.

Script_column_engraver

This engraver creates the following layout objects: ScriptColumn.

Script_engraver
Handles note scripted articulations.

Music types accepted:

articulation-event

Properties (read)

scriptDefinitions (list)
Description of scripts. This is used by Script_engraver for typesetting note-super/subscripts. See scm/script.scm for more information
This engraver creates the following layout objects: Script.
Bend_after_engraver
Create fall spanners.

Music types accepted:

bend-after-event

This engraver creates the following layout objects: BendAfter.

Dynamic_engraver
This engraver creates hairpins, dynamic texts, and their vertical alignments. The symbols are collected onto a DynamicLineSpanner grob which takes care of vertical positioning.

Music types accepted:

span-dynamic-event and absolute-dynamic-event

This engraver creates the following layout objects: DynamicLineSpanner, DynamicText, Hairpin and TextSpanner.

Text_engraver
Create text-scripts

Music types accepted:

text-script-event

This engraver creates the following layout objects: TextScript.

Part_combine_engraver
Part combine engraver for orchestral scores: Print markings a2, Solo, Solo II, and unisono

Music types accepted:

part-combine-event

Properties (read)

printPartCombineTexts (boolean)
set Solo/A due texts in the part combiner?
soloText (string)
text for begin of solo when part-combining.
soloIIText (string)
text for begin of solo for voice “two” when part-combining.
aDueText (string)
Text to print at a unisono passage.
This engraver creates the following layout objects: CombineTextScript.
Slash_repeat_engraver
Make beat repeats.

Music types accepted:

percent-event

Properties (read)

measureLength (moment)
Length of one measure in the current time signature.
This engraver creates the following layout objects: RepeatSlash.
Percent_repeat_engraver
Make whole bar and double bar repeats.

Music types accepted:

percent-event

Properties (read)

countPercentRepeats (boolean)
If set, produce counters for percent repeats.
currentCommandColumn (layout object)
Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
measureLength (moment)
Length of one measure in the current time signature.
Properties (write)
forbidBreak (boolean)
If set to ##t, prevent a line break at this point.
This engraver creates the following layout objects: DoublePercentRepeat, DoublePercentRepeatCounter, PercentRepeat and PercentRepeatCounter.
Chord_tremolo_engraver
Generates beams for tremolo repeats.

Music types accepted:

tremolo-span-event

This engraver creates the following layout objects: Beam.

Auto_beam_engraver
Generate beams based on measure characteristics and observed Stems. Uses beatLength, measureLength and measurePosition to decide when to start and stop a beam. Overriding beaming is done through Stem_engraver properties stemLeftBeamCount and stemRightBeamCount.

Music types accepted:

beam-forbid-event

Properties (read)

autoBeaming (boolean)
If set to true then beams are generated automatically.
autoBeamSettings (list)
Specifies when automatically generated beams should begin and end. See Setting automatic beam behavior for more information.
beatLength (moment)
The length of one beat in this time signature.
subdivideBeams (boolean)
If set, multiple beams will be subdivided at beat positions by only drawing one beam over the beat.
This engraver creates the following layout objects: Beam.
Grace_beam_engraver
Handles Beam events by engraving Beams. If omitted, then notes will be printed with flags instead of beams. Only engraves beams when we are at grace points in time.

Music types accepted:

beam-event

Properties (read)

beamMelismaBusy (boolean)
Signal if a beam is present.
beatLength (moment)
The length of one beat in this time signature.
allowBeamBreak (boolean)
If true allow line breaks for beams over bar lines.
subdivideBeams (boolean)
If set, multiple beams will be subdivided at beat positions by only drawing one beam over the beat.
This engraver creates the following layout objects: Beam.
Beam_engraver
Handles Beam events by engraving Beams. If omitted, then notes will be printed with flags instead of beams.

Music types accepted:

beam-event

Properties (read)

beamMelismaBusy (boolean)
Signal if a beam is present.
beatLength (moment)
The length of one beat in this time signature.
subdivideBeams (boolean)
If set, multiple beams will be subdivided at beat positions by only drawing one beam over the beat.
Properties (write)
forbidBreak (boolean)
If set to ##t, prevent a line break at this point.
This engraver creates the following layout objects: Beam.
Stem_engraver
Create stems and single-stem tremolos. It also works together with the beam engraver for overriding beaming.

Music types accepted:

tremolo-event

Properties (read)

tremoloFlags (integer)
Number of tremolo flags to add if no number is specified.
stemLeftBeamCount (integer)
Specify the number of beams to draw on the left side of the next note. Overrides automatic beaming. The value is only used once, and then it is erased.
stemRightBeamCount (integer)
See stemLeftBeamCount.
This engraver creates the following layout objects: Stem and StemTremolo.
Rest_engraver

Music types accepted:

rest-event

Properties (read)

middleCPosition (number)
Place of the middle C, measured in half staff-spaces. Usually determined by looking at clefPosition and clefGlyph.
This engraver creates the following layout objects: Rest.
Dots_engraver
Create Dots objects for rhythmic-head-interfaces.

This engraver creates the following layout objects: Dots.

Breathing_sign_engraver

Music types accepted:

breathing-event

This engraver creates the following layout objects: BreathingSign.

Repeat_tie_engraver
Create Laissez vibrer items.

Music types accepted:

repeat-tie-event

This engraver creates the following layout objects: RepeatTie and RepeatTieColumn.

Laissez_vibrer_engraver
Create Laissez vibrer items.

Music types accepted:

laissez-vibrer-event

This engraver creates the following layout objects: LaissezVibrerTie and LaissezVibrerTieColumn.

Forbid_line_break_engraver
Forbid line breaks when note heads are still playing at some point.

Properties (read)

busyGrobs (list)
a queue of (end-moment . GROB) conses. This is for internal (C++) use only. This property contains the grobs which are still busy (e.g. note heads, spanners, etc.)
Properties (write)
forbidBreak (boolean)
If set to ##t, prevent a line break at this point.

Grob_pq_engraver
Administrate when certain grobs (eg. note heads) stop playing

Properties (read)

busyGrobs (list)
a queue of (end-moment . GROB) conses. 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) conses. This is for internal (C++) use only. This property contains the grobs which are still busy (e.g. note heads, spanners, etc.)

Trill_spanner_engraver
Create trill spanner from an event.

Music types accepted:

trill-span-event

This engraver creates the following layout objects: TrillSpanner.

Text_spanner_engraver
Create text spanner from an event.

Music types accepted:

text-span-event

This engraver creates the following layout objects: TextSpanner.

Multi_measure_rest_engraver
Engraves multi-measure rests that are produced with R. Reads measurePosition and internalBarNumber to determine what number to print over the MultiMeasureRest. Reads measureLength to determine if it should use a whole rest or a breve rest to represent 1 measure

Music types accepted:

multi-measure-text-event and multi-measure-rest-event

Properties (read)

internalBarNumber (integer)
Contains the current barnumber. This property is used for internal timekeeping, among others by the Accidental_engraver.
restNumberThreshold (number)
If a multimeasure rest has more measures than this, a number is printed.
breakableSeparationItem (layout object)
The breakable items in this time step, for this staff.
currentCommandColumn (layout object)
Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
measurePosition (moment)
How much of the current measure have we had. This can be set manually to create incomplete measures.
measureLength (moment)
Length of one measure in the current time signature.
This engraver creates the following layout objects: MultiMeasureRest, MultiMeasureRestNumber and MultiMeasureRestText.
Output_property_engraver
Apply a procedure to any grob acknowledged.

Music types accepted:

apply-output-event

Pitched_trill_engraver
Print the bracketed notehead after a notehead with trill.

This engraver creates the following layout objects: TrillPitchAccidental, TrillPitchGroup and TrillPitchHead.

Font_size_engraver
Puts fontSize into font-size grob property.

Properties (read)

fontSize (number)
The relative size of all grobs in a context.


Next: , Previous: DrumStaff, Up: Contexts

This page is for LilyPond-2.10.33 (stable-branch).

Report errors to http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs.