1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 88f1608ae6fd17b05344bafb2f0721aafdac657b
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @node Changing defaults
13 @chapter Changing defaults
15 El objetivo del diseño de LilyPond es proporcionar la más alta calidad
16 de los resultados, de forma predeterminada. A pesar de ello, podría
17 tener que cambiar este resultado predeterminado. La disposición sobre
18 el papel se controla a través de un amplio número de @q{botones e
19 interruptores} llamados en su conjunto @q{propiedades}. En el Manual
20 de aprendizaje podemos encontrar una introducción en forma de tutorial
21 al acceso y modificación de estas propiedades, véase
22 @rlearning{Tweaking output}. Éste debería leerse en primer lugar.
23 Este capítulo cubre un terreno similar, pero con un estilo más
24 adecuado para un manual de referencia.
26 @cindex Referencia de funcionamiento interno
28 La descripción definitiva de los controles que están dipsonibles para
29 su ajuste fino están en un documento aparte: @rinternalsnamed{Top,la
30 Referencia de funcionamiento interno}. Dicho manual relaciona todas
31 las variables, funciones y opciones que se encuentran disponibles en
32 LilyPond. Está escrito como un documento HTML, que se puede encontrar
34 @c leave the @uref as one long line.
35 @uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,on@/-line},
36 pero que también va incluido en el paquete de la documentación de LilyPond.
38 Internamente, LilyPond utiliza el lenguaje Scheme (un dialecto de
39 LISP) para aportar la infraestructura. La sobreescritura de las
40 decisiones de disposición da acceso efectivo a las interioridades del
41 programa, lo que requiere código de Scheme como entrada. Los
42 elementos de Scheme se inauguran dentro de un archivo @code{.ly} con
43 el símbolo de cuadradillo @code{#}.@footnote{@rlearning{Scheme
44 tutorial} contiene un breve tutorial sobre la introducción de números,
45 listas, cadenas y símbolos en Scheme.}
48 * Interpretation contexts::
49 * Explaining the Internals Reference::
50 * Modifying properties::
51 * Useful concepts and properties::
56 @node Interpretation contexts
57 @section Interpretation contexts
59 Esta sección explica qué son los contextos y cómo modificarlos.
62 * Contexts explained::
64 * Modifying context plug-ins::
65 * Changing context default settings::
66 * Defining new contexts::
72 Manual de aprendizaje:
73 @rlearning{Contexts and engravers}.
76 @file{ly/@/engraver@/-init@/.ly},
77 @file{ly/@/performer@/-init@/.ly}.
80 @rlsr{Contexts and engravers}.
82 Referencia de funcionamiento interno:
83 @rinternals{Contexts},
84 @rinternals{Engravers and Performers}.
87 @node Contexts explained
88 @subsection Contexts explained
90 Los contextos se disponen de forma jerárquica:
93 * Score - the master of all contexts::
94 * Top-level contexts - staff containers::
95 * Intermediate-level contexts - staves::
96 * Bottom-level contexts - voices::
99 @node Score - the master of all contexts
100 @unnumberedsubsubsec Score - the master of all contexts
102 Este es el contexto de notación del nivel más alto. Ningún otro
103 contexto puede contener a un contexto Score. De forma predeterminada,
104 el contexto Score maneja la administración de las indicaciones de
105 compás y se asegura de que ciertos elementos como claves, compases y
106 armaduras están siempre alineados entre los distintos pentagramas.
108 Se crea implícitamente una instancia del contexto Score cuando se
109 procesa un bloque @code{\score @{@dots{}@}} o @code{\layout
110 @{@dots{}@}}, o explícitamente cuando se ejecuta una instrucción
113 @node Top-level contexts - staff containers
114 @unnumberedsubsubsec Top-level contexts - staff containers
116 @strong{@emph{StaffGroup}}
118 Agrupa pentagramas y añade un corchete en la parte izquierda, formando
119 un grupo. Las líneas divisorias de los pentagramas contenidos se
120 conectan verticalmente. StaffGroup sólo consiste en una colección de
121 pentagramas, con un corchete delante y líneas divisorias de arriba a
124 @strong{@emph{ChoirStaff}}
126 Idéntico a StaffGroup excepto que las barras de compás de los
127 pentagramas contenidos no se conectan verticalmente.
129 @strong{@emph{GrandStaff}}
131 Un grupo de pentagramas, con una llave en la parte izquierda que
132 abarca el grupo. Las barras de compás de los pentagramas contenidos
133 se conectan verticalmente.
135 @strong{@emph{PianoStaff}}
137 @c TODO No longer correct? Check. -td
138 Igual que GrandStaff pero con una distancia fija entre los
139 pentagramas, de manera que se pueden usar ligaduras y barras que
140 cruzan de un pentagrama a otro.
143 @strong{@emph{InnerStaffGroup}}
147 @strong{@emph{InnerChoirStaff}}
153 @node Intermediate-level contexts - staves
154 @unnumberedsubsubsec Intermediate-level contexts - staves
156 @strong{@emph{Staff}}
158 Maneja claves, barras de compás, tonalidades y alteraciones
159 accidentales. Puede contener contextos de Voice.
161 @strong{@emph{RhythmicStaff}}
163 Como Staff, pero para imprimir ritmos. Se ignoran las alturas de las
164 notas; las notas se imprimen sobre una línea.
166 @strong{@emph{TabStaff}}
168 Contexto para generar tablaturas. De forma predeterminada dispone la
169 expresión musical como una tablatura de guitarra, impresa sobre seis
172 @strong{@emph{DrumStaff}}
174 Maneja el tipografiado para instrumentos de percusión. Puede contener
177 @strong{@emph{VaticanaStaff}}
179 Iguall que Staff, excepto que está pensado para tipografiar piezas en
182 @strong{@emph{MensuralStaff}}
184 Igual que Staff, excepto que está diseñado para tipografiar piezas en
188 @node Bottom-level contexts - voices
189 @unnumberedsubsubsec Bottom-level contexts - voices
191 Los contextos del mismo nivel que Voice dan un valor inicial a ciertas
192 propiedades e inician los grabadores correspondientes. Siendo
193 contextos del nivel más bajo, no pueden contener a otros contextos.
195 @strong{@emph{Voice}}
197 Corresponde a una voz sobre un pentagrama. este contexto maneja la
198 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
199 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
200 que crear instancias explícitas de este contexto si necesitamos varias
201 voces en el mismo pentagrama.
203 @strong{@emph{VaticanaVoice}}
205 Lo mismo que Voice, excepto que está diseñado para tipografiar piezas
206 en estilo gregoriano.
208 @strong{@emph{MensuralVoice}}
210 Lo mismmo que Voice, con modificaciones para el tipografiado de piezas
213 @strong{@emph{Lyrics}}
215 Corresponde a una voz con letra. Maneja la impresión de una sola
218 @strong{@emph{DrumVoice}}
220 El contexto de voz utilizado en una pauta de percusión.
222 @strong{@emph{FiguredBass}}
224 El contexto en que los objetos BassFigure se crean a partir de la
225 entrada escrita en el modo @code{\figuremode}.
227 @strong{@emph{TabVoice}}
229 El contexto de voz utilizado dentro de un contexto TabStaff. Se suele
230 dejar que se cree implícitamente.
232 @strong{@emph{ChordNames}}
234 Tipografía nombres de acordes.
237 @node Creating contexts
238 @subsection Creating contexts
240 Para partituras que sólo tienen una voz y un pentagrama, los contextos
241 se crean automáticamente. Para partituras más complejas, es necesario
242 crearlos a mano. Existen tres instrucciones que hacen esto.
247 La instrucción más fácil es @code{\new}, y es también la más rápida de
248 escribir. Se antepone a una expresión musical, por ejemplo
251 @cindex nuevos, contextos
252 @cindex Contexto, creación de
255 \new @var{tipo} @var{expresión_musical}
259 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
260 @code{Voice}). Esta instrucción crea un contexto nuevo, y empieza a
261 interpretar la @var{expresión_musical} con él.
263 Una aplicación práctica de @code{\new} es una partitura con muchos pentagramas.
264 Cada parte que debe ir en su propio pentagrama, va precedida de
267 @lilypond[quote,verbatim,relative=2,ragged-right,fragment]
274 La instrucción @code{\new} puede también dar nombre al contexto,
277 \new @var{tipo} = @var{identificador} @var{música}
279 Sin embargo, este nombre especificado por el usuario sólo se utiliza
280 si no hay ya otro contexto anterior con el mismo nombre.
286 Como @code{\new}, la instrucción @code{\context} también dirige una
287 expresión musical a un objeto de contexto, pero da al contexto un
288 nombre explícito. La sintaxis es
291 \context @var{tipo} = @var{identificador} @var{música}
294 En esta forma, la instrucción buscará un contexto existente del
295 @var{tipo} especificado que tenga el nombre @var{identificador}. Si
296 ese contexto aún no existe, se crea un contexto nuevo con el nombre
297 especificado. Esto es útil si nos vamos a referir más tarde al
298 contexto. Por ejemplo, cuando se escribe la letra, la melodía está
299 dentro de un contexto con nombre
302 \context Voice = "@b{tenor}" @var{música}
306 de forma que los textos se puedan alienar correctamente con sus notas,
309 \new Lyrics \lyricsto "@b{tenor}" @var{letra}
314 Otro uso posible de los contextos con nombre es la fusión de dos
315 expresiones musicales distintas en un solo contexto. En el siguiente
316 ejemplo, se introducen por separado las articulaciones y las notas,
320 decoracion = @{ s4-. s4-> @}
323 se combinan enviando los dos al mismo contexto @code{Voice},
327 \new Staff \context Voice = "A" \musica
328 \context Voice = "A" \decoracion
331 @lilypond[quote,ragged-right]
335 \new Staff \context Voice = "A" \music
336 \context Voice = "A" \arts
340 Con este mecanismo, es posible definir un Urtext (una edición
341 original), con la posibilidad de poner articulaciones distintas sobre
344 @cindex crear contextos
347 La tercera instrucción para crear contextos es
349 \context @var{tipo} @var{música}
354 Esto es similar a @code{\context} con @code{= @var{identificador}},
355 pero se corresponde con cualquier contexto del tipo @var{tipo}, sin
356 importar qué nombre se le ha dado.
358 Esta variante se usa con expresiones musicales que se pueden
359 interpretar en varios niveles. Por ejemplo, la instrucción
360 @code{\applyOutput} (véase @ref{Running a function on all layout
361 objects}). Sin una instrucción @code{\context} explícita, normalmente
362 se aplicaría a @code{Voice}
365 \applyOutput #'@var{contexto} #@var{función} % aplicar al contexto Voice
368 Para que se interprete dentro de los niveles de @code{Score} o
369 @code{Staff}, utilice las siguientes formas:
372 \applyOutput #'Score #@var{función}
373 \applyOutput #'Staff #@var{función}
379 @node Modifying context plug-ins
380 @subsection Modifying context plug-ins
382 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
383 almacenan propiedades, también contienen «plug-ins» o complementos
384 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
385 el contexto @code{Voice} contiene un grabador
386 @code{Note_head_engraver} que crea las cabezas de nota y el contexto
387 @code{Staff} contiene un grabador @code{Key_signature_engraver} que
388 crea la indicación de compás.
390 Para ver una descripción completa de todos y cada uno de los
391 complementos, consulte
393 @rinternals{Engravers and Performers}.
396 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
398 Cada contexto que se describe en
400 @rinternals{Contexts}
403 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
405 relaciona los grabadores que se usan para ese contexto.
408 Puede ser de utilidad jugar un poco con estos complementos. Se hace
409 iniciando un contexto nuevo con @code{\new} o @code{\context} y
415 \new @var{contexto} \with @{
428 donde los @dots{} debe ser el nombre de un grabador. Aquí tenemos un
429 ejemplo sencillo que suprime los grabadores
430 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
433 @lilypond[quote,relative=1,verbatim,fragment]
439 \remove "Time_signature_engraver"
440 \remove "Clef_engraver"
447 En el segundo pentagrama no hay indicación de compás ni clave. Éste
448 es un método bastante rudimentario de hacer que desaparezcan los
449 objetos porque afecta a todo el pentagrama. Este método también
450 afecta al espaciado, lo que puede ser deseable o no serlo. Se
451 muestran métodos más sofisticados para quitar objetos en
452 @rlearning{Visibility and color of objects}.
454 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
455 líneas divisorias y las indicaciones de compás están sincronizadas a
456 lo largo de toda la partitura. Lo hacen los grabadores
457 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
458 complementos mantienen al día la administración de las indicaciones de
459 compás, posición dentro del compás, etc. Moviendo estos grabadores
460 desde el contexto de @code{Score} al de @code{Staff}, podemos
461 conseguir una partitura en la que cada pentagrama tiene su propio
462 compás independiente.
464 @cindex polimétricas, partituras
465 @cindex compases distintos al mismo tiempo
467 @lilypond[quote,relative=1,ragged-right,verbatim,fragment]
469 \remove "Timing_translator"
470 \remove "Default_bar_line_engraver"
473 \consists "Timing_translator"
474 \consists "Default_bar_line_engraver"
480 \consists "Timing_translator"
481 \consists "Default_bar_line_engraver"
490 @node Changing context default settings
491 @subsection Changing context default settings
493 Los ajustes de las secciones previas ( @ref{The set command},
494 @ref{Modifying context plug-ins} y @ref{Overview of modifying
495 properties}) también se pueden escribir separados de la música dentro
496 del bloque @code{\layout}:
505 \override Stem #'thickness = #4.0
506 \remove "Time_signature_engraver"
511 La instrucción @code{\Staff} recupera la definición existente del
512 contexto de pentagrama de manera que se pueda modificar.
517 \override Stem #'thickness = #4.0
518 \remove "Time_signature_engraver"
522 afectan a todos los pentagramas de la partitura. Otros contextos se
523 pueden modificar de forma análoga.
525 La palabra clave @code{\set} es opcional dentro del bloque
526 @code{\layout}, y así
542 No es posible recolectar cambios de contexto dentro de una variable y
543 aplicarlos a una definición de @code{\context} por referencia a dicha
546 La instrucción @code{\RemoveEmptyStaffContext} sobreescribe nuestros
547 ajustes en curso para @code{\Staff}. Si queremos cambiar los valores
548 predeterminados para un pentagrama que utilice
549 @code{\RemoveEmptyStaffContext}, debe hacerlo después de llamar a
550 @code{\RemoveEmptyStaffContext}, o sea
555 \RemoveEmptyStaffContext
557 \override Stem #'thickness = #4.0
563 @node Defining new contexts
564 @subsection Defining new contexts
566 Los contextos específicos, como @code{Staff} y @code{Voice}, están
567 construidos a base de bloques sencillos. Es posible crear nuevos
568 tipos de contextos con combinaciones distintas de añadidos grabadores.
570 El siguiente ejemplo muestra cómo construir un tipo diferente de contexto de
571 @code{Voice} partiendo de cero. Será parecido a
572 @code{Voice}, pero imprime solamente cabezas centradas en forma de barra inclinada. Se puede usar
573 para indicar improvisación en piezas de jazz,
576 @lilypond[quote,ragged-right]
579 \type "Engraver_group"
580 \consists "Note_heads_engraver"
581 \consists "Text_engraver"
582 \consists Pitch_squash_engraver
583 squashedPosition = #0
584 \override NoteHead #'style = #'slash
585 \override Stem #'transparent = ##t
589 \accepts "ImproVoice"
593 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
594 c4 c^"desvístete" c_"mientras juegas :)" c }
600 Estos ajustes se definen dentro de un bloque @code{\context} que a su
601 vez está dentro de un bloque @code{\layout},
611 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
612 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
614 En primer lugar es necesario definir un nombre para el nuevo contexto:
620 Debido a que es parecido al contexto @code{Voice}, queremos órdenes
621 que funcionen sobre contextos de @code{Voice} (existentes) para que
622 siga funcionando. Esto se consigue dando al contexto nuevo un alias
629 El contexto imprimirá notas y textos explicativos, por ello tenemos
630 que añadir los grabadores que aportan esta funcionalidad,
633 \consists Note_heads_engraver
634 \consists Text_engraver
637 Pero sólo necesitamos esto en la línea central,
640 \consists Pitch_squash_engraver
641 squashedPosition = #0
644 El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
645 nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
646 establece sus posiciones verticales al valor de
647 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.
649 Las notas parecen barras inclinadas y no tienen plica,
652 \override NoteHead #'style = #'slash
653 \override Stem #'transparent = ##t
656 Todos estos añadidos tienen que cooperar, y esto se consigue con un
657 añadido especial, que se debe marcar con la palabra clave
658 @code{\type}. Este será siempre @code{Engraver_group},
661 \type "Engraver_group"
664 Al juntarlo todo, obtenemos
669 \type "Engraver_group"
670 \consists "Note_heads_engraver"
671 \consists "Text_engraver"
672 \consists Pitch_squash_engraver
673 squashedPosition = #0
674 \override NoteHead #'style = #'slash
675 \override Stem #'transparent = ##t
681 Los contextos dan lugar a jerarquías. Queremos colgar el contexto
682 @code{ImproVoice} bajo el contexto @code{Staff}, como simples
683 @code{Voice}s normales. Por tanto, modificamos la definición de
684 @code{Staff} con la instrucción @code{\accepts} (acepta),
694 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
695 que a veces se necesita cuando se están reutilizando definiciones de
698 Ponemos ambos dentro de un bloque @code{\layout}, como
708 \accepts "ImproVoice"
713 Así pues, la salida que aparece al comienzo de esta sub-sección se
722 c c_"while playing :)"
729 @node Aligning contexts
730 @subsection Aligning contexts
732 Los contextos nuevos se pueden alinear por encima o por debajo de
733 otros contextos existentes. Esto podría ser de utilidad al preparar
734 un pentagrama vocal (@rlearning{Vocal ensembles}) y un ossia,
737 @findex alignAboveContext
738 @findex alignBelowContext
740 @lilypond[quote,ragged-right]
743 \relative c' \new Staff = "main" {
746 \new Staff \with {alignAboveContext=main} \ossia
753 @cindex nested contexts
754 @cindex contexts, nested
759 Los contextos como @code{PianoStaff} pueden llevar dentro otros
760 contextos anidados. Los contextos que se pueden aceptar para su
761 anidamiento están definidos por la lista @qq{accepts} (acepta) de un
762 contexto. Los contextos que no están en esta lista se colocan debajo
763 del contexto exterior en la partitura impresa. Por ejemplo, el
764 contexto @code{PianoStaff} está definido para que acepte contextos
765 @code{Staff} y @code{FiguredBass} de forma predeterminada, pero no un
766 contexto @code{Lyrics}, por ejemplo. Así pues, en la siguiente
767 estructura la letra se sitúa debajo del sistema de piano en lugar de
768 colocarse entre los dos pentagramas:
770 @lilypond[verbatim,quote,relative=1]
773 \new Staff { e4 d c2 }
774 \addlyrics { Three blind mice }
782 La lista @qq{accepts} de un contexto se puede modificar para que
783 incluya contextos anidados adicionales, y así si quisiéramos que la
784 letra apareciese entre los dos pentagramas podríamos usar:
786 @lilypond[verbatim,quote,relative=1]
787 \new PianoStaff \with { \accepts Lyrics }
789 \new Staff { e4 d c2 }
790 \addlyrics { Three blind mice }
798 Lo contrario de @code{\accepts} (acepta) es @code{\denies} (deniega);
799 esto suprime un contexto de la lista @qq{accepts}.
802 @node Explaining the Internals Reference
803 @section Explaining the Internals Reference
807 * Navigating the program reference::
808 * Layout interfaces::
809 * Determining the grob property::
810 * Naming conventions::
815 @node Navigating the program reference
816 @subsection Navigating the program reference
818 Supongamos que queremos mover la indicación de digitación del
821 @lilypond[quote,fragment,relative=2,verbatim]
827 Si hace una visita a la documentación en busca de instrucciones de
828 digitación (en @ref{Fingering instructions}), encontrará:
831 @strong{Véase también}
833 Referencia de funcionamiento interno: @rinternals{Fingering}.
838 La referencia del programador se encuentra disponible en forma de
839 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
840 en línea o bien descargando los archivos de la documentación HTML.
841 Esta sección sería mucho más difícil de entender si está utilizando el
842 manual en formato PDF.
845 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
849 Los objetos de digitación se crean por parte de:
850 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
853 Siguiendo los enlaces relacionados dentro de la referencia del
854 programa, podemos seguir el flujo de información dentro del programa:
858 @item @rinternals{Fingering}:
859 los objetos @rinternals{Fingering} se crean por parte de:
860 @rinternals{Fingering_engraver}
862 @item @rinternals{Fingering_engraver}:
863 Tipos de música aceptados: @rinternals{fingering-event}
865 @item @rinternals{fingering-event}:
866 El tipo de evento musical @code{fingering-event} está descrito en
867 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
870 Este camino se recorre en contra de la corriente de información del
871 programa: comienza por la salida y acaba en el evento de entrada.
872 También podríamos haber empezado por un evento de la entrada, y leído
873 siguiendo el flujo de información terminando en su caso en el objeto
874 (u objetos) de la salida.
876 La referencia del programa también se puede examinar como un documento
877 normal. Contiene capítulos que tratan de
879 @rinternals{Music definitions},
882 @code{Music definitions}
884 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
885 de los capítulos relaciona todas las definiciones utilizadas y todas
886 las propiedades que se pueden ajustar.
889 @node Layout interfaces
890 @subsection Layout interfaces
892 @cindex interfaz de la presentación
893 @cindex presentación, interfaz de la
896 La página HTML que pudimos ver en la sección anterior describe el
897 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
898 es un símbolo dentro de la partitura. Tiene propiedades que guardan
899 números (como grosores y direcciones), pero también punteros a objetos
900 relacionados. Un objeto de presentación también se llama un
901 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
902 gráfico). Para ver más detalles acerca de los objetos gráficos o
903 Grobs, consulte @rinternals{grob-interface}.
905 La página dedicada a @code{Fingering} relaciona las definiciones del
906 objeto @code{Fingering}. Por ejemplo, la página dice
909 @code{relleno} (dimensión, en espacios de pentagrama):
915 lo que significa que el número se mantendrá a una distancia de al
916 menos 0.5 de la cabeza de la nota.
919 Cada objeto de presentación puede tener varias funciones como elemento
920 notacional o tipográfico. Por ejemplo, el objeto de digitación
921 Fingering tiene los siguientes aspectos
925 Su tamaño es independiente del espaciado horizontal, al contrario de
926 las ligaduras o las barras de las figuras.
929 Es un elemento de texto. Casi seguro que es un texto muy corto.
932 este elemento de texto se tipografía con un tipo de letra, no como las
933 ligaduras o las barras de las figuras.
936 Horizontalmente, el centro del símbolo se debe alinear con el centro
937 de la cabeza de la nota.
940 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
943 La posición vertical también está coordinada con otros símbolos de
944 superíndice y de subíndice.
947 Cada uno de estos aspectos se capta en lo que se llaman
948 @emph{interface}s, que se relacionan al final de la página dedicada a
949 @rinternals{Fingering}
952 Este objeto contempla los siguientes interfaces:
953 @rinternals{item-interface},
954 @rinternals{self-alignment-interface},
955 @rinternals{side-position-interface}, @rinternals{text-interface},
956 @rinternals{text-script-interface}, @rinternals{font-interface},
957 @rinternals{finger-interface} y @rinternals{grob-interface}.
960 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
961 página del respectivo interfaz del objeto. Cada interfaz tiene un
962 cierto número de propiedades. Algunas de ellas no son para que el
963 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
966 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
967 realmente esto no significa mucho. El archivo de inicialización
968 (véase @ref{File structure}) @file{scm/@/define@/-grobs@/.scm} muestra
969 el alma del @q{objeto},
974 (avoid-slur . around)
976 (staff-padding . 0.5)
977 (self-alignment-X . 0)
978 (self-alignment-Y . 0)
979 (script-priority . 100)
980 (stencil . ,ly:text-interface::print)
981 (direction . ,ly:script-interface::calc-direction)
982 (font-encoding . fetaNumber)
983 (font-size . -5) ; don't overlap when next to heads.
984 (meta . ((class . Item)
985 (interfaces . (finger-interface
987 text-script-interface
989 side-position-interface
990 self-alignment-interface
995 Como podemos ver, el objeto @code{Fingering} no es más que un montón
996 de valores de variables, y la página web de la Referencia de
997 funcionamiento interno se genera directamente a partir de esta
1001 @node Determining the grob property
1002 @subsection Determining the grob property
1004 Recordemos que queríamos cambiar la posición del @b{2} en
1006 @lilypond[quote,fragment,relative=2,verbatim]
1012 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1013 tenemos que negociar con el interfaz asociado con esta colocación.
1014 Esto se hace usando @code{side-position-interface}. La página que
1015 describe este interface dice:
1018 @code{side-position-interface}
1020 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1021 soporte). La propiedad @code{direction} significa dónde poner el
1022 objeto víctima con relación al soporte (¿a la izquierda o a la
1023 derecha, encima o debajo?)
1028 Debajo de esta descripción, la variable @code{padding} (relleno) se describe como
1033 (dimensión, en espacios de pentagrama)
1035 Añadir esta cantidad de espacio adicional entre objetos que están unos
1040 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1041 digitación de la cabeza de la nota. La siguiente orden inserta un
1042 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1045 \once \override Voice.Fingering #'padding = #3
1048 Al insertar esta instrucción antes de que se haya creado el objeto
1049 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1052 @lilypond[quote,relative=2,fragment,verbatim]
1053 \once \override Voice.Fingering #'padding = #3
1059 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1060 se puede deducir también a partir de la referencia del programa, ya
1061 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1064 El grabador Fingering_engraver es parte de los contextos: @dots{}
1070 @node Naming conventions
1071 @subsection Naming conventions
1074 Another thing that is needed, is an overview of the various naming
1077 scheme functions: lowercase-with-hyphens (incl. one-word
1079 scheme functions: ly:plus-scheme-style
1080 music events, music classes and music properties:
1082 Grob interfaces: scheme-style
1083 backend properties: scheme-style (but X and Y!)
1084 contexts (and MusicExpressions and grobs): Capitalized or
1086 context properties: lowercaseFollowedByCamelCase
1088 Capitalized_followed_by_lowercase_and_with_underscores
1090 Which of these are conventions and which are rules?
1091 Which are rules of the underlying language, and which are
1095 @node Modifying properties
1096 @section Modifying properties
1099 * Overview of modifying properties::
1101 * The override command::
1102 * The tweak command::
1103 * set versus override::
1107 @node Overview of modifying properties
1108 @subsection Overview of modifying properties
1110 Cada contexto es responsable de la creación de ciertos tipos de
1111 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1112 también se almacenan por contexto. Mediante la modificación de estos
1113 ajustes, se puede alterar la apariencia de los objetos.
1115 La sintaxis de esto es
1118 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1121 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1122 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1123 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1124 disposición}). Este último es un símbolo, y por ello debe ir
1125 precedido de un apóstrofo. La subsección @ref{Modifying properties}
1126 explica cómo se deben cumplimentar los conceptos @var{nombre},
1127 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1128 funcionalidad des esta instrucción.
1133 \override Staff.Stem #'thickness = #4.0
1137 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1138 grosor de una línea del pentagrama como unidad). Puesto que la
1139 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1140 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1141 Aquí vemos la instrucción en pleno funcionamiento:
1143 @lilypond[quote,verbatim,relative=2,fragment]
1145 \override Staff.Stem #'thickness = #4.0
1151 La instrucción @code{\override} modifica la definición de la plica
1152 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1153 que la instrucción se ha interpretado, todas las plicas se engrosan.
1155 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1156 omitir, ocasionando que se utilice el contexto predeterminado
1157 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1158 solo paso de tiempo.
1160 @lilypond[quote,fragment,verbatim,relative=2]
1162 \once \override Stem #'thickness = #4.0
1167 El @code{\override} se debe hacer antes de que el objeto se inicia.
1168 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1169 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1170 en el momento en que se crea el objeto. En este ejemplo:
1172 @lilypond[quote,fragment,verbatim,relative=2]
1173 \override Slur #'thickness = #3.0
1175 \override Beam #'thickness = #0.6
1180 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1181 la instrucción para @code{Beam}, la barra, va después de que la barra
1182 se ha iniciado, y por ello no tiene ningún efecto.
1184 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1185 un contexto deshace una instrucción @code{\override}; como con
1186 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1187 del mismo contexto. En otras palabras, el @code{\revert} del
1188 siguiente ejemplo no hace nada.
1191 \override Voice.Stem #'thickness = #4.0
1192 \revert Staff.Stem #'thickness
1195 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1196 dentro de las propiedades normales. Para trucarlas, utilice
1197 instrucciones de la forma
1199 @c leave this as a long long
1201 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1208 \override Stem #'details #'beamed-lengths = #'(4 4 3)
1214 Referencia de funcionamiento interno:
1215 @rinternals{OverrideProperty},
1216 @rinternals{RevertProperty},
1217 @rinternals{PropertySet},
1218 @rinternals{Backend},
1219 @rinternals{All layout objects}.
1224 El «back-end» o motor de salida no es muy estricto en la comprobación
1225 de tipos de las propiedades de objetos. Las referencias cíclicas en
1226 valores Scheme de propiedades pueden producir cuelgues o salidas
1227 abruptas, o las dos cosas.
1230 @node The set command
1231 @subsection The @code{\set} command
1235 @cindex cambiar propiedades
1237 Cada contexto puede tener distintas @emph{propiedades}, variables
1238 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1239 paso de interpretación. Se consigue insertando la instrucción
1240 @code{\set} dentro de la música:
1243 \set @var{contexto}.@var{propiedad} = #@var{valor}
1247 @lilypond[quote,verbatim,relative=2,fragment]
1249 \set Score.skipBars = ##t
1253 Estas instrucción salta los compases que no tienen notas. El
1254 resultado es que los silencios multicompás se condensan. El valor
1255 asignado es un objeto de Scheme. En este caso, es @code{#t}, el valor
1256 booleano True o verdadero.
1258 Si se omite el argumento @var{context}, entonces se utiliza el
1259 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1260 @code{Voice} o @code{Lyrics}). En este ejemplo:
1262 @lilypond[quote,verbatim,relative=2,fragment]
1264 \set autoBeaming = ##f
1269 el argumento @var{contexto} de la instrucción @code{\set} se omite,
1270 así pues el barrado automático se desactiva en la voz actual. Observe
1271 que el contexto de nivel más bajo no siempre contiene la propiedad que
1272 queremos cambiar (por ejemplo, no tendrá ningún efecto intentar
1273 establecer un valor para la propiedad @code{skipBars} del contexto de
1274 nivel más bajo, en este caso @code{Voice}).
1276 @lilypond[quote,verbatim,relative=2,fragment]
1282 Los contextos son jerárquicos, y si se ha especificado un contexto
1283 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1284 también a todos los contextos @code{Voice} dentro del pentagrama
1285 actual. El cambio se aplica @q{al vuelo}, durante la música, de
1286 manera que el ajuste sólo afecta al segundo grupo de corcheas.
1290 También existe una instrucción @code{\unset}:
1292 \unset @var{contexto}.@var{propiedad}
1296 que elimina la definición de @var{propiedad}. Esta instrucción
1297 elimina la definición solamente si está establecida dentro de
1298 @var{contexto}, de manera que
1301 \set Staff.autoBeaming = ##f
1305 introduce un ajuste de la propiedad en el nivel de @code{Staff}. El
1306 ajuste también se aplica a la @code{Voice} actual. Sin embargo:
1309 \unset Voice.autoBeaming
1313 no tiene ningúun efecto. Para cancelar este ajuste, se debe
1314 especificar el @code{\unset} en el mismo nivel que el @code{\set}
1315 original. Dicho de otra forma, para deshacer el efecto de
1316 @code{Staff.autoBeaming = ##f} se necesita
1318 \unset Staff.autoBeaming
1321 Como @code{\set}, el argumento @var{contexto} no se tiene que
1322 especificar para un contexto del nivel más bajo, por lo que los dos
1326 \set Voice.autoBeaming = ##t
1327 \set autoBeaming = ##t
1335 Los ajustes que se aplican solamente a un único paso de tiempo se
1336 pueden escribir con @code{\once}, por ejemplo en
1338 @lilypond[quote,verbatim,relative=2,fragment]
1340 \once \set fontSize = #4.7
1345 la propiedad @code{fontSize} se deshace automáticamente después de la
1348 En el manual de Referencia de funcionamiento interno hay una
1349 descripción completa de todas las propiedades de contexto disponibles,
1352 @rinternals{Tunable context properties}.
1355 Traducción @expansion{} Propiedades de contexto modificables por el
1361 @node The override command
1362 @subsection The @code{\override} command
1364 Las instrucciones que modifican la salida tienen por lo general un
1368 \override Voice.Stem #'thickness = #3.0
1372 Para construir este truco debemos determinar los siguientes datos:
1375 @item el contexto: aquí @code{Voice}.
1376 @item el objeto de presentación: aquí @code{Stem}.
1377 @item la propiedad de presentación: aquí @code{thickness}.
1378 @item un valor adecuado: aquí @code{3.0}.
1381 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
1382 en el interior de las propiedades normales. Para modificarlas utilice
1383 instrucciones de la forma
1386 \override Stem #'details #'beamed-lengths = #'(4 4 3)
1389 @cindex documentación interna
1390 @cindex buscar objetos gráficos
1391 @cindex gráficos, descripción de los objetos
1394 @cindex interna, documentación
1396 Para muchas propiedades, independientemente del tipo de datos de la
1397 propiedad, si se establece el valor de la propiedad a falso
1398 (@code{##f}) se producirá su desactivación, ocasionando que LilyPond
1399 ignore por completo dicha propiedad. Esto es especialmente útil para
1400 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
1401 causarína problemas.
1403 Mostraremos a continuación cómo localizar esta información en el
1404 manual de notación y en la referencia de funcionamiento interno.
1407 @node The tweak command
1408 @subsection The @code{\tweak} command
1413 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
1414 los objetos gráficos. Para objetos que reusultan directamente de un
1415 elemento de código de la entrada, puede usar la función @code{\tweak},
1418 @lilypond[relative=2,verbatim]
1423 \tweak #'duration-log #1
1426 -\tweak #'padding #8
1430 @cindex chord, modifying one note in
1432 Pero el uso principal de la instrucción @code{\tweak} es modificar
1433 solamente uno de varios elementos de notación que dan comienzo en el
1434 mismo momento musical, como las notas de un acorde, o corchetes de
1435 tresillo que empiezan al mismo tiempo.
1437 Para ver una introducción a la sintaxis y los usos de la instrucción
1438 tweak, consulte @rlearning{Tweaking methods}.
1440 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
1441 a continuación de forma directa, sin necesidad de especificar el
1442 nombre del grob o el contexto. Para que esto funcione, es necesario
1443 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
1444 al objeto al que se aplica, después de que el archivo de entrada se ha
1445 convertido en un flujo musical. Con frecuencia no es el caso, pues
1446 muchos elementos adicionales se insertan en la corriente musical de
1447 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
1448 parte de un acorde, LilyPond inserta implícitamente un evento
1449 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
1450 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
1451 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
1452 en el flujo musical, permaneciendo así adyacente a la nota, y con la
1453 posibilidad de modificarla.
1457 @lilypond[relative=2,verbatim,quote]
1458 <\tweak #'color #red c>4
1462 pero esto no funciona:
1464 @lilypond[relative=2,verbatim,quote]
1465 \tweak #'color #red c4
1468 Si se colocan varios elementos similares en el mismo momento musical,
1469 la instrucción @code{\override} no se puede usar para modificar uno
1470 solo de ellos: aquí es donde se debe usar la instrucción
1471 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
1472 en el mismo momento musical están los siguientes:
1474 @c TODO expand to include any further uses of \tweak
1476 @item las cabezas de las notas de un acorde
1477 @item signos de articulación sobre la misma nota
1478 @item ligaduras de unión entre notas de un acorde
1479 @item corchetes de grupos especials que comienzan en el mismo momento
1482 @c TODO add examples of these
1485 y se puede usar @code{\tweak} para modificar cualquier aparición
1486 específica de estos elementos.
1488 Es de resaltar que la instrucción @code{\tweak} no se puede usar para
1489 modificar plicas, barras o alteraciones accidentales, porque éstos se
1490 generan más tarde por parte de las cabezas de nota, en vez de por
1491 elementos musicales que están en el flujo de entrada. Ni se puede
1492 usar una instrucción @code{\tweak} para modificar claves o
1493 indicaciones de compás, ya que éstos están separados de cualquier
1494 instrucción @code{\tweak} precedente en el flujo de entrada a causa de
1495 la inserción automática de elementos adicionales necesarios para
1496 especificar el contexto.
1498 Pero la instrucción @code{\tweak} se puede usar como alternativa a la
1499 instrucción @code{\override} para modificar estos elementos
1500 notacionales que no producen la adición de ningún elemento notacional
1501 implícito antes de ellos mismos en el flujo musical. Por ejemplo, las
1502 ligaduras de expresión se pueden modificar de esta forma:
1504 @lilypond[verbatim,quote,relative=1]
1505 c-\tweak #'thickness #5 ( d e f)
1508 También se pueden escribir varias instrucciones @code{\tweak} antes de
1509 un elemento notacional, y todas ellas le afectan:
1511 @lilypond[verbatim,quote,relative=1]
1513 -\tweak #'style #'dashed-line
1514 -\tweak #'dash-fraction #0.2
1515 -\tweak #'thickness #3
1516 -\tweak #'color #red
1521 El flujo musical que se genera a partir de una sección de un archivo
1522 de entrada, incluido cualquier elemento insertado automáticamente,
1523 puede examinarse, véase @ref{Displaying music expressions}. Esto
1524 puede ser de utilidad en la determinación de lo que puede modificarse
1525 por medio de una instrucción @code{\tweak}.
1529 Manual de aprendizaje:
1530 @rlearning{Tweaking methods}.
1532 Referencia de la notación:
1533 @ref{Displaying music expressions}.
1537 @cindex trucos en una variable
1538 La instrucción @code{\tweak} no se puede usar dentro de una variable.
1540 @cindex trucos en la letra
1541 Las instrucciones @code{\tweak} no se pueden usar dentro del modo @code{\lyricmode}.
1543 @cindex trucar puntos de control
1544 @cindex control, trucar puntos de
1546 La instrucción @code{\tweak} no se puede usar para modificar los
1547 puntos de control de una única ligadura entre varias dentro de un
1548 acorde, aparte de la primera que aparece en el archivo de entrada.
1550 @node set versus override
1551 @subsection @code{\set} vs. @code{\override}
1553 Hemos visto dos formas de cambiar las propiedades: @code{\set} y
1554 @code{\override}. De hecho, en realidad existen dos clases diferentes
1557 Los contextos pueden tener propiedades, que por lo general reciben
1558 nombres en @code{mayúsculasDeCamello}. Principalmente controlan la
1559 traducción de la música a la notación, p.ej. @code{localKeySignature}
1560 (para determinar si hay que imprimir las alteraciones accidentales),
1561 @code{measurePosition} (para determinar cuándo imprimir una línea
1562 divisoria). Las propiedades de contexto pueden ver modificado su
1563 valor con el tiempo según se interpreta una pieza de música;
1564 @code{measurePosition} es un ejemplo obvio de esto. Las propiedades
1565 de contexto se modifican con @code{\set}.
1567 Hay un tipo especial de propiedad de contexto: la descripción del
1568 elemento. Estas propiedades reciben nombres en
1569 @code{MayúsculasDeCamello} (comenzando en letra mayúscula). Contienen
1570 los @q{ajustes por defecto} para dicho elemento gráfico como una lista
1571 asociativa. Consulte @file{scm/@/define@/-grobs@/.scm} para ver qué
1572 tipos de ajustes hay. Las descripciones de los elementos se pueden
1573 modificar con @code{\override}.
1575 Realmente, @code{\override} es un atajo;
1578 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1582 es más o menos equivalente a
1584 @c leave this long line -gp
1586 \set @var{contexto}.@var{nombre} #'@var{propiedad} = #(cons (cons '@var{propiedad} @var{valor}) <valor previo de @var{contexto})
1589 El valor de @code{contexto} (la lista-a) se usa para da un valor
1590 inicial a las propiedades de los objetos gráficos individuales. Los
1591 objetos gráficos también tienen propiedades, que reciben nombres en el
1592 estilo de Scheme, con @code{palabras-con-guiones}. Los valores de las
1593 propiedades de objetos gráficos cambian durante el proceso de
1594 formateo: el formateo básicamente consiste en calcular las propiedades
1595 utilizando funciones de callback.
1597 @code{fontSize} es una propiedad especial: equivale a escribir
1598 @code{\override ... #'font-size} para todos los objetos pertinentes.
1599 Al ser éste un cambio muy común, se creó la propiedad especial
1600 (modificada con @code{\set}).
1603 @node Useful concepts and properties
1604 @section Useful concepts and properties
1609 * Direction and placement::
1610 * Distances and measurements::
1611 * Staff symbol properties::
1613 * Visibility of objects::
1615 * Rotating objects::
1619 @subsection Input modes
1621 La forma en que se interpreta la notación conenida dentro de un
1622 archivo de entrada, está determinada por el modo de entrada en curso.
1624 @strong{Modo de acordes}
1626 Se activa con la instrucción @code{\chordmode} y produce que la
1627 entrada se interprete con al sintaxis de la notación de acordes, véase
1628 @ref{Chord notation}. Los acordes se imprimen como notas sobre un
1631 El modo de acordes se activa también con la instrucción
1632 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
1633 y produce que el código que sigue se interprete conla sintaxis de la
1634 notación de acordes y se imprima como nombres de acorde dentro del
1635 contexto @code{ChordNames}, véase @ref{Printing chord names}.
1637 @strong{Modo de percusión}
1639 Se activa con la instrucción @code{\drummode} y produce que el código
1640 de entrada se interprete con la sintaxis de la notación de percusión,
1641 véase @ref{Basic percussion notation}.
1643 El modo de percusión también se activa con la instrucción
1644 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
1645 que el código que sigue se interprete con la sintaxis de la notación
1646 de percusión y se imprima como símbolos de percusión sobre un
1647 pentagrama de percusión, véase @ref{Basic percussion notation}.
1649 @strong{Modo de cifras}
1651 Se activa con la instrucción @code{\figuremode} y hace que el código
1652 de entrada se interprete con la sintaxis del bajo cifrado, véase
1653 @ref{Entering figured bass}.
1655 El modo de cifrase también se activa con la instrucción
1656 @code{\figures}. También crea un contexto de @code{FiguredBass} nuevo
1657 y hace que el código que viene a continuación se interprete con la
1658 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
1659 dentro del contexto @code{FiguredBass}, véase @ref{Introduction to
1662 @strong{Modos de traste y tablatura}
1664 No existen modos de entrada especiales para introducir símibolos de
1665 trastes y de tablatura.
1667 Para crear diagramas de trastes, escriba las notas o acordes en el
1668 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
1669 véase @ref{Default tablatures}.
1671 Para crear diagramas de trastes encima de un pentagrama, escríbalos
1672 como elementos de marcado encima de las notas utilizando la
1673 instrucción @code{\fret-diagram}, véase @ref{Fret diagram markups}.
1675 @strong{Modo de letra}
1677 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
1678 se interprete como sílabas de la letra de la canción con duraciones
1679 opcionales y modificadores de letra asociados, véase @ref{Vocal
1682 El modo de letra también se habilita con la instrucción
1683 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
1684 y una instrucción @code{\lyricsto} implícita que asocia la letra que
1685 viene a continuación con la música precedente.
1687 @strong{Modo de marcado}
1689 Se activa con la instrucción @code{\markup}, y hace que la entrada se
1690 interprete con la sintaxis del marcado, véase @ref{Text markup
1693 @c silly work-around for texinfo broken-ness
1694 @c (@strong{Note...} causes a spurious cross-reference in Info)
1697 Es el modo predeterminado o se puede activar con la instrucción
1698 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
1699 marcado, etc. y se imprime como notación musical sobre un pentagrama.
1701 Normalmente no es necesario especificar el modo de notas de forma
1702 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
1703 ejemplo si estamos en el modo de letra, en el modo de acordes o en
1704 otro modo y queremos insertar algo que solamente se puede hacer con la
1705 sintaxis del modo de notas.
1707 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
1708 una pieza coral es necesario entrar en el modo de notas para poder
1709 interpretar dichas indicaciones:
1711 @lilypond[verbatim,relative=2,quote]
1714 \notemode{\set stanza = \markup{ \dynamic f 1. } }
1718 \notemode{\set stanza = \markup{ \dynamic p 2. } }
1725 @node Direction and placement
1726 @subsection Direction and placement
1728 Al tipografiar música, la dirección y colocación de muchos elementos
1729 es cuestión de elección. Por ejemplo, las plicas de las notas se
1730 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
1731 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
1732 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
1733 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
1734 LilyPond las determine automáticamente, pero en ciertos casos puede
1735 ser deseable forzar una dirección o colocación concreta.
1737 @strong{Acciones predeterminadas}
1739 De forma predeterminada algunas direcciones siempre son hacia arriba o
1740 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
1741 otras cosas pueden alternar entre arriba y abajo en función de la
1742 dirección de las plicas (como las ligaduras o los acentos).
1744 @c TODO Add table showing these
1746 @strong{Disposición de contexto}
1748 Los contextos se colocan dentro de un sistema de arriba a abajo en el
1749 orden en que se encuentran. Sin embargo, observe que se crea un
1750 contexto implícitamente si se encuentra una instrucción cuando no está
1751 disponible un contexto apropiado para contenerla.
1753 @c TODO Add example ?
1755 Se pude cambiar el orden predeterminado en que los contextos se
1756 presentan, véase @ref{Aligning contexts}
1758 @strong{Indicadores de dirección de las articulaciones}
1760 Al añadir articulaciones a notas se puede omitir normalmente el
1761 indicador de dirección, @code{^} (que significa @qq{arriba}), @code{_}
1762 (que significa @qq{abajo}) o @code{-} (que significa @qq{usar la
1763 dirección predeterminada}), en cuyo caso se supone el perdeterminado
1764 @code{-}. Pero se necesita un indicador de dirección @strong{always}
1768 @item las instrucciones @code{\tweak}
1769 @item las instrucciones @code{\markup}
1770 @item las instrucciones @code{\tag}
1771 @item los marcados de cadena, p.ej. -"cadena"
1772 @item las instrucciones de digitación, p.ej. @code{-1}
1773 @item las abreviaturas de articulación, p.ej. @code{-.}, @code{->}, @code{--}
1776 @strong{La propiedad de dirección}
1778 La posición o dirección de muchos objetos de presentación está
1779 controlada por la propiedad @code{direction}.
1781 El valor de la propiedad @code{direction} se puede establecer al valor
1782 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
1783 @code{-1}, con el significado de @qq{hacia abajo} o @qq{debajo}. Se
1784 pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
1785 @code{1} y @code{-1} respectivamente. La dirección predeterminada se
1786 puede especificar estableciendo @code{direction} a @code{0} ó a
1787 @code{CENTER}. De forma alternativa, en muchos casos existen
1788 instrucciones predefinidas para especificar la dirección. Todas ellas
1792 @code{\xxxUp}, @code{xxxDown}, @code{xxxNeutral}
1795 donde @code{xxxNeutral} significa @qq{utilizar la dirección
1796 predeterminada}. Véase @rlearning{Within-staff objects}.
1798 En alguna que otra ocasión, con el único ejemplo usual del arpegio, el
1799 valor de la propiedad @code{direction} especifica si el objeto se debe
1800 colocar a la izquierda o a la derecha del objeto padre. En este caso
1801 @code{-1} ó @code{LEFT} significan @qq{a la izquierda} y @code{1} ó
1802 @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
1803 significan @qq{utilizar la dirección predeterminada}, como antes.
1806 @node Distances and measurements
1807 @subsection Distances and measurements
1809 @cindex distances, absolute
1810 @cindex distances, scaled
1817 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
1819 Las distancias absolutas se usan para especificar márgenes, sangrados
1820 y otros detalles de diseño de página, y de forma predeterminada se
1821 especifican en milímetros. Las distancias se pueden especificar en
1822 otras unidades escribiendo después de la cifra indicativa de la
1823 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
1824 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
1825 de página se pueden especificar también en unidades escalables (véase
1826 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
1827 La disposición de página se describe en detalle en @ref{Page
1830 Las distancias escaladas siempre se especifican en unidades de un
1831 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
1832 El espacio de pentagrama es la distancia entre dos líneas del
1833 pentagrama adyacentes. El valor predeterminado se puede cambiar
1834 globalmente fijando el tamaño global del pentagrama, o se puede
1835 sobreescribir localmente cambiando la propiedad @code{staff-space} del
1836 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
1837 automáticamente con cualquier cambio al tamaño global del pentagrama o
1838 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
1839 las fuentes tipográficas se escalan solamente con los cambios
1840 efectuados al tamaño global del pentagrama. Así, el tamaño global del
1841 pentagrama posibilita la fácil variación del tamaño general de una
1842 partitura impresa. Para ver los métodos de establecimiento del tamaño
1843 global del pentagrama, véase @ref{Setting the staff size}.
1847 Si se necesita dibujar sólo una sección de una partitura a una escala
1848 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
1849 simplemente cambiar el tamaño global del pentagrama porque esto
1850 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
1851 hace sobreescribiendo tanto la propiedad @code{staff-space} de
1852 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
1853 nuestra disposición una función de Scheme, @code{magstep}, para
1854 convertir de un cambio en el tamaño de la fuente al cambio equivalente
1855 en @code{staff-space}. Para ver una explicación y un ejemplo de su
1856 utilización, consulte @rlearning{Length and thickness of objects}.
1860 Manual de aprendizaje:
1861 @rlearning{Length and thickness of objects}.
1863 Referencia de la notación:
1864 @ref{Page formatting},
1865 @ref{Setting the staff size}.
1868 @node Staff symbol properties
1869 @subsection Staff symbol properties
1871 @cindex ajuste del símbolo del pentagrama
1872 @cindex dibujar el símbolo del pentagrama
1873 @cindex pentagrama, establecer el símbolo del
1875 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
1876 @c Need to think of uses for these properties. Eg 'line-positions
1877 @c is used in a snippet to thicken centre line.
1878 @c If retained, add @ref to here in 1.6.2 -td
1880 Se puede definir al mismo tiempo la posición vertical de las líneas de
1881 la pauta y el número de líneas de la misma. Como muestra el siguiente
1882 ejemplo, las posiciones de las notas no están influidas por las
1883 posiciones de las líneas de la pauta.
1885 @warning{La propiedad @code{'line-positions} sobreescribe a la
1886 propiedad @code{'line-count}. El número de líneas de la pauta está
1887 definido implícitamente por el número de elementos de la lista de
1888 valores de @code{'line-positions}.}
1890 @lilypond[verbatim,quote,relative=1]
1892 \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
1897 Se puede modificar la anchura de la pauta. Las unidades son espacios
1898 de pentagrama. El espaciado de los objetos dentro del pentagrama no
1899 resulta afectado por este ajuste.
1901 @lilypond[verbatim,quote,relative=1]
1903 \override StaffSymbol #'width = #23
1910 @subsection Spanners
1912 Muchos objetos de notación musical abarcan varias notas o incluso
1913 varios compases. Son ejemplos los crescendi, trinos, corchetes de
1914 grupo especial y corchetes de primera y segunda vez. Estos objetos se
1915 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
1916 especiales para controlar su apariencia y comportamiento. Algunas de
1917 estas propiedades son comunes a todos los objetos de extensión; otras
1918 se limitan a un subconjunto de los extensores.
1920 Todos los objetos de extensión contemplan el interface
1921 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
1922 una línea recta entre los dos objetos, contemplan también el interface
1923 @code{line-spanner-interface}.
1925 @unnumberedsubsubsec Using the @code{spanner-interface}
1927 Este interface proporciona dos propiedades que se aplican a varios
1930 @strong{@i{La propiedad @code{minimum-length}}}
1932 La longitud mínima del objeto de extensión se pesoecifica a través de
1933 la propiedad @code{minimum-length}. Su aumento suele producir el
1934 efecto necesario de aumentar el espaciado de las notas entre los dos
1935 puntos extremos. Sin embargo, esta sobreescritura no tiene ningún
1936 efecto sobre muchos extensores, pues su longitud está determinada por
1937 otras consideraciones. Más abajo se muestran algunos ejemplos de
1948 Works as long as callback is made:
1952 Works not at all for:
1961 @lilypond[verbatim,quote,relative=2]
1964 % increase the length of the tie
1965 -\tweak #'minimum-length #5
1969 @lilypond[verbatim,quote,relative=2]
1971 \compressFullBarRests
1973 % increase the length of the rest bar
1974 \once \override MultiMeasureRest #'minimum-length = #20
1979 @lilypond[verbatim,quote,relative=2]
1981 % increase the length of the hairpin
1982 \override Hairpin #'minimum-length = #20
1986 Esta sobreescritura se puede usar también para aumentar la longitud de
1987 las ligaduras de expresión y de fraseo:
1989 @lilypond[verbatim,quote,relative=2]
1992 -\tweak #'minimum-length #5
1997 -\tweak #'minimum-length #5
2001 Para algunos objetos de preesentación, la propiedad
2002 @code{minimum-length} es efectiva sólo si se llama explícitamente al
2003 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
2004 propiedad @code{springs-and-rods} al valor
2005 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
2006 de un glissando no tiene efecto a no ser que se establezca la
2007 propiedad @code{springs-and-rods}:
2009 @lilypond[verbatim,quote,relative=1]
2013 % not effective alone
2014 \once \override Glissando #'minimum-length = #20
2017 % effective only when both overrides are present
2018 \once \override Glissando #'minimum-length = #20
2019 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
2023 Lo mismo se puede decir del objeto @code{Beam}:
2025 @lilypond[verbatim,quote,relative=1]
2026 % not effective alone
2027 \once \override Beam #'minimum-length = #20
2030 % effective only when both overrides are present
2031 \once \override Beam #'minimum-length = #20
2032 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2036 @strong{@i{The @code{to-barline} property}}
2038 La segunda propiedad útil del @code{spanner-interface} es
2039 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2040 haciendo que los reguladores y otros objetos de extensión que terminan
2041 sobre la primera nota de un compás, en vez de eso terminen en la línea
2042 divisoria inmediatamente precedente. Si se establece al valor falso,
2043 el extensor llegará más allá de la barra de compás y terminará
2044 excatamente sobre la nota:
2046 @lilypond[verbatim,quote,relative=2]
2047 a \< a a a a \! a a a \break
2048 \override Hairpin #'to-barline = ##f
2049 a \< a a a a \! a a a
2052 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
2053 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2054 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2055 que terminar en la barra de compás no tendría ningún significado.
2057 @unnumberedsubsubsec Using the @code{line-spanner-interface}
2059 Entre los objetos que contemplan el interface
2060 @code{line-spanner-interface} se encuentran
2063 @item @code{DynamicTextSpanner}
2064 @item @code{Glissando}
2065 @item @code{TextSpanner}
2066 @item @code{TrillSpanner}
2067 @item @code{VoiceFollower}
2070 La rutina responsable de dibujar los sellos de estos extensores es
2071 @code{ly:line-interface::print}. esta rutina determina la
2072 localización exacta de los dos puntos extremos y traza una línea entre
2073 ellos, en el estilo solicitado. Las posiciones de los dos puntos
2074 extremos del extensor se calculan al vuelo, pero es posible
2075 sobreescribir sus coordenadas Y. Las propiedades que se deben
2076 especificar están anidadas a dos niveles de profundidad en la
2077 jerarquía de propiedades, pero la sintaxis de la instrucción
2078 @code{\override} es bastante sencilla:
2080 @lilypond[relative=2,quote,verbatim]
2082 \once \override Glissando #'bound-details #'left #'Y = #3
2083 \once \override Glissando #'bound-details #'right #'Y = #-2
2087 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2088 siendo el punto del cero la línea central del pentagrama. Para el
2089 glissando, esto es el valor de @code{Y} en la coordenada X que
2090 corresponde al punto central de cada cabeza de nota si nos imaginamos
2091 que la línea se extiende hasta allí.
2093 Si no está fijado @code{Y}, su valor se calcula a partir de la
2094 posición vertical del punto de anclaje correspondiente del extensor.
2096 En caso de salto de línea, los valores para los puntos extremos se
2097 especifican por las sub-listas @code{left-broken} y
2098 @code{right-broken} de @code{bound-details}. Por ejemplo:
2100 @lilypond[relative=2,ragged-right,verbatim,fragment]
2101 \override Glissando #'breakable = ##t
2102 \override Glissando #'bound-details #'right-broken #'Y = #-3
2103 c1 \glissando \break
2107 Un número de propiedades adicionales de las sub-listas @code{left} y
2108 @code{right} de la propiedad @code{bound-details} se pueden
2109 especificar de la misma forma que @code{Y}:
2113 Establece la coordenada Y del punto extremo, en desplazamientos de
2114 @code{staff-space}s desde la línea central del pentagrama. De forma
2115 predeterminada es el centro del objeto ancla, y así un glissando
2116 apunta al centro vertical de la cabeza de la nota.
2118 Para extensores horizontales como los extensores de texto y los
2119 trinos, está inamoviblemente codificado como 0.
2121 @item attach-dir (dirección de anclaje)
2122 Determina dónde comienza y termina la línea en la dirección X, con
2123 relación al objeto ancla. Sí, un valor de @code{-1} (o @code{LEFT},
2124 izquierda) hace que la línea comienze o termine en el lado izquierdo
2125 de la cabeza de la nota a la que está anclado.
2128 Es la coordenada X absoluta del punto extremo. Se suele calcular al
2129 vuelo, y su sobreescritura no tiene un efecto útil.
2131 @item stencil (sello)
2132 Los extensores de línea pueden tener símbolos al comienzo o al final,
2133 lo que está contenido en esta sub-propiedad. Esto es para uso
2134 interno; se recomienda en su lugar el uso de @code{text}.
2137 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
2138 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2139 de extensión horizontales.
2141 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2142 \override TextSpanner #'bound-details #'left #'text
2143 = \markup { \small \bold Slower }
2144 c2\startTextSpan b c a\stopTextSpan
2147 @item stencil-align-dir-y (alineación del sello en y)
2148 @item stencil-offset (desplazamiento del sello)
2149 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2150 punto extremo, centrado sobrer la línea, como viene definido por las
2151 subpropiedades @code{X} e @code{Y}. Si se fijan
2152 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2153 símbolo del borde verticalmente con relación al extremo de la línea:
2155 @lilypond[relative=1,fragment,verbatim]
2156 \override TextSpanner #'bound-details
2157 #'left #'stencil-align-dir-y = #-2
2158 \override TextSpanner #'bound-details
2159 #'right #'stencil-align-dir-y = #UP
2161 \override TextSpanner #'bound-details
2162 #'left #'text = #"ggg"
2163 \override TextSpanner #'bound-details
2164 #'right #'text = #"hhh"
2165 c4^\startTextSpan c c c \stopTextSpan
2168 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2169 al contrario de lo que podríoa esperarse, pues el valor de @code{-1} o
2170 @code{DOWN} (abajo) significa alinear el bborde @emph{inferior} del
2171 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
2172 (arriba) alinea el borde superior del texto con la línea extensora.
2174 @item arrow (flecha)
2175 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
2176 flecha en el extremo de la línea.
2178 @item padding (relleno)
2179 Esta sub-propiedad controla el espacio entre el punto extremo
2180 especificado de la línea y el extremo real. Sin relleno, un glissando
2181 empezaría y terminaría en el centro de la cabeza de las notas.
2185 La función musical @code{\endSpanners} finaliza de forma prematura el
2186 extensor que comienza sobre la nota que sigue inmediatamente a
2187 continuación. Se termina después de una nota exactamente, o en la
2188 siguiente barra de compás si @code{to-barline} es verdadero y se
2189 produce una divisoria antes de la siguiente nota.
2191 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
2193 c2 \startTextSpan c2 c2
2198 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
2199 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
2203 Referencia de funcionamiento interno:
2204 @rinternals{TextSpanner},
2205 @rinternals{Glissando},
2206 @rinternals{VoiceFollower},
2207 @rinternals{TrillSpanner},
2208 @rinternals{line-spanner-interface}.
2211 @node Visibility of objects
2212 @subsection Visibility of objects
2214 @cindex objetos, visibilidad de
2215 @cindex grobs, visibilidad de
2216 @cindex visibilidad de los objetos
2218 Hay cuatro formas principales en que se puede controlar la visibilidad
2219 de los objetos de presentación: se puede eliminar su sello, se pueden
2220 volver transparentes, se pueden pintar de blanco, o se puede
2221 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
2222 se aplican a todos los objetos de presentación; la última sólo a unos
2223 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
2224 introduce estas cuatro técnicas, véase @rlearning{Visibility and color
2227 Hay también algunas otras técnicas que son específicas de ciertos
2228 objetos de presentación. Se estudian bajo Consideraciones especiales.
2231 * Removing the stencil::
2232 * Making objects transparent::
2233 * Painting objects white::
2234 * Using break-visibility::
2235 * Special considerations::
2239 @node Removing the stencil
2240 @unnumberedsubsubsec Removing the stencil
2242 @cindex sello, eliminar
2244 Todo objeto de presentación tiene una propiedad stencil (sello). De
2245 forma predeterminada está establecida a la función específica que
2246 dibuja ese objeto. Se se sobreescribe eesta propiedad a @code{#f} no
2247 se llama a ninguna función y el objeto no se dibuja. La acción
2248 predeterminada se puede recuperar con @code{\revert}.
2250 @lilypond[quote,verbatim,relative=1]
2252 \override Score.BarLine #'stencil = ##f
2254 \revert Score.BarLine #'stencil
2258 @node Making objects transparent
2259 @unnumberedsubsubsec Making objects transparent
2261 @cindex transparentes, hacer los objetos
2263 Todo objeto de presentación tiene una propiedad transparent
2264 (transparente) que de forma predeterminada está establecida a
2265 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
2268 @lilypond[quote,verbatim,relative=2]
2270 \once \override NoteHead #'transparent = ##t
2274 @node Painting objects white
2275 @unnumberedsubsubsec Painting objects white
2277 @cindex objetos, coloreado de
2278 @cindex coloreado de objetos
2280 @cindex impresión, orden de
2281 @cindex sobreescritura de objetos
2282 @cindex objetos, sobreescritura de
2283 @cindex grobs, sobreescritura de
2285 Todo objeto de presentación tiene una propiedad de color que de forma
2286 predeterminada está establecida a @code{black} (negro). Si se
2287 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
2288 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
2289 color de los puntos de cruce queda determinado por el orden en que se
2290 dibujan estos objetos, lo que puede dejar una imagen fantasma del
2291 objeto blanco, como puede verse aquí:
2293 @lilypond[quote,verbatim,relative=2]
2294 \override Staff.Clef #'color = #white
2298 Se puede evitar esto cambiando el orden de impresión de los objetos.
2299 Todos los objetos de presentación tienen una propiedad @code{layer}
2300 (capa) que se debe establecer a un valor entero. Los objetos con el
2301 valor de @code{layer} más bajo se dibujan primero, después se dibujan
2302 los objetos con valores progresivamente mayores, y así los objetos con
2303 valores más altos se dibujan encima de los que tienen valores más
2304 bajos. De forma predeterminada, casi todos los objetos tienen
2305 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
2306 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
2307 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
2308 impresión de los objetos con el mismo valor de @code{layer} es
2311 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
2312 predeterminado de @code{1}, se dibuja después de las líneas del
2313 pentragrama (valor @code{layer} predeterminado de @code{0}),
2314 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
2315 @code{Clef} un valor de @code{layer} más bajo, digamos @code{-1}, para
2316 que se dibuje antes:
2318 @lilypond[quote,verbatim,relative=2]
2319 \override Staff.Clef #'color = #white
2320 \override Staff.Clef #'layer = #-1
2324 @node Using break-visibility
2325 @unnumberedsubsubsec Using break-visibility
2327 @c TODO Add making other objects breakable
2329 @cindex break-visibility
2331 Casi todos los objetos de presentación se imprimen una sola vez, pero
2332 algunos como las líneas divisorias, claves, indicaciones de compás y
2333 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
2334 se produce un salto de línea : una vez al final de la línea y otra al
2335 comienzo de la siguiente. Estos objetos reciben el nombre de
2336 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
2337 (visibilidad en el salto), para controlar su visibilidad en las tres
2338 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
2339 la línea si se produce un cambio, y al final de la línea si el cambio
2340 se produce en ese lugar.
2342 Por ejemplo, la indicación de compás se imprime de forma
2343 predeterminada al comienzo de la primera línea y en ningún otro lugar
2344 a no ser que cambie, en cuyo caso se imprime en el punto en que se
2345 produce el cambio. Si este cambio se produce al final de una línea,
2346 la nueva indicación de compás se imprime al principio de la línea
2347 siguiente y también al final de la línea anterior como indicación de
2350 Este comportamiento se controla por medio de la propiedad
2351 @code{break-visibility}, que se explica en
2352 @c Leave this ref on a newline - formats incorrectly otherwise -td
2353 @rlearning{Visibility and color of objects}. Esta propiedad toma un
2354 vector de tres valores booleanos que, por orden, determinan si el
2355 objeto se imprime al final, dentro, o al principio de la línea. O,
2356 para ser más exactos: antes del salto de línea, si no hay salto, o
2359 Como alternativa se pueden especificar siete de las ocho combinaciones
2360 mediante funciones predefinidas cuya definición está en
2361 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
2362 los objetos de presentación serán visibles en las posiciones que se
2363 muestran en el encabezamiento de cada columna:
2365 @multitable @columnfractions .40 .15 .1 .1 .1
2366 @c TODO check these more carefully
2367 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
2368 @headitem de función @tab de vector @tab salto @tab salto @tab salto
2370 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @ @ @tab no @tab no @tab no
2371 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
2372 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
2373 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
2374 @c The center-visible function is not defined
2375 @c @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
2376 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
2377 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
2378 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
2381 La función @code{center-visible} no está predefinida.
2383 Los ajustes predeterminados de @code{break-visibility} dependen del
2384 objeto de presentación. La tabla siguiente muestra todos los objetos
2385 de presentación de interés que resultan afectados por
2386 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
2388 @multitable @columnfractions .3 .3 .4
2390 @headitem Objeto @tab Contexto usual @tab Valor predet.
2392 @c omit Ambitus as it appears not to be affected by break-visibility -td
2393 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
2394 @item @code{BarLine} @tab @code{Score} @tab calculado
2395 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
2396 @c omit the following item until it can be explained -td
2397 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculated
2398 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2399 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
2400 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
2401 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2402 @c omit KeyCancellation until it can be explained -td
2403 @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible}
2404 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
2405 @c omit LeftEdge until it can be explained -td
2406 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
2407 @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible}
2408 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
2409 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
2413 El ejemplo de abajo muestra el uso de la forma de vector para
2414 controlar la visibilidad de las líneas divisorias:
2416 @lilypond[quote,verbatim,relative=1,ragged-right]
2419 % Remove bar line at the end of the current line
2420 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
2426 Aunque los tres componentes del vector utilizado para sobreescribir
2427 @code{break-visibility} deben estar presentes, no todos son efectivos
2428 para todos los objetos de presentación, y algunas combinaciones pueden
2429 incluso dar errores. Son de aplicación las siguientes limitaciones:
2432 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
2433 @item No se puede imprimir el número de compás al principio de la primera
2434 línea a no ser que su valor establecido sea distinto de 1.
2435 @item Clave: véase más abajo
2436 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
2437 se suprimen por completo. Utilice begin-of line-invisible para
2438 imprimirlas y all-invisible para suprimirlas.
2439 @item Armadura: véase más abajo
2440 @item OctavateEight: véase más abajo
2443 @node Special considerations
2444 @unnumberedsubsubsec Special considerations
2446 @strong{@emph{Visibilidad después de un cambio explícito}}
2448 @cindex armadura, visibilidad después de un cambio explícito
2449 @cindex explicitKeySignatureVisibility
2450 @cindex clave, visibilidad después de un cambio explícito
2451 @cindex explicitClefVisibility
2453 La propiedad @code{break-visibility} controla la visibilidad de las
2454 armaduras y cambios de clave sólo al principio de las líneas, es
2455 decir, después de un salto. No tiene ningún efecto sobre la
2456 visibilidad de la armadura o la clave después de un cambio explícito
2457 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
2458 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
2459 bemol mayor es visible incluso con @code{all-invisible} establecido.
2461 @lilypond[quote,verbatim,relative=1,ragged-right]
2464 % Try to remove all key signatures
2465 \override Staff.KeySignature #'break-visibility = #all-invisible
2473 La visibilidad de estos cambios explícitos de tonalidad y de clave se
2474 controla por medio de las propiedades
2475 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
2476 Son los equivalentes de la propiedad @code{break-visibility} y las dos
2477 toman un vector de tres valores booleanos o las funciones predefinidas
2478 relacionadas anteriormente, exactamente igual que
2479 @code{break-visibility}. Las dos son propiedades del contexto Staff,
2480 no de los propios objetos de presentación, y por tanto se establecen
2481 utilizando la instrucción @code{\set}. Las dos están establecidas de
2482 forma predeterminada al valor @code{all-visible}. Estas propiedades
2483 controlan sólo la visibilidad de las armaduras y las claves que
2484 resultan de los cambios explícitos y no afectan a las armaduras y
2485 tonalidades que están al principio de las líneas; para quitarlas, aún
2486 se debe sobreescribir la propiedad @code{break-visibility} en el
2487 objeto correspondiente.
2489 @lilypond[quote,verbatim,relative=1,ragged-right]
2492 \set Staff.explicitKeySignatureVisibility = #all-invisible
2493 \override Staff.KeySignature #'break-visibility = #all-invisible
2500 @strong{@emph{Visibilidad de las alteraciones de precaución}}
2502 Para eliminar las alteraciones de precaución que se imprimen en un
2503 cambio de tonalidad explícito, establezca la propiedad
2504 @code{printKeyCancellation} del contexto Staff a @code{#f}:
2506 @lilypond[quote,verbatim,relative=1,ragged-right]
2509 \set Staff.explicitKeySignatureVisibility = #all-invisible
2510 \set Staff.printKeyCancellation = ##f
2511 \override Staff.KeySignature #'break-visibility = #all-invisible
2518 Con estas sobreescrituras solamente permanecen las alteraciones
2519 accidentales delante de las notas para indicar el cambio de tonalidad.
2521 @c TODO Add visibility of cautionary accidentals before notes
2523 @strong{@emph{Automatic bars}}
2525 @cindex automaticBars
2526 @cindex líneas divisorias, eliminación
2528 Como caso especial, la impresión de las líneas divisorias también se
2529 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
2530 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
2531 imprimen automáticamente; se deben crear explícitamente con una
2532 instrucción @code{\bar}. A diferencia de la instrucción predefinida
2533 @code{\cadenzaOn}, los compases se siguen contando. La generación de
2534 compases continúa de acuerdo a esta cuenta si esta propiedad se
2535 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
2536 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
2541 @strong{@emph{Octavated clefs}}
2543 @cindex octavadas, visibilidad de las claves
2544 @cindex visibilidad de las claves octavadas
2545 @cindex claves, visibilidad de la octavación
2547 El pequeño símbolo de octava sobre las claves en octava alta o baja se
2548 produce por parte del objeto @code{OctavateEight}. Su visibilidad se
2549 controla independientemente de la del objeto @code{Clef}, así que es
2550 necesario aplicar las sobreescrituras correspondientes
2551 @code{break-visibility} tanto a los objetos @code{Clef} como
2552 @code{OctavateEight} para suprimir completamente estos símbolos de
2553 clave al comienzo de cada línea.
2555 Para los cambios de clave explícitos, la propiedad
2556 @code{explicitClefVisibility} controla tanto el símbolo de clave como
2557 el símbolo de octava asociado.
2561 Manual de aprendizaje:
2562 @rlearning{Visibility and color of objects}
2566 @subsection Line styles
2568 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
2569 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
2570 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
2572 Todos ellos usan las mismas rutinas que el glissando para dibujar los
2573 textos y las líneas, y por ello el ajuste fino de su comportamiento se
2574 hace de la misma manera. Se hace con un spanner (un objeto de
2575 extensión), y la rutina responsable de dibujar los objetos de
2576 extensión es @code{ly:line-interface::print}. Esta rutina determina la
2577 colocación exacta de los dos @i{extremos del objeto de extensión} y
2578 dibuja una línea entre ellos, en el estilo solicitado.
2580 He aquí un ejemplo de los distintos estilos de línea disponibles, y
2581 cómo aplicarles ajustes finos.
2583 @lilypond[relative=2,ragged-right,verbatim,fragment]
2585 \once \override Glissando #'style = #'dashed-line
2587 \override Glissando #'style = #'dotted-line
2589 \override Glissando #'style = #'zigzag
2591 \override Glissando #'style = #'trill
2595 Las posiciones de los puntos extremos del objeto de extensión se
2596 computan al vuelo para cada uno de los objetos gráficos, pero es
2597 posible sobreescribirlos:
2599 @lilypond[relative=2,ragged-right,verbatim,fragment]
2601 \once \override Glissando #'bound-details #'right #'Y = #-2
2605 El valor de @code{Y} está establecido a @code{-2} para el extremo
2606 derecho. El lado izquierdo se puede ajustar de forma similar
2607 especificando @code{left} en vez de @code{right}.
2609 Si no está establecido @code{Y}, el valor se computa a partir de la
2610 posición vertical de los puntos de anclaje izquierdo y derecho del
2613 Son posibles otros ajustes de los extensores, para ver más detalles
2614 consulte @ref{Spanners}.
2617 @node Rotating objects
2618 @subsection Rotating objects
2620 Tanto los objetos de presentación como los elementos de texto de
2621 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
2622 pero difiere el método de hacerlo.
2625 * Rotating layout objects::
2629 @node Rotating layout objects
2630 @unnumberedsubsubsec Rotating layout objects
2632 @cindex rotating objects
2633 @cindex objects, rotating
2635 Todos los objetos de presentación que contemplan el interface
2636 @code{grob-interface} se pueden rotar estableciendo su propiedad
2637 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
2638 rotación en sentido antihorario, y las coordenadas x e y del punto con
2639 relación al punto de referencia del objeto, alrededor del que se va a
2640 realizar la rotación. El ángulo de rotación se pespecifica en grados
2641 y las coordenadas en espacios de pentagrama.
2643 El ángulo de rotación y las coordenadas del punto de rotación se deben
2644 determinar por ensayo y error.
2646 @cindex reguladores en ángulo
2647 @cindex ángulo, reguladores en
2649 Solamente en ciertas ocasiones es útil la rotación de objetos de
2650 presentación; el ejemplo siguiente muestra una situación en que puede
2653 @lilypond[quote,verbatim,relative=1]
2655 \override Hairpin #'rotation = #'(20 -1 0)
2659 @node Rotating markup
2660 @unnumberedsubsubsec Rotating markup
2662 Todos los textos de marcado se pueden rotar para que se dispongan en
2663 cualquier ángulo predeciéndolos de la instrucción @code{\rotate}. La
2664 instrucción acepta dos argumentos: el ángulo de rotación en grados en
2665 sentido antihorario, y el texto que rotar. Los límites que ocupa el
2666 texto no se rotan: toman su valor a partir de los extremos de las
2667 coordenadas x e y del texto rotado. En el ejemplo siguiente la
2668 propiedad @code{outside-staff-priority} del texto se establece a
2669 @code{#f} para desactivar la evitación automática de colisiones, lo
2670 que empuja al texto a una posición muy alta.
2672 @lilypond[quote,verbatim,relative=1]
2673 \override TextScript #'outside-staff-priority = ##f
2674 g4^\markup { \rotate #30 "a G" }
2675 b^\markup { \rotate #30 "a B" }
2676 des^\markup { \rotate #30 "a D-Flat" }
2677 fis^\markup { \rotate #30 "an F-Sharp" }
2680 @node Advanced tweaks
2681 @section Advanced tweaks
2683 Esta sección trata sobre distintos enfoques en la realización de
2684 ajustes finos a la apariencia de la partitura impresa.
2687 * Aligning objects::
2688 * Vertical grouping of grobs::
2689 * Modifying stencils::
2690 * Modifying shapes::
2695 Manual de aprendizaje:
2696 @rlearning{Tweaking output},
2697 @rlearning{Other sources of information}.
2699 Referencia de la notación:
2700 @ref{Explaining the Internals Reference},
2701 @ref{Modifying properties},
2702 @ref{Interfaces for programmers}.
2705 @file{scm/@/define@/-grobs@/.scm}.
2707 Fragmentos de código:
2708 @rlsr{Tweaks and overrides}.
2710 Referencia de funcionamiento interno:
2711 @rinternals{All layout objects}.
2714 @node Aligning objects
2715 @subsection Aligning objects
2717 Los objetos gráficos que soportan el interface
2718 @code{self-alignment-interface} y/o el @code{side-position-interface}
2719 se pueden alinear contra un objeto colocado previamente, de diversas
2720 maneras. Para ver una lista de estos objetos, consulte
2721 @rinternals{self-alignment-interface} y
2722 @rinternals{side-position-interface}.
2724 Todos los objetos gráficos tienen un punto de referencia, una
2725 extensión horizontal y una extensión vertical. La extensión
2726 horizontal es una pareja de números que dan los desplazamientos a
2727 partir del punto de referencia de los bordes izquierdo y derecho,
2728 siendo negativos los desplazamientos hacia la izquierda. La extensión
2729 vertical es una pareja de números que dan el desplazamiento a partir
2730 del punto de referencia hasta los bordes inferior y superior, siendo
2731 negativos los deplazamientos hacia abajo.
2733 La posición de un objeto sobre el pentagrama viene dada por los
2734 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
2735 valor de @code{X-offset} da el desplazamiento desde la coordenada x
2736 del punto de referencia del objeto padre, y el valor de
2737 @code{Y-offset} da el desplazamiento a partir de la línea central del
2738 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
2739 pueden establecer directamente o se puede dejar que se calculen por
2740 parte de procedimientos para conseguir una alineación con el objeto
2741 padre de distintas maneras.
2743 @warning{Muchos objetos tienen consideraciones de posicionamiento
2744 especiales que hacen que se ignore o se modifique cualquier ajuste
2745 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
2746 objeto contemple el interface @code{self-alignment-interface}.}
2748 Por ejemplo, una alteración accidental se puede reposicionar
2749 verticalmente estableciendo @code{Y-offset} pero los cambios a
2750 @code{X-offset} no tienen ningún efecto.
2752 Las letras de ensayo se pueden alinear con objetos divisibles como
2753 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
2754 propiedades especiales que se encuentran en
2755 @code{break-aligned-interface} para el posicionamiento de las letras
2756 de ensayo sobre dichos objetos.
2759 * Setting @code{X-offset} and @code{Y-offset} directly::
2760 * Using the @code{side-position-interface}::
2761 * Using the @code{self-alignment-interface}::
2762 * Using the @code{break-aligned-interface}::
2765 @node Setting @code{X-offset} and @code{Y-offset} directly
2766 @unnumberedsubsubsec Setting @code{X-offset} and @code{Y-offset} directly
2768 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
2769 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
2770 notas con una digitación en su posición predeterminada y con los
2771 valores @code{X-offset} y @code{Y-offset} modificados.
2773 @lilypond[verbatim,quote,relative=2]
2776 -\tweak #'X-offset #0
2777 -\tweak #'Y-offset #0
2780 -\tweak #'X-offset #-1
2781 -\tweak #'Y-offset #1
2787 @node Using the @code{side-position-interface}
2788 @unnumberedsubsubsec Using the @code{side-position-interface}
2790 Un objeto que contempla el @code{side-position-interface} se puede
2791 colocar junto a su objeto padre de forma que los bordes especificados
2792 de los dos objetos se toquen. El objeto se puede situar encima,
2793 debajo, a la derecha o a la izquierda del objeto padre. El padre no
2794 se puede especificar; ciene determinado por el orden de los elementos
2795 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
2796 nota asociada como padre.
2798 Los valores de las propiedades @code{side-axis} y @code{direction}
2799 determinan dónde colocar el objeto, como sigue:
2801 @c TODO add an example of each to the table
2803 @multitable @columnfractions .3 .3 .3
2804 @headitem @code{side-axis} @tab @code{direction} @tab
2805 @headitem propiedad @tab propiedad @tab colocación
2807 @item @code{0} @tab @code{-1} @tab izquierda
2808 @item @code{0} @tab @code{1} @tab derecha
2809 @item @code{1} @tab @code{-1} @tab debajo
2810 @item @code{1} @tab @code{1} @tab encima
2814 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
2815 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
2816 procedimiento devuelve el calor correcto de @code{X-offset} para
2817 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
2818 el valor de @code{direction}.
2820 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
2821 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
2822 procedimiento devuelve el valor correcto de @code{Y-offset} para
2823 situar el objeto encima o debajo del padre de acuerdo con el valor de
2826 @c TODO Add examples
2828 @node Using the @code{self-alignment-interface}
2829 @unnumberedsubsubsec Using the @code{self-alignment-interface}
2831 @emph{Auto-alineación horizontal de los objetos}
2833 La alineación horizontal de un objeto que contempla el interface
2834 @code{self-alignment-interface} está controlada por el valor de la
2835 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
2836 @code{X-offset} de este objeto esté establecida a
2837 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
2838 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
2839 mitad de la extensión X total del objeto. Los valores negativos
2840 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
2841 valor de @code{0} centra el objeto sobre el punto de referencia de su
2842 padre, un valor de @code{-1} alinea el borde izquierdo del objeto
2843 sobre el punto de referencia de su padre, y un valor de @code{1}
2844 alinea el borde derecho del objeto sobre el punto de referencia de su
2845 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
2846 @code{RIGHT} en sustitución de los valores @code{-1, 0, 1},
2849 Normalmente se usaría la instrucción @code{\override} para modificar
2850 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
2851 @code{\tweak} para alinear varias anotaciones por separado sobre una
2854 @lilypond[quote,verbatim,relative=1]
2856 -\tweak #'self-alignment-X #-1
2858 -\tweak #'self-alignment-X #0
2860 -\tweak #'self-alignment-X #RIGHT
2862 -\tweak #'self-alignment-X #-2.5
2863 ^"aligned further to the right"
2866 @emph{Auto-alineación vertical de los objetos}
2868 Los objetos se pueden alinear verticalmente en una forma análoga a la
2869 alineación horizontal si la propiedad @code{Y-offset} está establecida
2870 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
2871 a menudo se encuentran implicados otros mecanismos en la alineación
2872 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
2873 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
2874 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
2875 las dimensiones verticales del objeto, que suele ser bastante pequeño,
2876 por lo que pueden requerirse números bastante grandes. Un valor de
2877 @code{-1} alinea el borde inferior del objeto con el punto de
2878 referencia del objeto padre, un valor de @code{0} alinea el centro del
2879 objeto con el punto de referencia del padre, y un valor de @code{1}
2880 alinea el borde superior del objeto con el punto de referencia del
2881 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
2882 @code{UP} en sustitución de @code{-1, 0, 1} respectivamente.
2884 @emph{Auto-alineación de objetos en las dos direcciones}
2886 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
2887 alinear un objeto en las dos direcciones simultáneamente.
2889 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
2890 se acerque a la cabeza de la nota.
2892 @lilypond[quote,verbatim,relative=2]
2894 -\tweak #'self-alignment-X #0.5 % move horizontally left
2895 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
2896 -\tweak #'self-alignment-Y #-1 % move vertically up
2901 @unnumberedsubsubsec Using the @code{aligned-on-parent} procedures
2903 @c Cannot document as they do not seem to operate consistently on all objects -td
2904 @c TODO investigate further
2906 The @code{aligned-on-parent} procedures are used in the same way
2907 as the @code{aligned-on-self} procedures, they difference being
2908 that they permit an object to be aligned with the @emph{edges} of
2909 the parent rather than the parent's reference point. The following
2910 example shows the difference:
2914 @lilypond[verbatim,quote]
2920 @unnumberedsubsubsec Using the @code{centered-on-parent} procedures
2922 @c Cannot document as they do not seem to operate consistently on all objects -td
2923 @c TODO investigate further
2927 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
2930 @node Using the @code{break-aligned-interface}
2931 @unnumberedsubsubsec Using the @code{break-aligned-interface}
2933 Las letras de ensayo se pueden alinear con objetos de notación
2934 distintos a las barras de compás. Estos objetos son @code{ambitus},
2935 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
2936 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
2937 @code{time-signature}.
2939 De forma predeterminada, las letras de ensayo se centran
2940 horizontalmente sobre el objeto:
2942 @lilypond[verbatim,quote,relative=1]
2944 % the RehearsalMark will be centered above the Clef
2945 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
2950 % the RehearsalMark will be centered above the TimeSignature
2951 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
2959 La alineación de la letra de enzayo con relación al objeto de notación
2960 se puede cambiar, como se ve en el ejemplo siguiente. En una
2961 partitura con varios pentagramas, este ajuste se debe hacer para todos
2964 @lilypond[verbatim,quote,relative=1]
2965 % The RehearsalMark will be centered above the KeySignature
2966 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
2972 % The RehearsalMark will be aligned with the left edge of the KeySignature
2973 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
2977 % The RehearsalMark will be aligned with the right edge of the KeySignature
2978 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
2984 La letra de ensayo también se puede desplazar al borde derecho o
2985 izquierdo en una medida arbitraria. Las unidades son espacios de
2988 @lilypond[verbatim,quote,relative=1]
2989 % The RehearsalMark will be aligned with the left edge of the KeySignature
2990 % and then shifted right by 3.5 staff-spaces
2991 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
2992 \once \override Score.KeySignature #'break-align-anchor = #3.5
2996 % The RehearsalMark will be aligned with the left edge of the KeySignature
2997 % and then shifted left by 2 staff-spaces
2998 \once \override Score.KeySignature #'break-align-anchor = #-2
3005 @node Vertical grouping of grobs
3006 @subsection Vertical grouping of grobs
3008 Los grobs (objetos gráficos) @code{VerticalAlignment} y
3009 @code{VerticalAxisGroup} trabajan de manera coordinada.
3010 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
3011 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
3012 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
3013 Normalmente sólo existe un @code{VerticalAlignment} por cada
3014 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
3015 @code{VerticalAxisGroup}.
3018 @node Modifying stencils
3019 @subsection Modifying stencils
3021 Todos los objetos de presentación tienen una propiedad @code{stencil}
3022 que es parte del @code{grob-interface}. De forma predeterminada, esta
3023 propiedad suele estar establecida a una función específica del objeto
3024 que está hecha a medida para disponer el símbolo que lo representa en
3025 la salida. Por ejemplo, el ajuste estándar para la propiedad
3026 @code{stencil} del objeto @code{MultiMeasureRest} es
3027 @code{ly:multi-measure-rest::print}.
3029 El símbolo estándar de cualquier objeto se puede sustituir modificando
3030 la propiedad @code{stencil} para que haga referencia a un
3031 procedimiento diferente escrito especialmente. Esto requiere un alto
3032 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3033 una forma más fácil que a menudo puede dar resultados adecuados.
3035 El procedimiento es establecer la propiedad @code{stencil} al
3036 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3037 añadir una propiedad @code{text} al objeto ajustada para que contenga
3038 el texto de marcado que produce el símbolo requerido. Debido a la
3039 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3040 particular, consulte @ref{Graphic notation inside markup}.
3042 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3043 la nota a unas aspas dentro de una circunferencia.
3045 @lilypond[verbatim,quote]
3047 \once \override NoteHead #'stencil = #ly:text-interface::print
3048 \once \override NoteHead #'text = \markup {
3050 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3051 \musicglyph #"noteheads.s2cross"
3059 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3060 a la instrucción de marcado @code{\musicglyph}: véase @ref{The Feta
3063 @c TODO Add inserting eps files or ref to later
3065 @c TODO Add inserting Postscript or ref to later
3069 Referencia de la notación:
3070 @ref{Graphic notation inside markup},
3071 @ref{Formatting text},
3072 @ref{Text markup commands},
3073 @ref{The Feta font}.
3076 @node Modifying shapes
3077 @subsection Modifying shapes
3080 * Modifying ties and slurs::
3083 @node Modifying ties and slurs
3084 @unnumberedsubsubsec Modifying ties and slurs
3086 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
3087 de Bézier de tercer orden. Si la forma de la ligadura calculada
3088 automáticamente no resulta óptima, se puede modificar su forma
3089 manualmente mediante la especificación explícita de los cuatro puntos
3090 de control necesarios para definir una curva de Bézier de tercer
3093 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
3094 puntos de control. El primer y cuarto puntos de control son
3095 exactamente los puntos extremos de comienzo y de final de la curva.
3096 Los dos puntos de contros intermedios definen la forma. Se pueden
3097 encontrar en la web animaciones que muestran cómo se traza la curva,
3098 pero la descripción siguiente puede ser de ayuda. La curva comienza a
3099 partir del primer punto de control dirigiéndose directamente hacia el
3100 segundo, curvándose progresivamente para dirigirse hacia el tercero y
3101 continuando la curva hacia el cuarto, llegando a éste en viaje directo
3102 desde el tercer punto de control. La curva está contenida enteramente
3103 dentro del cuadrilátero definido por los cuatro puntos de control.
3105 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
3106 @code{\tieDown} no sirve de ayuda.
3108 @lilypond[verbatim,quote,relative=1]
3112 { r4 <g c,> <g c,> <g c,> }
3116 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
3117 de control como sigue.
3119 Las coordenadas de los puntos de control de Bézier se especifican en
3120 unidades de espacios de pentagrama. La coordenada@tie{}X está en
3121 relación con el punto de referencia de la nota a la que está unida la
3122 ligadura, y la coordenada@tie{}Y está en relación con la línea central
3123 del pentagrama. Las coordenadas se introducen como una lista de
3124 cuatro parejas de números decimales (reales). Un enfoque es estimar
3125 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
3126 los dos puntos intermedios. Los valores óptimos se encuentran por
3129 Es útil recordar que una curva simétrica necesita puntos de contros
3130 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
3131 las transformaciones de la curva tales como la traslación, rotación y
3132 escalado se pueden obtener aplicando la misma transformación a los
3133 puntos de control de la curva.
3135 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
3138 @lilypond[verbatim,quote,relative=1]
3141 #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
3144 { r4 <g c,> <g c,> <g c,>4 }
3150 No es posible modificar la forma de las ligaduras de unión o de
3151 expresión cambiando la propiedad @code{control-points} si hay más de
3152 una en el mismo mom ento musical, ni siquiera usando la instrucción