Documentation/snippets/partcombine-and-autobeamoff.ly

   1 % Do not edit this file; it is automatically
   2 % generated from Documentation/snippets/new
   3 % This file is in the public domain.
   4 %% Note: this file works from version 2.13.31
   5 \version "2.13.31"
   6
   7 \header {
   8   lsrtags = "rhythms"
   9
  10   texidoc = "
  11 The function of @code{@bs{}autoBeamOff} when used with
  12 @code{@bs{}partcombine} can be difficult to understand.  It may
  13 be preferable to use
  14
  15 @example
  16 \set Staff.autobeaming = ##f
  17 @end example
  18
  19 @noindent
  20 instead, to ensure that autobeaming will be turned off for the entire
  21 staff.
  22
  23 @code{\partcombine} apparently works with 3 voices -- stem up single,
  24 stem down single, stem up combined.
  25
  26 An @code{\autoBeamOff} call in the first argument to partcombine will
  27 apply to the voice that is active at the time the call is processed,
  28 either stem up single or stem up combined.
  29 An @code{\autoBeamOff} call in the second argument will apply to the
  30 voice that is stem down single.
  31
  32 In order to use @code{\autoBeamOff} to stop all autobeaming when used
  33 with @code{\partcombine},
  34 it will be necessary to use @emph{three} calls to @code{\autoBeamOff}.
  35
  36 "
  37 doctitle = "Partcombine and autoBeamOff"
  38 } % begin verbatim
  39
  40
  41 {
  42   %\set Staff.autoBeaming = ##f % turns off all autobeaming
  43   \partcombine
  44       {
  45         \autoBeamOff % applies to split up stems
  46         \repeat unfold 4 a'16
  47         %\autoBeamOff % applies to combined up stems
  48         \repeat unfold 4 a'8
  49         \repeat unfold 4 a'16
  50       }
  51       {
  52         \autoBeamOff % applies to down stems
  53         \repeat unfold 4 f'8
  54         \repeat unfold 8 f'16 |
  55       }
  56 }
  57