1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 412fa426d510594ec7772c7cf7b568e376bd1c84
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Cambiar los valores por omisión
14 @chapter Cambiar los valores por omisión
15 @translationof Changing defaults
17 El objetivo del diseño de LilyPond es proporcionar la más alta calidad
18 de los resultados, de forma predeterminada. A pesar de ello, podría
19 tener que cambiar este resultado predeterminado. La disposición sobre
20 el papel se controla a través de un amplio número de @q{botones e
21 interruptores} llamados en su conjunto @q{propiedades}. En el Manual
22 de aprendizaje podemos encontrar una introducción en forma de tutorial
23 al acceso y modificación de estas propiedades, véase
24 @rlearning{Trucar la salida}. Éste debería leerse en primer lugar.
25 Este capítulo cubre un terreno similar, pero con un estilo más
26 adecuado para un manual de referencia.
28 @cindex Referencia de funcionamiento interno
30 La descripción definitiva de los controles que están disponibles para
31 su ajuste fino están en un documento aparte: la
32 @rinternalsnamed{Top,Referencia de funcionamiento interno}.
33 Dicho manual relaciona todas
34 las variables, funciones y opciones que se encuentran disponibles en
35 LilyPond. Está escrito como un documento HTML, que se puede encontrar
36 @c leave the @uref as one long line.
37 @uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,en línea},
38 pero que también va incluido en el paquete de la documentación de LilyPond.
40 Internamente, LilyPond utiliza el lenguaje Scheme (un dialecto de
41 LISP) para aportar la infraestructura. La sobreescritura de las
42 decisiones de disposición da acceso efectivo a las interioridades del
43 programa, lo que requiere código de Scheme como entrada. Los
44 elementos de Scheme se inauguran dentro de un archivo @code{.ly} con
45 el símbolo de cuadradillo @code{#}.@footnote{@rextend{Tutorial de
46 Scheme} contiene un breve tutorial sobre la introducción de números,
47 listas, cadenas y símbolos en Scheme.}
50 * Contextos de interpretación::
51 * Explicación del Manual de referencia de funcionamiento interno::
52 * Modificar las propiedades::
53 * Conceptos y propiedades útiles::
55 * Uso de las funciones musicales::
59 @node Contextos de interpretación
60 @section Contextos de interpretación
61 @translationof Interpretation contexts
63 Esta sección explica qué son los contextos y cómo modificarlos.
66 * Explicación de los contextos::
68 * Mantener vivos los contextos::
69 * Modificar los complementos (plug-ins) de contexto::
70 * Cambiar los valores por omisión de los contextos::
71 * Definir contextos nuevos::
72 * Alinear los contextos::
77 Manual de aprendizaje:
78 @rlearning{Contextos y grabadores}.
81 @file{ly/@/engraver@/-init@/.ly},
82 @file{ly/@/performer@/-init@/.ly}.
85 @rlsr{Contexts and engravers}.
87 Referencia de funcionamiento interno:
88 @rinternals{Contexts},
89 @rinternals{Engravers and Performers}.
92 @node Explicación de los contextos
93 @subsection Explicación de los contextos
94 @translationof Contexts explained
96 Los contextos se disponen de forma jerárquica:
99 * Score. El contexto maestro::
100 * Contextos del nivel superior. Contenedores de pentagramas::
101 * Contextos de nivel intermedio. Pentagramas::
102 * Contextos del nivel más bajo. Voces::
105 @node Score. El contexto maestro
106 @unnumberedsubsubsec Score. El contexto maestro
107 @translationof Score - the master of all contexts
109 Este es el contexto de notación del nivel más alto. Ningún otro
110 contexto puede contener a un contexto Score. De forma predeterminada,
111 el contexto Score maneja la administración de las indicaciones de
112 compás y se asegura de que ciertos elementos como claves, compases y
113 armaduras están siempre alineados entre los distintos pentagramas.
115 Se crea implícitamente una instancia del contexto Score cuando se
116 procesa un bloque @code{\score @{@dots{}@}} o @code{\layout
117 @{@dots{}@}}, o explícitamente cuando se ejecuta una instrucción
120 @node Contextos del nivel superior. Contenedores de pentagramas
121 @unnumberedsubsubsec Contextos del nivel superior: contenedores de pentagramas
122 @translationof Top-level contexts - staff containers
124 @strong{@emph{StaffGroup}}
126 Agrupa pentagramas y añade un corchete en la parte izquierda, formando
127 un grupo. Las líneas divisorias de los pentagramas contenidos se
128 conectan verticalmente. @code{StaffGroup} sólo consiste en una
129 colección de pentagramas, con un corchete delante y líneas divisorias
132 @strong{@emph{ChoirStaff}}
134 Idéntico a @code{StaffGroup} excepto que las barras de compás de los
135 pentagramas contenidos no se conectan verticalmente.
137 @strong{@emph{GrandStaff}}
139 Un grupo de pentagramas, con una llave en la parte izquierda que
140 abarca el grupo. Las barras de compás de los pentagramas contenidos
141 se conectan verticalmente.
143 @strong{@emph{PianoStaff}}
145 Igual que @code{GrandStaff}, pero contempla la posibilidad de poner el
146 nombre del instrumento a la izquierda del sistema.
148 @node Contextos de nivel intermedio. Pentagramas
149 @unnumberedsubsubsec Contextos de nivel intermedio. Pentagramas
150 @translationof Intermediate-level contexts - staves
152 @strong{@emph{Staff}}
154 Maneja claves, barras de compás, tonalidades y alteraciones
155 accidentales. Puede contener contextos de @code{Voice}.
157 @strong{@emph{RhythmicStaff}}
159 Como @code{Staff}, pero para imprimir ritmos. Se ignoran las alturas
160 de las notas; las notas se imprimen sobre una línea.
162 @strong{@emph{TabStaff}}
164 Contexto para generar tablaturas. De forma predeterminada dispone la
165 expresión musical como una tablatura de guitarra, impresa sobre seis
168 @strong{@emph{DrumStaff}}
170 Maneja el tipografiado para instrumentos de percusión. Puede contener
171 contextos @code{DrumVoice}.
173 @strong{@emph{VaticanaStaff}}
175 Igual que @code{Staff}, excepto que está pensado para tipografiar
176 piezas en estilo gregoriano.
178 @strong{@emph{MensuralStaff}}
180 Igual que @code{Staff}, excepto que está diseñado para tipografiar
181 piezas en estilo mensural.
184 @node Contextos del nivel más bajo. Voces
185 @unnumberedsubsubsec Contextos del nivel más bajo. Voces
186 @translationof Bottom-level contexts - voices
188 Los contextos del mismo nivel que Voice dan un valor inicial a ciertas
189 propiedades e inician los grabadores correspondientes. Siendo
190 contextos del nivel más bajo, no pueden contener a otros contextos.
192 @strong{@emph{Voice}}
194 Corresponde a una voz sobre un pentagrama. este contexto maneja la
195 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
196 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
197 que crear instancias explícitas de este contexto si necesitamos varias
198 voces en el mismo pentagrama.
200 @strong{@emph{VaticanaVoice}}
202 Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
203 piezas en estilo gregoriano.
205 @strong{@emph{MensuralVoice}}
207 Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
208 piezas en estilo mensural.
210 @strong{@emph{Lyrics}}
212 Corresponde a una voz con letra. Maneja la impresión de una sola
215 @strong{@emph{DrumVoice}}
217 El contexto de voz utilizado en una pauta de percusión.
219 @strong{@emph{FiguredBass}}
221 El contexto en que los objetos @code{BassFigure} se crean a partir de
222 la entrada escrita en el modo @code{\figuremode}.
224 @strong{@emph{TabVoice}}
226 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
227 Se suele dejar que se cree implícitamente.
229 @strong{@emph{CueVoice}}
231 El contexto de voz que se utiliza para dibujar notas de tamaño
232 reducido, con el principal objetivo de añadir notas guía de un
233 pentagrama a otro, véase @ref{Formateo de las notas guía}.
234 Normalmente se deja que se cree implícitamente.
236 @strong{@emph{ChordNames}}
238 Tipografía nombres de acordes.
241 @node Crear contextos
242 @subsection Crear contextos
243 @translationof Creating contexts
245 Para partituras que sólo tienen una voz y un pentagrama, los contextos
246 se crean automáticamente. Para partituras más complejas, es necesario
247 crearlos a mano. Existen tres instrucciones que hacen esto.
252 La instrucción más fácil es @code{\new}, y es también la más rápida de
253 escribir. Se antepone a una expresión musical, por ejemplo
256 @cindex nuevos, contextos
257 @cindex Contexto, creación de
260 \new @var{tipo} @var{expresión_musical}
264 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
265 @code{Voice}). Esta instrucción crea un contexto nuevo, y empieza a
266 interpretar la @var{expresión_musical} con él.
268 Una aplicación práctica de @code{\new} es una partitura con muchos
269 pentagramas. Cada parte que debe ir en su propio pentagrama, va
270 precedida de @code{\new Staff}.
272 @lilypond[quote,verbatim,relative=2,ragged-right,fragment]
279 La instrucción @code{\new} puede también dar nombre al contexto,
282 \new @var{tipo} = @var{identificador} @var{música}
284 Sin embargo, este nombre especificado por el usuario sólo se utiliza
285 si no hay ya otro contexto anterior con el mismo nombre.
291 Como @code{\new}, la instrucción @code{\context} también dirige una
292 expresión musical a un objeto de contexto, pero da al contexto un
293 nombre explícito. La sintaxis es
296 \context @var{tipo} = @var{identificador} @var{música}
299 En esta forma, la instrucción buscará un contexto existente del
300 @var{tipo} especificado que tenga el nombre @var{identificador}. Si
301 ese contexto aún no existe, se crea un contexto nuevo con el nombre
302 especificado. Esto es útil si nos vamos a referir más tarde al
303 contexto. Por ejemplo, cuando se escribe la letra, la melodía está
304 dentro de un contexto con nombre
307 \context Voice = "@b{tenor}" @var{música}
311 de forma que los textos se puedan alinear correctamente con sus notas,
314 \new Lyrics \lyricsto "@b{tenor}" @var{letra}
319 Otro uso posible de los contextos con nombre es la fusión de dos
320 expresiones musicales distintas en un solo contexto. En el siguiente
321 ejemplo, se introducen por separado las articulaciones y las notas:
325 decoracion = @{ s4-. s4-> @}
328 se combinan enviando los dos al mismo contexto @code{Voice},
332 \new Staff \context Voice = "A" \musica
333 \context Voice = "A" \decoracion
336 @lilypond[quote,ragged-right]
340 \new Staff \context Voice = "A" \music
341 \context Voice = "A" \arts
345 Con este mecanismo, es posible definir un @qq{urtext} (una edición
346 original), con la posibilidad de poner articulaciones distintas sobre
349 @cindex crear contextos
352 La tercera instrucción para crear contextos es
354 \context @var{tipo} @var{música}
359 Esto es similar a @code{\context} con @code{= @var{identificador}},
360 pero se corresponde con cualquier contexto del tipo @var{tipo}, sin
361 importar qué nombre se le ha dado.
363 Esta variante se usa con expresiones musicales que se pueden
364 interpretar en varios niveles. Por ejemplo, la instrucción
365 @code{\applyOutput} (véase @rextend{Ejecutar una función sobre todos
366 los objetos de la presentación}). Sin una instrucción @code{\context}
367 explícita, normalmente se aplicaría a @code{Voice}
370 \applyOutput #'@var{contexto} #@var{función} % aplicar al contexto Voice
373 Para que se interprete dentro de los niveles de @code{Score} o
374 @code{Staff}, utilice las siguientes formas:
377 \applyOutput #'Score #@var{función}
378 \applyOutput #'Staff #@var{función}
383 @node Mantener vivos los contextos
384 @subsection Mantener vivos los contextos
385 @translationof Keeping contexts alive
387 @cindex contextos, mantener vivos
388 @cindex contextos, tiempo de vida
390 Normalmente los contextos finalizan en el primer momento musical en
391 que no tienen nada que hacer. Así, los contextos de @code{Voice}
392 mueren tan pronto como ya no contienen ningún evento; los contextos de
393 @code{Staff} mueren tan pronto como todos los contextos de
394 @code{Voice} que contenían ya no contengan ningún evento; etc. Esto
395 puede ocasionar dificultades si se tiene que hacer referencia a
396 contextos anteriores que ya han muerto, por ejemplo, al cambiar de
397 pentagramas con instrucciones @code{\change}, asociar letra con una
398 voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
399 eventos musicales adicionales a un contexto anterior.
401 Existe una excepción a esta regla general: precisamente uno de los
402 contextos de @code{Voice} que están dentro de un contexto de
403 @code{Staff} o de una construcción @code{<<...>>} persiste siempre
404 hasta el final de, contexto de @code{Staff} circundante o la
405 construcción @code{<<...>>}, incluso aunque puede haber períodos en
406 que no tiene nada que hacer. El contexto que persiste de esta forma
407 será el primero que se encuentre en la primera construcción encerrada
408 entre llaves @code{@{...@}}, ignorando cualquiera que se encuentre
409 dentro de construcciones encerradas por ángulos dobles @code{<<...>>}.
411 Cualquier contexto se puede mantener vivo si nos aseguramos de que
412 tiene algo que hacer en cualquier momento musical dado. Los
413 contextos de @code{Staff} se mantienen con vida si nos aseguramos de
414 que una de sus voces se mantiene viva. Una manera de hacerlo es
415 añadir silencios de separación a una voz en paralelo con la música
416 real. Éstos deben añadirse a todos y cada uno de los contextos de
417 @code{Voice} que se hayan de mantener vivos. Si se van a usar
418 esporádicamente varias voces, es más seguro mantenerlas todas vivas en
419 lugar de tratar de confiar en las excepciones que hemos mencionado
422 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
423 vivas de esta manera durante la duración de la pieza:
425 @lilypond[quote,verbatim]
426 musicA = \relative c'' { d4 d d d }
427 musicB = \relative c'' { g4 g g g }
430 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
431 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
436 \context Voice = "A" {
440 \context Voice = "B" {
444 \context Voice = "A" { \musicA }
445 \context Voice = "B" { \musicB }
446 \context Voice = "A" { \musicA }
457 @cindex letra, alineación con melodía esporádica
459 El ejemplo siguiente muestra cómo se puede escribir una línea melódica
460 esporádica con letra utilizando este enfoque. Por supuesto, en una
461 situación real la melodía y el acompañamiento consistirían en varias
462 secciones diferentes.
464 @lilypond[quote,verbatim]
465 melody = \relative c'' { a4 a a a }
466 accompaniment = \relative c' { d4 d d d }
467 words = \lyricmode { These words fol -- low the mel -- o -- dy }
470 \new Staff = "music" {
472 \new Voice = "melody" {
474 s1*4 % Keep Voice "melody" alive for 4 bars
477 \new Voice = "accompaniment" {
482 \context Voice = "melody" { \melody }
483 \context Voice = "accompaniment" { \accompaniment }
485 \context Voice = "accompaniment" { \accompaniment }
487 \context Voice = "melody" { \melody }
488 \context Voice = "accompaniment" { \accompaniment }
493 \new Lyrics \with { alignAboveContext = #"music" }
494 \lyricsto "melody" { \words }
499 Una forma alternativa, que podría resultar mejor en muchas
500 situaciones, es mantener con vida la línea melódica simplemente
501 incluyendo notas espaciadoras para alinearla correctamente con el
504 @lilypond[quote,verbatim]
505 melody = \relative c'' {
511 accompaniment = \relative c' {
517 words = \lyricmode { These words fol -- low the mel -- o -- dy }
521 \new Staff = "music" {
523 \new Voice = "melody" {
527 \new Voice = "accompaniment" {
533 \new Lyrics \with { alignAboveContext = #"music" }
534 \lyricsto "melody" { \words }
540 @node Modificar los complementos (plug-ins) de contexto
541 @subsection Modificar los complementos (plug-ins) de contexto
542 @translationof Modifying context plug-ins
544 @c TODO Should this be Modifying engravers or Modifying contexts?
546 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
547 almacenan propiedades, también contienen «plug-ins» o complementos
548 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
549 el contexto @code{Voice} contiene un grabador
550 @code{Note_head_engraver} que crea las cabezas de nota y el contexto
551 @code{Staff} contiene un grabador @code{Key_signature_engraver} que
552 crea la indicación de compás.
554 Para ver una descripción completa de todos y cada uno de los
555 complementos, consulte
557 @rinternals{Engravers and Performers}.
560 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
562 Cada contexto que se describe en
564 @rinternals{Contexts}
567 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
569 relaciona los grabadores que se usan para ese contexto.
572 Puede ser de utilidad jugar un poco con estos complementos. Se hace
573 iniciando un contexto nuevo con @code{\new} o @code{\context} y
579 \new @var{contexto} \with @{
592 donde los @dots{} deben ser el nombre de un grabador. Aquí tenemos un
593 ejemplo sencillo que suprime los grabadores
594 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
597 @lilypond[quote,relative=1,verbatim,fragment]
603 \remove "Time_signature_engraver"
604 \remove "Clef_engraver"
611 En el segundo pentagrama no hay indicación de compás ni clave. Éste
612 es un método bastante rudimentario de hacer que desaparezcan los
613 objetos porque afecta a todo el pentagrama. Este método también
614 afecta al espaciado, lo que puede ser deseable o no serlo. Se
615 muestran métodos más sofisticados para quitar objetos en
616 @rlearning{Visibilidad y color de los objetos}.
618 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
619 líneas divisorias y las indicaciones de compás están sincronizadas a
620 lo largo de toda la partitura. Lo hacen los grabadores
621 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
622 complementos mantienen al día la administración de las indicaciones de
623 compás, posición dentro del compás, etc. Moviendo estos grabadores
624 desde el contexto de @code{Score} al de @code{Staff}, podemos
625 conseguir una partitura en la que cada pentagrama tiene su propio
626 compás independiente.
628 @cindex polimétricas, partituras
629 @cindex compases distintos al mismo tiempo
631 @lilypond[quote,relative=1,ragged-right,verbatim,fragment]
633 \remove "Timing_translator"
634 \remove "Default_bar_line_engraver"
637 \consists "Timing_translator"
638 \consists "Default_bar_line_engraver"
644 \consists "Timing_translator"
645 \consists "Default_bar_line_engraver"
655 Normalmente, el orden en que se especifican los grabadores no tiene
656 importancia, pero en algunos casos especiales sí la tiene, por ejemplo
657 donde un grabador escribe una propiedad y otro la lee, o donde un
658 grabador crea un groby otro debe procesarlo. El orden en que los
659 grabadores se especifican es el orden en que se llaman para realizar
660 su tarea de procesamiento.
662 Las siguientes ordenaciones son importantes: el grabador de compases
663 @code{Bar_engraver} debe ir normalmente en primer lugar, y el grabador
664 de digitaciones @code{New_fingering_engraver} debe ir antes del
665 grabador @code{Script_column_engraver} de columnas de inscripciones.
666 Podría haber otros que tengan dependencias de ordenación.
668 @node Cambiar los valores por omisión de los contextos
669 @subsection Cambiar los valores por omisión de los contextos
670 @translationof Changing context default settings
672 Los ajustes de contexto que están preparados para usarse de forma
673 predeterminada en los contextos @code{Score}, @code{Staff} y
674 @code{Voice}, se pueden especificar dentro de un bloque
675 @code{\layout}, como se ilustra en el ejemplo siguiente. El bloque
676 @code{\layout} se debe colocar dentro del bloque @code{\score} en que
677 se quiere que haga efecto, pero fuera de la música.
679 Observe que la propia instrucción @code{\set} y el contexto se deben
680 omitir cuando se especifican de esta manera los valores de contexto
683 @lilypond[quote,verbatim]
686 a4^"Really small, thicker stems, no time signature" a a a
693 \override Stem #'thickness = #4.0
694 \remove "Time_signature_engraver"
700 En este ejemplo, la instrucción @code{\Staff} especifica que los
701 ajustes siguientes se apliquen a todos los pentagramas dentro del
704 Se pueden realizar de forma similar modificaciones al contexto
705 @code{Score} o a todos los contextos @code{Voice}.
709 No es posible recolectar cambios de contexto dentro de una variable y
710 aplicarlos a una definición de @code{\context} por referencia a dicha
713 La instrucción @code{\RemoveEmptyStaffContext} sobreescribe nuestros
714 ajustes en curso para @code{\Staff}. Si queremos cambiar los valores
715 predeterminados para un pentagrama que utilice
716 @code{\RemoveEmptyStaffContext}, debe hacerlo después de llamar a
717 @code{\RemoveEmptyStaffContext}, o sea
722 \RemoveEmptyStaffContext
724 \override Stem #'thickness = #4.0
729 @c TODO: add \with in here.
733 @node Definir contextos nuevos
734 @subsection Definir contextos nuevos
735 @translationof Defining new contexts
737 @cindex contextos, definición de nuevos
738 @cindex grabadores, incluir en contextos
753 Los contextos específicos, como @code{Staff} y @code{Voice}, están
754 construidos a base de bloques sencillos. Es posible crear nuevos
755 tipos de contextos con combinaciones distintas de añadidos grabadores.
757 El siguiente ejemplo muestra cómo construir un tipo diferente de
758 contexto de @code{Voice} partiendo de cero. Será parecido a
759 @code{Voice}, pero imprime solamente cabezas centradas en forma de
760 barra inclinada. Se puede usar para indicar improvisación en piezas
764 @lilypond[quote,ragged-right]
767 \type "Engraver_group"
768 \consists "Note_heads_engraver"
769 \consists "Rhythmic_column_engraver"
770 \consists "Text_engraver"
771 \consists Pitch_squash_engraver
772 squashedPosition = #0
773 \override NoteHead #'style = #'slash
774 \override Stem #'transparent = ##t
778 \accepts "ImproVoice"
782 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
783 c4 c^"desvístete" c_"mientras tocas :)" c }
789 Estos ajustes se definen dentro de un bloque @code{\context} que a su
790 vez está dentro de un bloque @code{\layout},
800 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
801 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
803 En primer lugar es necesario definir un nombre para el nuevo contexto:
809 Debido a que es parecido al contexto @code{Voice}, queremos órdenes
810 que funcionen sobre contextos de @code{Voice} (existentes) para que
811 siga funcionando. Esto se consigue dando al contexto nuevo un alias
818 El contexto imprimirá notas y textos explicativos, por ello tenemos
819 que añadir los grabadores que aportan esta funcionalidad:
822 \consists Note_heads_engraver
823 \consists Text_engraver
826 pero sólo necesitamos esto en la línea central:
829 \consists Pitch_squash_engraver
830 squashedPosition = #0
833 El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
834 nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
835 establece sus posiciones verticales al valor de
836 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.
838 Las notas parecen barras inclinadas y no tienen plica:
841 \override NoteHead #'style = #'slash
842 \override Stem #'transparent = ##t
845 Todos estos añadidos tienen que cooperar, y esto se consigue con un
846 añadido especial, que se debe marcar con la palabra clave
847 @code{\type}. Este será siempre @code{Engraver_group},
850 \type "Engraver_group"
853 Al juntarlo todo, obtenemos
858 \type "Engraver_group"
859 \consists "Note_heads_engraver"
860 \consists "Text_engraver"
861 \consists Pitch_squash_engraver
862 squashedPosition = #0
863 \override NoteHead #'style = #'slash
864 \override Stem #'transparent = ##t
870 Los contextos dan lugar a jerarquías. Queremos colgar el contexto
871 @code{ImproVoice} bajo el contexto @code{Staff}, como simples
872 @code{Voice}s normales. Por tanto, modificamos la definición de
873 @code{Staff} con la instrucción @code{\accepts} (acepta),
883 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
884 que a veces se necesita cuando se están reutilizando definiciones de
887 Ponemos ambos dentro de un bloque @code{\layout}, como
897 \accepts "ImproVoice"
902 Así pues, la salida que aparece al comienzo de esta sub-sección se
911 c c_"mientras tocas :)"
918 @node Alinear los contextos
919 @subsection Alinear los contextos
920 @translationof Aligning contexts
922 Los contextos nuevos se pueden alinear por encima o por debajo de
923 otros contextos existentes. Esto podría ser de utilidad al preparar
924 un pentagrama vocal (@rlearning{Conjuntos vocales}) y en el ossia,
927 @funindex alignAboveContext
928 @funindex alignBelowContext
930 @lilypond[quote,ragged-right]
933 \relative c' \new Staff = "main" {
936 \new Staff \with { alignAboveContext = #"main" } \ossia
943 @cindex nested contexts
944 @cindex contexts, nested
949 Los contextos como @code{PianoStaff} pueden llevar dentro otros
950 contextos anidados. Los contextos que se pueden aceptar para su
951 anidamiento están definidos por la lista @qq{accepts} (acepta) de un
952 contexto. Los contextos que no están en esta lista se colocan debajo
953 del contexto exterior en la partitura impresa. Por ejemplo, el
954 contexto @code{PianoStaff} está definido para que acepte contextos
955 @code{Staff} y @code{FiguredBass} de forma predeterminada, pero no un
956 contexto @code{Lyrics}, por ejemplo. Así pues, en la siguiente
957 estructura la letra se sitúa debajo del sistema de piano en lugar de
958 colocarse entre los dos pentagramas:
960 @lilypond[verbatim,quote,relative=1]
963 \new Staff { e4 d c2 }
964 \addlyrics { Three blind mice }
972 La lista @qq{accepts} de un contexto se puede modificar para que
973 incluya contextos anidados adicionales, y así si quisiéramos que la
974 letra apareciese entre los dos pentagramas podríamos usar:
976 @lilypond[verbatim,quote,relative=1]
977 \new PianoStaff \with { \accepts Lyrics }
979 \new Staff { e4 d c2 }
980 \addlyrics { Three blind mice }
988 Lo contrario de @code{\accepts} (acepta) es @code{\denies} (deniega);
989 esto suprime un contexto de la lista @qq{accepts}.
992 @node Explicación del Manual de referencia de funcionamiento interno
993 @section Explicación del Manual de referencia de funcionamiento interno
994 @translationof Explaining the Internals Reference
998 * Navegar por la referencia del programa::
999 * Interfaces de la presentación::
1000 * Determinar la propiedad del grob::
1001 * Convenciones de nombres::
1006 @node Navegar por la referencia del programa
1007 @subsection Navegar por la referencia del programa
1008 @translationof Navigating the program reference
1010 Supongamos que queremos mover la indicación de digitación del
1011 fragmento siguiente:
1013 @lilypond[quote,fragment,relative=2,verbatim]
1019 Si hace una visita a la documentación en busca de instrucciones de
1020 digitación (en @ref{Indicaciones de digitación}), encontrará:
1023 @strong{Véase también}
1025 Referencia de funcionamiento interno: @rinternals{Fingering}.
1030 La referencia del programador se encuentra disponible en forma de
1031 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
1032 en línea o bien descargando los archivos de la documentación HTML.
1033 Esta sección sería mucho más difícil de entender si está utilizando el
1034 manual en formato PDF.
1037 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
1041 Los objetos de digitación se crean por parte de:
1042 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1045 Siguiendo los enlaces relacionados dentro de la referencia del
1046 programa, podemos seguir el flujo de información dentro del programa:
1050 @item @rinternals{Fingering}:
1051 los objetos @rinternals{Fingering} se crean por parte de:
1052 @rinternals{Fingering_engraver}
1054 @item @rinternals{Fingering_engraver}:
1055 Tipos de música aceptados: @rinternals{fingering-event}
1057 @item @rinternals{fingering-event}:
1058 El tipo de evento musical @code{fingering-event} está descrito en
1059 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1062 Este camino se recorre en contra de la corriente de información del
1063 programa: comienza por la salida y acaba en el evento de entrada.
1064 También podríamos haber empezado por un evento de la entrada, y leído
1065 siguiendo el flujo de información terminando en su caso en el objeto
1066 (u objetos) de la salida.
1068 La referencia del programa también se puede examinar como un documento
1069 normal. Contiene capítulos que tratan de
1071 @rinternals{Music definitions},
1074 @code{Music definitions}
1076 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1077 de los capítulos relaciona todas las definiciones utilizadas y todas
1078 las propiedades que se pueden ajustar.
1081 @node Interfaces de la presentación
1082 @subsection Interfaces de la presentación
1083 @translationof Layout interfaces
1085 @cindex interfaz de la presentación
1086 @cindex presentación, interfaz de la
1089 La página HTML que pudimos ver en la sección anterior describe el
1090 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1091 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1092 números (como grosores y direcciones), pero también punteros a objetos
1093 relacionados. Un objeto de presentación también se llama un
1094 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1095 gráfico). Para ver más detalles acerca de los objetos gráficos o
1096 Grobs, consulte @rinternals{grob-interface}.
1098 La página dedicada a @code{Fingering} relaciona las definiciones del
1099 objeto @code{Fingering}. Por ejemplo, la página dice
1102 @code{padding} (dimensión, en espacios de pentagrama):
1108 lo que significa que el número se mantendrá a una distancia de al
1109 menos 0.5 de la cabeza de la nota.
1112 Cada objeto de presentación puede tener varias funciones como elemento
1113 notacional o tipográfico. Por ejemplo, el objeto de digitación
1114 Fingering tiene los siguientes aspectos
1118 Su tamaño es independiente del espaciado horizontal, al contrario de
1119 las ligaduras o las barras de las figuras.
1122 Es un elemento de texto. Casi seguro que es un texto muy corto.
1125 este elemento de texto se tipografía con un tipo de letra, no como las
1126 ligaduras o las barras de las figuras.
1129 Horizontalmente, el centro del símbolo se debe alinear con el centro
1130 de la cabeza de la nota.
1133 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1136 La posición vertical también está coordinada con otros símbolos de
1137 superíndice y de subíndice.
1140 Cada uno de estos aspectos se capta en lo que se llaman
1141 @emph{interface}s, que se relacionan al final de la página dedicada a
1142 @rinternals{Fingering}
1145 Este objeto contempla los siguientes interfaces:
1146 @rinternals{item-interface},
1147 @rinternals{self-alignment-interface},
1148 @rinternals{side-position-interface}, @rinternals{text-interface},
1149 @rinternals{text-script-interface}, @rinternals{font-interface},
1150 @rinternals{finger-interface} y @rinternals{grob-interface}.
1153 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1154 página del respectivo interfaz del objeto. Cada interfaz tiene un
1155 cierto número de propiedades. Algunas de ellas no son para que el
1156 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1159 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1160 realmente esto no significa mucho. El archivo de inicialización
1161 (véase @rlearning{Otras fuentes de información})
1162 @file{scm/@/define@/-grobs@/.scm} muestra el alma del @q{objeto},
1167 (avoid-slur . around)
1168 (slur-padding . 0.2)
1169 (staff-padding . 0.5)
1170 (self-alignment-X . 0)
1171 (self-alignment-Y . 0)
1172 (script-priority . 100)
1173 (stencil . ,ly:text-interface::print)
1174 (direction . ,ly:script-interface::calc-direction)
1175 (font-encoding . fetaNumber)
1176 (font-size . -5) ; don't overlap when next to heads.
1177 (meta . ((class . Item)
1178 (interfaces . (finger-interface
1180 text-script-interface
1182 side-position-interface
1183 self-alignment-interface
1184 item-interface))))))
1188 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1189 de valores de variables, y la página web de la Referencia de
1190 funcionamiento interno se genera directamente a partir de esta
1194 @node Determinar la propiedad del grob
1195 @subsection Determinar la propiedad del grob
1196 @translationof Determining the grob property
1198 Recordemos que queríamos cambiar la posición del @b{2} en
1200 @lilypond[quote,fragment,relative=2,verbatim]
1206 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1207 tenemos que negociar con el interfaz asociado con esta colocación.
1208 Esto se hace usando @code{side-position-interface}. La página que
1209 describe este interface dice:
1212 @code{side-position-interface}
1214 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1215 soporte). La propiedad @code{direction} significa dónde poner el
1216 objeto víctima con relación al soporte (¿a la izquierda o a la
1217 derecha, encima o debajo?)
1221 @cindex padding (relleno)
1223 Debajo de esta descripción, la variable @code{padding} (relleno) se
1229 (dimensión, en espacios de pentagrama)
1231 Añadir esta cantidad de espacio adicional entre objetos que están unos
1236 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1237 digitación de la cabeza de la nota. La siguiente orden inserta un
1238 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1241 \once \override Voice.Fingering #'padding = #3
1244 Al insertar esta instrucción antes de que se haya creado el objeto
1245 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1248 @lilypond[quote,relative=2,fragment,verbatim]
1249 \once \override Voice.Fingering #'padding = #3
1255 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1256 se puede deducir también a partir de la referencia del programa, ya
1257 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1260 El grabador Fingering_engraver es parte de los contextos: @dots{}
1265 @node Convenciones de nombres
1266 @subsection Convenciones de nombres
1267 @translationof Naming conventions
1269 Se hace necesario presentar una panorámica de las diversas
1270 convenciones de nomenclatura:
1273 @item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
1274 @item funciones de Scheme: ly:más-estilo-de-scheme
1275 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1276 @item interfaces de Grobs: estilo-scheme
1277 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1278 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1279 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1280 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1284 Preguntas aún sin respuesta
1286 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1287 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1291 @node Modificar las propiedades
1292 @section Modificar las propiedades
1293 @translationof Modifying properties
1296 * Panorámica de la modificación de las propiedades::
1297 * La instrucción set::
1298 * La instrucción override::
1299 * La instrucción tweak::
1300 * set frente a override::
1304 @node Panorámica de la modificación de las propiedades
1305 @subsection Panorámica de la modificación de las propiedades
1306 @translationof Overview of modifying properties
1308 Cada contexto es responsable de la creación de ciertos tipos de
1309 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1310 también se almacenan por contexto. Mediante la modificación de estos
1311 ajustes, se puede alterar la apariencia de los objetos.
1313 Existen dos tipos diferentes de propiedades almacenadas en los
1314 contextos: las propiedades de contexto y las propiedades de grob. Las
1315 prpopiedades de contexto son propiedades que se aplican al contexto
1316 como un todo y controlan la forma en que el propio contexto se
1317 imprime. Por contra, las propiedades de grob se aplican a los tipos
1318 de grob específicos que se imprimirán dentro del contexto.
1320 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar los
1321 valores de las propiedades de contexto. Las instrucciones
1322 @code{\override} y @code{\revert} se usan para cambiar los valores de
1323 las propiedades de grob.
1326 La sintaxis de esto es
1329 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1332 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1333 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1334 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1335 disposición}). Este último es un símbolo, y por ello debe ir
1336 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1337 explica cómo se deben cumplimentar los conceptos @var{nombre},
1338 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1339 funcionalidad des esta instrucción.
1344 \override Staff.Stem #'thickness = #4.0
1348 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1349 grosor de una línea del pentagrama como unidad). Puesto que la
1350 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1351 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1352 Aquí vemos la instrucción en pleno funcionamiento:
1354 @lilypond[quote,verbatim,relative=2,fragment]
1356 \override Staff.Stem #'thickness = #4.0
1362 La instrucción @code{\override} modifica la definición de la plica
1363 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1364 que la instrucción se ha interpretado, todas las plicas se engrosan.
1366 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1367 omitir, ocasionando que se utilice el contexto predeterminado
1368 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1369 solo paso de tiempo.
1371 @lilypond[quote,fragment,verbatim,relative=2]
1373 \once \override Stem #'thickness = #4.0
1378 El @code{\override} se debe hacer antes de que el objeto se inicia.
1379 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1380 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1381 en el momento en que se crea el objeto. En este ejemplo:
1383 @lilypond[quote,fragment,verbatim,relative=2]
1384 \override Slur #'thickness = #3.0
1386 \override Beam #'thickness = #0.6
1391 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1392 la instrucción para @code{Beam}, la barra, va después de que la barra
1393 se ha iniciado, y por ello no tiene ningún efecto.
1395 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1396 un contexto deshace una instrucción @code{\override}; como con
1397 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1398 del mismo contexto. En otras palabras, el @code{\revert} del
1399 siguiente ejemplo no hace nada.
1402 \override Voice.Stem #'thickness = #4.0
1403 \revert Staff.Stem #'thickness
1406 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1407 dentro de las propiedades normales. Para trucarlas, utilice
1408 instrucciones de la forma
1410 @c leave this as a long long
1412 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1419 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1425 Referencia de funcionamiento interno:
1426 @rinternals{Backend},
1427 @rinternals{All layout objects},
1428 @rinternals{OverrideProperty},
1429 @rinternals{RevertProperty},
1430 @rinternals{PropertySet}.
1435 El «back-end» o motor de salida no es muy estricto en la comprobación
1436 de tipos de las propiedades de objetos. Las referencias cíclicas en
1437 valores Scheme de propiedades pueden producir cuelgues o salidas
1438 abruptas, o las dos cosas.
1441 @node La instrucción set
1442 @subsection La instrucción @code{@bs{}set}
1443 @translationof The set command
1447 @cindex cambiar propiedades
1449 Cada contexto puede tener distintas @emph{propiedades}, variables
1450 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1451 paso de interpretación. Se consigue insertando la instrucción
1452 @code{\set} dentro de la música:
1455 \set @var{contexto}.@var{propiedad} = #@var{valor}
1458 @var{valor} es un objeto de Scheme, razón por la que va precedido del
1459 carácter almohadilla, @code{#}.
1461 El nombre de las propiedades de contexto suele ir en minúsculas con
1462 mayúscula en medio. Controlan sobre todo la traducción de la música a
1463 la notación, p.ej. @code{localKeySignature} (para determinar si hay
1464 que impriir alteraciones o no), o @code{measurePosition} (para
1465 determinar cuándo hay que imprimir una línea divisoria). El valor de
1466 las propiedades de contexto puede modifcarse con el tiempo durante la
1467 interpretación de la música; un ejemplo obvio es
1468 @code{measurePosition}. Las propiedades de contexto se modifican
1469 mediante la instrucción @code{\set}.
1471 Por ejemplo, los silencios multicompás se combinan en un solo compás
1472 si el valor de la propiedad de contexto @code{skipBars} se establece a
1473 @code{#t} (verdadero):
1475 @lilypond[quote,verbatim,relative=2,fragment]
1477 \set Score.skipBars = ##t
1481 Si se omite el argumento @var{context}, entonces se utiliza el
1482 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1483 @code{Voice} o @code{Lyrics}). En este ejemplo:
1485 @lilypond[quote,verbatim,relative=2,fragment]
1486 \set Score.autoBeaming = ##f
1490 \set autoBeaming = ##t
1498 El cambio se aplica @q{al vuelo}, mientras dura la música, de forma
1499 que el ajuste sólo afecta al segundo grupo de corcheas.
1501 Observe que el contexto del nivel más bajo no siempre contiene la
1502 propiedad que querríamos modificar: por ejemplo, intentar ajustar el
1503 valor de la propiedad @code{skipBars} del contexto predeterminado del
1504 nivel más bajo, que en este caso es @code{Voice}, no tendrá ningún
1505 efecto, porque skipBars es una propiedad del contexto @code{Score}.
1507 @lilypond[quote,verbatim,relative=2,fragment]
1513 Los contextos son jerárquicos, y si se ha especificado un contexto
1514 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1515 también a todos los contextos @code{Voice} dentro del pentagrama
1520 También existe una instrucción @code{\unset}:
1522 \unset @var{contexto}.@var{propiedad}
1526 que elimina la definición de @var{propiedad}. Esta instrucción
1527 elimina la definición solamente si está establecida dentro de
1528 @var{contexto}. Properties that have been set in enclosing contexts will
1529 not be altered by an unset in an enclosed context:
1531 @lilypond[quote,verbatim,relative=2,fragment]
1532 \set Score.autoBeaming = ##t
1537 \unset Score.autoBeaming
1545 Como @code{\set}, el argumento @var{contexto} no se tiene que
1546 especificar para un contexto del nivel más bajo, por lo que los dos
1550 \set Voice.autoBeaming = ##t
1551 \set autoBeaming = ##t
1555 son equivalentes si el contexto inferior en curso es @code{Voice}.
1559 Los ajustes que se aplican solamente a un único paso de tiempo se
1560 pueden escribir con @code{\once}, por ejemplo en
1562 @lilypond[quote,verbatim,relative=2,fragment]
1564 \once \set fontSize = #4.7
1569 En el manual de Referencia de funcionamiento interno hay una
1570 descripción completa de todas las propiedades de contexto disponibles,
1573 @rinternals{Tunable context properties}.
1576 Traducción @expansion{} Propiedades de contexto modificables por el
1582 Referencia de funcionamiento interno:
1583 @rinternals{Tunable context properties}.
1586 @cindex grob, propiedades de
1587 @cindex propiedades de grob
1590 @node La instrucción override
1591 @subsection La instrucción @code{\override}
1592 @translationof The override command
1594 Existe un tipo especial de propiedad de contexto: la descripción de
1595 los grobs. Las decscripciones de los grobs reciben un nombre en
1596 @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen los
1597 @q{ajustes predeterminados} para un tipo particular de grob, en forma
1598 de lista asociativa. Consulte @file{scm/@/define@/-grobs@/.scm} para
1599 ver los ajustes de cada descripción de grob. Las descripciones de
1600 grob se modifican con @code{\override}.
1602 @code{\override} es en realidad una forma abreviada;
1605 \override @var{contexto}.@var{NombreDelGrob} #'@var{propiedad} = #@var{valor}
1609 equivale más o menos a
1611 @c leave this long line -gp
1613 \set @var{contexto}.@var{NombreDelGrob} =
1614 #(cons (cons '@var{propiedad} @var{valor})
1615 <valor anterior de @var{contexto}.@var{NombreDelGrob}>)
1618 El valor de @code{contexto}.@code{NombreDelGrob} (la lista-A) se
1619 utiliza para inicializar las propiedades de los grobs individuales.
1620 Los grobs tienen propiedades, denominadas en el estilo de Scheme, con
1621 @code{palabras-con-guiones}. Los valores de las propiedades de grob
1622 cambian durante el proceso de formateo: éste se realiza básicamente
1623 calculando las propiedades utilizando funciones de @q{callback}
1624 (pasadas como parámetro).
1626 Por ejemplo, podemos aumentar el grosor de la plica de una figura
1627 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
1628 @code{Stem} (plica):
1630 @lilypond[quote, verbatim, relative=2, fragment]
1632 \override Voice.Stem #'thickness = #3.0
1636 Si no se ha especificado ningún contexto en la instrucción
1637 @code{\override}, se utiliza el contexto del nivel inferior:
1639 @lilypond[quote, verbatim, relative=2, fragment]
1640 { \override Staff.Stem #'thickness = #3.0
1644 \override Stem #'thickness = #0.5
1654 @cindex reversión de sobreescrituras
1655 @cindex sobreescrituras, reversión de
1657 El efecto de una instrucción de sobreescritura @code{\override} se
1658 puede deshacer con @code{\revert}:
1660 @lilypond[quote, verbatim, relative=2, fragment]
1662 \override Voice.Stem #'thickness = #3.0
1664 \revert Voice.Stem #'thickness
1668 Los efectos de @code{\override} y @code{\revert} se aplican a todos
1669 los grobs del contexto afectado partiendo del momento actual y hacia
1672 @lilypond[quote, verbatim, relative=2, fragment]
1677 \override Staff.Stem #'thickness = #3.0
1681 \revert Staff.Stem #'thickness
1689 @cindex sobreescritura para un solo momento
1691 Se puede usar @code{\once} con @code{\override} para afectar solamente
1692 al instante de tiempo actual:
1694 @lilypond[quote, verbatim, relative=2, fragment]
1698 \override Stem #'thickness = #3.0
1702 \once \override Stem #'thickness = #3.0
1711 Las instrucciones que modifican la salida tienen por lo general un
1715 \override Voice.Stem #'thickness = #3.0
1719 Para construir este truco debemos determinar los siguientes datos:
1722 @item el contexto: aquí @code{Voice}.
1723 @item el objeto de presentación: aquí @code{Stem}.
1724 @item la propiedad de presentación: aquí @code{thickness}.
1725 @item un valor adecuado: aquí @code{3.0}.
1728 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
1729 en el interior de las propiedades normales. Para modificarlas utilice
1730 instrucciones de la forma
1733 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1736 @cindex documentación interna
1737 @cindex buscar objetos gráficos
1738 @cindex gráficos, descripción de los objetos
1741 @cindex interna, documentación
1743 Para muchas propiedades, independientemente del tipo de datos de la
1744 propiedad, si se establece el valor de la propiedad a falso
1745 (@code{##f}) se producirá su desactivación, ocasionando que LilyPond
1746 ignore por completo dicha propiedad. Esto es especialmente útil para
1747 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
1748 causarían problemas.
1750 Mostraremos a continuación cómo localizar esta información en el
1751 manual de notación y en la referencia de funcionamiento interno.
1756 Referencia de funcionamiento interno:
1757 @rinternals{Backend}
1759 @node La instrucción tweak
1760 @subsection La instrucción @code{\tweak}
1761 @translationof The tweak command
1766 El cambio de las propiedades de grob mediante @code{\override} produce
1767 la aplicación del cambio a todos los grobs dados en el contexto en el
1768 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
1769 podemos desear que los cambios se apliquen a un solo grob en lugar de
1770 a todos los grobs del contexto afectado. Esto se consigue con la
1771 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
1774 \tweak #'@code{propiedad-del-grob} #@code{valor}
1777 La instrucción @code{\tweak} se aplica al objeto que viene
1778 inmediatamente después de @code{valor} dentro del flujo musical.
1781 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
1782 los objetos gráficos. Para objetos que resultan directamente de un
1783 elemento de código de la entrada, puede usar la función @code{\tweak},
1786 @lilypond[relative=2,verbatim]
1791 \tweak #'duration-log #1
1794 -\tweak #'padding #8
1800 Pero el uso principal de la instrucción @code{\tweak} es modificar
1801 solamente uno de varios elementos de notación que dan comienzo en el
1802 mismo momento musical, como las notas de un acorde, o corchetes de
1803 tresillo que empiezan al mismo tiempo.
1805 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
1806 a continuación de forma directa, sin necesidad de especificar el
1807 nombre del grob o el contexto. Para que esto funcione, es necesario
1808 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
1809 al objeto al que se aplica, después de que el archivo de entrada se ha
1810 convertido en un flujo musical. Con frecuencia no es el caso, pues
1811 muchos elementos adicionales se insertan en la corriente musical de
1812 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
1813 parte de un acorde, LilyPond inserta implícitamente un evento
1814 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
1815 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
1816 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
1817 en el flujo musical, permaneciendo así adyacente a la nota, y con la
1818 posibilidad de modificarla.
1822 @lilypond[relative=2,verbatim,quote]
1823 <\tweak #'color #red c>4
1827 pero esto no funciona:
1829 @lilypond[relative=2,verbatim,quote]
1830 \tweak #'color #red c4
1835 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
1836 consulte @rlearning{Métodos de trucaje}.
1838 Si se colocan varios elementos similares en el mismo momento musical,
1839 la instrucción @code{\override} no se puede usar para modificar uno
1840 solo de ellos: aquí es donde se debe usar la instrucción
1841 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
1842 en el mismo momento musical están los siguientes:
1844 @c TODO expand to include any further uses of \tweak
1846 @item las cabezas de las notas de un acorde
1847 @item signos de articulación sobre la misma nota
1848 @item ligaduras de unión entre notas de un acorde
1849 @item corchetes de grupos especials que comienzan en el mismo momento
1852 @c TODO add examples of these
1854 @cindex acorde, modificación de una nota
1856 En este ejemplo se modifican el color de una cabeza y el tipo de otra,
1857 dentro del mismo acorde:
1859 @lilypond[relative=2,verbatim,quote]
1864 \tweak #'duration-log #1
1869 @code{\tweak} se puede usar para modificar ligaduras de expresión:
1871 @lilypond[verbatim,quote,relative=1]
1872 c-\tweak #'thickness #5 ( d e f)
1876 Para que funcione la instrucción @code{\tweak}, debe permanecer
1877 adyacente al objeto al que se ha de aplicar después de que el código
1878 de entrada se ha convertido a un flujo musical. A veces, LilyPond
1879 puede insertar elementos adicionales dentro del flujo de música
1880 durante el proceso de análisis sintáctico. Por ejemplo, cuando una
1881 nota que no es parte explícita de un acorde se coloca dentro de un
1882 acorde por parte de LilyPond de manera que las notas que se pretenden
1883 modificar con @code{\tweak} se deben poner dentro de una construcción
1886 @lilypond[relative=2,verbatim,quote]
1887 \tweak #'color #red c4
1888 <\tweak #'color #red c>4
1891 La instrucción @code{\tweak} no se puede usar para modificar ningún
1892 elemento que no aparezca explícitamente en el código de entrada.
1893 Concretamente, no se puede usar para modificar plicas, barras o
1894 alteraciones directamente, porque éstos se generan posteriormente por
1895 parte de las cabezas de las notas, más que por elementos musicales del
1896 flujo de entrada. Tampoco se puede usar @code{\tweak} para modificar
1897 las claves ni las indicaciones de compás, porque se separarán de
1898 cualquier instrucción @code{\tweak} que aparezca en el flujo de
1899 entrada debido a la inserción automática de los elementos adicionales
1900 que se requieren para especificar el contexto.
1902 También se pueden escribir varias instrucciones @code{\tweak} antes de
1903 un elemento notacional, y todas ellas le afectan:
1905 @lilypond[verbatim,quote,relative=1]
1907 -\tweak #'style #'dashed-line
1908 -\tweak #'dash-fraction #0.2
1909 -\tweak #'thickness #3
1910 -\tweak #'color #red
1915 El flujo musical que se genera a partir de una sección de un archivo
1916 de entrada (incluido cualquier elemento insertado automáticamente)
1917 puede examinarse, véase @ref{Displaying music expressions}. Esto
1918 puede ser de utilidad en la determinación de lo que puede modificarse
1919 por medio de una instrucción @code{\tweak}.
1923 Manual de aprendizaje:
1924 @rlearning{Métodos de trucaje}.
1926 Referencia de la notación:
1927 @ref{Presentación de expresiones musicales}.
1932 @cindex trucos en una variable
1933 La instrucción @code{\tweak} no se puede usar dentro de una variable.
1935 @cindex trucos en la letra
1936 Las instrucciones @code{\tweak} no se pueden usar dentro del modo
1939 @cindex trucar puntos de control
1940 @cindex control, trucar puntos de
1942 La instrucción @code{\tweak} solamente se aplica a la primera de
1943 varias ligaduras generadas dentro de un acorde.
1945 @node set frente a override
1946 @subsection @code{\set} frente a @code{\override}
1947 @translationof set versus override
1949 HACER: probablemente esta sección es innecesaria.
1952 We have seen two methods of changing properties: @code{\set} and
1953 @code{\override}. There are actually two different kinds of
1956 @code{fontSize} is a special property: it is equivalent to
1957 entering @code{\override ... #'font-size} for all pertinent
1958 objects. Since this is a common change, the special
1959 property (modified with @code{\set}) was created.
1963 @node Conceptos y propiedades útiles
1964 @section Conceptos y propiedades útiles
1965 @translationof Useful concepts and properties
1969 * Modos de entrada::
1970 * Dirección y posición::
1971 * Orden de disposición de los contextos::
1972 * Distancias y medidas::
1973 * Propiedades del símbolo del pentagrama::
1974 * Objetos de extensión::
1975 * Visibilidad de los objetos::
1976 * Estilos de línea::
1977 * Rotación de objetos::
1980 @node Modos de entrada
1981 @subsection Modos de entrada
1982 @translationof Input modes
1984 La forma en que se interpreta la notación contenida dentro de un
1985 archivo de entrada, está determinada por el modo de entrada en curso.
1987 @strong{Modo de acordes}
1989 Se activa con la instrucción @code{\chordmode} y produce que la
1990 entrada se interprete con al sintaxis de la notación de acordes, véase
1991 @ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
1994 El modo de acordes se activa también con la instrucción
1995 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
1996 y produce que el código que sigue se interprete con la sintaxis de la
1997 notación de acordes y se imprima como nombres de acorde dentro del
1998 contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
2000 @strong{Modo de percusión}
2002 Se activa con la instrucción @code{\drummode} y produce que el código
2003 de entrada se interprete con la sintaxis de la notación de percusión,
2004 véase @ref{Notación básica de percusión}.
2006 El modo de percusión también se activa con la instrucción
2007 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
2008 que el código que sigue se interprete con la sintaxis de la notación
2009 de percusión y se imprima como símbolos de percusión sobre un
2010 pentagrama de percusión, véase @ref{Notación básica de percusión}.
2012 @strong{Modo de cifras}
2014 Se activa con la instrucción @code{\figuremode} y hace que el código
2015 de entrada se interprete con la sintaxis del bajo cifrado, véase
2016 @ref{Introducir el bajo cifrado}.
2018 El modo de cifrase también se activa con la instrucción
2019 @code{\figures}. También crea un contexto de @code{FiguredBass} nuevo
2020 y hace que el código que viene a continuación se interprete con la
2021 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
2022 dentro del contexto @code{FiguredBass}, véase @ref{Introducción al bajo cifrado}.
2024 @strong{Modos de traste y tablatura}
2026 No existen modos de entrada especiales para introducir símbolos de
2027 trastes y de tablatura.
2029 Para crear diagramas de trastes, escriba las notas o acordes en el
2030 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2031 véase @ref{Tablaturas predeterminadas}.
2033 Para crear diagramas de trastes encima de un pentagrama, escríbalos
2034 como elementos de marcado encima de las notas utilizando la
2035 instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
2037 @strong{Modo de letra}
2039 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
2040 se interprete como sílabas de la letra de la canción con duraciones
2041 opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
2043 El modo de letra también se habilita con la instrucción
2044 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
2045 y una instrucción @code{\lyricsto} implícita que asocia la letra que
2046 viene a continuación con la música precedente.
2048 @strong{Modo de marcado}
2050 Se activa con la instrucción @code{\markup}, y hace que la entrada se
2051 interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
2053 @c silly work-around for texinfo broken-ness
2054 @c (@strong{Note...} causes a spurious cross-reference in Info)
2057 Es el modo predeterminado o se puede activar con la instrucción
2058 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
2059 marcado, etc. y se imprime como notación musical sobre un pentagrama.
2061 Normalmente no es necesario especificar el modo de notas de forma
2062 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2063 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2064 otro modo y queremos insertar algo que solamente se puede hacer con la
2065 sintaxis del modo de notas.
2067 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
2068 una pieza coral es necesario entrar en el modo de notas para poder
2069 interpretar dichas indicaciones:
2071 @lilypond[verbatim,relative=2,quote]
2074 \notemode{\set stanza = \markup{ \dynamic f 1. } }
2078 \notemode{\set stanza = \markup{ \dynamic p 2. } }
2085 @node Dirección y posición
2086 @subsection Dirección y posición
2087 @translationof Direction and placement
2089 Al tipografiar música, la dirección y colocación de muchos elementos
2090 es cuestión de elección. Por ejemplo, las plicas de las notas se
2091 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
2092 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
2093 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
2094 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
2095 LilyPond las determine automáticamente, pero en ciertos casos puede
2096 ser deseable forzar una dirección o colocación concreta.
2098 @strong{Acciones predeterminadas}
2100 De forma predeterminada algunas direcciones siempre son hacia arriba o
2101 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
2102 otras cosas pueden alternar entre arriba y abajo en función de la
2103 dirección de las plicas (como las ligaduras o los acentos).
2105 @c TODO Add table showing these
2107 @strong{Disposición de contexto}
2109 Los contextos se colocan dentro de un sistema de arriba a abajo en el
2110 orden en que se encuentran. Sin embargo, observe que se crea un
2111 contexto implícitamente si se encuentra una instrucción cuando no está
2112 disponible un contexto apropiado para contenerla.
2114 @c TODO Add example ?
2116 Se pude cambiar el orden predeterminado en que los contextos se
2117 presentan, véase @ref{Alinear los contextos}
2119 @strong{Indicadores de dirección de las articulaciones}
2121 Al añadir articulaciones a notas se puede omitir normalmente el
2122 indicador de dirección, @code{^} (que significa @qq{arriba}), @code{_}
2123 (que significa @qq{abajo}) o @code{-} (que significa @qq{usar la
2124 dirección predeterminada}), en cuyo caso se supone el predeterminado
2125 @code{-}. Pero se necesita un indicador de dirección @strong{siempre}
2129 @item las instrucciones @code{\tweak}
2130 @item las instrucciones @code{\markup}
2131 @item las instrucciones @code{\tag}
2132 @item los marcados de cadena, p.ej. -"cadena"
2133 @item las instrucciones de digitación, p.ej. @code{-1}
2134 @item las abreviaturas de articulación, p.ej. @code{-.}, @code{->}, @code{--}
2137 Estas indicaciones afectan sólo a la nota siguiente.
2139 @lilypond[verbatim,quote,relative=2]
2146 @strong{La propiedad de dirección}
2148 La posición o dirección de muchos objetos de presentación está
2149 controlada por la propiedad @code{direction}.
2151 El valor de la propiedad @code{direction} se puede establecer al valor
2152 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
2153 @code{-1}, con el significado de @qq{hacia abajo} o @qq{debajo}. Se
2154 pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
2155 @code{1} y @code{-1} respectivamente. La dirección predeterminada se
2156 puede especificar estableciendo @code{direction} a @code{0} ó a
2157 @code{CENTER}. De forma alternativa, en muchos casos existen
2158 instrucciones predefinidas para especificar la dirección. Todas ellas
2162 @code{\xxxUp}, @code{xxxDown}, @code{xxxNeutral}
2165 donde @code{xxxNeutral} significa @qq{utilizar la dirección
2166 predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
2168 En alguna que otra ocasión, con el único ejemplo usual del arpegio, el
2169 valor de la propiedad @code{direction} especifica si el objeto se debe
2170 colocar a la izquierda o a la derecha del objeto padre. En este caso
2171 @code{-1} ó @code{LEFT} significan @qq{a la izquierda} y @code{1} ó
2172 @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
2173 significan @qq{utilizar la dirección predeterminada}, como antes.
2175 Estas indicaciones afectan a todas las notas hasta que son canceladas.
2177 @lilypond[verbatim,quote,relative=2]
2187 @node Orden de disposición de los contextos
2188 @subsection Orden de disposición de los contextos
2189 @translationof Context layout order
2191 @cindex contextos, orden de disposición
2193 Los contextos se disponen en un sistema normalmente desde arriba hacia
2194 abajo en el orden en que se encuentran en el archivo de entrada.
2195 Cuando los contextos se anidan unos dentro de otros, el contexto
2196 exterior incluye a los contextos anidados tal y como se especifica en
2197 el archivo de entrada, siempre y cuando los contextos interiores estén
2198 incluidos en la lista @qq{accepts} del contexto externo. Los
2199 contextos anidados que no está nincluidos en la lista @qq{accepts} del
2200 contexto externo se recolocan debajo del contexto externo en lugar de
2201 anidarse dentro de él.
2203 Observe que discretamente se crea un contexto de forma implícita si se
2204 encuentra una instrucción donde no hay un contexto apropiado para
2205 contenerlo. Esto puede dar lugar a pentagramas o partituras nuevos no
2208 El orden predeterminado en que los contextos se disponen, así como la
2209 lista @qq{accepts}, pueden cambiarse; véase @ref{Alinear los
2213 Manual de utilización del programa:
2214 @rprogram{An extra staff appears}.
2216 @node Distancias y medidas
2217 @subsection Distancias y medidas
2218 @translationof Distances and measurements
2220 @cindex distancias absolutas
2221 @cindex distancias escaladas
2228 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
2230 Las distancias absolutas se usan para especificar márgenes, sangrados
2231 y otros detalles de diseño de página, y de forma predeterminada se
2232 especifican en milímetros. Las distancias se pueden especificar en
2233 otras unidades escribiendo después de la cifra indicativa de la
2234 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
2235 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
2236 de página se pueden especificar también en unidades escalables (véase
2237 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
2238 La disposición de página se describe en detalle en @ref{Formateo de
2241 Las distancias escaladas siempre se especifican en unidades de un
2242 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
2243 El espacio de pentagrama es la distancia entre dos líneas del
2244 pentagrama adyacentes. El valor predeterminado se puede cambiar
2245 globalmente fijando el tamaño global del pentagrama, o se puede
2246 sobreescribir localmente cambiando la propiedad @code{staff-space} del
2247 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
2248 automáticamente con cualquier cambio al tamaño global del pentagrama o
2249 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
2250 las fuentes tipográficas se escalan solamente con los cambios
2251 efectuados al tamaño global del pentagrama. Así, el tamaño global del
2252 pentagrama posibilita la fácil variación del tamaño general de una
2253 partitura impresa. Para ver los métodos de establecimiento del tamaño
2254 global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2258 Si se necesita dibujar sólo una sección de una partitura a una escala
2259 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2260 simplemente cambiar el tamaño global del pentagrama porque esto
2261 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2262 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2263 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2264 nuestra disposición una función de Scheme, @code{magstep}, para
2265 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2266 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2267 utilización, consulte @rlearning{Longitud y grosor de los objetos}.
2271 Manual de aprendizaje:
2272 @rlearning{Longitud y grosor de los objetos}.
2274 Referencia de la notación:
2275 @ref{Formateo de las páginas},
2276 @ref{Establecer el tamaño del pentagrama}.
2279 @node Propiedades del símbolo del pentagrama
2280 @subsection Propiedades del símbolo del pentagrama
2281 @translationof Staff symbol properties
2283 @cindex ajuste del símbolo del pentagrama
2284 @cindex dibujar el símbolo del pentagrama
2285 @cindex pentagrama, establecer el símbolo del
2287 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2288 @c Need to think of uses for these properties. Eg 'line-positions
2289 @c is used in a snippet to thicken centre line.
2290 @c If retained, add @ref to here in 1.6.2 -td
2292 Se puede definir al mismo tiempo la posición vertical de las líneas de
2293 la pauta y el número de líneas de la misma. Como muestra el siguiente
2294 ejemplo, las posiciones de las notas no están influidas por las
2295 posiciones de las líneas de la pauta.
2297 @warning{La propiedad @code{'line-positions} sobreescribe a la
2298 propiedad @code{'line-count}. El número de líneas de la pauta está
2299 definido implícitamente por el número de elementos de la lista de
2300 valores de @code{'line-positions}.}
2302 @lilypond[verbatim,quote,relative=1]
2304 \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
2309 Se puede modificar la anchura de la pauta. Las unidades son espacios
2310 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2311 resulta afectado por este ajuste.
2313 @lilypond[verbatim,quote,relative=1]
2315 \override StaffSymbol #'width = #23
2321 @node Objetos de extensión
2322 @subsection Objetos de extensión
2323 @translationof Spanners
2325 Muchos objetos de notación musical abarcan varias notas o incluso
2326 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2327 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2328 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2329 especiales para controlar su apariencia y comportamiento. Algunas de
2330 estas propiedades son comunes a todos los objetos de extensión; otras
2331 se limitan a un subconjunto de los extensores.
2333 Todos los objetos de extensión contemplan el interface
2334 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2335 una línea recta entre los dos objetos, contemplan también el interface
2336 @code{line-spanner-interface}.
2338 @unnumberedsubsubsec Uso del @code{spanner-interface}
2340 Este interface proporciona dos propiedades que se aplican a varios
2343 @strong{@i{La propiedad @code{minimum-length}}}
2345 La longitud mínima del objeto de extensión se especifica a través de
2346 la propiedad @code{minimum-length}. Su aumento suele producir el
2347 efecto necesario de aumentar el espaciado de las notas entre los dos
2348 puntos extremos. Sin embargo, esta sobreescritura no tiene ningún
2349 efecto sobre muchos extensores, pues su longitud está determinada por
2350 otras consideraciones. Más abajo se muestran algunos ejemplos de
2361 Works as long as callback is made:
2365 Works not at all for:
2374 @lilypond[verbatim,quote,relative=2]
2377 % increase the length of the tie
2378 -\tweak #'minimum-length #5
2382 @lilypond[verbatim,quote,relative=2]
2384 \compressFullBarRests
2386 % increase the length of the rest bar
2387 \once \override MultiMeasureRest #'minimum-length = #20
2392 @lilypond[verbatim,quote,relative=2]
2394 % increase the length of the hairpin
2395 \override Hairpin #'minimum-length = #20
2399 Esta sobreescritura se puede usar también para aumentar la longitud de
2400 las ligaduras de expresión y de fraseo:
2402 @lilypond[verbatim,quote,relative=2]
2405 -\tweak #'minimum-length #5
2410 -\tweak #'minimum-length #5
2414 Para algunos objetos de presentación, la propiedad
2415 @code{minimum-length} es efectiva sólo si se llama explícitamente al
2416 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
2417 propiedad @code{springs-and-rods} al valor
2418 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
2419 de un glissando no tiene efecto a no ser que se establezca la
2420 propiedad @code{springs-and-rods}:
2422 @lilypond[verbatim,quote,relative=1]
2426 % not effective alone
2427 \once \override Glissando #'minimum-length = #20
2430 % effective only when both overrides are present
2431 \once \override Glissando #'minimum-length = #20
2432 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
2436 Lo mismo se puede decir del objeto @code{Beam}:
2438 @lilypond[verbatim,quote,relative=1]
2439 % not effective alone
2440 \once \override Beam #'minimum-length = #20
2443 % effective only when both overrides are present
2444 \once \override Beam #'minimum-length = #20
2445 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2449 @strong{@i{The @code{to-barline} property}}
2451 La segunda propiedad útil del @code{spanner-interface} es
2452 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2453 haciendo que los reguladores y otros objetos de extensión que terminan
2454 sobre la primera nota de un compás, en vez de eso terminen en la línea
2455 divisoria inmediatamente precedente. Si se establece al valor falso,
2456 el extensor llegará más allá de la barra de compás y terminará
2457 exactamente sobre la nota:
2459 @lilypond[verbatim,quote,relative=2]
2460 a \< a a a a \! a a a \break
2461 \override Hairpin #'to-barline = ##f
2462 a \< a a a a \! a a a
2465 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
2466 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2467 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2468 que terminar en la barra de compás no tendría ningún significado.
2470 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
2472 Entre los objetos que contemplan el interface
2473 @code{line-spanner-interface} se encuentran
2476 @item @code{DynamicTextSpanner}
2477 @item @code{Glissando}
2478 @item @code{TextSpanner}
2479 @item @code{TrillSpanner}
2480 @item @code{VoiceFollower}
2483 La rutina responsable de dibujar los sellos de estos extensores es
2484 @code{ly:line-interface::print}. esta rutina determina la
2485 localización exacta de los dos puntos extremos y traza una línea entre
2486 ellos, en el estilo solicitado. Las posiciones de los dos puntos
2487 extremos del extensor se calculan al vuelo, pero es posible
2488 sobreescribir sus coordenadas Y. Las propiedades que se deben
2489 especificar están anidadas a dos niveles de profundidad en la
2490 jerarquía de propiedades, pero la sintaxis de la instrucción
2491 @code{\override} es bastante sencilla:
2493 @lilypond[relative=2,quote,verbatim]
2495 \once \override Glissando #'(bound-details left Y) = #3
2496 \once \override Glissando #'(bound-details right Y) = #-2
2500 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2501 siendo el punto del cero la línea central del pentagrama. Para el
2502 glissando, esto es el valor de @code{Y} en la coordenada X que
2503 corresponde al punto central de cada cabeza de nota si nos imaginamos
2504 que la línea se extiende hasta allí.
2506 Si no está fijado @code{Y}, su valor se calcula a partir de la
2507 posición vertical del punto de anclaje correspondiente del extensor.
2509 En caso de salto de línea, los valores para los puntos extremos se
2510 especifican por las sub-listas @code{left-broken} y
2511 @code{right-broken} de @code{bound-details}. Por ejemplo:
2513 @lilypond[relative=2,ragged-right,verbatim,fragment]
2514 \override Glissando #'breakable = ##t
2515 \override Glissando #'(bound-details right-broken Y) = #-3
2516 c1 \glissando \break
2520 Un número de propiedades adicionales de las sub-listas @code{left} y
2521 @code{right} de la propiedad @code{bound-details} se pueden
2522 especificar de la misma forma que @code{Y}:
2526 Establece la coordenada Y del punto extremo, en desplazamientos de
2527 @code{staff-space}s desde la línea central del pentagrama. De forma
2528 predeterminada es el centro del objeto ancla, y así un glissando
2529 apunta al centro vertical de la cabeza de la nota.
2531 Para extensores horizontales como los extensores de texto y los
2532 trinos, está inamoviblemente codificado como 0.
2534 @item attach-dir (dirección de anclaje)
2535 Determina dónde comienza y termina la línea en la dirección X, con
2536 relación al objeto ancla. Sí, un valor de @code{-1} (o @code{LEFT},
2537 izquierda) hace que la línea comience o termine en el lado izquierdo
2538 de la cabeza de la nota a la que está anclado.
2541 Es la coordenada X absoluta del punto extremo. Se suele calcular al
2542 vuelo, y su sobreescritura no tiene un efecto útil.
2544 @item stencil (sello)
2545 Los extensores de línea pueden tener símbolos al comienzo o al final,
2546 lo que está contenido en esta sub-propiedad. Esto es para uso
2547 interno; se recomienda en su lugar el uso de @code{text}.
2550 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
2551 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2552 de extensión horizontales.
2554 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2555 \override TextSpanner #'(bound-details left text)
2556 = \markup { \small \bold Slower }
2557 c2\startTextSpan b c a\stopTextSpan
2560 @item stencil-align-dir-y (alineación del sello en y)
2561 @item stencil-offset (desplazamiento del sello)
2562 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2563 punto extremo, centrado sobre la línea, como viene definido por las
2564 subpropiedades @code{X} e @code{Y}. Si se fijan
2565 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2566 símbolo del borde verticalmente con relación al extremo de la línea:
2568 @lilypond[relative=1,fragment,verbatim]
2569 \override TextSpanner
2570 #'(bound-details left stencil-align-dir-y) = #-2
2571 \override TextSpanner
2572 #'(bound-details right stencil-align-dir-y) = #UP
2574 \override TextSpanner
2575 #'(bound-details left text) = #"ggg"
2576 \override TextSpanner
2577 #'(bound-details right text) = #"hhh"
2578 c4^\startTextSpan c c c \stopTextSpan
2581 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2582 al contrario de lo que podría esperarse, pues el valor de @code{-1} o
2583 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
2584 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
2585 (arriba) alinea el borde superior del texto con la línea extensora.
2587 @item arrow (flecha)
2588 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
2589 flecha en el extremo de la línea.
2591 @item padding (relleno)
2592 Esta sub-propiedad controla el espacio entre el punto extremo
2593 especificado de la línea y el extremo real. Sin relleno, un glissando
2594 empezaría y terminaría en el centro de la cabeza de las notas.
2598 La función musical @code{\endSpanners} finaliza de forma prematura el
2599 extensor que comienza sobre la nota que sigue inmediatamente a
2600 continuación. Se termina después de una nota exactamente, o en la
2601 siguiente barra de compás si @code{to-barline} es verdadero y se
2602 produce una divisoria antes de la siguiente nota.
2604 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
2606 c2 \startTextSpan c2 c2
2611 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
2612 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
2616 Referencia de funcionamiento interno:
2617 @rinternals{TextSpanner},
2618 @rinternals{Glissando},
2619 @rinternals{VoiceFollower},
2620 @rinternals{TrillSpanner},
2621 @rinternals{line-spanner-interface}.
2624 @node Visibilidad de los objetos
2625 @subsection Visibilidad de los objetos
2626 @translationof Visibility of objects
2628 @cindex objetos, visibilidad de
2629 @cindex grobs, visibilidad de
2630 @cindex visibilidad de los objetos
2632 Hay cuatro formas principales en que se puede controlar la visibilidad
2633 de los objetos de presentación: se puede eliminar su sello, se pueden
2634 volver transparentes, se pueden pintar de blanco, o se puede
2635 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
2636 se aplican a todos los objetos de presentación; la última sólo a unos
2637 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
2638 introduce estas cuatro técnicas, véase @rlearning{Visibilidad y color de los objetos}.
2640 Hay también algunas otras técnicas que son específicas de ciertos
2641 objetos de presentación. Se estudian bajo Consideraciones especiales.
2644 * Eliminar el sello::
2645 * Hacer transparentes los objetos::
2646 * Pintar los objetos de blanco::
2647 * Uso de break-visibility (visibilidad en el salto)::
2648 * Consideraciones especiales::
2652 @node Eliminar el sello
2653 @unnumberedsubsubsec Eliminar el sello
2654 @translationof Removing the stencil
2656 @cindex sello, eliminar
2658 Todo objeto de presentación tiene una propiedad stencil (sello). De
2659 forma predeterminada está establecida a la función específica que
2660 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
2661 se llama a ninguna función y el objeto no se dibuja. La acción
2662 predeterminada se puede recuperar con @code{\revert}.
2664 @lilypond[quote,verbatim,relative=1]
2666 \override Score.BarLine #'stencil = ##f
2668 \revert Score.BarLine #'stencil
2672 @node Hacer transparentes los objetos
2673 @unnumberedsubsubsec Hacer transparentes los objetos
2674 @translationof Making objects transparent
2676 @cindex transparentes, hacer los objetos
2678 Todo objeto de presentación tiene una propiedad transparent
2679 (transparente) que de forma predeterminada está establecida a
2680 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
2683 @lilypond[quote,verbatim,relative=2]
2685 \once \override NoteHead #'transparent = ##t
2689 @node Pintar los objetos de blanco
2690 @unnumberedsubsubsec Pintar los objetos de blanco
2691 @translationof Painting objects white
2693 @cindex objetos, coloreado de
2694 @cindex coloreado de objetos
2696 @cindex impresión, orden de
2697 @cindex sobreescritura de objetos
2698 @cindex objetos, sobreescritura de
2699 @cindex grobs, sobreescritura de
2701 Todo objeto de presentación tiene una propiedad de color que de forma
2702 predeterminada está establecida a @code{black} (negro). Si se
2703 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
2704 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
2705 color de los puntos de cruce queda determinado por el orden en que se
2706 dibujan estos objetos, lo que puede dejar una imagen fantasma del
2707 objeto blanco, como puede verse aquí:
2709 @lilypond[quote,verbatim,relative=2]
2710 \override Staff.Clef #'color = #white
2714 Se puede evitar esto cambiando el orden de impresión de los objetos.
2715 Todos los objetos de presentación tienen una propiedad @code{layer}
2716 (capa) que se debe establecer a un valor entero. Los objetos con el
2717 valor de @code{layer} más bajo se dibujan primero, después se dibujan
2718 los objetos con valores progresivamente mayores, y así los objetos con
2719 valores más altos se dibujan encima de los que tienen valores más
2720 bajos. De forma predeterminada, casi todos los objetos tienen
2721 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
2722 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
2723 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
2724 impresión de los objetos con el mismo valor de @code{layer} es
2727 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
2728 predeterminado de @code{1}, se dibuja después de las líneas del
2729 pentagrama (valor @code{layer} predeterminado de @code{0}),
2730 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
2731 @code{Clef} un valor de @code{layer} más bajo, digamos @code{-1}, para
2732 que se dibuje antes:
2734 @lilypond[quote,verbatim,relative=2]
2735 \override Staff.Clef #'color = #white
2736 \override Staff.Clef #'layer = #-1
2740 @node Uso de break-visibility (visibilidad en el salto)
2741 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
2742 @translationof Using break-visibility
2744 @c TODO Add making other objects breakable
2746 @cindex break-visibility
2748 Casi todos los objetos de presentación se imprimen una sola vez, pero
2749 algunos como las líneas divisorias, claves, indicaciones de compás y
2750 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
2751 se produce un salto de línea : una vez al final de la línea y otra al
2752 comienzo de la siguiente. Estos objetos reciben el nombre de
2753 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
2754 (visibilidad en el salto), para controlar su visibilidad en las tres
2755 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
2756 la línea si se produce un cambio, y al final de la línea si el cambio
2757 se produce en ese lugar.
2759 Por ejemplo, la indicación de compás se imprime de forma
2760 predeterminada al comienzo de la primera línea y en ningún otro lugar
2761 a no ser que cambie, en cuyo caso se imprime en el punto en que se
2762 produce el cambio. Si este cambio se produce al final de una línea,
2763 la nueva indicación de compás se imprime al principio de la línea
2764 siguiente y también al final de la línea anterior como indicación de
2767 Este comportamiento se controla por medio de la propiedad
2768 @code{break-visibility}, que se explica en
2769 @c Leave this ref on a newline - formats incorrectly otherwise -td
2770 @rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
2771 vector de tres valores booleanos que, por orden, determinan si el
2772 objeto se imprime al final, dentro, o al principio de la línea. O,
2773 para ser más exactos: antes del salto de línea, si no hay salto, o
2776 Como alternativa se puede especificar cualquiera de las ocho
2777 combinaciones mediante funciones predefinidas cuya definición está en
2778 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
2779 los objetos de presentación serán visibles en las posiciones que se
2780 muestran en el encabezamiento de cada columna:
2782 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {yes} {yes} {yes}
2783 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
2784 @headitem de función @tab de vector @tab salto @tab salto @tab salto
2786 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
2787 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
2788 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
2789 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
2790 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
2791 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
2792 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
2793 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
2796 Los ajustes predeterminados de @code{break-visibility} dependen del
2797 objeto de presentación. La tabla siguiente muestra todos los objetos
2798 de presentación de interés que resultan afectados por
2799 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
2801 @multitable @columnfractions .3 .3 .4
2803 @headitem Objeto @tab Contexto usual @tab Valor predet.
2805 @c omit Ambitus as it appears not to be affected by break-visibility -td
2806 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
2807 @item @code{BarLine} @tab @code{Score} @tab calculado
2808 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
2809 @c omit the following item until it can be explained -td
2810 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
2811 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2812 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
2813 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
2814 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2815 @c omit KeyCancellation until it can be explained -td
2816 @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible}
2817 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
2818 @c omit LeftEdge until it can be explained -td
2819 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
2820 @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible}
2821 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
2822 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
2826 El ejemplo de abajo muestra el uso de la forma de vector para
2827 controlar la visibilidad de las líneas divisorias:
2829 @lilypond[quote,verbatim,relative=1,ragged-right]
2832 % Remove bar line at the end of the current line
2833 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
2839 Aunque los tres componentes del vector utilizado para sobreescribir
2840 @code{break-visibility} deben estar presentes, no todos son efectivos
2841 para todos los objetos de presentación, y algunas combinaciones pueden
2842 incluso dar errores. Son de aplicación las siguientes limitaciones:
2845 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
2846 @item No se puede imprimir el número de compás al principio de la primera
2847 línea a no ser que su valor establecido sea distinto de 1.
2848 @item Clave: véase más abajo
2849 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
2850 se suprimen por completo. Utilice begin-of line-invisible para
2851 imprimirlas y all-invisible para suprimirlas.
2852 @item Armadura: véase más abajo
2853 @item OctavateEight: véase más abajo
2856 @node Consideraciones especiales
2857 @unnumberedsubsubsec Consideraciones especiales
2858 @translationof Special considerations
2860 @strong{@emph{Visibilidad después de un cambio explícito}}
2862 @cindex armadura, visibilidad después de un cambio explícito
2863 @cindex explicitKeySignatureVisibility
2864 @cindex clave, visibilidad después de un cambio explícito
2865 @cindex explicitClefVisibility
2867 La propiedad @code{break-visibility} controla la visibilidad de las
2868 armaduras y cambios de clave sólo al principio de las líneas, es
2869 decir, después de un salto. No tiene ningún efecto sobre la
2870 visibilidad de la armadura o la clave después de un cambio explícito
2871 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
2872 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
2873 bemol mayor es visible incluso con @code{all-invisible} establecido.
2875 @lilypond[quote,verbatim,relative=1,ragged-right]
2878 % Try to remove all key signatures
2879 \override Staff.KeySignature #'break-visibility = #all-invisible
2887 La visibilidad de estos cambios explícitos de tonalidad y de clave se
2888 controla por medio de las propiedades
2889 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
2890 Son los equivalentes de la propiedad @code{break-visibility} y las dos
2891 toman un vector de tres valores booleanos o las funciones predefinidas
2892 relacionadas anteriormente, exactamente igual que
2893 @code{break-visibility}. Las dos son propiedades del contexto Staff,
2894 no de los propios objetos de presentación, y por tanto se establecen
2895 utilizando la instrucción @code{\set}. Las dos están establecidas de
2896 forma predeterminada al valor @code{all-visible}. Estas propiedades
2897 controlan sólo la visibilidad de las armaduras y las claves que
2898 resultan de los cambios explícitos y no afectan a las armaduras y
2899 tonalidades que están al principio de las líneas; para quitarlas, aún
2900 se debe sobreescribir la propiedad @code{break-visibility} en el
2901 objeto correspondiente.
2903 @lilypond[quote,verbatim,relative=1,ragged-right]
2906 \set Staff.explicitKeySignatureVisibility = #all-invisible
2907 \override Staff.KeySignature #'break-visibility = #all-invisible
2914 @strong{@emph{Visibilidad de las alteraciones de precaución}}
2916 Para eliminar las alteraciones de precaución que se imprimen en un
2917 cambio de tonalidad explícito, establezca la propiedad
2918 @code{printKeyCancellation} del contexto Staff a @code{#f}:
2920 @lilypond[quote,verbatim,relative=1,ragged-right]
2923 \set Staff.explicitKeySignatureVisibility = #all-invisible
2924 \set Staff.printKeyCancellation = ##f
2925 \override Staff.KeySignature #'break-visibility = #all-invisible
2932 Con estas sobreescrituras solamente permanecen las alteraciones
2933 accidentales delante de las notas para indicar el cambio de tonalidad.
2935 @c TODO Add visibility of cautionary accidentals before notes
2937 @strong{@emph{Automatic bars}}
2939 @cindex automaticBars
2940 @cindex líneas divisorias, eliminación
2942 Como caso especial, la impresión de las líneas divisorias también se
2943 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
2944 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
2945 imprimen automáticamente; se deben crear explícitamente con una
2946 instrucción @code{\bar}. A diferencia de la instrucción predefinida
2947 @code{\cadenzaOn}, los compases se siguen contando. La generación de
2948 compases continúa de acuerdo a esta cuenta si esta propiedad se
2949 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
2950 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
2955 @strong{@emph{Octavated clefs}}
2957 @cindex octavadas, visibilidad de las claves
2958 @cindex visibilidad de las claves octavadas
2959 @cindex claves, visibilidad de la octavación
2961 El pequeño símbolo de octava sobre las claves en octava alta o baja se
2962 produce por parte del objeto @code{OctavateEight}. Su visibilidad se
2963 controla independientemente de la del objeto @code{Clef}, así que es
2964 necesario aplicar las sobreescrituras correspondientes
2965 @code{break-visibility} tanto a los objetos @code{Clef} como
2966 @code{OctavateEight} para suprimir completamente estos símbolos de
2967 clave al comienzo de cada línea.
2969 Para los cambios de clave explícitos, la propiedad
2970 @code{explicitClefVisibility} controla tanto el símbolo de clave como
2971 el símbolo de octava asociado.
2975 Manual de aprendizaje:
2976 @rlearning{Visibilidad y color de los objetos}
2979 @node Estilos de línea
2980 @subsection Estilos de línea
2981 @translationof Line styles
2983 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
2984 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
2985 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
2987 Todos ellos usan las mismas rutinas que el glissando para dibujar los
2988 textos y las líneas, y por ello el ajuste fino de su comportamiento se
2989 hace de la misma manera. Se hace con un spanner (un objeto de
2990 extensión), y la rutina responsable de dibujar los objetos de
2991 extensión es @code{ly:line-interface::print}. Esta rutina determina la
2992 colocación exacta de los dos @i{extremos del objeto de extensión} y
2993 dibuja una línea entre ellos, en el estilo solicitado.
2995 He aquí un ejemplo de los distintos estilos de línea disponibles, y
2996 cómo aplicarles ajustes finos.
2998 @lilypond[relative=2,ragged-right,verbatim,fragment]
3000 \once \override Glissando #'style = #'dashed-line
3002 \override Glissando #'style = #'dotted-line
3004 \override Glissando #'style = #'zigzag
3006 \override Glissando #'style = #'trill
3010 Las posiciones de los puntos extremos del objeto de extensión se
3011 computan al vuelo para cada uno de los objetos gráficos, pero es
3012 posible sobreescribirlos:
3014 @lilypond[relative=2,ragged-right,verbatim,fragment]
3016 \once \override Glissando #'(bound-details right Y) = #-2
3020 El valor de @code{Y} está establecido a @code{-2} para el extremo
3021 derecho. El lado izquierdo se puede ajustar de forma similar
3022 especificando @code{left} en vez de @code{right}.
3024 Si no está establecido @code{Y}, el valor se computa a partir de la
3025 posición vertical de los puntos de anclaje izquierdo y derecho del
3028 Son posibles otros ajustes de los extensores, para ver más detalles
3029 consulte @ref{Objetos de extensión}.
3032 @node Rotación de objetos
3033 @subsection Rotación de objetos
3034 @translationof Rotating objects
3036 Tanto los objetos de presentación como los elementos de texto de
3037 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
3038 pero difiere el método de hacerlo.
3041 * Rotación de objetos de presentación::
3042 * Rotación de elementos de marcado::
3045 @node Rotación de objetos de presentación
3046 @unnumberedsubsubsec Rotación de objetos de presentación
3047 @translationof Rotating layout objects
3049 @cindex rotating objects
3050 @cindex objects, rotating
3052 Todos los objetos de presentación que contemplan el interface
3053 @code{grob-interface} se pueden rotar estableciendo su propiedad
3054 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
3055 rotación en sentido antihorario, y las coordenadas x e y del punto con
3056 relación al punto de referencia del objeto, alrededor del que se va a
3057 realizar la rotación. El ángulo de rotación se especifica en grados
3058 y las coordenadas en espacios de pentagrama.
3060 El ángulo de rotación y las coordenadas del punto de rotación se deben
3061 determinar por ensayo y error.
3063 @cindex reguladores en ángulo
3064 @cindex ángulo, reguladores en
3066 Solamente en ciertas ocasiones es útil la rotación de objetos de
3067 presentación; el ejemplo siguiente muestra una situación en que puede
3070 @lilypond[quote,verbatim,relative=1]
3072 \override Hairpin #'rotation = #'(20 -1 0)
3076 @node Rotación de elementos de marcado
3077 @unnumberedsubsubsec Rotación de elementos de marcado
3078 @translationof Rotating markup
3080 Todos los textos de marcado se pueden rotar para que se dispongan en
3081 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
3082 instrucción acepta dos argumentos: el ángulo de rotación en grados en
3083 sentido antihorario, y el texto que rotar. Los límites que ocupa el
3084 texto no se rotan: toman su valor a partir de los extremos de las
3085 coordenadas x e y del texto rotado. En el ejemplo siguiente la
3086 propiedad @code{outside-staff-priority} del texto se establece a
3087 @code{#f} para desactivar la evitación automática de colisiones, lo
3088 que empuja al texto a una posición muy alta.
3090 @lilypond[quote,verbatim,relative=1]
3091 \override TextScript #'outside-staff-priority = ##f
3092 g4^\markup { \rotate #30 "a G" }
3093 b^\markup { \rotate #30 "a B" }
3094 des^\markup { \rotate #30 "a D-Flat" }
3095 fis^\markup { \rotate #30 "an F-Sharp" }
3098 @node Trucos avanzados
3099 @section Trucos avanzados
3100 @translationof Advanced tweaks
3102 Esta sección trata sobre distintos enfoques en la realización de
3103 ajustes finos a la apariencia de la partitura impresa.
3106 * Alineación de objetos::
3107 * Agrupación vertical de objetos gráficos::
3108 * Modificación de los sellos::
3109 * Modificación de las formas::
3114 Manual de aprendizaje:
3115 @rlearning{Trucar la salida},
3116 @rlearning{Otras fuentes de información}.
3118 Referencia de la notación:
3119 @ref{Explicación del Manual de referencia de funcionamiento interno},
3120 @ref{Modificar las propiedades}.
3124 @file{scm/@/define@/-grobs@/.scm}.
3126 Fragmentos de código:
3127 @rlsr{Tweaks and overrides}.
3130 @rextend{Interfaces for programmers}.
3132 Referencia de funcionamiento interno:
3133 @rinternals{All layout objects}.
3136 @node Alineación de objetos
3137 @subsection Alineación de objetos
3138 @translationof Aligning objects
3140 Los objetos gráficos que soportan el interface
3141 @code{self-alignment-interface} y/o el @code{side-position-interface}
3142 se pueden alinear contra un objeto colocado previamente, de diversas
3143 maneras. Para ver una lista de estos objetos, consulte
3144 @rinternals{self-alignment-interface} y
3145 @rinternals{side-position-interface}.
3147 Todos los objetos gráficos tienen un punto de referencia, una
3148 extensión horizontal y una extensión vertical. La extensión
3149 horizontal es una pareja de números que dan los desplazamientos a
3150 partir del punto de referencia de los bordes izquierdo y derecho,
3151 siendo negativos los desplazamientos hacia la izquierda. La extensión
3152 vertical es una pareja de números que dan el desplazamiento a partir
3153 del punto de referencia hasta los bordes inferior y superior, siendo
3154 negativos los desplazamientos hacia abajo.
3156 La posición de un objeto sobre el pentagrama viene dada por los
3157 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
3158 valor de @code{X-offset} da el desplazamiento desde la coordenada x
3159 del punto de referencia del objeto padre, y el valor de
3160 @code{Y-offset} da el desplazamiento a partir de la línea central del
3161 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
3162 pueden establecer directamente o se puede dejar que se calculen por
3163 parte de procedimientos para conseguir una alineación con el objeto
3164 padre de distintas maneras.
3166 @warning{Muchos objetos tienen consideraciones de posicionamiento
3167 especiales que hacen que se ignore o se modifique cualquier ajuste
3168 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
3169 objeto contemple el interface @code{self-alignment-interface}.}
3171 Por ejemplo, una alteración accidental se puede reposicionar
3172 verticalmente estableciendo @code{Y-offset} pero los cambios a
3173 @code{X-offset} no tienen ningún efecto.
3175 Las letras de ensayo se pueden alinear con objetos divisibles como
3176 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
3177 propiedades especiales que se encuentran en
3178 @code{break-aligned-interface} para el posicionamiento de las letras
3179 de ensayo sobre dichos objetos.
3182 * Establecer directamente @code{X-offset} y @code{Y-offset}::
3183 * Uso del @code{side-position-interface}::
3184 * Uso del @code{self-alignment-interface}::
3185 * Uso del @code{break-alignable-interface}::
3188 @node Establecer directamente @code{X-offset} y @code{Y-offset}
3189 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
3190 @translationof Setting @code{X-offset} and @code{Y-offset} directly
3192 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
3193 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
3194 notas con una digitación en su posición predeterminada y con los
3195 valores @code{X-offset} y @code{Y-offset} modificados.
3197 @lilypond[verbatim,quote,relative=2]
3200 -\tweak #'X-offset #0
3201 -\tweak #'Y-offset #0
3204 -\tweak #'X-offset #-1
3205 -\tweak #'Y-offset #1
3211 @node Uso del @code{side-position-interface}
3212 @unnumberedsubsubsec Uso del @code{side-position-interface}
3213 @translationof Using the @code{side-position-interface}
3215 Un objeto que contempla el @code{side-position-interface} se puede
3216 colocar junto a su objeto padre de forma que los bordes especificados
3217 de los dos objetos se toquen. El objeto se puede situar encima,
3218 debajo, a la derecha o a la izquierda del objeto padre. El padre no
3219 se puede especificar; viene determinado por el orden de los elementos
3220 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
3221 nota asociada como padre.
3223 Los valores de las propiedades @code{side-axis} y @code{direction}
3224 determinan dónde colocar el objeto, como sigue:
3226 @c TODO add an example of each to the table
3228 @multitable @columnfractions .3 .3 .3
3229 @headitem @code{side-axis} @tab @code{direction} @tab
3230 @headitem propiedad @tab propiedad @tab colocación
3232 @item @code{0} @tab @code{-1} @tab izquierda
3233 @item @code{0} @tab @code{1} @tab derecha
3234 @item @code{1} @tab @code{-1} @tab debajo
3235 @item @code{1} @tab @code{1} @tab encima
3239 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
3240 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
3241 procedimiento devuelve el calor correcto de @code{X-offset} para
3242 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
3243 el valor de @code{direction}.
3245 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
3246 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
3247 procedimiento devuelve el valor correcto de @code{Y-offset} para
3248 situar el objeto encima o debajo del padre de acuerdo con el valor de
3251 @c TODO Add examples
3253 @node Uso del @code{self-alignment-interface}
3254 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
3255 @translationof Using the @code{self-alignment-interface}
3257 @emph{Auto-alineación horizontal de los objetos}
3259 La alineación horizontal de un objeto que contempla el interface
3260 @code{self-alignment-interface} está controlada por el valor de la
3261 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
3262 @code{X-offset} de este objeto esté establecida a
3263 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
3264 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
3265 mitad de la extensión X total del objeto. Los valores negativos
3266 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
3267 valor de @code{0} centra el objeto sobre el punto de referencia de su
3268 padre, un valor de @code{-1} alinea el borde izquierdo del objeto
3269 sobre el punto de referencia de su padre, y un valor de @code{1}
3270 alinea el borde derecho del objeto sobre el punto de referencia de su
3271 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
3272 @code{RIGHT} en sustitución de los valores @code{-1, 0, 1},
3275 Normalmente se usaría la instrucción @code{\override} para modificar
3276 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
3277 @code{\tweak} para alinear varias anotaciones por separado sobre una
3280 @lilypond[quote,verbatim,relative=1]
3282 -\tweak #'self-alignment-X #-1
3284 -\tweak #'self-alignment-X #0
3286 -\tweak #'self-alignment-X #RIGHT
3288 -\tweak #'self-alignment-X #-2.5
3289 ^"aligned further to the right"
3292 @emph{Auto-alineación vertical de los objetos}
3294 Los objetos se pueden alinear verticalmente en una forma análoga a la
3295 alineación horizontal si la propiedad @code{Y-offset} está establecida
3296 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
3297 a menudo se encuentran implicados otros mecanismos en la alineación
3298 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
3299 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
3300 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
3301 las dimensiones verticales del objeto, que suele ser bastante pequeño,
3302 por lo que pueden requerirse números bastante grandes. Un valor de
3303 @code{-1} alinea el borde inferior del objeto con el punto de
3304 referencia del objeto padre, un valor de @code{0} alinea el centro del
3305 objeto con el punto de referencia del padre, y un valor de @code{1}
3306 alinea el borde superior del objeto con el punto de referencia del
3307 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
3308 @code{UP} en sustitución de @code{-1, 0, 1} respectivamente.
3310 @emph{Auto-alineación de objetos en las dos direcciones}
3312 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
3313 alinear un objeto en las dos direcciones simultáneamente.
3315 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
3316 se acerque a la cabeza de la nota.
3318 @lilypond[quote,verbatim,relative=2]
3320 -\tweak #'self-alignment-X #0.5 % move horizontally left
3321 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
3322 -\tweak #'self-alignment-Y #-1 % move vertically up
3327 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
3329 @c Cannot document as they do not seem to operate consistently on all objects -td
3330 @c TODO investigate further
3332 The @code{aligned-on-parent} procedures are used in the same way
3333 as the @code{aligned-on-self} procedures, they difference being
3334 that they permit an object to be aligned with the @emph{edges} of
3335 the parent rather than the parent's reference point. The following
3336 example shows the difference:
3340 @lilypond[verbatim,quote]
3346 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
3348 @c Cannot document as they do not seem to operate consistently on all objects -td
3349 @c TODO investigate further
3353 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
3356 @node Uso del @code{break-alignable-interface}
3357 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
3358 @translationof Using the @code{break-alignable-interface}
3360 @cindex alineación a objetos
3361 @cindex break-align-symbols
3363 Las letras de ensayo se pueden alinear con objetos de notación
3364 distintos a las barras de compás. Estos objetos son @code{ambitus},
3365 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
3366 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
3367 @code{time-signature}.
3369 De forma predeterminada, las letras de ensayo y los números de compás
3370 se centran horizontalmente sobre el objeto:
3372 @lilypond[verbatim,quote,relative=1]
3374 % the RehearsalMark will be centered above the Clef
3375 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
3380 % the RehearsalMark will be centered above the TimeSignature
3381 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
3389 Se puede especificar una lista de posibles objetos para la alineación.
3390 Si algunos de los objetos son invisibles en ese punto debido al valor
3391 de @code{break-visibility} o a valores de visibilidad explícitos para
3392 las armaduras y las claves, la letra de ensayo o número de compás se
3393 alinean con el primer objeto de la lista que sea visible. Si ningún
3394 objeto de la lista es visible, el objeto se alinea con la línea
3395 divisoria. Si la línea divisoria es invisible, el objeto se alinea
3396 con el punto en el que se encontraría la línea divisoria.
3398 @lilypond[verbatim,quote,relative=1]
3400 % the RehearsalMark will be centered above the Key Signature
3401 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3406 % the RehearsalMark will be centered above the Clef
3407 \set Staff.explicitKeySignatureVisibility = #all-invisible
3408 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3415 La alineación de la letra de ensayo con relación al objeto de notación
3416 se puede cambiar, como se ve en el ejemplo siguiente. En una
3417 partitura con varios pentagramas, este ajuste se debe hacer para todos
3420 @lilypond[verbatim,quote,relative=1]
3421 % The RehearsalMark will be centered above the KeySignature
3422 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3428 % The RehearsalMark will be aligned with the left edge of the KeySignature
3429 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
3433 % The RehearsalMark will be aligned with the right edge of the KeySignature
3434 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
3440 La letra de ensayo también se puede desplazar al borde derecho o
3441 izquierdo en una medida arbitraria. Las unidades son espacios de
3444 @lilypond[verbatim,quote,relative=1]
3445 % The RehearsalMark will be aligned with the left edge of the KeySignature
3446 % and then shifted right by 3.5 staff-spaces
3447 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3448 \once \override Score.KeySignature #'break-align-anchor = #3.5
3452 % The RehearsalMark will be aligned with the left edge of the KeySignature
3453 % and then shifted left by 2 staff-spaces
3454 \once \override Score.KeySignature #'break-align-anchor = #-2
3461 @node Agrupación vertical de objetos gráficos
3462 @subsection Agrupación vertical de objetos gráficos
3463 @translationof Vertical grouping of grobs
3465 Los grobs (objetos gráficos) @code{VerticalAlignment} y
3466 @code{VerticalAxisGroup} trabajan de manera coordinada.
3467 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
3468 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
3469 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
3470 Normalmente sólo existe un @code{VerticalAlignment} por cada
3471 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
3472 @code{VerticalAxisGroup}.
3475 @node Modificación de los sellos
3476 @subsection Modificación de los sellos
3477 @translationof Modifying stencils
3479 Todos los objetos de presentación tienen una propiedad @code{stencil}
3480 que es parte del @code{grob-interface}. De forma predeterminada, esta
3481 propiedad suele estar establecida a una función específica del objeto
3482 que está hecha a medida para disponer el símbolo que lo representa en
3483 la salida. Por ejemplo, el ajuste estándar para la propiedad
3484 @code{stencil} del objeto @code{MultiMeasureRest} es
3485 @code{ly:multi-measure-rest::print}.
3487 El símbolo estándar de cualquier objeto se puede sustituir modificando
3488 la propiedad @code{stencil} para que haga referencia a un
3489 procedimiento diferente escrito especialmente. Esto requiere un alto
3490 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3491 una forma más fácil que a menudo puede dar resultados adecuados.
3493 El procedimiento es establecer la propiedad @code{stencil} al
3494 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3495 añadir una propiedad @code{text} al objeto ajustada para que contenga
3496 el texto de marcado que produce el símbolo requerido. Debido a la
3497 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3498 particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
3500 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3501 la nota a unas aspas dentro de una circunferencia.
3503 @lilypond[verbatim,quote]
3505 \once \override NoteHead #'stencil = #ly:text-interface::print
3506 \once \override NoteHead #'text = \markup {
3508 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3509 \musicglyph #"noteheads.s2cross"
3517 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3518 a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
3520 @c TODO Add inserting eps files or ref to later
3522 @c TODO Add inserting Postscript or ref to later
3526 Referencia de la notación:
3527 @ref{Notación gráfica dentro de elementos de marcado},
3528 @ref{Formatear el texto},
3529 @ref{Text markup commands},
3530 @ref{La tipografía Feta}.
3533 @node Modificación de las formas
3534 @subsection Modificación de las formas
3535 @translationof Modifying shapes
3538 * Modificación de ligaduras de unión y de expresión::
3541 @node Modificación de ligaduras de unión y de expresión
3542 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
3543 @translationof Modifying ties and slurs
3545 @cindex ligaduras de expresión, modificar
3546 @cindex ligaduras de unión, modificar
3547 @cindex Bézier, curvas de
3548 @cindex Bézier, puntos de control
3550 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
3551 de Bézier de tercer orden. Si la forma de la ligadura calculada
3552 automáticamente no resulta óptima, se puede modificar su forma
3553 manualmente mediante la especificación explícita de los cuatro puntos
3554 de control necesarios para definir una curva de Bézier de tercer
3557 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
3558 puntos de control. El primer y cuarto puntos de control son
3559 exactamente los puntos extremos de comienzo y de final de la curva.
3560 Los dos puntos de control intermedios definen la forma. Se pueden
3561 encontrar en la web animaciones que muestran cómo se traza la curva,
3562 pero la descripción siguiente puede ser de ayuda. La curva comienza a
3563 partir del primer punto de control dirigiéndose directamente hacia el
3564 segundo, curvándose progresivamente para dirigirse hacia el tercero y
3565 continuando la curva hacia el cuarto, llegando a éste en viaje directo
3566 desde el tercer punto de control. La curva está contenida enteramente
3567 dentro del cuadrilátero definido por los cuatro puntos de control.
3569 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
3570 @code{\tieDown} no sirve de ayuda.
3572 @lilypond[verbatim,quote,relative=1]
3576 { r4 <g c,> <g c,> <g c,> }
3580 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
3581 de control como sigue.
3583 Las coordenadas de los puntos de control de Bézier se especifican en
3584 unidades de espacios de pentagrama. La coordenada@tie{}X está en
3585 relación con el punto de referencia de la nota a la que está unida la
3586 ligadura, y la coordenada@tie{}Y está en relación con la línea central
3587 del pentagrama. Las coordenadas se introducen como una lista de
3588 cuatro parejas de números decimales (reales). Un enfoque es estimar
3589 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
3590 los dos puntos intermedios. Los valores óptimos se encuentran por
3593 Es útil recordar que una curva simétrica necesita puntos de control
3594 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
3595 las transformaciones de la curva tales como la traslación, rotación y
3596 escalado se pueden obtener aplicando la misma transformación a los
3597 puntos de control de la curva.
3599 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
3600 satisfactoria. Observe la colocación: debe ir inmediatamente antes de
3601 la nota a la que se asigna el comienzo de la ligadura de expresión o
3604 @lilypond[verbatim,quote,relative=1]
3608 #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
3612 { r4 <g c,> <g c,> <g c,>4 }
3618 No es posible modificar la forma de las ligaduras de unión o de
3619 expresión cambiando la propiedad @code{control-points} si hay más de
3620 una en el mismo momento musical, ni siquiera usando la instrucción
3625 @node Uso de las funciones musicales
3626 @section Uso de las funciones musicales
3627 @translationof Using music functions
3629 @c TODO -- add @seealso, etc. to these subsections
3631 Dondequiera que se necesite reutilizar trucos con distintas
3632 expresiones musicales, con frecuencia conviene hacer que el truco
3633 forme parte de una función musical. En esta sección estudiaremos
3634 solamente las funciones de @emph{sustitución}, en las que el objeto es
3635 sustituir una variable dentro de un fragmento de código de entrada de
3636 LilyPond. Se describen otras funciones más complejas en
3637 @rextend{Music functions}.
3640 * Sintaxis de las funciones de sustitución::
3641 * Tipos de argumento comunes::
3642 * Ejemplos de funciones de sustitución::
3645 @node Sintaxis de las funciones de sustitución
3646 @subsection Sintaxis de las funciones de sustitución
3647 @translationof Substitution function syntax
3649 Es fácil hacer una función que sustituya una variable dentro de código
3650 de LilyPond. La forma general de estas funciones es
3654 #(define-music-function (parser location @var{var1} @var{var2}...@var{vari}... )
3655 (@var{tipo-de-var1?} @var{tipo-de-var2?}...@var{tipo-de-vari?}...)
3664 @multitable @columnfractions .33 .66
3665 @item @var{vari} @tab @var{i}-ésima variable
3666 @item @var{tipo-de-vari?} @tab tipo de la variable @var{i}-ésima
3667 @item @var{...música...} @tab entrada de LilyPond normal, que utiliza variables como @code{#$var1}, etc.
3670 Los tipos de variable comunes se describen en @ref{Tipos de argumento
3671 comunes}. Hay una descripción más completa de los tipos de variable
3672 en @rextend{Music function syntax}.
3674 Los argumentos @code{parser} y @code{location} son necesarios, y se
3675 utilizan en algunas situaciones avanzadas como se encuentra descrito
3676 en @rextend{Music function syntax}. Para las funciones de
3677 sustitución, tan sólo hemos de asegurarnos de incluirlos.
3681 Referencia de la notación:
3682 @ref{Tipos de argumento comunes}.
3684 Expansión de LilyPond:
3685 @rextend{Music function syntax}.
3687 @node Tipos de argumento comunes
3688 @subsection Tipos de argumento comunes
3689 @translationof Common argument types
3691 Para hacer posible la comprobación de errores, se debe definir el tipo
3692 de cada argumento que se pasa a una función musical. Algunos de los
3693 tipos de variable comunes están relacionados en la tabla que aparece
3696 Los siguientes tipos de entrada se pueden utilizar como variables
3697 dentro de una función musical. La lista no es exhaustiva; hay más
3698 información sobre los posibles tipos de variable en
3699 @rextendnamed{Music function syntax,Sintaxis de las funciones
3702 @multitable @columnfractions .33 .66
3703 @headitem Tipo de entrada @tab notación de @var{tipo-de-vari?}
3704 @item Entero @tab @code{integer?}
3705 @item Flotante (número decimal) @tab @code{number?}
3706 @item Cadena de caracteres @tab @code{string?}
3707 @item Marcado @tab @code{markup?}
3708 @item Expresión musical @tab @code{ly:music?}
3709 @item Dupla de Scheme @tab @code{pair?}
3714 Expansión de LilyPond:
3715 @rextend {Music function syntax}.
3717 Archivos instalados:
3718 @file{lily/music-scheme.cc},
3722 @node Ejemplos de funciones de sustitución
3723 @subsection Ejemplos de funciones de sustitución
3724 @translationof Substitution function examples
3726 Esta sección presenta algunos ejemplos de funciones de sustitución.
3727 No pretenden ser exhaustivas, sino demostrar algunas de las
3728 posibilidades de las funciones de sustitución sencillas.
3730 En el primer ejemplo se define una función que simplifica el ajuste
3731 del relleno de un elemento de inscripción de texto TextScript:
3733 @lilypond[quote,verbatim,ragged-right]
3734 padText = #(define-music-function (parser location padding) (number?)
3736 \once \override TextScript #'padding = #$padding
3740 c4^"piu mosso" b a b
3742 c4^"piu mosso" d e f
3744 c4^"piu mosso" fis a g
3748 Además de números, podemos usar expresiones musicales, como notas,
3749 para los argumentos de las funciones musicales:
3751 @lilypond[quote,verbatim,ragged-right]
3752 custosNote = #(define-music-function (parser location note)
3755 \once \override Voice.NoteHead #'stencil =
3756 #ly:text-interface::print
3757 \once \override Voice.NoteHead #'text =
3758 \markup \musicglyph #"custodes.mensural.u0"
3759 \once \override Voice.Stem #'stencil = ##f
3763 { c' d' e' f' \custosNote g' }
3766 Se pueden definir funciones de sustitución con varios argumentos:
3768 @lilypond[quote,verbatim,ragged-right]
3769 tempoPadded = #(define-music-function (parser location padding tempotext)
3772 \once \override Score.MetronomeMark #'padding = $padding
3773 \tempo \markup { \bold $tempotext }
3777 \tempo \markup { "Low tempo" }
3779 \tempoPadded #4.0 #"High tempo"