ly/auto-beam-settings.ly

   1 % auto-beam-settings.ly
   2 % setup for auto-beam engraver
   3 %
   4 % specify generic beam end times
   5
   6 % format:
   7 %
   8 %     [time-signature]'beamAutoEnd'[duration]
   9 %
  10 % where
  11 %
  12 %     time-signature = 'time'[numerator]'_'denominator; eg: 3_4
  13 %     duration = [numerator]'_'denominator; eg: 3_8, _16
  14 %
  15
  16 % in 3/2 time:
  17 %   end beams each 1/2 note
  18 %   end beams with 16th notes each 1/4 note
  19 %   end beams with 32th notes each 1/8 note
  20
  21 time3_2beamAutoEnd = #(make-moment 1 2)
  22 %time3_2beamAutoEnd_16 = #(make-moment 1 4)
  23 time3_2beamAutoEnd_16 = #(make-moment 1 4)
  24 time3_2beamAutoEnd_32 = #(begin (make-moment 1 8))
  25
  26 time3_4beamAutoBegin_8 = #(begin (make-moment 1 4))
  27 time3_4beamAutoEnd = #(begin (make-moment 3 4))
  28 time3_4beamAutoBegin_16 = #(begin (make-moment 1 16))
  29 time3_4beamAutoEnd_16 = #(begin (make-moment 1 4))
  30 %time3_4beamAutoBegin_32 = #(begin (make-moment 1 8))
  31 time3_4beamAutoEnd_32 = #(begin (make-moment 1 8))
  32
  33 time3_8beamAutoBegin = #(begin (make-moment 1 8))
  34 time3_8beamAutoEnd = #(begin (make-moment 3 8))
  35
  36 % in common time:
  37 %   end beams each 1/2 note
  38 %   end beams with 32th notes each 1/8 note
  39 %   end beams with 1/8 triplets each 1/4 note
  40
  41 time4_4beamAutoEnd = #(begin (make-moment 1 2))
  42 time4_4beamAutoEnd_12 = #(begin (make-moment 1 4))
  43 time4_4beamAutoEnd_16 = #(begin (make-moment 1 4))
  44 time4_4beamAutoEnd_32 = #(begin (make-moment 1 8))
  45
  46 time4_8beamAutoEnd = #(begin (make-moment 1 4))
  47 time4_8beamAutoEnd_16 = #(begin (make-moment 1 4))
  48 time4_8beamAutoEnd_32 = #(begin (make-moment 1 8))
  49
  50 time4_16beamAutoEnd = #(begin (make-moment 1 8))
  51
  52 time6_8beamAutoEnd = #(begin (make-moment 3 8))
  53 time6_8beamAutoEnd_16 = #(begin (make-moment 3 8))
  54 time6_8beamAutoEnd_32 = #(begin (make-moment 1 8))
  55
  56 time9_8beamAutoEnd = #(begin (make-moment 3 8))
  57 time9_8beamAutoEnd_16 = #(begin (make-moment 3 8))
  58 time9_8beamAutoEnd_32 = #(begin (make-moment 1 8))
  59
  60 time12_8beamAutoEnd = #(begin (make-moment 3 8))
  61 time12_8beamAutoEnd_16 = #(begin (make-moment 3 8))
  62 time12_8beamAutoEnd_32 = #(begin (make-moment 1 8))
  63
  64
  65
  66 %{
  67
  68 Users may override in most cases, simply by issuing
  69
  70     % from here on consider ending beam every 1/4 note
  71     \property Voice.beamAutoEnd = #(make-moment 1 4)
  72
  73     % no autobeaming
  74     \property Voice.beamAuto = ##f
  75
  76 or, more globally, by doing:
  77
  78  \paper{
  79         \translator{
  80             \VoiceContext
  81             % consider ending beam at every 1/2 note
  82             beamAutoEnd = #(make-moment 1 2)
  83         }
  84     }
  85
  86 see also input/test/auto-beam-override.ly
  87
  88 %}
  89