Doc-es: update Fretted, Keyboards, Notation appendices, web/Introduction.

[lilypond.git] / Documentation / es / notation / fretted-strings.itely

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

@ignore
    Translation of GIT committish: 5becf12f5ada67346f70ad8cfe68589466619305

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

@node Instrumentos de cuerda con trastes
@section Instrumentos de cuerda con trastes
@translationof Fretted string instruments

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

Esta sección trata varios aspectos de la notación musical que son
exclusivos de los instrumentos de cuerda con trastes.

@cindex tablatura
@cindex guitarra, tablatura de
@cindex tablatura de banjo
@cindex banjo, tablatura de

@menu
* Notación común para cuerdas con trastes::
* Guitarra::
* Banjo::
@end menu

@node Notación común para cuerdas con trastes
@subsection Notación común para cuerdas con trastes
@translationof Common notation for fretted strings

Esta sección se ocupa de la notación común exclusiva de los
instrumentos de cuerda con trastes.

@menu
* Referencias para cuerdas con trastes::
* Indicación de los números de cuerda::
* Tablaturas predeterminadas::
* Tablaturas personalizadas::
* Marcas de diagramas de trastes::
* Diagramas predefinidos de trastes::
* Diagramas de traste automáticos::
* Digitaciones de la mano derecha::
@end menu

@node Referencias para cuerdas con trastes
@unnumberedsubsubsec Referencias para cuerdas con trastes
@translationof References for fretted strings

La notación musical para instrumentos de cuerda con trastes se realiza
normalmente en una sola pauta, ya sea en notación musical tradicional
o en tablatura.  A veces se combinan los dos tipos, y es común en
música popular utilizar diagramas de acordes por encima de un
pentagrama de notación tradicional.  La guitarra y el banjo son
instrumentos transpositores, que suenan una octava por debajo de lo
escrito.  Las partituras para estos instrumentos deben usar la clave
de Sol octava baja @code{"treble_8"} (o @code{\transposition c} para
obtener una salida MIDI correcta).  Otros elementos relativos a los
instrumentos de cuerda con trastes se estudian en otras partes de
manual:

@itemize
@item
Las digitaciones se indican como se explica en @ref{Indicaciones de
digitación}.

@item
Las instrucciones para ligaduras @notation{Laissez vibrer} así como
ligaduras de unión sobre arpegios y trémolos están en
@ref{Ligaduras de unión}.

@item
Las instrucciones para el manejo de varias voces se encuentran en
@ref{Resolución de las colisiones}.

@item Las instrucciones para la indicación de armónicos está en
@ref{Armónicos}.

@end itemize


@seealso
Referencia de la notación:
@ref{Indicaciones de digitación},
@ref{Ligaduras de unión},
@ref{Resolución de las colisiones},
@ref{Nombres de instrumentos},
@ref{Escribir música en paralelo},
@ref{Arpegio},
@ref{Lista de articulaciones},
@ref{Clave},
@ref{Transposición de los instrumentos}.


@node Indicación de los números de cuerda
@unnumberedsubsubsec Indicación de los números de cuerda
@translationof String number indications

@cindex cuerda, número de la
@cindex números de cuerda frente a digitaciones
@cindex digitación frente a números de cuerda

Se puede indicar la cuerda en que se debe tocar una nota añadiendo
@code{\}@tie{}@var{número} a una nota dentro de una construcción de
acorde (@code{<>}).

@warning{Los números de cuerda @strong{se deben} definir dentro de una
construcción de acorde con ángulos simples, incluso si se trata de una
sola nota.}

@lilypond[verbatim,quote,relative=0]
\clef "treble_8"
<c\5>4 <e\4> <g\3>2
<c,\5 e\4 g\3>1
@end lilypond

Cuando se usan al mismo tiempo digitaciones e indicaciones del número
de cuerda, su colocación se controla por el orden en que aparecen
estos elementos en el código:

@lilypond[verbatim,quote,relative=1]
\clef "treble_8"
<g\3-0>2
<g-0\3>
@end lilypond

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{controlling-the-placement-of-chord-fingerings.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{allowing-fingerings-to-be-printed-inside-the-staff.ly}


@seealso
Referencia de la notación:
@ref{Indicaciones de digitación}.

Fragmentos de código:
@rlsr{Fretted strings}.

Referencia de funcionamiento interno:
@rinternals{StringNumber},
@rinternals{Fingering}.


@node Tablaturas predeterminadas
@unnumberedsubsubsec Tablaturas predeterminadas
@translationof Default tablatures

@cindex tablatura, principios básicos
@cindex tablatura predeterminada

@funindex TabStaff
@funindex TabVoice

La notación para instrumentos de cuerda pulsada se realiza con
frecuencia utilizando un sistema de dedos y cifras, o tablatura.  A
diferencia de la notación tradicional, las notas no se designan
mediante figuras, sino mediante números (o símbolos semejantes a
letras en la intavolatura histórica).  Las líneas de la tablatura
indican sobre qué cuerda se debe tocar la nota, y el número sobre
una línea indica el traste en que la cuerda correspondiente debe
pisarse.  Las notas que se deben tocar simultáneamente se
alinean en sentido vertical.

De forma predeterminada, la cuerda 1 es la más aguda y corresponde
a la línea superior de la pauta @code{TabStaff}.  La afinación
predeterminada de las cuerdas del @code{TabStaff} es la afinación
estándar de guitarra (con 6 cuerdas).  Las notas se imprimen
como tablatura, usando los contextos @code{TabStaff}
y @code{TabVoice}.  Se añade automáticamente una clave caligráfica
de tablatura.

@lilypond[quote,ragged-right,verbatim]
\new TabStaff \relative c' {
  a,8 a' <c e> a
  d,8 a' <d f> a
}
@end lilypond

Las tablaturas predeterminadas no contienen símbolos para la duración
de las notas ni ningún otro símbolo musical, como p.ej. indicaciones
expresivas.

