Partial update of Changing Defaults

[lilypond.git] / Documentation / es / user / changing-defaults.itely

@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond.tely
@ignore
    Translation of GIT committish: fc68c2abd535ff0bad9c703982894317dfc4967f

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

@node Changing defaults
@chapter Changing defaults


El objetivo del diseño de LilyPond es proporcionar por defecto la más
alta calidad de los resultados.  A pesar de ello, podría tener que
cambiar este resultado por defecto.  La disposición sobre el papel se
controla a través de un amplio número de proverbiales @q{botones e
interruptores}.  Este capítulo no relaciona todos y cada uno de los
botones.  Más bien da una visión de conjunto sobre qué grupos de
controles se encuentran disponibles y explica la forma de hallar el
botón exacto que se debe utilizar para conseguir un determinado
efecto.


@cindex Referencia de funcionamiento interno

Los controles disponibles para los ajustes finos se describen en un
documento separado,
@iftex
el Manual de referencia de funcionamiento interno.
@end iftex
@ifnottex
la @ref{Top,Referencia de funcionamiento interno,,lilypond-internals}.
@end ifnottex
Dicho manual relaciona todas las variables, funciones y opciones que
se encuentran disponibles en LilyPond.  Está escrito como un documento
HTML, que se puede encontrar en
@c leave the @uref as one long line.
@uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,on@/-line},
pero que también va incluido en el paquete de la documentación de LilyPond.

Hay cuatro áreas en las que se pueden cambiar los valores por defecto:

@itemize
@item
Notación automática: cambiar la creación automática de los elementos
de notación.  Por ejemplo, cambiar las reglas de barrado de las
figuras.

@item
Salida: cambiar el aspecto de los objetos individuales.  Por ejemplo,
cambiar las direcciones de las plicas o la situación exacta de los
subíndices.

@item
Contexto: modificar aspectos de la traducción de los eventos musicales
en notación.  Por ejemplo, dar a cada pentagrama una indicación de
compás distinta.

@item
Disposición de la página: cambiar el aspecto visual del espaciado, los
saltos de línea y las dimensiones de la página.  Estas modificaciones
se discuten en @ref{Non-musical notation} y @ref{Spacing issues}.
@end itemize

Internamente, LilyPond utiliza el lenguaje Scheme (un dialecto de
LISP) para aportar la infraestructura.  La sobreescritura de las
decisiones de disposición da acceso efectivo a las interioridades del
programa, lo que requiere código de Scheme como entrada.  Los
elementos de Scheme se inauguran dentro de un archivo @code{.ly} con
el símbolo de cuadradillo @code{#}.@footnote{@rlearning{Scheme
tutorial} contiene un breve tutorial sobre la introducción de números,
listas, cadenas y símbolos en Scheme.}


@menu
* Interpretation contexts::     
* Explaining the Internals Reference::  
* Modifying properties::        
* Common properties::           
* Advanced tweaks::             
* old The \override command::   
* Discussion of specific tweaks::  
@end menu


@node Interpretation contexts
@section Interpretation contexts

Esta sección explica qué son los contextos y cómo modificarlos.

@menu
* Contexts explained::          
* Creating contexts::           
* Modifying context plug-ins::  
* Changing context default settings::  
* Defining new contexts::       
* Aligning contexts::           
@end menu


@node Contexts explained
@subsection Contexts explained

Cuando se imprime la música, se tienen que añadir a la salida una gran
cantidad de elementos notacionales.  Por ejemplo, compare la entrada y
la salida del siguiente ejemplo:

@lilypond[quote,verbatim,relative=2,fragment]
cis4 cis2. g4
@end lilypond

La entrada es bastante escueta, pero en la salida se añaden líneas
divisorias, alteraciones accidentales, la clave y la indicación de
compás.  LilyPond @emph{interpreta} la entrada.  En esta fase se
inspecciona la información musical en orden temporal, de forma
parecida a la lectura de una partitura de izquierda a
derecha. Mientras se lee la entrada, el programa recuerda dónde se
encuentran los límites de los compases, y qué notas requieren
alteraciones explícitas.  Esta información se puede presentar sobre
varios niveles.  Por ejemplo, el efecto de una alteración accidental
se encuentra limitada a un solo pentagrama, mientras que una barra
divisoria debe estar sincronizada a través de la partitura de arriba a
abajo.

Dentro de LilyPond, estas reglas y pequeñas porciones de información
se agrupan en @emph{Contexts}.  Algunos ejemplos de contextos son
@code{Voice} (Voz), @code{Staff} (Pauta o pentagrama) y @code{Score}
(Partitura).  Los contextos son jerárquicos, por ejemplo: un
@code{Staff} contener muchas @code{Voice}s, y una @code{Score} puede
contener muchos contextos de @code{Staff}.

@quotation
@sourceimage{context-example,5cm,,}
@end quotation

Cada contexto asume la responsabilidad de imponer algunas reglas de
notación, creando ciertos objetos de notación y manteniendo las
propiedades asociadas.  Por ejemplo, el contexto @code{Voice} puede
introducir una alteración accidental y entonces el contexto
@code{Staff} mantiene la regla de mostrar o suprimir la alteración
para el resto del compás.  La sincronización de las líneas divisorias
se gestiona dentro del contexto de la partitura, @code{Score}.

Sin embargo, en algunas músicas posiblemente no queramos que las
líneas divisorias estén sincronizada (pensemos en una partitura
polimétrica en compases de 4/4 y de 3/4).  En tales casos, debemos
modificar los ajustes por omisión de los contextos @code{Score} y
@code{Staff}.

Para partituras muy sencillas, los contextos se crean implícitamente y
no debemos preocuparnos por ellos.  Para piezas mayores, como por
ejemplo cualquiera que tenga más de un pentagrama, los contextos se
deben crear explícitamente para asegurarnos de que tendremos la
cantidad exacta de pentagramas que necesitamos, y que están en el
orden correcto.  Para tipografiar piezas con notación especializada,
puede ser útil modificar contextos existentes o definir unos nuevos.


