Referencia de la notación de GNU LilyPond: 1.7.1 Dentro del pentagrama

### 1.7.1 Dentro del pentagrama

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

#### Seleccionar el tamaño de la tipografía para la notación

Nota:
Para el tamaño de la tipografía del texto, consulte Seleccionar la tipografía y su tamaño.
Para el tamaño del pentagrama, consulte Establecer el tamaño del pentagrama.
Para las notas guía, consulte Formateo de las notas guía.
Para los pentagramas de Ossia, consulte Pentagramas de Ossia.

Para modificar el tamaño de la notación sin cambiar el tamaño del pentagrama, especifique un factor de ampliación con la instrucción `\magnifyMusic`:

>     \new Staff <<
>       \new Voice \relative {
>         \voiceOne
>         <e' e'>4 <f f'>8. <g g'>16 <f f'>8 <e e'>4 r8
>       }
>       \new Voice \relative {
>         \voiceTwo
>         \magnifyMusic 0.63 {
>           \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
>           r32 c'' a c a c a c r c a c a c a c
>           r c a c a c a c a c a c a c a c
>         }
>       }
>     >>

El `\override` del ejemplo anterior es una solución provisional para solventar un fallo del programa. Consulte el apartado de “Problemas y advertencias conocidos” al final de esta sección.

Si una figura con un tamaño normal de cabeza se mezcla con otra más pequeña, el tamaño de la menor podría necesitar reiniciarse (con ‘`\once \normalsize`’) para que las plicas y las alteraciones accidentales mantengan una buena alineación:

>     \new Staff <<
>       \key fis \minor
>       \mergeDifferentlyDottedOn
>       \new Voice \relative {
>         \voiceOne
>         \magnifyMusic 0.63 {
>           \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
>           \once \normalsize cis'32( cis' gis b a fis \once \normalsize d d'
>           \once \normalsize cis, cis' gis b a gis \once \normalsize fis fis'
>           \once \normalsize fis, fis' ais, cis b gis \once \normalsize eis eis'
>           \once \normalsize a, a' bis, d cis b \once \normalsize gis gis')
>         }
>       }
>       \new Voice \relative {
>         \voiceTwo
>         cis'8. d16 cis8. fis16 fis8. eis16 a8. gis16
>       }
>     >>

La instrucción `\magnifyMusic` no está pensada para las notas guía, de adorno, o para los pentagramas de Ossia; existen métodos más apropiados para la introducción de cada uno de esos elementos. En vez de ello, es útil cuando el tamaño de la notación cambia dentro de una sola parte instrumental sobre un pentagrama, y cuando las notas de adorno no son adecuadas, como en pasajes de tipo cadencial o en casos como los de los ejemplos anteriores. Establecer el valor de `\magnifyMusic` a 0.63 duplica las dimensiones del contexto `CueVoice`.

Nota: La instrucción `\magnifyMusic` no debe utilizarse si se está cambiando el tamaño del pentagrama al mismo tiempo. Consulte Establecer el tamaño del pentagrama.

#### Cambiar el temaño de los objetos individuales

Un objeto de presentación individual se puede cambiar de tamaño usando las instrucciones `\tweak` u `\override` para ajustar su propiedad `font-size`:

>     \relative {
>       % resize a note head
>       <f' \tweak font-size -4 b e>-5
>       % resize a fingering
>       bes-\tweak font-size 0 -3
>       % resize an accidental
>       \once \override Accidental.font-size = -4 bes!-^
>       % resize an articulation
>       \once \override Script.font-size = 4 bes!-^
>     }

El valor predeterminado de `font-size` para cada objeto de presentación está relacionado en el Manual de Referencia de funcionamiento interno. La propiedad `font-size` solamente se puede fijar para los objetos de presentación que contemplan la interfaz de presentación `font-interface`. Si no está especificado `font-size` en la lista de ‘Ajustes estándar’ del objeto, su valor es 0. Véase All layout objects.

#### Comprensión de la propiedad `fontSize`

La propiedad de contexto `fontSize` ajusta el tamaño relativo de todos los elementos de notación basados en glifos dentro de un contexto:

>     \relative {
>       \time 3/4
>       d''4---5 c8( b a g) |
>       \set fontSize = -6
>       e'4-- c!8-4( b a g) |
>       \set fontSize = 0
>       fis4---3 e8( d) fis4 |
>       g2.
>     }

El valor de `fontSize` es un número que indica el tamaño relativo al tamaño estándar para la altura actual del pentagrama. El valor predeterminado de `fontSize` es 0; la adición de 6 a cualquier valor de `fontSize` duplica el tamaño impreso de los glifos, y la sustracción de 6 reduce el tamaño a la mitad. Cada paso aumenta el tamaño en un 12% aproximadamente.

