@node Overview of the supported styles
@subsection Overview of the supported styles
-
Three styles are available for typesetting Gregorian chant:
@itemize
Music Glossary:
@rglos{custos}.
-Internals Reference:
-@rinternals{Custos}.
-
Snippets:
@rlsr{Ancient notation}.
+Internals Reference:
+@rinternals{Custos}.
+
@node Figured bass support
@unnumberedsubsubsec Figured bass support
}
@end lilypond
-
@seealso
Music Glossary:
@rglos{mensural notation}.
Notation Reference:
@ref{Clef}.
-
@knownissues
The mensural g clef is mapped to the Petrucci g clef.
@c music, the default flag style should be used.
There are no flags in Gregorian chant notation.
-
@seealso
Music Glossary:
@rglos{mensural notation},
@rglos{flag}.
-
@knownissues
The attachment of ancient flags to stems is slightly off.
@c due to a change in early 2.3.x.
Snippets:
@rlsr{Ancient notation}.
-
@knownissues
The glyph for the maxima rest in mensural style is actually a perfect
longa rest; use two (or three) longa rests to print a maxima rest.
}
@end lilypond
-
@seealso
Internals Reference:
@rinternals{Accidental_engraver},
Horizontal spacing of ligatures is poor.
Accidentals may collide with previous notes.
+
@node Typesetting Gregorian chant
@subsection Typesetting Gregorian chant
@ref{White mensural ligatures},
@ref{Ligatures}.
+
@node Gregorian chant contexts
@unnumberedsubsubsec Gregorian chant contexts
@end lilypond
@end multitable
-
@seealso
Music Glossary:
@rglos{clef}.
@code{\override Staff.Accidental #'glyph-name-alist =
#alteration-mensural-glyph-name-alist}
-
@seealso
Music Glossary:
@rglos{accidental},
@ref{Breath marks}.
Installed Files:
-@file{gregorian.ly}.
+@file{ly/gregorian.ly}.
@node Gregorian articulation signs
}
@end lilypond
-
@seealso
Notation Reference:
@ref{Articulations and ornamentations}.
@rinternals{ScriptEvent},
@rinternals{Script_engraver}.
-
@knownissues
Some articulations are vertically placed too closely to the
corresponding note heads.
}
@end lilypond
-
@seealso
Notation Reference:
@ref{Breath marks}.
@ref{White mensural ligatures},
@ref{Ligatures}.
-
@knownissues
When an @code{\augmentum} dot appears at the end of the last staff
within a ligature, it is sometimes vertically placed wrong. As a
@c use snippet Transcription-of-ancient-music-with-incipit
TBC
-
@c @seealso
@c ... and reference to other sections ...
@c from lsr and -user
@c TBC
-
@c @seealso
@c ... and reference to other sections ...
@c @seealso
@c ... and reference to other sections ...
-
* Context layout order::
@end menu
-
@seealso
Learning Manual:
@rlearning{Contexts and engravers}.
contain it. This can give rise to unexpected new staves or scores.
@seealso
-Usage Manual:
+Application Usage:
@rprogram{An extra staff appears}.
Installed Files:
@file{ly/engraver-init.ly}.
-
@node Explaining the Internals Reference
@section Explaining the Internals Reference
-
@menu
* Navigating the program reference::
* Layout interfaces::
@end ignore
@seealso
-Internals:
+Internals Reference:
@rinternals{Backend},
@rinternals{All layout objects},
@rinternals{OverrideProperty},
@rinternals{RevertProperty},
@rinternals{PropertySet}.
-
@knownissues
-
The back-end is not very strict in type-checking object properties.
Cyclic references in Scheme values for properties can cause hangs
or crashes, or both.
-
@node The set command
@subsection The @code{@bs{}set} command
@end ifnothtml
@seealso
-
Internals Reference:
-
@rinternals{Tunable context properties}.
-
@cindex grob properties
@cindex properties, grob
@funindex \override
@end ignore
@seealso
-
Internals Reference:
@rinternals{Backend}
+
@node The tweak command
@subsection The @code{\tweak} command
in determining how to adjust the input to make a @code{\tweak}
apply.
-
@seealso
Learning Manual:
@rlearning{Tweaking methods}.
-Extending:
+Extending LilyPond:
@rextend{Displaying music expressions}.
-
@knownissues
-
@cindex tweaks in a variable
+
The @code{\tweak} command cannot be used inside a variable.
@cindex tweaks in lyrics
The @code{\tweak} command will apply to only the first of several
generated ties in a chord.
+
@node set versus override
@subsection @code{\set} vs. @code{\override}
@code{staff-space}. For an explanation and an example of its use,
see @rlearning{Length and thickness of objects}.
-
@seealso
Learning Manual:
@rlearning{Length and thickness of objects}.
\startTextSpan with \stopTextSpan, nor is it necessary to close
hairpins with @code{\!}.
-
@seealso
Internals Reference:
@rinternals{TextSpanner},
property controls both the clef symbol and any octavation symbol
associated with it.
-
@seealso
Learning Manual:
-@rlearning{Visibility and color of objects}
+@rlearning{Visibility and color of objects}.
@node Line styles
* Unpure-pure containers::
@end menu
-
@seealso
Learning Manual:
@rlearning{Tweaking output},
@ref{Explaining the Internals Reference},
@ref{Modifying properties}.
+Extending LilyPond:
+@rextend{Interfaces for programmers}.
+
Installed Files:
@file{scm/define-grobs.scm}.
Snippets:
@rlsr{Tweaks and overrides}.
-Extending:
-@rextend{Interfaces for programmers}.
-
Internals Reference:
@rinternals{All layout objects}.
for positioning rehearsal marks on such objects.
@seealso
-@ref{Using the break-alignable-interface},
+Internals Reference:
+@ref{Using the break-alignable-interface}.
+
+Exending LilyPond:
@rextend{Callback functions}.
@menu
@c TODO Add inserting Postscript or ref to later
-
@seealso
Notation Reference:
@ref{Graphic notation inside markup},
@cindex unpure containers, Scheme
@cindex horizontal spacing, overriding
+
@node Unpure-pure containers
@subsection Unpure-pure containers
@ref{Predefined type predicates}. User-defined type predicates
are also allowed.
-
@seealso
-
Notation Reference:
@ref{Predefined type predicates}.
-Extending:
+Extending Lilypond:
@rextend{Music functions}.
Installed Files:
\chordmode { f2 g }
@end lilypond
-
@seealso
Music Glossary:
@rglos{chord}.
Snippets:
@rlsr{Chords}.
-
@knownissues
-
Predefined shorthands for articulations and ornaments cannot be used
on notes in chord mode, see @ref{Articulations and ornamentations}.
}
@end lilypond
+
@node Common chords
@unnumberedsubsubsec Common chords
@end multitable
-
@seealso
Notation Reference:
@ref{Common chord modifiers},
Snippets:
@rlsr{Chords}.
-
@knownissues
Only one quality modifier should be used per chord, typically on the
highest step present in the chord. Chords with more than quality
standard chords are shown in
@ref{Common chord modifiers}.
-
@seealso
Notation Reference:
@ref{Common chord modifiers}.
Snippets:
@rlsr{Chords}.
-
@knownissues
-
Each step can only be present in a chord once. The following
simply produces the augmented chord, since @code{5+} is
interpreted last.
}
@end lilypond
+
@node Displaying chords
@subsection Displaying chords
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{simple-lead-sheet.ly}
-
@seealso
Music Glossary:
@rglos{chord}.
@rinternals{Volta_engraver},
@rinternals{Bar_engraver}.
-
@knownissues
-
Chords containing inversions or altered bass notes are not named
properly if entered using simultaneous music.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-chord-separator.ly}
-
@seealso
Notation Reference:
@ref{Chord name chart},
Snippets:
@rlsr{Chords}.
-@c Internals Reference:
-@c @r internals{}.
-
-
@knownissues
-
Chord names are determined from both the pitches that are present
in the chord and the information on the chord structure that may
have been entered in @code{\chordmode}. If the simultaneous pitches
@code{baseline-skip}.
@end ignore
-
@seealso
Music Glossary:
@rglos{figured bass}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-the-positions-of-figured-bass-alterations.ly}
-
@seealso
-@c Music Glossary:
-@c @rglos{}.
-@c
-@c Learning Manual:
-@c @rlearning{}.
-@c
-@c Notation Reference:
-@c @ref{}.
-@c
-@c Application Usage:
-@c @rprogram{}.
-@c
-@c Installed Files:
-@c @file{}.
-@c
Snippets:
@rlsr{Chords}.
@rinternals{FiguredBass}.
-@c @knownissues
-
-
@node Displaying figured bass
@unnumberedsubsubsec Displaying figured bass
>>
@end lilypond
-
@predefined
@cindex figured bass alignment
@code{\bassFigureStaffAlignmentDown},
@code{\bassFigureStaffAlignmentNeutral}.
@endpredefined
-
-@c @snippets
-
-
@seealso
-@c Music Glossary:
-@c @rglos{}.
-@c
-@c Learning Manual:
-@c @rlearning{}.
-@c
-@c Notation Reference:
-@c @ref{}.
-@c
-@c Application Usage:
-@c @rprogram{}.
-@c
-@c Installed Files:
-@c @file{}.
-@c
Snippets:
@rlsr{Chords}.
@rinternals{BassFigureContinuation},
@rinternals{FiguredBass}.
-
@knownissues
-
To ensure that continuation lines work properly, it is
safest to use the same rhythm in the figure line as in
the bass line.
}
>>
@end lilypond
-
@code{\huge}.
@endpredefined
-
@seealso
Snippets:
@rlsr{Editorial annotations}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{avoiding-collisions-with-chord-fingerings.ly}
-
@seealso
Notation Reference:
@ref{Direction and placement}.
@code{\unHideNotes}.
@endpredefined
-
@seealso
Learning Manual:
@rlearning{Visibility and color of objects}.
gis4 a
@end lilypond
-
@seealso
Notation Reference:
@ref{List of colors}, @ref{The
Snippets:
@rlsr{Editorial annotations}.
-
@cindex x11 color
@cindex colored notes in chords
@cindex notes, colored in chords
and @code{ForestGreen}. For web use normal colors are recommended
(i.e., @code{blue}, @code{green}, @code{red}).
-
Notes in a chord cannot be colored with @code{\override}; use
@code{\tweak} instead, see @ref{The tweak command}.
c2 \parenthesize r
@end lilypond
-
@seealso
Snippets:
@rlsr{Editorial annotations}.
@rinternals{ParenthesesItem},
@rinternals{parentheses-interface}.
-
@knownissues
-
Parenthesizing a chord prints parentheses around each individual
note, instead of a single large parenthesis around the entire
chord.
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{default-direction-of-stems-on-the-center-line-of-the-staff.ly}
-
@seealso
Notation Reference:
@ref{Direction and placement}.
}
@end lilypond
-
@predefined
@code{\balloonLengthOn},
@code{\balloonLengthOff}.
@endpredefined
-
@seealso
Snippets:
@rlsr{Editorial annotations}.
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{grid-lines--changing-their-appearance.ly}
-
@seealso
Snippets:
@rlsr{Editorial annotations}.
}
@end lilypond
-
@seealso
Snippets:
@rlsr{Editorial annotations}.
@rinternals{HorizontalBracket},
@rinternals{horizontal-bracket-interface},
@rinternals{Staff}.
-
@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-text-and-spanner-styles-for-text-dynamics.ly}
-
@seealso
Music Glossary:
@rglos{al niente},
Font settings in markup mode are described in
@ref{Selecting font and font size}.
-
@seealso
Notation Reference:
@ref{Formatting text},
@ref{What goes into the MIDI output?},
@ref{Controlling MIDI dynamics}.
-Snippets:
-@rlsr{Expressive marks}.
-
-Extend:
+Extending LilyPond:
@rextend{Markup construction in Scheme}.
+Snippets:
+@rlsr{Expressive marks}.
@node Expressive marks as curves
@lilypondfile[verbatim,quote,texidoc,doctitle]
{making-slurs-with-complex-dash-structure.ly}
-
@seealso
Music Glossary:
@rglos{slur}.
@code{\phrasingSlurSolid}.
@endpredefined
-
@seealso
Learning Manual:
@rlearning{On the un-nestedness of brackets and ties}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{inserting-a-caesura.ly}
-
@seealso
Music Glossary:
@rglos{caesura}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{adjusting-the-shape-of-falls-and-doits.ly}
-
@seealso
Music Glossary:
@rglos{fall},
@lilypondfile[verbatim,quote,texidoc,doctitle]
{contemporary-glissando.ly}
-
@seealso
Music Glossary:
@rglos{glissando}.
Internals Reference:
@rinternals{Glissando}.
-
@knownissues
-
Printing text over the line (such as @notation{gliss.}) is not
supported.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{creating-arpeggios-across-notes-in-different-voices.ly}
-
@seealso
Music Glossary:
@rglos{arpeggio}.
@rinternals{Slur},
@rinternals{PianoStaff}.
-
@knownissues
-
@cindex cross-staff parenthesis-style arpeggio
@cindex arpeggio, parenthesis-style, cross-staff
@cindex arpeggio, cross-staff parenthesis-style
eis4\stopTrillSpan
@end lilypond
-
@predefined
@code{\startTrillSpan},
@code{\stopTrillSpan}.
Internals Reference:
@rinternals{TrillSpanner}.
-
@end itemize
-
@seealso
Notation Reference:
@ref{Fingering instructions},
@lilypondfile[verbatim,quote,texidoc,doctitle]
{allowing-fingerings-to-be-printed-inside-the-staff.ly}
-
@seealso
Notation Reference:
@ref{Fingering instructions}.
Guitar special effects are limited to harmonics and slides.
+
@node Custom tablatures
@unnumberedsubsubsec Custom tablatures
@ref{Scheme functions}.
Installed Files:
-@file{ly/string-tuning-init.ly}
+@file{ly/string-tuning-init.ly},
@file{scm/tablature.scm}.
Snippets:
cases for instruments where string pitches do not vary
monotonically with string number, such as ukuleles.
+
@node Fret diagram markups
@unnumberedsubsubsec Fret diagram markups
@node Predefined fret diagrams
@unnumberedsubsubsec Predefined fret diagrams
-
@cindex fret diagrams
@cindex fret diagrams, ukulele
@cindex fret diagrams, mandolin
@lilypondfile[verbatim,quote,texidoc,doctitle]
{fretboards-alternate-tables.ly}
-
@seealso
Notation Reference:
@ref{Custom tablatures},
@code{\predefinedFretboardsOn}.
@endpredefined
-
@seealso
Notation Reference:
@ref{Custom tablatures}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{fingerings,-string-indications,-and-right-hand-fingerings.ly}
-
@seealso
Snippets:
@rlsr{Fretted strings}.
e16 b g d
@end lilypond
-
@seealso
Notation Reference:
@ref{Text spanners}.
@end example
@seealso
+Installed Files:
+@file{ly/string-tunings-init.ly}.
+
Snippets:
@rlsr{Fretted strings}.
-
-Installed Files:
-@file{ly/string-tunings-init.ly}
@end itemize
-
@seealso
Learning Manual:
@rlearning{How LilyPond input files work}.
Installed Files:
@file{ly/titling-init.ly}.
+
@node Default layout of headers and footers
@unnumberedsubsubsec Default layout of headers and footers
@ref{Title blocks explained},
@ref{Default layout of book and score title blocks}.
+
@node Creating footnotes
@subsection Creating footnotes
}
@end lilypond
-
@seealso
-Init files: @file{../ly/toc-init.ly}.
-
+Installed Files:
+@file{ly/toc-init.ly}.
@predefined
@funindex \table-of-contents
@ref{Automatic part combining},
@ref{Including LilyPond files}.
-
@ignore
@c This warning is more general than this placement implies.
@c Rests are not merged whether or not they come from tagged sections.
@c Should be deleted? -td
@knownissues
-
Multiple rests are not merged if you create a score with more
than one tagged section at the same place.
@end ignore
+
@node Using global settings
@unnumberedsubsubsec Using global settings
Notation Reference:
@ref{Including LilyPond files}.
+
@node Special characters
@subsection Special characters
@file{ly/text-replacements.ly}.
-
@node Controlling output
@section Controlling output
reverse the process.
@seealso
-Learning Manual: @rlearning{Other sources of information}.
+Learning Manual:
+@rlearning{Other sources of information}.
@knownissues
Gonville cannot be used to typeset @q{Ancient Music} notation and it is
Snippets:
@rlsr{Keyboards}.
+
@node Changing staff manually
@unnumberedsubsubsec Changing staff manually
>>
@end lilypond
-
@seealso
Notation Reference:
@ref{Changing staff manually}.
@knownissues
-
@cindex chords, splitting across staves with \autochange
The staff switches may not end up in optimal places. For high
Chords will not be split across the staves; they will be assigned to a
staff based on the first note named in the chord construct.
+
@node Staff-change lines
@unnumberedsubsubsec Staff-change lines
@code{\hideStaffSwitch}.
@endpredefined
-
@seealso
Snippets:
@rlsr{Keyboards}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{indicating-cross-staff-chords-with-arpeggio-bracket.ly}
-
@seealso
Snippets:
@rlsr{Keyboards}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{accordion-discant-symbols.ly}
-
@seealso
Snippets:
@rlsr{Keyboards}.
@ref{Arpeggio},
@ref{Harmonics}.
+
@node Harp pedals
@unnumberedsubsubsec Harp pedals
A set of glyphs with a single style and shape comprise a font, and
a set of fonts covering several styles and sizes comprise a typeface.
-
@seealso
Notation Reference:
@ref{Fonts},
Notation Reference:
@ref{mutable}.
+
@node interface
@unnumberedsubsec interface
Notation Reference:
@ref{immutable}.
+
@node output-def
@unnumberedsubsec output-def
@end itemize
-
@seealso
Notation Reference:
@ref{Showing melody rhythms},
There are a few issues concerning MIDI support for percussion
instruments; for details please see @ref{Percussion in MIDI}.
-
@seealso
Notation Reference:
@ref{Percussion in MIDI},
@ref{Percussion notes}.
-File:
-@file{ly/drumpitch-init.ly}
+Installed Files:
+@file{ly/drumpitch-init.ly}.
Snippets:
@rlsr{Percussion}.
}
@end lilypond
-
@seealso
-
Notation Reference:
@ref{Tremolo repeats}.
vibraphone, and timpani) are written using normal staves.
This is covered in other sections of the manual.
-
@seealso
@c TODO: possibly link to an alternate section of NR 3.5, if
@c "percussion in MIDI" gets a separate subsubsection for
}
@end lilypond
-
@seealso
Snippets:
@rlsr{Percussion}.
Also note that you must add chords (@code{< >} brackets)
around each @code{\parenthesize} statement.
-
@seealso
Snippets:
@rlsr{Percussion}.
}
@end lilypond
-
@seealso
Music Glossary:
@rglos{Pitch names}.
Internals Reference:
@rinternals{RelativeOctaveMusic}.
-
@cindex relative octave entry and transposition
@cindex transposition and relative octave entry
@funindex \relative
@funindex relative
-
@c DEPRECATED
If no @code{@var{startpitch}} is specified for @code{\relative},
then@tie{}@code{c'} is assumed. However, this is a deprecated
discouraged.
-
@node Accidentals
@unnumberedsubsubsec Accidentals
@rinternals{AccidentalCautionary},
@rinternals{accidental-interface}.
-
@cindex accidental, quarter-tone
@cindex quarter-tone accidental
@knownissues
-
There are no generally accepted standards for denoting
quarter-tone accidentals, so LilyPond's symbol does not conform to
any standard.
-
@node Note names in other languages
@unnumberedsubsubsec Note names in other languages
pitches and tuning systems are also supported: see
@ref{Common notation for non-Western music}.
-
@seealso
Music Glossary:
@rglos{Pitch names},
}
@end lilypond
-
@seealso
Snippets:
@rlsr{Pitches}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{transposing-pitches-with-minimum-accidentals-smart-transpose.ly}
-
@seealso
Notation Reference:
@ref{Instrument transpositions},
Internals Reference:
@rinternals{TransposedMusic}.
-
@funindex \transpose
@funindex transpose
@funindex \chordmode
@funindex relative
@knownissues
-
The relative conversion will not affect @code{\transpose},
@code{\chordmode} or @code{\relative} sections in its argument. To use
relative mode within transposed music, an additional @code{\relative}
@lilypondfile[verbatim,quote,texidoc,doctitle]
{non-traditional-key-signatures.ly}
-
@seealso
Music Glossary:
@rglos{church mode},
@lilypondfile[verbatim,quote,texidoc,doctitle]
{ottava-text.ly}
-
@seealso
Music Glossary:
@rglos{octavation}.
c2 g
@end lilypond
-
@seealso
Music Glossary:
@rglos{concert pitch},
@rinternals{AccidentalPlacement},
@rinternals{accidental-suggestion-interface}.
-
@cindex accidentals and simultaneous notes
@cindex simultaneous notes and accidentals
@cindex accidentals in chords
@cindex chords, accidentals in
@knownissues
-
Simultaneous notes are not considered in the automatic
determination of accidentals; only previous notes and the key
signature are considered. Forcing accidentals with@tie{}@code{!}
}
@end lilypond
+
@node Ambitus
@unnumberedsubsubsec Ambitus
@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-the-ambitus-gap.ly}
-
@seealso
Music Glossary:
@rglos{ambitus}.
@rinternals{AmbitusNoteHead},
@rinternals{ambitus-interface}.
-
@knownissues
-
There is no collision handling in the case of multiple per-voice
ambitus.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{numbers-as-easy-note-heads.ly}
-
@seealso
Notation Reference:
@ref{Setting the staff size}.
To see all note head styles, see @ref{Note head styles}.
-
@seealso
Snippets:
@rlsr{Pitches}.
}
@end lilypond
-
@predefined
@code{\improvisationOn},
@code{\improvisationOff}.
@endpredefined
-
@seealso
Snippets:
@rlsr{Pitches}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{printing-a-repeat-sign-at-the-beginning-of-a-piece.ly}
-
@seealso
Notation Reference:
@ref{Bar lines},
@rinternals{RepeatedMusic},
@rinternals{UnfoldedRepeatedMusic}.
+
@node Short repeats
@subsection Short repeats
@lilypondfile[verbatim,quote,texidoc,doctitle]
{cross-staff-tremolos.ly}
-
@seealso
Snippets:
@rlsr{Repeats}.
@cindex tremolo, cross-staff
@cindex cross-staff tremolo
-
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{changing-the-number-of-augmentation-dots-per-note.ly}
-
@seealso
Music Glossary:
@rglos{breve},
@rinternals{Dots},
@rinternals{DotColumn}.
-
@knownissues
-
@c Deliberately duplicated in Durations and Rests. -gp
There is no fundamental limit to rest durations (both in terms of
longest and shortest), but the number of glyphs is limited:
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{permitting-line-breaks-within-beamed-tuplets.ly}
-
@seealso
Music Glossary:
@rglos{triplet},
@rinternals{TupletNumber},
@rinternals{TimeScaledMusic}.
-
@cindex grace notes within tuplet brackets
@knownissues
One application of this command is in polymetric
notation, see @ref{Polymetric notation}.
-
@seealso
Notation Reference:
@ref{Tuplets},
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{rest-styles.ly}
-
@seealso
Music Glossary:
@rglos{breve},
Internals Reference:
@rinternals{Rest}.
-
@knownissues
-
@c Deliberately duplicated in Durations and Rests. -gp
There is no fundamental limit to rest durations (both in terms of
longest and shortest), but the number of glyphs is limited: there
\skip 1 \skip1 \skip 1
@end lilypond
-
@seealso
Learning Manual:
@rlearning{Visibility and color of objects}.
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{multi-measure-rest-markup.ly}
-
@seealso
Music Glossary:
@rglos{multi-measure rest}.
@rinternals{MultiMeasureRestNumber},
@rinternals{MultiMeasureRestText}.
-
@cindex fingerings and multi-measure rests
@cindex multi-measure rests and fingerings
Multi-measure rests do not take part in rest collisions.
+
@node Displaying rhythms
@subsection Displaying rhythms
@lilypondfile[verbatim,quote,texidoc,doctitle]
{time-signature-printing-only-the-numerator-as-a-number-instead-of-the-fraction.ly}
-
@seealso
Music Glossary:
@rglos{time signature}
@rinternals{TimeSignature},
@rinternals{Timing_translator}.
+
@node Metronome marks
@unnumberedsubsubsec Metronome marks
For more details, see @ref{Formatting text}.
-
@seealso
Music Glossary:
@rglos{metronome},
r8 e,8 | a4 c8 b[ c b] |
@end lilypond
+
@node Unmetered music
@unnumberedsubsubsec Unmetered music
@code{\cadenzaOff}.
@endpredefined
-
@seealso
Music Glossary:
@rglos{cadenza}.
Snippets:
@rlsr{Rhythms}.
-
@cindex cadenza line breaks
@cindex cadenza page breaks
@cindex unmetered music, line breaks
@cindex page breaks in unmetered music
@knownissues
-
LilyPond will insert line breaks and page breaks only at a
bar line. Unless the unmetered music ends before the end of the
staff line, you will need to insert invisible bar lines with
@rinternals{Default_bar_line_engraver},
@rinternals{Staff}.
-
@knownissues
When using different time signatures in parallel, notes at the same
moment will be placed at the same horizontal location. However, the bar
regular in each of the individual staves than would be normal without
the different time signatures.
+
@node Automatic note splitting
@unnumberedsubsubsec Automatic note splitting
the measures are not entirely filled, then the ties show exactly how
much each measure is off.
-
@seealso
Music Glossary:
@rglos{tie}
@rinternals{Completion_rest_engraver},
@rinternals{Forbid_line_break_engraver}.
-
@knownissues
-
Not all durations (especially those containing tuplets) can be
represented exactly with normal notes and dots, but the
@code{Completion_heads_engraver} will not insert tuplets.
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{guitar-strum-rhythms.ly}
-
@seealso
Snippets:
@rlsr{Rhythms}.
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{beam-endings-in-score-context.ly}
-
@seealso
Installed Files:
@file{scm/beam-settings.scm}.
@rinternals{BeamForbidEvent},
@rinternals{beam-interface}.
-
@knownissues
If a score ends while an automatic beam has not been ended and is
still accepting notes, this last beam will not be typeset at all.
>>
@end lilypond
+
@node Manual beams
@unnumberedsubsubsec Manual beams
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{flat-flags-and-beam-nibs.ly}
-
@seealso
Notation Reference:
@ref{Direction and placement},
The spacing in the printed output represents the
note durations only approximately, but the MIDI output is exact.
-
@predefined
@code{\featherDurations}.
@endpredefined
Snippets:
@rlsr{Rhythms}.
-
@knownissues
-
The @code{\featherDurations} command only works with very short
music snippets, and when numbers in the fraction are small.
@node Bars
@subsection Bars
-
@menu
* Bar lines::
* Bar numbers::
@code{"|"}. This may be changed at any time with
@samp{\set Timing.defaultBarType = @var{bartype}}.
-
@seealso
Notation Reference:
@ref{Line breaking},
will print a warning if the @code{currentBarNumber} is not 123
when it is processed.
-
@seealso
Snippets:
@rlsr{Rhythms}.
@ref{Formatting text}. For more precise control, see
@code{break-alignable-interface} in @ref{Aligning objects}.
+The file @file{scm/translation-functions.scm} contains
+the definitions of @code{format-mark-numbers} and
+@code{format-mark-letters}. They can be used as inspiration for
+other formatting functions.
@seealso
Notation Reference:
@ref{Aligning objects}.
Installed Files:
-@file{scm/translation-functions.scm} contains
-the definitions of @code{format-mark-numbers} and
-@code{format-mark-letters}. They can be used as inspiration for
-other formatting functions.
+@file{scm/translation-functions.scm}.
Snippets:
@rlsr{Rhythms}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{positioning-grace-notes-with-floating-space.ly}
-
@seealso
Music Glossary:
@rglos{grace notes},
@rglos{appoggiatura}.
Notation Reference:
+@ref{Scaling durations},
@ref{Manual beams}.
Installed Files:
@knownissues
-
@cindex acciaccatura, multi-note
@cindex multi-note acciaccatura
@cindex grace-note synchronization
>>
@end lilypond
-
@seealso
Music Glossary:
@rglos{cadenza}.
@code{ly:make-moment 7 16} is the duration of seven sixteenths
notes.
-
@seealso
Notation Reference:
@ref{Bar numbers},
Internals Reference:
@rinternals{Timing_translator},
@rinternals{Score}.
-
@end itemize
+
@node Chord repetition
@unnumberedsubsubsec Chord repetition
even simultaneously. In such a case no attempt is made to
automatically avoid collisions between ordinary notes and clusters.
-
@seealso
Music Glossary:
@rglos{cluster}.
@rinternals{ClusterSpannerBeacon},
@rinternals{Cluster_spanner_engraver}.
-
@knownissues
-
Clusters look good only if they span at least two chords; otherwise
they appear too narrow.
Clusters do not produce MIDI output.
+
@node Multiple voices
@subsection Multiple voices
@code{\oneVoice}.
@endpredefined
-Snippets:
-@rlsr{Simultaneous notes}.
-
@seealso
Learning Manual:
@rlearning{Voices contain music},
@ref{Invisible rests},
@ref{Stems}.
+Snippets:
+@rlsr{Simultaneous notes}.
+
@node Voice styles
@unnumberedsubsubsec Voice styles
@code{\voiceNeutralStyle}.
@endpredefined
-
@seealso
Learning Manual:
@rlearning{I'm hearing Voices},
are at the same time differently dotted are not clear.
@end ignore
+
@node Automatic part combining
@unnumberedsubsubsec Automatic part combining
@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-partcombine-texts.ly}
-
@seealso
Music Glossary:
@rglos{a due},
@rinternals{Voice}.
@knownissues
-
All @code{\partcombine...} functions can only accept two voices and are
not designed to work with lyrics; such that when one of the voices is
explicitly named in order to attach lyrics to it, the partcombiner will
}
@end lilypond
-
@seealso
Learning Manual:
@rlearning{Organizing pieces with variables}.
@rlsr{Spacing}.
@knownissues
-
The titles (from the @code{\header} block) are treated as a
system, so @code{ragged-bottom} and @code{ragged-last-bottom} will
add space between the titles and the first system of the score.
@file{ly/paper-defaults-init.ly}.
@knownissues
-
Explicitly defined paper-sizes will override any user-defined left or
right margin settings.
@end table
-
@seealso
Installed Files:
@file{ly/titling-init.ly}.
Snippets:
@rlsr{Spacing}.
-
@knownissues
-
The default page header puts the page number and the @code{instrument}
field from the @code{\header} block on a line.
@}
@end example
-
@seealso
Notation Reference:
@ref{Changing context default settings}.
@rinternals{StaffSymbol}) can be used to tune the size for individual
staves. The sizes of individual staves are relative to the global size.
-
@seealso
Notation Reference:
@ref{Selecting notation font size}.
Snippets:
@rlsr{Spacing}.
-
@knownissues
-
@code{layout-set-staff-size} does not change the distance between the
staff lines.
@code{\noBreak}.
@endpredefined
-
@seealso
Notation Reference:
@ref{\paper variables for line breaking}.
@code{\noPageBreak}.
@endpredefined
-
@seealso
Notation Reference:
@ref{\paper variables for page breaking}.
cramping and stretching, both horizontally and vertically. Unlike
@code{ly:page-turn-breaking}, it has no concept of page turns.
-
@seealso
Snippets:
@rlsr{Spacing}.
@code{\allowPageTurn}, may also be used at top-level, between scores and
top-level markups.
-
@predefined
@funindex \pageTurn
@code{\pageTurn},
@code{\allowPageTurn}.
@endpredefined
-
@seealso
Snippets:
@rlsr{Spacing}.
-
@knownissues
-
There should only be one @code{Page_turn_engraver} in a score. If there is more
than one, they will interfere with each other.
@}
@end example
-
@seealso
Snippets:
@rlsr{Spacing}.
}
@end lilypond
-
@seealso
Snippets:
@rlsr{Spacing}.
}
@end lilypond
-
@seealso
Notation Reference:
@ref{Vertical spacing}.
@ref{Flexible vertical spacing \paper variables},
@ref{Modifying alists}.
+Installed Files:
+@file{ly/engraver-init.ly},
+@file{scm/define-grobs.scm}.
+
Internals Reference:
@rinternals{Contexts},
@rinternals{VerticalAxisGroup},
@rinternals{StaffGrouper}.
-Installed Files:
-@file{ly/engraver-init.ly},
-@file{scm/define-grobs.scm}.
-
@node Spacing of ungrouped staves
@unnumberedsubsubsec Spacing of ungrouped staves
>>
@end lilypond
-
@seealso
Installed Files:
@file{ly/engraver-init.ly},
passed to these different settings will avoid this.
@end itemize
-
@seealso
Snippets:
@rlsr{Spacing}.
c''2
@end lilypond
-
@seealso
Snippets:
@rlsr{Spacing}.
Proportional notation is supported; see @ref{Proportional notation}.
-
@seealso
+Essay on automated music engraving:
+@ressay{Optical spacing}.
+
Snippets:
@rlsr{Spacing}.
@rinternals{StaffSpacing},
@rinternals{NonMusicalPaperColumn}.
-Essay on automated music engraving:
-@ressay{Optical spacing}.
-
-
@knownissues
-
There is no convenient mechanism to manually override spacing. The
following work-around may be used to insert extra space into a score,
adjusting the padding value as necessary.
+
@example
\override Score.NonMusicalPaperColumn #'padding = #10
@end example
@code{SpacingSpanner} object, and hence new @code{\override}s
may be used in that location.
-
@seealso
Snippets:
@rlsr{Spacing}.
\new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c] c32[ c32] }
@end lilypond
-
@seealso
Snippets:
@rlsr{Spacing}.
@}
@end example
-
@seealso
Snippets:
@rlsr{Spacing}.
to break across systems and pages. See the respective parts of the manual
for these related settings.
-
@seealso
Notation Reference:
@ref{New spacing area}.
(@var{a},@var{b}) are intervals, where @var{a} is the lower
edge and @var{b} the upper edge of the interval.
-
@seealso
Notation Reference:
@ref{Setting the staff size}.
@end itemize
-
@seealso
Notation Reference:
@ref{Page layout},
New single staff contexts may be defined. For details, see
@ref{Defining new contexts}.
-
@seealso
Music Glossary:
@rglos{staff},
@lilypondfile[verbatim,quote,texidoc,doctitle]
{mensurstriche-layout-bar-lines-between-the-staves.ly}
-
@seealso
Music Glossary:
@rglos{brace},
@lilypondfile[verbatim,quote,texidoc,doctitle]
{nesting-staves.ly}
-
@seealso
Notation Reference:
@ref{Grouping staves},
@rinternals{SystemStartBracket},
@rinternals{SystemStartSquare}.
+
@node Separating systems
@unnumberedsubsubsec Separating systems
@lilypondfile[verbatim,quote,texidoc,doctitle]
{vertically-aligning-ossias-and-lyrics.ly}
-
@seealso
Music Glossary:
@rglos{ossia},
@lilypondfile[verbatim,quote,texidoc,doctitle]
{removing-the-first-empty-line.ly}
-
@seealso
Music Glossary:
@rglos{Frenched staff}.
@rinternals{VerticalAxisGroup},
@rinternals{Staff_symbol_engraver}.
-
@knownissues
-
Removing @code{Staff_symbol_engraver} also hides bar lines. If
bar line visibility is forced, formatting errors may occur. In
this case, use the following overrides instead of removing the
@code{\Staff \RemoveEmptyStaves} see
@ref{Changing context default settings}.
+
@node Writing parts
@subsection Writing parts
}
@end lilypond
-
@seealso
Notation Reference:
@ref{\paper variables for shifts and indents},
@ref{Instrument transpositions},
@ref{Using tags}.
+Installed Files:
+@file{scm/define-event-classes.scm}.
+
Snippets:
@rlsr{Staff notation}.
@rinternals{QuoteMusic},
@rinternals{Voice}.
-Installed Files:
-@file{scm/define-event-classes.scm}.
-
-
@knownissues
Only the contents of the first @code{Voice} occurring in an
@code{\addQuote} command will be considered for quotation, so if the music
collected into an instrument definition for repeated use, using
@code{\addInstrumentDefinition} described in @ref{Instrument names}.
-
@seealso
Notation Reference:
@ref{Quoting other voices},
@rinternals{CueVoice},
@rinternals{Voice}.
-
@knownissues
-
Collisions can occur with rests, when using @code{\cueDuring},
between @code{Voice} and @code{CueVoice} contexts. When using
@code{\cueDuringWithClef} or @code{\transposedCueDuring} the extra
@code{\textLengthOff}.
@endpredefined
-
@seealso
Learning Manual:
@rlearning{Placement of objects}.
Internals Reference:
@rinternals{TextScript}.
-
@cindex text outside margin
@cindex margin, text running over
@cindex text, keeping inside margin
@cindex lyrics, keeping inside margin
-
@knownissues
Checking to make sure that text scripts and lyrics are within the
margins requires additonal calculations. In cases where slightly faster
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{printing-marks-on-every-staff.ly}
-
@seealso
Notation Reference:
@ref{Rehearsal marks},
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{stand-alone-two-column-markup.ly}
-
@seealso
Notation Reference:
@ref{Formatting text},
An exhaustive list of @code{\markup}-specific commands can be found in
@ref{Text markup commands}.
-
@seealso
Notation Reference:
@ref{Text markup commands}.
Installed Files:
@file{scm/markup.scm}.
-
@knownissues
Syntax errors for markup mode can be confusing.
@code{\larger}.
@endpredefined
-
@seealso
Notation Reference:
@ref{Font},
@ref{Manual repeat marks},
@ref{Fonts}.
+Installed Files:
+@file{scm/define-markup-commands.scm}.
+
Snippets:
@rlsr{Text}.
Internals Reference:
@rinternals{TextScript}.
-Installed Files:
-@file{scm/define-markup-commands.scm}.
-
@knownissues
Using the font sizing commands @code{\teeny}, @code{\tiny},
@code{\small}, @code{\normalsize}, @code{\large}, and
An exhaustive list of text alignment commands can be found in
@ref{Align}.
-
@seealso
Learning Manual:
@rlearning{Moving objects}.
@ref{Align},
@ref{Text marks}.
+Installed Files:
+@file{scm/define-markup-commands.scm}.
+
Snippets:
@rlsr{Text}.
Internals Reference:
@rinternals{TextScript}.
-Installed Files:
-@file{scm/define-markup-commands.scm}.
-
@node Graphic notation inside markup
@unnumberedsubsubsec Graphic notation inside markup
An exhaustive list of graphics-specific commands can be found in
@ref{Graphic}.
-
@seealso
Notation Reference:
@ref{Graphic},
@ref{Editorial annotations},
@ref{Align}.
+Installed Files:
+@file{scm/define-markup-commands.scm},
+@file{scm/stencil.scm}.
+
Snippets:
@rlsr{Text}.
Internals Reference:
@rinternals{TextScript}.
-Installed Files:
-@file{scm/define-markup-commands.scm},
-@file{scm/stencil.scm}.
-
@node Music notation inside markup
@unnumberedsubsubsec Music notation inside markup
An exhaustive list of music notation related commands can be found in
@ref{Music}.
-
@seealso
Notation Reference:
@ref{Music},
@ref{The Feta font},
@ref{Fonts explained}.
+Installed Files:
+@file{scm/define-markup-commands.scm},
+@file{scm/fret-diagrams.scm},
+@file{scm/harp-pedals.scm}.
+
Snippets:
@rlsr{Text}.
Internals Reference:
@rinternals{TextScript}.
-Installed Files:
-@file{scm/define-markup-commands.scm},
-@file{scm/fret-diagrams.scm},
-@file{scm/harp-pedals.scm}.
-
@node Multi-page markup
@unnumberedsubsubsec Multi-page markup
An exhaustive list of markup list commands can be found in
@ref{Text markup list commands}.
-
@seealso
Notation Reference:
-@ref{Text markup list commands},
-
-Snippets:
-@rlsr{Text}.
+@ref{Text markup list commands}.
-Extending:
+Extending LilyPond:
@rextend{New markup list command definition}.
-Internals Reference:
-@rinternals{TextScript}.
-
Installed Files:
@file{scm/define-markup-commands.scm}.
+Snippets:
+@rlsr{Text}.
+
+Internals Reference:
+@rinternals{TextScript}.
@funindex \markuplist
@funindex markuplist
possible to use other fonts, as explained in the following sections:
@ref{Single entry fonts} and @ref{Entire document fonts}.
-
@seealso
Notation Reference:
@ref{The Feta font},
lilypond -dshow-available-fonts x
@end example
-
@seealso
Notation Reference:
@ref{Fonts explained},
@c we don't do Helvetica / Courier, since GS incorrectly loads
@c Apple TTF fonts
-
@seealso
Notation Reference:
@ref{Fonts explained},
@end itemize
-
@seealso
Learning Manual:
@rlearning{String quartet}.
@code{\open}.
@endpredefined
-
@seealso
Notation Reference:
@ref{Articulations and ornamentations},
chord construct even if there is only a single note. Normally
@code{@bs{}harmonicsOn} would be used in this situation.}
-
@seealso
Music Glossary:
@rglos{harmonics}.
Snippets:
@rlsr{Vocal music}.
+
@node Entering lyrics
@unnumberedsubsubsec Entering lyrics
@rinternals{LyricText}.
Snippets:
-@rlsr{Text}
+@rlsr{Text}.
+
@node Aligning lyrics to a melody
@unnumberedsubsubsec Aligning lyrics to a melody
Notation Reference:
@ref{Contexts explained},
-@ref{Automatic syllable durations}.
+@ref{Automatic syllable durations},
@ref{Stanzas},
@ref{Manual syllable durations},
@ref{Dialogue over music},
Internals Reference:
@rinternals{Lyrics}.
+
@node Automatic syllable durations
@unnumberedsubsubsec Automatic syllable durations
@ref{Keeping contexts alive},
@ref{Placing lyrics vertically}.
+
@node Manual syllable durations
@unnumberedsubsubsec Manual syllable durations
}
@end lilypond
-
@seealso
Internals Reference:
@rinternals{LyricCombineMusic}.
@rinternals{Tunable context properties}.
@knownissues
-
Extender lines under melismata are not created automatically; they
must be inserted manually with a double underscore.
(threshold below which hyphens are removed) properties of
@code{LyricHyphen}.
-
@seealso
Internals Reference:
@rinternals{LyricExtender},
}
@end lilypond
-
@seealso
Notation Reference:
@ref{Placing lyrics vertically}.
@ref{Context layout order},
@ref{Creating contexts}.
+
@node Placing syllables horizontally
@unnumberedsubsubsec Placing syllables horizontally
Snippets:
@rlsr{Vocal music}.
+
@node Lead sheets
@unnumberedsubsubsec Lead sheets
@rinternals{Lyrics},
@rinternals{PianoStaff}.
+
@node Score layouts for choral
@unnumberedsubsubsec Score layouts for choral
Extending LilyPond:
@rextend{Markup construction in Scheme}.
+
@node Musical cues
@unnumberedsubsubsec Musical cues
@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing--flageolet-mark-size.ly}
-
@seealso
Notation Reference:
@ref{Breath marks},
{recorder-fingering-chart.ly}
@seealso
-
Notation Reference:
@ref{Woodwind diagrams}.
piobaireachd high g can be written @code{gflat} when it occurs in light
music.
-
@seealso
+Snippets:
@rlsr{Winds}.
}
@end lilypond
-
@seealso
+Snippets:
@rlsr{Winds}.
+
@node Woodwinds
@subsection Woodwinds
{woodwind-diagrams-key-lists.ly}
@seealso
-
Installed Files:
@file{scm/define-woodwind-diagrams.scm},
@file{scm/display-woodwind-diagrams.scm}.
-Snippets: @rlsr{Winds}.
+Snippets:
+@rlsr{Winds}.
Internals Reference:
@rinternals{TextScript},
projects / lilypond.git / commitdiff