Issue 5099 Fix format in input/regression/scheme-engraver.ly

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

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

@ignore
    Translation of GIT committish: 828310574b05b95170920eabb8142bf0e8f23182

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

@node Notación de acordes
@section Notación de acordes
@translationof Chord notation

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

Los acordes se pueden escribir en el modo de acordes, que reconoce
ciertas convenciones europeas tradicionales de nomenclatura de
acordes.  También se pueden imprimir los nombres de los acordes.
Además se puede imprimir notación de bajo cifrado.

@menu
* Modo de acordes::
* Imprimir los acordes::
* Bajo cifrado::
@end menu


@node Modo de acordes
@subsection Modo de acordes
@translationof Chord mode

@cindex modo de acordes

Para introducir acordes se utiliza el modo de acordes. Se usa un
indicador de la estructura del acorde en lugar de la altura de sus
notas.

@menu
* Panorámica del modo de acordes::
* Acordes más usuales::
* Acordes extendidos y alterados::
@end menu


@node Panorámica del modo de acordes
@unnumberedsubsubsec Panorámica del modo de acordes
@translationof Chord mode overview

@cindex acordes, nombres de
@cindex acordes, modo de
@cindex cifrado americano
@cindex acordes de jazz
@cindex jazz, acordes de

Los acordes se pueden escribir como música simultánea, como se
explica en @ref{Notas en acorde}.

También se pueden escribir los acordes en el @qq{modo de acordes},
que es un modo de entrada que se centra en las estructuras de los
acordes dentro de la música europea tradicional (donde se conoce
como «cifrado americano») más que en las notas concretas.  Esto es
muy práctico para los que están familiarizados con la utilización
de nombres para describir los acordes.  Hay más información sobre
los distintos modos de entrada en @ref{Modos de entrada}.

@lilypond[verbatim,quote,ragged-right]
\chordmode { c1 g a g c }
@end lilypond

Los acordes escritos con el modo de acordes son elementos
musicales, y se pueden transportar igual que los acordes escritos
mediante construcciones de música simultánea. @code{\chordmode} es
absoluto, pues @code{\relative} no tiene ningún efecto sobre los
bloques @code{chordmode}.  Sin embargo, dentro de
@code{\chordmode} las alturas absolutas son una octava más agudas
que en el modo de notas.

Se pueden mezclar los modos de acorde y de nota en la música
secuencial:

@lilypond[verbatim,quote,ragged-right]
\relative {
  <c' e g>2 <g b d>
  \chordmode { c2 f }
  <c e g>2 <g' b d>
  \chordmode { f2 g }
}
@end lilypond

@seealso
Glosario musical:
@rglos{chord}.

Referencia de la notación:
@ref{Notas en acorde},
@ref{Modos de entrada}.

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

@knownissues
No se pueden usar las abreviaturas predefinidas de articulaciones
y adornos sobre notas dentro del modo de acordes; véase
@ref{Articulaciones y ornamentos}.


@node Acordes más usuales
@unnumberedsubsubsec Acordes más usuales
@translationof Common chords

@cindex tríadas
@cindex séptima, acordes de
@cindex fundamental de un acorde
@cindex modificadores de acorde
@cindex acordes, variantes de

Las tríadas mayores se introducen escribiendo la fundamental y una
duración opcional:

@lilypond[verbatim,quote,ragged-right]
\chordmode { c2 f4 g }
@end lilypond

Las tríadas menores, aumentadas y disminuidas se escriben poniendo
@code{:} y una cadena modificadora de variante después de la
duración:

@lilypond[verbatim,quote,ragged-right]
\chordmode { c2:m f4:aug g:dim }
@end lilypond

Se pueden crear acordes de séptima:

@lilypond[quote,ragged-right,verbatim]
\chordmode { c1:7 c:m7 c:maj7 c:dim7 c:aug7 }
@end lilypond

@funindex aug
@funindex dim
@funindex maj
@funindex m

La tabla que aparece más abajo muestra el efecto de los
modificadores de variante sobre los acordes de tríada y de
séptima.  La séptima añadida de forma predeterminada a los acordes
es menor, lo que hace del acorde de séptima dominante el acorde
básico de séptima.  Todas las alteraciones se consideran en
relación con la séptima dominante.  Hay una tabla más completa
donde aparecen los usos de los modificadores en
@ref{Modificadores de acorde más usuales}.

