1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
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 Cambiar los valores por omisión
13 @chapter Cambiar los valores por omisión
14 @translationof Changing defaults
16 El objetivo del diseño de LilyPond es proporcionar la más alta calidad
17 de los resultados, de forma predeterminada. A pesar de ello, podría
18 tener que cambiar este resultado predeterminado. La disposición sobre
19 el papel se controla a través de un amplio número de @q{botones e
20 interruptores} llamados en su conjunto @q{propiedades}. En el Manual
21 de aprendizaje podemos encontrar una introducción en forma de tutorial
22 al acceso y modificación de estas propiedades, véase
23 @rlearning{Trucar la salida}. Éste debería leerse en primer lugar.
24 Este capítulo cubre un terreno similar, pero con un estilo más
25 adecuado para un manual de referencia.
27 @cindex Referencia de funcionamiento interno
29 La descripción definitiva de los controles que están disponibles para
30 su ajuste fino están en un documento aparte: @rinternalsnamed{Top,la
31 Referencia de funcionamiento interno}. Dicho manual relaciona todas
32 las variables, funciones y opciones que se encuentran disponibles en
33 LilyPond. Está escrito como un documento HTML, que se puede encontrar
35 @c leave the @uref as one long line.
36 @uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,on@/-line},
37 pero que también va incluido en el paquete de la documentación de LilyPond.
39 Internamente, LilyPond utiliza el lenguaje Scheme (un dialecto de
40 LISP) para aportar la infraestructura. La sobreescritura de las
41 decisiones de disposición da acceso efectivo a las interioridades del
42 programa, lo que requiere código de Scheme como entrada. Los
43 elementos de Scheme se inauguran dentro de un archivo @code{.ly} con
44 el símbolo de cuadradillo @code{#}.@footnote{@rlearning{Tutorial de Scheme} contiene un breve tutorial sobre la introducción de números,
45 listas, cadenas y símbolos en Scheme.}
48 * Contextos de interpretación::
49 * Explicación del Manual de referencia de funcionamiento interno::
50 * Modificar las propiedades::
51 * Conceptos y propiedades útiles::
56 @node Contextos de interpretación
57 @section Contextos de interpretación
58 @translationof Interpretation contexts
60 Esta sección explica qué son los contextos y cómo modificarlos.
63 * Explicación de los contextos::
65 * Mantener vivos los contextos::
66 * Modificar los complementos (plug-ins) de contexto::
67 * Cambiar los valores por omisión de los contextos::
68 * Definir contextos nuevos::
69 * Alinear los contextos::
74 Manual de aprendizaje:
75 @rlearning{Contextos y grabadores}.
78 @file{ly/@/engraver@/-init@/.ly},
79 @file{ly/@/performer@/-init@/.ly}.
82 @rlsr{Contexts and engravers}.
84 Referencia de funcionamiento interno:
85 @rinternals{Contexts},
86 @rinternals{Engravers and Performers}.
89 @node Explicación de los contextos
90 @subsection Explicación de los contextos
91 @translationof Contexts explained
93 Los contextos se disponen de forma jerárquica:
96 * Score: el contexto maestro::
97 * Contextos del nivel superior: contenedores de pentagramas::
98 * Contextos de nivel intermedio: pentagramas::
99 * Contextos del nivel más bajo: voces::
102 @node Score: el contexto maestro
103 @unnumberedsubsubsec Score: el contexto maestro
104 @translationof Score - the master of all contexts
106 Este es el contexto de notación del nivel más alto. Ningún otro
107 contexto puede contener a un contexto Score. De forma predeterminada,
108 el contexto Score maneja la administración de las indicaciones de
109 compás y se asegura de que ciertos elementos como claves, compases y
110 armaduras están siempre alineados entre los distintos pentagramas.
112 Se crea implícitamente una instancia del contexto Score cuando se
113 procesa un bloque @code{\score @{@dots{}@}} o @code{\layout
114 @{@dots{}@}}, o explícitamente cuando se ejecuta una instrucción
117 @node Contextos del nivel superior: contenedores de pentagramas
118 @unnumberedsubsubsec Contextos del nivel superior: contenedores de pentagramas
119 @translationof Top-level contexts - staff containers
121 @strong{@emph{StaffGroup}}
123 Agrupa pentagramas y añade un corchete en la parte izquierda, formando
124 un grupo. Las líneas divisorias de los pentagramas contenidos se
125 conectan verticalmente. @code{StaffGroup} sólo consiste en una
126 colección de pentagramas, con un corchete delante y líneas divisorias
129 @strong{@emph{ChoirStaff}}
131 Idéntico a @code{StaffGroup} excepto que las barras de compás de los
132 pentagramas contenidos no se conectan verticalmente.
134 @strong{@emph{GrandStaff}}
136 Un grupo de pentagramas, con una llave en la parte izquierda que
137 abarca el grupo. Las barras de compás de los pentagramas contenidos
138 se conectan verticalmente.
140 @strong{@emph{PianoStaff}}
142 Igual que @code{GrandStaff}, pero contempla la posibilidad de poner el
143 nombre del instrumento a la izquierda del sistema.
145 @node Contextos de nivel intermedio: pentagramas
146 @unnumberedsubsubsec Contextos de nivel intermedio: pentagramas
147 @translationof Intermediate-level contexts - staves
149 @strong{@emph{Staff}}
151 Maneja claves, barras de compás, tonalidades y alteraciones
152 accidentales. Puede contener contextos de @code{Voice}.
154 @strong{@emph{RhythmicStaff}}
156 Como @code{Staff}, pero para imprimir ritmos. Se ignoran las alturas
157 de las notas; las notas se imprimen sobre una línea.
159 @strong{@emph{TabStaff}}
161 Contexto para generar tablaturas. De forma predeterminada dispone la
162 expresión musical como una tablatura de guitarra, impresa sobre seis
165 @strong{@emph{DrumStaff}}
167 Maneja el tipografiado para instrumentos de percusión. Puede contener
168 contextos @code{DrumVoice}.
170 @strong{@emph{VaticanaStaff}}
172 Igual que @code{Staff}, excepto que está pensado para tipografiar
173 piezas en estilo gregoriano.
175 @strong{@emph{MensuralStaff}}
177 Igual que @code{Staff}, excepto que está diseñado para tipografiar
178 piezas en estilo mensural.
181 @node Contextos del nivel más bajo: voces
182 @unnumberedsubsubsec Contextos del nivel más bajo: voces
183 @translationof Bottom-level contexts - voices
185 Los contextos del mismo nivel que Voice dan un valor inicial a ciertas
186 propiedades e inician los grabadores correspondientes. Siendo
187 contextos del nivel más bajo, no pueden contener a otros contextos.
189 @strong{@emph{Voice}}
191 Corresponde a una voz sobre un pentagrama. este contexto maneja la
192 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
193 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
194 que crear instancias explícitas de este contexto si necesitamos varias
195 voces en el mismo pentagrama.
197 @strong{@emph{VaticanaVoice}}
199 Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
200 piezas en estilo gregoriano.
202 @strong{@emph{MensuralVoice}}
204 Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
205 piezas en estilo mensural.
207 @strong{@emph{Lyrics}}
209 Corresponde a una voz con letra. Maneja la impresión de una sola
212 @strong{@emph{DrumVoice}}
214 El contexto de voz utilizado en una pauta de percusión.
216 @strong{@emph{FiguredBass}}
218 El contexto en que los objetos @code{BassFigure} se crean a partir de
219 la entrada escrita en el modo @code{\figuremode}.
221 @strong{@emph{TabVoice}}
223 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
224 Se suele dejar que se cree implícitamente.
226 @strong{@emph{ChordNames}}
228 Tipografía nombres de acordes.
231 @node Crear contextos
232 @subsection Crear contextos
233 @translationof Creating contexts
235 Para partituras que sólo tienen una voz y un pentagrama, los contextos
236 se crean automáticamente. Para partituras más complejas, es necesario
237 crearlos a mano. Existen tres instrucciones que hacen esto.
242 La instrucción más fácil es @code{\new}, y es también la más rápida de
243 escribir. Se antepone a una expresión musical, por ejemplo
246 @cindex nuevos, contextos
247 @cindex Contexto, creación de
250 \new @var{tipo} @var{expresión_musical}
254 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
255 @code{Voice}). Esta instrucción crea un contexto nuevo, y empieza a
256 interpretar la @var{expresión_musical} con él.
258 Una aplicación práctica de @code{\new} es una partitura con muchos pentagramas.
259 Cada parte que debe ir en su propio pentagrama, va precedida de
262 @lilypond[quote,verbatim,relative=2,ragged-right,fragment]
269 La instrucción @code{\new} puede también dar nombre al contexto,
272 \new @var{tipo} = @var{identificador} @var{música}
274 Sin embargo, este nombre especificado por el usuario sólo se utiliza
275 si no hay ya otro contexto anterior con el mismo nombre.
281 Como @code{\new}, la instrucción @code{\context} también dirige una
282 expresión musical a un objeto de contexto, pero da al contexto un
283 nombre explícito. La sintaxis es
286 \context @var{tipo} = @var{identificador} @var{música}
289 En esta forma, la instrucción buscará un contexto existente del
290 @var{tipo} especificado que tenga el nombre @var{identificador}. Si
291 ese contexto aún no existe, se crea un contexto nuevo con el nombre
292 especificado. Esto es útil si nos vamos a referir más tarde al
293 contexto. Por ejemplo, cuando se escribe la letra, la melodía está
294 dentro de un contexto con nombre
297 \context Voice = "@b{tenor}" @var{música}
301 de forma que los textos se puedan alienar correctamente con sus notas,
304 \new Lyrics \lyricsto "@b{tenor}" @var{letra}
309 Otro uso posible de los contextos con nombre es la fusión de dos
310 expresiones musicales distintas en un solo contexto. En el siguiente
311 ejemplo, se introducen por separado las articulaciones y las notas,
315 decoracion = @{ s4-. s4-> @}
318 se combinan enviando los dos al mismo contexto @code{Voice},
322 \new Staff \context Voice = "A" \musica
323 \context Voice = "A" \decoracion
326 @lilypond[quote,ragged-right]
330 \new Staff \context Voice = "A" \music
331 \context Voice = "A" \arts
335 Con este mecanismo, es posible definir un Urtext (una edición
336 original), con la posibilidad de poner articulaciones distintas sobre
339 @cindex crear contextos
342 La tercera instrucción para crear contextos es
344 \context @var{tipo} @var{música}
349 Esto es similar a @code{\context} con @code{= @var{identificador}},
350 pero se corresponde con cualquier contexto del tipo @var{tipo}, sin
351 importar qué nombre se le ha dado.
353 Esta variante se usa con expresiones musicales que se pueden
354 interpretar en varios niveles. Por ejemplo, la instrucción
355 @code{\applyOutput} (véase @ref{Ejecutar una función sobre todos los objetos de la presentación}). Sin una instrucción @code{\context} explícita, normalmente
356 se aplicaría a @code{Voice}
359 \applyOutput #'@var{contexto} #@var{función} % aplicar al contexto Voice
362 Para que se interprete dentro de los niveles de @code{Score} o
363 @code{Staff}, utilice las siguientes formas:
366 \applyOutput #'Score #@var{función}
367 \applyOutput #'Staff #@var{función}
372 @node Mantener vivos los contextos
373 @subsection Mantener vivos los contextos
374 @translationof Keeping contexts alive
376 @cindex contextos, mantener vivos
377 @cindex contextos, tiempo de vida
379 Normalmente los contextos finalizan en el primer momento musical en
380 que no tienen nada que hacer. Así, los contextos de @code{Voice}
381 mueren tan pronto como ya no contienen ningún evento; los contextos de
382 @code{Staff} mueren tan pronto como todos los contextos de
383 @code{Voice} que contenían ya no contengan ningún evento; etc. Esto
384 puede ocasionar dificultades si se tiene que hacer referencia a
385 contextos anteriores que ya han muerto, por ejemplo, al cambiar de
386 pentagramas con instrucciones @code{\change}, asociar letra con una
387 voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
388 eventos musicales adicionales a un contexto anterior.
390 Existe una excepción a esta regla general: precisamente uno de los
391 contextos de @code{Voice} que están dentro de un contexto de
392 @code{Staff} o de una construcción @code{<<...>>} persiste siempre
393 hasta el final de, contexto de @code{Staff} circundante o la
394 construcción @code{<<...>>}, incluso aunque puede haber períodos en
395 que no tiene nada que hacer. El contexto que persiste de esta forma
396 será el primero que se encuentre en la primera construcción encerrada
397 entre llaves @code{@{...@}}, ignorando cualquiera que se encuentre
398 dentro de construcciones encerradas por ángulos dobles @code{<<...>>}.
400 Cualquier contexto se puede mantener vivo si nos aseguramos de que
401 tiene algo que hacer en cualquier momento musical dado. Los
402 contextos de @code{Staff} se mantienen con vida si nos aseguramos de
403 que una de sus voces se mantiene viva. Una manera de hacerlo es
404 añadir silencios de separación a una voz en paralelo con la música
405 real. Éstos deben añadirse a todos y cada uno de los contextos de
406 @code{Voice} que se hayan de mantener vivos. Si se van a usar
407 esporádicamente varias voces, es más seguro mantenerlas todas vivas en
408 lugar de tratar de confiar en las excepciones que hemos mencionado
411 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
412 vivas de esta manera durante la duración de la pieza:
414 @lilypond[quote,verbatim]
415 musicA = \relative c'' { d4 d d d }
416 musicB = \relative c'' { g4 g g g }
419 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
420 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
425 \context Voice = "A" {
429 \context Voice = "B" {
433 \context Voice = "A" { \musicA }
434 \context Voice = "B" { \musicB }
435 \context Voice = "A" { \musicA }
446 @cindex letra, alineación con melodía esporádica
448 El ejemplo siguiente muestra cómo se puede escribir una línea melódica
449 esporádica con letra utilizando este enfoque. Por supuesto, en una
450 situación real la melodía y el acompañamiento consistirían en varias
451 secciones diferentes.
453 @lilypond[quote,verbatim]
454 melody = \relative c'' { a4 a a a }
455 accompaniment = \relative c' { d4 d d d }
456 words = \lyricmode { These words fol -- low the mel -- o -- dy }
459 \new Staff = "music" {
461 \new Voice = "melody" {
463 s1*4 % Keep Voice "melody" alive for 4 bars
466 \new Voice = "accompaniment" {
471 \context Voice = "melody" { \melody }
472 \context Voice = "accompaniment" { \accompaniment }
474 \context Voice = "accompaniment" { \accompaniment }
476 \context Voice = "melody" { \melody }
477 \context Voice = "accompaniment" { \accompaniment }
482 \new Lyrics \with { alignAboveContext = #"music" }
483 \lyricsto "melody" { \words }
488 Una forma alternativa, que podría resultar mejor en muchas
489 situaciones, es mantener con vida la línea melódica simplemente
490 incluyendo notas espaciadoras para alinearla correctamente con el
493 @lilypond[quote,verbatim]
494 melody = \relative c'' {
500 accompaniment = \relative c' {
506 words = \lyricmode { These words fol -- low the mel -- o -- dy }
510 \new Staff = "music" {
512 \new Voice = "melody" {
516 \new Voice = "accompaniment" {
522 \new Lyrics \with { alignAboveContext = #"music" }
523 \lyricsto "melody" { \words }
529 @node Modificar los complementos (plug-ins) de contexto
530 @subsection Modificar los complementos (plug-ins) de contexto
531 @translationof Modifying context plug-ins
533 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
534 almacenan propiedades, también contienen «plug-ins» o complementos
535 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
536 el contexto @code{Voice} contiene un grabador
537 @code{Note_head_engraver} que crea las cabezas de nota y el contexto
538 @code{Staff} contiene un grabador @code{Key_signature_engraver} que
539 crea la indicación de compás.
541 Para ver una descripción completa de todos y cada uno de los
542 complementos, consulte
544 @rinternals{Engravers and Performers}.
547 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
549 Cada contexto que se describe en
551 @rinternals{Contexts}
554 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
556 relaciona los grabadores que se usan para ese contexto.
559 Puede ser de utilidad jugar un poco con estos complementos. Se hace
560 iniciando un contexto nuevo con @code{\new} o @code{\context} y
566 \new @var{contexto} \with @{
579 donde los @dots{} debe ser el nombre de un grabador. Aquí tenemos un
580 ejemplo sencillo que suprime los grabadores
581 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
584 @lilypond[quote,relative=1,verbatim,fragment]
590 \remove "Time_signature_engraver"
591 \remove "Clef_engraver"
598 En el segundo pentagrama no hay indicación de compás ni clave. Éste
599 es un método bastante rudimentario de hacer que desaparezcan los
600 objetos porque afecta a todo el pentagrama. Este método también
601 afecta al espaciado, lo que puede ser deseable o no serlo. Se
602 muestran métodos más sofisticados para quitar objetos en
603 @rlearning{Visibilidad y color de los objetos}.
605 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
606 líneas divisorias y las indicaciones de compás están sincronizadas a
607 lo largo de toda la partitura. Lo hacen los grabadores
608 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
609 complementos mantienen al día la administración de las indicaciones de
610 compás, posición dentro del compás, etc. Moviendo estos grabadores
611 desde el contexto de @code{Score} al de @code{Staff}, podemos
612 conseguir una partitura en la que cada pentagrama tiene su propio
613 compás independiente.
615 @cindex polimétricas, partituras
616 @cindex compases distintos al mismo tiempo
618 @lilypond[quote,relative=1,ragged-right,verbatim,fragment]
620 \remove "Timing_translator"
621 \remove "Default_bar_line_engraver"
624 \consists "Timing_translator"
625 \consists "Default_bar_line_engraver"
631 \consists "Timing_translator"
632 \consists "Default_bar_line_engraver"
641 @node Cambiar los valores por omisión de los contextos
642 @subsection Cambiar los valores por omisión de los contextos
643 @translationof Changing context default settings
645 Los ajustes de contexto que están preparados para usarse de forma
646 predeterminada en los contextos @code{Score}, @code{Staff} y
647 @code{Voice}, se pueden especificar dentro de un bloque
648 @code{\layout}, como se ilustra en el ejemplo siguiente. El bloque
649 @code{\layout} se debe colocar dentro del bloque @code{\score} en que
650 se quiere que haga efecto, pero fuera de la música.
652 Observe que la propia instrucción @code{\set} y el contexto se deben
653 omitir cuando se especifican de esta manera los valores de contexto
656 @lilypond[quote,verbatim]
659 a4^"Really small, thicker stems, no time signature" a a a
666 \override Stem #'thickness = #4.0
667 \remove "Time_signature_engraver"
673 En este ejemplo, la instrucción @code{\Staff} especifica que los
674 ajustes siguientes se apliquen a todos los pentagramas dentro del
677 Se pueden realizar de forma similar modificaciones al contexto
678 @code{Score} o a todos los contextos @code{Voice}.
682 No es posible recolectar cambios de contexto dentro de una variable y
683 aplicarlos a una definición de @code{\context} por referencia a dicha
686 La instrucción @code{\RemoveEmptyStaffContext} sobreescribe nuestros
687 ajustes en curso para @code{\Staff}. Si queremos cambiar los valores
688 predeterminados para un pentagrama que utilice
689 @code{\RemoveEmptyStaffContext}, debe hacerlo después de llamar a
690 @code{\RemoveEmptyStaffContext}, o sea
695 \RemoveEmptyStaffContext
697 \override Stem #'thickness = #4.0
703 @node Definir contextos nuevos
704 @subsection Definir contextos nuevos
705 @translationof Defining new contexts
707 Los contextos específicos, como @code{Staff} y @code{Voice}, están
708 construidos a base de bloques sencillos. Es posible crear nuevos
709 tipos de contextos con combinaciones distintas de añadidos grabadores.
711 El siguiente ejemplo muestra cómo construir un tipo diferente de contexto de
712 @code{Voice} partiendo de cero. Será parecido a
713 @code{Voice}, pero imprime solamente cabezas centradas en forma de barra inclinada. Se puede usar
714 para indicar improvisación en piezas de jazz,
717 @lilypond[quote,ragged-right]
720 \type "Engraver_group"
721 \consists "Note_heads_engraver"
722 \consists "Rhythmic_column_engraver"
723 \consists "Text_engraver"
724 \consists Pitch_squash_engraver
725 squashedPosition = #0
726 \override NoteHead #'style = #'slash
727 \override Stem #'transparent = ##t
731 \accepts "ImproVoice"
735 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
736 c4 c^"desvístete" c_"mientras juegas :)" c }
742 Estos ajustes se definen dentro de un bloque @code{\context} que a su
743 vez está dentro de un bloque @code{\layout},
753 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
754 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
756 En primer lugar es necesario definir un nombre para el nuevo contexto:
762 Debido a que es parecido al contexto @code{Voice}, queremos órdenes
763 que funcionen sobre contextos de @code{Voice} (existentes) para que
764 siga funcionando. Esto se consigue dando al contexto nuevo un alias
771 El contexto imprimirá notas y textos explicativos, por ello tenemos
772 que añadir los grabadores que aportan esta funcionalidad,
775 \consists Note_heads_engraver
776 \consists Text_engraver
779 Pero sólo necesitamos esto en la línea central,
782 \consists Pitch_squash_engraver
783 squashedPosition = #0
786 El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
787 nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
788 establece sus posiciones verticales al valor de
789 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.
791 Las notas parecen barras inclinadas y no tienen plica,
794 \override NoteHead #'style = #'slash
795 \override Stem #'transparent = ##t
798 Todos estos añadidos tienen que cooperar, y esto se consigue con un
799 añadido especial, que se debe marcar con la palabra clave
800 @code{\type}. Este será siempre @code{Engraver_group},
803 \type "Engraver_group"
806 Al juntarlo todo, obtenemos
811 \type "Engraver_group"
812 \consists "Note_heads_engraver"
813 \consists "Text_engraver"
814 \consists Pitch_squash_engraver
815 squashedPosition = #0
816 \override NoteHead #'style = #'slash
817 \override Stem #'transparent = ##t
823 Los contextos dan lugar a jerarquías. Queremos colgar el contexto
824 @code{ImproVoice} bajo el contexto @code{Staff}, como simples
825 @code{Voice}s normales. Por tanto, modificamos la definición de
826 @code{Staff} con la instrucción @code{\accepts} (acepta),
836 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
837 que a veces se necesita cuando se están reutilizando definiciones de
840 Ponemos ambos dentro de un bloque @code{\layout}, como
850 \accepts "ImproVoice"
855 Así pues, la salida que aparece al comienzo de esta sub-sección se
864 c c_"while playing :)"
871 @node Alinear los contextos
872 @subsection Alinear los contextos
873 @translationof Aligning contexts
875 Los contextos nuevos se pueden alinear por encima o por debajo de
876 otros contextos existentes. Esto podría ser de utilidad al preparar
877 un pentagrama vocal (@rlearning{Conjuntos vocales}) y un ossia,
880 @findex alignAboveContext
881 @findex alignBelowContext
883 @lilypond[quote,ragged-right]
886 \relative c' \new Staff = "main" {
889 \new Staff \with { alignAboveContext = #"main" } \ossia
896 @cindex nested contexts
897 @cindex contexts, nested
902 Los contextos como @code{PianoStaff} pueden llevar dentro otros
903 contextos anidados. Los contextos que se pueden aceptar para su
904 anidamiento están definidos por la lista @qq{accepts} (acepta) de un
905 contexto. Los contextos que no están en esta lista se colocan debajo
906 del contexto exterior en la partitura impresa. Por ejemplo, el
907 contexto @code{PianoStaff} está definido para que acepte contextos
908 @code{Staff} y @code{FiguredBass} de forma predeterminada, pero no un
909 contexto @code{Lyrics}, por ejemplo. Así pues, en la siguiente
910 estructura la letra se sitúa debajo del sistema de piano en lugar de
911 colocarse entre los dos pentagramas:
913 @lilypond[verbatim,quote,relative=1]
916 \new Staff { e4 d c2 }
917 \addlyrics { Three blind mice }
925 La lista @qq{accepts} de un contexto se puede modificar para que
926 incluya contextos anidados adicionales, y así si quisiéramos que la
927 letra apareciese entre los dos pentagramas podríamos usar:
929 @lilypond[verbatim,quote,relative=1]
930 \new PianoStaff \with { \accepts Lyrics }
932 \new Staff { e4 d c2 }
933 \addlyrics { Three blind mice }
941 Lo contrario de @code{\accepts} (acepta) es @code{\denies} (deniega);
942 esto suprime un contexto de la lista @qq{accepts}.
945 @node Explicación del Manual de referencia de funcionamiento interno
946 @section Explicación del Manual de referencia de funcionamiento interno
947 @translationof Explaining the Internals Reference
951 * Navegar por la referencia del programa::
952 * Interfaces de la presentación::
953 * Determinar la propiedad del grob::
954 * Convenciones de nombres::
959 @node Navegar por la referencia del programa
960 @subsection Navegar por la referencia del programa
961 @translationof Navigating the program reference
963 Supongamos que queremos mover la indicación de digitación del
966 @lilypond[quote,fragment,relative=2,verbatim]
972 Si hace una visita a la documentación en busca de instrucciones de
973 digitación (en @ref{Indicaciones de digitación}), encontrará:
976 @strong{Véase también}
978 Referencia de funcionamiento interno: @rinternals{Fingering}.
983 La referencia del programador se encuentra disponible en forma de
984 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
985 en línea o bien descargando los archivos de la documentación HTML.
986 Esta sección sería mucho más difícil de entender si está utilizando el
987 manual en formato PDF.
990 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
994 Los objetos de digitación se crean por parte de:
995 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
998 Siguiendo los enlaces relacionados dentro de la referencia del
999 programa, podemos seguir el flujo de información dentro del programa:
1003 @item @rinternals{Fingering}:
1004 los objetos @rinternals{Fingering} se crean por parte de:
1005 @rinternals{Fingering_engraver}
1007 @item @rinternals{Fingering_engraver}:
1008 Tipos de música aceptados: @rinternals{fingering-event}
1010 @item @rinternals{fingering-event}:
1011 El tipo de evento musical @code{fingering-event} está descrito en
1012 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1015 Este camino se recorre en contra de la corriente de información del
1016 programa: comienza por la salida y acaba en el evento de entrada.
1017 También podríamos haber empezado por un evento de la entrada, y leído
1018 siguiendo el flujo de información terminando en su caso en el objeto
1019 (u objetos) de la salida.
1021 La referencia del programa también se puede examinar como un documento
1022 normal. Contiene capítulos que tratan de
1024 @rinternals{Music definitions},
1027 @code{Music definitions}
1029 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1030 de los capítulos relaciona todas las definiciones utilizadas y todas
1031 las propiedades que se pueden ajustar.
1034 @node Interfaces de la presentación
1035 @subsection Interfaces de la presentación
1036 @translationof Layout interfaces
1038 @cindex interfaz de la presentación
1039 @cindex presentación, interfaz de la
1042 La página HTML que pudimos ver en la sección anterior describe el
1043 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1044 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1045 números (como grosores y direcciones), pero también punteros a objetos
1046 relacionados. Un objeto de presentación también se llama un
1047 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1048 gráfico). Para ver más detalles acerca de los objetos gráficos o
1049 Grobs, consulte @rinternals{grob-interface}.
1051 La página dedicada a @code{Fingering} relaciona las definiciones del
1052 objeto @code{Fingering}. Por ejemplo, la página dice
1055 @code{relleno} (dimensión, en espacios de pentagrama):
1061 lo que significa que el número se mantendrá a una distancia de al
1062 menos 0.5 de la cabeza de la nota.
1065 Cada objeto de presentación puede tener varias funciones como elemento
1066 notacional o tipográfico. Por ejemplo, el objeto de digitación
1067 Fingering tiene los siguientes aspectos
1071 Su tamaño es independiente del espaciado horizontal, al contrario de
1072 las ligaduras o las barras de las figuras.
1075 Es un elemento de texto. Casi seguro que es un texto muy corto.
1078 este elemento de texto se tipografía con un tipo de letra, no como las
1079 ligaduras o las barras de las figuras.
1082 Horizontalmente, el centro del símbolo se debe alinear con el centro
1083 de la cabeza de la nota.
1086 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1089 La posición vertical también está coordinada con otros símbolos de
1090 superíndice y de subíndice.
1093 Cada uno de estos aspectos se capta en lo que se llaman
1094 @emph{interface}s, que se relacionan al final de la página dedicada a
1095 @rinternals{Fingering}
1098 Este objeto contempla los siguientes interfaces:
1099 @rinternals{item-interface},
1100 @rinternals{self-alignment-interface},
1101 @rinternals{side-position-interface}, @rinternals{text-interface},
1102 @rinternals{text-script-interface}, @rinternals{font-interface},
1103 @rinternals{finger-interface} y @rinternals{grob-interface}.
1106 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1107 página del respectivo interfaz del objeto. Cada interfaz tiene un
1108 cierto número de propiedades. Algunas de ellas no son para que el
1109 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1112 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1113 realmente esto no significa mucho. El archivo de inicialización
1114 (véase @rlearning{Otras fuentes de información})
1115 @file{scm/@/define@/-grobs@/.scm} muestra el alma del @q{objeto},
1120 (avoid-slur . around)
1121 (slur-padding . 0.2)
1122 (staff-padding . 0.5)
1123 (self-alignment-X . 0)
1124 (self-alignment-Y . 0)
1125 (script-priority . 100)
1126 (stencil . ,ly:text-interface::print)
1127 (direction . ,ly:script-interface::calc-direction)
1128 (font-encoding . fetaNumber)
1129 (font-size . -5) ; don't overlap when next to heads.
1130 (meta . ((class . Item)
1131 (interfaces . (finger-interface
1133 text-script-interface
1135 side-position-interface
1136 self-alignment-interface
1137 item-interface))))))
1141 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1142 de valores de variables, y la página web de la Referencia de
1143 funcionamiento interno se genera directamente a partir de esta
1147 @node Determinar la propiedad del grob
1148 @subsection Determinar la propiedad del grob
1149 @translationof Determining the grob property
1151 Recordemos que queríamos cambiar la posición del @b{2} en
1153 @lilypond[quote,fragment,relative=2,verbatim]
1159 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1160 tenemos que negociar con el interfaz asociado con esta colocación.
1161 Esto se hace usando @code{side-position-interface}. La página que
1162 describe este interface dice:
1165 @code{side-position-interface}
1167 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1168 soporte). La propiedad @code{direction} significa dónde poner el
1169 objeto víctima con relación al soporte (¿a la izquierda o a la
1170 derecha, encima o debajo?)
1175 Debajo de esta descripción, la variable @code{padding} (relleno) se describe como
1180 (dimensión, en espacios de pentagrama)
1182 Añadir esta cantidad de espacio adicional entre objetos que están unos
1187 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1188 digitación de la cabeza de la nota. La siguiente orden inserta un
1189 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1192 \once \override Voice.Fingering #'padding = #3
1195 Al insertar esta instrucción antes de que se haya creado el objeto
1196 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1199 @lilypond[quote,relative=2,fragment,verbatim]
1200 \once \override Voice.Fingering #'padding = #3
1206 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1207 se puede deducir también a partir de la referencia del programa, ya
1208 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1211 El grabador Fingering_engraver es parte de los contextos: @dots{}
1217 @node Convenciones de nombres
1218 @subsection Convenciones de nombres
1219 @translationof Naming conventions
1222 Another thing that is needed, is an overview of the various naming
1225 scheme functions: lowercase-with-hyphens (incl. one-word
1227 scheme functions: ly:plus-scheme-style
1228 music events, music classes and music properties:
1230 Grob interfaces: scheme-style
1231 backend properties: scheme-style (but X and Y!)
1232 contexts (and MusicExpressions and grobs): Capitalized or
1234 context properties: lowercaseFollowedByCamelCase
1236 Capitalized_followed_by_lowercase_and_with_underscores
1238 Which of these are conventions and which are rules?
1239 Which are rules of the underlying language, and which are
1243 @node Modificar las propiedades
1244 @section Modificar las propiedades
1245 @translationof Modifying properties
1248 * Panorámica de la modificación de las propiedades::
1249 * La instrucción set::
1250 * La instrucción override::
1251 * La instrucción tweak::
1252 * set frente a override::
1256 @node Panorámica de la modificación de las propiedades
1257 @subsection Panorámica de la modificación de las propiedades
1258 @translationof Overview of modifying properties
1260 Cada contexto es responsable de la creación de ciertos tipos de
1261 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1262 también se almacenan por contexto. Mediante la modificación de estos
1263 ajustes, se puede alterar la apariencia de los objetos.
1265 La sintaxis de esto es
1268 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1271 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1272 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1273 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1274 disposición}). Este último es un símbolo, y por ello debe ir
1275 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1276 explica cómo se deben cumplimentar los conceptos @var{nombre},
1277 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1278 funcionalidad des esta instrucción.
1283 \override Staff.Stem #'thickness = #4.0
1287 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1288 grosor de una línea del pentagrama como unidad). Puesto que la
1289 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1290 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1291 Aquí vemos la instrucción en pleno funcionamiento:
1293 @lilypond[quote,verbatim,relative=2,fragment]
1295 \override Staff.Stem #'thickness = #4.0
1301 La instrucción @code{\override} modifica la definición de la plica
1302 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1303 que la instrucción se ha interpretado, todas las plicas se engrosan.
1305 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1306 omitir, ocasionando que se utilice el contexto predeterminado
1307 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1308 solo paso de tiempo.
1310 @lilypond[quote,fragment,verbatim,relative=2]
1312 \once \override Stem #'thickness = #4.0
1317 El @code{\override} se debe hacer antes de que el objeto se inicia.
1318 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1319 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1320 en el momento en que se crea el objeto. En este ejemplo:
1322 @lilypond[quote,fragment,verbatim,relative=2]
1323 \override Slur #'thickness = #3.0
1325 \override Beam #'thickness = #0.6
1330 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1331 la instrucción para @code{Beam}, la barra, va después de que la barra
1332 se ha iniciado, y por ello no tiene ningún efecto.
1334 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1335 un contexto deshace una instrucción @code{\override}; como con
1336 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1337 del mismo contexto. En otras palabras, el @code{\revert} del
1338 siguiente ejemplo no hace nada.
1341 \override Voice.Stem #'thickness = #4.0
1342 \revert Staff.Stem #'thickness
1345 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1346 dentro de las propiedades normales. Para trucarlas, utilice
1347 instrucciones de la forma
1349 @c leave this as a long long
1351 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1358 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1363 Referencia de funcionamiento interno:
1364 @rinternals{OverrideProperty},
1365 @rinternals{RevertProperty},
1366 @rinternals{PropertySet},
1367 @rinternals{Backend},
1368 @rinternals{All layout objects}.
1373 El «back-end» o motor de salida no es muy estricto en la comprobación
1374 de tipos de las propiedades de objetos. Las referencias cíclicas en
1375 valores Scheme de propiedades pueden producir cuelgues o salidas
1376 abruptas, o las dos cosas.
1379 @node La instrucción set
1380 @subsection La instrucción @code{\set}
1381 @translationof The set command
1385 @cindex cambiar propiedades
1387 Cada contexto puede tener distintas @emph{propiedades}, variables
1388 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1389 paso de interpretación. Se consigue insertando la instrucción
1390 @code{\set} dentro de la música:
1393 \set @var{contexto}.@var{propiedad} = #@var{valor}
1397 @lilypond[quote,verbatim,relative=2,fragment]
1399 \set Score.skipBars = ##t
1403 Estas instrucción salta los compases que no tienen notas. El
1404 resultado es que los silencios multicompás se condensan. El valor
1405 asignado es un objeto de Scheme. En este caso, es @code{#t}, el valor
1406 booleano True o verdadero.
1408 Si se omite el argumento @var{context}, entonces se utiliza el
1409 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1410 @code{Voice} o @code{Lyrics}). En este ejemplo:
1412 @lilypond[quote,verbatim,relative=2,fragment]
1414 \set autoBeaming = ##f
1419 el argumento @var{contexto} de la instrucción @code{\set} se omite,
1420 así pues el barrado automático se desactiva en la voz actual. Observe
1421 que el contexto de nivel más bajo no siempre contiene la propiedad que
1422 queremos cambiar (por ejemplo, no tendrá ningún efecto intentar
1423 establecer un valor para la propiedad @code{skipBars} del contexto de
1424 nivel más bajo, en este caso @code{Voice}).
1426 @lilypond[quote,verbatim,relative=2,fragment]
1432 Los contextos son jerárquicos, y si se ha especificado un contexto
1433 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1434 también a todos los contextos @code{Voice} dentro del pentagrama
1435 actual. El cambio se aplica @q{al vuelo}, durante la música, de
1436 manera que el ajuste sólo afecta al segundo grupo de corcheas.
1440 También existe una instrucción @code{\unset}:
1442 \unset @var{contexto}.@var{propiedad}
1446 que elimina la definición de @var{propiedad}. Esta instrucción
1447 elimina la definición solamente si está establecida dentro de
1448 @var{contexto}, de manera que
1451 \set Staff.autoBeaming = ##f
1455 introduce un ajuste de la propiedad en el nivel de @code{Staff}. El
1456 ajuste también se aplica a la @code{Voice} actual. Sin embargo:
1459 \unset Voice.autoBeaming
1463 no tiene ningún efecto. Para cancelar este ajuste, se debe
1464 especificar el @code{\unset} en el mismo nivel que el @code{\set}
1465 original. Dicho de otra forma, para deshacer el efecto de
1466 @code{Staff.autoBeaming = ##f} se necesita
1468 \unset Staff.autoBeaming
1471 Como @code{\set}, el argumento @var{contexto} no se tiene que
1472 especificar para un contexto del nivel más bajo, por lo que los dos
1476 \set Voice.autoBeaming = ##t
1477 \set autoBeaming = ##t
1485 Los ajustes que se aplican solamente a un único paso de tiempo se
1486 pueden escribir con @code{\once}, por ejemplo en
1488 @lilypond[quote,verbatim,relative=2,fragment]
1490 \once \set fontSize = #4.7
1495 la propiedad @code{fontSize} se deshace automáticamente después de la
1498 En el manual de Referencia de funcionamiento interno hay una
1499 descripción completa de todas las propiedades de contexto disponibles,
1502 @rinternals{Tunable context properties}.
1505 Traducción @expansion{} Propiedades de contexto modificables por el
1511 @node La instrucción override
1512 @subsection La instrucción @code{\override}
1513 @translationof The override command
1515 Las instrucciones que modifican la salida tienen por lo general un
1519 \override Voice.Stem #'thickness = #3.0
1523 Para construir este truco debemos determinar los siguientes datos:
1526 @item el contexto: aquí @code{Voice}.
1527 @item el objeto de presentación: aquí @code{Stem}.
1528 @item la propiedad de presentación: aquí @code{thickness}.
1529 @item un valor adecuado: aquí @code{3.0}.
1532 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
1533 en el interior de las propiedades normales. Para modificarlas utilice
1534 instrucciones de la forma
1537 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1540 @cindex documentación interna
1541 @cindex buscar objetos gráficos
1542 @cindex gráficos, descripción de los objetos
1545 @cindex interna, documentación
1547 Para muchas propiedades, independientemente del tipo de datos de la
1548 propiedad, si se establece el valor de la propiedad a falso
1549 (@code{##f}) se producirá su desactivación, ocasionando que LilyPond
1550 ignore por completo dicha propiedad. Esto es especialmente útil para
1551 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
1552 causarían problemas.
1554 Mostraremos a continuación cómo localizar esta información en el
1555 manual de notación y en la referencia de funcionamiento interno.
1558 @node La instrucción tweak
1559 @subsection La instrucción @code{\tweak}
1560 @translationof The tweak command
1565 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
1566 los objetos gráficos. Para objetos que resultan directamente de un
1567 elemento de código de la entrada, puede usar la función @code{\tweak},
1570 @lilypond[relative=2,verbatim]
1575 \tweak #'duration-log #1
1578 -\tweak #'padding #8
1582 @cindex chord, modifying one note in
1584 Pero el uso principal de la instrucción @code{\tweak} es modificar
1585 solamente uno de varios elementos de notación que dan comienzo en el
1586 mismo momento musical, como las notas de un acorde, o corchetes de
1587 tresillo que empiezan al mismo tiempo.
1589 Para ver una introducción a la sintaxis y los usos de la instrucción
1590 tweak, consulte @rlearning{Métodos de trucaje}.
1592 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
1593 a continuación de forma directa, sin necesidad de especificar el
1594 nombre del grob o el contexto. Para que esto funcione, es necesario
1595 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
1596 al objeto al que se aplica, después de que el archivo de entrada se ha
1597 convertido en un flujo musical. Con frecuencia no es el caso, pues
1598 muchos elementos adicionales se insertan en la corriente musical de
1599 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
1600 parte de un acorde, LilyPond inserta implícitamente un evento
1601 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
1602 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
1603 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
1604 en el flujo musical, permaneciendo así adyacente a la nota, y con la
1605 posibilidad de modificarla.
1609 @lilypond[relative=2,verbatim,quote]
1610 <\tweak #'color #red c>4
1614 pero esto no funciona:
1616 @lilypond[relative=2,verbatim,quote]
1617 \tweak #'color #red c4
1620 Si se colocan varios elementos similares en el mismo momento musical,
1621 la instrucción @code{\override} no se puede usar para modificar uno
1622 solo de ellos: aquí es donde se debe usar la instrucción
1623 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
1624 en el mismo momento musical están los siguientes:
1626 @c TODO expand to include any further uses of \tweak
1628 @item las cabezas de las notas de un acorde
1629 @item signos de articulación sobre la misma nota
1630 @item ligaduras de unión entre notas de un acorde
1631 @item corchetes de grupos especials que comienzan en el mismo momento
1634 @c TODO add examples of these
1637 y se puede usar @code{\tweak} para modificar cualquier aparición
1638 específica de estos elementos.
1640 Es de resaltar que la instrucción @code{\tweak} no se puede usar para
1641 modificar plicas, barras o alteraciones accidentales directamente,
1642 porque éstos se generan más tarde por parte de las cabezas de nota, en
1643 vez de por elementos musicales que están en el flujo de entrada. Ni
1644 se puede usar una instrucción @code{\tweak} para modificar claves o
1645 indicaciones de compás, ya que éstos están separados de cualquier
1646 instrucción @code{\tweak} precedente en el flujo de entrada a causa de
1647 la inserción automática de elementos adicionales necesarios para
1648 especificar el contexto.
1650 Pero la instrucción @code{\tweak} se puede usar como alternativa a la
1651 instrucción @code{\override} para modificar estos elementos
1652 notacionales que no producen la adición de ningún elemento notacional
1653 implícito antes de ellos mismos en el flujo musical. Por ejemplo, las
1654 ligaduras de expresión se pueden modificar de esta forma:
1656 @lilypond[verbatim,quote,relative=1]
1657 c-\tweak #'thickness #5 ( d e f)
1660 También se pueden escribir varias instrucciones @code{\tweak} antes de
1661 un elemento notacional, y todas ellas le afectan:
1663 @lilypond[verbatim,quote,relative=1]
1665 -\tweak #'style #'dashed-line
1666 -\tweak #'dash-fraction #0.2
1667 -\tweak #'thickness #3
1668 -\tweak #'color #red
1673 El flujo musical que se genera a partir de una sección de un archivo
1674 de entrada, incluido cualquier elemento insertado automáticamente,
1675 puede examinarse, véase @ref{Presentación de expresiones musicales}. Esto
1676 puede ser de utilidad en la determinación de lo que puede modificarse
1677 por medio de una instrucción @code{\tweak}.
1681 Manual de aprendizaje:
1682 @rlearning{Métodos de trucaje}.
1684 Referencia de la notación:
1685 @ref{Presentación de expresiones musicales}.
1690 @cindex trucos en una variable
1691 La instrucción @code{\tweak} no se puede usar dentro de una variable.
1693 @cindex trucos en la letra
1694 Las instrucciones @code{\tweak} no se pueden usar dentro del modo @code{\lyricmode}.
1696 @cindex trucar puntos de control
1697 @cindex control, trucar puntos de
1699 La instrucción @code{\tweak} no se puede usar para modificar los
1700 puntos de control de una única ligadura entre varias dentro de un
1701 acorde, aparte de la primera que aparece en el archivo de entrada.
1703 @node set frente a override
1704 @subsection @code{\set} frente a @code{\override}
1705 @translationof set versus override
1707 Hemos visto dos formas de cambiar las propiedades: @code{\set} y
1708 @code{\override}. De hecho, en realidad existen dos clases diferentes
1711 Los contextos pueden tener propiedades, que por lo general reciben
1712 nombres en @code{mayúsculasDeCamello}. Principalmente controlan la
1713 traducción de la música a la notación, p.ej. @code{localKeySignature}
1714 (para determinar si hay que imprimir las alteraciones accidentales),
1715 @code{measurePosition} (para determinar cuándo imprimir una línea
1716 divisoria). Las propiedades de contexto pueden ver modificado su
1717 valor con el tiempo según se interpreta una pieza de música;
1718 @code{measurePosition} es un ejemplo obvio de esto. Las propiedades
1719 de contexto se modifican con @code{\set}.
1721 Hay un tipo especial de propiedad de contexto: la descripción del
1722 elemento. Estas propiedades reciben nombres en
1723 @code{MayúsculasDeCamello} (comenzando en letra mayúscula). Contienen
1724 los @q{ajustes por defecto} para dicho elemento gráfico como una lista
1725 asociativa. Consulte @file{scm/@/define@/-grobs@/.scm} para ver qué
1726 tipos de ajustes hay. Las descripciones de los elementos se pueden
1727 modificar con @code{\override}.
1729 Realmente, @code{\override} es un atajo;
1732 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1736 es más o menos equivalente a
1738 @c leave this long line -gp
1740 \set @var{contexto}.@var{nombre} #'@var{propiedad} = #(cons (cons '@var{propiedad} @var{valor}) <valor previo de @var{contexto})
1743 El valor de @code{contexto} (la lista-a) se usa para da un valor
1744 inicial a las propiedades de los objetos gráficos individuales. Los
1745 objetos gráficos también tienen propiedades, que reciben nombres en el
1746 estilo de Scheme, con @code{palabras-con-guiones}. Los valores de las
1747 propiedades de objetos gráficos cambian durante el proceso de
1748 formateo: el formateo básicamente consiste en calcular las propiedades
1749 utilizando funciones de callback.
1751 @code{fontSize} es una propiedad especial: equivale a escribir
1752 @code{\override ... #'font-size} para todos los objetos pertinentes.
1753 Al ser éste un cambio muy común, se creó la propiedad especial
1754 (modificada con @code{\set}).
1757 @node Conceptos y propiedades útiles
1758 @section Conceptos y propiedades útiles
1759 @translationof Useful concepts and properties
1763 * Modos de entrada::
1764 * Dirección y posición::
1765 * Distancias y medidas::
1766 * Propiedades del símbolo del pentagrama::
1767 * Objetos de extensión::
1768 * Visibilidad de los objetos::
1769 * Estilos de línea::
1770 * Rotación de objetos::
1773 @node Modos de entrada
1774 @subsection Modos de entrada
1775 @translationof Input modes
1777 La forma en que se interpreta la notación contenida dentro de un
1778 archivo de entrada, está determinada por el modo de entrada en curso.
1780 @strong{Modo de acordes}
1782 Se activa con la instrucción @code{\chordmode} y produce que la
1783 entrada se interprete con al sintaxis de la notación de acordes, véase
1784 @ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
1787 El modo de acordes se activa también con la instrucción
1788 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
1789 y produce que el código que sigue se interprete con la sintaxis de la
1790 notación de acordes y se imprima como nombres de acorde dentro del
1791 contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
1793 @strong{Modo de percusión}
1795 Se activa con la instrucción @code{\drummode} y produce que el código
1796 de entrada se interprete con la sintaxis de la notación de percusión,
1797 véase @ref{Notación básica de percusión}.
1799 El modo de percusión también se activa con la instrucción
1800 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
1801 que el código que sigue se interprete con la sintaxis de la notación
1802 de percusión y se imprima como símbolos de percusión sobre un
1803 pentagrama de percusión, véase @ref{Notación básica de percusión}.
1805 @strong{Modo de cifras}
1807 Se activa con la instrucción @code{\figuremode} y hace que el código
1808 de entrada se interprete con la sintaxis del bajo cifrado, véase
1809 @ref{Introducir el bajo cifrado}.
1811 El modo de cifrase también se activa con la instrucción
1812 @code{\figures}. También crea un contexto de @code{FiguredBass} nuevo
1813 y hace que el código que viene a continuación se interprete con la
1814 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
1815 dentro del contexto @code{FiguredBass}, véase @ref{Introducción al bajo cifrado}.
1817 @strong{Modos de traste y tablatura}
1819 No existen modos de entrada especiales para introducir símbolos de
1820 trastes y de tablatura.
1822 Para crear diagramas de trastes, escriba las notas o acordes en el
1823 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
1824 véase @ref{Tablaturas predeterminadas}.
1826 Para crear diagramas de trastes encima de un pentagrama, escríbalos
1827 como elementos de marcado encima de las notas utilizando la
1828 instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
1830 @strong{Modo de letra}
1832 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
1833 se interprete como sílabas de la letra de la canción con duraciones
1834 opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
1836 El modo de letra también se habilita con la instrucción
1837 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
1838 y una instrucción @code{\lyricsto} implícita que asocia la letra que
1839 viene a continuación con la música precedente.
1841 @strong{Modo de marcado}
1843 Se activa con la instrucción @code{\markup}, y hace que la entrada se
1844 interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
1846 @c silly work-around for texinfo broken-ness
1847 @c (@strong{Note...} causes a spurious cross-reference in Info)
1850 Es el modo predeterminado o se puede activar con la instrucción
1851 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
1852 marcado, etc. y se imprime como notación musical sobre un pentagrama.
1854 Normalmente no es necesario especificar el modo de notas de forma
1855 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
1856 ejemplo si estamos en el modo de letra, en el modo de acordes o en
1857 otro modo y queremos insertar algo que solamente se puede hacer con la
1858 sintaxis del modo de notas.
1860 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
1861 una pieza coral es necesario entrar en el modo de notas para poder
1862 interpretar dichas indicaciones:
1864 @lilypond[verbatim,relative=2,quote]
1867 \notemode{\set stanza = \markup{ \dynamic f 1. } }
1871 \notemode{\set stanza = \markup{ \dynamic p 2. } }
1878 @node Dirección y posición
1879 @subsection Dirección y posición
1880 @translationof Direction and placement
1882 Al tipografiar música, la dirección y colocación de muchos elementos
1883 es cuestión de elección. Por ejemplo, las plicas de las notas se
1884 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
1885 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
1886 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
1887 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
1888 LilyPond las determine automáticamente, pero en ciertos casos puede
1889 ser deseable forzar una dirección o colocación concreta.
1891 @strong{Acciones predeterminadas}
1893 De forma predeterminada algunas direcciones siempre son hacia arriba o
1894 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
1895 otras cosas pueden alternar entre arriba y abajo en función de la
1896 dirección de las plicas (como las ligaduras o los acentos).
1898 @c TODO Add table showing these
1900 @strong{Disposición de contexto}
1902 Los contextos se colocan dentro de un sistema de arriba a abajo en el
1903 orden en que se encuentran. Sin embargo, observe que se crea un
1904 contexto implícitamente si se encuentra una instrucción cuando no está
1905 disponible un contexto apropiado para contenerla.
1907 @c TODO Add example ?
1909 Se pude cambiar el orden predeterminado en que los contextos se
1910 presentan, véase @ref{Alinear los contextos}
1912 @strong{Indicadores de dirección de las articulaciones}
1914 Al añadir articulaciones a notas se puede omitir normalmente el
1915 indicador de dirección, @code{^} (que significa @qq{arriba}), @code{_}
1916 (que significa @qq{abajo}) o @code{-} (que significa @qq{usar la
1917 dirección predeterminada}), en cuyo caso se supone el predeterminado
1918 @code{-}. Pero se necesita un indicador de dirección @strong{siempre}
1922 @item las instrucciones @code{\tweak}
1923 @item las instrucciones @code{\markup}
1924 @item las instrucciones @code{\tag}
1925 @item los marcados de cadena, p.ej. -"cadena"
1926 @item las instrucciones de digitación, p.ej. @code{-1}
1927 @item las abreviaturas de articulación, p.ej. @code{-.}, @code{->}, @code{--}
1930 Estas indicaciones afectan sólo a la nota siguiente.
1932 @lilypond[verbatim,quote,relative=2]
1939 @strong{La propiedad de dirección}
1941 La posición o dirección de muchos objetos de presentación está
1942 controlada por la propiedad @code{direction}.
1944 El valor de la propiedad @code{direction} se puede establecer al valor
1945 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
1946 @code{-1}, con el significado de @qq{hacia abajo} o @qq{debajo}. Se
1947 pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
1948 @code{1} y @code{-1} respectivamente. La dirección predeterminada se
1949 puede especificar estableciendo @code{direction} a @code{0} ó a
1950 @code{CENTER}. De forma alternativa, en muchos casos existen
1951 instrucciones predefinidas para especificar la dirección. Todas ellas
1955 @code{\xxxUp}, @code{xxxDown}, @code{xxxNeutral}
1958 donde @code{xxxNeutral} significa @qq{utilizar la dirección
1959 predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
1961 En alguna que otra ocasión, con el único ejemplo usual del arpegio, el
1962 valor de la propiedad @code{direction} especifica si el objeto se debe
1963 colocar a la izquierda o a la derecha del objeto padre. En este caso
1964 @code{-1} ó @code{LEFT} significan @qq{a la izquierda} y @code{1} ó
1965 @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
1966 significan @qq{utilizar la dirección predeterminada}, como antes.
1968 Estas indicaciones afectan a todas las notas hasta que son canceladas.
1970 @lilypond[verbatim,quote,relative=2]
1980 @node Distancias y medidas
1981 @subsection Distancias y medidas
1982 @translationof Distances and measurements
1984 @cindex distances, absolute
1985 @cindex distances, scaled
1992 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
1994 Las distancias absolutas se usan para especificar márgenes, sangrados
1995 y otros detalles de diseño de página, y de forma predeterminada se
1996 especifican en milímetros. Las distancias se pueden especificar en
1997 otras unidades escribiendo después de la cifra indicativa de la
1998 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
1999 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
2000 de página se pueden especificar también en unidades escalables (véase
2001 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
2002 La disposición de página se describe en detalle en @ref{Formateo de las páginas}.
2004 Las distancias escaladas siempre se especifican en unidades de un
2005 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
2006 El espacio de pentagrama es la distancia entre dos líneas del
2007 pentagrama adyacentes. El valor predeterminado se puede cambiar
2008 globalmente fijando el tamaño global del pentagrama, o se puede
2009 sobreescribir localmente cambiando la propiedad @code{staff-space} del
2010 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
2011 automáticamente con cualquier cambio al tamaño global del pentagrama o
2012 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
2013 las fuentes tipográficas se escalan solamente con los cambios
2014 efectuados al tamaño global del pentagrama. Así, el tamaño global del
2015 pentagrama posibilita la fácil variación del tamaño general de una
2016 partitura impresa. Para ver los métodos de establecimiento del tamaño
2017 global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2021 Si se necesita dibujar sólo una sección de una partitura a una escala
2022 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2023 simplemente cambiar el tamaño global del pentagrama porque esto
2024 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2025 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2026 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2027 nuestra disposición una función de Scheme, @code{magstep}, para
2028 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2029 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2030 utilización, consulte @rlearning{Longitud y grosor de los objetos}.
2034 Manual de aprendizaje:
2035 @rlearning{Longitud y grosor de los objetos}.
2037 Referencia de la notación:
2038 @ref{Formateo de las páginas},
2039 @ref{Establecer el tamaño del pentagrama}.
2042 @node Propiedades del símbolo del pentagrama
2043 @subsection Propiedades del símbolo del pentagrama
2044 @translationof Staff symbol properties
2046 @cindex ajuste del símbolo del pentagrama
2047 @cindex dibujar el símbolo del pentagrama
2048 @cindex pentagrama, establecer el símbolo del
2050 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2051 @c Need to think of uses for these properties. Eg 'line-positions
2052 @c is used in a snippet to thicken centre line.
2053 @c If retained, add @ref to here in 1.6.2 -td
2055 Se puede definir al mismo tiempo la posición vertical de las líneas de
2056 la pauta y el número de líneas de la misma. Como muestra el siguiente
2057 ejemplo, las posiciones de las notas no están influidas por las
2058 posiciones de las líneas de la pauta.
2060 @warning{La propiedad @code{'line-positions} sobreescribe a la
2061 propiedad @code{'line-count}. El número de líneas de la pauta está
2062 definido implícitamente por el número de elementos de la lista de
2063 valores de @code{'line-positions}.}
2065 @lilypond[verbatim,quote,relative=1]
2067 \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
2072 Se puede modificar la anchura de la pauta. Las unidades son espacios
2073 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2074 resulta afectado por este ajuste.
2076 @lilypond[verbatim,quote,relative=1]
2078 \override StaffSymbol #'width = #23
2084 @node Objetos de extensión
2085 @subsection Objetos de extensión
2086 @translationof Spanners
2088 Muchos objetos de notación musical abarcan varias notas o incluso
2089 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2090 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2091 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2092 especiales para controlar su apariencia y comportamiento. Algunas de
2093 estas propiedades son comunes a todos los objetos de extensión; otras
2094 se limitan a un subconjunto de los extensores.
2096 Todos los objetos de extensión contemplan el interface
2097 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2098 una línea recta entre los dos objetos, contemplan también el interface
2099 @code{line-spanner-interface}.
2101 @unnumberedsubsubsec Uso del @code{spanner-interface}
2103 Este interface proporciona dos propiedades que se aplican a varios
2106 @strong{@i{La propiedad @code{minimum-length}}}
2108 La longitud mínima del objeto de extensión se especifica a través de
2109 la propiedad @code{minimum-length}. Su aumento suele producir el
2110 efecto necesario de aumentar el espaciado de las notas entre los dos
2111 puntos extremos. Sin embargo, esta sobreescritura no tiene ningún
2112 efecto sobre muchos extensores, pues su longitud está determinada por
2113 otras consideraciones. Más abajo se muestran algunos ejemplos de
2124 Works as long as callback is made:
2128 Works not at all for:
2137 @lilypond[verbatim,quote,relative=2]
2140 % increase the length of the tie
2141 -\tweak #'minimum-length #5
2145 @lilypond[verbatim,quote,relative=2]
2147 \compressFullBarRests
2149 % increase the length of the rest bar
2150 \once \override MultiMeasureRest #'minimum-length = #20
2155 @lilypond[verbatim,quote,relative=2]
2157 % increase the length of the hairpin
2158 \override Hairpin #'minimum-length = #20
2162 Esta sobreescritura se puede usar también para aumentar la longitud de
2163 las ligaduras de expresión y de fraseo:
2165 @lilypond[verbatim,quote,relative=2]
2168 -\tweak #'minimum-length #5
2173 -\tweak #'minimum-length #5
2177 Para algunos objetos de presentación, la propiedad
2178 @code{minimum-length} es efectiva sólo si se llama explícitamente al
2179 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
2180 propiedad @code{springs-and-rods} al valor
2181 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
2182 de un glissando no tiene efecto a no ser que se establezca la
2183 propiedad @code{springs-and-rods}:
2185 @lilypond[verbatim,quote,relative=1]
2189 % not effective alone
2190 \once \override Glissando #'minimum-length = #20
2193 % effective only when both overrides are present
2194 \once \override Glissando #'minimum-length = #20
2195 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
2199 Lo mismo se puede decir del objeto @code{Beam}:
2201 @lilypond[verbatim,quote,relative=1]
2202 % not effective alone
2203 \once \override Beam #'minimum-length = #20
2206 % effective only when both overrides are present
2207 \once \override Beam #'minimum-length = #20
2208 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2212 @strong{@i{The @code{to-barline} property}}
2214 La segunda propiedad útil del @code{spanner-interface} es
2215 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2216 haciendo que los reguladores y otros objetos de extensión que terminan
2217 sobre la primera nota de un compás, en vez de eso terminen en la línea
2218 divisoria inmediatamente precedente. Si se establece al valor falso,
2219 el extensor llegará más allá de la barra de compás y terminará
2220 exactamente sobre la nota:
2222 @lilypond[verbatim,quote,relative=2]
2223 a \< a a a a \! a a a \break
2224 \override Hairpin #'to-barline = ##f
2225 a \< a a a a \! a a a
2228 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
2229 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2230 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2231 que terminar en la barra de compás no tendría ningún significado.
2233 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
2235 Entre los objetos que contemplan el interface
2236 @code{line-spanner-interface} se encuentran
2239 @item @code{DynamicTextSpanner}
2240 @item @code{Glissando}
2241 @item @code{TextSpanner}
2242 @item @code{TrillSpanner}
2243 @item @code{VoiceFollower}
2246 La rutina responsable de dibujar los sellos de estos extensores es
2247 @code{ly:line-interface::print}. esta rutina determina la
2248 localización exacta de los dos puntos extremos y traza una línea entre
2249 ellos, en el estilo solicitado. Las posiciones de los dos puntos
2250 extremos del extensor se calculan al vuelo, pero es posible
2251 sobreescribir sus coordenadas Y. Las propiedades que se deben
2252 especificar están anidadas a dos niveles de profundidad en la
2253 jerarquía de propiedades, pero la sintaxis de la instrucción
2254 @code{\override} es bastante sencilla:
2256 @lilypond[relative=2,quote,verbatim]
2258 \once \override Glissando #'(bound-details left Y) = #3
2259 \once \override Glissando #'(bound-details right Y) = #-2
2263 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2264 siendo el punto del cero la línea central del pentagrama. Para el
2265 glissando, esto es el valor de @code{Y} en la coordenada X que
2266 corresponde al punto central de cada cabeza de nota si nos imaginamos
2267 que la línea se extiende hasta allí.
2269 Si no está fijado @code{Y}, su valor se calcula a partir de la
2270 posición vertical del punto de anclaje correspondiente del extensor.
2272 En caso de salto de línea, los valores para los puntos extremos se
2273 especifican por las sub-listas @code{left-broken} y
2274 @code{right-broken} de @code{bound-details}. Por ejemplo:
2276 @lilypond[relative=2,ragged-right,verbatim,fragment]
2277 \override Glissando #'breakable = ##t
2278 \override Glissando #'(bound-details right-broken Y) = #-3
2279 c1 \glissando \break
2283 Un número de propiedades adicionales de las sub-listas @code{left} y
2284 @code{right} de la propiedad @code{bound-details} se pueden
2285 especificar de la misma forma que @code{Y}:
2289 Establece la coordenada Y del punto extremo, en desplazamientos de
2290 @code{staff-space}s desde la línea central del pentagrama. De forma
2291 predeterminada es el centro del objeto ancla, y así un glissando
2292 apunta al centro vertical de la cabeza de la nota.
2294 Para extensores horizontales como los extensores de texto y los
2295 trinos, está inamoviblemente codificado como 0.
2297 @item attach-dir (dirección de anclaje)
2298 Determina dónde comienza y termina la línea en la dirección X, con
2299 relación al objeto ancla. Sí, un valor de @code{-1} (o @code{LEFT},
2300 izquierda) hace que la línea comience o termine en el lado izquierdo
2301 de la cabeza de la nota a la que está anclado.
2304 Es la coordenada X absoluta del punto extremo. Se suele calcular al
2305 vuelo, y su sobreescritura no tiene un efecto útil.
2307 @item stencil (sello)
2308 Los extensores de línea pueden tener símbolos al comienzo o al final,
2309 lo que está contenido en esta sub-propiedad. Esto es para uso
2310 interno; se recomienda en su lugar el uso de @code{text}.
2313 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
2314 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2315 de extensión horizontales.
2317 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2318 \override TextSpanner #'(bound-details left text)
2319 = \markup { \small \bold Slower }
2320 c2\startTextSpan b c a\stopTextSpan
2323 @item stencil-align-dir-y (alineación del sello en y)
2324 @item stencil-offset (desplazamiento del sello)
2325 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2326 punto extremo, centrado sobre la línea, como viene definido por las
2327 subpropiedades @code{X} e @code{Y}. Si se fijan
2328 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2329 símbolo del borde verticalmente con relación al extremo de la línea:
2331 @lilypond[relative=1,fragment,verbatim]
2332 \override TextSpanner
2333 #'(bound-details left stencil-align-dir-y) = #-2
2334 \override TextSpanner
2335 #'(bound-details right stencil-align-dir-y) = #UP
2337 \override TextSpanner
2338 #'(bound-details left text) = #"ggg"
2339 \override TextSpanner
2340 #'(bound-details right text) = #"hhh"
2341 c4^\startTextSpan c c c \stopTextSpan
2344 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2345 al contrario de lo que podría esperarse, pues el valor de @code{-1} o
2346 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
2347 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
2348 (arriba) alinea el borde superior del texto con la línea extensora.
2350 @item arrow (flecha)
2351 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
2352 flecha en el extremo de la línea.
2354 @item padding (relleno)
2355 Esta sub-propiedad controla el espacio entre el punto extremo
2356 especificado de la línea y el extremo real. Sin relleno, un glissando
2357 empezaría y terminaría en el centro de la cabeza de las notas.
2361 La función musical @code{\endSpanners} finaliza de forma prematura el
2362 extensor que comienza sobre la nota que sigue inmediatamente a
2363 continuación. Se termina después de una nota exactamente, o en la
2364 siguiente barra de compás si @code{to-barline} es verdadero y se
2365 produce una divisoria antes de la siguiente nota.
2367 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
2369 c2 \startTextSpan c2 c2
2374 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
2375 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
2379 Referencia de funcionamiento interno:
2380 @rinternals{TextSpanner},
2381 @rinternals{Glissando},
2382 @rinternals{VoiceFollower},
2383 @rinternals{TrillSpanner},
2384 @rinternals{line-spanner-interface}.
2387 @node Visibilidad de los objetos
2388 @subsection Visibilidad de los objetos
2389 @translationof Visibility of objects
2391 @cindex objetos, visibilidad de
2392 @cindex grobs, visibilidad de
2393 @cindex visibilidad de los objetos
2395 Hay cuatro formas principales en que se puede controlar la visibilidad
2396 de los objetos de presentación: se puede eliminar su sello, se pueden
2397 volver transparentes, se pueden pintar de blanco, o se puede
2398 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
2399 se aplican a todos los objetos de presentación; la última sólo a unos
2400 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
2401 introduce estas cuatro técnicas, véase @rlearning{Visibilidad y color de los objetos}.
2403 Hay también algunas otras técnicas que son específicas de ciertos
2404 objetos de presentación. Se estudian bajo Consideraciones especiales.
2407 * Eliminar el sello::
2408 * Hacer transparentes los objetos::
2409 * Pintar los objetos de blanco::
2410 * Uso de break-visibility (visibilidad en el salto)::
2411 * Consideraciones especiales::
2415 @node Eliminar el sello
2416 @unnumberedsubsubsec Eliminar el sello
2417 @translationof Removing the stencil
2419 @cindex sello, eliminar
2421 Todo objeto de presentación tiene una propiedad stencil (sello). De
2422 forma predeterminada está establecida a la función específica que
2423 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
2424 se llama a ninguna función y el objeto no se dibuja. La acción
2425 predeterminada se puede recuperar con @code{\revert}.
2427 @lilypond[quote,verbatim,relative=1]
2429 \override Score.BarLine #'stencil = ##f
2431 \revert Score.BarLine #'stencil
2435 @node Hacer transparentes los objetos
2436 @unnumberedsubsubsec Hacer transparentes los objetos
2437 @translationof Making objects transparent
2439 @cindex transparentes, hacer los objetos
2441 Todo objeto de presentación tiene una propiedad transparent
2442 (transparente) que de forma predeterminada está establecida a
2443 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
2446 @lilypond[quote,verbatim,relative=2]
2448 \once \override NoteHead #'transparent = ##t
2452 @node Pintar los objetos de blanco
2453 @unnumberedsubsubsec Pintar los objetos de blanco
2454 @translationof Painting objects white
2456 @cindex objetos, coloreado de
2457 @cindex coloreado de objetos
2459 @cindex impresión, orden de
2460 @cindex sobreescritura de objetos
2461 @cindex objetos, sobreescritura de
2462 @cindex grobs, sobreescritura de
2464 Todo objeto de presentación tiene una propiedad de color que de forma
2465 predeterminada está establecida a @code{black} (negro). Si se
2466 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
2467 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
2468 color de los puntos de cruce queda determinado por el orden en que se
2469 dibujan estos objetos, lo que puede dejar una imagen fantasma del
2470 objeto blanco, como puede verse aquí:
2472 @lilypond[quote,verbatim,relative=2]
2473 \override Staff.Clef #'color = #white
2477 Se puede evitar esto cambiando el orden de impresión de los objetos.
2478 Todos los objetos de presentación tienen una propiedad @code{layer}
2479 (capa) que se debe establecer a un valor entero. Los objetos con el
2480 valor de @code{layer} más bajo se dibujan primero, después se dibujan
2481 los objetos con valores progresivamente mayores, y así los objetos con
2482 valores más altos se dibujan encima de los que tienen valores más
2483 bajos. De forma predeterminada, casi todos los objetos tienen
2484 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
2485 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
2486 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
2487 impresión de los objetos con el mismo valor de @code{layer} es
2490 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
2491 predeterminado de @code{1}, se dibuja después de las líneas del
2492 pentagrama (valor @code{layer} predeterminado de @code{0}),
2493 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
2494 @code{Clef} un valor de @code{layer} más bajo, digamos @code{-1}, para
2495 que se dibuje antes:
2497 @lilypond[quote,verbatim,relative=2]
2498 \override Staff.Clef #'color = #white
2499 \override Staff.Clef #'layer = #-1
2503 @node Uso de break-visibility (visibilidad en el salto)
2504 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
2505 @translationof Using break-visibility
2507 @c TODO Add making other objects breakable
2509 @cindex break-visibility
2511 Casi todos los objetos de presentación se imprimen una sola vez, pero
2512 algunos como las líneas divisorias, claves, indicaciones de compás y
2513 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
2514 se produce un salto de línea : una vez al final de la línea y otra al
2515 comienzo de la siguiente. Estos objetos reciben el nombre de
2516 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
2517 (visibilidad en el salto), para controlar su visibilidad en las tres
2518 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
2519 la línea si se produce un cambio, y al final de la línea si el cambio
2520 se produce en ese lugar.
2522 Por ejemplo, la indicación de compás se imprime de forma
2523 predeterminada al comienzo de la primera línea y en ningún otro lugar
2524 a no ser que cambie, en cuyo caso se imprime en el punto en que se
2525 produce el cambio. Si este cambio se produce al final de una línea,
2526 la nueva indicación de compás se imprime al principio de la línea
2527 siguiente y también al final de la línea anterior como indicación de
2530 Este comportamiento se controla por medio de la propiedad
2531 @code{break-visibility}, que se explica en
2532 @c Leave this ref on a newline - formats incorrectly otherwise -td
2533 @rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
2534 vector de tres valores booleanos que, por orden, determinan si el
2535 objeto se imprime al final, dentro, o al principio de la línea. O,
2536 para ser más exactos: antes del salto de línea, si no hay salto, o
2539 Como alternativa se puede especificar cualquiera de las ocho
2540 combinaciones mediante funciones predefinidas cuya definición está en
2541 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
2542 los objetos de presentación serán visibles en las posiciones que se
2543 muestran en el encabezamiento de cada columna:
2545 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {yes} {yes} {yes}
2546 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
2547 @headitem de función @tab de vector @tab salto @tab salto @tab salto
2549 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
2550 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
2551 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
2552 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
2553 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
2554 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
2555 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
2556 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
2559 Los ajustes predeterminados de @code{break-visibility} dependen del
2560 objeto de presentación. La tabla siguiente muestra todos los objetos
2561 de presentación de interés que resultan afectados por
2562 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
2564 @multitable @columnfractions .3 .3 .4
2566 @headitem Objeto @tab Contexto usual @tab Valor predet.
2568 @c omit Ambitus as it appears not to be affected by break-visibility -td
2569 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
2570 @item @code{BarLine} @tab @code{Score} @tab calculado
2571 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
2572 @c omit the following item until it can be explained -td
2573 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculated
2574 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2575 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
2576 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
2577 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2578 @c omit KeyCancellation until it can be explained -td
2579 @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible}
2580 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
2581 @c omit LeftEdge until it can be explained -td
2582 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
2583 @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible}
2584 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
2585 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
2589 El ejemplo de abajo muestra el uso de la forma de vector para
2590 controlar la visibilidad de las líneas divisorias:
2592 @lilypond[quote,verbatim,relative=1,ragged-right]
2595 % Remove bar line at the end of the current line
2596 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
2602 Aunque los tres componentes del vector utilizado para sobreescribir
2603 @code{break-visibility} deben estar presentes, no todos son efectivos
2604 para todos los objetos de presentación, y algunas combinaciones pueden
2605 incluso dar errores. Son de aplicación las siguientes limitaciones:
2608 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
2609 @item No se puede imprimir el número de compás al principio de la primera
2610 línea a no ser que su valor establecido sea distinto de 1.
2611 @item Clave: véase más abajo
2612 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
2613 se suprimen por completo. Utilice begin-of line-invisible para
2614 imprimirlas y all-invisible para suprimirlas.
2615 @item Armadura: véase más abajo
2616 @item OctavateEight: véase más abajo
2619 @node Consideraciones especiales
2620 @unnumberedsubsubsec Consideraciones especiales
2621 @translationof Special considerations
2623 @strong{@emph{Visibilidad después de un cambio explícito}}
2625 @cindex armadura, visibilidad después de un cambio explícito
2626 @cindex explicitKeySignatureVisibility
2627 @cindex clave, visibilidad después de un cambio explícito
2628 @cindex explicitClefVisibility
2630 La propiedad @code{break-visibility} controla la visibilidad de las
2631 armaduras y cambios de clave sólo al principio de las líneas, es
2632 decir, después de un salto. No tiene ningún efecto sobre la
2633 visibilidad de la armadura o la clave después de un cambio explícito
2634 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
2635 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
2636 bemol mayor es visible incluso con @code{all-invisible} establecido.
2638 @lilypond[quote,verbatim,relative=1,ragged-right]
2641 % Try to remove all key signatures
2642 \override Staff.KeySignature #'break-visibility = #all-invisible
2650 La visibilidad de estos cambios explícitos de tonalidad y de clave se
2651 controla por medio de las propiedades
2652 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
2653 Son los equivalentes de la propiedad @code{break-visibility} y las dos
2654 toman un vector de tres valores booleanos o las funciones predefinidas
2655 relacionadas anteriormente, exactamente igual que
2656 @code{break-visibility}. Las dos son propiedades del contexto Staff,
2657 no de los propios objetos de presentación, y por tanto se establecen
2658 utilizando la instrucción @code{\set}. Las dos están establecidas de
2659 forma predeterminada al valor @code{all-visible}. Estas propiedades
2660 controlan sólo la visibilidad de las armaduras y las claves que
2661 resultan de los cambios explícitos y no afectan a las armaduras y
2662 tonalidades que están al principio de las líneas; para quitarlas, aún
2663 se debe sobreescribir la propiedad @code{break-visibility} en el
2664 objeto correspondiente.
2666 @lilypond[quote,verbatim,relative=1,ragged-right]
2669 \set Staff.explicitKeySignatureVisibility = #all-invisible
2670 \override Staff.KeySignature #'break-visibility = #all-invisible
2677 @strong{@emph{Visibilidad de las alteraciones de precaución}}
2679 Para eliminar las alteraciones de precaución que se imprimen en un
2680 cambio de tonalidad explícito, establezca la propiedad
2681 @code{printKeyCancellation} del contexto Staff a @code{#f}:
2683 @lilypond[quote,verbatim,relative=1,ragged-right]
2686 \set Staff.explicitKeySignatureVisibility = #all-invisible
2687 \set Staff.printKeyCancellation = ##f
2688 \override Staff.KeySignature #'break-visibility = #all-invisible
2695 Con estas sobreescrituras solamente permanecen las alteraciones
2696 accidentales delante de las notas para indicar el cambio de tonalidad.
2698 @c TODO Add visibility of cautionary accidentals before notes
2700 @strong{@emph{Automatic bars}}
2702 @cindex automaticBars
2703 @cindex líneas divisorias, eliminación
2705 Como caso especial, la impresión de las líneas divisorias también se
2706 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
2707 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
2708 imprimen automáticamente; se deben crear explícitamente con una
2709 instrucción @code{\bar}. A diferencia de la instrucción predefinida
2710 @code{\cadenzaOn}, los compases se siguen contando. La generación de
2711 compases continúa de acuerdo a esta cuenta si esta propiedad se
2712 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
2713 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
2718 @strong{@emph{Octavated clefs}}
2720 @cindex octavadas, visibilidad de las claves
2721 @cindex visibilidad de las claves octavadas
2722 @cindex claves, visibilidad de la octavación
2724 El pequeño símbolo de octava sobre las claves en octava alta o baja se
2725 produce por parte del objeto @code{OctavateEight}. Su visibilidad se
2726 controla independientemente de la del objeto @code{Clef}, así que es
2727 necesario aplicar las sobreescrituras correspondientes
2728 @code{break-visibility} tanto a los objetos @code{Clef} como
2729 @code{OctavateEight} para suprimir completamente estos símbolos de
2730 clave al comienzo de cada línea.
2732 Para los cambios de clave explícitos, la propiedad
2733 @code{explicitClefVisibility} controla tanto el símbolo de clave como
2734 el símbolo de octava asociado.
2738 Manual de aprendizaje:
2739 @rlearning{Visibilidad y color de los objetos}
2742 @node Estilos de línea
2743 @subsection Estilos de línea
2744 @translationof Line styles
2746 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
2747 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
2748 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
2750 Todos ellos usan las mismas rutinas que el glissando para dibujar los
2751 textos y las líneas, y por ello el ajuste fino de su comportamiento se
2752 hace de la misma manera. Se hace con un spanner (un objeto de
2753 extensión), y la rutina responsable de dibujar los objetos de
2754 extensión es @code{ly:line-interface::print}. Esta rutina determina la
2755 colocación exacta de los dos @i{extremos del objeto de extensión} y
2756 dibuja una línea entre ellos, en el estilo solicitado.
2758 He aquí un ejemplo de los distintos estilos de línea disponibles, y
2759 cómo aplicarles ajustes finos.
2761 @lilypond[relative=2,ragged-right,verbatim,fragment]
2763 \once \override Glissando #'style = #'dashed-line
2765 \override Glissando #'style = #'dotted-line
2767 \override Glissando #'style = #'zigzag
2769 \override Glissando #'style = #'trill
2773 Las posiciones de los puntos extremos del objeto de extensión se
2774 computan al vuelo para cada uno de los objetos gráficos, pero es
2775 posible sobreescribirlos:
2777 @lilypond[relative=2,ragged-right,verbatim,fragment]
2779 \once \override Glissando #'(bound-details right Y) = #-2
2783 El valor de @code{Y} está establecido a @code{-2} para el extremo
2784 derecho. El lado izquierdo se puede ajustar de forma similar
2785 especificando @code{left} en vez de @code{right}.
2787 Si no está establecido @code{Y}, el valor se computa a partir de la
2788 posición vertical de los puntos de anclaje izquierdo y derecho del
2791 Son posibles otros ajustes de los extensores, para ver más detalles
2792 consulte @ref{Objetos de extensión}.
2795 @node Rotación de objetos
2796 @subsection Rotación de objetos
2797 @translationof Rotating objects
2799 Tanto los objetos de presentación como los elementos de texto de
2800 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
2801 pero difiere el método de hacerlo.
2804 * Rotación de objetos de presentación::
2805 * Rotación de elementos de marcado::
2808 @node Rotación de objetos de presentación
2809 @unnumberedsubsubsec Rotación de objetos de presentación
2810 @translationof Rotating layout objects
2812 @cindex rotating objects
2813 @cindex objects, rotating
2815 Todos los objetos de presentación que contemplan el interface
2816 @code{grob-interface} se pueden rotar estableciendo su propiedad
2817 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
2818 rotación en sentido antihorario, y las coordenadas x e y del punto con
2819 relación al punto de referencia del objeto, alrededor del que se va a
2820 realizar la rotación. El ángulo de rotación se especifica en grados
2821 y las coordenadas en espacios de pentagrama.
2823 El ángulo de rotación y las coordenadas del punto de rotación se deben
2824 determinar por ensayo y error.
2826 @cindex reguladores en ángulo
2827 @cindex ángulo, reguladores en
2829 Solamente en ciertas ocasiones es útil la rotación de objetos de
2830 presentación; el ejemplo siguiente muestra una situación en que puede
2833 @lilypond[quote,verbatim,relative=1]
2835 \override Hairpin #'rotation = #'(20 -1 0)
2839 @node Rotación de elementos de marcado
2840 @unnumberedsubsubsec Rotación de elementos de marcado
2841 @translationof Rotating markup
2843 Todos los textos de marcado se pueden rotar para que se dispongan en
2844 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
2845 instrucción acepta dos argumentos: el ángulo de rotación en grados en
2846 sentido antihorario, y el texto que rotar. Los límites que ocupa el
2847 texto no se rotan: toman su valor a partir de los extremos de las
2848 coordenadas x e y del texto rotado. En el ejemplo siguiente la
2849 propiedad @code{outside-staff-priority} del texto se establece a
2850 @code{#f} para desactivar la evitación automática de colisiones, lo
2851 que empuja al texto a una posición muy alta.
2853 @lilypond[quote,verbatim,relative=1]
2854 \override TextScript #'outside-staff-priority = ##f
2855 g4^\markup { \rotate #30 "a G" }
2856 b^\markup { \rotate #30 "a B" }
2857 des^\markup { \rotate #30 "a D-Flat" }
2858 fis^\markup { \rotate #30 "an F-Sharp" }
2861 @node Trucos avanzados
2862 @section Trucos avanzados
2863 @translationof Advanced tweaks
2865 Esta sección trata sobre distintos enfoques en la realización de
2866 ajustes finos a la apariencia de la partitura impresa.
2869 * Alineación de objetos::
2870 * Agrupación vertical de objetos gráficos::
2871 * Modificación de los sellos::
2872 * Modificación de las formas::
2877 Manual de aprendizaje:
2878 @rlearning{Trucar la salida},
2879 @rlearning{Otras fuentes de información}.
2881 Referencia de la notación:
2882 @ref{Explicación del Manual de referencia de funcionamiento interno},
2883 @ref{Modificar las propiedades},
2884 @ref{Interfaces para programadores}.
2887 @file{scm/@/define@/-grobs@/.scm}.
2889 Fragmentos de código:
2890 @rlsr{Tweaks and overrides}.
2892 Referencia de funcionamiento interno:
2893 @rinternals{All layout objects}.
2896 @node Alineación de objetos
2897 @subsection Alineación de objetos
2898 @translationof Aligning objects
2900 Los objetos gráficos que soportan el interface
2901 @code{self-alignment-interface} y/o el @code{side-position-interface}
2902 se pueden alinear contra un objeto colocado previamente, de diversas
2903 maneras. Para ver una lista de estos objetos, consulte
2904 @rinternals{self-alignment-interface} y
2905 @rinternals{side-position-interface}.
2907 Todos los objetos gráficos tienen un punto de referencia, una
2908 extensión horizontal y una extensión vertical. La extensión
2909 horizontal es una pareja de números que dan los desplazamientos a
2910 partir del punto de referencia de los bordes izquierdo y derecho,
2911 siendo negativos los desplazamientos hacia la izquierda. La extensión
2912 vertical es una pareja de números que dan el desplazamiento a partir
2913 del punto de referencia hasta los bordes inferior y superior, siendo
2914 negativos los desplazamientos hacia abajo.
2916 La posición de un objeto sobre el pentagrama viene dada por los
2917 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
2918 valor de @code{X-offset} da el desplazamiento desde la coordenada x
2919 del punto de referencia del objeto padre, y el valor de
2920 @code{Y-offset} da el desplazamiento a partir de la línea central del
2921 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
2922 pueden establecer directamente o se puede dejar que se calculen por
2923 parte de procedimientos para conseguir una alineación con el objeto
2924 padre de distintas maneras.
2926 @warning{Muchos objetos tienen consideraciones de posicionamiento
2927 especiales que hacen que se ignore o se modifique cualquier ajuste
2928 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
2929 objeto contemple el interface @code{self-alignment-interface}.}
2931 Por ejemplo, una alteración accidental se puede reposicionar
2932 verticalmente estableciendo @code{Y-offset} pero los cambios a
2933 @code{X-offset} no tienen ningún efecto.
2935 Las letras de ensayo se pueden alinear con objetos divisibles como
2936 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
2937 propiedades especiales que se encuentran en
2938 @code{break-aligned-interface} para el posicionamiento de las letras
2939 de ensayo sobre dichos objetos.
2942 * Establecer directamente @code{X-offset} y @code{Y-offset}::
2943 * Uso del @code{side-position-interface}::
2944 * Uso del @code{self-alignment-interface}::
2945 * Uso del @code{break-alignable-interface}::
2948 @node Establecer directamente @code{X-offset} y @code{Y-offset}
2949 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
2950 @translationof Setting @code{X-offset} and @code{Y-offset} directly
2952 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
2953 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
2954 notas con una digitación en su posición predeterminada y con los
2955 valores @code{X-offset} y @code{Y-offset} modificados.
2957 @lilypond[verbatim,quote,relative=2]
2960 -\tweak #'X-offset #0
2961 -\tweak #'Y-offset #0
2964 -\tweak #'X-offset #-1
2965 -\tweak #'Y-offset #1
2971 @node Uso del @code{side-position-interface}
2972 @unnumberedsubsubsec Uso del @code{side-position-interface}
2973 @translationof Using the @code{side-position-interface}
2975 Un objeto que contempla el @code{side-position-interface} se puede
2976 colocar junto a su objeto padre de forma que los bordes especificados
2977 de los dos objetos se toquen. El objeto se puede situar encima,
2978 debajo, a la derecha o a la izquierda del objeto padre. El padre no
2979 se puede especificar; viene determinado por el orden de los elementos
2980 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
2981 nota asociada como padre.
2983 Los valores de las propiedades @code{side-axis} y @code{direction}
2984 determinan dónde colocar el objeto, como sigue:
2986 @c TODO add an example of each to the table
2988 @multitable @columnfractions .3 .3 .3
2989 @headitem @code{side-axis} @tab @code{direction} @tab
2990 @headitem propiedad @tab propiedad @tab colocación
2992 @item @code{0} @tab @code{-1} @tab izquierda
2993 @item @code{0} @tab @code{1} @tab derecha
2994 @item @code{1} @tab @code{-1} @tab debajo
2995 @item @code{1} @tab @code{1} @tab encima
2999 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
3000 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
3001 procedimiento devuelve el calor correcto de @code{X-offset} para
3002 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
3003 el valor de @code{direction}.
3005 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
3006 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
3007 procedimiento devuelve el valor correcto de @code{Y-offset} para
3008 situar el objeto encima o debajo del padre de acuerdo con el valor de
3011 @c TODO Add examples
3013 @node Uso del @code{self-alignment-interface}
3014 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
3015 @translationof Using the @code{self-alignment-interface}
3017 @emph{Auto-alineación horizontal de los objetos}
3019 La alineación horizontal de un objeto que contempla el interface
3020 @code{self-alignment-interface} está controlada por el valor de la
3021 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
3022 @code{X-offset} de este objeto esté establecida a
3023 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
3024 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
3025 mitad de la extensión X total del objeto. Los valores negativos
3026 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
3027 valor de @code{0} centra el objeto sobre el punto de referencia de su
3028 padre, un valor de @code{-1} alinea el borde izquierdo del objeto
3029 sobre el punto de referencia de su padre, y un valor de @code{1}
3030 alinea el borde derecho del objeto sobre el punto de referencia de su
3031 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
3032 @code{RIGHT} en sustitución de los valores @code{-1, 0, 1},
3035 Normalmente se usaría la instrucción @code{\override} para modificar
3036 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
3037 @code{\tweak} para alinear varias anotaciones por separado sobre una
3040 @lilypond[quote,verbatim,relative=1]
3042 -\tweak #'self-alignment-X #-1
3044 -\tweak #'self-alignment-X #0
3046 -\tweak #'self-alignment-X #RIGHT
3048 -\tweak #'self-alignment-X #-2.5
3049 ^"aligned further to the right"
3052 @emph{Auto-alineación vertical de los objetos}
3054 Los objetos se pueden alinear verticalmente en una forma análoga a la
3055 alineación horizontal si la propiedad @code{Y-offset} está establecida
3056 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
3057 a menudo se encuentran implicados otros mecanismos en la alineación
3058 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
3059 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
3060 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
3061 las dimensiones verticales del objeto, que suele ser bastante pequeño,
3062 por lo que pueden requerirse números bastante grandes. Un valor de
3063 @code{-1} alinea el borde inferior del objeto con el punto de
3064 referencia del objeto padre, un valor de @code{0} alinea el centro del
3065 objeto con el punto de referencia del padre, y un valor de @code{1}
3066 alinea el borde superior del objeto con el punto de referencia del
3067 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
3068 @code{UP} en sustitución de @code{-1, 0, 1} respectivamente.
3070 @emph{Auto-alineación de objetos en las dos direcciones}
3072 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
3073 alinear un objeto en las dos direcciones simultáneamente.
3075 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
3076 se acerque a la cabeza de la nota.
3078 @lilypond[quote,verbatim,relative=2]
3080 -\tweak #'self-alignment-X #0.5 % move horizontally left
3081 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
3082 -\tweak #'self-alignment-Y #-1 % move vertically up
3087 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
3089 @c Cannot document as they do not seem to operate consistently on all objects -td
3090 @c TODO investigate further
3092 The @code{aligned-on-parent} procedures are used in the same way
3093 as the @code{aligned-on-self} procedures, they difference being
3094 that they permit an object to be aligned with the @emph{edges} of
3095 the parent rather than the parent's reference point. The following
3096 example shows the difference:
3100 @lilypond[verbatim,quote]
3106 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
3108 @c Cannot document as they do not seem to operate consistently on all objects -td
3109 @c TODO investigate further
3113 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
3116 @node Uso del @code{break-alignable-interface}
3117 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
3118 @translationof Using the @code{break-alignable-interface}
3120 @cindex alineación a objetos
3121 @cindex break-align-symbols
3123 Las letras de ensayo se pueden alinear con objetos de notación
3124 distintos a las barras de compás. Estos objetos son @code{ambitus},
3125 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
3126 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
3127 @code{time-signature}.
3129 De forma predeterminada, las letras de ensayo y los números de compás
3130 se centran horizontalmente sobre el objeto:
3132 @lilypond[verbatim,quote,relative=1]
3134 % the RehearsalMark will be centered above the Clef
3135 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
3140 % the RehearsalMark will be centered above the TimeSignature
3141 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
3149 Se puede especificar una lista de posibles objetos para la alineación.
3150 Si algunos de los objetos son invisibles en ese punto debido al valor
3151 de @code{break-visibility} o a valores de visibilidad explícitos para
3152 las armaduras y las claves, la letra de ensayo o número de compás se
3153 alinean con el primer objeto de la lista que sea visible. Si ningún
3154 objeto de la lista es visible, el objeto se alinea con la línea
3155 divisoria. Si la línea divisoria es invisible, el objeto se alinea
3156 con el punto en el que se encontraría la línea divisoria.
3158 @lilypond[verbatim,quote,relative=1]
3160 % the RehearsalMark will be centered above the Key Signature
3161 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3166 % the RehearsalMark will be centered above the Clef
3167 \set Staff.explicitKeySignatureVisibility = #all-invisible
3168 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3175 La alineación de la letra de ensayo con relación al objeto de notación
3176 se puede cambiar, como se ve en el ejemplo siguiente. En una
3177 partitura con varios pentagramas, este ajuste se debe hacer para todos
3180 @lilypond[verbatim,quote,relative=1]
3181 % The RehearsalMark will be centered above the KeySignature
3182 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3188 % The RehearsalMark will be aligned with the left edge of the KeySignature
3189 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
3193 % The RehearsalMark will be aligned with the right edge of the KeySignature
3194 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
3200 La letra de ensayo también se puede desplazar al borde derecho o
3201 izquierdo en una medida arbitraria. Las unidades son espacios de
3204 @lilypond[verbatim,quote,relative=1]
3205 % The RehearsalMark will be aligned with the left edge of the KeySignature
3206 % and then shifted right by 3.5 staff-spaces
3207 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3208 \once \override Score.KeySignature #'break-align-anchor = #3.5
3212 % The RehearsalMark will be aligned with the left edge of the KeySignature
3213 % and then shifted left by 2 staff-spaces
3214 \once \override Score.KeySignature #'break-align-anchor = #-2
3221 @node Agrupación vertical de objetos gráficos
3222 @subsection Agrupación vertical de objetos gráficos
3223 @translationof Vertical grouping of grobs
3225 Los grobs (objetos gráficos) @code{VerticalAlignment} y
3226 @code{VerticalAxisGroup} trabajan de manera coordinada.
3227 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
3228 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
3229 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
3230 Normalmente sólo existe un @code{VerticalAlignment} por cada
3231 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
3232 @code{VerticalAxisGroup}.
3235 @node Modificación de los sellos
3236 @subsection Modificación de los sellos
3237 @translationof Modifying stencils
3239 Todos los objetos de presentación tienen una propiedad @code{stencil}
3240 que es parte del @code{grob-interface}. De forma predeterminada, esta
3241 propiedad suele estar establecida a una función específica del objeto
3242 que está hecha a medida para disponer el símbolo que lo representa en
3243 la salida. Por ejemplo, el ajuste estándar para la propiedad
3244 @code{stencil} del objeto @code{MultiMeasureRest} es
3245 @code{ly:multi-measure-rest::print}.
3247 El símbolo estándar de cualquier objeto se puede sustituir modificando
3248 la propiedad @code{stencil} para que haga referencia a un
3249 procedimiento diferente escrito especialmente. Esto requiere un alto
3250 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3251 una forma más fácil que a menudo puede dar resultados adecuados.
3253 El procedimiento es establecer la propiedad @code{stencil} al
3254 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3255 añadir una propiedad @code{text} al objeto ajustada para que contenga
3256 el texto de marcado que produce el símbolo requerido. Debido a la
3257 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3258 particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
3260 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3261 la nota a unas aspas dentro de una circunferencia.
3263 @lilypond[verbatim,quote]
3265 \once \override NoteHead #'stencil = #ly:text-interface::print
3266 \once \override NoteHead #'text = \markup {
3268 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3269 \musicglyph #"noteheads.s2cross"
3277 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3278 a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
3280 @c TODO Add inserting eps files or ref to later
3282 @c TODO Add inserting Postscript or ref to later
3286 Referencia de la notación:
3287 @ref{Notación gráfica dentro de elementos de marcado},
3288 @ref{Formatear el texto},
3289 @ref{Text markup commands},
3290 @ref{La tipografía Feta}.
3293 @node Modificación de las formas
3294 @subsection Modificación de las formas
3295 @translationof Modifying shapes
3298 * Modificación de ligaduras de unión y de expresión::
3301 @node Modificación de ligaduras de unión y de expresión
3302 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
3303 @translationof Modifying ties and slurs
3305 @cindex ligaduras de expresión, modificar
3306 @cindex ligaduras de unión, modificar
3307 @cindex Bézier, curvas de
3308 @cindex Bézier, puntos de control
3310 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
3311 de Bézier de tercer orden. Si la forma de la ligadura calculada
3312 automáticamente no resulta óptima, se puede modificar su forma
3313 manualmente mediante la especificación explícita de los cuatro puntos
3314 de control necesarios para definir una curva de Bézier de tercer
3317 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
3318 puntos de control. El primer y cuarto puntos de control son
3319 exactamente los puntos extremos de comienzo y de final de la curva.
3320 Los dos puntos de control intermedios definen la forma. Se pueden
3321 encontrar en la web animaciones que muestran cómo se traza la curva,
3322 pero la descripción siguiente puede ser de ayuda. La curva comienza a
3323 partir del primer punto de control dirigiéndose directamente hacia el
3324 segundo, curvándose progresivamente para dirigirse hacia el tercero y
3325 continuando la curva hacia el cuarto, llegando a éste en viaje directo
3326 desde el tercer punto de control. La curva está contenida enteramente
3327 dentro del cuadrilátero definido por los cuatro puntos de control.
3329 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
3330 @code{\tieDown} no sirve de ayuda.
3332 @lilypond[verbatim,quote,relative=1]
3336 { r4 <g c,> <g c,> <g c,> }
3340 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
3341 de control como sigue.
3343 Las coordenadas de los puntos de control de Bézier se especifican en
3344 unidades de espacios de pentagrama. La coordenada@tie{}X está en
3345 relación con el punto de referencia de la nota a la que está unida la
3346 ligadura, y la coordenada@tie{}Y está en relación con la línea central
3347 del pentagrama. Las coordenadas se introducen como una lista de
3348 cuatro parejas de números decimales (reales). Un enfoque es estimar
3349 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
3350 los dos puntos intermedios. Los valores óptimos se encuentran por
3353 Es útil recordar que una curva simétrica necesita puntos de control
3354 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
3355 las transformaciones de la curva tales como la traslación, rotación y
3356 escalado se pueden obtener aplicando la misma transformación a los
3357 puntos de control de la curva.
3359 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
3360 satisfactoria. Observe la colocación: debe ir inmediatamente antes de
3361 la nota a la que se asigna el comienzo de la ligadura de expresión o
3364 @lilypond[verbatim,quote,relative=1]
3368 #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
3372 { r4 <g c,> <g c,> <g c,>4 }
3378 No es posible modificar la forma de las ligaduras de unión o de
3379 expresión cambiando la propiedad @code{control-points} si hay más de
3380 una en el mismo momento musical, ni siquiera usando la instrucción