LilyPond – Internals Reference ¶

1.1.1 AbsoluteDynamicEvent ¶

Create a dynamic mark.

Syntax: note\x, where \x is a dynamic mark like \ppp or \sfz. A complete list is in file ly/dynamic-scripts-init.ly.

Properties:

name (symbol):

'AbsoluteDynamicEvent

Name of this music object.

types (list):

'(post-event
   event
   dynamic-event
   absolute-dynamic-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.2 AdHocJumpEvent ¶

Insert a JumpScript.

Syntax: \jump markup

Example: \jump "Gavotte I D.C."

Properties:

name (symbol):

'AdHocJumpEvent

Name of this music object.

types (list):

'(ad-hoc-jump-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.3 AdHocMarkEvent ¶

Insert markup as a rehearsal mark without advancing the rehearsal mark sequence.

Syntax: \mark markup

Example: \mark "A"

Properties:

name (symbol):

'AdHocMarkEvent

Name of this music object.

types (list):

'(ad-hoc-mark-event mark-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.4 AlternativeEvent ¶

Create an alternative event.

Properties:

name (symbol):

'AlternativeEvent

Name of this music object.

types (list):

'(alternative-event structural-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.5 AnnotateOutputEvent ¶

Print an annotation of an output element.

Properties:

name (symbol):

'AnnotateOutputEvent

Name of this music object.

types (list):

'(event annotate-output-event post-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.6 ApplyContext ¶

Call the argument with the current context during interpreting phase.

Properties:

iterator-ctor (procedure):

ly:apply-context-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'ApplyContext

Name of this music object.

types (list):

'(apply-context)

The types of this music object; determines by what engraver this music expression is processed.

1.1.7 ApplyOutputEvent ¶

Call the argument with all current grobs during interpreting phase.

Syntax: \applyOutput #'context func

Arguments to func are 1. the grob, 2. the originating context, and 3. the context where func is called.

Properties:

name (symbol):

'ApplyOutputEvent

Name of this music object.

types (list):

'(event apply-output-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.8 ArpeggioEvent ¶

Arpeggiate this chord.

Syntax: note-\arpeggio

Properties:

name (symbol):

'ArpeggioEvent

Name of this music object.

types (list):

'(post-event arpeggio-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.9 ArticulationEvent ¶

Add an articulation marking to a note.

Syntax: notexy, where x is a direction (^ for up or _ for down), or LilyPond’s choice (no direction specified), and where y is an articulation (such as -., ->, \tenuto, \downbow). See the Notation Reference for details.

Properties:

name (symbol):

'ArticulationEvent

Name of this music object.

types (list):

'(post-event
   event
   articulation-event
   script-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.10 BarCheckEvent ¶

Check whether this music coincides with the start of the measure.

Properties:

name (symbol):

'BarCheckEvent

Name of this music object.

types (list):

'(bar-check-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.11 BarEvent ¶

Force a bar line.

Syntax: \bar type

Example: \bar "!"

Properties:

name (symbol):

'BarEvent

Name of this music object.

types (list):

'(bar-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.12 BassFigureEvent ¶

Print a bass-figure text.

Properties:

name (symbol):

'BassFigureEvent

Name of this music object.

types (list):

'(event rhythmic-event bass-figure-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.13 BeamBreakEvent ¶

Manual control over whether to connect or disconnect auto-beam groups.

Properties:

name (symbol):

'BeamBreakEvent

Name of this music object.

types (list):

'(event beam-break-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.14 BeamEvent ¶

Start or stop a beam.

Syntax for manual control: c8-[ c c-] c8

Properties:

name (symbol):

'BeamEvent

Name of this music object.

types (list):

'(post-event event beam-event span-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.15 BeamForbidEvent ¶

Specify that a note must not be auto-beamed.

Properties:

name (symbol):

'BeamForbidEvent

Name of this music object.

types (list):

'(post-event event beam-forbid-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.16 BendAfterEvent ¶

A drop/fall/doit jazz articulation.

Properties:

name (symbol):

'BendAfterEvent

Name of this music object.

types (list):

'(post-event bend-after-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.17 BendSpanEvent ¶