@c @table @code
@multitable @columnfractions .2 .4 .3

@item
@b{Modificador}
@tab
@b{Acción}
@tab
@b{Ejemplo}

@item
Ninguno
@tab
Acción predeterminada; produce una tríada mayor.
@tab
@lilypond[line-width=4\cm, noragged-right]
\chordmode {
  \omit Staff.TimeSignature
  c1
}
@end lilypond

@item
m, m7
@tab
Acorde menor.  Este modificador baja la tercera.
@tab
@lilypond[line-width=4\cm, noragged-right]
\chordmode {
  \omit Staff.TimeSignature
  c1:m c:m7
}
@end lilypond


@item
dim, dim7
@tab
Acorde disminuido.  Este modificador baja la tercera, la quinta y,
si existe, la séptima.
@tab
@lilypond[line-width=4\cm, noragged-right]
\chordmode {
  \omit Staff.TimeSignature
  c1:dim c:dim7
}
@end lilypond

@item
aug
@tab
Acorde aumentado.  Este modificador eleva la quinta.
@tab
@lilypond[line-width=4\cm, noragged-right]
\chordmode {
  \omit Staff.TimeSignature
  c1:aug
}
@end lilypond

@item
maj, maj7
@tab
Acorde de séptima mayor.  Este modificador añade una séptima
elevada.  El @code{7} que sigue a @code{maj} es opcional.  NO
utilice este modificador para crear una tríada mayor.
@tab
@lilypond[line-width=4\cm, noragged-right]
\chordmode {
  \omit Staff.TimeSignature
  c1:maj c:maj7
}
@end lilypond

@end multitable

@seealso
Referencia de la notación:
@ref{Modificadores de acorde más usuales},
@ref{Acordes extendidos y alterados}.

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

@knownissues
Sólo se puede usar un modificador por cada acorde, normalmente
sobre la nota más aguda del mismo.  Los acordes con más de un
modificador se analizan sin producir errores ni advertencias, pero
el resultado es impredecible.  Los acordes que no se pueden
conseguir con un solo modificador se deben alterar en sus notas
individuales como se describe en
@ref{Acordes extendidos y alterados}.


@node Acordes extendidos y alterados
@unnumberedsubsubsec Acordes extendidos y alterados
@translationof Extended and altered chords

@cindex acordes extendidos
@cindex acordes alterados

Se pueden crear estructuras de acorde de complejidad arbitraria
dentro del modo de acordes.  Se puede usar la cadena modificadora
para extender un acorde, añadir o quitar notas, elevar o bajar
notas del acorde y añadir un bajo distinto o crear una inversión.

El primer número que sigue al @code{:} se considera que es el
ámbito del acorde.  El acorde se construye secuencialmente
añadiendo terceras a la fundamental hasta que se alcanza el número
especificado.  Observe que la séptima añadida como parte de un
acorde extendido es la séptima menor, no mayor.  Si el ámbito no
es una tercera (p.ej. 6), se añaden terceras hasta la tercera más
alta inferior al ámbito, y después se añade la nota del ámbito.
El mayor valor posible para el ámbito es 13.  Cualquier valor
mayor se interpreta como 13.

@lilypond[quote,ragged-right,verbatim]
\chordmode {
  c1:2 c:3 c:4 c:5
  c1:6 c:7 c:8 c:9
  c1:10 c:11 c:12 c:13
  c1:14
}
@end lilypond

@noindent
Como excepción especial, @code{c:5} produce un @q{power chord},
que tiene solamente la fundamental y la quinta.

Puesto que una oncena sin alteración no suena bien cuando se
combina con una trecena sin alteración, se elimina la oncena de
los acordes de @code{:13} (a no ser que se añada explícitamente).

@lilypond[quote,ragged-right,verbatim]
\chordmode {
  c1:13 c:13.11 c:m13
}
@end lilypond

@cindex adiciones en acordes