@lilypond[quote,ragged-right,verbatim]
symbols = {
  \time 3/4
  c4-.^"Allegro" d( e)
  f4-.\f g a^\fermata
  \mark \default
  c8_.\<\( c16 c~ c2\!
  c'2.\prall\)
}

\score {
  <<
    \new Staff { \clef "G_8" \symbols }
    \new TabStaff { \symbols }
  >>
}
@end lilypond

@funindex \tabFullNotation

Si queremos que todos los símbolos musicales que se usan en la
notación tradicional aparezcan también en la tablatura, tenemos que
aplicar la instrucción @code{\tabFullNotation} dentro de un contexto
@code{TabStaff}.  Tenga en cuenta que, en la tablatura, las blancas
tienen doble plica para poder distinguirlas de las negras.

@lilypond[quote,ragged-right,verbatim]
symbols = {
  \time 3/4
  c4-.^"Allegro" d( e)
  f4-.\f g a^\fermata
  \mark \default
  c8_.\<\( c16 c~ c2\!
  c'2.\prall\)
}

\score {
  \new TabStaff {
    \tabFullNotation
    \symbols
  }
}
@end lilypond

@cindex traste

@funindex minimumFret

De forma predeterminada, las notas se asignan a la posición más baja
del mástil (primera posición).  Las cuerdas al aire se toman como
preferencia, automáticamente.  Si queremos que una nota determinada se
toque sobre una cuerda concreta, podemos añadir una indicación de
número de cuerda al nombre de la nota.  Si definimos los nombres de
nota y los números de cuerda sin una construcción de acorde
(@code{<>}), las indicaciones de número de cuerda no aparecerán en la
notación tradicional.  Es mucho más cómodo definir la posición
utilizando el valor de @code{minimumFret}.  El valor predeterminado de
es 0.


@lilypond[quote,ragged-right,verbatim]
\new StaffGroup <<
   \new Staff \relative c {
     \clef "treble_8"
     \time 2/4
     c16 d e f g4
     c,16\5 d\5 e\4 f\4 g4\4
     c,16 d e f g4
   }
   \new TabStaff \relative c {
     c16 d e f g4
     c,16\5 d\5 e\4 f\4 g4\4
     \set TabStaff.minimumFret = #5
     c,16 d e f g4
   }
>>
@end lilypond

@funindex \tabChordRepetition

Las construcciones de acorde se pueden repetir mediante el símbolo de
repetición de acordes @code{q}.  Para utilizar esta posibilidad en
combinación con la tablatura, se proporciona
@code{\tabChordRepetition}, que preserva la información de cuerdas
dada explícitamente dentro de las construcciones de acorde, de forma
que los acordes repetidos den lugar a representaciones de tablatura
idénticas.

@lilypond[quote,verbatim]
\tabChordRepetition

guitar = \relative c' {
  r8 <gis\4 cis\3 b\2>~ q4 q8~ q q4
}

\new StaffGroup <<
  \new Staff {
    \clef "treble_8"
    \override Voice.StringNumber #'transparent = ##t
    \guitar
  }
  \new TabStaff {
    \guitar
  }
>>
@end lilypond

Las ligaduras de unión que cruzan saltos de línea llevan paréntesis de
forma predeterminada.  Lo mismo rige para la casilla de segunda vez de
una repetición.

@lilypond[quote,ragged-right,verbatim]
ties = \relative c' {
  \repeat volta 2 {
    e2. f4~
    f2 g2~
  }
  \alternative {
     { g4 f2. }
     { g4\repeatTie c,2. }
  }
  b1~
  \break
  b1
  \bar "|."
}

\score {
  <<
    \new StaffGroup  <<
      \context Staff {
        \clef "treble_8"
        \ties
      }
      \context TabStaff {
        \ties
      }
    >>
  >>
  \layout {
  indent = #0
  ragged-right = ##t
  }
}
@end lilypond

@funindex \hideSplitTiedTabNotes

La instrucción @code{\hideSplitTiedTabNotes} cancela el comportamiento
de imprimir los números de traste entre paréntesis:

@lilypond[quote,ragged-right,verbatim]
ties = \relative c' {
  \repeat volta 2 {
    e2. f4~
    f2 g2~ }
  \alternative {
    { g4 f2. }
    { g4\repeatTie c,2. }
  }
  b1~
  \break
  b1
  \bar "|."
}

\score {
  <<
    \new StaffGroup  <<
      \context Staff {
        \clef "treble_8"
        \ties
      }
      \context TabStaff {
      \hideSplitTiedTabNotes
        \ties
      }
    >>
  >>
  \layout {
  indent = #0
  ragged-right = ##t
  }
}
@end lilypond


@cindex armónicos en tablatura
@cindex tablatura y armónicos
@cindex deslizamientos en notación de tablatura
@cindex tablatura y deslizamientos
@cindex glissandos de acordes
@funindex \harmonic
@funindex \harmonicByFret
@funindex \harmonicByRatio
@funindex \chordGlissando

Se pueden añadir indicaciones de armónicos a la notación de tablatura
como sus alturas de sonido:

@lilypond[verbatim,quote]
firstHarmonic = {
  <d'\4\harmonic>4
  <g'\3\harmonic>4
  <b'\2\harmonic>2
}
\score {
  <<
    \new Staff { \firstHarmonic }
    \new TabStaff { \firstHarmonic }
  >>
}
@end lilypond

Observe que la instrucción @code{\harmonic} se debe situar siempre
dentro de una construcción de acorde. Sólo tiene sentido para
armónicos sobre una cuerda abierta en el duodécimo traste.  Cualquier
otro armónico debe estar calculado por parte de LilyPond.  Se puede
conseguir esto indicando el traste en que debe rozar la cuerda el dedo
de la mano que pisa.


@lilypond[verbatim,quote]
fretHarmonics = {
  \harmonicByFret #5 d16\4
  \harmonicByFret #4 d16\4
  \harmonicByFret #3 d8\4
  \harmonicByFret #5 <g\3 b\2>2.
}
\score {
  <<
    \new Staff { \fretHarmonics }
    \new TabStaff { \fretHarmonics }
  >>
}
@end lilypond

De forma alternativa, se pueden calcular los armónicos definiendo la
razón de las longitudes de cuerda por encima y por debajo de la
digitación de armónico.

@lilypond[verbatim,quote]
ratioHarmonics = {
  \harmonicByRatio #1/2 <g\3 b\2 e'\1>4
  \harmonicByRatio #1/3 <g\3 b\2 e'\1>4
  \harmonicByRatio #1/4 { g8\3 b8\2 e'4\1 }
}
\score {
  <<
    \new Staff { \ratioHarmonics }
    \new TabStaff { \ratioHarmonics }
  >>
}
@end lilypond


