@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond.tely
@ignore
    Translation of GIT committish: 223846f933f47587fd0403e1a75cc1776990a785

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  See TRANSLATION for details.
@end ignore

@c \version "2.11.51"

@node Percussion
@section Percussion

@menu
* Common notation for percussion::
@end menu

@node Common notation for percussion
@subsection Common notation for percussion

La notación rítmica se emplea primordialmente para la percusión y la batería, pero también
se puede utilizar para mostrar los valores rítmicos una melodía.

@menu
* References for percussion::
* Basic percussion notation::
* Percussion staves::
* Ghost notes::
@end menu

@node References for percussion
@subsubsection References for percussion

@untranslated


@node Basic percussion notation
@subsubsection Basic percussion notation

@cindex percusión
@cindex batería


Las notas de percusión se pueden escribir en el modo @code{\drummode},
que es similar al modo estándar para introducir notas.  Cada elemento
de un set de percusión lleva un nombre completo y un nombre abreviado,
y los dos se pueden usar en la entrada.  La manera más fácil de
escribir notas de percusión es utilizar la instrucción @code{\drums},
que crea el contexto y el modo de entrada apropiados para percusión:

@lilypond[quote,ragged-right,verbatim]
\drums {
  hihat hh bassdrum bd
}
@end lilypond

Esto es una abreviatura de

@lilypond[quote,ragged-right,verbatim]
\new DrumStaff
\drummode {
  hihat hh bassdrum bd
}
@end lilypond



La lista completa de nombre de instrumentos de percusión se encuentra en el archivo de inicio
@file{ly/@/drumpitch@/-init@/.ly}.
@c TODO: properly document this.

Los redobles se indican mediante tres barras cruzadas en la plica.
Para las negras o notas más largas, las tres barras se muestran
explícitamente, las corcheas se presentan con dos barras cruzadas
(siendo la barra de corchea la tercera), y los redobles más breves que
las corcheas tienen una barra cruzada para complementar las barras
normales.  Esto se consigue mediante la notación de trémolo,
@code{:32}, véase @ref{Tremolo repeats}.  He aquí un ejemplo de
redobles de caja:

@lilypond[quote,ragged-right,verbatim]
\new DrumStaff
\drummode {
  \time 2/4
  sn16 sn8 sn16 sn8 sn8:32~ |
  sn8 sn8 sn4:32~ |
  sn4 sn8 sn16 sn16 |
  sn4 r4 |
}
@end lilypond

Los golpes de baqueta se pueden indicar mediante la colocación de
@code{^"R"} o @code{^"L"} después de la nota.  La propiedad
@code{staff-padding} se puede sobreescribir para conseguir una línea
de base satisfactoria.

@c TODO Add example of sticking

@seealso

Referencia del programa:
@rinternals{note-event}.

@node Percussion staves
@subsubsection Percussion staves
@cindex percusión
@cindex batería

Una parte de percusión para más de un instrumento, normalmente utiliza
una pauta de varias líneas donde cada posición dentro de la pauta se
refiere a un elemento de percusión.


Para tipografiar la música, se deben interpretar las notas dentro de
los contextos @rinternals{DrumStaff} y @rinternals{DrumVoice}

@lilypond[quote,ragged-right,verbatim]
up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
down = \drummode { bassdrum4 snare8 bd r bd sn4 }
  \new DrumStaff <<
    \new DrumVoice { \voiceOne \up }
    \new DrumVoice { \voiceTwo \down }
  >>
@end lilypond

El ejemplo anterior muestra una notación polifónica prolija.  La
notación polifónica abreviada, descrita en @rlearning{I'm hearing
Voices}, también se puede usar si las @rinternals{DrumVoice}s se
instancian primero a mano.  Por ejemplo,

@lilypond[quote,ragged-right,fragment,verbatim]
\new DrumStaff <<
  \new DrumVoice = "1" { s1 *2 }
  \new DrumVoice = "2" { s1 *2 }
  \drummode {
    bd4 sn4 bd4 sn4
    <<
      { \repeat unfold 16 hh16 }
      \\
      { bd4 sn4 bd4 sn4 }
    >>
  }
>>
@end lilypond


También existen otras posibilidades en lo referente a la disposición.
Para usarlas, establezca la propiedad @code{drumStyleTable} en el
contexto @rinternals{DrumVoice}.  Se han predefinido las siguientes
variables:

@table @code
@item drums-style
Es la opción por defecto.  Tipografía un típico set de percusión sobre
una pauta de cinco líneas

