@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-

@ignore
    Translation of GIT committish: 26a079ca2393d053315ef8dbef626c897dc9645a

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
    Guide, node Updating translation committishes..
@end ignore

@c \version "2.16.0"

@node Percusión
@section Percusión
@translationof Percussion

@menu
* Notación común para percusión::
@end menu


@node Notación común para percusión
@subsection Notación común para percusión
@translationof 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
* Referencias para percusión::
* Notación básica de percusión::
* Redobles::
* Percusión afinada::
* Pautas de percusión::
* Pautas de percusión personalizadas::
* Notas fantasma::
@end menu


@node Referencias para percusión
@unnumberedsubsubsec Referencias para percusión
@translationof References for percussion

@c TODO add more references.

@itemize

@item
La notación de algunas percusiones se puede hacer sobre una pauta de
ritmo; esto se estudia en @ref{Mostrar los ritmos de la melodía} y
@ref{Crear instancias de pentagramas nuevos}.

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

@end itemize

@seealso
Referencia de la notación:
@ref{Mostrar los ritmos de la melodía},
@ref{Crear instancias de pentagramas nuevos}.
@ref{Percusión en MIDI}.

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


@node Notación básica de percusión
@unnumberedsubsubsec Notación básica de percusión
@translationof 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{Notas de percusión}.

@cindex clave de percusión
@cindex percusión, clave

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

@lilypond[quote,ragged-right,verbatim]
\drums {
  \clef percussion
  bd4 bd bd bd
  \clef treble
  hh4 hh hh hh
}
@end lilypond


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

@seealso
Referencia de la notación:
@ref{Percusión en MIDI},
@ref{Notas de percusión}.

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

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


@node Redobles
@unnumberedsubsubsec Redobles
@translationof 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,
véase @ref{Repeticiones de trémolo}.

@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
los elementos de marcado @code{"R"} o @code{"L"} encima o debajo de
las notas, como se estudia en @ref{Dirección y posición}. 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"
    \stemUp
    sn16_"L" sn_"R" sn_"L" sn_"L" sn_"R" sn_"L" sn_"R" sn_"R"
  }
}
@end lilypond

@seealso
Referencia de la notación:
@ref{Repeticiones de trémolo}.

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


@node Percusión afinada
@unnumberedsubsubsec Percusión afinada
@translationof 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{Percusión en MIDI}.

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


@node Pautas de percusión
@unnumberedsubsubsec Pautas de percusión
@translationof 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{Oigo voces},
también se puede usar.  Por ejemplo,

@lilypond[quote,verbatim]
\new DrumStaff <<
  \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 Flag #'transparent = ##t
       \override Stem #'Y-extent = ##f
     } \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 Flag #'transparent = ##t
    \override Stem #'Y-extent = ##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 Flag #'transparent = ##t
    \override Stem #'Y-extent = ##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 Flag #'transparent = ##t
    \override Stem #'Y-extent = ##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 Flag #'transparent = ##t
    \override Stem #'Y-extent = ##f
  } \mus
  \new Lyrics {
    \override LyricText #'font-family = #'typewriter
    \nam
  }
>>
@end lilypond
@end table


@node Pautas de percusión personalizadas
@unnumberedsubsubsec Pautas de percusión personalizadas
@translationof 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)
         (halfopenhihat   cross     "halfopen"   1)
         (pedalhihat      xcircle   "stopped"    2)
         (lowtom          diamond   #f           3)))
up = \drummode { hh8 hh hhho hhho 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 necessary; if not entered, the barline would be too short!
  \override Staff.BarLine #'bar-extent = #'(-1.5 . 1.5)
}

\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-extent #'(de . a)}.
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{El símbolo del pentagrama}.

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

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

tambustaff = {
  \override Staff.StaffSymbol #'line-positions = #'( 0 )
  \override Staff.BarLine #'bar-extent = #'(-1.5 . 1.5)
  \set DrumStaff.instrumentName = #"Tambourine"
}

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

  \drummode {
    \time 6/8
    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-extent = #'(-1.5 . 1.5)
  \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-extent = #'(-1.5 . 1.5)
  \set DrumStaff.instrumentName = #"Different Bells"
}

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

Aquí un breve ejemplo procedente de la @q{Historia del soldado} de
Stravinsky:

@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 Notas fantasma
@unnumberedsubsubsec Notas fantasma
@translationof 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{Paréntesis}.  Sin embargo, el modo por defecto
@code{\drummode} no incluye el complemento grabador
@code{Parenthesis_engraver} que permite esto.

@lilypond[quote,ragged-right,verbatim]
\new DrumStaff \with {
  \consists "Parenthesis_engraver"
}
<<
  \context DrumVoice  = "1" { s1 }
  \context DrumVoice  = "2" { s1 }
  \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}.