La función de Scheme `magnification->font-size` se provee por conveniencia, pues las unidades logarítmicas de la propiedad `font-size` no son totalmente intuitivas. Por ejemplo, para ajustar la notación musical al 75% del tamaño predeterminado, usamos:

>     \set fontSize = #(magnification->font-size 0.75)

La función de Scheme `magstep` tiene el efecto opuesto: convierte un valor de `font-size` en un factor de ampliación.

La propiedad `fontSize` no afecta solamente a los elementos notacionales que se dibujan con glifos, como la cabeza de las figuras, las alteraciones accidentales, las inscripciones textuales, etc. No afecta al tamaño de la propia pauta, ni cambia la escala de las plicas, barras, o espaciado horizontal. Para cambiar la escala de las plicas, barras y el espaciado horizontal junto con el tamaño de la notación (sin cambiar el tamaño de la pauta), use la instrucción `\magnifyMusic` que se ha explicado anteriormente. Para cambiar la escala del tamaño de todo, incluida la pauta, véase Establecer el tamaño del pentagrama.

Siempre que se establece el valor de la propiedad de contexto `fontSize`, su valor se añade al valor de la propiedad de objeto gráfico `font-size` para los objetos de presentación individuales, antes de que se imprima cualquiera de los glifos. Esto puede causar confusión cuando se fija el valor de las propiedades `font-size` individuales mientras `fontSize` ya está fijado:

>     % the default font-size for NoteHead is 0
>     % the default font-size for Fingering is -5
>     c''4-3

>     \set fontSize = -3
>     % the effective font size for NoteHead is now -3
>     % the effective font size for Fingering is now -8
>     c''4-3

>     \override Fingering.font-size = 0
>     % the effective font size for Fingering is now -3
>     c''4-3

Las siguientes instrucciones de atajo también están disponibles:

Instrucción | Equivalente a | Tamaño relativo
`\teeny` | `\set fontSize = -3` | 71%
`\tiny` | `\set fontSize = -2` | 79%
`\small` | `\set fontSize = -1` | 89%
`\normalsize` | `\set fontSize = 0` | 100%
`\large` | `\set fontSize = 1` | 112%
`\huge` | `\set fontSize = 2` | 126%

>     \relative c'' {
>       \teeny
>       c4.-> d8---3
>       \tiny
>       c4.-> d8---3
>       \small
>       c4.-> d8---3
>       \normalsize
>       c4.-> d8---3
>       \large
>       c4.-> d8---3
>       \huge
>       c4.-> d8---3
>     }

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 `font-size = 0`) depende de la altura estándar del pentagrama. Para un pentagrama de 20 puntos, se selecciona una fuente de 11 puntos.

#### Instrucciones predefinidas

`\magnifyMusic`, `\teeny` (enano), `\tiny` (muy pequeño), `\small` (pequeño), `\normalsize` (normal), `\large` (grande), `\huge` (enorme).

#### Véase también

Notation Reference: Seleccionar la tipografía y su tamaño, Establecer el tamaño del pentagrama, Formateo de las notas guía, Pentagramas de Ossia.

Installed Files: ‘`ly/music-functions-init.ly`’, ‘`ly/property-init.ly`’.

Fragmentos de código: Editorial annotations.

Referencia de funcionamiento interno: font-interface.

#### Advertencias y problemas conocidos

Actualmente hay dos fallos del programa que impiden un correcto espaciado horizontal al usar `\magnifyMusic`. Solamente existe una forma de esquivarlo, y su funcionamiento correcto no está garantizado en todos los casos. En el ejemplo que aparece a continuación, sustituya la variable mag con su valor preferido. También puede tratar de quitar una o ambas instrucciones `\newSpacingSection`, y/o las instrucciones `\override` y `\revert`:

>     \magnifyMusic mag {
>       \newSpacingSection
>       \override Score.SpacingSpanner.spacing-increment = #(* 1.2 mag)
>       [music]
>       \newSpacingSection
>       \revert Score.SpacingSpanner.spacing-increment
>     }

#### Indicaciones de digitación

Las instrucciones de digitación se pueden introducir usando ‘`nota-dígito`’:

>     \relative { c''4-1 d-2 f-4 e-3 }

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

>     \relative {
>       c''4-1 d-2 f\finger \markup \tied-lyric "4~3" c\finger "2 - 3"
>     }

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

