From 0dc8d12d04d40386d318a7203620a6753c75dd32 Mon Sep 17 00:00:00 2001 From: Trevor Daniels Date: Sat, 1 Nov 2008 09:56:12 +0000 Subject: [PATCH] Tidy auto-beaming - Remove all the "switch off at any beat" rules These do not need to be switched off as this feature is no longer active. - Add subgrouping for 1 32 beams in 12 8 to correspond to other time signatures. - Tidy up documentation to match. --- Documentation/user/rhythms.itely | 57 ++++++++++++++++++-------------- scm/auto-beam.scm | 33 +++++++++--------- 2 files changed, 51 insertions(+), 39 deletions(-) diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely index 7f4d1aa15f..827eaefd1f 100644 --- a/Documentation/user/rhythms.itely +++ b/Documentation/user/rhythms.itely @@ -1406,7 +1406,7 @@ Notation Reference: @ref{Setting automatic beam behavior}. Installed Files: -@file{scm/auto-beam.scm}. +@file{scm/@/auto@/-beam@/.scm}. Snippets: @rlsr{Rhythms}. @@ -1443,9 +1443,11 @@ exclusive ways in which these rules may be modified. The first, modifying the grouping of beats, applies to uncommon time signatures, i.e. those for which there are no predefined rules defining the beam end points. The second method, modifying the -beam end points, must be used for those time signatures for which -beam ending rules are pre-defined. There are predefined rules for -time signatures of 3/2, 3/4, 4/4, 2/4, 4/8, 4/16, 6/8, 9/8 and 12/8. +specification of the beam end points, can be used for any time +signature. This second method @strong{must} be used for those time +signatures for which beam ending rules are pre-defined, unless +these have all been reverted. There are predefined rules for time +signatures of 3/2, 3/4, 4/4, 2/4, 4/8, 4/16, 6/8, 9/8 and 12/8. @i{@strong{Modifying the grouping of beats}} @@ -1473,11 +1475,21 @@ the end points of beams. @end itemize -By default these properties are derived from the time signature set -by the @code{\time} command. The @code{measureLength} is, by -default, exactly the same length as the measure length given by the -time signature, and the default @code{beatLength} is given by the -denominator of the time signature. +@warning{These three properties are effective @strong{only} if +there are no beam-ending rules defined for the time signature in +force, or if these beam-ending rules have all been reverted.} + +By default the @code{measureLength} and @code{beatLength} are +derived from the time signature set by the @code{\time} command. +The @code{measureLength} is set to be exactly the same length as +the measure length given by the time signature, and the +@code{beatLength} is set to be the same as one over the denominator +of the time signature. + +The default value of @code{beatGrouping} is taken from a table in +@file{scm/@/music@/-functions@/.scm}. To find this, see +@rlearning{Other sources of information}. It defines the beat +grouping for 5/8, 6/8, 8/8, 9/8 and 12/8 time signatures. Both @code{measureLength} and @code{beatLength} are @i{moments}, units of musical duration. A quantity of type @i{moment} is @@ -1495,7 +1507,7 @@ beats in each group. @c TODO Convert to snippet called "Specifying context with beatGrouping" By specifying the context, the effect of @code{beatGrouping} can be -limited to the context specified, and values set in higher-level +limited to the context specified, and the values set in higher-level contexts overridden: @lilypond[quote,verbatim] @@ -1525,7 +1537,7 @@ contexts overridden: The property @code{measureLength} determines where bar lines should be inserted and, with @code{beatLength} and @code{beatGrouping}, how automatic beams should be generated -for time signatures for which no beam end rules are defined. +for time signatures for which no beam-ending rules are defined. @lilypond[quote,verbatim,relative=2] \time 3/4 % auto beam on 1/4 note groups @@ -1563,22 +1575,19 @@ a16 a a a a a a a a a a a a a a a @strong{@i{Modifying the beam end points}} -In normal time signatures, automatic beams can start on any note but -can end at only a few positions within the measure, namely at +In common time signatures, automatic beams can start on any note +but can end at only a few positions within the measure, namely at durations specified by the properties in @code{autoBeamSettings}. These properties consist of a list of rules defining where beams can end. The default @code{autoBeamSettings} rules are defined in -@file{scm/@/auto@/-beam@/.scm}. - -This method @strong{must} be used for the common time signatures, -and is also particularly suitable for many other time signatures -if the time signature of the measures changes frequently. Because -the rules can be written to apply to a specific time signature they -need to be set up only once with rules for each time signature. -Attempting to achieve the same result by modifying the beat grouping -would require the insertion of @code{\set} commands every time the -time signature changed, unless the default values in that time -signature were suitable. +@file{scm/@/auto@/-beam@/.scm}. To find this, see +@rlearning{Other sources of information}. + +This method @strong{must} be used for the time signatures for which +beam-ending rules are defined by default, unless these have all +been reverted. It is also particularly suitable for many other time +signatures if the time signature of the measures changes frequently, +or if the beaming should be different for different beam durations. In order to add a rule to the list, use diff --git a/scm/auto-beam.scm b/scm/auto-beam.scm index 2b622fda6f..3e04ea81a0 100644 --- a/scm/auto-beam.scm +++ b/scm/auto-beam.scm @@ -26,16 +26,16 @@ ;; in 3 2 time: ;; end beams each 1 2 note ;; end beams with 16th notes each 1 4 note - ;; end beams with 32th notes each 1 8 note + ;; end beams with 32nd notes each 1 8 note ((end * * 3 2) . ,(ly:make-moment 1 2)) ((end * * 3 2) . ,(ly:make-moment 2 2)) - + ((end 1 16 3 2) . ,(ly:make-moment 1 4)) ((end 1 16 3 2) . ,(ly:make-moment 1 2)) ((end 1 16 3 2) . ,(ly:make-moment 3 4)) ((end 1 16 3 2) . ,(ly:make-moment 5 4)) - + ((end 1 32 3 2) . ,(ly:make-moment 1 8)) ((end 1 32 3 2) . ,(ly:make-moment 1 4)) ((end 1 32 3 2) . ,(ly:make-moment 3 8)) @@ -51,7 +51,7 @@ ((end 1 16 3 4) . ,(ly:make-moment 1 4)) ((end 1 16 3 4) . ,(ly:make-moment 1 2)) - + ((end 1 32 3 4) . ,(ly:make-moment 1 8)) ((end 1 32 3 4) . ,(ly:make-moment 1 4)) ((end 1 32 3 4) . ,(ly:make-moment 3 8)) @@ -62,16 +62,16 @@ ;; in common time: ;; end beams each 1 2 note - ;; end beams with 32th notes each 1 8 note + ;; end beams with 32nd notes each 1 8 note ;; end beams with 1 8 triplets each 1 4 note ((end * * 4 4) . ,(ly:make-moment 1 2)) ((end 1 12 4 4) . ,(ly:make-moment 1 4)) ((end 1 12 4 4) . ,(ly:make-moment 3 4)) - + ((end 1 16 4 4) . ,(ly:make-moment 1 4)) ((end 1 16 4 4) . ,(ly:make-moment 3 4)) - + ((end 1 32 4 4) . ,(ly:make-moment 1 8)) ((end 1 32 4 4) . ,(ly:make-moment 1 4)) ((end 1 32 4 4) . ,(ly:make-moment 3 8)) @@ -79,27 +79,26 @@ ((end 1 32 4 4) . ,(ly:make-moment 3 4)) ((end 1 32 4 4) . ,(ly:make-moment 7 8)) - ((end * * 2 4) . #f) ;; switch-off at-any-beat feature ((end * * 2 4) . ,(ly:make-moment 1 4)) ((end 1 32 2 4) . ,(ly:make-moment 1 8)) ((end 1 32 2 4) . ,(ly:make-moment 3 8)) - ((end * * 4 8) . #f) ;; switch-off at-any-beat feature ((end * * 4 8) . ,(ly:make-moment 1 4)) ((end 1 32 4 8) . ,(ly:make-moment 1 8)) ((end 1 32 4 8) . ,(ly:make-moment 3 8)) - ((end * * 4 16) . #f) ;; switch-off at-any-beat feature ((end * * 4 16) . ,(ly:make-moment 1 8)) - ((end * * 6 8) . #f) ;; switch-off at-any-beat feature + ;; in 6 8, 9 8 and 12 8 time: + ;; end beams every 3 8 ths + ;; end beams with 32nd notes every 1 8 note + ((end * * 6 8) . ,(ly:make-moment 3 8)) ((end 1 32 6 8) . ,(ly:make-moment 1 8)) ((end 1 32 6 8) . ,(ly:make-moment 1 4)) ((end 1 32 6 8) . ,(ly:make-moment 1 2)) ((end 1 32 6 8) . ,(ly:make-moment 5 8)) - ((end * * 9 8) . #f) ;; switch-off at-any-beat feature ((end * * 9 8) . ,(ly:make-moment 3 8)) ((end * * 9 8) . ,(ly:make-moment 3 4)) ((end 1 32 9 8) . ,(ly:make-moment 1 8)) @@ -108,14 +107,18 @@ ((end 1 32 9 8) . ,(ly:make-moment 5 8)) ((end 1 32 9 8) . ,(ly:make-moment 7 8)) ((end 1 32 9 8) . ,(ly:make-moment 1 1)) - ((end 1 32 9 8) . ,(ly:make-moment 9 8)) - ((end * * 12 8) . #f) ;; switch-off at-every-beat ((end * * 12 8) . ,(ly:make-moment 3 8)) ((end * * 12 8) . ,(ly:make-moment 3 4)) ((end * * 12 8) . ,(ly:make-moment 9 8)) - ((end * * 12 8) . ,(ly:make-moment 2 1)) ((end 1 32 12 8) . ,(ly:make-moment 1 8)) + ((end 1 32 12 8) . ,(ly:make-moment 1 4)) + ((end 1 32 12 8) . ,(ly:make-moment 1 2)) + ((end 1 32 12 8) . ,(ly:make-moment 5 8)) + ((end 1 32 12 8) . ,(ly:make-moment 7 8)) + ((end 1 32 12 8) . ,(ly:make-moment 1 1)) + ((end 1 32 12 8) . ,(ly:make-moment 5 4)) + ((end 1 32 12 8) . ,(ly:make-moment 11 8)) )) (define (override-property-setting context property setting value) -- 2.39.5