Documentation/notation/repeats.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  For details, see the Contributors'
   7     Guide, node Updating translation committishes..
   8 @end ignore
   9
  10 @c \version "2.17.11"
  11
  12 @node Repeats
  13 @section Repeats
  14
  15 @lilypondfile[quote]{repeats-headword.ly}
  16
  17 Repetition is a central concept in music, and multiple notations
  18 exist for repetitions.  LilyPond supports the following kinds of
  19 repeats:
  20
  21
  22 @table @code
  23 @item volta
  24 The repeated music is not written out but enclosed between repeat bar
  25 lines.  If the repeat is at the beginning of a piece, a repeat bar
  26 line is only printed at the end of the repeat.  Alternative endings
  27 (volte) are printed left to right with brackets.  This is the standard
  28 notation for repeats with alternatives.
  29
  30 @item unfold
  31 The repeated music is fully written out, as many times as
  32 specified by @code{@var{repeatcount}}.  This is useful when
  33 entering repetitious music.
  34
  35 @item percent
  36 These are beat or measure repeats.  They look like single slashes or
  37 percent signs.
  38
  39 @item tremolo
  40 This is used to write tremolo beams.
  41
  42 @end table
  43
  44
  45 @menu
  46 * Long repeats::
  47 * Short repeats::
  48 @end menu
  49
  50 @node Long repeats
  51 @subsection Long repeats
  52
  53 This section discusses how to input long (usually multi-measure)
  54 repeats.  The repeats can take two forms: repeats enclosed between
  55 repeat signs; or written-out repeats, used to input repetitious music.
  56 Repeat signs can also be controlled manually.
  57
  58 @menu
  59 * Normal repeats::
  60 * Manual repeat marks::
  61 * Written-out repeats::
  62 @end menu
  63
  64 @cindex volta
  65 @cindex prima volta
  66 @cindex seconda volta
  67 @cindex volta, prima
  68 @cindex volta, seconda
  69 @cindex repeat, normal
  70 @cindex normal repeat
  71 @cindex repeat with alternate endings
  72 @cindex alternate endings
  73 @funindex \repeat
  74 @funindex \alternative
  75 @funindex \partial
  76
  77 @node Normal repeats
  78 @unnumberedsubsubsec Normal repeats
  79
  80 The syntax for a normal repeat is
  81
  82 @example
  83 \repeat volta @var{repeatcount} @var{musicexpr}
  84 @end example
  85
  86 @noindent
  87 where @code{@var{musicexpr}} is a music expression.
  88
  89 A single repeat without an alternate ending:
  90
  91 @lilypond[verbatim,quote,relative=2]
  92 \repeat volta 2 { c4 d e f }
  93 c2 d
  94 \repeat volta 2 { d4 e f g }
  95 @end lilypond
  96
  97 Alternative endings can be produced using @code{\alternative}.  Each
  98 group of alternatives must be themselves, enclosed in a set of braces.
  99
 100 @example
 101 \repeat volta @var{repeatcount} @var{musicexpr}
 102 \alternative @{
 103   @{ @var{musicexpr} @}
 104 @}
 105 @end example
 106
 107 @noindent
 108 where @code{@var{musicexpr}} is a music expression.
 109
 110 If there are more repeats than there are alternate endings, the earliest
 111 repeats are given the first alternative.
 112
 113 A single repeat with one alternate ending:
 114
 115 @lilypond[verbatim,quote,relative=2]
 116 \repeat volta 2 { c4 d e f | }
 117 \alternative {
 118   { c2 e | }
 119   { f2 g | }
 120 }
 121 c1
 122 @end lilypond
 123
 124 Multiple repeats with one alternate ending:
 125
 126 @lilypond[verbatim,quote,relative=2]
 127 \repeat volta 4 { c4 d e f | }
 128 \alternative {
 129   { c2 e | }
 130   { f2 g | }
 131 }
 132 c1
 133 @end lilypond
 134
 135 Multiple repeats with more than one alternate ending:
 136
 137 @lilypond[verbatim,quote,relative=2]
 138 \repeat volta 3 { c4 d e f | }
 139 \alternative {
 140   { c2 e | }
 141   { f2 g | }
 142   { a2 g | }
 143 }
 144 c1
 145 @end lilypond
 146
 147 @warning{If there are two or more alternatives, nothing should appear
 148 between the closing brace of one and the opening brace of the next
 149 in an @code{@bs{}alternative} block, otherwise you will not get the
 150 expected number of endings.}
 151
 152 @warning{If you include @code{@bs{}relative} inside a
 153 @code{@bs{}repeat} without explicitly instantiating the
 154 @code{Voice} context, extra (unwanted) staves will appear.  See
 155 @rprogram{An extra staff appears}.}
 156
 157 @cindex repeat with upbeat
 158 @cindex upbeat in a repeat
 159 @cindex anacrusis in a repeat
 160 @cindex repeat with anacrusis
 161 @cindex repeat with pickup
 162 @cindex pickup in a repeat
 163 @funindex \partial
 164
 165 If a repeat starts in the middle of a measure and has no alternate
 166 endings, normally the end of the repeat will also fall in the
 167 middle of a measure, so that the two ends add up to one complete
 168 measure.  In such cases, the repeat signs do not constitute true
 169 bar lines.  Do not use @code{\partial} commands or bar checks
 170 where these repeat signs are printed:
 171
 172 @lilypond[verbatim,quote,relative=1]
 173 % no \partial here
 174 c4 e g  % no bar check here
 175 % no \partial here
 176 \repeat volta 4 {
 177   e4 |
 178   c2 e |
 179   % no \partial here
 180   g4 g g  % no bar check here
 181 }
 182 % no \partial here
 183 g4 |
 184 a2 a |
 185 g1 |
 186 @end lilypond
 187
 188 Similarly, if a repeat begins with the initial partial measure of
 189 a score and has no alternate endings, the same conditions apply as
 190 in the above example, except that in this case the @code{\partial}
 191 command is required at the beginning of the score:
 192
 193 @lilypond[verbatim,quote,relative=1]
 194 \partial 4  % required
 195 \repeat volta 4 {
 196   e4 |
 197   c2 e |
 198   % no \partial here
 199   g4 g g  % no bar check here
 200 }
 201 % no \partial here
 202 g4 |
 203 a2 a |
 204 g1 |
 205 @end lilypond
 206
 207 When alternate endings are added to a repeat that begins with an
 208 incomplete measure, it becomes necessary to set the
 209 @code{Timing.measureLength} context property manually, in the
 210 following specific places:
 211
 212 @itemize
 213 @item
 214 at the start of any incomplete measures in the @code{\alternative}
 215 block, which normally occur at the end of each alternative, except
 216 (in most cases) the last.
 217
 218 @item
 219 at the start of each alternative, except the first.
 220 @end itemize
 221
 222 @lilypond[verbatim,quote,relative=1]
 223 \partial 4
 224 \repeat volta 2 { e4 | c2 e | }
 225 \alternative {
 226   {
 227     f2 d |
 228     \set Timing.measureLength = #(ly:make-moment 3/4)
 229     g4 g g  % optional bar check is allowed here
 230   }
 231   {
 232     \set Timing.measureLength = #(ly:make-moment 4/4)
 233     a2 a |
 234   }
 235 }
 236 g1 |
 237 @end lilypond
 238
 239 The @code{measureLength} property is described in @ref{Time
 240 administration}.
 241
 242 @cindex repeats, with ties
 243 @cindex alternative endings, with ties
 244 @cindex ties, in repeats
 245 @cindex ties, alternative endings
 246 @funindex \repeatTie
 247
 248 Ties may be added to a second ending:
 249
 250 @lilypond[verbatim,quote,relative=2]
 251 c1
 252 \repeat volta 2 { c4 d e f~ }
 253 \alternative {
 254   { f2 d }
 255   { f2\repeatTie f, }
 256 }
 257 @end lilypond
 258
 259 @funindex \inStaffSegno
 260 @cindex repeats, with segno
 261 @cindex segno, with repeats
 262
 263 The @code{\inStaffSegno} command can be used to generate a composite
 264 bar line incorporating the segno symbol with the appropriate repeat
 265 bar line when used with the @code{\repeat volta} command.  The
 266 correct type of repeat bar line, viz. start repeat, end repeat or
 267 double repeat, is selected automatically.  Note that the
 268 corresponding @qq{D.S.} mark must be added manually.
 269
 270 Away from a repeat:
 271
 272 @lilypond[verbatim,quote,relative=1]
 273 e1
 274 \inStaffSegno
 275 f2 g a b
 276 c1_"D.S." \bar "|."
 277 @end lilypond
 278
 279 At the start of a repeat:
 280
 281 @lilypond[verbatim,quote,relative=1]
 282 e1
 283 \repeat volta 2 {
 284   \inStaffSegno  % start repeat
 285   f2 g a b
 286 }
 287 c1_"D.S." \bar "|."
 288 @end lilypond
 289
 290 At the end of a repeat:
 291
 292 @lilypond[verbatim,quote,relative=1]
 293 e1
 294 \repeat volta 2 {
 295   f2 g a b
 296   \inStaffSegno  % end repeat
 297 }
 298 f2 g a b
 299 c1_"D.S." \bar "|."
 300 @end lilypond
 301
 302 Between two repeats:
 303
 304 @lilypond[verbatim,quote,relative=1]
 305 e1
 306 \repeat volta 2 {
 307   f2 g a b
 308 }
 309 \inStaffSegno  % double repeat
 310 \repeat volta 2 {
 311   f2 g a b
 312 }
 313 c1_"D.S." \bar "|."
 314 @end lilypond
 315
 316 Alternative bar line symbols can be obtained by setting (in the Score
 317 context) the properties @code{segnoType}, @code{startRepeatSegnoType},
 318 @code{endRepeatSegnoType} or @code{doubleRepeatSegnoType} to the
 319 required bar line type.  The alternative bar line types must be
 320 selected from the pre-defined types or types previously defined
 321 with the @code{\defineBarLine} command (see @ref{Bar lines}).
 322
 323 @lilypond[verbatim,quote,relative=1]
 324 \defineBarLine ":|.S[" #'(":|." "S[" "")
 325 \defineBarLine "]" #'("]" "" "")
 326 e1
 327 \repeat volta 2 {
 328   f2 g a b
 329   \once \set Score.endRepeatSegnoType = ":|.S["
 330   \inStaffSegno
 331 }
 332 f2 g \bar "]" a b
 333 c1_"D.S." \bar "|."
 334 @end lilypond
 335
 336 @snippets
 337 @lilypondfile[verbatim,quote,texidoc,doctitle]
 338 {shortening-volta-brackets.ly}
 339
 340 @lilypondfile[verbatim,quote,texidoc,doctitle]
 341 {adding-volta-brackets-to-additional-staves.ly}
 342
 343 @lilypondfile[verbatim,quote,texidoc,doctitle]
 344 {setting-the-double-repeat-default-for-volte.ly}
 345
 346 @cindex repeats, bar numbers letters
 347 @cindex repeats, alternative bar numbers
 348
 349 @lilypondfile[verbatim,quote,texidoc,doctitle]
 350 {alternative-bar-numbering.ly}
 351
 352 @seealso
 353 Music Glossary:
 354 @rglos{repeat},
 355 @rglos{volta}.
 356
 357 Notation Reference:
 358 @ref{Bar lines},
 359 @ref{Modifying context plug-ins},
 360 @ref{Modifying ties and slurs},
 361 @ref{Time administration}.
 362
 363 Snippets:
 364 @rlsr{Repeats}.
 365
 366 Internals Reference:
 367 @rinternals{VoltaBracket},
 368 @rinternals{RepeatedMusic},
 369 @rinternals{VoltaRepeatedMusic},
 370 @rinternals{UnfoldedRepeatedMusic}.
 371
 372 @knownissues
 373 @cindex repeat, ambiguous
 374 @cindex nested repeat
 375 @cindex repeat, nested
 376 @cindex repeat timing information
 377 @cindex repeat and measure number
 378 @cindex timing information and repeats
 379 @cindex measure number and repeats
 380 @cindex repeats and slur
 381 @cindex slur and repeats
 382 @cindex glissandi and repeats
 383 @cindex repeats and glissandi
 384
 385 Slurs that span from a @code{\repeat} block into an
 386 @code{\alternative} block will only work for the first alternative
 387 ending.  The visual appearance of a continuing slur in other
 388 alternative blocks may be simulated with @code{\repeatTie} if the
 389 slur extends into only one note in the alternative block, although
 390 this method does not work in @code{TabStaff}.  Other methods which
 391 may be tailored to indicate continuing slurs over several notes in
 392 alternative blocks, and which also work in @code{TabStaff} contexts,
 393 are shown in @ref{Modifying ties and slurs}.
 394
 395 Also, slurs cannot wrap around from the end of one
 396 alternative back to the beginning of the repeat.
 397
 398 Glissandi that span from a @code{\repeat} block into an
 399 @code{\alternative} block will only work for the first alternative
 400 ending.  The visual appearance of a continuing glissando in other
 401 alternative blocks may be indicated by coding a glissando starting
 402 on a hidden grace note.  For an example, see
 403 @qq{Extending glissandi across repeats} under Selected Snippets
 404 in @ref{Glissando}.
 405
 406 If a repeat that begins with an incomplete measure has an
 407 @code{\alternative} block that contains modifications to the
 408 @code{measureLength} property, using @code{\unfoldRepeats} will
 409 result in wrongly-placed bar lines and bar check warnings.
 410
 411 A nested repeat like
 412
 413 @example
 414 \repeat @dots{}
 415 \repeat @dots{}
 416 \alternative
 417 @end example
 418
 419 @noindent
 420 is ambiguous, since it is not clear to which @code{\repeat} the
 421 @code{\alternative} belongs.  This ambiguity is resolved by always
 422 having the @code{\alternative} belong to the inner @code{\repeat}.
 423 For clarity, it is advisable to use braces in such situations.
 424
 425
 426 @node Manual repeat marks
 427 @unnumberedsubsubsec Manual repeat marks
 428
 429 @cindex manual repeat mark
 430 @cindex repeat, manual
 431 @cindex start repeat
 432 @cindex repeat, start
 433 @cindex end repeat
 434 @cindex repeat, end
 435 @cindex repeat number, changing
 436 @cindex repeat volta, changing
 437 @cindex volta bracket
 438 @cindex bracket, volta
 439 @funindex repeatCommands
 440 @funindex start-repeat
 441
 442 @warning{These methods are only used for displaying unusual repeat
 443 constructs, and may produce unexpected behavior.  In most cases,
 444 repeats should be created using the standard @code{@bs{}repeat} command
 445 or by printing the relevant bar lines.  For more information, see
 446 @ref{Bar lines}.}
 447
 448 The property @code{repeatCommands} can be used to control the
 449 layout of repeats.  Its value is a Scheme list of repeat commands.
 450
 451 @table @code
 452 @item start-repeat
 453 Print a @code{.|:} bar line.
 454
 455 @lilypond[verbatim,quote,relative=2]
 456 c1
 457 \set Score.repeatCommands = #'(start-repeat)
 458 d4 e f g
 459 c1
 460 @end lilypond
 461
 462 As per standard engraving practice, repeat signs are not printed
 463 at the beginning of a piece.
 464
 465 @item end-repeat
 466 Print a @code{:|.} bar line:
 467
 468 @lilypond[verbatim,quote,relative=2]
 469 c1
 470 d4 e f g
 471 \set Score.repeatCommands = #'(end-repeat)
 472 c1
 473 @end lilypond
 474
 475 @item (volta @var{number}) @dots{} (volta #f)
 476 Create a new volta with the specified number.  The volta bracket must
 477 be explicitly terminated, or it will not be printed.
 478
 479 @lilypond[verbatim,quote,relative=2]
 480 f4 g a b
 481 \set Score.repeatCommands = #'((volta "2"))
 482 g4 a g a
 483 \set Score.repeatCommands = #'((volta #f))
 484 c1
 485 @end lilypond
 486
 487 @end table
 488
 489 Multiple repeat commands may occur at the same point:
 490
 491 @lilypond[verbatim,quote,relative=2]
 492 f4 g a b
 493 \set Score.repeatCommands = #'((volta "2, 5") end-repeat)
 494 g4 a g a
 495 c1
 496 \set Score.repeatCommands = #'((volta #f) (volta "95") end-repeat)
 497 b1
 498 \set Score.repeatCommands = #'((volta #f))
 499 @end lilypond
 500
 501 @cindex volta bracket with text
 502 @cindex text in volta bracket
 503
 504 Text can be included with the volta bracket.  The text can be a
 505 number or numbers or markup text, see @ref{Formatting text}.  The
 506 simplest way to use markup text is to define the markup first,
 507 then include the markup in a Scheme list.
 508
 509 @lilypond[verbatim,quote]
 510 voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
 511 \relative c'' {
 512   c1
 513   \set Score.repeatCommands =
 514     #(list(list 'volta voltaAdLib) 'start-repeat)
 515   c4 b d e
 516   \set Score.repeatCommands = #'((volta #f) (volta "4.") end-repeat)
 517   f1
 518   \set Score.repeatCommands = #'((volta #f))
 519 }
 520 @end lilypond
 521
 522
 523 @snippets
 524
 525 @lilypondfile[verbatim,quote,texidoc,doctitle]
 526 {printing-a-repeat-sign-at-the-beginning-of-a-piece.ly}
 527
 528 @seealso
 529 Notation Reference:
 530 @ref{Bar lines},
 531 @ref{Formatting text}.
 532
 533 Snippets:
 534 @rlsr{Repeats}.
 535
 536 Internals Reference:
 537 @rinternals{VoltaBracket},
 538 @rinternals{RepeatedMusic},
 539 @rinternals{VoltaRepeatedMusic}.
 540
 541
 542 @node Written-out repeats
 543 @unnumberedsubsubsec Written-out repeats
 544
 545 @cindex written-out repeats
 546 @cindex repeats, written-out
 547 @cindex repeats, unfold
 548 @cindex repeats, alternative
 549 @cindex unfold repeat
 550 @cindex unfold repeat, alternate endings
 551 @cindex alternate repeats
 552 @cindex alternate endings, repeats
 553 @funindex unfold
 554
 555 By using the @code{unfold} command, repeats can be used to simplify the
 556 writing out of repetitious music.  The syntax is
 557
 558 @example
 559 \repeat unfold @var{repeatcount} @var{musicexpr}
 560 @end example
 561
 562 @noindent
 563 where @code{@var{musicexpr}} is a music expression and
 564 @code{@var{repeatcount}} is the number of times
 565 @code{@var{musicexpr}} is repeated.
 566
 567 @lilypond[verbatim,quote,relative=2]
 568 \repeat unfold 2 { c4 d e f }
 569 c1
 570 @end lilypond
 571
 572 In some cases, especially in a @code{\relative} context, the
 573 @code{\repeat unfold} function is not the same as writing out the
 574 music expression multiple times. E.g,
 575
 576 @example
 577 \repeat unfold 2 @{ a'4 b c @}
 578 @end example
 579
 580 is not equivalent to
 581
 582 @example
 583 a'4 b c | a'4 b c
 584 @end example
 585
 586 Unfold repeats can be made with alternate endings.
 587
 588 @lilypond[verbatim,quote,relative=2]
 589 \repeat unfold 2 { c4 d e f }
 590 \alternative {
 591   { c2 g' }
 592   { c,2 b }
 593 }
 594 c1
 595 @end lilypond
 596
 597 If there are more repeats than there are alternate endings, the first
 598 alternative is applied multiple times until the remaining alternatives
 599 make up the total number of repeats.
 600
 601 @lilypond[verbatim,quote,relative=2]
 602 \repeat unfold 4 { c4 d e f }
 603 \alternative {
 604   { c2 g' }
 605   { c,2 b }
 606   { e2 d }
 607  }
 608 c1
 609 @end lilypond
 610
 611 If there are more alternate endings than repeats then only the first
 612 alternatives are applied.  The remaining alternatives will be ignored
 613 and not printed.
 614
 615 @lilypond[verbatim,quote,relative=2]
 616 \repeat unfold 2 { c4 d e f }
 617 \alternative {
 618   { c2 g' }
 619   { c,2 b }
 620   { e2 d }
 621 }
 622 c1
 623 @end lilypond
 624
 625 It is also possible to nest multiple @code{unfold} functions (with or
 626 without alternate endings).
 627
 628 @lilypond[verbatim,quote,relative=2]
 629 \repeat unfold 2 {
 630   \repeat unfold 2 { c4 d e f }
 631   \alternative {
 632     { c2 g' }
 633     { c,2 b }
 634   }
 635 }
 636 c1
 637 @end lilypond
 638
 639 Chord constructs can be repeated by the chord repetition symbol
 640 @code{q}.  See @ref{Chord repetition}.
 641
 642 @warning{If you include @code{@bs{}relative} inside a @code{@bs{}repeat}
 643 without explicitly instantiating the @code{Voice} context, extra
 644 (unwanted) staves will appear.  See @rprogram{An extra staff appears}.}
 645
 646 @seealso
 647 Notation Reference:
 648 @ref{Chord repetition}.
 649
 650 Snippets:
 651 @rlsr{Repeats}.
 652
 653 Internals Reference:
 654 @rinternals{RepeatedMusic},
 655 @rinternals{UnfoldedRepeatedMusic}.
 656
 657
 658 @node Short repeats
 659 @subsection Short repeats
 660
 661 This section discusses how to input short repeats.  Short repeats can
 662 take two forms: slashes or percent signs to represent repeats of a
 663 single note, a single measure or two measures, and tremolos otherwise.
 664
 665 @menu
 666 * Percent repeats::
 667 * Tremolo repeats::
 668 @end menu
 669
 670 @node Percent repeats
 671 @unnumberedsubsubsec Percent repeats
 672
 673 @cindex percent repeats
 674 @cindex measure repeats
 675 @cindex repeat, percent
 676 @cindex repeat, measure
 677 @cindex repeat, short
 678 @funindex \repeat percent
 679 @funindex percent
 680
 681 Repeated short patterns are printed once, and the repeated pattern
 682 is replaced with a special sign.
 683
 684 The syntax is
 685
 686 @example
 687 \repeat percent @var{number} @var{musicexpr}
 688 @end example
 689
 690 @noindent
 691 where @code{@var{musicexpr}} is a music expression.
 692
 693 Patterns that are shorter than one measure are replaced by slashes.
 694
 695 @lilypond[verbatim,quote,relative=2]
 696 \repeat percent 4 { c128 d e f }
 697 \repeat percent 4 { c64 d e f }
 698 \repeat percent 5 { c32 d e f }
 699 \repeat percent 4 { c16 d e f }
 700 \repeat percent 4 { c8 d }
 701 \repeat percent 4 { c4 }
 702 \repeat percent 2 { c2 }
 703 @end lilypond
 704
 705 Patterns of one or two measures are replaced by percent-like symbols.
 706
 707 @lilypond[verbatim,quote,relative=2]
 708 \repeat percent 2 { c4 d e f }
 709 \repeat percent 2 { c2 d }
 710 \repeat percent 2 { c1 }
 711 @end lilypond
 712
 713 @lilypond[verbatim,quote,relative=2]
 714 \repeat percent 3 { c4 d e f | c2 g' }
 715 @end lilypond
 716
 717 Patterns that are shorter than one measure but contain mixed durations
 718 use a double-percent symbol.
 719
 720 @lilypond[verbatim,quote,relative=2]
 721 \repeat percent 4 { c8. <d f>16 }
 722 \repeat percent 2 { \tuplet 3/2 { r8 c d } e4 }
 723 @end lilypond
 724
 725 @snippets
 726
 727 @lilypondfile[verbatim,quote,texidoc,doctitle]
 728 {percent-repeat-counter.ly}
 729
 730 @lilypondfile[verbatim,quote,texidoc,doctitle]
 731 {percent-repeat-count-visibility.ly}
 732
 733 @lilypondfile[verbatim,quote,texidoc,doctitle]
 734 {isolated-percent-repeats.ly}
 735
 736 @seealso
 737 Music Glossary:
 738 @rglos{percent repeat},
 739 @rglos{simile}.
 740
 741 Snippets:
 742 @rlsr{Repeats}.
 743
 744 Internals Reference:
 745 @rinternals{RepeatSlash},
 746 @rinternals{RepeatSlashEvent},
 747 @rinternals{DoubleRepeatSlash},
 748 @rinternals{PercentRepeat},
 749 @rinternals{PercentRepeatCounter},
 750 @rinternals{PercentRepeatedMusic},
 751 @rinternals{Percent_repeat_engraver},
 752 @rinternals{DoublePercentEvent},
 753 @rinternals{DoublePercentRepeat},
 754 @rinternals{DoublePercentRepeatCounter},
 755 @rinternals{Double_percent_repeat_engraver},
 756 @rinternals{Slash_repeat_engraver}.
 757
 758
 759 @node Tremolo repeats
 760 @unnumberedsubsubsec Tremolo repeats
 761
 762 @cindex tremolo beams
 763 @cindex tremolo
 764 @cindex repeat, tremolo
 765 @funindex \repeat tremolo
 766 @funindex tremolo
 767
 768 Tremolos can take two forms: alternation between two chords or two
 769 notes, and rapid repetition of a single note or chord.  Tremolos
 770 consisting of an alternation are indicated by adding beams between the
 771 notes or chords being alternated, while tremolos consisting of the
 772 rapid repetition of a single note are indicated by adding beams or
 773 slashes to a single note.
 774
 775 To place tremolo marks between notes, use @code{\repeat} with
 776 tremolo style:
 777
 778 @lilypond[quote,verbatim,relative=2]
 779 \repeat tremolo 8 { c16 d }
 780 \repeat tremolo 6 { c16 d }
 781 \repeat tremolo 2 { c16 d }
 782 @end lilypond
 783
 784 The @code{\repeat tremolo} syntax expects exactly two notes within
 785 the braces, and the number of repetitions must correspond to a
 786 note value that can be expressed with plain or dotted notes.  Thus,
 787 @code{\repeat tremolo 7} is valid and produces a double dotted
 788 note, but @code{\repeat tremolo 9} is not.
 789
 790 The duration of the tremolo equals the duration of the
 791 braced expression multiplied by the number of repeats:
 792 @code{\repeat tremolo 8 @{ c16 d16 @}} gives a whole note tremolo,
 793 notated as two whole notes joined by tremolo beams.
 794
 795 There are two ways to put tremolo marks on a single note.  The
 796 @code{\repeat tremolo} syntax is also used here, in which case
 797 the note should not be surrounded by braces:
 798
 799 @lilypond[quote,verbatim,ragged-right]
 800 \repeat tremolo 4 c'16
 801 @end lilypond
 802
 803 @cindex tremolo marks
 804 @funindex tremoloFlags
 805 @funindex :
 806
 807 The same output can be obtained by adding @code{:@var{N}} after
 808 the note, where @code{@var{N}} indicates the duration of the
 809 subdivision (it must be at least 8).  If @code{@var{N}} is 8, one
 810 beam is added to the note's stem.  If @code{@var{N}} is omitted,
 811 the last value (stored in @code{tremoloFlags}) is used:
 812
 813 @lilypond[quote,verbatim,relative=2]
 814 c2:8 c:32
 815 c: c:
 816 @end lilypond
 817
 818 @snippets
 819
 820 @lilypondfile[verbatim,quote,texidoc,doctitle]
 821 {cross-staff-tremolos.ly}
 822
 823 @seealso
 824 Snippets:
 825 @rlsr{Repeats}.
 826
 827 @cindex tremolo, cross-staff
 828 @cindex cross-staff tremolo