En la referencia del programa se encuentra una descripción completa de
todos los contextos que están disponibles, consulte
@ifhtml
@rinternals{Contexts}.
@end ifhtml
@ifnothtml
Traducción @expansion{} Contexto.
@end ifnothtml

@node Creating contexts
@subsection Creating contexts

Para partituras que sólo tienen una voz y un pentagrama, los contextos
se crean automáticamente.  Para partituras más complejas, es necesario
crearlos a mano.  Existen tres instrucciones que hacen esto.

@itemize

@item
La instrucción más fácil es @code{\new}, y es también la más rápida de
escribir.  Se antepone a una expresión musical, por ejemplo

@funindex \new
@cindex nuevos, contextos
@cindex Contexto, creación de

@example
\new @var{tipo} @var{expresión_musical}
@end example

@noindent
donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
@code{Voice}).  Esta instrucción crea un contexto nuevo, y empieza a
interpretar la @var{expresión_musical} con él.

Una aplicación práctica de @code{\new} es una partitura con muchos pentagramas.
Cada parte que debe ir en su propio pentagrama, va precedida de
@code{\new Staff}.

@lilypond[quote,verbatim,relative=2,ragged-right,fragment]
<<
  \new Staff { c4 c }
  \new Staff { d4 d }
>>
@end lilypond

La instrucción @code{\new} puede también dar nombre al contexto,

@example
\new @var{tipo} = @var{identificador} @var{música}
@end example
Sin embargo, este nombre especificado por el usuario sólo se utiliza
si no hay ya otro contexto anterior con el mismo nombre.


@funindex \context

@item
Como @code{\new}, la instrucción @code{\context} también dirige una
expresión musical a un objeto de contexto, pero da al contexto un
nombre explícito.  La sintaxis es

@example
\context @var{tipo} = @var{identificador} @var{música}
@end example

En esta forma, la instrucción buscará un contexto existente del
@var{tipo} especificado que tenga el nombre @var{identificador}.  Si
ese contexto aún no existe, se crea un contexto nuevo con el nombre
especificado.  Esto es útil si nos vamos a referir más tarde al
contexto.  Por ejemplo, cuando se escribe la letra, la melodía está
dentro de un contexto con nombre

@example
\context Voice = "@b{tenor}" @var{música}
@end example

@noindent
de forma que los textos se puedan alienar correctamente con sus notas,

@example
\new Lyrics \lyricsto "@b{tenor}" @var{letra}
@end example

@noindent

Otro uso posible de los contextos con nombre es la fusión de dos
expresiones musicales distintas en un solo contexto.  En el siguiente
ejemplo, se introducen por separado las articulaciones y las notas,

@example
musica = @{ c4 c4 @}
decoracion = @{ s4-. s4-> @}
@end example

se combinan enviando los dos al mismo contexto @code{Voice},

@example
<<
  \new Staff \context Voice = "A" \musica
  \context Voice = "A" \decoracion
>>
@end example
@lilypond[quote,ragged-right]
music = { c4 c4 }
arts = { s4-. s4-> }
\relative c'' <<
  \new Staff \context Voice = "A" \music
  \context Voice = "A" \arts
>>
@end lilypond

Con este mecanismo, es posible definir un Urtext (una edición
original), con la posibilidad de poner articulaciones distintas sobre
las mismas notas.

@cindex crear contextos

@item
La tercera instrucción para crear contextos es
@example
\context @var{tipo} @var{música}
@end example


@noindent
Esto es similar a @code{\context} con @code{= @var{identificador}},
pero se corresponde con cualquier contexto del tipo @var{tipo}, sin
importar qué nombre se le ha dado.

Esta variante se usa con expresiones musicales que se pueden
interpretar en varios niveles.  Por ejemplo, la instrucción
@code{\applyOutput} (véase @ref{Running a function on all layout
objects}).  Sin una instrucción @code{\context} explícita, normalmente
se aplicaría a @code{Voice}

@example
\applyOutput #'@var{contexto} #@var{función}   % aplicar al contexto Voice
@end example

Para que se interprete dentro de los niveles de @code{Score} o
@code{Staff}, utilice las siguientes formas:

@example
\applyOutput #'Score #@var{función}
\applyOutput #'Staff #@var{función}
@end example

@end itemize


@node Modifying context plug-ins
@subsection Modifying context plug-ins

Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
almacenan propiedades, también contienen «plug-ins» o complementos
llamados @q{grabadores} que crean elementos de notación.  Por ejemplo,
el contexto @code{Voice} contiene un grabador
@code{Note_head_engraver} que crea las cabezas de nota y el contexto
@code{Staff} contiene un grabador @code{Key_signature_engraver} que
crea la indicación de compás.

Para ver una descripción completa de todos y cada uno de los
complementos, consulte
@ifhtml
@rinternals{Engravers and Performers}.
@end ifhtml
@ifnothtml
Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
@end ifnothtml
Cada contexto que se describe en
@ifhtml
@rinternals{Contexts}
@end ifhtml
@ifnothtml
Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
@end ifnothtml
relaciona los grabadores que se usan para ese contexto.


Puede ser de utilidad jugar un poco con estos complementos.  Se hace
iniciando un contexto nuevo con @code{\new} o @code{\context} y
modificándolo:

@funindex \with

@example
\new @var{contexto} \with @{
  \consists @dots{}
  \consists @dots{}
  \remove @dots{}
  \remove @dots{}
  @emph{etc.}
@}
@{
  @emph{..música..}
@}
@end example

@noindent
donde los @dots{} debe ser el nombre de un grabador.  Aquí tenemos un
ejemplo sencillo que suprime los grabadores
@code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
@code{Staff}:

@lilypond[quote,relative=1,verbatim,fragment]
<<
  \new Staff {
    f2 g
  }
  \new Staff \with {
     \remove "Time_signature_engraver"
     \remove "Clef_engraver"
  } {
    f2 g2
  }
>>
@end lilypond