Se pueden añadir notas individuales a un acorde.  Las adiciones
siguen el ámbito y van prefijadas por un punto (@code{.}).  La
séptima normal que se añade a un acorde es la séptima menor, no
mayor.

@lilypond[quote,verbatim]
\chordmode {
  c1:3.5.6 c:3.7.8 c:3.6.13
}
@end lilypond

Las notas añadidas pueden ser tan agudas como se desee.

@lilypond[quote,verbatim]
\chordmode {
  c4:3.5.15 c:3.5.20 c:3.5.25 c:3.5.30
}
@end lilypond

@cindex acordes, alteración de notas

Las notas añadidas a los acordes se pueden alterar mediante la
adición de los sufijos @code{-} o @code{+} al número.  Para
alterar una nota que se ha incluido automáticamente como parte de
la estructura básica del acorde, añádala como una nota alterada.

@lilypond[quote,verbatim]
\chordmode {
  c1:7+ c:5+.3- c:3-.5-.7-
}
@end lilypond

@cindex acordes, supresiones en

@funindex ^

Una nota que se quiere suprimir de un acorde se indica dentro de
la cadena modificadora prefijándola por un acento circunflejo
@code{^}.  Sólo se permite una supresión con @code{^} dentro de
una cadena modificadora.

@lilypond[quote,verbatim]
\chordmode {
  c1^3 c:7^5 c:9^3 c:9^3.5 c:13.11^3.7
}
@end lilypond

@funindex sus

Se puede añadir el modificador @code{sus} a la cadena modificadora
para crear acordes suspendidos.  Esto elimina la tercera del
acorde.  Escriba bien @code{2} o bien @code{4} para añadir la
segunda o la cuarta al acorde, respectivamente.  Cuando @code{sus}
va seguido de una segunda o una cuarta, es equivalente a
@code{^3}, y en caso contrario a @code{sus4}, o sea, @code{5.4}.

@lilypond[quote,ragged-right,verbatim]
\chordmode {
  c1:sus c:sus2 c:sus4 c:5.4
}
@end lilypond

@funindex /
@cindex acordes, inversiones
@cindex bajo de los acordes
@cindex acordes, bajo de

Se pueden especificar las inversiones (colocar en el bajo una nota
distinta de la fundamental del acorde) y notas de bajo añadidas
mediante la adición de @code{/}@var{nota} al acorde.

@lilypond[quote,ragged-right,verbatim]
\chordmode {
  c'1 c'/e c'/f
}
@end lilypond

@funindex /+

Se puede añadir una nota del bajo que forma parte del acorde, en
lugar de ser movida por efecto de una inversión, mediante el uso
de @code{/+}@var{nota}.

@lilypond[quote,ragged-right,verbatim]
\chordmode {
  c'1 c'/g c'/+e
}
@end lilypond

Los modificadores de acorde que se pueden utilizar para producir
una amplia variedad de acordes estándar se muestran en
@ref{Modificadores de acorde más usuales}.

@seealso
Referencia de la notación:
@ref{Modificadores de acorde más usuales}.

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

@knownissues
Cada nota sólo puede estar presente en el acorde una sola vez.  Lo
que sigue produce simplemente el acorde aumentado, porque
@code{5+} se interpreta en último lugar.

@lilypond[quote,ragged-right,verbatim]
\chordmode { c1:3.5.5-.5+ }
@end lilypond


@node Imprimir los acordes
@subsection Imprimir los acordes
@translationof Displaying chords

Los acordes se pueden imprimir por su nombre, además de la
impresión estándar como notas sobre un pentagrama.

@menu
* Impresión de los nombres de acorde::
* Nombres de acorde personalizados::
@end menu


@node Impresión de los nombres de acorde
@unnumberedsubsubsec Impresión de los nombres de acorde
@translationof Printing chord names

@cindex impresión de los nombres de acorde
@cindex acordes, nombres de
@cindex acordes

Los nombres de acorde se imprimen dentro del contexto
@code{ChordNames}:

@lilypond[verbatim,quote,ragged-right]
\new ChordNames {
  \chordmode {
    c2 f4. g8
  }
}
@end lilypond

Los acordes se pueden escribir como notas simultáneas o a través
del uso del modo de acordes.  El nombre de acorde que se imprime
es el mismo independientemente del modo de entrada, a no ser que
existan inversiones o bajos añadidos:

