]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/notation/rhythms.itely
Doc: NR 1.2.3 Expl. manual accidentals + cadenzas
[lilypond.git] / Documentation / notation / rhythms.itely
index a3707bf42a4d84ff2e53e770e189effd490e9353..e223bab4124b6d54cedca6e31056b37e6c6a3521 100644 (file)
@@ -148,7 +148,6 @@ the staff; see @ref{Direction and placement}.
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {changing-the-number-of-augmentation-dots-per-note.ly}
 
-
 @seealso
 Music Glossary:
 @rglos{breve},
@@ -174,9 +173,7 @@ Internals Reference:
 @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:
@@ -271,7 +268,6 @@ see @ref{Scaling durations}.
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {permitting-line-breaks-within-beamed-tuplets.ly}
 
-
 @seealso
 Music Glossary:
 @rglos{triplet},
@@ -295,7 +291,6 @@ Internals Reference:
 @rinternals{TupletNumber},
 @rinternals{TimeScaledMusic}.
 
-
 @cindex grace notes within tuplet brackets
 
 @knownissues
@@ -375,7 +370,6 @@ and expanded:
 One application of this command is in polymetric
 notation, see @ref{Polymetric notation}.
 
-
 @seealso
 Notation Reference:
 @ref{Tuplets},
@@ -664,7 +658,6 @@ a4\rest d4\rest
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {rest-styles.ly}
 
-
 @seealso
 Music Glossary:
 @rglos{breve},
@@ -680,9 +673,7 @@ Snippets:
 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
@@ -764,7 +755,6 @@ any kind.
 \skip 1 \skip1 \skip 1
 @end lilypond
 
-
 @seealso
 Learning Manual:
 @rlearning{Visibility and color of objects}.
@@ -941,7 +931,6 @@ setting, resulting bar-check warnings may not be displayed.
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {multi-measure-rest-markup.ly}
 
-
 @seealso
 Music Glossary:
 @rglos{multi-measure rest}.
@@ -960,7 +949,6 @@ Internals Reference:
 @rinternals{MultiMeasureRestNumber},
 @rinternals{MultiMeasureRestText}.
 
-
 @cindex fingerings and multi-measure rests
 @cindex multi-measure rests and fingerings
 
@@ -979,6 +967,7 @@ into a single multi-measure rest.
 
 Multi-measure rests do not take part in rest collisions.
 
+
 @node Displaying rhythms
 @subsection Displaying rhythms
 
@@ -1214,7 +1203,6 @@ for different staves by moving the @code{Timing_translator} and the
 @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}
@@ -1230,6 +1218,7 @@ Internals Reference:
 @rinternals{TimeSignature},
 @rinternals{Timing_translator}.
 
+
 @node Metronome marks
 @unnumberedsubsubsec Metronome marks
 
@@ -1305,7 +1294,6 @@ d4 g e c
 
 For more details, see @ref{Formatting text}.
 
-
 @seealso
 Music Glossary:
 @rglos{metronome},
@@ -1409,24 +1397,39 @@ e8 | a4 c8 b[ c b] |
 r8 e,8 | a4 c8 b[ c b] |
 @end lilypond
 
+
 @node Unmetered music
 @unnumberedsubsubsec Unmetered music
 
-@cindex bar lines, turning off
-@cindex bar numbering, turning off
 @cindex cadenza
+@cindex cadenza, beams
+@cindex cadenza, accidentals
+@cindex cadenza, bar lines
+@cindex cadenza, bar numbers
 @cindex unmetered music
+@cindex unmetered music, beams
+@cindex unmetered music, accidentals
+@cindex unmetered music, bar lines
+@cindex unmetered music, bar numbers
+@cindex accidentals, cadenzas
+@cindex accidentals, unmetered music
+@cindex bar lines, cadenzas
+@cindex bar lines, unmetered music
+@cindex bar numbers, cadenzas
+@cindex bar numbers, unmetered music
+@cindex beams, cadenzas
+@cindex beams, unmetered music
 
 @funindex \cadenzaOn
 @funindex cadenzaOn
 @funindex \cadenzaOff
 @funindex cadenzaOff
 
-Bar lines and bar numbers are calculated automatically.  For
-unmetered music (some cadenzas, for example), this is not desirable.
-To turn off automatic calculation of bar lines and bar numbers,
-use the command @code{\cadenzaOn}, and use @code{\cadenzaOff}
-to turn them on again.
+In metered music bar lines are inserted and bar numbers are calculated
+automatically. In unmetered music (i.e. cadenzas), this is not
+desirable and can be @q{switched off} using the command
+@code{\cadenzaOn}, then @q{switched back on} at the appropriate place
+using @code{\cadenzaOff}.
 
 @lilypond[verbatim,relative=2,quote]
 c4 d e d
@@ -1437,8 +1440,7 @@ c4 c d8[ d d] f4 g4.
 d4 e d c
 @end lilypond
 
