]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/snippets/conducting-signs,-measure-grouping-signs.ly
Merge remote branch 'origin/master' into release/unstable
[lilypond.git] / Documentation / snippets / conducting-signs,-measure-grouping-signs.ly
1 %% DO NOT EDIT this file manually; it is automatically
2 %% generated from LSR http://lsr.di.unimi.it
3 %% Make any changes in LSR itself, or in Documentation/snippets/new/ ,
4 %% and then run scripts/auxiliar/makelsr.py
5 %%
6 %% This file is in the public domain.
7 \version "2.18.0"
8
9 \header {
10   lsrtags = "rhythms"
11
12   texidoc = "
13 Beat grouping within a measure is controlled by the context property
14 @code{beatStructure}.  Values of @code{beatStructure} are established
15 for many time signatures in @file{scm/time-signature-settings.scm}.
16 Values of @code{beatStructure} can be changed or set with @code{\\set}.
17 Alternatively, @code{\\time} can be used to both set the time signature
18 and establish the beat structure. For this, you specify the internal
19 grouping of beats in a measure as a list of numbers (in Scheme syntax)
20 before the time signature.
21
22 @code{\\time} applies to the @code{Timing} context, so it will not
23 reset values of @code{beatStructure} or @code{baseMoment} that are set
24 in other lower-level contexts, such as @code{Voice}.
25
26 If the @code{Measure_grouping_engraver} is included in one of the
27 display contexts, measure grouping signs will be created.  Such signs
28 ease reading rhythmically complex modern music. In the example, the 9/8
29 measure is grouped in two different patterns using the two different
30 methods, while the 5/8 measure is grouped according to the default
31 setting in @file{scm/time-signature-settings.scm}:
32
33 "
34   doctitle = "Conducting signs measure grouping signs"
35 } % begin verbatim
36
37 \score {
38   \new Voice \relative c'' {
39     \time 9/8
40     g8 g d d g g a( bes g) |
41     \set Timing.beatStructure = #'(2 2 2 3)
42     g8 g d d g g a( bes g) |
43     \time #'(4 5) 9/8
44     g8 g d d g g a( bes g) |
45     \time 5/8
46     a4. g4 |
47   }
48   \layout {
49     \context {
50       \Staff
51       \consists "Measure_grouping_engraver"
52     }
53   }
54 }