Previous: VaticanaVoice, Up: Contexts
Corresponds to a voice on a staff. This context handles the conversion of dynamic signs, stems, beams, super- and subscripts, slurs, ties, and rests.
You have to instantiate this explicitly if you want to have multiple voices on the same staff.
This context creates the following layout object(s):
Arpeggio, Beam, BendAfter, BreathingSign, ClusterSpannerBeacon, ClusterSpanner, CombineTextScript, Dots, DoublePercentRepeatCounter, DoublePercentRepeat, DynamicLineSpanner, DynamicTextSpanner, DynamicText, Fingering, Glissando, Hairpin, InstrumentSwitch, LaissezVibrerTieColumn, LaissezVibrerTie, LigatureBracket, MultiMeasureRestNumber, MultiMeasureRestText, MultiMeasureRest, NoteColumn, NoteHead, NoteSpacing, PercentRepeatCounter, PercentRepeat, PhrasingSlur, RepeatSlash, RepeatTieColumn, RepeatTie, Rest, ScriptColumn, Script, Slur, StemTremolo, Stem, StringNumber, StrokeFinger, TextScript, TextSpanner, TieColumn, Tie, TrillPitchAccidental, TrillPitchGroup, TrillPitchHead, TrillSpanner, TupletBracket, TupletNumber and VoiceFollower.
This context sets the following properties:
localKeySignature
to '()
.
This context is a `bottom' context; it cannot contain other contexts.
This context is built from the following engraver(s):
Skip_event_swallow_translator
- Swallow
\skip
.Instrument_switch_engraver
- Create a cue text for taking instrument.
Properties (read)
instrumentCueName
(markup)- The name to print if another instrument is to be taken.
This engraver creates the following layout object(s):
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:
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 signatures, etc.) before the note.
This engraver creates the following layout object(s):
Tie_engraver
- Generate ties between note heads of equal pitch.
Music types accepted:
Properties (read)
Properties (write)
tieWaitForNote
(boolean)- If true, tied notes do not have to follow each other directly. This can be used for writing out arpeggios.
tieMelismaBusy
(boolean)- Signal whether a tie is present.
This engraver creates the following layout object(s):
Slur_engraver
- Build slur grobs from slur events.
Music types accepted:
Properties (read)
slurMelismaBusy
(boolean)- Signal if a slur is present.
doubleSlurs
(boolean)- If set, two slurs are created for every slurred note, one above and one below the chord.
This engraver creates the following layout object(s):
Slur.
Cluster_spanner_engraver
- Engrave a cluster using
Spanner
notation.Music types accepted:
This engraver creates the following layout object(s):
Phrasing_slur_engraver
- Print phrasing slurs. Similar to Slur_engraver.
Music types accepted:
This engraver creates the following layout object(s):
Spanner_break_forbid_engraver
- Forbid breaks in certain spanners.
Note_spacing_engraver
- Generate
NoteSpacing
, an object linking horizontal lines for use in spacing.This engraver creates the following layout object(s):
Rhythmic_column_engraver
- Generate
NoteColumn
, an object that groups stems, note heads, and rests.This engraver creates the following layout object(s):
Script_column_engraver
- Find potentially colliding scripts and put them into a
ScriptColumn
object; that will fix the collisions.This engraver creates the following layout object(s):
Script_engraver
- Handle note scripted articulations.
Music types accepted:
Properties (read)
scriptDefinitions
(list)- The description of scripts. This is used by the
Script_engraver
for typesetting note-superscripts and subscripts. See scm/script.scm for more information.This engraver creates the following layout object(s):
Bend_engraver
- Create fall spanners.
Music types accepted:
This engraver creates the following layout object(s):
Fingering_engraver
- Create fingering scripts.
Music types accepted:
stroke-finger-event and fingering-event
This engraver creates the following layout object(s):
Dynamic_align_engraver
- Align hairpins and dynamic texts on a horizontal line
Properties (read)
currentMusicalColumn
(layout object)- Grob that is X-parent to all non-breakable items (note heads, lyrics, etc.).
This engraver creates the following layout object(s):
New_dynamic_engraver
- Create 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
Properties (read)
currentMusicalColumn
(layout object)- Grob that is X-parent to all non-breakable items (note heads, lyrics, etc.).
This engraver creates the following layout object(s):
Text_engraver
- Create text scripts.
Music types accepted:
This engraver creates the following layout object(s):
Part_combine_engraver
- Part combine engraver for orchestral scores: Print markings ‘a2’, ‘Solo’, ‘Solo II’, and ‘unisono’.
Music types accepted:
Properties (read)
printPartCombineTexts
(boolean)- Set ‘Solo’ and ‘A due’ texts in the part combiner?
soloText
(markup)- The text for the start of a solo when part-combining.
soloIIText
(markup)- The text for the start of a solo for voice ‘two’ when part-combining.
aDueText
(markup)- Text to print at a unisono passage.
This engraver creates the following layout object(s):
Slash_repeat_engraver
- Make beat repeats.
Music types accepted:
Properties (read)
measureLength
(moment)- Length of one measure in the current time signature.
This engraver creates the following layout object(s):
Percent_repeat_engraver
- Make whole bar and double bar repeats.
Music types accepted:
Properties (read)
Properties (write)
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.
forbidBreak
(boolean)- If set to
##t
, prevent a line break at this point.This engraver creates the following layout object(s):
DoublePercentRepeat, DoublePercentRepeatCounter, PercentRepeat and PercentRepeatCounter.
Chord_tremolo_engraver
- Generate beams for tremolo repeats.
Music types accepted:
This engraver creates the following layout object(s):
Beam.
New_fingering_engraver
- Create fingering scripts for notes in a new chord. This engraver is ill-named, since it also takes care of articulations and harmonic note heads.
Properties (read)
fingeringOrientations
(list)- A list of symbols, containing ‘left’, ‘right’, ‘up’ and/or ‘down’. This list determines where fingerings are put relative to the chord being fingered.
harmonicDots
(boolean)- If set, harmonic notes in dotted chords get dots.
strokeFingerOrientations
(list)- See
fingeringOrientations
.stringNumberOrientations
(list)- See
fingeringOrientations
.This engraver creates the following layout object(s):
Fingering, Script, StringNumber and StrokeFinger.
Auto_beam_engraver
- Generate beams based on measure characteristics and observed Stems. Uses
beatLength
,measureLength
, andmeasurePosition
to decide when to start and stop a beam. Overriding beaming is done through Stem_engraver propertiesstemLeftBeamCount
andstemRightBeamCount
.Music types accepted:
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 behavior 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 object(s):
Beam.
Grace_beam_engraver
- Handle
Beam
events by engraving beams. If omitted, then notes are printed with flags instead of beams. Only engraves beams when we are at grace points in time.Music types accepted:
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.
This engraver creates the following layout object(s):
Beam.
Beam_engraver
- Handle
Beam
events by engraving beams. If omitted, then notes are printed with flags instead of beams.Music types accepted:
Properties (read)
Properties (write)
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.
forbidBreak
(boolean)- If set to
##t
, prevent a line break at this point.This engraver creates the following layout object(s):
Beam.
Stem_engraver
- Create stems and single-stem tremolos. It also works together with the beam engraver for overriding beaming.
Music types accepted:
Properties (read)
tremoloFlags
(integer)- The 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 object(s):
Stem and StemTremolo.
Tweak_engraver
- Read the
tweaks
property from the originating event, and set properties.Rest_engraver
- Engrave rests.
Music types accepted:
Properties (read)
middleCPosition
(number)- The place of the middle C, measured in half staff-spaces. Usually determined by looking at
middleCClefPosition
andmiddleCOffset
.This engraver creates the following layout object(s):
Rest.
Dots_engraver
- Create Dots objects for rhythmic-head-interfaces.
This engraver creates the following layout object(s):
Dots.
Note_heads_engraver
- Generate note heads.
Music types accepted:
Properties (read)
middleCPosition
(number)- The place of the middle C, measured in half staff-spaces. Usually determined by looking at
middleCClefPosition
andmiddleCOffset
.staffLineLayoutFunction
(procedure)- Layout of staff lines,
traditional
, orsemitone
.This engraver creates the following layout object(s):
Breathing_sign_engraver
- Create a breathing sign.
Music types accepted:
This engraver creates the following layout object(s):
Ligature_bracket_engraver
- Handle
Ligature_events
by engravingLigature
brackets.Music types accepted:
This engraver creates the following layout object(s):
Glissando_engraver
- Engrave glissandi.
Music types accepted:
This engraver creates the following layout object(s):
Note_head_line_engraver
- Engrave a line between two note heads, for example a glissando. If
followVoice
is set, staff switches also generate a line.Properties (read)
followVoice
(boolean)- If set, note heads are tracked across staff switches by a thin line.
This engraver creates the following layout object(s):
Glissando and VoiceFollower.
Repeat_tie_engraver
- Create repeat ties.
Music types accepted:
This engraver creates the following layout object(s):
RepeatTie and RepeatTieColumn.
Laissez_vibrer_engraver
- Create laissez vibrer items.
Music types accepted:
This engraver creates the following layout object(s):
Forbid_line_break_engraver
- Forbid line breaks when note heads are still playing at some point.
Properties (read)
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.).
forbidBreak
(boolean)- If set to
##t
, prevent a line break at this point.Grob_pq_engraver
- Administrate when certain grobs (e.g., note heads) stop playing.
Properties (read)
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.).
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.).Trill_spanner_engraver
- Create trill spanner from an event.
Music types accepted:
This engraver creates the following layout object(s):
Text_spanner_engraver
- Create text spanner from an event.
Music types accepted:
This engraver creates the following layout object(s):
Multi_measure_rest_engraver
- Engrave multi-measure rests that are produced with ‘R’. It reads
measurePosition
andinternalBarNumber
to determine what number to print over the MultiMeasureRest. ReadsmeasureLength
to determine whether it should use a whole rest or a breve rest to represent one 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 object(s):
MultiMeasureRest, MultiMeasureRestNumber and MultiMeasureRestText.
Arpeggio_engraver
- Generate an Arpeggio symbol.
Music types accepted:
This engraver creates the following layout object(s):
Output_property_engraver
- Apply a procedure to any grob acknowledged.
Music types accepted:
Pitched_trill_engraver
- Print the bracketed note head after a note head with trill.
This engraver creates the following layout object(s):
Font_size_engraver
- Put
fontSize
intofont-size
grob property.Properties (read)
fontSize
(number)- The relative size of all grobs in a context.
Cette page documente LilyPond-2.11.58 (branche de développement).
Rapportez toute anomalie en français à lilypond-user-fr@gnu.org ou en anglais à http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs
Vos suggestions à propos de la documentation sont les bienvenues.