1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: e16bb64a802f4f6a8b66c8714d6094f1866af6c0
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. @code{StaffGroup} sólo consiste en una
121 colección de pentagramas, con un corchete delante y líneas divisorias
124 @strong{@emph{ChoirStaff}}
126 Idéntico a @code{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 Igual que @code{GrandStaff}, pero contempla la posibilidad de poner el
138 nombre del instrumento a la izquierda del sistema.
140 @node Intermediate-level contexts - staves
141 @unnumberedsubsubsec Intermediate-level contexts - staves
143 @strong{@emph{Staff}}
145 Maneja claves, barras de compás, tonalidades y alteraciones
146 accidentales. Puede contener contextos de @code{Voice}.
148 @strong{@emph{RhythmicStaff}}
150 Como @code{Staff}, pero para imprimir ritmos. Se ignoran las alturas
151 de las notas; las notas se imprimen sobre una línea.
153 @strong{@emph{TabStaff}}
155 Contexto para generar tablaturas. De forma predeterminada dispone la
156 expresión musical como una tablatura de guitarra, impresa sobre seis
159 @strong{@emph{DrumStaff}}
161 Maneja el tipografiado para instrumentos de percusión. Puede contener
162 contextos @code{DrumVoice}.
164 @strong{@emph{VaticanaStaff}}
166 Igual que @code{Staff}, excepto que está pensado para tipografiar
167 piezas en estilo gregoriano.
169 @strong{@emph{MensuralStaff}}
171 Igual que @code{Staff}, excepto que está diseñado para tipografiar
172 piezas en estilo mensural.
175 @node Bottom-level contexts - voices
176 @unnumberedsubsubsec Bottom-level contexts - voices
178 Los contextos del mismo nivel que Voice dan un valor inicial a ciertas
179 propiedades e inician los grabadores correspondientes. Siendo
180 contextos del nivel más bajo, no pueden contener a otros contextos.
182 @strong{@emph{Voice}}
184 Corresponde a una voz sobre un pentagrama. este contexto maneja la
185 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
186 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
187 que crear instancias explícitas de este contexto si necesitamos varias
188 voces en el mismo pentagrama.
190 @strong{@emph{VaticanaVoice}}
192 Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
193 piezas en estilo gregoriano.
195 @strong{@emph{MensuralVoice}}
197 Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
198 piezas en estilo mensural.
200 @strong{@emph{Lyrics}}
202 Corresponde a una voz con letra. Maneja la impresión de una sola
205 @strong{@emph{DrumVoice}}
207 El contexto de voz utilizado en una pauta de percusión.
209 @strong{@emph{FiguredBass}}
211 El contexto en que los objetos @code{BassFigure} se crean a partir de
212 la entrada escrita en el modo @code{\figuremode}.
214 @strong{@emph{TabVoice}}
216 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
217 Se suele dejar que se cree implícitamente.
219 @strong{@emph{ChordNames}}
221 Tipografía nombres de acordes.
224 @node Creating contexts
225 @subsection Creating contexts
227 Para partituras que sólo tienen una voz y un pentagrama, los contextos
228 se crean automáticamente. Para partituras más complejas, es necesario
229 crearlos a mano. Existen tres instrucciones que hacen esto.
234 La instrucción más fácil es @code{\new}, y es también la más rápida de
235 escribir. Se antepone a una expresión musical, por ejemplo
238 @cindex nuevos, contextos
239 @cindex Contexto, creación de
242 \new @var{tipo} @var{expresión_musical}
246 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
247 @code{Voice}). Esta instrucción crea un contexto nuevo, y empieza a
248 interpretar la @var{expresión_musical} con él.
250 Una aplicación práctica de @code{\new} es una partitura con muchos pentagramas.
251 Cada parte que debe ir en su propio pentagrama, va precedida de
254 @lilypond[quote,verbatim,relative=2,ragged-right,fragment]
261 La instrucción @code{\new} puede también dar nombre al contexto,
264 \new @var{tipo} = @var{identificador} @var{música}
266 Sin embargo, este nombre especificado por el usuario sólo se utiliza
267 si no hay ya otro contexto anterior con el mismo nombre.
273 Como @code{\new}, la instrucción @code{\context} también dirige una
274 expresión musical a un objeto de contexto, pero da al contexto un
275 nombre explícito. La sintaxis es
278 \context @var{tipo} = @var{identificador} @var{música}
281 En esta forma, la instrucción buscará un contexto existente del
282 @var{tipo} especificado que tenga el nombre @var{identificador}. Si
283 ese contexto aún no existe, se crea un contexto nuevo con el nombre
284 especificado. Esto es útil si nos vamos a referir más tarde al
285 contexto. Por ejemplo, cuando se escribe la letra, la melodía está
286 dentro de un contexto con nombre
289 \context Voice = "@b{tenor}" @var{música}
293 de forma que los textos se puedan alienar correctamente con sus notas,
296 \new Lyrics \lyricsto "@b{tenor}" @var{letra}
301 Otro uso posible de los contextos con nombre es la fusión de dos
302 expresiones musicales distintas en un solo contexto. En el siguiente
303 ejemplo, se introducen por separado las articulaciones y las notas,
307 decoracion = @{ s4-. s4-> @}
310 se combinan enviando los dos al mismo contexto @code{Voice},
314 \new Staff \context Voice = "A" \musica
315 \context Voice = "A" \decoracion
318 @lilypond[quote,ragged-right]
322 \new Staff \context Voice = "A" \music
323 \context Voice = "A" \arts
327 Con este mecanismo, es posible definir un Urtext (una edición
328 original), con la posibilidad de poner articulaciones distintas sobre
331 @cindex crear contextos
334 La tercera instrucción para crear contextos es
336 \context @var{tipo} @var{música}
341 Esto es similar a @code{\context} con @code{= @var{identificador}},
342 pero se corresponde con cualquier contexto del tipo @var{tipo}, sin
343 importar qué nombre se le ha dado.
345 Esta variante se usa con expresiones musicales que se pueden
346 interpretar en varios niveles. Por ejemplo, la instrucción
347 @code{\applyOutput} (véase @ref{Running a function on all layout
348 objects}). Sin una instrucción @code{\context} explícita, normalmente
349 se aplicaría a @code{Voice}
352 \applyOutput #'@var{contexto} #@var{función} % aplicar al contexto Voice
355 Para que se interprete dentro de los niveles de @code{Score} o
356 @code{Staff}, utilice las siguientes formas:
359 \applyOutput #'Score #@var{función}
360 \applyOutput #'Staff #@var{función}
366 @node Modifying context plug-ins
367 @subsection Modifying context plug-ins
369 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
370 almacenan propiedades, también contienen «plug-ins» o complementos
371 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
372 el contexto @code{Voice} contiene un grabador
373 @code{Note_head_engraver} que crea las cabezas de nota y el contexto
374 @code{Staff} contiene un grabador @code{Key_signature_engraver} que
375 crea la indicación de compás.
377 Para ver una descripción completa de todos y cada uno de los
378 complementos, consulte
380 @rinternals{Engravers and Performers}.
383 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
385 Cada contexto que se describe en
387 @rinternals{Contexts}
390 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
392 relaciona los grabadores que se usan para ese contexto.
395 Puede ser de utilidad jugar un poco con estos complementos. Se hace
396 iniciando un contexto nuevo con @code{\new} o @code{\context} y
402 \new @var{contexto} \with @{
415 donde los @dots{} debe ser el nombre de un grabador. Aquí tenemos un
416 ejemplo sencillo que suprime los grabadores
417 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
420 @lilypond[quote,relative=1,verbatim,fragment]
426 \remove "Time_signature_engraver"
427 \remove "Clef_engraver"
434 En el segundo pentagrama no hay indicación de compás ni clave. Éste
435 es un método bastante rudimentario de hacer que desaparezcan los
436 objetos porque afecta a todo el pentagrama. Este método también
437 afecta al espaciado, lo que puede ser deseable o no serlo. Se
438 muestran métodos más sofisticados para quitar objetos en
439 @rlearning{Visibility and color of objects}.
441 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
442 líneas divisorias y las indicaciones de compás están sincronizadas a
443 lo largo de toda la partitura. Lo hacen los grabadores
444 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
445 complementos mantienen al día la administración de las indicaciones de
446 compás, posición dentro del compás, etc. Moviendo estos grabadores
447 desde el contexto de @code{Score} al de @code{Staff}, podemos
448 conseguir una partitura en la que cada pentagrama tiene su propio
449 compás independiente.
451 @cindex polimétricas, partituras
452 @cindex compases distintos al mismo tiempo
454 @lilypond[quote,relative=1,ragged-right,verbatim,fragment]
456 \remove "Timing_translator"
457 \remove "Default_bar_line_engraver"
460 \consists "Timing_translator"
461 \consists "Default_bar_line_engraver"
467 \consists "Timing_translator"
468 \consists "Default_bar_line_engraver"
477 @node Changing context default settings
478 @subsection Changing context default settings
480 Los ajustes de contexto que están preparados para usarse de forma
481 predeterminada en los contextos @code{Score}, @code{Staff} y
482 @code{Voice}, se pueden especificar dentro de un bloque
483 @code{\layout}, como se ilustra en el ejemplo siguiente. El bloque
484 @code{\layout} se debe colocar dentro del bloque @code{\score} en que
485 se quiere que haga efecto, pero fuera de la música.
487 Observe que la propia instrucción @code{\set} y el contexto se deben
488 omitir cuando se especifican de esta manera los valores de contexto
491 @lilypond[quote,verbatim]
494 a4^"Really small, thicker stems, no time signature" a a a
501 \override Stem #'thickness = #4.0
502 \remove "Time_signature_engraver"
508 En este ejemplo, la instrucción @code{\Staff} especifica que los
509 ajustes siguientes se apliquen a todos los pentagramas dentro del
512 Se pueden realizar de forma similar modificaciones al contexto
513 @code{Score} o a todos los contextos @code{Voice}.
517 No es posible recolectar cambios de contexto dentro de una variable y
518 aplicarlos a una definición de @code{\context} por referencia a dicha
521 La instrucción @code{\RemoveEmptyStaffContext} sobreescribe nuestros
522 ajustes en curso para @code{\Staff}. Si queremos cambiar los valores
523 predeterminados para un pentagrama que utilice
524 @code{\RemoveEmptyStaffContext}, debe hacerlo después de llamar a
525 @code{\RemoveEmptyStaffContext}, o sea
530 \RemoveEmptyStaffContext
532 \override Stem #'thickness = #4.0
538 @node Defining new contexts
539 @subsection Defining new contexts
541 Los contextos específicos, como @code{Staff} y @code{Voice}, están
542 construidos a base de bloques sencillos. Es posible crear nuevos
543 tipos de contextos con combinaciones distintas de añadidos grabadores.
545 El siguiente ejemplo muestra cómo construir un tipo diferente de contexto de
546 @code{Voice} partiendo de cero. Será parecido a
547 @code{Voice}, pero imprime solamente cabezas centradas en forma de barra inclinada. Se puede usar
548 para indicar improvisación en piezas de jazz,
551 @lilypond[quote,ragged-right]
554 \type "Engraver_group"
555 \consists "Note_heads_engraver"
556 \consists "Rhythmic_column_engraver"
557 \consists "Text_engraver"
558 \consists Pitch_squash_engraver
559 squashedPosition = #0
560 \override NoteHead #'style = #'slash
561 \override Stem #'transparent = ##t
565 \accepts "ImproVoice"
569 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
570 c4 c^"desvístete" c_"mientras juegas :)" c }
576 Estos ajustes se definen dentro de un bloque @code{\context} que a su
577 vez está dentro de un bloque @code{\layout},
587 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
588 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
590 En primer lugar es necesario definir un nombre para el nuevo contexto:
596 Debido a que es parecido al contexto @code{Voice}, queremos órdenes
597 que funcionen sobre contextos de @code{Voice} (existentes) para que
598 siga funcionando. Esto se consigue dando al contexto nuevo un alias
605 El contexto imprimirá notas y textos explicativos, por ello tenemos
606 que añadir los grabadores que aportan esta funcionalidad,
609 \consists Note_heads_engraver
610 \consists Text_engraver
613 Pero sólo necesitamos esto en la línea central,
616 \consists Pitch_squash_engraver
617 squashedPosition = #0
620 El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
621 nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
622 establece sus posiciones verticales al valor de
623 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.
625 Las notas parecen barras inclinadas y no tienen plica,
628 \override NoteHead #'style = #'slash
629 \override Stem #'transparent = ##t
632 Todos estos añadidos tienen que cooperar, y esto se consigue con un
633 añadido especial, que se debe marcar con la palabra clave
634 @code{\type}. Este será siempre @code{Engraver_group},
637 \type "Engraver_group"
640 Al juntarlo todo, obtenemos
645 \type "Engraver_group"
646 \consists "Note_heads_engraver"
647 \consists "Text_engraver"
648 \consists Pitch_squash_engraver
649 squashedPosition = #0
650 \override NoteHead #'style = #'slash
651 \override Stem #'transparent = ##t
657 Los contextos dan lugar a jerarquías. Queremos colgar el contexto
658 @code{ImproVoice} bajo el contexto @code{Staff}, como simples
659 @code{Voice}s normales. Por tanto, modificamos la definición de
660 @code{Staff} con la instrucción @code{\accepts} (acepta),
670 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
671 que a veces se necesita cuando se están reutilizando definiciones de
674 Ponemos ambos dentro de un bloque @code{\layout}, como
684 \accepts "ImproVoice"
689 Así pues, la salida que aparece al comienzo de esta sub-sección se
698 c c_"while playing :)"
705 @node Aligning contexts
706 @subsection Aligning contexts
708 Los contextos nuevos se pueden alinear por encima o por debajo de
709 otros contextos existentes. Esto podría ser de utilidad al preparar
710 un pentagrama vocal (@rlearning{Vocal ensembles}) y un ossia,
713 @findex alignAboveContext
714 @findex alignBelowContext
716 @lilypond[quote,ragged-right]
719 \relative c' \new Staff = "main" {
722 \new Staff \with { alignAboveContext = #"main" } \ossia
729 @cindex nested contexts
730 @cindex contexts, nested
735 Los contextos como @code{PianoStaff} pueden llevar dentro otros
736 contextos anidados. Los contextos que se pueden aceptar para su
737 anidamiento están definidos por la lista @qq{accepts} (acepta) de un
738 contexto. Los contextos que no están en esta lista se colocan debajo
739 del contexto exterior en la partitura impresa. Por ejemplo, el
740 contexto @code{PianoStaff} está definido para que acepte contextos
741 @code{Staff} y @code{FiguredBass} de forma predeterminada, pero no un
742 contexto @code{Lyrics}, por ejemplo. Así pues, en la siguiente
743 estructura la letra se sitúa debajo del sistema de piano en lugar de
744 colocarse entre los dos pentagramas:
746 @lilypond[verbatim,quote,relative=1]
749 \new Staff { e4 d c2 }
750 \addlyrics { Three blind mice }
758 La lista @qq{accepts} de un contexto se puede modificar para que
759 incluya contextos anidados adicionales, y así si quisiéramos que la
760 letra apareciese entre los dos pentagramas podríamos usar:
762 @lilypond[verbatim,quote,relative=1]
763 \new PianoStaff \with { \accepts Lyrics }
765 \new Staff { e4 d c2 }
766 \addlyrics { Three blind mice }
774 Lo contrario de @code{\accepts} (acepta) es @code{\denies} (deniega);
775 esto suprime un contexto de la lista @qq{accepts}.
778 @node Explaining the Internals Reference
779 @section Explaining the Internals Reference
783 * Navigating the program reference::
784 * Layout interfaces::
785 * Determining the grob property::
786 * Naming conventions::
791 @node Navigating the program reference
792 @subsection Navigating the program reference
794 Supongamos que queremos mover la indicación de digitación del
797 @lilypond[quote,fragment,relative=2,verbatim]
803 Si hace una visita a la documentación en busca de instrucciones de
804 digitación (en @ref{Fingering instructions}), encontrará:
807 @strong{Véase también}
809 Referencia de funcionamiento interno: @rinternals{Fingering}.
814 La referencia del programador se encuentra disponible en forma de
815 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
816 en línea o bien descargando los archivos de la documentación HTML.
817 Esta sección sería mucho más difícil de entender si está utilizando el
818 manual en formato PDF.
821 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
825 Los objetos de digitación se crean por parte de:
826 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
829 Siguiendo los enlaces relacionados dentro de la referencia del
830 programa, podemos seguir el flujo de información dentro del programa:
834 @item @rinternals{Fingering}:
835 los objetos @rinternals{Fingering} se crean por parte de:
836 @rinternals{Fingering_engraver}
838 @item @rinternals{Fingering_engraver}:
839 Tipos de música aceptados: @rinternals{fingering-event}
841 @item @rinternals{fingering-event}:
842 El tipo de evento musical @code{fingering-event} está descrito en
843 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
846 Este camino se recorre en contra de la corriente de información del
847 programa: comienza por la salida y acaba en el evento de entrada.
848 También podríamos haber empezado por un evento de la entrada, y leído
849 siguiendo el flujo de información terminando en su caso en el objeto
850 (u objetos) de la salida.
852 La referencia del programa también se puede examinar como un documento
853 normal. Contiene capítulos que tratan de
855 @rinternals{Music definitions},
858 @code{Music definitions}
860 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
861 de los capítulos relaciona todas las definiciones utilizadas y todas
862 las propiedades que se pueden ajustar.
865 @node Layout interfaces
866 @subsection Layout interfaces
868 @cindex interfaz de la presentación
869 @cindex presentación, interfaz de la
872 La página HTML que pudimos ver en la sección anterior describe el
873 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
874 es un símbolo dentro de la partitura. Tiene propiedades que guardan
875 números (como grosores y direcciones), pero también punteros a objetos
876 relacionados. Un objeto de presentación también se llama un
877 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
878 gráfico). Para ver más detalles acerca de los objetos gráficos o
879 Grobs, consulte @rinternals{grob-interface}.
881 La página dedicada a @code{Fingering} relaciona las definiciones del
882 objeto @code{Fingering}. Por ejemplo, la página dice
885 @code{relleno} (dimensión, en espacios de pentagrama):
891 lo que significa que el número se mantendrá a una distancia de al
892 menos 0.5 de la cabeza de la nota.
895 Cada objeto de presentación puede tener varias funciones como elemento
896 notacional o tipográfico. Por ejemplo, el objeto de digitación
897 Fingering tiene los siguientes aspectos
901 Su tamaño es independiente del espaciado horizontal, al contrario de
902 las ligaduras o las barras de las figuras.
905 Es un elemento de texto. Casi seguro que es un texto muy corto.
908 este elemento de texto se tipografía con un tipo de letra, no como las
909 ligaduras o las barras de las figuras.
912 Horizontalmente, el centro del símbolo se debe alinear con el centro
913 de la cabeza de la nota.
916 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
919 La posición vertical también está coordinada con otros símbolos de
920 superíndice y de subíndice.
923 Cada uno de estos aspectos se capta en lo que se llaman
924 @emph{interface}s, que se relacionan al final de la página dedicada a
925 @rinternals{Fingering}
928 Este objeto contempla los siguientes interfaces:
929 @rinternals{item-interface},
930 @rinternals{self-alignment-interface},
931 @rinternals{side-position-interface}, @rinternals{text-interface},
932 @rinternals{text-script-interface}, @rinternals{font-interface},
933 @rinternals{finger-interface} y @rinternals{grob-interface}.
936 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
937 página del respectivo interfaz del objeto. Cada interfaz tiene un
938 cierto número de propiedades. Algunas de ellas no son para que el
939 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
942 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
943 realmente esto no significa mucho. El archivo de inicialización
944 (véase @rlearning{Other sources of information})
945 @file{scm/@/define@/-grobs@/.scm} muestra el alma del @q{objeto},
950 (avoid-slur . around)
952 (staff-padding . 0.5)
953 (self-alignment-X . 0)
954 (self-alignment-Y . 0)
955 (script-priority . 100)
956 (stencil . ,ly:text-interface::print)
957 (direction . ,ly:script-interface::calc-direction)
958 (font-encoding . fetaNumber)
959 (font-size . -5) ; don't overlap when next to heads.
960 (meta . ((class . Item)
961 (interfaces . (finger-interface
963 text-script-interface
965 side-position-interface
966 self-alignment-interface
971 Como podemos ver, el objeto @code{Fingering} no es más que un montón
972 de valores de variables, y la página web de la Referencia de
973 funcionamiento interno se genera directamente a partir de esta
977 @node Determining the grob property
978 @subsection Determining the grob property
980 Recordemos que queríamos cambiar la posición del @b{2} en
982 @lilypond[quote,fragment,relative=2,verbatim]
988 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
989 tenemos que negociar con el interfaz asociado con esta colocación.
990 Esto se hace usando @code{side-position-interface}. La página que
991 describe este interface dice:
994 @code{side-position-interface}
996 Colocar un objeto víctima (este mismo) junto a otros objetos (el
997 soporte). La propiedad @code{direction} significa dónde poner el
998 objeto víctima con relación al soporte (¿a la izquierda o a la
999 derecha, encima o debajo?)
1004 Debajo de esta descripción, la variable @code{padding} (relleno) se describe como
1009 (dimensión, en espacios de pentagrama)
1011 Añadir esta cantidad de espacio adicional entre objetos que están unos
1016 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1017 digitación de la cabeza de la nota. La siguiente orden inserta un
1018 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1021 \once \override Voice.Fingering #'padding = #3
1024 Al insertar esta instrucción antes de que se haya creado el objeto
1025 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1028 @lilypond[quote,relative=2,fragment,verbatim]
1029 \once \override Voice.Fingering #'padding = #3
1035 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1036 se puede deducir también a partir de la referencia del programa, ya
1037 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1040 El grabador Fingering_engraver es parte de los contextos: @dots{}
1046 @node Naming conventions
1047 @subsection Naming conventions
1050 Another thing that is needed, is an overview of the various naming
1053 scheme functions: lowercase-with-hyphens (incl. one-word
1055 scheme functions: ly:plus-scheme-style
1056 music events, music classes and music properties:
1058 Grob interfaces: scheme-style
1059 backend properties: scheme-style (but X and Y!)
1060 contexts (and MusicExpressions and grobs): Capitalized or
1062 context properties: lowercaseFollowedByCamelCase
1064 Capitalized_followed_by_lowercase_and_with_underscores
1066 Which of these are conventions and which are rules?
1067 Which are rules of the underlying language, and which are
1071 @node Modifying properties
1072 @section Modifying properties
1075 * Overview of modifying properties::
1077 * The override command::
1078 * The tweak command::
1079 * set versus override::
1083 @node Overview of modifying properties
1084 @subsection Overview of modifying properties
1086 Cada contexto es responsable de la creación de ciertos tipos de
1087 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1088 también se almacenan por contexto. Mediante la modificación de estos
1089 ajustes, se puede alterar la apariencia de los objetos.
1091 La sintaxis de esto es
1094 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1097 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1098 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1099 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1100 disposición}). Este último es un símbolo, y por ello debe ir
1101 precedido de un apóstrofo. La subsección @ref{Modifying properties}
1102 explica cómo se deben cumplimentar los conceptos @var{nombre},
1103 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1104 funcionalidad des esta instrucción.
1109 \override Staff.Stem #'thickness = #4.0
1113 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1114 grosor de una línea del pentagrama como unidad). Puesto que la
1115 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1116 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1117 Aquí vemos la instrucción en pleno funcionamiento:
1119 @lilypond[quote,verbatim,relative=2,fragment]
1121 \override Staff.Stem #'thickness = #4.0
1127 La instrucción @code{\override} modifica la definición de la plica
1128 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1129 que la instrucción se ha interpretado, todas las plicas se engrosan.
1131 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1132 omitir, ocasionando que se utilice el contexto predeterminado
1133 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1134 solo paso de tiempo.
1136 @lilypond[quote,fragment,verbatim,relative=2]
1138 \once \override Stem #'thickness = #4.0
1143 El @code{\override} se debe hacer antes de que el objeto se inicia.
1144 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1145 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1146 en el momento en que se crea el objeto. En este ejemplo:
1148 @lilypond[quote,fragment,verbatim,relative=2]
1149 \override Slur #'thickness = #3.0
1151 \override Beam #'thickness = #0.6
1156 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1157 la instrucción para @code{Beam}, la barra, va después de que la barra
1158 se ha iniciado, y por ello no tiene ningún efecto.
1160 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1161 un contexto deshace una instrucción @code{\override}; como con
1162 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1163 del mismo contexto. En otras palabras, el @code{\revert} del
1164 siguiente ejemplo no hace nada.
1167 \override Voice.Stem #'thickness = #4.0
1168 \revert Staff.Stem #'thickness
1171 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1172 dentro de las propiedades normales. Para trucarlas, utilice
1173 instrucciones de la forma
1175 @c leave this as a long long
1177 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1184 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1189 Referencia de funcionamiento interno:
1190 @rinternals{OverrideProperty},
1191 @rinternals{RevertProperty},
1192 @rinternals{PropertySet},
1193 @rinternals{Backend},
1194 @rinternals{All layout objects}.
1199 El «back-end» o motor de salida no es muy estricto en la comprobación
1200 de tipos de las propiedades de objetos. Las referencias cíclicas en
1201 valores Scheme de propiedades pueden producir cuelgues o salidas
1202 abruptas, o las dos cosas.
1205 @node The set command
1206 @subsection The @code{\set} command
1210 @cindex cambiar propiedades
1212 Cada contexto puede tener distintas @emph{propiedades}, variables
1213 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1214 paso de interpretación. Se consigue insertando la instrucción
1215 @code{\set} dentro de la música:
1218 \set @var{contexto}.@var{propiedad} = #@var{valor}
1222 @lilypond[quote,verbatim,relative=2,fragment]
1224 \set Score.skipBars = ##t
1228 Estas instrucción salta los compases que no tienen notas. El
1229 resultado es que los silencios multicompás se condensan. El valor
1230 asignado es un objeto de Scheme. En este caso, es @code{#t}, el valor
1231 booleano True o verdadero.
1233 Si se omite el argumento @var{context}, entonces se utiliza el
1234 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1235 @code{Voice} o @code{Lyrics}). En este ejemplo:
1237 @lilypond[quote,verbatim,relative=2,fragment]
1239 \set autoBeaming = ##f
1244 el argumento @var{contexto} de la instrucción @code{\set} se omite,
1245 así pues el barrado automático se desactiva en la voz actual. Observe
1246 que el contexto de nivel más bajo no siempre contiene la propiedad que
1247 queremos cambiar (por ejemplo, no tendrá ningún efecto intentar
1248 establecer un valor para la propiedad @code{skipBars} del contexto de
1249 nivel más bajo, en este caso @code{Voice}).
1251 @lilypond[quote,verbatim,relative=2,fragment]
1257 Los contextos son jerárquicos, y si se ha especificado un contexto
1258 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1259 también a todos los contextos @code{Voice} dentro del pentagrama
1260 actual. El cambio se aplica @q{al vuelo}, durante la música, de
1261 manera que el ajuste sólo afecta al segundo grupo de corcheas.
1265 También existe una instrucción @code{\unset}:
1267 \unset @var{contexto}.@var{propiedad}
1271 que elimina la definición de @var{propiedad}. Esta instrucción
1272 elimina la definición solamente si está establecida dentro de
1273 @var{contexto}, de manera que
1276 \set Staff.autoBeaming = ##f
1280 introduce un ajuste de la propiedad en el nivel de @code{Staff}. El
1281 ajuste también se aplica a la @code{Voice} actual. Sin embargo:
1284 \unset Voice.autoBeaming
1288 no tiene ningúun efecto. Para cancelar este ajuste, se debe
1289 especificar el @code{\unset} en el mismo nivel que el @code{\set}
1290 original. Dicho de otra forma, para deshacer el efecto de
1291 @code{Staff.autoBeaming = ##f} se necesita
1293 \unset Staff.autoBeaming
1296 Como @code{\set}, el argumento @var{contexto} no se tiene que
1297 especificar para un contexto del nivel más bajo, por lo que los dos
1301 \set Voice.autoBeaming = ##t
1302 \set autoBeaming = ##t
1310 Los ajustes que se aplican solamente a un único paso de tiempo se
1311 pueden escribir con @code{\once}, por ejemplo en
1313 @lilypond[quote,verbatim,relative=2,fragment]
1315 \once \set fontSize = #4.7
1320 la propiedad @code{fontSize} se deshace automáticamente después de la
1323 En el manual de Referencia de funcionamiento interno hay una
1324 descripción completa de todas las propiedades de contexto disponibles,
1327 @rinternals{Tunable context properties}.
1330 Traducción @expansion{} Propiedades de contexto modificables por el
1336 @node The override command
1337 @subsection The @code{\override} command
1339 Las instrucciones que modifican la salida tienen por lo general un
1343 \override Voice.Stem #'thickness = #3.0
1347 Para construir este truco debemos determinar los siguientes datos:
1350 @item el contexto: aquí @code{Voice}.
1351 @item el objeto de presentación: aquí @code{Stem}.
1352 @item la propiedad de presentación: aquí @code{thickness}.
1353 @item un valor adecuado: aquí @code{3.0}.
1356 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
1357 en el interior de las propiedades normales. Para modificarlas utilice
1358 instrucciones de la forma
1361 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1364 @cindex documentación interna
1365 @cindex buscar objetos gráficos
1366 @cindex gráficos, descripción de los objetos
1369 @cindex interna, documentación
1371 Para muchas propiedades, independientemente del tipo de datos de la
1372 propiedad, si se establece el valor de la propiedad a falso
1373 (@code{##f}) se producirá su desactivación, ocasionando que LilyPond
1374 ignore por completo dicha propiedad. Esto es especialmente útil para
1375 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
1376 causarína problemas.
1378 Mostraremos a continuación cómo localizar esta información en el
1379 manual de notación y en la referencia de funcionamiento interno.
1382 @node The tweak command
1383 @subsection The @code{\tweak} command
1388 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
1389 los objetos gráficos. Para objetos que reusultan directamente de un
1390 elemento de código de la entrada, puede usar la función @code{\tweak},
1393 @lilypond[relative=2,verbatim]
1398 \tweak #'duration-log #1
1401 -\tweak #'padding #8
1405 @cindex chord, modifying one note in
1407 Pero el uso principal de la instrucción @code{\tweak} es modificar
1408 solamente uno de varios elementos de notación que dan comienzo en el
1409 mismo momento musical, como las notas de un acorde, o corchetes de
1410 tresillo que empiezan al mismo tiempo.
1412 Para ver una introducción a la sintaxis y los usos de la instrucción
1413 tweak, consulte @rlearning{Tweaking methods}.
1415 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
1416 a continuación de forma directa, sin necesidad de especificar el
1417 nombre del grob o el contexto. Para que esto funcione, es necesario
1418 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
1419 al objeto al que se aplica, después de que el archivo de entrada se ha
1420 convertido en un flujo musical. Con frecuencia no es el caso, pues
1421 muchos elementos adicionales se insertan en la corriente musical de
1422 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
1423 parte de un acorde, LilyPond inserta implícitamente un evento
1424 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
1425 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
1426 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
1427 en el flujo musical, permaneciendo así adyacente a la nota, y con la
1428 posibilidad de modificarla.
1432 @lilypond[relative=2,verbatim,quote]
1433 <\tweak #'color #red c>4
1437 pero esto no funciona:
1439 @lilypond[relative=2,verbatim,quote]
1440 \tweak #'color #red c4
1443 Si se colocan varios elementos similares en el mismo momento musical,
1444 la instrucción @code{\override} no se puede usar para modificar uno
1445 solo de ellos: aquí es donde se debe usar la instrucción
1446 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
1447 en el mismo momento musical están los siguientes:
1449 @c TODO expand to include any further uses of \tweak
1451 @item las cabezas de las notas de un acorde
1452 @item signos de articulación sobre la misma nota
1453 @item ligaduras de unión entre notas de un acorde
1454 @item corchetes de grupos especials que comienzan en el mismo momento
1457 @c TODO add examples of these
1460 y se puede usar @code{\tweak} para modificar cualquier aparición
1461 específica de estos elementos.
1463 Es de resaltar que la instrucción @code{\tweak} no se puede usar para
1464 modificar plicas, barras o alteraciones accidentales, porque éstos se
1465 generan más tarde por parte de las cabezas de nota, en vez de por
1466 elementos musicales que están en el flujo de entrada. Ni se puede
1467 usar una instrucción @code{\tweak} para modificar claves o
1468 indicaciones de compás, ya que éstos están separados de cualquier
1469 instrucción @code{\tweak} precedente en el flujo de entrada a causa de
1470 la inserción automática de elementos adicionales necesarios para
1471 especificar el contexto.
1473 Pero la instrucción @code{\tweak} se puede usar como alternativa a la
1474 instrucción @code{\override} para modificar estos elementos
1475 notacionales que no producen la adición de ningún elemento notacional
1476 implícito antes de ellos mismos en el flujo musical. Por ejemplo, las
1477 ligaduras de expresión se pueden modificar de esta forma:
1479 @lilypond[verbatim,quote,relative=1]
1480 c-\tweak #'thickness #5 ( d e f)
1483 También se pueden escribir varias instrucciones @code{\tweak} antes de
1484 un elemento notacional, y todas ellas le afectan:
1486 @lilypond[verbatim,quote,relative=1]
1488 -\tweak #'style #'dashed-line
1489 -\tweak #'dash-fraction #0.2
1490 -\tweak #'thickness #3
1491 -\tweak #'color #red
1496 El flujo musical que se genera a partir de una sección de un archivo
1497 de entrada, incluido cualquier elemento insertado automáticamente,
1498 puede examinarse, véase @ref{Displaying music expressions}. Esto
1499 puede ser de utilidad en la determinación de lo que puede modificarse
1500 por medio de una instrucción @code{\tweak}.
1504 Manual de aprendizaje:
1505 @rlearning{Tweaking methods}.
1507 Referencia de la notación:
1508 @ref{Displaying music expressions}.
1513 @cindex trucos en una variable
1514 La instrucción @code{\tweak} no se puede usar dentro de una variable.
1516 @cindex trucos en la letra
1517 Las instrucciones @code{\tweak} no se pueden usar dentro del modo @code{\lyricmode}.
1519 @cindex trucar puntos de control
1520 @cindex control, trucar puntos de
1522 La instrucción @code{\tweak} no se puede usar para modificar los
1523 puntos de control de una única ligadura entre varias dentro de un
1524 acorde, aparte de la primera que aparece en el archivo de entrada.
1526 @node set versus override
1527 @subsection @code{\set} vs. @code{\override}
1529 Hemos visto dos formas de cambiar las propiedades: @code{\set} y
1530 @code{\override}. De hecho, en realidad existen dos clases diferentes
1533 Los contextos pueden tener propiedades, que por lo general reciben
1534 nombres en @code{mayúsculasDeCamello}. Principalmente controlan la
1535 traducción de la música a la notación, p.ej. @code{localKeySignature}
1536 (para determinar si hay que imprimir las alteraciones accidentales),
1537 @code{measurePosition} (para determinar cuándo imprimir una línea
1538 divisoria). Las propiedades de contexto pueden ver modificado su
1539 valor con el tiempo según se interpreta una pieza de música;
1540 @code{measurePosition} es un ejemplo obvio de esto. Las propiedades
1541 de contexto se modifican con @code{\set}.
1543 Hay un tipo especial de propiedad de contexto: la descripción del
1544 elemento. Estas propiedades reciben nombres en
1545 @code{MayúsculasDeCamello} (comenzando en letra mayúscula). Contienen
1546 los @q{ajustes por defecto} para dicho elemento gráfico como una lista
1547 asociativa. Consulte @file{scm/@/define@/-grobs@/.scm} para ver qué
1548 tipos de ajustes hay. Las descripciones de los elementos se pueden
1549 modificar con @code{\override}.
1551 Realmente, @code{\override} es un atajo;
1554 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1558 es más o menos equivalente a
1560 @c leave this long line -gp
1562 \set @var{contexto}.@var{nombre} #'@var{propiedad} = #(cons (cons '@var{propiedad} @var{valor}) <valor previo de @var{contexto})
1565 El valor de @code{contexto} (la lista-a) se usa para da un valor
1566 inicial a las propiedades de los objetos gráficos individuales. Los
1567 objetos gráficos también tienen propiedades, que reciben nombres en el
1568 estilo de Scheme, con @code{palabras-con-guiones}. Los valores de las
1569 propiedades de objetos gráficos cambian durante el proceso de
1570 formateo: el formateo básicamente consiste en calcular las propiedades
1571 utilizando funciones de callback.
1573 @code{fontSize} es una propiedad especial: equivale a escribir
1574 @code{\override ... #'font-size} para todos los objetos pertinentes.
1575 Al ser éste un cambio muy común, se creó la propiedad especial
1576 (modificada con @code{\set}).
1579 @node Useful concepts and properties
1580 @section Useful concepts and properties
1585 * Direction and placement::
1586 * Distances and measurements::
1587 * Staff symbol properties::
1589 * Visibility of objects::
1591 * Rotating objects::
1595 @subsection Input modes
1597 La forma en que se interpreta la notación conenida dentro de un
1598 archivo de entrada, está determinada por el modo de entrada en curso.
1600 @strong{Modo de acordes}
1602 Se activa con la instrucción @code{\chordmode} y produce que la
1603 entrada se interprete con al sintaxis de la notación de acordes, véase
1604 @ref{Chord notation}. Los acordes se imprimen como notas sobre un
1607 El modo de acordes se activa también con la instrucción
1608 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
1609 y produce que el código que sigue se interprete conla sintaxis de la
1610 notación de acordes y se imprima como nombres de acorde dentro del
1611 contexto @code{ChordNames}, véase @ref{Printing chord names}.
1613 @strong{Modo de percusión}
1615 Se activa con la instrucción @code{\drummode} y produce que el código
1616 de entrada se interprete con la sintaxis de la notación de percusión,
1617 véase @ref{Basic percussion notation}.
1619 El modo de percusión también se activa con la instrucción
1620 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
1621 que el código que sigue se interprete con la sintaxis de la notación
1622 de percusión y se imprima como símbolos de percusión sobre un
1623 pentagrama de percusión, véase @ref{Basic percussion notation}.
1625 @strong{Modo de cifras}
1627 Se activa con la instrucción @code{\figuremode} y hace que el código
1628 de entrada se interprete con la sintaxis del bajo cifrado, véase
1629 @ref{Entering figured bass}.
1631 El modo de cifrase también se activa con la instrucción
1632 @code{\figures}. También crea un contexto de @code{FiguredBass} nuevo
1633 y hace que el código que viene a continuación se interprete con la
1634 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
1635 dentro del contexto @code{FiguredBass}, véase @ref{Introduction to
1638 @strong{Modos de traste y tablatura}
1640 No existen modos de entrada especiales para introducir símibolos de
1641 trastes y de tablatura.
1643 Para crear diagramas de trastes, escriba las notas o acordes en el
1644 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
1645 véase @ref{Default tablatures}.
1647 Para crear diagramas de trastes encima de un pentagrama, escríbalos
1648 como elementos de marcado encima de las notas utilizando la
1649 instrucción @code{\fret-diagram}, véase @ref{Fret diagram markups}.
1651 @strong{Modo de letra}
1653 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
1654 se interprete como sílabas de la letra de la canción con duraciones
1655 opcionales y modificadores de letra asociados, véase @ref{Vocal
1658 El modo de letra también se habilita con la instrucción
1659 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
1660 y una instrucción @code{\lyricsto} implícita que asocia la letra que
1661 viene a continuación con la música precedente.
1663 @strong{Modo de marcado}
1665 Se activa con la instrucción @code{\markup}, y hace que la entrada se
1666 interprete con la sintaxis del marcado, véase @ref{Text markup
1669 @c silly work-around for texinfo broken-ness
1670 @c (@strong{Note...} causes a spurious cross-reference in Info)
1673 Es el modo predeterminado o se puede activar con la instrucción
1674 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
1675 marcado, etc. y se imprime como notación musical sobre un pentagrama.
1677 Normalmente no es necesario especificar el modo de notas de forma
1678 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
1679 ejemplo si estamos en el modo de letra, en el modo de acordes o en
1680 otro modo y queremos insertar algo que solamente se puede hacer con la
1681 sintaxis del modo de notas.
1683 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
1684 una pieza coral es necesario entrar en el modo de notas para poder
1685 interpretar dichas indicaciones:
1687 @lilypond[verbatim,relative=2,quote]
1690 \notemode{\set stanza = \markup{ \dynamic f 1. } }
1694 \notemode{\set stanza = \markup{ \dynamic p 2. } }
1701 @node Direction and placement
1702 @subsection Direction and placement
1704 Al tipografiar música, la dirección y colocación de muchos elementos
1705 es cuestión de elección. Por ejemplo, las plicas de las notas se
1706 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
1707 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
1708 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
1709 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
1710 LilyPond las determine automáticamente, pero en ciertos casos puede
1711 ser deseable forzar una dirección o colocación concreta.
1713 @strong{Acciones predeterminadas}
1715 De forma predeterminada algunas direcciones siempre son hacia arriba o
1716 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
1717 otras cosas pueden alternar entre arriba y abajo en función de la
1718 dirección de las plicas (como las ligaduras o los acentos).
1720 @c TODO Add table showing these
1722 @strong{Disposición de contexto}
1724 Los contextos se colocan dentro de un sistema de arriba a abajo en el
1725 orden en que se encuentran. Sin embargo, observe que se crea un
1726 contexto implícitamente si se encuentra una instrucción cuando no está
1727 disponible un contexto apropiado para contenerla.
1729 @c TODO Add example ?
1731 Se pude cambiar el orden predeterminado en que los contextos se
1732 presentan, véase @ref{Aligning contexts}
1734 @strong{Indicadores de dirección de las articulaciones}
1736 Al añadir articulaciones a notas se puede omitir normalmente el
1737 indicador de dirección, @code{^} (que significa @qq{arriba}), @code{_}
1738 (que significa @qq{abajo}) o @code{-} (que significa @qq{usar la
1739 dirección predeterminada}), en cuyo caso se supone el perdeterminado
1740 @code{-}. Pero se necesita un indicador de dirección @strong{always}
1744 @item las instrucciones @code{\tweak}
1745 @item las instrucciones @code{\markup}
1746 @item las instrucciones @code{\tag}
1747 @item los marcados de cadena, p.ej. -"cadena"
1748 @item las instrucciones de digitación, p.ej. @code{-1}
1749 @item las abreviaturas de articulación, p.ej. @code{-.}, @code{->}, @code{--}
1752 @strong{La propiedad de dirección}
1754 La posición o dirección de muchos objetos de presentación está
1755 controlada por la propiedad @code{direction}.
1757 El valor de la propiedad @code{direction} se puede establecer al valor
1758 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
1759 @code{-1}, con el significado de @qq{hacia abajo} o @qq{debajo}. Se
1760 pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
1761 @code{1} y @code{-1} respectivamente. La dirección predeterminada se
1762 puede especificar estableciendo @code{direction} a @code{0} ó a
1763 @code{CENTER}. De forma alternativa, en muchos casos existen
1764 instrucciones predefinidas para especificar la dirección. Todas ellas
1768 @code{\xxxUp}, @code{xxxDown}, @code{xxxNeutral}
1771 donde @code{xxxNeutral} significa @qq{utilizar la dirección
1772 predeterminada}. Véase @rlearning{Within-staff objects}.
1774 En alguna que otra ocasión, con el único ejemplo usual del arpegio, el
1775 valor de la propiedad @code{direction} especifica si el objeto se debe
1776 colocar a la izquierda o a la derecha del objeto padre. En este caso
1777 @code{-1} ó @code{LEFT} significan @qq{a la izquierda} y @code{1} ó
1778 @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
1779 significan @qq{utilizar la dirección predeterminada}, como antes.
1782 @node Distances and measurements
1783 @subsection Distances and measurements
1785 @cindex distances, absolute
1786 @cindex distances, scaled
1793 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
1795 Las distancias absolutas se usan para especificar márgenes, sangrados
1796 y otros detalles de diseño de página, y de forma predeterminada se
1797 especifican en milímetros. Las distancias se pueden especificar en
1798 otras unidades escribiendo después de la cifra indicativa de la
1799 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
1800 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
1801 de página se pueden especificar también en unidades escalables (véase
1802 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
1803 La disposición de página se describe en detalle en @ref{Page
1806 Las distancias escaladas siempre se especifican en unidades de un
1807 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
1808 El espacio de pentagrama es la distancia entre dos líneas del
1809 pentagrama adyacentes. El valor predeterminado se puede cambiar
1810 globalmente fijando el tamaño global del pentagrama, o se puede
1811 sobreescribir localmente cambiando la propiedad @code{staff-space} del
1812 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
1813 automáticamente con cualquier cambio al tamaño global del pentagrama o
1814 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
1815 las fuentes tipográficas se escalan solamente con los cambios
1816 efectuados al tamaño global del pentagrama. Así, el tamaño global del
1817 pentagrama posibilita la fácil variación del tamaño general de una
1818 partitura impresa. Para ver los métodos de establecimiento del tamaño
1819 global del pentagrama, véase @ref{Setting the staff size}.
1823 Si se necesita dibujar sólo una sección de una partitura a una escala
1824 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
1825 simplemente cambiar el tamaño global del pentagrama porque esto
1826 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
1827 hace sobreescribiendo tanto la propiedad @code{staff-space} de
1828 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
1829 nuestra disposición una función de Scheme, @code{magstep}, para
1830 convertir de un cambio en el tamaño de la fuente al cambio equivalente
1831 en @code{staff-space}. Para ver una explicación y un ejemplo de su
1832 utilización, consulte @rlearning{Length and thickness of objects}.
1836 Manual de aprendizaje:
1837 @rlearning{Length and thickness of objects}.
1839 Referencia de la notación:
1840 @ref{Page formatting},
1841 @ref{Setting the staff size}.
1844 @node Staff symbol properties
1845 @subsection Staff symbol properties
1847 @cindex ajuste del símbolo del pentagrama
1848 @cindex dibujar el símbolo del pentagrama
1849 @cindex pentagrama, establecer el símbolo del
1851 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
1852 @c Need to think of uses for these properties. Eg 'line-positions
1853 @c is used in a snippet to thicken centre line.
1854 @c If retained, add @ref to here in 1.6.2 -td
1856 Se puede definir al mismo tiempo la posición vertical de las líneas de
1857 la pauta y el número de líneas de la misma. Como muestra el siguiente
1858 ejemplo, las posiciones de las notas no están influidas por las
1859 posiciones de las líneas de la pauta.
1861 @warning{La propiedad @code{'line-positions} sobreescribe a la
1862 propiedad @code{'line-count}. El número de líneas de la pauta está
1863 definido implícitamente por el número de elementos de la lista de
1864 valores de @code{'line-positions}.}
1866 @lilypond[verbatim,quote,relative=1]
1868 \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
1873 Se puede modificar la anchura de la pauta. Las unidades son espacios
1874 de pentagrama. El espaciado de los objetos dentro del pentagrama no
1875 resulta afectado por este ajuste.
1877 @lilypond[verbatim,quote,relative=1]
1879 \override StaffSymbol #'width = #23
1886 @subsection Spanners
1888 Muchos objetos de notación musical abarcan varias notas o incluso
1889 varios compases. Son ejemplos los crescendi, trinos, corchetes de
1890 grupo especial y corchetes de primera y segunda vez. Estos objetos se
1891 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
1892 especiales para controlar su apariencia y comportamiento. Algunas de
1893 estas propiedades son comunes a todos los objetos de extensión; otras
1894 se limitan a un subconjunto de los extensores.
1896 Todos los objetos de extensión contemplan el interface
1897 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
1898 una línea recta entre los dos objetos, contemplan también el interface
1899 @code{line-spanner-interface}.
1901 @unnumberedsubsubsec Using the @code{spanner-interface}
1903 Este interface proporciona dos propiedades que se aplican a varios
1906 @strong{@i{La propiedad @code{minimum-length}}}
1908 La longitud mínima del objeto de extensión se pesoecifica a través de
1909 la propiedad @code{minimum-length}. Su aumento suele producir el
1910 efecto necesario de aumentar el espaciado de las notas entre los dos
1911 puntos extremos. Sin embargo, esta sobreescritura no tiene ningún
1912 efecto sobre muchos extensores, pues su longitud está determinada por
1913 otras consideraciones. Más abajo se muestran algunos ejemplos de
1924 Works as long as callback is made:
1928 Works not at all for:
1937 @lilypond[verbatim,quote,relative=2]
1940 % increase the length of the tie
1941 -\tweak #'minimum-length #5
1945 @lilypond[verbatim,quote,relative=2]
1947 \compressFullBarRests
1949 % increase the length of the rest bar
1950 \once \override MultiMeasureRest #'minimum-length = #20
1955 @lilypond[verbatim,quote,relative=2]
1957 % increase the length of the hairpin
1958 \override Hairpin #'minimum-length = #20
1962 Esta sobreescritura se puede usar también para aumentar la longitud de
1963 las ligaduras de expresión y de fraseo:
1965 @lilypond[verbatim,quote,relative=2]
1968 -\tweak #'minimum-length #5
1973 -\tweak #'minimum-length #5
1977 Para algunos objetos de preesentación, la propiedad
1978 @code{minimum-length} es efectiva sólo si se llama explícitamente al
1979 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
1980 propiedad @code{springs-and-rods} al valor
1981 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
1982 de un glissando no tiene efecto a no ser que se establezca la
1983 propiedad @code{springs-and-rods}:
1985 @lilypond[verbatim,quote,relative=1]
1989 % not effective alone
1990 \once \override Glissando #'minimum-length = #20
1993 % effective only when both overrides are present
1994 \once \override Glissando #'minimum-length = #20
1995 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
1999 Lo mismo se puede decir del objeto @code{Beam}:
2001 @lilypond[verbatim,quote,relative=1]
2002 % not effective alone
2003 \once \override Beam #'minimum-length = #20
2006 % effective only when both overrides are present
2007 \once \override Beam #'minimum-length = #20
2008 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2012 @strong{@i{The @code{to-barline} property}}
2014 La segunda propiedad útil del @code{spanner-interface} es
2015 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2016 haciendo que los reguladores y otros objetos de extensión que terminan
2017 sobre la primera nota de un compás, en vez de eso terminen en la línea
2018 divisoria inmediatamente precedente. Si se establece al valor falso,
2019 el extensor llegará más allá de la barra de compás y terminará
2020 excatamente sobre la nota:
2022 @lilypond[verbatim,quote,relative=2]
2023 a \< a a a a \! a a a \break
2024 \override Hairpin #'to-barline = ##f
2025 a \< a a a a \! a a a
2028 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
2029 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2030 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2031 que terminar en la barra de compás no tendría ningún significado.
2033 @unnumberedsubsubsec Using the @code{line-spanner-interface}
2035 Entre los objetos que contemplan el interface
2036 @code{line-spanner-interface} se encuentran
2039 @item @code{DynamicTextSpanner}
2040 @item @code{Glissando}
2041 @item @code{TextSpanner}
2042 @item @code{TrillSpanner}
2043 @item @code{VoiceFollower}
2046 La rutina responsable de dibujar los sellos de estos extensores es
2047 @code{ly:line-interface::print}. esta rutina determina la
2048 localización exacta de los dos puntos extremos y traza una línea entre
2049 ellos, en el estilo solicitado. Las posiciones de los dos puntos
2050 extremos del extensor se calculan al vuelo, pero es posible
2051 sobreescribir sus coordenadas Y. Las propiedades que se deben
2052 especificar están anidadas a dos niveles de profundidad en la
2053 jerarquía de propiedades, pero la sintaxis de la instrucción
2054 @code{\override} es bastante sencilla:
2056 @lilypond[relative=2,quote,verbatim]
2058 \once \override Glissando #'(bound-details left Y) = #3
2059 \once \override Glissando #'(bound-details right Y) = #-2
2063 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2064 siendo el punto del cero la línea central del pentagrama. Para el
2065 glissando, esto es el valor de @code{Y} en la coordenada X que
2066 corresponde al punto central de cada cabeza de nota si nos imaginamos
2067 que la línea se extiende hasta allí.
2069 Si no está fijado @code{Y}, su valor se calcula a partir de la
2070 posición vertical del punto de anclaje correspondiente del extensor.
2072 En caso de salto de línea, los valores para los puntos extremos se
2073 especifican por las sub-listas @code{left-broken} y
2074 @code{right-broken} de @code{bound-details}. Por ejemplo:
2076 @lilypond[relative=2,ragged-right,verbatim,fragment]
2077 \override Glissando #'breakable = ##t
2078 \override Glissando #'(bound-details right-broken Y) = #-3
2079 c1 \glissando \break
2083 Un número de propiedades adicionales de las sub-listas @code{left} y
2084 @code{right} de la propiedad @code{bound-details} se pueden
2085 especificar de la misma forma que @code{Y}:
2089 Establece la coordenada Y del punto extremo, en desplazamientos de
2090 @code{staff-space}s desde la línea central del pentagrama. De forma
2091 predeterminada es el centro del objeto ancla, y así un glissando
2092 apunta al centro vertical de la cabeza de la nota.
2094 Para extensores horizontales como los extensores de texto y los
2095 trinos, está inamoviblemente codificado como 0.
2097 @item attach-dir (dirección de anclaje)
2098 Determina dónde comienza y termina la línea en la dirección X, con
2099 relación al objeto ancla. Sí, un valor de @code{-1} (o @code{LEFT},
2100 izquierda) hace que la línea comienze o termine en el lado izquierdo
2101 de la cabeza de la nota a la que está anclado.
2104 Es la coordenada X absoluta del punto extremo. Se suele calcular al
2105 vuelo, y su sobreescritura no tiene un efecto útil.
2107 @item stencil (sello)
2108 Los extensores de línea pueden tener símbolos al comienzo o al final,
2109 lo que está contenido en esta sub-propiedad. Esto es para uso
2110 interno; se recomienda en su lugar el uso de @code{text}.
2113 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
2114 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2115 de extensión horizontales.
2117 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2118 \override TextSpanner #'(bound-details left text)
2119 = \markup { \small \bold Slower }
2120 c2\startTextSpan b c a\stopTextSpan
2123 @item stencil-align-dir-y (alineación del sello en y)
2124 @item stencil-offset (desplazamiento del sello)
2125 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2126 punto extremo, centrado sobrer la línea, como viene definido por las
2127 subpropiedades @code{X} e @code{Y}. Si se fijan
2128 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2129 símbolo del borde verticalmente con relación al extremo de la línea:
2131 @lilypond[relative=1,fragment,verbatim]
2132 \override TextSpanner
2133 #'(bound-details left stencil-align-dir-y) = #-2
2134 \override TextSpanner
2135 #'(bound-details right stencil-align-dir-y) = #UP
2137 \override TextSpanner
2138 #'(bound-details left text) = #"ggg"
2139 \override TextSpanner
2140 #'(bound-details right text) = #"hhh"
2141 c4^\startTextSpan c c c \stopTextSpan
2144 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2145 al contrario de lo que podríoa esperarse, pues el valor de @code{-1} o
2146 @code{DOWN} (abajo) significa alinear el bborde @emph{inferior} del
2147 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
2148 (arriba) alinea el borde superior del texto con la línea extensora.
2150 @item arrow (flecha)
2151 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
2152 flecha en el extremo de la línea.
2154 @item padding (relleno)
2155 Esta sub-propiedad controla el espacio entre el punto extremo
2156 especificado de la línea y el extremo real. Sin relleno, un glissando
2157 empezaría y terminaría en el centro de la cabeza de las notas.
2161 La función musical @code{\endSpanners} finaliza de forma prematura el
2162 extensor que comienza sobre la nota que sigue inmediatamente a
2163 continuación. Se termina después de una nota exactamente, o en la
2164 siguiente barra de compás si @code{to-barline} es verdadero y se
2165 produce una divisoria antes de la siguiente nota.
2167 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
2169 c2 \startTextSpan c2 c2
2174 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
2175 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
2179 Referencia de funcionamiento interno:
2180 @rinternals{TextSpanner},
2181 @rinternals{Glissando},
2182 @rinternals{VoiceFollower},
2183 @rinternals{TrillSpanner},
2184 @rinternals{line-spanner-interface}.
2187 @node Visibility of objects
2188 @subsection Visibility of objects
2190 @cindex objetos, visibilidad de
2191 @cindex grobs, visibilidad de
2192 @cindex visibilidad de los objetos
2194 Hay cuatro formas principales en que se puede controlar la visibilidad
2195 de los objetos de presentación: se puede eliminar su sello, se pueden
2196 volver transparentes, se pueden pintar de blanco, o se puede
2197 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
2198 se aplican a todos los objetos de presentación; la última sólo a unos
2199 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
2200 introduce estas cuatro técnicas, véase @rlearning{Visibility and color
2203 Hay también algunas otras técnicas que son específicas de ciertos
2204 objetos de presentación. Se estudian bajo Consideraciones especiales.
2207 * Removing the stencil::
2208 * Making objects transparent::
2209 * Painting objects white::
2210 * Using break-visibility::
2211 * Special considerations::
2215 @node Removing the stencil
2216 @unnumberedsubsubsec Removing the stencil
2218 @cindex sello, eliminar
2220 Todo objeto de presentación tiene una propiedad stencil (sello). De
2221 forma predeterminada está establecida a la función específica que
2222 dibuja ese objeto. Se se sobreescribe eesta propiedad a @code{#f} no
2223 se llama a ninguna función y el objeto no se dibuja. La acción
2224 predeterminada se puede recuperar con @code{\revert}.
2226 @lilypond[quote,verbatim,relative=1]
2228 \override Score.BarLine #'stencil = ##f
2230 \revert Score.BarLine #'stencil
2234 @node Making objects transparent
2235 @unnumberedsubsubsec Making objects transparent
2237 @cindex transparentes, hacer los objetos
2239 Todo objeto de presentación tiene una propiedad transparent
2240 (transparente) que de forma predeterminada está establecida a
2241 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
2244 @lilypond[quote,verbatim,relative=2]
2246 \once \override NoteHead #'transparent = ##t
2250 @node Painting objects white
2251 @unnumberedsubsubsec Painting objects white
2253 @cindex objetos, coloreado de
2254 @cindex coloreado de objetos
2256 @cindex impresión, orden de
2257 @cindex sobreescritura de objetos
2258 @cindex objetos, sobreescritura de
2259 @cindex grobs, sobreescritura de
2261 Todo objeto de presentación tiene una propiedad de color que de forma
2262 predeterminada está establecida a @code{black} (negro). Si se
2263 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
2264 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
2265 color de los puntos de cruce queda determinado por el orden en que se
2266 dibujan estos objetos, lo que puede dejar una imagen fantasma del
2267 objeto blanco, como puede verse aquí:
2269 @lilypond[quote,verbatim,relative=2]
2270 \override Staff.Clef #'color = #white
2274 Se puede evitar esto cambiando el orden de impresión de los objetos.
2275 Todos los objetos de presentación tienen una propiedad @code{layer}
2276 (capa) que se debe establecer a un valor entero. Los objetos con el
2277 valor de @code{layer} más bajo se dibujan primero, después se dibujan
2278 los objetos con valores progresivamente mayores, y así los objetos con
2279 valores más altos se dibujan encima de los que tienen valores más
2280 bajos. De forma predeterminada, casi todos los objetos tienen
2281 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
2282 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
2283 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
2284 impresión de los objetos con el mismo valor de @code{layer} es
2287 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
2288 predeterminado de @code{1}, se dibuja después de las líneas del
2289 pentragrama (valor @code{layer} predeterminado de @code{0}),
2290 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
2291 @code{Clef} un valor de @code{layer} más bajo, digamos @code{-1}, para
2292 que se dibuje antes:
2294 @lilypond[quote,verbatim,relative=2]
2295 \override Staff.Clef #'color = #white
2296 \override Staff.Clef #'layer = #-1
2300 @node Using break-visibility
2301 @unnumberedsubsubsec Using break-visibility
2303 @c TODO Add making other objects breakable
2305 @cindex break-visibility
2307 Casi todos los objetos de presentación se imprimen una sola vez, pero
2308 algunos como las líneas divisorias, claves, indicaciones de compás y
2309 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
2310 se produce un salto de línea : una vez al final de la línea y otra al
2311 comienzo de la siguiente. Estos objetos reciben el nombre de
2312 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
2313 (visibilidad en el salto), para controlar su visibilidad en las tres
2314 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
2315 la línea si se produce un cambio, y al final de la línea si el cambio
2316 se produce en ese lugar.
2318 Por ejemplo, la indicación de compás se imprime de forma
2319 predeterminada al comienzo de la primera línea y en ningún otro lugar
2320 a no ser que cambie, en cuyo caso se imprime en el punto en que se
2321 produce el cambio. Si este cambio se produce al final de una línea,
2322 la nueva indicación de compás se imprime al principio de la línea
2323 siguiente y también al final de la línea anterior como indicación de
2326 Este comportamiento se controla por medio de la propiedad
2327 @code{break-visibility}, que se explica en
2328 @c Leave this ref on a newline - formats incorrectly otherwise -td
2329 @rlearning{Visibility and color of objects}. Esta propiedad toma un
2330 vector de tres valores booleanos que, por orden, determinan si el
2331 objeto se imprime al final, dentro, o al principio de la línea. O,
2332 para ser más exactos: antes del salto de línea, si no hay salto, o
2335 Como alternativa se puede especificar cualquiera de las ocho
2336 combinaciones mediante funciones predefinidas cuya definición está en
2337 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
2338 los objetos de presentación serán visibles en las posiciones que se
2339 muestran en el encabezamiento de cada columna:
2341 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {yes} {yes} {yes}
2342 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
2343 @headitem de función @tab de vector @tab salto @tab salto @tab salto
2345 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
2346 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
2347 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
2348 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
2349 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
2350 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
2351 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
2352 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
2355 Los ajustes predeterminados de @code{break-visibility} dependen del
2356 objeto de presentación. La tabla siguiente muestra todos los objetos
2357 de presentación de interés que resultan afectados por
2358 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
2360 @multitable @columnfractions .3 .3 .4
2362 @headitem Objeto @tab Contexto usual @tab Valor predet.
2364 @c omit Ambitus as it appears not to be affected by break-visibility -td
2365 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
2366 @item @code{BarLine} @tab @code{Score} @tab calculado
2367 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
2368 @c omit the following item until it can be explained -td
2369 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculated
2370 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2371 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
2372 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
2373 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2374 @c omit KeyCancellation until it can be explained -td
2375 @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible}
2376 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
2377 @c omit LeftEdge until it can be explained -td
2378 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
2379 @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible}
2380 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
2381 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
2385 El ejemplo de abajo muestra el uso de la forma de vector para
2386 controlar la visibilidad de las líneas divisorias:
2388 @lilypond[quote,verbatim,relative=1,ragged-right]
2391 % Remove bar line at the end of the current line
2392 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
2398 Aunque los tres componentes del vector utilizado para sobreescribir
2399 @code{break-visibility} deben estar presentes, no todos son efectivos
2400 para todos los objetos de presentación, y algunas combinaciones pueden
2401 incluso dar errores. Son de aplicación las siguientes limitaciones:
2404 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
2405 @item No se puede imprimir el número de compás al principio de la primera
2406 línea a no ser que su valor establecido sea distinto de 1.
2407 @item Clave: véase más abajo
2408 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
2409 se suprimen por completo. Utilice begin-of line-invisible para
2410 imprimirlas y all-invisible para suprimirlas.
2411 @item Armadura: véase más abajo
2412 @item OctavateEight: véase más abajo
2415 @node Special considerations
2416 @unnumberedsubsubsec Special considerations
2418 @strong{@emph{Visibilidad después de un cambio explícito}}
2420 @cindex armadura, visibilidad después de un cambio explícito
2421 @cindex explicitKeySignatureVisibility
2422 @cindex clave, visibilidad después de un cambio explícito
2423 @cindex explicitClefVisibility
2425 La propiedad @code{break-visibility} controla la visibilidad de las
2426 armaduras y cambios de clave sólo al principio de las líneas, es
2427 decir, después de un salto. No tiene ningún efecto sobre la
2428 visibilidad de la armadura o la clave después de un cambio explícito
2429 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
2430 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
2431 bemol mayor es visible incluso con @code{all-invisible} establecido.
2433 @lilypond[quote,verbatim,relative=1,ragged-right]
2436 % Try to remove all key signatures
2437 \override Staff.KeySignature #'break-visibility = #all-invisible
2445 La visibilidad de estos cambios explícitos de tonalidad y de clave se
2446 controla por medio de las propiedades
2447 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
2448 Son los equivalentes de la propiedad @code{break-visibility} y las dos
2449 toman un vector de tres valores booleanos o las funciones predefinidas
2450 relacionadas anteriormente, exactamente igual que
2451 @code{break-visibility}. Las dos son propiedades del contexto Staff,
2452 no de los propios objetos de presentación, y por tanto se establecen
2453 utilizando la instrucción @code{\set}. Las dos están establecidas de
2454 forma predeterminada al valor @code{all-visible}. Estas propiedades
2455 controlan sólo la visibilidad de las armaduras y las claves que
2456 resultan de los cambios explícitos y no afectan a las armaduras y
2457 tonalidades que están al principio de las líneas; para quitarlas, aún
2458 se debe sobreescribir la propiedad @code{break-visibility} en el
2459 objeto correspondiente.
2461 @lilypond[quote,verbatim,relative=1,ragged-right]
2464 \set Staff.explicitKeySignatureVisibility = #all-invisible
2465 \override Staff.KeySignature #'break-visibility = #all-invisible
2472 @strong{@emph{Visibilidad de las alteraciones de precaución}}
2474 Para eliminar las alteraciones de precaución que se imprimen en un
2475 cambio de tonalidad explícito, establezca la propiedad
2476 @code{printKeyCancellation} del contexto Staff a @code{#f}:
2478 @lilypond[quote,verbatim,relative=1,ragged-right]
2481 \set Staff.explicitKeySignatureVisibility = #all-invisible
2482 \set Staff.printKeyCancellation = ##f
2483 \override Staff.KeySignature #'break-visibility = #all-invisible
2490 Con estas sobreescrituras solamente permanecen las alteraciones
2491 accidentales delante de las notas para indicar el cambio de tonalidad.
2493 @c TODO Add visibility of cautionary accidentals before notes
2495 @strong{@emph{Automatic bars}}
2497 @cindex automaticBars
2498 @cindex líneas divisorias, eliminación
2500 Como caso especial, la impresión de las líneas divisorias también se
2501 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
2502 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
2503 imprimen automáticamente; se deben crear explícitamente con una
2504 instrucción @code{\bar}. A diferencia de la instrucción predefinida
2505 @code{\cadenzaOn}, los compases se siguen contando. La generación de
2506 compases continúa de acuerdo a esta cuenta si esta propiedad se
2507 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
2508 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
2513 @strong{@emph{Octavated clefs}}
2515 @cindex octavadas, visibilidad de las claves
2516 @cindex visibilidad de las claves octavadas
2517 @cindex claves, visibilidad de la octavación
2519 El pequeño símbolo de octava sobre las claves en octava alta o baja se
2520 produce por parte del objeto @code{OctavateEight}. Su visibilidad se
2521 controla independientemente de la del objeto @code{Clef}, así que es
2522 necesario aplicar las sobreescrituras correspondientes
2523 @code{break-visibility} tanto a los objetos @code{Clef} como
2524 @code{OctavateEight} para suprimir completamente estos símbolos de
2525 clave al comienzo de cada línea.
2527 Para los cambios de clave explícitos, la propiedad
2528 @code{explicitClefVisibility} controla tanto el símbolo de clave como
2529 el símbolo de octava asociado.
2533 Manual de aprendizaje:
2534 @rlearning{Visibility and color of objects}
2538 @subsection Line styles
2540 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
2541 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
2542 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
2544 Todos ellos usan las mismas rutinas que el glissando para dibujar los
2545 textos y las líneas, y por ello el ajuste fino de su comportamiento se
2546 hace de la misma manera. Se hace con un spanner (un objeto de
2547 extensión), y la rutina responsable de dibujar los objetos de
2548 extensión es @code{ly:line-interface::print}. Esta rutina determina la
2549 colocación exacta de los dos @i{extremos del objeto de extensión} y
2550 dibuja una línea entre ellos, en el estilo solicitado.
2552 He aquí un ejemplo de los distintos estilos de línea disponibles, y
2553 cómo aplicarles ajustes finos.
2555 @lilypond[relative=2,ragged-right,verbatim,fragment]
2557 \once \override Glissando #'style = #'dashed-line
2559 \override Glissando #'style = #'dotted-line
2561 \override Glissando #'style = #'zigzag
2563 \override Glissando #'style = #'trill
2567 Las posiciones de los puntos extremos del objeto de extensión se
2568 computan al vuelo para cada uno de los objetos gráficos, pero es
2569 posible sobreescribirlos:
2571 @lilypond[relative=2,ragged-right,verbatim,fragment]
2573 \once \override Glissando #'(bound-details right Y) = #-2
2577 El valor de @code{Y} está establecido a @code{-2} para el extremo
2578 derecho. El lado izquierdo se puede ajustar de forma similar
2579 especificando @code{left} en vez de @code{right}.
2581 Si no está establecido @code{Y}, el valor se computa a partir de la
2582 posición vertical de los puntos de anclaje izquierdo y derecho del
2585 Son posibles otros ajustes de los extensores, para ver más detalles
2586 consulte @ref{Spanners}.
2589 @node Rotating objects
2590 @subsection Rotating objects
2592 Tanto los objetos de presentación como los elementos de texto de
2593 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
2594 pero difiere el método de hacerlo.
2597 * Rotating layout objects::
2601 @node Rotating layout objects
2602 @unnumberedsubsubsec Rotating layout objects
2604 @cindex rotating objects
2605 @cindex objects, rotating
2607 Todos los objetos de presentación que contemplan el interface
2608 @code{grob-interface} se pueden rotar estableciendo su propiedad
2609 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
2610 rotación en sentido antihorario, y las coordenadas x e y del punto con
2611 relación al punto de referencia del objeto, alrededor del que se va a
2612 realizar la rotación. El ángulo de rotación se pespecifica en grados
2613 y las coordenadas en espacios de pentagrama.
2615 El ángulo de rotación y las coordenadas del punto de rotación se deben
2616 determinar por ensayo y error.
2618 @cindex reguladores en ángulo
2619 @cindex ángulo, reguladores en
2621 Solamente en ciertas ocasiones es útil la rotación de objetos de
2622 presentación; el ejemplo siguiente muestra una situación en que puede
2625 @lilypond[quote,verbatim,relative=1]
2627 \override Hairpin #'rotation = #'(20 -1 0)
2631 @node Rotating markup
2632 @unnumberedsubsubsec Rotating markup
2634 Todos los textos de marcado se pueden rotar para que se dispongan en
2635 cualquier ángulo predeciéndolos de la instrucción @code{\rotate}. La
2636 instrucción acepta dos argumentos: el ángulo de rotación en grados en
2637 sentido antihorario, y el texto que rotar. Los límites que ocupa el
2638 texto no se rotan: toman su valor a partir de los extremos de las
2639 coordenadas x e y del texto rotado. En el ejemplo siguiente la
2640 propiedad @code{outside-staff-priority} del texto se establece a
2641 @code{#f} para desactivar la evitación automática de colisiones, lo
2642 que empuja al texto a una posición muy alta.
2644 @lilypond[quote,verbatim,relative=1]
2645 \override TextScript #'outside-staff-priority = ##f
2646 g4^\markup { \rotate #30 "a G" }
2647 b^\markup { \rotate #30 "a B" }
2648 des^\markup { \rotate #30 "a D-Flat" }
2649 fis^\markup { \rotate #30 "an F-Sharp" }
2652 @node Advanced tweaks
2653 @section Advanced tweaks
2655 Esta sección trata sobre distintos enfoques en la realización de
2656 ajustes finos a la apariencia de la partitura impresa.
2659 * Aligning objects::
2660 * Vertical grouping of grobs::
2661 * Modifying stencils::
2662 * Modifying shapes::
2667 Manual de aprendizaje:
2668 @rlearning{Tweaking output},
2669 @rlearning{Other sources of information}.
2671 Referencia de la notación:
2672 @ref{Explaining the Internals Reference},
2673 @ref{Modifying properties},
2674 @ref{Interfaces for programmers}.
2677 @file{scm/@/define@/-grobs@/.scm}.
2679 Fragmentos de código:
2680 @rlsr{Tweaks and overrides}.
2682 Referencia de funcionamiento interno:
2683 @rinternals{All layout objects}.
2686 @node Aligning objects
2687 @subsection Aligning objects
2689 Los objetos gráficos que soportan el interface
2690 @code{self-alignment-interface} y/o el @code{side-position-interface}
2691 se pueden alinear contra un objeto colocado previamente, de diversas
2692 maneras. Para ver una lista de estos objetos, consulte
2693 @rinternals{self-alignment-interface} y
2694 @rinternals{side-position-interface}.
2696 Todos los objetos gráficos tienen un punto de referencia, una
2697 extensión horizontal y una extensión vertical. La extensión
2698 horizontal es una pareja de números que dan los desplazamientos a
2699 partir del punto de referencia de los bordes izquierdo y derecho,
2700 siendo negativos los desplazamientos hacia la izquierda. La extensión
2701 vertical es una pareja de números que dan el desplazamiento a partir
2702 del punto de referencia hasta los bordes inferior y superior, siendo
2703 negativos los deplazamientos hacia abajo.
2705 La posición de un objeto sobre el pentagrama viene dada por los
2706 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
2707 valor de @code{X-offset} da el desplazamiento desde la coordenada x
2708 del punto de referencia del objeto padre, y el valor de
2709 @code{Y-offset} da el desplazamiento a partir de la línea central del
2710 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
2711 pueden establecer directamente o se puede dejar que se calculen por
2712 parte de procedimientos para conseguir una alineación con el objeto
2713 padre de distintas maneras.
2715 @warning{Muchos objetos tienen consideraciones de posicionamiento
2716 especiales que hacen que se ignore o se modifique cualquier ajuste
2717 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
2718 objeto contemple el interface @code{self-alignment-interface}.}
2720 Por ejemplo, una alteración accidental se puede reposicionar
2721 verticalmente estableciendo @code{Y-offset} pero los cambios a
2722 @code{X-offset} no tienen ningún efecto.
2724 Las letras de ensayo se pueden alinear con objetos divisibles como
2725 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
2726 propiedades especiales que se encuentran en
2727 @code{break-aligned-interface} para el posicionamiento de las letras
2728 de ensayo sobre dichos objetos.
2731 * Setting @code{X-offset} and @code{Y-offset} directly::
2732 * Using the @code{side-position-interface}::
2733 * Using the @code{self-alignment-interface}::
2734 * Using the @code{break-alignable-interface}::
2737 @node Setting @code{X-offset} and @code{Y-offset} directly
2738 @unnumberedsubsubsec Setting @code{X-offset} and @code{Y-offset} directly
2740 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
2741 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
2742 notas con una digitación en su posición predeterminada y con los
2743 valores @code{X-offset} y @code{Y-offset} modificados.
2745 @lilypond[verbatim,quote,relative=2]
2748 -\tweak #'X-offset #0
2749 -\tweak #'Y-offset #0
2752 -\tweak #'X-offset #-1
2753 -\tweak #'Y-offset #1
2759 @node Using the @code{side-position-interface}
2760 @unnumberedsubsubsec Using the @code{side-position-interface}
2762 Un objeto que contempla el @code{side-position-interface} se puede
2763 colocar junto a su objeto padre de forma que los bordes especificados
2764 de los dos objetos se toquen. El objeto se puede situar encima,
2765 debajo, a la derecha o a la izquierda del objeto padre. El padre no
2766 se puede especificar; ciene determinado por el orden de los elementos
2767 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
2768 nota asociada como padre.
2770 Los valores de las propiedades @code{side-axis} y @code{direction}
2771 determinan dónde colocar el objeto, como sigue:
2773 @c TODO add an example of each to the table
2775 @multitable @columnfractions .3 .3 .3
2776 @headitem @code{side-axis} @tab @code{direction} @tab
2777 @headitem propiedad @tab propiedad @tab colocación
2779 @item @code{0} @tab @code{-1} @tab izquierda
2780 @item @code{0} @tab @code{1} @tab derecha
2781 @item @code{1} @tab @code{-1} @tab debajo
2782 @item @code{1} @tab @code{1} @tab encima
2786 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
2787 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
2788 procedimiento devuelve el calor correcto de @code{X-offset} para
2789 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
2790 el valor de @code{direction}.
2792 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
2793 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
2794 procedimiento devuelve el valor correcto de @code{Y-offset} para
2795 situar el objeto encima o debajo del padre de acuerdo con el valor de
2798 @c TODO Add examples
2800 @node Using the @code{self-alignment-interface}
2801 @unnumberedsubsubsec Using the @code{self-alignment-interface}
2803 @emph{Auto-alineación horizontal de los objetos}
2805 La alineación horizontal de un objeto que contempla el interface
2806 @code{self-alignment-interface} está controlada por el valor de la
2807 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
2808 @code{X-offset} de este objeto esté establecida a
2809 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
2810 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
2811 mitad de la extensión X total del objeto. Los valores negativos
2812 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
2813 valor de @code{0} centra el objeto sobre el punto de referencia de su
2814 padre, un valor de @code{-1} alinea el borde izquierdo del objeto
2815 sobre el punto de referencia de su padre, y un valor de @code{1}
2816 alinea el borde derecho del objeto sobre el punto de referencia de su
2817 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
2818 @code{RIGHT} en sustitución de los valores @code{-1, 0, 1},
2821 Normalmente se usaría la instrucción @code{\override} para modificar
2822 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
2823 @code{\tweak} para alinear varias anotaciones por separado sobre una
2826 @lilypond[quote,verbatim,relative=1]
2828 -\tweak #'self-alignment-X #-1
2830 -\tweak #'self-alignment-X #0
2832 -\tweak #'self-alignment-X #RIGHT
2834 -\tweak #'self-alignment-X #-2.5
2835 ^"aligned further to the right"
2838 @emph{Auto-alineación vertical de los objetos}
2840 Los objetos se pueden alinear verticalmente en una forma análoga a la
2841 alineación horizontal si la propiedad @code{Y-offset} está establecida
2842 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
2843 a menudo se encuentran implicados otros mecanismos en la alineación
2844 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
2845 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
2846 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
2847 las dimensiones verticales del objeto, que suele ser bastante pequeño,
2848 por lo que pueden requerirse números bastante grandes. Un valor de
2849 @code{-1} alinea el borde inferior del objeto con el punto de
2850 referencia del objeto padre, un valor de @code{0} alinea el centro del
2851 objeto con el punto de referencia del padre, y un valor de @code{1}
2852 alinea el borde superior del objeto con el punto de referencia del
2853 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
2854 @code{UP} en sustitución de @code{-1, 0, 1} respectivamente.
2856 @emph{Auto-alineación de objetos en las dos direcciones}
2858 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
2859 alinear un objeto en las dos direcciones simultáneamente.
2861 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
2862 se acerque a la cabeza de la nota.
2864 @lilypond[quote,verbatim,relative=2]
2866 -\tweak #'self-alignment-X #0.5 % move horizontally left
2867 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
2868 -\tweak #'self-alignment-Y #-1 % move vertically up
2873 @unnumberedsubsubsec Using the @code{aligned-on-parent} procedures
2875 @c Cannot document as they do not seem to operate consistently on all objects -td
2876 @c TODO investigate further
2878 The @code{aligned-on-parent} procedures are used in the same way
2879 as the @code{aligned-on-self} procedures, they difference being
2880 that they permit an object to be aligned with the @emph{edges} of
2881 the parent rather than the parent's reference point. The following
2882 example shows the difference:
2886 @lilypond[verbatim,quote]
2892 @unnumberedsubsubsec Using the @code{centered-on-parent} procedures
2894 @c Cannot document as they do not seem to operate consistently on all objects -td
2895 @c TODO investigate further
2899 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
2902 @node Using the @code{break-alignable-interface}
2903 @unnumberedsubsubsec Using the @code{break-alignable-interface}
2905 @cindex alineación a objetos
2906 @cindex break-align-symbols
2908 Las letras de ensayo se pueden alinear con objetos de notación
2909 distintos a las barras de compás. Estos objetos son @code{ambitus},
2910 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
2911 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
2912 @code{time-signature}.
2914 De forma predeterminada, las letras de ensayo y los números de compás
2915 se centran horizontalmente sobre el objeto:
2917 @lilypond[verbatim,quote,relative=1]
2919 % the RehearsalMark will be centered above the Clef
2920 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
2925 % the RehearsalMark will be centered above the TimeSignature
2926 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
2934 Se puede especificar una lista de posibles objetos para la alineación.
2935 Si algunos de los objetos son invisibles en ese punto debido al valor
2936 de @code{break-visibility} o a valores de visibilidad explícitos para
2937 las armaduras y las claves, la letra de ensayo o número de compás se
2938 alinean con el primer objeto de la lista que sea visible. Si ningún
2939 objeto de la lista es visible, el objeto se alinea con la línea
2940 divisoria. Si la línea divisoria es invisible, el objeto se alinea
2941 con el punto en el que se encontraría la línea divisoria.
2943 @lilypond[verbatim,quote,relative=1]
2945 % the RehearsalMark will be centered above the Key Signature
2946 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
2951 % the RehearsalMark will be centered above the Clef
2952 \set Staff.explicitKeySignatureVisibility = #all-invisible
2953 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
2960 La alineación de la letra de ensayo con relación al objeto de notación
2961 se puede cambiar, como se ve en el ejemplo siguiente. En una
2962 partitura con varios pentagramas, este ajuste se debe hacer para todos
2965 @lilypond[verbatim,quote,relative=1]
2966 % The RehearsalMark will be centered above the KeySignature
2967 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
2973 % The RehearsalMark will be aligned with the left edge of the KeySignature
2974 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
2978 % The RehearsalMark will be aligned with the right edge of the KeySignature
2979 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
2985 La letra de ensayo también se puede desplazar al borde derecho o
2986 izquierdo en una medida arbitraria. Las unidades son espacios de
2989 @lilypond[verbatim,quote,relative=1]
2990 % The RehearsalMark will be aligned with the left edge of the KeySignature
2991 % and then shifted right by 3.5 staff-spaces
2992 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
2993 \once \override Score.KeySignature #'break-align-anchor = #3.5
2997 % The RehearsalMark will be aligned with the left edge of the KeySignature
2998 % and then shifted left by 2 staff-spaces
2999 \once \override Score.KeySignature #'break-align-anchor = #-2
3006 @node Vertical grouping of grobs
3007 @subsection Vertical grouping of grobs
3009 Los grobs (objetos gráficos) @code{VerticalAlignment} y
3010 @code{VerticalAxisGroup} trabajan de manera coordinada.
3011 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
3012 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
3013 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
3014 Normalmente sólo existe un @code{VerticalAlignment} por cada
3015 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
3016 @code{VerticalAxisGroup}.
3019 @node Modifying stencils
3020 @subsection Modifying stencils
3022 Todos los objetos de presentación tienen una propiedad @code{stencil}
3023 que es parte del @code{grob-interface}. De forma predeterminada, esta
3024 propiedad suele estar establecida a una función específica del objeto
3025 que está hecha a medida para disponer el símbolo que lo representa en
3026 la salida. Por ejemplo, el ajuste estándar para la propiedad
3027 @code{stencil} del objeto @code{MultiMeasureRest} es
3028 @code{ly:multi-measure-rest::print}.
3030 El símbolo estándar de cualquier objeto se puede sustituir modificando
3031 la propiedad @code{stencil} para que haga referencia a un
3032 procedimiento diferente escrito especialmente. Esto requiere un alto
3033 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3034 una forma más fácil que a menudo puede dar resultados adecuados.
3036 El procedimiento es establecer la propiedad @code{stencil} al
3037 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3038 añadir una propiedad @code{text} al objeto ajustada para que contenga
3039 el texto de marcado que produce el símbolo requerido. Debido a la
3040 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3041 particular, consulte @ref{Graphic notation inside markup}.
3043 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3044 la nota a unas aspas dentro de una circunferencia.
3046 @lilypond[verbatim,quote]
3048 \once \override NoteHead #'stencil = #ly:text-interface::print
3049 \once \override NoteHead #'text = \markup {
3051 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3052 \musicglyph #"noteheads.s2cross"
3060 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3061 a la instrucción de marcado @code{\musicglyph}: véase @ref{The Feta
3064 @c TODO Add inserting eps files or ref to later
3066 @c TODO Add inserting Postscript or ref to later
3070 Referencia de la notación:
3071 @ref{Graphic notation inside markup},
3072 @ref{Formatting text},
3073 @ref{Text markup commands},
3074 @ref{The Feta font}.
3077 @node Modifying shapes
3078 @subsection Modifying shapes
3081 * Modifying ties and slurs::
3084 @node Modifying ties and slurs
3085 @unnumberedsubsubsec Modifying ties and slurs
3087 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
3088 de Bézier de tercer orden. Si la forma de la ligadura calculada
3089 automáticamente no resulta óptima, se puede modificar su forma
3090 manualmente mediante la especificación explícita de los cuatro puntos
3091 de control necesarios para definir una curva de Bézier de tercer
3094 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
3095 puntos de control. El primer y cuarto puntos de control son
3096 exactamente los puntos extremos de comienzo y de final de la curva.
3097 Los dos puntos de contros intermedios definen la forma. Se pueden
3098 encontrar en la web animaciones que muestran cómo se traza la curva,
3099 pero la descripción siguiente puede ser de ayuda. La curva comienza a
3100 partir del primer punto de control dirigiéndose directamente hacia el
3101 segundo, curvándose progresivamente para dirigirse hacia el tercero y
3102 continuando la curva hacia el cuarto, llegando a éste en viaje directo
3103 desde el tercer punto de control. La curva está contenida enteramente
3104 dentro del cuadrilátero definido por los cuatro puntos de control.
3106 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
3107 @code{\tieDown} no sirve de ayuda.
3109 @lilypond[verbatim,quote,relative=1]
3113 { r4 <g c,> <g c,> <g c,> }
3117 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
3118 de control como sigue.
3120 Las coordenadas de los puntos de control de Bézier se especifican en
3121 unidades de espacios de pentagrama. La coordenada@tie{}X está en
3122 relación con el punto de referencia de la nota a la que está unida la
3123 ligadura, y la coordenada@tie{}Y está en relación con la línea central
3124 del pentagrama. Las coordenadas se introducen como una lista de
3125 cuatro parejas de números decimales (reales). Un enfoque es estimar
3126 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
3127 los dos puntos intermedios. Los valores óptimos se encuentran por
3130 Es útil recordar que una curva simétrica necesita puntos de contros
3131 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
3132 las transformaciones de la curva tales como la traslación, rotación y
3133 escalado se pueden obtener aplicando la misma transformación a los
3134 puntos de control de la curva.
3136 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
3139 @lilypond[verbatim,quote,relative=1]
3142 #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
3145 { r4 <g c,> <g c,> <g c,>4 }
3151 No es posible modificar la forma de las ligaduras de unión o de
3152 expresión cambiando la propiedad @code{control-points} si hay más de
3153 una en el mismo mom ento musical, ni siquiera usando la instrucción