En el segundo pentagrama no hay indicación de compás ni clave.  Éste
es un método bastante rudimentario de hacer que desaparezcan los
objetos porque afecta a todo el pentagrama.  Este método también
afecta al espaciado, lo que puede ser deseable o no serlo.  Se
muestran métodos más sofisticados para quitar objetos en
@rlearning{Visibility and color of objects}.

EL ejemplo siguiente muestra una aplicación práctica.  Normalmente las
líneas divisorias y las indicaciones de compás están sincronizadas a
lo largo de toda la partitura.  Lo hacen los grabadores
@code{Timing_translator} y @code{Default_bar_line_engraver}.  Estos
complementos mantienen al día la administración de las indicaciones de
compás, posición dentro del compás, etc.  Moviendo estos grabadores
desde el contexto de @code{Score} al de @code{Staff}, podemos
conseguir una partitura en la que cada pentagrama tiene su propio
compás independiente.

@cindex polimétricas, partituras
@cindex compases distintos al mismo tiempo

@lilypond[quote,relative=1,ragged-right,verbatim,fragment]
\new Score \with {
  \remove "Timing_translator"
  \remove "Default_bar_line_engraver"
} <<
  \new Staff \with {
    \consists "Timing_translator"
    \consists "Default_bar_line_engraver"
  } {
      \time 3/4
      c4 c c c c c
  }
  \new Staff \with {
    \consists "Timing_translator"
    \consists "Default_bar_line_engraver"
  } {
       \time 2/4
       c4 c c c c c
  }
>>
@end lilypond


@node Changing context default settings
@subsection Changing context default settings

Los ajustes de las secciones previas ( @ref{The \set command},
@ref{Modifying context plug-ins} y @ref{Overview of modifying
properties}) también se pueden escribir separados de la música dentro
del bloque @code{\layout}:

@example
\layout @{
  @dots{}
  \context @{
    \Staff

    \set fontSize = #-2
    \override Stem #'thickness = #4.0
    \remove "Time_signature_engraver"
  @}
@}
@end example

La instrucción @code{\Staff} recupera la definición existente del
contexto de pentagrama de manera que se pueda modificar.

Los enunciados
@example
\set fontSize = #-2
\override Stem #'thickness = #4.0
\remove "Time_signature_engraver"
@end example

@noindent
afectan a todos los pentagramas de la partitura.  Otros contextos se
pueden modificar de forma análoga.

La palabra clave @code{\set} es opcional dentro del bloque
@code{\layout}, y así

@example
\context @{
  @dots{}
  fontSize = #-2
@}
@end example

@noindent
también funciona.



@knownissues

No es posible recolectar cambios de contexto dentro de una variable y
aplicarlos a una definición de @code{\context} por referencia a dicha
variable.

La instrucción @code{\RemoveEmptyStaffContext} sobreescribe nuestros
ajustes en curso para @code{\Staff}.  Si queremos cambiar los valores
predeterminados para un pentagrama que utilice
@code{\RemoveEmptyStaffContext}, debe hacerlo después de llamar a
@code{\RemoveEmptyStaffContext}, o sea

@example
\layout @{
  \context @{
    \RemoveEmptyStaffContext

    \override Stem #'thickness = #4.0
  @}
@}
@end example


@node Defining new contexts
@subsection Defining new contexts

Los contextos específicos, como @code{Staff} y @code{Voice}, están
construidos a base de bloques sencillos.  Es posible crear nuevos
tipos de contextos con combinaciones distintas de añadidos grabadores.

El siguiente ejemplo muestra cómo construir un tipo diferente de contexto de
@code{Voice} partiendo de cero.  Será parecido a
@code{Voice}, pero imprime solamente cabezas centradas en forma de barra inclinada.  Se puede usar
para indicar improvisación en piezas de jazz,

@c KEEP LY
@lilypond[quote,ragged-right]
\layout { \context {
  \name ImproVoice
  \type "Engraver_group"
  \consists "Note_heads_engraver"
  \consists "Text_engraver"
  \consists Pitch_squash_engraver
  squashedPosition = #0
  \override NoteHead #'style = #'slash
  \override Stem #'transparent = ##t
  \alias Voice
}
\context { \Staff
  \accepts "ImproVoice"
}}

\relative c'' {
  a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
   c4 c^"desvístete" c_"mientras juegas :)" c }
  a1
}
@end lilypond


Estos ajustes se definen dentro de un bloque @code{\context} que a su
vez está dentro de un bloque @code{\layout},

@example
\layout @{
  \context @{
    @dots{}
  @}
@}
@end example

En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
en el lugar de los puntos suspensivos @dots{} del fragmento anterior.

En primer lugar es necesario definir un nombre para el nuevo contexto:

@example
\name ImproVoice
@end example

Debido a que es parecido al contexto @code{Voice}, queremos órdenes
que funcionen sobre contextos de @code{Voice} (existentes) para que
siga funcionando.  Esto se consigue dando al contexto nuevo un alias
@code{Voice},

@example
\alias Voice
@end example

El contexto imprimirá notas y textos explicativos, por ello tenemos
que añadir los grabadores que aportan esta funcionalidad,

@example
\consists Note_heads_engraver
\consists Text_engraver
@end example

Pero sólo necesitamos esto en la línea central,

@example
\consists Pitch_squash_engraver
squashedPosition = #0
@end example

El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
establece sus posiciones verticales al valor de
@code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.

Las notas parecen barras inclinadas y no tienen plica,

@example
\override NoteHead #'style = #'slash
\override Stem #'transparent = ##t
@end example

Todos estos añadidos tienen que cooperar, y esto se consigue con un
añadido especial, que se debe marcar con la palabra clave
@code{\type}.  Este será siempre @rinternals{Engraver_group},

@example
\type "Engraver_group"
@end example

Al juntarlo todo, obtenemos

@example
\context @{
  \name ImproVoice
  \type "Engraver_group"
  \consists "Note_heads_engraver"
  \consists "Text_engraver"
  \consists Pitch_squash_engraver
  squashedPosition = #0
  \override NoteHead #'style = #'slash
  \override Stem #'transparent = ##t
  \alias Voice
@}
@end example

