1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: bcd9d85bfc1dd6cc2dd3e98901b4df33fd6d0989
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 s4^"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
1014 @cindex alignAboveContext
1015 @cindex alignBelowContext
1016 @funindex alignAboveContext
1017 @funindex alignBelowContext
1019 En ocasiones se necesita que un contexto exista durante un breve
1020 intervalo de tiempo, siendo un buen ejemplo el contexto de pentagrama
1021 de un ossia. Esto se consigue normalmente mediante la introducción de
1022 la definición del contexto en el lugar apropiado en paralelo con la
1023 sección correspondiente de la música principal. De forma
1024 predeterminada, el contexto tempral se coloca debajo de todos los
1025 contextos existentes. Para reposicionallo por encima del contexto que
1026 tenga el nombre @qq{principal}, debería definirse de esta forma:
1029 @code{\new Staff \with @{ alignAboveContext = #"principal" @} }
1032 Se presenta una situación similar cuando se posiciona un contexto
1033 temporal de letra de una canción dentro de una disposición de varios
1034 pentagramas tal como @code{ChoirStaff}, por ejemplo, cuando se añade
1035 una segunda estrofa a una sección que se repite. De forma
1036 predeterminada, el contexto temporal de letra se coloca debajo de los
1037 pentagramas inferiores. Mediante la definición del contexto temporal
1038 de letra con @code{alignBelowContext} se puede posicionar
1039 correctamente debajo del contexto de letra con nombre que contiene el
1040 texto de la primera estrofa.
1042 En diversos lugares pueden verse ejemplos que muestran esta
1043 recolocación de contextos temporales: véase
1044 @rlearning{Anidado de expresiones musicales},
1045 @ref{Modificación de pentagramas sueltos} y
1046 @ref{Técnicas específicas para la letra}.
1049 Manual de aprendizaje:
1050 @rlearning{Anidado de expresiones musicales}.
1052 Referencia de la notación:
1053 @ref{Modificación de pentagramas sueltos},
1054 @ref{Técnicas específicas para la letra}.
1056 Manual de utilización del programa:
1057 @rprogram{Aparece un pentagrama de más}.
1059 Archivos instalados:
1060 @file{ly/engraver-init.ly}.
1063 @node Explicación del Manual de referencia de funcionamiento interno
1064 @section Explicación del Manual de referencia de funcionamiento interno
1065 @translationof Explaining the Internals Reference
1068 * Navegar por la referencia del programa::
1069 * Interfaces de la presentación::
1070 * Determinar la propiedad del grob::
1071 * Convenciones de nombres::
1076 @node Navegar por la referencia del programa
1077 @subsection Navegar por la referencia del programa
1078 @translationof Navigating the program reference
1080 Supongamos que queremos mover la indicación de digitación del
1081 fragmento siguiente:
1083 @lilypond[quote,relative=2,verbatim]
1089 Si hace una visita a la documentación en busca de instrucciones de
1090 digitación (en @ref{Indicaciones de digitación}), encontrará:
1093 @strong{Véase también}
1095 Referencia de funcionamiento interno: @rinternals{Fingering}.
1100 La referencia del programador se encuentra disponible en forma de
1101 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
1102 en línea o bien descargando los archivos de la documentación HTML.
1103 Esta sección sería mucho más difícil de entender si está utilizando el
1104 manual en formato PDF.
1107 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
1111 Los objetos de digitación se crean por parte de:
1112 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1115 Siguiendo los enlaces relacionados dentro de la referencia del
1116 programa, podemos seguir el flujo de información dentro del programa:
1120 @item @rinternals{Fingering}:
1121 los objetos @rinternals{Fingering} se crean por parte de:
1122 @rinternals{Fingering_engraver}
1124 @item @rinternals{Fingering_engraver}:
1125 Tipos de música aceptados: @rinternals{fingering-event}
1127 @item @rinternals{fingering-event}:
1128 El tipo de evento musical @code{fingering-event} está descrito en
1129 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1132 Este camino se recorre en contra de la corriente de información del
1133 programa: comienza por la salida y acaba en el evento de entrada.
1134 También podríamos haber empezado por un evento de la entrada, y leído
1135 siguiendo el flujo de información terminando en su caso en el objeto
1136 (u objetos) de la salida.
1138 La referencia del programa también se puede examinar como un documento
1139 normal. Contiene capítulos que tratan de
1141 @rinternals{Music definitions},
1144 @code{Music definitions}
1146 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1147 de los capítulos relaciona todas las definiciones utilizadas y todas
1148 las propiedades que se pueden ajustar.
1151 @node Interfaces de la presentación
1152 @subsection Interfaces de la presentación
1153 @translationof Layout interfaces
1155 @cindex interfaz de la presentación
1156 @cindex presentación, interfaz de la
1159 La página HTML que pudimos ver en la sección anterior describe el
1160 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1161 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1162 números (como grosores y direcciones), pero también punteros a objetos
1163 relacionados. Un objeto de presentación también se llama un
1164 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1165 gráfico). Para ver más detalles acerca de los objetos gráficos o
1166 Grobs, consulte @rinternals{grob-interface}.
1168 La página dedicada a @code{Fingering} relaciona las definiciones del
1169 objeto @code{Fingering}. Por ejemplo, la página dice
1172 @code{padding} (dimensión, en espacios de pentagrama):
1178 lo que significa que el número se mantendrá a una distancia de al
1179 menos 0.5 de la cabeza de la nota.
1182 Cada objeto de presentación puede tener varias funciones como elemento
1183 notacional o tipográfico. Por ejemplo, el objeto de digitación
1184 Fingering tiene los siguientes aspectos
1188 Su tamaño es independiente del espaciado horizontal, al contrario de
1189 las ligaduras o las barras de las figuras.
1192 Es un elemento de texto. Casi seguro que es un texto muy corto.
1195 este elemento de texto se tipografía con un tipo de letra, no como las
1196 ligaduras o las barras de las figuras.
1199 Horizontalmente, el centro del símbolo se debe alinear con el centro
1200 de la cabeza de la nota.
1203 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1206 La posición vertical también está coordinada con otros símbolos de
1207 superíndice y de subíndice.
1210 Cada uno de estos aspectos se capta en lo que se llaman
1211 @emph{interface}s, que se relacionan al final de la página dedicada a
1212 @rinternals{Fingering}
1215 Este objeto contempla los siguientes interfaces:
1216 @rinternals{item-interface},
1217 @rinternals{self-alignment-interface},
1218 @rinternals{side-position-interface}, @rinternals{text-interface},
1219 @rinternals{text-script-interface}, @rinternals{font-interface},
1220 @rinternals{finger-interface} y @rinternals{grob-interface}.
1223 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1224 página del respectivo interfaz del objeto. Cada interfaz tiene un
1225 cierto número de propiedades. Algunas de ellas no son para que el
1226 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1229 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1230 realmente esto no significa mucho. El archivo de inicialización
1231 (véase @rlearning{Otras fuentes de información})
1232 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1237 (avoid-slur . around)
1238 (slur-padding . 0.2)
1239 (staff-padding . 0.5)
1240 (self-alignment-X . 0)
1241 (self-alignment-Y . 0)
1242 (script-priority . 100)
1243 (stencil . ,ly:text-interface::print)
1244 (direction . ,ly:script-interface::calc-direction)
1245 (font-encoding . fetaText)
1246 (font-size . -5) ; don't overlap when next to heads.
1247 (meta . ((class . Item)
1248 (interfaces . (finger-interface
1250 text-script-interface
1252 side-position-interface
1253 self-alignment-interface
1254 item-interface))))))
1258 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1259 de valores de variables, y la página web de la Referencia de
1260 funcionamiento interno se genera directamente a partir de esta
1264 @node Determinar la propiedad del grob
1265 @subsection Determinar la propiedad del grob
1266 @translationof Determining the grob property
1268 Recordemos que queríamos cambiar la posición del @b{2} en
1270 @lilypond[quote,relative=2,verbatim]
1276 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1277 tenemos que negociar con el interfaz asociado con esta colocación.
1278 Esto se hace usando @code{side-position-interface}. La página que
1279 describe este interface dice:
1282 @code{side-position-interface}
1284 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1285 soporte). La propiedad @code{direction} significa dónde poner el
1286 objeto víctima con relación al soporte (¿a la izquierda o a la
1287 derecha, encima o debajo?)
1291 @cindex padding (relleno)
1293 Debajo de esta descripción, la variable @code{padding} (relleno) se
1299 (dimensión, en espacios de pentagrama)
1301 Añadir esta cantidad de espacio adicional entre objetos que están unos
1306 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1307 digitación de la cabeza de la nota. La siguiente orden inserta un
1308 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1311 \once \override Voice.Fingering #'padding = #3
1314 Al insertar esta instrucción antes de que se haya creado el objeto
1315 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1318 @lilypond[quote,relative=2,verbatim]
1319 \once \override Voice.Fingering #'padding = #3
1325 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1326 se puede deducir también a partir de la referencia del programa, ya
1327 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1330 El grabador Fingering_engraver es parte de los contextos: @dots{}
1335 @node Convenciones de nombres
1336 @subsection Convenciones de nombres
1337 @translationof Naming conventions
1339 Se hace necesario presentar una panorámica de las diversas
1340 convenciones de nomenclatura:
1343 @item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
1344 @item funciones de Scheme: ly:más-estilo-de-scheme
1345 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1346 @item interfaces de Grobs: estilo-scheme
1347 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1348 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1349 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1350 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1354 Preguntas aún sin respuesta
1356 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1357 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1362 @node Modificar las propiedades
1363 @section Modificar las propiedades
1364 @translationof Modifying properties
1367 * Panorámica de la modificación de las propiedades::
1368 * La instrucción set::
1369 * La instrucción override::
1370 * La instrucción tweak::
1371 * set frente a override::
1372 * Modificación de las listas-A::
1376 @node Panorámica de la modificación de las propiedades
1377 @subsection Panorámica de la modificación de las propiedades
1378 @translationof Overview of modifying properties
1380 Cada contexto es responsable de la creación de ciertos tipos de
1381 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1382 también se almacenan por contexto. Mediante la modificación de estos
1383 ajustes, se puede alterar la apariencia de los objetos.
1385 Existen dos tipos diferentes de propiedades almacenadas en los
1386 contextos: las propiedades de contexto y las propiedades de grob. Las
1387 propiedades de contexto son propiedades que se aplican al contexto
1388 como un todo y controlan la forma en que el propio contexto se
1389 imprime. Por contra, las propiedades de grob se aplican a los tipos
1390 de grob específicos que se imprimirán dentro del contexto.
1392 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar los
1393 valores de las propiedades de contexto. Las instrucciones
1394 @code{\override} y @code{\revert} se usan para cambiar los valores de
1395 las propiedades de grob.
1398 La sintaxis de esto es
1401 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1404 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1405 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1406 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1407 disposición}). Este último es un símbolo, y por ello debe ir
1408 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1409 explica cómo se deben cumplimentar los conceptos @var{nombre},
1410 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1411 funcionalidad des esta instrucción.
1416 \override Staff.Stem #'thickness = #4.0
1420 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1421 grosor de una línea del pentagrama como unidad). Puesto que la
1422 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1423 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1424 Aquí vemos la instrucción en pleno funcionamiento:
1426 @lilypond[quote,verbatim,relative=2]
1428 \override Staff.Stem #'thickness = #4.0
1434 La instrucción @code{\override} modifica la definición de la plica
1435 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1436 que la instrucción se ha interpretado, todas las plicas se engrosan.
1438 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1439 omitir, ocasionando que se utilice el contexto predeterminado
1440 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1441 solo paso de tiempo.
1443 @lilypond[quote,verbatim,relative=2]
1445 \once \override Stem #'thickness = #4.0
1450 El @code{\override} se debe hacer antes de que el objeto se inicia.
1451 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1452 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1453 en el momento en que se crea el objeto. En este ejemplo:
1455 @lilypond[quote,verbatim,relative=2]
1456 \override Slur #'thickness = #3.0
1458 \override Beam #'beam-thickness = #0.6
1463 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1464 la instrucción para @code{Beam}, la barra, va después de que la barra
1465 se ha iniciado, y por ello no tiene ningún efecto.
1467 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1468 un contexto deshace una instrucción @code{\override}; como con
1469 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1470 del mismo contexto. En otras palabras, el @code{\revert} del
1471 siguiente ejemplo no hace nada.
1474 \override Voice.Stem #'thickness = #4.0
1475 \revert Staff.Stem #'thickness
1478 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1479 dentro de las propiedades normales. Para trucarlas, utilice
1480 instrucciones de la forma
1482 @c leave this as a long long
1484 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1491 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1497 Referencia de funcionamiento interno:
1498 @rinternals{Backend},
1499 @rinternals{All layout objects},
1500 @rinternals{OverrideProperty},
1501 @rinternals{RevertProperty},
1502 @rinternals{PropertySet}.
1505 El «back-end» o motor de salida no es muy estricto en la comprobación
1506 de tipos de las propiedades de objetos. Las referencias cíclicas en
1507 valores Scheme de propiedades pueden producir cuelgues o salidas
1508 abruptas, o las dos cosas.
1511 @node La instrucción set
1512 @subsection La instrucción @code{@bs{}set}
1513 @translationof The set command
1517 @cindex cambiar propiedades
1519 Cada contexto puede tener distintas @emph{propiedades}, variables
1520 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1521 paso de interpretación. Se consigue insertando la instrucción
1522 @code{\set} dentro de la música:
1525 \set @var{contexto}.@var{propiedad} = #@var{valor}
1528 @var{valor} es un objeto de Scheme, razón por la que va precedido del
1529 carácter almohadilla,@tie{}@code{#}.
1531 El nombre de las propiedades de contexto suele ir en minúsculas con
1532 mayúscula en medio. Controlan sobre todo la traducción de la música a
1533 la notación, p.ej. @code{localKeySignature} (para determinar si hay
1534 que impriir alteraciones o no), o @code{measurePosition} (para
1535 determinar cuándo hay que imprimir una línea divisoria). El valor de
1536 las propiedades de contexto puede modifcarse con el tiempo durante la
1537 interpretación de la música; un ejemplo obvio es
1538 @code{measurePosition}. Las propiedades de contexto se modifican
1539 mediante la instrucción @code{\set}.
1541 Por ejemplo, los silencios multicompás se combinan en un solo compás
1542 si el valor de la propiedad de contexto @code{skipBars} se establece a
1543 @code{#t} (verdadero):
1545 @lilypond[quote,verbatim,relative=2]
1547 \set Score.skipBars = ##t
1551 Si se omite el argumento @var{context}, entonces se utiliza el
1552 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1553 @code{Voice} o @code{Lyrics}). En este ejemplo:
1555 @lilypond[quote,verbatim,relative=2]
1556 \set Score.autoBeaming = ##f
1560 \set autoBeaming = ##t
1568 El cambio se aplica @q{al vuelo}, mientras dura la música, de forma
1569 que el ajuste sólo afecta al segundo grupo de corcheas.
1571 Observe que el contexto del nivel más bajo no siempre contiene la
1572 propiedad que querríamos modificar: por ejemplo, intentar ajustar el
1573 valor de la propiedad @code{skipBars} del contexto predeterminado del
1574 nivel más bajo, que en este caso es @code{Voice}, no tendrá ningún
1575 efecto, porque skipBars es una propiedad del contexto @code{Score}.
1577 @lilypond[quote,verbatim,relative=2]
1583 Los contextos son jerárquicos, y si se ha especificado un contexto
1584 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1585 también a todos los contextos @code{Voice} dentro del pentagrama
1590 También existe una instrucción @code{\unset}:
1592 \unset @var{contexto}.@var{propiedad}
1596 que elimina la definición de @var{propiedad}. Esta instrucción
1597 elimina la definición solamente si está establecida dentro de
1598 @var{contexto}. Properties that have been set in enclosing contexts will
1599 not be altered by an unset in an enclosed context:
1601 @lilypond[quote,verbatim,relative=2]
1602 \set Score.autoBeaming = ##t
1607 \unset Score.autoBeaming
1615 Como @code{\set}, el argumento @var{contexto} no se tiene que
1616 especificar para un contexto del nivel más bajo, por lo que los dos
1620 \set Voice.autoBeaming = ##t
1621 \set autoBeaming = ##t
1625 son equivalentes si el contexto inferior en curso es @code{Voice}.
1629 Los ajustes que se aplican solamente a un único paso de tiempo se
1630 pueden escribir con @code{\once}, por ejemplo en
1632 @lilypond[quote,verbatim,relative=2]
1634 \once \set fontSize = #4.7
1639 En el manual de Referencia de funcionamiento interno hay una
1640 descripción completa de todas las propiedades de contexto disponibles,
1643 @rinternals{Tunable context properties}.
1646 Traducción @expansion{} Propiedades de contexto modificables por el
1651 Referencia de funcionamiento interno:
1652 @rinternals{Tunable context properties}.
1654 @cindex grob, propiedades de
1655 @cindex propiedades de grob
1659 @node La instrucción override
1660 @subsection La instrucción @code{\override}
1661 @translationof The override command
1663 Existe un tipo especial de propiedad de contexto: la descripción de
1664 los grobs. Las decscripciones de los grobs reciben un nombre en
1665 @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen los
1666 @q{ajustes predeterminados} para un tipo particular de grob, en forma
1667 de lista asociativa. Consulte @file{scm/define-grobs.scm} para
1668 ver los ajustes de cada descripción de grob. Las descripciones de
1669 grob se modifican con @code{\override}.
1671 @code{\override} es en realidad una forma abreviada;
1674 \override @var{contexto}.@var{NombreDelGrob} #'@var{propiedad} = #@var{valor}
1678 equivale más o menos a
1680 @c leave this long line -gp
1682 \set @var{contexto}.@var{NombreDelGrob} =
1683 #(cons (cons '@var{propiedad} @var{valor})
1684 <valor anterior de @var{contexto}.@var{NombreDelGrob}>)
1687 El valor de @code{contexto}.@code{NombreDelGrob} (la lista-A) se
1688 utiliza para inicializar las propiedades de los grobs individuales.
1689 Los grobs tienen propiedades, denominadas en el estilo de Scheme, con
1690 @code{palabras-con-guiones}. Los valores de las propiedades de grob
1691 cambian durante el proceso de formateo: éste se realiza básicamente
1692 calculando las propiedades utilizando funciones de @q{callback}
1693 (pasadas como parámetro).
1695 Por ejemplo, podemos aumentar el grosor de la plica de una figura
1696 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
1697 @code{Stem} (plica):
1699 @lilypond[quote,verbatim,relative=2]
1701 \override Voice.Stem #'thickness = #3.0
1705 Si no se ha especificado ningún contexto en la instrucción
1706 @code{\override}, se utiliza el contexto del nivel inferior:
1708 @lilypond[quote,verbatim,relative=2]
1709 { \override Staff.Stem #'thickness = #3.0
1713 \override Stem #'thickness = #0.5
1723 @cindex reversión de sobreescrituras
1724 @cindex sobreescrituras, reversión de
1726 El efecto de una instrucción de sobreescritura @code{\override} se
1727 puede deshacer con @code{\revert}:
1729 @lilypond[quote,verbatim,relative=2]
1731 \override Voice.Stem #'thickness = #3.0
1733 \revert Voice.Stem #'thickness
1737 Los efectos de @code{\override} y @code{\revert} se aplican a todos
1738 los grobs del contexto afectado partiendo del momento actual y hacia
1741 @lilypond[quote,verbatim,relative=2]
1746 \override Staff.Stem #'thickness = #3.0
1750 \revert Staff.Stem #'thickness
1758 @cindex sobreescritura para un solo momento
1760 Se puede usar @code{\once} con @code{\override} para afectar solamente
1761 al instante de tiempo actual:
1763 @lilypond[quote,verbatim,relative=2]
1767 \override Stem #'thickness = #3.0
1771 \once \override Stem #'thickness = #3.0
1780 Las instrucciones que modifican la salida tienen por lo general un
1784 \override Voice.Stem #'thickness = #3.0
1788 Para construir este truco debemos determinar los siguientes datos:
1791 @item el contexto: aquí @code{Voice}.
1792 @item el objeto de presentación: aquí @code{Stem}.
1793 @item la propiedad de presentación: aquí @code{thickness}.
1794 @item un valor adecuado: aquí @code{3.0}.
1797 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
1798 en el interior de las propiedades normales. Para modificarlas utilice
1799 instrucciones de la forma
1802 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1805 @cindex documentación interna
1806 @cindex buscar objetos gráficos
1807 @cindex gráficos, descripción de los objetos
1810 @cindex interna, documentación
1812 Para muchas propiedades, independientemente del tipo de datos de la
1813 propiedad, si se establece el valor de la propiedad a falso
1814 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
1815 ignore por completo dicha propiedad. Esto es especialmente útil para
1816 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
1817 causarían problemas.
1819 Mostraremos a continuación cómo localizar esta información en el
1820 manual de notación y en la referencia de funcionamiento interno.
1824 Referencia de funcionamiento interno:
1825 @rinternals{Backend}
1828 @node La instrucción tweak
1829 @subsection La instrucción @code{\tweak}
1830 @translationof The tweak command
1835 El cambio de las propiedades de grob mediante @code{\override} produce
1836 la aplicación del cambio a todos los grobs dados en el contexto en el
1837 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
1838 podemos desear que los cambios se apliquen a un solo grob en lugar de
1839 a todos los grobs del contexto afectado. Esto se consigue con la
1840 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
1843 \tweak @var{objeto-de-presentación} #'@var{propiedad-del-grob} @var{valor}
1846 Es opcional especificar el @var{objeto-de-presentación}. La
1847 instrucción @code{\tweak} se aplica al objeto musical que viene
1848 inmediatamente después de @var{valor} dentro del flujo musical.
1851 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
1852 los objetos gráficos. Para objetos que resultan directamente de un
1853 elemento de código de la entrada, puede usar la función @code{\tweak},
1856 @lilypond[relative=2,verbatim,quote]
1861 \tweak #'duration-log #1
1864 -\tweak #'padding #8
1870 Pero el uso principal de la instrucción @code{\tweak} es modificar
1871 solamente uno de varios elementos de notación que dan comienzo en el
1872 mismo momento musical, como las notas de un acorde, o corchetes de
1873 tresillo que empiezan al mismo tiempo.
1875 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
1876 a continuación de forma directa, sin necesidad de especificar el
1877 nombre del grob o el contexto. Para que esto funcione, es necesario
1878 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
1879 al objeto al que se aplica, después de que el archivo de entrada se ha
1880 convertido en un flujo musical. Con frecuencia no es el caso, pues
1881 muchos elementos adicionales se insertan en la corriente musical de
1882 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
1883 parte de un acorde, LilyPond inserta implícitamente un evento
1884 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
1885 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
1886 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
1887 en el flujo musical, permaneciendo así adyacente a la nota, y con la
1888 posibilidad de modificarla.
1892 @lilypond[relative=2,verbatim,quote]
1893 <\tweak #'color #red c>4
1897 pero esto no funciona:
1899 @lilypond[relative=2,verbatim,quote]
1900 \tweak #'color #red c4
1905 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
1906 consulte @rlearning{Métodos de trucaje}.
1908 Si se colocan varios elementos similares en el mismo momento musical,
1909 la instrucción @code{\override} no se puede usar para modificar uno
1910 solo de ellos: aquí es donde se debe usar la instrucción
1911 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
1912 en el mismo momento musical están los siguientes:
1914 @c TODO expand to include any further uses of \tweak
1916 @item las cabezas de las notas de un acorde
1917 @item signos de articulación sobre la misma nota
1918 @item ligaduras de unión entre notas de un acorde
1919 @item corchetes de grupos especials que comienzan en el mismo momento
1922 @c TODO add examples of these
1924 @cindex acorde, modificación de una nota
1926 En este ejemplo se modifican el color de una cabeza y el tipo de otra,
1927 dentro del mismo acorde:
1929 @lilypond[relative=2,verbatim,quote]
1934 \tweak #'duration-log #1
1939 @code{\tweak} se puede usar para modificar ligaduras de expresión:
1941 @lilypond[verbatim,quote,relative=1]
1942 c-\tweak #'thickness #5 ( d e f)
1946 Para que funcione la instrucción @code{\tweak}, debe permanecer
1947 adyacente al objeto al que se ha de aplicar después de que el código
1948 de entrada se ha convertido a un flujo musical. El trucaje de un
1949 acorde completo no hace nada porque su evento musical actúa solamente
1950 como un contenedor, y todos los objetos de presentación se crean a
1951 partir de eventos dentro del @code{EventChord}:
1953 @lilypond[relative=2,verbatim,quote]
1954 \tweak #'color #red c4
1955 \tweak #'color #red <c e>4
1956 <\tweak #'color #red c e>4
1959 La instrucción @code{\tweak} sencilla no se puede usar para modificar
1960 ningún objeto que no se haya creado directamente a partir de la entrada.
1961 Concretamente, no afecta a las plicas, barras automáticas ni
1962 alteraciones, porque éstos se generan posteriormente por
1963 parte de objetos de presentación @code{NoteHead}
1964 más que por elementos musicales del
1967 Tales objetos de presencaión creados indirectamente se pueden trucar
1968 usando la forma explícita de la instrucción @code{\tweak}:
1970 @lilypond[relative=2,verbatim,quote]
1971 \tweak Stem #'color #red
1972 \tweak Beam #'color #green c8 e
1973 <c e \tweak Accidental #'font-size #-3 ges>4
1976 No se puede usar @code{\tweak} para modificar las claves o las
1977 indicaciones de compás, porque éstos se separan de cualquier
1978 instrucción @code{\tweak} precedente dentro del flujo de entrada
1979 merced a la inserción automática de elementos adicionales que se
1980 requieren para especificar el contexto.
1982 Se pueden colocar varias instrucciones @code{\tweak} antes de un
1983 elemento de notación; todos le afectan:
1985 @lilypond[verbatim,quote,relative=1]
1987 -\tweak #'style #'dashed-line
1988 -\tweak #'dash-fraction #0.2
1989 -\tweak #'thickness #3
1990 -\tweak #'color #red
1995 El flujo musical que se genera a partir de una sección de un archivo
1996 de entrada (incluido cualquier elemento insertado automáticamente)
1997 puede examinarse, véase @rextend{Presentación de las expresiones musicales}.
1998 Esto puede ser de utilidad en la determinación de lo que
1999 puede modificarse por medio de una instrucción @code{\tweak}.
2002 Manual de aprendizaje:
2003 @rlearning{Métodos de trucaje}.
2005 Manual de extensión:
2006 @rextend{Presentación de las expresiones musicales}.
2010 @cindex trucar puntos de control
2011 @cindex control, trucar puntos de
2013 La instrucción @code{\tweak} solamente se aplica a la primera de
2014 varias ligaduras generadas dentro de un acorde.
2017 @node set frente a override
2018 @subsection @code{\set} frente a @code{\override}
2019 @translationof set versus override
2021 @c HACER: probablemente esta sección es innecesaria.
2024 We have seen two methods of changing properties: @code{\set} and
2025 @code{\override}. There are actually two different kinds of
2028 @code{fontSize} is a special property: it is equivalent to
2029 entering @code{\override ... #'font-size} for all pertinent
2030 objects. Since this is a common change, the special
2031 property (modified with @code{\set}) was created.
2036 @node Modificación de las listas-A
2037 @subsection Modificación de las listas-A
2038 @translationof Modifying alists
2040 Ciertas propiedades configurables por parte del usuario se representan
2041 internamente como @emph{listas-A} (listas asociativas), que almacenan
2042 duplas de @emph{claves} y @emph{valores}. La estructura de una
2043 lista-A es la siguiente:
2046 '((@var{clave1} . @var{valor1})
2047 (@var{clave2} . @var{valor2})
2048 (@var{clave3} . @var{valor3})
2052 Si una lista-A es una propiedad de un grob o una variable de
2053 @code{\paper}, sus claves se pueden modificar individualmente sin que
2054 afecte a las otras claves.
2056 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2057 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2058 del grob @code{StaffGrouper}. La propiedad es una lista-A con cuatro
2059 claves: @code{basic-distance} (distancia básica),
2060 @code{minimum-distance} (distancia mínima), @code{padding} (relleno)
2061 y @code{stretchability} (ampliabilidad).
2062 Los ajustes estándar para esta propiedad
2063 se relacionan en la sección
2064 @qq{Backend} de la Referencia de Funcionamiento Interno
2065 (véase @rinternals{StaffGrouper}):
2068 '((basic-distance . 9)
2069 (minimum-distance . 7)
2071 (stretchability . 5))
2074 Una forma de acercar los pentagramas entre sí es reducir el valor de
2075 la clave @code{basic-distance} (@code{9}) para que se corresponda con
2076 el valor de @code{minimum-distance} (@code{7}). Para modificar una
2077 única clave de forma individual, utilice una @emph{declaración
2080 @lilypond[quote,verbatim]
2081 % default space between staves
2083 \new Staff { \clef treble c''1 }
2084 \new Staff { \clef bass c1 }
2087 % reduced space between staves
2088 \new PianoStaff \with {
2089 % this is the nested declaration
2090 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #7
2092 \new Staff { \clef treble c''1 }
2093 \new Staff { \clef bass c1 }
2097 La utilización de una declaración anidada actualiza la clave
2098 especificada (como @code{basic-distance} en el ejemplo anterior)
2100 de las otras claves que ya se habían establecido para la misma
2103 Ahora, supongamos que deseamos que los pentagramas estén tan próximos
2104 como sea posible sin que se superpongan. La manera más sencilla de
2105 hacerlo es establecer las cuatro claves de la lista-A a cero. Sin
2106 embargo, no es necesario escribir cuatro declaraciones anidadas, una
2107 por cada clave. En lugar de eso, se puede redefinir completamente la
2108 propiedad con una sola declaración, como una lista-A:
2110 @lilypond[quote,verbatim]
2111 \new PianoStaff \with {
2112 \override StaffGrouper #'staff-staff-spacing =
2113 #'((basic-distance . 0)
2114 (minimum-distance . 0)
2116 (stretchability . 0))
2118 \new Staff { \clef treble c''1 }
2119 \new Staff { \clef bass c1 }
2123 Observe que cualquier clave que no haya sido relacionada
2124 explícitamente en la definición de la lista-A, será reiniciada a sus
2125 valores @emph{predeterminados si no se han fijado}. En el caso de
2126 @code{staff-staff-spacing}, el valor de cualquier clave no fijada se
2127 reiniciaría a cero (excepto @code{stretchability}, que toma el valor
2128 de @code{basic-distance} si no se fija). Así, las dos declaraciones
2129 siguientes son equivalentes:
2132 \override StaffGrouper #'staff-staff-spacing =
2133 #'((basic-distance . 7))
2135 \override StaffGrouper #'staff-staff-spacing =
2136 #'((basic-distance . 7)
2137 (minimum-distance . 0)
2139 (stretchability . 7))
2142 Una consecuencia de esto (posiblemente no intencionada) es la
2143 eliminación de cualquier valor estándar que se establezca en un
2144 archivo de inicio y que se carga cada vez que se compila un archivo de
2145 entrada. En el ejemplo anterior, los ajustes estándar para
2146 @code{padding} y @code{minimum-distance} (definidos en
2147 @file{scm/define-grobs.scm}) se reinician a sus valores
2148 predeterminados si no se han fijado (cero para las dos claves). La
2149 definición de una propiedad o variable como una lista-A (de cualquier
2150 tamaño) siempre reinicia todos los valores de clave no establecidos a
2151 sus valores predeterminados si no se han fijado. Ano ser que este sea
2152 el resultado deseado, es más seguro actualizar los valores de clave
2153 individualmente con una declaración anidada.
2155 @warning{Las declaraciones anidadas no funcionan para las listas-A de
2156 propiedades de contexto (como @code{beamExceptions},
2157 @code{keySignature}, @code{timeSignatureSettings}, etc.). Estas
2158 propiedades sólo se pueden modificar redefiniéndolas completamente
2162 @node Conceptos y propiedades útiles
2163 @section Conceptos y propiedades útiles
2164 @translationof Useful concepts and properties
2168 * Modos de entrada::
2169 * Dirección y posición::
2170 * Distancias y medidas::
2171 * Propiedades del símbolo del pentagrama::
2172 * Objetos de extensión::
2173 * Visibilidad de los objetos::
2174 * Estilos de línea::
2175 * Rotación de objetos::
2179 @node Modos de entrada
2180 @subsection Modos de entrada
2181 @translationof Input modes
2183 La forma en que se interpreta la notación contenida dentro de un
2184 archivo de entrada, está determinada por el modo de entrada en curso.
2186 @strong{Modo de acordes}
2188 Se activa con la instrucción @code{\chordmode} y produce que la
2189 entrada se interprete con al sintaxis de la notación de acordes, véase
2190 @ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
2193 El modo de acordes se activa también con la instrucción
2194 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
2195 y produce que el código que sigue se interprete con la sintaxis de la
2196 notación de acordes y se imprima como nombres de acorde dentro del
2197 contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
2199 @strong{Modo de percusión}
2201 Se activa con la instrucción @code{\drummode} y produce que el código
2202 de entrada se interprete con la sintaxis de la notación de percusión,
2203 véase @ref{Notación básica de percusión}.
2205 El modo de percusión también se activa con la instrucción
2206 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
2207 que el código que sigue se interprete con la sintaxis de la notación
2208 de percusión y se imprima como símbolos de percusión sobre un
2209 pentagrama de percusión, véase @ref{Notación básica de percusión}.
2211 @strong{Modo de cifras}
2213 Se activa con la instrucción @code{\figuremode} y hace que el código
2214 de entrada se interprete con la sintaxis del bajo cifrado, véase
2215 @ref{Introducir el bajo cifrado}.
2217 El modo de cifrase también se activa con la instrucción
2218 @code{\figures}. También crea un contexto de @code{FiguredBass} nuevo
2219 y hace que el código que viene a continuación se interprete con la
2220 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
2221 dentro del contexto @code{FiguredBass}, véase @ref{Introducción al bajo cifrado}.
2223 @strong{Modos de traste y tablatura}
2225 No existen modos de entrada especiales para introducir símbolos de
2226 trastes y de tablatura.
2228 Para crear diagramas de trastes, escriba las notas o acordes en el
2229 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2230 véase @ref{Tablaturas predeterminadas}.
2232 Para crear diagramas de trastes encima de un pentagrama, escríbalos
2233 como elementos de marcado encima de las notas utilizando la
2234 instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
2236 @strong{Modo de letra}
2238 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
2239 se interprete como sílabas de la letra de la canción con duraciones
2240 opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
2242 El modo de letra también se habilita con la instrucción
2243 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
2244 y una instrucción @code{\lyricsto} implícita que asocia la letra que
2245 viene a continuación con la música precedente.
2247 @strong{Modo de marcado}
2249 Se activa con la instrucción @code{\markup}, y hace que la entrada se
2250 interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
2252 @c silly work-around for texinfo broken-ness
2253 @c (@strong{Note...} causes a spurious cross-reference in Info)
2256 Es el modo predeterminado o se puede activar con la instrucción
2257 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
2258 marcado, etc. y se imprime como notación musical sobre un pentagrama.
2260 Normalmente no es necesario especificar el modo de notas de forma
2261 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2262 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2263 otro modo y queremos insertar algo que solamente se puede hacer con la
2264 sintaxis del modo de notas.
2266 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
2267 una pieza coral es necesario entrar en el modo de notas para poder
2268 interpretar dichas indicaciones:
2270 @lilypond[verbatim,relative=2,quote]
2273 \notemode{\set stanza = \markup{ \dynamic f 1. } }
2277 \notemode{\set stanza = \markup{ \dynamic p 2. } }
2283 @node Dirección y posición
2284 @subsection Dirección y posición
2285 @translationof Direction and placement
2287 Al tipografiar música, la dirección y colocación de muchos elementos
2288 es cuestión de elección. Por ejemplo, las plicas de las notas se
2289 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
2290 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
2291 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
2292 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
2293 LilyPond las determine automáticamente, pero en ciertos casos puede
2294 ser deseable forzar una dirección o colocación concreta.
2296 @strong{Acciones predeterminadas}
2298 De forma predeterminada algunas direcciones siempre son hacia arriba o
2299 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
2300 otras cosas pueden alternar entre arriba y abajo en función de la
2301 dirección de las plicas (como las ligaduras o los acentos).
2303 @c TODO Add table showing these
2305 Se puede sobreescribir la acción predeterminada mediante el prefijado
2306 de la articulación por un @emph{indicacor de dirección}. Están
2307 disponibles tres indicadores de dirección: @code{^} (que significa
2308 @qq{arriba}), @code{_} (que significa @qq{abajo}) o @code{-} (que
2309 significa @qq{usar la dirección predeterminada}). El indicador de
2310 dirección se puede normalmente omitir, en cuyo caso se supone el
2311 indicador predeterminado @code{-}, pero se necesita un indicador de
2312 dirección @strong{siempre} antes de:
2315 @item las instrucciones @code{\tweak}
2316 @item las instrucciones @code{\markup}
2317 @item las instrucciones @code{\tag}
2318 @item los marcados de cadena, p.ej. -"cadena"
2319 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2320 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2323 Estas indicaciones afectan sólo a la nota siguiente.
2325 @lilypond[verbatim,quote,relative=2]
2332 @strong{La propiedad de dirección}
2334 La posición o dirección de muchos objetos de presentación está
2335 controlada por la propiedad @code{direction}.
2337 El valor de la propiedad @code{direction} se puede establecer al valor
2338 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
2339 @w{@code{-1}}, con el significado de @qq{hacia abajo} o @qq{debajo}.
2340 Se pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
2341 @code{1} y @w{@code{-1}} respectivamente. La dirección predeterminada
2342 se puede especificar estableciendo @code{direction} a @code{0} ó a
2343 @code{CENTER}. De forma alternativa, en muchos casos existen
2344 instrucciones predefinidas para especificar la dirección. Todas ellas
2348 @code{\xxxUp}, @code{\xxxDown} o @code{\xxxNeutral}
2352 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
2353 predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
2355 En alguna que otra ocasión como en el arpegio, el
2356 valor de la propiedad @code{direction} puede especificar si el objeto se debe
2357 colocar a la izquierda o a la derecha del objeto padre. En este caso
2358 @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y @code{1}
2359 ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
2360 significan @qq{utilizar la dirección predeterminada}.
2362 Estas indicaciones afectan a todas las notas hasta que son canceladas.
2364 @lilypond[verbatim,quote,relative=2]
2373 En música polifónica, en general es mejor especificar una voz explícita
2374 que cambiar la dirección de un objeto. Para ver más información,
2375 véase @ref{Varias voces}.
2378 Manual de aprendizaje:
2379 @rlearning{Objetos interiores al pentagrama}.
2381 Referencia de la notación:
2385 @node Distancias y medidas
2386 @subsection Distancias y medidas
2387 @translationof Distances and measurements
2389 @cindex distancias absolutas
2390 @cindex distancias escaladas
2397 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
2399 Las distancias absolutas se usan para especificar márgenes, sangrados
2400 y otros detalles de diseño de página, y de forma predeterminada se
2401 especifican en milímetros. Las distancias se pueden especificar en
2402 otras unidades escribiendo después de la cifra indicativa de la
2403 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
2404 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
2405 de página se pueden especificar también en unidades escalables (véase
2406 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
2407 La disposición de página se describe en detalle en
2408 @ref{Disposición de la página}.
2410 Las distancias escaladas siempre se especifican en unidades de un
2411 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
2412 El espacio de pentagrama es la distancia entre dos líneas del
2413 pentagrama adyacentes. El valor predeterminado se puede cambiar
2414 globalmente fijando el tamaño global del pentagrama, o se puede
2415 sobreescribir localmente cambiando la propiedad @code{staff-space} del
2416 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
2417 automáticamente con cualquier cambio al tamaño global del pentagrama o
2418 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
2419 las fuentes tipográficas se escalan solamente con los cambios
2420 efectuados al tamaño global del pentagrama. Así, el tamaño global del
2421 pentagrama posibilita la fácil variación del tamaño general de una
2422 partitura impresa. Para ver los métodos de establecimiento del tamaño
2423 global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2427 Si se necesita dibujar sólo una sección de una partitura a una escala
2428 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2429 simplemente cambiar el tamaño global del pentagrama porque esto
2430 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2431 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2432 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2433 nuestra disposición una función de Scheme, @code{magstep}, para
2434 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2435 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2436 utilización, consulte @rlearning{Longitud y grosor de los objetos}.
2439 Manual de aprendizaje:
2440 @rlearning{Longitud y grosor de los objetos}.
2442 Referencia de la notación:
2443 @ref{Disposición de la página},
2444 @ref{Establecer el tamaño del pentagrama}.
2447 @node Propiedades del símbolo del pentagrama
2448 @subsection Propiedades del símbolo del pentagrama
2449 @translationof Staff symbol properties
2451 @cindex ajuste del símbolo del pentagrama
2452 @cindex dibujar el símbolo del pentagrama
2453 @cindex pentagrama, establecer el símbolo del
2455 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2456 @c Need to think of uses for these properties. Eg 'line-positions
2457 @c is used in a snippet to thicken centre line.
2458 @c If retained, add @ref to here in 1.6.2 -td
2460 Se puede definir al mismo tiempo la posición vertical de las líneas de
2461 la pauta y el número de líneas de la misma. Como muestra el siguiente
2462 ejemplo, las posiciones de las notas no están influidas por las
2463 posiciones de las líneas de la pauta.
2465 @warning{La propiedad @code{'line-positions} sobreescribe a la
2466 propiedad @code{'line-count}. El número de líneas de la pauta está
2467 definido implícitamente por el número de elementos de la lista de
2468 valores de @code{'line-positions}.}
2470 @lilypond[verbatim,quote,relative=1]
2472 \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
2477 Se puede modificar la anchura de la pauta. Las unidades son espacios
2478 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2479 resulta afectado por este ajuste.
2481 @lilypond[verbatim,quote,relative=1]
2483 \override StaffSymbol #'width = #23
2489 @node Objetos de extensión
2490 @subsection Objetos de extensión
2491 @translationof Spanners
2493 Muchos objetos de notación musical abarcan varias notas o incluso
2494 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2495 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2496 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2497 especiales para controlar su apariencia y comportamiento. Algunas de
2498 estas propiedades son comunes a todos los objetos de extensión; otras
2499 se limitan a un subconjunto de los extensores.
2501 Todos los objetos de extensión contemplan el interface
2502 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2503 una línea recta entre los dos objetos, contemplan también el interface
2504 @code{line-spanner-interface}.
2506 @unnumberedsubsubsec Uso del @code{spanner-interface}
2508 Este interface proporciona dos propiedades que se aplican a varios
2511 @strong{@i{La propiedad @code{minimum-length}}}
2513 La longitud mínima del objeto de extensión se especifica a través de
2514 la propiedad @code{minimum-length}. Su aumento suele producir el
2515 efecto necesario de aumentar el espaciado de las notas entre los dos
2516 puntos extremos. Sin embargo, esta sobreescritura no tiene ningún
2517 efecto sobre muchos extensores, pues su longitud está determinada por
2518 otras consideraciones. Más abajo se muestran algunos ejemplos de
2529 Works as long as callback is made:
2533 Works not at all for:
2542 @lilypond[verbatim,quote,relative=2]
2545 % increase the length of the tie
2546 -\tweak #'minimum-length #5
2550 @lilypond[verbatim,quote,relative=2]
2552 \compressFullBarRests
2554 % increase the length of the rest bar
2555 \once \override MultiMeasureRest #'minimum-length = #20
2560 @lilypond[verbatim,quote,relative=2]
2562 % increase the length of the hairpin
2563 \override Hairpin #'minimum-length = #20
2567 Esta sobreescritura se puede usar también para aumentar la longitud de
2568 las ligaduras de expresión y de fraseo:
2570 @lilypond[verbatim,quote,relative=2]
2573 -\tweak #'minimum-length #5
2578 -\tweak #'minimum-length #5
2582 Para algunos objetos de presentación, la propiedad
2583 @code{minimum-length} es efectiva sólo si se llama explícitamente al
2584 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
2585 propiedad @code{springs-and-rods} al valor
2586 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
2587 de un glissando no tiene efecto a no ser que se establezca la
2588 propiedad @code{springs-and-rods}:
2590 @lilypond[verbatim,quote,relative=1]
2594 % not effective alone
2595 \once \override Glissando #'minimum-length = #20
2598 % effective only when both overrides are present
2599 \once \override Glissando #'minimum-length = #20
2600 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
2604 Lo mismo se puede decir del objeto @code{Beam}:
2606 @lilypond[verbatim,quote,relative=1]
2607 % not effective alone
2608 \once \override Beam #'minimum-length = #20
2611 % effective only when both overrides are present
2612 \once \override Beam #'minimum-length = #20
2613 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2617 @strong{@i{The @code{to-barline} property}}
2619 La segunda propiedad útil del @code{spanner-interface} es
2620 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2621 haciendo que los reguladores y otros objetos de extensión que terminan
2622 sobre la primera nota de un compás, en vez de eso terminen en la línea
2623 divisoria inmediatamente precedente. Si se establece al valor falso,
2624 el extensor llegará más allá de la barra de compás y terminará
2625 exactamente sobre la nota:
2627 @lilypond[verbatim,quote,relative=2]
2628 a \< a a a a \! a a a \break
2629 \override Hairpin #'to-barline = ##f
2630 a \< a a a a \! a a a
2633 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
2634 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2635 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2636 que terminar en la barra de compás no tendría ningún significado.
2638 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
2640 Entre los objetos que contemplan el interface
2641 @code{line-spanner-interface} se encuentran
2644 @item @code{DynamicTextSpanner}
2645 @item @code{Glissando}
2646 @item @code{TextSpanner}
2647 @item @code{TrillSpanner}
2648 @item @code{VoiceFollower}
2651 La rutina responsable de dibujar los sellos de estos extensores es
2652 @code{ly:line-interface::print}. esta rutina determina la
2653 localización exacta de los dos puntos extremos y traza una línea entre
2654 ellos, en el estilo solicitado. Las posiciones de los dos puntos
2655 extremos del extensor se calculan al vuelo, pero es posible
2656 sobreescribir sus coordenadas Y. Las propiedades que se deben
2657 especificar están anidadas a dos niveles de profundidad en la
2658 jerarquía de propiedades, pero la sintaxis de la instrucción
2659 @code{\override} es bastante sencilla:
2661 @lilypond[relative=2,quote,verbatim]
2663 \once \override Glissando #'(bound-details left Y) = #3
2664 \once \override Glissando #'(bound-details right Y) = #-2
2668 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2669 siendo el punto del cero la línea central del pentagrama. Para el
2670 glissando, esto es el valor de @code{Y} en la coordenada X que
2671 corresponde al punto central de cada cabeza de nota si nos imaginamos
2672 que la línea se extiende hasta allí.
2674 Si no está fijado @code{Y}, su valor se calcula a partir de la
2675 posición vertical del punto de anclaje correspondiente del extensor.
2677 En caso de salto de línea, los valores para los puntos extremos se
2678 especifican por las sub-listas @code{left-broken} y
2679 @code{right-broken} de @code{bound-details}. Por ejemplo:
2681 @lilypond[relative=2,ragged-right,verbatim,quote]
2682 \override Glissando #'breakable = ##t
2683 \override Glissando #'(bound-details right-broken Y) = #-3
2684 c1 \glissando \break
2688 Un número de propiedades adicionales de las sub-listas @code{left} y
2689 @code{right} de la propiedad @code{bound-details} se pueden
2690 especificar de la misma forma que @code{Y}:
2694 Establece la coordenada Y del punto extremo, en desplazamientos de
2695 @code{staff-space}s desde la línea central del pentagrama. De forma
2696 predeterminada es el centro del objeto ancla, y así un glissando
2697 apunta al centro vertical de la cabeza de la nota.
2699 Para extensores horizontales como los extensores de texto y los
2700 trinos, está inamoviblemente codificado como 0.
2702 @item attach-dir (dirección de anclaje)
2703 Determina dónde comienza y termina la línea en la dirección X, con
2704 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o @code{LEFT},
2705 izquierda) hace que la línea comience o termine en el lado izquierdo
2706 de la cabeza de la nota a la que está anclado.
2709 Es la coordenada X absoluta del punto extremo. Se suele calcular al
2710 vuelo, y su sobreescritura no tiene un efecto útil.
2712 @item stencil (sello)
2713 Los extensores de línea pueden tener símbolos al comienzo o al final,
2714 lo que está contenido en esta sub-propiedad. Esto es para uso
2715 interno; se recomienda en su lugar el uso de @code{text}.
2718 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
2719 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2720 de extensión horizontales.
2722 @lilypond[quote,ragged-right,relative=2,verbatim]
2723 \override TextSpanner #'(bound-details left text)
2724 = \markup { \small \bold Slower }
2725 c2\startTextSpan b c a\stopTextSpan
2728 @item stencil-align-dir-y (alineación del sello en y)
2729 @item stencil-offset (desplazamiento del sello)
2730 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2731 punto extremo, centrado sobre la línea, como viene definido por las
2732 subpropiedades @code{X} e @code{Y}. Si se fijan
2733 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2734 símbolo del borde verticalmente con relación al extremo de la línea:
2736 @lilypond[relative=1,quote,verbatim]
2737 \override TextSpanner
2738 #'(bound-details left stencil-align-dir-y) = #-2
2739 \override TextSpanner
2740 #'(bound-details right stencil-align-dir-y) = #UP
2742 \override TextSpanner
2743 #'(bound-details left text) = #"ggg"
2744 \override TextSpanner
2745 #'(bound-details right text) = #"hhh"
2746 c4^\startTextSpan c c c \stopTextSpan
2749 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2750 al contrario de lo que podría esperarse, pues el valor de @w{@code{-1}} o
2751 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
2752 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
2753 (arriba) alinea el borde superior del texto con la línea extensora.
2755 @item arrow (flecha)
2756 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
2757 flecha en el extremo de la línea.
2759 @item padding (relleno)
2760 Esta sub-propiedad controla el espacio entre el punto extremo
2761 especificado de la línea y el extremo real. Sin relleno, un glissando
2762 empezaría y terminaría en el centro de la cabeza de las notas.
2766 La función musical @code{\endSpanners} finaliza de forma prematura el
2767 extensor que comienza sobre la nota que sigue inmediatamente a
2768 continuación. Se termina después de una nota exactamente, o en la
2769 siguiente barra de compás si @code{to-barline} es verdadero y se
2770 produce una divisoria antes de la siguiente nota.
2772 @lilypond[verbatim,quote,ragged-right,relative=2]
2774 c2 \startTextSpan c2 c2
2779 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
2780 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
2783 Referencia de funcionamiento interno:
2784 @rinternals{TextSpanner},
2785 @rinternals{Glissando},
2786 @rinternals{VoiceFollower},
2787 @rinternals{TrillSpanner},
2788 @rinternals{line-spanner-interface}.
2791 @node Visibilidad de los objetos
2792 @subsection Visibilidad de los objetos
2793 @translationof Visibility of objects
2795 @cindex objetos, visibilidad de
2796 @cindex grobs, visibilidad de
2797 @cindex visibilidad de los objetos
2799 Hay cuatro formas principales en que se puede controlar la visibilidad
2800 de los objetos de presentación: se puede eliminar su sello, se pueden
2801 volver transparentes, se pueden pintar de blanco, o se puede
2802 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
2803 se aplican a todos los objetos de presentación; la última sólo a unos
2804 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
2805 introduce estas cuatro técnicas,
2806 véase @rlearning{Visibilidad y color de los objetos}.
2808 Hay también algunas otras técnicas que son específicas de ciertos
2809 objetos de presentación. Se estudian bajo Consideraciones especiales.
2812 * Eliminar el sello::
2813 * Hacer transparentes los objetos::
2814 * Pintar los objetos de blanco::
2815 * Uso de break-visibility (visibilidad en el salto)::
2816 * Consideraciones especiales::
2820 @node Eliminar el sello
2821 @unnumberedsubsubsec Eliminar el sello
2822 @translationof Removing the stencil
2824 @cindex sello, eliminar
2826 Todo objeto de presentación tiene una propiedad stencil (sello). De
2827 forma predeterminada está establecida a la función específica que
2828 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
2829 se llama a ninguna función y el objeto no se dibuja. La acción
2830 predeterminada se puede recuperar con @code{\revert}.
2832 @lilypond[quote,verbatim,relative=1]
2834 \override Score.BarLine #'stencil = ##f
2836 \revert Score.BarLine #'stencil
2841 @node Hacer transparentes los objetos
2842 @unnumberedsubsubsec Hacer transparentes los objetos
2843 @translationof Making objects transparent
2845 @cindex transparentes, hacer los objetos
2847 Todo objeto de presentación tiene una propiedad transparent
2848 (transparente) que de forma predeterminada está establecida a
2849 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
2852 @lilypond[quote,verbatim,relative=2]
2854 \once \override NoteHead #'transparent = ##t
2859 @node Pintar los objetos de blanco
2860 @unnumberedsubsubsec Pintar los objetos de blanco
2861 @translationof Painting objects white
2863 @cindex objetos, coloreado de
2864 @cindex coloreado de objetos
2866 @cindex impresión, orden de
2867 @cindex sobreescritura de objetos
2868 @cindex objetos, sobreescritura de
2869 @cindex grobs, sobreescritura de
2871 Todo objeto de presentación tiene una propiedad de color que de forma
2872 predeterminada está establecida a @code{black} (negro). Si se
2873 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
2874 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
2875 color de los puntos de cruce queda determinado por el orden en que se
2876 dibujan estos objetos, lo que puede dejar una imagen fantasma del
2877 objeto blanco, como puede verse aquí:
2879 @lilypond[quote,verbatim,relative=2]
2880 \override Staff.Clef #'color = #white
2884 Se puede evitar esto cambiando el orden de impresión de los objetos.
2885 Todos los objetos de presentación tienen una propiedad @code{layer}
2886 (capa) que se debe establecer a un valor entero. Los objetos con el
2887 valor de @code{layer} más bajo se dibujan primero, después se dibujan
2888 los objetos con valores progresivamente mayores, y así los objetos con
2889 valores más altos se dibujan encima de los que tienen valores más
2890 bajos. De forma predeterminada, casi todos los objetos tienen
2891 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
2892 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
2893 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
2894 impresión de los objetos con el mismo valor de @code{layer} es
2897 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
2898 predeterminado de @code{1}, se dibuja después de las líneas del
2899 pentagrama (valor @code{layer} predeterminado de @code{0}),
2900 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
2901 @code{Clef} un valor de @code{layer} más bajo, digamos @w{@code{-1}},
2902 para que se dibuje antes:
2904 @lilypond[quote,verbatim,relative=2]
2905 \override Staff.Clef #'color = #white
2906 \override Staff.Clef #'layer = #-1
2911 @node Uso de break-visibility (visibilidad en el salto)
2912 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
2913 @translationof Using break-visibility
2915 @c TODO Add making other objects breakable
2917 @cindex break-visibility
2919 Casi todos los objetos de presentación se imprimen una sola vez, pero
2920 algunos como las líneas divisorias, claves, indicaciones de compás y
2921 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
2922 se produce un salto de línea : una vez al final de la línea y otra al
2923 comienzo de la siguiente. Estos objetos reciben el nombre de
2924 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
2925 (visibilidad en el salto), para controlar su visibilidad en las tres
2926 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
2927 la línea si se produce un cambio, y al final de la línea si el cambio
2928 se produce en ese lugar.
2930 Por ejemplo, la indicación de compás se imprime de forma
2931 predeterminada al comienzo de la primera línea y en ningún otro lugar
2932 a no ser que cambie, en cuyo caso se imprime en el punto en que se
2933 produce el cambio. Si este cambio se produce al final de una línea,
2934 la nueva indicación de compás se imprime al principio de la línea
2935 siguiente y también al final de la línea anterior como indicación de
2938 Este comportamiento se controla por medio de la propiedad
2939 @code{break-visibility}, que se explica en
2940 @c Leave this ref on a newline - formats incorrectly otherwise -td
2941 @rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
2942 vector de tres valores booleanos que, por orden, determinan si el
2943 objeto se imprime al final, dentro, o al principio de la línea. O,
2944 para ser más exactos: antes del salto de línea, si no hay salto, o
2947 Como alternativa se puede especificar cualquiera de las ocho
2948 combinaciones mediante funciones predefinidas cuya definición está en
2949 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
2950 los objetos de presentación serán visibles en las posiciones que se
2951 muestran en el encabezamiento de cada columna:
2953 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {yes} {yes} {yes}
2954 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
2955 @headitem de función @tab de vector @tab salto @tab salto @tab salto
2957 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
2958 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
2959 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
2960 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
2961 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
2962 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
2963 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
2964 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
2967 Los ajustes predeterminados de @code{break-visibility} dependen del
2968 objeto de presentación. La tabla siguiente muestra todos los objetos
2969 de presentación de interés que resultan afectados por
2970 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
2972 @multitable @columnfractions .3 .3 .4
2974 @headitem Objeto @tab Contexto usual @tab Valor predet.
2976 @c omit Ambitus as it appears not to be affected by break-visibility -td
2977 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
2978 @item @code{BarLine} @tab @code{Score} @tab calculado
2979 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
2980 @c omit the following item until it can be explained -td
2981 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
2982 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2983 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
2984 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
2985 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2986 @c omit KeyCancellation until it can be explained -td
2987 @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible}
2988 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
2989 @c omit LeftEdge until it can be explained -td
2990 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
2991 @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible}
2992 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
2993 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
2997 El ejemplo de abajo muestra el uso de la forma de vector para
2998 controlar la visibilidad de las líneas divisorias:
3000 @lilypond[quote,verbatim,relative=1,ragged-right]
3003 % Remove bar line at the end of the current line
3004 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
3010 Aunque los tres componentes del vector utilizado para sobreescribir
3011 @code{break-visibility} deben estar presentes, no todos son efectivos
3012 para todos los objetos de presentación, y algunas combinaciones pueden
3013 incluso dar errores. Son de aplicación las siguientes limitaciones:
3016 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
3017 @item No se puede imprimir el número de compás al principio de la primera
3018 línea a no ser que su valor establecido sea distinto de 1.
3019 @item Clave: véase más abajo
3020 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
3021 se suprimen por completo. Utilice begin-of line-invisible para
3022 imprimirlas y all-invisible para suprimirlas.
3023 @item Armadura: véase más abajo
3024 @item OctavateEight: véase más abajo
3028 @node Consideraciones especiales
3029 @unnumberedsubsubsec Consideraciones especiales
3030 @translationof Special considerations
3032 @strong{@emph{Visibilidad después de un cambio explícito}}
3034 @cindex armadura, visibilidad después de un cambio explícito
3035 @cindex explicitKeySignatureVisibility
3036 @cindex clave, visibilidad después de un cambio explícito
3037 @cindex explicitClefVisibility
3039 La propiedad @code{break-visibility} controla la visibilidad de las
3040 armaduras y cambios de clave sólo al principio de las líneas, es
3041 decir, después de un salto. No tiene ningún efecto sobre la
3042 visibilidad de la armadura o la clave después de un cambio explícito
3043 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
3044 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
3045 bemol mayor es visible incluso con @code{all-invisible} establecido.
3047 @lilypond[quote,verbatim,relative=1,ragged-right]
3050 % Try to remove all key signatures
3051 \override Staff.KeySignature #'break-visibility = #all-invisible
3059 La visibilidad de estos cambios explícitos de tonalidad y de clave se
3060 controla por medio de las propiedades
3061 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
3062 Son los equivalentes de la propiedad @code{break-visibility} y las dos
3063 toman un vector de tres valores booleanos o las funciones predefinidas
3064 relacionadas anteriormente, exactamente igual que
3065 @code{break-visibility}. Las dos son propiedades del contexto Staff,
3066 no de los propios objetos de presentación, y por tanto se establecen
3067 utilizando la instrucción @code{\set}. Las dos están establecidas de
3068 forma predeterminada al valor @code{all-visible}. Estas propiedades
3069 controlan sólo la visibilidad de las armaduras y las claves que
3070 resultan de los cambios explícitos y no afectan a las armaduras y
3071 tonalidades que están al principio de las líneas; para quitarlas, aún
3072 se debe sobreescribir la propiedad @code{break-visibility} en el
3073 objeto correspondiente.
3075 @lilypond[quote,verbatim,relative=1,ragged-right]
3078 \set Staff.explicitKeySignatureVisibility = #all-invisible
3079 \override Staff.KeySignature #'break-visibility = #all-invisible
3086 @strong{@emph{Visibilidad de las alteraciones de precaución}}
3088 Para eliminar las alteraciones de precaución que se imprimen en un
3089 cambio de tonalidad explícito, establezca la propiedad
3090 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3092 @lilypond[quote,verbatim,relative=1,ragged-right]
3095 \set Staff.explicitKeySignatureVisibility = #all-invisible
3096 \set Staff.printKeyCancellation = ##f
3097 \override Staff.KeySignature #'break-visibility = #all-invisible
3104 Con estas sobreescrituras solamente permanecen las alteraciones
3105 accidentales delante de las notas para indicar el cambio de tonalidad.
3107 @c TODO Add visibility of cautionary accidentals before notes
3109 @strong{@emph{Automatic bars}}
3111 @cindex automaticBars
3112 @cindex líneas divisorias, eliminación
3114 Como caso especial, la impresión de las líneas divisorias también se
3115 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
3116 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
3117 imprimen automáticamente; se deben crear explícitamente con una
3118 instrucción @code{\bar}. A diferencia de la instrucción predefinida
3119 @code{\cadenzaOn}, los compases se siguen contando. La generación de
3120 compases continúa de acuerdo a esta cuenta si esta propiedad se
3121 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
3122 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
3127 @strong{@emph{Octavated clefs}}
3129 @cindex octavadas, visibilidad de las claves
3130 @cindex visibilidad de las claves octavadas
3131 @cindex claves, visibilidad de la octavación
3133 El pequeño símbolo de octava sobre las claves en octava alta o baja se
3134 produce por parte del objeto @code{OctavateEight}. Su visibilidad se
3135 hereda automáticamente de la del objeto @code{Clef}, así que no es
3136 necesario aplicar las sobreescrituras correspondientes
3137 @code{break-visibility} a los objetos
3138 @code{OctavateEight} para suprimir los símbolos de octavación
3139 para las claves invisibles.
3141 Para los cambios de clave explícitos, la propiedad
3142 @code{explicitClefVisibility} controla tanto el símbolo de clave como
3143 el símbolo de octava asociado.
3146 Manual de aprendizaje:
3147 @rlearning{Visibilidad y color de los objetos}
3150 @node Estilos de línea
3151 @subsection Estilos de línea
3152 @translationof Line styles
3154 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3155 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
3156 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
3158 Todos ellos usan las mismas rutinas que el glissando para dibujar los
3159 textos y las líneas, y por ello el ajuste fino de su comportamiento se
3160 hace de la misma manera. Se hace con un spanner (un objeto de
3161 extensión), y la rutina responsable de dibujar los objetos de
3162 extensión es @code{ly:line-interface::print}. Esta rutina determina la
3163 colocación exacta de los dos @i{extremos del objeto de extensión} y
3164 dibuja una línea entre ellos, en el estilo solicitado.
3166 He aquí un ejemplo de los distintos estilos de línea disponibles, y
3167 cómo aplicarles ajustes finos.
3169 @lilypond[relative=2,ragged-right,verbatim,quote]
3171 \once \override Glissando #'style = #'dashed-line
3173 \override Glissando #'style = #'dotted-line
3175 \override Glissando #'style = #'zigzag
3177 \override Glissando #'style = #'trill
3181 Las posiciones de los puntos extremos del objeto de extensión se
3182 computan al vuelo para cada uno de los objetos gráficos, pero es
3183 posible sobreescribirlos:
3186 @lilypond[relative=2,ragged-right,verbatim,quote]
3188 \once \override Glissando #'(bound-details right Y) = #-2
3192 El valor de @code{Y} está establecido a @w{@code{-2}} para el extremo
3193 derecho. El lado izquierdo se puede ajustar de forma similar
3194 especificando @code{left} en vez de @code{right}.
3196 Si no está establecido @code{Y}, el valor se computa a partir de la
3197 posición vertical de los puntos de anclaje izquierdo y derecho del
3200 Son posibles otros ajustes de los extensores, para ver más detalles
3201 consulte @ref{Objetos de extensión}.
3204 @node Rotación de objetos
3205 @subsection Rotación de objetos
3206 @translationof Rotating objects
3208 Tanto los objetos de presentación como los elementos de texto de
3209 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
3210 pero difiere el método de hacerlo.
3213 * Rotación de objetos de presentación::
3214 * Rotación de elementos de marcado::
3217 @node Rotación de objetos de presentación
3218 @unnumberedsubsubsec Rotación de objetos de presentación
3219 @translationof Rotating layout objects
3221 @cindex rotating objects
3222 @cindex objects, rotating
3224 Todos los objetos de presentación que contemplan el interface
3225 @code{grob-interface} se pueden rotar estableciendo su propiedad
3226 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
3227 rotación en sentido antihorario, y las coordenadas x e y del punto con
3228 relación al punto de referencia del objeto, alrededor del que se va a
3229 realizar la rotación. El ángulo de rotación se especifica en grados
3230 y las coordenadas en espacios de pentagrama.
3232 El ángulo de rotación y las coordenadas del punto de rotación se deben
3233 determinar por ensayo y error.
3235 @cindex reguladores en ángulo
3236 @cindex ángulo, reguladores en
3238 Solamente en ciertas ocasiones es útil la rotación de objetos de
3239 presentación; el ejemplo siguiente muestra una situación en que puede
3242 @lilypond[quote,verbatim,relative=1]
3244 \override Hairpin #'rotation = #'(20 -1 0)
3249 @node Rotación de elementos de marcado
3250 @unnumberedsubsubsec Rotación de elementos de marcado
3251 @translationof Rotating markup
3253 Todos los textos de marcado se pueden rotar para que se dispongan en
3254 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
3255 instrucción acepta dos argumentos: el ángulo de rotación en grados en
3256 sentido antihorario, y el texto que rotar. Los límites que ocupa el
3257 texto no se rotan: toman su valor a partir de los extremos de las
3258 coordenadas x e y del texto rotado. En el ejemplo siguiente la
3259 propiedad @code{outside-staff-priority} del texto se establece a
3260 @code{#f} para desactivar la evitación automática de colisiones, lo
3261 que empuja al texto a una posición muy alta.
3263 @lilypond[quote,verbatim,relative=1]
3264 \override TextScript #'outside-staff-priority = ##f
3265 g4^\markup { \rotate #30 "a G" }
3266 b^\markup { \rotate #30 "a B" }
3267 des^\markup { \rotate #30 "a D-Flat" }
3268 fis^\markup { \rotate #30 "an F-Sharp" }
3272 @node Trucos avanzados
3273 @section Trucos avanzados
3274 @translationof Advanced tweaks
3276 Esta sección trata sobre distintos enfoques en la realización de
3277 ajustes finos a la apariencia de la partitura impresa.
3280 * Alineación de objetos::
3281 * Agrupación vertical de objetos gráficos::
3282 * Modificación de los sellos::
3283 * Modificación de las formas::
3284 * Contenedores unpure-pure::
3288 Manual de aprendizaje:
3289 @rlearning{Trucar la salida},
3290 @rlearning{Otras fuentes de información}.
3292 Referencia de la notación:
3293 @ref{Explicación del Manual de referencia de funcionamiento interno},
3294 @ref{Modificar las propiedades}.
3296 Manual de extensión:
3297 @rextend{Interfaces para programadores}.
3300 @file{scm/define-grobs.scm}.
3302 Fragmentos de código:
3303 @rlsr{Tweaks and overrides}.
3305 Referencia de funcionamiento interno:
3306 @rinternals{All layout objects}.
3309 @node Alineación de objetos
3310 @subsection Alineación de objetos
3311 @translationof Aligning objects
3313 Los objetos gráficos que soportan el interface
3314 @code{self-alignment-interface} y/o el @code{side-position-interface}
3315 se pueden alinear contra un objeto colocado previamente, de diversas
3316 maneras. Para ver una lista de estos objetos, consulte
3317 @rinternals{self-alignment-interface} y
3318 @rinternals{side-position-interface}.
3320 Todos los objetos gráficos tienen un punto de referencia, una
3321 extensión horizontal y una extensión vertical. La extensión
3322 horizontal es una pareja de números que dan los desplazamientos a
3323 partir del punto de referencia de los bordes izquierdo y derecho,
3324 siendo negativos los desplazamientos hacia la izquierda. La extensión
3325 vertical es una pareja de números que dan el desplazamiento a partir
3326 del punto de referencia hasta los bordes inferior y superior, siendo
3327 negativos los desplazamientos hacia abajo.
3329 La posición de un objeto sobre el pentagrama viene dada por los
3330 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
3331 valor de @code{X-offset} da el desplazamiento desde la coordenada X
3332 del punto de referencia del objeto padre, y el valor de
3333 @code{Y-offset} da el desplazamiento a partir de la línea central del
3334 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
3335 pueden establecer directamente o se puede dejar que se calculen por
3336 parte de procedimientos para conseguir una alineación con el objeto
3339 @warning{Muchos objetos tienen consideraciones de posicionamiento
3340 especiales que hacen que se ignore o se modifique cualquier ajuste
3341 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
3342 objeto contemple el interface @code{self-alignment-interface}. La
3343 sobreescritura de las propiedades @code{X-offset} ó @code{Y-offset} a
3344 un valor fijo hace que se descarte la respectiva propiedad
3345 @code{self-alignment}.}
3347 Por ejemplo, una alteración accidental se puede reposicionar
3348 verticalmente estableciendo @code{Y-offset} pero los cambios a
3349 @code{X-offset} no tienen ningún efecto.
3351 Las letras de ensayo se pueden alinear con objetos divisibles como
3352 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
3353 propiedades especiales que se encuentran en
3354 @code{break-aligned-interface} para el posicionamiento de las letras
3355 de ensayo sobre dichos objetos.
3358 Referencia de la notación:
3359 @ref{Uso del break-alignable-interface}.
3361 Manual de extensión:
3362 @rextend{Funciones de callback}.
3365 * Establecer directamente X-offset e Y-offset::
3366 * Uso del side-position-interface::
3367 * Uso del self-alignment-interface::
3368 * Uso del break-alignable-interface::
3372 @node Establecer directamente X-offset e Y-offset
3373 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
3374 @translationof Setting X-offset and Y-offset directly
3376 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
3377 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
3378 notas con una digitación en su posición predeterminada y con los
3379 valores @code{X-offset} y @code{Y-offset} modificados.
3381 @lilypond[verbatim,quote,relative=2]
3384 -\tweak #'X-offset #0
3385 -\tweak #'Y-offset #0
3388 -\tweak #'X-offset #-1
3389 -\tweak #'Y-offset #1
3396 @node Uso del side-position-interface
3397 @unnumberedsubsubsec Uso del @code{side-position-interface}
3398 @translationof Using the side-position-interface
3400 Un objeto que contempla el @code{side-position-interface} se puede
3401 colocar junto a su objeto padre de forma que los bordes especificados
3402 de los dos objetos se toquen. El objeto se puede situar encima,
3403 debajo, a la derecha o a la izquierda del objeto padre. El padre no
3404 se puede especificar; viene determinado por el orden de los elementos
3405 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
3406 nota asociada como padre.
3408 Los valores de las propiedades @code{side-axis} y @code{direction}
3409 determinan dónde colocar el objeto, como sigue:
3411 @c TODO add an example of each to the table
3413 @multitable @columnfractions .3 .3 .3
3414 @headitem @code{side-axis} @tab @code{direction} @tab
3415 @headitem propiedad @tab propiedad @tab colocación
3417 @item @code{0} @tab @w{@code{-1}} @tab izquierda
3418 @item @code{0} @tab @code{1} @tab derecha
3419 @item @code{1} @tab @w{@code{-1}} @tab debajo
3420 @item @code{1} @tab @code{1} @tab encima
3424 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
3425 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
3426 procedimiento devuelve el calor correcto de @code{X-offset} para
3427 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
3428 el valor de @code{direction}.
3430 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
3431 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
3432 procedimiento devuelve el valor correcto de @code{Y-offset} para
3433 situar el objeto encima o debajo del padre de acuerdo con el valor de
3436 @c TODO Add examples
3439 @node Uso del self-alignment-interface
3440 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
3441 @translationof Using the self-alignment-interface
3443 @emph{Auto-alineación horizontal de los objetos}
3445 La alineación horizontal de un objeto que contempla el interface
3446 @code{self-alignment-interface} está controlada por el valor de la
3447 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
3448 @code{X-offset} de este objeto esté establecida a
3449 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
3450 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
3451 mitad de la extensión X total del objeto. Los valores negativos
3452 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
3453 valor de @code{0} centra el objeto sobre el punto de referencia de su
3454 padre, un valor de @w{@code{-1}} alinea el borde izquierdo del objeto
3455 sobre el punto de referencia de su padre, y un valor de @code{1}
3456 alinea el borde derecho del objeto sobre el punto de referencia de su
3457 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
3458 @code{RIGHT} en sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
3461 Normalmente se usaría la instrucción @code{\override} para modificar
3462 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
3463 @code{\tweak} para alinear varias anotaciones por separado sobre una
3466 @lilypond[quote,verbatim,relative=1]
3468 -\tweak #'self-alignment-X #-1
3470 -\tweak #'self-alignment-X #0
3472 -\tweak #'self-alignment-X #RIGHT
3474 -\tweak #'self-alignment-X #-2.5
3475 ^"aligned further to the right"
3478 @emph{Auto-alineación vertical de los objetos}
3480 Los objetos se pueden alinear verticalmente en una forma análoga a la
3481 alineación horizontal si la propiedad @code{Y-offset} está establecida
3482 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
3483 a menudo se encuentran implicados otros mecanismos en la alineación
3484 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
3485 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
3486 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
3487 las dimensiones verticales del objeto, que suele ser bastante pequeño,
3488 por lo que pueden requerirse números bastante grandes. Un valor de
3489 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
3490 referencia del objeto padre, un valor de @code{0} alinea el centro del
3491 objeto con el punto de referencia del padre, y un valor de @code{1}
3492 alinea el borde superior del objeto con el punto de referencia del
3493 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
3494 @code{UP} en sustitución de @w{@code{-1}},
3495 @code{0} y @code{1}, respectivamente.
3497 @emph{Auto-alineación de objetos en las dos direcciones}
3499 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
3500 alinear un objeto en las dos direcciones simultáneamente.
3502 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
3503 se acerque a la cabeza de la nota.
3505 @lilypond[quote,verbatim,relative=2]
3507 -\tweak #'self-alignment-X #0.5 % move horizontally left
3508 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
3509 -\tweak #'self-alignment-Y #-1 % move vertically up
3514 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
3516 @c Cannot document as they do not seem to operate consistently on all objects -td
3517 @c TODO investigate further
3519 The @code{aligned-on-parent} procedures are used in the same way
3520 as the @code{aligned-on-self} procedures, they difference being
3521 that they permit an object to be aligned with the @emph{edges} of
3522 the parent rather than the parent's reference point. The following
3523 example shows the difference:
3527 @lilypond[verbatim,quote]
3533 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
3535 @c Cannot document as they do not seem to operate consistently on all objects -td
3536 @c TODO investigate further
3540 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
3543 @node Uso del break-alignable-interface
3544 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
3545 @translationof Using the break-alignable-interface
3547 @cindex alineación a objetos
3548 @cindex break-align-symbols
3550 Las letras de ensayo se pueden alinear con objetos de notación
3551 distintos a las barras de compás. Estos objetos son @code{ambitus},
3552 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
3553 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
3554 @code{time-signature}.
3556 De forma predeterminada, las letras de ensayo y los números de compás
3557 se centran horizontalmente sobre el objeto:
3559 @lilypond[verbatim,quote,relative=1]
3560 % The rehearsal mark will be centered above the Clef
3561 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
3566 % The rehearsal mark will be centered above the Time Signature
3567 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
3573 % The rehearsal mark will be centered above the Breath Mark
3574 \override Score.RehearsalMark #'break-align-symbols = #'(breathing-sign)
3583 Se puede especificar una lista de posibles objetos para la alineación.
3584 Si algunos de los objetos son invisibles en ese punto debido al valor
3585 de @code{break-visibility} o a valores de visibilidad explícitos para
3586 las armaduras y las claves, la letra de ensayo o número de compás se
3587 alinean con el primer objeto de la lista que sea visible. Si ningún
3588 objeto de la lista es visible, el objeto se alinea con la línea
3589 divisoria. Si la línea divisoria es invisible, el objeto se alinea
3590 con el punto en el que se encontraría la línea divisoria.
3592 @lilypond[verbatim,quote,relative=1]
3593 % The rehearsal mark will be centered above the Key Signature
3594 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3599 % The rehearsal mark will be centered above the Clef
3600 \set Staff.explicitKeySignatureVisibility = #all-invisible
3601 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3606 % The rehearsal mark will be centered above the Bar Line
3607 \set Staff.explicitKeySignatureVisibility = #all-invisible
3608 \set Staff.explicitClefVisibility = #all-invisible
3609 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3616 La alineación de la letra de ensayo con relación al objeto de notación
3617 se puede cambiar, como se ve en el ejemplo siguiente. En una
3618 partitura con varios pentagramas, este ajuste se debe hacer para todos
3621 @lilypond[verbatim,quote,relative=1]
3622 % The RehearsalMark will be centered above the Key Signature
3623 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3629 % The RehearsalMark will be aligned with the left edge of the Key Signature
3630 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
3634 % The RehearsalMark will be aligned with the right edge of the Key Signature
3635 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
3641 La letra de ensayo también se puede desplazar al borde derecho o
3642 izquierdo en una medida arbitraria. Las unidades son espacios de
3645 @lilypond[verbatim,quote,relative=1]
3646 % The RehearsalMark will be aligned with the left edge of the Key Signature
3647 % and then shifted right by 3.5 staff-spaces
3648 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3649 \once \override Score.KeySignature #'break-align-anchor = #3.5
3653 % The RehearsalMark will be aligned with the left edge of the Key Signature
3654 % and then shifted left by 2 staff-spaces
3655 \once \override Score.KeySignature #'break-align-anchor = #-2
3662 @node Agrupación vertical de objetos gráficos
3663 @subsection Agrupación vertical de objetos gráficos
3664 @translationof Vertical grouping of grobs
3666 @c TODO Expand this section
3668 Los grobs (objetos gráficos) @code{VerticalAlignment} y
3669 @code{VerticalAxisGroup} trabajan de manera coordinada.
3670 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
3671 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
3672 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
3673 Normalmente sólo existe un @code{VerticalAlignment} por cada
3674 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
3675 @code{VerticalAxisGroup}.
3678 @node Modificación de los sellos
3679 @subsection Modificación de los sellos
3680 @translationof Modifying stencils
3682 Todos los objetos de presentación tienen una propiedad @code{stencil}
3683 que es parte del @code{grob-interface}. De forma predeterminada, esta
3684 propiedad suele estar establecida a una función específica del objeto
3685 que está hecha a medida para disponer el símbolo que lo representa en
3686 la salida. Por ejemplo, el ajuste estándar para la propiedad
3687 @code{stencil} del objeto @code{MultiMeasureRest} es
3688 @code{ly:multi-measure-rest::print}.
3690 El símbolo estándar de cualquier objeto se puede sustituir modificando
3691 la propiedad @code{stencil} para que haga referencia a un
3692 procedimiento diferente escrito especialmente. Esto requiere un alto
3693 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3694 una forma más fácil que a menudo puede dar resultados adecuados.
3696 El procedimiento es establecer la propiedad @code{stencil} al
3697 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3698 añadir una propiedad @code{text} al objeto ajustada para que contenga
3699 el texto de marcado que produce el símbolo requerido. Debido a la
3700 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3701 particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
3703 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3704 la nota a unas aspas dentro de una circunferencia.
3706 @lilypond[verbatim,quote]
3708 \once \override NoteHead #'stencil = #ly:text-interface::print
3709 \once \override NoteHead #'text = \markup {
3711 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3712 \musicglyph #"noteheads.s2cross"
3720 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3721 a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
3723 @c TODO Add inserting eps files or ref to later
3725 @c TODO Add inserting Postscript or ref to later
3728 Referencia de la notación:
3729 @ref{Notación gráfica dentro de elementos de marcado},
3730 @ref{Formatear el texto},
3731 @ref{Text markup commands},
3732 @ref{La tipografía Feta}.
3735 @node Modificación de las formas
3736 @subsection Modificación de las formas
3737 @translationof Modifying shapes
3740 * Modificación de ligaduras de unión y de expresión::
3744 @node Modificación de ligaduras de unión y de expresión
3745 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
3746 @translationof Modifying ties and slurs
3748 @cindex ligaduras de expresión, modificar
3749 @cindex ligaduras de unión, modificar
3750 @cindex Bézier, curvas de, puntos de control
3751 @cindex puntos de control en curvas de Bézier
3753 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
3754 de Bézier de tercer orden. Si la forma de la ligadura calculada
3755 automáticamente no resulta óptima, se puede modificar su forma
3756 manualmente mediante la especificación explícita de los cuatro puntos
3757 de control necesarios para definir una curva de Bézier de tercer
3760 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
3761 puntos de control. El primer y cuarto puntos de control son
3762 exactamente los puntos extremos de comienzo y de final de la curva.
3763 Los dos puntos de control intermedios definen la forma. Se pueden
3764 encontrar en la web animaciones que muestran cómo se traza la curva,
3765 pero la descripción siguiente puede ser de ayuda. La curva comienza a
3766 partir del primer punto de control dirigiéndose directamente hacia el
3767 segundo, curvándose progresivamente para dirigirse hacia el tercero y
3768 continuando la curva hacia el cuarto, llegando a éste en viaje directo
3769 desde el tercer punto de control. La curva está contenida enteramente
3770 dentro del cuadrilátero definido por los cuatro puntos de control.
3772 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
3773 @code{\tieDown} no sirve de ayuda.
3775 @lilypond[verbatim,quote,relative=1]
3779 { r4 <g c,> <g c,> <g c,> }
3783 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
3784 de control como sigue.
3786 Las coordenadas de los puntos de control de Bézier se especifican en
3787 unidades de espacios de pentagrama. La coordenada@tie{}X está en
3788 relación con el punto de referencia de la nota a la que está unida la
3789 ligadura, y la coordenada@tie{}Y está en relación con la línea central
3790 del pentagrama. Las coordenadas se introducen como una lista de
3791 cuatro parejas de números decimales (reales). Un enfoque es estimar
3792 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
3793 los dos puntos intermedios. Los valores óptimos se encuentran por
3796 Es útil recordar que una curva simétrica necesita puntos de control
3797 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
3798 las transformaciones de la curva tales como la traslación, rotación y
3799 escalado se pueden obtener aplicando la misma transformación a los
3800 puntos de control de la curva.
3802 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
3803 satisfactoria. Observe la colocación: debe ir inmediatamente antes de
3804 la nota a la que se asigna el comienzo de la ligadura de expresión o
3807 @lilypond[verbatim,quote,relative=1]
3811 #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
3815 { r4 <g c,> <g c,> <g c,> }
3820 No es posible modificar la forma de las ligaduras de unión o de
3821 expresión cambiando la propiedad @code{control-points} si hay más de
3822 una en el mismo momento musical, ni siquiera usando la instrucción
3823 @code{\tweak}. Sin embargo, se puede sobreescribir la propiedad
3824 @code{tie-configuration} de @code{TieColumn} para fijar la línea de
3825 inicio y la dirección según se requiera.
3828 Referencia de funcionamiento interno:
3829 @rinternals{TieColumn}.
3831 @cindex Scheme, contenedores puros
3832 @cindex Scheme, contenedores no-puros
3833 @cindex puros, contenedores de Scheme
3834 @cindex no-puros: contenedores de Scheme
3835 @cindex horizontal, sobreescribir el espaciado
3838 @node Contenedores unpure-pure
3839 @subsection Contenedores unpure-pure
3840 @translationof Unpure-pure containers
3842 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para la
3843 sobreescritura de los cálculos del espaciado en el @emph{eje Y}
3844 (concretamente @code{Y-offset} e @code{Y-extent}) con una función de
3845 Scheme en lugar de un literal, es decir, un número o una pareja de
3848 Para ciertos objetos gráficos, las dimensiones @code{Y-extent} están
3849 basadas en la propiedad @code{stencil}, la sobreescritura de la
3850 propiedad de sello de éstos requiere una sobreescritura adicional de
3851 @code{Y-extent} con un contenedor unpure-pure. Cuando una función
3852 sobreescribe una dimensión @code{Y-offset} y/o @code{Y-extent} se
3853 supone que esto dispara los cálculos de los saltos de línea
3854 prematuramente durante la compilación. Así pues, la función no se
3855 evalúa en absoluto (devolviendo por lo general un valor de @samp{0} o
3856 @samp{'(0 . 0)}) lo que puede dar lugar a colisiones. Una función
3857 @q{pura} no afecta a las propiedades, objetos o suicidios de grobs, y
3858 por ello siempre ven sus valores relacionados con el eje Y evaluados
3861 Actualmente hay unas treinta funciones que ya se consideran @q{puras}
3862 y los contenedores Unpure-pure son una manera de establecer funciones
3863 que no están en esta lista como @q{puras}. La función @q{pura} se
3864 evalúa @emph{antes} de cualquier salto de línea y así el espaciado
3865 horizontal se puede ajustar @q{a tiempo}. La función @q{impura} se
3866 evalúa entonces @emph{después} del salto de línea.
3868 @warning{Dado que es difícil saber siempre qué funciones están en esta
3869 lista, recomendamos que cualquier función @q{pura} que estemos creando
3870 no utilice los grobs @code{Beam} o @code{VerticalAlignment}.}
3872 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
3874 @code{(ly:make-unpure-pure-container f0 f1)}
3876 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
3877 1}) y el primer argumento siempre debe ser el grob. Ésta es la
3878 función que da el resultado real. @var{f1} es la función que se
3879 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
3880 primer argumento debe ser siempre el grob pero los argumentos segundo
3881 y tercero son argumentos de @q{inicio} y de @q{final}.
3883 @var{inicio} y @var{final} son, a todos los efectos, valores mudos que
3884 sólo tienen importancia para los @code{objetos de extensión} (o sea:
3885 @code{Hairpin}, regulador, o @code{Beam}, barra), que pueden devolver
3886 distintas estimaciones de altura basadas en una columna de inicio y
3889 El resto son los otros argumentos para la primera función (que puede
3890 no ser ninguno si @var{n = 1}).
3892 El resultado de la segunda función se usa como una aproximación del
3893 valor necesario, que se usa entonces por la primera función para
3894 obtener el valor real que se usa a continuación para el ajuste de
3895 precisión mucho más tardío durante el proceso de espaciado.
3897 @lilypond[verbatim,quote,ragged-right]
3898 #(define (square-line-circle-space grob)
3899 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
3900 (notename (ly:pitch-notename pitch)))
3901 (if (= 0 (modulo notename 2))
3902 (make-circle-stencil 0.5 0.0 #t)
3903 (make-filled-box-stencil '(0 . 1.0)
3906 squareLineCircleSpace = {
3907 \override NoteHead #'stencil = #square-line-circle-space
3910 smartSquareLineCircleSpace = {
3911 \squareLineCircleSpace
3912 \override NoteHead #'Y-extent =
3913 #(ly:make-unpure-pure-container
3914 ly:grob::stencil-height
3915 (lambda (grob start end) (ly:grob::stencil-height grob)))
3918 \new Voice \with { \remove "Stem_engraver" }
3920 \squareLineCircleSpace
3922 \smartSquareLineCircleSpace
3927 En el primer compás, sin el contenedor @emph{unpure-pure}, el motor de
3928 espaciado no conoce la anchura de la cabeza de la nota y permite que
3929 colisione con las alteraciones accidentales. En el segundo compás, el
3930 motor de espaciado conoce la anchura de las cabezas de las notas y
3931 evita la colisión mediante el alargamiento de la línea en la medida
3934 Normalmente, para cálculos simples se pueden usar funciones casi
3935 idénticas tanto para las partes @q{no pura} y @q{pura}, simplemente
3936 cambiando el número de argumentos que se pasan a, y el ámbito de, la
3939 @warning{Si una función está caracterizada como @q{pura} y resulta que
3940 no lo es, el resultado puede ser inesperado.}
3943 @node Uso de las funciones musicales
3944 @section Uso de las funciones musicales
3945 @translationof Using music functions
3947 @c TODO -- add @seealso, etc. to these subsections
3949 Dondequiera que se necesite reutilizar trucos con distintas
3950 expresiones musicales, con frecuencia conviene hacer que el truco
3951 forme parte de una @emph{función musical}. En esta sección
3952 estudiaremos solamente las funciones de @emph{sustitución}, en las que
3953 el objeto es sustituir una variable dentro de un fragmento de código
3954 de entrada de LilyPond. Se describen otras funciones más complejas en
3955 @rextend{Funciones musicales}.
3958 * Sintaxis de las funciones de sustitución::
3959 * Ejemplos de funciones de sustitución::
3963 @node Sintaxis de las funciones de sustitución
3964 @subsection Sintaxis de las funciones de sustitución
3965 @translationof Substitution function syntax
3967 Es fácil hacer una función que sustituya una variable dentro de código
3968 de LilyPond. La forma general de estas funciones es
3972 #(define-music-function
3973 (parser location @var{arg1} @var{arg2} @dots{})
3974 (@var{type1?} @var{type2?} @dots{})
3976 @var{@dots{}música@dots{}}
3983 @multitable @columnfractions .33 .66
3984 @item @code{@var{argN}}
3985 @tab @var{n}-ésimo argumento
3987 @item @code{@var{typeN?}}
3988 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
3989 debe devolver @code{#t}.
3991 @item @code{@var{@dots{}música@dots{}}}
3992 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
3993 lugares en que sólo se permiten construcciones de Lilypond) o @code{#}
3994 (para usarlo como un valor de Scheme o un argumento de función
3995 musical) para referenciar argumentos (p.ej. @samp{#arg1}).
3998 Los argumentos @code{parser} y @code{location} son necesarios, y se
3999 utilizan en algunas situaciones avanzadas como se encuentra descrito
4000 en @rextend{Sintaxis de las funciones musicales}. Para las funciones
4001 de sustitución, tan sólo hemos de asegurarnos de incluirlos.
4003 También es necesaria la lista de predicados de tipo. Algunos de los
4004 predicados de tipo más comunes que se utilizan en las funciones
4009 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
4021 Para ver una lista de los predicados de tipo disponibles, consulte
4022 @ref{Predicados de tipo predefinidos}. También se permiten los
4023 predicados de tipo definidos por el usuario.
4026 Referencia de la notación:
4027 @ref{Predicados de tipo predefinidos}.
4029 Expansión de LilyPond:
4030 @rextend{Sintaxis de las funciones musicales}.
4032 Archivos instalados:
4033 @file{lily/music-scheme.cc},
4035 @file{scm/lily.scm}.
4038 @node Ejemplos de funciones de sustitución
4039 @subsection Ejemplos de funciones de sustitución
4040 @translationof Substitution function examples
4042 Esta sección presenta algunos ejemplos de funciones de sustitución.
4043 No pretenden ser exhaustivas, sino demostrar algunas de las
4044 posibilidades de las funciones de sustitución sencillas.
4046 En el primer ejemplo se define una función que simplifica el ajuste
4047 del relleno de un elemento de inscripción de texto TextScript:
4049 @lilypond[quote,verbatim,ragged-right]
4051 #(define-music-function
4052 (parser location padding)
4055 \once \override TextScript #'padding = #padding
4059 c4^"piu mosso" b a b
4061 c4^"piu mosso" d e f
4063 c4^"piu mosso" fis a g
4067 Además de números, podemos usar expresiones musicales, como notas,
4068 para los argumentos de las funciones musicales:
4070 @lilypond[quote,verbatim,ragged-right]
4072 #(define-music-function
4073 (parser location note)
4076 \tweak NoteHead #'stencil #ly:text-interface::print
4077 \tweak NoteHead #'text
4078 \markup \musicglyph #"custodes.mensural.u0"
4079 \tweak Stem #'stencil ##f
4083 \relative c' { c4 d e f \custosNote g }
4086 Se pueden definir funciones de sustitución con más de un argumento:
4088 @lilypond[quote,verbatim,ragged-right]
4090 #(define-music-function
4091 (parser location padding tempotext)
4094 \once \override Score.MetronomeMark #'padding = #padding
4095 \tempo \markup { \bold #tempotext }
4099 \tempo \markup { "Low tempo" }
4101 \tempoPadded #4.0 "High tempo"
4106 @c TODO: add appropriate @@ref's here.