Include `freetype.hh' where appropriate.

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

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

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

@node Anotaciones editoriales
@section Anotaciones editoriales
@translationof 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
* Dentro del pentagrama::
* Fuera del pentagrama::
@end menu


@node Dentro del pentagrama
@subsection Dentro del pentagrama
@translationof Inside the staff

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

@menu
* Seleccionar el tamaño de la tipografía para la notación::
* Indicaciones de digitación::
* Notas ocultas::
* Colorear objetos::
* Paréntesis::
* Plicas::
@end menu

@node Seleccionar el tamaño de la tipografía para la notación
@unnumberedsubsubsec Seleccionar el tamaño de la tipografía para la notación
@translationof 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{Seleccionar la tipografía y su tamaño}.}

@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 Indicaciones de digitación
@unnumberedsubsubsec Indicaciones de digitación
@translationof Fingering instructions

@cindex digitación
@cindex cambio de dedo

@funindex \finger
@funindex finger

Las instrucciones de digitación se pueden introducir usando
@samp{@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 o de cadenas de caracteres.

@lilypond[verbatim,quote,relative=2]
c4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\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 violoncello).

@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 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{Dirección y posición}.

@snippets

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

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

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

@seealso
Referencia de la notación:
@ref{Dirección y posición}.

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 Notas ocultas
@unnumberedsubsubsec Notas ocultas
@translationof 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

La cabeza, la plica y el corchete de las figuras, así como los
silencios, son invisibles.  Las barras son invisibles si comienzan en
una nota oculta.  Los objetos de notación que están anclados a notas
invisibles, son a pesar de ello visibles.

@lilypond[verbatim,quote,relative=2]
e8(\p f g a)--
\hideNotes
e8(\p f g a)--
@end lilypond

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

@seealso
Manual de aprendizaje:
@rlearning{Visibilidad y color de los objetos}.

Notation Reference:
@ref{Silencios invisibles},
@ref{Visibilidad de los objetos},
@ref{Ocultar pentagramas}.

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

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


@node Colorear objetos
@unnumberedsubsubsec Colorear objetos
@translationof 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{Lista de colores}.

@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 @code{@var{'FulanoMengano}}
o una cadena de la forma @code{"@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{Lista de colores},
@ref{La instrucción tweak}.

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{La instrucción tweak} para
ver más detalles.


@node Paréntesis
@unnumberedsubsubsec Paréntesis
@translationof Parentheses

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

@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.
Para las articulaciones se necesita un guión antes de la instrucción
@code{\parenthesize}.

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

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

Referencia de funcionamiento 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 Plicas
@unnumberedsubsubsec Plicas
@translationof Stems

@cindex plica
@cindex plica invisible
@cindex invisible, plica
@cindex plica, dirección
@cindex plica arriba
@cindex plica abajo
@cindex plica neutral

@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.

Se puede hacer manualmente que las plicas apunten hacia arriba o hacia
abajo; véase @ref{Dirección y posición}.

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

@snippets

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

@seealso
Referencia de la notación:
@ref{Dirección y posición}.

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

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


@node Fuera del pentagrama
@subsection Fuera del pentagrama
@translationof Outside the staff

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

@menu
* Globos de ayuda::
* Líneas de rejilla::
* Corchetes de análisis::
@end menu

@node Globos de ayuda
@unnumberedsubsubsec Globos de ayuda
@translationof 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 como
@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 Líneas de rejilla
@unnumberedsubsubsec Líneas de rejilla
@translationof 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,quote,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 Corchetes de análisis
@unnumberedsubsubsec Corchetes de análisis
@translationof 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}.