@funindex \accepts
Los contextos dan lugar a jerarquías.  Queremos colgar el contexto
@code{ImproVoice} bajo el contexto @code{Staff}, como simples
@code{Voice}s normales.  Por tanto, modificamos la definición de
@code{Staff} con la instrucción @code{\accepts} (acepta),

@example
\context @{
  \Staff
  \accepts ImproVoice
@}
@end example

@funindex \denies
Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
que a veces se necesita cuando se están reutilizando definiciones de
contexto existentes.

Ponemos ambos dentro de un bloque @code{\layout}, como

@example
\layout @{
  \context @{
    \name ImproVoice
    @dots{}
  @}
  \context @{
    \Staff
    \accepts "ImproVoice"
  @}
@}
@end example

Así pues, la salida que aparece al comienzo de esta sub-sección se
puede escribir como

@example
\relative c'' @{
  a4 d8 bes8
  \new ImproVoice @{
    c4^"ad lib" c
    c4 c^"undress"
    c c_"while playing :)"
  @}
  a1
@}
@end example


@node Aligning contexts
@subsection Aligning contexts

Los contextos nuevos se pueden alinear por encima o por debajo de
otros contextos existentes.  Esto podría ser de utilidad al preparar
un pentagrama vocal (@rlearning{Vocal ensembles}) y un ossia,

@c ARREGLAR: esta sección no funciona en PDF. (¿?)

@cindex ossia
@findex alignAboveContext
@findex alignBelowContext

@lilypond[quote,ragged-right]
ossia = { f4 f f f }
\score{
  \relative c' \new Staff = "main" {
    c4 c c c
    <<
      \new Staff \with {alignAboveContext=main} \ossia
      { d8 f d f d f d f }
    >>
  }
}
@end lilypond




@node Explaining the Internals Reference
@section Explaining the Internals Reference


@menu
* Navigating the program reference::  
* Layout interfaces::           
* Determining the grob property::  
* Naming conventions::          
@end menu



@node Navigating the program reference
@subsection Navigating the program reference

Supongamos que queremos mover la indicación de digitación del
fragmento siguiente:

@lilypond[quote,fragment,relative=2,verbatim]
c-2
\stemUp
f
@end lilypond

Si hace una visita a la documentación en busca de instrucciones de
digitación (en @ref{Fingering instructions}), encontrará:

@quotation
@seealso

Referencia de funcionamiento interno: @rinternals{Fingering}.

@end quotation

@ifnothtml
La referencia del programador se encuentra disponible en forma de
documento HTML.  Se recomienda mucho que lo lea en la forma HTML, bien
en línea o bien descargando los archivos de la documentación HTML.
Esta sección sería mucho más difícil de entender si está utilizando el
manual en formato PDF.
@end ifnothtml

Siga el enlace que lleva a @rinternals{Fingering}.  Al principio de la
página, puede ver

@quotation
Los objetos de digitación se crean por parte de:
@rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
@end quotation

Siguiendo los enlaces relacionados dentro de la referencia del
programa, podemos seguir el flujo de información dentro del programa:

@itemize

@item @rinternals{Fingering}:
los objetos @rinternals{Fingering} se crean por parte de:
@rinternals{Fingering_engraver}

@item @rinternals{Fingering_engraver}:
Tipos de música aceptados: @rinternals{fingering-event}

@item @rinternals{fingering-event}:
El tipo de evento musical @code{fingering-event} está descrito en
Expresiones musicales con el nombre de @rinternals{FingerEvent}
@end itemize

Este camino se recorre en contra de la corriente de información del
programa: comienza por la salida y acaba en el evento de entrada.
También podríamos haber empezado por un evento de la entrada, y leído
siguiendo el flujo de información terminando en su caso en el objeto
(u objetos) de la salida.

La referencia del programa también se puede examinar como un documento
normal.  Contiene capítulos que tratan de
@ifhtml
@rinternals{Music definitions},
@end ifhtml
@ifnothtml
@code{Music definitions}
@end ifnothtml
de la @rinternals{Translation}, y del @rinternals{Backend}.  Cada uno
de los capítulos relaciona todas las definiciones utilizadas y todas
las propiedades que se pueden ajustar.


@node Layout interfaces
@subsection Layout interfaces

@cindex interfaz de la presentación
@cindex presentación, interfaz de la
@cindex grob

La página HTML que pudimos ver en la sección anterior describe el
objeto de presentación llamado @rinternals{Fingering}.  Dicho objeto
es un símbolo dentro de la partitura.  Tiene propiedades que guardan
números (como grosores y direcciones), pero también punteros a objetos
relacionados.  Un objeto de presentación también se llama un
@emph{Grob}, que es una abreviatura de Graphical Object (objeto
gráfico).  Para ver más detalles acerca de los objetos gráficos o
Grobs, consulte @rinternals{grob-interface}.

La página dedicada a @code{Fingering} relaciona las definiciones del
objeto @code{Fingering}.  Por ejemplo, la página dice

@quotation
@code{relleno} (dimensión, en espacios de pentagrama):

@code{0.5}
@end quotation

@noindent
lo que significa que el número se mantendrá a una distancia de al
menos 0.5 de la cabeza de la nota.


Cada objeto de presentación puede tener varias funciones como elemento
notacional o tipográfico.  Por ejemplo, el objeto de digitación
Fingering tiene los siguientes aspectos

@itemize
@item
Su tamaño es independiente del espaciado horizontal, al contrario de
las ligaduras o las barras de las figuras.

@item
Es un elemento de texto.  Casi seguro que es un texto muy corto.

@item
este elemento de texto se tipografía con un tipo de letra, no como las
ligaduras o las barras de las figuras.

@item
Horizontalmente, el centro del símbolo se debe alinear con el centro
de la cabeza de la nota.

@item
Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.

