Documentation/notation/percussion.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.30"
  11
  12 @node Percussion
  13 @section Percussion
  14
  15 @menu
  16 * Common notation for percussion::
  17 @end menu
  18
  19 @node Common notation for percussion
  20 @subsection Common notation for percussion
  21
  22 Rhythmic music is primarily used for percussion and drum notation, but it can
  23 also be used to show the rhythms of melodies.
  24
  25 @menu
  26 * References for percussion::
  27 * Basic percussion notation::
  28 * Drum rolls::
  29 * Pitched percussion::
  30 * Percussion staves::
  31 * Custom percussion staves::
  32 * Ghost notes::
  33 @end menu
  34
  35 @node References for percussion
  36 @unnumberedsubsubsec References for percussion
  37
  38 @c TODO add more references.
  39
  40 @itemize
  41
  42 @item Some percussion may be notated on a rhythmic staff; this is
  43 discussed in @ref{Showing melody rhythms}, and
  44 @ref{Instantiating new staves}.
  45
  46 @item MIDI output is discussed in a separate section; please see
  47 @ref{Percussion in MIDI}.
  48
  49 @end itemize
  50
  51 @seealso
  52 Notation Reference:
  53 @ref{Showing melody rhythms},
  54 @ref{Instantiating new staves}.
  55 @ref{Percussion in MIDI}.
  56
  57 Snippets:
  58 @rlsr{Percussion}.
  59
  60
  61 @node Basic percussion notation
  62 @unnumberedsubsubsec Basic percussion notation
  63
  64 @cindex percussion
  65 @cindex drums
  66
  67 Percussion notes may be entered in @code{\drummode} mode, which is
  68 similar to the standard mode for entering notes.  The simplest way
  69 to enter percussion notes is to use the @code{\drums} command,
  70 which creates the correct context and entry mode for percussion:
  71
  72 @lilypond[quote,verbatim]
  73 \drums {
  74   hihat4 hh bassdrum bd
  75 }
  76 @end lilypond
  77
  78 This is shorthand for:
  79
  80 @lilypond[quote,verbatim]
  81 \new DrumStaff {
  82   \drummode {
  83     hihat4 hh bassdrum bd
  84   }
  85 }
  86 @end lilypond
  87
  88 Each piece of percussion has a full name and an abbreviated name,
  89 and both can be used in input files.  The full list of percussion
  90 note names may be found in @ref{Percussion notes}.
  91
  92 @cindex clef, percussion
  93 @cindex percussion clef
  94
  95 Note that the normal notation of pitches (such as @code{cis4}) in a
  96 @code{DrumStaff} context will cause an error message.  Percussion clefs
  97 are added automatically to a @code{DrumStaff} context but they can also
  98 be set explicitly.  Other clefs may be used as well.
  99
 100 @lilypond[quote,ragged-right,verbatim]
 101 \drums {
 102   \clef percussion
 103   bd4 4 4 4
 104   \clef treble
 105   hh4 4 4 4
 106 }
 107 @end lilypond
 108
 109
 110 There are a few issues concerning MIDI support for percussion
 111 instruments; for details please see @ref{Percussion in MIDI}.
 112
 113 @seealso
 114 Notation Reference:
 115 @ref{Percussion in MIDI},
 116 @ref{Percussion notes}.
 117
 118 Installed Files:
 119 @file{ly/drumpitch-init.ly}.
 120
 121 Snippets:
 122 @rlsr{Percussion}.
 123
 124
 125 @node Drum rolls
 126 @unnumberedsubsubsec Drum rolls
 127
 128 Drum rolls are indicated with three slashes across the stem.  For
 129 quarter notes or longer the three slashes are shown explicitly,
 130 eighth notes are shown with two slashes (the beam being the
 131 third), and drum rolls shorter than eighths have one stem slash to
 132 supplement the beams.  This is achieved with the tremolo notation,
 133 as described in @ref{Tremolo repeats}.
 134
 135 @lilypond[quote,verbatim]
 136 \drums {
 137   \time 2/4
 138   sn16 8 16 8 8:32 ~
 139   8 8 4:32 ~
 140   4 8 16 16
 141   4 r4
 142 }
 143 @end lilypond
 144
 145 Sticking can be indicated by placing a markup for @code{"R"}
 146 or @code{"L"} above or below notes, as discussed in
 147 @ref{Direction and placement}.  The @code{staff-padding} property
 148 may be overridden to achieve a pleasing baseline.
 149
 150 @lilypond[quote,verbatim]
 151 \drums {
 152   \repeat unfold 2 {
 153     sn16^"L" 16^"R" 16^"L" 16^"L" 16^"R" 16^"L" 16^"R" 16^"R"
 154     \stemUp
 155     sn16_"L" 16_"R" 16_"L" 16_"L" 16_"R" 16_"L" 16_"R" 16_"R"
 156   }
 157 }
 158 @end lilypond
 159
 160 @seealso
 161 Notation Reference:
 162 @ref{Tremolo repeats}.
 163
 164 Snippets:
 165 @rlsr{Percussion}.
 166
 167
 168 @node Pitched percussion
 169 @unnumberedsubsubsec Pitched percussion
 170
 171 Certain pitched percussion instruments (e.g. xylophone,
 172 vibraphone, and timpani) are written using normal staves.
 173 This is covered in other sections of the manual.
 174
 175 @seealso
 176 @c TODO: possibly link to an alternate section of NR 3.5, if
 177 @c "percussion in MIDI" gets a separate subsubsection for
 178 @c pitched percussion sounds.  -gp
 179 Notation Reference:
 180 @ref{Percussion in MIDI}.
 181
 182 Snippets:
 183 @rlsr{Percussion}.
 184
 185
 186 @node Percussion staves
 187 @unnumberedsubsubsec Percussion staves
 188
 189 @cindex percussion
 190 @cindex drums
 191
 192 A percussion part for more than one instrument typically uses a
 193 multiline staff where each position in the staff refers to one
 194 piece of percussion.  To typeset the music, the notes must be
 195 interpreted in @code{DrumStaff} and @code{DrumVoice} context.
 196
 197 @lilypond[quote,verbatim]
 198 up = \drummode {
 199   crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat
 200 }
 201 down = \drummode {
 202   bassdrum4 snare8 bd r bd sn4
 203 }
 204 \new DrumStaff <<
 205   \new DrumVoice { \voiceOne \up }
 206   \new DrumVoice { \voiceTwo \down }
 207 >>
 208 @end lilypond
 209
 210 The above example shows verbose polyphonic notation.  The short
 211 polyphonic notation, described in @rlearning{I'm hearing Voices},
 212 can also be used.
 213 For example,
 214
 215 @lilypond[quote,verbatim]
 216 \new DrumStaff <<
 217   \drummode {
 218     bd4 sn4 bd4 sn4
 219     << {
 220       \repeat unfold 16 hh16
 221     } \\ {
 222       bd4 sn4 bd4 sn4
 223     } >>
 224   }
 225 >>
 226 @end lilypond
 227
 228 There are also other layout possibilities.  To use these, set the
 229 property @code{drumStyleTable} in context @code{DrumVoice}.  The
 230 following variables have been predefined:
 231
 232 @c TODO: decide what to do about this table.  (ie verbatim or not)
 233 @table @code
 234
 235 @item drums-style
 236 This is the default.  It typesets a typical drum kit on a
 237 five-line staff:
 238
 239 @lilypond[quote,line-width=10.0\cm]
 240 nam = \lyricmode {
 241   cymc cyms cymr hh hhc hho hhho hhp
 242   cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
 243 mus = \drummode {
 244   cymc cyms cymr hh hhc hho hhho hhp \break
 245   cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
 246 \score {
 247   << \new DrumStaff \with {
 248        \remove "Bar_engraver"
 249        \remove "Time_signature_engraver"
 250        \hide Stem
 251        \override Stem.Y-extent = ##f
 252      } \mus
 253      \new Lyrics \nam
 254   >>
 255   \layout {
 256     \context {
 257       \Score
 258       \override LyricText.font-family = #'typewriter
 259       \override BarNumber.transparent =##T
 260     }
 261   }
 262 }
 263 @end lilypond
 264
 265 The drum scheme supports six different toms.  When there are fewer
 266 toms, simply select the toms that produce the desired result.  For
 267 example, to get toms on the three middle lines you use
 268 @code{tommh}, @code{tomml}, and @code{tomfh}.
 269
 270 @item timbales-style
 271 This typesets timbales on a two line staff:
 272
 273 @lilypond[quote,ragged-right]
 274 nam = \lyricmode { timh ssh timl ssl cb }
 275 mus = \drummode { timh ssh timl ssl cb s16 }
 276
 277 <<
 278   \new DrumStaff \with {
 279     \remove "Bar_engraver"
 280     \remove "Time_signature_engraver"
 281     \hide Stem
 282     \override Stem.Y-extent = ##f
 283     \override StaffSymbol.line-count = #2
 284     \override StaffSymbol.staff-space = #2
 285     \override VerticalAxisGroup.minimum-Y-extent = #'(-3.0 . 4.0)
 286     drumStyleTable = #timbales-style
 287   } \mus
 288   \new Lyrics {
 289     \override LyricText.font-family = #'typewriter
 290     \nam
 291   }
 292 >>
 293 @end lilypond
 294
 295 @item congas-style
 296 This typesets congas on a two line staff:
 297
 298 @lilypond[quote,ragged-right]
 299 nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
 300 mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
 301
 302 <<
 303   \new DrumStaff \with {
 304     \remove "Bar_engraver"
 305     \remove "Time_signature_engraver"
 306     drumStyleTable = #congas-style
 307     \override StaffSymbol.line-count = #2
 308
 309     %% this sucks; it will lengthen stems.
 310     \override StaffSymbol.staff-space = #2
 311     \hide Stem
 312     \override Stem.Y-extent = ##f
 313   } \mus
 314   \new Lyrics {
 315     \override LyricText.font-family = #'typewriter
 316     \nam
 317   }
 318 >>
 319 @end lilypond
 320
 321 @item bongos-style
 322 This typesets bongos on a two line staff:
 323
 324 @lilypond[quote,ragged-right]
 325 nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
 326 mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
 327
 328 <<
 329   \new DrumStaff \with {
 330     \remove "Bar_engraver"
 331     \remove "Time_signature_engraver"
 332     \override StaffSymbol.line-count = #2
 333     drumStyleTable = #bongos-style
 334
 335     %% this sucks; it will lengthen stems.
 336     \override StaffSymbol.staff-space = #2
 337     \hide Stem
 338     \override Stem.Y-extent = ##f
 339   } \mus
 340   \new Lyrics {
 341     \override LyricText.font-family = #'typewriter
 342     \nam
 343   }
 344 >>
 345 @end lilypond
 346
 347 @item percussion-style
 348 To typeset all kinds of simple percussion on one line staves:
 349
 350 @lilypond[quote,ragged-right]
 351 nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
 352 mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
 353
 354 <<
 355   \new DrumStaff \with{
 356     \remove "Bar_engraver"
 357     drumStyleTable = #percussion-style
 358     \override StaffSymbol.line-count = #1
 359     \remove "Time_signature_engraver"
 360     \hide Stem
 361     \override Stem.Y-extent = ##f
 362   } \mus
 363   \new Lyrics {
 364     \override LyricText.font-family = #'typewriter
 365     \nam
 366   }
 367 >>
 368 @end lilypond
 369 @end table
 370
 371
 372 @node Custom percussion staves
 373 @unnumberedsubsubsec Custom percussion staves
 374
 375 If you do not like any of the predefined lists you can define your
 376 own list at the top of your file.
 377
 378 @lilypond[quote,verbatim]
 379 #(define mydrums '(
 380          (bassdrum        default   #f           -1)
 381          (snare           default   #f           0)
 382          (hihat           cross     #f           1)
 383          (halfopenhihat   cross     "halfopen"   1)
 384          (pedalhihat      xcircle   "stopped"    2)
 385          (lowtom          diamond   #f           3)))
 386 up = \drummode { hh8 hh hhho hhho hhp4 hhp }
 387 down = \drummode { bd4 sn bd toml8 toml }
 388
 389 \new DrumStaff <<
 390   \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 391   \new DrumVoice { \voiceOne \up }
 392   \new DrumVoice { \voiceTwo \down }
 393 >>
 394 @end lilypond
 395
 396
 397 @snippets
 398
 399 @c TODO: MOVE ALL THESE TO LSR!  -gp
 400
 401 Here are some examples:
 402
 403 Two Woodblocks, entered with wbh (high woodblock) and wbl (low woodblock)
 404
 405 @lilypond[quote,verbatim]
 406 % These lines define the position of the woodblocks in the stave;
 407 % if you like, you can change it or you can use special note heads
 408 % for the woodblocks.
 409 #(define mydrums '((hiwoodblock default #t  3)
 410                    (lowoodblock default #t -2)))
 411
 412 woodstaff = {
 413   % This defines a staff with only two lines.
 414   % It also defines the positions of the two lines.
 415   \override Staff.StaffSymbol.line-positions = #'(-2 3)
 416
 417   % This is necessary; if not entered, the barline would be too short!
 418   \override Staff.BarLine.bar-extent = #'(-1.5 . 1.5)
 419 }
 420
 421 \new DrumStaff {
 422   \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 423
 424   % with this you load your new drum style table
 425   \woodstaff
 426
 427   \drummode {
 428     \time 2/4
 429     wbl8 16 16 8-> 8 |
 430     wbl8 16 16-> ~ 16 16 r8 |
 431   }
 432 }
 433 @end lilypond
 434
 435 Note that in this special case the length of the barline must
 436 altered with @code{\override Staff.BarLine.bar-extent #'(from . to)}.
 437 Otherwise it would be too short.  And you have also to define the
 438 positions of the two stafflines.  For more information about these
 439 delicate things have a look at @ref{Staff symbol}.
 440
 441 A tambourine, entered with @q{tamb}:
 442
 443 @lilypond[quote,verbatim]
 444 #(define mydrums '((tambourine default #t 0)))
 445
 446 tambustaff = {
 447   \override Staff.StaffSymbol.line-positions = #'( 0 )
 448   \override Staff.BarLine.bar-extent = #'(-1.5 . 1.5)
 449   \set DrumStaff.instrumentName = #"Tambourine"
 450 }
 451
 452 \new DrumStaff {
 453   \tambustaff
 454   \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 455
 456   \drummode {
 457     \time 6/8
 458     tamb8. 16 8 8 8 8 |
 459     tamb4. 8 8 8 |
 460     % the trick with the scaled duration and the shorter rest
 461     % is neccessary for the correct ending of the trill-span!
 462     tamb2.*5/6 \startTrillSpan s8 \stopTrillSpan |
 463   }
 464 }
 465 @end lilypond
 466
 467 Music for Tam-Tam (entered with @q{tt}):
 468
 469 @lilypond[quote,verbatim]
 470 #(define mydrums '((tamtam default #t 0)))
 471
 472 tamtamstaff = {
 473   \override Staff.StaffSymbol.line-positions = #'( 0 )
 474   \override Staff.BarLine.bar-extent = #'(-1.5 . 1.5)
 475   \set DrumStaff.instrumentName = #"Tamtam"
 476 }
 477
 478 \new DrumStaff {
 479   \tamtamstaff
 480   \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 481
 482   \drummode {
 483     tt 1 \pp \laissezVibrer
 484   }
 485 }
 486 @end lilypond
 487
 488 Two different bells, entered with @q{cb} (cowbell) and @q{rb} (ridebell)
 489
 490 @lilypond[quote,verbatim]
 491 #(define mydrums '((ridebell default #t  3)
 492                    (cowbell  default #t -2)))
 493
 494 bellstaff = {
 495   \override DrumStaff.StaffSymbol.line-positions = #'(-2 3)
 496   \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 497   \override Staff.BarLine.bar-extent = #'(-1.5 . 1.5)
 498   \set DrumStaff.instrumentName = #"Different Bells"
 499 }
 500
 501 \new DrumStaff {
 502   \bellstaff
 503   \drummode {
 504     \time 2/4
 505     rb8 8 cb8 16 rb16-> ~ |
 506     16 8 16 cb8 8 |
 507   }
 508 }
 509 @end lilypond
 510
 511 Here a short example taken from Stravinsky's @q{L'histoire du Soldat}.
 512
 513 @lilypond[quote,verbatim]
 514 #(define mydrums '((bassdrum   default #t  4)
 515                    (snare      default #t -4)
 516                    (tambourine default #t  0)))
 517
 518 global = {
 519   \time 3/8 s4.
 520   \time 2/4 s2*2
 521   \time 3/8 s4.
 522   \time 2/4 s2
 523 }
 524
 525 drumsA = {
 526   \context DrumVoice <<
 527     { \global }
 528     { \drummode {
 529         \autoBeamOff
 530         \stemDown sn8 \stemUp tamb s8 |
 531         sn4 \stemDown sn4 |
 532         \stemUp tamb8 \stemDown sn8 \stemUp sn16 \stemDown sn \stemUp sn8 |
 533         \stemDown sn8 \stemUp tamb s8 |
 534         \stemUp sn4 s8 \stemUp tamb
 535       }
 536     }
 537   >>
 538 }
 539
 540 drumsB = {
 541   \drummode {
 542     s4 bd8 s2*2 s4 bd8 s4 bd8 s8
 543   }
 544 }
 545
 546 \layout {
 547   indent = #40
 548 }
 549
 550 \score {
 551   \new StaffGroup <<
 552     \new DrumStaff {
 553       \set DrumStaff.instrumentName = \markup {
 554         \column {
 555           "Tambourine"
 556           "et"
 557           "caisse claire s. timbre"
 558         }
 559       }
 560       \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 561       \drumsA
 562     }
 563
 564    \new DrumStaff {
 565      \set DrumStaff.instrumentName = #"Grosse Caisse"
 566      \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
 567      \drumsB }
 568   >>
 569 }
 570 @end lilypond
 571
 572 @seealso
 573 Snippets:
 574 @rlsr{Percussion}.
 575
 576 Internals Reference:
 577 @rinternals{DrumStaff},
 578 @rinternals{DrumVoice}.
 579
 580
 581 @c TODO: check name -gp
 582 @node Ghost notes
 583 @unnumberedsubsubsec Ghost notes
 584
 585 Ghost notes for drums and percussion may be created using the
 586 @code{\parenthesize} command detailed in @ref{Parentheses}.
 587
 588 @lilypond[quote,ragged-right,verbatim]
 589 \new DrumStaff
 590 <<
 591   \context DrumVoice  = "1" { s1 }
 592   \context DrumVoice  = "2" { s1 }
 593   \drummode {
 594     <<
 595       {
 596         hh8[ 8] <hh sn> hh16
 597         \parenthesize sn  hh
 598         \parenthesize sn  hh8 <hh sn> hh
 599       } \\
 600       {
 601         bd4 r4 bd8 8 r8 bd
 602       }
 603     >>
 604   }
 605 >>
 606 @end lilypond
 607
 608 @seealso
 609 Snippets:
 610 @rlsr{Percussion}.