Documentation/snippets/new/conducting-signs,-measure-grouping-signs.ly

   1 \version "2.15.19"
   2
   3 \header {
   4   lsrtags = "rhythms"
   5   texidoc = "
   6 Beat grouping within a measure is controlled by the context property
   7 @code{beatStructure}.  Values of @code{beatStructure} are
   8 established for many time signatures in
   9 @file{scm/time-signature-settings.scm}.  Values of @code{beatStructure}
  10 can be changed or set with @code{\set}.
  11 Alternatively, @code{\time} can be used to both
  12 set the time signature and establish the beat structure.
  13 For this, you specify the internal grouping of beats in a measure
  14 as a list of numbers (in Scheme syntax) before the time signature.
  15
  16 @code{\time} applies to the @code{Timing} context, so it will not
  17 reset values of @code{beatStructure} or @code{baseMoment} that are set
  18 in other lower-level contexts, such as @code{Voice}.
  19
  20 If the @code{Measure_grouping_engraver} is included
  21 in one of the display contexts, measure grouping signs will be
  22 created.  Such signs ease reading rhythmically complex modern music.
  23 In the example, the 9/8 measure is grouped in two different
  24 patterns using the two different methods, while the 5/8 measure
  25 is grouped according to the default setting in
  26 @file{scm/time-signature-settings.scm}:
  27 "
  28   doctitle = "Conducting signs, measure grouping signs"
  29 }
  30
  31
  32 \score {
  33   \new Voice \relative c'' {
  34     \time 9/8
  35     g8 g d d g g a( bes g) |
  36     \set Timing.beatStructure = #'(2 2 2 3)
  37     g8 g d d g g a( bes g) |
  38     \time #'(4 5) 9/8
  39     g8 g d d g g a( bes g) |
  40     \time 5/8
  41     a4. g4 |
  42   }
  43   \layout {
  44     \context {
  45       \Staff
  46       \consists "Measure_grouping_engraver"
  47     }
  48   }
  49 }