@item
La posición vertical también está coordinada con otros símbolos de
superíndice y de subíndice.
@end itemize

Cada uno de estos aspectos se capta en lo que se llaman
@emph{interface}s, que se relacionan al final de la página dedicada a
@rinternals{Fingering}

@quotation
Este objeto contempla los siguientes interfaces:
@rinternals{item-interface},
@rinternals{self-alignment-interface},
@rinternals{side-position-interface}, @rinternals{text-interface},
@rinternals{text-script-interface}, @rinternals{font-interface},
@rinternals{finger-interface} y @rinternals{grob-interface}.
@end quotation

Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
página del respectivo interfaz del objeto.  Cada interfaz tiene un
cierto número de propiedades.  Algunas de ellas no son para que el
usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
pueden modificar.

Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
realmente esto no significa mucho.  El archivo de inicialización
(véase @ref{File structure}) @file{scm/@/define@/-grobs@/.scm} muestra
el alma del @q{objeto},

@example
(Fingering
  . ((padding . 0.5)
     (avoid-slur . around)
     (slur-padding . 0.2)
     (staff-padding . 0.5)
     (self-alignment-X . 0)
     (self-alignment-Y . 0)
     (script-priority . 100)
     (stencil . ,ly:text-interface::print)
     (direction . ,ly:script-interface::calc-direction)
     (font-encoding . fetaNumber)
     (font-size . -5)           ; don't overlap when next to heads.
     (meta . ((class . Item)
     (interfaces . (finger-interface
                    font-interface
                    text-script-interface
                    text-interface
                    side-position-interface
                    self-alignment-interface
                    item-interface))))))
@end example

@noindent
Como podemos ver, el objeto @code{Fingering} no es más que un montón
de valores de variables, y la página web de la Referencia de
funcionamiento interno se genera directamente a partir de esta
definición.


@node Determining the grob property
@subsection Determining the grob property

Recordemos que queríamos cambiar la posición del @b{2} en

@lilypond[quote,fragment,relative=2,verbatim]
c-2
\stemUp
f
@end lilypond

Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
tenemos que negociar con el interfaz asociado con esta colocación.
Esto se hace usando @code{side-position-interface}.  La página que
describe este interface dice:

@quotation
@code{side-position-interface}

Colocar un objeto víctima (este mismo) junto a otros objetos (el
soporte).  La propiedad @code{direction} significa dónde poner el
objeto víctima con relación al soporte (¿a la izquierda o a la
derecha, encima o debajo?)
@end quotation

@cindex relleno
@noindent
Debajo de esta descripción, la variable @code{padding} (relleno) se describe como

@quotation
@table @code
@item padding
(dimensión, en espacios de pentagrama)

Añadir esta cantidad de espacio adicional entre objetos que están unos
junto a otros.
@end table
@end quotation

Aumentando el valor de @code{padding}, podemos alejar la cifra de
digitación de la cabeza de la nota.  La siguiente orden inserta un
espacio en blanco de 3 espacios de pentagrama entre la nota y la
digitación:
@example
\once \override Voice.Fingering #'padding = #3
@end example

Al insertar esta instrucción antes de que se haya creado el objeto
Fingering, es decir, antes del @code{c2}, llegamos al siguiente
resultado:

@lilypond[quote,relative=2,fragment,verbatim]
\once \override Voice.Fingering #'padding = #3
c-2
\stemUp
f
@end lilypond


En este caso, el contexto de este truco es @code{Voice}.  Este hecho
se puede deducir también a partir de la referencia del programa, ya
que la página dedicada al añadido @rinternals{Fingering_engraver} dice

@quotation
El grabador Fingering_engraver es parte de los contextos: @dots{}
@rinternals{Voice}
@end quotation



@node Naming conventions
@subsection Naming conventions

UNTRANSLATED NODE: IGNORE ME

@node Modifying properties
@section Modifying properties

@menu
* Overview of modifying properties::  
* The \set command::            
* The \override command::       
* \set versus \override::       
* Objects connected to the input::  
@end menu


@node Overview of modifying properties
@subsection Overview of modifying properties

Cada contexto es responsable de la creación de ciertos tipos de
objetos gráficos.  Los ajustes que se usan para imprimir estos objetos
también se almacenan por contexto.  Mediante la modificación de estos
ajustes, se puede alterar la apariencia de los objetos.

La sintaxis de esto es

@example
\override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
@end example

Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
o @code{NoteHead}, y @var{propiedad} es una variable interna del
sistema de formateo (@q{propiedad del grob} o @q{propiedad de
disposición}).  Este último es un símbolo, y por ello debe ir
precedido de un apóstrofe.  La subsección @ref{Modifying properties}
explica cómo se deben cumplimentar los conceptos @var{nombre},
@var{propiedad} y @var{valor}.  Aquí sólo nos ocuparemos de la
funcionalidad des esta instrucción.

La instrucción

@verbatim
\override Staff.Stem #'thickness = #4.0
@end verbatim

@noindent
hace más gruesas las plicas (el valor predeterminado es 1.3, con el
grosor de una línea del pentagrama como unidad).  Puesto que la
instrucción especifica como contexto a @code{Staff}, sólo se aplica al
pentagrama actual.  Otros pentagramas mantienen su aspecto normal.
Aquí vemos la instrucción en pleno funcionamiento:

@lilypond[quote,verbatim,relative=2,fragment]
c4
\override Staff.Stem #'thickness = #4.0
c4
c4
c4
@end lilypond

La instrucción @code{\override} modifica la definición de la plica
@code{Stem} dentro del pentagrama en curso @code{Staff}.  Después de
que la instrucción se ha interpretado, todas las plicas se engrosan.

DE manera análoga a @code{\set}, el argumento @var{contexto} se puede
omitir, ocasionando que se utilice el contexto predeterminado
@code{Voice}.  Al añadir @code{\once} se aplica el cambio durante un
solo paso de tiempo.

@lilypond[quote,fragment,verbatim,relative=2]
c4
\once \override Stem #'thickness = #4.0
c4
c4
@end lilypond

