GNU LilyPond

Welcome to the home of the GNU Music Typesetter

Node:Voice, Previous:Thread, Up:LilyPond interpretation contexts

Voice

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 grobs: Arpeggio, Beam, BreathingSign, DotColumn, DoublePercentRepeat, DynamicLineSpanner, DynamicText, Hairpin, MultiMeasureRest, NoteColumn, PercentRepeat, RepeatSlash, ScriptColumn, Script, Slur, StemTremolo, Stem, TextScript, TextSpanner, TieColumn, Tie and TupletBracket.

Context Voice can contain Grace and Thread

This context is built from the following engravers:

Engraver_group_engraver

A group of engravers taken together

Engraver_group_engraver is part of contexts: Lyrics, ChoirStaff, LyricsVoice, PianoStaff, GrandStaff, Thread, RhythmicStaff, Voice, Staff, ChordNames, StaffContainer, InnerStaffGroup, InnerChoirStaff, NoteNames and StaffGroup

Skip_req_swallow_translator

Skip_req_swallow_translator is part of contexts: Voice and ChordNames

A2_engraver

Part combine engraver for orchestral scores.

The markings a2, Solo and Solo II, are created by this engraver. It also acts upon instructions of the part combiner. Another thing that the this engraver, is forcing of stem, slur and tie directions, always when both threads are not identical; up for the musicexpr called one, down for the musicexpr called two.

Properties

combineParts (boolean):

try to combine parts?

noDirection (boolean):

Don't set directions by a2-engraver when part-combining.

soloADue (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 for begin of a due

split-interval (boolean):

set if part-combiner separated voices based on splitInterval.

unison (boolean):

set if unisono is detected by the part combiner. .

solo (boolean):

set if solo is detected by the part combiner.

unisilence (boolean):

set if unisilence is detected by the part combiner.

unirhythm (boolean):

set if unirhythm is detected by the part combiner.

A2_engraver is part of contexts: Voice

Grace_position_engraver

Attach a grace note alignment to a note-column

Grace_position_engraver is part of contexts: Voice

Tuplet_engraver

Catch Time_scaled_music and generate appropriate bracket

Properties

tupletNumberFormatFunction (procedure):

Function taking a music as input, producing a string. This function is called to determine the text to print on a tuplet bracket.

tupletSpannerDuration (moment):

Normally a tuplet bracket is as wide as the imes expression that gave rise to it. By setting this property, you can make brackets last shorter. Example

@lilypond[verbatim,fragment]
context Voice 	imes 2/3 {
  property Voice.tupletSpannerDuration = #(make-moment 1 4)
  [c8 c c] [c c c]
}
@end lilypond

.

tupletInvisible (boolean):

If set to true, tuplet bracket creation is switched off entirely. This has the same effect as setting both tupletNumberVisibility and tupletBracketVisibility to #f, but as this does not even create any grobs, this setting uses less memory and time.

Tuplet_engraver is part of contexts: Voice

Tie_engraver

Generate ties between noteheads of equal pitch.

Properties

sparseTies (boolean):

only create one tie per chord.

tieMelismaBusy (boolean):

Signal ties when automaticMelismata is set.

Tie_engraver is part of contexts: Voice

Slur_engraver

Build slurs from Slur_reqs

Properties

slurBeginAttachment (symbol):

translates to the car of grob-property 'attachment of NoteColumn. See Slur.

slurEndAttachment (symbol):

translates to the cdr of grob-property 'attachment of NoteColumn. See Slur.

slurMelismaBusy (boolean):

Signal a slur if automaticMelismata is set.

Slur_engraver is part of contexts: Grace and VoiceEngraver Phrasing_slur_engraver, not documented.

Rhythmic_column_engraver

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

This engraver creates the following grobs: NoteColumn.

Rhythmic_column_engraver is part of contexts: Grace and Voice

Script_column_engraver

This engraver creates the following grobs: ScriptColumn.

Script_column_engraver is part of contexts: Voice

Script_engraver

Handles note ornaments generated by script.

Properties

scriptDefinitions (list):

Description of scripts. This is used by Script_engraver for typesetting note-super/subscripts. See scm/script.scm for more information

scriptHorizontal (boolean):

Put scripts left or right of note heads. Support for this is limited. Accidentals will collide with scripts.

Script_engraver is part of contexts: Voice

Text_engraver

Create text-scripts

Properties

scriptHorizontal (boolean):

Put scripts left or right of note heads. Support for this is limited. Accidentals will collide with scripts.

textNonEmpty (boolean):

If set to true then text placed above or below the staff is not assumed to have zero width. atText and emptyText are predefined settings. .

Text_engraver is part of contexts: Grace and Voice

Dynamic_engraver

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

Dynamic_engraver is part of contexts: Grace and Voice

Melisma_engraver

Properties

melismaBusy (boolean):

Signifies whether a melisma is active. This can be used to signal melismas on top of those automatically detected.

slurMelismaBusy (boolean):

Signal a slur if automaticMelismata is set.

tieMelismaBusy (boolean):

Signal ties when automaticMelismata is set.

beamMelismaBusy (boolean):

Signal if a beam is set when automaticMelismata is set

Melisma_engraver is part of contexts: Voice

Percent_repeat_engraver

Engrave percent repeats.

This engraver creates the following grobs: DoublePercentRepeat, PercentRepeat and RepeatSlash.

Percent_repeat_engraver is part of contexts: Voice

Chord_tremolo_engraver

Generates beams for the epeat X tremolo ... construct

This engraver creates the following grobs: Beam.

Chord_tremolo_engraver is part of contexts: Voice

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.

Properties

noAutoBeaming (boolean):

If set to true then beams are not generated automatically.

autoBeamSettings (list):

Specifies when automatically generated beams should begin and end. The elements have the format:

   function shortest-duration-in-beam time-signature

where

    function = begin or end
    shortest-duration-in-beam = numerator denominator; eg: 1 16
    time-signature = numerator denominator, eg: 4 4

unspecified or wildcard entries for duration or time-signature
are given by * *

The user can override beam begin or end time by pushing a wildcard entries
'(begin * * * *) or '(end * * * *) resp., eg:

    property Voice.autoBeamSettings push #'(end * * * *) = #(make-moment 1 4)

The head of the list:
    '(
((end * * 3 2) . ,(make-moment 1 2))
((end 1 16 3 2) . ,(make-moment 1 4))
((end 1 32 3 2) . ,(make-moment 1 8))
     ...
    )