@lilypond[verbatim,quote]
chordmusic = \relative {
  <c' e g>2 <f bes c>
  <f c' e g>1
  \chordmode {
    c2 f:sus4 c1:/f
  }
}
<<
  \new ChordNames {
    \chordmusic
  }
  {
    \chordmusic
  }
>>
@end lilypond

@cindex sin acorde, símbolo
@cindex N.C., símbolo
@cindex indicar No Chord (sin acorde) en ChordNames

Los silencios pasados a un contexto @code{ChordNames} hacen que se
imprima el elemento de marcado @code{noChordSymbol} (símbolo de
N.C., Sin Acorde).

@lilypond[verbatim,quote]
<<
  \new ChordNames \chordmode {
    c1
    r1
    g1
    c1
  }
  \chordmode {
    c1
    r1
    g1
    c1
  }
>>
@end lilypond

@funindex{\chords}

@code{\chords @{ @dots{} @}} es una forma abreviada de escribir
@code{\new ChordNames @{ \chordmode @{ @dots{} @} @}}.

@lilypond[verbatim,quote,ragged-right]
\chords {
  c2 f4.:m g8:maj7
}
@end lilypond

@lilypond[verbatim,quote,ragged-right]
\new ChordNames {
  \chordmode {
    c2 f4.:m g8:maj7
  }
}
@end lilypond

@snippets

@c Keep index entries with following snippet
@cindex acordes, eliminar repetidos
@funindex chordChanges

@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{showing-chords-at-changes.ly}

@c @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
@c {adding-bar-lines-to-chordnames-context.ly}

@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{simple-lead-sheet.ly}

@seealso
Glosario musical:
@rglos{chord}.

Referencia de la notación:
@ref{Escribir música en paralelo}.

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

Referencia de funcionamiento interno:
@rinternals{ChordNames},
@rinternals{ChordName},
@rinternals{Chord_name_engraver},
@rinternals{Volta_engraver},
@rinternals{Bar_engraver}.

@knownissues
Los acordes que contienen inversiones o bajos alterados no reciben
un nombre adecuado si se escriben usando música simultánea.


@node Nombres de acorde personalizados
@unnumberedsubsubsec Nombres de acorde personalizados
@translationof Customizing chord names

@cindex personalización de los nombres de acorde

No hay un sistema único para nombrar acordes.  Las distintas
tradiciones musicales usan distintos nombres para el mismo
conjunto de acordes.  También hay distintos símbolos impresos para
un nombre de acorde dado.  Los nombres y símbolos que se imprimen
para los nombres de acorde dados se pueden personalizar.

@cindex Banter
@cindex jazz, acordes de
@cindex acordes de jazz

El esquema de nomenclatura de acordes predeterminado es un sistema
para música de Jazz, propuesto por Klaus Ignatzek (véase
@ressay{Lista bibliográfica}).  También funcionan otros dos
esquemas de nomenclatura de acordes: una notación de acordes de
Jazz alternativa y un esquema sistemático llamado Acordes de
Banter.  La notación de Jazz alternativa también se puede ver en
el cuadro @ref{Cuadro de nombres de acordes}.

@c TODO --  Change this so we don't have a non-verbatim example.
@c  Make short example in docs, then move longer example to
@c  appendix, where the length of the snippet won't matter.

Además de los distintos sistemas de nomenclatura, se usan
diferentes nombres de nota para la fundamental en los distintos
idiomas.  Las variables predefinidas @code{\germanChords},
@code{\semiGermanChords}, @code{\italianChords} y
@code{\frenchChords} establecen el valor de estas variables.  El
efecto se muestra aquí:

@lilypondfile[ragged-right]{chord-names-languages.ly}


@funindex chordNameLowercaseMinor

Algunos cancioneros alemanes indican los acordes menores como
letras minúsculas, sin el sufijo @var{m}.  Esto se puede conseguir
estableciendo la propiedad @code{chordNameLowercaseMinor}:

@lilypond[verbatim,quote,ragged-right]
\chords {
  \set chordNameLowercaseMinor = ##t
  c2 d:m e:m f
}
@end lilypond

