X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fuser%2Fpercussion.itely;h=846b6d4d0989589f6ace4c6a23f18c509d62fc9a;hb=1423508c355989fa26a8cfe5985b0d6e1ab0a538;hp=dda41290ef86186a3fcd1e1e721fa3da9ac4f109;hpb=de451af43aef0220738bfdd5329f0685bdaba3d2;p=lilypond.git

diff --git a/Documentation/es/user/percussion.itely b/Documentation/es/user/percussion.itely
index dda41290ef..846b6d4d09 100644
--- a/Documentation/es/user/percussion.itely
+++ b/Documentation/es/user/percussion.itely
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 223846f933f47587fd0403e1a75cc1776990a785
+    Translation of GIT committish: 41ef91786a08102d9b9a839f6a2f40cec263d723
 
     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"
+@c \version "2.12.0"
 
 @node Percussion
 @section Percussion
@@ -19,20 +19,45 @@
 @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.
+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
 
-@untranslated
+@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
@@ -41,34 +66,57 @@ se puede utilizar para mostrar los valores rítmicos una melodía.
 @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:
+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,ragged-right,verbatim]
+@lilypond[quote,verbatim]
 \drums {
-  hihat hh bassdrum bd
+  hihat4 hh bassdrum bd
 }
 @end lilypond
 
 Esto es una abreviatura de
 
-@lilypond[quote,ragged-right,verbatim]
-\new DrumStaff
-\drummode {
-  hihat hh bassdrum bd
+@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} producen 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}.
 
-La lista completa de nombre de instrumentos de percusión se encuentra en el archivo de inicio
+Archivos de inicio:
 @file{ly/@/drumpitch@/-init@/.ly}.
-@c TODO: properly document this.
+
+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
@@ -79,14 +127,13 @@ 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 {
+@lilypond[quote,verbatim]
+\drums {
   \time 2/4
-  sn16 sn8 sn16 sn8 sn8:32~ |
-  sn8 sn8 sn4:32~ |
-  sn4 sn8 sn16 sn16 |
-  sn4 r4 |
+  sn16 sn8 sn16 sn8 sn8:32 ~
+  sn8 sn8 sn4:32 ~
+  sn4 sn8 sn16 sn16
+  sn4 r4
 }
 @end lilypond
 
@@ -95,65 +142,94 @@ Los golpes de baqueta se pueden indicar mediante la colocación de
 @code{staff-padding} se puede sobreescribir para conseguir una línea
 de base satisfactoria.
 
-@c TODO Add example of sticking
+@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
+@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}.
 
-Referencia del programa:
-@rinternals{note-event}.
 
 @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}
+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 }
-  >>
+@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 @rinternals{DrumVoice}s se
-instancian primero a mano.  Por ejemplo,
+Voices}, también se puede usar si las voces se instancian primero a
+mano.  Por ejemplo,
 
-@lilypond[quote,ragged-right,fragment,verbatim]
+@lilypond[quote,verbatim]
 \new DrumStaff <<
-  \new DrumVoice = "1" { s1 *2 }
-  \new DrumVoice = "2" { s1 *2 }
+  \new DrumVoice = "1" { s1*2 }
+  \new DrumVoice = "2" { s1*2 }
   \drummode {
     bd4 sn4 bd4 sn4
-    <<
-      { \repeat unfold 16 hh16 }
-      \\
-      { 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
+pentagrama:
 
 @lilypond[quote,line-width=10.0\cm]
 nam = \lyricmode {
@@ -167,7 +243,7 @@ mus = \drummode {
        \remove Bar_engraver
        \remove Time_signature_engraver
        \override Stem #'transparent = ##t
-       \override Stem #'Y-extent-callback = ##f
+       \override Stem #'Y-extent = ##f
        \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
      } \mus
      \new Lyrics \nam
@@ -200,7 +276,7 @@ mus = \drummode { timh ssh timl ssl cb s16 }
     \remove Bar_engraver
     \remove Time_signature_engraver
     \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
+    \override Stem #'Y-extent = ##f
     \override StaffSymbol #'line-count = #2
     \override StaffSymbol #'staff-space = #2
     \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
@@ -230,7 +306,7 @@ mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
     %% this sucks; it will lengthen stems.
     \override StaffSymbol #'staff-space = #2
     \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
+    \override Stem #'Y-extent = ##f
   } \mus
   \new Lyrics {
     \override LyricText #'font-family = #'typewriter
@@ -256,7 +332,7 @@ mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
     %% this sucks; it will lengthen stems.
     \override StaffSymbol #'staff-space = #2
     \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
+    \override Stem #'Y-extent = ##f
   } \mus
   \new Lyrics {
     \override LyricText #'font-family = #'typewriter
@@ -267,7 +343,7 @@ mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
 
 @item percussion-style
 Para tipografiar toda clase de percusiones simples sobre pautas de una
-línea.
+línea:
 
 @lilypond[quote,ragged-right]
 nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
@@ -280,7 +356,7 @@ mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
     \override StaffSymbol #'line-count = #1
     \remove Time_signature_engraver
     \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
+    \override Stem #'Y-extent = ##f
   } \mus
   \new Lyrics {
     \override LyricText #'font-family = #'typewriter
@@ -290,10 +366,14 @@ mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
 @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,ragged-right,verbatim]
+@lilypond[quote,verbatim]
 #(define mydrums '(
          (bassdrum     default   #f         -1)
          (snare        default   #f         0)
@@ -310,22 +390,194 @@ down = \drummode { bd4 sn bd toml8 toml }
 >>
 @end lilypond
 
+@snippets
 
-@seealso
+@c FIXME: MOVE ALL THESE TO LSR!  -gp
 
-Archivos de inicio:
-@file{ly/@/drumpitch@/-init@/.ly}.
+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 would 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]
+#(define mydrums '((tambourine default #t 0)))
+
+tambustaff = {
+  \override Staff.StaffSymbol #'line-positions = #'( 0 )
+  \override Staff.BarLine #'bar-size = #3
+  \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-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
+    rb8 rb cb cb16 rb-> ~ |
+    rb16 rb8 rb16 cb8 cb |
+  }
+}
+@end lilypond
+
+Aquí un breve ejemplo del maestro Stravinsky (procedente 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}.
 
-@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
@@ -337,20 +589,21 @@ 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 }
+}
+<<
+  \context DrumVoice  = "1" { s1 }
+  \context DrumVoice  = "2" { s1 }
   \drummode {
     <<
       {
         hh8[ hh] <hh sn> hh16
-        < \parenthesize sn > hh < \parenthesize
-        sn > hh8 <hh sn> hh
-      } \\ {
+        < \parenthesize sn > hh
+        < \parenthesize sn > hh8 <hh sn> hh
+      } \\
+      {
         bd4 r4 bd8 bd r8 bd
       }
     >>
@@ -363,3 +616,6 @@ 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}.