@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is included from notation.itely
@ignore
    Translation of GIT committish: 41ef91786a08102d9b9a839f6a2f40cec263d723

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  See TRANSLATION for details.
@end ignore

@c \version "2.12.0"

@node Editorial annotations
@section Editorial annotations

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

Esta sección trata de las diversas maneras de modificar el aspecto de
las notas y de aplicar énfasis analítico o educativo.

@menu
* Inside the staff::
* Outside the staff::
@end menu


@node Inside the staff
@subsection Inside the staff

Esta sección trata sobre cómo aplicar énfasis a los elementos situados
dentro del pentagrama.

@menu
* Selecting notation font size::
* Fingering instructions::
* Hidden notes::
* Coloring objects::
* Parentheses::
* Stems::
@end menu

@node Selecting notation font size
@unnumberedsubsubsec Selecting notation font size

@cindex fuente tipográfica (de notación), tamaño
@cindex selección del tamaño de la fuente tipográfica (de notación)
@cindex notación, tamaño de la fuente
@cindex notas, cabezas de

@funindex fontSize
@funindex font-size
@funindex magstep
@funindex \huge
@funindex \large
@funindex \normalsize
@funindex \small
@funindex \tiny
@funindex \teeny
@funindex huge
@funindex large
@funindex normalsize
@funindex small
@funindex tiny
@funindex teeny

Se puede alterar el tamaño de la fuente tipográfica de los elementos
de notación.  Esto no cambia el tamaño de los símbolos variables, como
las barras de corchea o las ligaduras.

@warning{Para los tamaños de tipografía del texto, consulte
@ref{Selecting font and font size}.}

@lilypond[verbatim,quote,relative=2]
\huge
c4.-> d8---3
\large
c4.-> d8---3
\normalsize
c4.-> d8---3
\small
c4.-> d8---3
\tiny
c4.-> d8---3
\teeny
c4.-> d8---3
@end lilypond

Internamente, esto establece un valor para la propiedad
@code{fontSize}.  Esto, a su vez, hace que se establezca el valor de
la propiedad @code{font-size} de todos los objetos de presentación.
El valor de @code{font-size} es un número que indica el tamaño con
relación al tamaño estándar para la altura vigente del pentagrama.
Cada unidad hacia arriba es un incremento de un 12% del tamaño de la
fuente, aproximadamente.  Seis unidades son exactamente un factor de
dos.  La función de Scheme @code{magstep} convierte un número de
tamaño @code{font-size} a un factor de escalado.  La propiedad
@code{font-size} también se puede establecer directamente, de forma
que queden afectados solamente determinados objetos gráficos.

@lilypond[verbatim,quote,relative=2]
\set fontSize = #3
c4.-> d8---3
\override NoteHead #'font-size = #-4
c4.-> d8---3
\override Script #'font-size = #2
c4.-> d8---3
\override Stem #'font-size = #-5
c4.-> d8---3
@end lilypond

@cindex estándar, tamaño de la tipografía (de notación)
@cindex fuente tipográfica (de notación), tamaño estándar de

@funindex font-interface
@funindex font-size