Si ninguno de los ajustes predeterminados proporciona el resultado
deseado, se puede afinar la presentación de los nombres de acorde
a través de las siguientes propiedades.

@table @code

@funindex chordRootNamer

@item chordRootNamer

El nombre de acorde se imprime normalmente como una letra para la
fundamental con una alteración opcional.  La transformación de la
nota en la letra se realiza por parte de esta función.  Los
nombres de nota especiales (por ejemplo, la @q{H} alemana para un
acorde de Si) se pueden producir almacenando una función nueva en
esta propiedad.

@funindex majorSevenSymbol

@item majorSevenSymbol

Esta propiedad contiene el objeto de marcado que se usa para hacer
el seguimiento de la salida de @code{chordRootNamer} para
identificar un acorde de séptima mayor. Las opciones predefinidas
son @code{whiteTriangleMarkup} (triángulo blanco) y
@code{blackTriangleMarkup} (triángulo negro).

@funindex additionalPitchPrefix

@item additionalPitchPrefix

Cuando el acorde contiene notas añadidas, se pueden prefijar
opcionalmente por un texto.  Por omisión no hay ningún prefijo,
para evitar la sobrecarga visual, pero para pequeñas cantidades de
notas añadidas puede ser visualmente efectivo.

@lilypond[verbatim,quote,ragged-right]
\new ChordNames {
  <c e g d'>    % add9
  \set additionalPitchPrefix = #"add"
  <c e g d'>    % add9
}
@end lilypond

@funindex chordNoteNamer

@item chordNoteNamer

Cuando el nombre del acorde contiene notas adicionales aparte de
la fundamental (p.ej., un bajo añadido), se utiliza esta función
para imprimir la nota adicional.  De forma predeterminada se
imprime la nota usando @code{chordRootNamer}.  La propiedad
@code{chordNoteNamer} se puede establecer a una función
especializada para cambiar este comportamiento.  Por ejemplo, el
bajo se puede imprimir en minúscula.

@funindex chordNameSeparator

@item chordNameSeparator

Las diferentes partes del nombre de un acorde se separan
normalmente mediante un pequeño espacio en blanco.  Mediante el
ajuste de @code{chordNameSeparator}, podemos usar cualquier
marcado que deseemos como separador.  Esto no afecta al separador
entre un acorde y la nota del bajo: para personalizar eso, utilice
@code{slashChordSeparator}.

@lilypond[verbatim,quote,ragged-right]
\chords {
  c4:7.9- c:7.9-/g
  \set chordNameSeparator = \markup { "/" }
  \break
  c4:7.9- c:7.9-/g
}
@end lilypond

@funindex slashChordSeparator

@item slashChordSeparator

Los acordes se pueden tocar sobre una nota del bajo distinta a la
fundamental.  Se llaman "inversiones" o "acordes de barra
inclinada" porque la manera predeterminada de efectuar su notación
es con una barra inclinada entre el acorde y la nota del bajo.
Por tanto, el valor de @code{slashChordSeparator} es, por omisión,
una barra inclinada, pero podemos cambiarlo a cualquier elemento
de marcado que queramos.

@lilypond[verbatim,quote,ragged-right]
\chords {
  c4:7.9- c:7.9-/g
  \set slashChordSeparator = \markup { " over " }
  \break
  c4:7.9- c:7.9-/g
}
@end lilypond

@funindex chordNameExceptions

@item chordNameExceptions

Esta propiedad es una lista de parejas.  El primer elemento de
cada pareja es un conjunto de notas utilizadas para identificar
los elementos presentes en el acorde.  El segundo elemento es un
elemento de marcado que sigue a la salida de @code{chordRootNamer}
para crear el nombre del acorde.

@funindex minorChordModifier

@item minorChordModifier

La notación de los acordes menores se suele hacer por medio del
sufijo @q{m} a la derecha de la letra que indica la fundamental
del acorde.  Sin embargo, otras convenciones dan preferencia a
sufijos diferentes, como un signo menos.

@lilypond[verbatim,quote,ragged-right]
\chords {
  c4:min f:min7
  \set minorChordModifier = \markup { "-" }
  \break
  c4:min f:min7
}
@end lilypond