Auto_beam_engraver is part of contexts: Grace and Voice

Beam_engraver

Handles Beam_requests by engraving Beams. If omitted, then notes will be printed with flags instead of beams.

Properties

beamMelismaBusy (boolean):

Signal if a beam is set when automaticMelismata is set

Beam_engraver is part of contexts: Grace and Voice

Stem_engraver

Create stems and single-stem tremolos. It also works together with the beam engraver for overriding beaming.

Properties

tremoloFlags (integer):

Number of tremolo flags to add if none 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):

idem, for the right side.

Stem_engraver is part of contexts: Grace and Voice

Dot_column_engraver

Engraves 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 grobs: DotColumn.

Dot_column_engraver is part of contexts: Voice

Breathing_sign_engraver

This engraver creates the following grobs: BreathingSign.

Breathing_sign_engraver is part of contexts: Voice

Property_engraver

This is a engraver that converts property settings into back-end grob-property settings. Example: Voice.stemLength will set #'length in all Stem objects.

Due to CPU and memory requirements, the use of this engraver is deprecated.

Properties

Generic_property_list (list):

description of the conversion.

Defines names and types for generic properties. These are properties than can be plugged into the backend directly. See the init file generic-property.scm for details. For internal use only, deprecated.

Property_engraver is part of contexts: Lyrics, PianoStaff, GrandStaff, Grace, Thread, RhythmicStaff, Voice, Staff and ChordNames

Text_spanner_engraver

Create text spanner from a Span_req

This engraver creates the following grobs: TextSpanner.

Text_spanner_engraver is part of contexts: Voice

Multi_measure_rest_engraver

Engraves multi-measure rests that are produced with R. Reads measurePosition and currentBarNumber to determine what number to print over the MultiMeasureRest

Properties

currentBarNumber (integer):

Contains the current barnumber. This property is incremented at every barline.

currentCommandColumn (grob (GRaphical OBject)):

Grob that is X-parent to all current breakable (clef, key signature, etc.) items.

measurePosition (moment):

How much of the current measure (measured in whole notes) have we had. This can be set manually to create incomplete measures (anacrusis, upbeat), the start of the music.

Multi_measure_rest_engraver is part of contexts: Voice

Arpeggio_engraver

Generate an Arpeggio from a Arpeggio_req

This engraver creates the following grobs: Arpeggio.

Arpeggio_engraver is part of contexts: Voice

Output_property_engraver

Interpret Music of Output_property type, and apply a function to any Graphic objects that satisfies the predicate.

Output_property_engraver is part of contexts: Grace, Thread, RhythmicStaff, Voice, Staff, Score, ChordNames, InnerStaffGroup and StaffGroup

Voice_devnull_engraver

Kill off certain items and spanners if we're Voice `two' and unison or unisilence is set.

Voice_devnull_engraver is part of contexts: Voice

Please send GNU LilyPond questions and comments to lilypond-user@gnu.org.

Please send comments on these web pages to lilypond@packages.debian.org

Copyright (c) 1997--2001 Han-Wen Nienhuys and Jan Nieuwenhuizen.

Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.