Used to signal where a bend spanner starts and stops.

Properties:

name (symbol):

'BendSpanEvent

Name of this music object.

types (list):

'(bend-span-event post-event span-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.18 BreakDynamicSpanEvent ¶

End an alignment spanner for dynamics here.

Properties:

name (symbol):

'BreakDynamicSpanEvent

Name of this music object.

types (list):

'(post-event
   break-span-event
   break-dynamic-span-event
   event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.19 BreathingEvent ¶

A short span of silence that shortens the previous note.

Syntax: note\breathe

Properties:

midi-length (procedure):

breathe::midi-length

Function to determine how long to play a note in MIDI. It should take a moment (the written length of the note) and a context, and return a moment (the length to play the note).

name (symbol):

'BreathingEvent

Name of this music object.

types (list):

'(event breathing-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.20 CaesuraEvent ¶

A short span of silence that does not shorten the previous note.

Syntax: note\caesura

Properties:

name (symbol):

'CaesuraEvent

Name of this music object.

types (list):

'(caesura-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.21 ChordSlurEvent ¶

Do not arpeggiate this chord. This is similar to See NonArpeggiatoEvent with the acknowledgment that performing all notes simultaneously might be impossible.

Syntax: note-\chordSlur

Properties:

name (symbol):

'ChordSlurEvent

Name of this music object.

types (list):

'(post-event chord-slur-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.22 ClusterNoteEvent ¶

A note that is part of a cluster.

Properties:

iterator-ctor (procedure):

ly:rhythmic-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'ClusterNoteEvent

Name of this music object.

types (list):

'(cluster-note-event
   melodic-event
   rhythmic-event
   event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.23 CodaMarkEvent ¶

Add a coda mark.

Properties:

name (symbol):

'CodaMarkEvent

Name of this music object.

types (list):

'(coda-mark-event structural-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.24 CompletizeExtenderEvent ¶

Used internally to signal the end of a lyrics block to ensure extenders are completed correctly when a Lyrics context ends before its associated Voice context.

Properties:

name (symbol):

'CompletizeExtenderEvent

Name of this music object.

types (list):

'(completize-extender-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.25 ContextChange ¶

Change staves in Piano staff.

Syntax: \change Staff = new-id

Properties:

iterator-ctor (procedure):

ly:change-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'ContextChange

Name of this music object.

types (list):

'(translator-change-instruction)

The types of this music object; determines by what engraver this music expression is processed.

1.1.26 ContextSpeccedMusic ¶

Interpret the argument music within a specific context.

Properties:

iterator-ctor (procedure):

ly:context-specced-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-wrapper::length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'ContextSpeccedMusic

Name of this music object.

start-callback (procedure):