@funindex chordPrefixSpacer

@item chordPrefixSpacer

El modificador de los acordes menores tal y como viene determinado
por @code{minorChordModifier} se imprime por lo general
inmediatamente a la derecha de la fundamental.  Se puede insertar
un símbolo separador entre la fundamental y el modificador
estableciendo @code{chordPrefixSpacer}.  El símbolo separador no
se usa cuando el acorde está alterado.

@end table


@predefined
@funindex major seven symbols
@code{\whiteTriangleMarkup},
@code{\blackTriangleMarkup},
@funindex \germanChords
@code{\germanChords},
@funindex \semiGermanChords
@code{\semiGermanChords},
@funindex \italianChords
@code{\italianChords},
@funindex \frenchChords
@code{\frenchChords}.
@endpredefined


@snippets

@cindex excepciones, nombres de acorde
@lilypondfile[verbatim,quote,texidoc,doctitle]
{chord-name-exceptions.ly}

@c TODO - tweak snippet to use \blackTriangleMarkup as well
@lilypondfile[verbatim,quote,texidoc,doctitle]
{chord-name-major7.ly}

@lilypondfile[verbatim,quote,texidoc,doctitle]
{adding-bar-lines-to-chordnames-context.ly}

@lilypondfile[verbatim,quote,texidoc,doctitle]
{volta-below-chords.ly}

@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-chord-separator.ly}

@seealso
Referencia de la notación:
@ref{Cuadro de nombres de acordes},
@ref{Modificadores de acorde más usuales}.

El ensayo sobre grabado musical automatizado:
@ressay{Lista de referencias bibliográficas}.

Archivos instalados:
@file{scm/chords-ignatzek.scm},
@file{scm/chord-entry.scm},
@file{ly/chord-modifier-init.ly}.

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

@knownissues
Los nombres de acorde se determinan a partir de las notas que
están presentes en el mismo y de la información acerca de la
estructura del acorde que ha podido ser introducida en
@code{\chordmode}.  Si el método de las notas simultáneas se usa
para introducir los acordes, pueden resultar nombres no deseados a
partir de las inversiones o de las notas del bajo.

@lilypond[quote,ragged-right,verbatim]
myChords = \relative c' {
  \chordmode { c1 c/g c/f }
  <c e g>1 <g c e> <f c' e g>
}
<<
  \new ChordNames { \myChords }
  \new Staff { \myChords }
>>
@end lilypond


@node Bajo cifrado
@subsection Bajo cifrado
@translationof Figured bass

@c Line width hack because of instrument names
@lilypondfile[quote,staffsize=18,line-width=14.5\cm]{figured-bass-headword.ly}

Se puede imprimir notación de bajo cifrado.

@menu
* Introducción al bajo cifrado::
* Introducir el bajo cifrado::
* Imprimir el bajo cifrado::
@end menu


@node Introducción al bajo cifrado
@unnumberedsubsubsec Introducción al bajo cifrado
@translationof Introduction to figured bass

@cindex Basso continuo
@cindex Thorough bass
@cindex Figured bass
@cindex Bass, thorough
@cindex Bass, figured

@c TODO: musicological blurb about FB

LilyPond contempla el bajo cifrado, también conocido como basso
continuo:

@lilypond[quote,ragged-right,verbatim]
<<
  \new Voice { \clef bass dis4 c d ais g fis}
  \new FiguredBass {
    \figuremode {
      < 6 >4 < 7\+ >8 < 6+ [_!] >
      < 6 >4 <6 5 [3+] >
      < _ >4 < 6 5/>4
    }
  }
>>
@end lilypond

El soporte para bajo cifrado se compone de dos partes: hay un modo
de entrada, presentado por @code{\figuremode}, que admite la
entrada de las cifras del bajo, y hay un contexto llamado
@code{FiguredBass} que se ocupa de la impresión de los objetos del
tipo @code{BassFigure}.  El bajo cifrado también se puede imprimir
dentro de contextos de @code{Staff}.

@code{\figures@{ @dots{} @}} es una notación abreviada de
@code{\new FiguredBass @{ \figuremode @{ @dots{} @} @}}.