@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{stem-and-beam-behavior-in-tablature.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{polyphony-in-tablature.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{open-string-harmonics-in-tablature.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{fretted-string-harmonics-in-tablature.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{slides-in-tablature.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{chord-glissando-in-tablature.ly}


@seealso
Referencia de la notación:
@ref{Plicas},
@ref{Armónicods},
@ref{Glissando}.

Fragmentos de código:
@rlsr{Fretted strings}.

Referencia de funcionamiento interno:
@rinternals{TabNoteHead},
@rinternals{TabStaff},
@rinternals{TabVoice},
@rinternals{Beam}.


@knownissues

Los acordes no se tratan de una forma especial, y de aquí que el
selector automático de la cuerda puede elegir fácilmente la misma
cuerda para dos notas del acorde.

Para manejar @code{\partcombine}, es necesario que @code{TabStaff}
utilice voces especialmente creadas:

@lilypond[quote,ragged-right,verbatim]
melodia = \partcombine { e4 g g g } { e4 e e e }
<<
  \new TabStaff <<
    \new TabVoice = "one" s1
    \new TabVoice = "two" s1
    \new TabVoice = "shared" s1
    \new TabVoice = "solo" s1
    { \melodia }
  >>
>>
@end lilypond

Los efectos especiales de guitarra se limitan a armónicos y @emph{slides}.

@node Tablaturas personalizadas
@unnumberedsubsubsec Tablaturas personalizadas
@translationof Custom tablatures

@cindex tablaturas personalizadas
@cindex tablatura de banjo
@cindex tablatura de mandolina
@cindex tablatura de guitarra
@cindex tablatura de bajo
@cindex tablatura de ukelele
@cindex tablatura de violin
@cindex tablatura de viola
@cindex tablatura de violoncello
@cindex tablatura de bajo
@cindex tablatura de contrabajo
@cindex tablatura, afinaciones predefinidas de
@cindex trastes, instrumentos con, afinaciones predefinidas
@cindex predefinidas, afinaciones, para instrumentos de traste

@funindex StringTunings

La tablatura en LilyPond calcula automáticamente el traste para cada
nota, basándose en la cuerda a que está asignada la nota.  Para
hacerlo, es necesario especificar la afinación de las cuerdas.  La
afinación de las cuerdas se da en la propiedad @code{stringTunings}.

LilyPond trae afinaciones predefinidas para el banjo, la mandolina, la
guitarra, el bajo, el ukelele, el violín, la viola, el violoncello y
el contrabajo.  LilyPond establece automáticamente la transposición
correcta para las afinaciones predefinidas.  El ejemplo siguiente es
para bajo, que suena una octava por debajo de lo escrito.

@lilypond[quote,ragged-right,verbatim]
<<
  \new Staff {
    \clef "bass_8"
    \relative c, {
      c4 d e f
    }
  }
  \new TabStaff {
    \set TabStaff.stringTunings = #bass-tuning
    \relative c, {
      c4 d e f
    }
  }
>>
@end lilypond

La afinación por omisión es @code{guitar-tuning} (la afinación
estándar Mi-La-Re-Sol-Si-Mi).  Otras afinaciones predefinidas son
@code{guitar-open-g-tuning} (Sol Mayor al aire, Re-Sol-Re-Sol-Si-Re),
@code{mandolin-tuning} (mandolina) y @code{banjo-open-g-tuning} (banjo
con Sol Mayor al aire).  Las afinaciones predefinidas están en
@file{ly/string-tuning-init.ly}.

@funindex contextStringTunings
@funindex \contextStringTunings
@cindex tablaturas, afinaciones personalizadas
@cindex personalizadas, afinaciones de cuerdas

Es posible crear cualquier afinación de cuerdas que se desee.  Se
puede usar la función @code{\contextStringTuning} para definir una
afinación de cuerdas y establecerla como el valor de
@code{stringTunings} para el contexto actual.
@code{\contextStringTuning} admite dos argumentos: el símbolo en que
se almacena la afinación de cuerdas y una construcción de acorde
que define la altura de las notas de cada cuerda al aire en dicha
afinación.  La construcción de acorde debe estar en el modo de
octava absoluto, véase @ref{Escritura de octava absoluta}.
La cuerda con el número más alto (generalmente la más grave)
debe ir primero en el acorde.  Por ejemplo, podemos definir una
afinación para un instrumento de cuatro cuerdas con las alturas
@code{a''}, @code{d''}, @code{g'} y @code{c'}:

@lilypond[quote,verbatim]

mynotes = {
  c'4 e' g' c'' |
  e''4 g'' b'' c'''
}

<<
  \new Staff {
    \clef treble
    \mynotes
  }
  \new TabStaff {
    \contextStringTuning #'custom-tuning <c' g' d'' a''>
    \mynotes
  }
>>
@end lilypond

La propiedad @code{stringTunings} también se utiliza por parte de
@code{FretBoards} para calcular los diagramas de posición automáticos.

@funindex makeStringTuning
@funindex \makeStringTuning

Las afinaciones de cuerdas se utilizan como parte de la clave de
asociación para los diagramas de posición predefinidos (véase
@ref{Diagramas predefinidos de trastes}).  Se usa la función
@code{\makeStringTuning} para crear una afinación sin fijar el valor
de la propiedad @code{stringTunings} en el contexto actual.  Los
argumentos de @code{\makeStringTuning} son el símbolo que usar para la
nueva afinación y una construcción de acorde que se usa para definir
la afinación.  El ejemplo anterior también se podría haber escrito
como sigue:

@lilypond[quote,verbatim]
\makeStringTuning #'custom-tuning <c' g' d'' a''>

mynotes = {
  c'4 e' g' c'' |
  e''4 g'' b'' c'''
}

<<
  \new Staff {
    \clef treble
    \mynotes
  }
  \new TabStaff {
    \set TabStaff.stringTunings = #custom-tuning
    \mynotes
  }
>>
@end lilypond

Internamente, una afinación de las cuerdas es una lista de Scheme de
alturas, una por cada cuerda, ordenadas de 1 a N, donde la cuerda 1
está arriba en la pauta de tablatura y la cuerda N está abajo.  Esto
resulta generalmente en un orden de la nota más aguda a la más grave,
pero algunos instrumentos (p.ej. el ukelele) no tienen las cuerdas
dispuestas en orden de altura.

La altura de una cuerda dentro de una lista de alturas de cuerdas es
un objeto altura de LilyPond.  Los objetos altura se crean con la
función de Scheme @code{ly:make-pitch} (véase
@ref{Funciones de Scheme}).

Se así se desea, puede crearse una afinación de cuerdas como un
literal de Scheme.  El ejemplo de abajo recrea los ejemplos
anteriores, pero la afinación no se guarda como un objeto separado:

@lilypond[quote,verbatim]
mynotes = {
  c'4 e' g' c'' |
  e''4 g'' b'' c'''
}

<<
  \new Staff {
    \clef treble
    \mynotes
  }
  \new TabStaff {
    \set TabStaff.stringTunings = #`(,(ly:make-pitch 1 5 0)
                                     ,(ly:make-pitch 1 1 0)
                                     ,(ly:make-pitch 0 4 0)
                                     ,(ly:make-pitch 0 0 0))
    \mynotes
  }
>>
@end lilypond

LilyPond calcula automáticamente el número de líneas dentro del
@code{TabStaff} y el número de cuerdas dentro de un @code{FretBoard}
calculado automáticamente como el número de elementos de
@code{stringTunings}.

@cindex moderntab, clave
@cindex clave moderntab
@cindex clave de tablatura
@cindex tablatura, clave de

También se puede usar una clave moderna de tablatura.

@lilypond[quote,ragged-right,verbatim]
\new TabStaff {
  \clef moderntab
  <a, e a>1
  \break
  \clef tab
  <a, e a>1
}
@end lilypond

La clave moderna de tablatura contempla tablaturas de 4 a 7 cuerdas.

@seealso
Referencia de la notación:
@ref{Escritura de octava absoluta},
@ref{Diagramas predefinidos de trastes},
@ref{Funciones de Scheme}.

Archivos instalados:
@file{ly/string-tuning-init.ly}
@file{scm/tablature.scm}.

Fragmentos de código:
@rlsr{Fretted strings}.

Referencia de funcionamiento interno:
@rinternals{Tab_note_heads_engraver}.

@knownissues
Los cálculos de tablatura automáticos no funcionan bien en la mayoría
de los casos para instrumentos en que la afinación de las cuerdas no
varía de forma monótona con el número de cuerda, como el ukelele.


@node Marcas de diagramas de trastes
@unnumberedsubsubsec Marcas de diagramas de trastes
@translationof Fret diagram markups

@cindex trastes, diagramas de
@cindex acordes, diagramas de
@cindex diagramas de trastes
@cindex diagramas de acordes para instrumentos de trastes
@cindex trastes, diagramas de, personalizados
@cindex personalizados, diagramas de trastes

Se pueden añadir diagramas de trastes a la música como elementos de
marcado sobre la nota deseada.  El marcado contiene información sobre
el diagrama de trastes deseado.  Existen tres interfaces distintos de
marcado de diagramas de trastes: standard (estándar), terse (escueto)
y verbose (prolijo).  Los tres interfaces producen marcados
equivalentes, pero tienen cantidades variables de información en la
cadena de marcado.  Hay más detalles sobre la sintaxis de las distintos
cadenas de marcado que se usan para definir diagramas de posiciones en
@ref{Instrument Specific Markup}.

La cadena de marcado de los diagramas estándar de trastes indica el
número de la cuerda y el número de traste en que se coloca cada uno de
los puntos sobre la cuerda.  Además se pueden indicar cuerdas al aire
y cuerdas mudas (que no se tocan).

@lilypond[quote, verbatim]
<<
  \context ChordNames {
    \chordmode {
      c1 d:m
    }
  }
  \context Staff {
    \clef "treble_8"
    <c e g c' e'>1^\markup {
      \fret-diagram #"6-x;5-3;4-2;3-o;2-1;1-o;"
    }
    <d a d' f'>1^\markup {
      \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-1;"
    }
  }
>>
@end lilypond

@cindex cejilla, indicación de

Las indicaciones de cejilla se pueden añadir al diagrama a partir de
la cadena de marcado del diagrama de trastes.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       f1 g
     }
  }
  \context Staff {
    \clef "treble_8"
    <f, c f a c' f'>1^\markup {
      \fret-diagram #"c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
    }
    <g, d g b d' g'>1^\markup {
      \fret-diagram #"c:6-1-3;6-3;5-5;4-5;3-4;2-3;1-3;"
    }
  }
>>
@end lilypond

@cindex fret-diagram, marcado con
@cindex ukelele

@funindex fret-diagram
@funindex \fret-diagram

El tamaño del diagrama de trastes y el número de trastes del diagrama,
se puede cambiar en la cadena de marcado @code{fret-diagram}.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
     \chordmode {
       f1 g
     }
  }
  \context Staff {
    \clef "treble_8"
    <f, c f a c' f'>1^\markup {
      \fret-diagram #"s:1.5;c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
    }
    <g, b, d g b g'>1^\markup {
      \fret-diagram #"h:6;6-3;5-2;4-o;3-o;2-o;1-3;"
    }
  }
>>
@end lilypond

Se puede cambiar el número de cuerdas de un diagrama de trastes para
que se adapte a distintos instrumentos como el bajo y el ukelele, con
la cadena de marcado del diagrama.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
    \chordmode {
      a1
    }
  }
  \context Staff {
    % An 'A' chord for ukulele
    a'1^\markup {
      \fret-diagram #"w:4;4-2-2;3-1-1;2-o;1-o;"
    }
  }
>>
@end lilypond

Se pueden añadir indicaciones de digitación, y la posición de las
etiquetas de los dedos se puede controlar mediante la cadena de
marcado del diagrama.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
    \chordmode {
      c1 d:m
    }
  }
  \context Staff {
    \clef "treble_8"
    <c e g c' e'>1^\markup {
      \fret-diagram #"f:1;6-x;5-3-3;4-2-2;3-o;2-1-1;1-o;"
    }
    <d a d' f'>1^\markup {
      \fret-diagram #"f:2;6-x;5-x;4-o;3-2-2;2-3-3;1-1-1;"
    }
  }
>>
@end lilypond

Se puede controlar el radio y la posición de los puntos con la cadena
de marcado @code{fret-diagram}.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
    \chordmode {
      c1 d:m
    }
  }
  \context Staff {
    \clef "treble_8"
    <c e g c' e'>1^\markup {
      \fret-diagram #"d:0.35;6-x;5-3;4-2;3-o;2-1;1-o;"
    }
    <d a d' f'>1^\markup {
      \fret-diagram #"p:0.2;6-x;5-x;4-o;3-2;2-3;1-1;"
    }
  }
>>
@end lilypond

@cindex fret-diagram-terse, marcado con

@funindex fret-diagram-terse
@funindex \fret-diagram-terse

La cadena de marcado de diagrama de trastes escueta,
@code{fret-diagram-terse}, omite los números de la cuerda; el número
de cuerda viene implícito por la presencia del punto y coma.  Hay un
punto y coma por cada cuerda del diagrama.  El primer punto y coma
corresponde al número de cuerda más alto, y el último punto y coma
corresponde a la primera cuerda.  Se pueden indicad cuerdas mudas, al
aire y números de traste.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
    \chordmode {
      c1 d:m
    }
  }
  \context Staff {
    \clef "treble_8"
    <c e g c' e'>1^\markup {
      \fret-diagram-terse #"x;3;2;o;1;o;"
    }
    <d a d' f'>1^\markup {
      \fret-diagram-terse #"x;x;o;2;3;1;"
    }
  }
>>
@end lilypond

Se pueden incluir números de cejilla en la cadena de marcado escueta
@code{fret-diagram-terse}.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
    \chordmode {
      f1 g
    }
  }
  \context Staff {
    \clef "treble_8"
    <f, c f a c' f'>1^\markup {
      \fret-diagram-terse #"1-(;3;3;2;1;1-);"
    }
    <g, d g b d' g'>1^\markup {
      \fret-diagram-terse #"3-(;5;5;4;3;3-);"
    }
  }
>>
@end lilypond

Se pueden incluir indicaciones de digitación en la cadena de marcado
escueta @code{fret-diagram-terse}

@c Need to use override to enable fingerings to show this -- can we do so?
@lilypond[quote, verbatim]
<<
  \context ChordNames {
    \chordmode {
      c1 d:m
    }
  }
  \context Staff {
    \override Voice.TextScript
      #'(fret-diagram-details finger-code) = #'below-string
    \clef "treble_8"
    <c e g c' e'>1^\markup {
      \fret-diagram-terse #"x;3-3;2-2;o;1-1;o;"
    }
    <d a d' f'>1^\markup {
      \fret-diagram-terse #"x;x;o;2-2;3-3;1-1;"
    }
  }
>>
@end lilypond

Otras propiedades de los diagramas de trastes se deben
ajustar usando @code{\override} al utilizar el marcado
escueto con fret-diagram-terse.

@cindex fret-diagram-verbose, marcado con
@cindex capo

@funindex fret-diagram-verbose
@funindex \fret-diagram-verbose

La cadena de marcado prolija @code{fret-diagram-verbose} está en el
formato de una lista de Scheme.  Cada elemento de la lista indica la
colocación un elemento sobre el diagrama de trastes.

@lilypond[quote, verbatim]
<<
    \context ChordNames {
      \chordmode {
        c1 d:m
      }
    }
  \context Staff {
    \clef "treble_8"
    <c e g c' e'>1^\markup {
      \fret-diagram-verbose #'(
        (mute 6)
        (place-fret 5 3)
        (place-fret 4 2)
        (open 3)
        (place-fret 2 1)
        (open 1)
      )
    }
    <d a d' f'>1^\markup {
      \fret-diagram-verbose #'(
        (mute 6)
        (mute 5)
        (open 4)
        (place-fret 3 2)
        (place-fret 2 3)
        (place-fret 1 1)
      )
    }
  }
>>
@end lilypond

Se pueden incluir digitaciones y cejillas en una cadena de marcado
prolija @code{fret-diagram-verbose}.  Es exclusiva del interfaz de
fret-diagram-verbose la indicación @q{capo} que se puede colocar sobre
el diagrama de posición.  La indicación de capo es una barra gruesa
que cubre todas las cuerdas.  El traste que tiene el capo es el más
bajo del diagrama de posición.

@c \override is necessary to make fingering visible
@lilypond[quote, verbatim]
<<
    \context ChordNames {
      \chordmode {
        f1 g c
      }
    }
  \context Staff {
    \clef "treble_8"
    \override Voice.TextScript
      #'(fret-diagram-details finger-code) = #'below-string
    <f, c f a c' f'>1^\markup {
      \fret-diagram-verbose #'(
        (place-fret 6 1)
        (place-fret 5 3)
        (place-fret 4 3)
        (place-fret 3 2)
        (place-fret 2 1)
        (place-fret 1 1)
        (barre 6 1 1)
      )
    }
    <g, b, d g b g'>1^\markup {
      \fret-diagram-verbose #'(
        (place-fret 6 3 2)
        (place-fret 5 2 1)
        (open 4)
        (open 3)
        (open 2)
        (place-fret 1 3 3)
      )
    }
    <c e g c' e'>1^\markup {
      \fret-diagram-verbose #'(
        (capo 3)
        (mute 6)
        (place-fret 4 5 1)
        (place-fret 3 5 2)
        (place-fret 2 5 3)
      )
    }
  }
>>
@end lilypond

Todas las otras propiedades de diagrama de trastes se deben ajustar
utilizando @code{\override} cuando se usa el marcado prolijo con
fret-diagram-verbose.

@ignore
The following example shows the three fret-diagram markup
interfaces, along with examples of common tweaks.  For example,
the size of the verbose fret diagram is reduced to 0.75, and the
finger indications are specified to appear below the diagram.  The
terse diagram includes tweaks to specify placement of finger code
and color of dots.

@lilypond[verbatim,ragged-right,quote]
\new Voice {
  \clef "treble_8"
  d4^\markup {
    \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
  }
  d4 d d
  fis^\markup {
    \override #'(size . 0.75) {
      \override #'(finger-code . below-string) {
        \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
                                 (place-fret 5 4 3)
                                 (place-fret 4 4 4)
                                 (place-fret 3 3 2)
                                 (place-fret 2 2 1)
                                 (place-fret 1 2 1))
      }
    }
  }
  fis4 fis fis
  c^\markup {
    \override #'(dot-radius . 0.35) {
      \override #'(finger-code . in-dot) {
        \override #'(dot-color . white) {
          \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
        }
      }
    }
  }
  c4 c c
}
@end lilypond
@end ignore

@cindex personalizados, diagramas de trastes
@cindex trastes, diagramas personalizados de
@cindex diagrama de trastes personalizado

@funindex fret-diagram-interface

El aspecto gráfico de un diagrama de trastes se puede personalizar
según las preferencias del usuario a través de las propiedades del
interface @code{fret-diagram-interface}.  Los detalles están en
@rinternals{fret-diagram-interface}.  Para un marcado de diagrama de
trastes, las propiedades del interface pertenecen a
@code{Voice.TextScript}.

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{changing-fret-orientations.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{customizing-markup-fret-diagrams.ly}

@seealso
Referencia de la notación:
@ref{Instrument Specific Markup}.

Fragmentos de código:
@rlsr{Fretted strings}.

Referencia de funcionamiento interno:
@rinternals{fret-diagram-interface}.


@node Diagramas predefinidos de trastes
@unnumberedsubsubsec Diagramas predefinidos de trastes
@translationof Predefined fret diagrams

@cindex diagramas de posiciones
@cindex diagramas de posiciones de ukelele
@cindex diagramas de posiciones de mandolina
@cindex diagramas de acordes

@funindex FretBoards
@funindex stringTunings

Se pueden imprimir los diagramas de trastes usando el contexto
@code{FretBoards}.  De forma predeterminada, el contexto
@code{FretBoards} imprime diagramas de trastes que están almacenados
en una tabla de búsqueda:

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"
\context FretBoards {
  \chordmode {
    c1 d
  }
}
@end lilypond

Los diagramas de traste predefinidos están en el archivo
@file{predefined-guitar-fretboards.ly}.  Los diagramas de trastes se
almacenan tomando como base las notas de un acorde y el valor de
@code{stringTunings} que se está utilizando en cada momento.
@file{predefined-guitar-fretboards.ly} contiene diagramas de traste
predefinidos sólo para @code{guitar-tuning}.  Los diagramas de traste
predefinidos se pueden añadir para otros instrumentos u otras
afinaciones siguiendo los ejemplos que aparecen en
@file{predefined-guitar-fretboards.ly}.

Los diagramas de posiciones para el ukelele están en el archivo
@file{predefined-ukulele-fretboards.ly}.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-ukulele-fretboards.ly"

myChords = \chordmode { a1 a:m a:aug }

\new ChordNames {
  \myChords
}

\new FretBoards {
  \set stringTunings = #ukulele-tuning
  \myChords
}
@end lilypond

Los diagramas de posiciones para la mandolina
están contenidos en el archivo
@file{predefined-mandolin-fretboards.ly}.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-mandolin-fretboards.ly"

myChords = \chordmode { c1 c:m7.5- c:aug }

\new ChordNames {
  \myChords
}

\new FretBoards {
  \set stringTunings = #mandolin-tuning
  \myChords
}
@end lilypond

Las notas de los acordes se pueden introducir como música simultánea o
bien usando el modo de acordes (véase
@ref{Panorámica del modo de acordes}).

@lilypond[verbatim, ragged-right,quote]
\include "predefined-guitar-fretboards.ly"
\context FretBoards {
  \chordmode { c1 }
  <c' e' g'>1
}
@end lilypond

@cindex acordes, diagramas de trastes con nombres de
@cindex trastes, diagramas de, con nombres de acorde

@funindex ChordNames
@funindex chordmode
@funindex \chordmode

Es corriente que se impriman juntos los nombres de acorde y los
diagramas de traste.  Esto se puede hacer poniendo un contexto de
nombres de acorde @code{ChordNames} en paralelo con un contexto de
trastes @code{FretBoards} y dando a los dos contextos el mismo
contenido musical.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"
mychords = \chordmode{
  c1 f g
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

@cindex transporte de diagramas de trastes
@cindex trastes, diagramas de, transporte
@cindex diagramas de traste, transporte de los

Los diagramas de traste predefinidos se pueden transportar, en la
medida en que esté almacenado un diagrama para el acorde transportado,
en la tabla de diagramas de traste.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"
mychords = \chordmode{
  c1 f g
}

mychordlist = {
  \mychords
  \transpose c e { \mychords }
}
<<
  \context ChordNames {
    \mychordlist
  }
  \context FretBoards {
    \mychordlist
  }
>>
@end lilypond


La tabla de diagramas de traste predefinidos para la guitarra contiene
ocho acordes (mayor, menor, aumentado, disminuido, séptima dominante,
séptima mayor, menor séptima y novena domniante) para 17 tonalidades
distintas.  La tabla de diagramas predefinidos para el ukelele
contiene estos acordes y además otros tres (sexta mayor, segunda
suspendida y cuarta suspendida).  Se puede ver una lista completa de
los diagramas de traste predefinidos en
@ref{Diagramas predefinidos de trastes}.
Si no hay una entrada en la tabla para un acorde, el
grabador FretBoards calcula un cadena de diagrama fret-diagram usando
la funcionalidad de diagramas automáticos que se describe en
@ref{Diagramas de traste automáticos}.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"
mychords = \chordmode{
  c1 c:maj9
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

@cindex trastes personalizados, añadir diagramas de
@cindex personalizados, añadir diagramas de traste
@cindex diagramas de trastes personalizados, añadir

Se pueden añadir diagramas de posiciones a la tabla de diagramas de
posiciones.  Para añadir un diagrama debemos especificar la
tabla de correspondencias para el diagrama, el acorde del
diagrama, la afinación utilizada y una definición del diagrama.
Normalmente la tabla de correspondencias será
@var{default-fret-table}.  La definición del diagrama puede ser
una cadena de definición escueta fret-diagram-terse o una lista
de marcados prolija fret-diagram-verbose.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"

\storePredefinedDiagram #default-fret-table
                        \chordmode { c:maj9 }
                        #guitar-tuning
                        #"x;3-2;o;o;o;o;"

mychords = \chordmode {
  c1 c:maj9
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

Se pueden almacenar distintos diagramas de traste para el mismo acorde
usando distintas octavas para las notas.  Las octavas de diferencia
deben ser al menos dos por encima o por debajo de la octava
predeterminada, porque las octavas inmediatas superior e inferior de
la predeterminada se utilizan para los trasteros transpositores.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"

\storePredefinedDiagram #default-fret-table
                        \chordmode { c'' }
                        #guitar-tuning
                        #(offset-fret 2 (chord-shape 'bes guitar-tuning))

mychords = \chordmode {
  c1 c''
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

@cindex trastes, instrumentos de, formas de acordes
@cindex acordes, formas de, en instrumentos de trastes

@funindex \addChordShape
@funindex addChordShape
@funindex storePredefinedDiagram
@funindex \storePredefinedDiagram

Además de los diagramas de traste, LilyPond almacena una lista interna
de formas de acorde.  Las formas de acorde son diagramas de traste que
se pueden desplazar por el mástil para dar acordes distintos.  Se
pueden añadir formas de acorde a la lista interna y luego usarlas para
definir diagramas de posición predefinidos.  Dado que se pueden mover
a distintas posiciones dentro del mástil, las formas de acorde
normalmente no contienen cuerdas al aire.  Como los diagramas de
posiciones, las formas de acorde se pueden introducir como cadenas
escuetas fret-diagram-terse o como listas de marcado prolijas
fret-diagram-verbose.

@lilypond[verbatim, ragged-right, quote]
\include "predefined-guitar-fretboards.ly"

% Add a new chord shape

\addChordShape #'powerf #guitar-tuning #"1-1;3-3;3-4;x;x;x;"

% add some new chords based on the power chord shape

\storePredefinedDiagram #default-fret-table
                        \chordmode { f'' }
                        #guitar-tuning
                        #(chord-shape 'powerf guitar-tuning)
\storePredefinedDiagram #default-fret-table
                        \chordmode { g'' }
                        #guitar-tuning
                        #(offset-fret 2 (chord-shape 'powerf guitar-tuning))

mychords = \chordmode{
  f1 f'' g g''
}

<<
  \context ChordNames {
    \mychords
  }
  \context FretBoards {
    \mychords
  }
>>
@end lilypond

El aspecto gráfico de un diagrama de traste se puede personalizar
según las preferencias del usuario a través de las propiedades del
interface @code{fret-diagram-interface}.  Los detalles están en
@rinternals{fret-diagram-interface}.  Para un diagrama de trastes
predefinido, las propiedades de interface pertenecen a
@code{FretBoards.FretBoard}.

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{customizing-fretboard-fret-diagrams.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{defining-predefined-fretboards-for-other-instruments.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{chordchanges-for-fretboards.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{fretboards-alternate-tables.ly}


@seealso
Referencia de la notación:
@ref{Tablaturas personalizadas},
@ref{Diagramas de traste automáticos},
@ref{Panorámica del modo de acordes},
@ref{Diagramas predefinidos de trastes}.

Archivos de inicio:
@file{ly/predefined-guitar-fretboards.ly},
@file{ly/predefined-guitar-ninth-fretboards.ly},
@file{ly/predefined-ukulele-fretboards.ly},
@file{ly/predefined-mandolin-fretboards.ly}.

Fragmentos de código:
@rlsr{Fretted strings}.

Referencia de funcionamiento interno:
@rinternals {fret-diagram-interface}.


@node Diagramas de traste automáticos
@unnumberedsubsubsec Diagramas de traste automáticos
@translationof Automatic fret diagrams

@cindex trastes, diagramas automáticos de
@cindex acordes, diagramas automáticos de
@cindex automáticos, diagramas de traste
@cindex automáticos, diagramas de acordes

Se pueden crear diagramas de traste automáticamente a partir de las
notas introducidas usando el contexto @code{FretBoards}.  Si no está
disponible ningún diagrama predefinido para las notas introducidas en
la afinación @code{stringTunings} activa, este contexto calcula las
cuerdas y los trastes que se pueden usar para tocar las notas.

@lilypond[quote,ragged-right,verbatim]
<<
  \context ChordNames {
    \chordmode {
      f1 g
    }
  }
  \context FretBoards {
    <f, c f a c' f'>1
    <g,\6 b, d g b g'>1
  }
  \context Staff {
    \clef "treble_8"
    <f, c f a c' f'>1
    <g, b, d g b' g'>1
  }
>>
@end lilypond

@funindex predefinedFretboardsOff
@funindex \predefinedFretboardsOff
@funindex predefinedFretboardsOn
@funindex \predefinedFretboardsOn

Puesto que de forma predeterminada no se carga ningún diagrama
predefinido, el comportamiento predeterminado es el cálculo automático
de los diagramas de traste.  Una vez que los diagramas predeterminados
se han cargado, se puede habilitar e inhabilitar el cálculo automático
con instrucciones predefinidas:

@lilypond[quote,ragged-right,verbatim]

\storePredefinedDiagram #default-fret-table
                        <c e g c' e'>
                        #guitar-tuning
                        #"x;3-1-(;5-2;5-3;5-4;3-1-1-);"
<<
  \context ChordNames {
    \chordmode {
      c1 c c
    }
  }
  \context FretBoards {
    <c e g c' e'>1
    \predefinedFretboardsOff
    <c e g c' e'>1
    \predefinedFretboardsOn
    <c e g c' e'>1
  }
  \context Staff {
    \clef "treble_8"
    <c e g c' e'>1
    <c e g c' e'>1
    <c e g c' e'>1
  }
>>
@end lilypond



A veces el calculador de trastes es incapaz de encontrar un diagrama
aceptable.  Esto se puede remediar generalmente mediante la asignación
manual de una nota a una cuerda.  En muchos casos sólo hay que colocar
manualmente una nota sobre una cuerda; el resto de las notas se
situará en el lugar adecuado por parte del contexto
@code{FretBoards}.

@cindex trastes, añadir digitaciones a diagramas de
@cindex digitaciones, añadir, a diagramas de trastes

Se pueden añadir digitaciones a los diagramas de traste del contexto
FretBoard.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
    \chordmode {
      c1 d:m
    }
  }
  \context FretBoards {
    <c-3 e-2 g c'-1 e'>1
    <d a-2 d'-3 f'-1>1
  }
  \context Staff {
    \clef "treble_8"
    <c e g c' e'>1
    <d a d' f'>1
  }
>>
@end lilypond

@funindex minimumFret

El traste mínimo que usar en el cálculo de cuerdas y trastes para el
contexto FretBoard se puede fijar con la propiedad @code{minimumFret}.

@lilypond[quote, verbatim]
<<
  \context ChordNames {
    \chordmode {
      d1:m d:m
    }
  }
  \context FretBoards {
    <d a d' f'>1
    \set FretBoards.minimumFret = #5
    <d a d' f'>1
  }
  \context Staff {
    \clef "treble_8"
    <d a d' f'>1
    <d a d' f'>1
  }
>>
@end lilypond

Las cuerdas y los trastes para el contexto @code{FretBoards} dependen
de la propiedad @code{stringTunings}, que tiene el mismo significado
que en el contexto de tablatura TabStaff.
Consulte @ref{Tablaturas personalizadas} para ver más información
sobre la propiedad @code{stringTunings}.

El aspecto gráfico de un diagrama de trastes se puede personalizar de
acuerdo a las preferencias del usuario a través de las propiedades del
interface @code{fret-diagram-interface}.  Los detalles están en
@rinternals{fret-diagram-interface}.  Para un diagrama de
@code{FretBoards}, las propiedades del interface pertenecen a
@code{FretBoards.FretBoard}.


@predefined
@code{\predefinedFretboardsOff},
@code{\predefinedFretboardsOn}.
@endpredefined


@seealso
Referencia de la notación:
@ref{Tablaturas personalizadas}.

Fragmentos de código:
@rlsr{Fretted strings}.

Referencia de funcionamiento interno:
@rinternals {fret-diagram-interface}.

@knownissues
Los cálculos de tablatura automáticos no funcionan bien para
instrumentos con afinaciones no monótonas.


@node Digitaciones de la mano derecha
@unnumberedsubsubsec Digitaciones de la mano derecha
@translationof Right-hand fingerings

@cindex trastes, instrumentos de, digitaciones de la derecha
@cindex digitaciones de la mano derecha para instrumentos de trastes
@cindex derecha, mano, digitaciones para instrumentos de traste

@funindex rightHandFinger
@funindex \rightHandFinger

Las digitaciones de la mano derecha @var{p-i-m-a} se deben introducir
dentro de una construcción de acorde @code{<>} para que se impriman en
la partitura, incluso si se aplican a una nota suelta.

@warning{@strong{Debe} haber un guión antes de
@code{@bs{}rightHandFinger} y un espacio antes del ángulo de cierre
@code{>}.}

@lilypond[quote,verbatim,relative=0]
\clef "treble_8"
<c-\rightHandFinger #1 >4
<e-\rightHandFinger #2 >
<g-\rightHandFinger #3 >
<c-\rightHandFinger #4 >
<c,-\rightHandFinger #1 e-\rightHandFinger #2
 g-\rightHandFinger #3 c-\rightHandFinger #4 >1
@end lilypond

Por brevedad, se puede escribir @code{\rightHandFinger} como algo más
corto, como por ejemplo @code{RH}:

@example
#(define RH rightHandFinger)
@end example


@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{placement-of-right-hand-fingerings.ly}

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{fingerings,-string-indications,-and-right-hand-fingerings.ly}


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

Referencia de funcionamiento interno:
@rinternals{StrokeFinger}.


@node Guitarra
@subsection Guitarra
@translationof Guitar

Casi todos los asuntos de notación relacionados con la música para
guitarra están suficientemente cubiertos en la sección general sobre
ajustes de instrumentos de trastes, pero hay algunos más de los que
merece la pena hablar aquí.  De forma ocasional, los usuarios quieren
crear documentos del tipo de cancioneros que tengan sólo la letra de
las canciones con indicaciones de acordes sobre ella.  Dado que
LilyPond es un tipografiador de música, no se recomienda para
documentos que no tienen notación musical.  Una alternativa mejor es
un procesador de texto, editor de texto o, para usuarios con
experiencia, un tipografiador como GuitarTeX.

@menu
* Indicar la posición y la cejilla::
* Indicar armónicos y notas tapadas::
* Indicación de acordes de potencia o de quinta vacía::
@end menu


@node Indicar la posición y la cejilla
@unnumberedsubsubsec Indicar la posición y la cejilla
@translationof Indicating position and barring

@cindex posición y cejilla, indicación para instrumentos de trastes
@cindex trastes, instrumentos de, indicación de la posición y cejilla

Este ejemplo muestra cómo incluir indicaciones de posición y cejilla
de guitarra:

@lilypond[quote,ragged-right,verbatim,relative=0]
\clef "treble_8"
b16 d g b e
\textSpannerDown
\override TextSpanner #'(bound-details left text) = #"XII "
g16\startTextSpan
b16 e g e b g\stopTextSpan
e16 b g d
@end lilypond


@seealso
Referencia de la notación:
@ref{Extensiones de texto}.

Fragmentos de código:
@rlsr{Fretted strings},
@rlsr{Expressive marks}.


@node Indicar armónicos y notas tapadas
@unnumberedsubsubsec Indicar armónicos y notas tapadas
@translationof Indicating harmonics and dampened notes

@cindex trastes, notas tapadas en instrumentos de
@cindex trastes, armónicos en instrumentos de
@cindex tapadas, notas, en instrumentos de trastes
@cindex armónicos en instrumentos de trastes

Se pueden usar cabezas de nota especiales para indicar notas apagadas
o armónicos.  Los armónicos se suelen explicar de forma más completa
con un marcado de texto.

@lilypond[quote,ragged-right,verbatim]
\relative c' {
  \clef "treble_8"
  \override Staff.NoteHead #'style = #'harmonic-mixed
  d^\markup { \italic { \fontsize #-2 { "harm. 12" }}} <g b>1
}
@end lilypond

Las notas tapadas (llamadas también @notation{notas muertas}) están
contempladas dentro de los pentagramas normales y de tablatura:

@lilypond[quote,ragged-right,verbatim]
music = \relative c' {
  < a\3 \deadNote c\2 a'\1 >4
  < b\3 \deadNote d\2 b'\1 >
  < c\3 \deadNote e\2 c'\1 >
  \deadNotesOn
  \times 2/3 { g8 b e }
  \deadNotesOff
  < a,\3 c\2 e\1 >1
}
\new StaffGroup <<
  \new Staff {
    \clef "treble_8"
    \music
  }
  \new TabStaff {
    \music
  }
>>
@end lilypond

Otra téctnica de ejecución (utilizada especialmente en la guitarra
eléctrica) se llama @notation{tapado de palma}.  La cuerda es
parcialmente tapada por la palma de la mano que pulsa (de ahí el
nombre).  Lilypond contempla la notación de las notas de estilo de
tapado de palma mediante el cambio de la forma de la cabeza de nota a
un triángulo.

@lilypond[quote,ragged-right,verbatim]
\new Voice { % Warning: explicit Voice instantiation is
             %    required to have palmMuteOff work properly
             %    when palmMuteOn comes at the beginning of
             %    the piece.
  \relative c, {
    \clef "G_8"
    \palmMuteOn
    e8^\markup { \musicglyph #"noteheads.u2do"  = palm mute }
    < e b' e > e
    \palmMuteOff
    e e  \palmMute e e e |
    e8 \palmMute { e e e } e e e e |
    < \palmMute e b' e >8 \palmMute { e e e } < \palmMute e b' e >2
  }
}
@end lilypond

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

Referencia de la notación:
@ref{Cabezas de nota especiales},
@ref{Estilos de cabezas de nota}.


@node Indicación de acordes de potencia o de quinta vacía
@unnumberedsubsubsec Indicación de acordes de potencia o de quinta vacía
@translationof Indicating power chords

@funindex powerChords
@funindex \powerChords

@cindex potencia, acordes de
@cindex acordes de potencia
@cindex acordes de quinta vacía
@cindex quinta vacía, acordes de
@cindex vacía, acordes de quinta

Los acordes de quinta vacía o acordes de potencia
(@emph{power chords}) y sus símbolos se pueden tipografiar
en el modo de acordes o como construcciones de acorde normales:

@lilypond[quote,ragged-right,verbatim]
ChordsAndSymbols = {
  \chordmode {
    \powerChords
    e,,1:1.5
    a,,1:1.5.8
    \set minimumFret = #8
    c,1:1.5
    f,1:1.5.8
  }
  \set minimumFret = #5
  <a, e>1
  <g d' g'>1
}
\score {
  <<
    \new ChordNames {
    \ChordsAndSymbols
    }
    \new Staff {
      \clef "treble_8"
      \ChordsAndSymbols
    }
    \new TabStaff {
      \ChordsAndSymbols
    }
  >>
}
@end lilypond

Los símbolos de acordes de quinta vacía se desactivan automáticamente
tan pronto como se utiliza cualquiera de los otros modificadores de
acorde:

@lilypond[quote,ragged-right,verbatim]
mixedChords = \chordmode {
  c,1
  \powerChords
  b,,1:1.5
  fis,,1:1.5.8
  g,,1:m
}
\score {
  <<
    \new ChordNames {
      \mixedChords
    }
    \new Staff {
      \clef "treble_8"
      \mixedChords
    }
    \new TabStaff {
      \mixedChords
    }
  >>
}
@end lilypond

@seealso
Glosario musical:
@rglos{power chord}.

Referencia de la notación:
@ref{Acordes extendidos y alterados},
@ref{Impresión de los nombres de acorde}.

Fragmentos de código:
@rlsr{Fretted strings}.


@node Banjo
@subsection Banjo
@translationof Banjo

@menu
* Tablaturas de banjo::
@end menu

@node Tablaturas de banjo
@unnumberedsubsubsec Tablaturas de banjo
@translationof Banjo tablatures

@cindex banjo, tablaturas de
@cindex tablatura de banjo

LilyPond contempla el banjo de cinco cuerdas de una manera básica.
Cuando haga tablaturas para banjo de cinco cuerdas, utilice la función
de formato de tablatura de banjo para obtener los números correctos de
los trastes para la quinta cuerda:

@c due to crazy intervals of banjo music, absolute pitch is recommended

@lilypond[quote,ragged-right,verbatim]
\new TabStaff <<
  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
  \set TabStaff.stringTunings = #banjo-open-g-tuning
  {
    \stemDown
    g8 d' g'\5 a b g e d' |
    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
    g4
  }
>>
@end lilypond

@cindex banjo, afinaciones del
@cindex afinaciones del banjo

@funindex banjo-c-tuning
@funindex banjo-modal-tuning
@funindex banjo-open-d-tuning
@funindex banjo-open-dm-tuning
@funindex four-string-banjo

En LilyPond se encuentran predefinidas varias afinaciones comunes para
el banjo: @code{banjo-c-tuning} (sol-Do-Sol-Si-Re),
@code{banjo-modal-tuning} (sol-Re-Sol-Do-Re),
@code{banjo-open-d-tuning} (Re Mayor al aire, la-Re-Fa#-La-Re) y
@code{banjo-open-dm-tuning} (Re menor al aire, la-Re-Fa-La-Re).

Estas afinaciones se pueden convertir a afinaciones para bajo de
cuatro cuerdas utilizando la función @code{four-string-banjo}:

@example
\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
@end example


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

Archivos de inicio:
@file{scm/string-tunings-init.scm} contiene las afinaciones
predefinidas para el banjo.