Los cambios en el tamaño de la fuente se obtienen por medio del
escalado del tamaño del diseño que se encuentra más cerca del tamaño
deseado.  El tamaño estándar para la tipografía (para @code{font-size
= #0}), depende de la altura estándar del pentagrama.  Para un
pentagrama de 20 puntos, se selecciona una fuente de 10 puntos.

La propiedad @code{font-size} sólo se puede establecer en objetos
gráficos que utilicen fuentes tipográficas.  Éstos son los que
contemplan el interfaz de presentación @code{font-interface}.


@predefined
@code{\teeny} (enano),
@code{\tiny} (muy pequeño),
@code{\small} (pequeño),
@code{\normalsize} (normal),
@code{\large} (grande),
@code{\huge} (enorme).
@endpredefined


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

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


@node Fingering instructions
@unnumberedsubsubsec Fingering instructions

@cindex digitación
@cindex cambio de dedo

@funindex \finger
@funindex finger

Las instrucciones de digitación se pueden introducir usando
@var{nota}-@var{dígito}:

@lilypond[verbatim,quote,relative=2]
c4-1 d-2 f-4 e-3
@end lilypond

Para los cambios de dedo se pueden usar elementos de marcado de texto.

@lilypond[verbatim,quote,relative=2]
c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
@end lilypond

@cindex thumb-script

@funindex \thumb
@funindex thumb

Puede usar la articulación de pulgar para indicar que una nota se debe
tocar con el pulgar (p.ej. en música de cello).

@lilypond[verbatim,quote,relative=2]
<a_\thumb a'-3>2 <b_\thumb b'-3>
@end lilypond

@cindex digitación de acordes
@cindex digitación, instrucciones de, para acordes
@cindex acordes, digitación de

Las digitaciones para los acordes también se pueden añadir a las notas
individuales del acorde escribiéndolas después de las alturas.

@lilypond[verbatim,quote,relative=2]
<c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
@end lilypond

Las indicaciones de digitación se pueden situar manualmente encima o
debajo del pentagrama, véase @ref{Direction
and placement}.

@snippets

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

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

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{avoiding-collisions-with-chord-fingerings.ly}


@seealso
Referencia de la notación:
@ref{Direction and placement}.

Fragmentos de código:
@rlsr{Editorial annotations}.

Referencia de funcionamiento interno:
@rinternals{FingeringEvent},
@rinternals{fingering-event},
@rinternals{Fingering_engraver},
@rinternals{New_fingering_engraver},
@rinternals{Fingering}.


@node Hidden notes
@unnumberedsubsubsec Hidden notes

@cindex ocultas, notas
@cindex invisibles, notas
@cindex transparentes, notas
@cindex notas ocultas
@cindex notas invisibles
@cindex notas transparentes

@funindex \hideNotes
@funindex hideNotes
@funindex \unHideNotes
@funindex unHideNotes

Las notas ocultas (o invisibles, o transparentes) pueden ser de
utilidad en la preparación de ejercicios de teoría o de composición.

@lilypond[verbatim,quote,relative=2]
c4 d
\hideNotes
e4 f
\unHideNotes
g a
\hideNotes
b
\unHideNotes
c
@end lilypond

Los objetos de notación que están anclados a notas invisibles, son a
pesar de ello visibles.

@lilypond[verbatim,quote,relative=2]
c4( d)
\hideNotes
e4(\p f)--
@end lilypond


@predefined
@code{\hideNotes},
@code{\unHideNotes}.
@endpredefined


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

Referencia de funcionamiento interno:
@rinternals{Note_spacing_engraver},
@rinternals{NoteSpacing}.


@node Coloring objects
@unnumberedsubsubsec Coloring objects

@cindex coloreados, objetos
@cindex colores
@cindex colorear objetos
@cindex objetos, colorear
@cindex coloreadas, notas
@cindex colorear notas
@cindex notas coloreadas
@cindex x11, color de
@cindex x11-color
@cindex colores de x11
@cindex with-color

@funindex color
@funindex \with-color
@funindex with-color
@funindex x11-color

Se pueden asignar colores a los objetos individuales.  Los nombres de
color válidos se encuentran relacionados en la @ref{List of colors}.

@lilypond[verbatim,quote,relative=2]
\override NoteHead #'color = #red
c4 c
\override NoteHead #'color = #(x11-color 'LimeGreen)
d
\override Stem #'color = #blue
e
@end lilypond

Se puede acceder al espectro completo de colores definido para X11
usando la función de Scheme x11-color.  Esta función acepta un único
argumento; éste puede ser un símbolo de la forma @var{'FulanoMengano}
o una cadena de la forma @var{"FulanoMengano"}.  La primera forma es
más rápida de escribir y también más eficiente.  Sin embargo, al usar
la segunda forma es posible acceder a los colores de X11 por medio de
la forma del nombre que tiene varias palabras.

Si @code{x11-color} no entiende el parámetro, el color predeterminado
que se devuelve es el negro.

@lilypond[verbatim,quote,relative=2]
\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
\set Staff.instrumentName = \markup {
  \with-color #(x11-color 'navy) "Clarinet"
}

gis8 a
\override Beam #'color = #(x11-color "medium turquoise")
gis a
\override Accidental #'color = #(x11-color 'DarkRed)
gis a
\override NoteHead #'color = #(x11-color "LimeGreen")
gis a
% this is deliberate nonsense; note that the stems remain black
\override Stem #'color = #(x11-color 'Boggle)
b2 cis
@end lilypond

@cindex rgb-color
@cindex color rgb
@cindex rgb, color

@funindex rgb-color

Se pueden especificar colores RGB exactos utilizando la función de
Scheme @code{rgb-color}.

@lilypond[verbatim,quote,relative=2]
\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
\set Staff.instrumentName = \markup {
  \with-color #(x11-color 'navy) "Clarinet"
}

\override Stem #'color = #(rgb-color 0 0 0)
gis8 a
\override Stem #'color = #(rgb-color 1 1 1)
gis8 a
\override Stem #'color = #(rgb-color 0 0 0.5)
gis4 a
@end lilypond


@seealso
Referencia de la notación:
@ref{List of colors},
@ref{The tweak command}.

Fragmentos de código:
@rlsr{Editorial annotations}.


@cindex x11,  color de
@cindex coloreadas, notas de acorde
@cindex notas coloreadas en acordes
@cindex color en acordes

@funindex x11-color

@knownissues
Un color de X11 no es necesariamente de la misma tonalidad exacta que
un color normal de nombre similar.

No todos los colores de X11 se distinguen entre sí en un navegador
web, es decir, un navegador de web podría no mostrar ninguna
diferencia entre @code{'LimeGreen} (verde lima) y @code{'ForestGreen}
(verde bosque).  Para la web se recomiendan los colores normales (o
sea: @code{#blue}, azul, @code{#green}, verde, @code{#red}, rojo).

Las notas de un acorde no se pueden colorear con @code{\override}; en
su lugar utilice @code{\tweak}.  Consulte @ref{The tweak command} para
ver más detalles.


@node Parentheses
@unnumberedsubsubsec Parentheses

@cindex fantasma, notas
@cindex notas fantasma
@cindex notas entre paréntesis
@cindex paréntesis

@funindex \parenthesize
@funindex parenthesize

Los objetos se pueden encerrar entre paréntesis anteponiendo
@code{\parenthesize} al evento musical.  Si se aplica a un acorde,
encierra cada nota dentro de un par de paréntesis.  También se pueden
poner entre paréntesis las notas individuales de un acorde.

@lilypond[verbatim,quote,relative=2]
c2 \parenthesize d
c2 \parenthesize <c e g>
c2 <c \parenthesize e g>
@end lilypond

Los objetos que no son notas también se pueden poner entre paréntesis.

@lilypond[verbatim,quote,relative=2]
c2-\parenthesize -. d
c2 \parenthesize r
@end lilypond


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

Referencia de funciionamiento interno:
@rinternals{Parenthesis_engraver},
@rinternals{ParenthesesItem},
@rinternals{parentheses-interface}.

@knownissues

Al poner un acorde entre paréntesis, se encierra cada una de las notas
individuales entre paréntesis, en vez de un solo paréntesis grande
rodeando al acorde completo.


@node Stems
@unnumberedsubsubsec Stems

@cindex plica
@cindex plica invisible
@cindex invisible, plica

@funindex \stemUp
@funindex stemUp
@funindex \stemDown
@funindex stemDown
@funindex \stemNeutral
@funindex stemNeutral

Cuando se encuentra con una nota, se crea automáticamente un objeto
@code{Stem} (plica).  Para las redondas y los silencios, también se
crean pero se hacen invisibles.

@predefined
@code{\stemUp},
@code{\stemDown},
@code{\stemNeutral}.
@endpredefined

@snippets

@cindex stem, direction
@cindex stem, up
@cindex stem, down
@cindex stem, neutral

@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{default-direction-of-stems-on-the-center-line-of-the-staff.ly}


@seealso
Referencia de la notación:
@ref{Direction and placement}.

Fragmentos de código:
@rlsr{Editorial annotations}.

Referencia de funcionamiento interno:
@rinternals{Stem_engraver},
@rinternals{Stem},
@rinternals{stem-interface}.


@node Outside the staff
@subsection Outside the staff

Esta sección trata sobre cómo enfatizar elementos que están dentro del
pentagrama, desde fuera del pentagrama.

@menu
* Balloon help::
* Grid lines::
* Analysis brackets::
@end menu

@node Balloon help
@unnumberedsubsubsec Balloon help

@cindex globo
@cindex notación, explicación de
@cindex globo de ayuda
@cindex ayuda, globos de

@funindex \balloonGrobText
@funindex \balloonText
@funindex Balloon_engraver
@funindex balloonGrobText
@funindex balloonText
@funindex \balloonLengthOn
@funindex balloonLengthOn
@funindex \balloonLengthOff
@funindex balloonLengthOff

Los elementos de notación se pueden marcar y nombrar con la ayuda de
un cartel o globo de ayuda rectangular.  El propósito principal de
esta funcionalidad es la explicación de la notación.

@c KEEP LY
@lilypond[verbatim,quote,relative=2]
\new Voice \with { \consists "Balloon_engraver" }
{
  \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
  a8
  \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
  r
  <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
}
@end lilypond

Existen dos funciones musicales, @code{balloonGrobText} y
@code{balloonText}; el primero se usa como @code{\once\override} para
adjuntar un texto a cualquier grob, y el último se usa coqmo
@code{\tweak}, normalmente dentro de acordes, para adjuntar un texto a
una nota individual.

Los textos de globo normalmente influyen en el espaciado de las notas,
pero esto puede cambiarse:

@c KEEP LY
@lilypond[verbatim,quote,relative=2]
\new Voice \with { \consists "Balloon_engraver" }
{
  \balloonLengthOff
  \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
  a8
  \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
  r
  \balloonLengthOn
  <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
}
@end lilypond


@predefined
@code{\balloonLengthOn},
@code{\balloonLengthOff}.
@endpredefined


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

Referencia de funcionamiento interno:
@rinternals{Balloon_engraver},
@rinternals{BalloonTextItem},
@rinternals{balloon-interface}.


@node Grid lines
@unnumberedsubsubsec Grid lines

@cindex rejilla, líneas de
@cindex líneas de rejilla
@cindex vertical, línea, entre pentagramas
@cindex línea vertical entre pentagramas

@funindex Grid_point_engraver
@funindex Grid_line_span_engraver
@funindex gridInterval

Se pueden dibujar líneas verticales entre los pentagramas
sincronizadas con las notas.

Se debe usar el grabador @code{Grid_point_engraver} para crear los
puntos extremos de las líneas, mientras que el grabador
@code{Grid_line_span_engraver} se debe utilizar para trazar
efectivamente las líneas.  De forma predeterminada, esto centra las
líneas de rejilla horizontalmente debajo y al lado izquierdo de la
cabeza de las notas.  Las líneas de rejilla se extienden a partir de
línea media de los pentagramas.  El intervalo @code{gridInterval} debe
especificar la duración entre las líneas de rejilla.

@lilypond[verbatim,quote]
\layout {
  \context {
    \Staff
    \consists "Grid_point_engraver"
    gridInterval = #(ly:make-moment 1 4)
  }
  \context {
    \Score
    \consists "Grid_line_span_engraver"
  }
}

\score {
  \new ChoirStaff <<
    \new Staff \relative c'' {
      \stemUp
      c4. d8 e8 f g4
    }
    \new Staff \relative c {
      \clef bass
      \stemDown
      c4 g' f e
    }
  >>
}
@end lilypond

@snippets

@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{grid-lines--changing-their-appearance.ly}


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

Referencia de funcionamiento interno:
@rinternals{Grid_line_span_engraver},
@rinternals{Grid_point_engraver},
@rinternals{GridLine},
@rinternals{GridPoint},
@rinternals{grid-line-interface},
@rinternals{grid-point-interface}.


@node Analysis brackets
@unnumberedsubsubsec Analysis brackets

@cindex corchetes
@cindex fraseo, corchetes de
@cindex corchetes de fraseo
@cindex musicológico, análisis
@cindex análisis musicológico
@cindex notas, corchetes de agrupación de
@cindex horizontal, corchete
@cindex corchete horizontal

@funindex Horizontal_bracket_engraver
@funindex \startGroup
@funindex startGroup
@funindex \stopGroup
@funindex stopGroup

Los corchetes se usan en análisis musical para indicar la estructura
de las piezas musicales.  Están contemplados los corchetes
horizontales simples.

@lilypond[verbatim,quote]
\layout {
  \context {
    \Voice
    \consists "Horizontal_bracket_engraver"
  }
}
\relative c'' {
  c2\startGroup
  d\stopGroup
}
@end lilypond

Los corchetes de análisis se pueden anidar.

@lilypond[verbatim,quote]
\layout {
  \context {
    \Voice
    \consists "Horizontal_bracket_engraver"
  }
}
\relative c'' {
  c4\startGroup\startGroup
  d4\stopGroup
  e4\startGroup
  d4\stopGroup\stopGroup
}
@end lilypond


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

Referencia de funcionamiento interno:
@rinternals{Horizontal_bracket_engraver},
@rinternals{HorizontalBracket},
@rinternals{horizontal-bracket-interface},
@rinternals{Staff}.