El @code{\override} se debe hacer antes de que el objeto se inicia.
Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
ligaduras o barras, la instrucción @code{\override} se debe ejecutar
en el momento en que se crea el objeto.  En este ejemplo:

@lilypond[quote,fragment,verbatim,relative=2]
\override Slur #'thickness = #3.0
c8[( c
\override Beam #'thickness = #0.6
c8 c])
@end lilypond

@noindent
la ligadura es más gruesa pero la barra no lo es.  Esto es así porque
la instrucción para @code{Beam}, la barra, va después de que la barra
se ha iniciado, y por ello no tiene ningún efecto.

De forma análoga a @code{\unset}, la instrucción @code{\revert} para
un contexto deshace una instrucción @code{\override}; como con
@code{\unset}, solamente afecta a los ajustes que se hicieron dentro
del mismo contexto.  En otras palabras, el @code{\revert} del
siguiente ejemplo no hace nada.

@example
\override Voice.Stem #'thickness = #4.0
\revert Staff.Stem #'thickness
@end example

Salgunas opciones «trucables» se llaman @q{subpropiedades} y residen
dentro de las propiedades normales.  Para trucarlas, utilice
instrucciones de la forma

@c leave this as a long long
@example
\override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
@end example

@noindent
tales como

@example
\override Stem #'details #'beamed-lengths = #'(4 4 3)
@end example


@seealso

Referencia de funcionamiento interno:
@rinternals{OverrideProperty},
@rinternals{RevertProperty},
@rinternals{PropertySet},
@rinternals{Backend} y
@rinternals{All layout objects}.


@knownissues

El «back-end» o motor de salida no es muy estricto en la comprobación
de tipos de las propiedades de objetos.  Las referencias cíclicas en
valores Scheme de propiedades pueden producir cuelgues o salidas
abruptas, o las dos cosas.


@node The \set command
@subsection The @code{\set} command

@cindex propiedades
@funindex \set
@cindex cambiar propiedades

Cada contexto puede tener distintas @emph{propiedades}, variables
contenidas dentro de ese contexto.  Se pueden cambiar mientras dura el
paso de interpretación.  Se consigue insertando la instrucción
@code{\set} dentro de la música:

@example
\set @var{contexto}.@var{propiedad} = #@var{valor}
@end example

Por ejemplo:
@lilypond[quote,verbatim,relative=2,fragment]
R1*2
\set Score.skipBars = ##t
R1*2
@end lilypond

