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

    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.61"

@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::
* Drum rolls::
* Pitched percussion::
* Percussion staves::
* Custom percussion staves::
* Ghost notes::
@end menu

@node References for percussion
@unnumberedsubsubsec References for percussion

@itemize

@item
La notación de algunas percusiones se puede hacer sobre una pauta de
ritmo; esto se estudia en @ref{Showing melody rhythms} y
@ref{Instantiating new staves}.

@item
La salida MIDI se trata en una sección aparte; véase @ref{Percussion
in MIDI}.

@end itemize

@seealso

Referencia de la notación:
@ref{Showing melody rhythms},
@ref{Instantiating new staves}.
@ref{Percussion in MIDI}.

Fragmentos de código:
@rlsr{Percussion}.


@node Basic percussion notation
@unnumberedsubsubsec 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.  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,verbatim]
\drums {
  hihat4 hh bassdrum bd
}
@end lilypond

Esto es una abreviatura de

@lilypond[quote,verbatim]
\new DrumStaff {
  \drummode {
    hihat4 hh bassdrum bd
  }
}
@end lilypond

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 lista
completa de nombre de instrumentos de percusión se encuentra en
@ref{Percussion notes}.

Observe que la notación normal de las notas con altura determinada
(como @code{cis4}) en un contexto @code{DrumStaff} procuden un mensaje
de error.  Las claves de percusión se añaden automáticamente al
contexto @code{DrumStaff}, pero también se pueden usar otras claves.

Hay ciertos detalles respecto a cómo está contemplado el MIDI para los
instrumentos de percusión; para ver los detalles consulte
@ref{Percussion in MIDI}.

@seealso

Referencia de la notación:
@ref{Percussion in MIDI},
@ref{Percussion notes}.

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

Fragmentos de código:
@rlsr{Percussion}.