-Bar numbering is resumed at the end of the cadenza as if the
-cadenza were not there:
+Bar numbering is resumed at the end of the cadenza.
 
 @lilypond[verbatim,relative=2,quote]
 % Show all bar numbers
@@ -1451,36 +1453,43 @@ c4 c d8[ d d] f4 g4.
 d4 e d c
 @end lilypond
 
-@cindex beams, in cadenzas
-@cindex beams, in unmetered music
-@cindex cadenza, with beams
-@cindex unmetered music, with beams
+A new bar is never started within a cadenza, even if one or more
+@code{\bar} commands are inserted within it.  Therefore, reminder
+accidentals will need to be added manually.  See @ref{Accidentals}.
 
-Automatic beaming is disabled by @code{\cadenzaOn} and enabled
-by @code{\cadenzaOff}.  Therefore, all beaming in cadenzas
-must be entered manually (@ref{Manual beams}).
+@lilypond[verbatim,relative=2,quote]
+c4 d e d
+\cadenzaOn
+cis4 d cis d
+\bar "|"
+cis4 d cis! d
+\cadenzaOff
+\bar "|"
+@end lilypond
+
+Automatic beaming is disabled by @code{\cadenzaOn}. Therefore, all
+beaming in cadenzas must be entered manually. See @ref{Manual beams}.
 
 @lilypond[verbatim,relative=2,quote]
 \repeat unfold 8 { c8 }
 \cadenzaOn
-\repeat unfold 5 { c8 }
+cis8 c c c c
 \bar"|"
+c8 c c
 \cadenzaOff
 \repeat unfold 8 { c8 }
 @end lilypond
 
-Note that these predefined commands affect all staves in the
-score, even when they are placed in just one @code{Voice}
-context.  To change this, move the @code{Timing_translator}
-from the @code{Score} context to the @code{Staff} context, as
-shown in @ref{Polymetric notation}.
+These predefined commands affect all staves in the score, even when
+placed in just one @code{Voice} context.  To change this, move the
+@code{Timing_translator} from the @code{Score} context to the
+@code{Staff} context.  See @ref{Polymetric notation}.
 
 @predefined
 @code{\cadenzaOn},
 @code{\cadenzaOff}.
 @endpredefined
 
-
 @seealso
 Music Glossary:
 @rglos{cadenza}.
@@ -1488,37 +1497,33 @@ Music Glossary:
 Notation Reference:
 @ref{Visibility of objects},
 @ref{Polymetric notation},
-@ref{Manual beams}.
+@ref{Manual beams},
+@ref{Accidentals}.
 
 Snippets:
 @rlsr{Rhythms}.
 
-
-@cindex cadenza line breaks
-@cindex cadenza page breaks
+@cindex cadenza, line breaks
+@cindex cadenza, page breaks
 @cindex unmetered music, line breaks
 @cindex unmetered music, page breaks
 @cindex breaks in unmetered music
-@cindex line breaks in cadenzas
-@cindex page breaks in cadenzas
-@cindex line breaks in unmetered music
-@cindex page breaks in unmetered music
+@cindex line breaks, cadenzas
+@cindex page breaks, cadenzas
+@cindex line breaks, unmetered music
+@cindex page breaks, 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
+Automatic line and page breaks are inserted only at bar lines, so
+@q{invisible} bar lines will need to be inserted manually in long
+stretches of unmetered music to permit breaking:
 
 @example
 \bar ""
 @end example
 