Estas instrucción salta los compases que no tienen notas.  El
resultado es que los silencios multicompás se condensan.  El valor
asignado es un objeto de Scheme.  En este caso, es @code{#t}, el valor
booleano True o verdadero.

Si se omite el argumento @var{context}, entonces se utiliza el
contexto actual de nivel más bajo (normalmente @code{ChordNames},
@code{Voice} o @code{Lyrics}). En este ejemplo:

@lilypond[quote,verbatim,relative=2,fragment]
c8 c c c
\set autoBeaming = ##f
c8 c c c
@end lilypond

@noindent
el argumento @var{contexto} de la instrucción @code{\set} se omite,
así pues el barrado automático se desactiva en la voz actual.  Observe
que el contexto de nivel más bajo no siempre contiene la propiedad que
queremos cambiar (por ejemplo, no tendrá ningún efecto intentar
establecer un valor para la propiedad @code{skipBars} del contexto de
nivel más bajo, en este caso @code{Voice}).

@lilypond[quote,verbatim,relative=2,fragment]
R1*2
\set skipBars = ##t
R1*2
@end lilypond

Los contextos so jerárquicos, y si se ha especificado un contexto
mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
también a todos los contextos @code{Voice} dentro del pentagrama
actual.  El cambio se aplica @q{al vuelo}, durante la música, de
manera que el ajuste sólo afecta al segundo grupo de corcheas.

@funindex \unset

También existe una instrucción @code{\unset}:
@example
\unset @var{contexto}.@var{propiedad}
@end example

@noindent
que elimina la definición de @var{propiedad}.  Esta instrucción
elimina la definición solamente si está establecida dentro de
@var{contexto}, de manera que

@example
\set Staff.autoBeaming = ##f
@end example

@noindent
introduce un ajuste de la propiedad en el nivel de @code{Staff}.  El
ajuste también se aplica a la @code{Voice} actual.  Sin embargo:

@example
\unset Voice.autoBeaming
@end example

@noindent
no tiene ningúun efecto.  Para cancelar este ajuste, se debe
especificar el @code{\unset} en el mismo nivel que el @code{\set}
original.  Dicho de otra forma, para deshacer el efecto de
@code{Staff.autoBeaming = ##f} se necesita
@example
\unset Staff.autoBeaming
@end example

Como @code{\set}, el argumento @var{contexto} no se tiene que
especificar para un contexto del nivel más bajo, por lo que los dos
enunciados

@example
\set Voice.autoBeaming = ##t
\set autoBeaming = ##t
@end example

@noindent
son equivalentes.


@cindex \once
Los ajustes que se aplican solamente a un único paso de tiempo se
pueden escribir con @code{\once}, por ejemplo en

@lilypond[quote,verbatim,relative=2,fragment]
c4
\once \set fontSize = #4.7
c4
c4
@end lilypond

la propiedad @code{fontSize} se deshace automáticamente después de la
segunda nota.

En el manual de Referencia de funcionamiento interno hay una
descripción completa de todas las propiedades de contexto disponibles,
consulte
@ifhtml
@rinternals{Tunable context properties}.
@end ifhtml
@ifnothtml
Traducción @expansion{} Propiedades de contexto modificables por el
usuario.
@end ifnothtml



@node The \override command
@subsection The @code{\override} command

Las instrucciones que modifican la salida tienen por lo general un
aspecto como

@example
\override Voice.Stem #'thickness = #3.0
@end example

@noindent
Para construir este truco debemos determinar los siguientes datos:

@itemize
@item el contexto: aquí @code{Voice}.
@item el objeto de presentación: aquí @code{Stem}.
@item la propiedad de presentación: aquí @code{thickness}.
@item un valor adecuado: aquí @code{3.0}.
@end itemize

Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
en el interior de las propiedades normales.  Para modificarlas utilice
instrucciones de la forma

@example
\override Stem #'details #'beamed-lengths = #'(4 4 3)
@end example

@cindex documentación interna
@cindex buscar objetos gráficos
@cindex gráficos, descripción de los objetos
@cindex trucos
@funindex \override
@cindex interna, documentación

Para muchas propiedades, independientemente del tipo de datos de la
propiedad, si se establece el valor de la propiedad a falso
(@code{##f}) se producirá su desactivación, ocasionando que LilyPond
ignore por completo dicha propiedad.  Esto es especialmente útil para
«apagar» propiedades de grobs (objetos gráficos) que de otra manera
causarína problemas.

Mostraremos a continuación cómo localizar esta información en el
manual de notación y en la referencia de funcionamiento interno.

@node \set versus \override
@subsection @code{\set} vs. @code{\override}

Hemos visto dos formas de cambiar las propiedades: @code{\set} y
@code{\override}.  De hecho, en realidad existen dos clases diferentes
de propiedades.

Los contextos pueden tener propiedades, que por lo general reciben
nombres en @code{mayúsculasDeCamello}.  Principalmente controlan la
traducción de la música a la notación, p.ej. @code{localKeySignature}
(para determinar si hay que imprimir las alteraciones accidentales),
@code{measurePosition} (para determinar cuándo imprimir una línea
divisoria).  Las propiedades de contexto pueden ver modificado su
valor con el tiempo según se interpreta una pieza de música;
@code{measurePosition} es un ejemplo obvio de esto.  Las propiedades
de contexto se modifican con @code{\set}.

Hay un tipo especial de propiedad de contexto: la descripción del
elemento.  Estas propiedades reciben nombres en
@code{MayúsculasDeCamello} (comenzando en letra mayúscula).  Contienen
los @q{ajustes por defecto} para dicho elemento gráfico como una lista
asociativa.  Consulte @file{scm/@/define@/-grobs@/.scm} para ver qué
tipos de ajustes hay.  Las descripciones de los elementos se pueden
modificar con @code{\override}.

Realmente, @code{\override} es un atajo;

@example
\override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
@end example

@noindent
es más o menos equivalente a

@c  leave this long line -gp
@example
\set @var{contexto}.@var{nombre} #'@var{propiedad} = #(cons (cons '@var{propiedad} @var{valor}) <valor previo de @var{contexto})
@end example

El valor de @code{contexto} (la lista-a) se usa para da un valor
inicial a las propiedades de los objetos gráficos individuales.  Los
objetos gráficos también tienen propiedades, que reciben nombres en el
estilo de Scheme, con @code{palabras-con-guiones}.  Los valores de las
propiedades de objetos gráficos cambian durante el proceso de
formateo: el formateo básicamente consiste en calcular las propiedades
utilizando funciones de callback.

@code{fontSize} es una propiedad especial: equivale a escribir
@code{\override ... #'font-size} para todos los objetos pertinentes.
Al ser éste un cambio muy común, se creó la propiedad especial
(modificada con @code{\set}).


@node Objects connected to the input
@subsection Objects connected to the input

@funindex \tweak

En ocasiones es posible tomar un atajo para realizar el ajuste fino de
los objetos gráficos.  Para objetos que reusultan directamente de un
elemento de código de la entrada, puede usar la función @code{\tweak},
por ejemplo

@lilypond[relative=2,fragment,verbatim,ragged-right]
<
  c
  \tweak #'color #red d
  g
  \tweak #'duration-log #1  a
>4-\tweak #'padding #10 -.
@end lilypond

Como podemos ver, las propiedades se establecen directamente dentro de
los objetos, sin hacer mención al nombre del grob ni al contexto en el
que se tendría que aplicar.

Esta técnica sólo funciona para los objetos que están conectados
directamente a un @rinternals{Event} (evento) del texto de entrada,
por ejemplo

@itemize
@item cabezas de nota, producidas por chord-pitch (p. ej.: las notas de un acorde)
@item signos de articulación, producidos por instrucciones de articulación
@end itemize

Posiblemente no funcione para plicas y alteraciones accidentales
(éstos están producidos por parte de las cabezas de nota, no por los
eventos musicales) ni para las claves (éstos no están producidos por
ninguna entrada musical, sino más bien a causa de un cambio en el
valor de una propiedad).

Existen muy pocos objetos que estén conectados @emph{directamente} al
resultado de salida.  Una nota normal (como @code{c4}) no está
conectada directamente a la salida, así que

@example
\tweak #'color #red c4
@end example

@noindent
no cambia el color.  Consulte @ref{Displaying music expressions} para
ver más detalles.


@node Common properties
@section Common properties

@menu
* Controlling visibility of objects::  
* Line styles::                 
* Rotating objects::            
* Aligning objects::            
@end menu

@node Controlling visibility of objects
@subsection Controlling visibility of objects


@node Line styles
@subsection Line styles

Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
@i{accelerando} y los @i{trinos} se escriben como texto y se extienden
sobre muchos compases mediante líneas, a veces punteadas u onduladas.

Todos ellos usan las mismas rutinas que el glissando para dibujar los textos y las líneas,
y por ello el ajuste fino de su comportamiento se hace de la
misma manera. Se hace con un spanner (un objeto de extensión), y la rutina responsable
de dibujar los objetos de extensión es @code{ly:line-interface::print}. Esta
rutina determina la colocación exacta de los dos @i{extremos del
objeto de extensión} y dibuja una línea entre ellos, en el estilo solicitado.

He aquí un ejemplo de los distintos estilos de línea disponibles, y cómo
aplicarles ajustes finos.

@lilypond[relative=2,ragged-right,verbatim,fragment]
d2 \glissando d'2
\once \override Glissando #'style = #'dashed-line
d,2 \glissando d'2
\override Glissando #'style = #'dotted-line
d,2 \glissando d'2
\override Glissando #'style = #'zigzag
d,2 \glissando d'2
\override Glissando #'style = #'trill
d,2 \glissando d'2
@end lilypond

La información que determina los puntos extremos se calcula al vuelo
para cada objeto gráfico, pero es posible sobreescribirlos.

@lilypond[relative=2,ragged-right,verbatim,fragment]
e2 \glissando f
\once \override Glissando #'bound-details #'right #'Y = #-2
e2 \glissando f
@end lilypond

El objeto @code{Glissando}, como cualquier otro que use la rutina
@code{ly:line-interface::print}, conlleva una lista asociativa
anidada. En la instrucción anterior, el valor de @code{Y}
se establece a @code{-2} para la lista asociativa correspondiente al extremo final de la
derecha. Por supuesto, también es posible ajustar el extremo de la izquierda con
@code{left} en vez de @code{right}.

Si no se establece el valor de @code{Y}, se calcula a partir de la posición
vertical del punto de anclaje derecho del objeto de extensión.

En el caso de un salto de línea, los valores de los puntos extremos se extienden
con los contenidos de las sublistas @code{left-broken} y @code{right-broken},
por ejemplo

@lilypond[relative=2,ragged-right,verbatim,fragment]
\override Glissando #'breakable = ##T 
\override Glissando #'bound-details #'right-broken #'Y = #-3
c1 \glissando \break
f1
@end lilypond

Las siguientes propiedades se pueden usar para el ajuste fino de los objetos de extensión:

@table @code
@item Y
Establece la coordenada Y del punto extremo, en espacios de pentagrama.  Por
omisión, es el centro del objeto con que enlaza.  Así, para un glissando
apuntaría al centro vertical de la cabeza de la nota.

Para objetos de extensión horizontales, como el de texto y los trinos, tiene el valor
fijo de cero.

@item attach-dir
Determina el lugar donde la línea comienza y acaba en la dirección X,
relativo al objeto al que se enlaza.  Así, un valor de @code{-1} (o
@code{LEFT}) hace que la línea comience o acabe en el lado izquierdo de la cabeza de la nota
a la que el objeto se encuentra adjuntado.

@item X
Es la coordenada absoluta del extremo final. Normalmente
se calcula al vuelo y no tiene mucho sentido sobreescribirlo.

@item stencil
Los objetos extensores de línea pueden tener símbolos al principio o al final, que se encuentra contenido
dentro de esta subpropiedad.  Es para uso interno y se recomienda
usar @code{text}.

@item text
Es un elemento de marcado que se evalúa para generar la propiedad stencil anterior. Se usa
para poner @i{cresc.} y @i{tr} sobre los objetos de extensión horizontales.

@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
\override TextSpanner #'bound-details #'left #'text
   = \markup { \small \bold Slower }
c2\startTextSpan b c a\stopTextSpan
@end lilypond

@item stencil-align-dir-y
@item stencil-offset
Sin un valor establecido para esto, el stencil se coloca simplemente sobre el extremo del final,
tal y como se encuentra definido por las subpropiedades @code{X} e @code{Y}.
La asignación de un valor para @code{stencil-align-dir-y} o para @code{stencil-offset}
desplaza el símbolo del extremo de forma relativa al extremo de la línea

@lilypond[relative=1,fragment,verbatim]
\override TextSpanner #'bound-details #'left #'stencil-align-dir-y = #DOWN
\override TextSpanner #'bound-details #'right #'stencil-align-dir-y = #UP

\override TextSpanner #'bound-details #'left #'text = #"gggg"
\override TextSpanner #'bound-details #'right #'text = #"hhhh"
c4^\startTextSpan c c c \stopTextSpan
@end lilypond

@item arrow (flecha)
El establecimiento de esta subpropiedad al valor de @code{#t} produce una cabeza de flecha al final de la
línea.

@item padding (relleno)
Esta subpropiedad controla el espacio entre el punto extremo de la línea especificado
y el extremo real.  Sin relleno, un glissando empezaría
y acabaría en el centro de las cabezas de las notas.

@end table

La función musical \endSpanners termina los objetos de extensión y los
reguladores después de una nota exactamente.

@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
\endSpanners
c2 \startTextSpan c2
c2 \< c2
@end lilypond

Al utilizar \endSpanners no es necesario cerrar \startTextSpan con
\stopTextSpan, ni tampoco cerrar los reguladores con \!.

@seealso

Referencia del programa:
@rinternals{TextSpanner},
@rinternals{Glissando},
@rinternals{VoiceFollower},
@rinternals{TrillSpanner},
@rinternals{line-spanner-interface}.

Ejemplos:
@lsr{expressive,line-styles.ly},
@lsr{expressive,line-arrows.ly}.


@node Rotating objects
@subsection Rotating objects

@node Aligning objects
@subsection Aligning objects


@node Advanced tweaks
@section Advanced tweaks

@menu
* Vertical grouping of grobs::  
* Modifying ends of spanners::  
* Modifying stencils::          
@end menu




@node Vertical grouping of grobs
@subsection Vertical grouping of grobs

Los grobs (objetos gráficos) @code{VerticalAlignment} y
@code{VerticalAxisGroup} trabajan de manera coordinada.
@code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
@code{Lyrics}, etc.  Después, @code{VerticalAlignment} alinea los
distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
Normalmente sólo existe un @code{VerticalAlignment} por cada
partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
@code{VerticalAxisGroup}.


@node Modifying ends of spanners
@subsection Modifying ends of spanners


@node Modifying stencils
@subsection Modifying stencils

@node old The \override command
@section old The @code{\override} command

UNTRANSLATED NODE: IGNORE ME

@node Discussion of specific tweaks
@section Discussion of specific tweaks

UNTRANSLATED NODE: IGNORE ME

@menu
* old Contexts explained::      
@end menu

@node old Contexts explained
@subsection old Contexts explained

UNTRANSLATED NODE: IGNORE ME