1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 1d2e41cbaad491f61b3aba0fc67391cf88a89df8
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/@/internals/,en@tie{}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 @file{.ly} con
45 el símbolo de cuadradillo@tie{}@code{#}.@footnote{@rextend{Tutorial de Scheme}
46 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 * Orden de disposición de los contextos::
76 Manual de aprendizaje:
77 @rlearning{Contextos y grabadores}.
80 @file{ly/engraver-init.ly},
81 @file{ly/performer-init.ly}.
84 @rlsr{Contexts and engravers}.
86 Referencia de funcionamiento interno:
87 @rinternals{Contexts},
88 @rinternals{Engravers and Performers}.
91 @node Explicación de los contextos
92 @subsection Explicación de los contextos
93 @translationof Contexts explained
95 Los contextos se disponen de forma jerárquica:
98 * Score. El contexto maestro::
99 * Contextos del nivel superior. Contenedores de pentagramas::
100 * Contextos de nivel intermedio. Pentagramas::
101 * 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
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.
149 @node Contextos de nivel intermedio. Pentagramas
150 @unnumberedsubsubsec Contextos de nivel intermedio. Pentagramas
151 @translationof Intermediate-level contexts - staves
153 @strong{@emph{Staff}}
155 Maneja claves, barras de compás, tonalidades y alteraciones
156 accidentales. Puede contener contextos de @code{Voice}.
158 @strong{@emph{RhythmicStaff}}
160 Como @code{Staff}, pero para imprimir ritmos. Se ignoran las alturas
161 de las notas; las notas se imprimen sobre una línea.
163 @strong{@emph{TabStaff}}
165 Contexto para generar tablaturas. De forma predeterminada dispone la
166 expresión musical como una tablatura de guitarra, impresa sobre seis
169 @strong{@emph{DrumStaff}}
171 Maneja el tipografiado para instrumentos de percusión. Puede contener
172 contextos @code{DrumVoice}.
174 @strong{@emph{VaticanaStaff}}
176 Igual que @code{Staff}, excepto que está pensado para tipografiar
177 piezas en estilo gregoriano.
179 @strong{@emph{MensuralStaff}}
181 Igual que @code{Staff}, excepto que está diseñado para tipografiar
182 piezas en estilo mensural.
185 @node Contextos del nivel más bajo. Voces
186 @unnumberedsubsubsec Contextos del nivel más bajo. Voces
187 @translationof Bottom-level contexts - voices
189 Los contextos del mismo nivel que Voice dan un valor inicial a ciertas
190 propiedades e inician los grabadores correspondientes. Siendo
191 contextos del nivel más bajo, no pueden contener a otros contextos.
193 @strong{@emph{Voice}}
195 Corresponde a una voz sobre un pentagrama. este contexto maneja la
196 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
197 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
198 que crear instancias explícitas de este contexto si necesitamos varias
199 voces en el mismo pentagrama.
201 @strong{@emph{VaticanaVoice}}
203 Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
204 piezas en estilo gregoriano.
206 @strong{@emph{MensuralVoice}}
208 Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
209 piezas en estilo mensural.
211 @strong{@emph{Lyrics}}
213 Corresponde a una voz con letra. Maneja la impresión de una sola
216 @strong{@emph{DrumVoice}}
218 El contexto de voz utilizado en una pauta de percusión.
220 @strong{@emph{FiguredBass}}
222 El contexto en que los objetos @code{BassFigure} se crean a partir de
223 la entrada escrita en el modo @code{\figuremode}.
225 @strong{@emph{TabVoice}}
227 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
228 Se suele dejar que se cree implícitamente.
230 @strong{@emph{CueVoice}}
232 El contexto de voz que se utiliza para dibujar notas de tamaño
233 reducido, con el principal objetivo de añadir notas guía de un
234 pentagrama a otro, véase @ref{Formateo de las notas guía}.
235 Normalmente se deja que se cree implícitamente.
237 @strong{@emph{ChordNames}}
239 Tipografía nombres de acordes.
242 @node Crear contextos
243 @subsection Crear contextos
244 @translationof Creating contexts
246 @c TODO more complete descriptions rather than learning style
248 Para partituras que sólo tienen una voz y un pentagrama, los contextos
249 se crean automáticamente. Para partituras más complejas, es necesario
250 crearlos a mano. Existen tres instrucciones que hacen esto.
255 La instrucción más fácil es @code{\new}, y es también la más rápida de
256 escribir. Se antepone a una expresión musical, por ejemplo
259 @cindex nuevos, contextos
260 @cindex Contexto, creación de
263 \new @var{tipo} @var{expresión_musical}
267 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
268 @code{Voice}). Esta instrucción crea un contexto nuevo, y empieza a
269 interpretar la @var{expresión_musical} con él.
271 Una aplicación práctica de @code{\new} es una partitura con muchos
272 pentagramas. Cada parte que debe ir en su propio pentagrama, va
273 precedida de @code{\new Staff}.
275 @lilypond[quote,verbatim,relative=2,ragged-right]
282 La instrucción @code{\new} puede también dar nombre al contexto,
285 \new @var{tipo} = @var{identificador} @var{música}
287 Sin embargo, este nombre especificado por el usuario sólo se utiliza
288 si no hay ya otro contexto anterior con el mismo nombre.
294 Como @code{\new}, la instrucción @code{\context} también dirige una
295 expresión musical a un objeto de contexto, pero da al contexto un
296 nombre explícito. La sintaxis es
299 \context @var{tipo} = @var{identificador} @var{música}
302 En esta forma, la instrucción buscará un contexto existente del
303 @var{tipo} especificado que tenga el nombre @var{identificador}. Si
304 ese contexto aún no existe, se crea un contexto nuevo con el nombre
305 especificado. Esto es útil si nos vamos a referir más tarde al
306 contexto. Por ejemplo, cuando se escribe la letra, la melodía está
307 dentro de un contexto con nombre
310 \context Voice = "@b{tenor}" @var{música}
314 de forma que los textos se puedan alinear correctamente con sus notas,
317 \new Lyrics \lyricsto "@b{tenor}" @var{letra}
322 Otro uso posible de los contextos con nombre es la fusión de dos
323 expresiones musicales distintas en un solo contexto. En el siguiente
324 ejemplo, se introducen por separado las articulaciones y las notas:
328 decoracion = @{ s4-. s4-> @}
331 se combinan enviando los dos al mismo contexto @code{Voice},
335 \new Staff \context Voice = "A" \musica
336 \context Voice = "A" \decoracion
339 @lilypond[quote,ragged-right]
343 \new Staff \context Voice = "A" \music
344 \context Voice = "A" \arts
348 Con este mecanismo, es posible definir un @qq{urtext} (una edición
349 original), con la posibilidad de poner articulaciones distintas sobre
352 @cindex crear contextos
355 La tercera instrucción para crear contextos es
357 \context @var{tipo} @var{música}
362 Esto es similar a @code{\context} con @code{= @var{identificador}},
363 pero se corresponde con cualquier contexto del tipo @var{tipo}, sin
364 importar qué nombre se le ha dado.
366 Esta variante se usa con expresiones musicales que se pueden
367 interpretar en varios niveles. Por ejemplo, la instrucción
368 @code{\applyOutput} (véase
369 @rextend{Ejecutar una función sobre todos los objetos de la presentación}).
370 Sin una instrucción @code{\context}
371 explícita, normalmente se aplicaría a @code{Voice}
374 \applyOutput #'@var{contexto} #@var{función} % aplicar al contexto Voice
377 Para que se interprete dentro de los niveles de @code{Score} o
378 @code{Staff}, utilice las siguientes formas:
381 \applyOutput #'Score #@var{función}
382 \applyOutput #'Staff #@var{función}
388 @node Mantener vivos los contextos
389 @subsection Mantener vivos los contextos
390 @translationof Keeping contexts alive
392 @cindex contextos, mantener vivos
393 @cindex contextos, tiempo de vida
395 Normalmente los contextos finalizan en el primer momento musical en
396 que no tienen nada que hacer. Así, los contextos de @code{Voice}
397 mueren tan pronto como ya no contienen ningún evento; los contextos de
398 @code{Staff} mueren tan pronto como todos los contextos de
399 @code{Voice} que contenían ya no contengan ningún evento; etc. Esto
400 puede ocasionar dificultades si se tiene que hacer referencia a
401 contextos anteriores que ya han muerto, por ejemplo, al cambiar de
402 pentagramas con instrucciones @code{\change}, asociar letra con una
403 voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
404 eventos musicales adicionales a un contexto anterior.
406 Existe una excepción a esta regla general: precisamente uno de los
407 contextos de @code{Voice} que están dentro de un contexto de
408 @code{Staff} o de una construcción @code{<<...>>} persiste siempre
409 hasta el final de, contexto de @code{Staff} circundante o la
410 construcción @code{<<...>>}, incluso aunque puede haber períodos en
411 que no tiene nada que hacer. El contexto que persiste de esta forma
412 será el primero que se encuentre en la primera construcción encerrada
413 entre llaves @code{@{...@}}, ignorando cualquiera que se encuentre
414 dentro de construcciones encerradas por ángulos dobles @code{<<...>>}.
416 Cualquier contexto se puede mantener vivo si nos aseguramos de que
417 tiene algo que hacer en cualquier momento musical dado. Los
418 contextos de @code{Staff} se mantienen con vida si nos aseguramos de
419 que una de sus voces se mantiene viva. Una manera de hacerlo es
420 añadir silencios de separación a una voz en paralelo con la música
421 real. Éstos deben añadirse a todos y cada uno de los contextos de
422 @code{Voice} que se hayan de mantener vivos. Si se van a usar
423 esporádicamente varias voces, es más seguro mantenerlas todas vivas en
424 lugar de tratar de confiar en las excepciones que hemos mencionado
427 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
428 vivas de esta manera durante la duración de la pieza:
430 @lilypond[quote,verbatim]
431 musicA = \relative c'' { d4 d d d }
432 musicB = \relative c'' { g4 g g g }
435 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
436 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
441 \context Voice = "A" {
445 \context Voice = "B" {
449 \context Voice = "A" { \musicA }
450 \context Voice = "B" { \musicB }
451 \context Voice = "A" { \musicA }
462 @cindex letra, alineación con melodía esporádica
464 El ejemplo siguiente muestra cómo se puede escribir una línea melódica
465 esporádica con letra utilizando este enfoque. Por supuesto, en una
466 situación real la melodía y el acompañamiento consistirían en varias
467 secciones diferentes.
469 @lilypond[quote,verbatim]
470 melody = \relative c'' { a4 a a a }
471 accompaniment = \relative c' { d4 d d d }
472 words = \lyricmode { These words fol -- low the mel -- o -- dy }
475 \new Staff = "music" {
477 \new Voice = "melody" {
479 s1*4 % Keep Voice "melody" alive for 4 bars
482 \new Voice = "accompaniment" {
487 \context Voice = "melody" { \melody }
488 \context Voice = "accompaniment" { \accompaniment }
490 \context Voice = "accompaniment" { \accompaniment }
492 \context Voice = "melody" { \melody }
493 \context Voice = "accompaniment" { \accompaniment }
498 \new Lyrics \with { alignAboveContext = #"music" }
499 \lyricsto "melody" { \words }
504 Una forma alternativa, que podría resultar mejor en muchas
505 situaciones, es mantener con vida la línea melódica simplemente
506 incluyendo notas espaciadoras para alinearla correctamente con el
509 @lilypond[quote,verbatim]
510 melody = \relative c'' {
516 accompaniment = \relative c' {
522 words = \lyricmode { These words fol -- low the mel -- o -- dy }
526 \new Staff = "music" {
528 \new Voice = "melody" {
532 \new Voice = "accompaniment" {
538 \new Lyrics \with { alignAboveContext = #"music" }
539 \lyricsto "melody" { \words }
545 @node Modificar los complementos (plug-ins) de contexto
546 @subsection Modificar los complementos (plug-ins) de contexto
547 @translationof Modifying context plug-ins
549 @c TODO Should this be Modifying engravers or Modifying contexts?
551 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
552 almacenan propiedades, también contienen «plug-ins» o complementos
553 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
554 el contexto @code{Voice} contiene un grabador
555 @code{Note_heads_engraver} que crea las cabezas de nota y el contexto
556 @code{Staff} contiene un grabador @code{Key_engraver} que
559 Para ver una descripción completa de todos y cada uno de los
560 complementos, consulte
562 @rinternals{Engravers and Performers}.
565 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
567 Cada contexto que se describe en
569 @rinternals{Contexts}
572 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
574 relaciona los grabadores que se usan para ese contexto.
577 Puede ser de utilidad jugar un poco con estos complementos. Se hace
578 iniciando un contexto nuevo con @code{\new} o @code{\context} y
584 \new @var{contexto} \with @{
597 donde los @dots{} deben ser el nombre de un grabador. Aquí tenemos un
598 ejemplo sencillo que suprime los grabadores
599 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
602 @lilypond[quote,relative=1,verbatim]
608 \remove "Time_signature_engraver"
609 \remove "Clef_engraver"
616 En el segundo pentagrama no hay indicación de compás ni clave. Éste
617 es un método bastante rudimentario de hacer que desaparezcan los
618 objetos porque afecta a todo el pentagrama. Este método también
619 afecta al espaciado, lo que puede ser deseable o no serlo. Se
620 muestran métodos más sofisticados para quitar objetos en
621 @rlearning{Visibilidad y color de los objetos}.
623 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
624 líneas divisorias y las indicaciones de compás están sincronizadas a
625 lo largo de toda la partitura. Lo hacen los grabadores
626 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
627 complementos mantienen al día la administración de las indicaciones de
628 compás, posición dentro del compás, etc. Moviendo estos grabadores
629 desde el contexto de @code{Score} al de @code{Staff}, podemos
630 conseguir una partitura en la que cada pentagrama tiene su propio
631 compás independiente.
633 @cindex polimétricas, partituras
634 @cindex compases distintos al mismo tiempo
636 @lilypond[quote,verbatim]
640 \consists "Timing_translator"
641 \consists "Default_bar_line_engraver"
647 \consists "Timing_translator"
648 \consists "Default_bar_line_engraver"
657 \remove "Timing_translator"
658 \remove "Default_bar_line_engraver"
665 Normalmente, el orden en que se especifican los grabadores no tiene
666 importancia, pero en algunos casos especiales sí la tiene, por ejemplo
667 donde un grabador escribe una propiedad y otro la lee, o donde un
668 grabador crea un groby otro debe procesarlo. El orden en que los
669 grabadores se especifican es el orden en que se llaman para realizar
670 su tarea de procesamiento.
672 Las siguientes ordenaciones son importantes: el grabador de compases
673 @code{Bar_engraver} debe ir normalmente en primer lugar, y el grabador
674 de digitaciones @code{New_fingering_engraver} debe ir antes del
675 grabador @code{Script_column_engraver} de columnas de inscripciones.
676 Podría haber otros que tengan dependencias de ordenación.
679 @node Cambiar los valores por omisión de los contextos
680 @subsection Cambiar los valores por omisión de los contextos
681 @translationof Changing context default settings
683 Los ajustes de contexto que están preparados para usarse de forma
684 predeterminada en los contextos @code{Score}, @code{Staff} y
685 @code{Voice}, se pueden especificar dentro de un bloque
686 @code{\layout}, como se ilustra en el ejemplo siguiente. El bloque
687 @code{\layout} se debe colocar dentro del bloque @code{\score} en que
688 se quiere que haga efecto, pero fuera de la música.
690 Observe que la propia instrucción @code{\set} y el contexto se deben
691 omitir cuando se especifican de esta manera los valores de contexto
694 @lilypond[quote,verbatim]
697 a4^"Really small, thicker stems, no time signature" a a a
704 \override Stem #'thickness = #4.0
705 \remove "Time_signature_engraver"
711 En este ejemplo, la instrucción @code{\Staff} especifica que los
712 ajustes siguientes se apliquen a todos los pentagramas dentro del
715 Se pueden realizar de forma similar modificaciones al contexto
716 @code{Score} o a todos los contextos @code{Voice}.
718 Los cambios de contexto se pueden poner dentro de una variable y
719 aplicarse a una definición de contexto @code{\context} anteponiendo la
720 modificación mediante @code{\with}:
722 @lilypond[quote,verbatim]
725 \override Stem #'thickness = #4.0
726 \remove "Time_signature_engraver"
731 \override Stem #'thickness = #-2.0
734 melody = \relative c'' {
743 s1*0^"Small, thicker stems, no time signature"
759 @c TODO: add \with in here.
763 @node Definir contextos nuevos
764 @subsection Definir contextos nuevos
765 @translationof Defining new contexts
767 @cindex contextos, definición de nuevos
768 @cindex grabadores, incluir en contextos
783 Los contextos específicos, como @code{Staff} y @code{Voice}, están
784 construidos a base de bloques sencillos. Es posible crear nuevos
785 tipos de contextos con combinaciones distintas de añadidos grabadores.
787 El siguiente ejemplo muestra cómo construir un tipo diferente de
788 contexto de @code{Voice} partiendo de cero. Será parecido a
789 @code{Voice}, pero imprime solamente cabezas centradas en forma de
790 barra inclinada. Se puede usar para indicar improvisación en piezas
794 @lilypond[quote,ragged-right]
797 \type "Engraver_group"
798 \consists "Note_heads_engraver"
799 \consists "Rhythmic_column_engraver"
800 \consists "Text_engraver"
801 \consists Pitch_squash_engraver
802 squashedPosition = #0
803 \override NoteHead #'style = #'slash
804 \override Stem #'transparent = ##t
805 \override Flag #'transparent = ##t
809 \accepts "ImproVoice"
813 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
814 c4 c^"desvístete" c_"mientras tocas :)" c }
820 Estos ajustes se definen dentro de un bloque @code{\context} que a su
821 vez está dentro de un bloque @code{\layout},
831 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
832 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
834 En primer lugar es necesario definir un nombre para el nuevo contexto:
840 Debido a que es parecido al contexto @code{Voice}, queremos órdenes
841 que funcionen sobre contextos de @code{Voice} (existentes) para que
842 siga funcionando. Esto se consigue dando al contexto nuevo un alias
849 El contexto imprimirá notas y textos explicativos, por ello tenemos
850 que añadir los grabadores que aportan esta funcionalidad:
853 \consists Note_heads_engraver
854 \consists Text_engraver
857 pero sólo necesitamos esto en la línea central:
860 \consists Pitch_squash_engraver
861 squashedPosition = #0
864 El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
865 nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
866 establece sus posiciones verticales al valor de
867 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.
869 Las notas parecen barras inclinadas y no tienen plica:
872 \override NoteHead #'style = #'slash
873 \override Stem #'transparent = ##t
874 \override Flag #'transparent = ##t
877 Todos estos añadidos tienen que cooperar, y esto se consigue con un
878 añadido especial, que se debe marcar con la palabra clave
879 @code{\type}. Este será siempre @code{Engraver_group},
882 \type "Engraver_group"
885 Al juntarlo todo, obtenemos
890 \type "Engraver_group"
891 \consists "Note_heads_engraver"
892 \consists "Text_engraver"
893 \consists Pitch_squash_engraver
894 squashedPosition = #0
895 \override NoteHead #'style = #'slash
896 \override Stem #'transparent = ##t
897 \override Flag #'transparent = ##t
903 Los contextos dan lugar a jerarquías. Queremos colgar el contexto
904 @code{ImproVoice} bajo el contexto @code{Staff}, como simples
905 @code{Voice}s normales. Por tanto, modificamos la definición de
906 @code{Staff} con la instrucción @code{\accepts} (acepta),
916 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
917 que a veces se necesita cuando se están reutilizando definiciones de
920 Ponemos ambos dentro de un bloque @code{\layout}, como
930 \accepts "ImproVoice"
935 Así pues, la salida que aparece al comienzo de esta sub-sección se
944 c c_"mientras tocas :)"
951 @node Orden de disposición de los contextos
952 @subsection Orden de disposición de los contextos
953 @translationof Context layout order
955 @cindex contextos, orden de disposición
959 Los contextos se disponen en un sistema normalmente desde arriba hacia
960 abajo en el orden en que se encuentran en el archivo de entrada.
961 Cuando los contextos se anidan unos dentro de otros, el contexto
962 exterior incluye a los contextos anidados tal y como se especifica en
963 el archivo de entrada, siempre y cuando los contextos interiores estén
964 incluidos en la lista @qq{accepts} del contexto externo. Los
965 contextos anidados que no está nincluidos en la lista @qq{accepts} del
966 contexto externo se recolocan debajo del contexto externo en lugar de
967 anidarse dentro de él.
969 La lista @qq{accepts} de un contexto se puede cambiar con las
970 instrucciones @code{\accepts} (acepta) y @code{\denies} (niega).
971 @code{\accepts} añade un contexto a la lista @qq{accepts} y
972 @code{\denies} elimina un contexto de la lista. Por ejemplo,
973 normalmente no sería deseable que los acordes de cifrado americano
974 estuvieran anidados dentro de un contexto @code{Staff}, por lo que el
975 contexto @code{ChordNames} no se incluye de forma predeterminada
976 dentro de la lista @qq{accepts} del contexto @code{Staff}, pero podría
977 hacerse si fuera necesario:
979 @lilypond[verbatim,quote]
983 \chords { d1:m7 b1:min7.5- }
988 @lilypond[verbatim,quote]
992 \chords { d1:m7 b1:min7.5- }
997 \accepts "ChordNames"
1003 @code{\denies} se usa principalmente cuando un contexto nuevo se está
1004 basando en otro, pero los anidamientos requeridos difieren. Por
1005 ejemplo, el contexto @code{VaticanaStaff} está basado en el contexto
1006 @code{Staff}, pero con el contexto @code{VaticanaVoice} sustituido por
1007 el contexto @code{Voice} en la lista @qq{accepts}.
1009 Observe que discretamente se crea un contexto de forma implícita si se
1010 encuentra una instrucción donde no hay un contexto apropiado para
1011 contenerlo. Esto puede dar lugar a pentagramas o partituras nuevos no
1015 Manual de utilización del programa:
1016 @rprogram{Aparece un pentagrama de más}.
1018 Archivos instalados:
1019 @file{ly/engraver-init.ly}.
1022 @node Explicación del Manual de referencia de funcionamiento interno
1023 @section Explicación del Manual de referencia de funcionamiento interno
1024 @translationof Explaining the Internals Reference
1027 * Navegar por la referencia del programa::
1028 * Interfaces de la presentación::
1029 * Determinar la propiedad del grob::
1030 * Convenciones de nombres::
1035 @node Navegar por la referencia del programa
1036 @subsection Navegar por la referencia del programa
1037 @translationof Navigating the program reference
1039 Supongamos que queremos mover la indicación de digitación del
1040 fragmento siguiente:
1042 @lilypond[quote,relative=2,verbatim]
1048 Si hace una visita a la documentación en busca de instrucciones de
1049 digitación (en @ref{Indicaciones de digitación}), encontrará:
1052 @strong{Véase también}
1054 Referencia de funcionamiento interno: @rinternals{Fingering}.
1059 La referencia del programador se encuentra disponible en forma de
1060 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
1061 en línea o bien descargando los archivos de la documentación HTML.
1062 Esta sección sería mucho más difícil de entender si está utilizando el
1063 manual en formato PDF.
1066 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
1070 Los objetos de digitación se crean por parte de:
1071 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1074 Siguiendo los enlaces relacionados dentro de la referencia del
1075 programa, podemos seguir el flujo de información dentro del programa:
1079 @item @rinternals{Fingering}:
1080 los objetos @rinternals{Fingering} se crean por parte de:
1081 @rinternals{Fingering_engraver}
1083 @item @rinternals{Fingering_engraver}:
1084 Tipos de música aceptados: @rinternals{fingering-event}
1086 @item @rinternals{fingering-event}:
1087 El tipo de evento musical @code{fingering-event} está descrito en
1088 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1091 Este camino se recorre en contra de la corriente de información del
1092 programa: comienza por la salida y acaba en el evento de entrada.
1093 También podríamos haber empezado por un evento de la entrada, y leído
1094 siguiendo el flujo de información terminando en su caso en el objeto
1095 (u objetos) de la salida.
1097 La referencia del programa también se puede examinar como un documento
1098 normal. Contiene capítulos que tratan de
1100 @rinternals{Music definitions},
1103 @code{Music definitions}
1105 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1106 de los capítulos relaciona todas las definiciones utilizadas y todas
1107 las propiedades que se pueden ajustar.
1110 @node Interfaces de la presentación
1111 @subsection Interfaces de la presentación
1112 @translationof Layout interfaces
1114 @cindex interfaz de la presentación
1115 @cindex presentación, interfaz de la
1118 La página HTML que pudimos ver en la sección anterior describe el
1119 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1120 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1121 números (como grosores y direcciones), pero también punteros a objetos
1122 relacionados. Un objeto de presentación también se llama un
1123 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1124 gráfico). Para ver más detalles acerca de los objetos gráficos o
1125 Grobs, consulte @rinternals{grob-interface}.
1127 La página dedicada a @code{Fingering} relaciona las definiciones del
1128 objeto @code{Fingering}. Por ejemplo, la página dice
1131 @code{padding} (dimensión, en espacios de pentagrama):
1137 lo que significa que el número se mantendrá a una distancia de al
1138 menos 0.5 de la cabeza de la nota.
1141 Cada objeto de presentación puede tener varias funciones como elemento
1142 notacional o tipográfico. Por ejemplo, el objeto de digitación
1143 Fingering tiene los siguientes aspectos
1147 Su tamaño es independiente del espaciado horizontal, al contrario de
1148 las ligaduras o las barras de las figuras.
1151 Es un elemento de texto. Casi seguro que es un texto muy corto.
1154 este elemento de texto se tipografía con un tipo de letra, no como las
1155 ligaduras o las barras de las figuras.
1158 Horizontalmente, el centro del símbolo se debe alinear con el centro
1159 de la cabeza de la nota.
1162 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1165 La posición vertical también está coordinada con otros símbolos de
1166 superíndice y de subíndice.
1169 Cada uno de estos aspectos se capta en lo que se llaman
1170 @emph{interface}s, que se relacionan al final de la página dedicada a
1171 @rinternals{Fingering}
1174 Este objeto contempla los siguientes interfaces:
1175 @rinternals{item-interface},
1176 @rinternals{self-alignment-interface},
1177 @rinternals{side-position-interface}, @rinternals{text-interface},
1178 @rinternals{text-script-interface}, @rinternals{font-interface},
1179 @rinternals{finger-interface} y @rinternals{grob-interface}.
1182 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1183 página del respectivo interfaz del objeto. Cada interfaz tiene un
1184 cierto número de propiedades. Algunas de ellas no son para que el
1185 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1188 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1189 realmente esto no significa mucho. El archivo de inicialización
1190 (véase @rlearning{Otras fuentes de información})
1191 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1196 (avoid-slur . around)
1197 (slur-padding . 0.2)
1198 (staff-padding . 0.5)
1199 (self-alignment-X . 0)
1200 (self-alignment-Y . 0)
1201 (script-priority . 100)
1202 (stencil . ,ly:text-interface::print)
1203 (direction . ,ly:script-interface::calc-direction)
1204 (font-encoding . fetaText)
1205 (font-size . -5) ; don't overlap when next to heads.
1206 (meta . ((class . Item)
1207 (interfaces . (finger-interface
1209 text-script-interface
1211 side-position-interface
1212 self-alignment-interface
1213 item-interface))))))
1217 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1218 de valores de variables, y la página web de la Referencia de
1219 funcionamiento interno se genera directamente a partir de esta
1223 @node Determinar la propiedad del grob
1224 @subsection Determinar la propiedad del grob
1225 @translationof Determining the grob property
1227 Recordemos que queríamos cambiar la posición del @b{2} en
1229 @lilypond[quote,relative=2,verbatim]
1235 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1236 tenemos que negociar con el interfaz asociado con esta colocación.
1237 Esto se hace usando @code{side-position-interface}. La página que
1238 describe este interface dice:
1241 @code{side-position-interface}
1243 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1244 soporte). La propiedad @code{direction} significa dónde poner el
1245 objeto víctima con relación al soporte (¿a la izquierda o a la
1246 derecha, encima o debajo?)
1250 @cindex padding (relleno)
1252 Debajo de esta descripción, la variable @code{padding} (relleno) se
1258 (dimensión, en espacios de pentagrama)
1260 Añadir esta cantidad de espacio adicional entre objetos que están unos
1265 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1266 digitación de la cabeza de la nota. La siguiente orden inserta un
1267 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1270 \once \override Voice.Fingering #'padding = #3
1273 Al insertar esta instrucción antes de que se haya creado el objeto
1274 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1277 @lilypond[quote,relative=2,verbatim]
1278 \once \override Voice.Fingering #'padding = #3
1284 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1285 se puede deducir también a partir de la referencia del programa, ya
1286 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1289 El grabador Fingering_engraver es parte de los contextos: @dots{}
1294 @node Convenciones de nombres
1295 @subsection Convenciones de nombres
1296 @translationof Naming conventions
1298 Se hace necesario presentar una panorámica de las diversas
1299 convenciones de nomenclatura:
1302 @item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
1303 @item funciones de Scheme: ly:más-estilo-de-scheme
1304 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1305 @item interfaces de Grobs: estilo-scheme
1306 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1307 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1308 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1309 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1313 Preguntas aún sin respuesta
1315 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1316 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1321 @node Modificar las propiedades
1322 @section Modificar las propiedades
1323 @translationof Modifying properties
1326 * Panorámica de la modificación de las propiedades::
1327 * La instrucción set::
1328 * La instrucción override::
1329 * La instrucción tweak::
1330 * set frente a override::
1331 * Modificación de las listas-A::
1335 @node Panorámica de la modificación de las propiedades
1336 @subsection Panorámica de la modificación de las propiedades
1337 @translationof Overview of modifying properties
1339 Cada contexto es responsable de la creación de ciertos tipos de
1340 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1341 también se almacenan por contexto. Mediante la modificación de estos
1342 ajustes, se puede alterar la apariencia de los objetos.
1344 Existen dos tipos diferentes de propiedades almacenadas en los
1345 contextos: las propiedades de contexto y las propiedades de grob. Las
1346 propiedades de contexto son propiedades que se aplican al contexto
1347 como un todo y controlan la forma en que el propio contexto se
1348 imprime. Por contra, las propiedades de grob se aplican a los tipos
1349 de grob específicos que se imprimirán dentro del contexto.
1351 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar los
1352 valores de las propiedades de contexto. Las instrucciones
1353 @code{\override} y @code{\revert} se usan para cambiar los valores de
1354 las propiedades de grob.
1357 La sintaxis de esto es
1360 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1363 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1364 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1365 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1366 disposición}). Este último es un símbolo, y por ello debe ir
1367 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1368 explica cómo se deben cumplimentar los conceptos @var{nombre},
1369 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1370 funcionalidad des esta instrucción.
1375 \override Staff.Stem #'thickness = #4.0
1379 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1380 grosor de una línea del pentagrama como unidad). Puesto que la
1381 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1382 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1383 Aquí vemos la instrucción en pleno funcionamiento:
1385 @lilypond[quote,verbatim,relative=2]
1387 \override Staff.Stem #'thickness = #4.0
1393 La instrucción @code{\override} modifica la definición de la plica
1394 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1395 que la instrucción se ha interpretado, todas las plicas se engrosan.
1397 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1398 omitir, ocasionando que se utilice el contexto predeterminado
1399 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1400 solo paso de tiempo.
1402 @lilypond[quote,verbatim,relative=2]
1404 \once \override Stem #'thickness = #4.0
1409 El @code{\override} se debe hacer antes de que el objeto se inicia.
1410 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1411 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1412 en el momento en que se crea el objeto. En este ejemplo:
1414 @lilypond[quote,verbatim,relative=2]
1415 \override Slur #'thickness = #3.0
1417 \override Beam #'beam-thickness = #0.6
1422 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1423 la instrucción para @code{Beam}, la barra, va después de que la barra
1424 se ha iniciado, y por ello no tiene ningún efecto.
1426 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1427 un contexto deshace una instrucción @code{\override}; como con
1428 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1429 del mismo contexto. En otras palabras, el @code{\revert} del
1430 siguiente ejemplo no hace nada.
1433 \override Voice.Stem #'thickness = #4.0
1434 \revert Staff.Stem #'thickness
1437 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1438 dentro de las propiedades normales. Para trucarlas, utilice
1439 instrucciones de la forma
1441 @c leave this as a long long
1443 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1450 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1456 Referencia de funcionamiento interno:
1457 @rinternals{Backend},
1458 @rinternals{All layout objects},
1459 @rinternals{OverrideProperty},
1460 @rinternals{RevertProperty},
1461 @rinternals{PropertySet}.
1464 El «back-end» o motor de salida no es muy estricto en la comprobación
1465 de tipos de las propiedades de objetos. Las referencias cíclicas en
1466 valores Scheme de propiedades pueden producir cuelgues o salidas
1467 abruptas, o las dos cosas.
1470 @node La instrucción set
1471 @subsection La instrucción @code{@bs{}set}
1472 @translationof The set command
1476 @cindex cambiar propiedades
1478 Cada contexto puede tener distintas @emph{propiedades}, variables
1479 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1480 paso de interpretación. Se consigue insertando la instrucción
1481 @code{\set} dentro de la música:
1484 \set @var{contexto}.@var{propiedad} = #@var{valor}
1487 @var{valor} es un objeto de Scheme, razón por la que va precedido del
1488 carácter almohadilla,@tie{}@code{#}.
1490 El nombre de las propiedades de contexto suele ir en minúsculas con
1491 mayúscula en medio. Controlan sobre todo la traducción de la música a
1492 la notación, p.ej. @code{localKeySignature} (para determinar si hay
1493 que impriir alteraciones o no), o @code{measurePosition} (para
1494 determinar cuándo hay que imprimir una línea divisoria). El valor de
1495 las propiedades de contexto puede modifcarse con el tiempo durante la
1496 interpretación de la música; un ejemplo obvio es
1497 @code{measurePosition}. Las propiedades de contexto se modifican
1498 mediante la instrucción @code{\set}.
1500 Por ejemplo, los silencios multicompás se combinan en un solo compás
1501 si el valor de la propiedad de contexto @code{skipBars} se establece a
1502 @code{#t} (verdadero):
1504 @lilypond[quote,verbatim,relative=2]
1506 \set Score.skipBars = ##t
1510 Si se omite el argumento @var{context}, entonces se utiliza el
1511 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1512 @code{Voice} o @code{Lyrics}). En este ejemplo:
1514 @lilypond[quote,verbatim,relative=2]
1515 \set Score.autoBeaming = ##f
1519 \set autoBeaming = ##t
1527 El cambio se aplica @q{al vuelo}, mientras dura la música, de forma
1528 que el ajuste sólo afecta al segundo grupo de corcheas.
1530 Observe que el contexto del nivel más bajo no siempre contiene la
1531 propiedad que querríamos modificar: por ejemplo, intentar ajustar el
1532 valor de la propiedad @code{skipBars} del contexto predeterminado del
1533 nivel más bajo, que en este caso es @code{Voice}, no tendrá ningún
1534 efecto, porque skipBars es una propiedad del contexto @code{Score}.
1536 @lilypond[quote,verbatim,relative=2]
1542 Los contextos son jerárquicos, y si se ha especificado un contexto
1543 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1544 también a todos los contextos @code{Voice} dentro del pentagrama
1549 También existe una instrucción @code{\unset}:
1551 \unset @var{contexto}.@var{propiedad}
1555 que elimina la definición de @var{propiedad}. Esta instrucción
1556 elimina la definición solamente si está establecida dentro de
1557 @var{contexto}. Properties that have been set in enclosing contexts will
1558 not be altered by an unset in an enclosed context:
1560 @lilypond[quote,verbatim,relative=2]
1561 \set Score.autoBeaming = ##t
1566 \unset Score.autoBeaming
1574 Como @code{\set}, el argumento @var{contexto} no se tiene que
1575 especificar para un contexto del nivel más bajo, por lo que los dos
1579 \set Voice.autoBeaming = ##t
1580 \set autoBeaming = ##t
1584 son equivalentes si el contexto inferior en curso es @code{Voice}.
1588 Los ajustes que se aplican solamente a un único paso de tiempo se
1589 pueden escribir con @code{\once}, por ejemplo en
1591 @lilypond[quote,verbatim,relative=2]
1593 \once \set fontSize = #4.7
1598 En el manual de Referencia de funcionamiento interno hay una
1599 descripción completa de todas las propiedades de contexto disponibles,
1602 @rinternals{Tunable context properties}.
1605 Traducción @expansion{} Propiedades de contexto modificables por el
1610 Referencia de funcionamiento interno:
1611 @rinternals{Tunable context properties}.
1613 @cindex grob, propiedades de
1614 @cindex propiedades de grob
1618 @node La instrucción override
1619 @subsection La instrucción @code{\override}
1620 @translationof The override command
1622 Existe un tipo especial de propiedad de contexto: la descripción de
1623 los grobs. Las decscripciones de los grobs reciben un nombre en
1624 @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen los
1625 @q{ajustes predeterminados} para un tipo particular de grob, en forma
1626 de lista asociativa. Consulte @file{scm/define-grobs.scm} para
1627 ver los ajustes de cada descripción de grob. Las descripciones de
1628 grob se modifican con @code{\override}.
1630 @code{\override} es en realidad una forma abreviada;
1633 \override @var{contexto}.@var{NombreDelGrob} #'@var{propiedad} = #@var{valor}
1637 equivale más o menos a
1639 @c leave this long line -gp
1641 \set @var{contexto}.@var{NombreDelGrob} =
1642 #(cons (cons '@var{propiedad} @var{valor})
1643 <valor anterior de @var{contexto}.@var{NombreDelGrob}>)
1646 El valor de @code{contexto}.@code{NombreDelGrob} (la lista-A) se
1647 utiliza para inicializar las propiedades de los grobs individuales.
1648 Los grobs tienen propiedades, denominadas en el estilo de Scheme, con
1649 @code{palabras-con-guiones}. Los valores de las propiedades de grob
1650 cambian durante el proceso de formateo: éste se realiza básicamente
1651 calculando las propiedades utilizando funciones de @q{callback}
1652 (pasadas como parámetro).
1654 Por ejemplo, podemos aumentar el grosor de la plica de una figura
1655 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
1656 @code{Stem} (plica):
1658 @lilypond[quote,verbatim,relative=2]
1660 \override Voice.Stem #'thickness = #3.0
1664 Si no se ha especificado ningún contexto en la instrucción
1665 @code{\override}, se utiliza el contexto del nivel inferior:
1667 @lilypond[quote,verbatim,relative=2]
1668 { \override Staff.Stem #'thickness = #3.0
1672 \override Stem #'thickness = #0.5
1682 @cindex reversión de sobreescrituras
1683 @cindex sobreescrituras, reversión de
1685 El efecto de una instrucción de sobreescritura @code{\override} se
1686 puede deshacer con @code{\revert}:
1688 @lilypond[quote,verbatim,relative=2]
1690 \override Voice.Stem #'thickness = #3.0
1692 \revert Voice.Stem #'thickness
1696 Los efectos de @code{\override} y @code{\revert} se aplican a todos
1697 los grobs del contexto afectado partiendo del momento actual y hacia
1700 @lilypond[quote,verbatim,relative=2]
1705 \override Staff.Stem #'thickness = #3.0
1709 \revert Staff.Stem #'thickness
1717 @cindex sobreescritura para un solo momento
1719 Se puede usar @code{\once} con @code{\override} para afectar solamente
1720 al instante de tiempo actual:
1722 @lilypond[quote,verbatim,relative=2]
1726 \override Stem #'thickness = #3.0
1730 \once \override Stem #'thickness = #3.0
1739 Las instrucciones que modifican la salida tienen por lo general un
1743 \override Voice.Stem #'thickness = #3.0
1747 Para construir este truco debemos determinar los siguientes datos:
1750 @item el contexto: aquí @code{Voice}.
1751 @item el objeto de presentación: aquí @code{Stem}.
1752 @item la propiedad de presentación: aquí @code{thickness}.
1753 @item un valor adecuado: aquí @code{3.0}.
1756 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
1757 en el interior de las propiedades normales. Para modificarlas utilice
1758 instrucciones de la forma
1761 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1764 @cindex documentación interna
1765 @cindex buscar objetos gráficos
1766 @cindex gráficos, descripción de los objetos
1769 @cindex interna, documentación
1771 Para muchas propiedades, independientemente del tipo de datos de la
1772 propiedad, si se establece el valor de la propiedad a falso
1773 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
1774 ignore por completo dicha propiedad. Esto es especialmente útil para
1775 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
1776 causarían problemas.
1778 Mostraremos a continuación cómo localizar esta información en el
1779 manual de notación y en la referencia de funcionamiento interno.
1783 Referencia de funcionamiento interno:
1784 @rinternals{Backend}
1787 @node La instrucción tweak
1788 @subsection La instrucción @code{\tweak}
1789 @translationof The tweak command
1794 El cambio de las propiedades de grob mediante @code{\override} produce
1795 la aplicación del cambio a todos los grobs dados en el contexto en el
1796 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
1797 podemos desear que los cambios se apliquen a un solo grob en lugar de
1798 a todos los grobs del contexto afectado. Esto se consigue con la
1799 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
1802 \tweak @var{objeto-de-presentación} #'@var{propiedad-del-grob} @var{valor}
1805 Es opcional especificar el @var{objeto-de-presentación}. La
1806 instrucción @code{\tweak} se aplica al objeto musical que viene
1807 inmediatamente después de @var{valor} dentro del flujo musical.
1810 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
1811 los objetos gráficos. Para objetos que resultan directamente de un
1812 elemento de código de la entrada, puede usar la función @code{\tweak},
1815 @lilypond[relative=2,verbatim,quote]
1820 \tweak #'duration-log #1
1823 -\tweak #'padding #8
1829 Pero el uso principal de la instrucción @code{\tweak} es modificar
1830 solamente uno de varios elementos de notación que dan comienzo en el
1831 mismo momento musical, como las notas de un acorde, o corchetes de
1832 tresillo que empiezan al mismo tiempo.
1834 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
1835 a continuación de forma directa, sin necesidad de especificar el
1836 nombre del grob o el contexto. Para que esto funcione, es necesario
1837 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
1838 al objeto al que se aplica, después de que el archivo de entrada se ha
1839 convertido en un flujo musical. Con frecuencia no es el caso, pues
1840 muchos elementos adicionales se insertan en la corriente musical de
1841 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
1842 parte de un acorde, LilyPond inserta implícitamente un evento
1843 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
1844 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
1845 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
1846 en el flujo musical, permaneciendo así adyacente a la nota, y con la
1847 posibilidad de modificarla.
1851 @lilypond[relative=2,verbatim,quote]
1852 <\tweak #'color #red c>4
1856 pero esto no funciona:
1858 @lilypond[relative=2,verbatim,quote]
1859 \tweak #'color #red c4
1864 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
1865 consulte @rlearning{Métodos de trucaje}.
1867 Si se colocan varios elementos similares en el mismo momento musical,
1868 la instrucción @code{\override} no se puede usar para modificar uno
1869 solo de ellos: aquí es donde se debe usar la instrucción
1870 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
1871 en el mismo momento musical están los siguientes:
1873 @c TODO expand to include any further uses of \tweak
1875 @item las cabezas de las notas de un acorde
1876 @item signos de articulación sobre la misma nota
1877 @item ligaduras de unión entre notas de un acorde
1878 @item corchetes de grupos especials que comienzan en el mismo momento
1881 @c TODO add examples of these
1883 @cindex acorde, modificación de una nota
1885 En este ejemplo se modifican el color de una cabeza y el tipo de otra,
1886 dentro del mismo acorde:
1888 @lilypond[relative=2,verbatim,quote]
1893 \tweak #'duration-log #1
1898 @code{\tweak} se puede usar para modificar ligaduras de expresión:
1900 @lilypond[verbatim,quote,relative=1]
1901 c-\tweak #'thickness #5 ( d e f)
1905 Para que funcione la instrucción @code{\tweak}, debe permanecer
1906 adyacente al objeto al que se ha de aplicar después de que el código
1907 de entrada se ha convertido a un flujo musical. El trucaje de un
1908 acorde completo no hace nada porque su evento musical actúa solamente
1909 como un contenedor, y todos los objetos de presentación se crean a
1910 partir de eventos dentro del @code{EventChord}:
1912 @lilypond[relative=2,verbatim,quote]
1913 \tweak #'color #red c4
1914 \tweak #'color #red <c e>4
1915 <\tweak #'color #red c e>4
1918 La instrucción @code{\tweak} sencilla no se puede usar para modificar
1919 ningún objeto que no se haya creado directamente a partir de la entrada.
1920 Concretamente, no afecta a las plicas, barras automáticas ni
1921 alteraciones, porque éstos se generan posteriormente por
1922 parte de objetos de presentación @code{NoteHead}
1923 más que por elementos musicales del
1926 Tales objetos de presencaión creados indirectamente se pueden trucar
1927 usando la forma explícita de la instrucción @code{\tweak}:
1929 @lilypond[relative=2,verbatim,quote]
1930 \tweak Stem #'color #red
1931 \tweak Beam #'color #green c8 e
1932 <c e \tweak Accidental #'font-size #-3 ges>4
1935 No se puede usar @code{\tweak} para modificar las claves o las
1936 indicaciones de compás, porque éstos se separan de cualquier
1937 instrucción @code{\tweak} precedente dentro del flujo de entrada
1938 merced a la inserción automática de elementos adicionales que se
1939 requieren para especificar el contexto.
1941 Se pueden colocar varias instrucciones @code{\tweak} antes de un
1942 elemento de notación; todos le afectan:
1944 @lilypond[verbatim,quote,relative=1]
1946 -\tweak #'style #'dashed-line
1947 -\tweak #'dash-fraction #0.2
1948 -\tweak #'thickness #3
1949 -\tweak #'color #red
1954 El flujo musical que se genera a partir de una sección de un archivo
1955 de entrada (incluido cualquier elemento insertado automáticamente)
1956 puede examinarse, véase @rextend{Presentación de las expresiones musicales}.
1957 Esto puede ser de utilidad en la determinación de lo que
1958 puede modificarse por medio de una instrucción @code{\tweak}.
1961 Manual de aprendizaje:
1962 @rlearning{Métodos de trucaje}.
1964 Manual de extensión:
1965 @rextend{Presentación de las expresiones musicales}.
1969 @cindex trucar puntos de control
1970 @cindex control, trucar puntos de
1972 La instrucción @code{\tweak} solamente se aplica a la primera de
1973 varias ligaduras generadas dentro de un acorde.
1976 @node set frente a override
1977 @subsection @code{\set} frente a @code{\override}
1978 @translationof set versus override
1980 @c HACER: probablemente esta sección es innecesaria.
1983 We have seen two methods of changing properties: @code{\set} and
1984 @code{\override}. There are actually two different kinds of
1987 @code{fontSize} is a special property: it is equivalent to
1988 entering @code{\override ... #'font-size} for all pertinent
1989 objects. Since this is a common change, the special
1990 property (modified with @code{\set}) was created.
1995 @node Modificación de las listas-A
1996 @subsection Modificación de las listas-A
1997 @translationof Modifying alists
1999 Ciertas propiedades configurables por parte del usuario se representan
2000 internamente como @emph{listas-A} (listas asociativas), que almacenan
2001 duplas de @emph{claves} y @emph{valores}. La estructura de una
2002 lista-A es la siguiente:
2005 '((@var{clave1} . @var{valor1})
2006 (@var{clave2} . @var{valor2})
2007 (@var{clave3} . @var{valor3})
2011 Si una lista-A es una propiedad de un grob o una variable de
2012 @code{\paper}, sus claves se pueden modificar individualmente sin que
2013 afecte a las otras claves.
2015 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2016 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2017 del grob @code{StaffGrouper}. La propiedad es una lista-A con cuatro
2018 claves: @code{basic-distance} (distancia básica),
2019 @code{minimum-distance} (distancia mínima), @code{padding} (relleno)
2020 y @code{stretchability} (ampliabilidad).
2021 Los ajustes estándar para esta propiedad
2022 se relacionan en la sección
2023 @qq{Backend} de la Referencia de Funcionamiento Interno
2024 (véase @rinternals{StaffGrouper}):
2027 '((basic-distance . 9)
2028 (minimum-distance . 7)
2030 (stretchability . 5))
2033 Una forma de acercar los pentagramas entre sí es reducir el valor de
2034 la clave @code{basic-distance} (@code{9}) para que se corresponda con
2035 el valor de @code{minimum-distance} (@code{7}). Para modificar una
2036 única clave de forma individual, utilice una @emph{declaración
2039 @lilypond[quote,verbatim]
2040 % default space between staves
2042 \new Staff { \clef treble c''1 }
2043 \new Staff { \clef bass c1 }
2046 % reduced space between staves
2047 \new PianoStaff \with {
2048 % this is the nested declaration
2049 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #7
2051 \new Staff { \clef treble c''1 }
2052 \new Staff { \clef bass c1 }
2056 La utilización de una declaración anidada actualiza la clave
2057 especificada (como @code{basic-distance} en el ejemplo anterior)
2059 de las otras claves que ya se habían establecido para la misma
2062 Ahora, supongamos que deseamos que los pentagramas estén tan próximos
2063 como sea posible sin que se superpongan. La manera más sencilla de
2064 hacerlo es establecer las cuatro claves de la lista-A a cero. Sin
2065 embargo, no es necesario escribir cuatro declaraciones anidadas, una
2066 por cada clave. En lugar de eso, se puede redefinir completamente la
2067 propiedad con una sola declaración, como una lista-A:
2069 @lilypond[quote,verbatim]
2070 \new PianoStaff \with {
2071 \override StaffGrouper #'staff-staff-spacing =
2072 #'((basic-distance . 0)
2073 (minimum-distance . 0)
2075 (stretchability . 0))
2077 \new Staff { \clef treble c''1 }
2078 \new Staff { \clef bass c1 }
2082 Observe que cualquier clave que no haya sido relacionada
2083 explícitamente en la definición de la lista-A, será reiniciada a sus
2084 valores @emph{predeterminados si no se han fijado}. En el caso de
2085 @code{staff-staff-spacing}, el valor de cualquier clave no fijada se
2086 reiniciaría a cero (excepto @code{stretchability}, que toma el valor
2087 de @code{basic-distance} si no se fija). Así, las dos declaraciones
2088 siguientes son equivalentes:
2091 \override StaffGrouper #'staff-staff-spacing =
2092 #'((basic-distance . 7))
2094 \override StaffGrouper #'staff-staff-spacing =
2095 #'((basic-distance . 7)
2096 (minimum-distance . 0)
2098 (stretchability . 7))
2101 Una consecuencia de esto (posiblemente no intencionada) es la
2102 eliminación de cualquier valor estándar que se establezca en un
2103 archivo de inicio y que se carga cada vez que se compila un archivo de
2104 entrada. En el ejemplo anterior, los ajustes estándar para
2105 @code{padding} y @code{minimum-distance} (definidos en
2106 @file{scm/define-grobs.scm}) se reinician a sus valores
2107 predeterminados si no se han fijado (cero para las dos claves). La
2108 definición de una propiedad o variable como una lista-A (de cualquier
2109 tamaño) siempre reinicia todos los valores de clave no establecidos a
2110 sus valores predeterminados si no se han fijado. Ano ser que este sea
2111 el resultado deseado, es más seguro actualizar los valores de clave
2112 individualmente con una declaración anidada.
2114 @warning{Las declaraciones anidadas no funcionan para las listas-A de
2115 propiedades de contexto (como @code{beamExceptions},
2116 @code{keySignature}, @code{timeSignatureSettings}, etc.). Estas
2117 propiedades sólo se pueden modificar redefiniéndolas completamente
2121 @node Conceptos y propiedades útiles
2122 @section Conceptos y propiedades útiles
2123 @translationof Useful concepts and properties
2127 * Modos de entrada::
2128 * Dirección y posición::
2129 * Distancias y medidas::
2130 * Propiedades del símbolo del pentagrama::
2131 * Objetos de extensión::
2132 * Visibilidad de los objetos::
2133 * Estilos de línea::
2134 * Rotación de objetos::
2138 @node Modos de entrada
2139 @subsection Modos de entrada
2140 @translationof Input modes
2142 La forma en que se interpreta la notación contenida dentro de un
2143 archivo de entrada, está determinada por el modo de entrada en curso.
2145 @strong{Modo de acordes}
2147 Se activa con la instrucción @code{\chordmode} y produce que la
2148 entrada se interprete con al sintaxis de la notación de acordes, véase
2149 @ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
2152 El modo de acordes se activa también con la instrucción
2153 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
2154 y produce que el código que sigue se interprete con la sintaxis de la
2155 notación de acordes y se imprima como nombres de acorde dentro del
2156 contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
2158 @strong{Modo de percusión}
2160 Se activa con la instrucción @code{\drummode} y produce que el código
2161 de entrada se interprete con la sintaxis de la notación de percusión,
2162 véase @ref{Notación básica de percusión}.
2164 El modo de percusión también se activa con la instrucción
2165 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
2166 que el código que sigue se interprete con la sintaxis de la notación
2167 de percusión y se imprima como símbolos de percusión sobre un
2168 pentagrama de percusión, véase @ref{Notación básica de percusión}.
2170 @strong{Modo de cifras}
2172 Se activa con la instrucción @code{\figuremode} y hace que el código
2173 de entrada se interprete con la sintaxis del bajo cifrado, véase
2174 @ref{Introducir el bajo cifrado}.
2176 El modo de cifrase también se activa con la instrucción
2177 @code{\figures}. También crea un contexto de @code{FiguredBass} nuevo
2178 y hace que el código que viene a continuación se interprete con la
2179 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
2180 dentro del contexto @code{FiguredBass}, véase @ref{Introducción al bajo cifrado}.
2182 @strong{Modos de traste y tablatura}
2184 No existen modos de entrada especiales para introducir símbolos de
2185 trastes y de tablatura.
2187 Para crear diagramas de trastes, escriba las notas o acordes en el
2188 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2189 véase @ref{Tablaturas predeterminadas}.
2191 Para crear diagramas de trastes encima de un pentagrama, escríbalos
2192 como elementos de marcado encima de las notas utilizando la
2193 instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
2195 @strong{Modo de letra}
2197 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
2198 se interprete como sílabas de la letra de la canción con duraciones
2199 opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
2201 El modo de letra también se habilita con la instrucción
2202 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
2203 y una instrucción @code{\lyricsto} implícita que asocia la letra que
2204 viene a continuación con la música precedente.
2206 @strong{Modo de marcado}
2208 Se activa con la instrucción @code{\markup}, y hace que la entrada se
2209 interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
2211 @c silly work-around for texinfo broken-ness
2212 @c (@strong{Note...} causes a spurious cross-reference in Info)
2215 Es el modo predeterminado o se puede activar con la instrucción
2216 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
2217 marcado, etc. y se imprime como notación musical sobre un pentagrama.
2219 Normalmente no es necesario especificar el modo de notas de forma
2220 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2221 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2222 otro modo y queremos insertar algo que solamente se puede hacer con la
2223 sintaxis del modo de notas.
2225 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
2226 una pieza coral es necesario entrar en el modo de notas para poder
2227 interpretar dichas indicaciones:
2229 @lilypond[verbatim,relative=2,quote]
2232 \notemode{\set stanza = \markup{ \dynamic f 1. } }
2236 \notemode{\set stanza = \markup{ \dynamic p 2. } }
2242 @node Dirección y posición
2243 @subsection Dirección y posición
2244 @translationof Direction and placement
2246 Al tipografiar música, la dirección y colocación de muchos elementos
2247 es cuestión de elección. Por ejemplo, las plicas de las notas se
2248 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
2249 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
2250 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
2251 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
2252 LilyPond las determine automáticamente, pero en ciertos casos puede
2253 ser deseable forzar una dirección o colocación concreta.
2255 @strong{Acciones predeterminadas}
2257 De forma predeterminada algunas direcciones siempre son hacia arriba o
2258 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
2259 otras cosas pueden alternar entre arriba y abajo en función de la
2260 dirección de las plicas (como las ligaduras o los acentos).
2262 @c TODO Add table showing these
2264 Se puede sobreescribir la acción predeterminada mediante el prefijado
2265 de la articulación por un @emph{indicacor de dirección}. Están
2266 disponibles tres indicadores de dirección: @code{^} (que significa
2267 @qq{arriba}), @code{_} (que significa @qq{abajo}) o @code{-} (que
2268 significa @qq{usar la dirección predeterminada}). El indicador de
2269 dirección se puede normalmente omitir, en cuyo caso se supone el
2270 indicador predeterminado @code{-}, pero se necesita un indicador de
2271 dirección @strong{siempre} antes de:
2274 @item las instrucciones @code{\tweak}
2275 @item las instrucciones @code{\markup}
2276 @item las instrucciones @code{\tag}
2277 @item los marcados de cadena, p.ej. -"cadena"
2278 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2279 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2282 Estas indicaciones afectan sólo a la nota siguiente.
2284 @lilypond[verbatim,quote,relative=2]
2291 @strong{La propiedad de dirección}
2293 La posición o dirección de muchos objetos de presentación está
2294 controlada por la propiedad @code{direction}.
2296 El valor de la propiedad @code{direction} se puede establecer al valor
2297 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
2298 @w{@code{-1}}, con el significado de @qq{hacia abajo} o @qq{debajo}.
2299 Se pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
2300 @code{1} y @w{@code{-1}} respectivamente. La dirección predeterminada
2301 se puede especificar estableciendo @code{direction} a @code{0} ó a
2302 @code{CENTER}. De forma alternativa, en muchos casos existen
2303 instrucciones predefinidas para especificar la dirección. Todas ellas
2307 @code{\xxxUp}, @code{\xxxDown} o @code{\xxxNeutral}
2311 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
2312 predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
2314 En alguna que otra ocasión como en el arpegio, el
2315 valor de la propiedad @code{direction} puede especificar si el objeto se debe
2316 colocar a la izquierda o a la derecha del objeto padre. En este caso
2317 @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y @code{1}
2318 ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
2319 significan @qq{utilizar la dirección predeterminada}.
2321 Estas indicaciones afectan a todas las notas hasta que son canceladas.
2323 @lilypond[verbatim,quote,relative=2]
2332 En música polifónica, en general es mejor especificar una voz explícita
2333 que cambiar la dirección de un objeto. Para ver más información,
2334 véase @ref{Varias voces}.
2337 Manual de aprendizaje:
2338 @rlearning{Objetos interiores al pentagrama}.
2340 Referencia de la notación:
2344 @node Distancias y medidas
2345 @subsection Distancias y medidas
2346 @translationof Distances and measurements
2348 @cindex distancias absolutas
2349 @cindex distancias escaladas
2356 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
2358 Las distancias absolutas se usan para especificar márgenes, sangrados
2359 y otros detalles de diseño de página, y de forma predeterminada se
2360 especifican en milímetros. Las distancias se pueden especificar en
2361 otras unidades escribiendo después de la cifra indicativa de la
2362 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
2363 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
2364 de página se pueden especificar también en unidades escalables (véase
2365 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
2366 La disposición de página se describe en detalle en
2367 @ref{Disposición de la página}.
2369 Las distancias escaladas siempre se especifican en unidades de un
2370 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
2371 El espacio de pentagrama es la distancia entre dos líneas del
2372 pentagrama adyacentes. El valor predeterminado se puede cambiar
2373 globalmente fijando el tamaño global del pentagrama, o se puede
2374 sobreescribir localmente cambiando la propiedad @code{staff-space} del
2375 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
2376 automáticamente con cualquier cambio al tamaño global del pentagrama o
2377 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
2378 las fuentes tipográficas se escalan solamente con los cambios
2379 efectuados al tamaño global del pentagrama. Así, el tamaño global del
2380 pentagrama posibilita la fácil variación del tamaño general de una
2381 partitura impresa. Para ver los métodos de establecimiento del tamaño
2382 global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2386 Si se necesita dibujar sólo una sección de una partitura a una escala
2387 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2388 simplemente cambiar el tamaño global del pentagrama porque esto
2389 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2390 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2391 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2392 nuestra disposición una función de Scheme, @code{magstep}, para
2393 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2394 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2395 utilización, consulte @rlearning{Longitud y grosor de los objetos}.
2398 Manual de aprendizaje:
2399 @rlearning{Longitud y grosor de los objetos}.
2401 Referencia de la notación:
2402 @ref{Disposición de la página},
2403 @ref{Establecer el tamaño del pentagrama}.
2406 @node Propiedades del símbolo del pentagrama
2407 @subsection Propiedades del símbolo del pentagrama
2408 @translationof Staff symbol properties
2410 @cindex ajuste del símbolo del pentagrama
2411 @cindex dibujar el símbolo del pentagrama
2412 @cindex pentagrama, establecer el símbolo del
2414 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2415 @c Need to think of uses for these properties. Eg 'line-positions
2416 @c is used in a snippet to thicken centre line.
2417 @c If retained, add @ref to here in 1.6.2 -td
2419 Se puede definir al mismo tiempo la posición vertical de las líneas de
2420 la pauta y el número de líneas de la misma. Como muestra el siguiente
2421 ejemplo, las posiciones de las notas no están influidas por las
2422 posiciones de las líneas de la pauta.
2424 @warning{La propiedad @code{'line-positions} sobreescribe a la
2425 propiedad @code{'line-count}. El número de líneas de la pauta está
2426 definido implícitamente por el número de elementos de la lista de
2427 valores de @code{'line-positions}.}
2429 @lilypond[verbatim,quote,relative=1]
2431 \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
2436 Se puede modificar la anchura de la pauta. Las unidades son espacios
2437 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2438 resulta afectado por este ajuste.
2440 @lilypond[verbatim,quote,relative=1]
2442 \override StaffSymbol #'width = #23
2448 @node Objetos de extensión
2449 @subsection Objetos de extensión
2450 @translationof Spanners
2452 Muchos objetos de notación musical abarcan varias notas o incluso
2453 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2454 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2455 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2456 especiales para controlar su apariencia y comportamiento. Algunas de
2457 estas propiedades son comunes a todos los objetos de extensión; otras
2458 se limitan a un subconjunto de los extensores.
2460 Todos los objetos de extensión contemplan el interface
2461 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2462 una línea recta entre los dos objetos, contemplan también el interface
2463 @code{line-spanner-interface}.
2465 @unnumberedsubsubsec Uso del @code{spanner-interface}
2467 Este interface proporciona dos propiedades que se aplican a varios
2470 @strong{@i{La propiedad @code{minimum-length}}}
2472 La longitud mínima del objeto de extensión se especifica a través de
2473 la propiedad @code{minimum-length}. Su aumento suele producir el
2474 efecto necesario de aumentar el espaciado de las notas entre los dos
2475 puntos extremos. Sin embargo, esta sobreescritura no tiene ningún
2476 efecto sobre muchos extensores, pues su longitud está determinada por
2477 otras consideraciones. Más abajo se muestran algunos ejemplos de
2488 Works as long as callback is made:
2492 Works not at all for:
2501 @lilypond[verbatim,quote,relative=2]
2504 % increase the length of the tie
2505 -\tweak #'minimum-length #5
2509 @lilypond[verbatim,quote,relative=2]
2511 \compressFullBarRests
2513 % increase the length of the rest bar
2514 \once \override MultiMeasureRest #'minimum-length = #20
2519 @lilypond[verbatim,quote,relative=2]
2521 % increase the length of the hairpin
2522 \override Hairpin #'minimum-length = #20
2526 Esta sobreescritura se puede usar también para aumentar la longitud de
2527 las ligaduras de expresión y de fraseo:
2529 @lilypond[verbatim,quote,relative=2]
2532 -\tweak #'minimum-length #5
2537 -\tweak #'minimum-length #5
2541 Para algunos objetos de presentación, la propiedad
2542 @code{minimum-length} es efectiva sólo si se llama explícitamente al
2543 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
2544 propiedad @code{springs-and-rods} al valor
2545 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
2546 de un glissando no tiene efecto a no ser que se establezca la
2547 propiedad @code{springs-and-rods}:
2549 @lilypond[verbatim,quote,relative=1]
2553 % not effective alone
2554 \once \override Glissando #'minimum-length = #20
2557 % effective only when both overrides are present
2558 \once \override Glissando #'minimum-length = #20
2559 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
2563 Lo mismo se puede decir del objeto @code{Beam}:
2565 @lilypond[verbatim,quote,relative=1]
2566 % not effective alone
2567 \once \override Beam #'minimum-length = #20
2570 % effective only when both overrides are present
2571 \once \override Beam #'minimum-length = #20
2572 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2576 @strong{@i{The @code{to-barline} property}}
2578 La segunda propiedad útil del @code{spanner-interface} es
2579 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2580 haciendo que los reguladores y otros objetos de extensión que terminan
2581 sobre la primera nota de un compás, en vez de eso terminen en la línea
2582 divisoria inmediatamente precedente. Si se establece al valor falso,
2583 el extensor llegará más allá de la barra de compás y terminará
2584 exactamente sobre la nota:
2586 @lilypond[verbatim,quote,relative=2]
2587 a \< a a a a \! a a a \break
2588 \override Hairpin #'to-barline = ##f
2589 a \< a a a a \! a a a
2592 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
2593 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2594 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2595 que terminar en la barra de compás no tendría ningún significado.
2597 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
2599 Entre los objetos que contemplan el interface
2600 @code{line-spanner-interface} se encuentran
2603 @item @code{DynamicTextSpanner}
2604 @item @code{Glissando}
2605 @item @code{TextSpanner}
2606 @item @code{TrillSpanner}
2607 @item @code{VoiceFollower}
2610 La rutina responsable de dibujar los sellos de estos extensores es
2611 @code{ly:line-interface::print}. esta rutina determina la
2612 localización exacta de los dos puntos extremos y traza una línea entre
2613 ellos, en el estilo solicitado. Las posiciones de los dos puntos
2614 extremos del extensor se calculan al vuelo, pero es posible
2615 sobreescribir sus coordenadas Y. Las propiedades que se deben
2616 especificar están anidadas a dos niveles de profundidad en la
2617 jerarquía de propiedades, pero la sintaxis de la instrucción
2618 @code{\override} es bastante sencilla:
2620 @lilypond[relative=2,quote,verbatim]
2622 \once \override Glissando #'(bound-details left Y) = #3
2623 \once \override Glissando #'(bound-details right Y) = #-2
2627 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2628 siendo el punto del cero la línea central del pentagrama. Para el
2629 glissando, esto es el valor de @code{Y} en la coordenada X que
2630 corresponde al punto central de cada cabeza de nota si nos imaginamos
2631 que la línea se extiende hasta allí.
2633 Si no está fijado @code{Y}, su valor se calcula a partir de la
2634 posición vertical del punto de anclaje correspondiente del extensor.
2636 En caso de salto de línea, los valores para los puntos extremos se
2637 especifican por las sub-listas @code{left-broken} y
2638 @code{right-broken} de @code{bound-details}. Por ejemplo:
2640 @lilypond[relative=2,ragged-right,verbatim,quote]
2641 \override Glissando #'breakable = ##t
2642 \override Glissando #'(bound-details right-broken Y) = #-3
2643 c1 \glissando \break
2647 Un número de propiedades adicionales de las sub-listas @code{left} y
2648 @code{right} de la propiedad @code{bound-details} se pueden
2649 especificar de la misma forma que @code{Y}:
2653 Establece la coordenada Y del punto extremo, en desplazamientos de
2654 @code{staff-space}s desde la línea central del pentagrama. De forma
2655 predeterminada es el centro del objeto ancla, y así un glissando
2656 apunta al centro vertical de la cabeza de la nota.
2658 Para extensores horizontales como los extensores de texto y los
2659 trinos, está inamoviblemente codificado como 0.
2661 @item attach-dir (dirección de anclaje)
2662 Determina dónde comienza y termina la línea en la dirección X, con
2663 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o @code{LEFT},
2664 izquierda) hace que la línea comience o termine en el lado izquierdo
2665 de la cabeza de la nota a la que está anclado.
2668 Es la coordenada X absoluta del punto extremo. Se suele calcular al
2669 vuelo, y su sobreescritura no tiene un efecto útil.
2671 @item stencil (sello)
2672 Los extensores de línea pueden tener símbolos al comienzo o al final,
2673 lo que está contenido en esta sub-propiedad. Esto es para uso
2674 interno; se recomienda en su lugar el uso de @code{text}.
2677 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
2678 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2679 de extensión horizontales.
2681 @lilypond[quote,ragged-right,relative=2,verbatim]
2682 \override TextSpanner #'(bound-details left text)
2683 = \markup { \small \bold Slower }
2684 c2\startTextSpan b c a\stopTextSpan
2687 @item stencil-align-dir-y (alineación del sello en y)
2688 @item stencil-offset (desplazamiento del sello)
2689 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2690 punto extremo, centrado sobre la línea, como viene definido por las
2691 subpropiedades @code{X} e @code{Y}. Si se fijan
2692 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2693 símbolo del borde verticalmente con relación al extremo de la línea:
2695 @lilypond[relative=1,quote,verbatim]
2696 \override TextSpanner
2697 #'(bound-details left stencil-align-dir-y) = #-2
2698 \override TextSpanner
2699 #'(bound-details right stencil-align-dir-y) = #UP
2701 \override TextSpanner
2702 #'(bound-details left text) = #"ggg"
2703 \override TextSpanner
2704 #'(bound-details right text) = #"hhh"
2705 c4^\startTextSpan c c c \stopTextSpan
2708 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2709 al contrario de lo que podría esperarse, pues el valor de @w{@code{-1}} o
2710 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
2711 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
2712 (arriba) alinea el borde superior del texto con la línea extensora.
2714 @item arrow (flecha)
2715 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
2716 flecha en el extremo de la línea.
2718 @item padding (relleno)
2719 Esta sub-propiedad controla el espacio entre el punto extremo
2720 especificado de la línea y el extremo real. Sin relleno, un glissando
2721 empezaría y terminaría en el centro de la cabeza de las notas.
2725 La función musical @code{\endSpanners} finaliza de forma prematura el
2726 extensor que comienza sobre la nota que sigue inmediatamente a
2727 continuación. Se termina después de una nota exactamente, o en la
2728 siguiente barra de compás si @code{to-barline} es verdadero y se
2729 produce una divisoria antes de la siguiente nota.
2731 @lilypond[verbatim,quote,ragged-right,relative=2]
2733 c2 \startTextSpan c2 c2
2738 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
2739 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
2742 Referencia de funcionamiento interno:
2743 @rinternals{TextSpanner},
2744 @rinternals{Glissando},
2745 @rinternals{VoiceFollower},
2746 @rinternals{TrillSpanner},
2747 @rinternals{line-spanner-interface}.
2750 @node Visibilidad de los objetos
2751 @subsection Visibilidad de los objetos
2752 @translationof Visibility of objects
2754 @cindex objetos, visibilidad de
2755 @cindex grobs, visibilidad de
2756 @cindex visibilidad de los objetos
2758 Hay cuatro formas principales en que se puede controlar la visibilidad
2759 de los objetos de presentación: se puede eliminar su sello, se pueden
2760 volver transparentes, se pueden pintar de blanco, o se puede
2761 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
2762 se aplican a todos los objetos de presentación; la última sólo a unos
2763 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
2764 introduce estas cuatro técnicas,
2765 véase @rlearning{Visibilidad y color de los objetos}.
2767 Hay también algunas otras técnicas que son específicas de ciertos
2768 objetos de presentación. Se estudian bajo Consideraciones especiales.
2771 * Eliminar el sello::
2772 * Hacer transparentes los objetos::
2773 * Pintar los objetos de blanco::
2774 * Uso de break-visibility (visibilidad en el salto)::
2775 * Consideraciones especiales::
2779 @node Eliminar el sello
2780 @unnumberedsubsubsec Eliminar el sello
2781 @translationof Removing the stencil
2783 @cindex sello, eliminar
2785 Todo objeto de presentación tiene una propiedad stencil (sello). De
2786 forma predeterminada está establecida a la función específica que
2787 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
2788 se llama a ninguna función y el objeto no se dibuja. La acción
2789 predeterminada se puede recuperar con @code{\revert}.
2791 @lilypond[quote,verbatim,relative=1]
2793 \override Score.BarLine #'stencil = ##f
2795 \revert Score.BarLine #'stencil
2800 @node Hacer transparentes los objetos
2801 @unnumberedsubsubsec Hacer transparentes los objetos
2802 @translationof Making objects transparent
2804 @cindex transparentes, hacer los objetos
2806 Todo objeto de presentación tiene una propiedad transparent
2807 (transparente) que de forma predeterminada está establecida a
2808 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
2811 @lilypond[quote,verbatim,relative=2]
2813 \once \override NoteHead #'transparent = ##t
2818 @node Pintar los objetos de blanco
2819 @unnumberedsubsubsec Pintar los objetos de blanco
2820 @translationof Painting objects white
2822 @cindex objetos, coloreado de
2823 @cindex coloreado de objetos
2825 @cindex impresión, orden de
2826 @cindex sobreescritura de objetos
2827 @cindex objetos, sobreescritura de
2828 @cindex grobs, sobreescritura de
2830 Todo objeto de presentación tiene una propiedad de color que de forma
2831 predeterminada está establecida a @code{black} (negro). Si se
2832 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
2833 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
2834 color de los puntos de cruce queda determinado por el orden en que se
2835 dibujan estos objetos, lo que puede dejar una imagen fantasma del
2836 objeto blanco, como puede verse aquí:
2838 @lilypond[quote,verbatim,relative=2]
2839 \override Staff.Clef #'color = #white
2843 Se puede evitar esto cambiando el orden de impresión de los objetos.
2844 Todos los objetos de presentación tienen una propiedad @code{layer}
2845 (capa) que se debe establecer a un valor entero. Los objetos con el
2846 valor de @code{layer} más bajo se dibujan primero, después se dibujan
2847 los objetos con valores progresivamente mayores, y así los objetos con
2848 valores más altos se dibujan encima de los que tienen valores más
2849 bajos. De forma predeterminada, casi todos los objetos tienen
2850 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
2851 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
2852 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
2853 impresión de los objetos con el mismo valor de @code{layer} es
2856 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
2857 predeterminado de @code{1}, se dibuja después de las líneas del
2858 pentagrama (valor @code{layer} predeterminado de @code{0}),
2859 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
2860 @code{Clef} un valor de @code{layer} más bajo, digamos @w{@code{-1}},
2861 para que se dibuje antes:
2863 @lilypond[quote,verbatim,relative=2]
2864 \override Staff.Clef #'color = #white
2865 \override Staff.Clef #'layer = #-1
2870 @node Uso de break-visibility (visibilidad en el salto)
2871 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
2872 @translationof Using break-visibility
2874 @c TODO Add making other objects breakable
2876 @cindex break-visibility
2878 Casi todos los objetos de presentación se imprimen una sola vez, pero
2879 algunos como las líneas divisorias, claves, indicaciones de compás y
2880 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
2881 se produce un salto de línea : una vez al final de la línea y otra al
2882 comienzo de la siguiente. Estos objetos reciben el nombre de
2883 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
2884 (visibilidad en el salto), para controlar su visibilidad en las tres
2885 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
2886 la línea si se produce un cambio, y al final de la línea si el cambio
2887 se produce en ese lugar.
2889 Por ejemplo, la indicación de compás se imprime de forma
2890 predeterminada al comienzo de la primera línea y en ningún otro lugar
2891 a no ser que cambie, en cuyo caso se imprime en el punto en que se
2892 produce el cambio. Si este cambio se produce al final de una línea,
2893 la nueva indicación de compás se imprime al principio de la línea
2894 siguiente y también al final de la línea anterior como indicación de
2897 Este comportamiento se controla por medio de la propiedad
2898 @code{break-visibility}, que se explica en
2899 @c Leave this ref on a newline - formats incorrectly otherwise -td
2900 @rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
2901 vector de tres valores booleanos que, por orden, determinan si el
2902 objeto se imprime al final, dentro, o al principio de la línea. O,
2903 para ser más exactos: antes del salto de línea, si no hay salto, o
2906 Como alternativa se puede especificar cualquiera de las ocho
2907 combinaciones mediante funciones predefinidas cuya definición está en
2908 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
2909 los objetos de presentación serán visibles en las posiciones que se
2910 muestran en el encabezamiento de cada columna:
2912 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {yes} {yes} {yes}
2913 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
2914 @headitem de función @tab de vector @tab salto @tab salto @tab salto
2916 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
2917 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
2918 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
2919 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
2920 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
2921 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
2922 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
2923 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
2926 Los ajustes predeterminados de @code{break-visibility} dependen del
2927 objeto de presentación. La tabla siguiente muestra todos los objetos
2928 de presentación de interés que resultan afectados por
2929 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
2931 @multitable @columnfractions .3 .3 .4
2933 @headitem Objeto @tab Contexto usual @tab Valor predet.
2935 @c omit Ambitus as it appears not to be affected by break-visibility -td
2936 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
2937 @item @code{BarLine} @tab @code{Score} @tab calculado
2938 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
2939 @c omit the following item until it can be explained -td
2940 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
2941 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2942 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
2943 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
2944 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2945 @c omit KeyCancellation until it can be explained -td
2946 @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible}
2947 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
2948 @c omit LeftEdge until it can be explained -td
2949 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
2950 @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible}
2951 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
2952 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
2956 El ejemplo de abajo muestra el uso de la forma de vector para
2957 controlar la visibilidad de las líneas divisorias:
2959 @lilypond[quote,verbatim,relative=1,ragged-right]
2962 % Remove bar line at the end of the current line
2963 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
2969 Aunque los tres componentes del vector utilizado para sobreescribir
2970 @code{break-visibility} deben estar presentes, no todos son efectivos
2971 para todos los objetos de presentación, y algunas combinaciones pueden
2972 incluso dar errores. Son de aplicación las siguientes limitaciones:
2975 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
2976 @item No se puede imprimir el número de compás al principio de la primera
2977 línea a no ser que su valor establecido sea distinto de 1.
2978 @item Clave: véase más abajo
2979 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
2980 se suprimen por completo. Utilice begin-of line-invisible para
2981 imprimirlas y all-invisible para suprimirlas.
2982 @item Armadura: véase más abajo
2983 @item OctavateEight: véase más abajo
2987 @node Consideraciones especiales
2988 @unnumberedsubsubsec Consideraciones especiales
2989 @translationof Special considerations
2991 @strong{@emph{Visibilidad después de un cambio explícito}}
2993 @cindex armadura, visibilidad después de un cambio explícito
2994 @cindex explicitKeySignatureVisibility
2995 @cindex clave, visibilidad después de un cambio explícito
2996 @cindex explicitClefVisibility
2998 La propiedad @code{break-visibility} controla la visibilidad de las
2999 armaduras y cambios de clave sólo al principio de las líneas, es
3000 decir, después de un salto. No tiene ningún efecto sobre la
3001 visibilidad de la armadura o la clave después de un cambio explícito
3002 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
3003 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
3004 bemol mayor es visible incluso con @code{all-invisible} establecido.
3006 @lilypond[quote,verbatim,relative=1,ragged-right]
3009 % Try to remove all key signatures
3010 \override Staff.KeySignature #'break-visibility = #all-invisible
3018 La visibilidad de estos cambios explícitos de tonalidad y de clave se
3019 controla por medio de las propiedades
3020 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
3021 Son los equivalentes de la propiedad @code{break-visibility} y las dos
3022 toman un vector de tres valores booleanos o las funciones predefinidas
3023 relacionadas anteriormente, exactamente igual que
3024 @code{break-visibility}. Las dos son propiedades del contexto Staff,
3025 no de los propios objetos de presentación, y por tanto se establecen
3026 utilizando la instrucción @code{\set}. Las dos están establecidas de
3027 forma predeterminada al valor @code{all-visible}. Estas propiedades
3028 controlan sólo la visibilidad de las armaduras y las claves que
3029 resultan de los cambios explícitos y no afectan a las armaduras y
3030 tonalidades que están al principio de las líneas; para quitarlas, aún
3031 se debe sobreescribir la propiedad @code{break-visibility} en el
3032 objeto correspondiente.
3034 @lilypond[quote,verbatim,relative=1,ragged-right]
3037 \set Staff.explicitKeySignatureVisibility = #all-invisible
3038 \override Staff.KeySignature #'break-visibility = #all-invisible
3045 @strong{@emph{Visibilidad de las alteraciones de precaución}}
3047 Para eliminar las alteraciones de precaución que se imprimen en un
3048 cambio de tonalidad explícito, establezca la propiedad
3049 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3051 @lilypond[quote,verbatim,relative=1,ragged-right]
3054 \set Staff.explicitKeySignatureVisibility = #all-invisible
3055 \set Staff.printKeyCancellation = ##f
3056 \override Staff.KeySignature #'break-visibility = #all-invisible
3063 Con estas sobreescrituras solamente permanecen las alteraciones
3064 accidentales delante de las notas para indicar el cambio de tonalidad.
3066 @c TODO Add visibility of cautionary accidentals before notes
3068 @strong{@emph{Automatic bars}}
3070 @cindex automaticBars
3071 @cindex líneas divisorias, eliminación
3073 Como caso especial, la impresión de las líneas divisorias también se
3074 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
3075 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
3076 imprimen automáticamente; se deben crear explícitamente con una
3077 instrucción @code{\bar}. A diferencia de la instrucción predefinida
3078 @code{\cadenzaOn}, los compases se siguen contando. La generación de
3079 compases continúa de acuerdo a esta cuenta si esta propiedad se
3080 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
3081 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
3086 @strong{@emph{Octavated clefs}}
3088 @cindex octavadas, visibilidad de las claves
3089 @cindex visibilidad de las claves octavadas
3090 @cindex claves, visibilidad de la octavación
3092 El pequeño símbolo de octava sobre las claves en octava alta o baja se
3093 produce por parte del objeto @code{OctavateEight}. Su visibilidad se
3094 hereda automáticamente de la del objeto @code{Clef}, así que no es
3095 necesario aplicar las sobreescrituras correspondientes
3096 @code{break-visibility} a los objetos
3097 @code{OctavateEight} para suprimir los símbolos de octavación
3098 para las claves invisibles.
3100 Para los cambios de clave explícitos, la propiedad
3101 @code{explicitClefVisibility} controla tanto el símbolo de clave como
3102 el símbolo de octava asociado.
3105 Manual de aprendizaje:
3106 @rlearning{Visibilidad y color de los objetos}
3109 @node Estilos de línea
3110 @subsection Estilos de línea
3111 @translationof Line styles
3113 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3114 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
3115 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
3117 Todos ellos usan las mismas rutinas que el glissando para dibujar los
3118 textos y las líneas, y por ello el ajuste fino de su comportamiento se
3119 hace de la misma manera. Se hace con un spanner (un objeto de
3120 extensión), y la rutina responsable de dibujar los objetos de
3121 extensión es @code{ly:line-interface::print}. Esta rutina determina la
3122 colocación exacta de los dos @i{extremos del objeto de extensión} y
3123 dibuja una línea entre ellos, en el estilo solicitado.
3125 He aquí un ejemplo de los distintos estilos de línea disponibles, y
3126 cómo aplicarles ajustes finos.
3128 @lilypond[relative=2,ragged-right,verbatim,quote]
3130 \once \override Glissando #'style = #'dashed-line
3132 \override Glissando #'style = #'dotted-line
3134 \override Glissando #'style = #'zigzag
3136 \override Glissando #'style = #'trill
3140 Las posiciones de los puntos extremos del objeto de extensión se
3141 computan al vuelo para cada uno de los objetos gráficos, pero es
3142 posible sobreescribirlos:
3145 @lilypond[relative=2,ragged-right,verbatim,quote]
3147 \once \override Glissando #'(bound-details right Y) = #-2
3151 El valor de @code{Y} está establecido a @w{@code{-2}} para el extremo
3152 derecho. El lado izquierdo se puede ajustar de forma similar
3153 especificando @code{left} en vez de @code{right}.
3155 Si no está establecido @code{Y}, el valor se computa a partir de la
3156 posición vertical de los puntos de anclaje izquierdo y derecho del
3159 Son posibles otros ajustes de los extensores, para ver más detalles
3160 consulte @ref{Objetos de extensión}.
3163 @node Rotación de objetos
3164 @subsection Rotación de objetos
3165 @translationof Rotating objects
3167 Tanto los objetos de presentación como los elementos de texto de
3168 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
3169 pero difiere el método de hacerlo.
3172 * Rotación de objetos de presentación::
3173 * Rotación de elementos de marcado::
3176 @node Rotación de objetos de presentación
3177 @unnumberedsubsubsec Rotación de objetos de presentación
3178 @translationof Rotating layout objects
3180 @cindex rotating objects
3181 @cindex objects, rotating
3183 Todos los objetos de presentación que contemplan el interface
3184 @code{grob-interface} se pueden rotar estableciendo su propiedad
3185 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
3186 rotación en sentido antihorario, y las coordenadas x e y del punto con
3187 relación al punto de referencia del objeto, alrededor del que se va a
3188 realizar la rotación. El ángulo de rotación se especifica en grados
3189 y las coordenadas en espacios de pentagrama.
3191 El ángulo de rotación y las coordenadas del punto de rotación se deben
3192 determinar por ensayo y error.
3194 @cindex reguladores en ángulo
3195 @cindex ángulo, reguladores en
3197 Solamente en ciertas ocasiones es útil la rotación de objetos de
3198 presentación; el ejemplo siguiente muestra una situación en que puede
3201 @lilypond[quote,verbatim,relative=1]
3203 \override Hairpin #'rotation = #'(20 -1 0)
3208 @node Rotación de elementos de marcado
3209 @unnumberedsubsubsec Rotación de elementos de marcado
3210 @translationof Rotating markup
3212 Todos los textos de marcado se pueden rotar para que se dispongan en
3213 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
3214 instrucción acepta dos argumentos: el ángulo de rotación en grados en
3215 sentido antihorario, y el texto que rotar. Los límites que ocupa el
3216 texto no se rotan: toman su valor a partir de los extremos de las
3217 coordenadas x e y del texto rotado. En el ejemplo siguiente la
3218 propiedad @code{outside-staff-priority} del texto se establece a
3219 @code{#f} para desactivar la evitación automática de colisiones, lo
3220 que empuja al texto a una posición muy alta.
3222 @lilypond[quote,verbatim,relative=1]
3223 \override TextScript #'outside-staff-priority = ##f
3224 g4^\markup { \rotate #30 "a G" }
3225 b^\markup { \rotate #30 "a B" }
3226 des^\markup { \rotate #30 "a D-Flat" }
3227 fis^\markup { \rotate #30 "an F-Sharp" }
3231 @node Trucos avanzados
3232 @section Trucos avanzados
3233 @translationof Advanced tweaks
3235 Esta sección trata sobre distintos enfoques en la realización de
3236 ajustes finos a la apariencia de la partitura impresa.
3239 * Alineación de objetos::
3240 * Agrupación vertical de objetos gráficos::
3241 * Modificación de los sellos::
3242 * Modificación de las formas::
3243 * Contenedores unpure-pure::
3247 Manual de aprendizaje:
3248 @rlearning{Trucar la salida},
3249 @rlearning{Otras fuentes de información}.
3251 Referencia de la notación:
3252 @ref{Explicación del Manual de referencia de funcionamiento interno},
3253 @ref{Modificar las propiedades}.
3255 Manual de extensión:
3256 @rextend{Interfaces para programadores}.
3259 @file{scm/define-grobs.scm}.
3261 Fragmentos de código:
3262 @rlsr{Tweaks and overrides}.
3264 Referencia de funcionamiento interno:
3265 @rinternals{All layout objects}.
3268 @node Alineación de objetos
3269 @subsection Alineación de objetos
3270 @translationof Aligning objects
3272 Los objetos gráficos que soportan el interface
3273 @code{self-alignment-interface} y/o el @code{side-position-interface}
3274 se pueden alinear contra un objeto colocado previamente, de diversas
3275 maneras. Para ver una lista de estos objetos, consulte
3276 @rinternals{self-alignment-interface} y
3277 @rinternals{side-position-interface}.
3279 Todos los objetos gráficos tienen un punto de referencia, una
3280 extensión horizontal y una extensión vertical. La extensión
3281 horizontal es una pareja de números que dan los desplazamientos a
3282 partir del punto de referencia de los bordes izquierdo y derecho,
3283 siendo negativos los desplazamientos hacia la izquierda. La extensión
3284 vertical es una pareja de números que dan el desplazamiento a partir
3285 del punto de referencia hasta los bordes inferior y superior, siendo
3286 negativos los desplazamientos hacia abajo.
3288 La posición de un objeto sobre el pentagrama viene dada por los
3289 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
3290 valor de @code{X-offset} da el desplazamiento desde la coordenada X
3291 del punto de referencia del objeto padre, y el valor de
3292 @code{Y-offset} da el desplazamiento a partir de la línea central del
3293 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
3294 pueden establecer directamente o se puede dejar que se calculen por
3295 parte de procedimientos para conseguir una alineación con el objeto
3298 @warning{Muchos objetos tienen consideraciones de posicionamiento
3299 especiales que hacen que se ignore o se modifique cualquier ajuste
3300 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
3301 objeto contemple el interface @code{self-alignment-interface}. La
3302 sobreescritura de las propiedades @code{X-offset} ó @code{Y-offset} a
3303 un valor fijo hace que se descarte la respectiva propiedad
3304 @code{self-alignment}.}
3306 Por ejemplo, una alteración accidental se puede reposicionar
3307 verticalmente estableciendo @code{Y-offset} pero los cambios a
3308 @code{X-offset} no tienen ningún efecto.
3310 Las letras de ensayo se pueden alinear con objetos divisibles como
3311 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
3312 propiedades especiales que se encuentran en
3313 @code{break-aligned-interface} para el posicionamiento de las letras
3314 de ensayo sobre dichos objetos.
3317 Referencia de la notación:
3318 @ref{Uso del break-alignable-interface}.
3320 Manual de extensión:
3321 @rextend{Funciones de callback}.
3324 * Establecer directamente X-offset e Y-offset::
3325 * Uso del side-position-interface::
3326 * Uso del self-alignment-interface::
3327 * Uso del break-alignable-interface::
3331 @node Establecer directamente X-offset e Y-offset
3332 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
3333 @translationof Setting X-offset and Y-offset directly
3335 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
3336 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
3337 notas con una digitación en su posición predeterminada y con los
3338 valores @code{X-offset} y @code{Y-offset} modificados.
3340 @lilypond[verbatim,quote,relative=2]
3343 -\tweak #'X-offset #0
3344 -\tweak #'Y-offset #0
3347 -\tweak #'X-offset #-1
3348 -\tweak #'Y-offset #1
3355 @node Uso del side-position-interface
3356 @unnumberedsubsubsec Uso del @code{side-position-interface}
3357 @translationof Using the side-position-interface
3359 Un objeto que contempla el @code{side-position-interface} se puede
3360 colocar junto a su objeto padre de forma que los bordes especificados
3361 de los dos objetos se toquen. El objeto se puede situar encima,
3362 debajo, a la derecha o a la izquierda del objeto padre. El padre no
3363 se puede especificar; viene determinado por el orden de los elementos
3364 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
3365 nota asociada como padre.
3367 Los valores de las propiedades @code{side-axis} y @code{direction}
3368 determinan dónde colocar el objeto, como sigue:
3370 @c TODO add an example of each to the table
3372 @multitable @columnfractions .3 .3 .3
3373 @headitem @code{side-axis} @tab @code{direction} @tab
3374 @headitem propiedad @tab propiedad @tab colocación
3376 @item @code{0} @tab @w{@code{-1}} @tab izquierda
3377 @item @code{0} @tab @code{1} @tab derecha
3378 @item @code{1} @tab @w{@code{-1}} @tab debajo
3379 @item @code{1} @tab @code{1} @tab encima
3383 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
3384 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
3385 procedimiento devuelve el calor correcto de @code{X-offset} para
3386 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
3387 el valor de @code{direction}.
3389 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
3390 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
3391 procedimiento devuelve el valor correcto de @code{Y-offset} para
3392 situar el objeto encima o debajo del padre de acuerdo con el valor de
3395 @c TODO Add examples
3398 @node Uso del self-alignment-interface
3399 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
3400 @translationof Using the self-alignment-interface
3402 @emph{Auto-alineación horizontal de los objetos}
3404 La alineación horizontal de un objeto que contempla el interface
3405 @code{self-alignment-interface} está controlada por el valor de la
3406 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
3407 @code{X-offset} de este objeto esté establecida a
3408 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
3409 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
3410 mitad de la extensión X total del objeto. Los valores negativos
3411 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
3412 valor de @code{0} centra el objeto sobre el punto de referencia de su
3413 padre, un valor de @w{@code{-1}} alinea el borde izquierdo del objeto
3414 sobre el punto de referencia de su padre, y un valor de @code{1}
3415 alinea el borde derecho del objeto sobre el punto de referencia de su
3416 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
3417 @code{RIGHT} en sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
3420 Normalmente se usaría la instrucción @code{\override} para modificar
3421 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
3422 @code{\tweak} para alinear varias anotaciones por separado sobre una
3425 @lilypond[quote,verbatim,relative=1]
3427 -\tweak #'self-alignment-X #-1
3429 -\tweak #'self-alignment-X #0
3431 -\tweak #'self-alignment-X #RIGHT
3433 -\tweak #'self-alignment-X #-2.5
3434 ^"aligned further to the right"
3437 @emph{Auto-alineación vertical de los objetos}
3439 Los objetos se pueden alinear verticalmente en una forma análoga a la
3440 alineación horizontal si la propiedad @code{Y-offset} está establecida
3441 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
3442 a menudo se encuentran implicados otros mecanismos en la alineación
3443 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
3444 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
3445 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
3446 las dimensiones verticales del objeto, que suele ser bastante pequeño,
3447 por lo que pueden requerirse números bastante grandes. Un valor de
3448 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
3449 referencia del objeto padre, un valor de @code{0} alinea el centro del
3450 objeto con el punto de referencia del padre, y un valor de @code{1}
3451 alinea el borde superior del objeto con el punto de referencia del
3452 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
3453 @code{UP} en sustitución de @w{@code{-1}},
3454 @code{0} y @code{1}, respectivamente.
3456 @emph{Auto-alineación de objetos en las dos direcciones}
3458 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
3459 alinear un objeto en las dos direcciones simultáneamente.
3461 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
3462 se acerque a la cabeza de la nota.
3464 @lilypond[quote,verbatim,relative=2]
3466 -\tweak #'self-alignment-X #0.5 % move horizontally left
3467 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
3468 -\tweak #'self-alignment-Y #-1 % move vertically up
3473 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
3475 @c Cannot document as they do not seem to operate consistently on all objects -td
3476 @c TODO investigate further
3478 The @code{aligned-on-parent} procedures are used in the same way
3479 as the @code{aligned-on-self} procedures, they difference being
3480 that they permit an object to be aligned with the @emph{edges} of
3481 the parent rather than the parent's reference point. The following
3482 example shows the difference:
3486 @lilypond[verbatim,quote]
3492 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
3494 @c Cannot document as they do not seem to operate consistently on all objects -td
3495 @c TODO investigate further
3499 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
3502 @node Uso del break-alignable-interface
3503 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
3504 @translationof Using the break-alignable-interface
3506 @cindex alineación a objetos
3507 @cindex break-align-symbols
3509 Las letras de ensayo se pueden alinear con objetos de notación
3510 distintos a las barras de compás. Estos objetos son @code{ambitus},
3511 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
3512 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
3513 @code{time-signature}.
3515 De forma predeterminada, las letras de ensayo y los números de compás
3516 se centran horizontalmente sobre el objeto:
3518 @lilypond[verbatim,quote,relative=1]
3519 % The rehearsal mark will be centered above the Clef
3520 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
3525 % The rehearsal mark will be centered above the Time Signature
3526 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
3532 % The rehearsal mark will be centered above the Breath Mark
3533 \override Score.RehearsalMark #'break-align-symbols = #'(breathing-sign)
3542 Se puede especificar una lista de posibles objetos para la alineación.
3543 Si algunos de los objetos son invisibles en ese punto debido al valor
3544 de @code{break-visibility} o a valores de visibilidad explícitos para
3545 las armaduras y las claves, la letra de ensayo o número de compás se
3546 alinean con el primer objeto de la lista que sea visible. Si ningún
3547 objeto de la lista es visible, el objeto se alinea con la línea
3548 divisoria. Si la línea divisoria es invisible, el objeto se alinea
3549 con el punto en el que se encontraría la línea divisoria.
3551 @lilypond[verbatim,quote,relative=1]
3552 % The rehearsal mark will be centered above the Key Signature
3553 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3558 % The rehearsal mark will be centered above the Clef
3559 \set Staff.explicitKeySignatureVisibility = #all-invisible
3560 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3565 % The rehearsal mark will be centered above the Bar Line
3566 \set Staff.explicitKeySignatureVisibility = #all-invisible
3567 \set Staff.explicitClefVisibility = #all-invisible
3568 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3575 La alineación de la letra de ensayo con relación al objeto de notación
3576 se puede cambiar, como se ve en el ejemplo siguiente. En una
3577 partitura con varios pentagramas, este ajuste se debe hacer para todos
3580 @lilypond[verbatim,quote,relative=1]
3581 % The RehearsalMark will be centered above the Key Signature
3582 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3588 % The RehearsalMark will be aligned with the left edge of the Key Signature
3589 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
3593 % The RehearsalMark will be aligned with the right edge of the Key Signature
3594 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
3600 La letra de ensayo también se puede desplazar al borde derecho o
3601 izquierdo en una medida arbitraria. Las unidades son espacios de
3604 @lilypond[verbatim,quote,relative=1]
3605 % The RehearsalMark will be aligned with the left edge of the Key Signature
3606 % and then shifted right by 3.5 staff-spaces
3607 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3608 \once \override Score.KeySignature #'break-align-anchor = #3.5
3612 % The RehearsalMark will be aligned with the left edge of the Key Signature
3613 % and then shifted left by 2 staff-spaces
3614 \once \override Score.KeySignature #'break-align-anchor = #-2
3621 @node Agrupación vertical de objetos gráficos
3622 @subsection Agrupación vertical de objetos gráficos
3623 @translationof Vertical grouping of grobs
3625 @c TODO Expand this section
3627 Los grobs (objetos gráficos) @code{VerticalAlignment} y
3628 @code{VerticalAxisGroup} trabajan de manera coordinada.
3629 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
3630 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
3631 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
3632 Normalmente sólo existe un @code{VerticalAlignment} por cada
3633 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
3634 @code{VerticalAxisGroup}.
3637 @node Modificación de los sellos
3638 @subsection Modificación de los sellos
3639 @translationof Modifying stencils
3641 Todos los objetos de presentación tienen una propiedad @code{stencil}
3642 que es parte del @code{grob-interface}. De forma predeterminada, esta
3643 propiedad suele estar establecida a una función específica del objeto
3644 que está hecha a medida para disponer el símbolo que lo representa en
3645 la salida. Por ejemplo, el ajuste estándar para la propiedad
3646 @code{stencil} del objeto @code{MultiMeasureRest} es
3647 @code{ly:multi-measure-rest::print}.
3649 El símbolo estándar de cualquier objeto se puede sustituir modificando
3650 la propiedad @code{stencil} para que haga referencia a un
3651 procedimiento diferente escrito especialmente. Esto requiere un alto
3652 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3653 una forma más fácil que a menudo puede dar resultados adecuados.
3655 El procedimiento es establecer la propiedad @code{stencil} al
3656 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3657 añadir una propiedad @code{text} al objeto ajustada para que contenga
3658 el texto de marcado que produce el símbolo requerido. Debido a la
3659 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3660 particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
3662 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3663 la nota a unas aspas dentro de una circunferencia.
3665 @lilypond[verbatim,quote]
3667 \once \override NoteHead #'stencil = #ly:text-interface::print
3668 \once \override NoteHead #'text = \markup {
3670 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3671 \musicglyph #"noteheads.s2cross"
3679 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3680 a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
3682 @c TODO Add inserting eps files or ref to later
3684 @c TODO Add inserting Postscript or ref to later
3687 Referencia de la notación:
3688 @ref{Notación gráfica dentro de elementos de marcado},
3689 @ref{Formatear el texto},
3690 @ref{Text markup commands},
3691 @ref{La tipografía Feta}.
3694 @node Modificación de las formas
3695 @subsection Modificación de las formas
3696 @translationof Modifying shapes
3699 * Modificación de ligaduras de unión y de expresión::
3703 @node Modificación de ligaduras de unión y de expresión
3704 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
3705 @translationof Modifying ties and slurs
3707 @cindex ligaduras de expresión, modificar
3708 @cindex ligaduras de unión, modificar
3709 @cindex Bézier, curvas de, puntos de control
3710 @cindex puntos de control en curvas de Bézier
3712 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
3713 de Bézier de tercer orden. Si la forma de la ligadura calculada
3714 automáticamente no resulta óptima, se puede modificar su forma
3715 manualmente mediante la especificación explícita de los cuatro puntos
3716 de control necesarios para definir una curva de Bézier de tercer
3719 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
3720 puntos de control. El primer y cuarto puntos de control son
3721 exactamente los puntos extremos de comienzo y de final de la curva.
3722 Los dos puntos de control intermedios definen la forma. Se pueden
3723 encontrar en la web animaciones que muestran cómo se traza la curva,
3724 pero la descripción siguiente puede ser de ayuda. La curva comienza a
3725 partir del primer punto de control dirigiéndose directamente hacia el
3726 segundo, curvándose progresivamente para dirigirse hacia el tercero y
3727 continuando la curva hacia el cuarto, llegando a éste en viaje directo
3728 desde el tercer punto de control. La curva está contenida enteramente
3729 dentro del cuadrilátero definido por los cuatro puntos de control.
3731 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
3732 @code{\tieDown} no sirve de ayuda.
3734 @lilypond[verbatim,quote,relative=1]
3738 { r4 <g c,> <g c,> <g c,> }
3742 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
3743 de control como sigue.
3745 Las coordenadas de los puntos de control de Bézier se especifican en
3746 unidades de espacios de pentagrama. La coordenada@tie{}X está en
3747 relación con el punto de referencia de la nota a la que está unida la
3748 ligadura, y la coordenada@tie{}Y está en relación con la línea central
3749 del pentagrama. Las coordenadas se introducen como una lista de
3750 cuatro parejas de números decimales (reales). Un enfoque es estimar
3751 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
3752 los dos puntos intermedios. Los valores óptimos se encuentran por
3755 Es útil recordar que una curva simétrica necesita puntos de control
3756 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
3757 las transformaciones de la curva tales como la traslación, rotación y
3758 escalado se pueden obtener aplicando la misma transformación a los
3759 puntos de control de la curva.
3761 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
3762 satisfactoria. Observe la colocación: debe ir inmediatamente antes de
3763 la nota a la que se asigna el comienzo de la ligadura de expresión o
3766 @lilypond[verbatim,quote,relative=1]
3770 #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
3774 { r4 <g c,> <g c,> <g c,> }
3779 No es posible modificar la forma de las ligaduras de unión o de
3780 expresión cambiando la propiedad @code{control-points} si hay más de
3781 una en el mismo momento musical, ni siquiera usando la instrucción
3782 @code{\tweak}. Sin embargo, se puede sobreescribir la propiedad
3783 @code{tie-configuration} de @code{TieColumn} para fijar la línea de
3784 inicio y la dirección según se requiera.
3787 Referencia de funcionamiento interno:
3788 @rinternals{TieColumn}.
3790 @cindex Scheme, contenedores puros
3791 @cindex Scheme, contenedores no-puros
3792 @cindex puros, contenedores de Scheme
3793 @cindex no-puros: contenedores de Scheme
3794 @cindex horizontal, sobreescribir el espaciado
3797 @node Contenedores unpure-pure
3798 @subsection Contenedores unpure-pure
3799 @translationof Unpure-pure containers
3801 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para la
3802 sobreescritura de los cálculos del espaciado en el @emph{eje Y}
3803 (concretamente @code{Y-offset} e @code{Y-extent}) con una función de
3804 Scheme en lugar de un literal, es decir, un número o una pareja de
3807 Para ciertos objetos gráficos, las dimensiones @code{Y-extent} están
3808 basadas en la propiedad @code{stencil}, la sobreescritura de la
3809 propiedad de sello de éstos requiere una sobreescritura adicional de
3810 @code{Y-extent} con un contenedor unpure-pure. Cuando una función
3811 sobreescribe una dimensión @code{Y-offset} y/o @code{Y-extent} se
3812 supone que esto dispara los cálculos de los saltos de línea
3813 prematuramente durante la compilación. Así pues, la función no se
3814 evalúa en absoluto (devolviendo por lo general un valor de @samp{0} o
3815 @samp{'(0 . 0)}) lo que puede dar lugar a colisiones. Una función
3816 @q{pura} no afecta a las propiedades, objetos o suicidios de grobs, y
3817 por ello siempre ven sus valores relacionados con el eje Y evaluados
3820 Actualmente hay unas treinta funciones que ya se consideran @q{puras}
3821 y los contenedores Unpure-pure son una manera de establecer funciones
3822 que no están en esta lista como @q{puras}. La función @q{pura} se
3823 evalúa @emph{antes} de cualquier salto de línea y así el espaciado
3824 horizontal se puede ajustar @q{a tiempo}. La función @q{impura} se
3825 evalúa entonces @emph{después} del salto de línea.
3827 @warning{Dado que es difícil saber siempre qué funciones están en esta
3828 lista, recomendamos que cualquier función @q{pura} que estemos creando
3829 no utilice los grobs @code{Beam} o @code{VerticalAlignment}.}
3831 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
3833 @code{(ly:make-unpure-pure-container f0 f1)}
3835 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
3836 1}) y el primer argumento siempre debe ser el grob. Ésta es la
3837 función que da el resultado real. @var{f1} es la función que se
3838 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
3839 primer argumento debe ser siempre el grob pero los argumentos segundo
3840 y tercero son argumentos de @q{inicio} y de @q{final}.
3842 @var{inicio} y @var{final} son, a todos los efectos, valores mudos que
3843 sólo tienen importancia para los @code{objetos de extensión} (o sea:
3844 @code{Hairpin}, regulador, o @code{Beam}, barra), que pueden devolver
3845 distintas estimaciones de altura basadas en una columna de inicio y
3848 El resto son los otros argumentos para la primera función (que puede
3849 no ser ninguno si @var{n = 1}).
3851 El resultado de la segunda función se usa como una aproximación del
3852 valor necesario, que se usa entonces por la primera función para
3853 obtener el valor real que se usa a continuación para el ajuste de
3854 precisión mucho más tardío durante el proceso de espaciado.
3856 @lilypond[verbatim,quote,ragged-right]
3857 #(define (square-line-circle-space grob)
3858 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
3859 (notename (ly:pitch-notename pitch)))
3860 (if (= 0 (modulo notename 2))
3861 (make-circle-stencil 0.5 0.0 #t)
3862 (make-filled-box-stencil '(0 . 1.0)
3865 squareLineCircleSpace = {
3866 \override NoteHead #'stencil = #square-line-circle-space
3869 smartSquareLineCircleSpace = {
3870 \squareLineCircleSpace
3871 \override NoteHead #'Y-extent =
3872 #(ly:make-unpure-pure-container
3873 ly:grob::stencil-height
3874 (lambda (grob start end) (ly:grob::stencil-height grob)))
3877 \new Voice \with { \remove "Stem_engraver" }
3879 \squareLineCircleSpace
3881 \smartSquareLineCircleSpace
3886 En el primer compás, sin el contenedor @emph{unpure-pure}, el motor de
3887 espaciado no conoce la anchura de la cabeza de la nota y permite que
3888 colisione con las alteraciones accidentales. En el segundo compás, el
3889 motor de espaciado conoce la anchura de las cabezas de las notas y
3890 evita la colisión mediante el alargamiento de la línea en la medida
3893 Normalmente, para cálculos simples se pueden usar funciones casi
3894 idénticas tanto para las partes @q{no pura} y @q{pura}, simplemente
3895 cambiando el número de argumentos que se pasan a, y el ámbito de, la
3898 @warning{Si una función está caracterizada como @q{pura} y resulta que
3899 no lo es, el resultado puede ser inesperado.}
3902 @node Uso de las funciones musicales
3903 @section Uso de las funciones musicales
3904 @translationof Using music functions
3906 @c TODO -- add @seealso, etc. to these subsections
3908 Dondequiera que se necesite reutilizar trucos con distintas
3909 expresiones musicales, con frecuencia conviene hacer que el truco
3910 forme parte de una @emph{función musical}. En esta sección
3911 estudiaremos solamente las funciones de @emph{sustitución}, en las que
3912 el objeto es sustituir una variable dentro de un fragmento de código
3913 de entrada de LilyPond. Se describen otras funciones más complejas en
3914 @rextend{Funciones musicales}.
3917 * Sintaxis de las funciones de sustitución::
3918 * Ejemplos de funciones de sustitución::
3922 @node Sintaxis de las funciones de sustitución
3923 @subsection Sintaxis de las funciones de sustitución
3924 @translationof Substitution function syntax
3926 Es fácil hacer una función que sustituya una variable dentro de código
3927 de LilyPond. La forma general de estas funciones es
3931 #(define-music-function
3932 (parser location @var{arg1} @var{arg2} @dots{})
3933 (@var{type1?} @var{type2?} @dots{})
3935 @var{@dots{}música@dots{}}
3942 @multitable @columnfractions .33 .66
3943 @item @code{@var{argN}}
3944 @tab @var{n}-ésimo argumento
3946 @item @code{@var{typeN?}}
3947 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
3948 debe devolver @code{#t}.
3950 @item @code{@var{@dots{}música@dots{}}}
3951 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
3952 lugares en que sólo se permiten construcciones de Lilypond) o @code{#}
3953 (para usarlo como un valor de Scheme o un argumento de función
3954 musical) para referenciar argumentos (p.ej. @samp{#arg1}).
3957 Los argumentos @code{parser} y @code{location} son necesarios, y se
3958 utilizan en algunas situaciones avanzadas como se encuentra descrito
3959 en @rextend{Sintaxis de las funciones musicales}. Para las funciones
3960 de sustitución, tan sólo hemos de asegurarnos de incluirlos.
3962 También es necesaria la lista de predicados de tipo. Algunos de los
3963 predicados de tipo más comunes que se utilizan en las funciones
3968 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
3980 Para ver una lista de los predicados de tipo disponibles, consulte
3981 @ref{Predicados de tipo predefinidos}. También se permiten los
3982 predicados de tipo definidos por el usuario.
3985 Referencia de la notación:
3986 @ref{Predicados de tipo predefinidos}.
3988 Expansión de LilyPond:
3989 @rextend{Sintaxis de las funciones musicales}.
3991 Archivos instalados:
3992 @file{lily/music-scheme.cc},
3994 @file{scm/lily.scm}.
3997 @node Ejemplos de funciones de sustitución
3998 @subsection Ejemplos de funciones de sustitución
3999 @translationof Substitution function examples
4001 Esta sección presenta algunos ejemplos de funciones de sustitución.
4002 No pretenden ser exhaustivas, sino demostrar algunas de las
4003 posibilidades de las funciones de sustitución sencillas.
4005 En el primer ejemplo se define una función que simplifica el ajuste
4006 del relleno de un elemento de inscripción de texto TextScript:
4008 @lilypond[quote,verbatim,ragged-right]
4010 #(define-music-function
4011 (parser location padding)
4014 \once \override TextScript #'padding = #padding
4018 c4^"piu mosso" b a b
4020 c4^"piu mosso" d e f
4022 c4^"piu mosso" fis a g
4026 Además de números, podemos usar expresiones musicales, como notas,
4027 para los argumentos de las funciones musicales:
4029 @lilypond[quote,verbatim,ragged-right]
4031 #(define-music-function
4032 (parser location note)
4035 \tweak NoteHead #'stencil #ly:text-interface::print
4036 \tweak NoteHead #'text
4037 \markup \musicglyph #"custodes.mensural.u0"
4038 \tweak Stem #'stencil ##f
4042 \relative c' { c4 d e f \custosNote g }
4045 Se pueden definir funciones de sustitución con más de un argumento:
4047 @lilypond[quote,verbatim,ragged-right]
4049 #(define-music-function
4050 (parser location padding tempotext)
4053 \once \override Score.MetronomeMark #'padding = #padding
4054 \tempo \markup { \bold #tempotext }
4058 \tempo \markup { "Low tempo" }
4060 \tempoPadded #4.0 "High tempo"
4065 @c TODO: add appropriate @@ref's here.