>     \relative { <a'_\thumb a'-3>2 <b_\thumb b'-3> }

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

>     \relative {
>       <c''-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
>     }

Las indicaciones de digitación se pueden situar manualmente encima o debajo del pentagrama, véase Dirección y posición.

#### Fragmentos de código seleccionados

Controlar la colocación de las digitaciones de acordes

Se puede controlar con precisión la colocación de los números de digitación. Para que se tenga en cuenta la orientación de las digitaciones, se debe utilizar dentro de una construcción de acorde <> aunque sea una sola nota. Se puede establecer la orientación para los números de cuerda y las digitaciones de la mano derecha de una forma similar.

>     \relative c' {
>       \set fingeringOrientations = #'(left)
>       <c-1 e-3 a-5>4
>       \set fingeringOrientations = #'(down)
>       <c-1 e-3 a-5>4
>       \set fingeringOrientations = #'(down right up)
>       <c-1 e-3 a-5>4
>       \set fingeringOrientations = #'(up)
>       <c-1 e-3 a-5>4
>       \set fingeringOrientations = #'(left)
>       <c-1>2
>       \set fingeringOrientations = #'(down)
>       <e-3>2
>       \set stringNumberOrientations = #'(up left down)
>       <f\3 a\2 c\1>1
>       \set strokeFingerOrientations = #'(down right up)
>       <c\rightHandFinger #1 e\rightHandFinger #2 c'\rightHandFinger #4 >
>     }

Permitir que las digitaciones se impriman dentro del pentagrama

Las cifras de digitación orientadas verticalmente se colocan de forma predeterminada fuera del pentagrama. Sin embargo, este comportamiento se puede cancelar. Hay que prestar atención en situaciones en las que las digitaciones y las plicas están en la misma dirección: por defecto, las digitaciones solo evitan la colisión con plicas unidas por una barra. Se puede cambiar este ajuste para no evitar ninguna plica o evitarlas todas; el ejemplo siguiente muestra las dos copciones, así como la manera de volver al comportamiento predeteminado.

>     \relative c' {
>       <c-1 e-2 g-3 b-5>2
>       \override Fingering.staff-padding = #'()
>       <c-1 e-2 g-3 b-5>4 g'-0
>       a8[-1 b]-2 g-0 r
>       \override Fingering.add-stem-support = ##f
>       a[-1 b]-2 g-0 r
>       \override Fingering.add-stem-support = ##t
>       a[-1 b]-2 g-0 r
>       \override Fingering.add-stem-support = #only-if-beamed
>       a[-1 b]-2 g-0 r
>     }

#### Véase también

Referencia de la notación: Dirección y posición.

Fragmentos de código: Editorial annotations.

Referencia de funcionamiento interno: FingeringEvent, fingering-event, Fingering_engraver, New_fingering_engraver, Fingering.

#### Notas ocultas

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

>     \relative {
>       c''4 d
>       \hideNotes
>       e4 f
>       \unHideNotes
>       g a
>       \hideNotes
>       b
>       \unHideNotes
>       c
>     }

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.

>     \relative c'' {
>       e8(\p f g a)--
>       \hideNotes
>       e8(\p f g a)--
>     }

#### Instrucciones predefinidas

`\hideNotes`, `\unHideNotes`.

#### Véase también

Manual de aprendizaje: Visibilidad y color de los objetos.

Notation Reference: Silencios invisibles, Visibilidad de los objetos, Ocultar pentagramas.

Fragmentos de código: Editorial annotations.

Referencia de funcionamiento interno: Note_spacing_engraver, NoteSpacing.

#### Colorear objetos

Se pueden asignar colores a los objetos individuales. Los nombres de color válidos se encuentran relacionados en la Lista de colores.

>     \override NoteHead.color = #red
>     c''4 c''
>     \override NoteHead.color = #(x11-color 'LimeGreen)
>     d''
>     \override Stem.color = "deepskyblue"
>     e''

Además de un conjunto limitado de colores sencillos que están disponibles como variables predefinidas (véase ‘Colores normales’ dentro de Lista de colores), se puede introducir cualquier color como una cadena de caracteres. Dicha cadena puede ser un nombre predefinido de color al estilo de CSS, o un código de color hexadecimal con el carácter `#` como prefijo (dentro de las comillas):

>     \override NoteHead.color = "lightsalmon"
>     \override Flag.color = "#E30074"
>     \override Beam.color = "#5e45ad"
>     \override Rest.color = "#3058"
>     g'8 \huge r4 a'16 f'

