Run scripts/auxiliar/update-with-convert-ly.sh

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

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

@ignore
    Translation of GIT committish: 844e5387a003bde2c10389ad863184defe893b6c

    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 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=1]
<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}.

Cuando se mezclan los modos de acorde y de nota en música secuencial,
y el modo de acordes aparece en primer lugar, el modo de notas crea un
nuevo contexto de @code{Staff}:

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

@noindent
Para evitar este comportamiento podemos crear explícitamente el
contexto de @code{Staff}:

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


@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 {
  \override Staff.TimeSignature #'stencil = ##f
  c1
}
@end lilypond

@item
m, m7
@tab
Acorde menor.  Este modificador baja la tercera.
@tab
@lilypond[line-width=4\cm, noragged-right]
\chordmode {
  \override Staff.TimeSignature #'stencil = ##f
  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 {
  \override Staff.TimeSignature #'stencil = ##f
  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 {
  \override Staff.TimeSignature #'stencil = ##f
  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 {
  \override Staff.TimeSignature #'stencil = ##f
  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
Observe que @code{c:5} es idéntico a @code{c} (los dos producen una
tríada de Do mayor).

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: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:5.15 c:5.20 c:5.25 c: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.  @code{sus} equivale a @code{^3};
@code{sus4} equivale a @code{.4^3}.

@lilypond[quote,ragged-right,verbatim]
\chordmode {
  c1:sus c:sus2 c:sus4 c:5.4^3
}
@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 {
  c1 c/g 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 {
  c1 c/g c/+g
}
@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:5.5-.5+ }
@end lilypond

Sólo se puede crear la segunda inversión mediante la adición de un
bajo.  La primera inversión requiere cambiar la fundamental del
acorde.

@lilypond[quote,ragged-right,verbatim]
\chordmode {
  c'1: c':/g e:6-3-^5 e:m6-^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,relative=1]
<<
  \new ChordNames {
    <c e g>2  <f bes c>
    <f c' e g>1
    \chordmode {
      c2 f:sus4 c1:/f
    }
  }
  {
    <c e g>2  <f bes c>
    <f, c' e g>1
    \chordmode {
      c2 f:sus4 c1:/f
    }
  }
>>
@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, relative=1]
<<
  \new ChordNames \chordmode {
    c1
    r1
    g1
    c1
  }
  \chordmode {
    c1
    r1
    g1
    c1
  }
>>
@end lilypond

@funindex{\chords}

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

@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@{ ... @}} es una notación abreviada de
@code{\new FiguredBass @{ \figuremode @{ ... @} @}}.

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'' {
    c4 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

Si se usan líneas extensoras, las cifras adyacentes con el mismo
número en distinta colocación puede hacer que se inviertan las
posiciones de las cifras.

@lilypond[verbatim,ragged-right,quote,relative=1]
<<
  { fis4 g g, e' }
  \figures {
    \bassFigureExtendersOn
    <6 5>4 <5\! 4> < 5 _!> <6>
  }
>>
@end lilypond

Para evitar este problema, sencillamente habilite los extensores
después de la cifra y quítelos al final de la línea extensora.

@lilypond[verbatim,ragged-right,quote,relative=1]
<<
  { fis4 g g, e' }
  \figures {
    <6 5>4 <5 4>
    \bassFigureExtendersOn
    < 5 _!>4 <6>
    \bassFigureExtendersOff
  }
>>
@end lilypond