@node Drum rolls
@unnumberedsubsubsec Drum rolls

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,verbatim]
\drums {
  \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.

@lilypond[quote,verbatim]
\drums {
  \repeat unfold 2 {
    sn16 ^"L" sn^"R" sn^"L" sn^"L" sn^"R" sn^"L"  sn^"R" sn^"R"
  }
}
@end lilypond

@seealso

Fragmentos de código:
@rlsr{Percussion}.


@node Pitched percussion
@unnumberedsubsubsec Pitched percussion

Ciertos instrumentos de percusión de altura determinada (p.ej.: el
xilófono, el vibráfono y los timbales) se escriben usando pentagramas
normales.  Esto se estudia en otras secciones del manual.

@seealso

@c TODO: possibly link to an alternate section of NR 3.5, if
@c "percussion in MIDI" gets a separate subsubsection for
@c pitched percussion sounds.  -gp

Referencia de la notación:
@ref{Percussion in MIDI}.

Fragmentos de código:
@rlsr{Percussion}.


@node Percussion staves
@unnumberedsubsubsec 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,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 voces se instancian primero a
mano.  Por ejemplo,

@lilypond[quote,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
pentagrama:

@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


@node Custom percussion staves
@unnumberedsubsubsec Custom percussion staves

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

@lilypond[quote,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

@snippets

@c FIXME: MOVE ALL THESE TO LSR!  -gp

He aquí algunos ejemplos adicionales:

Dos bloques de madera, escritos con wbh (@emph{woodblock-high}, bloque
alto) y wbl (@emph{woodblock-low} bloque bajo)

@lilypond[quote,verbatim]
% These lines define the position of the woodblocks in the stave;
% if you like, you can change it or you can use special note heads
% for the woodblocks.
#(define mydrums '((hiwoodblock default #t  3)
                   (lowoodblock default #t -2)))

woodstaff = {
  % This defines a staff with only two lines.
  % It also defines the positions of the two lines.
  \override Staff.StaffSymbol #'line-positions = #'(-2 3)

  % This is neccessary; if not entered, the barline wuld be too short!
  \override Staff.BarLine #'bar-size = #3
}

\new DrumStaff {
  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)

  % with this you load your new drum style table
  \woodstaff

  \drummode {
    \time 2/4
    wbl8 wbl16 wbl wbh8-> wbl |
    wbl8 wbl16 wbh-> ~ wbh wbl16 r8 |
  }
}
@end lilypond

Observe que en este caso especial se debe alterar la longitud de la
línea divisoria con @code{\override Staff.BarLine #'bar-size #number}.
En caso contrario resulta demasiado corta.  También debe definir las
posiciones de las dos líneas del pentagrama.  Para más información
sobre estos delicados asuntos, consulte @ref{Staff symbol}.

Una pandereta, escrita mediante @q{tamb} (@emph{tambourine}:

@lilypond[quote,verbatim]
tambustaff = {
  \override Staff.StaffSymbol #'line-positions = #'( 0 )
  \override Staff.BarLine #'bar-size = #3
  \set DrumStaff.instrumentName = "Tambourine"
}

\new DrumStaff {
  \tambustaff
  % broken
  % \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)

  \drummode {
    \time 6/8
    \repeat "unfold" 2 { tamb8. tamb16 tamb8 tamb tamb tamb | }
    tamb4. tamb8 tamb tamb |
    % the trick with the scaled duration and the shorter rest
    % is neccessary for the correct ending of the trill-span!
    tamb2.*5/6 \startTrillSpan s8 \stopTrillSpan |
  }
}
@end lilypond

Música para gong, introducida con @q{tt} (tam-tam):

@lilypond[quote,verbatim]
#(define mydrums '((tamtam default #t 0)))

tamtamstaff = {
  \override Staff.StaffSymbol #'line-positions = #'( 0 )
  \override Staff.BarLine #'bar-size = #3
  \set DrumStaff.instrumentName = "Tamtam"
}

\new DrumStaff {
  \tamtamstaff
  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)

  \drummode {
    tt 1 \pp \laissezVibrer
  }
}
@end lilypond

Dos campanas, introducidas con @q{cb} (@emph{cowbell}, cencerro) y
@q{rb} (@emph{ridebell}, campana normal)

@lilypond[quote,verbatim]
#(define mydrums '((ridebell default #t  3)
                   (cowbell  default #t -2)))

bellstaff = {
  \override DrumStaff.StaffSymbol #'line-positions = #'(-2 3)
  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
  \override Staff.BarLine #'bar-size = #3
  \set DrumStaff.instrumentName = "Different Bells"
}

\new DrumStaff {
  \bellstaff
  \drummode {
    \time 2/4
    \repeat "unfold" 2 { rb8 rb cb cb16 rb-> ~ |
                         rb16 rb8 rb16 cb8 cb | }
  }
}
@end lilypond

Aquí un breve ejemplo del maestro Stravinsky (procedende de la
@q{Historia del soldado})

@lilypond[quote,verbatim]
#(define mydrums '((bassdrum   default #t  4)
                   (snare      default #t -4)
                   (tambourine default #t  0)))

global = {
  \time 3/8 s4.
  \time 2/4 s2*2
  \time 3/8 s4.
  \time 2/4 s2
}

drumsA = {
  \context DrumVoice <<
    { \global }
    { \drummode {
        \autoBeamOff
        \stemDown sn8 \stemUp tamb s8 |
        sn4 \stemDown sn4 |
        \stemUp tamb8 \stemDown sn8 \stemUp sn16 \stemDown sn \stemUp sn8 |
        \stemDown sn8 \stemUp tamb s8 |
        \stemUp sn4 s8 \stemUp tamb
      }
    }
  >>
}

drumsB = {
  \drummode {
    s4 bd8 s2*2 s4 bd8 s4 bd8 s8
  }
}

\layout {
  indent = #40
}

\score {
  \new StaffGroup <<
    \new DrumStaff {
      \set DrumStaff.instrumentName = \markup {
        \column {
          "Tambourine"
          "et"
          "caisse claire s. timbre"
        }
      }
      \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
      \drumsA
    }

   \new DrumStaff {
     \set DrumStaff.instrumentName = "Grosse Caisse"
     \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
     \drumsB }
  >>
}
@end lilypond

@seealso

Fragmentos de código:
@rlsr{Percussion}.

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


@c FIXME: check name -gp
@node Ghost notes
@unnumberedsubsubsec 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}.

@seealso

Fragmentos de código:
@rlsr{Percussion}.
