1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 45945bd973aa9161b10e3f517902afb7ef4b4a56
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 disponibles 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 * Keeping contexts alive::
65 * Modifying context plug-ins::
66 * Changing context default settings::
67 * Defining new contexts::
73 Manual de aprendizaje:
74 @rlearning{Contexts and engravers}.
77 @file{ly/@/engraver@/-init@/.ly},
78 @file{ly/@/performer@/-init@/.ly}.
81 @rlsr{Contexts and engravers}.
83 Referencia de funcionamiento interno:
84 @rinternals{Contexts},
85 @rinternals{Engravers and Performers}.
88 @node Contexts explained
89 @subsection Contexts explained
91 Los contextos se disponen de forma jerárquica:
94 * Score - the master of all contexts::
95 * Top-level contexts - staff containers::
96 * Intermediate-level contexts - staves::
97 * Bottom-level contexts - voices::
100 @node Score - the master of all contexts
101 @unnumberedsubsubsec Score - the master of all contexts
103 Este es el contexto de notación del nivel más alto. Ningún otro
104 contexto puede contener a un contexto Score. De forma predeterminada,
105 el contexto Score maneja la administración de las indicaciones de
106 compás y se asegura de que ciertos elementos como claves, compases y
107 armaduras están siempre alineados entre los distintos pentagramas.
109 Se crea implícitamente una instancia del contexto Score cuando se
110 procesa un bloque @code{\score @{@dots{}@}} o @code{\layout
111 @{@dots{}@}}, o explícitamente cuando se ejecuta una instrucción
114 @node Top-level contexts - staff containers
115 @unnumberedsubsubsec Top-level contexts - staff containers
117 @strong{@emph{StaffGroup}}
119 Agrupa pentagramas y añade un corchete en la parte izquierda, formando
120 un grupo. Las líneas divisorias de los pentagramas contenidos se
121 conectan verticalmente. @code{StaffGroup} sólo consiste en una
122 colección de pentagramas, con un corchete delante y líneas divisorias
125 @strong{@emph{ChoirStaff}}
127 Idéntico a @code{StaffGroup} excepto que las barras de compás de los
128 pentagramas contenidos no se conectan verticalmente.
130 @strong{@emph{GrandStaff}}
132 Un grupo de pentagramas, con una llave en la parte izquierda que
133 abarca el grupo. Las barras de compás de los pentagramas contenidos
134 se conectan verticalmente.
136 @strong{@emph{PianoStaff}}
138 Igual que @code{GrandStaff}, pero contempla la posibilidad de poner el
139 nombre del instrumento a la izquierda del sistema.
141 @node Intermediate-level contexts - staves
142 @unnumberedsubsubsec Intermediate-level contexts - staves
144 @strong{@emph{Staff}}
146 Maneja claves, barras de compás, tonalidades y alteraciones
147 accidentales. Puede contener contextos de @code{Voice}.
149 @strong{@emph{RhythmicStaff}}
151 Como @code{Staff}, pero para imprimir ritmos. Se ignoran las alturas
152 de las notas; las notas se imprimen sobre una línea.
154 @strong{@emph{TabStaff}}
156 Contexto para generar tablaturas. De forma predeterminada dispone la
157 expresión musical como una tablatura de guitarra, impresa sobre seis
160 @strong{@emph{DrumStaff}}
162 Maneja el tipografiado para instrumentos de percusión. Puede contener
163 contextos @code{DrumVoice}.
165 @strong{@emph{VaticanaStaff}}
167 Igual que @code{Staff}, excepto que está pensado para tipografiar
168 piezas en estilo gregoriano.
170 @strong{@emph{MensuralStaff}}
172 Igual que @code{Staff}, excepto que está diseñado para tipografiar
173 piezas en estilo mensural.
176 @node Bottom-level contexts - voices
177 @unnumberedsubsubsec Bottom-level contexts - voices
179 Los contextos del mismo nivel que Voice dan un valor inicial a ciertas
180 propiedades e inician los grabadores correspondientes. Siendo
181 contextos del nivel más bajo, no pueden contener a otros contextos.
183 @strong{@emph{Voice}}
185 Corresponde a una voz sobre un pentagrama. este contexto maneja la
186 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
187 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
188 que crear instancias explícitas de este contexto si necesitamos varias
189 voces en el mismo pentagrama.
191 @strong{@emph{VaticanaVoice}}
193 Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
194 piezas en estilo gregoriano.
196 @strong{@emph{MensuralVoice}}
198 Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
199 piezas en estilo mensural.
201 @strong{@emph{Lyrics}}
203 Corresponde a una voz con letra. Maneja la impresión de una sola
206 @strong{@emph{DrumVoice}}
208 El contexto de voz utilizado en una pauta de percusión.
210 @strong{@emph{FiguredBass}}
212 El contexto en que los objetos @code{BassFigure} se crean a partir de
213 la entrada escrita en el modo @code{\figuremode}.
215 @strong{@emph{TabVoice}}
217 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
218 Se suele dejar que se cree implícitamente.
220 @strong{@emph{ChordNames}}
222 Tipografía nombres de acordes.
225 @node Creating contexts
226 @subsection Creating contexts
228 Para partituras que sólo tienen una voz y un pentagrama, los contextos
229 se crean automáticamente. Para partituras más complejas, es necesario
230 crearlos a mano. Existen tres instrucciones que hacen esto.
235 La instrucción más fácil es @code{\new}, y es también la más rápida de
236 escribir. Se antepone a una expresión musical, por ejemplo
239 @cindex nuevos, contextos
240 @cindex Contexto, creación de
243 \new @var{tipo} @var{expresión_musical}
247 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
248 @code{Voice}). Esta instrucción crea un contexto nuevo, y empieza a
249 interpretar la @var{expresión_musical} con él.
251 Una aplicación práctica de @code{\new} es una partitura con muchos pentagramas.
252 Cada parte que debe ir en su propio pentagrama, va precedida de
255 @lilypond[quote,verbatim,relative=2,ragged-right,fragment]
262 La instrucción @code{\new} puede también dar nombre al contexto,
265 \new @var{tipo} = @var{identificador} @var{música}
267 Sin embargo, este nombre especificado por el usuario sólo se utiliza
268 si no hay ya otro contexto anterior con el mismo nombre.
274 Como @code{\new}, la instrucción @code{\context} también dirige una
275 expresión musical a un objeto de contexto, pero da al contexto un
276 nombre explícito. La sintaxis es
279 \context @var{tipo} = @var{identificador} @var{música}
282 En esta forma, la instrucción buscará un contexto existente del
283 @var{tipo} especificado que tenga el nombre @var{identificador}. Si
284 ese contexto aún no existe, se crea un contexto nuevo con el nombre
285 especificado. Esto es útil si nos vamos a referir más tarde al
286 contexto. Por ejemplo, cuando se escribe la letra, la melodía está
287 dentro de un contexto con nombre
290 \context Voice = "@b{tenor}" @var{música}
294 de forma que los textos se puedan alienar correctamente con sus notas,
297 \new Lyrics \lyricsto "@b{tenor}" @var{letra}
302 Otro uso posible de los contextos con nombre es la fusión de dos
303 expresiones musicales distintas en un solo contexto. En el siguiente
304 ejemplo, se introducen por separado las articulaciones y las notas,
308 decoracion = @{ s4-. s4-> @}
311 se combinan enviando los dos al mismo contexto @code{Voice},
315 \new Staff \context Voice = "A" \musica
316 \context Voice = "A" \decoracion
319 @lilypond[quote,ragged-right]
323 \new Staff \context Voice = "A" \music
324 \context Voice = "A" \arts
328 Con este mecanismo, es posible definir un Urtext (una edición
329 original), con la posibilidad de poner articulaciones distintas sobre
332 @cindex crear contextos
335 La tercera instrucción para crear contextos es
337 \context @var{tipo} @var{música}
342 Esto es similar a @code{\context} con @code{= @var{identificador}},
343 pero se corresponde con cualquier contexto del tipo @var{tipo}, sin
344 importar qué nombre se le ha dado.
346 Esta variante se usa con expresiones musicales que se pueden
347 interpretar en varios niveles. Por ejemplo, la instrucción
348 @code{\applyOutput} (véase @ref{Running a function on all layout
349 objects}). Sin una instrucción @code{\context} explícita, normalmente
350 se aplicaría a @code{Voice}
353 \applyOutput #'@var{contexto} #@var{función} % aplicar al contexto Voice
356 Para que se interprete dentro de los niveles de @code{Score} o
357 @code{Staff}, utilice las siguientes formas:
360 \applyOutput #'Score #@var{función}
361 \applyOutput #'Staff #@var{función}
366 @node Keeping contexts alive
367 @subsection Keeping contexts alive
369 @cindex contextos, mantener vivos
370 @cindex contextos, tiempo de vida
372 Normalmente los contextos finalizan en el primer momento musical en
373 que no tienen nada que hacer. Así, los contextos de @code{Voice}
374 mueren tan pronto como ya no contienen ningún evento; los contextos de
375 @code{Staff} mueren tan pronto como todos los contextos de
376 @code{Voice} que contenían ya no contengan ningún evento; etc. Esto
377 puede ocasionar dificultades si se tiene que hacer referencia a
378 contextos anteriores que ya han muerto, por ejemplo, al cambiar de
379 pentagramas con instrucciones @code{\change}, asociar letra con una
380 voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
381 eventos musicales adicionales a un contexto anterior.
383 Existe una excepción a esta regla general: precisamente uno de los
384 contextos de @code{Voice} que están dentro de un contexto de
385 @code{Staff} o de una construcción @code{<<...>>} persiste siempre
386 hasta el final de, contexto de @code{Staff} circundante o la
387 construcción @code{<<...>>}, incluso aunque puede haber períodos en
388 que no tiene nada que hacer. El contexto que persiste de esta forma
389 será el primero que se encuentre en la primera construcción encerrada
390 entre llaves @code{@{...@}}, ignorando cualquiera que se encuentre
391 dentro de construcciones encerradas por ángulos dobles @code{<<...>>}.
393 Cualquier contexto se puede mantener vivo si nos aseguramos de que
394 tiene algo que hacer en cualquier momento musical dado. Los
395 contextos de @code{Staff} se mantienen con vida si nos aseguramos de
396 que una de sus voces se mantiene viva. Una manera de hacerlo es
397 añadir silencios de separación a una voz en paralelo con la música
398 real. Éstos deben añadirse a todos y cada uno de los contextos de
399 @code{Voice} que se hayan de mantener vivos. Si se van a usar
400 esporádicamente varias voces, es más seguro mantenerlas todas vivas en
401 lugar de tratar de confiar en las excepciones que hemos mencionado
404 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
405 vivas de esta manera durante la duración de la pieza:
407 @lilypond[quote,verbatim]
408 musicA = \relative c'' { d4 d d d }
409 musicB = \relative c'' { g4 g g g }
412 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
413 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
418 \context Voice = "A" {
422 \context Voice = "B" {
426 \context Voice = "A" { \musicA }
427 \context Voice = "B" { \musicB }
428 \context Voice = "A" { \musicA }
439 @cindex letra, alineación con melodía esporádica
441 El ejemplo siguiente muestra cómo se puede escribir una línea melódica
442 esporádica con letra utilizando este enfoque. Por supuesto, en una
443 situación real la melodía y el acompañamiento consistirían en varias
444 secciones diferentes.
446 @lilypond[quote,verbatim]
447 melody = \relative c'' { a4 a a a }
448 accompaniment = \relative c' { d4 d d d }
449 words = \lyricmode { These words fol -- low the mel -- o -- dy }
452 \new Staff = "music" {
454 \new Voice = "melody" {
456 s1*4 % Keep Voice "melody" alive for 4 bars
459 \new Voice = "accompaniment" {
464 \context Voice = "melody" { \melody }
465 \context Voice = "accompaniment" { \accompaniment }
467 \context Voice = "accompaniment" { \accompaniment }
469 \context Voice = "melody" { \melody }
470 \context Voice = "accompaniment" { \accompaniment }
475 \new Lyrics \with { alignAboveContext = #"music" }
476 \lyricsto "melody" { \words }
481 Una forma alternativa, que podría resultar mejor en muchas
482 situaciones, es mantener con vida la línea melódica simplemente
483 incluyendo notas espaciadoras para alinearla correctamente con el
486 @lilypond[quote,verbatim]
487 melody = \relative c'' {
493 accompaniment = \relative c' {
499 words = \lyricmode { These words fol -- low the mel -- o -- dy }
503 \new Staff = "music" {
505 \new Voice = "melody" {
509 \new Voice = "accompaniment" {
515 \new Lyrics \with { alignAboveContext = #"music" }
516 \lyricsto "melody" { \words }
522 @node Modifying context plug-ins
523 @subsection Modifying context plug-ins
525 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
526 almacenan propiedades, también contienen «plug-ins» o complementos
527 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
528 el contexto @code{Voice} contiene un grabador
529 @code{Note_head_engraver} que crea las cabezas de nota y el contexto
530 @code{Staff} contiene un grabador @code{Key_signature_engraver} que
531 crea la indicación de compás.
533 Para ver una descripción completa de todos y cada uno de los
534 complementos, consulte
536 @rinternals{Engravers and Performers}.
539 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
541 Cada contexto que se describe en
543 @rinternals{Contexts}
546 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
548 relaciona los grabadores que se usan para ese contexto.
551 Puede ser de utilidad jugar un poco con estos complementos. Se hace
552 iniciando un contexto nuevo con @code{\new} o @code{\context} y
558 \new @var{contexto} \with @{
571 donde los @dots{} debe ser el nombre de un grabador. Aquí tenemos un
572 ejemplo sencillo que suprime los grabadores
573 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
576 @lilypond[quote,relative=1,verbatim,fragment]
582 \remove "Time_signature_engraver"
583 \remove "Clef_engraver"
590 En el segundo pentagrama no hay indicación de compás ni clave. Éste
591 es un método bastante rudimentario de hacer que desaparezcan los
592 objetos porque afecta a todo el pentagrama. Este método también
593 afecta al espaciado, lo que puede ser deseable o no serlo. Se
594 muestran métodos más sofisticados para quitar objetos en
595 @rlearning{Visibility and color of objects}.
597 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
598 líneas divisorias y las indicaciones de compás están sincronizadas a
599 lo largo de toda la partitura. Lo hacen los grabadores
600 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
601 complementos mantienen al día la administración de las indicaciones de
602 compás, posición dentro del compás, etc. Moviendo estos grabadores
603 desde el contexto de @code{Score} al de @code{Staff}, podemos
604 conseguir una partitura en la que cada pentagrama tiene su propio
605 compás independiente.
607 @cindex polimétricas, partituras
608 @cindex compases distintos al mismo tiempo
610 @lilypond[quote,relative=1,ragged-right,verbatim,fragment]
612 \remove "Timing_translator"
613 \remove "Default_bar_line_engraver"
616 \consists "Timing_translator"
617 \consists "Default_bar_line_engraver"
623 \consists "Timing_translator"
624 \consists "Default_bar_line_engraver"
633 @node Changing context default settings
634 @subsection Changing context default settings
636 Los ajustes de contexto que están preparados para usarse de forma
637 predeterminada en los contextos @code{Score}, @code{Staff} y
638 @code{Voice}, se pueden especificar dentro de un bloque
639 @code{\layout}, como se ilustra en el ejemplo siguiente. El bloque
640 @code{\layout} se debe colocar dentro del bloque @code{\score} en que
641 se quiere que haga efecto, pero fuera de la música.
643 Observe que la propia instrucción @code{\set} y el contexto se deben
644 omitir cuando se especifican de esta manera los valores de contexto
647 @lilypond[quote,verbatim]
650 a4^"Really small, thicker stems, no time signature" a a a
657 \override Stem #'thickness = #4.0
658 \remove "Time_signature_engraver"
664 En este ejemplo, la instrucción @code{\Staff} especifica que los
665 ajustes siguientes se apliquen a todos los pentagramas dentro del
668 Se pueden realizar de forma similar modificaciones al contexto
669 @code{Score} o a todos los contextos @code{Voice}.
673 No es posible recolectar cambios de contexto dentro de una variable y
674 aplicarlos a una definición de @code{\context} por referencia a dicha
677 La instrucción @code{\RemoveEmptyStaffContext} sobreescribe nuestros
678 ajustes en curso para @code{\Staff}. Si queremos cambiar los valores
679 predeterminados para un pentagrama que utilice
680 @code{\RemoveEmptyStaffContext}, debe hacerlo después de llamar a
681 @code{\RemoveEmptyStaffContext}, o sea
686 \RemoveEmptyStaffContext
688 \override Stem #'thickness = #4.0
694 @node Defining new contexts
695 @subsection Defining new contexts
697 Los contextos específicos, como @code{Staff} y @code{Voice}, están
698 construidos a base de bloques sencillos. Es posible crear nuevos
699 tipos de contextos con combinaciones distintas de añadidos grabadores.
701 El siguiente ejemplo muestra cómo construir un tipo diferente de contexto de
702 @code{Voice} partiendo de cero. Será parecido a
703 @code{Voice}, pero imprime solamente cabezas centradas en forma de barra inclinada. Se puede usar
704 para indicar improvisación en piezas de jazz,
707 @lilypond[quote,ragged-right]
710 \type "Engraver_group"
711 \consists "Note_heads_engraver"
712 \consists "Rhythmic_column_engraver"
713 \consists "Text_engraver"
714 \consists Pitch_squash_engraver
715 squashedPosition = #0
716 \override NoteHead #'style = #'slash
717 \override Stem #'transparent = ##t
721 \accepts "ImproVoice"
725 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
726 c4 c^"desvístete" c_"mientras juegas :)" c }
732 Estos ajustes se definen dentro de un bloque @code{\context} que a su
733 vez está dentro de un bloque @code{\layout},
743 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
744 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
746 En primer lugar es necesario definir un nombre para el nuevo contexto:
752 Debido a que es parecido al contexto @code{Voice}, queremos órdenes
753 que funcionen sobre contextos de @code{Voice} (existentes) para que
754 siga funcionando. Esto se consigue dando al contexto nuevo un alias
761 El contexto imprimirá notas y textos explicativos, por ello tenemos
762 que añadir los grabadores que aportan esta funcionalidad,
765 \consists Note_heads_engraver
766 \consists Text_engraver
769 Pero sólo necesitamos esto en la línea central,
772 \consists Pitch_squash_engraver
773 squashedPosition = #0
776 El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
777 nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
778 establece sus posiciones verticales al valor de
779 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.
781 Las notas parecen barras inclinadas y no tienen plica,
784 \override NoteHead #'style = #'slash
785 \override Stem #'transparent = ##t
788 Todos estos añadidos tienen que cooperar, y esto se consigue con un
789 añadido especial, que se debe marcar con la palabra clave
790 @code{\type}. Este será siempre @code{Engraver_group},
793 \type "Engraver_group"
796 Al juntarlo todo, obtenemos
801 \type "Engraver_group"
802 \consists "Note_heads_engraver"
803 \consists "Text_engraver"
804 \consists Pitch_squash_engraver
805 squashedPosition = #0
806 \override NoteHead #'style = #'slash
807 \override Stem #'transparent = ##t
813 Los contextos dan lugar a jerarquías. Queremos colgar el contexto
814 @code{ImproVoice} bajo el contexto @code{Staff}, como simples
815 @code{Voice}s normales. Por tanto, modificamos la definición de
816 @code{Staff} con la instrucción @code{\accepts} (acepta),
826 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
827 que a veces se necesita cuando se están reutilizando definiciones de
830 Ponemos ambos dentro de un bloque @code{\layout}, como
840 \accepts "ImproVoice"
845 Así pues, la salida que aparece al comienzo de esta sub-sección se
854 c c_"while playing :)"
861 @node Aligning contexts
862 @subsection Aligning contexts
864 Los contextos nuevos se pueden alinear por encima o por debajo de
865 otros contextos existentes. Esto podría ser de utilidad al preparar
866 un pentagrama vocal (@rlearning{Vocal ensembles}) y un ossia,
869 @findex alignAboveContext
870 @findex alignBelowContext
872 @lilypond[quote,ragged-right]
875 \relative c' \new Staff = "main" {
878 \new Staff \with { alignAboveContext = #"main" } \ossia
885 @cindex nested contexts
886 @cindex contexts, nested
891 Los contextos como @code{PianoStaff} pueden llevar dentro otros
892 contextos anidados. Los contextos que se pueden aceptar para su
893 anidamiento están definidos por la lista @qq{accepts} (acepta) de un
894 contexto. Los contextos que no están en esta lista se colocan debajo
895 del contexto exterior en la partitura impresa. Por ejemplo, el
896 contexto @code{PianoStaff} está definido para que acepte contextos
897 @code{Staff} y @code{FiguredBass} de forma predeterminada, pero no un
898 contexto @code{Lyrics}, por ejemplo. Así pues, en la siguiente
899 estructura la letra se sitúa debajo del sistema de piano en lugar de
900 colocarse entre los dos pentagramas:
902 @lilypond[verbatim,quote,relative=1]
905 \new Staff { e4 d c2 }
906 \addlyrics { Three blind mice }
914 La lista @qq{accepts} de un contexto se puede modificar para que
915 incluya contextos anidados adicionales, y así si quisiéramos que la
916 letra apareciese entre los dos pentagramas podríamos usar:
918 @lilypond[verbatim,quote,relative=1]
919 \new PianoStaff \with { \accepts Lyrics }
921 \new Staff { e4 d c2 }
922 \addlyrics { Three blind mice }
930 Lo contrario de @code{\accepts} (acepta) es @code{\denies} (deniega);
931 esto suprime un contexto de la lista @qq{accepts}.
934 @node Explaining the Internals Reference
935 @section Explaining the Internals Reference
939 * Navigating the program reference::
940 * Layout interfaces::
941 * Determining the grob property::
942 * Naming conventions::
947 @node Navigating the program reference
948 @subsection Navigating the program reference
950 Supongamos que queremos mover la indicación de digitación del
953 @lilypond[quote,fragment,relative=2,verbatim]
959 Si hace una visita a la documentación en busca de instrucciones de
960 digitación (en @ref{Fingering instructions}), encontrará:
963 @strong{Véase también}
965 Referencia de funcionamiento interno: @rinternals{Fingering}.
970 La referencia del programador se encuentra disponible en forma de
971 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
972 en línea o bien descargando los archivos de la documentación HTML.
973 Esta sección sería mucho más difícil de entender si está utilizando el
974 manual en formato PDF.
977 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
981 Los objetos de digitación se crean por parte de:
982 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
985 Siguiendo los enlaces relacionados dentro de la referencia del
986 programa, podemos seguir el flujo de información dentro del programa:
990 @item @rinternals{Fingering}:
991 los objetos @rinternals{Fingering} se crean por parte de:
992 @rinternals{Fingering_engraver}
994 @item @rinternals{Fingering_engraver}:
995 Tipos de música aceptados: @rinternals{fingering-event}
997 @item @rinternals{fingering-event}:
998 El tipo de evento musical @code{fingering-event} está descrito en
999 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1002 Este camino se recorre en contra de la corriente de información del
1003 programa: comienza por la salida y acaba en el evento de entrada.
1004 También podríamos haber empezado por un evento de la entrada, y leído
1005 siguiendo el flujo de información terminando en su caso en el objeto
1006 (u objetos) de la salida.
1008 La referencia del programa también se puede examinar como un documento
1009 normal. Contiene capítulos que tratan de
1011 @rinternals{Music definitions},
1014 @code{Music definitions}
1016 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1017 de los capítulos relaciona todas las definiciones utilizadas y todas
1018 las propiedades que se pueden ajustar.
1021 @node Layout interfaces
1022 @subsection Layout interfaces
1024 @cindex interfaz de la presentación
1025 @cindex presentación, interfaz de la
1028 La página HTML que pudimos ver en la sección anterior describe el
1029 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1030 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1031 números (como grosores y direcciones), pero también punteros a objetos
1032 relacionados. Un objeto de presentación también se llama un
1033 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1034 gráfico). Para ver más detalles acerca de los objetos gráficos o
1035 Grobs, consulte @rinternals{grob-interface}.
1037 La página dedicada a @code{Fingering} relaciona las definiciones del
1038 objeto @code{Fingering}. Por ejemplo, la página dice
1041 @code{relleno} (dimensión, en espacios de pentagrama):
1047 lo que significa que el número se mantendrá a una distancia de al
1048 menos 0.5 de la cabeza de la nota.
1051 Cada objeto de presentación puede tener varias funciones como elemento
1052 notacional o tipográfico. Por ejemplo, el objeto de digitación
1053 Fingering tiene los siguientes aspectos
1057 Su tamaño es independiente del espaciado horizontal, al contrario de
1058 las ligaduras o las barras de las figuras.
1061 Es un elemento de texto. Casi seguro que es un texto muy corto.
1064 este elemento de texto se tipografía con un tipo de letra, no como las
1065 ligaduras o las barras de las figuras.
1068 Horizontalmente, el centro del símbolo se debe alinear con el centro
1069 de la cabeza de la nota.
1072 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1075 La posición vertical también está coordinada con otros símbolos de
1076 superíndice y de subíndice.
1079 Cada uno de estos aspectos se capta en lo que se llaman
1080 @emph{interface}s, que se relacionan al final de la página dedicada a
1081 @rinternals{Fingering}
1084 Este objeto contempla los siguientes interfaces:
1085 @rinternals{item-interface},
1086 @rinternals{self-alignment-interface},
1087 @rinternals{side-position-interface}, @rinternals{text-interface},
1088 @rinternals{text-script-interface}, @rinternals{font-interface},
1089 @rinternals{finger-interface} y @rinternals{grob-interface}.
1092 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1093 página del respectivo interfaz del objeto. Cada interfaz tiene un
1094 cierto número de propiedades. Algunas de ellas no son para que el
1095 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1098 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1099 realmente esto no significa mucho. El archivo de inicialización
1100 (véase @rlearning{Other sources of information})
1101 @file{scm/@/define@/-grobs@/.scm} muestra el alma del @q{objeto},
1106 (avoid-slur . around)
1107 (slur-padding . 0.2)
1108 (staff-padding . 0.5)
1109 (self-alignment-X . 0)
1110 (self-alignment-Y . 0)
1111 (script-priority . 100)
1112 (stencil . ,ly:text-interface::print)
1113 (direction . ,ly:script-interface::calc-direction)
1114 (font-encoding . fetaNumber)
1115 (font-size . -5) ; don't overlap when next to heads.
1116 (meta . ((class . Item)
1117 (interfaces . (finger-interface
1119 text-script-interface
1121 side-position-interface
1122 self-alignment-interface
1123 item-interface))))))
1127 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1128 de valores de variables, y la página web de la Referencia de
1129 funcionamiento interno se genera directamente a partir de esta
1133 @node Determining the grob property
1134 @subsection Determining the grob property
1136 Recordemos que queríamos cambiar la posición del @b{2} en
1138 @lilypond[quote,fragment,relative=2,verbatim]
1144 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1145 tenemos que negociar con el interfaz asociado con esta colocación.
1146 Esto se hace usando @code{side-position-interface}. La página que
1147 describe este interface dice:
1150 @code{side-position-interface}
1152 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1153 soporte). La propiedad @code{direction} significa dónde poner el
1154 objeto víctima con relación al soporte (¿a la izquierda o a la
1155 derecha, encima o debajo?)
1160 Debajo de esta descripción, la variable @code{padding} (relleno) se describe como
1165 (dimensión, en espacios de pentagrama)
1167 Añadir esta cantidad de espacio adicional entre objetos que están unos
1172 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1173 digitación de la cabeza de la nota. La siguiente orden inserta un
1174 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1177 \once \override Voice.Fingering #'padding = #3
1180 Al insertar esta instrucción antes de que se haya creado el objeto
1181 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1184 @lilypond[quote,relative=2,fragment,verbatim]
1185 \once \override Voice.Fingering #'padding = #3
1191 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1192 se puede deducir también a partir de la referencia del programa, ya
1193 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1196 El grabador Fingering_engraver es parte de los contextos: @dots{}
1202 @node Naming conventions
1203 @subsection Naming conventions
1206 Another thing that is needed, is an overview of the various naming
1209 scheme functions: lowercase-with-hyphens (incl. one-word
1211 scheme functions: ly:plus-scheme-style
1212 music events, music classes and music properties:
1214 Grob interfaces: scheme-style
1215 backend properties: scheme-style (but X and Y!)
1216 contexts (and MusicExpressions and grobs): Capitalized or
1218 context properties: lowercaseFollowedByCamelCase
1220 Capitalized_followed_by_lowercase_and_with_underscores
1222 Which of these are conventions and which are rules?
1223 Which are rules of the underlying language, and which are
1227 @node Modifying properties
1228 @section Modifying properties
1231 * Overview of modifying properties::
1233 * The override command::
1234 * The tweak command::
1235 * set versus override::
1239 @node Overview of modifying properties
1240 @subsection Overview of modifying properties
1242 Cada contexto es responsable de la creación de ciertos tipos de
1243 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1244 también se almacenan por contexto. Mediante la modificación de estos
1245 ajustes, se puede alterar la apariencia de los objetos.
1247 La sintaxis de esto es
1250 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1253 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1254 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1255 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1256 disposición}). Este último es un símbolo, y por ello debe ir
1257 precedido de un apóstrofo. La subsección @ref{Modifying properties}
1258 explica cómo se deben cumplimentar los conceptos @var{nombre},
1259 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1260 funcionalidad des esta instrucción.
1265 \override Staff.Stem #'thickness = #4.0
1269 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1270 grosor de una línea del pentagrama como unidad). Puesto que la
1271 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1272 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1273 Aquí vemos la instrucción en pleno funcionamiento:
1275 @lilypond[quote,verbatim,relative=2,fragment]
1277 \override Staff.Stem #'thickness = #4.0
1283 La instrucción @code{\override} modifica la definición de la plica
1284 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1285 que la instrucción se ha interpretado, todas las plicas se engrosan.
1287 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1288 omitir, ocasionando que se utilice el contexto predeterminado
1289 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1290 solo paso de tiempo.
1292 @lilypond[quote,fragment,verbatim,relative=2]
1294 \once \override Stem #'thickness = #4.0
1299 El @code{\override} se debe hacer antes de que el objeto se inicia.
1300 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1301 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1302 en el momento en que se crea el objeto. En este ejemplo:
1304 @lilypond[quote,fragment,verbatim,relative=2]
1305 \override Slur #'thickness = #3.0
1307 \override Beam #'thickness = #0.6
1312 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1313 la instrucción para @code{Beam}, la barra, va después de que la barra
1314 se ha iniciado, y por ello no tiene ningún efecto.
1316 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1317 un contexto deshace una instrucción @code{\override}; como con
1318 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1319 del mismo contexto. En otras palabras, el @code{\revert} del
1320 siguiente ejemplo no hace nada.
1323 \override Voice.Stem #'thickness = #4.0
1324 \revert Staff.Stem #'thickness
1327 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1328 dentro de las propiedades normales. Para trucarlas, utilice
1329 instrucciones de la forma
1331 @c leave this as a long long
1333 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1340 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1345 Referencia de funcionamiento interno:
1346 @rinternals{OverrideProperty},
1347 @rinternals{RevertProperty},
1348 @rinternals{PropertySet},
1349 @rinternals{Backend},
1350 @rinternals{All layout objects}.
1355 El «back-end» o motor de salida no es muy estricto en la comprobación
1356 de tipos de las propiedades de objetos. Las referencias cíclicas en
1357 valores Scheme de propiedades pueden producir cuelgues o salidas
1358 abruptas, o las dos cosas.
1361 @node The set command
1362 @subsection The @code{\set} command
1366 @cindex cambiar propiedades
1368 Cada contexto puede tener distintas @emph{propiedades}, variables
1369 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1370 paso de interpretación. Se consigue insertando la instrucción
1371 @code{\set} dentro de la música:
1374 \set @var{contexto}.@var{propiedad} = #@var{valor}
1378 @lilypond[quote,verbatim,relative=2,fragment]
1380 \set Score.skipBars = ##t
1384 Estas instrucción salta los compases que no tienen notas. El
1385 resultado es que los silencios multicompás se condensan. El valor
1386 asignado es un objeto de Scheme. En este caso, es @code{#t}, el valor
1387 booleano True o verdadero.
1389 Si se omite el argumento @var{context}, entonces se utiliza el
1390 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1391 @code{Voice} o @code{Lyrics}). En este ejemplo:
1393 @lilypond[quote,verbatim,relative=2,fragment]
1395 \set autoBeaming = ##f
1400 el argumento @var{contexto} de la instrucción @code{\set} se omite,
1401 así pues el barrado automático se desactiva en la voz actual. Observe
1402 que el contexto de nivel más bajo no siempre contiene la propiedad que
1403 queremos cambiar (por ejemplo, no tendrá ningún efecto intentar
1404 establecer un valor para la propiedad @code{skipBars} del contexto de
1405 nivel más bajo, en este caso @code{Voice}).
1407 @lilypond[quote,verbatim,relative=2,fragment]
1413 Los contextos son jerárquicos, y si se ha especificado un contexto
1414 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1415 también a todos los contextos @code{Voice} dentro del pentagrama
1416 actual. El cambio se aplica @q{al vuelo}, durante la música, de
1417 manera que el ajuste sólo afecta al segundo grupo de corcheas.
1421 También existe una instrucción @code{\unset}:
1423 \unset @var{contexto}.@var{propiedad}
1427 que elimina la definición de @var{propiedad}. Esta instrucción
1428 elimina la definición solamente si está establecida dentro de
1429 @var{contexto}, de manera que
1432 \set Staff.autoBeaming = ##f
1436 introduce un ajuste de la propiedad en el nivel de @code{Staff}. El
1437 ajuste también se aplica a la @code{Voice} actual. Sin embargo:
1440 \unset Voice.autoBeaming
1444 no tiene ningún efecto. Para cancelar este ajuste, se debe
1445 especificar el @code{\unset} en el mismo nivel que el @code{\set}
1446 original. Dicho de otra forma, para deshacer el efecto de
1447 @code{Staff.autoBeaming = ##f} se necesita
1449 \unset Staff.autoBeaming
1452 Como @code{\set}, el argumento @var{contexto} no se tiene que
1453 especificar para un contexto del nivel más bajo, por lo que los dos
1457 \set Voice.autoBeaming = ##t
1458 \set autoBeaming = ##t
1466 Los ajustes que se aplican solamente a un único paso de tiempo se
1467 pueden escribir con @code{\once}, por ejemplo en
1469 @lilypond[quote,verbatim,relative=2,fragment]
1471 \once \set fontSize = #4.7
1476 la propiedad @code{fontSize} se deshace automáticamente después de la
1479 En el manual de Referencia de funcionamiento interno hay una
1480 descripción completa de todas las propiedades de contexto disponibles,
1483 @rinternals{Tunable context properties}.
1486 Traducción @expansion{} Propiedades de contexto modificables por el
1492 @node The override command
1493 @subsection The @code{\override} command
1495 Las instrucciones que modifican la salida tienen por lo general un
1499 \override Voice.Stem #'thickness = #3.0
1503 Para construir este truco debemos determinar los siguientes datos:
1506 @item el contexto: aquí @code{Voice}.
1507 @item el objeto de presentación: aquí @code{Stem}.
1508 @item la propiedad de presentación: aquí @code{thickness}.
1509 @item un valor adecuado: aquí @code{3.0}.
1512 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
1513 en el interior de las propiedades normales. Para modificarlas utilice
1514 instrucciones de la forma
1517 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1520 @cindex documentación interna
1521 @cindex buscar objetos gráficos
1522 @cindex gráficos, descripción de los objetos
1525 @cindex interna, documentación
1527 Para muchas propiedades, independientemente del tipo de datos de la
1528 propiedad, si se establece el valor de la propiedad a falso
1529 (@code{##f}) se producirá su desactivación, ocasionando que LilyPond
1530 ignore por completo dicha propiedad. Esto es especialmente útil para
1531 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
1532 causarían problemas.
1534 Mostraremos a continuación cómo localizar esta información en el
1535 manual de notación y en la referencia de funcionamiento interno.
1538 @node The tweak command
1539 @subsection The @code{\tweak} command
1544 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
1545 los objetos gráficos. Para objetos que resultan directamente de un
1546 elemento de código de la entrada, puede usar la función @code{\tweak},
1549 @lilypond[relative=2,verbatim]
1554 \tweak #'duration-log #1
1557 -\tweak #'padding #8
1561 @cindex chord, modifying one note in
1563 Pero el uso principal de la instrucción @code{\tweak} es modificar
1564 solamente uno de varios elementos de notación que dan comienzo en el
1565 mismo momento musical, como las notas de un acorde, o corchetes de
1566 tresillo que empiezan al mismo tiempo.
1568 Para ver una introducción a la sintaxis y los usos de la instrucción
1569 tweak, consulte @rlearning{Tweaking methods}.
1571 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
1572 a continuación de forma directa, sin necesidad de especificar el
1573 nombre del grob o el contexto. Para que esto funcione, es necesario
1574 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
1575 al objeto al que se aplica, después de que el archivo de entrada se ha
1576 convertido en un flujo musical. Con frecuencia no es el caso, pues
1577 muchos elementos adicionales se insertan en la corriente musical de
1578 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
1579 parte de un acorde, LilyPond inserta implícitamente un evento
1580 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
1581 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
1582 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
1583 en el flujo musical, permaneciendo así adyacente a la nota, y con la
1584 posibilidad de modificarla.
1588 @lilypond[relative=2,verbatim,quote]
1589 <\tweak #'color #red c>4
1593 pero esto no funciona:
1595 @lilypond[relative=2,verbatim,quote]
1596 \tweak #'color #red c4
1599 Si se colocan varios elementos similares en el mismo momento musical,
1600 la instrucción @code{\override} no se puede usar para modificar uno
1601 solo de ellos: aquí es donde se debe usar la instrucción
1602 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
1603 en el mismo momento musical están los siguientes:
1605 @c TODO expand to include any further uses of \tweak
1607 @item las cabezas de las notas de un acorde
1608 @item signos de articulación sobre la misma nota
1609 @item ligaduras de unión entre notas de un acorde
1610 @item corchetes de grupos especials que comienzan en el mismo momento
1613 @c TODO add examples of these
1616 y se puede usar @code{\tweak} para modificar cualquier aparición
1617 específica de estos elementos.
1619 Es de resaltar que la instrucción @code{\tweak} no se puede usar para
1620 modificar plicas, barras o alteraciones accidentales directamente,
1621 porque éstos se generan más tarde por parte de las cabezas de nota, en
1622 vez de por elementos musicales que están en el flujo de entrada. Ni
1623 se puede usar una instrucción @code{\tweak} para modificar claves o
1624 indicaciones de compás, ya que éstos están separados de cualquier
1625 instrucción @code{\tweak} precedente en el flujo de entrada a causa de
1626 la inserción automática de elementos adicionales necesarios para
1627 especificar el contexto.
1629 Pero la instrucción @code{\tweak} se puede usar como alternativa a la
1630 instrucción @code{\override} para modificar estos elementos
1631 notacionales que no producen la adición de ningún elemento notacional
1632 implícito antes de ellos mismos en el flujo musical. Por ejemplo, las
1633 ligaduras de expresión se pueden modificar de esta forma:
1635 @lilypond[verbatim,quote,relative=1]
1636 c-\tweak #'thickness #5 ( d e f)
1639 También se pueden escribir varias instrucciones @code{\tweak} antes de
1640 un elemento notacional, y todas ellas le afectan:
1642 @lilypond[verbatim,quote,relative=1]
1644 -\tweak #'style #'dashed-line
1645 -\tweak #'dash-fraction #0.2
1646 -\tweak #'thickness #3
1647 -\tweak #'color #red
1652 El flujo musical que se genera a partir de una sección de un archivo
1653 de entrada, incluido cualquier elemento insertado automáticamente,
1654 puede examinarse, véase @ref{Displaying music expressions}. Esto
1655 puede ser de utilidad en la determinación de lo que puede modificarse
1656 por medio de una instrucción @code{\tweak}.
1660 Manual de aprendizaje:
1661 @rlearning{Tweaking methods}.
1663 Referencia de la notación:
1664 @ref{Displaying music expressions}.
1669 @cindex trucos en una variable
1670 La instrucción @code{\tweak} no se puede usar dentro de una variable.
1672 @cindex trucos en la letra
1673 Las instrucciones @code{\tweak} no se pueden usar dentro del modo @code{\lyricmode}.
1675 @cindex trucar puntos de control
1676 @cindex control, trucar puntos de
1678 La instrucción @code{\tweak} no se puede usar para modificar los
1679 puntos de control de una única ligadura entre varias dentro de un
1680 acorde, aparte de la primera que aparece en el archivo de entrada.
1682 @node set versus override
1683 @subsection @code{\set} vs. @code{\override}
1685 Hemos visto dos formas de cambiar las propiedades: @code{\set} y
1686 @code{\override}. De hecho, en realidad existen dos clases diferentes
1689 Los contextos pueden tener propiedades, que por lo general reciben
1690 nombres en @code{mayúsculasDeCamello}. Principalmente controlan la
1691 traducción de la música a la notación, p.ej. @code{localKeySignature}
1692 (para determinar si hay que imprimir las alteraciones accidentales),
1693 @code{measurePosition} (para determinar cuándo imprimir una línea
1694 divisoria). Las propiedades de contexto pueden ver modificado su
1695 valor con el tiempo según se interpreta una pieza de música;
1696 @code{measurePosition} es un ejemplo obvio de esto. Las propiedades
1697 de contexto se modifican con @code{\set}.
1699 Hay un tipo especial de propiedad de contexto: la descripción del
1700 elemento. Estas propiedades reciben nombres en
1701 @code{MayúsculasDeCamello} (comenzando en letra mayúscula). Contienen
1702 los @q{ajustes por defecto} para dicho elemento gráfico como una lista
1703 asociativa. Consulte @file{scm/@/define@/-grobs@/.scm} para ver qué
1704 tipos de ajustes hay. Las descripciones de los elementos se pueden
1705 modificar con @code{\override}.
1707 Realmente, @code{\override} es un atajo;
1710 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1714 es más o menos equivalente a
1716 @c leave this long line -gp
1718 \set @var{contexto}.@var{nombre} #'@var{propiedad} = #(cons (cons '@var{propiedad} @var{valor}) <valor previo de @var{contexto})
1721 El valor de @code{contexto} (la lista-a) se usa para da un valor
1722 inicial a las propiedades de los objetos gráficos individuales. Los
1723 objetos gráficos también tienen propiedades, que reciben nombres en el
1724 estilo de Scheme, con @code{palabras-con-guiones}. Los valores de las
1725 propiedades de objetos gráficos cambian durante el proceso de
1726 formateo: el formateo básicamente consiste en calcular las propiedades
1727 utilizando funciones de callback.
1729 @code{fontSize} es una propiedad especial: equivale a escribir
1730 @code{\override ... #'font-size} para todos los objetos pertinentes.
1731 Al ser éste un cambio muy común, se creó la propiedad especial
1732 (modificada con @code{\set}).
1735 @node Useful concepts and properties
1736 @section Useful concepts and properties
1741 * Direction and placement::
1742 * Distances and measurements::
1743 * Staff symbol properties::
1745 * Visibility of objects::
1747 * Rotating objects::
1751 @subsection Input modes
1753 La forma en que se interpreta la notación contenida dentro de un
1754 archivo de entrada, está determinada por el modo de entrada en curso.
1756 @strong{Modo de acordes}
1758 Se activa con la instrucción @code{\chordmode} y produce que la
1759 entrada se interprete con al sintaxis de la notación de acordes, véase
1760 @ref{Chord notation}. Los acordes se imprimen como notas sobre un
1763 El modo de acordes se activa también con la instrucción
1764 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
1765 y produce que el código que sigue se interprete con la sintaxis de la
1766 notación de acordes y se imprima como nombres de acorde dentro del
1767 contexto @code{ChordNames}, véase @ref{Printing chord names}.
1769 @strong{Modo de percusión}
1771 Se activa con la instrucción @code{\drummode} y produce que el código
1772 de entrada se interprete con la sintaxis de la notación de percusión,
1773 véase @ref{Basic percussion notation}.
1775 El modo de percusión también se activa con la instrucción
1776 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
1777 que el código que sigue se interprete con la sintaxis de la notación
1778 de percusión y se imprima como símbolos de percusión sobre un
1779 pentagrama de percusión, véase @ref{Basic percussion notation}.
1781 @strong{Modo de cifras}
1783 Se activa con la instrucción @code{\figuremode} y hace que el código
1784 de entrada se interprete con la sintaxis del bajo cifrado, véase
1785 @ref{Entering figured bass}.
1787 El modo de cifrase también se activa con la instrucción
1788 @code{\figures}. También crea un contexto de @code{FiguredBass} nuevo
1789 y hace que el código que viene a continuación se interprete con la
1790 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
1791 dentro del contexto @code{FiguredBass}, véase @ref{Introduction to
1794 @strong{Modos de traste y tablatura}
1796 No existen modos de entrada especiales para introducir símbolos de
1797 trastes y de tablatura.
1799 Para crear diagramas de trastes, escriba las notas o acordes en el
1800 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
1801 véase @ref{Default tablatures}.
1803 Para crear diagramas de trastes encima de un pentagrama, escríbalos
1804 como elementos de marcado encima de las notas utilizando la
1805 instrucción @code{\fret-diagram}, véase @ref{Fret diagram markups}.
1807 @strong{Modo de letra}
1809 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
1810 se interprete como sílabas de la letra de la canción con duraciones
1811 opcionales y modificadores de letra asociados, véase @ref{Vocal
1814 El modo de letra también se habilita con la instrucción
1815 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
1816 y una instrucción @code{\lyricsto} implícita que asocia la letra que
1817 viene a continuación con la música precedente.
1819 @strong{Modo de marcado}
1821 Se activa con la instrucción @code{\markup}, y hace que la entrada se
1822 interprete con la sintaxis del marcado, véase @ref{Text markup
1825 @c silly work-around for texinfo broken-ness
1826 @c (@strong{Note...} causes a spurious cross-reference in Info)
1829 Es el modo predeterminado o se puede activar con la instrucción
1830 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
1831 marcado, etc. y se imprime como notación musical sobre un pentagrama.
1833 Normalmente no es necesario especificar el modo de notas de forma
1834 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
1835 ejemplo si estamos en el modo de letra, en el modo de acordes o en
1836 otro modo y queremos insertar algo que solamente se puede hacer con la
1837 sintaxis del modo de notas.
1839 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
1840 una pieza coral es necesario entrar en el modo de notas para poder
1841 interpretar dichas indicaciones:
1843 @lilypond[verbatim,relative=2,quote]
1846 \notemode{\set stanza = \markup{ \dynamic f 1. } }
1850 \notemode{\set stanza = \markup{ \dynamic p 2. } }
1857 @node Direction and placement
1858 @subsection Direction and placement
1860 Al tipografiar música, la dirección y colocación de muchos elementos
1861 es cuestión de elección. Por ejemplo, las plicas de las notas se
1862 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
1863 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
1864 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
1865 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
1866 LilyPond las determine automáticamente, pero en ciertos casos puede
1867 ser deseable forzar una dirección o colocación concreta.
1869 @strong{Acciones predeterminadas}
1871 De forma predeterminada algunas direcciones siempre son hacia arriba o
1872 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
1873 otras cosas pueden alternar entre arriba y abajo en función de la
1874 dirección de las plicas (como las ligaduras o los acentos).
1876 @c TODO Add table showing these
1878 @strong{Disposición de contexto}
1880 Los contextos se colocan dentro de un sistema de arriba a abajo en el
1881 orden en que se encuentran. Sin embargo, observe que se crea un
1882 contexto implícitamente si se encuentra una instrucción cuando no está
1883 disponible un contexto apropiado para contenerla.
1885 @c TODO Add example ?
1887 Se pude cambiar el orden predeterminado en que los contextos se
1888 presentan, véase @ref{Aligning contexts}
1890 @strong{Indicadores de dirección de las articulaciones}
1892 Al añadir articulaciones a notas se puede omitir normalmente el
1893 indicador de dirección, @code{^} (que significa @qq{arriba}), @code{_}
1894 (que significa @qq{abajo}) o @code{-} (que significa @qq{usar la
1895 dirección predeterminada}), en cuyo caso se supone el predeterminado
1896 @code{-}. Pero se necesita un indicador de dirección @strong{siempre}
1900 @item las instrucciones @code{\tweak}
1901 @item las instrucciones @code{\markup}
1902 @item las instrucciones @code{\tag}
1903 @item los marcados de cadena, p.ej. -"cadena"
1904 @item las instrucciones de digitación, p.ej. @code{-1}
1905 @item las abreviaturas de articulación, p.ej. @code{-.}, @code{->}, @code{--}
1908 Estas indicaciones afectan sólo a la nota siguiente.
1910 @lilypond[verbatim,quote,relative=2]
1917 @strong{La propiedad de dirección}
1919 La posición o dirección de muchos objetos de presentación está
1920 controlada por la propiedad @code{direction}.
1922 El valor de la propiedad @code{direction} se puede establecer al valor
1923 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
1924 @code{-1}, con el significado de @qq{hacia abajo} o @qq{debajo}. Se
1925 pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
1926 @code{1} y @code{-1} respectivamente. La dirección predeterminada se
1927 puede especificar estableciendo @code{direction} a @code{0} ó a
1928 @code{CENTER}. De forma alternativa, en muchos casos existen
1929 instrucciones predefinidas para especificar la dirección. Todas ellas
1933 @code{\xxxUp}, @code{xxxDown}, @code{xxxNeutral}
1936 donde @code{xxxNeutral} significa @qq{utilizar la dirección
1937 predeterminada}. Véase @rlearning{Within-staff objects}.
1939 En alguna que otra ocasión, con el único ejemplo usual del arpegio, el
1940 valor de la propiedad @code{direction} especifica si el objeto se debe
1941 colocar a la izquierda o a la derecha del objeto padre. En este caso
1942 @code{-1} ó @code{LEFT} significan @qq{a la izquierda} y @code{1} ó
1943 @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
1944 significan @qq{utilizar la dirección predeterminada}, como antes.
1946 Estas indicaciones afectan a todas las notas hasta que son canceladas.
1948 @lilypond[verbatim,quote,relative=2]
1958 @node Distances and measurements
1959 @subsection Distances and measurements
1961 @cindex distances, absolute
1962 @cindex distances, scaled
1969 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
1971 Las distancias absolutas se usan para especificar márgenes, sangrados
1972 y otros detalles de diseño de página, y de forma predeterminada se
1973 especifican en milímetros. Las distancias se pueden especificar en
1974 otras unidades escribiendo después de la cifra indicativa de la
1975 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
1976 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
1977 de página se pueden especificar también en unidades escalables (véase
1978 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
1979 La disposición de página se describe en detalle en @ref{Page
1982 Las distancias escaladas siempre se especifican en unidades de un
1983 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
1984 El espacio de pentagrama es la distancia entre dos líneas del
1985 pentagrama adyacentes. El valor predeterminado se puede cambiar
1986 globalmente fijando el tamaño global del pentagrama, o se puede
1987 sobreescribir localmente cambiando la propiedad @code{staff-space} del
1988 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
1989 automáticamente con cualquier cambio al tamaño global del pentagrama o
1990 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
1991 las fuentes tipográficas se escalan solamente con los cambios
1992 efectuados al tamaño global del pentagrama. Así, el tamaño global del
1993 pentagrama posibilita la fácil variación del tamaño general de una
1994 partitura impresa. Para ver los métodos de establecimiento del tamaño
1995 global del pentagrama, véase @ref{Setting the staff size}.
1999 Si se necesita dibujar sólo una sección de una partitura a una escala
2000 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2001 simplemente cambiar el tamaño global del pentagrama porque esto
2002 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2003 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2004 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2005 nuestra disposición una función de Scheme, @code{magstep}, para
2006 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2007 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2008 utilización, consulte @rlearning{Length and thickness of objects}.
2012 Manual de aprendizaje:
2013 @rlearning{Length and thickness of objects}.
2015 Referencia de la notación:
2016 @ref{Page formatting},
2017 @ref{Setting the staff size}.
2020 @node Staff symbol properties
2021 @subsection Staff symbol properties
2023 @cindex ajuste del símbolo del pentagrama
2024 @cindex dibujar el símbolo del pentagrama
2025 @cindex pentagrama, establecer el símbolo del
2027 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2028 @c Need to think of uses for these properties. Eg 'line-positions
2029 @c is used in a snippet to thicken centre line.
2030 @c If retained, add @ref to here in 1.6.2 -td
2032 Se puede definir al mismo tiempo la posición vertical de las líneas de
2033 la pauta y el número de líneas de la misma. Como muestra el siguiente
2034 ejemplo, las posiciones de las notas no están influidas por las
2035 posiciones de las líneas de la pauta.
2037 @warning{La propiedad @code{'line-positions} sobreescribe a la
2038 propiedad @code{'line-count}. El número de líneas de la pauta está
2039 definido implícitamente por el número de elementos de la lista de
2040 valores de @code{'line-positions}.}
2042 @lilypond[verbatim,quote,relative=1]
2044 \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
2049 Se puede modificar la anchura de la pauta. Las unidades son espacios
2050 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2051 resulta afectado por este ajuste.
2053 @lilypond[verbatim,quote,relative=1]
2055 \override StaffSymbol #'width = #23
2062 @subsection Spanners
2064 Muchos objetos de notación musical abarcan varias notas o incluso
2065 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2066 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2067 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2068 especiales para controlar su apariencia y comportamiento. Algunas de
2069 estas propiedades son comunes a todos los objetos de extensión; otras
2070 se limitan a un subconjunto de los extensores.
2072 Todos los objetos de extensión contemplan el interface
2073 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2074 una línea recta entre los dos objetos, contemplan también el interface
2075 @code{line-spanner-interface}.
2077 @unnumberedsubsubsec Using the @code{spanner-interface}
2079 Este interface proporciona dos propiedades que se aplican a varios
2082 @strong{@i{La propiedad @code{minimum-length}}}
2084 La longitud mínima del objeto de extensión se especifica a través de
2085 la propiedad @code{minimum-length}. Su aumento suele producir el
2086 efecto necesario de aumentar el espaciado de las notas entre los dos
2087 puntos extremos. Sin embargo, esta sobreescritura no tiene ningún
2088 efecto sobre muchos extensores, pues su longitud está determinada por
2089 otras consideraciones. Más abajo se muestran algunos ejemplos de
2100 Works as long as callback is made:
2104 Works not at all for:
2113 @lilypond[verbatim,quote,relative=2]
2116 % increase the length of the tie
2117 -\tweak #'minimum-length #5
2121 @lilypond[verbatim,quote,relative=2]
2123 \compressFullBarRests
2125 % increase the length of the rest bar
2126 \once \override MultiMeasureRest #'minimum-length = #20
2131 @lilypond[verbatim,quote,relative=2]
2133 % increase the length of the hairpin
2134 \override Hairpin #'minimum-length = #20
2138 Esta sobreescritura se puede usar también para aumentar la longitud de
2139 las ligaduras de expresión y de fraseo:
2141 @lilypond[verbatim,quote,relative=2]
2144 -\tweak #'minimum-length #5
2149 -\tweak #'minimum-length #5
2153 Para algunos objetos de presentación, la propiedad
2154 @code{minimum-length} es efectiva sólo si se llama explícitamente al
2155 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
2156 propiedad @code{springs-and-rods} al valor
2157 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
2158 de un glissando no tiene efecto a no ser que se establezca la
2159 propiedad @code{springs-and-rods}:
2161 @lilypond[verbatim,quote,relative=1]
2165 % not effective alone
2166 \once \override Glissando #'minimum-length = #20
2169 % effective only when both overrides are present
2170 \once \override Glissando #'minimum-length = #20
2171 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
2175 Lo mismo se puede decir del objeto @code{Beam}:
2177 @lilypond[verbatim,quote,relative=1]
2178 % not effective alone
2179 \once \override Beam #'minimum-length = #20
2182 % effective only when both overrides are present
2183 \once \override Beam #'minimum-length = #20
2184 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2188 @strong{@i{The @code{to-barline} property}}
2190 La segunda propiedad útil del @code{spanner-interface} es
2191 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2192 haciendo que los reguladores y otros objetos de extensión que terminan
2193 sobre la primera nota de un compás, en vez de eso terminen en la línea
2194 divisoria inmediatamente precedente. Si se establece al valor falso,
2195 el extensor llegará más allá de la barra de compás y terminará
2196 exactamente sobre la nota:
2198 @lilypond[verbatim,quote,relative=2]
2199 a \< a a a a \! a a a \break
2200 \override Hairpin #'to-barline = ##f
2201 a \< a a a a \! a a a
2204 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
2205 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2206 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2207 que terminar en la barra de compás no tendría ningún significado.
2209 @unnumberedsubsubsec Using the @code{line-spanner-interface}
2211 Entre los objetos que contemplan el interface
2212 @code{line-spanner-interface} se encuentran
2215 @item @code{DynamicTextSpanner}
2216 @item @code{Glissando}
2217 @item @code{TextSpanner}
2218 @item @code{TrillSpanner}
2219 @item @code{VoiceFollower}
2222 La rutina responsable de dibujar los sellos de estos extensores es
2223 @code{ly:line-interface::print}. esta rutina determina la
2224 localización exacta de los dos puntos extremos y traza una línea entre
2225 ellos, en el estilo solicitado. Las posiciones de los dos puntos
2226 extremos del extensor se calculan al vuelo, pero es posible
2227 sobreescribir sus coordenadas Y. Las propiedades que se deben
2228 especificar están anidadas a dos niveles de profundidad en la
2229 jerarquía de propiedades, pero la sintaxis de la instrucción
2230 @code{\override} es bastante sencilla:
2232 @lilypond[relative=2,quote,verbatim]
2234 \once \override Glissando #'(bound-details left Y) = #3
2235 \once \override Glissando #'(bound-details right Y) = #-2
2239 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2240 siendo el punto del cero la línea central del pentagrama. Para el
2241 glissando, esto es el valor de @code{Y} en la coordenada X que
2242 corresponde al punto central de cada cabeza de nota si nos imaginamos
2243 que la línea se extiende hasta allí.
2245 Si no está fijado @code{Y}, su valor se calcula a partir de la
2246 posición vertical del punto de anclaje correspondiente del extensor.
2248 En caso de salto de línea, los valores para los puntos extremos se
2249 especifican por las sub-listas @code{left-broken} y
2250 @code{right-broken} de @code{bound-details}. Por ejemplo:
2252 @lilypond[relative=2,ragged-right,verbatim,fragment]
2253 \override Glissando #'breakable = ##t
2254 \override Glissando #'(bound-details right-broken Y) = #-3
2255 c1 \glissando \break
2259 Un número de propiedades adicionales de las sub-listas @code{left} y
2260 @code{right} de la propiedad @code{bound-details} se pueden
2261 especificar de la misma forma que @code{Y}:
2265 Establece la coordenada Y del punto extremo, en desplazamientos de
2266 @code{staff-space}s desde la línea central del pentagrama. De forma
2267 predeterminada es el centro del objeto ancla, y así un glissando
2268 apunta al centro vertical de la cabeza de la nota.
2270 Para extensores horizontales como los extensores de texto y los
2271 trinos, está inamoviblemente codificado como 0.
2273 @item attach-dir (dirección de anclaje)
2274 Determina dónde comienza y termina la línea en la dirección X, con
2275 relación al objeto ancla. Sí, un valor de @code{-1} (o @code{LEFT},
2276 izquierda) hace que la línea comience o termine en el lado izquierdo
2277 de la cabeza de la nota a la que está anclado.
2280 Es la coordenada X absoluta del punto extremo. Se suele calcular al
2281 vuelo, y su sobreescritura no tiene un efecto útil.
2283 @item stencil (sello)
2284 Los extensores de línea pueden tener símbolos al comienzo o al final,
2285 lo que está contenido en esta sub-propiedad. Esto es para uso
2286 interno; se recomienda en su lugar el uso de @code{text}.
2289 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
2290 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2291 de extensión horizontales.
2293 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2294 \override TextSpanner #'(bound-details left text)
2295 = \markup { \small \bold Slower }
2296 c2\startTextSpan b c a\stopTextSpan
2299 @item stencil-align-dir-y (alineación del sello en y)
2300 @item stencil-offset (desplazamiento del sello)
2301 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2302 punto extremo, centrado sobre la línea, como viene definido por las
2303 subpropiedades @code{X} e @code{Y}. Si se fijan
2304 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2305 símbolo del borde verticalmente con relación al extremo de la línea:
2307 @lilypond[relative=1,fragment,verbatim]
2308 \override TextSpanner
2309 #'(bound-details left stencil-align-dir-y) = #-2
2310 \override TextSpanner
2311 #'(bound-details right stencil-align-dir-y) = #UP
2313 \override TextSpanner
2314 #'(bound-details left text) = #"ggg"
2315 \override TextSpanner
2316 #'(bound-details right text) = #"hhh"
2317 c4^\startTextSpan c c c \stopTextSpan
2320 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2321 al contrario de lo que podría esperarse, pues el valor de @code{-1} o
2322 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
2323 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
2324 (arriba) alinea el borde superior del texto con la línea extensora.
2326 @item arrow (flecha)
2327 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
2328 flecha en el extremo de la línea.
2330 @item padding (relleno)
2331 Esta sub-propiedad controla el espacio entre el punto extremo
2332 especificado de la línea y el extremo real. Sin relleno, un glissando
2333 empezaría y terminaría en el centro de la cabeza de las notas.
2337 La función musical @code{\endSpanners} finaliza de forma prematura el
2338 extensor que comienza sobre la nota que sigue inmediatamente a
2339 continuación. Se termina después de una nota exactamente, o en la
2340 siguiente barra de compás si @code{to-barline} es verdadero y se
2341 produce una divisoria antes de la siguiente nota.
2343 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
2345 c2 \startTextSpan c2 c2
2350 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
2351 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
2355 Referencia de funcionamiento interno:
2356 @rinternals{TextSpanner},
2357 @rinternals{Glissando},
2358 @rinternals{VoiceFollower},
2359 @rinternals{TrillSpanner},
2360 @rinternals{line-spanner-interface}.
2363 @node Visibility of objects
2364 @subsection Visibility of objects
2366 @cindex objetos, visibilidad de
2367 @cindex grobs, visibilidad de
2368 @cindex visibilidad de los objetos
2370 Hay cuatro formas principales en que se puede controlar la visibilidad
2371 de los objetos de presentación: se puede eliminar su sello, se pueden
2372 volver transparentes, se pueden pintar de blanco, o se puede
2373 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
2374 se aplican a todos los objetos de presentación; la última sólo a unos
2375 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
2376 introduce estas cuatro técnicas, véase @rlearning{Visibility and color
2379 Hay también algunas otras técnicas que son específicas de ciertos
2380 objetos de presentación. Se estudian bajo Consideraciones especiales.
2383 * Removing the stencil::
2384 * Making objects transparent::
2385 * Painting objects white::
2386 * Using break-visibility::
2387 * Special considerations::
2391 @node Removing the stencil
2392 @unnumberedsubsubsec Removing the stencil
2394 @cindex sello, eliminar
2396 Todo objeto de presentación tiene una propiedad stencil (sello). De
2397 forma predeterminada está establecida a la función específica que
2398 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
2399 se llama a ninguna función y el objeto no se dibuja. La acción
2400 predeterminada se puede recuperar con @code{\revert}.
2402 @lilypond[quote,verbatim,relative=1]
2404 \override Score.BarLine #'stencil = ##f
2406 \revert Score.BarLine #'stencil
2410 @node Making objects transparent
2411 @unnumberedsubsubsec Making objects transparent
2413 @cindex transparentes, hacer los objetos
2415 Todo objeto de presentación tiene una propiedad transparent
2416 (transparente) que de forma predeterminada está establecida a
2417 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
2420 @lilypond[quote,verbatim,relative=2]
2422 \once \override NoteHead #'transparent = ##t
2426 @node Painting objects white
2427 @unnumberedsubsubsec Painting objects white
2429 @cindex objetos, coloreado de
2430 @cindex coloreado de objetos
2432 @cindex impresión, orden de
2433 @cindex sobreescritura de objetos
2434 @cindex objetos, sobreescritura de
2435 @cindex grobs, sobreescritura de
2437 Todo objeto de presentación tiene una propiedad de color que de forma
2438 predeterminada está establecida a @code{black} (negro). Si se
2439 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
2440 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
2441 color de los puntos de cruce queda determinado por el orden en que se
2442 dibujan estos objetos, lo que puede dejar una imagen fantasma del
2443 objeto blanco, como puede verse aquí:
2445 @lilypond[quote,verbatim,relative=2]
2446 \override Staff.Clef #'color = #white
2450 Se puede evitar esto cambiando el orden de impresión de los objetos.
2451 Todos los objetos de presentación tienen una propiedad @code{layer}
2452 (capa) que se debe establecer a un valor entero. Los objetos con el
2453 valor de @code{layer} más bajo se dibujan primero, después se dibujan
2454 los objetos con valores progresivamente mayores, y así los objetos con
2455 valores más altos se dibujan encima de los que tienen valores más
2456 bajos. De forma predeterminada, casi todos los objetos tienen
2457 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
2458 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
2459 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
2460 impresión de los objetos con el mismo valor de @code{layer} es
2463 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
2464 predeterminado de @code{1}, se dibuja después de las líneas del
2465 pentagrama (valor @code{layer} predeterminado de @code{0}),
2466 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
2467 @code{Clef} un valor de @code{layer} más bajo, digamos @code{-1}, para
2468 que se dibuje antes:
2470 @lilypond[quote,verbatim,relative=2]
2471 \override Staff.Clef #'color = #white
2472 \override Staff.Clef #'layer = #-1
2476 @node Using break-visibility
2477 @unnumberedsubsubsec Using break-visibility
2479 @c TODO Add making other objects breakable
2481 @cindex break-visibility
2483 Casi todos los objetos de presentación se imprimen una sola vez, pero
2484 algunos como las líneas divisorias, claves, indicaciones de compás y
2485 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
2486 se produce un salto de línea : una vez al final de la línea y otra al
2487 comienzo de la siguiente. Estos objetos reciben el nombre de
2488 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
2489 (visibilidad en el salto), para controlar su visibilidad en las tres
2490 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
2491 la línea si se produce un cambio, y al final de la línea si el cambio
2492 se produce en ese lugar.
2494 Por ejemplo, la indicación de compás se imprime de forma
2495 predeterminada al comienzo de la primera línea y en ningún otro lugar
2496 a no ser que cambie, en cuyo caso se imprime en el punto en que se
2497 produce el cambio. Si este cambio se produce al final de una línea,
2498 la nueva indicación de compás se imprime al principio de la línea
2499 siguiente y también al final de la línea anterior como indicación de
2502 Este comportamiento se controla por medio de la propiedad
2503 @code{break-visibility}, que se explica en
2504 @c Leave this ref on a newline - formats incorrectly otherwise -td
2505 @rlearning{Visibility and color of objects}. Esta propiedad toma un
2506 vector de tres valores booleanos que, por orden, determinan si el
2507 objeto se imprime al final, dentro, o al principio de la línea. O,
2508 para ser más exactos: antes del salto de línea, si no hay salto, o
2511 Como alternativa se puede especificar cualquiera de las ocho
2512 combinaciones mediante funciones predefinidas cuya definición está en
2513 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
2514 los objetos de presentación serán visibles en las posiciones que se
2515 muestran en el encabezamiento de cada columna:
2517 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {yes} {yes} {yes}
2518 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
2519 @headitem de función @tab de vector @tab salto @tab salto @tab salto
2521 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
2522 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
2523 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
2524 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
2525 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
2526 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
2527 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
2528 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
2531 Los ajustes predeterminados de @code{break-visibility} dependen del
2532 objeto de presentación. La tabla siguiente muestra todos los objetos
2533 de presentación de interés que resultan afectados por
2534 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
2536 @multitable @columnfractions .3 .3 .4
2538 @headitem Objeto @tab Contexto usual @tab Valor predet.
2540 @c omit Ambitus as it appears not to be affected by break-visibility -td
2541 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
2542 @item @code{BarLine} @tab @code{Score} @tab calculado
2543 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
2544 @c omit the following item until it can be explained -td
2545 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculated
2546 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2547 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
2548 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
2549 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2550 @c omit KeyCancellation until it can be explained -td
2551 @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible}
2552 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
2553 @c omit LeftEdge until it can be explained -td
2554 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
2555 @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible}
2556 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
2557 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
2561 El ejemplo de abajo muestra el uso de la forma de vector para
2562 controlar la visibilidad de las líneas divisorias:
2564 @lilypond[quote,verbatim,relative=1,ragged-right]
2567 % Remove bar line at the end of the current line
2568 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
2574 Aunque los tres componentes del vector utilizado para sobreescribir
2575 @code{break-visibility} deben estar presentes, no todos son efectivos
2576 para todos los objetos de presentación, y algunas combinaciones pueden
2577 incluso dar errores. Son de aplicación las siguientes limitaciones:
2580 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
2581 @item No se puede imprimir el número de compás al principio de la primera
2582 línea a no ser que su valor establecido sea distinto de 1.
2583 @item Clave: véase más abajo
2584 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
2585 se suprimen por completo. Utilice begin-of line-invisible para
2586 imprimirlas y all-invisible para suprimirlas.
2587 @item Armadura: véase más abajo
2588 @item OctavateEight: véase más abajo
2591 @node Special considerations
2592 @unnumberedsubsubsec Special considerations
2594 @strong{@emph{Visibilidad después de un cambio explícito}}
2596 @cindex armadura, visibilidad después de un cambio explícito
2597 @cindex explicitKeySignatureVisibility
2598 @cindex clave, visibilidad después de un cambio explícito
2599 @cindex explicitClefVisibility
2601 La propiedad @code{break-visibility} controla la visibilidad de las
2602 armaduras y cambios de clave sólo al principio de las líneas, es
2603 decir, después de un salto. No tiene ningún efecto sobre la
2604 visibilidad de la armadura o la clave después de un cambio explícito
2605 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
2606 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
2607 bemol mayor es visible incluso con @code{all-invisible} establecido.
2609 @lilypond[quote,verbatim,relative=1,ragged-right]
2612 % Try to remove all key signatures
2613 \override Staff.KeySignature #'break-visibility = #all-invisible
2621 La visibilidad de estos cambios explícitos de tonalidad y de clave se
2622 controla por medio de las propiedades
2623 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
2624 Son los equivalentes de la propiedad @code{break-visibility} y las dos
2625 toman un vector de tres valores booleanos o las funciones predefinidas
2626 relacionadas anteriormente, exactamente igual que
2627 @code{break-visibility}. Las dos son propiedades del contexto Staff,
2628 no de los propios objetos de presentación, y por tanto se establecen
2629 utilizando la instrucción @code{\set}. Las dos están establecidas de
2630 forma predeterminada al valor @code{all-visible}. Estas propiedades
2631 controlan sólo la visibilidad de las armaduras y las claves que
2632 resultan de los cambios explícitos y no afectan a las armaduras y
2633 tonalidades que están al principio de las líneas; para quitarlas, aún
2634 se debe sobreescribir la propiedad @code{break-visibility} en el
2635 objeto correspondiente.
2637 @lilypond[quote,verbatim,relative=1,ragged-right]
2640 \set Staff.explicitKeySignatureVisibility = #all-invisible
2641 \override Staff.KeySignature #'break-visibility = #all-invisible
2648 @strong{@emph{Visibilidad de las alteraciones de precaución}}
2650 Para eliminar las alteraciones de precaución que se imprimen en un
2651 cambio de tonalidad explícito, establezca la propiedad
2652 @code{printKeyCancellation} del contexto Staff a @code{#f}:
2654 @lilypond[quote,verbatim,relative=1,ragged-right]
2657 \set Staff.explicitKeySignatureVisibility = #all-invisible
2658 \set Staff.printKeyCancellation = ##f
2659 \override Staff.KeySignature #'break-visibility = #all-invisible
2666 Con estas sobreescrituras solamente permanecen las alteraciones
2667 accidentales delante de las notas para indicar el cambio de tonalidad.
2669 @c TODO Add visibility of cautionary accidentals before notes
2671 @strong{@emph{Automatic bars}}
2673 @cindex automaticBars
2674 @cindex líneas divisorias, eliminación
2676 Como caso especial, la impresión de las líneas divisorias también se
2677 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
2678 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
2679 imprimen automáticamente; se deben crear explícitamente con una
2680 instrucción @code{\bar}. A diferencia de la instrucción predefinida
2681 @code{\cadenzaOn}, los compases se siguen contando. La generación de
2682 compases continúa de acuerdo a esta cuenta si esta propiedad se
2683 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
2684 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
2689 @strong{@emph{Octavated clefs}}
2691 @cindex octavadas, visibilidad de las claves
2692 @cindex visibilidad de las claves octavadas
2693 @cindex claves, visibilidad de la octavación
2695 El pequeño símbolo de octava sobre las claves en octava alta o baja se
2696 produce por parte del objeto @code{OctavateEight}. Su visibilidad se
2697 controla independientemente de la del objeto @code{Clef}, así que es
2698 necesario aplicar las sobreescrituras correspondientes
2699 @code{break-visibility} tanto a los objetos @code{Clef} como
2700 @code{OctavateEight} para suprimir completamente estos símbolos de
2701 clave al comienzo de cada línea.
2703 Para los cambios de clave explícitos, la propiedad
2704 @code{explicitClefVisibility} controla tanto el símbolo de clave como
2705 el símbolo de octava asociado.
2709 Manual de aprendizaje:
2710 @rlearning{Visibility and color of objects}
2714 @subsection Line styles
2716 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
2717 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
2718 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
2720 Todos ellos usan las mismas rutinas que el glissando para dibujar los
2721 textos y las líneas, y por ello el ajuste fino de su comportamiento se
2722 hace de la misma manera. Se hace con un spanner (un objeto de
2723 extensión), y la rutina responsable de dibujar los objetos de
2724 extensión es @code{ly:line-interface::print}. Esta rutina determina la
2725 colocación exacta de los dos @i{extremos del objeto de extensión} y
2726 dibuja una línea entre ellos, en el estilo solicitado.
2728 He aquí un ejemplo de los distintos estilos de línea disponibles, y
2729 cómo aplicarles ajustes finos.
2731 @lilypond[relative=2,ragged-right,verbatim,fragment]
2733 \once \override Glissando #'style = #'dashed-line
2735 \override Glissando #'style = #'dotted-line
2737 \override Glissando #'style = #'zigzag
2739 \override Glissando #'style = #'trill
2743 Las posiciones de los puntos extremos del objeto de extensión se
2744 computan al vuelo para cada uno de los objetos gráficos, pero es
2745 posible sobreescribirlos:
2747 @lilypond[relative=2,ragged-right,verbatim,fragment]
2749 \once \override Glissando #'(bound-details right Y) = #-2
2753 El valor de @code{Y} está establecido a @code{-2} para el extremo
2754 derecho. El lado izquierdo se puede ajustar de forma similar
2755 especificando @code{left} en vez de @code{right}.
2757 Si no está establecido @code{Y}, el valor se computa a partir de la
2758 posición vertical de los puntos de anclaje izquierdo y derecho del
2761 Son posibles otros ajustes de los extensores, para ver más detalles
2762 consulte @ref{Spanners}.
2765 @node Rotating objects
2766 @subsection Rotating objects
2768 Tanto los objetos de presentación como los elementos de texto de
2769 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
2770 pero difiere el método de hacerlo.
2773 * Rotating layout objects::
2777 @node Rotating layout objects
2778 @unnumberedsubsubsec Rotating layout objects
2780 @cindex rotating objects
2781 @cindex objects, rotating
2783 Todos los objetos de presentación que contemplan el interface
2784 @code{grob-interface} se pueden rotar estableciendo su propiedad
2785 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
2786 rotación en sentido antihorario, y las coordenadas x e y del punto con
2787 relación al punto de referencia del objeto, alrededor del que se va a
2788 realizar la rotación. El ángulo de rotación se especifica en grados
2789 y las coordenadas en espacios de pentagrama.
2791 El ángulo de rotación y las coordenadas del punto de rotación se deben
2792 determinar por ensayo y error.
2794 @cindex reguladores en ángulo
2795 @cindex ángulo, reguladores en
2797 Solamente en ciertas ocasiones es útil la rotación de objetos de
2798 presentación; el ejemplo siguiente muestra una situación en que puede
2801 @lilypond[quote,verbatim,relative=1]
2803 \override Hairpin #'rotation = #'(20 -1 0)
2807 @node Rotating markup
2808 @unnumberedsubsubsec Rotating markup
2810 Todos los textos de marcado se pueden rotar para que se dispongan en
2811 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
2812 instrucción acepta dos argumentos: el ángulo de rotación en grados en
2813 sentido antihorario, y el texto que rotar. Los límites que ocupa el
2814 texto no se rotan: toman su valor a partir de los extremos de las
2815 coordenadas x e y del texto rotado. En el ejemplo siguiente la
2816 propiedad @code{outside-staff-priority} del texto se establece a
2817 @code{#f} para desactivar la evitación automática de colisiones, lo
2818 que empuja al texto a una posición muy alta.
2820 @lilypond[quote,verbatim,relative=1]
2821 \override TextScript #'outside-staff-priority = ##f
2822 g4^\markup { \rotate #30 "a G" }
2823 b^\markup { \rotate #30 "a B" }
2824 des^\markup { \rotate #30 "a D-Flat" }
2825 fis^\markup { \rotate #30 "an F-Sharp" }
2828 @node Advanced tweaks
2829 @section Advanced tweaks
2831 Esta sección trata sobre distintos enfoques en la realización de
2832 ajustes finos a la apariencia de la partitura impresa.
2835 * Aligning objects::
2836 * Vertical grouping of grobs::
2837 * Modifying stencils::
2838 * Modifying shapes::
2843 Manual de aprendizaje:
2844 @rlearning{Tweaking output},
2845 @rlearning{Other sources of information}.
2847 Referencia de la notación:
2848 @ref{Explaining the Internals Reference},
2849 @ref{Modifying properties},
2850 @ref{Interfaces for programmers}.
2853 @file{scm/@/define@/-grobs@/.scm}.
2855 Fragmentos de código:
2856 @rlsr{Tweaks and overrides}.
2858 Referencia de funcionamiento interno:
2859 @rinternals{All layout objects}.
2862 @node Aligning objects
2863 @subsection Aligning objects
2865 Los objetos gráficos que soportan el interface
2866 @code{self-alignment-interface} y/o el @code{side-position-interface}
2867 se pueden alinear contra un objeto colocado previamente, de diversas
2868 maneras. Para ver una lista de estos objetos, consulte
2869 @rinternals{self-alignment-interface} y
2870 @rinternals{side-position-interface}.
2872 Todos los objetos gráficos tienen un punto de referencia, una
2873 extensión horizontal y una extensión vertical. La extensión
2874 horizontal es una pareja de números que dan los desplazamientos a
2875 partir del punto de referencia de los bordes izquierdo y derecho,
2876 siendo negativos los desplazamientos hacia la izquierda. La extensión
2877 vertical es una pareja de números que dan el desplazamiento a partir
2878 del punto de referencia hasta los bordes inferior y superior, siendo
2879 negativos los desplazamientos hacia abajo.
2881 La posición de un objeto sobre el pentagrama viene dada por los
2882 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
2883 valor de @code{X-offset} da el desplazamiento desde la coordenada x
2884 del punto de referencia del objeto padre, y el valor de
2885 @code{Y-offset} da el desplazamiento a partir de la línea central del
2886 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
2887 pueden establecer directamente o se puede dejar que se calculen por
2888 parte de procedimientos para conseguir una alineación con el objeto
2889 padre de distintas maneras.
2891 @warning{Muchos objetos tienen consideraciones de posicionamiento
2892 especiales que hacen que se ignore o se modifique cualquier ajuste
2893 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
2894 objeto contemple el interface @code{self-alignment-interface}.}
2896 Por ejemplo, una alteración accidental se puede reposicionar
2897 verticalmente estableciendo @code{Y-offset} pero los cambios a
2898 @code{X-offset} no tienen ningún efecto.
2900 Las letras de ensayo se pueden alinear con objetos divisibles como
2901 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
2902 propiedades especiales que se encuentran en
2903 @code{break-aligned-interface} para el posicionamiento de las letras
2904 de ensayo sobre dichos objetos.
2907 * Setting @code{X-offset} and @code{Y-offset} directly::
2908 * Using the @code{side-position-interface}::
2909 * Using the @code{self-alignment-interface}::
2910 * Using the @code{break-alignable-interface}::
2913 @node Setting @code{X-offset} and @code{Y-offset} directly
2914 @unnumberedsubsubsec Setting @code{X-offset} and @code{Y-offset} directly
2916 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
2917 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
2918 notas con una digitación en su posición predeterminada y con los
2919 valores @code{X-offset} y @code{Y-offset} modificados.
2921 @lilypond[verbatim,quote,relative=2]
2924 -\tweak #'X-offset #0
2925 -\tweak #'Y-offset #0
2928 -\tweak #'X-offset #-1
2929 -\tweak #'Y-offset #1
2935 @node Using the @code{side-position-interface}
2936 @unnumberedsubsubsec Using the @code{side-position-interface}
2938 Un objeto que contempla el @code{side-position-interface} se puede
2939 colocar junto a su objeto padre de forma que los bordes especificados
2940 de los dos objetos se toquen. El objeto se puede situar encima,
2941 debajo, a la derecha o a la izquierda del objeto padre. El padre no
2942 se puede especificar; viene determinado por el orden de los elementos
2943 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
2944 nota asociada como padre.
2946 Los valores de las propiedades @code{side-axis} y @code{direction}
2947 determinan dónde colocar el objeto, como sigue:
2949 @c TODO add an example of each to the table
2951 @multitable @columnfractions .3 .3 .3
2952 @headitem @code{side-axis} @tab @code{direction} @tab
2953 @headitem propiedad @tab propiedad @tab colocación
2955 @item @code{0} @tab @code{-1} @tab izquierda
2956 @item @code{0} @tab @code{1} @tab derecha
2957 @item @code{1} @tab @code{-1} @tab debajo
2958 @item @code{1} @tab @code{1} @tab encima
2962 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
2963 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
2964 procedimiento devuelve el calor correcto de @code{X-offset} para
2965 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
2966 el valor de @code{direction}.
2968 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
2969 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
2970 procedimiento devuelve el valor correcto de @code{Y-offset} para
2971 situar el objeto encima o debajo del padre de acuerdo con el valor de
2974 @c TODO Add examples
2976 @node Using the @code{self-alignment-interface}
2977 @unnumberedsubsubsec Using the @code{self-alignment-interface}
2979 @emph{Auto-alineación horizontal de los objetos}
2981 La alineación horizontal de un objeto que contempla el interface
2982 @code{self-alignment-interface} está controlada por el valor de la
2983 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
2984 @code{X-offset} de este objeto esté establecida a
2985 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
2986 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
2987 mitad de la extensión X total del objeto. Los valores negativos
2988 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
2989 valor de @code{0} centra el objeto sobre el punto de referencia de su
2990 padre, un valor de @code{-1} alinea el borde izquierdo del objeto
2991 sobre el punto de referencia de su padre, y un valor de @code{1}
2992 alinea el borde derecho del objeto sobre el punto de referencia de su
2993 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
2994 @code{RIGHT} en sustitución de los valores @code{-1, 0, 1},
2997 Normalmente se usaría la instrucción @code{\override} para modificar
2998 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
2999 @code{\tweak} para alinear varias anotaciones por separado sobre una
3002 @lilypond[quote,verbatim,relative=1]
3004 -\tweak #'self-alignment-X #-1
3006 -\tweak #'self-alignment-X #0
3008 -\tweak #'self-alignment-X #RIGHT
3010 -\tweak #'self-alignment-X #-2.5
3011 ^"aligned further to the right"
3014 @emph{Auto-alineación vertical de los objetos}
3016 Los objetos se pueden alinear verticalmente en una forma análoga a la
3017 alineación horizontal si la propiedad @code{Y-offset} está establecida
3018 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
3019 a menudo se encuentran implicados otros mecanismos en la alineación
3020 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
3021 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
3022 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
3023 las dimensiones verticales del objeto, que suele ser bastante pequeño,
3024 por lo que pueden requerirse números bastante grandes. Un valor de
3025 @code{-1} alinea el borde inferior del objeto con el punto de
3026 referencia del objeto padre, un valor de @code{0} alinea el centro del
3027 objeto con el punto de referencia del padre, y un valor de @code{1}
3028 alinea el borde superior del objeto con el punto de referencia del
3029 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
3030 @code{UP} en sustitución de @code{-1, 0, 1} respectivamente.
3032 @emph{Auto-alineación de objetos en las dos direcciones}
3034 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
3035 alinear un objeto en las dos direcciones simultáneamente.
3037 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
3038 se acerque a la cabeza de la nota.
3040 @lilypond[quote,verbatim,relative=2]
3042 -\tweak #'self-alignment-X #0.5 % move horizontally left
3043 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
3044 -\tweak #'self-alignment-Y #-1 % move vertically up
3049 @unnumberedsubsubsec Using the @code{aligned-on-parent} procedures
3051 @c Cannot document as they do not seem to operate consistently on all objects -td
3052 @c TODO investigate further
3054 The @code{aligned-on-parent} procedures are used in the same way
3055 as the @code{aligned-on-self} procedures, they difference being
3056 that they permit an object to be aligned with the @emph{edges} of
3057 the parent rather than the parent's reference point. The following
3058 example shows the difference:
3062 @lilypond[verbatim,quote]
3068 @unnumberedsubsubsec Using the @code{centered-on-parent} procedures
3070 @c Cannot document as they do not seem to operate consistently on all objects -td
3071 @c TODO investigate further
3075 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
3078 @node Using the @code{break-alignable-interface}
3079 @unnumberedsubsubsec Using the @code{break-alignable-interface}
3081 @cindex alineación a objetos
3082 @cindex break-align-symbols
3084 Las letras de ensayo se pueden alinear con objetos de notación
3085 distintos a las barras de compás. Estos objetos son @code{ambitus},
3086 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
3087 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
3088 @code{time-signature}.
3090 De forma predeterminada, las letras de ensayo y los números de compás
3091 se centran horizontalmente sobre el objeto:
3093 @lilypond[verbatim,quote,relative=1]
3095 % the RehearsalMark will be centered above the Clef
3096 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
3101 % the RehearsalMark will be centered above the TimeSignature
3102 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
3110 Se puede especificar una lista de posibles objetos para la alineación.
3111 Si algunos de los objetos son invisibles en ese punto debido al valor
3112 de @code{break-visibility} o a valores de visibilidad explícitos para
3113 las armaduras y las claves, la letra de ensayo o número de compás se
3114 alinean con el primer objeto de la lista que sea visible. Si ningún
3115 objeto de la lista es visible, el objeto se alinea con la línea
3116 divisoria. Si la línea divisoria es invisible, el objeto se alinea
3117 con el punto en el que se encontraría la línea divisoria.
3119 @lilypond[verbatim,quote,relative=1]
3121 % the RehearsalMark will be centered above the Key Signature
3122 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3127 % the RehearsalMark will be centered above the Clef
3128 \set Staff.explicitKeySignatureVisibility = #all-invisible
3129 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3136 La alineación de la letra de ensayo con relación al objeto de notación
3137 se puede cambiar, como se ve en el ejemplo siguiente. En una
3138 partitura con varios pentagramas, este ajuste se debe hacer para todos
3141 @lilypond[verbatim,quote,relative=1]
3142 % The RehearsalMark will be centered above the KeySignature
3143 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3149 % The RehearsalMark will be aligned with the left edge of the KeySignature
3150 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
3154 % The RehearsalMark will be aligned with the right edge of the KeySignature
3155 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
3161 La letra de ensayo también se puede desplazar al borde derecho o
3162 izquierdo en una medida arbitraria. Las unidades son espacios de
3165 @lilypond[verbatim,quote,relative=1]
3166 % The RehearsalMark will be aligned with the left edge of the KeySignature
3167 % and then shifted right by 3.5 staff-spaces
3168 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3169 \once \override Score.KeySignature #'break-align-anchor = #3.5
3173 % The RehearsalMark will be aligned with the left edge of the KeySignature
3174 % and then shifted left by 2 staff-spaces
3175 \once \override Score.KeySignature #'break-align-anchor = #-2
3182 @node Vertical grouping of grobs
3183 @subsection Vertical grouping of grobs
3185 Los grobs (objetos gráficos) @code{VerticalAlignment} y
3186 @code{VerticalAxisGroup} trabajan de manera coordinada.
3187 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
3188 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
3189 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
3190 Normalmente sólo existe un @code{VerticalAlignment} por cada
3191 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
3192 @code{VerticalAxisGroup}.
3195 @node Modifying stencils
3196 @subsection Modifying stencils
3198 Todos los objetos de presentación tienen una propiedad @code{stencil}
3199 que es parte del @code{grob-interface}. De forma predeterminada, esta
3200 propiedad suele estar establecida a una función específica del objeto
3201 que está hecha a medida para disponer el símbolo que lo representa en
3202 la salida. Por ejemplo, el ajuste estándar para la propiedad
3203 @code{stencil} del objeto @code{MultiMeasureRest} es
3204 @code{ly:multi-measure-rest::print}.
3206 El símbolo estándar de cualquier objeto se puede sustituir modificando
3207 la propiedad @code{stencil} para que haga referencia a un
3208 procedimiento diferente escrito especialmente. Esto requiere un alto
3209 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3210 una forma más fácil que a menudo puede dar resultados adecuados.
3212 El procedimiento es establecer la propiedad @code{stencil} al
3213 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3214 añadir una propiedad @code{text} al objeto ajustada para que contenga
3215 el texto de marcado que produce el símbolo requerido. Debido a la
3216 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3217 particular, consulte @ref{Graphic notation inside markup}.
3219 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3220 la nota a unas aspas dentro de una circunferencia.
3222 @lilypond[verbatim,quote]
3224 \once \override NoteHead #'stencil = #ly:text-interface::print
3225 \once \override NoteHead #'text = \markup {
3227 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3228 \musicglyph #"noteheads.s2cross"
3236 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3237 a la instrucción de marcado @code{\musicglyph}: véase @ref{The Feta
3240 @c TODO Add inserting eps files or ref to later
3242 @c TODO Add inserting Postscript or ref to later
3246 Referencia de la notación:
3247 @ref{Graphic notation inside markup},
3248 @ref{Formatting text},
3249 @ref{Text markup commands},
3250 @ref{The Feta font}.
3253 @node Modifying shapes
3254 @subsection Modifying shapes
3257 * Modifying ties and slurs::
3260 @node Modifying ties and slurs
3261 @unnumberedsubsubsec Modifying ties and slurs
3263 @cindex ligaduras de expresión, modificar
3264 @cindex ligaduras de unión, modificar
3265 @cindex Bézier, curvas de
3266 @cindex Bézier, puntos de control
3268 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
3269 de Bézier de tercer orden. Si la forma de la ligadura calculada
3270 automáticamente no resulta óptima, se puede modificar su forma
3271 manualmente mediante la especificación explícita de los cuatro puntos
3272 de control necesarios para definir una curva de Bézier de tercer
3275 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
3276 puntos de control. El primer y cuarto puntos de control son
3277 exactamente los puntos extremos de comienzo y de final de la curva.
3278 Los dos puntos de control intermedios definen la forma. Se pueden
3279 encontrar en la web animaciones que muestran cómo se traza la curva,
3280 pero la descripción siguiente puede ser de ayuda. La curva comienza a
3281 partir del primer punto de control dirigiéndose directamente hacia el
3282 segundo, curvándose progresivamente para dirigirse hacia el tercero y
3283 continuando la curva hacia el cuarto, llegando a éste en viaje directo
3284 desde el tercer punto de control. La curva está contenida enteramente
3285 dentro del cuadrilátero definido por los cuatro puntos de control.
3287 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
3288 @code{\tieDown} no sirve de ayuda.
3290 @lilypond[verbatim,quote,relative=1]
3294 { r4 <g c,> <g c,> <g c,> }
3298 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
3299 de control como sigue.
3301 Las coordenadas de los puntos de control de Bézier se especifican en
3302 unidades de espacios de pentagrama. La coordenada@tie{}X está en
3303 relación con el punto de referencia de la nota a la que está unida la
3304 ligadura, y la coordenada@tie{}Y está en relación con la línea central
3305 del pentagrama. Las coordenadas se introducen como una lista de
3306 cuatro parejas de números decimales (reales). Un enfoque es estimar
3307 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
3308 los dos puntos intermedios. Los valores óptimos se encuentran por
3311 Es útil recordar que una curva simétrica necesita puntos de control
3312 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
3313 las transformaciones de la curva tales como la traslación, rotación y
3314 escalado se pueden obtener aplicando la misma transformación a los
3315 puntos de control de la curva.
3317 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
3318 satisfactoria. Observe la colocación: debe ir inmediatamente antes de
3319 la nota a la que se asigna el comienzo de la ligadura de expresión o
3322 @lilypond[verbatim,quote,relative=1]
3326 #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
3330 { r4 <g c,> <g c,> <g c,>4 }
3336 No es posible modificar la forma de las ligaduras de unión o de
3337 expresión cambiando la propiedad @code{control-points} si hay más de
3338 una en el mismo momento musical, ni siquiera usando la instrucción