From ebb23e45f7e59515c97b0d8cbaf5b0e11c0689c8 Mon Sep 17 00:00:00 2001 From: James Lowe Date: Fri, 1 Oct 2010 19:07:32 +0100 Subject: [PATCH] Doc: remove more \new Score constructs Continuing of Tracker 1033 Minor grammar edits and line breaking as per CG --- Documentation/notation/spacing.itely | 183 ++++++++++++++++----------- 1 file changed, 106 insertions(+), 77 deletions(-) diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely index 4a1a4576eb..f673e62484 100644 --- a/Documentation/notation/spacing.itely +++ b/Documentation/notation/spacing.itely @@ -2339,72 +2339,90 @@ the second half of the measure now occupy equal amounts of horizontal space. We could place a measured timeline or graphic above or below this example. -The @code{proportionalNotationDuration} setting is a context setting that -lives in @code{Score}. Recall that context settings appear in one of -three locations in our input file -- in a @code{\with} block, in a -@code{\context} block, or directly in music entry -preceded by the @code{\set} command. As with all -context settings, users can pick which of the three different -locations they would like to set @code{proportionalNotationDuration}. +The @code{proportionalNotationDuration} setting is a context setting +that lives in @code{Score}. Remember that context settings can appear +in one of three locations within our input file -- in a @code{\with} +block, in a @code{\context} block, or directly in music entry preceded +by the @code{\set} command. As with all context settings, users can +pick which of the three different locations they would like to +set @code{proportionalNotationDuration} in to. The @code{proportionalNotationDuration} setting takes a single argument, -which is the reference duration against which all music will be -spaced. The LilyPond Scheme function make-moment takes two arguments +which is the reference duration against that all music will be spaced. +The LilyPond Scheme function @code{make-moment} takes two arguments -- a numerator and denominator which together express some fraction of -a whole note. The call @code{#(ly:make-moment 1 20)} therefore produces a -reference duration of a twentieth note. The values +a whole note. The call @code{#(ly:make-moment 1 20)} therefore produces +a reference duration of a twentieth note. Values such as @code{#(ly:make-moment 1 16)}, @code{#(ly:make-moment 1 8)}, and @code{#(ly:make-moment 3 97)} are all possible as well. How do we select the right reference duration to pass to -@code{proportionalNotationDuration}? Usually by a process of trial and error, -beginning with a duration close to the fastest (or smallest) duration -in the piece. Smaller reference durations space music loosely; larger -reference durations space music tightly. +@code{proportionalNotationDuration}? Usually by a process of trial +and error, beginning with a duration close to the fastest (or smallest) +duration in the piece. Smaller reference durations space music loosely; +larger reference durations space music tightly. @lilypond[quote,verbatim,ragged-right] -\new Score \with { - proportionalNotationDuration = #(ly:make-moment 1 8) -} << - \new RhythmicStaff { - c'2 - c'16 c'16 c'16 c'16 - \times 4/5 { - c'16 c'16 c'16 c'16 c'16 +\score { + << + \new RhythmicStaff { + c'2 + c'16 c'16 c'16 c'16 + \times 4/5 { + c'16 c'16 c'16 c'16 c'16 + } + } + >> + \layout { + \context { + \Score + proportionalNotationDuration = #(ly:make-moment 1 8) } } ->> +} -\new Score \with { - proportionalNotationDuration = #(ly:make-moment 1 16) -} << - \new RhythmicStaff { - c'2 - c'16 c'16 c'16 c'16 - \times 4/5 { - c'16 c'16 c'16 c'16 c'16 +\score { + << + \new RhythmicStaff { + c'2 + c'16 c'16 c'16 c'16 + \times 4/5 { + c'16 c'16 c'16 c'16 c'16 + } + } + >> + \layout { + \context { + \Score + proportionalNotationDuration = #(ly:make-moment 1 16) } } ->> +} -\new Score \with { - proportionalNotationDuration = #(ly:make-moment 1 32) -} << - \new RhythmicStaff { - c'2 - c'16 c'16 c'16 c'16 - \times 4/5 { - c'16 c'16 c'16 c'16 c'16 +\score { + << + \new RhythmicStaff { + c'2 + c'16 c'16 c'16 c'16 + \times 4/5 { + c'16 c'16 c'16 c'16 c'16 + } + } + >> + \layout { + \context { + \Score + proportionalNotationDuration = #(ly:make-moment 1 32) } } ->> +} @end lilypond Note that too large a reference duration -- such as the eighth note, above -- spaces music too tightly and can cause note head collisions. -Note also that proportional notation in general takes up more -horizontal space that does classical spacing. Proportional spacing -provides rhythmic clarity at the expense of horizontal space. +Also that proportional notation in general takes up more horizontal +space than classical spacing. Proportional spacing provides rhythmic +clarity at the expense of horizontal space. Next we examine how to optimally space overlapping tuplets. @@ -2431,55 +2449,66 @@ tuplet. } @end lilypond -The spacing is bad because the evenly notes of the bottom staff do not -stretch uniformly. Classical engraving includes very few complex +The spacing is bad because the evenly spaced notes of the bottom staff +do not stretch uniformly. Classical engravings include very few complex triplets and so classical engraving rules can generate this type of -result. Setting @code{proportionalNotationDuration} remedies this -situation considerably. +result. Setting @code{proportionalNotationDuration} fixes this. @lilypond[quote,verbatim,ragged-right] -\new Score \with { - proportionalNotationDuration = #(ly:make-moment 1 20) -} << - \new RhythmicStaff { - c'2 - c'16 c'16 c'16 c'16 - \times 4/5 { - c'16 c'16 c'16 c'16 c'16 +\score { + << + \new RhythmicStaff { + c'2 + c'16 c'16 c'16 c'16 + \times 4/5 { + c'16 c'16 c'16 c'16 c'16 + } } - } - \new RhythmicStaff { - \times 8/9 { - c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 + \new RhythmicStaff { + \times 8/9 { + c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 + } + } + >> + \layout { + \context { + \Score + proportionalNotationDuration = #(ly:make-moment 1 20) } } ->> +} @end lilypond But if we look very carefully we can see that notes of the second half -of the 9-tuplet space ever so slightly more widely than do the notes +of the 9-tuplet space ever so slightly more widely than the notes of the first half of the 9-tuplet. To ensure uniform stretching, we turn on @code{uniform-stretching}, which is a property of @code{SpacingSpanner}. @lilypond[quote,verbatim,ragged-right] -\new Score \with { - proportionalNotationDuration = #(ly:make-moment 1 20) - \override SpacingSpanner #'uniform-stretching = ##t -} << - \new RhythmicStaff { - c'2 - c'16 c'16 c'16 c'16 - \times 4/5 { - c'16 c'16 c'16 c'16 c'16 +\score { + << + \new RhythmicStaff { + c'2 + c'16 c'16 c'16 c'16 + \times 4/5 { + c'16 c'16 c'16 c'16 c'16 + } } - } - \new RhythmicStaff { - \times 8/9 { - c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 + \new RhythmicStaff { + \times 8/9 { + c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 c'8 + } + } + >> + \layout { + \context { + \Score + proportionalNotationDuration = #(ly:make-moment 1 20) + \override SpacingSpanner #'uniform-stretching = ##t } } ->> +} @end lilypond Our two-staff example now spaces exactly, our rhythmic -- 2.39.5