ly:music-wrapper::start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(context-specification music-wrapper-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.27 CrescendoEvent ¶

Begin or end a crescendo.

Syntax: note\< … note\!

An alternative syntax is note\cr … note\endcr.

Properties:

name (symbol):

'CrescendoEvent

Name of this music object.

types (list):

'(post-event
   span-event
   span-dynamic-event
   crescendo-event
   event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.28 DalSegnoEvent ¶

Add a D.S. or similar instruction.

Properties:

name (symbol):

'DalSegnoEvent

Name of this music object.

types (list):

'(dal-segno-event structural-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.29 DecrescendoEvent ¶

Begin or end a decrescendo.

Syntax: note\> … note\!

An alternative syntax is note\decr … note\enddecr.

Properties:

name (symbol):

'DecrescendoEvent

Name of this music object.

types (list):

'(post-event
   span-event
   span-dynamic-event
   decrescendo-event
   event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.30 DoublePercentEvent ¶

Used internally to signal double percent repeats.

Properties:

name (symbol):

'DoublePercentEvent

Name of this music object.

types (list):

'(event double-percent-event rhythmic-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.31 DurationLineEvent ¶

Initiate a duration line.

Syntax: note\-

Properties:

name (symbol):

'DurationLineEvent

Name of this music object.

types (list):

'(duration-line-event post-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.32 EpisemaEvent ¶

Begin or end an episema.

Properties:

name (symbol):

'EpisemaEvent

Name of this music object.

types (list):

'(post-event span-event event episema-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.33 Event ¶

Unspecified music event.

Properties:

name (symbol):

'Event

Name of this music object.

types (list):

'(event)

The types of this music object; determines by what engraver this music expression is processed.

void (boolean):

#t

If this property is #t, then the music expression is to be discarded by the top-level music handler.

1.1.34 EventChord ¶

Explicitly entered chords.

When iterated, elements are converted to events at the current timestep, followed by any articulations. Per-chord postevents attached by the parser just follow any rhythmic events in elements instead of utilizing articulations.

An unexpanded chord repetition ‘q’ is recognizable by having its duration stored in duration.

Properties:

iterator-ctor (procedure):

ly:event-chord-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-sequence::event-chord-length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'EventChord

Name of this music object.

to-relative-callback (procedure):

ly:music-sequence::event-chord-relative-callback

How to transform a piece of music to relative pitches.

types (list):

'(event-chord)

The types of this music object; determines by what engraver this music expression is processed.

1.1.35 ExtenderEvent ¶

Extend lyrics.

Properties:

name (symbol):

'ExtenderEvent

Name of this music object.

types (list):

'(post-event extender-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.36 FineEvent ¶

End the performance, not necessarily at the written end of the music.

Properties:

iterator-ctor (procedure):

ly:fine-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'FineEvent

Name of this music object.

types (list):

'(fine-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.37 FingerGlideEvent ¶

Initiate a line connecting two equal fingerings. This line represents a finger gliding on a string.

Syntax: note\glide-finger

Properties:

name (symbol):

'FingerGlideEvent

Name of this music object.

types (list):

'(finger-glide-event post-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.38 FingeringEvent ¶

Specify what finger to use for this note.

Properties:

name (symbol):

'FingeringEvent

Name of this music object.

types (list):

'(post-event fingering-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.39 FootnoteEvent ¶

Footnote a grob.

Properties:

name (symbol):

'FootnoteEvent

Name of this music object.

types (list):

'(event footnote-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.40 GlissandoEvent ¶

Start a glissando on this note.

Properties:

name (symbol):

'GlissandoEvent

Name of this music object.

types (list):

'(post-event glissando-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.41 GraceMusic ¶

Interpret the argument as grace notes.

Properties:

iterator-ctor (procedure):

ly:grace-iterator::constructor

Function to construct a music-event-iterator object for this music.

length (moment):

#<Mom 0>

The endpoint of this music. This property is unhappily named in that it does not account for any initial grace notes: the full length of the music is length minus the start time. A value of INF-MOMENT indicates indefinite length.

name (symbol):

'GraceMusic

Name of this music object.

start-callback (procedure):

ly:grace-music::start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(grace-music music-wrapper-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.42 HarmonicEvent ¶

Mark a note as harmonic.

Properties:

name (symbol):

'HarmonicEvent

Name of this music object.

types (list):

'(post-event event harmonic-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.43 HyphenEvent ¶

A hyphen between lyric syllables.

Properties:

name (symbol):

'HyphenEvent

Name of this music object.

types (list):

'(post-event hyphen-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.44 InitialContextMusic ¶

Enter the initial context of the argument and ignore the rest of it.

Syntax: \initialContextFrom music

Properties:

iterator-ctor (procedure):

ly:initial-context-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

length (moment):

#<Mom 0>

The endpoint of this music. This property is unhappily named in that it does not account for any initial grace notes: the full length of the music is length minus the start time. A value of INF-MOMENT indicates indefinite length.

name (symbol):

'InitialContextMusic

Name of this music object.

to-relative-callback (procedure):

ly:relative-octave-music::no-relative-callback

How to transform a piece of music to relative pitches.

types (list):

'(initial-context-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.45 KeyChangeEvent ¶

Change the key signature.

Syntax: \key name scale

Properties:

name (symbol):

'KeyChangeEvent

Name of this music object.

to-relative-callback (procedure):

#<procedure at lily/define-music-types.scm:352:33 (x p)>

How to transform a piece of music to relative pitches.

types (list):

'(key-change-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.46 LabelEvent ¶

Place a bookmarking label.

Properties:

name (symbol):

'LabelEvent

Name of this music object.

types (list):

'(label-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.47 LaissezVibrerEvent ¶

Don’t damp this chord.

Syntax: note\laissezVibrer

Properties:

name (symbol):

'LaissezVibrerEvent

Name of this music object.

types (list):

'(post-event event laissez-vibrer-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.48 LigatureEvent ¶

Start or end a ligature.

Properties:

name (symbol):

'LigatureEvent

Name of this music object.

types (list):

'(span-event ligature-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.49 LineBreakEvent ¶

Allow, forbid or force a line break.

Properties:

name (symbol):

'LineBreakEvent

Name of this music object.

types (list):

'(line-break-event break-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.50 LyricCombineMusic ¶

Align lyrics to the start of notes.

Syntax: \lyricsto voicename lyrics

Properties:

iterator-ctor (procedure):

ly:lyric-combine-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

length (moment):

#<Mom infinity>

The endpoint of this music. This property is unhappily named in that it does not account for any initial grace notes: the full length of the music is length minus the start time. A value of INF-MOMENT indicates indefinite length.

name (symbol):

'LyricCombineMusic

Name of this music object.

types (list):

'(lyric-combine-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.51 LyricEvent ¶

A lyric syllable. Must be entered in lyrics mode, i.e., \lyrics { twinkle4 twinkle4 } .

Properties:

iterator-ctor (procedure):

ly:rhythmic-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'LyricEvent

Name of this music object.

types (list):

'(rhythmic-event lyric-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.52 MeasureCounterEvent ¶

Used to signal the start and end of a measure count.

Properties:

name (symbol):

'MeasureCounterEvent

Name of this music object.

types (list):

'(measure-counter-event span-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.53 MeasureSpannerEvent ¶

Used to signal the start and end of a measure spanner.

Properties:

name (symbol):

'MeasureSpannerEvent

Name of this music object.

types (list):

'(measure-spanner-event span-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.54 MultiMeasureArticulationEvent ¶

Articulations on multi-measure rests.

Properties:

name (symbol):

'MultiMeasureArticulationEvent

Name of this music object.

types (list):

'(post-event
   event
   multi-measure-articulation-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.55 MultiMeasureRestEvent ¶

Used internally by MultiMeasureRestMusic to signal rests.

Properties:

iterator-ctor (procedure):

ly:rhythmic-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'MultiMeasureRestEvent

Name of this music object.

types (list):

'(event rhythmic-event
        general-rest-event
        multi-measure-rest-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.56 MultiMeasureRestMusic ¶

Rests that may be compressed into multi-measure rests.

Syntax: R2.*4 for 4 measures in 3/4 time.

Properties:

elements-callback (procedure):

mm-rest-child-list

Return a list of children, for use by a sequential iterator. Takes a single music parameter.

iterator-ctor (procedure):

ly:sequential-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'MultiMeasureRestMusic

Name of this music object.

types (list):

'(multi-measure-rest)

The types of this music object; determines by what engraver this music expression is processed.

1.1.57 MultiMeasureTextEvent ¶

Texts on multi-measure rests.

Syntax: R-\markup { "bla" }

Properties:

name (symbol):

'MultiMeasureTextEvent

Name of this music object.

types (list):

'(post-event event multi-measure-text-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.58 Music ¶

Unspecified music expression.

Properties:

iterator-ctor (procedure):

ly:music-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'Music

Name of this music object.

types (list):

'()

The types of this music object; determines by what engraver this music expression is processed.

void (boolean):

#t

If this property is #t, then the music expression is to be discarded by the top-level music handler.

1.1.59 NonArpeggiatoEvent ¶

Do not arpeggiate this chord.

Syntax: note-\nonArpeggiato

Properties:

name (symbol):

'NonArpeggiatoEvent

Name of this music object.

types (list):

'(post-event non-arpeggiato-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.60 NoteEvent ¶

A note.

Outside of chords, any events in articulations with a listener are broadcast like chord articulations, the others are retained.

For iteration inside of chords, See EventChord.

Properties:

iterator-ctor (procedure):

ly:rhythmic-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'NoteEvent

Name of this music object.

types (list):

'(event note-event rhythmic-event melodic-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.61 NoteGroupingEvent ¶

Start or stop grouping brackets.

Properties:

name (symbol):

'NoteGroupingEvent

Name of this music object.

types (list):

'(post-event event note-grouping-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.62 OptionalMaterialEvent ¶

Start or stop optional material.

Properties:

name (symbol):

'OptionalMaterialEvent

Name of this music object.

types (list):

'(optional-material-event span-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.63 OttavaEvent ¶

Start or stop an ottava bracket.

Properties:

name (symbol):

'OttavaEvent

Name of this music object.

types (list):

'(ottava-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.64 OverrideProperty ¶

Extend the definition of a graphical object.

Syntax: \override [ context . ] object property = value

Properties:

iterator-ctor (procedure):

ly:push-property-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'OverrideProperty

Name of this music object.

types (list):

'(layout-instruction-event
   override-property-event)

The types of this music object; determines by what engraver this music expression is processed.

untransposable (boolean):

#t

If set, this music is not transposed.

1.1.65 PageBreakEvent ¶

Allow, forbid or force a page break.

Properties:

name (symbol):

'PageBreakEvent

Name of this music object.

types (list):

'(break-event page-break-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.66 PageTurnEvent ¶

Allow, forbid or force a page turn.

Properties:

name (symbol):

'PageTurnEvent

Name of this music object.

types (list):

'(break-event page-turn-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.67 PartCombineEvent ¶

Announce partcombine status change, such as aDue, soloI, or soloII, based on value of property part-combine-status.

Properties:

name (symbol):

'PartCombineEvent

Name of this music object.

types (list):

'(event part-combine-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.68 PartCombineMusic ¶

Combine two parts on a staff, either merged or as separate voices.

Properties:

iterator-ctor (procedure):

ly:part-combine-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-sequence::maximum-length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'PartCombineMusic

Name of this music object.

start-callback (procedure):

ly:music-sequence::minimum-start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(part-combine-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.69 PartialEvent ¶

An event announcing a partial measure.

Properties:

name (symbol):

'PartialEvent

Name of this music object.

types (list):

'(partial-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.70 PartialSet ¶

Create an anacrusis or upbeat (partial measure).

Properties:

elements-callback (procedure):

make-partial-set

Return a list of children, for use by a sequential iterator. Takes a single music parameter.

iterator-ctor (procedure):

ly:sequential-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-sequence::cumulative-length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'PartialSet

Name of this music object.

types (list):

'(partial-set)

The types of this music object; determines by what engraver this music expression is processed.

1.1.71 PercentEvent ¶

Used internally to signal percent repeats.

Properties:

name (symbol):

'PercentEvent

Name of this music object.

types (list):

'(event percent-event rhythmic-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.72 PercentRepeatedMusic ¶

Repeats encoded by percents and slashes.

Properties:

elements-callback (procedure):

make-percent-set

Return a list of children, for use by a sequential iterator. Takes a single music parameter.

iterator-ctor (procedure):

ly:percent-repeat-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:calculated-sequential-music::length

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'PercentRepeatedMusic

Name of this music object.

start-callback (procedure):

ly:calculated-sequential-music::start

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(repeated-music percent-repeated-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.73 PhrasingSlurEvent ¶

Start or end phrasing slur.

Syntax: note\( and note\)

Properties:

name (symbol):

'PhrasingSlurEvent

Name of this music object.

types (list):

'(post-event span-event event phrasing-slur-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.74 PolymetricTimeSignatureEvent ¶

An event created when setting a new time signature

Properties:

name (symbol):

'PolymetricTimeSignatureEvent

Name of this music object.

types (list):

'(event time-signature-event
        polymetric-time-signature-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.75 PolymetricTimeSignatureMusic ¶

Set a new time signature

Properties:

duration (duration):

#<Duration 1 >

Duration of this note or lyric.

elements-callback (procedure):

make-time-signature-set

Return a list of children, for use by a sequential iterator. Takes a single music parameter.

iterator-ctor (procedure):

ly:sequential-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-sequence::cumulative-length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'PolymetricTimeSignatureMusic

Name of this music object.

types (list):

'(time-signature-music
   polymetric-time-signature-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.76 PostEvents ¶

Container for several postevents.

This can be used to package several events into a single one. Should not be seen outside of the parser.

Properties:

name (symbol):

'PostEvents

Name of this music object.

types (list):

'(post-event post-event-wrapper)

The types of this music object; determines by what engraver this music expression is processed.

1.1.77 PropertySet ¶

Set a context property.

Syntax: \set context.prop = scheme-val

Properties:

iterator-ctor (procedure):

ly:property-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'PropertySet

Name of this music object.

types (list):

'(layout-instruction-event)

The types of this music object; determines by what engraver this music expression is processed.

untransposable (boolean):

#t

If set, this music is not transposed.

1.1.78 PropertyUnset ¶

Restore the default setting for a context property. See PropertySet.

Syntax: \unset context.prop

Properties:

iterator-ctor (procedure):

ly:property-unset-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'PropertyUnset

Name of this music object.

types (list):

'(layout-instruction-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.79 QuoteMusic ¶

Quote preprocessed snippets of music.

Properties:

iterator-ctor (procedure):

ly:music-wrapper-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-wrapper::length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'QuoteMusic

Name of this music object.

start-callback (procedure):

ly:music-wrapper::start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(music-wrapper-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.80 ReferenceTimeSignatureEvent ¶

An event created when setting a new time signature

Properties:

name (symbol):

'ReferenceTimeSignatureEvent

Name of this music object.

types (list):

'(event time-signature-event
        reference-time-signature-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.81 ReferenceTimeSignatureMusic ¶

Set a new time signature

Properties:

elements-callback (procedure):

make-time-signature-set

Return a list of children, for use by a sequential iterator. Takes a single music parameter.

iterator-ctor (procedure):

ly:sequential-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'ReferenceTimeSignatureMusic

Name of this music object.

types (list):

'(time-signature-music
   reference-time-signature-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.82 RehearsalMarkEvent ¶

Insert a rehearsal mark.

Syntax: \mark marker

Example: \mark 3

Properties:

name (symbol):

'RehearsalMarkEvent

Name of this music object.

types (list):

'(rehearsal-mark-event mark-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.83 RelativeOctaveCheck ¶

Check if a pitch is in the correct octave.

Properties:

name (symbol):

'RelativeOctaveCheck

Name of this music object.

to-relative-callback (procedure):

ly:relative-octave-check::relative-callback

How to transform a piece of music to relative pitches.

types (list):

'(relative-octave-check)

The types of this music object; determines by what engraver this music expression is processed.

1.1.84 RelativeOctaveMusic ¶

Music in which the assignment of octaves is complete.

Properties:

iterator-ctor (procedure):

ly:music-wrapper-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-wrapper::length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'RelativeOctaveMusic

Name of this music object.

start-callback (procedure):

ly:music-wrapper::start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

to-relative-callback (procedure):

ly:relative-octave-music::relative-callback

How to transform a piece of music to relative pitches.

types (list):

'(music-wrapper-music relative-octave-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.85 RepeatSlashEvent ¶

Used internally to signal beat repeats.

Properties:

name (symbol):

'RepeatSlashEvent

Name of this music object.

types (list):

'(event repeat-slash-event rhythmic-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.86 RepeatTieEvent ¶

Ties for starting a second volta bracket.

Properties:

name (symbol):

'RepeatTieEvent

Name of this music object.

types (list):

'(post-event event repeat-tie-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.87 RestEvent ¶

A Rest.

Syntax: r4 for a quarter rest.

Properties:

iterator-ctor (procedure):

ly:rhythmic-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'RestEvent

Name of this music object.

types (list):

'(event rhythmic-event
        general-rest-event
        rest-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.88 RevertProperty ¶

The opposite of OverrideProperty: remove a previously added property from a graphical object definition.

Properties:

iterator-ctor (procedure):

ly:pop-property-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'RevertProperty

Name of this music object.

types (list):

'(layout-instruction-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.89 ScriptEvent ¶

Add an articulation mark to a note.

Properties:

name (symbol):

'ScriptEvent

Name of this music object.

types (list):

'(event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.90 SectionEvent ¶

Add a section division, which is typically written as a thin double bar line.

Properties:

name (symbol):

'SectionEvent

Name of this music object.

types (list):

'(section-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.91 SectionLabelEvent ¶

Mark the beginning of a named passage. Does not imply a section division.

Properties:

name (symbol):

'SectionLabelEvent

Name of this music object.

types (list):

'(section-label-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.92 SegnoMarkEvent ¶

Add a segno mark or bar line.

Properties:

name (symbol):

'SegnoMarkEvent

Name of this music object.

types (list):

'(segno-mark-event structural-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.93 SegnoRepeatedMusic ¶

Repeats with alternatives placed sequentially and marked with segno, Coda, D.C., etc.

Properties:

elements-callback (procedure):

make-volta-set

Return a list of children, for use by a sequential iterator. Takes a single music parameter.

iterator-ctor (procedure):

ly:volta-repeat-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:calculated-sequential-music::length

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'SegnoRepeatedMusic

Name of this music object.

start-callback (procedure):

ly:calculated-sequential-music::start

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(segno-repeated-music
   folded-repeated-music
   repeated-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.94 SequentialAlternativeMusic ¶

Repeat alternatives in sequence.

Syntax: \alternative { alternatives }

Properties:

elements-callback (procedure):

#<procedure at lily/define-music-types.scm:696:30 (m)>

Return a list of children, for use by a sequential iterator. Takes a single music parameter.

iterator-ctor (procedure):

ly:alternative-sequence-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-sequence::cumulative-length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'SequentialAlternativeMusic

Name of this music object.

start-callback (procedure):

ly:music-sequence::first-start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(sequential-music sequential-alternative-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.95 SequentialMusic ¶

Music expressions concatenated.

Syntax: \sequential { … } or simply { … }

Properties:

elements-callback (procedure):

#<procedure at lily/define-music-types.scm:709:30 (m)>

Return a list of children, for use by a sequential iterator. Takes a single music parameter.

iterator-ctor (procedure):

ly:sequential-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-sequence::cumulative-length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'SequentialMusic

Name of this music object.

start-callback (procedure):

ly:music-sequence::first-start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(sequential-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.96 SimultaneousMusic ¶

Music playing together.

Syntax: \simultaneous { … } or << … >>

Properties:

iterator-ctor (procedure):

ly:simultaneous-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-sequence::maximum-length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'SimultaneousMusic

Name of this music object.

start-callback (procedure):

ly:music-sequence::minimum-start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

to-relative-callback (procedure):

ly:music-sequence::simultaneous-relative-callback

How to transform a piece of music to relative pitches.

types (list):

'(simultaneous-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.97 SkipEvent ¶

Filler that takes up duration, but does not print anything.

Syntax: s4 for a skip equivalent to a quarter rest.

Properties:

iterator-ctor (procedure):

ly:rhythmic-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'SkipEvent

Name of this music object.

types (list):

'(event rhythmic-event skip-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.98 SkipMusic ¶

Filler that takes up duration, does not print anything, and also does not create staves or voices implicitly.

Syntax: \skip duration

Properties:

iterator-ctor (procedure):

ly:simple-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

name (symbol):

'SkipMusic

Name of this music object.

types (list):

'(event skip-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.99 SkippedMusic ¶

Filler that takes up duration, does not print anything, and also does not create staves or voices implicitly.

Syntax: \skip music

Properties:

iterator-ctor (procedure):

ly:simple-music-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-wrapper::length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'SkippedMusic

Name of this music object.

start-callback (procedure):

ly:music-wrapper::start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(skipped-music music-wrapper-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.100 SlurEvent ¶

Start or end slur.

Syntax: note( and note)

Properties:

name (symbol):

'SlurEvent

Name of this music object.

types (list):

'(post-event span-event event slur-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.101 SostenutoEvent ¶

Depress or release sostenuto pedal.

Properties:

name (symbol):

'SostenutoEvent

Name of this music object.

types (list):

'(post-event event pedal-event sostenuto-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.102 SpacingSectionEvent ¶

Start a new spacing section.

Properties:

name (symbol):

'SpacingSectionEvent

Name of this music object.

types (list):

'(event spacing-section-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.103 SpanEvent ¶

Event for anything that is started at a different time than stopped.

Properties:

name (symbol):

'SpanEvent

Name of this music object.

types (list):

'(event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.104 StaffHighlightEvent ¶

Start or stop a staff highlight.

Syntax: \staffHighlight, \stopStaffHighlight.

Properties:

name (symbol):

'StaffHighlightEvent

Name of this music object.

types (list):

'(staff-highlight-event span-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.105 StaffSpanEvent ¶

Start or stop a staff symbol.

Properties:

name (symbol):

'StaffSpanEvent

Name of this music object.

types (list):

'(event span-event staff-span-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.106 StanzaEvent ¶

Set and display a stanza number in lyrics.

Syntax: \stanza markup.

Properties:

name (symbol):

'StanzaEvent

Name of this music object.

types (list):

'(stanza-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.107 StringNumberEvent ¶

Specify on which string to play this note.

Syntax: \number

Properties:

name (symbol):

'StringNumberEvent

Name of this music object.

types (list):

'(post-event string-number-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.108 StrokeFingerEvent ¶

Specify with which finger to pluck a string.

Syntax: \rightHandFinger text

Properties:

name (symbol):

'StrokeFingerEvent

Name of this music object.

types (list):

'(post-event stroke-finger-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.109 SustainEvent ¶

Depress or release sustain pedal.

Properties:

name (symbol):

'SustainEvent

Name of this music object.

types (list):

'(post-event event pedal-event sustain-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.110 TempoChangeEvent ¶

A metronome mark or tempo indication.

Properties:

name (symbol):

'TempoChangeEvent

Name of this music object.

types (list):

'(event tempo-change-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.111 TempoGradualChangeEvent ¶

Begin a gradual change in tempo.

Properties:

name (symbol):

'TempoGradualChangeEvent

Name of this music object.

types (list):

'(event span-event tempo-gradual-change-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.112 TextMarkEvent ¶

A textual mark.

Syntax: \textMark markup or \textEndMark markup.

Properties:

name (symbol):

'TextMarkEvent

Name of this music object.

types (list):

'(text-mark-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.113 TextScriptEvent ¶

Print text.

Properties:

name (symbol):

'TextScriptEvent

Name of this music object.

types (list):

'(post-event script-event text-script-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.114 TextSpanEvent ¶

Start a text spanner, for example, an octavation.

Properties:

name (symbol):

'TextSpanEvent

Name of this music object.

types (list):

'(post-event span-event event text-span-event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.115 TieEvent ¶

A tie.

Syntax: note-~

Properties:

name (symbol):

'TieEvent

Name of this music object.

types (list):

'(post-event tie-event event)

The types of this music object; determines by what engraver this music expression is processed.

1.1.116 TimeScaledMusic ¶

Multiply durations, as in tuplets.

Syntax: \times fraction music, e.g., \times 2/3 { … } for triplets.

Properties:

iterator-ctor (procedure):

ly:tuplet-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-wrapper::length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'TimeScaledMusic

Name of this music object.

start-callback (procedure):

ly:music-wrapper::start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

types (list):

'(time-scaled-music)

The types of this music object; determines by what engraver this music expression is processed.

1.1.117 TransposedMusic ¶

Music that has been transposed.

Properties:

iterator-ctor (procedure):

ly:music-wrapper-iterator::constructor

Function to construct a music-event-iterator object for this music.

length-callback (procedure):

ly:music-wrapper::length-callback

How to compute the duration of this music. This property can only be defined as initializer in scm/define-music-types.scm.

name (symbol):

'TransposedMusic

Name of this music object.

start-callback (procedure):

ly:music-wrapper::start-callback

Function to compute the negative length of starting grace notes. This property can only be defined as initializer in scm/define-music-types.scm.

to-relative-callback (procedure):

ly:relative-octave-music::no-relative-callback

How to transform a piece of music to relative pitches.

types (list):

'(music-wrapper-music transposed-music)

The types of this music object; determines by what engraver this music expression is processed.