1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 56ed249c9d5076f33515e36af54126ea5fb88783
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
10 @node Changing defaults
11 @chapter Changing defaults
14 El objetivo del diseño de LilyPond es proporcionar por defecto la más alta
15 calidad de los resultados. A pesar de ello, podría tener que cambiar
16 este resultado por defecto. La disposición sobre el papel se controla a través de un amplio número
17 de proverbiales @q{botones e interruptores.} Este capítulo no
18 relaciona todos y cada uno de los botones. Más bien da una visión de conjunto sobre qué grupos de controles
19 se encuentran disponibles y explica la forma de hallar el botón exacto que se debe utilizar para conseguir
20 un determinado efecto.
23 @cindex Referencia de funcionamiento interno
25 Los controles disponibles para los ajustes finos se describen en un documento
28 el Manual de referencia de funcionamiento interno.
31 la @ref{Top,Referencia de funcionamiento interno,,lilypond-internals}.
34 relaciona todas las variables, funciones y opciones que se encuentran disponibles en
35 LilyPond. Está escrito como un documento HTML, que se puede encontrar en
36 @c leave the @uref as one long line.
37 @uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,on@/-line},
38 pero que también va incluido en el paquete de la documentación de LilyPond.
40 Hay cuatro áreas en las que se pueden cambiar los valores por defecto:
44 Notación automática: cambiar la creación automática de los elementos de
45 notación. Por ejemplo, cambiar las reglas de barrado de las figuras.
48 Salida: cambiar el aspecto de los objetos individuales.
49 Por ejemplo, cambiar las direcciones de las plicas o la situación exacta de
53 Contexto: modificar aspectos de la traducción de los eventos musicales en
54 notación. Por ejemplo, dar a cada pentagrama una indicación de compás distinta.
57 Disposición de la página: cambiar el aspecto visual del espaciado, los saltos de
58 línea y las dimensiones de la página. Estas modificaciones se discuten
59 en @ref{Non-musical notation} y @ref{Spacing issues}.
62 Internamente, LilyPond utiliza el lenguaje Scheme (un dialecto de LISP) para aportar
63 la infraestructura. La sobreescritura de las decisiones de disposición da acceso efectivo a las interioridades
64 del programa, lo que requiere código de Scheme como entrada. Los elementos de Scheme
65 se inauguran dentro de un archivo @code{.ly} con el símbolo de cuadradillo
66 @code{#}.@footnote{@rlearning{Scheme tutorial} contiene un breve tutorial
67 sobre la introducción de números, listas, cadenas y símbolos en Scheme.}
71 * Interpretation contexts::
72 * The \override command::
76 @node Interpretation contexts
77 @section Interpretation contexts
79 Esta sección explica qué son los contextos y cómo modificarlos.
82 * Contexts explained::
84 * Changing context properties on the fly::
85 * Modifying context plug-ins::
86 * Layout tunings within contexts::
87 * Changing context default settings::
88 * Defining new contexts::
90 * Vertical grouping of grobs::
94 @node Contexts explained
95 @subsection Contexts explained
97 Cuando se imprime la música, se tienen que añadir a la salida una gran cantidad de elementos
98 notacionales. Por ejemplo, compare la entrada y la salida del siguiente ejemplo:
100 @lilypond[quote,verbatim,relative=2,fragment]
104 La entrada es bastante escueta, pero en la salida se añaden líneas divisorias, alteraciones accidentales,
105 la clave y la indicación de compás. LilyPond @emph{interpreta} la
106 entrada. En esta fase se inspecciona la información musical en orden temporal,
107 de forma parecida a la lectura de una partitura de izquierda a derecha. Mientras se lee
108 la entrada, el programa recuerda dónde se encuentran los límites de los compases, y qué notas
109 requieren alteraciones explícitas. Esta información se puede presentar sobre varios
110 niveles. Por ejemplo, el efecto de una alteración accidental se encuentra limitada
111 a un solo pentagrama, mientras que una barra divisoria debe estar sincronizada a través
112 de la partitura de arriba a abajo.
114 Dentro de LilyPond, estas reglas y pequeñas porciones de información se agrupan en
115 @emph{Contexts}. Algunos ejemplos de contextos son @code{Voice} (Voz),
116 @code{Staff} (Pauta o pentagrama) y @code{Score} (Partitura). Los contextos son jerárquicos, por
117 ejemplo: un @code{Staff} contener muchas @code{Voice}s, y una
118 @code{Score} puede contener muchos contextos de @code{Staff}.
121 @sourceimage{context-example,5cm,,}
124 Cada contexto asume la responsabilidad de imponer algunas reglas de notación,
125 creando ciertos objetos de notación y manteniendo las propiedades
126 asociadas. Por ejemplo, el contexto @code{Voice} puede introducir una alteración
127 accidental y entonces el contexto @code{Staff} mantiene la regla de mostrar o
128 suprimir la alteración para el resto del compás. La
129 sincronización de las líneas divisorias se gestiona dentro del contexto de la partitura, @code{Score}.
131 Sin embargo, en algunas músicas posiblemente no queramos que las líneas divisorias estén
132 sincronizada (pensemos en una partitura polimétrica en compases de 4/4 y de 3/4). En tales casos,
133 debemos modificar los ajustes por omisión de los contextos @code{Score}
136 Para partituras muy sencillas, los contextos se crean implícitamente y no debemos
137 preocuparnos por ellos. Para piezas mayores, como por ejemplo cualquiera que tenga más de un pentagrama,
138 los contextos se deben crear explícitamente para asegurarnos
139 de que tendremos la cantidad exacta de pentagramas que necesitamos,
140 y que están en el orden correcto. Para tipografiar piezas
141 con notación especializada, puede ser útil modificar contextos existentes
142 o definir unos nuevos.
145 En la referencia del programa se encuentra una descripción completa de todos los contextos que están disponibles,
148 @internalsref{Contexts}.
151 Traducción @expansion{} Contexto.
154 @c [TODO: describe propagation]
157 @node Creating contexts
158 @subsection Creating contexts
160 Para partituras que sólo tienen una voz y un pentagrama, los contextos se
161 crean automáticamente. Para partituras más complejas, es necesario crearlos
162 a mano. Existen tres instrucciones que hacen esto.
167 La instrucción más fácil es @code{\new}, y es también la más rápida de escribir.
168 Se antepone a una expresión musical, por ejemplo
171 @cindex nuevos, contextos
172 @cindex Contexto, creación de
175 \new @var{tipo} @var{expresión_musical}
179 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
180 @code{Voice}). Esta instrucción crea un contexto nuevo, y empieza a
181 interpretar la @var{expresión_musical} con él.
183 Una aplicación práctica de @code{\new} es una partitura con muchos pentagramas.
184 Cada parte que debe ir en su propio pentagrama, va precedida de
187 @lilypond[quote,verbatim,relative=2,ragged-right,fragment]
194 La instrucción @code{\new} puede también dar nombre al contexto,
197 \new @var{tipo} = @var{identificador} @var{música}
199 Sin embargo, este nombre especificado por el usuario sólo se utiliza si no hay ya otro contexto
200 anterior con el mismo nombre.
206 Como @code{\new}, la instrucción @code{\context} también dirige una expresión musical
207 a un objeto de contexto, pero da al contexto un nombre explícito. La sintaxis
211 \context @var{tipo} = @var{identificador} @var{música}
214 En esta forma, la instrucción buscará un contexto existente del @var{tipo} especificado
215 que tenga el nombre @var{identificador}. Si ese contexto aún no existe, se crea
216 un contexto nuevo con el nombre especificado. Esto es útil si nos vamos a referir
217 más tarde al contexto. Por ejemplo, cuando
218 se escribe la letra, la melodía está dentro de un contexto con nombre
221 \context Voice = "@b{tenor}" @var{música}
225 de forma que los textos se puedan alienar correctamente con sus notas,
228 \new Lyrics \lyricsto "@b{tenor}" @var{letra}
233 Otro uso posible de los contextos con nombre es la fusión de dos expresiones musicales
234 distintas en un solo contexto. En el siguiente ejemplo,
235 se introducen por separado las articulaciones y las notas,
239 decoracion = @{ s4-. s4-> @}
242 se combinan enviando los dos al mismo contexto @code{Voice},
246 \new Staff \context Voice = "A" \musica
247 \context Voice = "A" \decoracion
250 @lilypond[quote,ragged-right]
254 \new Staff \context Voice = "A" \music
255 \context Voice = "A" \arts
259 Con este mecanismo, es posible definir un Urtext (una edición
260 original), con la posibilidad de poner articulaciones distintas sobre las
263 @cindex crear contextos
266 La tercera instrucción para crear contextos es
268 \context @var{tipo} @var{música}
273 Esto es similar a @code{\context} con @code{= @var{identificador}}, pero se corresponde con
274 cualquier contexto del tipo @var{tipo}, sin importar qué nombre se le ha dado.
276 Esta variante se usa con expresiones musicales que se pueden interpretar en
277 varios niveles. Por ejemplo, la instrucción @code{\applyOutput} (véase
278 @ref{Running a function on all layout objects}). Sin una instrucción
279 @code{\context} explícita, normalmente se aplicaría a @code{Voice}
282 \applyOutput #'@var{contexto} #@var{función} % aplicar al contexto Voice
285 Para que se interprete dentro de los niveles de @code{Score} o @code{Staff}, utilice las siguientes
289 \applyOutput #'Score #@var{función}
290 \applyOutput #'Staff #@var{función}
296 @node Changing context properties on the fly
297 @subsection Changing context properties on the fly
301 @cindex changing properties
303 Cada contexto puede tener diferentes @emph{propiedades} o variables contenidas
304 en dicho contexto. Se pueden cambiar mientras se desarrolla la fase de interpretación.
305 Esto se consigue insertando la instrucción @code{\set} en la música,
308 \set @var{contexto}.@var{propiedad} = #@var{valor}
312 @lilypond[quote,verbatim,relative=2,fragment]
314 \set Score.skipBars = ##t
318 Esta instrucción hace que se salten los compases que no tienen ninguna nota. El resultado es que
319 los silencios multicompás se comprimen. El valor asignado es un objeto del lenguaje Scheme. En
320 este caso, es @code{#t}, el valor booleano Verdadero.
322 Si el argumento @var{contexto} se deja en blanco, entonces se utiliza el contexto actual más bajo
323 (normalmente @code{ChordNames}, @code{Voice} o
324 @code{Lyrics}). En este ejemplo,
326 @lilypond[quote,verbatim,relative=2,fragment]
328 \set autoBeaming = ##f
333 el argumento @var{contexto} para la instrucción @code{\set} está omitido, por tanto
334 el barrado automático está desactivado en la @internalsref{Voice} (voz) actual. Fíjese en que
335 el contexto más bajo no siempre contiene la propiedad que quiere
336 cambiar. Por ejemplo, si intenta establecer la propiedad @code{skipBars}
337 (del contexto más bajo, en este caso @code{Voice}) no se producirá ningún
340 @lilypond[quote,verbatim,relative=2,fragment]
346 Los contextos son jerárquicos, de forma que si se especificó un contexto mayor, por
347 ejemplo @code{Staff}, entonces el cambio también se aplicaría a todos los
348 @code{Voice}s o contextos de voz en el pentagrama actual. El cambio se aplica
349 @q{al vuelo}, mientras transcurre la música, de manera que el ajuste sólo afecta al segundo
354 También existe una instrucción @code{\unset},
356 \unset @var{contexto}.@var{propiedad}
360 que quita la definición de la @var{propiedad}. Esta instrucción quita
361 la definición solamente si está establecida dentro del @var{contexto} especificado, por lo que
364 \set Staff.autoBeaming = ##f
368 introduce un ajuste de propiedad en el nivel del contexto @code{Staff}. El ajuste también se aplica
369 a la @code{Voice} actual. Sin embargo,
372 \unset Voice.autoBeaming
376 no tiene ningún efecto. Para cancelar este ajuste, el @code{\unset}
377 se debe especificar en el mismo nivel que el @code{\set} original. En
378 otras palabras, deshacer el efecto de @code{Staff.autoBeaming = ##f}
381 \unset Staff.autoBeaming
384 Igual que @code{\set}, el argumento @var{contexto} no tiene que especificarse para un contexto
385 que está en la parte más baja, por lo que las dos instrucciones
388 \set Voice.autoBeaming = ##t
389 \set autoBeaming = ##t
397 Los ajustes que se quieren aplicar a un paso de tiempo único se pueden escribir
398 con @code{\once}, por ejemplo en
400 @lilypond[quote,verbatim,relative=2,fragment]
402 \once \set fontSize = #4.7
407 la propiedad @code{fontSize} pierde su valor automáticamente después de la segunda
410 En la referencia del programa hay una descripción detallada de todas las propiedades de contexto disponibles,
413 @internalsref{Tunable context properties}.
416 Traducción @expansion{} propiedades de contexto ajustables.
420 @node Modifying context plug-ins
421 @subsection Modifying context plug-ins
423 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
424 almacenan propiedades,
425 también contienen plug-ins o añadidos llamados @q{engravers} (grabadores) que crean elementos
426 de notación. Por ejemplo, el contexto @code{Voice} contiene un
427 @code{Note_head_engraver} (grabador de las cabezas de nota) y el contexto @code{Staff} contiene un
428 @code{Key_signature_engraver} (grabador de la armadura).
430 Para ver una descripción completa de cada uno de los añadidos, consulte
432 @internalsref{Engravers}.
435 Referencia del programa @expansion Traducción @expansion{} Grabadores.
437 cada uno de los contextos descritos en
439 @internalsref{Contexts}
442 Referencia del programa @expansion Traducción @expansion{} Contexto.
444 relaciona los grabadores utilizados para ese contexto.
447 Puede ser útil poner o quitar estos añadidos. Esto se hace
448 iniciando un contexto nuevo con @code{\new} o @code{\context} y
454 \new @var{contexto} \with @{
467 donde los @dots{} serían el nombre de un grabador. A continuación se presenta un ejemplo sencillo
468 que quita los grabadores @code{Time_signature_engraver} y
469 @code{Clef_engraver} de un contexto @code{Staff},
471 @lilypond[quote,relative=1,verbatim,fragment]
477 \remove "Time_signature_engraver"
478 \remove "Clef_engraver"
485 En el segundo pentagrama no hay indicación de compás ni clave. Ésta es
486 una forma un poco fuerte de hacer desaparecer objetos, porque afectará
487 al pentagrama completo. Este método también influye en el espaciado, lo que podría ser
488 deseable o no. Un método más
489 sofisticado de borrar objetos se muestra en @rlearning{Common tweaks}.
491 El ejemplo siguiente muestra una aplicación práctica. Las líneas divisorias y las indicaciones
492 de compás están normalmente sincronizadas en toda la partitura. Esto se hace
493 por parte del @code{Timing_translator} y el grabador @code{Default_bar_line_engraver}.
494 Este añadido mantiene al día la administración de la indicación de compás, colocación
495 dentro del compás, etc. Moviendo el grabador desde el contexto @code{Score} al
496 contexto @code{Staff}, podemos tener una partitura donde cada pentagrama tiene su propia
497 indicación de compás.
499 @cindex polimétricas, partituras
500 @cindex Indicaciones de compás, varias
502 @lilypond[quote,relative=1,ragged-right,verbatim,fragment]
504 \remove "Timing_translator"
505 \remove "Default_bar_line_engraver"
508 \consists "Timing_translator"
509 \consists "Default_bar_line_engraver"
515 \consists "Timing_translator"
516 \consists "Default_bar_line_engraver"
525 @node Layout tunings within contexts
526 @subsection Layout tunings within contexts
528 Cada contexto es responsable de crear ciertos tipos de objetos
529 gráficos. Los ajustes utilizados para imprimir estos objetos también se almacenan en cada contexto.
530 Cambiando estos ajustes se puede alterar la apariencia visual de los
533 La sintaxis de esto es
536 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
539 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem} (plica) o
540 @code{NoteHead} (cabeza de nota), y @var{propiedad} es una variable interna del sistema
541 de formateo (@q{propiedad del objeto gráfico o grob} o @q{propiedad de la disposición o layout}). El último es un
542 símbolo, por ello debe ir entre comillas. La subsección @ref{Constructing a
543 tweak} explica qué datos hay que cumplimentar para las variables @var{nombre}, @var{propiedad} y
544 @var{valor}. Aquí discutiremos solamente la funcionalidad de esta instrucción.
549 \override Staff.Stem #'thickness = #4.0
553 hace las plicas más gruesas (el valor por defecto es 1.3, tomando como unidad el grosor de las líneas del
554 pentagrama). Puesto que la orden especifica @code{Staff} como contexto, sólo se
555 aplica al pentagrama en curso. Otros pentagramas conservarán su apariencia visual
556 normal. Aquí podemos ver la orden en acción:
558 @lilypond[quote,verbatim,relative=2,fragment]
560 \override Staff.Stem #'thickness = #4.0
566 La instrucción @code{\override} cambia la definición de la @code{Stem} (plica)
567 dentro del pentagrama @code{Staff} en curso. Después de que la orden se ha interpretado,
568 todas las plicas quedan engrosadas.
570 Análogo a @code{\set}, el argumento @var{contexto} se puede dejar en blanco,
571 haciendo que se utilice el contexto por defecto, @code{Voice}. Al añadir
572 @code{\once} se aplicará el cambio solamente durante un paso de tiempo.
574 @lilypond[quote,fragment,verbatim,relative=2]
576 \once \override Stem #'thickness = #4.0
581 El @code{\override} debe hacerse antes de que el objeto haya
582 comenzado. Por ello, al alterar objetos de extensión o @emph{Spanner} tales como ligaduras
583 o barras de figuras, la instrucción @code{\override} debe ejecutarse en el momento en que se
584 crea el objeto. En este ejemplo,
586 @lilypond[quote,fragment,verbatim,relative=2]
587 \override Slur #'thickness = #3.0
589 \override Beam #'thickness = #0.6
594 la ligadura es más gruesa, no así la barra. Esto es así porque la orden para la barra
595 @code{Beam} va después de que la barra Beam ha comenzado, así que no tiene ningún efecto.
597 De forma análoga a @code{\unset}, la orden @code{\revert} para un contexto
598 deshace una orden @code{\override}; como con @code{\unset}, afecta solamente
599 los ajustes que se hayan hecho dentro del mismo contexto. En otras palabras, el
600 @code{\revert} del siguiente ejemplo no hace nada en absoluto.
603 \override Voice.Stem #'thickness = #4.0
604 \revert Staff.Stem #'thickness
607 Algunas opciones trucables reciben el nombre de @q{subpropiedades} y residen dentro de las
608 propiedades. Para trucarlas, utilice órdenes de la forma
610 @c leave this as a long long
612 \override @var{contexto}.@var{nombre} #'@var{propiedad} #'@var{subpropiedad} = #@var{valor}
619 \override Stem #'details #'beamed-lengths = #'(4 4 3)
625 Funcionamiento interno: @internalsref{OverrideProperty}, @internalsref{RevertProperty},
626 @internalsref{PropertySet}, @internalsref{Backend} y
627 @internalsref{All layout objects}.
632 El back-end o parte profunda del programa no es muy estricta cuando se trata de la comprobación de tipos de las propiedades de los objetos.
633 Las referencias circulares en los valores de Scheme para las propiedades pueden causar cuelgues o
634 terminaciones abruptas, o las dos cosas.
637 @node Changing context default settings
638 @subsection Changing context default settings
640 Los ajustes de las subsecciones previas (@ref{Changing context
641 properties on the fly}, @ref{Modifying context plug-ins} y
642 @ref{Layout tunings within contexts}) también se pueden escribir separados de la música
643 dentro del bloque @code{\layout},
652 \override Stem #'thickness = #4.0
653 \remove "Time_signature_engraver"
658 La orden @code{\Staff} saca la definición existente del contexto de
659 pentagrama de manera que pueda ser modificada.
664 \override Stem #'thickness = #4.0
665 \remove "Time_signature_engraver"
669 afectan a todos los pentagramas de la partitura. Otros contextos se pueden modificar de forma
672 La palabra clave @code{\set} es opcional dentro del bloque @code{\layout}, y así:
688 No es posible recolectar cambios de contexto en una variable y aplicarlos
689 a una definición @code{\context} mediante la referencia a esa variable.
691 El @code{\RemoveEmptyStaffContext} sobreescribirá sus ajustes actuales
692 de @code{\Staff}. Si quiere cambiar los valores por defecto para un pentagrama que usa
693 @code{\RemoveEmptyStaffContext}, tendrá que hacerlo después de
694 llamar a @code{\RemoveemptyStaffContext}, es decir
699 \RemoveEmptyStaffContext
701 \override Stem #'thickness = #4.0
707 @node Defining new contexts
708 @subsection Defining new contexts
710 Los contextos específicos, como @code{Staff} y @code{Voice}, están construidos a base de
711 bloques sencillos. Es posible crear nuevos tipos de
712 contextos con combinaciones distintas de añadidos grabadores.
714 El siguiente ejemplo muestra cómo construir un tipo diferente de contexto de
715 @code{Voice} partiendo de cero. Será parecido a
716 @code{Voice}, pero imprime solamente cabezas centradas en forma de barra inclinada. Se puede usar
717 para indicar improvisación en piezas de jazz,
719 @lilypond[quote,ragged-right]
722 \type "Engraver_group"
723 \consists "Note_heads_engraver"
724 \consists "Text_engraver"
725 \consists Pitch_squash_engraver
726 squashedPosition = #0
727 \override NoteHead #'style = #'slash
728 \override Stem #'transparent = ##t
732 \accepts "ImproVoice"
736 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
737 c4 c^"undress" c_"while playing :)" c }
743 Estos ajustes se definen dentro de un bloque @code{\context} que a su vez está dentro de un bloque
754 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir en el lugar de
755 los puntos suspensivos @dots{} del fragmento anterior.
757 En primer lugar es necesario definir un nombre para el nuevo contexto:
763 Debido a que es parecido al contexto @code{Voice}, queremos órdenes que funcionen sobre
764 contextos de @code{Voice} (existentes) para que siga funcionando. Esto se consigue dando al
765 contexto nuevo un alias @code{Voice},
771 El contexto imprimirá notas y textos explicativos, por ello tenemos que añadir los
772 grabadores que aportan esta funcionalidad,
775 \consists Note_heads_engraver
776 \consists Text_engraver
779 Pero sólo necesitamos esto en la línea central,
782 \consists Pitch_squash_engraver
783 squashedPosition = #0
786 El grabador @internalsref{Pitch_squash_engraver} modifica las cabezas de nota (creadas
787 por el grabador @internalsref{Note_heads_engraver}) y establece sus posiciones verticales
788 al valor de @code{squashedPosition}, en este caso@tie{}@code{0},
791 Las notas parecen barras inclinadas y no tienen plica,
794 \override NoteHead #'style = #'slash
795 \override Stem #'transparent = ##t
798 Todos estos añadidos tienen que cooperar, y esto se consigue con un añadido especial,
799 que se debe marcar con la palabra clave @code{\type}.
800 Este será siempre @internalsref{Engraver_group},
803 \type "Engraver_group"
806 Al juntarlo todo, obtenemos
811 \type "Engraver_group"
812 \consists "Note_heads_engraver"
813 \consists "Text_engraver"
814 \consists Pitch_squash_engraver
815 squashedPosition = #0
816 \override NoteHead #'style = #'slash
817 \override Stem #'transparent = ##t
823 Los contextos dan lugar a jerarquías. Queremos colgar el contexto @code{ImproVoice}
824 bajo el contexto @code{Staff}, como simples @code{Voice}s normales. Por tanto, modificamos
825 la definición de @code{Staff} con la instrucción
826 @code{\accepts} (acepta),
836 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega),
837 lo que a veces se necesita cuando se están reutilizando definiciones de contexto existentes.
839 Ponemos ambos dentro de un bloque @code{\layout}, como
849 \accepts "ImproVoice"
854 Así pues, la salida que aparece al comienzo de esta sub-sección se puede escribir como
862 c c_"while playing :)"
869 @node Aligning contexts
870 @subsection Aligning contexts
872 Los contextos nuevos se pueden alinear por encima o por debajo de otros contextos existentes. Esto
873 podría ser de utilidad al preparar un pentagrama vocal (@rlearning{Vocal ensembles}) y
876 ARREGLAR: esta sección no funciona en PDF. (¿?)
879 @findex alignAboveContext
880 @findex alignBelowContext
882 @lilypond[quote,ragged-right]
885 \relative c' \new Staff = "main" {
888 \new Staff \with {alignAboveContext=main} \ossia
896 @node Vertical grouping of grobs
897 @subsection Vertical grouping of grobs
899 Los grobs (objetos gráficos) VerticalAlignment y VerticalAxisGroup funcionan juntos.
900 VerticalAxisGroup agrupa distintos objetos gráficos como Staff, Lyrics,
901 etc. VerticalAlignment por su parte alinea verticalmente los diferentes objetos gráficos
902 agrupados por VerticalAxisGroup. Normalmente hay solamente un
903 VerticalAlignment por cada partitura, pero cada Staff, Lyrics, etc. tiene su propio
907 @node The \override command
908 @section The @code{\override} command
910 En la sección anterior ya hemos tocado una orden que
911 modifica los detalles de la presentación: la instrucción @code{\override}. En esta sección
912 observaremos con mayor detalle la manera de usar esta orden en la práctica. La
913 sintaxis general de esta orden es:
916 \override @var{contexto}.@var{objeto_de_presentación} #'@var{propiedad_de_presentación} = #@var{valor}
919 Así establecemos la @var{propiedad_de_presentación} del @var{objeto_de_presentación} especificado,
920 que es miembro del @var{contexto}, al @var{valor} que se indica.
923 * Constructing a tweak::
924 * Navigating the program reference::
925 * Layout interfaces::
926 * Determining the grob property::
927 * Objects connected to the input::
928 * Using Scheme code instead of \tweak::
929 * \set versus \override::
935 @node Constructing a tweak
936 @subsection Constructing a tweak
938 Las instrucciones que cambian la salida generalmente tienen la forma
941 \override Voice.Stem #'thickness = #3.0
945 Para construir este ajuste debemos primero averiguar estos datos:
948 @item el contexto: aquí @code{Voice} (voz).
949 @item el objeto de presentación: aquí @code{Stem} (plica).
950 @item la propiedad de presentación: aquí @code{thickness} (grosor).
951 @item un valor: aquí @code{3.0}.
954 Ciertas opciones ajustables se llaman @q{subpropiedades} y residen en el interior
955 de las propiedades. Para trucarlas, utilice órdenes de la forma
958 \override Stem #'details #'beamed-lengths = #'(4 4 3)
961 @cindex documentación interna
962 @cindex buscar objetos gráficos
963 @cindex gráficos, descripciones de los objetos
966 @cindex interna, documentación
968 Para muchas propiedades, independientemente del tipo de datos de la propiedad, el establecimiento del valor de la
969 propiedad a Falso ( @code{##f} ) dará como resultado su apagado o desactivación, haciendo que
970 Lilypond ignore por completo dicha propiedad. Esto es especialmente útil para
971 desactivar propiedades de objetos gráficos que, de otro modo, podrían causar problemas.
973 Explicaremos a continuación cómo extraer esta información del manual de notación y de la
974 referencia del programa.
979 @node Navigating the program reference
980 @subsection Navigating the program reference
982 Supongamos que queremos mover la indicación de digitación del fragmento
985 @lilypond[quote,fragment,relative=2,verbatim]
991 Si hace una visita a la documentación en busca de instrucciones de digitación (en
992 @ref{Fingering instructions}), encontrará:
997 Referencia de funcionamiento interno: @internalsref{Fingering}.
1002 @c outdated info; probably will delete.
1004 This fragment points to two parts of the program reference: a page
1005 on @code{FingerEvent} and one on @code{Fingering}.
1007 The page on @code{FingerEvent} describes the properties of the music
1008 expression for the input @code{-2}. The page contains many links
1009 forward. For example, it says
1012 Accepted by: @internalsref{Fingering_engraver},
1016 That link brings us to the documentation for the Engraver, the
1020 This engraver creates the following layout objects: @internalsref{Fingering}.
1022 In other words, once the @code{FingerEvent}s are interpreted, the
1023 @code{Fingering_engraver} plug-in will process them.
1027 @c I can't figure out what this is supposed to mean. -gp
1029 The @code{Fingering_engraver} is also listed to create
1030 @internalsref{Fingering} objects,
1032 @c old info? it doesn't make any sense to me with our current docs.
1034 second bit of information listed under @b{See also} in the Notation
1039 La referencia del programador se encuentra disponible en forma de documento HTML. Se recomienda
1040 mucho que lo lea en la forma HTML, bien en línea o bien
1041 descargando los archivos de la documentación HTML. Esta sección sería mucho más difícil de entender
1042 si está utilizando el manual en
1046 Siga el enlace que lleva a @internalsref{Fingering}. Al principio de la página,
1050 Los objetos de digitación se crean por parte de: @internalsref{Fingering_engraver} y
1051 @internalsref{New_fingering_engraver}.
1054 Siguiendo los enlaces relacionados dentro de la referencia del programa, podemos seguir el
1055 flujo de información dentro del programa:
1059 @item @internalsref{Fingering}:
1060 los objetos @internalsref{Fingering} se crean por parte de:
1061 @internalsref{Fingering_engraver}
1063 @item @internalsref{Fingering_engraver}:
1064 Tipos de música aceptados: @internalsref{fingering-event}
1066 @item @internalsref{fingering-event}:
1067 El tipo de evento musical @code{fingering-event} está descrito en Expresiones musicales con el nombre de
1068 @internalsref{FingerEvent}
1071 Este camino se recorre en contra de la corriente de información del programa: comienza
1072 por la salida y acaba en el evento de entrada. También podríamos haber
1073 empezado por un evento de la entrada, y leído siguiendo el flujo de información
1074 terminando en su caso en el objeto (u objetos) de la salida.
1076 La referencia del programa también se puede examinar como un documento normal. Contiene
1077 capítulos que tratan de
1079 @internalsref{Music definitions},
1082 @code{Music definitions}
1084 de la @internalsref{Translation}, y del @internalsref{Backend}. Cada uno de los capítulos
1085 relaciona todas las definiciones utilizadas y todas las propiedades que se pueden
1089 @node Layout interfaces
1090 @subsection Layout interfaces
1092 @cindex interfaz de la presentación
1093 @cindex presentación, interfaz de la
1096 La página HTML que pudimos ver en la sección anterior describe el
1097 objeto de presentación llamado @internalsref{Fingering}. Dicho objeto es un
1098 símbolo dentro de la partitura. Tiene propiedades que guardan números (como
1099 grosores y direcciones), pero también punteros a objetos relacionados. Un
1100 objeto de presentación también se llama un @emph{Grob}, que es una abreviatura de Graphical
1101 Object (objeto gráfico). Para ver más detalles acerca de los objetos gráficos o Grobs, consulte @internalsref{grob-interface}.
1103 La página dedicada a @code{Fingering} relaciona las definiciones del objeto
1104 @code{Fingering}. Por ejemplo, la página dice
1107 @code{relleno} (dimensión, en espacios de pentagrama):
1113 lo que significa que el número se mantendrá a una distancia de al menos 0.5
1114 de la cabeza de la nota.
1117 Cada objeto de presentación puede tener varias funciones como elemento notacional o
1118 tipográfico. Por ejemplo, el objeto de digitación Fingering tiene
1119 los siguientes aspectos
1123 Su tamaño es independiente del espaciado horizontal, al contrario de las ligaduras o las barras de las figuras.
1126 Es un elemento de texto. Casi seguro que es un texto muy corto.
1129 este elemento de texto se tipografía con un tipo de letra, no como las ligaduras o las barras de las figuras.
1132 Horizontalmente, el centro del símbolo se debe alinear con el centro de la cabeza
1136 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1139 La posición vertical también está coordinada con otros símbolos de superíndice
1143 Cada uno de estos aspectos se capta en lo que se llaman @emph{interface}s,
1144 que se relacionan al final de la página dedicada a @internalsref{Fingering}
1147 Este objeto contempla los siguientes interfaces:
1148 @internalsref{item-interface},
1149 @internalsref{self-alignment-interface},
1150 @internalsref{side-position-interface}, @internalsref{text-interface},
1151 @internalsref{text-script-interface}, @internalsref{font-interface},
1152 @internalsref{finger-interface} y @internalsref{grob-interface}.
1155 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la página del respectivo interfaz del
1156 objeto. Cada interfaz tiene un cierto número de propiedades. Algunas de ellas
1157 no son para que el usuario las pueda ajustar (@q{Propiedades internas}), pero otras
1158 sí se pueden modificar.
1160 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero realmente esto no significa
1161 mucho. El archivo de inicialización (véase
1162 @rlearning{Default files})
1163 @file{scm/@/define@/-grobs@/.scm} muestra el alma del @q{objeto},
1168 (avoid-slur . around)
1169 (slur-padding . 0.2)
1170 (staff-padding . 0.5)
1171 (self-alignment-X . 0)
1172 (self-alignment-Y . 0)
1173 (script-priority . 100)
1174 (stencil . ,ly:text-interface::print)
1175 (direction . ,ly:script-interface::calc-direction)
1176 (font-encoding . fetaNumber)
1177 (font-size . -5) ; don't overlap when next to heads.
1178 (meta . ((class . Item)
1179 (interfaces . (finger-interface
1181 text-script-interface
1183 side-position-interface
1184 self-alignment-interface
1185 item-interface))))))
1189 Como podemos ver, el objeto @code{Fingering} no es más que un montón de
1190 valores de variables, y la página web de la Referencia de funcionamiento interno
1191 se genera directamente a partir de esta definición.
1194 @node Determining the grob property
1195 @subsection Determining the grob property
1197 Recordemos que queríamos cambiar la posición del @b{2} en
1199 @lilypond[quote,fragment,relative=2,verbatim]
1205 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota, tenemos que
1206 negociar con el interfaz asociado con esta colocación. Esto se
1207 hace usando @code{side-position-interface}. La página que describe este interface
1211 @code{side-position-interface}
1213 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1214 soporte). La propiedad @code{direction} significa dónde poner el objeto
1215 víctima con relación al soporte (¿a la izquierda o a la derecha, encima o debajo?)
1220 Debajo de esta descripción, la variable @code{padding} (relleno) se describe como
1225 (dimensión, en espacios de pentagrama)
1227 Añadir esta cantidad de espacio adicional entre objetos que están unos junto a otros.
1231 Aumentando el valor de @code{padding}, podemos alejar
1232 la cifra de digitación de la cabeza de la nota. La siguiente orden inserta
1233 un espacio en blanco de 3 espacios de pentagrama
1234 entre la nota y la digitación:
1236 \once \override Voice.Fingering #'padding = #3
1239 Al insertar esta instrucción antes de que se haya creado el objeto Fingering,
1240 es decir, antes del @code{c2}, llegamos al siguiente resultado:
1242 @lilypond[quote,relative=2,fragment,verbatim]
1243 \once \override Voice.Fingering #'padding = #3
1250 En este caso, el contexto de este truco es @code{Voice}. Este
1251 hecho se puede deducir también a partir de la referencia del programa, ya que la página dedicada al
1252 añadido @internalsref{Fingering_engraver} dice
1255 El grabador Fingering_engraver es parte de los contextos: @dots{} @internalsref{Voice}
1259 @node Objects connected to the input
1260 @subsection Objects connected to the input
1264 En ocasiones es posible tomar un atajo para realizar el ajuste fino de los objetos
1265 gráficos. Para objetos que reusultan directamente de un elemento de código de la entrada,
1266 puede usar la función @code{\tweak}, por ejemplo
1268 @lilypond[relative=2,fragment,verbatim,ragged-right]
1271 \tweak #'color #red d
1273 \tweak #'duration-log #1 a
1274 >4-\tweak #'padding #10 -.
1277 Como podemos ver, las propiedades se establecen directamente dentro de los objetos,
1278 sin hacer mención al nombre del grob ni al contexto en el que se tendría que
1281 Esta técnica sólo funciona para los objetos que están conectados directamente a
1282 un @internalsref{Event} (evento) del texto de entrada, por ejemplo
1285 @item cabezas de nota, producidas por chord-pitch (p. ej.: las notas de un acorde)
1286 @item signos de articulación, producidos por instrucciones de articulación
1289 Posiblemente no funcione para plicas y alteraciones accidentales (éstos están producidos
1290 por parte de las cabezas de nota, no por los eventos musicales) ni para las claves (éstos no están producidos por
1291 ninguna entrada musical, sino más bien a causa de un cambio en el valor de una propiedad).
1293 Existen muy pocos objetos que estén conectados @emph{directamente} al
1294 resultado de salida. Una nota normal (como @code{c4}) no está conectada directamente
1295 a la salida, así que
1298 \tweak #'color #red c4
1302 no cambia el color. Consulte @ref{Displaying music expressions} para ver más
1306 @node Using Scheme code instead of \tweak
1307 @subsection Using Scheme code instead of @code{\tweak}
1309 La principal desventaja de @code{\tweak} es su inflexibilidad
1310 sintáctica. Por ejemplo, lo siguiente produce un error de sintaxis.
1313 F = \tweak #'font-size #-3 -\flageolet
1321 En otras palabras, @code{\tweak} no se comporta como una articulación en lo que respecta a la
1322 sintaxis; en concreto, no se puede adjuntar mediante
1323 @code{^} y @code{_}.
1325 Utilizando el lenguaje Scheme, se puede dar un rodeo a este problema. La ruta hacia el resultado
1326 se da en @ref{Adding articulation to notes (example)},
1327 especialmente cómo usar @code{\displayMusic} como guía de ayuda.
1330 F = #(let ((m (make-music 'ArticulationEvent
1331 'articulation-type "flageolet")))
1332 (set! (ly:music-property m 'tweaks)
1333 (acons 'font-size -3
1334 (ly:music-property m 'tweaks)))
1343 Aquí las propiedades @code{tweaks} del objeto de flageolet
1344 @code{m} (creado con @code{make-music}) se extraen con
1345 @code{ly:music-property}, un nuevo par clave-valor para cambiar el
1346 tamaño de la tipografía se antepone a la lista de propiedades con la función de Scheme
1347 @code{acons}, y el resultado finalmente se escribe
1348 de nuevo con @code{set!}. El último elemento del bloque
1349 @code{let} es el valor devuelto, el propio @code{m}.
1352 @node \set versus \override
1353 @subsection @code{\set} vs. @code{\override}
1355 Hemos visto dos formas de cambiar las propiedades: @code{\set} y
1356 @code{\override}. De hecho, en realidad existen dos clases diferentes de
1359 Los contextos pueden tener propiedades, que por lo general reciben nombres en
1360 @code{mayúsculasDeCamello}. Principalmente controlan la traducción
1361 de la música a la notación, p.ej. @code{localKeySignature} (para determinar
1362 si hay que imprimir las alteraciones accidentales), @code{measurePosition} (para
1363 determinar cuándo imprimir una línea divisoria). Las propiedades de contexto pueden
1364 ver modificado su valor con el tiempo según se interpreta una pieza de música;
1365 @code{measurePosition} es un ejemplo obvio de esto.
1366 Las propiedades de contexto se modifican con @code{\set}.
1368 Hay un tipo especial de propiedad de contexto: la descripción del
1369 elemento. Estas propiedades reciben nombres en @code{MayúsculasDeCamello}
1370 (comenzando en letra mayúscula). Contienen los
1371 @q{ajustes por defecto} para dicho elemento gráfico como una lista
1372 asociativa. Consulte @file{scm/@/define@/-grobs@/.scm}
1373 para ver qué tipos de ajustes hay. Las descripciones de los elementos
1374 se pueden modificar con @code{\override}.
1376 Realmente, @code{\override} es un atajo;
1379 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1383 es más o menos equivalente a
1385 @c leave this long line -gp
1387 \set @var{contexto}.@var{nombre} #'@var{propiedad} = #(cons (cons '@var{propiedad} @var{valor}) <valor previo de @var{contexto})
1390 El valor de @code{contexto} (la lista-a) se usa para da un valor inicial
1391 a las propiedades de los objetos gráficos individuales. Los objetos gráficos también tienen
1392 propiedades, que reciben nombres en el estilo de Scheme, con
1393 @code{palabras-con-guiones}. Los valores de las propiedades de objetos gráficos cambian
1394 durante el proceso de formateo: el formateo básicamente consiste en
1395 calcular las propiedades utilizando funciones de callback.
1397 @code{fontSize} es una propiedad especial: equivale a
1398 escribir @code{\override ... #'font-size} para todos los objetos
1399 pertinentes. Al ser éste un cambio muy común, se creó la propiedad especial
1400 (modificada con @code{\set}).
1403 @node Difficult tweaks
1404 @subsection Difficult tweaks
1406 Hay ciertos tipos de ajustes difíciles.
1412 Un tipo de ajuste difícil es la apariencia visual de los objetos de extensión,
1413 como las ligaduras de expresión y de unión. Inicialmente sólo se crea uno de estos objetos,
1414 y se pueden ajustar a través del mecanismo normal. Sin embargo, en ocasiones
1415 los objetos de extensión atraviesan los saltos de línea. Si esto ocurre, estos objetos
1416 se clonan. Se crea un objeto separado para cada grupo de pentagramas en el que está.
1417 Son clones del objeto original y heredan todas las
1418 propiedades, incluyendo los @code{\override}s.
1421 En otras palabras, un @code{\override} siempre afecta a todas las piezas de un elemento de
1422 extensión roto. Para cambiar sólo una parte del elemento de extensión en un salto de línea,
1423 es necesario implicarse en el proceso de formateo. La función de callback
1424 @code{after-line-breaking} contiene el procedimiento de Scheme que
1425 se llama después de que se han determinado los saltos de línea, y de que los objetos de
1426 presentación se han dividido sobre los diferentes sistemas o grupos de pentagramas.
1428 En el ejemplo siguiente, definimos un procedimiento
1429 @code{my-callback}. Este procedimiento
1433 determina si hemos sido divididos en un salto de línea
1435 si es así, recupera todos los objetos divididos
1437 comprueba si nosotros somos el último de los objetos divididos
1439 si es así, establece @code{extra-offset}.
1442 Este procedimiento se instala dentro de @internalsref{Tie} (ligadura de unión), de forma que la última parte
1443 de la ligadura dividida se traslada hacia arriba.
1445 @lilypond[quote,verbatim,ragged-right]
1446 #(define (my-callback grob)
1448 ; have we been split?
1449 (orig (ly:grob-original grob))
1451 ; if yes, get the split pieces (our siblings)
1452 (siblings (if (ly:grob? orig)
1453 (ly:spanner-broken-into orig) '() )))
1455 (if (and (>= (length siblings) 2)
1456 (eq? (car (last-pair siblings)) grob))
1457 (ly:grob-set-property! grob 'extra-offset '(-2 . 5)))))
1460 \override Tie #'after-line-breaking =
1467 Cuando aplicamos este truco, la nueva función de callback @code{after-line-breaking}
1468 también debe llamar a la antigua @code{after-line-breaking}, si existe.
1469 Por ejemplo, si se utiliza con @code{Hairpin} (regulador),
1470 también se debe llamar a @code{ly:hairpin::after-line-breaking}.
1473 @item Algunos objetos no se pueden cambiar con @code{\override} por razones
1474 técnicas. Ejemplo de ello son @code{NonMusicalPaperColumn}
1475 y @code{PaperColumn}. Se pueden cambiar con la función
1476 @code{\overrideProperty}, que funciona de forma parecida a @code{\once
1477 \override}, pero usa una sintaxis diferente.
1481 #"Score.NonMusicalPaperColumn" % Nombre del Grob u objeto gráfico
1482 #'line-break-system-details % Nombre de la propiedad
1483 #'((next-padding . 20)) % Valor
1486 Fíjese, sin embargo, en que @code{\override}, aplicado a
1487 @code{NoteMusicalPaperColumn} y a @code{PaperColumn}, aún funciona tal y como se espera
1488 dentro de los bloques @code{\context}.