Si dicho color incluye un canal alfa para la semitransparencia mediante el uso de un código de ocho caracteres del tipo "#RRGGBBAA" o su forma abreviada "#RGBA", se usará en la salida de SVG pero no en la salida de PostScript/PDF. En el ejemplo anterior, el silencio es semitransparente solo si el código se compila con el backend de SVG, como se explica en Formatos de salida alternativos.

De manera completamente distinta, se puede acceder al rango de colores completo definido para X11 mediante el uso de la función de Scheme `x11-color`. Esta función admite un argumento que puede ser un símbolo, como `'DarkSeaGreen4`, o una cadena de caracteres, como `"DarkSeaGreen4"`. La primera manera es más rápida de escribir y ligeramente más eficiente; sin embargo la segunda forma permite además especificar colores de X11 como frases de varias palabras: en el ejemplo, `"dark sea green 4"`.

Si `x11-color` no entiende el parámetro, el color predeterminado que se devuelve es el negro.

>     \new Staff \with {
>       instrumentName = \markup {
>         \with-color #(x11-color 'red) "Clarinet"
>         }
>       }
>       \relative c'' {
>       \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
>       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
>     }

Se pueden especificar colores RGB exactos utilizando la función de Scheme `rgb-color`. Esta función admite tres argumentos que se utilizan respectivamente para los canales rojo, verde y azul, y un número de alfa opcional para la semitransparencia (todos los valores deben ser números entre 0 y 1). De nuevo, la transparencia solo se contempla en la salida de SVG; por ejemplo, en el fragmento siguiente la clave es semitransparente cuando se produce un documento SVG.

>     \new Staff \with {
>         instrumentName = \markup {
>           \with-color #(x11-color 'red) "Clarinet"
>           }
>         \override Clef.color = #(rgb-color 0 0 0 0.5)
>       }
>     \relative c'' {
>       \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
>       \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
>     }

#### Véase también

Referencia de la notación: Lista de colores, La instrucción `\tweak`.

Fragmentos de código: Editorial annotations.

#### Advertencias y problemas conocidos

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 `LimeGreen` (verde lima) y `ForestGreen` (verde bosque). Para la web se recomiendan los colores de CSS, como aparece detallado en Lista de colores.

Las notas de un acorde no se pueden colorear individualmente con `\override`; en su lugar utilice `\tweak` o su equivalente `\single\override` antes de la nota respectiva. Consulte La instrucción `\tweak` para ver más detalles.

#### Paréntesis

Los objetos se pueden encerrar entre paréntesis anteponiendo `\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.

>     \relative {
>       c''2 \parenthesize d
>       c2 \parenthesize <c e g>
>       c2 <c \parenthesize e g>
>     }

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 `\parenthesize`.

>     \relative {
>       c''2-\parenthesize -. d
>       c2 \parenthesize r
>     }

#### Véase también

Fragmentos de código: Editorial annotations.

Referencia de funcionamiento interno: Parenthesis_engraver, ParenthesesItem, parentheses-interface.

#### Advertencias y problemas conocidos

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.

#### Plicas

Cuando se encuentra con una nota, se crea automáticamente un objeto `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 Dirección y posición.

#### Instrucciones predefinidas

`\stemUp`, `\stemDown`, `\stemNeutral`.

#### Fragmentos de código seleccionados

Dirección predeterminada de las plicas sobre la tercera línea del pentagrama

La dirección predeterminada de las plicas sobre la tercera línea del pentagrama está determinada por la propiedad `neutral-direction` del objeto `Stem`.

>     \relative c'' {
>       a4 b c b
>       \override Stem.neutral-direction = #up
>       a4 b c b
>       \override Stem.neutral-direction = #down
>       a4 b c b
>     }

Cambiar la dirección de la plica de las notas de la tercera línea automáticamente, basado en la melodía

LilyPond puede alterar la dirección de la plica de las notas que van en la tercera línea de un pentagrama de forma que siga la melodía, mediante la adición del grabador `Melody_engraver` al contexto Voice y sobreescribiendo el valor de `neutral-direction` para el objeto Stem (plica).

>     \relative c'' {
>       \time 3/4
>       a8 b g f b g |
>       c  b d c b c |
>     }

>     \layout {
>       \context {
>         \Voice
>         \consists "Melody_engraver"
>         \autoBeamOff
>         \override Stem.neutral-direction = #'()
>       }
>     }

#### Véase también

Referencia de la notación: Dirección y posición.

Fragmentos de código: Editorial annotations.

Referencia de funcionamiento interno: Stem_engraver, Stem, stem-interface.

#### LilyPond — Referencia de la notación v2.22.2 (rama estable).