@lilypond[quote,line-width=10.0\cm]
nam = \lyricmode {
  cymc cyms cymr hh hhc hho hhho hhp
  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
mus = \drummode {
  cymc cyms cymr hh hhc hho hhho hhp \break
  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
\score {
  << \new DrumStaff \with {
       \remove Bar_engraver
       \remove Time_signature_engraver
       \override Stem #'transparent = ##t
       \override Stem #'Y-extent-callback = ##f
       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
     } \mus
     \new Lyrics \nam
  >>
  \layout {
    \context {
      \Score
      \override LyricText #'font-family = #'typewriter
      \override BarNumber #'transparent =##T
    }
  }
}
@end lilypond

El esquema de percusión contempla seis tambores graves (toms)
distintos.  Cuando haya menos toms, sencillamente seleccione aquellos
que producen el resultado deseado, es decir, para tener toms en las
tres líneas centrales utilizará @code{tommh}, @code{tomml} y
@code{tomfh}.

@item timbales-style
Esto tipografía timbales en una pauta de dos líneas:

@lilypond[quote,ragged-right]
nam = \lyricmode { timh ssh timl ssl cb }
mus = \drummode { timh ssh timl ssl cb s16 }

<<
  \new DrumStaff \with {
    \remove Bar_engraver
    \remove Time_signature_engraver
    \override Stem #'transparent = ##t
    \override Stem #'Y-extent-callback = ##f
    \override StaffSymbol #'line-count = #2
    \override StaffSymbol #'staff-space = #2
    \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
    drumStyleTable = #timbales-style
  } \mus
  \new Lyrics {
    \override LyricText #'font-family = #'typewriter
    \nam
  }
>>
@end lilypond

@item congas-style
Esto tipografía congas en una pauta de dos líneas:

@lilypond[quote,ragged-right]
nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }

<<
  \new DrumStaff \with {
    \remove Bar_engraver
    \remove Time_signature_engraver
    drumStyleTable = #congas-style
    \override StaffSymbol #'line-count = #2

    %% this sucks; it will lengthen stems.
    \override StaffSymbol #'staff-space = #2
    \override Stem #'transparent = ##t
    \override Stem #'Y-extent-callback = ##f
  } \mus
  \new Lyrics {
    \override LyricText #'font-family = #'typewriter
    \nam
  }
>>
@end lilypond

@item bongos-style
Esto tipografía bongos sobre una pauta de dos líneas:

@lilypond[quote,ragged-right]
nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }

<<
  \new DrumStaff \with {
    \remove Bar_engraver
    \remove Time_signature_engraver
    \override StaffSymbol #'line-count = #2
    drumStyleTable = #bongos-style

    %% this sucks; it will lengthen stems.
    \override StaffSymbol #'staff-space = #2
    \override Stem #'transparent = ##t
    \override Stem #'Y-extent-callback = ##f
  } \mus
  \new Lyrics {
    \override LyricText #'font-family = #'typewriter
    \nam
  }
>>
@end lilypond

@item percussion-style
Para tipografiar toda clase de percusiones simples sobre pautas de una
línea.

@lilypond[quote,ragged-right]
nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }

<<
  \new DrumStaff \with{
    \remove Bar_engraver
    drumStyleTable = #percussion-style
    \override StaffSymbol #'line-count = #1
    \remove Time_signature_engraver
    \override Stem #'transparent = ##t
    \override Stem #'Y-extent-callback = ##f
  } \mus
  \new Lyrics {
    \override LyricText #'font-family = #'typewriter
    \nam
  }
>>
@end lilypond
@end table

Si no le gusta ninguna de las listas predefinidas, puede definir su
propia lista al principio de su archivo

@lilypond[quote,ragged-right,verbatim]
#(define mydrums '(
         (bassdrum     default   #f         -1)
         (snare        default   #f         0)
         (hihat        cross     #f         1)
         (pedalhihat   xcircle   "stopped"  2)
         (lowtom       diamond   #f         3)))
up = \drummode { hh8 hh hh hh hhp4 hhp }
down = \drummode { bd4 sn bd toml8 toml }

\new DrumStaff <<
  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
  \new DrumVoice { \voiceOne \up }
  \new DrumVoice { \voiceTwo \down }
>>
@end lilypond


@seealso

Archivos de inicio:
@file{ly/@/drumpitch@/-init@/.ly}.

Referencia de funcionamiento interno:
@rinternals{DrumStaff},
@rinternals{DrumVoice}.

@knownissues

A causa de que el estándar General MIDI no contiene golpes de aro (rim
shot), para este propósito se usa el golpe lateral de baqueta
(sidestick) en su lugar.


@c FIXME: check name -gp
@node Ghost notes
@subsubsection Ghost notes

Las notas fantasma para la batería e instrumentos de percusión se
pueden crear utilizando la instrucción @code{\parenthesize} detallada
en @ref{Parentheses}.  Sin embargo, el modo por defecto
@code{\drummode} no incluye el complemento grabador
@code{Parenthesis_engraver} que permite esto.


@lilypond[quote,ragged-right,verbatim,fragment]
\new DrumStaff \with {
  \consists "Parenthesis_engraver"
} <<
  \context DrumVoice  = "1"  { s1 *2 }
  \context DrumVoice  = "2" { s1 *2 }
  \drummode {
    <<
      {
        hh8[ hh] <hh sn> hh16
        < \parenthesize sn > hh < \parenthesize
        sn > hh8 <hh sn> hh
      } \\ {
        bd4 r4 bd8 bd r8 bd
      }
    >>
  }
>>
@end lilypond

@noindent
Observe, además, que debe añadir acordes (paréntesis en ángulo @code{<
>}) alrededor de cada una de las instrucciones @code{\parenthesize}.