1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 26a079ca2393d053315ef8dbef626c897dc9645a
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"
666 El orden en que los grabadores se especifican es el orden en que se
667 llaman para realizar su tarea de procesamiento. Normalmente, el orden
668 en que se especifican los grabadores no tiene importancia, pero en
669 algunos casos especiales sí la tiene, por ejemplo donde un grabador
670 escribe una propiedad y otro la lee, o donde un grabador crea un groby
671 otro debe procesarlo.
673 Las siguientes ordenaciones son importantes:
677 el grabador de compases @code{Bar_engraver} debe ir normalmente en
681 el grabador de digitaciones @code{New_fingering_engraver} debe ir
682 antes del grabador @code{Script_column_engraver} de columnas de
686 el @code{Timing_translator} debe ir antes del grabador de números de
687 compás @code{Bar_number_engraver}.
693 @file{ly/engraver-init.ly}.
696 @node Cambiar los valores por omisión de los contextos
697 @subsection Cambiar los valores por omisión de los contextos
698 @translationof Changing context default settings
700 @cindex predeterminadas, cambio de propiedades de contexto
701 @cindex contexto, cambiar propiedades predeterminadas de
703 Se pueden cambiar las propiedades de contexto y de grob con las
704 instrucciones @code{\set} y @code{\override}, tal y como se describe
705 en @ref{Modificar las propiedades}. Estas instrucciones crean eventos
706 musicales, haciendo que los cambios tengan efecto en el punto temporal
707 en que la música se está procesando.
709 Por contra, esta sección explica la forma de cambiarlos valores
710 @emph{predeterminados} de las propiedades de contexto y de grob en el
711 momento en que se crea el contexto. Existen dos formas de hacerlo.
712 Una modifica los valores predeterminados en todos los contextos de un
713 tipo dado, y el otro modifica los valores predeterminados solamente en
714 una instancia concreta de un contexto.
717 * Cambiar todos los contextos del mismo tipo::
718 * Cambiar solamente un contexto determinado::
719 * Orden de precedencia::
722 @node Cambiar todos los contextos del mismo tipo
723 @unnumberedsubsubsec Cambiar todos los contextos del mismo tipo
724 @translationof Changing all contexts of the same type
726 @cindex \context dentro de un bloque \layout
730 Los ajustes de contexto que se han de usar de forma predeterminada
731 dentro de @code{Score}, @code{Staff}, @code{Voice} y otros contextos
732 se pueden especificar en un bloque @code{\context} dentro de cualquier
733 bloque @code{\layout}. El bloque @code{\layout} se debe colocar
734 dentro del bloque @code{\score} al que se aplica, después de la
741 [ajustes de contexto para todos los contextos Voice]
745 [ajustes de contexto para todos los contextos Staff]
750 Se pueden especificar los siguientes tipos de ajustes:
754 Una instrucción @code{\override}, pero omitiendo el nombre del contexto
756 @lilypond[quote,verbatim]
759 a4^"Thicker stems" a a a
765 \override Stem #'thickness = #4.0
772 Estableciendo una propiedad de contexto directamente
774 @lilypond[quote,verbatim]
777 a4^"Smaller font" a a a
790 Una instrucción predefinida tal como @code{\dynamicUp} o una expresión
791 musical como @code{\accidentalStyle "dodecaphonic"}
793 @lilypond[quote,verbatim]
796 a4^"Dynamics above" a a a
806 \accidentalStyle "dodecaphonic"
813 Una variable definida por el usuario que contenga un bloque
814 @code{\with}; para ver detalles acerca del bloque @code{\with},
815 consulte @ref{Cambiar solamente un contexto determinado}.
817 @lilypond[quote,verbatim]
818 StaffDefaults = \with {
825 a4^"Smaller font" a a a
840 Las instrucciones de ajuste de propiedades se pueden disponer dentro
841 de un bloque @code{\layout} sin que estén encerradas en un bloque
842 @code{\context}. Tales ajustes son equivalentes a incluir las mismas
843 instrucciones de ajuste de propiedades al comienzo de cada uno de los
844 contextos del tipo especificado. Si no se especifica ningún contexto,
845 @emph{todos y cada uno} de los contextos del nivel inferior quedan
846 afectados, véase @ref{Contextos del nivel más bajo. Voces}. La
847 sintaxis de una instrucción de ajuste de propiedades dentro de un
848 bloque @code{\layout} es la misma que si la misma instrucción
849 estuviera escrita en el propio flujo musical.
851 @lilypond[quote,verbatim]
855 a4^"Smaller font" a a a
860 \accidentalStyle "dodecaphonic"
862 \override Voice.Stem #'thickness = #4.0
868 @node Cambiar solamente un contexto determinado
869 @unnumberedsubsubsec Cambiar solamente un contexto determinado
870 @translationof Changing just one specific context
875 Las propiedades de contexto de una única instancia de contexto pueden
876 cambiarse dentro de un bloque @code{\with}. Todas las demás
877 instancias de contexto del mismo tipo retienen los ajustes
878 predeterminados que LilyPond tiene programados y que se modifican por
879 parte de cualquier bloque @code{\layout} que se encuentre dentro del
880 ámbito. El bloque @code{\with} se debe situar inmediatamente después
881 de las instrucciones @code{\new} @var{context-type}:
886 [ajustes de contexto para esta única instancia de contexto]
892 Se pueden especificar los siguientes tipos de ajustes:
896 Una instrucción @code{\override}, pero omitiendo el nombre del
899 @lilypond[quote,verbatim]
904 \override Stem #'thickness = #4.0
908 a4^"Thick stems" a a a
917 Estableciendo una propiedad de contexto directamente
919 @lilypond[quote,verbatim]
924 a4^"Default font" a a a
933 a4^"Smaller font" a a a
942 Una instrucción predefinida tal como @code{\dynamicUp}
944 @lilypond[quote,verbatim]
950 a4^"Dynamics below" a a a
956 \with { \accidentalStyle "dodecaphonic" }
962 a4^"Dynamics above" a a a
973 @node Orden de precedencia
974 @unnumberedsubsubsec Orden de precedencia
975 @translationof Order of precedence
977 El valor de una propiedad que se aplica en un momento determinado se
978 determina de la siguiente forma:
982 si está en efecto una instrucción @code{\override} o @code{\set}
983 dentro del flujo musical, se usa dicho valor,
986 de lo contrario, se usa el valor predeterminado tomado de un enunciado
987 @code{\with} en las instrucciones de inicio del contexto,
990 de lo contrario, se usa el valor tomado del bloque @code{\context} más
991 reciente que corresponda dentro de los bloques @code{\layout},
994 de lo contrario se usa el valor predeterminado que LilyPond lleva
999 Manual de aprendizaje:
1000 @rlearning{Modificar las propiedades de los contextos}.
1002 Referencia de la notación:
1003 @ref{Explicación de los contextos},
1004 @ref{Contextos del nivel más bajo. Voces},
1005 @ref{La instrucción set},
1006 @ref{La instrucción override},
1007 @ref{El bloque \layout}.
1010 @node Definir contextos nuevos
1011 @subsection Definir contextos nuevos
1012 @translationof Defining new contexts
1014 @cindex contextos, definición de nuevos
1015 @cindex grabadores, incluir en contextos
1030 Los contextos específicos, como @code{Staff} y @code{Voice}, están
1031 construidos a base de bloques sencillos. Es posible crear nuevos
1032 tipos de contextos con combinaciones distintas de añadidos grabadores.
1034 El siguiente ejemplo muestra cómo construir un tipo diferente de
1035 contexto de @code{Voice} partiendo de cero. Será parecido a
1036 @code{Voice}, pero imprime solamente cabezas centradas en forma de
1037 barra inclinada. Se puede usar para indicar improvisación en piezas
1041 @lilypond[quote,ragged-right]
1042 \layout { \context {
1044 \type "Engraver_group"
1045 \consists "Note_heads_engraver"
1046 \consists "Rhythmic_column_engraver"
1047 \consists "Text_engraver"
1048 \consists Pitch_squash_engraver
1049 squashedPosition = #0
1050 \override NoteHead #'style = #'slash
1051 \override Stem #'transparent = ##t
1052 \override Flag #'transparent = ##t
1056 \accepts "ImproVoice"
1060 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
1061 c4 c^"desvístete" c_"mientras tocas :)" c }
1067 Estos ajustes se definen dentro de un bloque @code{\context} que a su
1068 vez está dentro de un bloque @code{\layout},
1078 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
1079 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
1081 En primer lugar es necesario definir un nombre para el nuevo contexto:
1087 Debido a que es parecido al contexto @code{Voice}, queremos órdenes
1088 que funcionen sobre contextos de @code{Voice} (existentes) para que
1089 siga funcionando. Esto se consigue dando al contexto nuevo un alias
1096 El contexto imprimirá notas y textos explicativos, por ello tenemos
1097 que añadir los grabadores que aportan esta funcionalidad:
1100 \consists Note_heads_engraver
1101 \consists Text_engraver
1104 pero sólo necesitamos esto en la línea central:
1107 \consists Pitch_squash_engraver
1108 squashedPosition = #0
1111 El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
1112 nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
1113 establece sus posiciones verticales al valor de
1114 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.
1116 Las notas parecen barras inclinadas y no tienen plica:
1119 \override NoteHead #'style = #'slash
1120 \override Stem #'transparent = ##t
1121 \override Flag #'transparent = ##t
1124 Todos estos añadidos tienen que cooperar, y esto se consigue con un
1125 añadido especial, que se debe marcar con la palabra clave
1126 @code{\type}. Este será siempre @code{Engraver_group},
1129 \type "Engraver_group"
1132 Al juntarlo todo, obtenemos
1137 \type "Engraver_group"
1138 \consists "Note_heads_engraver"
1139 \consists "Text_engraver"
1140 \consists Pitch_squash_engraver
1141 squashedPosition = #0
1142 \override NoteHead #'style = #'slash
1143 \override Stem #'transparent = ##t
1144 \override Flag #'transparent = ##t
1150 Los contextos dan lugar a jerarquías. Queremos colgar el contexto
1151 @code{ImproVoice} bajo el contexto @code{Staff}, como simples
1152 @code{Voice}s normales. Por tanto, modificamos la definición de
1153 @code{Staff} con la instrucción @code{\accepts} (acepta),
1163 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
1164 que a veces se necesita cuando se están reutilizando definiciones de
1165 contexto existentes.
1167 Ponemos ambos dentro de un bloque @code{\layout}, como
1177 \accepts "ImproVoice"
1182 Así pues, la salida que aparece al comienzo de esta sub-sección se
1191 c c_"mientras tocas :)"
1198 @node Orden de disposición de los contextos
1199 @subsection Orden de disposición de los contextos
1200 @translationof Context layout order
1202 @cindex contextos, orden de disposición
1206 Los contextos se disponen en un sistema normalmente desde arriba hacia
1207 abajo en el orden en que se encuentran en el archivo de entrada.
1208 Cuando los contextos se anidan unos dentro de otros, el contexto
1209 exterior incluye a los contextos anidados tal y como se especifica en
1210 el archivo de entrada, siempre y cuando los contextos interiores estén
1211 incluidos en la lista @qq{accepts} del contexto externo. Los
1212 contextos anidados que no está nincluidos en la lista @qq{accepts} del
1213 contexto externo se recolocan debajo del contexto externo en lugar de
1214 anidarse dentro de él.
1216 La lista @qq{accepts} de un contexto se puede cambiar con las
1217 instrucciones @code{\accepts} (acepta) y @code{\denies} (niega).
1218 @code{\accepts} añade un contexto a la lista @qq{accepts} y
1219 @code{\denies} elimina un contexto de la lista. Por ejemplo,
1220 normalmente no sería deseable que los acordes de cifrado americano
1221 estuvieran anidados dentro de un contexto @code{Staff}, por lo que el
1222 contexto @code{ChordNames} no se incluye de forma predeterminada
1223 dentro de la lista @qq{accepts} del contexto @code{Staff}, pero podría
1224 hacerse si fuera necesario:
1226 @lilypond[verbatim,quote]
1230 \chords { d1:m7 b1:min7.5- }
1235 @lilypond[verbatim,quote]
1239 \chords { d1:m7 b1:min7.5- }
1244 \accepts "ChordNames"
1250 @code{\denies} se usa principalmente cuando un contexto nuevo se está
1251 basando en otro, pero los anidamientos requeridos difieren. Por
1252 ejemplo, el contexto @code{VaticanaStaff} está basado en el contexto
1253 @code{Staff}, pero con el contexto @code{VaticanaVoice} sustituido por
1254 el contexto @code{Voice} en la lista @qq{accepts}.
1256 Observe que discretamente se crea un contexto de forma implícita si se
1257 encuentra una instrucción donde no hay un contexto apropiado para
1258 contenerlo. Esto puede dar lugar a pentagramas o partituras nuevos no
1261 @cindex alignAboveContext
1262 @cindex alignBelowContext
1263 @funindex alignAboveContext
1264 @funindex alignBelowContext
1266 En ocasiones se necesita que un contexto exista durante un breve
1267 intervalo de tiempo, siendo un buen ejemplo el contexto de pentagrama
1268 de un ossia. Esto se consigue normalmente mediante la introducción de
1269 la definición del contexto en el lugar apropiado en paralelo con la
1270 sección correspondiente de la música principal. De forma
1271 predeterminada, el contexto tempral se coloca debajo de todos los
1272 contextos existentes. Para reposicionallo por encima del contexto que
1273 tenga el nombre @qq{principal}, debería definirse de esta forma:
1276 @code{\new Staff \with @{ alignAboveContext = #"principal" @} }
1279 Se presenta una situación similar cuando se posiciona un contexto
1280 temporal de letra de una canción dentro de una disposición de varios
1281 pentagramas tal como @code{ChoirStaff}, por ejemplo, cuando se añade
1282 una segunda estrofa a una sección que se repite. De forma
1283 predeterminada, el contexto temporal de letra se coloca debajo de los
1284 pentagramas inferiores. Mediante la definición del contexto temporal
1285 de letra con @code{alignBelowContext} se puede posicionar
1286 correctamente debajo del contexto de letra con nombre que contiene el
1287 texto de la primera estrofa.
1289 En diversos lugares pueden verse ejemplos que muestran esta
1290 recolocación de contextos temporales: véase
1291 @rlearning{Anidado de expresiones musicales},
1292 @ref{Modificación de pentagramas sueltos} y
1293 @ref{Técnicas específicas para la letra}.
1296 Manual de aprendizaje:
1297 @rlearning{Anidado de expresiones musicales}.
1299 Referencia de la notación:
1300 @ref{Modificación de pentagramas sueltos},
1301 @ref{Técnicas específicas para la letra}.
1303 Manual de utilización del programa:
1304 @rprogram{Aparece un pentagrama de más}.
1306 Archivos instalados:
1307 @file{ly/engraver-init.ly}.
1310 @node Explicación del Manual de referencia de funcionamiento interno
1311 @section Explicación del Manual de referencia de funcionamiento interno
1312 @translationof Explaining the Internals Reference
1315 * Navegar por la referencia del programa::
1316 * Interfaces de la presentación::
1317 * Determinar la propiedad del grob::
1318 * Convenciones de nombres::
1323 @node Navegar por la referencia del programa
1324 @subsection Navegar por la referencia del programa
1325 @translationof Navigating the program reference
1327 Supongamos que queremos mover la indicación de digitación del
1328 fragmento siguiente:
1330 @lilypond[quote,relative=2,verbatim]
1336 Si hace una visita a la documentación en busca de instrucciones de
1337 digitación (en @ref{Indicaciones de digitación}), encontrará:
1340 @strong{Véase también}
1342 Referencia de funcionamiento interno: @rinternals{Fingering}.
1347 La referencia del programador se encuentra disponible en forma de
1348 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
1349 en línea o bien descargando los archivos de la documentación HTML.
1350 Esta sección sería mucho más difícil de entender si está utilizando el
1351 manual en formato PDF.
1354 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
1358 Los objetos de digitación se crean por parte de:
1359 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1362 Siguiendo los enlaces relacionados dentro de la referencia del
1363 programa, podemos seguir el flujo de información dentro del programa:
1367 @item @rinternals{Fingering}:
1368 los objetos @rinternals{Fingering} se crean por parte de:
1369 @rinternals{Fingering_engraver}
1371 @item @rinternals{Fingering_engraver}:
1372 Tipos de música aceptados: @rinternals{fingering-event}
1374 @item @rinternals{fingering-event}:
1375 El tipo de evento musical @code{fingering-event} está descrito en
1376 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1379 Este camino se recorre en contra de la corriente de información del
1380 programa: comienza por la salida y acaba en el evento de entrada.
1381 También podríamos haber empezado por un evento de la entrada, y leído
1382 siguiendo el flujo de información terminando en su caso en el objeto
1383 (u objetos) de la salida.
1385 La referencia del programa también se puede examinar como un documento
1386 normal. Contiene capítulos que tratan de
1388 @rinternals{Music definitions},
1391 @code{Music definitions}
1393 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1394 de los capítulos relaciona todas las definiciones utilizadas y todas
1395 las propiedades que se pueden ajustar.
1398 @node Interfaces de la presentación
1399 @subsection Interfaces de la presentación
1400 @translationof Layout interfaces
1402 @cindex interfaz de la presentación
1403 @cindex presentación, interfaz de la
1406 La página HTML que pudimos ver en la sección anterior describe el
1407 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1408 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1409 números (como grosores y direcciones), pero también punteros a objetos
1410 relacionados. Un objeto de presentación también se llama un
1411 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1412 gráfico). Para ver más detalles acerca de los objetos gráficos o
1413 Grobs, consulte @rinternals{grob-interface}.
1415 La página dedicada a @code{Fingering} relaciona las definiciones del
1416 objeto @code{Fingering}. Por ejemplo, la página dice
1419 @code{padding} (dimensión, en espacios de pentagrama):
1425 lo que significa que el número se mantendrá a una distancia de al
1426 menos 0.5 de la cabeza de la nota.
1429 Cada objeto de presentación puede tener varias funciones como elemento
1430 notacional o tipográfico. Por ejemplo, el objeto de digitación
1431 Fingering tiene los siguientes aspectos
1435 Su tamaño es independiente del espaciado horizontal, al contrario de
1436 las ligaduras o las barras de las figuras.
1439 Es un elemento de texto. Casi seguro que es un texto muy corto.
1442 este elemento de texto se tipografía con un tipo de letra, no como las
1443 ligaduras o las barras de las figuras.
1446 Horizontalmente, el centro del símbolo se debe alinear con el centro
1447 de la cabeza de la nota.
1450 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1453 La posición vertical también está coordinada con otros símbolos de
1454 superíndice y de subíndice.
1457 Cada uno de estos aspectos se capta en lo que se llaman
1458 @emph{interface}s, que se relacionan al final de la página dedicada a
1459 @rinternals{Fingering}
1462 Este objeto contempla los siguientes interfaces:
1463 @rinternals{item-interface},
1464 @rinternals{self-alignment-interface},
1465 @rinternals{side-position-interface}, @rinternals{text-interface},
1466 @rinternals{text-script-interface}, @rinternals{font-interface},
1467 @rinternals{finger-interface} y @rinternals{grob-interface}.
1470 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1471 página del respectivo interfaz del objeto. Cada interfaz tiene un
1472 cierto número de propiedades. Algunas de ellas no son para que el
1473 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1476 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1477 realmente esto no significa mucho. El archivo de inicialización
1478 (véase @rlearning{Otras fuentes de información})
1479 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1484 (avoid-slur . around)
1485 (slur-padding . 0.2)
1486 (staff-padding . 0.5)
1487 (self-alignment-X . 0)
1488 (self-alignment-Y . 0)
1489 (script-priority . 100)
1490 (stencil . ,ly:text-interface::print)
1491 (direction . ,ly:script-interface::calc-direction)
1492 (font-encoding . fetaText)
1493 (font-size . -5) ; don't overlap when next to heads.
1494 (meta . ((class . Item)
1495 (interfaces . (finger-interface
1497 text-script-interface
1499 side-position-interface
1500 self-alignment-interface
1501 item-interface))))))
1505 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1506 de valores de variables, y la página web de la Referencia de
1507 funcionamiento interno se genera directamente a partir de esta
1511 @node Determinar la propiedad del grob
1512 @subsection Determinar la propiedad del grob
1513 @translationof Determining the grob property
1515 Recordemos que queríamos cambiar la posición del @b{2} en
1517 @lilypond[quote,relative=2,verbatim]
1523 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1524 tenemos que negociar con el interfaz asociado con esta colocación.
1525 Esto se hace usando @code{side-position-interface}. La página que
1526 describe este interface dice:
1529 @code{side-position-interface}
1531 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1532 soporte). La propiedad @code{direction} significa dónde poner el
1533 objeto víctima con relación al soporte (¿a la izquierda o a la
1534 derecha, encima o debajo?)
1538 @cindex padding (relleno)
1540 Debajo de esta descripción, la variable @code{padding} (relleno) se
1546 (dimensión, en espacios de pentagrama)
1548 Añadir esta cantidad de espacio adicional entre objetos que están unos
1553 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1554 digitación de la cabeza de la nota. La siguiente orden inserta un
1555 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1558 \once \override Voice.Fingering #'padding = #3
1561 Al insertar esta instrucción antes de que se haya creado el objeto
1562 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1565 @lilypond[quote,relative=2,verbatim]
1566 \once \override Voice.Fingering #'padding = #3
1572 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1573 se puede deducir también a partir de la referencia del programa, ya
1574 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1577 El grabador Fingering_engraver es parte de los contextos: @dots{}
1582 @node Convenciones de nombres
1583 @subsection Convenciones de nombres
1584 @translationof Naming conventions
1586 Se hace necesario presentar una panorámica de las diversas
1587 convenciones de nomenclatura:
1590 @item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
1591 @item funciones de Scheme: ly:más-estilo-de-scheme
1592 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1593 @item interfaces de Grobs: estilo-scheme
1594 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1595 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1596 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1597 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1601 Preguntas aún sin respuesta
1603 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1604 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1609 @node Modificar las propiedades
1610 @section Modificar las propiedades
1611 @translationof Modifying properties
1614 * Panorámica de la modificación de las propiedades::
1615 * La instrucción set::
1616 * La instrucción override::
1617 * La instrucción tweak::
1618 * set frente a override::
1619 * Modificación de las listas-A::
1623 @node Panorámica de la modificación de las propiedades
1624 @subsection Panorámica de la modificación de las propiedades
1625 @translationof Overview of modifying properties
1627 Cada contexto es responsable de la creación de ciertos tipos de
1628 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1629 también se almacenan por contexto. Mediante la modificación de estos
1630 ajustes, se puede alterar la apariencia de los objetos.
1632 Existen dos tipos diferentes de propiedades almacenadas en los
1633 contextos: las propiedades de contexto y las propiedades de grob. Las
1634 propiedades de contexto son propiedades que se aplican al contexto
1635 como un todo y controlan la forma en que el propio contexto se
1636 imprime. Por contra, las propiedades de grob se aplican a los tipos
1637 de grob específicos que se imprimirán dentro del contexto.
1639 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar los
1640 valores de las propiedades de contexto. Las instrucciones
1641 @code{\override} y @code{\revert} se usan para cambiar los valores de
1642 las propiedades de grob.
1645 La sintaxis de esto es
1648 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1651 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1652 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1653 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1654 disposición}). Este último es un símbolo, y por ello debe ir
1655 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1656 explica cómo se deben cumplimentar los conceptos @var{nombre},
1657 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1658 funcionalidad des esta instrucción.
1663 \override Staff.Stem #'thickness = #4.0
1667 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1668 grosor de una línea del pentagrama como unidad). Puesto que la
1669 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1670 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1671 Aquí vemos la instrucción en pleno funcionamiento:
1673 @lilypond[quote,verbatim,relative=2]
1675 \override Staff.Stem #'thickness = #4.0
1681 La instrucción @code{\override} modifica la definición de la plica
1682 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1683 que la instrucción se ha interpretado, todas las plicas se engrosan.
1685 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1686 omitir, ocasionando que se utilice el contexto predeterminado
1687 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1688 solo paso de tiempo.
1690 @lilypond[quote,verbatim,relative=2]
1692 \once \override Stem #'thickness = #4.0
1697 El @code{\override} se debe hacer antes de que el objeto se inicia.
1698 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1699 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1700 en el momento en que se crea el objeto. En este ejemplo:
1702 @lilypond[quote,verbatim,relative=2]
1703 \override Slur #'thickness = #3.0
1705 \override Beam #'beam-thickness = #0.6
1710 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1711 la instrucción para @code{Beam}, la barra, va después de que la barra
1712 se ha iniciado, y por ello no tiene ningún efecto.
1714 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1715 un contexto deshace una instrucción @code{\override}; como con
1716 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1717 del mismo contexto. En otras palabras, el @code{\revert} del
1718 siguiente ejemplo no hace nada.
1721 \override Voice.Stem #'thickness = #4.0
1722 \revert Staff.Stem #'thickness
1725 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1726 dentro de las propiedades normales. Para trucarlas, utilice
1727 instrucciones de la forma
1729 @c leave this as a long long
1731 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1738 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1744 Referencia de funcionamiento interno:
1745 @rinternals{Backend},
1746 @rinternals{All layout objects},
1747 @rinternals{OverrideProperty},
1748 @rinternals{RevertProperty},
1749 @rinternals{PropertySet}.
1752 El «back-end» o motor de salida no es muy estricto en la comprobación
1753 de tipos de las propiedades de objetos. Las referencias cíclicas en
1754 valores Scheme de propiedades pueden producir cuelgues o salidas
1755 abruptas, o las dos cosas.
1758 @node La instrucción set
1759 @subsection La instrucción @code{@bs{}set}
1760 @translationof The set command
1764 @cindex cambiar propiedades
1766 Cada contexto puede tener distintas @emph{propiedades}, variables
1767 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1768 paso de interpretación. Se consigue insertando la instrucción
1769 @code{\set} dentro de la música:
1772 \set @var{contexto}.@var{propiedad} = #@var{valor}
1775 @var{valor} es un objeto de Scheme, razón por la que va precedido del
1776 carácter almohadilla,@tie{}@code{#}.
1778 El nombre de las propiedades de contexto suele ir en minúsculas con
1779 mayúscula en medio. Controlan sobre todo la traducción de la música a
1780 la notación, p.ej. @code{localKeySignature} (para determinar si hay
1781 que impriir alteraciones o no), o @code{measurePosition} (para
1782 determinar cuándo hay que imprimir una línea divisoria). El valor de
1783 las propiedades de contexto puede modifcarse con el tiempo durante la
1784 interpretación de la música; un ejemplo obvio es
1785 @code{measurePosition}. Las propiedades de contexto se modifican
1786 mediante la instrucción @code{\set}.
1788 Por ejemplo, los silencios multicompás se combinan en un solo compás
1789 si el valor de la propiedad de contexto @code{skipBars} se establece a
1790 @code{#t} (verdadero):
1792 @lilypond[quote,verbatim,relative=2]
1794 \set Score.skipBars = ##t
1798 Si se omite el argumento @var{context}, entonces se utiliza el
1799 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1800 @code{Voice} o @code{Lyrics}). En este ejemplo:
1802 @lilypond[quote,verbatim,relative=2]
1803 \set Score.autoBeaming = ##f
1807 \set autoBeaming = ##t
1815 El cambio se aplica @q{al vuelo}, mientras dura la música, de forma
1816 que el ajuste sólo afecta al segundo grupo de corcheas.
1818 Observe que el contexto del nivel más bajo no siempre contiene la
1819 propiedad que querríamos modificar: por ejemplo, intentar ajustar el
1820 valor de la propiedad @code{skipBars} del contexto predeterminado del
1821 nivel más bajo, que en este caso es @code{Voice}, no tendrá ningún
1822 efecto, porque skipBars es una propiedad del contexto @code{Score}.
1824 @lilypond[quote,verbatim,relative=2]
1830 Los contextos son jerárquicos, y si se ha especificado un contexto
1831 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1832 también a todos los contextos @code{Voice} dentro del pentagrama
1837 También existe una instrucción @code{\unset}:
1839 \unset @var{contexto}.@var{propiedad}
1843 que elimina la definición de @var{propiedad}. Esta instrucción
1844 elimina la definición solamente si está establecida dentro de
1845 @var{contexto}. Properties that have been set in enclosing contexts will
1846 not be altered by an unset in an enclosed context:
1848 @lilypond[quote,verbatim,relative=2]
1849 \set Score.autoBeaming = ##t
1854 \unset Score.autoBeaming
1862 Como @code{\set}, el argumento @var{contexto} no se tiene que
1863 especificar para un contexto del nivel más bajo, por lo que los dos
1867 \set Voice.autoBeaming = ##t
1868 \set autoBeaming = ##t
1872 son equivalentes si el contexto inferior en curso es @code{Voice}.
1876 Los ajustes que se aplican solamente a un único paso de tiempo se
1877 pueden escribir con @code{\once}, por ejemplo en
1879 @lilypond[quote,verbatim,relative=2]
1881 \once \set fontSize = #4.7
1886 En el manual de Referencia de funcionamiento interno hay una
1887 descripción completa de todas las propiedades de contexto disponibles,
1890 @rinternals{Tunable context properties}.
1893 Traducción @expansion{} Propiedades de contexto modificables por el
1898 Referencia de funcionamiento interno:
1899 @rinternals{Tunable context properties}.
1901 @cindex grob, propiedades de
1902 @cindex propiedades de grob
1906 @node La instrucción override
1907 @subsection La instrucción @code{\override}
1908 @translationof The override command
1910 Existe un tipo especial de propiedad de contexto: la descripción de
1911 los grobs. Las decscripciones de los grobs reciben un nombre en
1912 @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen los
1913 @q{ajustes predeterminados} para un tipo particular de grob, en forma
1914 de lista asociativa. Consulte @file{scm/define-grobs.scm} para
1915 ver los ajustes de cada descripción de grob. Las descripciones de
1916 grob se modifican con @code{\override}.
1918 @code{\override} es en realidad una forma abreviada;
1921 \override @var{contexto}.@var{NombreDelGrob} #'@var{propiedad} = #@var{valor}
1925 equivale más o menos a
1927 @c leave this long line -gp
1929 \set @var{contexto}.@var{NombreDelGrob} =
1930 #(cons (cons '@var{propiedad} @var{valor})
1931 <valor anterior de @var{contexto}.@var{NombreDelGrob}>)
1934 El valor de @code{contexto}.@code{NombreDelGrob} (la lista-A) se
1935 utiliza para inicializar las propiedades de los grobs individuales.
1936 Los grobs tienen propiedades, denominadas en el estilo de Scheme, con
1937 @code{palabras-con-guiones}. Los valores de las propiedades de grob
1938 cambian durante el proceso de formateo: éste se realiza básicamente
1939 calculando las propiedades utilizando funciones de @q{callback}
1940 (pasadas como parámetro).
1942 Por ejemplo, podemos aumentar el grosor de la plica de una figura
1943 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
1944 @code{Stem} (plica):
1946 @lilypond[quote,verbatim,relative=2]
1948 \override Voice.Stem #'thickness = #3.0
1952 Si no se ha especificado ningún contexto en la instrucción
1953 @code{\override}, se utiliza el contexto del nivel inferior:
1955 @lilypond[quote,verbatim,relative=2]
1956 { \override Staff.Stem #'thickness = #3.0
1960 \override Stem #'thickness = #0.5
1970 @cindex reversión de sobreescrituras
1971 @cindex sobreescrituras, reversión de
1973 El efecto de una instrucción de sobreescritura @code{\override} se
1974 puede deshacer con @code{\revert}:
1976 @lilypond[quote,verbatim,relative=2]
1978 \override Voice.Stem #'thickness = #3.0
1980 \revert Voice.Stem #'thickness
1984 Los efectos de @code{\override} y @code{\revert} se aplican a todos
1985 los grobs del contexto afectado partiendo del momento actual y hacia
1988 @lilypond[quote,verbatim,relative=2]
1993 \override Staff.Stem #'thickness = #3.0
1997 \revert Staff.Stem #'thickness
2005 @cindex sobreescritura para un solo momento
2007 Se puede usar @code{\once} con @code{\override} para afectar solamente
2008 al instante de tiempo actual:
2010 @lilypond[quote,verbatim,relative=2]
2014 \override Stem #'thickness = #3.0
2018 \once \override Stem #'thickness = #3.0
2027 Las instrucciones que modifican la salida tienen por lo general un
2031 \override Voice.Stem #'thickness = #3.0
2035 Para construir este truco debemos determinar los siguientes datos:
2038 @item el contexto: aquí @code{Voice}.
2039 @item el objeto de presentación: aquí @code{Stem}.
2040 @item la propiedad de presentación: aquí @code{thickness}.
2041 @item un valor adecuado: aquí @code{3.0}.
2044 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
2045 en el interior de las propiedades normales. Para modificarlas utilice
2046 instrucciones de la forma
2049 \override Stem #'(details beamed-lengths) = #'(4 4 3)
2052 @cindex documentación interna
2053 @cindex buscar objetos gráficos
2054 @cindex gráficos, descripción de los objetos
2057 @cindex interna, documentación
2059 Para muchas propiedades, independientemente del tipo de datos de la
2060 propiedad, si se establece el valor de la propiedad a falso
2061 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
2062 ignore por completo dicha propiedad. Esto es especialmente útil para
2063 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
2064 causarían problemas.
2066 Mostraremos a continuación cómo localizar esta información en el
2067 manual de notación y en la referencia de funcionamiento interno.
2071 Referencia de funcionamiento interno:
2072 @rinternals{Backend}
2075 @node La instrucción tweak
2076 @subsection La instrucción @code{\tweak}
2077 @translationof The tweak command
2082 El cambio de las propiedades de grob mediante @code{\override} produce
2083 la aplicación del cambio a todos los grobs dados en el contexto en el
2084 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
2085 podemos desear que los cambios se apliquen a un solo grob en lugar de
2086 a todos los grobs del contexto afectado. Esto se consigue con la
2087 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
2090 \tweak @var{objeto-de-presentación} #'@var{propiedad-del-grob} @var{valor}
2093 Es opcional especificar el @var{objeto-de-presentación}. La
2094 instrucción @code{\tweak} se aplica al objeto musical que viene
2095 inmediatamente después de @var{valor} dentro del flujo musical.
2098 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
2099 los objetos gráficos. Para objetos que resultan directamente de un
2100 elemento de código de la entrada, puede usar la función @code{\tweak},
2103 @lilypond[relative=2,verbatim,quote]
2108 \tweak #'duration-log #1
2111 -\tweak #'padding #8
2117 Pero el uso principal de la instrucción @code{\tweak} es modificar
2118 solamente uno de varios elementos de notación que dan comienzo en el
2119 mismo momento musical, como las notas de un acorde, o corchetes de
2120 tresillo que empiezan al mismo tiempo.
2122 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
2123 a continuación de forma directa, sin necesidad de especificar el
2124 nombre del grob o el contexto. Para que esto funcione, es necesario
2125 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
2126 al objeto al que se aplica, después de que el archivo de entrada se ha
2127 convertido en un flujo musical. Con frecuencia no es el caso, pues
2128 muchos elementos adicionales se insertan en la corriente musical de
2129 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
2130 parte de un acorde, LilyPond inserta implícitamente un evento
2131 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
2132 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
2133 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
2134 en el flujo musical, permaneciendo así adyacente a la nota, y con la
2135 posibilidad de modificarla.
2139 @lilypond[relative=2,verbatim,quote]
2140 <\tweak #'color #red c>4
2144 pero esto no funciona:
2146 @lilypond[relative=2,verbatim,quote]
2147 \tweak #'color #red c4
2152 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
2153 consulte @rlearning{Métodos de trucaje}.
2155 Si se colocan varios elementos similares en el mismo momento musical,
2156 la instrucción @code{\override} no se puede usar para modificar uno
2157 solo de ellos: aquí es donde se debe usar la instrucción
2158 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
2159 en el mismo momento musical están los siguientes:
2161 @c TODO expand to include any further uses of \tweak
2163 @item las cabezas de las notas de un acorde
2164 @item signos de articulación sobre la misma nota
2165 @item ligaduras de unión entre notas de un acorde
2166 @item corchetes de grupos especials que comienzan en el mismo momento
2169 @c TODO add examples of these
2171 @cindex acorde, modificación de una nota
2173 En este ejemplo se modifican el color de una cabeza y el tipo de otra,
2174 dentro del mismo acorde:
2176 @lilypond[relative=2,verbatim,quote]
2181 \tweak #'duration-log #1
2186 @code{\tweak} se puede usar para modificar ligaduras de expresión:
2188 @lilypond[verbatim,quote,relative=1]
2189 c-\tweak #'thickness #5 ( d e f)
2193 Para que funcione la instrucción @code{\tweak}, debe permanecer
2194 adyacente al objeto al que se ha de aplicar después de que el código
2195 de entrada se ha convertido a un flujo musical. El trucaje de un
2196 acorde completo no hace nada porque su evento musical actúa solamente
2197 como un contenedor, y todos los objetos de presentación se crean a
2198 partir de eventos dentro del @code{EventChord}:
2200 @lilypond[relative=2,verbatim,quote]
2201 \tweak #'color #red c4
2202 \tweak #'color #red <c e>4
2203 <\tweak #'color #red c e>4
2206 La instrucción @code{\tweak} sencilla no se puede usar para modificar
2207 ningún objeto que no se haya creado directamente a partir de la entrada.
2208 Concretamente, no afecta a las plicas, barras automáticas ni
2209 alteraciones, porque éstos se generan posteriormente por
2210 parte de objetos de presentación @code{NoteHead}
2211 más que por elementos musicales del
2214 Tales objetos de presencaión creados indirectamente se pueden trucar
2215 usando la forma explícita de la instrucción @code{\tweak}:
2217 @lilypond[relative=2,verbatim,quote]
2218 \tweak Stem #'color #red
2219 \tweak Beam #'color #green c8 e
2220 <c e \tweak Accidental #'font-size #-3 ges>4
2223 No se puede usar @code{\tweak} para modificar las claves o las
2224 indicaciones de compás, porque éstos se separan de cualquier
2225 instrucción @code{\tweak} precedente dentro del flujo de entrada
2226 merced a la inserción automática de elementos adicionales que se
2227 requieren para especificar el contexto.
2229 Se pueden colocar varias instrucciones @code{\tweak} antes de un
2230 elemento de notación; todos le afectan:
2232 @lilypond[verbatim,quote,relative=1]
2234 -\tweak #'style #'dashed-line
2235 -\tweak #'dash-fraction #0.2
2236 -\tweak #'thickness #3
2237 -\tweak #'color #red
2242 El flujo musical que se genera a partir de una sección de un archivo
2243 de entrada (incluido cualquier elemento insertado automáticamente)
2244 puede examinarse, véase @rextend{Presentación de las expresiones musicales}.
2245 Esto puede ser de utilidad en la determinación de lo que
2246 puede modificarse por medio de una instrucción @code{\tweak}.
2249 Manual de aprendizaje:
2250 @rlearning{Métodos de trucaje}.
2252 Manual de extensión:
2253 @rextend{Presentación de las expresiones musicales}.
2257 @cindex trucar puntos de control
2258 @cindex control, trucar puntos de
2260 No se puede usar la instrucción @code{\tweak} para modificar los
2261 puntos de control de una sola de varias ligaduras de unión dentro de
2262 un acorde, aparte de la primera que se encuentre en el código de
2266 @node set frente a override
2267 @subsection @code{\set} frente a @code{\override}
2268 @translationof set versus override
2270 @c HACER: probablemente esta sección es innecesaria.
2273 We have seen two methods of changing properties: @code{\set} and
2274 @code{\override}. There are actually two different kinds of
2277 @code{fontSize} is a special property: it is equivalent to
2278 entering @code{\override ... #'font-size} for all pertinent
2279 objects. Since this is a common change, the special
2280 property (modified with @code{\set}) was created.
2285 @node Modificación de las listas-A
2286 @subsection Modificación de las listas-A
2287 @translationof Modifying alists
2289 Ciertas propiedades configurables por parte del usuario se representan
2290 internamente como @emph{listas-A} (listas asociativas), que almacenan
2291 duplas de @emph{claves} y @emph{valores}. La estructura de una
2292 lista-A es la siguiente:
2295 '((@var{clave1} . @var{valor1})
2296 (@var{clave2} . @var{valor2})
2297 (@var{clave3} . @var{valor3})
2301 Si una lista-A es una propiedad de un grob o una variable de
2302 @code{\paper}, sus claves se pueden modificar individualmente sin que
2303 afecte a las otras claves.
2305 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2306 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2307 del grob @code{StaffGrouper}. La propiedad es una lista-A con cuatro
2308 claves: @code{basic-distance} (distancia básica),
2309 @code{minimum-distance} (distancia mínima), @code{padding} (relleno)
2310 y @code{stretchability} (ampliabilidad).
2311 Los ajustes estándar para esta propiedad
2312 se relacionan en la sección
2313 @qq{Backend} de la Referencia de Funcionamiento Interno
2314 (véase @rinternals{StaffGrouper}):
2317 '((basic-distance . 9)
2318 (minimum-distance . 7)
2320 (stretchability . 5))
2323 Una forma de acercar los pentagramas entre sí es reducir el valor de
2324 la clave @code{basic-distance} (@code{9}) para que se corresponda con
2325 el valor de @code{minimum-distance} (@code{7}). Para modificar una
2326 única clave de forma individual, utilice una @emph{declaración
2329 @lilypond[quote,verbatim]
2330 % default space between staves
2332 \new Staff { \clef treble c''1 }
2333 \new Staff { \clef bass c1 }
2336 % reduced space between staves
2337 \new PianoStaff \with {
2338 % this is the nested declaration
2339 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #7
2341 \new Staff { \clef treble c''1 }
2342 \new Staff { \clef bass c1 }
2346 La utilización de una declaración anidada actualiza la clave
2347 especificada (como @code{basic-distance} en el ejemplo anterior)
2349 de las otras claves que ya se habían establecido para la misma
2352 Ahora, supongamos que deseamos que los pentagramas estén tan próximos
2353 como sea posible sin que se superpongan. La manera más sencilla de
2354 hacerlo es establecer las cuatro claves de la lista-A a cero. Sin
2355 embargo, no es necesario escribir cuatro declaraciones anidadas, una
2356 por cada clave. En lugar de eso, se puede redefinir completamente la
2357 propiedad con una sola declaración, como una lista-A:
2359 @lilypond[quote,verbatim]
2360 \new PianoStaff \with {
2361 \override StaffGrouper #'staff-staff-spacing =
2362 #'((basic-distance . 0)
2363 (minimum-distance . 0)
2365 (stretchability . 0))
2367 \new Staff { \clef treble c''1 }
2368 \new Staff { \clef bass c1 }
2372 Observe que cualquier clave que no haya sido relacionada
2373 explícitamente en la definición de la lista-A, será reiniciada a sus
2374 valores @emph{predeterminados si no se han fijado}. En el caso de
2375 @code{staff-staff-spacing}, el valor de cualquier clave no fijada se
2376 reiniciaría a cero (excepto @code{stretchability}, que toma el valor
2377 de @code{basic-distance} si no se fija). Así, las dos declaraciones
2378 siguientes son equivalentes:
2381 \override StaffGrouper #'staff-staff-spacing =
2382 #'((basic-distance . 7))
2384 \override StaffGrouper #'staff-staff-spacing =
2385 #'((basic-distance . 7)
2386 (minimum-distance . 0)
2388 (stretchability . 7))
2391 Una consecuencia de esto (posiblemente no intencionada) es la
2392 eliminación de cualquier valor estándar que se establezca en un
2393 archivo de inicio y que se carga cada vez que se compila un archivo de
2394 entrada. En el ejemplo anterior, los ajustes estándar para
2395 @code{padding} y @code{minimum-distance} (definidos en
2396 @file{scm/define-grobs.scm}) se reinician a sus valores
2397 predeterminados si no se han fijado (cero para las dos claves). La
2398 definición de una propiedad o variable como una lista-A (de cualquier
2399 tamaño) siempre reinicia todos los valores de clave no establecidos a
2400 sus valores predeterminados si no se han fijado. Ano ser que este sea
2401 el resultado deseado, es más seguro actualizar los valores de clave
2402 individualmente con una declaración anidada.
2404 @warning{Las declaraciones anidadas no funcionan para las listas-A de
2405 propiedades de contexto (como @code{beamExceptions},
2406 @code{keySignature}, @code{timeSignatureSettings}, etc.). Estas
2407 propiedades sólo se pueden modificar redefiniéndolas completamente
2411 @node Conceptos y propiedades útiles
2412 @section Conceptos y propiedades útiles
2413 @translationof Useful concepts and properties
2417 * Modos de entrada::
2418 * Dirección y posición::
2419 * Distancias y medidas::
2420 * Propiedades del símbolo del pentagrama::
2421 * Objetos de extensión::
2422 * Visibilidad de los objetos::
2423 * Estilos de línea::
2424 * Rotación de objetos::
2428 @node Modos de entrada
2429 @subsection Modos de entrada
2430 @translationof Input modes
2432 La forma en que se interpreta la notación contenida dentro de un
2433 archivo de entrada, está determinada por el modo de entrada en curso.
2435 @strong{Modo de acordes}
2437 Se activa con la instrucción @code{\chordmode} y produce que la
2438 entrada se interprete con al sintaxis de la notación de acordes, véase
2439 @ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
2442 El modo de acordes se activa también con la instrucción
2443 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
2444 y produce que el código que sigue se interprete con la sintaxis de la
2445 notación de acordes y se imprima como nombres de acorde dentro del
2446 contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
2448 @strong{Modo de percusión}
2450 Se activa con la instrucción @code{\drummode} y produce que el código
2451 de entrada se interprete con la sintaxis de la notación de percusión,
2452 véase @ref{Notación básica de percusión}.
2454 El modo de percusión también se activa con la instrucción
2455 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
2456 que el código que sigue se interprete con la sintaxis de la notación
2457 de percusión y se imprima como símbolos de percusión sobre un
2458 pentagrama de percusión, véase @ref{Notación básica de percusión}.
2460 @strong{Modo de cifras}
2462 Se activa con la instrucción @code{\figuremode} y hace que el código
2463 de entrada se interprete con la sintaxis del bajo cifrado, véase
2464 @ref{Introducir el bajo cifrado}.
2466 El modo de cifrase también se activa con la instrucción
2467 @code{\figures}. También crea un contexto de @code{FiguredBass} nuevo
2468 y hace que el código que viene a continuación se interprete con la
2469 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
2470 dentro del contexto @code{FiguredBass}, véase @ref{Introducción al bajo cifrado}.
2472 @strong{Modos de traste y tablatura}
2474 No existen modos de entrada especiales para introducir símbolos de
2475 trastes y de tablatura.
2477 Para crear diagramas de trastes, escriba las notas o acordes en el
2478 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2479 véase @ref{Tablaturas predeterminadas}.
2481 Para crear diagramas de trastes encima de un pentagrama, escríbalos
2482 como elementos de marcado encima de las notas utilizando la
2483 instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
2485 @strong{Modo de letra}
2487 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
2488 se interprete como sílabas de la letra de la canción con duraciones
2489 opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
2491 El modo de letra también se habilita con la instrucción
2492 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
2493 y una instrucción @code{\lyricsto} implícita que asocia la letra que
2494 viene a continuación con la música precedente.
2496 @strong{Modo de marcado}
2498 Se activa con la instrucción @code{\markup}, y hace que la entrada se
2499 interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
2501 @c silly work-around for texinfo broken-ness
2502 @c (@strong{Note...} causes a spurious cross-reference in Info)
2505 Es el modo predeterminado o se puede activar con la instrucción
2506 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
2507 marcado, etc. y se imprime como notación musical sobre un pentagrama.
2509 Normalmente no es necesario especificar el modo de notas de forma
2510 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2511 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2512 otro modo y queremos insertar algo que solamente se puede hacer con la
2513 sintaxis del modo de notas.
2515 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
2516 una pieza coral es necesario entrar en el modo de notas para poder
2517 interpretar dichas indicaciones:
2519 @lilypond[verbatim,relative=2,quote]
2522 \notemode{\set stanza = \markup{ \dynamic f 1. } }
2526 \notemode{\set stanza = \markup{ \dynamic p 2. } }
2532 @node Dirección y posición
2533 @subsection Dirección y posición
2534 @translationof Direction and placement
2536 Al tipografiar música, la dirección y colocación de muchos elementos
2537 es cuestión de elección. Por ejemplo, las plicas de las notas se
2538 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
2539 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
2540 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
2541 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
2542 LilyPond las determine automáticamente, pero en ciertos casos puede
2543 ser deseable forzar una dirección o colocación concreta.
2545 @strong{Acciones predeterminadas}
2547 De forma predeterminada algunas direcciones siempre son hacia arriba o
2548 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
2549 otras cosas pueden alternar entre arriba y abajo en función de la
2550 dirección de las plicas (como las ligaduras o los acentos).
2552 @c TODO Add table showing these
2554 Se puede sobreescribir la acción predeterminada mediante el prefijado
2555 de la articulación por un @emph{indicacor de dirección}. Están
2556 disponibles tres indicadores de dirección: @code{^} (que significa
2557 @qq{arriba}), @code{_} (que significa @qq{abajo}) o @code{-} (que
2558 significa @qq{usar la dirección predeterminada}). El indicador de
2559 dirección se puede normalmente omitir, en cuyo caso se supone el
2560 indicador predeterminado @code{-}, pero se necesita un indicador de
2561 dirección @strong{siempre} antes de:
2564 @item las instrucciones @code{\tweak}
2565 @item las instrucciones @code{\markup}
2566 @item las instrucciones @code{\tag}
2567 @item los marcados de cadena, p.ej. -"cadena"
2568 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2569 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2572 Estas indicaciones afectan sólo a la nota siguiente.
2574 @lilypond[verbatim,quote,relative=2]
2581 @strong{La propiedad de dirección}
2583 La posición o dirección de muchos objetos de presentación está
2584 controlada por la propiedad @code{direction}.
2586 El valor de la propiedad @code{direction} se puede establecer al valor
2587 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
2588 @w{@code{-1}}, con el significado de @qq{hacia abajo} o @qq{debajo}.
2589 Se pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
2590 @code{1} y @w{@code{-1}} respectivamente. La dirección predeterminada
2591 se puede especificar estableciendo @code{direction} a @code{0} ó a
2592 @code{CENTER}. De forma alternativa, en muchos casos existen
2593 instrucciones predefinidas para especificar la dirección. Todas ellas
2597 @code{\xxxUp}, @code{\xxxDown} o @code{\xxxNeutral}
2601 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
2602 predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
2604 En alguna que otra ocasión como en el arpegio, el
2605 valor de la propiedad @code{direction} puede especificar si el objeto se debe
2606 colocar a la izquierda o a la derecha del objeto padre. En este caso
2607 @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y @code{1}
2608 ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
2609 significan @qq{utilizar la dirección predeterminada}.
2611 Estas indicaciones afectan a todas las notas hasta que son canceladas.
2613 @lilypond[verbatim,quote,relative=2]
2622 En música polifónica, en general es mejor especificar una voz explícita
2623 que cambiar la dirección de un objeto. Para ver más información,
2624 véase @ref{Varias voces}.
2627 Manual de aprendizaje:
2628 @rlearning{Objetos interiores al pentagrama}.
2630 Referencia de la notación:
2634 @node Distancias y medidas
2635 @subsection Distancias y medidas
2636 @translationof Distances and measurements
2638 @cindex distancias absolutas
2639 @cindex distancias escaladas
2646 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
2648 Las distancias absolutas se usan para especificar márgenes, sangrados
2649 y otros detalles de diseño de página, y de forma predeterminada se
2650 especifican en milímetros. Las distancias se pueden especificar en
2651 otras unidades escribiendo después de la cifra indicativa de la
2652 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
2653 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
2654 de página se pueden especificar también en unidades escalables (véase
2655 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
2656 La disposición de página se describe en detalle en
2657 @ref{Disposición de la página}.
2659 Las distancias escaladas siempre se especifican en unidades de un
2660 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
2661 El espacio de pentagrama es la distancia entre dos líneas del
2662 pentagrama adyacentes. El valor predeterminado se puede cambiar
2663 globalmente fijando el tamaño global del pentagrama, o se puede
2664 sobreescribir localmente cambiando la propiedad @code{staff-space} del
2665 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
2666 automáticamente con cualquier cambio al tamaño global del pentagrama o
2667 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
2668 las fuentes tipográficas se escalan solamente con los cambios
2669 efectuados al tamaño global del pentagrama. Así, el tamaño global del
2670 pentagrama posibilita la fácil variación del tamaño general de una
2671 partitura impresa. Para ver los métodos de establecimiento del tamaño
2672 global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2676 Si se necesita dibujar sólo una sección de una partitura a una escala
2677 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2678 simplemente cambiar el tamaño global del pentagrama porque esto
2679 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2680 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2681 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2682 nuestra disposición una función de Scheme, @code{magstep}, para
2683 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2684 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2685 utilización, consulte @rlearning{Longitud y grosor de los objetos}.
2688 Manual de aprendizaje:
2689 @rlearning{Longitud y grosor de los objetos}.
2691 Referencia de la notación:
2692 @ref{Disposición de la página},
2693 @ref{Establecer el tamaño del pentagrama}.
2696 @node Propiedades del símbolo del pentagrama
2697 @subsection Propiedades del símbolo del pentagrama
2698 @translationof Staff symbol properties
2700 @cindex ajuste del símbolo del pentagrama
2701 @cindex dibujar el símbolo del pentagrama
2702 @cindex pentagrama, establecer el símbolo del
2704 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2705 @c Need to think of uses for these properties. Eg 'line-positions
2706 @c is used in a snippet to thicken centre line.
2707 @c If retained, add @ref to here in 1.6.2 -td
2709 Se puede definir al mismo tiempo la posición vertical de las líneas de
2710 la pauta y el número de líneas de la misma. Como muestra el siguiente
2711 ejemplo, las posiciones de las notas no están influidas por las
2712 posiciones de las líneas de la pauta.
2714 @warning{La propiedad @code{'line-positions} sobreescribe a la
2715 propiedad @code{'line-count}. El número de líneas de la pauta está
2716 definido implícitamente por el número de elementos de la lista de
2717 valores de @code{'line-positions}.}
2719 @lilypond[verbatim,quote,relative=1]
2721 \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
2726 Se puede modificar la anchura de la pauta. Las unidades son espacios
2727 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2728 resulta afectado por este ajuste.
2730 @lilypond[verbatim,quote,relative=1]
2732 \override StaffSymbol #'width = #23
2738 @node Objetos de extensión
2739 @subsection Objetos de extensión
2740 @translationof Spanners
2742 Muchos objetos de notación musical abarcan varias notas o incluso
2743 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2744 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2745 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2746 especiales para controlar su apariencia y comportamiento. Algunas de
2747 estas propiedades son comunes a todos los objetos de extensión; otras
2748 se limitan a un subconjunto de los extensores.
2750 Todos los objetos de extensión contemplan el interface
2751 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2752 una línea recta entre los dos objetos, contemplan también el interface
2753 @code{line-spanner-interface}.
2755 @unnumberedsubsubsec Uso del @code{spanner-interface}
2757 Este interface proporciona dos propiedades que se aplican a varios
2760 @strong{@i{La propiedad @code{minimum-length}}}
2762 La longitud mínima del objeto de extensión se especifica a través de
2763 la propiedad @code{minimum-length}. Su aumento suele producir el
2764 efecto necesario de aumentar el espaciado de las notas entre los dos
2765 puntos extremos. Sin embargo, esta sobreescritura no tiene ningún
2766 efecto sobre muchos extensores, pues su longitud está determinada por
2767 otras consideraciones. Más abajo se muestran algunos ejemplos de
2778 Works as long as callback is made:
2782 Works not at all for:
2791 @lilypond[verbatim,quote,relative=2]
2794 % increase the length of the tie
2795 -\tweak #'minimum-length #5
2799 @lilypond[verbatim,quote,relative=2]
2801 \compressFullBarRests
2803 % increase the length of the rest bar
2804 \once \override MultiMeasureRest #'minimum-length = #20
2809 @lilypond[verbatim,quote,relative=2]
2811 % increase the length of the hairpin
2812 \override Hairpin #'minimum-length = #20
2816 Esta sobreescritura se puede usar también para aumentar la longitud de
2817 las ligaduras de expresión y de fraseo:
2819 @lilypond[verbatim,quote,relative=2]
2822 -\tweak #'minimum-length #5
2827 -\tweak #'minimum-length #5
2831 Para algunos objetos de presentación, la propiedad
2832 @code{minimum-length} es efectiva sólo si se llama explícitamente al
2833 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
2834 propiedad @code{springs-and-rods} al valor
2835 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
2836 de un glissando no tiene efecto a no ser que se establezca la
2837 propiedad @code{springs-and-rods}:
2839 @lilypond[verbatim,quote,relative=1]
2843 % not effective alone
2844 \once \override Glissando #'minimum-length = #20
2847 % effective only when both overrides are present
2848 \once \override Glissando #'minimum-length = #20
2849 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
2853 Lo mismo se puede decir del objeto @code{Beam}:
2855 @lilypond[verbatim,quote,relative=1]
2856 % not effective alone
2857 \once \override Beam #'minimum-length = #20
2860 % effective only when both overrides are present
2861 \once \override Beam #'minimum-length = #20
2862 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2866 @strong{@i{The @code{to-barline} property}}
2868 La segunda propiedad útil del @code{spanner-interface} es
2869 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2870 haciendo que los reguladores y otros objetos de extensión que terminan
2871 sobre la primera nota de un compás, en vez de eso terminen en la línea
2872 divisoria inmediatamente precedente. Si se establece al valor falso,
2873 el extensor llegará más allá de la barra de compás y terminará
2874 exactamente sobre la nota:
2876 @lilypond[verbatim,quote,relative=2]
2877 a \< a a a a \! a a a \break
2878 \override Hairpin #'to-barline = ##f
2879 a \< a a a a \! a a a
2882 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
2883 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2884 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2885 que terminar en la barra de compás no tendría ningún significado.
2887 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
2889 Entre los objetos que contemplan el interface
2890 @code{line-spanner-interface} se encuentran
2893 @item @code{DynamicTextSpanner}
2894 @item @code{Glissando}
2895 @item @code{TextSpanner}
2896 @item @code{TrillSpanner}
2897 @item @code{VoiceFollower}
2900 La rutina responsable de dibujar los sellos de estos extensores es
2901 @code{ly:line-interface::print}. esta rutina determina la
2902 localización exacta de los dos puntos extremos y traza una línea entre
2903 ellos, en el estilo solicitado. Las posiciones de los dos puntos
2904 extremos del extensor se calculan al vuelo, pero es posible
2905 sobreescribir sus coordenadas Y. Las propiedades que se deben
2906 especificar están anidadas a dos niveles de profundidad en la
2907 jerarquía de propiedades, pero la sintaxis de la instrucción
2908 @code{\override} es bastante sencilla:
2910 @lilypond[relative=2,quote,verbatim]
2912 \once \override Glissando #'(bound-details left Y) = #3
2913 \once \override Glissando #'(bound-details right Y) = #-2
2917 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2918 siendo el punto del cero la línea central del pentagrama. Para el
2919 glissando, esto es el valor de @code{Y} en la coordenada X que
2920 corresponde al punto central de cada cabeza de nota si nos imaginamos
2921 que la línea se extiende hasta allí.
2923 Si no está fijado @code{Y}, su valor se calcula a partir de la
2924 posición vertical del punto de anclaje correspondiente del extensor.
2926 En caso de salto de línea, los valores para los puntos extremos se
2927 especifican por las sub-listas @code{left-broken} y
2928 @code{right-broken} de @code{bound-details}. Por ejemplo:
2930 @lilypond[relative=2,ragged-right,verbatim,quote]
2931 \override Glissando #'breakable = ##t
2932 \override Glissando #'(bound-details right-broken Y) = #-3
2933 c1 \glissando \break
2937 Un número de propiedades adicionales de las sub-listas @code{left} y
2938 @code{right} de la propiedad @code{bound-details} se pueden
2939 especificar de la misma forma que @code{Y}:
2943 Establece la coordenada Y del punto extremo, en desplazamientos de
2944 @code{staff-space}s desde la línea central del pentagrama. De forma
2945 predeterminada es el centro del objeto ancla, y así un glissando
2946 apunta al centro vertical de la cabeza de la nota.
2948 Para extensores horizontales como los extensores de texto y los
2949 trinos, está inamoviblemente codificado como 0.
2951 @item attach-dir (dirección de anclaje)
2952 Determina dónde comienza y termina la línea en la dirección X, con
2953 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o @code{LEFT},
2954 izquierda) hace que la línea comience o termine en el lado izquierdo
2955 de la cabeza de la nota a la que está anclado.
2958 Es la coordenada X absoluta del punto extremo. Se suele calcular al
2959 vuelo, y su sobreescritura no tiene un efecto útil.
2961 @item stencil (sello)
2962 Los extensores de línea pueden tener símbolos al comienzo o al final,
2963 lo que está contenido en esta sub-propiedad. Esto es para uso
2964 interno; se recomienda en su lugar el uso de @code{text}.
2967 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
2968 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2969 de extensión horizontales.
2971 @lilypond[quote,ragged-right,relative=2,verbatim]
2972 \override TextSpanner #'(bound-details left text)
2973 = \markup { \small \bold Slower }
2974 c2\startTextSpan b c a\stopTextSpan
2977 @item stencil-align-dir-y (alineación del sello en y)
2978 @item stencil-offset (desplazamiento del sello)
2979 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2980 punto extremo, centrado sobre la línea, como viene definido por las
2981 subpropiedades @code{X} e @code{Y}. Si se fijan
2982 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2983 símbolo del borde verticalmente con relación al extremo de la línea:
2985 @lilypond[relative=1,quote,verbatim]
2986 \override TextSpanner
2987 #'(bound-details left stencil-align-dir-y) = #-2
2988 \override TextSpanner
2989 #'(bound-details right stencil-align-dir-y) = #UP
2991 \override TextSpanner
2992 #'(bound-details left text) = #"ggg"
2993 \override TextSpanner
2994 #'(bound-details right text) = #"hhh"
2995 c4^\startTextSpan c c c \stopTextSpan
2998 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2999 al contrario de lo que podría esperarse, pues el valor de @w{@code{-1}} o
3000 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
3001 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
3002 (arriba) alinea el borde superior del texto con la línea extensora.
3004 @item arrow (flecha)
3005 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
3006 flecha en el extremo de la línea.
3008 @item padding (relleno)
3009 Esta sub-propiedad controla el espacio entre el punto extremo
3010 especificado de la línea y el extremo real. Sin relleno, un glissando
3011 empezaría y terminaría en el centro de la cabeza de las notas.
3015 La función musical @code{\endSpanners} finaliza de forma prematura el
3016 extensor que comienza sobre la nota que sigue inmediatamente a
3017 continuación. Se termina después de una nota exactamente, o en la
3018 siguiente barra de compás si @code{to-barline} es verdadero y se
3019 produce una divisoria antes de la siguiente nota.
3021 @lilypond[verbatim,quote,ragged-right,relative=2]
3023 c2 \startTextSpan c2 c2
3028 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
3029 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
3032 Referencia de funcionamiento interno:
3033 @rinternals{TextSpanner},
3034 @rinternals{Glissando},
3035 @rinternals{VoiceFollower},
3036 @rinternals{TrillSpanner},
3037 @rinternals{line-spanner-interface}.
3040 @node Visibilidad de los objetos
3041 @subsection Visibilidad de los objetos
3042 @translationof Visibility of objects
3044 @cindex objetos, visibilidad de
3045 @cindex grobs, visibilidad de
3046 @cindex visibilidad de los objetos
3048 Hay cuatro formas principales en que se puede controlar la visibilidad
3049 de los objetos de presentación: se puede eliminar su sello, se pueden
3050 volver transparentes, se pueden pintar de blanco, o se puede
3051 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
3052 se aplican a todos los objetos de presentación; la última sólo a unos
3053 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
3054 introduce estas cuatro técnicas,
3055 véase @rlearning{Visibilidad y color de los objetos}.
3057 Hay también algunas otras técnicas que son específicas de ciertos
3058 objetos de presentación. Se estudian bajo Consideraciones especiales.
3061 * Eliminar el sello::
3062 * Hacer transparentes los objetos::
3063 * Pintar los objetos de blanco::
3064 * Uso de break-visibility (visibilidad en el salto)::
3065 * Consideraciones especiales::
3069 @node Eliminar el sello
3070 @unnumberedsubsubsec Eliminar el sello
3071 @translationof Removing the stencil
3073 @cindex sello, eliminar
3075 Todo objeto de presentación tiene una propiedad stencil (sello). De
3076 forma predeterminada está establecida a la función específica que
3077 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
3078 se llama a ninguna función y el objeto no se dibuja. La acción
3079 predeterminada se puede recuperar con @code{\revert}.
3081 @lilypond[quote,verbatim,relative=1]
3083 \override Score.BarLine #'stencil = ##f
3085 \revert Score.BarLine #'stencil
3090 @node Hacer transparentes los objetos
3091 @unnumberedsubsubsec Hacer transparentes los objetos
3092 @translationof Making objects transparent
3094 @cindex transparentes, hacer los objetos
3096 Todo objeto de presentación tiene una propiedad transparent
3097 (transparente) que de forma predeterminada está establecida a
3098 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
3101 @lilypond[quote,verbatim,relative=2]
3103 \once \override NoteHead #'transparent = ##t
3108 @node Pintar los objetos de blanco
3109 @unnumberedsubsubsec Pintar los objetos de blanco
3110 @translationof Painting objects white
3112 @cindex objetos, coloreado de
3113 @cindex coloreado de objetos
3115 @cindex impresión, orden de
3116 @cindex sobreescritura de objetos
3117 @cindex objetos, sobreescritura de
3118 @cindex grobs, sobreescritura de
3120 Todo objeto de presentación tiene una propiedad de color que de forma
3121 predeterminada está establecida a @code{black} (negro). Si se
3122 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
3123 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
3124 color de los puntos de cruce queda determinado por el orden en que se
3125 dibujan estos objetos, lo que puede dejar una imagen fantasma del
3126 objeto blanco, como puede verse aquí:
3128 @lilypond[quote,verbatim,relative=2]
3129 \override Staff.Clef #'color = #white
3133 Se puede evitar esto cambiando el orden de impresión de los objetos.
3134 Todos los objetos de presentación tienen una propiedad @code{layer}
3135 (capa) que se debe establecer a un valor entero. Los objetos con el
3136 valor de @code{layer} más bajo se dibujan primero, después se dibujan
3137 los objetos con valores progresivamente mayores, y así los objetos con
3138 valores más altos se dibujan encima de los que tienen valores más
3139 bajos. De forma predeterminada, casi todos los objetos tienen
3140 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
3141 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
3142 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
3143 impresión de los objetos con el mismo valor de @code{layer} es
3146 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
3147 predeterminado de @code{1}, se dibuja después de las líneas del
3148 pentagrama (valor @code{layer} predeterminado de @code{0}),
3149 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
3150 @code{Clef} un valor de @code{layer} más bajo, digamos @w{@code{-1}},
3151 para que se dibuje antes:
3153 @lilypond[quote,verbatim,relative=2]
3154 \override Staff.Clef #'color = #white
3155 \override Staff.Clef #'layer = #-1
3160 @node Uso de break-visibility (visibilidad en el salto)
3161 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
3162 @translationof Using break-visibility
3164 @c TODO Add making other objects breakable
3166 @cindex break-visibility
3168 Casi todos los objetos de presentación se imprimen una sola vez, pero
3169 algunos como las líneas divisorias, claves, indicaciones de compás y
3170 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
3171 se produce un salto de línea : una vez al final de la línea y otra al
3172 comienzo de la siguiente. Estos objetos reciben el nombre de
3173 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
3174 (visibilidad en el salto), para controlar su visibilidad en las tres
3175 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
3176 la línea si se produce un cambio, y al final de la línea si el cambio
3177 se produce en ese lugar.
3179 Por ejemplo, la indicación de compás se imprime de forma
3180 predeterminada al comienzo de la primera línea y en ningún otro lugar
3181 a no ser que cambie, en cuyo caso se imprime en el punto en que se
3182 produce el cambio. Si este cambio se produce al final de una línea,
3183 la nueva indicación de compás se imprime al principio de la línea
3184 siguiente y también al final de la línea anterior como indicación de
3187 Este comportamiento se controla por medio de la propiedad
3188 @code{break-visibility}, que se explica en
3189 @c Leave this ref on a newline - formats incorrectly otherwise -td
3190 @rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
3191 vector de tres valores booleanos que, por orden, determinan si el
3192 objeto se imprime al final, dentro, o al principio de la línea. O,
3193 para ser más exactos: antes del salto de línea, si no hay salto, o
3196 Como alternativa se puede especificar cualquiera de las ocho
3197 combinaciones mediante funciones predefinidas cuya definición está en
3198 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
3199 los objetos de presentación serán visibles en las posiciones que se
3200 muestran en el encabezamiento de cada columna:
3202 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
3203 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
3204 @headitem de función @tab de vector @tab salto @tab salto @tab salto
3206 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
3207 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
3208 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
3209 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
3210 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
3211 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
3212 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
3213 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
3216 Los ajustes predeterminados de @code{break-visibility} dependen del
3217 objeto de presentación. La tabla siguiente muestra todos los objetos
3218 de presentación de interés que resultan afectados por
3219 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
3221 @multitable @columnfractions .3 .3 .4
3223 @headitem Objeto @tab Contexto usual @tab Valor predet.
3225 @c omit Ambitus as it appears not to be affected by break-visibility -td
3226 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
3227 @item @code{BarLine} @tab @code{Score} @tab calculado
3228 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
3229 @c omit the following item until it can be explained -td
3230 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
3231 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3232 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
3233 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
3234 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3235 @c omit KeyCancellation until it can be explained -td
3236 @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible}
3237 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
3238 @c omit LeftEdge until it can be explained -td
3239 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
3240 @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible}
3241 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
3242 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
3246 El ejemplo de abajo muestra el uso de la forma de vector para
3247 controlar la visibilidad de las líneas divisorias:
3249 @lilypond[quote,verbatim,relative=1,ragged-right]
3252 % Remove bar line at the end of the current line
3253 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
3259 Aunque los tres componentes del vector utilizado para sobreescribir
3260 @code{break-visibility} deben estar presentes, no todos son efectivos
3261 para todos los objetos de presentación, y algunas combinaciones pueden
3262 incluso dar errores. Son de aplicación las siguientes limitaciones:
3265 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
3266 @item No se puede imprimir el número de compás al principio de la primera
3267 línea a no ser que su valor establecido sea distinto de 1.
3268 @item Clave: véase más abajo
3269 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
3270 se suprimen por completo. Utilice begin-of line-invisible para
3271 imprimirlas y all-invisible para suprimirlas.
3272 @item Armadura: véase más abajo
3273 @item OctavateEight: véase más abajo
3277 @node Consideraciones especiales
3278 @unnumberedsubsubsec Consideraciones especiales
3279 @translationof Special considerations
3281 @strong{@emph{Visibilidad después de un cambio explícito}}
3283 @cindex armadura, visibilidad después de un cambio explícito
3284 @cindex explicitKeySignatureVisibility
3285 @cindex clave, visibilidad después de un cambio explícito
3286 @cindex explicitClefVisibility
3288 La propiedad @code{break-visibility} controla la visibilidad de las
3289 armaduras y cambios de clave sólo al principio de las líneas, es
3290 decir, después de un salto. No tiene ningún efecto sobre la
3291 visibilidad de la armadura o la clave después de un cambio explícito
3292 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
3293 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
3294 bemol mayor es visible incluso con @code{all-invisible} establecido.
3296 @lilypond[quote,verbatim,relative=1,ragged-right]
3299 % Try to remove all key signatures
3300 \override Staff.KeySignature #'break-visibility = #all-invisible
3308 La visibilidad de estos cambios explícitos de tonalidad y de clave se
3309 controla por medio de las propiedades
3310 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
3311 Son los equivalentes de la propiedad @code{break-visibility} y las dos
3312 toman un vector de tres valores booleanos o las funciones predefinidas
3313 relacionadas anteriormente, exactamente igual que
3314 @code{break-visibility}. Las dos son propiedades del contexto Staff,
3315 no de los propios objetos de presentación, y por tanto se establecen
3316 utilizando la instrucción @code{\set}. Las dos están establecidas de
3317 forma predeterminada al valor @code{all-visible}. Estas propiedades
3318 controlan sólo la visibilidad de las armaduras y las claves que
3319 resultan de los cambios explícitos y no afectan a las armaduras y
3320 tonalidades que están al principio de las líneas; para quitarlas, aún
3321 se debe sobreescribir la propiedad @code{break-visibility} en el
3322 objeto correspondiente.
3324 @lilypond[quote,verbatim,relative=1,ragged-right]
3327 \set Staff.explicitKeySignatureVisibility = #all-invisible
3328 \override Staff.KeySignature #'break-visibility = #all-invisible
3335 @strong{@emph{Visibilidad de las alteraciones de precaución}}
3337 Para eliminar las alteraciones de precaución que se imprimen en un
3338 cambio de tonalidad explícito, establezca la propiedad
3339 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3341 @lilypond[quote,verbatim,relative=1,ragged-right]
3344 \set Staff.explicitKeySignatureVisibility = #all-invisible
3345 \set Staff.printKeyCancellation = ##f
3346 \override Staff.KeySignature #'break-visibility = #all-invisible
3353 Con estas sobreescrituras solamente permanecen las alteraciones
3354 accidentales delante de las notas para indicar el cambio de tonalidad.
3356 @c TODO Add visibility of cautionary accidentals before notes
3358 @strong{@emph{Automatic bars}}
3360 @cindex automaticBars
3361 @cindex líneas divisorias, eliminación
3363 Como caso especial, la impresión de las líneas divisorias también se
3364 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
3365 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
3366 imprimen automáticamente; se deben crear explícitamente con una
3367 instrucción @code{\bar}. A diferencia de la instrucción predefinida
3368 @code{\cadenzaOn}, los compases se siguen contando. La generación de
3369 compases continúa de acuerdo a esta cuenta si esta propiedad se
3370 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
3371 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
3376 @strong{@emph{Octavated clefs}}
3378 @cindex octavadas, visibilidad de las claves
3379 @cindex visibilidad de las claves octavadas
3380 @cindex claves, visibilidad de la octavación
3382 El pequeño símbolo de octava sobre las claves en octava alta o baja se
3383 produce por parte del objeto @code{OctavateEight}. Su visibilidad se
3384 hereda automáticamente de la del objeto @code{Clef}, así que no es
3385 necesario aplicar las sobreescrituras correspondientes
3386 @code{break-visibility} a los objetos
3387 @code{OctavateEight} para suprimir los símbolos de octavación
3388 para las claves invisibles.
3390 Para los cambios de clave explícitos, la propiedad
3391 @code{explicitClefVisibility} controla tanto el símbolo de clave como
3392 el símbolo de octava asociado.
3395 Manual de aprendizaje:
3396 @rlearning{Visibilidad y color de los objetos}
3399 @node Estilos de línea
3400 @subsection Estilos de línea
3401 @translationof Line styles
3403 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3404 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
3405 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
3407 Todos ellos usan las mismas rutinas que el glissando para dibujar los
3408 textos y las líneas, y por ello el ajuste fino de su comportamiento se
3409 hace de la misma manera. Se hace con un spanner (un objeto de
3410 extensión), y la rutina responsable de dibujar los objetos de
3411 extensión es @code{ly:line-interface::print}. Esta rutina determina la
3412 colocación exacta de los dos @i{extremos del objeto de extensión} y
3413 dibuja una línea entre ellos, en el estilo solicitado.
3415 He aquí un ejemplo de los distintos estilos de línea disponibles, y
3416 cómo aplicarles ajustes finos.
3418 @lilypond[relative=2,ragged-right,verbatim,quote]
3420 \once \override Glissando #'style = #'dashed-line
3422 \override Glissando #'style = #'dotted-line
3424 \override Glissando #'style = #'zigzag
3426 \override Glissando #'style = #'trill
3430 Las posiciones de los puntos extremos del objeto de extensión se
3431 computan al vuelo para cada uno de los objetos gráficos, pero es
3432 posible sobreescribirlos:
3435 @lilypond[relative=2,ragged-right,verbatim,quote]
3437 \once \override Glissando #'(bound-details right Y) = #-2
3441 El valor de @code{Y} está establecido a @w{@code{-2}} para el extremo
3442 derecho. El lado izquierdo se puede ajustar de forma similar
3443 especificando @code{left} en vez de @code{right}.
3445 Si no está establecido @code{Y}, el valor se computa a partir de la
3446 posición vertical de los puntos de anclaje izquierdo y derecho del
3449 Son posibles otros ajustes de los extensores, para ver más detalles
3450 consulte @ref{Objetos de extensión}.
3453 @node Rotación de objetos
3454 @subsection Rotación de objetos
3455 @translationof Rotating objects
3457 Tanto los objetos de presentación como los elementos de texto de
3458 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
3459 pero difiere el método de hacerlo.
3462 * Rotación de objetos de presentación::
3463 * Rotación de elementos de marcado::
3466 @node Rotación de objetos de presentación
3467 @unnumberedsubsubsec Rotación de objetos de presentación
3468 @translationof Rotating layout objects
3470 @cindex rotating objects
3471 @cindex objects, rotating
3473 Todos los objetos de presentación que contemplan el interface
3474 @code{grob-interface} se pueden rotar estableciendo su propiedad
3475 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
3476 rotación en sentido antihorario, y las coordenadas x e y del punto con
3477 relación al punto de referencia del objeto, alrededor del que se va a
3478 realizar la rotación. El ángulo de rotación se especifica en grados
3479 y las coordenadas en espacios de pentagrama.
3481 El ángulo de rotación y las coordenadas del punto de rotación se deben
3482 determinar por ensayo y error.
3484 @cindex reguladores en ángulo
3485 @cindex ángulo, reguladores en
3487 Solamente en ciertas ocasiones es útil la rotación de objetos de
3488 presentación; el ejemplo siguiente muestra una situación en que puede
3491 @lilypond[quote,verbatim,relative=1]
3493 \override Hairpin #'rotation = #'(20 -1 0)
3498 @node Rotación de elementos de marcado
3499 @unnumberedsubsubsec Rotación de elementos de marcado
3500 @translationof Rotating markup
3502 Todos los textos de marcado se pueden rotar para que se dispongan en
3503 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
3504 instrucción acepta dos argumentos: el ángulo de rotación en grados en
3505 sentido antihorario, y el texto que rotar. Los límites que ocupa el
3506 texto no se rotan: toman su valor a partir de los extremos de las
3507 coordenadas x e y del texto rotado. En el ejemplo siguiente la
3508 propiedad @code{outside-staff-priority} del texto se establece a
3509 @code{#f} para desactivar la evitación automática de colisiones, lo
3510 que empuja al texto a una posición muy alta.
3512 @lilypond[quote,verbatim,relative=1]
3513 \override TextScript #'outside-staff-priority = ##f
3514 g4^\markup { \rotate #30 "a G" }
3515 b^\markup { \rotate #30 "a B" }
3516 des^\markup { \rotate #30 "a D-Flat" }
3517 fis^\markup { \rotate #30 "an F-Sharp" }
3521 @node Trucos avanzados
3522 @section Trucos avanzados
3523 @translationof Advanced tweaks
3525 Esta sección trata sobre distintos enfoques en la realización de
3526 ajustes finos a la apariencia de la partitura impresa.
3529 * Alineación de objetos::
3530 * Agrupación vertical de objetos gráficos::
3531 * Modificación de los sellos::
3532 * Modificación de las formas::
3533 * Contenedores unpure-pure::
3537 Manual de aprendizaje:
3538 @rlearning{Trucar la salida},
3539 @rlearning{Otras fuentes de información}.
3541 Referencia de la notación:
3542 @ref{Explicación del Manual de referencia de funcionamiento interno},
3543 @ref{Modificar las propiedades}.
3545 Manual de extensión:
3546 @rextend{Interfaces para programadores}.
3549 @file{scm/define-grobs.scm}.
3551 Fragmentos de código:
3552 @rlsr{Tweaks and overrides}.
3554 Referencia de funcionamiento interno:
3555 @rinternals{All layout objects}.
3558 @node Alineación de objetos
3559 @subsection Alineación de objetos
3560 @translationof Aligning objects
3562 Los objetos gráficos que soportan el interface
3563 @code{self-alignment-interface} y/o el @code{side-position-interface}
3564 se pueden alinear contra un objeto colocado previamente, de diversas
3565 maneras. Para ver una lista de estos objetos, consulte
3566 @rinternals{self-alignment-interface} y
3567 @rinternals{side-position-interface}.
3569 Todos los objetos gráficos tienen un punto de referencia, una
3570 extensión horizontal y una extensión vertical. La extensión
3571 horizontal es una pareja de números que dan los desplazamientos a
3572 partir del punto de referencia de los bordes izquierdo y derecho,
3573 siendo negativos los desplazamientos hacia la izquierda. La extensión
3574 vertical es una pareja de números que dan el desplazamiento a partir
3575 del punto de referencia hasta los bordes inferior y superior, siendo
3576 negativos los desplazamientos hacia abajo.
3578 La posición de un objeto sobre el pentagrama viene dada por los
3579 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
3580 valor de @code{X-offset} da el desplazamiento desde la coordenada X
3581 del punto de referencia del objeto padre, y el valor de
3582 @code{Y-offset} da el desplazamiento a partir de la línea central del
3583 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
3584 pueden establecer directamente o se puede dejar que se calculen por
3585 parte de procedimientos para conseguir una alineación con el objeto
3588 @warning{Muchos objetos tienen consideraciones de posicionamiento
3589 especiales que hacen que se ignore o se modifique cualquier ajuste
3590 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
3591 objeto contemple el interface @code{self-alignment-interface}. La
3592 sobreescritura de las propiedades @code{X-offset} ó @code{Y-offset} a
3593 un valor fijo hace que se descarte la respectiva propiedad
3594 @code{self-alignment}.}
3596 Por ejemplo, una alteración accidental se puede reposicionar
3597 verticalmente estableciendo @code{Y-offset} pero los cambios a
3598 @code{X-offset} no tienen ningún efecto.
3600 Las letras de ensayo se pueden alinear con objetos divisibles como
3601 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
3602 propiedades especiales que se encuentran en
3603 @code{break-aligned-interface} para el posicionamiento de las letras
3604 de ensayo sobre dichos objetos.
3607 Referencia de la notación:
3608 @ref{Uso del break-alignable-interface}.
3610 Manual de extensión:
3611 @rextend{Funciones de callback}.
3614 * Establecer directamente X-offset e Y-offset::
3615 * Uso del side-position-interface::
3616 * Uso del self-alignment-interface::
3617 * Uso del break-alignable-interface::
3621 @node Establecer directamente X-offset e Y-offset
3622 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
3623 @translationof Setting X-offset and Y-offset directly
3625 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
3626 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
3627 notas con una digitación en su posición predeterminada y con los
3628 valores @code{X-offset} y @code{Y-offset} modificados.
3630 @lilypond[verbatim,quote,relative=2]
3633 -\tweak #'X-offset #0
3634 -\tweak #'Y-offset #0
3637 -\tweak #'X-offset #-1
3638 -\tweak #'Y-offset #1
3645 @node Uso del side-position-interface
3646 @unnumberedsubsubsec Uso del @code{side-position-interface}
3647 @translationof Using the side-position-interface
3649 Un objeto que contempla el @code{side-position-interface} se puede
3650 colocar junto a su objeto padre de forma que los bordes especificados
3651 de los dos objetos se toquen. El objeto se puede situar encima,
3652 debajo, a la derecha o a la izquierda del objeto padre. El padre no
3653 se puede especificar; viene determinado por el orden de los elementos
3654 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
3655 nota asociada como padre.
3657 Los valores de las propiedades @code{side-axis} y @code{direction}
3658 determinan dónde colocar el objeto, como sigue:
3660 @c TODO add an example of each to the table
3662 @multitable @columnfractions .3 .3 .3
3663 @headitem @code{side-axis} @tab @code{direction} @tab
3664 @headitem propiedad @tab propiedad @tab colocación
3666 @item @code{0} @tab @w{@code{-1}} @tab izquierda
3667 @item @code{0} @tab @code{1} @tab derecha
3668 @item @code{1} @tab @w{@code{-1}} @tab debajo
3669 @item @code{1} @tab @code{1} @tab encima
3673 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
3674 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
3675 procedimiento devuelve el calor correcto de @code{X-offset} para
3676 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
3677 el valor de @code{direction}.
3679 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
3680 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
3681 procedimiento devuelve el valor correcto de @code{Y-offset} para
3682 situar el objeto encima o debajo del padre de acuerdo con el valor de
3685 @c TODO Add examples
3688 @node Uso del self-alignment-interface
3689 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
3690 @translationof Using the self-alignment-interface
3692 @emph{Auto-alineación horizontal de los objetos}
3694 La alineación horizontal de un objeto que contempla el interface
3695 @code{self-alignment-interface} está controlada por el valor de la
3696 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
3697 @code{X-offset} de este objeto esté establecida a
3698 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
3699 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
3700 mitad de la extensión X total del objeto. Los valores negativos
3701 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
3702 valor de @code{0} centra el objeto sobre el punto de referencia de su
3703 padre, un valor de @w{@code{-1}} alinea el borde izquierdo del objeto
3704 sobre el punto de referencia de su padre, y un valor de @code{1}
3705 alinea el borde derecho del objeto sobre el punto de referencia de su
3706 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
3707 @code{RIGHT} en sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
3710 Normalmente se usaría la instrucción @code{\override} para modificar
3711 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
3712 @code{\tweak} para alinear varias anotaciones por separado sobre una
3715 @lilypond[quote,verbatim,relative=1]
3717 -\tweak #'self-alignment-X #-1
3719 -\tweak #'self-alignment-X #0
3721 -\tweak #'self-alignment-X #RIGHT
3723 -\tweak #'self-alignment-X #-2.5
3724 ^"aligned further to the right"
3727 @emph{Auto-alineación vertical de los objetos}
3729 Los objetos se pueden alinear verticalmente en una forma análoga a la
3730 alineación horizontal si la propiedad @code{Y-offset} está establecida
3731 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
3732 a menudo se encuentran implicados otros mecanismos en la alineación
3733 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
3734 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
3735 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
3736 las dimensiones verticales del objeto, que suele ser bastante pequeño,
3737 por lo que pueden requerirse números bastante grandes. Un valor de
3738 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
3739 referencia del objeto padre, un valor de @code{0} alinea el centro del
3740 objeto con el punto de referencia del padre, y un valor de @code{1}
3741 alinea el borde superior del objeto con el punto de referencia del
3742 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
3743 @code{UP} en sustitución de @w{@code{-1}},
3744 @code{0} y @code{1}, respectivamente.
3746 @emph{Auto-alineación de objetos en las dos direcciones}
3748 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
3749 alinear un objeto en las dos direcciones simultáneamente.
3751 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
3752 se acerque a la cabeza de la nota.
3754 @lilypond[quote,verbatim,relative=2]
3756 -\tweak #'self-alignment-X #0.5 % move horizontally left
3757 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
3758 -\tweak #'self-alignment-Y #-1 % move vertically up
3763 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
3765 @c Cannot document as they do not seem to operate consistently on all objects -td
3766 @c TODO investigate further
3768 The @code{aligned-on-parent} procedures are used in the same way
3769 as the @code{aligned-on-self} procedures, they difference being
3770 that they permit an object to be aligned with the @emph{edges} of
3771 the parent rather than the parent's reference point. The following
3772 example shows the difference:
3776 @lilypond[verbatim,quote]
3782 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
3784 @c Cannot document as they do not seem to operate consistently on all objects -td
3785 @c TODO investigate further
3789 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
3792 @node Uso del break-alignable-interface
3793 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
3794 @translationof Using the break-alignable-interface
3796 @cindex alineación a objetos
3797 @cindex break-align-symbols
3799 Las letras de ensayo se pueden alinear con objetos de notación
3800 distintos a las barras de compás. Estos objetos son @code{ambitus},
3801 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
3802 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
3803 @code{time-signature}.
3805 De forma predeterminada, las letras de ensayo y los números de compás
3806 se centran horizontalmente sobre el objeto:
3808 @lilypond[verbatim,quote,relative=1]
3809 % The rehearsal mark will be centered above the Clef
3810 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
3815 % The rehearsal mark will be centered above the Time Signature
3816 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
3822 % The rehearsal mark will be centered above the Breath Mark
3823 \override Score.RehearsalMark #'break-align-symbols = #'(breathing-sign)
3832 Se puede especificar una lista de posibles objetos para la alineación.
3833 Si algunos de los objetos son invisibles en ese punto debido al valor
3834 de @code{break-visibility} o a valores de visibilidad explícitos para
3835 las armaduras y las claves, la letra de ensayo o número de compás se
3836 alinean con el primer objeto de la lista que sea visible. Si ningún
3837 objeto de la lista es visible, el objeto se alinea con la línea
3838 divisoria. Si la línea divisoria es invisible, el objeto se alinea
3839 con el punto en el que se encontraría la línea divisoria.
3841 @lilypond[verbatim,quote,relative=1]
3842 % The rehearsal mark will be centered above the Key Signature
3843 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3848 % The rehearsal mark will be centered above the Clef
3849 \set Staff.explicitKeySignatureVisibility = #all-invisible
3850 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3855 % The rehearsal mark will be centered above the Bar Line
3856 \set Staff.explicitKeySignatureVisibility = #all-invisible
3857 \set Staff.explicitClefVisibility = #all-invisible
3858 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3865 La alineación de la letra de ensayo con relación al objeto de notación
3866 se puede cambiar, como se ve en el ejemplo siguiente. En una
3867 partitura con varios pentagramas, este ajuste se debe hacer para todos
3870 @lilypond[verbatim,quote,relative=1]
3871 % The RehearsalMark will be centered above the Key Signature
3872 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3878 % The RehearsalMark will be aligned with the left edge of the Key Signature
3879 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
3883 % The RehearsalMark will be aligned with the right edge of the Key Signature
3884 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
3890 La letra de ensayo también se puede desplazar al borde derecho o
3891 izquierdo en una medida arbitraria. Las unidades son espacios de
3894 @lilypond[verbatim,quote,relative=1]
3895 % The RehearsalMark will be aligned with the left edge of the Key Signature
3896 % and then shifted right by 3.5 staff-spaces
3897 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3898 \once \override Score.KeySignature #'break-align-anchor = #3.5
3902 % The RehearsalMark will be aligned with the left edge of the Key Signature
3903 % and then shifted left by 2 staff-spaces
3904 \once \override Score.KeySignature #'break-align-anchor = #-2
3911 @node Agrupación vertical de objetos gráficos
3912 @subsection Agrupación vertical de objetos gráficos
3913 @translationof Vertical grouping of grobs
3915 @c TODO Expand this section
3917 Los grobs (objetos gráficos) @code{VerticalAlignment} y
3918 @code{VerticalAxisGroup} trabajan de manera coordinada.
3919 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
3920 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
3921 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
3922 Normalmente sólo existe un @code{VerticalAlignment} por cada
3923 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
3924 @code{VerticalAxisGroup}.
3927 @node Modificación de los sellos
3928 @subsection Modificación de los sellos
3929 @translationof Modifying stencils
3931 Todos los objetos de presentación tienen una propiedad @code{stencil}
3932 que es parte del @code{grob-interface}. De forma predeterminada, esta
3933 propiedad suele estar establecida a una función específica del objeto
3934 que está hecha a medida para disponer el símbolo que lo representa en
3935 la salida. Por ejemplo, el ajuste estándar para la propiedad
3936 @code{stencil} del objeto @code{MultiMeasureRest} es
3937 @code{ly:multi-measure-rest::print}.
3939 El símbolo estándar de cualquier objeto se puede sustituir modificando
3940 la propiedad @code{stencil} para que haga referencia a un
3941 procedimiento diferente escrito especialmente. Esto requiere un alto
3942 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3943 una forma más fácil que a menudo puede dar resultados adecuados.
3945 El procedimiento es establecer la propiedad @code{stencil} al
3946 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3947 añadir una propiedad @code{text} al objeto ajustada para que contenga
3948 el texto de marcado que produce el símbolo requerido. Debido a la
3949 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3950 particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
3952 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3953 la nota a unas aspas dentro de una circunferencia.
3955 @lilypond[verbatim,quote]
3957 \once \override NoteHead #'stencil = #ly:text-interface::print
3958 \once \override NoteHead #'text = \markup {
3960 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3961 \musicglyph #"noteheads.s2cross"
3969 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3970 a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
3972 @c TODO Add inserting eps files or ref to later
3974 @c TODO Add inserting Postscript or ref to later
3977 Referencia de la notación:
3978 @ref{Notación gráfica dentro de elementos de marcado},
3979 @ref{Formatear el texto},
3980 @ref{Text markup commands},
3981 @ref{La tipografía Feta}.
3984 @node Modificación de las formas
3985 @subsection Modificación de las formas
3986 @translationof Modifying shapes
3989 * Modificación de ligaduras de unión y de expresión::
3993 @node Modificación de ligaduras de unión y de expresión
3994 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
3995 @translationof Modifying ties and slurs
3997 @cindex ligaduras de expresión, modificar
3998 @cindex ligaduras de unión, modificar
3999 @cindex Bézier, curvas de, puntos de control
4000 @cindex puntos de control en curvas de Bézier
4002 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
4003 de Bézier de tercer orden. Si la forma de la ligadura calculada
4004 automáticamente no resulta óptima, se puede modificar su forma
4005 manualmente mediante la especificación explícita de los cuatro puntos
4006 de control necesarios para definir una curva de Bézier de tercer
4009 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
4010 puntos de control. El primer y cuarto puntos de control son
4011 exactamente los puntos extremos de comienzo y de final de la curva.
4012 Los dos puntos de control intermedios definen la forma. Se pueden
4013 encontrar en la web animaciones que muestran cómo se traza la curva,
4014 pero la descripción siguiente puede ser de ayuda. La curva comienza a
4015 partir del primer punto de control dirigiéndose directamente hacia el
4016 segundo, curvándose progresivamente para dirigirse hacia el tercero y
4017 continuando la curva hacia el cuarto, llegando a éste en viaje directo
4018 desde el tercer punto de control. La curva está contenida enteramente
4019 dentro del cuadrilátero definido por los cuatro puntos de control.
4021 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
4022 @code{\tieDown} no sirve de ayuda.
4024 @lilypond[verbatim,quote,relative=1]
4028 { r4 <g c,> <g c,> <g c,> }
4032 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
4033 de control como sigue.
4035 Las coordenadas de los puntos de control de Bézier se especifican en
4036 unidades de espacios de pentagrama. La coordenada@tie{}X está en
4037 relación con el punto de referencia de la nota a la que está unida la
4038 ligadura, y la coordenada@tie{}Y está en relación con la línea central
4039 del pentagrama. Las coordenadas se introducen como una lista de
4040 cuatro parejas de números decimales (reales). Un enfoque es estimar
4041 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
4042 los dos puntos intermedios. Los valores óptimos se encuentran por
4045 Es útil recordar que una curva simétrica necesita puntos de control
4046 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
4047 las transformaciones de la curva tales como la traslación, rotación y
4048 escalado se pueden obtener aplicando la misma transformación a los
4049 puntos de control de la curva.
4051 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
4052 satisfactoria. Observe la colocación: debe ir inmediatamente antes de
4053 la nota a la que se asigna el comienzo de la ligadura de expresión o
4056 @lilypond[verbatim,quote,relative=1]
4060 #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
4064 { r4 <g c,> <g c,> <g c,> }
4069 No es posible modificar la forma de las ligaduras de unión o de
4070 expresión cambiando la propiedad @code{control-points} si hay más de
4071 una en el mismo momento musical, ni siquiera usando la instrucción
4072 @code{\tweak}. Sin embargo, se puede sobreescribir la propiedad
4073 @code{tie-configuration} de @code{TieColumn} para fijar la línea de
4074 inicio y la dirección según se requiera.
4077 Referencia de funcionamiento interno:
4078 @rinternals{TieColumn}.
4080 @cindex Scheme, contenedores puros
4081 @cindex Scheme, contenedores no-puros
4082 @cindex puros, contenedores de Scheme
4083 @cindex no-puros: contenedores de Scheme
4084 @cindex horizontal, sobreescribir el espaciado
4087 @node Contenedores unpure-pure
4088 @subsection Contenedores unpure-pure
4089 @translationof Unpure-pure containers
4091 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para la
4092 sobreescritura de los cálculos del espaciado en el @emph{eje Y}
4093 (concretamente @code{Y-offset} e @code{Y-extent}) con una función de
4094 Scheme en lugar de un literal, es decir, un número o una pareja de
4097 Para ciertos objetos gráficos, las dimensiones @code{Y-extent} están
4098 basadas en la propiedad @code{stencil}, la sobreescritura de la
4099 propiedad de sello de éstos requiere una sobreescritura adicional de
4100 @code{Y-extent} con un contenedor unpure-pure. Cuando una función
4101 sobreescribe una dimensión @code{Y-offset} y/o @code{Y-extent} se
4102 supone que esto dispara los cálculos de los saltos de línea
4103 prematuramente durante la compilación. Así pues, la función no se
4104 evalúa en absoluto (devolviendo por lo general un valor de @samp{0} o
4105 @samp{'(0 . 0)}) lo que puede dar lugar a colisiones. Una función
4106 @q{pura} no afecta a las propiedades, objetos o suicidios de grobs, y
4107 por ello siempre ven sus valores relacionados con el eje Y evaluados
4110 Actualmente hay unas treinta funciones que ya se consideran @q{puras}
4111 y los contenedores Unpure-pure son una manera de establecer funciones
4112 que no están en esta lista como @q{puras}. La función @q{pura} se
4113 evalúa @emph{antes} de cualquier salto de línea y así el espaciado
4114 horizontal se puede ajustar @q{a tiempo}. La función @q{impura} se
4115 evalúa entonces @emph{después} del salto de línea.
4117 @warning{Dado que es difícil saber siempre qué funciones están en esta
4118 lista, recomendamos que cualquier función @q{pura} que estemos creando
4119 no utilice los grobs @code{Beam} o @code{VerticalAlignment}.}
4121 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
4123 @code{(ly:make-unpure-pure-container f0 f1)}
4125 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
4126 1}) y el primer argumento siempre debe ser el grob. Ésta es la
4127 función que da el resultado real. @var{f1} es la función que se
4128 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
4129 primer argumento debe ser siempre el grob pero los argumentos segundo
4130 y tercero son argumentos de @q{inicio} y de @q{final}.
4132 @var{inicio} y @var{final} son, a todos los efectos, valores mudos que
4133 sólo tienen importancia para los @code{objetos de extensión} (o sea:
4134 @code{Hairpin}, regulador, o @code{Beam}, barra), que pueden devolver
4135 distintas estimaciones de altura basadas en una columna de inicio y
4138 El resto son los otros argumentos para la primera función (que puede
4139 no ser ninguno si @var{n = 1}).
4141 El resultado de la segunda función se usa como una aproximación del
4142 valor necesario, que se usa entonces por la primera función para
4143 obtener el valor real que se usa a continuación para el ajuste de
4144 precisión mucho más tardío durante el proceso de espaciado.
4146 @lilypond[verbatim,quote,ragged-right]
4147 #(define (square-line-circle-space grob)
4148 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
4149 (notename (ly:pitch-notename pitch)))
4150 (if (= 0 (modulo notename 2))
4151 (make-circle-stencil 0.5 0.0 #t)
4152 (make-filled-box-stencil '(0 . 1.0)
4155 squareLineCircleSpace = {
4156 \override NoteHead #'stencil = #square-line-circle-space
4159 smartSquareLineCircleSpace = {
4160 \squareLineCircleSpace
4161 \override NoteHead #'Y-extent =
4162 #(ly:make-unpure-pure-container
4163 ly:grob::stencil-height
4164 (lambda (grob start end) (ly:grob::stencil-height grob)))
4167 \new Voice \with { \remove "Stem_engraver" }
4169 \squareLineCircleSpace
4171 \smartSquareLineCircleSpace
4176 En el primer compás, sin el contenedor @emph{unpure-pure}, el motor de
4177 espaciado no conoce la anchura de la cabeza de la nota y permite que
4178 colisione con las alteraciones accidentales. En el segundo compás, el
4179 motor de espaciado conoce la anchura de las cabezas de las notas y
4180 evita la colisión mediante el alargamiento de la línea en la medida
4183 Normalmente, para cálculos simples se pueden usar funciones casi
4184 idénticas tanto para las partes @q{no pura} y @q{pura}, simplemente
4185 cambiando el número de argumentos que se pasan a, y el ámbito de, la
4188 @warning{Si una función está caracterizada como @q{pura} y resulta que
4189 no lo es, el resultado puede ser inesperado.}
4192 @node Uso de las funciones musicales
4193 @section Uso de las funciones musicales
4194 @translationof Using music functions
4196 @c TODO -- add @seealso, etc. to these subsections
4198 Dondequiera que se necesite reutilizar trucos con distintas
4199 expresiones musicales, con frecuencia conviene hacer que el truco
4200 forme parte de una @emph{función musical}. En esta sección
4201 estudiaremos solamente las funciones de @emph{sustitución}, en las que
4202 el objeto es sustituir una variable dentro de un fragmento de código
4203 de entrada de LilyPond. Se describen otras funciones más complejas en
4204 @rextend{Funciones musicales}.
4207 * Sintaxis de las funciones de sustitución::
4208 * Ejemplos de funciones de sustitución::
4212 @node Sintaxis de las funciones de sustitución
4213 @subsection Sintaxis de las funciones de sustitución
4214 @translationof Substitution function syntax
4216 Es fácil hacer una función que sustituya una variable dentro de código
4217 de LilyPond. La forma general de estas funciones es
4221 #(define-music-function
4222 (parser location @var{arg1} @var{arg2} @dots{})
4223 (@var{type1?} @var{type2?} @dots{})
4225 @var{@dots{}música@dots{}}
4232 @multitable @columnfractions .33 .66
4233 @item @code{@var{argN}}
4234 @tab @var{n}-ésimo argumento
4236 @item @code{@var{typeN?}}
4237 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
4238 debe devolver @code{#t}.
4240 @item @code{@var{@dots{}música@dots{}}}
4241 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
4242 lugares en que sólo se permiten construcciones de Lilypond) o @code{#}
4243 (para usarlo como un valor de Scheme o un argumento de función musical
4244 o música dentro de listas de música) para referenciar argumentos
4245 (p.ej. @samp{#arg1}).
4248 Los argumentos @code{parser} y @code{location} son necesarios, y se
4249 utilizan en algunas situaciones avanzadas como se encuentra descrito
4250 en @rextend{Sintaxis de las funciones musicales}. Para las funciones
4251 de sustitución, tan sólo hemos de asegurarnos de incluirlos.
4253 También es necesaria la lista de predicados de tipo. Algunos de los
4254 predicados de tipo más comunes que se utilizan en las funciones
4259 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
4271 Para ver una lista de los predicados de tipo disponibles, consulte
4272 @ref{Predicados de tipo predefinidos}. También se permiten los
4273 predicados de tipo definidos por el usuario.
4276 Referencia de la notación:
4277 @ref{Predicados de tipo predefinidos}.
4279 Expansión de LilyPond:
4280 @rextend{Sintaxis de las funciones musicales}.
4282 Archivos instalados:
4283 @file{lily/music-scheme.cc},
4285 @file{scm/lily.scm}.
4288 @node Ejemplos de funciones de sustitución
4289 @subsection Ejemplos de funciones de sustitución
4290 @translationof Substitution function examples
4292 Esta sección presenta algunos ejemplos de funciones de sustitución.
4293 No pretenden ser exhaustivas, sino demostrar algunas de las
4294 posibilidades de las funciones de sustitución sencillas.
4296 En el primer ejemplo se define una función que simplifica el ajuste
4297 del relleno de un elemento de inscripción de texto TextScript:
4299 @lilypond[quote,verbatim,ragged-right]
4301 #(define-music-function
4302 (parser location padding)
4305 \once \override TextScript #'padding = #padding
4309 c4^"piu mosso" b a b
4311 c4^"piu mosso" d e f
4313 c4^"piu mosso" fis a g
4317 Además de números, podemos usar expresiones musicales, como notas,
4318 para los argumentos de las funciones musicales:
4320 @lilypond[quote,verbatim,ragged-right]
4322 #(define-music-function
4323 (parser location note)
4326 \tweak NoteHead #'stencil #ly:text-interface::print
4327 \tweak NoteHead #'text
4328 \markup \musicglyph #"custodes.mensural.u0"
4329 \tweak Stem #'stencil ##f
4333 \relative c' { c4 d e f \custosNote g }
4336 Se pueden definir funciones de sustitución con más de un argumento:
4338 @lilypond[quote,verbatim,ragged-right]
4340 #(define-music-function
4341 (parser location padding tempotext)
4344 \once \override Score.MetronomeMark #'padding = #padding
4345 \tempo \markup { \bold #tempotext }
4349 \tempo \markup { "Low tempo" }
4351 \tempoPadded #4.0 "High tempo"
4356 @c TODO: add appropriate @@ref's here.