@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @c This file is part of lilypond.tely @ignore Translation of GIT committish: d6fc290a4c31ad0f7983b37bc62b29e776cf250a 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.61" @node Changing defaults @chapter Changing defaults El objetivo del diseño de LilyPond es proporcionar la más alta calidad de los resultados, de forma predeterminada. A pesar de ello, podría tener que cambiar este resultado predeterminado. La disposición sobre el papel se controla a través de un amplio número de @q{botones e interruptores} llamados en su conjunto @q{propiedades}. En el Manual de aprendizaje podemos encontrar una introducción en forma de tutorial al acceso y modificación de estas propiedades, véase @rlearning{Tweaking output}. Éste debería leerse en primer lugar. Este capítulo cubre un terreno similar, pero con un estilo más adecuado para un manual de referencia. @cindex Referencia de funcionamiento interno La descripción definitiva de los controles que están dipsonibles para su ajuste fino están en un documento aparte: @rinternalsnamed{Top,la Referencia de funcionamiento interno}. 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. 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:: * Useful concepts and properties:: * Advanced 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 @seealso Manual de aprendizaje: @rlearning{Contexts and engravers}. Archivos de inicio: @file{ly/@/engraver@/-init@/.ly}, @file{ly/@/performer@/-init@/.ly}. Fragmentos de código: @rlsr{Contexts and engravers}. Referencia de funcionamiento interno: @rinternals{Contexts}, @rinternals{Engravers and Performers}. @node Contexts explained @subsection Contexts explained Los contextos se disponen de forma jerárquica: @menu * Score - the master of all contexts:: * Top-level contexts - staff containers:: * Intermediate-level contexts - staves:: * Bottom-level contexts - voices:: @end menu @node Score - the master of all contexts @unnumberedsubsubsec Score - the master of all contexts Este es el contexto de notación del nivel más alto. Ningún otro contexto puede contener a un contexto Score. De forma predeterminada, el contexto Score maneja la administración de las indicaciones de compás y se asegura de que ciertos elementos como claves, compases y armaduras están siempre alineados entre los distintos pentagramas. Se crea implícitamente una instancia del contexto Score cuando se procesa un bloque @code{\score @{@dots{}@}} o @code{\layout @{@dots{}@}}, o explícitamente cuando se ejecuta una instrucción @code{\new Score}. @node Top-level contexts - staff containers @unnumberedsubsubsec Top-level contexts - staff containers @strong{@emph{StaffGroup}} Agrupa pentagramas y añade un corchete en la parte izquierda, formando un grupo. Las líneas divisorias de los pentagramas contenidos se conectan verticalmente. StaffGroup sólo consiste en una colección de pentagramas, con un corchete delante y líneas divisorias de arriba a abajo. @strong{@emph{ChoirStaff}} Idéntico a StaffGroup excepto que las barras de compás de los pentagramas contenidos no se conectan verticalmente. @strong{@emph{GrandStaff}} Un grupo de pentagramas, con una llave en la parte izquierda que abarca el grupo. Las barras de compás de los pentagramas contenidos se conectan verticalmente. @strong{@emph{PianoStaff}} @c TODO No longer correct? Check. -td Igual que GrandStaff pero con una distancia fija entre los pentagramas, de manera que se pueden usar ligaduras y barras que cruzan de un pentagrama a otro. @ignore @strong{@emph{InnerStaffGroup}} TODO -td @strong{@emph{InnerChoirStaff}} TODO -td @end ignore @node Intermediate-level contexts - staves @unnumberedsubsubsec Intermediate-level contexts - staves @strong{@emph{Staff}} Maneja claves, barras de compás, tonalidades y alteraciones accidentales. Puede contener contextos de Voice. @strong{@emph{RhythmicStaff}} Como Staff, pero para imprimir ritmos. Se ignoran las alturas de las notas; las notas se imprimen sobre una línea. @strong{@emph{TabStaff}} Contexto para generar tablaturas. De forma predeterminada dispone la expresión musical como una tablatura de guitarra, impresa sobre seis líneas. @strong{@emph{DrumStaff}} Maneja el tipografiado para instrumentos de percusión. Puede contener contextos DrumVoice. @strong{@emph{VaticanaStaff}} Iguall que Staff, excepto que está pensado para tipografiar piezas en estilo gregoriano. @strong{@emph{MensuralStaff}} Igual que Staff, excepto que está diseñado para tipografiar piezas en estilo mensural. @node Bottom-level contexts - voices @unnumberedsubsubsec Bottom-level contexts - voices Los contextos del mismo nivel que Voice dan un valor inicial a ciertas propiedades e inician los grabadores correspondientes. Siendo contextos del nivel más bajo, no pueden contener a otros contextos. @strong{@emph{Voice}} Corresponde a una voz sobre un pentagrama. este contexto maneja la conversión de las indicaciones dinámicas, plicas, barras, subíndices y superíndices, ligaduras de expresión y de unión, y silencios. Tenemos que crear instancias explícitas de este contexto si necesitamos varias voces en el mismo pentagrama. @strong{@emph{VaticanaVoice}} Lo mismo que Voice, excepto que está diseñado para tipografiar piezas en estilo gregoriano. @strong{@emph{MensuralVoice}} Lo mismmo que Voice, con modificaciones para el tipografiado de piezas en estilo mensural. @strong{@emph{Lyrics}} Corresponde a una voz con letra. Maneja la impresión de una sola línea de letra. @strong{@emph{DrumVoice}} El contexto de voz utilizado en una pauta de percusión. @strong{@emph{FiguredBass}} El contexto en que los objetos BassFigure se crean a partir de la entrada escrita en el modo @code{\figuremode}. @strong{@emph{TabVoice}} El contexto de voz utilizado dentro de un contexto TabStaff. Se suele dejar que se cree implícitamente. @strong{@emph{ChordNames}} Tipografía nombres de acordes. @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 @code{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, @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 @cindex nested contexts @cindex contexts, nested @funindex \accepts @funindex \denies Los contextos como @code{PianoStaff} pueden llevar dentro otros contextos anidados. Los contextos que se pueden aceptar para su anidamiento están definidos por la lista @qq{accepts} (acepta) de un contexto. Los contextos que no están en esta lista se colocan debajo del contexto exterior en la partitura impresa. Por ejemplo, el contexto @code{PianoStaff} está definido para que acepte contextos @code{Staff} y @code{FiguredBass} de forma predeterminada, pero no un contexto @code{Lyrics}, por ejemplo. Así pues, en la siguiente estructura la letra se sitúa debajo del sistema de piano en lugar de colocarse entre los dos pentagramas: @lilypond[verbatim,quote,relative=1] \new PianoStaff << \new Staff { e4 d c2 } \addlyrics { Three blind mice } \new Staff { \clef "bass" { c,1 } } >> @end lilypond La lista @qq{accepts} de un contexto se puede modificar para que incluya contextos anidados adicionales, y así si quisiéramos que la letra apareciese entre los dos pentagramas podríamos usar: @lilypond[verbatim,quote,relative=1] \new PianoStaff \with { \accepts Lyrics } << \new Staff { e4 d c2 } \addlyrics { Three blind mice } \new Staff { \clef "bass" { c,1 } } >> @end lilypond Lo contrario de @code{\accepts} (acepta) es @code{\denies} (deniega); esto suprime un contexto de la lista @qq{accepts}. @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 @strong{Véase también} 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{FingeringEvent} @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 @ignore Another thing that is needed, is an overview of the various naming conventions: scheme functions: lowercase-with-hyphens (incl. one-word names) scheme functions: ly:plus-scheme-style music events, music classes and music properties: as-scheme-functions Grob interfaces: scheme-style backend properties: scheme-style (but X and Y!) contexts (and MusicExpressions and grobs): Capitalized or CamelCase context properties: lowercaseFollowedByCamelCase engravers: Capitalized_followed_by_lowercase_and_with_underscores Which of these are conventions and which are rules? Which are rules of the underlying language, and which are LP-specific? @end ignore @node Modifying properties @section Modifying properties @menu * Overview of modifying properties:: * The set command:: * The override command:: * set versus override:: * The tweak command:: @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óstrofo. 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 Algunas 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}, @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 son 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 The tweak command @subsection The @code{\tweak} command @funindex \tweak @cindex trucar 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,verbatim] < c \tweak #'color #red d g \tweak #'duration-log #1 a > 4 -\tweak #'padding #8 -^ @end lilypond @cindex chord, modifying one note in Pero el uso principal de la instrucción @code{\tweak} es modificar solamente uno de varios elementos de notación que dan comienzo en el mismo momento musical, como las notas de un acorde, o corchetes de tresillo que empiezan al mismo tiempo. Para ver una introducción a la sintaxis y los usos de la instrucción tweak, consulte @rlearning{Tweaking methods}. La instrucción @code{\tweak} fija una propiedad en el objeto que viene a continuación de forma directa, sin necesidad de especificar el nombre del grob o el contexto. Para que esto funcione, es necesario que la instrucción @code{\tweak} permanezca inmediatamente adyacente al objeto al que se aplica, después de que el archivo de entrada se ha convertido en un flujo musical. Con frecuencia no es el caso, pues muchos elementos adicionales se insertan en la corriente musical de forma implícita. Por ejemplo, cuando se procesa una nota que no forma parte de un acorde, LilyPond inserta implícitamente un evento @code{ChordEvent} antes de la nota, separando así el truco de la nota. Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la nota, la instrucción @code{\tweak} viene después del @code{ChordEvent} en el flujo musical, permaneciendo así adyacente a la nota, y con la posibilidad de modificarla. Así, esto funciona: @lilypond[relative=2,verbatim,quote] <\tweak #'color #red c>4 @end lilypond @noindent pero esto no funciona: @lilypond[relative=2,verbatim,quote] \tweak #'color #red c4 @end lilypond Si se colocan varios elementos similares en el mismo momento musical, la instrucción @code{\override} no se puede usar para modificar uno solo de ellos: aquí es donde se debe usar la instrucción @code{\tweak}. Entre los elementos que pueden aparecer más de una vez en el mismo momento musical están los siguientes: @c TODO expand to include any further uses of \tweak @itemize @item las cabezas de las notas de un acorde @item signos de articulación sobre la misma nota @item ligaduras de unión entre notas de un acorde @item corchetes de grupos especials que comienzan en el mismo momento @end itemize @c TODO add examples of these @noindent y se puede usar @code{\tweak} para modificar cualquier aparición específica de estos elementos. Es de resaltar que la instrucción @code{\tweak} no se puede usar para modificar plicas, barras o alteraciones accidentales, porque éstos se generan más tarde por parte de las cabezas de nota, en vez de por elementos musicales que están en el flujo de entrada. Ni se puede usar una instrucción @code{\tweak} para modificar claves o indicaciones de compás, ya que éstos están separados de cualquier instrucción @code{\tweak} precedente en el flujo de entrada a causa de la inserción automática de elementos adicionales necesarios para especificar el contexto. Pero la instrucción @code{\tweak} se puede usar como alternativa a la instrucción @code{\override} para modificar estos elementos notacionales que no producen la adición de ningún elemento notacional implícito antes de ellos mismos en el flujo musical. Por ejemplo, las ligaduras de expresión se pueden modificar de esta forma: @lilypond[verbatim,quote,relative=1] c-\tweak #'thickness #5 ( d e f) @end lilypond También se pueden escribir varias instrucciones @code{\tweak} antes de un elemento notacional, y todas ellas le afectan: @lilypond[verbatim,quote,relative=1] c -\tweak #'style #'dashed-line -\tweak #'dash-fraction #0.2 -\tweak #'thickness #3 -\tweak #'color #red \glissando f' @end lilypond El flujo musical que se genera a partir de una sección de un archivo de entrada, incluido cualquier elemento insertado automáticamente, puede examinarse, véase @ref{Displaying music expressions}. Esto puede ser de utilidad en la determinación de lo que puede modificarse por medio de una instrucción @code{\tweak}. @seealso Manual de aprendizaje: @rlearning{Tweaking methods}. Referencia de la notación: @ref{Displaying music expressions}. @knownissues @cindex trucos en una variable La instrucción @code{\tweak} no se puede usar dentro de una variable. @cindex trucos en la letra Las instrucciones @code{\tweak} no se pueden usar dentro del modo @code{\lyricmode}. @cindex trucar puntos de control @cindex control, trucar puntos de La instrucción @code{\tweak} no se puede usar para modificar los puntos de control de una única ligadura entre varias dentro de un acorde, aparte de la primera que aparece en el archivo de entrada. @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}) }, @code{--} @end itemize @strong{La propiedad de dirección} La posición o dirección de muchos objetos de presentación está controlada por la propiedad @code{direction}. El valor de la propiedad @code{direction} se puede establecer al valor @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a @code{-1}, con el significado de @qq{hacia abajo} o @qq{debajo}. Se pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de @code{1} y @code{-1} respectivamente. La dirección predeterminada se puede especificar estableciendo @code{direction} a @code{0} ó a @code{CENTER}. De forma alternativa, en muchos casos existen instrucciones predefinidas para especificar la dirección. Todas ellas son de la forma: @noindent @code{\xxxUp}, @code{xxxDown}, @code{xxxNeutral} @noindent donde @code{xxxNeutral} significa @qq{utilizar la dirección predeterminada}. Véase @rlearning{Within-staff objects}. En alguna que otra ocasión, con el único ejemplo usual del arpegio, el valor de la propiedad @code{direction} especifica si el objeto se debe colocar a la izquierda o a la derecha del objeto padre. En este caso @code{-1} ó @code{LEFT} significan @qq{a la izquierda} y @code{1} ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER} significan @qq{utilizar la dirección predeterminada}, como antes. @node Distances and measurements @subsection Distances and measurements @cindex distances, absolute @cindex distances, scaled @funindex \mm @funindex \cm @funindex \in @funindex \pt Las distancias en LilyPond son de dos tipos: absolutas y escaladas. Las distancias absolutas se usan para especificar márgenes, sangrados y otros detalles de diseño de página, y de forma predeterminada se especifican en milímetros. Las distancias se pueden especificar en otras unidades escribiendo después de la cifra indicativa de la cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño de página se pueden especificar también en unidades escalables (véase el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad. La disposición de página se describe en detalle en @ref{Page formatting}. Las distancias escaladas siempre se especifican en unidades de un espacio del pentagrama o, más raramente, medio espacio del pentagrama. El espacio de pentagrama es la distancia entre dos líneas del pentagrama adyacentes. El valor predeterminado se puede cambiar globalmente fijando el tamaño global del pentagrama, o se puede sobreescribir localmente cambiando la propiedad @code{staff-space} del objeto @code{StaffSymbol}. Las distancias escaladas se escalan automáticamente con cualquier cambio al tamaño global del pentagrama o a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero las fuentes tipográficas se escalan solamente con los cambios efectuados al tamaño global del pentagrama. Así, el tamaño global del pentagrama posibilita la fácil variación del tamaño general de una partitura impresa. Para ver los métodos de establecimiento del tamaño global del pentagrama, véase @ref{Setting the staff size}. @funindex magstep Si se necesita dibujar sólo una sección de una partitura a una escala distinta, por ejemplo una sección ossia o una nota al pie, no se puede simplemente cambiar el tamaño global del pentagrama porque esto afectaría a toda la partitura. En tales casos, el cambio de tamaño se hace sobreescribiendo tanto la propiedad @code{staff-space} de @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a nuestra disposición una función de Scheme, @code{magstep}, para convertir de un cambio en el tamaño de la fuente al cambio equivalente en @code{staff-space}. Para ver una explicación y un ejemplo de su utilización, consulte @rlearning{Length and thickness of objects}. @seealso Manual de aprendizaje: @rlearning{Length and thickness of objects}. Referencia de la notación: @ref{Page formatting}, @ref{Setting the staff size}. @node Spanners @subsection Spanners Muchos objetos de notación musical abarcan varias notas o incluso varios compases. Son ejemplos los crescendi, trinos, corchetes de grupo especial y corchetes de primera y segunda vez. Estos objetos se llaman @qq{spanners} u «objetos de extensión», y tienen propiedades especiales para controlar su apariencia y comportamiento. Algunas de estas propiedades son comunes a todos los objetos de extensión; otras se limitan a un subconjunto de los extensores. Todos los objetos de extensión contemplan el interface @code{spanner-interface}. Algunos, básicamente aquellos que trazan una línea recta entre los dos objetos, contemplan también el interface @code{line-spanner-interface}. @unnumberedsubsubsec Using the @code{spanner-interface} Este interface proporciona dos propiedades que se aplican a varios extensores. @strong{@i{La propiedad @code{minimum-length}}} La longitud mínima del objeto de extensión se pesoecifica a través de la propiedad @code{minimum-length}. Su aumento suele producir el efecto necesario de aumentar el espaciado de las notas entre los dos puntos extremos. Sin embargo, esta sobreescritura no tiene ningún efecto sobre muchos extensores, pues su longitud está determinada por otras consideraciones. Más abajo se muestran algunos ejemplos de dónde es efectiva. @ignore Works for: Tie MultiMeasureRest Hairpin Slur PhrasingSlur Works as long as callback is made: Glissando Beam Works not at all for: LyricSpace LyricHyphen LyricExtender TextSpanner System @end ignore @lilypond[verbatim,quote,relative=2] a~a a % increase the length of the tie -\tweak #'minimum-length #5 ~a @end lilypond @lilypond[verbatim,quote,relative=2] a1 \compressFullBarRests R1*23 % increase the length of the rest bar \once \override MultiMeasureRest #'minimum-length = #20 R1*23 a1 @end lilypond @lilypond[verbatim,quote,relative=2] a \< a a a \! % increase the length of the hairpin \override Hairpin #'minimum-length = #20 a \< a a a \! @end lilypond Esta sobreescritura se puede usar también para aumentar la longitud de las ligaduras de expresión y de fraseo: @lilypond[verbatim,quote,relative=2] a( a) a -\tweak #'minimum-length #5 ( a) a\( a\) a -\tweak #'minimum-length #5 \( a\) @end lilypond Para algunos objetos de preesentación, la propiedad @code{minimum-length} es efectiva sólo si se llama explícitamente al procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la propiedad @code{springs-and-rods} al valor @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima de un glissando no tiene efecto a no ser que se establezca la propiedad @code{springs-and-rods}: @lilypond[verbatim,quote,relative=1] % default e \glissando c' % not effective alone \once \override Glissando #'minimum-length = #20 e, \glissando c' % effective only when both overrides are present \once \override Glissando #'minimum-length = #20 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods e, \glissando c' @end lilypond Lo mismo se puede decir del objeto @code{Beam}: @lilypond[verbatim,quote,relative=1] % not effective alone \once \override Beam #'minimum-length = #20 e8 e e e % effective only when both overrides are present \once \override Beam #'minimum-length = #20 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods e8 e e e @end lilypond @strong{@i{The @code{to-barline} property}} La segunda propiedad útil del @code{spanner-interface} es @code{to-barline}. De forma predeterminada tiene el valor cierto, haciendo que los reguladores y otros objetos de extensión que terminan sobre la primera nota de un compás, en vez de eso terminen en la línea divisoria inmediatamente precedente. Si se establece al valor falso, el extensor llegará más allá de la barra de compás y terminará excatamente sobre la nota: @lilypond[verbatim,quote,relative=2] a \< a a a a \! a a a \break \override Hairpin #'to-barline = ##f a \< a a a a \! a a a @end lilypond Esta propiedad no es efectiva para todos los extensores. Por ejemplo, su establecimiento a @code{#t} no tienen ningún efecto sobre las ligaduras de expresión o de fraseo, o sobre otros extensores para los que terminar en la barra de compás no tendría ningún significado. @unnumberedsubsubsec Using the @code{line-spanner-interface} Entre los objetos que contemplan el interface @code{line-spanner-interface} se encuentran @itemize @item @code{DynamicTextSpanner} @item @code{Glissando} @item @code{TextSpanner} @item @code{TrillSpanner} @item @code{VoiceFollower} @end itemize La rutina responsable de dibujar los sellos de estos extensores es @code{ly:line-interface::print}. esta rutina determina la localización exacta de los dos puntos extremos y traza una línea entre ellos, en el estilo solicitado. Las posiciones de los dos puntos extremos del extensor se calculan al vuelo, pero es posible sobreescribir sus coordenadas Y. Las propiedades que se deben especificar están anidadas a dos niveles de profundidad en la jerarquía de propiedades, pero la sintaxis de la instrucción @code{\override} es bastante sencilla: @lilypond[relative=2,quote,verbatim] e2 \glissando b \once \override Glissando #'bound-details #'left #'Y = #3 \once \override Glissando #'bound-details #'right #'Y = #-2 e2 \glissando b @end lilypond Las unidades para la propiedad @code{Y} son @code{staff-space}s, siendo el punto del cero la línea central del pentagrama. Para el glissando, esto es el valor de @code{Y} en la coordenada X que corresponde al punto central de cada cabeza de nota si nos imaginamos que la línea se extiende hasta allí. Si no está fijado @code{Y}, su valor se calcula a partir de la posición vertical del punto de anclaje correspondiente del extensor. En caso de salto de línea, los valores para los puntos extremos se especifican por las sub-listas @code{left-broken} y @code{right-broken} de @code{bound-details}. 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 Un número de propiedades adicionales de las sub-listas @code{left} y @code{right} de la propiedad @code{bound-details} se pueden especificar de la misma forma que @code{Y}: @table @code @item Y Establece la coordenada Y del punto extremo, en desplazamientos de @code{staff-space}s desde la línea central del pentagrama. De forma predeterminada es el centro del objeto ancla, y así un glissando apunta al centro vertical de la cabeza de la nota. Para extensores horizontales como los extensores de texto y los trinos, está inamoviblemente codificado como 0. @item attach-dir (dirección de anclaje) Determina dónde comienza y termina la línea en la dirección X, con relación al objeto ancla. Sí, un valor de @code{-1} (o @code{LEFT}, izquierda) hace que la línea comienze o termine en el lado izquierdo de la cabeza de la nota a la que está anclado. @item X Es la coordenada X absoluta del punto extremo. Se suele calcular al vuelo, y su sobreescritura no tiene un efecto útil. @item stencil (sello) Los extensores de línea pueden tener símbolos al comienzo o al final, lo que está contenido en esta sub-propiedad. Esto es para uso interno; se recomienda en su lugar el uso de @code{text}. @item text (texto) Es un elemento de marcado que se evalúa para dar lugar al sello. Se usa para escribir @i{cresc.}, @i{tr} y otros textos 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 (alineación del sello en y) @item stencil-offset (desplazamiento del sello) Si no se modifican uno u otro, el sello se coloca sencillamente en el punto extremo, centrado sobrer la línea, como viene definido por las subpropiedades @code{X} e @code{Y}. Si se fijan @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el símbolo del borde verticalmente con relación al extremo de la línea: @lilypond[relative=1,fragment,verbatim] \override TextSpanner #'bound-details #'left #'stencil-align-dir-y = #-2 \override TextSpanner #'bound-details #'right #'stencil-align-dir-y = #UP \override TextSpanner #'bound-details #'left #'text = #"ggg" \override TextSpanner #'bound-details #'right #'text = #"hhh" c4^\startTextSpan c c c \stopTextSpan @end lilypond Observe que los valores negativos mueven el texto @emph{hacia arriba}, al contrario de lo que podríoa esperarse, pues el valor de @code{-1} o @code{DOWN} (abajo) significa alinear el bborde @emph{inferior} del texto con la línea de extensión. Un valor de @code{1} o @code{UP} (arriba) alinea el borde superior del texto con la línea extensora. @item arrow (flecha) Al establecer esta sub-propiedad a @code{#t} se produce una punta de flecha en el extremo de la línea. @item padding (relleno) Esta sub-propiedad controla el espacio entre el punto extremo especificado de la línea y el extremo real. Sin relleno, un glissando empezaría y terminaría en el centro de la cabeza de las notas. @end table La función musical @code{\endSpanners} finaliza de forma prematura el extensor que comienza sobre la nota que sigue inmediatamente a continuación. Se termina después de una nota exactamente, o en la siguiente barra de compás si @code{to-barline} es verdadero y se produce una divisoria antes de la siguiente nota. @lilypond[verbatim,quote,ragged-right,relative=2,fragment] \endSpanners c2 \startTextSpan c2 c2 \endSpanners c2 \< c2 c2 @end lilypond Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan con \stopTextSpan, ni cerrar los reguladores con @code{\!}. @seealso Referencia de funcionamiento interno: @rinternals{TextSpanner}, @rinternals{Glissando}, @rinternals{VoiceFollower}, @rinternals{TrillSpanner}, @rinternals{line-spanner-interface}. @node Visibility of objects @subsection Visibility of objects @cindex objetos, visibilidad de @cindex grobs, visibilidad de @cindex visibilidad de los objetos Hay cuatro formas principales en que se puede controlar la visibilidad de los objetos de presentación: se puede eliminar su sello, se pueden volver transparentes, se pueden pintar de blanco, o se puede sobreescribir su propiedad @code{break-visibility}. Las tres primeras se aplican a todos los objetos de presentación; la última sólo a unos pocos: los objetos @emph{divisibles}. El Manual de aprendizaje introduce estas cuatro técnicas, véase @rlearning{Visibility and color of objects}. Hay también algunas otras técnicas que son específicas de ciertos objetos de presentación. Se estudian bajo Consideraciones especiales. @menu * Removing the stencil:: * Making objects transparent:: * Painting objects white:: * Using break-visibility:: * Special considerations:: @end menu @node Removing the stencil @unnumberedsubsubsec Removing the stencil @cindex sello, eliminar Todo objeto de presentación tiene una propiedad stencil (sello). De forma predeterminada está establecida a la función específica que dibuja ese objeto. Se se sobreescribe eesta propiedad a @code{#f} no se llama a ninguna función y el objeto no se dibuja. La acción predeterminada se puede recuperar con @code{\revert}. @lilypond[quote,verbatim,relative=1] a1 a \override Score.BarLine #'stencil = ##f a a \revert Score.BarLine #'stencil a a a @end lilypond @node Making objects transparent @unnumberedsubsubsec Making objects transparent @cindex transparentes, hacer los objetos Todo objeto de presentación tiene una propiedad transparent (transparente) que de forma predeterminada está establecida a @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es invisible. @lilypond[quote,verbatim,relative=2] a4 a \once \override NoteHead #'transparent = ##t a a @end lilypond @node Painting objects white @unnumberedsubsubsec Painting objects white @cindex objetos, coloreado de @cindex coloreado de objetos @cindex capas @cindex impresión, orden de @cindex sobreescritura de objetos @cindex objetos, sobreescritura de @cindex grobs, sobreescritura de Todo objeto de presentación tiene una propiedad de color que de forma predeterminada está establecida a @code{black} (negro). Si se sobreescribe a @code{white} (blanco) el objeto será indistinguible del fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el color de los puntos de cruce queda determinado por el orden en que se dibujan estos objetos, lo que puede dejar una imagen fantasma del objeto blanco, como puede verse aquí: @lilypond[quote,verbatim,relative=2] \override Staff.Clef #'color = #white a1 @end lilypond Se puede evitar esto cambiando el orden de impresión de los objetos. Todos los objetos de presentación tienen una propiedad @code{layer} (capa) que se debe establecer a un valor entero. Los objetos con el valor de @code{layer} más bajo se dibujan primero, después se dibujan los objetos con valores progresivamente mayores, y así los objetos con valores más altos se dibujan encima de los que tienen valores más bajos. De forma predeterminada, casi todos los objetos tienen asignado un valor @code{layer} de @code{1}, aunque algunos objetos, entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol} y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de impresión de los objetos con el mismo valor de @code{layer} es indeterminado. En el ejemplo de arriba, la clave blanca, con un valor @code{layer} predeterminado de @code{1}, se dibuja después de las líneas del pentragrama (valor @code{layer} predeterminado de @code{0}), sobreimpresionándolas. Para cambiarlo, se debe dar al objeto @code{Clef} un valor de @code{layer} más bajo, digamos @code{-1}, para que se dibuje antes: @lilypond[quote,verbatim,relative=2] \override Staff.Clef #'color = #white \override Staff.Clef #'layer = #-1 a1 @end lilypond @node Using break-visibility @unnumberedsubsubsec Using break-visibility @c TODO Add making other objects breakable @cindex break-visibility Casi todos los objetos de presentación se imprimen una sola vez, pero algunos como las líneas divisorias, claves, indicaciones de compás y armaduras de tonalidad, se pueden tener que imprimir dos veces cuando se produce un salto de línea : una vez al final de la línea y otra al comienzo de la siguiente. Estos objetos reciben el nombre de @emph{divisibles}, y tienen una propiedad, @code{break-visibility} (visibilidad en el salto), para controlar su visibilidad en las tres posiciones en que pueden aparecer: al comienzo de una línea, dentro de la línea si se produce un cambio, y al final de la línea si el cambio se produce en ese lugar. Por ejemplo, la indicación de compás se imprime de forma predeterminada al comienzo de la primera línea y en ningún otro lugar a no ser que cambie, en cuyo caso se imprime en el punto en que se produce el cambio. Si este cambio se produce al final de una línea, la nueva indicación de compás se imprime al principio de la línea siguiente y también al final de la línea anterior como indicación de precaución. Este comportamiento se controla por medio de la propiedad @code{break-visibility}, que se explica en @c Leave this ref on a newline - formats incorrectly otherwise -td @rlearning{Visibility and color of objects}. Esta propiedad toma un vector de tres valores booleanos que, por orden, determinan si el objeto se imprime al final, dentro, o al principio de la línea. O, para ser más exactos: antes del salto de línea, si no hay salto, o después del salto. Como alternativa se pueden especificar siete de las ocho combinaciones mediante funciones predefinidas cuya definición está en @file{scm/output-lib.scm}, donde las tres últimas columnas indican si los objetos de presentación serán visibles en las posiciones que se muestran en el encabezamiento de cada columna: @multitable @columnfractions .40 .15 .1 .1 .1 @c TODO check these more carefully @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del @headitem de función @tab de vector @tab salto @tab salto @tab salto @item @code{all-invisible} @tab @code{'#(#f #f #f)} @ @ @tab no @tab no @tab no @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí @c The center-visible function is not defined @c @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí @end multitable La función @code{center-visible} no está predefinida. Los ajustes predeterminados de @code{break-visibility} dependen del objeto de presentación. La tabla siguiente muestra todos los objetos de presentación de interés que resultan afectados por @code{break-visibility} y el ajuste predeterminado de esta propiedad: @multitable @columnfractions .3 .3 .4 @headitem Objeto @tab Contexto usual @tab Valor predet. @c omit Ambitus as it appears not to be affected by break-visibility -td @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible} @item @code{BarLine} @tab @code{Score} @tab calculado @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible} @c omit the following item until it can be explained -td @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculated @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible} @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible} @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible} @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible} @c omit KeyCancellation until it can be explained -td @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible} @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible} @c omit LeftEdge until it can be explained -td @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible} @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible} @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible} @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible} @end multitable El ejemplo de abajo muestra el uso de la forma de vector para controlar la visibilidad de las líneas divisorias: @lilypond[quote,verbatim,relative=1,ragged-right] f4 g a b f4 g a b % Remove bar line at the end of the current line \once \override Score.BarLine #'break-visibility = #'#(#f #t #t) \break f4 g a b f4 g a b @end lilypond Aunque los tres componentes del vector utilizado para sobreescribir @code{break-visibility} deben estar presentes, no todos son efectivos para todos los objetos de presentación, y algunas combinaciones pueden incluso dar errores. Son de aplicación las siguientes limitaciones: @itemize @bullet @item Las líneas divisorias no se pueden imprimir al principio de la línea. @item No se puede imprimir el número de compás al principio de la primera línea a no ser que su valor establecido sea distinto de 1. @item Clave: véase más abajo @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o se suprimen por completo. Utilice begin-of line-invisible para imprimirlas y all-invisible para suprimirlas. @item Armadura: véase más abajo @item OctavateEight: véase más abajo @end itemize @node Special considerations @unnumberedsubsubsec Special considerations @strong{@emph{Visibilidad después de un cambio explícito}} @cindex armadura, visibilidad después de un cambio explícito @cindex explicitKeySignatureVisibility @cindex clave, visibilidad después de un cambio explícito @cindex explicitClefVisibility La propiedad @code{break-visibility} controla la visibilidad de las armaduras y cambios de clave sólo al principio de las líneas, es decir, después de un salto. No tiene ningún efecto sobre la visibilidad de la armadura o la clave después de un cambio explícito de tonalidad o de clave dentro o al final de una línea. En el ejemplo siguiente la armadura que sigue al cambio explícito de tonalidad a Si bemol mayor es visible incluso con @code{all-invisible} establecido. @lilypond[quote,verbatim,relative=1,ragged-right] \key g \major f4 g a b % Try to remove all key signatures \override Staff.KeySignature #'break-visibility = #all-invisible \key bes \major f4 g a b \break f4 g a b f4 g a b @end lilypond La visibilidad de estos cambios explícitos de tonalidad y de clave se controla por medio de las propiedades @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}. Son los equivalentes de la propiedad @code{break-visibility} y las dos toman un vector de tres valores booleanos o las funciones predefinidas relacionadas anteriormente, exactamente igual que @code{break-visibility}. Las dos son propiedades del contexto Staff, no de los propios objetos de presentación, y por tanto se establecen utilizando la instrucción @code{\set}. Las dos están establecidas de forma predeterminada al valor @code{all-visible}. Estas propiedades controlan sólo la visibilidad de las armaduras y las claves que resultan de los cambios explícitos y no afectan a las armaduras y tonalidades que están al principio de las líneas; para quitarlas, aún se debe sobreescribir la propiedad @code{break-visibility} en el objeto correspondiente. @lilypond[quote,verbatim,relative=1,ragged-right] \key g \major f4 g a b \set Staff.explicitKeySignatureVisibility = #all-invisible \override Staff.KeySignature #'break-visibility = #all-invisible \key bes \major f4 g a b \break f4 g a b f4 g a b @end lilypond @strong{@emph{Visibilidad de las alteraciones de precaución}} Para eliminar las alteraciones de precaución que se imprimen en un cambio de tonalidad explícito, establezca la propiedad @code{printKeyCancellation} del contexto Staff a @code{#f}: @lilypond[quote,verbatim,relative=1,ragged-right] \key g \major f4 g a b \set Staff.explicitKeySignatureVisibility = #all-invisible \set Staff.printKeyCancellation = ##f \override Staff.KeySignature #'break-visibility = #all-invisible \key bes \major f4 g a b \break f4 g a b f4 g a b @end lilypond Con estas sobreescrituras solamente permanecen las alteraciones accidentales delante de las notas para indicar el cambio de tonalidad. @c TODO Add visibility of cautionary accidentals before notes @strong{@emph{Automatic bars}} @cindex automaticBars @cindex líneas divisorias, eliminación Como caso especial, la impresión de las líneas divisorias también se puede inhabilitar estableciendo la propiedad @code{automaticBars} en el contexto Score. Si se fija a @code{#f}, las barras de compás no se imprimen automáticamente; se deben crear explícitamente con una instrucción @code{\bar}. A diferencia de la instrucción predefinida @code{\cadenzaOn}, los compases se siguen contando. La generación de compases continúa de acuerdo a esta cuenta si esta propiedad se establece posteriormente a @code{#t}. Si se fija al valor @code{#f}, sólo pueden producirse saltos de línea en instrucciones @code{\bar} explícitas. @c TODO Add example @strong{@emph{Octavated clefs}} @cindex octavadas, visibilidad de las claves @cindex visibilidad de las claves octavadas @cindex claves, visibilidad de la octavación El pequeño símbolo de octava sobre las claves en octava alta o baja se produce por parte del objeto @code{OctavateEight}. Su visibilidad se controla independientemente de la del objeto @code{Clef}, así que es necesario aplicar las sobreescrituras correspondientes @code{break-visibility} tanto a los objetos @code{Clef} como @code{OctavateEight} para suprimir completamente estos símbolos de clave al comienzo de cada línea. Para los cambios de clave explícitos, la propiedad @code{explicitClefVisibility} controla tanto el símbolo de clave como el símbolo de octava asociado. @seealso Manual de aprendizaje: @rlearning{Visibility and color 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 Las posiciones de los puntos extremos del objeto de extensión se computan al vuelo para cada uno de los objetos gráficos, 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 valor de @code{Y} está establecido a @code{-2} para el extremo derecho. El lado izquierdo se puede ajustar de forma similar especificando @code{left} en vez de @code{right}. Si no está establecido @code{Y}, el valor se computa a partir de la posición vertical de los puntos de anclaje izquierdo y derecho del extensor. Son posibles otros ajustes de los extensores, para ver más detalles consulte @ref{Spanners}. @node Rotating objects @subsection Rotating objects Tanto los objetos de presentación como los elementos de texto de marcado se pueden girar cualquier ángulo respecto a cualquier punto, pero difiere el método de hacerlo. @menu * Rotating layout objects:: * Rotating markup:: @end menu @node Rotating layout objects @unnumberedsubsubsec Rotating layout objects @cindex rotating objects @cindex objects, rotating Todos los objetos de presentación que contemplan el interface @code{grob-interface} se pueden rotar estableciendo su propiedad @code{rotation}. Acepta una lista de tres elementos: el ángulo de la rotación en sentido antihorario, y las coordenadas x e y del punto con relación al punto de referencia del objeto, alrededor del que se va a realizar la rotación. El ángulo de rotación se pespecifica en grados y las coordenadas en espacios de pentagrama. El ángulo de rotación y las coordenadas del punto de rotación se deben determinar por ensayo y error. @cindex reguladores en ángulo @cindex ángulo, reguladores en Solamente en ciertas ocasiones es útil la rotación de objetos de presentación; el ejemplo siguiente muestra una situación en que puede serlo: @lilypond[quote,verbatim,relative=1] g4\< e' d' f\! \override Hairpin #'rotation = #'(20 -1 0) g,,4\< e' d' f\! @end lilypond @node Rotating markup @unnumberedsubsubsec Rotating markup Todos los textos de marcado se pueden rotar para que se dispongan en cualquier ángulo predeciéndolos de la instrucción @code{\rotate}. La instrucción acepta dos argumentos: el ángulo de rotación en grados en sentido antihorario, y el texto que rotar. Los límites que ocupa el texto no se rotan: toman su valor a partir de los extremos de las coordenadas x e y del texto rotado. En el ejemplo siguiente la propiedad @code{outside-staff-priority} del texto se establece a @code{#f} para desactivar la evitación automática de colisiones, lo que empuja al texto a una posición muy alta. @lilypond[quote,verbatim,relative=1] \override TextScript #'outside-staff-priority = ##f g4^\markup { \rotate #30 "a G" } b^\markup { \rotate #30 "a B" } des^\markup { \rotate #30 "a D-Flat" } fis^\markup { \rotate #30 "an F-Sharp" } @end lilypond @node Advanced tweaks @section Advanced tweaks Esta sección trata sobre distintos enfoques en la realización de ajustes finos a la apariencia de la partitura impresa. @menu * Aligning objects:: * Vertical grouping of grobs:: * Modifying stencils:: * Modifying shapes:: @end menu @seealso Manual de aprendizaje: @rlearning{Tweaking output}, @rlearning{Other sources of information}. Referencia de la notación: @ref{Explaining the Internals Reference}, @ref{Modifying properties}, @ref{Interfaces for programmers}. Archivos de inicio: @file{scm/@/define@/-grobs@/.scm}. Fragmentos de código: @rlsr{Tweaks and overrides}. Referencia de funcionamiento interno: @rinternals{All layout objects}. @node Aligning objects @subsection Aligning objects Los objetos gráficos que soportan el interface @code{self-alignment-interface} y/o el @code{side-position-interface} se pueden alinear contra un objeto colocado previamente, de diversas maneras. Para ver una lista de estos objetos, consulte @rinternals{self-alignment-interface} y @rinternals{side-position-interface}. Todos los objetos gráficos tienen un punto de referencia, una extensión horizontal y una extensión vertical. La extensión horizontal es una pareja de números que dan los desplazamientos a partir del punto de referencia de los bordes izquierdo y derecho, siendo negativos los desplazamientos hacia la izquierda. La extensión vertical es una pareja de números que dan el desplazamiento a partir del punto de referencia hasta los bordes inferior y superior, siendo negativos los deplazamientos hacia abajo. La posición de un objeto sobre el pentagrama viene dada por los valores de las propiedades @code{X-offset} e @code{Y-offset}. El valor de @code{X-offset} da el desplazamiento desde la coordenada x del punto de referencia del objeto padre, y el valor de @code{Y-offset} da el desplazamiento a partir de la línea central del pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se pueden establecer directamente o se puede dejar que se calculen por parte de procedimientos para conseguir una alineación con el objeto padre de distintas maneras. @warning{Muchos objetos tienen consideraciones de posicionamiento especiales que hacen que se ignore o se modifique cualquier ajuste realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el objeto contemple el interface @code{self-alignment-interface}.} Por ejemplo, una alteración accidental se puede reposicionar verticalmente estableciendo @code{Y-offset} pero los cambios a @code{X-offset} no tienen ningún efecto. Las letras de ensayo se pueden alinear con objetos divisibles como líneas divisorias, claves, armaduras e indicaciones de compás. Hay propiedades especiales que se encuentran en @code{break-aligned-interface} para el posicionamiento de las letras de ensayo sobre dichos objetos. @menu * Setting @code{X-offset} and @code{Y-offset} directly:: * Using the @code{side-position-interface}:: * Using the @code{self-alignment-interface}:: * Using the @code{break-aligned-interface}:: @end menu @node Setting @code{X-offset} and @code{Y-offset} directly @unnumberedsubsubsec Setting @code{X-offset} and @code{Y-offset} directly Se pueden dar valores numéricos a las propiedades @code{X-offset} y @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres notas con una digitación en su posición predeterminada y con los valores @code{X-offset} y @code{Y-offset} modificados. @lilypond[verbatim,quote,relative=2] a-3 a -\tweak #'X-offset #0 -\tweak #'Y-offset #0 -3 a -\tweak #'X-offset #-1 -\tweak #'Y-offset #1 -3 @end lilypond @c TODO write more @node Using the @code{side-position-interface} @unnumberedsubsubsec Using the @code{side-position-interface} Un objeto que contempla el @code{side-position-interface} se puede colocar junto a su objeto padre de forma que los bordes especificados de los dos objetos se toquen. El objeto se puede situar encima, debajo, a la derecha o a la izquierda del objeto padre. El padre no se puede especificar; ciene determinado por el orden de los elementos en el flujo de entrada. Casi todos los objetos tienen la cabeza de la nota asociada como padre. Los valores de las propiedades @code{side-axis} y @code{direction} determinan dónde colocar el objeto, como sigue: @c TODO add an example of each to the table @multitable @columnfractions .3 .3 .3 @headitem @code{side-axis} @tab @code{direction} @tab @headitem propiedad @tab propiedad @tab colocación @item @code{0} @tab @code{-1} @tab izquierda @item @code{0} @tab @code{1} @tab derecha @item @code{1} @tab @code{-1} @tab debajo @item @code{1} @tab @code{1} @tab encima @end multitable Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al procedimiento @code{ly:side-position-interface::x-aligned-side}. Este procedimiento devuelve el calor correcto de @code{X-offset} para situar el objeto al lado izquierdo o derecho del padre de acuerdo con el valor de @code{direction}. Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al procedimiento @code{ly:side-position-interface::y-aligned-side}. Este procedimiento devuelve el valor correcto de @code{Y-offset} para situar el objeto encima o debajo del padre de acuerdo con el valor de @code{direction}. @c TODO Add examples @node Using the @code{self-alignment-interface} @unnumberedsubsubsec Using the @code{self-alignment-interface} @emph{Auto-alineación horizontal de los objetos} La alineación horizontal de un objeto que contempla el interface @code{self-alignment-interface} está controlada por el valor de la propiedad @code{self-alignment-X}, siempre y cuando la propiedad @code{X-offset} de este objeto esté establecida a @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede dar a @code{self-alignment-X} cualquier valor real, en unidades de la mitad de la extensión X total del objeto. Los valores negativos mueven el objeto a la derecha, los positivos hacia la izquierda. Un valor de @code{0} centra el objeto sobre el punto de referencia de su padre, un valor de @code{-1} alinea el borde izquierdo del objeto sobre el punto de referencia de su padre, y un valor de @code{1} alinea el borde derecho del objeto sobre el punto de referencia de su padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y @code{RIGHT} en sustitución de los valores @code{-1, 0, 1}, respectivamente. Normalmente se usaría la instrucción @code{\override} para modificar el valor de @code{self-alignment-X}, pero se puede usar la instrucción @code{\tweak} para alinear varias anotaciones por separado sobre una sola nota: @lilypond[quote,verbatim,relative=1] a' -\tweak #'self-alignment-X #-1 ^"left-aligned" -\tweak #'self-alignment-X #0 ^"center-aligned" -\tweak #'self-alignment-X #RIGHT ^"right-aligned" -\tweak #'self-alignment-X #-2.5 ^"aligned further to the right" @end lilypond @emph{Auto-alineación vertical de los objetos} Los objetos se pueden alinear verticalmente en una forma análoga a la alineación horizontal si la propiedad @code{Y-offset} está establecida a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo, a menudo se encuentran implicados otros mecanismos en la alineación vertical: el valor de @code{Y-offset} es tan sólo una variable que se tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos objetos sea una tarea dificultosa. Las unidades son sólo la mitad de las dimensiones verticales del objeto, que suele ser bastante pequeño, por lo que pueden requerirse números bastante grandes. Un valor de @code{-1} alinea el borde inferior del objeto con el punto de referencia del objeto padre, un valor de @code{0} alinea el centro del objeto con el punto de referencia del padre, y un valor de @code{1} alinea el borde superior del objeto con el punto de referencia del padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER}, @code{UP} en sustitución de @code{-1, 0, 1} respectivamente. @emph{Auto-alineación de objetos en las dos direcciones} Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede alinear un objeto en las dos direcciones simultáneamente. El ejemplo siguiente muestra cómo ajustar una digitación de forma que se acerque a la cabeza de la nota. @lilypond[quote,verbatim,relative=2] a -\tweak #'self-alignment-X #0.5 % move horizontally left -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self -\tweak #'self-alignment-Y #-1 % move vertically up -3 % third finger @end lilypond @ignore @unnumberedsubsubsec Using the @code{aligned-on-parent} procedures @c Cannot document as they do not seem to operate consistently on all objects -td @c TODO investigate further The @code{aligned-on-parent} procedures are used in the same way as the @code{aligned-on-self} procedures, they difference being that they permit an object to be aligned with the @emph{edges} of the parent rather than the parent's reference point. The following example shows the difference: @c TODO Add example @lilypond[verbatim,quote] @end lilypond @end ignore @ignore @unnumberedsubsubsec Using the @code{centered-on-parent} procedures @c Cannot document as they do not seem to operate consistently on all objects -td @c TODO investigate further @end ignore @c TODO The align-interface, BassFigureAlignment and VerticalAlignment @node Using the @code{break-aligned-interface} @unnumberedsubsubsec Using the @code{break-aligned-interface} Las letras de ensayo se pueden alinear con objetos de notación distintos a las barras de compás. Estos objetos son @code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar}, @code{left-edge}, @code{key-cancellation}, @code{key-signature} y @code{time-signature}. De forma predeterminada, las letras de ensayo se centran horizontalmente sobre el objeto: @lilypond[verbatim,quote,relative=1] e1 % the RehearsalMark will be centered above the Clef \override Score.RehearsalMark #'break-align-symbols = #'(clef) \key a \major \clef treble \mark "↓" e % the RehearsalMark will be centered above the TimeSignature \override Score.RehearsalMark #'break-align-symbols = #'(time-signature) \key a \major \clef treble \time 3/4 \mark "↓" e2. @end lilypond La alineación de la letra de enzayo con relación al objeto de notación se puede cambiar, como se ve en el ejemplo siguiente. En una partitura con varios pentagramas, este ajuste se debe hacer para todos los pentagramas. @lilypond[verbatim,quote,relative=1] % The RehearsalMark will be centered above the KeySignature \override Score.RehearsalMark #'break-align-symbols = #'(key-signature) \key a \major \clef treble \time 4/4 \mark "↓" e1 % The RehearsalMark will be aligned with the left edge of the KeySignature \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT \mark "↓" \key a \major e % The RehearsalMark will be aligned with the right edge of the KeySignature \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT \key a \major \mark "↓" e @end lilypond La letra de ensayo también se puede desplazar al borde derecho o izquierdo en una medida arbitraria. Las unidades son espacios de pentagrama: @lilypond[verbatim,quote,relative=1] % The RehearsalMark will be aligned with the left edge of the KeySignature % and then shifted right by 3.5 staff-spaces \override Score.RehearsalMark #'break-align-symbols = #'(key-signature) \once \override Score.KeySignature #'break-align-anchor = #3.5 \key a \major \mark "↓" e % The RehearsalMark will be aligned with the left edge of the KeySignature % and then shifted left by 2 staff-spaces \once \override Score.KeySignature #'break-align-anchor = #-2 \key a \major \mark "↓" e @end lilypond @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 stencils @subsection Modifying stencils Todos los objetos de presentación tienen una propiedad @code{stencil} que es parte del @code{grob-interface}. De forma predeterminada, esta propiedad suele estar establecida a una función específica del objeto que está hecha a medida para disponer el símbolo que lo representa en la salida. Por ejemplo, el ajuste estándar para la propiedad @code{stencil} del objeto @code{MultiMeasureRest} es @code{ly:multi-measure-rest::print}. El símbolo estándar de cualquier objeto se puede sustituir modificando la propiedad @code{stencil} para que haga referencia a un procedimiento diferente escrito especialmente. Esto requiere un alto nivel de conocimiento del funcionamiento interno de LilyPond, pero hay una forma más fácil que a menudo puede dar resultados adecuados. El procedimiento es establecer la propiedad @code{stencil} al procedimiento que imprime texto (@code{ly:text-interface::print}) y añadir una propiedad @code{text} al objeto ajustada para que contenga el texto de marcado que produce el símbolo requerido. Debido a la flexibilidad del marcado, se pueden conseguir muchas cosas; en particular, consulte @ref{Graphic notation inside markup}. El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de la nota a unas aspas dentro de una circunferencia. @lilypond[verbatim,quote] XinO = { \once \override NoteHead #'stencil = #ly:text-interface::print \once \override NoteHead #'text = \markup { \combine \halign #-0.7 \draw-circle #0.85 #0.2 ##f \musicglyph #"noteheads.s2cross" } } \relative c'' { a a \XinO a a } @end lilypond Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar a la instrucción de marcado @code{\musicglyph}: véase @ref{The Feta font}. @c TODO Add inserting eps files or ref to later @c TODO Add inserting Postscript or ref to later @seealso Referencia de la notación: @ref{Graphic notation inside markup}, @ref{Formatting text}, @ref{Text markup commands}, @ref{The Feta font}. @node Modifying shapes @subsection Modifying shapes @menu * Modifying ties and slurs:: @end menu @node Modifying ties and slurs @unnumberedsubsubsec Modifying ties and slurs Las ligaduras de unión, de expresión y de fraseo se trazan como curvas de Bézier de tercer orden. Si la forma de la ligadura calculada automáticamente no resulta óptima, se puede modificar su forma manualmente mediante la especificación explícita de los cuatro puntos de control necesarios para definir una curva de Bézier de tercer orden. Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro puntos de control. El primer y cuarto puntos de control son exactamente los puntos extremos de comienzo y de final de la curva. Los dos puntos de contros intermedios definen la forma. Se pueden encontrar en la web animaciones que muestran cómo se traza la curva, pero la descripción siguiente puede ser de ayuda. La curva comienza a partir del primer punto de control dirigiéndose directamente hacia el segundo, curvándose progresivamente para dirigirse hacia el tercero y continuando la curva hacia el cuarto, llegando a éste en viaje directo desde el tercer punto de control. La curva está contenida enteramente dentro del cuadrilátero definido por los cuatro puntos de control. He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde @code{\tieDown} no sirve de ayuda. @lilypond[verbatim,quote,relative=1] << { e1 ~ e } \\ { r4 } >> @end lilypond Una forma de mejorar esta ligadura es modificar manualmente sus puntos de control como sigue. Las coordenadas de los puntos de control de Bézier se especifican en unidades de espacios de pentagrama. La coordenada@tie{}X está en relación con el punto de referencia de la nota a la que está unida la ligadura, y la coordenada@tie{}Y está en relación con la línea central del pentagrama. Las coordenadas se introducen como una lista de cuatro parejas de números decimales (reales). Un enfoque es estimar las coordenadas de los dos puntos extremos, y luego tratar de adivinar los dos puntos intermedios. Los valores óptimos se encuentran por ensayo y error. Es útil recordar que una curva simétrica necesita puntos de contros simétricos, y que las curvas de Bézier tienen la útil propiedad de que las transformaciones de la curva tales como la traslación, rotación y escalado se pueden obtener aplicando la misma transformación a los puntos de control de la curva. Para el ejemplo anterior, la sobreescritura siguiente da una ligadura satisfactoria: @lilypond[verbatim,quote,relative=1] << \once \override Tie #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1)) { e1 ~ e1 } \\ { r4 4 } >> @end lilypond @knownissues No es posible modificar la forma de las ligaduras de unión o de expresión cambiando la propiedad @code{control-points} si hay más de una en el mismo mom ento musical, ni siquiera usando la instrucción @code{\tweak}.