-@noindent
-to indicate where breaks can occur.
-
-You should explicitly create a @code{Voice} context when starting a
-piece with @code{\cadenzaOn}, otherwise strange errors may occur.
+Explicitly create a @code{Voice} context when starting a piece with
+@code{\cadenzaOn}, else unexpected errors may occur.
 
 @example
 \new Voice @{
@@ -1700,7 +1705,6 @@ Internals Reference:
 @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
@@ -1708,6 +1712,7 @@ lines in the different staves will cause the note spacing to be less
 regular in each of the individual staves than would be normal without
 the different time signatures.
 
+
 @node Automatic note splitting
 @unnumberedsubsubsec Automatic note splitting
 
@@ -1744,7 +1749,6 @@ inserts ties for notes.  One of its uses is to debug complex scores: if
 the measures are not entirely filled, then the ties show exactly how
 much each measure is off.
 
-
 @seealso
 Music Glossary:
 @rglos{tie}
@@ -1763,9 +1767,7 @@ Internals Reference:
 @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.
@@ -1849,7 +1851,6 @@ be done with the @code{Pitch_squash_engraver} and
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {guitar-strum-rhythms.ly}
 
-
 @seealso
 Snippets:
 @rlsr{Rhythms}.
@@ -2147,17 +2148,31 @@ if @code{beamExceptions} is not reset.
 \repeat unfold 8 {c8}
 @end lilypond
 
-In a similar fashion, eighth notes in 3/4 time are beamed as a full
-measure by default.  To beam eighth notes in 3/4 time on the beat,
-reset @code{beamExceptions}.
+In traditional engraving, eighth notes can have special beaming rules.
+A measure consisting of only eighth notes can be beamed in one.  This rule is
+controlled by the context property @code{beamWholeMeasure}:
 
 @lilypond[quote,verbatim,relative=2]
 \time 3/4
-% by default we beam in (3) due to beamExceptions
-\repeat unfold 6 {a8} |
-% This will beam (1 1 1) due to beatLength
-\set Timing.beamExceptions = #'()
-\repeat unfold 6 {a8}
+% By default we beam in one
+\repeat unfold 6 { a8 }
+% We can avoid beaming in one
+\set Timing.beamWholeMeasure = ##f
+\repeat unfold 6 { a8 }
+@end lilypond
+
+In some engraving from the Romantic and Classical periods,
+a half-measure of eighth notes can be beamed
+together even though this violates the general rule (see Gould, p. 153).
+This behavior is controlled by the context property @code{beamHalfMeasure}:
+
+@lilypond[quote,verbatim,relative=2]
+\time 3/4
+% By default we avoid half-measure beams
+r4. a8 a a |
+% We can allow half-measure beams
+\set Timing.beamHalfMeasure = ##t
+r4. a8 a a |
 @end lilypond
 
 @i{@strong{How automatic beaming works}}
@@ -2223,7 +2238,6 @@ The default beaming rules can be found in
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {beam-endings-in-score-context.ly}
 
-
 @seealso
 Installed Files:
 @file{scm/beam-settings.scm}.
@@ -2237,7 +2251,6 @@ Internals Reference:
 @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.
@@ -2292,6 +2305,7 @@ beaming settings for a time signature are described in
 >>
 @end lilypond
 
+
 @node Manual beams
 @unnumberedsubsubsec Manual beams
 
@@ -2376,7 +2390,6 @@ g16 a]
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {flat-flags-and-beam-nibs.ly}
 
-
 @seealso
 Notation Reference:
 @ref{Direction and placement},
@@ -2444,7 +2457,6 @@ the last four 32nd notes are at a constant tempo.
 The spacing in the printed output represents the
 note durations only approximately, but the MIDI output is exact.
 
-
 @predefined
 @code{\featherDurations}.
 @endpredefined
@@ -2453,9 +2465,7 @@ note durations only approximately, but the MIDI output is exact.
 Snippets:
 @rlsr{Rhythms}.
 
-
 @knownissues
-
 The @code{\featherDurations} command only works with very short
 music snippets, and when numbers in the fraction are small.
 
@@ -2463,7 +2473,6 @@ music snippets, and when numbers in the fraction are small.
 @node Bars
 @subsection Bars
 
-
 @menu
 * Bar lines::
 * Bar numbers::
@@ -2703,7 +2712,6 @@ The default bar type used for automatically inserted bar lines is
 @code{"|"}.  This may be changed at any time with
 @samp{\set Timing.defaultBarType = @var{bartype}}.
 
-
 @seealso
 Notation Reference:
 @ref{Line breaking},
@@ -2890,7 +2898,6 @@ example,
 will print a warning if the @code{currentBarNumber} is not 123
 when it is processed.
 
-
 @seealso
 Snippets:
 @rlsr{Rhythms}.
@@ -3034,6 +3041,10 @@ For common tweaks to the positioning of rehearsal marks, see
 @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:
@@ -3042,10 +3053,7 @@ 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}.
@@ -3206,7 +3214,6 @@ direction is overridden and then reverted.
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {positioning-grace-notes-with-floating-space.ly}
 
-
 @seealso
 Music Glossary:
 @rglos{grace notes},
@@ -3214,6 +3221,7 @@ Music Glossary:
 @rglos{appoggiatura}.
 
 Notation Reference:
+@ref{Scaling durations},
 @ref{Manual beams}.
 
 Installed Files:
@@ -3230,7 +3238,6 @@ Internals Reference:
 
 
 @knownissues
-
 @cindex acciaccatura, multi-note
 @cindex multi-note acciaccatura
 @cindex grace-note synchronization
@@ -3357,7 +3364,6 @@ MyCadenza = \relative c' {
 >>
 @end lilypond
 
-
 @seealso
 Music Glossary:
 @rglos{cadenza}.
@@ -3442,7 +3448,6 @@ duration of n/m of a whole note.  For example,
 @code{ly:make-moment 7 16} is the duration of seven sixteenths
 notes.
 
-
 @seealso
 Notation Reference:
 @ref{Bar numbers},
@@ -3454,4 +3459,3 @@ Snippets:
 Internals Reference:
 @rinternals{Timing_translator},
 @rinternals{Score}.
-