Doc-es: update CHANGES and four more chapters of the Notation manual.

[lilypond.git] / Documentation / es / notation / repeats.itely

@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
    Translation of GIT committish: fe2cae0fa47ec4ec0184e6b3d15572fbcba881cf

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

@node Repeticiones
@section Repeticiones
@translationof Repeats

@lilypondfile[quote]{repeats-headword.ly}

La repetición es un concepto fundamental en música, y existen varios
tipos de notación para las repeticiones.  LilyPond contempla los
siguientes tipos de repetición:

@table @code
@item volta (primera y segunda vez)
La repetición de la música no se imprime de forma desarrollada, sino
que se indica encerrándola entre barras de repetición.  Si el salto de
la repetición se encuentra al comienzo de una pieza, la barra de
repetición sólo se imprime al final del fragmento.  Se imprimen una
serie de finales alternativos (volte) de izquierda a derecha indicados
mediante corchetes.  Ésta es la notación estándar para las
repeticiones con finales alternativos.

@item unfold (desplegada)
Las música repetida se escribe y se interpreta completamente tantas
veces como especifique el valor @var{número_de_repeticiones}.  Es útil
cuando se está escribiendo música repetitiva.

@item percent (porcentaje)
Hacer repeticiones de compases o parte de ellos.  Tienen un aspecto
semejante a un signo de porcentaje.  Las repeticiones de porcentaje se
deben declarar dentro de un contexto @code{Voice}.

@item tremolo (trémolo)
Hacer barras de trémolo.

@end table


@menu
* Repeticiones largas::
* Repeticiones cortas::
@end menu

@node Repeticiones largas
@subsection Repeticiones largas
@translationof Long repeats

Esta sección trata sobre la forma de introducir repeticiones largas,
normalmente de varios compases.  Las repeticiones adoptan dos formas:
repeticiones encerradas entre signos de repetición, o repeticiones
explícitas, que se usan para escribir música repetitiva.  También se
pueden controlar manualmente los signos de repetición.

@menu
* Repeticiones normales::
* Marcas de repetición manual::
* Repeticiones explícitas::
@end menu

@cindex repeticiones normales
@cindex repetición con finales alternativos
@cindex finales alternativos
@cindex volta
@cindex prima volta
@cindex primera y segunda vez
@cindex seconda volta
@cindex volta, prima
@cindex volta, seconda
@funindex \repeat
@funindex \alternative
@funindex \partial

@node Repeticiones normales
@unnumberedsubsubsec Repeticiones normales
@translationof Normal repeats

La sintaxis de una repetición normal es

@example
\repeat volta @var{número_de_repeticiones} @var{expresión_musical}
@end example

@noindent
donde @var{expresión_musical} es una expresión musical.

Una repetición simple sin finales alternativos:

@lilypond[verbatim,quote,relative=2]
\repeat volta 2 { c4 d e f }
c2 d
\repeat volta 2 { d4 e f g }
@end lilypond

Los filanes alternativos (casillas de primera y segunda vez)
se pueden generar utilizando @code{\alternative}.  Cada
grupo de alternativas debe,  a su vez, estar encerrado
entre llaves curvas.

@example
\repeat volta @var{número_de_repeticiones} @var{expresión_musical}
\alternative @{
  @{ @var{expresión_musical} @}
@}
@end example

@noindent
donde @var{expresión_musical} es una expresión musical.

Si existen más repeticiones que finales alternativos,
se asigna el primer final alternativo
a las repeticiones más antiguas.

Repetición única con primera y segunda vez:

@lilypond[verbatim,quote,relative=2]
\repeat volta 2 { c4 d e f }
\alternative {
  { c2 e }
  { f2 g }
}
c1
@end lilypond

Repetición única con primera y segunda vez,
con más de un final alternativo:

@lilypond[verbatim,quote,relative=2]
\repeat volta 4 { c4 d e f }
\alternative {
  { c2 e }
  { f2 g }
}
c1
@end lilypond

Más de una repetición con más de un final alternativo:

@lilypond[verbatim,quote,relative=2]
\repeat volta 3 { c4 d e f }
\alternative {
  { c2 e }
  { f2 g }
  { a2 g }
}
c1
@end lilypond

