[Top][Contents][Index][ ? ] |
LilyPond Regression Tests
[ << Top ] | [Top][Contents][Index][ ? ] | [ >> ] | ||
[ < Top ] | [ Up : Top ] | [ > ] |
Introduction
This document presents proofs for LilyPond 2.13.27). When the text corresponds with the shown notation, we consider LilyPond Officially BugFree (tm). This document is intended for finding bugs and for documenting bugfixes.
In the web version of this document, you can click on the file name or figure for each example to see the corresponding input file.
TODO: order of tests (file names!), test only one feature per test. Smaller and neater tests.
[ << ] | [Top][Contents][Index][ ? ] | [ >> ] | ||
[ < ] | [ Up : Top ] | [ > ] |
Regression test cases
‘accidental-ancient.ly’
Accidentals are available in different ancient styles, which all are collected here.‘accidental-broken-tie-spacing.ly’
When a tie is broken, the spacing engine must consider the accidental after the line break, to prevent a collision from occurring.‘accidental-cautionary.ly’
Cautionary accidentals may be indicated using either parentheses (default) or smaller accidentals.‘accidental-clef-change.ly’
Accidentals are reset for clef changes.‘accidental-collision.ly’
accidentals avoid stems of other notes too.‘accidental-contemporary.ly’
Several automatic accidental rules aim to reproduce contemporary music notation practices:-
'dodecaphonic
style prints accidentals on every note (including naturals) -
'neo-modern style
prints accidentals on every note (not including naturals), except when a note is immediately repeated -
'neo-modern-cautionary
style acts like neo-modern, adding cautionary parentheses around accidentals. -
'teaching
prints accidentals normally, but adds cautionary accidentals when an accidental is already included in the key signature.
Both scores should show the same accidentals.
‘accidental-double.ly’
If two forced accidentals happen at the same time, only one sharp sign is printed.‘accidental-forced-tie-barline.ly’
Cautionary accidentals applied to tied notes after a bar line are valid for the whole measure.‘accidental-forced-tie.ly’
Accidentals can be forced with ! and ? even if the notes are tied.‘accidental-ledger.ly’
Ledger lines are shortened when there are accidentals. This happens only for the single ledger line close to the note head, and only if the accidental is horizontally close to the head.‘accidental-octave.ly’
This shows how accidentals in different octaves are handled. The note names are also automatically printed but the octavation has been dropped out.
‘accidental-piano.ly’
In piano accidental style, notes in both staves influence each other. In this example, each note should have an accidental.‘accidental-placement-samepitch.ly’
When two (or more) accidentals modify the same pitch, they are printed adjacent to one another unless they represent the same alteration, in which case they are printed in exactly the same position as one another. In either case, collisions with accidentals of different pitches are correctly computed.‘accidental-placement.ly’
Accidentals are placed as closely as possible. Accidentals in corresponding octaves are aligned. The top accidental should be nearest to the chord. The flats in a sixth should be staggered.‘accidental-quarter.ly’
Quarter tone notation is supported, including threequarters flat.‘accidental-single-double.ly’
A sharp sign after a double sharp sign, as well as a flat sign after a double flat sign is automatically prepended with a natural sign.
‘accidental-suggestions.ly’
setting thesuggestAccidentals
will print
accidentals vertically relative to the note. This is useful for
denoting Musica Ficta.
‘accidental-tie-overridden.ly’
The presence of an accidental after a broken tie can be overridden.‘accidental-tie.ly’
The second and third notes should not get accidentals, because they are tied to a note. However, an accidental is present if the line is broken at the tie, which happens for the G sharp.‘accidental-unbroken-tie-spacing.ly’
Tied accidentaled notes (which cause reminder accidentals) do not wreak havoc in the spacing when unbroken.‘accidental-voice.ly’
This shows how modern cross voice auto cautionary accidentals are handled. The first two fisses get accidentals because they belong to different voices. The first f gets cautionary natural because of previous measure. The last f gets cautionary natural because fis was only in the other voice.
‘accidental.ly’
Accidentals work: the second note does not get a sharp. The third and fourth show forced and cautionary accidentals.
‘alignment-order.ly’
Newly created contexts can be inserted anywhere in the vertical alignment.‘alignment-vertical-manual-setting.ly’
Alignments may be changed per system by settingalignment-distances
in the line-break-system-details
property
‘ambitus-gap.ly’
The gaps between anAmbitusLine
and its
note heads are set by the gap
property.
‘ambitus-percussion-staves.ly’
Adding ambitus to percussion contexts does not cause crashes, since theAmbitus_engraver
will only
acknowledge pitched note heads.
‘ambitus-pitch-ordering.ly’
Ambitus use actual pitch not lexicographic ordering.‘ambitus.ly’
Ambitus indicate pitch ranges for voices.Accidentals only show up if they’re not part of key
signature. AmbitusNoteHead
grobs also have ledger lines.
‘apply-context.ly’
With\applyContext
, \properties
can be modified
procedurally. Applications include: checking bar numbers, smart
octavation.
This example prints a bar-number during processing on stdout.
‘apply-output.ly’
The\applyOutput
expression is the most flexible way to
tune properties for individual grobs.
Here, the layout of a note head is changed depending on its vertical position.
‘arpeggio-bracket.ly’
A square bracket on the left indicates that the player should not arpeggiate the chord.
‘arpeggio-collision.ly’
Arpeggio stays clear of accidentals and flipped note heads.‘arpeggio-no-overshoot.ly’
Arpeggios do not overshoot the highest note head. The first chord in this example simulates overshoot using'positions
for comparison with the correct behaviour.
‘arpeggio-no-staff-symbol.ly’
Arpeggios stil work in the absence of a staff-symbol.‘arpeggio-parenthesis.ly’
There is a variant of the arpeggio sign that uses a ‘vertical slur’ instead of the wiggle.‘arpeggio-span-collision.ly’
Cross-staff or -voice arpeggios which include single note heads as anchors do not collide with previous note heads or prefatory material.‘arpeggio-span-one-staff.ly’
Span arpeggios within one staff also work‘arpeggio.ly’
Arpeggios are supported, both cross-staff and broken single staff.
‘articulation-snappizzicato.ly’
The snappizzicato articulation adds a snappizzicato sign to the note.‘augmentum.ly’
Augmentum dots are accounted for in horizontal spacing.‘auto-beam-bar.ly’
No auto beams will be put over (manual) repeat bars.‘auto-beam-beaming-override.ly’
Autobeamer rememberssubdivideBeams
and other
beaming pattern related functions at the start of an autobeam.
‘auto-beam-breathe.ly’
Automatic beams are ended early if a breathing sign is encountered.‘auto-beam-no-beam.ly’
The autobeamer may be switched off for a single note with\noBeam
.
‘auto-beam-partial.ly’
Autobeaming works properly in partial measures.‘auto-beam-recheck.ly’
In 4/4 time, the first and second and third and fourth beats should be beamed together if only eighth notes are involved. If any shorter notes are included, each beat should be beamed separately.‘auto-beam-triplet.ly’
Automatic beaming is also done on tuplets.‘auto-beam-tuplets.ly’
Tuplet-spanner should not put (visible) brackets on beams even if they’re auto generated.‘auto-beam.ly’
Beams are placed automatically; the last measure should have a single beam.‘auto-change.ly’
Auto change piano staff switches voices between up and down staves automatically; rests are switched along with the coming note. When central C is reached, staff is not yet switched (by default).‘automatic-polyphony-context-id.ly’
The bottom-level contexts in polyphony shorthand are allocated a context id in order of creation, starting with"1"
.
This snippet will fail to compile if either voice has an invalid
context-id
string.
‘automatic-polyphony-drumstaff.ly’
In a DrumStaff, automatic polyphony can be used without explicitly initializing separate voices.‘automatic-polyphony-tabstaff.ly’
In a TabStaff, automatic polyphony can be used without explicitly initializing separate voices.‘backend-excercise.ly’
Excercise all output functions‘backend-svg.ly’
‘baerenreiter-sarabande.ly’
The Bärenreiter edition of the Cello Suites is the most beautifully typeset piece of music in our collection of music (we both own one. It is also lovely on French Horn). This piece does not include articulation, but it does follows the same beaming and linebreaking as the printed edition. This is done in order to benchmark the quality of the LilyPond output.As of lilypond 1.5.42, the spacing and beam quanting is almost identical.
There are two tweaks in this file: a line-break was forced before measure 25, we get back the linebreaking of Bärenreiter. The stem direction is forced in measure 24. The last beam of that measure is up in Bärenreiter because of context. We don’t detect that yet.
Note that the Bärenreiter edition contains a few engraving mistakes. The second line begins with measure 6 (but prints 5). The |: half way in measure 13 has been forgotten.
‘balloon.ly’
With balloon texts, objects in the output can be marked, with lines and explanatory text added.‘bar-check-redefine.ly’
The meaning of|
is stored in the
identifier pipeSymbol
.
‘bar-line-dashed.ly’
The dashes in a dashed bar line covers staff lines exactly. Dashed barlines between staves start and end on a half dash precisely.‘bar-line-dotted.ly’
The dots in a dotted bar line are in spaces.‘bar-line-segno.ly’
Segno bar lines can be used to mark the begin and the end of a segno part.‘bar-line-thick.ly’
A thick bar line is created by \bar ".", which is consistent with e.g. \bar "|."‘bar-line-tick.ly’
A ticked bar line is a short line of the same length as a staff space, centered on the top-most barline.‘bar-number.ly’
Bar numbers may be set and their padding adjusted individually. The counting of bar numbers is started after the anacrusis.To prevent clashes at the beginning of a line, the padding may have to be increased.
‘bar-scripts.ly’
Markings can be attached to (invisible) barlines.
‘beam-auto-knee.ly’
A knee is made automatically when a horizontal beam fits in a gap between note heads that is larger than a predefined threshold.‘beam-auto.ly’
There are presets for theauto-beam
engraver in the case of common
time signatures.
‘beam-beamlet-break.ly’
beamlets don’t run to end of line if there are no other beamlets on the same height.‘beam-beamlet-grace.ly’
Beamlets in grace notes remain readable.‘beam-beat-grouping.ly’
Default beaming patterns can be set for the current time signature by\setBeatGrouping
.
‘beam-break-no-bar.ly’
Broken beams have sane endings even if grobs are not present at the broken end.‘beam-break.ly’
Beams can be printed across line breaks, if forced.‘beam-center-slope.ly’
Simple beams on middle staffline are allowed to be slightly sloped, even if the notes have ledgers. Beams reaching beyond middle line can have bigger slope.‘beam-concave-chord.ly’
‘beam-concave-damped.ly’
Beams that are not strictly concave are damped according to their concaveness.‘beam-concave.ly’
Fully concave beams should be horizontal. Informally spoken, concave refers to the shape of the notes that are opposite a beam. If an up-beam has high notes on its center stems, then we call it concave.If a beam fails a test, the desired slope is printed next to it.
‘beam-cross-staff-auto-knee.ly’
Automatic cross-staff knees work also (here they were produced with explicit staff switches).‘beam-cross-staff-script.ly’
scripts don’t trigger beam formatting. If this does happen, we can have a cyclic dependency on Y-positions of staves.‘beam-cross-staff-slope.ly’
Cross staff (kneed) beams do not cause extreme slopes.‘beam-cross-staff.ly’
Beams can be typeset over fixed distance aligned staves, beam beautification does not really work, but knees do. Beams should be behave well, wherever the switching point is.
‘beam-damp.ly’
Beams are less steep than the notes they encompass.‘beam-default-lengths.ly’
Beamed stems have standard lengths if possible. Quantization is switched off in this example.‘beam-extreme.ly’
Beams should behave reasonably well, even under extreme circumstances.
Stems may be short, but noteheads should never touch the beam. Note that
under normal circumstances, these beams would get knees. Here
Beam.auto-knee-gap
was set to false.
‘beam-feather-knee-stem-length.ly’
In feathered beams, stems in knees reach up to the feathered part correctly.‘beam-feather.ly’
Specifyinggrow-direction
on a beam, will cause
feathered beaming. The \featherDurations
function can be used
to adjust note durations.
‘beam-flat-retain-direction.ly’
Even very flat but slanted patterns should give slanted beams.‘beam-forced-direction.ly’
The direction of manual beams can be forced using_
and ^
.
‘beam-french.ly’
In French style beaming, the stems do not go between beams.‘beam-funky-beamlet.ly’
Funky kneed beams with beamlets also work. The beamlets should be pointing to the note head.‘beam-funky.ly’
In complex configurations of knee beaming, according to Paul Roberts, the first stem of a beam determines the direction of the beam, and as such the way that following (kneed) stems attach to the beam. This is in disagreement with the current algorithm.‘beam-isknee.ly’
Beams can be placed across a PianoStaff
.
‘beam-knee-symmetry.ly’
Point-symmetric beams should receive the same quanting. There is no up/down bias in the quanting code.‘beam-length.ly’
Beams should look the same.
‘beam-manual-beaming.ly’
Beaming can be overidden for individual stems.‘beam-multiple-cross-staff.ly’
Kneed beams (often happens with cross-staff beams) should look good when there are multiple beams: all the beams should go on continuously at the staff change. Stems in both staves reach up to the last beam.‘beam-multiplicity-over-rests.ly’
When a beam goes over a rest, there should not be any beamlets pointing towards the rest unless absolutely necessary.‘beam-outside-beamlets.ly’
Beams may overshoot stems. This is also controlled withbreak-overshoot
.
‘beam-over-barline.ly’
Explicit beams may cross barlines.‘beam-position.ly’
Beams on ledgered notes should always reach the middle staff line. The second beam, counting from the note head side, should never be lower than the second staff line. This does not hold for grace note beams. Override withno-stem-extend
.
‘beam-quant-standard.ly’
This file tests a few standard beam quants, taken from Ted Ross’ book. If LilyPond finds another quant, the correct quant is printed over the beam.‘beam-quanting-32nd.ly’
Stem lengths take precedence over beam quants: ‘forbidden’ quants are only avoided for 32nd beams when they are outside of the staff. However, that leads to very long stems, which is even worse.‘beam-quanting-horizontal.ly’
In this test for beam quant positions for horizontal beams, staff lines should be covered in all cases. For 32nd beams, the free stem lengths are between 2 and 1.5.‘beam-quarter.ly’
Quarter notes may be beamed: the beam is halted momentarily.‘beam-rest.ly’
The number of beams does not change on a rest.‘beam-second.ly’
Engraving second intervals is tricky. We used to have problems with seconds being too steep, or getting too long stems. In a file like this, showing seconds, you’ll spot something fishy very quickly.‘beam-shortened-lengths.ly’
Beams in unnatural direction, have shortened stems, but do not look too short.‘beam-single-stem.ly’
Single stem beams are also allowed. For such beams, clip-edges is switched off automatically.‘beam-slope-stemlet.ly’
For slope calculations, stemlets are treated as invisible stems.‘beam-unconnected-beamlets.ly’
By settingmax-beam-connect
, it is
possible to create pairs of unconnected beamlets.
‘beaming-ternary-metrum.ly’
Automatic beaming works also in ternary time sigs. In this case, the 8th is a beat, so the 16ths are split into two groups. This can be avoided by overridingbeatLength
to be
three 8th notes.
‘beaming.ly’
Beaming is generated automatically. Beams may cross bar lines. In that case, line breaks are forbidden.
‘beams.ly’
Beaming can be also given explicitly.‘bend-after.ly’
Falls and doits can be created with bendAfter. They run to the next note, or to the next barline. Microtone bends (i.e. \bendAfter #3.5) are also supported.‘bend-dot.ly’
Bends avoid dots, but only if necessary.‘bookparts.ly’
A book can be split into several parts with different paper settings, using\bookpart
.
Fonts are loaded into the top-level paper. Page labels are also collected into the top-level paper.
‘break-alignment-anchor-alignment.ly’
The default callback for break-align-anchor in clefs and time/key signatures reads the break-align-anchor-aligment property to align the anchor to the extent of the break-aligned grob.‘break-alignment-anchors.ly’
The break-align-anchor property of a break-aligned grob gives the horizontal offset at which other grobs should attach.‘break.ly’
Breaks can be encouraged and discouraged using \break
and
\noBreak
.
‘breathing-sign-ancient.ly’
Gregorian chant notation sometimes also uses commas and ticks, but in smaller font size (we call it ’virgula’ and ’caesura’). However, the most common breathing signs are divisio minima/maior/maxima and finalis, the latter three looking similar to bar glyphs.
‘breathing-sign.ly’
Breathing signs are available in different tastes: commas (default), ticks, vees and ‘railroad tracks’ (caesura).
‘chord-changes.ly’
Property chordChanges: display chord names only when there’s a change in the chords scheme, but always display the chord name after a line break.‘chord-name-entry-11.ly’
The 11 is only added to major-13 if it is mentioned explicitly.‘chord-name-entry.ly’
Chords can be produced with the chordname entry code (\chordmode
mode), using a pitch and a suffix. Here,
the suffixes are printed below pitches.
‘chord-name-exceptions.ly’
The propertychordNameExceptions
can used
to store a list of special notations for specific chords.
‘chord-name-major7.ly’
The layout of the major 7 can be tuned withmajorSevenSymbol
.
‘chord-names-bass.ly’
In ignatzek inversions, a note is dropped down to act as the bass note of the chord. Bass note may be also added explicitly. Above the staff: computed chord names. Below staff: entered chord name.‘chord-names-languages.ly’
The english naming of chords (default) can be changed to german (\germanChords
replaces B and Bes to H and B), semi-german
(\semiGermanChords
replaces B and Bes to H and Bb), italian
(\italianChords
uses Do Re Mi Fa Sol La Si), or french
(\frenchChords
replaces Re to Ré).
‘chord-names-lower-case-minor.ly’
Minor chords may be printed as lowercase letters, in which case the ‘m’ suffix is omitted in the output.‘chord-repetition-relative.ly’
Chord repetition handles \relative mode: the repeated chords have the same octaves as the original one.
‘chord-repetition-script-stack.ly’
Post events such as fingerings and scripts added to a chord repetition follow the same basic stacking order as chords.‘chord-repetition.ly’
A repetition symbol can be used to repeat the previous chord and save typing. Only note events are copied: articulations, text scripts, fingerings, etc are not repeated.
‘chord-scripts.ly’
Scripts can also be attached to chord elements. They obey manual direction indicators.‘chord-tremolo-scaled-durations.ly’
Don’t allow scaled durations to confuse the tremolo beaming. The tremolos should each have 3 beams.‘chord-tremolo-short.ly’
Tremolo repeats can be constructed for short tremolos (total duration smaller than 1/4) too. Only some of the beams are connected to the stems.
‘chord-tremolo-single.ly’
Chord tremolos on a single note.‘chord-tremolo-stem-direction.ly’
Stem directions influence positioning of whole note tremolo beams.‘chord-tremolo-whole.ly’
chord tremolos don’t collide with whole notes.‘chord-tremolo.ly’
Chord tremolos look like beams, but are a kind of repeat symbol. To avoid confusion, chord tremolo beams do not reach the stems, but leave a gap. Chord tremolo beams on half notes are not ambiguous, as half notes cannot appear in a regular beam, and should reach the stems.
In this example, each tremolo lasts exactly one measure.
(To ensure that the spacing engine is not confused we add some regular notes as well.)
‘chordnames-nochord.ly’
Rests in music passed to ChordNames context display noChordSymbol. noChordSymbol is treated like a ChordName with respect to chordChanges.‘chords-funky-ignatzek.ly’
Jazz chords may have unusual combinations.‘chromatic-scales.ly’
staffLineLayoutFunction
is used to change the position of the notes.
This sets staffLineLayoutFunction
to ly:pitch-semitones
to
produce a chromatic scale with the distance between a consecutive
space and line equal to one semitone.
‘clef-oct.ly’
Octavation signs may be added to clefs. These octavation signs may be placed below or above (meaning an octave higher or lower), and can take any value, including 15 for two octaves.‘clef-ottava.ly’
Ottava brackets and clefs both modify Staff.middleCPosition, but they don’t confuse one another.‘clef-warn.ly’
Unknown clef name warning displays available clefs‘clefs.ly’
Clefs withfull-size-change
should be typeset in
full size.
‘clip-systems.ly’
Clipping snippets from a finished scoreNotes:
- If system starts and ends are included, they include extents of the System grob, eg. instrument names.
- Grace notes at the end point of the region are not included
- Regions can span multiple systems. In this case, multiple EPS files are generated.
This file needs to be run separately with -dclip-systems
; the
collated-files.html of the regression test does not adequately show
the results.
The result will be files named ‘base-from-start-to-end[-count].eps’.
‘cluster-break.ly’
Clusters behave well across line breaks.‘cluster-cross-staff.ly’
Clusters can be written across staves.‘cluster-single-note.ly’
don’t crash on single chord clusters.‘cluster-style.ly’
Clusters behave well across line breaks.‘cluster.ly’
Clusters are a device to denote that a complete range of notes is to be played.‘collision-2.ly’
Single head notes may collide.‘collision-alignment.ly’
Notes in different staves should be aligned to the left-most note, in case of collisions.‘collision-dots-invert.ly’
When notes are colliding, the resolution depends on the dots: notes with dots should go to the right, if there could be confusion to which notes the dots belong.‘collision-dots-move.ly’
If dotted note heads must remain on the left side, collision resolution moves the dots to the right.‘collision-dots-up-space-dotted.ly’
For collisions where the upper note is dotted and in a space, the upper is moved to right. This behavior can be tuned by prefer-dotted-right.‘collision-dots.ly’
Collision resolution tries to put notes with dots on the right side.‘collision-harmonic-no-dots.ly’
Collision resolution involving dotted harmonic heads succeeds when dots are hidden sincerhythmic-head-interface
will only retrieve 'dot-count
from live grobs.
‘collision-head-chords.ly’
Note heads in collisions should be merged if they have the same positions in the extreme note heads.‘collision-head-solfa-fa.ly’
The FA note (a triangle) is merged to avoid creating a block-shaped note.‘collision-heads.ly’
Open and black note heads are not merged by default.‘collision-manual.ly’
Collision resolution may be forced manually withforce-hshift
.
‘collision-merge-differently-dotted.ly’
IfNoteCollision
has
merge-differently-dotted = ##t
note
heads that have differing dot counts may be merged anyway. Dots
should not disappear when merging similar note heads.
‘collision-merge-differently-headed.ly’
Ifmerge-differently-headed
is enabled, then
open note heads may be merged with black noteheads, but only
if the black note heads are from 8th or shorter notes.
‘collision-merge-dots.ly’
When merging heads, the dots are merged too.‘collision-mesh.ly’
Oppositely stemmed chords, meshing into each other, are resolved.‘collision-seconds.ly’
Seconds do not confuse the collision algorithm too much. The best way to format this would be to merge the two Ds, but we will be happy for now if the upstem D does not collide with the downstem C.‘collision-whole.ly’
Mixed collisions with whole notes require asymmetric shifts.‘collisions.ly’
In addition to normal collision rules, there is support for polyphony, where the collisions are avoided by shifting middle voices horizontally.
‘color.ly’
Each grob can have a color assigned to it. Use the\override
and \revert
expressions to set the
color
property.
‘completion-heads-lyrics.ly’
You can put lyrics under completion heads.‘completion-heads-multiple-ties.ly’
The Completion_heads_engraver
correctly handles notes that need to be split into more than 2 parts.
‘completion-heads-polyphony-2.ly’
Complex completion heads work properly in a polyphonic environment.
‘completion-heads-polyphony.ly’
Completion heads are broken across bar lines. This was intended as a debugging tool, but it can be used to ease music entry. Completion heads are not fooled by polyphony with a different rhythm.‘completion-heads-tie.ly’
Completion heads will remember ties, so they are started on the last note of the split note.‘completion-heads-tuplets.ly’
Completion heads may be used with tuplets (and compressed music) too.
‘completion-heads.ly’
If the Note_heads_engraver
is replaced by the Completion_heads_engraver
, notes that cross bar lines are split into tied notes.
‘context-die-staff.ly’
a staff should die if there is reference to it.‘context-mod-context.ly’
Context modifications can be stored into a variable as a \with object. They can be later inserted directly into a context definition.‘context-mod-with.ly’
Context modifications can be stored into a variable as a \with object. They can be later inserted into another \with block.‘context-nested-staffgroup.ly’
Contexts of the same type can be nested.‘custos.ly’
Custodes may be engraved in various styles.‘dead-notes.ly’
Muted notes (also called dead notes) are supported within normal staves and tablature.‘display-lily-tests.ly’
This is a test of the display-lily-music unit. Problems are reported on the stderr of this run.‘dot-column-note-collision.ly’
Dots and note-heads should not collide.‘dot-column-rest-collision.ly’
Dot columns do not trigger beam slanting too early.‘dot-dot-count-override.ly’
Thedot-count
property
for Dots
can be modified by the user.
‘dot-flag-collision.ly’
Dots move to the right when a collision with the (up)flag happens.‘dot-rest-beam-trigger.ly’
Dotted rests connected with beams do not trigger premature beam calculations. In this case, the beam should be sloped, and there should be no programming_error() warnings.‘dot-rest-horizontal-spacing.ly’
The dots on a dotted rest are correctly accounted for in horizontal spacing.‘dot-up-voice-collision.ly’
in collisions, the stems of outer voice are added to the dot support of the inner voices.‘dots.ly’
Both noteheads and rests can have dots. Augmentation dots should never be printed on a staff line, but rather be shifted vertically. They should go up, but in case of multiple parts, the down stems have down shifted dots. In case of chords, all dots should be in a column. The dots follow the shift of rests when avoiding collisions.The priorities to print the dots are (ranked in importance):
- keeping dots off staff lines,
- keeping dots close to their note heads,
- moving dots in the direction specified by the voice,
- moving dots up.
‘double-repeat-default-volta.ly’
For volte, the style of double repeats can be set usingdoubleRepeatType
.
‘double-repeat.ly’
Three types of double repeat bar line are supported.‘drums.ly’
In drum notation, there is a special clef symbol, drums are placed to their own staff positions and have note heads according to the drum, an extra symbol may be attached to the drum, and the number of lines may be restricted.‘duration-identifier-compressed.ly’
The compression factor of a duration identifier is correctly accounted for by the parser.‘dynamics-alignment-breaker.ly’
Hairpins, DynamicTextSpanners and dynamics can be positioned independently using\breakDynamicSpan
, which
causes the alignment spanner to end prematurely.
‘dynamics-alignment-no-line.ly’
If the line for aDynamicTextSpanner
is hidden, the
alignment spanner for dynamics is ended early. This allows consecutive
dynamics to be unlinked.
‘dynamics-broken-hairpin.ly’
Broken crescendi should be open on one side.‘dynamics-context-textspan.ly’
Text spanners work in theDynamics
context.
‘dynamics-custom-text-spanner-postfix.ly’
Postfix functions for custom crescendo text spanners. The spanners should start on the first note of the measure. One has to use -\mycresc, otherwise the spanner start will rather be assigned to the next note.‘dynamics-glyphs.ly’
Dynamic letters are kerned, and their weight matches that of the hairpin signs. The dynamic scripts should be horizontally centered on the note head. Scripts that should appear closer to the note head (staccato, accent) are reckoned with.‘dynamics-hairpin-length.ly’
Hairpins extend to the extremes of the bound if there is no adjacent hairpin or dynamic-text. If there is, the hairpin extends to the center of the column or the bound of the text respectively.‘dynamics-line.ly’
Dynamics appear below or above the staff. If multiple dynamics are linked with (de)crescendi, they should be on the same line. Isolated dynamics may be forced up or down.‘dynamics-text-left-text-alignment.ly’
The left text of aDynamicTextSpanner
is
left-aligned to its anchor note.
‘dynamics-text-right-padding.ly’
The space between an absolute dynamic and a dynamic text span can be changed using'right-padding
.
‘dynamics-text-spanner-abs-dynamic.ly’
left attach dir for text crescendi starting on an absolute dynamic is changed, so cresc. and the absolute dynamic don’t overstrike.‘dynamics-text-spanner-padding.ly’
The 2nd half of the cresc. stays at a reasonable distance from the notes.‘dynamics-text-spanner-postfix.ly’
The \cresc, \dim and \decresc spanners are now postfix operators and produce one text spanner. Defining custom spanners is also easy. Hairpin and text crescendi can be easily mixed. \< and \> produce hairpins by default, \cresc etc. produce text spanners by default.‘dynamics-unbound-hairpin.ly’
Crescendi may start off-notes, however, they should not collapse into flat lines.‘easy-notation-accidentals.ly’
Accidentals are positioned correctly when using Easy notation.
‘easy-notation.ly’
Easy-notation (or Ez-notation) prints names in note heads. You also get ledger lines, of course.‘episema.ly’
An episema can be typeset over a single neume or a melisma. Its position is quantized between staff lines.‘fermata-rest-position.ly’
Fermatas over multimeasure rests are positioned as over normal rests.
‘figured-bass-alteration.ly’
Bass figures can carry alterations.‘figured-bass-continuation-center.ly’
Pairs of congruent figured bass extender lines are vertically centered iffiguredBassCenterContinuations
is set to
true.
‘figured-bass-continuation-forbid.ly’
By adorning a bass figure with\!
, an extender
may be forbidden.
‘figured-bass-continuation-modifiers.ly’
Figured bass extender lines shall be broken when a figure has a different alteration, augmentation or diminishment.‘figured-bass-continuation.ly’
Figured bass extender lines run between repeated bass figures. They are switched on withuseBassFigureExtenders
‘figured-bass-durations.ly’
Bass figures and extenders shall also work correctly if the figure has a different duration than the bass note. In particular, if a timestep does not have a new figure (because the old figure still goes on), extenders should be drawn and not be reset.‘figured-bass-extenders-markup.ly’
When using extender lines in FiguredBass, markup objects should be treated like ordinary figures and work correctly with extender lines.Extenders should only be used if the markup is really identical.
‘figured-bass-ignore-rest.ly’
When figures appear inside a voice,ignoreFiguredBassRest
causes all figures on rests to be discarded and all spanners ended.
If set to ##f
, figures on rests are printed.
‘figured-bass-implicit.ly’
Implicit bass figures are not printed, but they do get extenders.‘figured-bass-slashed-numbers.ly’
‘figured-bass-staff.ly’
Figured bass can also be added to Staff context directly. In that case, the figures must be entered with\figuremode
and be directed
to an existing Staff
context.
Since these engravers are on Staff
level, properties
controlling figured bass should be set in Staff
context.
‘figured-bass.ly’
Figured bass is created by the FiguredBass context which responds to figured bass events and rest events. You must enter these using the special\figuremode { }
mode, which allows you to
type numbers, like <4 6+>
and add slashes, backslashes and pluses.
You can also enter markup strings. The vertical alignment may also be tuned.
‘fill-line-test.ly’
The fill-line markup command should align texts in columns. For example, the characters in the center should form one column.‘finger-chords-accidental.ly’
Scripts left of a chord avoid accidentals.‘finger-chords-dot.ly’
Scripts right of a chord avoid dots.‘finger-chords-order.ly’
Ordering of the fingerings depends on vertical ordering of the notes, and is independent of up/down direction.‘finger-chords.ly’
It is possible to associate fingerings uniquely with notes. This makes it possible to add horizontal fingerings to notes.‘fingering-cross-staff.ly’
Fingerings work correctly with cross-staff beams.‘fingering.ly’
Automatic fingering tries to put fingering instructions next to noteheads.‘flags-default.ly’
Default flag styles: ’(), ’mensural and ’no-flag. Compare all three methods to print them: (1) C++ default implementation, (2) Scheme implementation using the ’flag-style grob property and (3) setting the ’flag property explicitly to the desired Scheme function. All three systems should be absolutely identical.‘flags-in-scheme.ly’
The ’flag property of the Stem grob can be set to a custom scheme function to generate the glyph for the flag.‘flags-straight-stockhausen-boulez.ly’
‘flags-straight.ly’
Straight flag styles.‘follow-voice-break.ly’
The line-spanners connects to the Y position of the note on the next line. When put across line breaks, only the part before the line break is printed.
‘follow-voice-consecutive.ly’
The voice follower is not confused when set for consecutive sets of staff switches.‘font-bogus-ligature.ly’
TM and No should not be changed into trademark/number symbols. This may happen with incorrect font versions.‘font-family-override.ly’
The default font families for text can be overridden withmake-pango-font-tree
‘font-kern.ly’
Text set in TrueType Fonts that contain kerning tables, are kerned.‘font-name-font-size.ly’
Setting the font-name
property does not change the font
size. The two strings below should be concatenated and have the
same font size.
‘font-name.ly’
Other fonts can be used by settingfont-name
for
the appropriate object. The string should be a Pango font description
without size specification.
‘font-postscript.ly’
This file demonstrates how to load different (postscript) fonts. The file ‘font.scm’ shows how to define the scheme-functionmake-century-schoolbook-tree
.
‘fret-board-alignment.ly’
FretBoards should be aligned in the Y direction at the fret-zero, string 1 intersection.‘fret-boards.ly’
Frets can be assigned automatically. The results will be best when one string number is indicated in advance‘fret-diagram-origins.ly’
Fret diagrams of different orientation should share a common origin of the topmost fret or string.
‘fret-diagrams-capo.ly’
A capo indicator can be added with a fret-diagram-verbose string, and its thickness can be changed.
‘fret-diagrams-dots.ly’
Dots indicating fingerings can be changed in location, size, and coloring.
‘fret-diagrams-fingering.ly’
Finger labels can be added, either in dots or below strings. Dot color can be changed, and fingering label font size can be adjusted.
‘fret-diagrams-fret-label.ly’
The label for the lowest fret can be changed in location, size, and number type.
‘fret-diagrams-landscape.ly’
Fret diagrams can be presented in landscape mode.
‘fret-diagrams-opposing-landscape.ly’
Fret diagrams can be presented in landscape mode.
‘fret-diagrams-string-frets.ly’
Number of frets and number of strings can be changed from the defaults.
‘fret-diagrams-string-thickness.ly’
String thickness can be changed, and diagrams can have variable string thickness.
‘fret-diagrams-xo-label.ly’
The label for the lowest fret can be changed in location, size, and number type.
‘fretboard-chordchanges.ly’
FretBoards can be set to display only when the chord changes or at the beginning of a new line.‘full-measure-rest-fermata.ly’
Fermata over full-measure rests should invert when below and be closer to the staff than other articulations.
‘general-scheme-bindings.ly’
This file tests various Scheme utility functions.‘generic-output-property.ly’
As a last resort, the placement of grobs can be adjusted manually, by
setting the extra-offset
of a grob.
‘glissando-broken.ly’
If broken, Glissandi anticipate on the pitch of the next line.‘glissando-no-break.ly’
Glissandi are not broken. Here a\break
is ineffective.
Use breakable
grob property to override.
‘glissando.ly’
Between notes, there may be simple glissando lines. Here, the first two glissandi are not consecutive.The engraver does no time-keeping, so it involves some trickery to get << { s8 s8 s4 } { c4 \gliss d4 } >> working correctly.
‘grace-auto-beam.ly’
The autobeamer is not confused by grace notes.‘grace-bar-line.ly’
Bar line should come before the grace note.‘grace-bar-number.ly’
Grace notes do tricky things with timing. If a measure starts with a grace note, the measure does not start at 0, but earlier. Nevertheless, lily should not get confused. For example, line breaks should be possible at grace notes, and the bar number should be printed correctly.‘grace-beam.ly’
Grace beams and normal beams may occur simultaneously. Unbeamed grace notes are not put into normal beams.‘grace-direction-polyphony.ly’
The\voiceOne
setting is retained after
finishing the grace section.
‘grace-end-2.ly’
Grace notes at the end of an expression don’t cause crashes.‘grace-end.ly’
Grace notes after the last note do not confuse the timing code.‘grace-nest1.ly’
Grace code should not be confused by nested sequential music containing grace notes; practically speaking, this means that the end-bar and measure bar coincide in this example.‘grace-nest2.ly’
Grace code should not be confused by nested sequential music containing grace notes; practically speaking, this means that the end-bar and measure bar coincide in this example.‘grace-nest3.ly’
In nested syntax, graces are still properly handled.‘grace-nest4.ly’
Also in the nested syntax here, grace notes appear rightly.‘grace-nest5.ly’
Graces notes may have the same duration as the main note.‘grace-part-combine.ly’
Grace notes may be put in apartcombine
r.
‘grace-partial.ly’
A\partial
may be combined with a
\grace
.
‘grace-staff-length.ly’
Stripped version of trip.ly. Staves should be of correct length.‘grace-start.ly’
Pieces may begin with grace notes.‘grace-stem-length.ly’
Stem lengths for grace notes should be shorter than normal notes, if possible. They should never be longer, even if that would lead to beam quanting problems.‘grace-stems.ly’
HerestartGraceMusic
should set no-stem-extend
to
true; the two grace beams should be the same here.
‘grace-sync.ly’
Grace notes in different voices/staves are synchronized.‘grace-types.ly’
There are three different kinds of grace types: the base grace switches to smaller type, the appoggiatura inserts also a slur, and the acciaccatura inserts a slur and slashes the stem.‘grace-unfold-repeat.ly’
When grace notes are entered with unfolded repeats, line breaks take place before grace notes.‘grace-volta-repeat-2.ly’
A volta repeat may begin with a grace. Consecutive ending and starting repeat bars are merged into one:||:
.
‘grace-volta-repeat.ly’
Repeated music can start with grace notes. Bar checks preceding the grace notes do not cause synchronization effects.‘grace.ly’
You can have beams, notes, chords, stems etc. within a\grace
section. If there are tuplets, the grace notes will not
be under the brace.
Main note scripts do not end up on the grace note.
‘graphviz.ly’
The graphviz feature draws dependency graphs for grob properties.‘grid-lines.ly’
With grid lines, vertical lines can be drawn between staves synchronized with the notes.‘grob-tweak.ly’
With the\tweak
function, individual grobs that
are directly caused by events may be tuned directly.
‘hairpin-barline-break.ly’
If a hairpin ends on the first note of a new stave, we do not print that ending. But on the previous line, this hairpin should not be left open, and should end at the bar line.‘hairpin-circled.ly’
Hairpins can have circled tips. A decrescendo del niente followed by a crescendo al niente should only print one circle.‘hairpin-dashed.ly’
Hairpin crescendi may be dashed.‘hairpin-ending.ly’
Hairpin dynamics start under notes if there are no text-dynamics. If there are text dynamics, the hairpin does not run into them.‘hairpin-neighboring-span-dynamics.ly’
Bound padding for hairpins also works with neighboringDynamicTextSpanner
grobs. In this case, bound-padding
is not scaled down.
‘hairpin-to-barline-mark.ly’
’to-barline is not confused by very long marks.‘hairpin-to-barline.ly’
Hairpins whose end note is preceded by a bar line should end at that bar line.‘hairpin-to-rest.ly’
Hairpins end at the left edge of a rest.‘hara-kiri-drumstaff.ly’
Hara-kiri staves are suppressed if they are empty. This example really contains three drum staves, but as it progresses, empty ones are removed: this example has three staves, but some of them disappear: note how the 2nd line only has the bar number 2. (That the bar number is printed might be considered a bug, however, the scenario of all staves disappearing does not happen in practice.)Any staff brackets and braces are removed, both in the single staff and no staff case.
‘hara-kiri-keep-previous-settings.ly’
Inserting the harakiri settings globally into the Staff context should not erase previous settings to the Staff context.‘hara-kiri-percent-repeat.ly’
Staves, RhythmicStaves, TabStaves and DrumStaves with percent repeats are not suppressed.‘hara-kiri-pianostaff.ly’
Hara-kiri staves kill themselves if they are empty. This example really contains three staves, but as they progress, empty ones are removed: this example has three staves, but some of them disappear: note how the 2nd line only has the bar number 2. (That the bar number is printed might be considered a bug, however, the scenario of all staves disappearing does not happen in practice.)Any staff brackets and braces are removed, both in the single staff and no staff case.
This example was done with a pianostaff, which has fixed distance alignment; this should not confuse the mechanism.
‘hara-kiri-rhythmicstaff.ly’
Hara-kiri staves are suppressed if they are empty. This example really contains three rhythmic staves, but as it progresses, empty ones are removed: this example has three staves, but some of them disappear: note how the 2nd line only has the bar number 2. (That the bar number is printed might be considered a bug, however, the scenario of all staves disappearing does not happen in practice.)Any staff brackets and braces are removed, both in the single staff and no staff case.
‘hara-kiri-stanza-number.ly’
stanza numbers remain, even on otherwise empty lyrics lines.‘hara-kiri-tabstaff.ly’
Hara-kiri staves are suppressed if they are empty. This example really contains three tab staves, but as it progresses, empty ones are removed: this example has three staves, but some of them disappear: note how the 2nd line only has the bar number 2. (That the bar number is printed might be considered a bug, however, the scenario of all staves disappearing does not happen in practice.)Any staff brackets and braces are removed, both in the single staff and no staff case.
‘harp-pedals-sanity-checks.ly’
The harp-pedal markup function does some sanity checks. All the diagrams here violate the standard (7 pedals with divider after third), so a warning is printed out, but they should still look okay.‘harp-pedals-tweaking.ly’
Harp pedals can be tweaked through the size, thickness and harp-pedal-details properties of TextScript.‘harp-pedals.ly’
Basic harp diagram functionality, including circled pedal boxes. The third diagram uses an empty string, the third contains invalid characters. Both cases will create warnings, but should still not fail with an error.‘horizontal-bracket-break.ly’
Horizontal brackets connect over line breaks.‘horizontal-bracket.ly’
Note grouping events are used to indicate where analysis brackets start and end.‘identifier-following-chordmode.ly’
Identifiers following a chordmode section are not interpreted as chordmode tokens. In the following snippet, the identifier ‘m’ is not interpreted by the lexer as a minor chord modifier.‘identifiers.ly’
test identifiers.‘incipit.ly’
Incipits can be printed using anInstrumentName
grob.
‘instrument-cue-name.ly’
TheVoice.instrumentCueName
property generates instrument
names for cue notes. It can also be unset properly.
‘instrument-name-dynamic.ly’
Instrument names (aligned on axis group spanners) ignore dynamic and pedal line spanners.
‘instrument-name-hara-kiri.ly’
Instrument names are removed when the staves are killed off.In this example, the second staff (marked by the bar number 2) disappears, as does the instrument name.
‘instrument-name-markup.ly’
Instrument names are set withStaff.instrument
and
Staff.instr
. You can enter markup texts to create more funky names,
including alterations.
‘instrument-name-partial.ly’
Instrument names are also printed on partial starting measures.‘instrument-name-volta.ly’
Moving theVolta_engraver
to the Staff
context does not affect InstrumentName
alignment.
‘instrument-name-x-align.ly’
Instrument names horizontal alignment is tweaked by changing theStaff.Instrument #'self-alignment-X
property. The
\layout
variables indent
and short-indent
define
the space where the instrument names are aligned before the first and
the following systems, respectively.
‘instrument-name.ly’
Staff margins are also markings attached to barlines. They should be left of the staff, and be centered vertically with respect to the staff. They may be on normal staves, but also on compound staves, like the PianoStaff.
‘instrument-switch.ly’
TheswitchInstrument
music function modifies
properties for an in staff instrument switch.
‘invalid-engraver.ly’
Engravers which do not exist produce a warning.‘key-clefs.ly’
Each clef has its own accidental placing rules.‘key-signature-cancellation-extra-natural.ly’
IfextraNatural
is set then keys that are not
altered farther away (eg from sharp to double sharp) are
cancelled. Otherwise only keys that do not occur in the new key
signature are cancelled.
‘key-signature-cancellation.ly’
Key cancellation signs consists of naturals for pitches that are not in the new key signature. Naturals get a little padding so the stems don’t collide.‘key-signature-left-edge.ly’
If the clef engraver is removed, the key signature shall use a proper padding > 0 to the start of the staff lines.‘key-signature-padding.ly’
With thepadding-pairs
property, distances
between individual key signature items can be adjusted.
‘key-signature-scordatura-persist.ly’
When a custom key signature has entries which are limited to a particular octave, such alterations should persist indefinitely or until a new key signature is set.Here, only the fis’ shows an accidental, since it is outside the
octave defined in keySignature
.
‘key-signature-scordatura.ly’
By settingStaff.keySignature
directly,
key signatures can be set invidually per pitch.
‘keys.ly’
Key signatures may appear on key changes, even without a barline.
In the case of a line break, the restoration accidentals are printed at
end of a line. If createKeyOnClefChange
is set, key signatures
are created also on a clef change.
‘laissez-vibrer-arpeggio.ly’
l.v. ties should not collide with arpeggio indications.
‘laissez-vibrer-tie-beam.ly’
\laissezVibrer
ties on beamed notes don’t trigger
premature beam slope calculation.
‘laissez-vibrer-tie-head-direction.ly’
The ’head-direction of a LaissezVibrerTieColumn should be able to be set without causing a segmentation fault.‘laissez-vibrer-ties.ly’
l.v. ties should avoid dots and staff lines, similar to normal ties.
They have fixed size. Their formatting can be tuned with
tie-configuration
.
‘landscape.ly’
Scores may be printed in landscape mode.‘ledger-line-minimum.ly’
When ledgered notes are very close, for example, in grace notes, they are kept at a minimum distance to prevent the ledgers from disappearing.‘ledger-line-shorten.ly’
Ledger lines are shortened when they are very close. This ensures that ledger lines stay separate.‘ledger-lines-varying-staves.ly’
Ledger lines should appear at every other location for a variety of staves using bothline-count
and
line-positions
.
‘les-nereides.ly’
‘ligature-bracket.ly’
The ligature bracket right-end is not affected by other voices.‘lily-in-scheme.ly’
LilyPond syntax can be used inside scheme to build music expressions, with the#{ ... #}
syntax.
Scheme forms can be introduced inside these blocks by escaping
them with a $
, both in a LilyPond context or in a Scheme
context.
In this example, the \withpaddingA
, \withpaddingB
and
\withpaddingC
music functions set different kinds of padding on
the TextScript
grob.
‘line-arrows.ly’
Arrows can be applied to text-spanners and line-spanners (such as the Glissando)‘line-dash-small-period.ly’
Generate valid postscript even if dash-period is small compared to line thickness.‘line-dashed-period.ly’
The period of a dashed line is adjusted such that it starts and ends on a full dash.‘line-style-zigzag-spacing.ly’
Setting'zigzag
style for spanners does not
cause spacing problems: in this example, the first text markup and
zigzag trillspanner have the same outside staff positioning as
the second markup and default trillspanner.
‘line-style.ly’
Cover all line styles available.‘lyric-combine-new.ly’
With the\lyricsto
mechanism, individual lyric
lines can be associated with one melody line. Each lyric line
can be tuned to either follow or ignore melismata.
‘lyric-combine-polyphonic.ly’
Polyphonic rhythms and rests do not disturb\lyricsto
.
‘lyric-combine-switch-voice-2.ly’
switching voices in the middle of the lyrics is possible usinglyricsto
.
‘lyric-combine-switch-voice.ly’
Switching the melody to a different voice works even if the switch occurs together with context instantiation.‘lyric-combine.ly’
Lyrics can be set to a melody automatically. Excess lyrics will be discarded. Lyrics will not be set over rests. You can have melismata either by setting a property melismaBusy, or by setting automaticMelismas (which will set melismas during slurs and ties). If you want a different order than first Music, then Lyrics, you must precook a chord of staves/lyrics and label those. Of course, the lyrics ignore any other rhythms in the piece.‘lyric-extender-broken.ly’
Lyric extenders run to the end of the line if it continues the next line. Otherwise, it should run to the last note of the melisma.‘lyric-extender-completion.ly’
A LyricExtender should end at the right place even if there are more notes in the voice than lyrics.‘lyric-extender-includegraces.ly’
If includeGraceNotes
is enabled, lyric extenders work as
expected also for syllables starting under grace notes.
‘lyric-extender-no-heads.ly’
Extender engraver also notices the lack of note heads. Here the extender ends on the 2nd quarter note, despite the grace note without a lyric attached.‘lyric-extender-rest.ly’
IfextendersOverRests
is set, an extender
is not terminated upon encountering a rest.
‘lyric-extender-right-margin.ly’
Extenders will not protrude into the right margin‘lyric-extender.ly’
A LyricExtender may span several notes. A LyricExtender does not extend past a rest, or past the next lyric syllable.‘lyric-hyphen-break.ly’
Hyphens are printed at the beginning of the line only when they go past the first note.‘lyric-hyphen-retain.ly’
The minimum distance between lyrics is determined by theminimum-distance
of LyricHyphen
and
LyricSpace
.
The ideal length of a hyphen is determined by its length
property, but it may be shortened down to minimum-length
in
tight situations. If in this it still does not fit, the hyphen will be
omitted.
Like all overrides within \lyricsto
and \addlyrics
, the
effect of a setting is delayed is one syllable.
‘lyric-hyphen.ly’
In lyrics, hyphens may be used.‘lyric-ignore-melisma-alignment.ly’
IfignoreMelismata
is set, lyrics should remain
center-aligned.
‘lyric-melisma-manual.ly’
Melisma’s may be entered manually by substituting_
for lyrics on notes that are part of the melisma.
‘lyric-no-association-rhythm.ly’
When lyrics are not associated with specific voices, the lyric placement should follow lyric rhythms. In particular, the second syllable here should not be attached to the first note of the first staff.‘lyric-phrasing.ly’
Normally, the lyric is centered on the note head. However, on melismata, the text is left aligned on the left-side of the note head.
‘lyric-tie.ly’
Tildes in lyric syllables are converted to tie symbols.‘lyrics-after-grace.ly’
Lyrics are ignored for aftergrace notes.‘lyrics-bar.ly’
Adding a Bar_engraver
to the Lyrics context makes sure that
lyrics do not collide with barlines.
‘lyrics-includegraces.ly’
Setting includeGraceNotes
enables lyrics syllables to be
assigned to grace notes.
‘lyrics-melisma-beam.ly’
Melismata are triggered by manual beams.‘lyrics-no-notes.ly’
Lyric syllables without note attachment are not centered. Centering may cause unintended effects when the paper column is very wide.‘lyrics-tenor-clef.ly’
Lyrics are not lowered despite the presence of an octavation 8.‘markup-arrows.ly’
The feta font has arrow heads‘markup-bidi-explicit-embedding.ly’
The explicit directional embedding codes, U+202A and U+202B, are supported in single-line markup strings. The embeddings must be terminated with the pop directional formatting character, U+202C.
‘markup-bidi-explicit-overrides.ly’
The explicit directional override codes, U+202D and U+202E, are supported in single-line markup strings. The overrides must be terminated with the pop directional formatting character, U+202C.
‘markup-bidi-implicit-marks.ly’
The implicit directional marks, U+200E and U+200F, are supported in single-line markup strings.
‘markup-bidi-pango.ly’
A single Pango string is processed according to the Unicode Bidirectional Algorithm. The strong Hebrew characters in this example are set right-to-left, and the Latin numerals, space character, and punctuation are set according to the rules of the algorithm.‘markup-brace-warning.ly’
If\left-brace
or \right-brace
cannot
find a match for the given point size, it should default
gracefully to either brace0
or brace575
and display
a warning.
‘markup-braces.ly’
The markup command\left-brace
selects a
fetaBraces
glyph based on point size, using a binary search.
\right-brace
is simply a \left-brace
rotated 180
degrees.
‘markup-column-align.ly’
Fixed horizontal alignment of columns of text can be set using \left-column, \center-column and \right-column.‘markup-commands.ly’
test various markup commands.‘markup-diacritic-marks.ly’
Diacritic marks are rendered and positioned correctly. The diacritic on line 1 looks like a lower-underline and is centered beneath the main character. The diacritic on line 2 is positioned to the left of the main character, with a tiny space of separation. The diacritic on line 3 is positioned directly above the main character, either centered or shifted slightly to the left.
‘markup-eps.ly’
The epsfile markup command reads an EPS file‘markup-eyeglasses.ly’
The eyeglasses markup function prints out eyeglasses.‘markup-line-thickness.ly’
The thickness setting between markup lines and other lines is consistent.‘markup-lines.ly’
Text that can spread over pages is entered with the\markuplines
command.
‘markup-music-glyph.ly’
Reset fontname for musicglyph. For unknown glyphs, we print a warning.‘markup-note-dot.ly’
A dotted whole note displayed via the\note
command must separate the note head and the dot. The dot avoids the upflag.
‘markup-note-grob-style.ly’
The'style
property from grobs such as
TimeSignature
and TextSpanner
does not affect
the default note head style for \note
and
\note-by-number
.
‘markup-note-styles.ly’
\note-by-number
and \note
support
all note head styles.
‘markup-note.ly’
The note markup function may be used to make metronome markings. It works for a variety of flag, dot and duration settings.‘markup-scheme.ly’
There is a Scheme macromarkup
to produce markup
texts using a similar syntax as \markup
.
‘markup-score-multi-system.ly’
\markup \score displays all systems. Spacing between systems is set usingbaseline-skip
.
‘markup-score.ly’
Use \score block as markup command.‘markup-stack.ly’
Markup scripts may be stacked.‘markup-syntax.ly’
Demo of markup texts, using LilyPond syntax.‘markup-user.ly’
Users may define non-standard markup commands using thedefine-markup-command
scheme macro.
‘markup-word-wrap.ly’
The markup commands\wordwrap
and \justify
produce simple paragraph text.
‘measure-grouping.ly’
TheMeasure_grouping_engraver
adds triangles and
brackets above beats when the beats of a time signature are grouped.
‘mensural-ligatures.ly’
Mensural ligatures show different shapes, depending on the rhythmical pattern and direction of the melody line.‘mensural.ly’
There is limited support for mensural notation: note head shapes are available. Mensural stems are centered on the note heads, both for up and down stems.‘metronome-marking.ly’
Here\tempo
directives are printed as metronome markings.
The marking is left aligned with the time signature, if there is one.
‘metronome-parenthesized.ly’
Using an empty text in the metronome marks, one can generate parenthesized tempo marks.
‘metronome-text.ly’
The tempo command supports text markup and/or duration=count. Using
Score.tempoHideNote
, one can hide the duration=count in the tempo mark.
‘midi-drums.ly’
Midi can create drums.‘midi-dynamics.ly’
Midi also handles crescendo and decrescendo, either starting and ending from specified or unspecified sound level.‘midi-grace.ly’
Grace notes don’t intrroduce syncing problems: the last note off will appear at tick 768 (2 * 384).‘midi-lyric-barcheck.ly’
Lyrics in MIDI are aligned to ties and beams: this examples causes no bar checks in MIDI.‘midi-microtone-off.ly’
Microtonal shifts should be corrected before the start of the next (possibly grace) note.‘midi-microtone.ly’
The pitch wheel is used for microtones.‘midi-partial.ly’
MIDI and partial measures work together.‘midi-pedal.ly’
Pedals. Runtimidity -idvvv file.midi |grep Midi
to see midi events.
‘midi-scales.ly’
Converting LilyPond input to MIDI and then again back withmidi2ly.py
is a reversible procedure in some simple cases,
which mean that the original .ly
-file and the one converted
back from the generated .midi
-file do not differ.
Here are produced some scales.
‘midi-transposition.ly’
should deliver f’ in MIDI‘midi-tuplets.ly’
Midi2ly tuplet test.
python scripts/midi2ly.py --duration-quant=32 \ --allow-tuplet=4*2/3 \ --allow-tuplet=8*2/3 \ --allow-tuplet=4*3/5 \ --allow-tuplet=8*3/5 \ tu.midi
‘midi-volume-equaliser.ly’
The full orchestra plays a note, where groups stop one after another. Use this to tune equalizer settings.‘mm-rests2.ly’
If Score.skipBars
is set,
the signs for four, two, and one measure rest are combined to
produce the graphical representation of rests for up to 10 bars.
The number of bars will be written above the sign.
‘modern-tab-clef-scaled.ly’
The sans serif style tab clef is automatically adjusted to different string spacings.‘modern-tab-clef.ly’
Sans serif style tab clefs are supported by\clef moderntab
.
This alternative clef supports four- to seven-stringed instruments
and is scaled automatically.
‘morgenlied.ly’
The source is a rather tightly set Peters in Edition is a heavy font. The Peters edition (4622c) was ‘herausgegeben’ by Paul Losse, whose name also appears on a 1956 edition of some other music. Strictly speaking, his edititorial enhancements will not be in the PD - but I am assuming there are no notable ones in this small piece.The original compresses the entire music onto a single page, in 4 systems. Lily does so too if you tune down spacing-increment, but chooses line breaks differently.
Further manual tweaks: the slur in measure 12 has been flattened manually. The beam in measure 3, left-hand, technically is wrong, but has been added following the original. The crescendo in measure 4 has been lowered
‘mozart-hrn-3.ly’
‘multi-measure-rest-center.ly’
The multimeasure rest is centered exactly between bar lines.‘multi-measure-rest-center2.ly’
The existence of a text mark does not affect the placement of a multimeasure rest.‘multi-measure-rest-grace.ly’
Multi-measure rests are centered also in the case of grace notes.‘multi-measure-rest-instr-name.ly’
There are both long and short instrument names. Engraving instrument names should not be confused by the multimeasure rests.‘multi-measure-rest-multi-staff-center.ly’
The centering of multi-measure rests is independent on prefatory matter in other staves.‘multi-measure-rest-spacing.ly’
By setting texts starting with a multi-measure rest, an extra spacing column is created. This should not cause problems.‘multi-measure-rest-text.ly’
Texts may be added to the multi-measure rests.
By setting the appropriate spacing-procedure
, we can make
measures stretch to accomodate wide texts.
‘multi-measure-rest-usebreve.ly’
For longer measure lengths, the breve rest is used.‘multi-measure-rest.ly’
Multi-measure rests do not collide with barlines and clefs. They
are not expanded when you set Score.skipBars
. Although the
multi-measure-rest is a Spanner, minimum distances are set to keep it
colliding from barlines.
Rests over measures during longer than 2 wholes use breve rests. When
more than 10 or more measures (tunable through expand-limit
)
are used then a different symbol is used.
‘music-function-end-spanners.ly’
theendSpanners
music function inserts
end span events at the end of a note.
‘music-function-string-markup.ly’
Music functions accept strings as markup arguments when using the type predicatemarkup?
‘music-function.ly’
Music functions are generic music transformation functions, which can be used to extend music syntax seamlessly. Here we demonstrate a\myBar
function, which works similar to
\bar
, but is implemented completely in Scheme.
‘music-map.ly’
Withmusic-map
, you can apply functions operating on a
single piece of music to an entire music expression. In this example,
the function notes-to-skip
changes a note to a skip. When
applied to an entire music expression in the 1st measure, the scripts
and dynamics are left over. These are put onto the 2nd measure.
‘newaddlyrics.ly’
newlyrics, multiple stanzas, multiple lyric voices.‘no-staff.ly’
The printing of the staff lines may be suppressed by removing the corresponding engraver.‘non-centered-bar-lines.ly’
Bar lines are positioned correctly when using custom staves which are not centered around position 0.‘non-empty-text.ly’
By default, text is set with empty horizontal dimensions. The propertyextra-spacing-width
in TextScript
is used
to control the horizontal size of text.
‘note-head-aiken.ly’
Notes can be set in the Aiken (Christian Harmony) style.‘note-head-chord.ly’
Note heads are flipped on the stem to prevent collisions. It also works for whole heads that have invisible stems.‘note-head-harmonic-dotted.ly’
Dots on harmonic note heads can be shown by setting the property
harmonicDots
.
‘note-head-harmonic-whole.ly’
A harmonic note head must be centered if the base note is a whole note.‘note-head-harmonic.ly’
The handling of stems for harmonic notes must be completely identical to normal note heads. Harmonic heads do not get dots. If harmonicAccidentals
is
unset, they also don’t get accidentals.
‘note-head-sacred-harp.ly’
Notes can be set in the Sacred Harp style.‘note-head-shape-minor.ly’
Shape notes can be set to work properly in minor keys.‘note-head-solfa.ly’
WithshapeNoteStyles
, the style of the note head
is adjusted according to the step of the scale, as measured relative
to the tonic
property.
‘note-head-southern-harmony.ly’
Notes can be set in the Southern Harmony style.‘note-head-style.ly’
Note head shapes may be set from several choices. The stem endings should be adjusted according to the note head. If you want different note head styles on one stem, you must create a special context.
Harmonic notes have a different shape and different dimensions.
‘note-line.ly’
Note head lines (e.g. glissando) run between centers of the note heads.‘number-staff-lines.ly’
The number of stafflines of a staff can be set. Ledger lines both on note heads and rests, as well as barlines, are adjusted accordingly.‘optimal-page-breaking-hstretch.ly’
The optimal page breaker will make trade-offs between horizontal and vertical stretching so that the overall spacing will be more acceptable. The page-spacing-weight parameter controls the relative importance of vertical/horizontal spacing. Because ragged-last-bottom is on, there is no penalty for odd vertical spacing on the final page. As a result, only the first page should be horizontally stretched.‘option-help.ly’
Print the option help text, for comparison against previous releases.‘ottava-broken.ly’
At line breaks, ottava brackets have no vertical line and their horizontal line does not stick out. The dashed line runs until the end of the line (regardless of prefatory matter).‘ottava-edge.ly’
Both edge heights of an ottava bracket can be specified.‘ottava.ly’
Ottava brackets are supported, through the use of the music function\ottava
.
The spanner should go below a staff for 8va bassa, and the ottavation
markup can be tuned with Staff.ottavation
.
‘override-nest-scheme.ly’
A sublist of grob property lists may be overridden within a callback. This test uses a custom stencil callback which changes the Y coordinate of the right bound of the glissando spanner.‘override-nest.ly’
Sublist of grob property lists may be also tuned. In the next example, thebeamed-lengths
property of the Stem
grob is tweaked.
‘page-break-between-scores.ly’
Page breaks work when they are placed at the end of a score, or between scores.‘page-break-turn-toplevel.ly’
Page breaking and page turning commands (\pageBreak
,
\noPageBreak
, etc), can be used at top level.
‘page-break-warn-forbidden.ly’
If a page break is forced where it is forbidden, a warning is printed.‘page-breaking-good-estimation.ly’
The page breaking algorithm can handle clefs combined with lyrics. That is, the Y-extent approximations are a little more accurate than just using bounding boxes. In particular, everything should fit on one page here.‘page-breaking-max-systems-per-page.ly’
The max-systems-per-page variable prevents more than a given number of systems from being on a page. Titles are not counted as systems. \noPageBreak can override max-systems-per-page in unusual situations.‘page-breaking-min-systems-per-page1.ly’
The min-systems-per-page variable forces each page to have a minimum number of systems. Titles do not count as systems here.‘page-breaking-min-systems-per-page2.ly’
The min-systems-per-page variable takes precedence over the desire not to overfill a page.‘page-breaking-page-count1.ly’
The number of pages in a score can be forced by settingpage-count
in the (book-level) paper block.
‘page-breaking-page-count2.ly’
The number of pages in a score can be forced by settingpage-count
in the (book-level) paper block. If there are too
few systems for the number of pages, we append blank pages.
‘page-breaking-page-count3.ly’
The number of pages in a score can be forced by settingpage-count
in the (book-level) paper block. Even if there are
too many systems for that number of pages, we will squeeze them in.
‘page-breaking-system-count-forced-break.ly’
system-count and \pageBreak are compatible.‘page-breaking-systems-per-page.ly’
The systems-per-page variable forces a certain number of systems per page. Titles are not counted as systems.‘page-breaking-title-padding.ly’
Padding between titles is honoured by the page breaker. This should take up two pages.‘page-breaking-title-padding2.ly’
Padding after titles is honoured by the page breaker. This should take up two pages.‘page-breaking-title-padding3.ly’
Padding before titles is honoured by the page breaker. This should take up two pages.‘page-breaks.ly’
Stress optimal page breaking. This should look nice and even on 4 a6 pages.‘page-label.ly’
Page labels may be placed inside music or at top-level, and refered to in markups.‘page-layout-manual-position.ly’
By settingY-offset
and X-offset
for the
line-break-system-details
of NonMusicalPaperColumn
,
systems may be placed absolutely on the printable area of the page.
‘page-layout.ly’
This shows how different settings on \paper modify the general page layout. Basically \paper will set the values for the whole paper while \layout for each \score block.This file is best viewed outside the collated files document.
‘page-limited-space.ly’
The space between systems can be limited when there is too much space left on the page by settingpage-limit-inter-system-space
.
‘page-minimal-page-breaking-last-page.ly’
Minimal page breaker: special case when the last system is moved to an other page when there is not enough space because of the tagline.‘page-minimal-page-breaking.ly’
The minimal page breaker stacks as many lines on pages, only accounting for manual page break commands.‘page-spacing-bottom-spring.ly’
The spring at the bottom of a page is fairly flexible (much more so than the one at the top), so it does not drag the staff to the bottom of the page. However, it is sufficiently stiff to cause stretching.‘page-spacing-dynamics.ly’
Dynamic centering still works with alignment-distances.‘page-spacing-loose-lines-after.ly’
A loose line (eg. a lyric line) at the bottom of a system gets spaced appropriately.‘page-spacing-loose-lines-and-markup.ly’
Having markup after a loose line doesn’t confuse the page layout engine.‘page-spacing-loose-lines-before.ly’
A loose line (eg. a lyric line) at the top of a system is spaced appropriately.‘page-spacing-loose-lines-between-systems.ly’
The vertical spacing engine is not confused by a loose line below a system followed by a loose line above the next system.‘page-spacing-loose-lines-between.ly’
Loose lines between two systems don’t confuse the layout engine. In particular, they don’t interfere with between-system-spacing, which measures distances between spaceable staves.‘page-spacing-loose-lines-header-padding.ly’
Padding from the header and footer is measured to the first line, whether or not it is spaceable.‘page-spacing-loose-lines-non-affinity.ly’
Loose lines can specify their padding or min-distance to the staff for which they don’t have affinity.‘page-spacing-markups.ly’
Adjacent lines of markup are placed as closely together as possible.‘page-spacing-rehearsal-mark.ly’
The space taken up by rehearsal marks is correctly accounted for, even though they live in the Score context.‘page-spacing-staff-group-hara-kiri.ly’
StaffGrouper interacts correctly with \RemoveEmptyStaffContext. In both systems, there should be a large space between the staff groups.‘page-spacing-staff-group.ly’
By default, the staves within a StaffGroup are spaced more closely than staves not in a StaffGroup.‘page-spacing-stretchability.ly’
The stretchability property affects the amount that staves will move under extreme stretching, but it does not affect the default distance between staves.‘page-spacing-system-count-overfull.ly’
Page breaking doesn’t crash when the line-breaking is invalid.‘page-spacing-system-count.ly’
Page layout and stretching work with system-count enabled.‘page-spacing-tall-headfoot.ly’
Both the page breaking and the page layout take account of the heights of the header and footer.‘page-spacing-top-system-spacing.ly’
top-system-spacing controls the spacing to the first non-title staff on every page.‘page-spacing-top-title-spacing.ly’
top-title-spacing controls the spacing from the top margin to a title (or markup), provided that it is the first system on a page.‘page-spacing.ly’
By setting properties in NonMusicalPaperColumn, vertical spacing of page layout can be adjusted.For technical reasons, overrideProperty
has to be used for
setting properties on individual object. \override
may still be
used for global overrides.
By setting annotate-spacing
, we can see the effect of each property.
‘page-top-space.ly’
By settingpage-top-space,
the Y position of the
first system can be forced to be uniform.
‘page-turn-page-breaking-auto-first-page.ly’
By default, we start with page 1, which is on the right hand side of a double page. In this example, auto-first-page-number is set to ##t and the music won’t fit on a single page, so we should automatically set the first page number to 2 in order to avoid a bad page turn.‘page-turn-page-breaking-auto-first-page2.ly’
By default, we start with page 1, which is on the right hand side of a double page. In this example, auto-first-page-number is set to ##t. ALthough the music will fit on a single page, it would require stretching the first page badly, so we should automatically set the first page number to 2 in order to avoid a bad page turn.‘page-turn-page-breaking-badturns.ly’
If there are no good places to have a page turn, the optimal-breaker will just have to recover gracefully. This should appear on 3 pages.‘page-turn-page-breaking-repeats.ly’
The page-turn engraver will not count potential page turns if they occur in the middle of a repeat unless there is a long gap at the beginning or at the end of the repeat.‘page-turn-page-breaking.ly’
The page-turn breaker will put a page turn after a rest unless there is a ’special’ barline within the rest, in which case the turn will go after the special barline.‘palm-mute.ly’
The palm mute technique for stringed instruments is supported by triangle-shaped note heads.‘paper-default-margins-a6.ly’
Default margin values are accessible in paper-defaults-init.ly and apply to the default paper size returned by (ly:get-option ’paper-size). For other paper sizes, they are scaled linearly. This also affects head- and foot-separation as well as indents.‘paper-default-margins-def.ly’
Default margin values are accessible in paper-defaults-init.ly and apply to the default paper size returned by (ly:get-option ’paper-size). For other paper sizes, they are scaled linearly. This also affects head- and foot-separation as well as indents.‘paper-margins-consistency.ly’
Margin values must fit the line-width, that means: paper-width = line-width + left-margin + right-margin. In case they do not, default margins are set and a warning is printed.‘paper-margins-left-margin.ly’
Here only left-margin is given, right-margin will remain default.‘paper-margins-line-width.ly’
If only line-width is given, systems are horizontally centered.‘paper-margins-no-checks.ly’
All checks can be avoided by setting check-consistency to ##f in \paper.‘paper-margins-overrun.ly’
Normally, margin settings must not cause systems to run off the page.‘paper-margins-right-margin.ly’
Here only right-margin is given, left-margin will remain default.‘paper-margins.ly’
Paper margin settings do not have to be complete. Missing values are added automatically. If no paper settings are specified, default values are used.‘paper-nested-override.ly’
Nested properties can be set in the paper block.‘paper-twosided-bcorr.ly’
In two-sided mode, a binding offset can be specified, which is added to the inner margin automatically.‘paper-twosided.ly’
Two-sided mode allows you to use different margins for odd and even pages.‘parenthesize-markup.ly’
The parenthesize markup will place parentheses around any stencil.
The angularity of the parentheses can be adjusted.
‘parenthesize-singlenotes-chords-rests.ly’
The parenthesize function should also work on single notes (not inside chords), rests and on whole chords (each note of the chord is parenthesized). Also, parenthesizing articulations, dynamics and text markup is possible. On all other music expressions, parenthesize does not have an effect.Measure 1: Three parenthesized notes (staccato not parenthesized), one note with staccato in parentheses; Measure 2: Chord and two rests in parentheses (accent and markup not); Measure 3: note (no parentheses) with \p in parentheses, with text in parentheses, and note in parentheses with p not in parentheses, rest (no parentheses); Measure 4: shows that \parenthesize does not apply to other expressions like SequentialMusic
‘parenthesize.ly’
The parenthesize function is a special tweak that encloses objects in parentheses. The associated grob isScore.ParenthesesItem
.
‘part-combine-a2.ly’
The a2 string is printed only on notes (i.e. not on rests), and only after chords, solo or polyphony.‘part-combine-cross.ly’
The part combiner stays apart for crossing voices.‘part-combine-global.ly’
The analysis of the part combiner is non-local: in the following example, the decision for using separate voices in the 1st measure is made on the 2nd note, but influences the 1st note.In the 2nd measure, the pattern without the tie, leads to combined voices.
‘part-combine-markup.ly’
Part combine texts accept markup.‘part-combine-mmrest-after-solo.ly’
Multimeasure rests are printed after solos, both for solo1 and for solo2.‘part-combine-solo-end.ly’
SOLO is printed even if the solo voice ends before the other one. Unfortunately, the multi-rest of the 1st voice (which is 2 bars longer than the 2nd voice) does not get printed.‘part-combine-solo-global.ly’
In this example, solo1 should not be printed over the 1st note, because of the slur which is present from the one-voice to the two-voice situation.‘part-combine-solo.ly’
A solo string can only be printed when a note starts. Hence, in this example, there is no Solo-2 although the 2nd voice has a dotted quarter, while the first voice has a rest.A Solo indication is only printed once; (shared) rests do not require reprinting a solo indication.
Solo 1/2 can not be used when a spanner is active, so there is no solo over any of the tied notes.
‘part-combine-text.ly’
The part combiner detects a2, solo1 and solo2, and prints texts accordingly.‘part-combine-tuplet-end.ly’
End tuplets events are sent to the starting context, so even after a switch, a tuplet ends correctly.‘part-combine-tuplet-single.ly’
Tuplets in combined parts only print one bracket.‘part-combine.ly’
The new part combiner stays apart from:- different durations,
- different articulations (taking into account only slur/beam/tie), and
- wide pitch ranges.
‘pedal-bracket.ly’
The brackets of a piano pedal should start and end at the left side of the note. If a note is shared between two brackets, these ends are flared.At a line-break, there are no vertical endings.
‘pedal-end.ly’
Unterminated piano pedal brackets run to the end of the piece.‘pedal-ped.ly’
The standard piano pedals style comes with Ped symbols. The pedal string can be also tuned, for example, to a shorter tilde/P variant at the end of the melody.‘phrasing-slur-dash.ly’
The appearance of phrasing slurs may be changed from solid to dotted or dashed.
‘phrasing-slur-slur-avoid.ly’
PhrasingSlur
s go over normal slurs.
‘phrasing-slur-tuplet.ly’
Phrasing slurs do not collide with tuplet numbers.‘predefined-fretboards-transpose.ly’
Transposition by less than one octave up or down should not affect predefined fretboards.
‘predefined-fretboards.ly’
‘prefatory-empty-spacing.ly’
The A is atop an invisible barline. The barline, although invisible, is also translated because it is the last one of the break alignment.‘prefatory-spacing-matter.ly’
Distances between prefatory items (e.g. clef, bar, etc.) are determined by engraving standards. These distances depend on which items are combined. Mid-line, the order for clef and bar-line is different from the start of line.‘profile-property-access.ly’
heavily mutilated Edition Peters Morgenlied by Schubert
‘property-grace-polyphony.ly’
Property overrides and reverts from\grace
do
not interfere with the overrides and reverts from polyphony.
‘property-nested-override.ly’
Nested properties may be overridden using Scheme list syntax. This test performs two property overrides: the first measure uses standard\override
syntax; the second uses a
list.
‘property-nested-revert.ly’
nested properties may also be reverted. This uses Scheme list syntax.‘property-once.ly’
Once properties take effect during a single time step only.‘quote-cue-during.ly’
ThecueDuring
form of quotation will set stem
directions on both quoted and main voice, and deliver the quoted voice
in the cue
Voice
. The music function \killCues
can remove all cue notes.
Spanners run to the end of a cue section, and are not started on the last note.
‘quote-cue-event-types.ly’
ThecueDuring
and quoteDuring
forms of quotation
will use the variables quotedCueEventTypes
and quotedEventTypes
to determine which events are quoted. This allows different events to be
quoted for cue notes than for normal quotes.
quotedEventTypes
is also the fallback for cue notes if
quotedCueEventTypes
is not set.
‘quote-cyclic.ly’
Two quoted voices may refer to each other. In this example, there are notes with each full-bar rest.‘quote-during.ly’
With\cueDuring
and \quoteDuring
,
fragments of previously entered music may be
quoted. quotedEventTypes
will determines what things are
quoted. In this example, a 16th rest is not quoted, since
rest-event
is not in quotedEventTypes
.
‘quote-grace.ly’
Quotes may contain grace notes. The grace note leading up to an unquoted note is not quoted.‘quote-kill-cues.ly’
\killCues
shall only remove real cue notes generated by
\cueDuring
, but not other music quoted using \quoteDuring
.
‘quote-overrides.ly’
The\quoteDuring
command shall also quote correctly all
\override
, \once \override
, \revert
, \set
,
\unset
and \tweak
events. The first line contains the
original music, the second line quotes the whole music and should look
identical.
By default, not all events are quoted. By setting the quoted event types to
'(StreamEvent)
, everything should be quoted.
‘quote-tie.ly’
Voices from different cues must not be tied together. In this example, the first note has a tie. This note should not be tied to the second visible note (following the rest). Note that this behavior will not hold for cues in direct succession, since only oneCueVoice
context is created
(with context-id
‘cue’).
‘quote-transposition.ly’
Quotations take into account the transposition of both source and target. In this example, all instruments play sounding central C, the target is a instrument in F. The target part may be\transpose
d. In this case, all the pitches (including the
quoted ones) will transposed as well.
‘quote-tuplet-end.ly’
Tuplet bracket ends properly when quoting.‘quote-tuplet.ly’
In cue notes, Tuplet stops are handled before new tuplets start.‘quote.ly’
With\quote
, fragments of previously entered
music may be quoted. quotedEventTypes
will determines what
things are quoted. In this example, a 16th rest is not quoted, since
rest-event
is not in quotedEventTypes
.
‘ragged-bottom-one-page.ly’
For a one-page score, ragged-bottom should have the same effect as ragged-last-bottom.‘ragged-right-compressed.ly’
When a score takes up only a single line and it is compressed, it is not printed as ragged.‘ragged-right-disabled.ly’
When ragged-right is specifically disabled, a score with only one line will not be printed as ragged.‘ragged-right-one-line.ly’
When a score takes up only a single line and it is stretched, it is printed as ragged by default.‘rehearsal-mark-align-priority.ly’
When the break-align-symbols property is given as a list, the alignment depends on which symbols are visible.‘rehearsal-mark-align-staff-context.ly’
RehearsalMarks still align correctly if Mark_engraver is moved to another context.‘rehearsal-mark-align.ly’
The rehearsal mark is put on top a breakable symbol, according to the value ofbreak-align-symbols
value of the
RehearsalMark
. The same holds for BarNumber
grobs.
‘rehearsal-mark-direction.ly’
Rehearsal marks with direction DOWN get placed at the bottom of the score.‘rehearsal-mark-final-score.ly’
Rehearsal marks at the end of the last measure of a score are automatically made visible.‘rehearsal-mark-letter.ly’
Rehearsal marks in letter style: the I is skipped, and after Z, double letters are used. The mark may be set with\mark NUMBER
, or with Score.rehearsalMark
.
‘rehearsal-mark-number.ly’
Marks can be printed as numbers.
By setting markFormatter
we may choose a different style of mark printing. Also, marks can be specified manually, with a markup argument.
‘relative-repeat.ly’
Relative mode for repeats uses order of entry.‘repeat-line-break.ly’
Across linebreaks, the left edge of a first and second alternative bracket should be equal.
‘repeat-percent-count-visibility.ly’
Percent repeat counters can be shown at regular
intervals by setting repeatCountVisibility
.
‘repeat-percent-count.ly’
Percent repeats get incremental numbers whencountPercentRepeats
is set, to indicate the repeat counts, but
only if there are more than two repeats.
‘repeat-percent-grace.ly’
Percent repeats are also centered when there is a grace note in a parallel staff.‘repeat-percent-kerning.ly’
The positioning of dots and slashes in percent repeat glyphs can be altered usingdot-negative-kern
and
slash-negative-kern
.
‘repeat-percent-skipbars.ly’
Percent repeats are not skipped, even whenskipBars
is set.
‘repeat-percent.ly’
Measure repeats may be nested with beat repeats.‘repeat-slash.ly’
Within a bar, beat repeats denote that a music snippet should be played again.‘repeat-tie.ly’
Repeat ties are only connected on the right side to a note head.‘repeat-tremolo-beams.ly’
Each of the staves here should have four tremolo beams.‘repeat-tremolo-dots.ly’
Dots are added to tremolo notes if the durations involved require them.‘repeat-unfold-all.ly’
Volta repeats may be unfolded through the music function\unfoldRepeats
.
‘repeat-unfold-tremolo.ly’
Unfolding tremolo repeats. All fragments fill one measure with 16th notes exactly.‘repeat-unfold.ly’
LilyPond has two modes for repeats: unfolded and semi-unfolded. Unfolded repeats are fully written out. Semi unfolded repeats have the body written and all alternatives sequentially. If the number of alternatives is larger than the repeat count, the excess alternatives are ignored. If the number of alternatives is smaller, the first alternative is multiplied to get to the number of repeats.Unfolded behavior:
‘repeat-volta-skip-alternatives.ly’
When too few alternatives are present, the first alternative is repeated, by printing a range for the 1st repeat.‘repeat-volta.ly’
Volta (Semi folded) behavior. Voltas can start on non-barline moments. If they don’t barlines should still be shown.
‘rest-collision-beam-note.ly’
Beam/rest collision resolution and normal rest/note collisions can be combined.‘rest-collision-beam-quantized.ly’
Rests under beams are moved by whole staff spaces.‘rest-collision-beam-restdir.ly’
Beam/rest collision takes offset due toRest #'direction
into
account properly.
‘rest-collision-beam.ly’
Rests under beams are shifted upon collision.‘rest-collision-note-duration.ly’
Vertical rest positions in a multi-voice staff should obey the duration of notes; this is, they shouldn’t return to a default position too early.‘rest-collision.ly’
Rests should not collide with beams, stems and noteheads. Rests may be under beams. Rests should be move by integral number of spaces inside the staff, and by half spaces outside. Notice that the half and whole rests just outside the staff get ledger lines in different cases.
‘rest-dot-position.ly’
Dots of rests should follow the rest positions.‘rest-ledger.ly’
Whole and half rests moving outside the staff should get ledger lines.‘rest-note-collision.ly’
In rest-note collisions, the rest moves in discrete steps, and inside the staff, it moves in whole staff spaces.‘rest-pitch.ly’
Rests can have pitches–these will be affected by transposition and relativization. If a rest has a pitch, rest/rest and beam/rest collision resolving will leave it alone.‘rest-pitched-beam.ly’
Pitched rests under beams.‘rest-polyphonic.ly’
In polyphonic situations, rests are moved down even if there is no opposite note or rest. The amount is twostaff-space
s.
‘rest.ly’
There is a big variety of rests. Note that the dot of 8th, 16th and 32nd rests rest should be next to the top of the rest. All rests except the whole rest are centered on the middle staff line.
‘rhythmic-staff.ly’
In rhythmic staves stems should go up, and bar lines have the size for a 5 line staff. The whole rest hangs from the rhythmic staff.‘safe.ly’
This should not survive lilypond –safe-mode‘scheme-book-scores.ly’
Scores can be generated with scheme, too, and inserted into the current book(part). Generated and explicit scores can be mixed, the header informations from top- and booklevel stack correctly.‘scheme-engraver-instance.ly’
Scheme engravers may be instantiated, with instance-scoped slots, by defining a 1 argument procedure which shall return the engraver definition as an alist, with the private slots defined in a closure. The argument procedure argument is the context where the engraver is instantiated.‘scheme-engraver.ly’
\consists can take a scheme alist as arguments, which should be functions, which will be invoked as engraver functions.‘score-text.ly’
Markup texts are rendered above or below a score.‘script-center-seconds.ly’
Scripts on chords with seconds remain centered on the extremal note head‘script-collision.ly’
Scripts are put on the utmost head, so they are positioned correctly when there are collisions.‘script-horizontal-slur.ly’
Horizontal scripts don’t haveavoid-slur
set.
‘script-shift.ly’
Thetoward-stem-shift
property controls the precise
horizontal location of scripts that are placed above an upstem or below
a downstem note (0.0
means centered on the note head, 1.0
means centered on the stem).
‘script-stack-horizontal.ly’
horizontal scripts are ordered, so they do not overlap. The order may be set with script-priority.The scripts should not be folded under the time signature.
‘script-stack-order.ly’
Scripts can be stacked. The order is determined by a priority field, but when objects have the same priority, the input order determines the order. Objects specified first are closest to the note.‘script-stacked.ly’
Scripts may be stacked.‘script-stem-tremolo.ly’
Scripts avoid stem tremolos even if there is no visible stem.‘semi-tie-manual-direction.ly’
Semi tie directions may be forced from the input.‘size11.ly’
Different text styles are used for various purposes.
‘size13.ly’
Different text styles are used for various purposes.
‘size16.ly’
Different text styles are used for various purposes.
‘size20.ly’
Different text styles are used for various purposes.
‘size23.ly’
Different text styles are used for various purposes.
‘size26.ly’
Different text styles are used for various purposes.
‘skip-of-length.ly’
skip-of-length and mmrest-of-length create skips and rests that last as long as their arguments.‘skiptypesetting-bar-check.ly’
skipTypesetting doesn’t affect bar checks.‘skiptypesetting-show-first-and-last.ly’
showFirstLength
and showLastLength
may be set at the
same time; both the beginning and the end of the score will be printed.
‘skiptypesetting-show-first.ly’
showFirstLength
will only show the first bit of a score
‘skiptypesetting-show-last.ly’
showLastLength
will only show the last bit of a score
‘skiptypesetting-tuplet.ly’
Tuplet brackets are also skipped withskipTypesetting
.
‘skyline-debug.ly’
-ddebug-skyline
draws the outline of the skyline used.
‘skyline-vertical-placement.ly’
Grobs that have outside-staff-priority set are positioned using a skyline algorithm so that they don’t collide with other objects.‘skyline-vertical-spacing.ly’
We use a skyline algorithm to determine the distance to the next system instead of relying only on bounding boxes. This keeps gaps between systems more uniform.‘slur-broken-trend.ly’
Across line breaks, slurs behave nicely. On the left, they extend to just after the preferatory matter, and on the right to the end of the staff. A slur should follow the same vertical direction it would have in unbroken state.
‘slur-clef.ly’
Slurs avoid clefs, but don’t avoid barlines.‘slur-cross-staff-beam.ly’
Slurs that depend on a cross-staff beam are not calculated until after line-breaking.‘slur-cross-staff.ly’
Slurs behave decently when broken across a linebreak.
‘slur-dash.ly’
The appearance of slurs may be changed from solid to dotted or dashed.‘slur-dots.ly’
Slurs should not get confused by augmentation dots. With a lot of dots, the problems becomes more visible.‘slur-double.ly’
Some composers use slurs both above and below chords. This can be typeset by settingdoubleSlurs
‘slur-dynamics.ly’
Dynamics avoid collision with slur.‘slur-extreme.ly’
Extreme slurs are scaled to fit the pattern, but only symmetrically.
Asymmetric slurs are created by setting eccentricity
.
‘slur-manual.ly’
Settingpositions
overrides the automatic
positioning of the slur. It selects the slur configuration closest to
the given pair.
‘slur-nice.ly’
Slurs should look nice and symmetric. The curvature may increase only to avoid noteheads, and as little as possible. Slurs never run through noteheads or stems.
‘slur-rest.ly’
Slurs may be placed over rests. The slur will avoid colliding with the rests.‘slur-scoring.ly’
Slur formatting is based on scoring. A large number of slurs are generated. Each esthetic aspect gets demerits, the best configuration (with least demerits) wins. This must be tested in one big file, since changing one score parameter for one situation may affect several other situations.Tunable parameters are in ‘scm/slur.scm’.
‘slur-script-inside.ly’
Slurs avoid scripts withavoid-slur
set to
inside
, scripts avoid slurs with avoid-slur
set to
around
. Slurs and scripts keep a distance of
slur-padding
.
‘slur-script.ly’
A slur avoids collisions with scripts, which are placed either inside or outside the slur, depending on the script. The slur responds appropriately if a script is moved.‘slur-symmetry-1.ly’
Symmetric figures should lead to symmetric slurs.‘slur-symmetry.ly’
Symmetric figures should lead to symmetric slurs.‘slur-tilt.ly’
The attachment point for strongly sloped slurs is shifted horizontally slightly. Without this correction, slurs will point into one note head, and point over another note head.‘slur-tuplet.ly’
TupletNumber
grobs are always inside slurs.
This may not work if the slur starts after the tuplet.
‘song-associated-voice.ly’
‘song-basic-nonenglish.ly’
‘song-basic.ly’
‘song-breathe.ly’
‘song-melisma.ly’
‘song-reordering.ly’
‘song-reordering2.ly’
‘song-repetition.ly’
‘song-skip-noword.ly’
‘song-skip.ly’
‘song-slurs.ly’
‘song-splitpart.ly’
‘song-stanzas.ly’
‘song-tempo.ly’
‘spacing-accidental-rest.ly’
Accidentals don’t collide with shifted-down rests.‘spacing-accidental-staffs.ly’
Accidentals in different staves do not affect the spacing of the eighth notes here.‘spacing-accidental-stretch.ly’
Accidentals do not influence the amount of stretchable space. The accidental does add a little non-stretchable space.‘spacing-accidental-tie.ly’
Horizontal spacing works as expected on tied notes with accidentals. No space is reserved for accidentals that end up not being printed, but accidentals that are printed don’t collide with anything.‘spacing-accidental.ly’
Accidentals sticking out to the left of a note will take a little more space, but only if the spacing is tight.‘spacing-bar-accidental.ly’
An accidental following a bar gets space so the left edge of the acc is at 0.3 - 0.6 staff space of the bar line‘spacing-bar-arpeggio.ly’
An arpeggio following a bar gets space‘spacing-bar-stem.ly’
Downstem notes following a barline are printed with some extra space. This is an optical correction similar to juxtaposed stems.The bar upstem should be approx 1.1 staff space, the bar downstem 1.3 to 1.5 staff space.
‘spacing-bar-whole-measure.ly’
Notes that fill a whole measure are preceded by extra space.‘spacing-clef-first-note.ly’
Clef changes at the start of a line get much more space than clef changes halfway the line.‘spacing-correction-accidentals.ly’
If right hand stems have accidentals, optical spacing correction is still applied, but only if the stem directions are different.‘spacing-empty-bar.ly’
Empty barlines do not affect spacing.‘spacing-end-of-line.ly’
Broken engraving of a bar at the end of a line does not upset the space following rests and notes.‘spacing-ended-voice.ly’
A voicelet (a very short voice to get polyphonic chords correct) should not confuse the spacing engine.
‘spacing-folded-clef-cross-staff.ly’
Clefs are also folded under cross staff constructs.‘spacing-folded-clef.ly’
A clef can be folded below notes in a different staff, if this does not disrupt the flow of the notes.‘spacing-folded-clef2.ly’
A clef can be folded below notes in a different staff, if there is space enough. WithPaper_column
stencil callbacks we
can show where columns are in the score.
‘spacing-folded-clef3.ly’
Voices that go back and forth between staves do not confuse the spacing engine.‘spacing-grace-duration.ly’
Spacing uses the duration of the notes, but disregards grace notes for this. In this example, the 8ths around the grace are spaced exactly as the other 8th notes.‘spacing-grace.ly’
Grace note runs have their own spacing variables inScore.GraceSpacing
. So differing grace note lengths inside a
run are spaced accordingly.
‘spacing-horizontal-skyline-grace.ly’
Skyline horizontal spacing may fold non-adjacent columns together, but they still do not collide. In this case, the arpeggio and the barline do not collide.‘spacing-horizontal-skyline.ly’
accidentals may be folded under preceding notes.‘spacing-knee-compressed.ly’
Spacing corrections for kneed beams still work when compression is involved.‘spacing-knee.ly’
For knees, the spacing correction is such that the stems are put at regular distances. This effect takes into account the width of the note heads and the thickness of the stem.‘spacing-loose-grace-error.ly’
Even in case of incorrect contexts (eg. shortlived contexts) that break linking of columns through spacing wishes,strict-note-spacing
defaults to a robust solution.
‘spacing-loose-grace-linebreak.ly’
If a floating grace spacing section attaches to a note across a line break, it gets attached to the end of line.‘spacing-loose-grace.ly’
Withstrict-grace-spacing
, grace notes don’t influence
spacing.
‘spacing-mark-width.ly’
Width of marks does not affect spacing.‘spacing-measure-length.ly’
Horizontal spacing is bounded by the current measure length. This means that the 3/8 setting does not affect the whole rest spacing.‘spacing-multi-tuplet.ly’
Concurrent tuplets should be equidistant on all staves. Such equidistant spacing is at odds with elegant engraver spacing; hence it must be switched on explicitly with theuniform-stretching
property of SpacingSpanner
.
‘spacing-no-note.ly’
In the absence of NoteSpacings, wide objects still get extra space. In this case, the slash before the barline gets a little more space.‘spacing-non-adjacent-columns1.ly’
The spacing engine avoids collisions between non-adjacent columns.‘spacing-non-adjacent-columns2.ly’
The spacing engine avoids collisions between non-adjacent columns.‘spacing-note-flags.ly’
The flags of 8th notes take some space, but not too much: the space following a flag is less than the space following a beamed 8th head.‘spacing-packed.ly’
In packed mode, pack notes as tight as possible. This makes sense mostly in combination with ragged-right mode: the notes are then printed at minimum distance. This is mostly useful for ancient notation, but may also be useful for some flavours of contemporary music. If not in ragged-right mode, lily will pack as many bars of music as possible into a line, but the line will then be stretched to fill the whole linewidth.
‘spacing-paper-column-padding.ly’
The space after a paper column can be increased by overriding the padding property.‘spacing-proportional.ly’
Proportional notation can be created by settingproportionalNotationDuration
. Notes will be spaced proportional
to the distance for the given duration.
‘spacing-ragged-last.ly’
Ifragged-last
is set, the systems are broken
similar to paragraph formatting in text: the last line is
unjustified.
‘spacing-rest.ly’
Rests get a little less space, since they are narrower. However, the quarter rest in feta font is relatively wide, causing this effect to be very small.‘spacing-section.ly’
New sections for spacing can be started with
ewSpacingSection
. In this example, a section is started at
the 4/16, and a 16th in the second section takes as much space as a
8th in first section.
‘spacing-short-notes.ly’
Notes that are shorter than the common shortest note get a space (i.e. without the space needed for the note) proportional to their duration. So, the 16th notes get 1/2 of the space of an eigth note. The total distance for a 16th (which includes note head) is 3/4 of the eighth note.‘spacing-space-to-barline.ly’
When space-to-barline is false, we measure the space between the note and the start of the clef. When space-to-barline is true, we measure the space between the note and the start of the barline.‘spacing-stem-bar.ly’
Upstem notes before a barline are printed with some extra space. This is an optical correction similar to juxtaposed stems.‘spacing-stem-direction.ly’
There are optical corrections to the spacing of stems. The overlap between two adjacent stems of different direction is used as a measure for how much to correct.
‘spacing-stem-same-direction.ly’
For juxtaposed chords with the same direction, a slight optical correction is used. It is constant, and works only if two chords have no common head-positions range.‘spacing-stick-out.ly’
Ifkeep-inside-line
is set for the relevant
PaperColumn, LilyPond will space a line to prevent text sticking out
of the right margin.
‘spacing-strict-notespacing.ly’
Ifstrict-note-spacing
is set, then spacing of
notes is not influenced by bars and clefs half-way on the system.
Rather, they are put just before the note that occurs at the same
time. This may cause collisions.
‘spacing-strict-spacing-grace.ly’
Withstrict-note-spacing
spacing for grace notes
(even multiple ones), is floating as well.
‘spacing-to-empty-barline.ly’
An empty barline does not confuse the spacing engine too much. The two scores should look approximately the same.‘spacing-to-grace.ly’
Space from a normal note (or barline) to a grace note is smaller than to a normal note.‘spacing-uniform-stretching.ly’
Notes are spaced exactly according to durations, ifuniform-stretching
is set. Accidentals are ignored, and no
optical-stem spacing is performed.
‘span-bar-break.ly’
At the beginning of a system, the|:
repeat
barline is drawn between the staves, but the :|
is not.
‘span-bar-partial.ly’
Span bars can be turned on/off on a staff-by-staff basis.‘span-bar-spacing.ly’
SpanBars participate in the horizontal collision system; the accidentals should not collide with the bar lines.‘span-bar.ly’
Span bars are drawn only between staff bar lines. By setting bar lines to transparent, they are shown only between systems.Setting SpanBar
transparent removes the barlines
between systems.
‘spanner-after-line-breaking.ly’
The visibility of left-broken line spanners and hairpins which end on the first note (i.e., span no time between bounds) is controlled by the callbackly:spanner::kill-zero-spanned-time
.
‘spanner-break-beyond-parent.ly’
Spanners parts that extend beyond their parents are killed in case of line breaks.‘spanner-break-overshoot.ly’
Thebreak-overshoot
property sets the amount that
a spanner (in this case: the beam and tuplet bracket) in case of a line
break extends beyond the rightmost column and extends to the left beyond the
prefatory matter.
‘staccato-pos.ly’
Some scripts must have quantized postions. VErtical position descend monotonously for a descending scale. The staccato dot is close to the notehead. If the head is in a space, then the dot is in the space next to it.‘staff-halfway.ly’
Staves can be started and stopped at command.‘staff-line-positions.ly’
The vertical positions of staff lines may be specified individually, by setting theline-positions
property of the
StaffSymbol.
‘staff-mixed-size.ly’
Staves may be present in several sizes within a score. This is achieved with an internal scaling factor. If the scaling factor is forgotten in some places, objects generally become too thick or too large on smaller staves.‘staff-online-symbol-absence.ly’
Symbols that need on-staffline info (like dots and ties) continue to work in absence of a staff-symbol.‘staff-tweak.ly’
The staff is a grob (graphical object) which may be adjusted as well, for example, to have 6 thick lines and a slightly largestaff-space
.
However, beams remain correctly quantized.
‘stanza-number.ly’
Stanza numbers are put left of their lyric. They are aligned in a column.‘stem-direction-context.ly’
Stem directions for notes on the middle staff line are determined by the directions of their neighbors.‘stem-direction.ly’
Stems, beams, ties and slurs should behave similarly, when placed on the middle staff line. Of course stem-direction is down for high notes, and up for low notes.
‘stem-length-estimation.ly’
Stems with overridden ’length should not confuse height estimation. This example should fit snugly on one page.‘stem-shorten.ly’
If note head is ‘over’ the center line, the stem is shortened. This happens with forced stem directions, and with some chord configurations.‘stem-stemlet-whole.ly’
Stemlets don’t cause stems on whole notes.‘stem-stemlet.ly’
Stemlets are small stems under beams over rests. Their length can be set withstemlet-length
.
‘stem-tremolo-forced-dir.ly’
‘stem-tremolo-position.ly’
Tremolos are positioned a fixed distance from the end of the beam. Tremolo flags are shortened and made rectangular on beamed notes or on stem-up notes with a flag. Tremolo flags are tilted extra on stem-down notes with a flag.‘stem-tremolo-staff-space.ly’
stem tremolo vertical distance also obeys staff-space settings.‘stem-tremolo.ly’
Stem tremolos or rolls are tremolo signs that look like beam segments crossing stems. If the stem is in a beam, the tremolo must be parallel to the beam. If the stem is invisible (e.g. on a whole note), the tremolo must be centered on the note. If the note has a flag (eg. an unbeamed 8th note), the tremolo should be shortened if the stem is up and tilted extra if the stem is down.
The tremolos should be positioned a fixed distance from the end of the stems unless there is no stem, in which case they should be positioned a fixed distance from the note head.
‘stencil-color-rotation.ly’
Combinations of rotation and color do work.‘stencil-hacking.ly’
You can write stencil callbacks in Scheme, thus providing custom glyphs for notation elements. A simple example is adding parentheses to existing stencil callbacks.The parenthesized beam is less successful due to implementation of the Beam. The note head is also rather naive, since the extent of the parens are also not seen by accidentals.
‘string-number-around-slur.ly’
String numbers should only be moved outside slurs when there is a collision.‘string-number.ly’
String numbers can be added to chords. They use the same positioning mechanism as finger instructions.‘system-extents.ly’
The size of every system is correctly determined; this includes postscript constructs such as slurs.‘system-overstrike.ly’
By setting the padding between systems to a negative value, it is possible to eliminate the anti-collision constraints.‘system-separator.ly’
System separators may be defined as markups in thesystem-separator-markup
field of the paper block. They are
centered between the boundary staves of each system.
‘system-start-bracket.ly’
A piano context included within a staff group should cause the piano brace to be drawn to the left of the staff angle bracket.‘system-start-heavy-bar.ly’
A heavy-bar system start delimiter may be created by tuning theSystemStartBar
grob.
‘system-start-nesting.ly’
Deeply nested system braces, brackets, etc., may be created with thesystemStartDelimiterHierarchy
property.
‘tablature-banjo.ly’
Tablature may also be tuned for banjo.‘tablature-chord-repetition.ly’
In a TabStaff, the chord repetition function needs to save the string information. This is handled by\tabChordRepetition
.
‘tablature-full-notation.ly’
As default, tablature staves show only the fret numbers, because in most situations, they are combined with normal staves. When used without standard notation,tabFullNotation
can be used.
‘tablature-glissando.ly’
Glissando lines in tablature have the right slope.‘tablature-grace-notes.ly’
Fret numbers belonging to grace notes are smaller.‘tablature-harmonic.ly’
Harmonics get angled brackets in tablature‘tablature-letter.ly’
A sample tablature with lettered tab, using fretLabels to modify the fret letters.By default, letters are drawn sequentially from the alphabet, but if the context property fretLabels is defined, these are substituted. If specified, the length of fretLabels must be sufficient to label all the frets used. A warning is issued if the length is too short.
‘tablature-slide.ly’
Tab supports slides.‘tablature-string-tunings.ly’
For other tunings, it is sufficient to setstringTunings
. The number of staff lines is adjusted
accordingly.
‘tablature-tie-behaviour.ly’
In tablature, notes that are tied to are invisible except after a line break or within a second volta; here, the fret number is displayed in parentheses.As an option, the notes that are tied to may become invisible completely, even after line breaks.
‘tablature.ly’
A sample tablature, with both normal staff and tab.Tablature is done by overriding the note-head formatting function, and putting it on a 6-line staff. A special engraver takes care of going from string-number + pitch to number.
String numbers can be entered as note articulations (inside a chord) and chord articulations (outside a chord)
‘tag-filter.ly’
The\tag
command marks music expressions with a
name. These tagged expressions can be filtered out later. This
mechanism can be used to make different versions of the same music. In
this example, the top stave displays the music expression with all
tags included. The bottom two staves are filtered: the part has cue
notes and fingerings, but the score has not.
‘test-output-distance.ly’
This file gives a different result each time it is run, so it should always show up in the output-distance testing.‘text-spanner-attachment-alignment.ly’
Text and trill spanners are attached to note columns, so attachments in other staves have no effect on them.‘text-spanner-override-order.ly’
The order of setting nested properties does not influence text spanner layout.‘text-spanner.ly’
Text spanners should not repeat start text when broken.‘tie-accidental.ly’
lilypond should flip the tie’s direction to avoid a collision with the sharp.
‘tie-arpeggio-collision.ly’
Advanced tie chord formatting also works with arpegiated ties. Due to arpeggios, tie directions may be changed relative to the unarpegiated case.‘tie-arpeggio.ly’
whentieWaitForNote
is set, the right-tied note does not
have to follow the lef-tied note directly. When tieWaitForNote
is set to false, any tie will erase all pending ties.
‘tie-broken-minimum-length.ly’
Broken ties honorminimum-length
also. This tie
has a minimum-length
of 5.
‘tie-broken-other-staff.ly’
Broken tie lengths are not affected by clefs in other staves.‘tie-broken.ly’
Ties behave properly at line breaks.‘tie-chord-broken-extremal.ly’
Tie detail property multi-tie-region-size controls how many variations are tried for the extremal ties in a chord.
‘tie-chord-debug.ly’
Switching on debug-tie-scoring annotates the tie scoring decisions made.‘tie-chord-partial.ly’
Individual chord notes can also be tied‘tie-chord.ly’
In chords, ties keep closer to the note head vertically, but never collide with heads or stems. Seconds are formatted up/down; the rest of the ties are positioned according to their vertical position.The code does not handle all cases. Sometimes ties will printed on top of or very close to each other. This happens in the last chords of each system.
‘tie-dash.ly’
The appearance of ties may be changed from solid to dotted or dashed.‘tie-direction-broken.ly’
In the single tie case, broken ties peek across line boundaries to determine which direction to take.‘tie-direction-manual.ly’
Tie directions can be set with_
and ^
.
This makes correction in complex chords easier.
‘tie-dot.ly’
Ties avoid collisions with dots.‘tie-grace.ly’
Tying a grace to a following grace or main note works.‘tie-manual-vertical-tune.ly’
If using integers, the tie will vertically tuned for staff line avoidance. If using a floating point number, this is taken as the exact location.‘tie-manual.ly’
Tie formatting may be adjusted manually, by setting thetie-configuration
property. The override should be placed at
the second note of the chord.
You can leave a Tie alone by introducing a non-pair value
(eg. #t
) in the tie-configuration
list.
‘tie-semi-single.ly’
Like normal ties, single semities (LaissezVibrerTie or RepeatTie) get their direction from the stem direction, and may be tweaked with#'direction
.
‘tie-single-chord.ly’
Tie directions are also scored. In hairy configurations, the default rule for tie directions is overruled.‘tie-single-manual.ly’
Individual ties may be formatted manually by specifying theirdirection
and/or staff-position
.
‘tie-single.ly’
Formatting for isolated ties.- short ties are in spaces
- long ties cross staff lines
- ties avoid flags of left stems.
- ties avoid dots of left notes.
- short ties are vertically centered in the space, as well those that otherwise don’t fit in a space
- extremely short ties are put over the noteheads, instead of inbetween.
‘tie-whole.ly’
For whole notes, the inside ties do not cross the center of the note head, horizontally.‘to-xml.ly’
The input representation is generic, and may be translated to XML.‘toc.ly’
A table of contents is included using\markuplines \table-of-contents
. The toc items are added with
the \tocItem
command.
‘trill-spanner-auto-stop.ly’
Consecutive trill spans work without explicit\stopTrillSpan
commands, since successive trill spanners
will automatically become the right bound of the previous trill.
‘trill-spanner-broken.ly’
A TrillSpanner crossing a line break should restart exactly above the first note on the new line.
‘trill-spanner-chained.ly’
Chained trills end at the next trill or barline. Collisions can be prevented by overridingbound-details
.
‘trill-spanner-grace.ly’
Trill spanner can end on a grace note‘trill-spanner-pitched-consecutive.ly’
Pitched trills on consecutive notes with the same name and octave should not lose accidentals; in the following example, accidentals should be visible for all trill-pitches.‘trill-spanner-pitched-forced.ly’
Pitched trill accidentals can be forced.‘trill-spanner-pitched.ly’
Pitched trills are denoted by a small note head in parentheses following the main note. This note head is properly ledgered, and parentheses include the accidental.‘trill-spanner-scaled.ly’
The horizontal position of the beginning of a trill spanner is positioned correctly relative to the note head it is attached to, even if scaled to a smaller size.
‘trill-spanner.ly’
The trill symbol and the wavy line are neatly aligned: the wavy line should appear to come from the crook of the r‘tuplet-beam.ly’
In combination with a beam, the bracket of the tuplet bracket is removed. This only happens if there is one beam, as long as the bracket.‘tuplet-bracket-cross-staff.ly’
Cross-staff tuplets are drawn correctly, even across multiple staves.‘tuplet-bracket-visibility.ly’
The default behavior of tuplet-bracket visibility is to print a bracket unless there is a beam of the same length as the tuplet. Overriding'bracket-visibility
changes the bracket visibility as follows:
-
#t
(always print a bracket) -
#f
(never print a bracket) -
#'if-no-beam
(only print a bracket if there is no beam)
‘tuplet-broken.ly’
Broken tuplets are adorned with little arrows. The arrows come from theedge-text
property, and thus be replaced with
larger glyphs or other text.
‘tuplet-full-length-extent.ly’
Withfull-length-to-extent
, the extent of the
attaching column for a full-length tuplet bracket can be ignored.
‘tuplet-full-length-note.ly’
tuplet can be made to run to prefatory matter or the next note, by settingtupletFullLengthNote
.
‘tuplet-full-length.ly’
IftupletFullLength
is set, tuplets end at the
start of the next non-tuplet note.
‘tuplet-gap.ly’
The size of the tuplet bracket gap is adjusted to the width of the text.‘tuplet-nest-beam.ly’
Nested tuplets do collision resolution, also when they span beams.‘tuplet-nest.ly’
Tuplets may be nested.‘tuplet-no-stems.ly’
Removing Stem_engraver doesn’t cause crashes.‘tuplet-properties.ly’
Tuplet bracket formatting supports numerous options, for instance, bracketed (B) and non-bracketed (NB).‘tuplet-rest.ly’
Tuplets may contain rests.‘tuplet-single-note.ly’
Show tuplet numbers also on single-note tuplets (otherwise the timing would look messed up!), but don’t show a bracket. Make sure that tuplets without any notes don’t show any number, either.‘tuplet-slope.ly’
Tuplet brackets stay clear of the staff. The slope is determined by the graphical characteristic of the notes, but if the musical pattern does not follow graphical slope, then the bracket is horizontalThe bracket direction is determined by the dominating stem direction.
‘tuplet-staffline-collision.ly’
Horizontal tuplet brackets are shifted vertically to avoid staff line collisions.‘tuplet-text-different-numbers.ly’
Non-standard tuplet texts: Printing other tuplet fractions than the ones actually assigned.‘tuplet-text-fraction-with-notes.ly’
Non-standard tuplet texts: Printing a tuplet fraction with note durations assigned to both the denominator and the numerator.‘tuplet-text-note-appended.ly’
Non-standard tuplet texts: Appending a note value to the normal text and to the fraction text.‘tuplets.ly’
Tuplets are indicated by a bracket with a number. There should be no bracket if there is a beam exactly matching the length of the tuplet. The bracket does not interfere with the stafflines, and the number is centered in the gap in the bracket.
The bracket stops at the end of the stems, if the stems have the same
direction as the bracket. The endings can be adjusted with
bracket-flare
.
‘typography-demo.ly’
heavily mutilated Edition Peters Morgenlied by Schubert
‘utf-8-mixed-text.ly’
words in mixed font in a single string are separated by spaces as in the input string. Here a Russian word followed by a roman word.‘utf-8.ly’
Various scripts may be used for texts (like titles and lyrics) introduced by entering them in UTF-8 encoding, and using a Pango based backend. Depending on the fonts installed, this fragment will render Bulgarian (Cyrillic), Hebrew, Japanese and Portuguese.‘voice-follower.ly’
Whenever a voice switches to another staff a line connecting the notes
can be printed automatically. This is enabled if the property
followVoice
is set to true.
‘volta-broken-left-edge.ly’
Broken volta spanners behave correctly at their left edge in all cases.‘volta-markup-text.ly’
Volte usingrepeatCommands
can have markup
text.
‘volta-multi-staff-inner-staff.ly’
By putting Volta_engraver in a staff context, one can get volta brackets on staves other than the topmost one.‘volta-multi-staff.ly’
By default, the volta brackets appear only in the topmost staff.‘warn-conflicting-key-signatures.ly’
If you specify two different key signatures at one point, a warning is printed.‘warn-unterminated-span-dynamic.ly’
A warning is printed if a dynamic spanner is unterminated.‘whiteout-lower-layers.ly’
If the ’whiteout property of a grob is set to #t, that part of all objects in lower layers which falls under the extent of the grob is whited out. Here the TimeSignature whites out the Tie but not the StaffSymbol.‘whiteout.ly’
The whiteout command underlays a white box under a markup. The whitening effect only is only guaranteed for staff lines, since staff lines are in a lower layer than most other grobs.‘woodwind-diagrams-empty.ly’
Empty woodwind diagrams for all instruments in woodwind-diagrams.scm.‘woodwind-diagrams-key-lists.ly’
Lists all possible keys for all instruments in woodwind-diagrams.scm[Top][Contents][Index][ ? ] |
About This Document
This document was generated by Graham Percival on July 6, 2010 using texi2html 1.82.
The buttons in the navigation panels have the following meaning:
Button | Name | Go to | From 1.2.3 go to |
---|---|---|---|
[] | |||
[ << ] | FastBack | Beginning of this chapter or previous chapter | 1 |
[] | |||
[Top] | Top | Cover (top) of document | |
[Contents] | Contents | Table of contents | |
[Index] | Index | Index | |
[ ? ] | About | About (help) | |
[] | |||
[ >> ] | FastForward | Next chapter | 2 |
[] | |||
[] | |||
[ < ] | Back | Previous section in reading order | 1.2.2 |
[] | |||
[ Up ] | Up | Up section | 1.2 |
[] | |||
[ > ] | Forward | Next section in reading order | 1.2.4 |
where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:
- 1. Section One
- 1.1 Subsection One-One
- ...
- 1.2 Subsection One-Two
- 1.2.1 Subsubsection One-Two-One
- 1.2.2 Subsubsection One-Two-Two
- 1.2.3 Subsubsection One-Two-Three <== Current Position
- 1.2.4 Subsubsection One-Two-Four
- 1.3 Subsection One-Three
- ...
- 1.4 Subsection One-Four
- 1.1 Subsection One-One