Aunque el soporte para bajo cifrado puede parecerse
superficialmente al de los acordes, realmente es mucho más simple.
El modo @code{\figuremode} simplemente almacena las cifras y el
contexto @code{FiguredBass} las imprime tal y como se han
introducido.  No hay ninguna conversión a notas.

@ignore
Las cifras se crean como textos de marcado.  Cualquiera de las
propiedades estándar de marcado se pueden usar para modificar la
impresión de las cifras.  Por ejemplo, el espaciado vertical de las
cifras se puede ajustar con @code{baseline-skip}.
@end ignore

@seealso
Glosario musical:
@rglos{figured bass}.

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


@node Introducir el bajo cifrado
@unnumberedsubsubsec Introducir el bajo cifrado
@translationof Entering figured bass

Se usa @code{\figuremode} para cambiar el modo de entrada al modo
de cifras.  Hay más información sobre los distintos modos de
entrada en @ref{Modos de entrada}.

En el modo de cifras, un grupo de cifras del bajo está delimitado
mediante ángulos simples, @code{<} y @code{>}.  La duración se
escribe después del @code{>}.

@lilypond[verbatim,quote,ragged-right]
\new FiguredBass {
  \figuremode {
    <6 4>2
  }
}
@end lilypond

Se pueden añadir alteraciones accidentales (incluso becuadros) a
las cifras:

@lilypond[verbatim,quote,ragged-right]
\figures {
  <7! 6+ 4-> <5++> <3-->
}
@end lilypond

Se pueden indicar elementos del acorde aumentados y disminuidos:

@lilypond[verbatim,quote,ragged-right]
\figures {
  <6\+ 5/> <7/>
}
@end lilypond

Se puede crear una barra invertida cruzando una cifra (usada
normalmente para sextas elevadas):

@lilypond[verbatim,quote,ragged-right]
\figures {
  <6> <6\\>
}
@end lilypond

Se pueden incluir espacios verticales y corchetes en las cifras:

@lilypond[verbatim,quote,ragged-right]
\figures {
  <[12 _!] 8 [6  4]>
}
@end lilypond

Se puede insertar cualquier elemento de marcado de texto como una
cifra:

@lilypond[verbatim,quote,ragged-right]
\figures {
  <\markup { \tiny \number 6 \super (1) } 5>
}
@end lilypond

@c TODO We need to include notes any time we use extenders to
@c avoid extraneous staff creation due to Staff.use... in
@c \bassFigureExtendersOn

Se pueden usar líneas de continuación para indicar cifras que se
repiten:

@lilypond[verbatim,quote,ragged-right]
<<
  {
    \clef bass
    e4 d c b,
    e4 d c b,
  }
  \figures {
    \bassFigureExtendersOn
    <6 4>4 <6 3> <7 3> <7 3>
    \bassFigureExtendersOff
    <6 4>4 <6 3> <7 3> <7 3>
  }
>>
@end lilypond

@noindent
En este caso, las líneas de extensión sustituyen a las cifras
existentes, a no ser que las líneas de continuación hayan sido
terminadas explícitamente.

@lilypond[verbatim,quote,ragged-right]
<<
  \figures {
    \bassFigureExtendersOn
    <6 4>4 <6 4> <6\! 4\!> <6 4>
  }
  {
    \clef bass
    d4 d c c
  }
>>
@end lilypond


La siguiente tabla resume los modificadores de cifrado
disponibles.

@multitable @columnfractions .1 .5 .4

@item
@b{Modificador}
@tab
@b{Propósito}
@tab
@b{Ejemplo}

@item
+, -, !
@tab
Alteraciones
@tab
@lilypond[line-width=4\cm]
\figures {
  <7! 6+ 4-> <5++> <3-->
}
@end lilypond

@item
\+, /
@tab
Aumentaciones y disminuciones
@tab
@lilypond[line-width=4\cm]
\figures {
  <6\+ 5/> <7/>
}
@end lilypond

@item
\\
@tab
Sexta elevada
@tab
@lilypond[line-width=4\cm]
\figures {
  <6\\>
}
@end lilypond