@warning{Si incluimos @code{@bs{}relative} dentro de un
@code{@bs{}repeat} sin instanciar el contexto
@code{Voice} explícitamente,
aparecerán pentagramas adicionales no deseados.
Véase @rprogram{Aparece un pentagrama de más}.}

@cindex repetición con anacrusa
@cindex anacrusa en repeticiones
@funindex \partial


Si una repetición comienza en medio de un compás y no tiene finales
alternativos (primera y segunda vez), normalmente el final de la
repetición también caerá en el medio de un compás, de forma que el
comienzo y el final formen un compás completo.  En tales casos, los
signos de repetición no son verdaderas líneas divisorias.  No utilice
instrucciones @code{\partial} o comprobaciones de compás en los
lugares en que se imprimen estos símbolos de repetición:

@lilypond[verbatim,quote,relative=1]
% no \partial here
c4 e g  % no bar check here
% no \partial here
\repeat volta 4 {
  e4 |
  c2 e |
  % no \partial here
  g4 g g  % no bar check here
}
% no \partial here
g4 |
a2 a |
g1 |
@end lilypond

De forma similar, si una repetición compienza con el compás de
anacrusa inicial de una partitura y no tiene finales alternativos, se
dan las mismas condiciones que en el ejemplo anterior, excepto que en
este caso se necesita la instrucción @code{\partial} al principio de
la partitura:

@lilypond[verbatim,quote,relative=1]
\partial 4  % required
\repeat volta 4 {
  e4 |
  c2 e |
  % no \partial here
  g4 g g  % no bar check here
}
% no \partial here
g4 |
a2 a |
g1 |
@end lilypond

Cuando se añaden primera y segunda vez a una repetición que comienza
con un compás incompleto, se hace necesario establecer la propiedad de
contexto @code{Timing.measureLength} manualmente, en los siguiente
lugares específicos:

@itemize
@item
en el comienzo de los complases incompletos del bloque
@code{\alternative}, que normalmente se producen al final de cada
final alternativo, excepto (en la mayoría de los casos) el último de
ellos.

@item
en el comienzo de cada uno de los finales alternativos, excepto el
primero.
@end itemize

@lilypond[verbatim,quote,relative=1]
\partial 4
\repeat volta 2 { e4 | c2 e | }
\alternative {
  {
    f2 d |
    \set Timing.measureLength = #(ly:make-moment 3 4)
    g4 g g  % optional bar check is allowed here
  }
  {
    \set Timing.measureLength = #(ly:make-moment 4 4)
    a2 a |
  }
}
g1 |
@end lilypond

La propiedad @code{measureLength} se describe en @ref{Gestión del
tiempo}.

@cindex repeticiones con ligaduras
@cindex primera y segunda vez con ligaduras
@cindex ligaduras en las repeticiones
@cindex ligaduras en primera y segunda vez
@funindex \repeatTie

Se pueden añadir ligaduras de unión al segundo final:

