release: 1.3.0

[lilypond.git] / ly / auto-beam-settings.ly

diff --git a/ly/auto-beam-settings.ly b/ly/auto-beam-settings.ly
index b24a713d417df5551c3650d70fbacaaf3eda182b..c3f20c4886027718c985eef89114a7c304f98c2b 100644 (file)
--- a/ly/auto-beam-settings.ly
+++ b/ly/auto-beam-settings.ly
@@ -1,31 +1,89 @@
+% auto-beam-settings.ly
+% setup for auto-beam engraver
 %
-% setup for auto beamer
+% specify generic beam end times
+
+% format:
+%
+%     [time-signature]'beamAutoEnd'[duration]
+%
+% where
 %
+%     time-signature = 'time'[numerator]'_'denominator; eg: 3_4
+%     duration = [numerator]'_'denominator; eg: 3_8, _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
+
+time3_2beamAutoEnd = #(make-moment 1 2)
+%time3_2beamAutoEnd_16 = #(make-moment 1 4)
+time3_2beamAutoEnd_16 = #(make-moment 1 4)
+time3_2beamAutoEnd_32 = #(begin (make-moment 1 8))
+
+time3_4beamAutoBegin_8 = #(begin (make-moment 1 4))
+time3_4beamAutoEnd = #(begin (make-moment 3 4))
+time3_4beamAutoBegin_16 = #(begin (make-moment 1 16))
+time3_4beamAutoEnd_16 = #(begin (make-moment 1 4))
+%time3_4beamAutoBegin_32 = #(begin (make-moment 1 8))
+time3_4beamAutoEnd_32 = #(begin (make-moment 1 8))
+
+time3_8beamAutoBegin = #(begin (make-moment 1 8))
+time3_8beamAutoEnd = #(begin (make-moment 3 8))
+
+% in common time:
+%   end beams each 1/2 note
+%   end beams with 32th notes each 1/8 note
+%   end beams with 1/8 triplets each 1/4 note
+
+time4_4beamAutoEnd = #(begin (make-moment 1 2))
+time4_4beamAutoEnd_12 = #(begin (make-moment 1 4))
+time4_4beamAutoEnd_16 = #(begin (make-moment 1 4))
+time4_4beamAutoEnd_32 = #(begin (make-moment 1 8))
+
+time4_8beamAutoEnd = #(begin (make-moment 1 4))
+time4_8beamAutoEnd_16 = #(begin (make-moment 1 4))
+time4_8beamAutoEnd_32 = #(begin (make-moment 1 8))
+
+time4_16beamAutoEnd = #(begin (make-moment 1 8))
+
+time6_8beamAutoEnd = #(begin (make-moment 3 8))
+time6_8beamAutoEnd_16 = #(begin (make-moment 3 8))
+time6_8beamAutoEnd_32 = #(begin (make-moment 1 8))
+
+time9_8beamAutoEnd = #(begin (make-moment 3 8))
+time9_8beamAutoEnd_16 = #(begin (make-moment 3 8))
+time9_8beamAutoEnd_32 = #(begin (make-moment 1 8))
+
+time12_8beamAutoEnd = #(begin (make-moment 3 8))
+time12_8beamAutoEnd_16 = #(begin (make-moment 3 8))
+time12_8beamAutoEnd_32 = #(begin (make-moment 1 8))
+
+
+
+%{
+
+Users may override in most cases, simply by issuing
+
+    % from here on consider ending beam every 1/4 note
+    \property Voice.beamAutoEnd = #(make-moment 1 4)
+
+    % no autobeaming
+    \property Voice.beamAuto = ##f  
+
+or, more globally, by doing:
+
+ \paper{
+        \translator{
+            \VoiceContext
+            % consider ending beam at every 1/2 note
+            beamAutoEnd = #(make-moment 1 2)
+        }
+    }
+
+see also input/test/auto-beam-override.ly
 
-% *num_den (omitted if "1")
-
-time2_8beamAutoEnd = "2/8";
-time3_2beamAutoEnd = "1/2";
-time3_2beamAutoEnd_16 = "1/4";
-time3_2beamAutoEnd_32 = "1/8";
-time3_4beamAutoBegin = "1/4";
-time3_4beamAutoEnd_8 = "3/4";
-time3_4beamAutoBegin_32 = "1/8";
-time3_4beamAutoEnd_32 = "1/8";
-time3_8beamAutoBegin = "1/8";
-time3_8beamAutoEnd = "3/8";
-time4_4beamAutoEnd_8 = "1/2";
-% 1/12 == 1/8 * 2/3
-time4_4beamAutoEnd_12 = "1/4";
-time4_4beamAutoEnd_32 = "1/8";
-time4_8beamAutoEnd_8 = "1/4";
-time4_8beamAutoEnd_16 = "1/4";
-time4_8beamAutoEnd_32 = "1/8";
-time4_16beamAutoEnd = "1/8";
-time6_8beamAutoEnd_8 = "3/8";
-time6_8beamAutoEnd_16 = "3/8";
-time6_8beamAutoEnd_32 = "1/8";
-time9_8beamAutoEnd_8 = "3/8";
-time9_8beamAutoEnd_16 = "3/8";
-time6_8beamAutoEnd_32 = "1/8";
+%}