release: 1.3.92

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

diff --git a/ly/auto-beam-settings.ly b/ly/auto-beam-settings.ly
index d52802108a82156167933403b434e2a848fff6fa..f77eb3f6b3a30dec939750d56452ff736dfdd5fc 100644 (file)
--- a/ly/auto-beam-settings.ly
+++ b/ly/auto-beam-settings.ly
@@ -1,24 +1,112 @@
+% auto-beam-settings.ly
+% setup for auto-beam engraver
 %
-% setup for auto beamer
+% specify generic beam end times
+
+% format:
 %
-time2_8beamAutoEnd = "2/8";
-time3_2beamAutoEnd = "1/2";
-time3_2beamAutoEnd16 = "1/4";
-time3_2beamAutoEnd32 = "1/8";
-time3_4beamAutoBegin = "1/4";
-time3_4beamAutoEnd8 = "3/4";
-time3_4beamAutoEnd32 = "1/8";
-time3_8beamAutoBegin = "1/8";
-time3_8beamAutoEnd = "3/8";
-time4_4beamAutoEnd8 = "1/2";
-time4_4beamAutoEnd32 = "1/8";
-time4_8beamAutoEnd8 = "1/4";
-time4_8beamAutoEnd16 = "1/4";
-time4_8beamAutoEnd32 = "1/8";
-time4_16beamAutoEnd = "1/8";
-time6_8beamAutoEnd8 = "3/8";
-time6_8beamAutoEnd16 = "3/8";
-time6_8beamAutoEnd32 = "1/8";
-time9_8beamAutoEnd8 = "3/8";
-time9_8beamAutoEnd16 = "3/8";
-time6_8beamAutoEnd32 = "1/8";
+%     [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
+
+
+%{
+
+UGH UGH. 
+
+Fixme: should use an alist
+
+autoBeamSettings = (list
+  (cons (list (make-moment MEASURE) TIME-SIGNATURE) (make-moment INTERVAL)
+  ..
+
+  )
+
+
+
+%}
+
+time3_2beamAutoEnd = #(make-moment 1 2)
+%time3_2beamAutoEnd_16 = #(make-moment 1 4)
+time3_2beamAutoEnd_16 = #(make-moment 1 4)
+time3_2beamAutoEnd_32 = #(make-moment 1 8)
+
+time3_4beamAutoBegin_8 = #(make-moment 1 4)
+time3_4beamAutoEnd = #(make-moment 3 4)
+time3_4beamAutoBegin_16 = #(make-moment 1 16)
+time3_4beamAutoEnd_16 = #(make-moment 1 4)
+%time3_4beamAutoBegin_32 = #(make-moment 1 8)
+time3_4beamAutoEnd_32 = #(make-moment 1 8)
+
+time3_8beamAutoBegin_16 = #(make-moment 1 8)
+time3_8beamAutoEnd = #(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 = #(make-moment 1 2)
+time4_4beamAutoEnd_12 = #(make-moment 1 4)
+time4_4beamAutoEnd_16 = #(make-moment 1 4)
+time4_4beamAutoEnd_32 = #(make-moment 1 8)
+
+time2_4beamAutoEnd = #(make-moment 1 4)
+time2_4beamAutoEnd_12 = #(make-moment 1 4)
+time2_4beamAutoEnd_16 = #(make-moment 1 4)
+time2_4beamAutoEnd_32 = #(make-moment 1 8)
+
+
+time4_8beamAutoEnd = #(make-moment 1 4)
+time4_8beamAutoEnd_16 = #(make-moment 1 4)
+time4_8beamAutoEnd_32 = #(make-moment 1 8)
+
+time4_16beamAutoEnd = #(make-moment 1 8)
+
+time6_8beamAutoEnd = #(make-moment 3 8)
+time6_8beamAutoEnd_16 = #(make-moment 3 8)
+time6_8beamAutoEnd_32 = #(make-moment 1 8)
+
+time9_8beamAutoEnd = #(make-moment 3 8)
+time9_8beamAutoEnd_16 = #(make-moment 3 8)
+time9_8beamAutoEnd_32 = #(make-moment 1 8)
+
+time12_8beamAutoEnd = #(make-moment 3 8)
+time12_8beamAutoEnd_16 = #(make-moment 3 8)
+time12_8beamAutoEnd_32 = #(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
+
+%}
+