@lilypond[verbatim,quote,relative=2]
c1
\repeat volta 2 { c4 d e f~ }
\alternative {
  { f2 d }
  { f2\repeatTie f, }
}
@end lilypond

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{shortening-volta-brackets.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{adding-volta-brackets-to-additional-staves.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{setting-the-double-repeat-default-for-volte.ly}

@seealso
Glosario musical:
@rglos{repeat},
@rglos{volta}.

Referencia de la notación:
@ref{Barras de compás},
@ref{Modificar los complementos (plug-ins) de contexto},
@ref{Gestión del tiempo}.

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

Referencia de funcionamiento interno:
@rinternals{VoltaBracket},
@rinternals{RepeatedMusic},
@rinternals{VoltaRepeatedMusic},
@rinternals{UnfoldedRepeatedMusic}.


@knownissues

@cindex repetición ambigua
@cindex anidada, repetición
@cindex repetición anidada
@cindex repetición, contador de tiempo de la
@cindex repetición y números de compás
@cindex números de compás y repeticiones
@cindex tiempo, repeticiones y contador de
@cindex compás, repeticiones y números de
@cindex repetición y ligadura de expresión
@cindex ligaduras de expresión y repeticiones

Las ligaduras de expresión que abarcan desde un bloque @code{\repeat}
hasta un bloque @code{\alternative} sólo funcionan para la casilla de
primera vez.  Asimismo, no es posible hacer que las ligaduras de
expresión se replieguen desde el final de una alternativa hasta el
comienzo de la repetición.

Si una repetición que comienza con un compás incompleto tiene un
bloque @code{\alternative} que contiene modificaciones a la propiedad
@code{measureLength}, la utilización de @code{\unfoldRepeats} dará
lugar a líneas divisorias erróneamente colocadas y advertencias de
comprobación de compás.

Una repetición anidada como

@example
\repeat @dots{}
\repeat @dots{}
\alternative
@end example

@noindent
es ambigua porque no está claro a qué @code{\repeat} pertenece la
@code{\alternative}.  Esta ambigüedad se resuelve haciendo que la
@code{\alternative} pertenezca siempre a la @code{\repeat} más
interna.  Para más claridad, se recomienda usar llaves en tales
situaciones.


@node Marcas de repetición manual
@unnumberedsubsubsec Marcas de repetición manual
@translationof Manual repeat marks


@cindex manual, marca de repetición
@cindex repetición manual
@cindex comienzo de repetición
@cindex repetición, comienzo de
@cindex final de repetición
@cindex repetición, final de
@cindex repetición, cambiar número de
@cindex repetición, cambiar finales alternativos
@cindex corchete de primera y segunda vez
@funindex repeatCommands
@funindex start-repeat

@warning{Estos métodos sólo se utilizan para realizar construcciones
de repetición poco usuales, y pueden tener un comportamiento distinto
al esperado.  En casi todas las situaciones, se deben crear las
repeticiones utilizando la instrucción estándar @code{@bs{}repeat} o
imprimiendo las barras de compás correspondientes.  Para ver más
información, consulte @ref{Barras de compás}.}

Se puede usar la propiedad @code{repeatCommands} para controlar la
disposición de las repeticiones.  Su valor es una lista de Scheme de
comandos de repetición.

@table @code
@item start-repeat
Imprimir una barra de compás @code{|:}

@lilypond[verbatim,quote,relative=2]
c1
\set Score.repeatCommands = #'(start-repeat)
d4 e f g
c1
@end lilypond

En la práctica habitual del grabado no se imprimen signos de
repetición al principio de la pieza.


@item @code{end-repeat}
Imprimir una barra de compás @code{:|}

@lilypond[verbatim,quote,relative=2]
c1
d4 e f g
\set Score.repeatCommands = #'(end-repeat)
c1
@end lilypond

@item (volta @var{number}) ... (volta #f)
Crear una nueva casilla de repetición con el número que se especifica.
El corchete de vez se debe terminar de forma explícita, pues en caso
contrario no se imprimirá.

@lilypond[verbatim,quote,relative=2]
f4 g a b
\set Score.repeatCommands = #'((volta "2"))
g4 a g a
\set Score.repeatCommands = #'((volta #f))
c1
@end lilypond

@end table

Se pueden producir varias instrucciones de repetición en el mismo
punto:

@lilypond[verbatim,quote,relative=2]
f4 g a b
\set Score.repeatCommands = #'((volta "2, 5") end-repeat)
g4 a g a
c1
\set Score.repeatCommands = #'((volta #f) (volta "95") end-repeat)
b1
\set Score.repeatCommands = #'((volta #f))
@end lilypond

@cindex corchete de casilla de repetición con texto
@cindex texto en casilla de repetición

Se puede incluir texto dentro de la casilla de primera y segunda vez.
El texto puede ser un número o números, o un elemento de marcado,
véase @ref{Formatear el texto}.  La forma más fácil de usar texto de
marcado es definir el marcado previamente, y luego incluirlo dentro de
una lista de Scheme.

@lilypond[verbatim,quote]
voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
\relative c'' {
  c1
  \set Score.repeatCommands = #(list(list 'volta voltaAdLib) 'start-repeat)
  c4 b d e
  \set Score.repeatCommands = #'((volta #f) (volta "4.") end-repeat)
  f1
  \set Score.repeatCommands = #'((volta #f))
}
@end lilypond


@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{printing-a-repeat-sign-at-the-beginning-of-a-piece.ly}


@seealso
Referencia de la notación:
@ref{Barras de compás},
@ref{Formatear el texto}.

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

Referencia de funcionamiento interno:
@rinternals{VoltaBracket},
@rinternals{RepeatedMusic},
@rinternals{VoltaRepeatedMusic}.


@node Repeticiones explícitas
@unnumberedsubsubsec Repeticiones explícitas
@translationof Written-out repeats

@cindex explícitas, repeticiones
@cindex repetitiva, música
@cindex repeticiones explícitas
@cindex repetición desplegada
@cindex desplegar música
@cindex desplegar repetición
@cindex repetición desplegada con finales alternativos
@cindex música desplegada con finales alternativos
@cindex alternativos, finales, en repeticiones explícitas
@funindex unfold

Mediante la utilización de la instrucción @code{unfold} se pueden usar
las repeticiones para simplificar la escritura desplegada de música
repetitiva.  La sintaxis es:

@example
\repeat unfold @var{número_de_repeticiones} @var{expresión_musical}
@end example

@noindent
donde @var{expresión_musical} es una expresión musical y
@var{número_de_repeticiones} es el número de veces que
@var{expresión_musical} se repite.

@lilypond[verbatim,quote,relative=2]
\repeat unfold 2 { c4 d e f }
c1
@end lilypond

Se pueden hacer repeticiones desplegadas con finales alternativos.

@lilypond[verbatim,quote,relative=2]
\repeat unfold 2 { c4 d e f }
\alternative {
  { c2 g' }
  { c,2 b }
}
c1
@end lilypond

Si hay más repeticiones que finales alternativos, el primer final
alternativo se aplica las veces necesarias hasta que
las alternativas restantes completan el número total
de repeticiones.

@lilypond[verbatim,quote,relative=2]
\repeat unfold 4 { c4 d e f }
\alternative {
  { c2 g' }
  { c,2 b }
  { e2 d }
 }
c1
@end lilypond

Si existen más finales alternativos que repeticiones,
se aplican los primeros finales alternativos y LilyPond
ignora las alternativas restantes, que no se imprimen.

@lilypond[verbatim,quote,relative=2]
\repeat unfold 2 { c4 d e f }
\alternative {
  { c2 g' }
  { c,2 b }
  { e2 d }
}
c1
@end lilypond

Es posible también anidar varias funciones
@code{unfold} (con  finales alternativos o sin ellos).

@lilypond[verbatim,quote,relative=2]
\repeat unfold 2 {
  \repeat unfold 2 { c4 d e f }
  \alternative {
    { c2 g' }
    { c,2 b }
  }
}
c1
@end lilypond


@warning{Si pone @code{@bs{}relative} dentro de un bloque
@code{@bs{}repeat} sin instanciar explícitamente el contexto
@code{Voice}, aparecerán pentagramas no deseados.  Véase
@rprogram{Aparece un pentagrama de más}.}

@seealso
Fragmentos de código:
@rlsr{Repeats}.

Referencia de funcionamiento interno:
@rinternals{RepeatedMusic},
@rinternals{UnfoldedRepeatedMusic}.


@node Repeticiones cortas
@subsection Repeticiones cortas
@translationof Short repeats

Esta sección trata de cómo introducir repeticiones cortas.  Las
repeticiones cortas pueden adoptar dos formas:
barras inclinadas o signos de porcentaje
si estamos representando repeticiones de una
sola nota, un compás o dos compases,
y trémolos en caso contrario.

@menu
* Repeticiones de compás o parte de ellos::
* Repeticiones de trémolo::
@end menu

@node Repeticiones de compás o parte de ellos
@unnumberedsubsubsec Repeticiones de compás o parte de ellos
@translationof Percent repeats

@cindex porcentaje, repetición de
@cindex compás, repetición de
@cindex repetición de porcentaje
@cindex repetición de compás
@cindex repetición corta
@funindex \repeat percent
@funindex percent

Están contempladas las repeticiones de patrones cortos de notas.  La
música se imprime una sola vez, y el patrón se sustituye por un
símbolo especial.  Los patrones que son más cortos de un compás se
sustituyen por barras inclinadas, y los patrones de uno o dos compases
se sustituyen por símbolos de tipo porcentaje.  La sintaxis es:

@example
@code{\repeat percent @var{número} @var{expresión_musical}}
@end example

@noindent
donde @var{expresión_musical} es una expresión musical.

Patterns that are shorter than one measure are replaced by slashes.

@lilypond[verbatim,quote,relative=2]
\repeat percent 4 { c8 d }
\repeat percent 4 { c4 }
\repeat percent 2 { c2 }
@end lilypond

Los patrones de repetición de uno o dos compases se sustituyen
por signos parecidos al símbolo de paorcentaje.

@lilypond[verbatim,quote,relative=2]
\repeat percent 3 { c4 d e f }
\repeat percent 4 { c2 d }
@end lilypond

@lilypond[verbatim,quote,relative=2]
\repeat percent 3 { c4 d e f | c2 g' }
@end lilypond

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{percent-repeat-counter.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{percent-repeat-count-visibility.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{isolated-percent-repeats.ly}


@seealso
Glosario musical:
@rglos{percent repeat},
@rglos{simile}.

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

Referencia de funcionamiento interno:
@rinternals{RepeatSlash},
@rinternals{PercentRepeat},
@rinternals{DoublePercentRepeat},
@rinternals{DoublePercentRepeatCounter},
@rinternals{PercentRepeatCounter},
@rinternals{PercentRepeatedMusic}.


@knownissues

Sólo están contempladas tres clases de repeticiones del tipo
porcentaje: una barra inclinada única que representa un solo pulso
(sin que importe la duración de las notas repetidas); una sola barra
inclinada con puntos que representa un compás completo; y dos barras
con puntos que cruzan a una línea divisoria y que representa dos
compases completos.  No están contempladas ni varias barras inclinadas
que representan repeticiones de un pulso consistentes en semicorcheas
o figuras menores, ni dos barras con puntos que representan
repeticiones de un solo pulso consistentes en notas de duraciones
variables.


@node Repeticiones de trémolo
@unnumberedsubsubsec Repeticiones de trémolo
@translationof Tremolo repeats

@cindex trémolo
@cindex barras de trémolo
@cindex repetición de trémolo
@funindex \repeat tremolo
@funindex tremolo

Los trémolos pueden adoptar dos formas: alternancia entre dos acordes
o dos notas, y repetición rápida de una sola nota o acorde.  Los
trémolos que consisten en una alternancia se indican por medio de la
adición de barras entre las notas o acordes que se alternan, mientras
que los trémolos que consisten en la repetición rápida de una sola
nota se indican mediante la adición de barras cruzadas a una nota
única.

Para colocar marcas de trémolo entre las notas, use @code{\repeat} con
el estilo @code{tremolo} (trémolo):

@lilypond[quote,verbatim,relative=2]
\repeat tremolo 8 { c16 d }
\repeat tremolo 6 { c16 d }
\repeat tremolo 2 { c16 d }
@end lilypond

La sintaxis de @code{\repeat tremolo} espera que se escriban
exactamente dos notas dentro de las llaves, y el número de
repeticiones debe corresponderse con un valor que se pueda expresar
con figuras normales o con puntillo.  Así, @code{\repeat tremolo 7} es
válido y produce una nota con doble puntillo, pero @code{\repeat
tremolo 9} no es válido.

La duración del trémolo es igual a la duración de la expresión entre
llaves, multiplicada por el número de repeticiones: @code{\repeat
tremolo 8 @{ c16 d16 @}} da como resultado un trémolo de redonda,
escrito como dos redondas unidas por barras de trémolo.

Existen dos maneras de colocar marcas de trémolo sobre una única nota.
Incluso aquí se puede utilizar la sintaxis @code{\repeat tremolo}, en
cuyo caso la nota no debe ir encerrada entre llaves:

@lilypond[quote,verbatim,ragged-right]
\repeat tremolo 4 c'16
@end lilypond

@cindex trémolo, indicaciones de
@funindex tremoloFlags
@funindex :

El mismo resultado se puede obtener escribiendo
@q{@code{:}[@var{número}]} después de la nota.  El número indica la
duración de la subdivisión, y debe ser 8 como mínimo.  Un valor de 8
para @var{número} produce una línea que atraviesa la plica de la nota.
Si se omite la longitud, se utiliza el último valor (almacenado en
@code{tremoloFlags}):

@lilypond[quote,verbatim,relative=2]
c2:8 c:32
c: c:
@end lilypond

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{cross-staff-tremolos.ly}


@seealso
Fragmentos de código:
@rlsr{Repeats}.

@cindex trémolos de pentagrama cruzado
@cindex pentagrama cruzado, trémolo de