@item
\!
@tab
Fin de línea de continuación
@tab
@lilypond[line-width=4\cm]
<<
  \figures {
    \bassFigureExtendersOn
    <6 4> <6 4> <6\! 4\!> <6 4>
  }
  {
    \clef bass
    d d c c
  }
>>
@end lilypond

@end multitable


@predefined
@cindex bajo cifrado, líneas de extensión
@code{\bassFigureExtendersOn},
@code{\bassFigureExtendersOff}.
@endpredefined


@snippets
@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-the-positions-of-figured-bass-alterations.ly}

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

Referencia de funcionamiento interno:
@rinternals{BassFigure},
@rinternals{BassFigureAlignment},
@rinternals{BassFigureLine},
@rinternals{BassFigureBracket},
@rinternals{BassFigureContinuation},
@rinternals{FiguredBass}.


@node Imprimir el bajo cifrado
@unnumberedsubsubsec Imprimir el bajo cifrado
@translationof Displaying figured bass

El bajo cifrado se puede imprimir usando el contexto
@code{FiguredBass}, o dentro de la mayoría de los contextos de
pentagrama.

Cuando se presenta dentro de un contexto de @code{FiguredBass}, la
ubicación vertical de las cifras es independiente de las notas que
están en el pentagrama.

@lilypond[verbatim,ragged-right,quote]
<<
  \relative {
    c''4 c'8 r8 c,4 c'
  }
  \new FiguredBass {
    \figuremode {
      <4>4 <10 6>8 s8
      <6 4>4 <6 4>
    }
  }
>>
@end lilypond

@noindent
En el ejemplo de arriba, el contexto @code{FiguredBass} se debe
instanciar explícitamente para evitar crear un segundo pentagrama
vacío.

El bajo cifrado se puede añadir también a contextos de
@code{Staff} directamente.  En este caso, la posición vertical de
las cifras se ajusta automáticamente.

@lilypond[verbatim,ragged-right,quote]
<<
  \new Staff = "myStaff"
  \figuremode {
    <4>4 <10 6>8 s8
    <6 4>4 <6 4>
  }
  %% Put notes on same Staff as figures
  \context Staff = "myStaff"
  {
    \clef bass
    c4 c'8 r8 c4 c'
  }
>>
@end lilypond

Cuando se escribe dentro de un contexto de pentagrama, el bajo
cifrado se puede presentar encima o debajo del mismo.

@lilypond[verbatim,ragged-right,quote]
<<
  \new Staff = "myStaff"
  \figuremode {
    <4>4 <10 6>8 s8
    \bassFigureStaffAlignmentDown
    <6 4>4 <6 4>
  }
  %% Put notes on same Staff as figures
  \context Staff = "myStaff"
  {
    \clef bass
    c4 c'8 r8 c4 c'
  }
>>
@end lilypond


@predefined
@cindex bajo cifrado, alineación
@code{\bassFigureStaffAlignmentDown},
@code{\bassFigureStaffAlignmentUp},
@code{\bassFigureStaffAlignmentNeutral}.
@endpredefined

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

Referencia de funcionamiento interno:
@rinternals{BassFigure},
@rinternals{BassFigureAlignment},
@rinternals{BassFigureLine},
@rinternals{BassFigureBracket},
@rinternals{BassFigureContinuation},
@rinternals{FiguredBass}.

@knownissues
Para asegurar que las líneas extensoras funcionan adecuadamente,
lo más seguro es utilizar las mismas duraciones en la línea de
cifras y en la línea del bajo.

@lilypond[verbatim,ragged-right,quote]
<<
  {
    \clef bass
    \repeat unfold 4 { f16. g32 } f8. es16 d8 es
  }
  \figures {
    \bassFigureExtendersOn
    % The extenders are correct here, with the same rhythm as the bass
    \repeat unfold 4 { <6 4->16. <6 4->32 }
    <5>8. r16 <6>8 <6\! 5->
  }
>>
<<
  {
    \clef bass
    \repeat unfold 4 { f16. g32 } f8. es16 d8 es
  }
  \figures {
    \bassFigureExtendersOn
    % The extenders are incorrect here, even though the timing is the same
    <6 4->4 <6 4->4
    <5>8. r16 <6>8 <6\! 5->
  }
>>
@end lilypond