1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 4299c96f609f79426a181ffed107d17fa6e1fdbd
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
18 calidad de los resultados, de forma predeterminada. A pesar de
19 ello, podría tener que cambiar este resultado predeterminado. La
20 disposición sobre el papel se controla a través de un amplio
21 número de @q{botones e interruptores} llamados en su conjunto
22 @q{propiedades}. En el Manual de aprendizaje podemos encontrar
23 una introducción en forma de tutorial al acceso y modificación de
24 estas propiedades, véase @rlearning{Trucar la salida}. Éste
25 debería leerse en primer lugar. Este capítulo cubre un terreno
26 similar, pero con un estilo más adecuado para un manual de
29 @cindex Referencia de funcionamiento interno
31 La descripción definitiva de los controles que están disponibles
32 para su ajuste fino están en un documento aparte: la
33 @rinternalsnamed{Top,Referencia de funcionamiento interno}. Dicho
34 manual relaciona todas las variables, funciones y opciones que se
35 encuentran disponibles en LilyPond. Está escrito como un
36 documento HTML, que se puede encontrar
37 @c leave the @uref as one long line.
38 @uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/internals/,en@tie{}línea},
39 pero que también va incluido en el paquete de la documentación de
42 Internamente, LilyPond utiliza el lenguaje Scheme (un dialecto de
43 LISP) para aportar la infraestructura. La sobreescritura de las
44 decisiones de disposición da acceso efectivo a las interioridades
45 del programa, lo que requiere código de Scheme como entrada. Los
46 elementos de Scheme se inauguran dentro de un archivo @file{.ly}
48 cuadradillo@tie{}@code{#}.@footnote{@rextend{Tutorial de Scheme}
49 contiene un breve tutorial sobre la introducción de números,
50 listas, cadenas y símbolos en Scheme.}
53 * Contextos de interpretación::
54 * Explicación del Manual de referencia de funcionamiento interno::
55 * Modificar las propiedades::
56 * Conceptos y propiedades útiles::
58 * Uso de las funciones musicales::
62 @node Contextos de interpretación
63 @section Contextos de interpretación
64 @translationof Interpretation contexts
66 Esta sección explica qué son los contextos y cómo modificarlos.
69 * Explicación de los contextos::
70 * Crear y referenciar contextos::
71 * Mantener vivos los contextos::
72 * Modificar los complementos (plug-ins) de contexto::
73 * Cambiar los valores por omisión de los contextos::
74 * Definir contextos nuevos::
75 * Orden de disposición de los contextos::
79 Manual de aprendizaje:
80 @rlearning{Contextos y grabadores}.
83 @file{ly/engraver-init.ly},
84 @file{ly/performer-init.ly}.
87 @rlsr{Contexts and engravers}.
89 Referencia de funcionamiento interno:
90 @rinternals{Contexts},
91 @rinternals{Engravers and Performers}.
94 @node Explicación de los contextos
95 @subsection Explicación de los contextos
96 @translationof Contexts explained
98 Los contextos se disponen de forma jerárquica:
101 * Definiciones de salida - estructura de los contextos::
102 * Score. El contexto maestro::
103 * Contextos del nivel superior. Contenedores de pentagramas::
104 * Contextos de nivel intermedio. Pentagramas::
105 * Contextos del nivel más bajo. Voces::
108 @node Definiciones de salida - estructura de los contextos
109 @unnumberedsubsubsec Definiciones de salida - estructura de los contextos
110 @translationof Output definitions - blueprints for contexts
112 Esta sección explica la relevancia de las definiciones de salida
113 cuando se trabaja con los contextos. Más adelante ofrecemos
114 ejemplos de definiciones de salida reales (véase
115 @ref{Cambiar todos los contextos del mismo tipo}).
117 @cindex salida, definiciones de
119 Aunque la música escrita en un archivo haga referencia a tipos y
120 nombres de contexto, los contextos se crean solamente cuando la
121 música se está realmente interpretando. LilyPond interpreta la
122 música bajo el control de una @q{definición de salida} y puede
123 hacerlo así para varias definiciones de salida distintas, dando
124 como resultado distintas salidas también. La definicion de salida
125 que corresponde a la impresión de la música se especifica mediante
129 Una definición de salida mucho más sencilla que se usa para la
130 producción de MIDI se especifica mediante @code{\midi}.
131 Internamente, LilyPond utiliza varias otras definiciones de
132 salida, como cuando se usa el combinador de particellas
133 (@ref{Combinación automática de las partes}) o se crean fragmentos
134 de notas guía citadas (@ref{Citar otras voces}).
136 Las definiciones de salida establecen la relación entre los
137 contextos así como sus respectivos valores predeterminados.
138 Aunque la mayor parte de los cambios se suelen hacer dentro de un
139 bloque @code{\layout}, los ajustes de valores relacionados con el
140 MIDI solamente tienen efecto cuando se hacen dentro de un bloque
143 @funindex autoBeaming
144 Algunos ajustes afectan a varias salidas: por ejemplo, si se
145 desactiva el barrado automático, @code{autoBeaming}, dentro de
146 algún contexto, las barras cuentan como melismas en lo que
147 respecta a la correspondencia entre la música y la letra, como se
148 describe en @ref{Duración automática de las sílabas}. Esta
149 correspondencia se hace tanto para la salida impresa como para el
150 MIDI. Si los cambios hechos sobre el @code{autoBeaming} dentro de
151 la definición de contexto de un bloque @code{\layout} no se
152 repiten dentro del correspondiente bloque @code{\midi}, la letra y
153 la música dejarán de estar sincronizadas dentro del MIDI.
157 @file{ly/engraver-init.ly}.
158 @file{ly/performer-init.ly}.
160 @node Score. El contexto maestro
161 @unnumberedsubsubsec Score. El contexto maestro
162 @translationof Score - the master of all contexts
164 Este es el contexto de notación del nivel más alto. Ningún otro
165 contexto puede contener a un contexto Score. De forma
166 predeterminada, el contexto Score maneja la administración de las
167 indicaciones de compás y se asegura de que ciertos elementos como
168 claves, compases y armaduras están siempre alineados entre los
169 distintos pentagramas.
171 Se crea implícitamente una instancia del contexto Score cuando se
172 procesa un bloque @code{\score @{@dots{}@}}.
175 @node Contextos del nivel superior. Contenedores de pentagramas
176 @unnumberedsubsubsec Contextos del nivel superior: contenedores de pentagramas
177 @translationof Top-level contexts - staff containers
179 @strong{@emph{StaffGroup}}
181 Agrupa pentagramas y añade un corchete en la parte izquierda,
182 formando un grupo. Las líneas divisorias de los pentagramas
183 contenidos se conectan verticalmente. @code{StaffGroup} sólo
184 consiste en una colección de pentagramas, con un corchete delante
185 y líneas divisorias de arriba a abajo.
187 @strong{@emph{ChoirStaff}}
189 Idéntico a @code{StaffGroup} excepto que las barras de compás de
190 los pentagramas contenidos no se conectan verticalmente.
192 @strong{@emph{GrandStaff}}
194 Un grupo de pentagramas, con una llave en la parte izquierda que
195 abarca el grupo. Las barras de compás de los pentagramas
196 contenidos se conectan verticalmente.
198 @strong{@emph{PianoStaff}}
200 Igual que @code{GrandStaff}, pero contempla la posibilidad de
201 poner el nombre del instrumento a la izquierda del sistema.
204 @node Contextos de nivel intermedio. Pentagramas
205 @unnumberedsubsubsec Contextos de nivel intermedio. Pentagramas
206 @translationof Intermediate-level contexts - staves
208 @strong{@emph{Staff}}
210 Maneja claves, barras de compás, tonalidades y alteraciones
211 accidentales. Puede contener contextos de @code{Voice}.
213 @strong{@emph{RhythmicStaff}}
215 Como @code{Staff}, pero para imprimir ritmos. Al imprimir se
216 ignoran las alturas de las notas; las notas se imprimen sobre una
217 línea. La salida de MIDI conserva las alturas sin modificación.
219 @strong{@emph{TabStaff}}
221 Contexto para generar tablaturas. De forma predeterminada dispone la
222 expresión musical como una tablatura de guitarra, impresa sobre seis
225 @strong{@emph{DrumStaff}}
227 Maneja el tipografiado para instrumentos de percusión. Puede contener
228 contextos @code{DrumVoice}.
230 @strong{@emph{VaticanaStaff}}
232 Igual que @code{Staff}, excepto que está pensado para tipografiar
233 piezas en estilo gregoriano.
235 @strong{@emph{MensuralStaff}}
237 Igual que @code{Staff}, excepto que está diseñado para tipografiar
238 piezas en estilo mensural.
241 @node Contextos del nivel más bajo. Voces
242 @unnumberedsubsubsec Contextos del nivel más bajo. Voces
243 @translationof Bottom-level contexts - voices
245 Los contextos del mismo nivel que Voice dan un valor inicial a
246 ciertas propiedades e inician los grabadores correspondientes. Un
247 contexto del nivel más bajo es aquel que no tiene un contexto
248 descendiente predeterminado @code{defaultchild}. Aunque es
249 posible hacer que pueda aceptar o contener subcontextos, éstos
250 solo se pueden crear e introducir de forma explícita.
252 @strong{@emph{Voice}}
254 Corresponde a una voz sobre un pentagrama. este contexto maneja la
255 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
256 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
257 que crear instancias explícitas de este contexto si necesitamos varias
258 voces en el mismo pentagrama.
260 @strong{@emph{VaticanaVoice}}
262 Lo mismo que @code{Voice}, excepto que está diseñado para
263 tipografiar piezas en estilo gregoriano.
265 @strong{@emph{MensuralVoice}}
267 Lo mismo que @code{Voice}, con modificaciones para el tipografiado
268 de piezas en estilo mensural.
270 @strong{@emph{Lyrics}}
272 Corresponde a una voz con letra. Maneja la impresión de una sola
275 @strong{@emph{DrumVoice}}
277 El contexto de voz utilizado en una pauta de percusión.
279 @strong{@emph{FiguredBass}}
281 El contexto en que los objetos @code{BassFigure} se crean a partir
282 de la entrada escrita en el modo @code{\figuremode}.
284 @strong{@emph{TabVoice}}
286 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
287 Se suele dejar que se cree implícitamente.
289 @strong{@emph{CueVoice}}
291 El contexto de voz que se utiliza para dibujar notas de tamaño
292 reducido, con el principal objetivo de añadir notas guía de un
293 pentagrama a otro, véase @ref{Formateo de las notas guía}.
294 Normalmente se deja que se cree implícitamente.
296 @strong{@emph{ChordNames}}
298 Tipografía nombres de acordes.
301 @node Crear y referenciar contextos
302 @subsection Crear y referenciar contextos
303 @translationof Creating and referencing contexts
307 @cindex nuevos contextos
308 @cindex contextos, creación y referenciación de
309 @cindex referenciar contextos
311 LilyPond crea automáticamente contextos de nifel inferior si se
312 encuentra una expresión musical antes de que exista un contexto
313 adecuado, pero normalmente esto sólo funciona bien para partituras
314 sencillas o fragmentos musicales como los que aparecen en la
315 documentación. Para partituras más complejas, se recomienda
316 especificar explícitamente todos los contextos con las
317 instrucciones @code{\new} o @code{\context}. La sintaxis de estas
318 dos instrucciones es muy similar:
321 [\new | \context] @var{Contexto} [ = @var{nombre}] [@var{expresión_musical}]
325 donde se puede especificar @code{\new} o @code{\context}.
326 @var{Contexto} es el tipo de contexto que se desea crear,
327 @var{nombre} es un nombre opcional que se da al contexto concreto
328 que se está creando, y @var{expresión_musical} es una sola
329 expresión musical que será interpretada por los complementos
330 grabadores y reproductores dentro de este contexto.
332 El prefijo @code{\new} sin ningún nombre se usa con frecuencia
333 para crear partituras con muchos pentagramas:
335 @lilypond[quote,verbatim]
337 \new Staff \relative {
338 % leave the Voice context to be created implicitly
341 \new Staff \relative {
348 y para introducir varias voces dentro de un solo pentagrama:
350 @lilypond[quote,verbatim]
352 \new Voice \relative {
356 \new Voice \relative {
364 @code{\new} debería usarse siempre para especificar contextos sin
367 La diferencia entre @code{\new} y @code{\context} se encuentra en
368 la acción que se realiza:
372 @code{\new} con un nombre o sin él, siempre crea un contexto nuevo
373 y distinto, incluso si ya existe un contexto con el mismo nombre:
375 @lilypond[quote,verbatim]
377 \new Voice = "A" \relative {
381 \new Voice = "A" \relative {
389 @code{\context} con un nombre especificado, crea un contexto nuevo
390 solamente si no existe ya un contexto del mismo tipo y con el
391 mismo nombre, dentro de la misma jerarquía de contextos. En caso
392 contrario, se toma como referencia a dicho contexto creado
393 previamente, y su expresión musical se pasa a este contexto para
396 Una aplicación de los contextos con nombre es la separación entre
397 la disposición de la partitura y el contenido musical. Son
398 válidas culaquiera de las dos formas siguientes:
400 @lilypond[quote,verbatim]
414 \context Voice = "one" {
419 \context Voice = "two" {
428 @lilypond[quote,verbatim]
433 \context Voice = "one" {
436 \context Voice = "two" {
442 \context Voice = "one" {
447 \context Voice = "two" {
457 De manera alternativa, se pueden utilizar variables con un efecto
458 similar. Véase @rlearning{Organizar las piezas mediante variables}.
461 @code{\context} sin ningún nombre corresponderá con el primer
462 contexto que se encuentre entre los creados previamente que sean
463 del mismo tipo dentro de la misma jerarquía de contextos, incluso
464 si tiene nombre, y su expresión musical se pasará a dicho contexto
465 para su interpretación. Esta forma rara vez es útil. Sin
466 embargo, @code{\context} sin nombre y sin expresión musical se usa
467 para establecer el contexto en que se ejecuta un procedimiento de
468 Scheme especificado con @code{\applyContext}:
471 \new Staff \relative @{
474 \applyContext #(lambda (ctx)
476 (display (ly:context-current-moment ctx)))
483 Un contexto debe tener un nombre si se va a hacer referencia a él
484 más tarde, por ejemplo cuando se asocia la letra con la música:
487 \new Voice = "tenor" @var{música}
489 \new Lyrics \lyricsto "tenor" @var{letra}
493 Para ver más detalles sobre la asociación de letra y música,
494 consulte @ref{Duración automática de las sílabas}.
496 Las propiedades de todos los contextos de un tipo en particular se
497 pueden modificar dentro de un bloque @code{\layout} (con una
498 sintaxis diferente), véase
499 @ref{Cambiar todos los contextos del mismo tipo}.
501 Esta construcción también ofrece una forma de mantener las
502 instrucciones de disposición separadas del contenido musical. Si
503 se va a modificar un solo contexto, debe usarse un bloque
505 @ref{Cambiar solamente un contexto determinado}.
508 Manual de aprendizaje:
509 @rlearning{Organizar las piezas mediante variables}.
511 Referencia de la notación:
512 @ref{Cambiar solamente un contexto determinado},
513 @ref{Duración automática de las sílabas}.
516 @node Mantener vivos los contextos
517 @subsection Mantener vivos los contextos
518 @translationof Keeping contexts alive
520 @cindex contextos, mantener vivos
521 @cindex contextos, tiempo de vida
523 Normalmente los contextos finalizan en el primer momento musical en
524 que no tienen nada que hacer. Así, los contextos de @code{Voice}
525 mueren tan pronto como ya no contienen ningún evento; los contextos de
526 @code{Staff} mueren tan pronto como todos los contextos de
527 @code{Voice} que contenían ya no contengan ningún evento; etc. Esto
528 puede ocasionar dificultades si se tiene que hacer referencia a
529 contextos anteriores que ya han muerto, por ejemplo, al cambiar de
530 pentagramas con instrucciones @code{\change}, asociar letra con una
531 voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
532 eventos musicales adicionales a un contexto anterior.
534 Existe una excepción a esta regla general: dentro de una
535 construcción @code{@{@dots{}@}} (música secuencial), la noción que
536 la construcción tiene del @qq{contexto actual} descenderá un nivel
537 cada vez que un elemento de la secuencia finaliza en un
538 subcontexto del contexto anterior. Esto evita la creación espúrea
539 de contextos implícitos en ciertas situaciones, pero significa que
540 el primer contexto dentro del que se desciende, se va a mantener
541 vivo hasta el final de la expresión.
543 Como contraste, los contextos de una expresión hecha con la
544 construcción @code{<<@dots{}>>} (música simultánea) no se
545 prolongan, por lo que si una instrucción que crea un contexto se
546 encierra en otro par de @code{<<@dots{}>>}, se impedirá que el
547 contexto persista durante toda la duración de la secuencia
548 @code{@{@dots{}@}} que lo contiene.
550 Cualquier contexto se puede mantener vivo si nos aseguramos de que
551 tiene algo que hacer en cualquier momento musical dado. Los
552 contextos de @code{Staff} se mantienen con vida si nos aseguramos
553 de que una de sus voces se mantiene viva. Una manera de hacerlo
554 es añadir silencios de separación a una voz en paralelo con la
555 música real. Éstos deben añadirse a todos y cada uno de los
556 contextos de @code{Voice} que se hayan de mantener vivos. Si se
557 van a usar esporádicamente varias voces, es más seguro mantenerlas
558 todas vivas en lugar de tratar de confiar en las excepciones que
559 hemos mencionado arriba.
561 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
562 vivas de esta manera durante la duración de la pieza:
564 @lilypond[quote,verbatim]
565 musicA = \relative { d''4 d d d }
566 musicB = \relative { g'4 g g g }
569 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
570 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
575 \context Voice = "A" {
579 \context Voice = "B" {
583 \context Voice = "A" { \musicA }
584 \context Voice = "B" { \musicB }
585 \context Voice = "A" { \musicA }
596 @cindex letra, alineación con melodía esporádica
598 El ejemplo siguiente muestra cómo se puede escribir una línea
599 melódica esporádica con letra utilizando este enfoque. Por
600 supuesto, en una situación real la melodía y el acompañamiento
601 consistirían en varias secciones diferentes.
603 @lilypond[quote,verbatim]
604 melody = \relative { a'4 a a a }
605 accompaniment = \relative { d'4 d d d }
606 words = \lyricmode { These words fol -- low the mel -- o -- dy }
609 \new Staff = "music" {
611 \new Voice = "melody" {
613 s1*4 % Keep Voice "melody" alive for 4 bars
616 \new Voice = "accompaniment" {
621 \context Voice = "melody" { \melody }
622 \context Voice = "accompaniment" { \accompaniment }
624 \context Voice = "accompaniment" { \accompaniment }
626 \context Voice = "melody" { \melody }
627 \context Voice = "accompaniment" { \accompaniment }
632 \new Lyrics \with { alignAboveContext = #"music" }
633 \lyricsto "melody" { \words }
638 Una forma alternativa, que podría resultar mejor en muchas
639 situaciones, es mantener con vida la línea melódica simplemente
640 incluyendo notas espaciadoras para alinearla correctamente con el
643 @lilypond[quote,verbatim]
650 accompaniment = \relative {
656 words = \lyricmode { These words fol -- low the mel -- o -- dy }
660 \new Staff = "music" {
662 \new Voice = "melody" {
666 \new Voice = "accompaniment" {
672 \new Lyrics \with { alignAboveContext = #"music" }
673 \lyricsto "melody" { \words }
679 @node Modificar los complementos (plug-ins) de contexto
680 @subsection Modificar los complementos (plug-ins) de contexto
681 @translationof Modifying context plug-ins
683 @c TODO Should this be Modifying engravers or Modifying contexts?
685 Los contextos de notación (como @code{Score} y @code{Staff}) no
686 sólo almacenan propiedades, también contienen «plug-ins» o
687 complementos llamados @q{grabadores} que crean elementos de
688 notación. Por ejemplo, el contexto @code{Voice} contiene un
689 grabador @code{Note_heads_engraver} que crea las cabezas de nota y
690 el contexto @code{Staff} contiene un grabador @code{Key_engraver}
691 que crea la armadura.
693 Para ver una descripción completa de todos y cada uno de los
694 complementos, consulte
696 @rinternals{Engravers and Performers}.
699 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
701 Cada contexto que se describe en
703 @rinternals{Contexts}
706 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
708 relaciona los grabadores que se usan para ese contexto.
711 Puede ser de utilidad jugar un poco con estos complementos. Se
712 hace iniciando un contexto nuevo con @code{\new} o @code{\context}
718 \new @var{contexto} \with @{
726 @emph{@dots{}música@dots{}}
731 donde los @dots{} deben ser el nombre de un grabador. Aquí
732 tenemos un ejemplo sencillo que suprime los grabadores
733 @code{Time_signature_engraver} y @code{Clef_engraver} de un
734 contexto @code{Staff}:
736 @lilypond[quote,verbatim]
738 \new Staff \relative {
742 \remove "Time_signature_engraver"
743 \remove "Clef_engraver"
750 En el segundo pentagrama no hay indicación de compás ni clave.
751 Éste es un método bastante rudimentario de hacer que desaparezcan
752 los objetos porque afecta a todo el pentagrama. Este método
753 también afecta al espaciado, lo que puede ser deseable o no serlo.
754 Se muestran métodos más sofisticados para quitar objetos en
755 @rlearning{Visibilidad y color de los objetos}.
757 El ejemplo siguiente muestra una aplicación práctica. Normalmente
758 las líneas divisorias y las indicaciones de compás están
759 sincronizadas a lo largo de toda la partitura. Lo hacen los
760 grabadores @code{Timing_translator} y
761 @code{Default_bar_line_engraver}. Estos complementos mantienen al
762 día la administración de las indicaciones de compás, posición
763 dentro del compás, etc. Moviendo estos grabadores desde el
764 contexto de @code{Score} al de @code{Staff}, podemos conseguir una
765 partitura en la que cada pentagrama tiene su propio compás
768 @cindex polimétricas, partituras
769 @cindex compases distintos al mismo tiempo
771 @lilypond[quote,verbatim]
775 \consists "Timing_translator"
776 \consists "Default_bar_line_engraver"
783 \consists "Timing_translator"
784 \consists "Default_bar_line_engraver"
794 \remove "Timing_translator"
795 \remove "Default_bar_line_engraver"
803 El orden en que los grabadores se especifican es el orden en que
804 se llaman para realizar su tarea de procesamiento. Normalmente,
805 el orden en que se especifican los grabadores no tiene
806 importancia, pero en algunos casos especiales sí la tiene, por
807 ejemplo donde un grabador escribe una propiedad y otro la lee, o
808 donde un grabador crea un groby otro debe procesarlo.
810 Las siguientes ordenaciones son importantes:
814 el grabador de compases @code{Bar_engraver} debe ir normalmente en
818 el grabador de digitaciones @code{New_fingering_engraver} debe ir
819 antes del grabador @code{Script_column_engraver} de columnas de
823 el @code{Timing_translator} debe ir antes del grabador de números
824 de compás @code{Bar_number_engraver}.
830 @file{ly/engraver-init.ly}.
833 @node Cambiar los valores por omisión de los contextos
834 @subsection Cambiar los valores por omisión de los contextos
835 @translationof Changing context default settings
837 @cindex predeterminadas, cambio de propiedades de contexto
838 @cindex contexto, cambiar propiedades predeterminadas de
840 Se pueden cambiar las propiedades de contexto y de grob con las
841 instrucciones @code{\set} y @code{\override}, tal y como se
842 describe en @ref{Modificar las propiedades}. Estas instrucciones
843 crean eventos musicales, haciendo que los cambios tengan efecto en
844 el punto temporal en que la música se está procesando.
846 Por contra, esta sección explica la forma de cambiarlos valores
847 @emph{predeterminados} de las propiedades de contexto y de grob en
848 el momento en que se crea el contexto. Existen dos formas de
849 hacerlo. Una modifica los valores predeterminados en todos los
850 contextos de un tipo dado, y el otro modifica los valores
851 predeterminados solamente en una instancia concreta de un
855 * Cambiar todos los contextos del mismo tipo::
856 * Cambiar solamente un contexto determinado::
857 * Orden de precedencia::
860 @node Cambiar todos los contextos del mismo tipo
861 @unnumberedsubsubsec Cambiar todos los contextos del mismo tipo
862 @translationof Changing all contexts of the same type
864 @cindex \context dentro de un bloque \layout
868 Los ajustes de contexto predeterminados que se han de usar para la
869 composición tipográfica dentro de @code{Score}, @code{Staff},
870 @code{Voice} y otros contextos se pueden especificar en un bloque
871 @code{\context} dentro de cualquier bloque @code{\layout}.
873 Los ajustes para la salida MIDI, al contrario que para la
874 composición tipográfica, se tendrán que especificar aparte en
875 bloques @code{\midi} (véase
876 @ref{Definiciones de salida - estructura de los contextos}).
878 El bloque @code{\layout} se debe colocar dentro del bloque
879 @code{\score} al que se aplica, después de la música.
885 [ajustes de contexto para todos los contextos Voice]
889 [ajustes de contexto para todos los contextos Staff]
894 Se pueden especificar los siguientes tipos de ajustes:
898 Una instrucción @code{\override}, pero omitiendo el nombre del
901 @lilypond[quote,verbatim]
904 a'4^"Thicker stems" a a a
910 \override Stem.thickness = #4.0
917 Estableciendo una propiedad de contexto directamente
919 @lilypond[quote,verbatim]
922 a'4^"Smaller font" a a a
935 Una instrucción predefinida tal como @code{\dynamicUp} o una
936 expresión musical como @code{\accidentalStyle dodecaphonic}
938 @lilypond[quote,verbatim]
941 a'4^"Dynamics above" a a a
951 \accidentalStyle dodecaphonic
958 Una variable definida por el usuario que contenga un bloque
959 @code{\with}; para ver detalles acerca del bloque @code{\with},
960 consulte @ref{Cambiar solamente un contexto determinado}.
962 @lilypond[quote,verbatim]
963 StaffDefaults = \with {
970 a'4^"Smaller font" a a a
985 Las instrucciones de ajuste de propiedades se pueden disponer
986 dentro de un bloque @code{\layout} sin que estén encerradas en un
987 bloque @code{\context}. Tales ajustes son equivalentes a incluir
988 las mismas instrucciones de ajuste de propiedades al comienzo de
989 cada uno de los contextos del tipo especificado. Si no se
990 especifica ningún contexto, @emph{todos y cada uno} de los
991 contextos del nivel inferior quedan afectados, véase
992 @ref{Contextos del nivel más bajo. Voces}. La sintaxis de una
993 instrucción de ajuste de propiedades dentro de un bloque
994 @code{\layout} es la misma que si la misma instrucción estuviera
995 escrita en el propio flujo musical.
997 @lilypond[quote,verbatim]
1001 a'4^"Smaller font" a a a
1006 \accidentalStyle dodecaphonic
1008 \override Voice.Stem.thickness = #4.0
1014 @node Cambiar solamente un contexto determinado
1015 @unnumberedsubsubsec Cambiar solamente un contexto determinado
1016 @translationof Changing just one specific context
1021 Las propiedades de contexto de una única instancia de contexto
1022 pueden cambiarse dentro de un bloque @code{\with}. Todas las
1023 demás instancias de contexto del mismo tipo retienen los ajustes
1024 predeterminados que LilyPond tiene programados y que se modifican
1025 por parte de cualquier bloque @code{\layout} que se encuentre
1026 dentro del ámbito. El bloque @code{\with} se debe situar
1027 inmediatamente después de las instrucciones @code{\new}
1031 \new Staff \with @{ [ajustes de contexto para esta instancia de contexto solamente] @}
1037 Dado que dicha @q{modificación de contexto} está especificada
1038 dentro de la música, afectará a @emph{todas} las salidas
1039 (tipografía @emph{y también} el MIDI), a diferencia de los cambios
1040 que se hacen dentro de una definición de salida.
1042 Se pueden especificar los siguientes tipos de ajustes:
1046 Una instrucción @code{\override}, pero omitiendo el nombre del
1049 @lilypond[quote,verbatim]
1052 \new Voice \with { \override Stem.thickness = #4.0 }
1055 a'4^"Thick stems" a a a
1064 Estableciendo una propiedad de contexto directamente
1066 @lilypond[quote,verbatim]
1071 a'4^"Default font" a a a
1075 \new Staff \with { fontSize = #-4 }
1078 a'4^"Smaller font" a a a
1087 Una instrucción predefinida tal como @code{\dynamicUp}
1089 @lilypond[quote,verbatim]
1095 a'4^"Dynamics below" a a a
1100 \new Staff \with { \accidentalStyle dodecaphonic }
1102 \new Voice \with { \dynamicUp }
1105 a'4^"Dynamics above" a a a
1116 @node Orden de precedencia
1117 @unnumberedsubsubsec Orden de precedencia
1118 @translationof Order of precedence
1120 El valor de una propiedad que se aplica en un momento determinado
1121 se determina de la siguiente forma:
1125 si está en efecto una instrucción @code{\override} o @code{\set}
1126 dentro del flujo musical, se usa dicho valor,
1129 de lo contrario, se usa el valor predeterminado tomado de un
1130 enunciado @code{\with} en las instrucciones de inicio del
1134 de lo contrario, se usa el valor tomado del bloque @code{\context}
1135 más reciente que corresponda dentro de los bloques @code{\layout}
1139 de lo contrario se usa el valor predeterminado que LilyPond lleva
1144 Manual de aprendizaje:
1145 @rlearning{Modificar las propiedades de los contextos}.
1147 Referencia de la notación:
1148 @ref{Explicación de los contextos},
1149 @ref{Contextos del nivel más bajo. Voces},
1150 @ref{La instrucción set},
1151 @ref{La instrucción override},
1152 @ref{El bloque layout,,El bloque @code{@bs{}layout}}.
1155 @node Definir contextos nuevos
1156 @subsection Definir contextos nuevos
1157 @translationof Defining new contexts
1159 @cindex contextos, definición de nuevos
1160 @cindex grabadores, incluir en contextos
1169 Los contextos específicos, como @code{Staff} y @code{Voice}, están
1170 construidos a partir de bloques sencillos. Es posible crear
1171 nuevos tipos de contextos con combinaciones distintas de añadidos
1174 El siguiente ejemplo muestra cómo construir un tipo diferente de
1175 contexto de @code{Voice} partiendo de cero. Será parecido a
1176 @code{Voice}, pero imprime solamente cabezas centradas en forma de
1177 barra inclinada. Se puede usar para indicar improvisación en
1180 @lilypond[quote,ragged-right]
1181 \layout { \context {
1183 \type "Engraver_group"
1184 \consists "Note_heads_engraver"
1185 \consists "Rhythmic_column_engraver"
1186 \consists "Text_engraver"
1187 \consists "Pitch_squash_engraver"
1188 squashedPosition = #0
1189 \override NoteHead.style = #'slash
1194 \accepts "ImproVoice"
1198 a'4 d8 bes8 \new ImproVoice { c4^"ad lib" c
1199 c4 c^"undress" c_"while playing :)" c }
1205 Estos ajustes se definen dentro de un bloque @code{\context} que a
1206 su vez está dentro de un bloque @code{\layout},
1216 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
1217 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
1219 En primer lugar es necesario definir un nombre para el nuevo
1226 Debido a que es parecido al contexto @code{Voice}, queremos
1227 órdenes que funcionen dentro de los contextos @code{Voice}
1228 (existentes) para que siga funcionando. Esto se consigue dando al
1229 contexto nuevo un alias de @code{Voice},
1235 El contexto imprimirá notas y textos explicativos, por ello
1236 tenemos que añadir los grabadores que aportan esta funcionalidad,
1237 y además el grabador que agrupa las notas, plicas y silencios que
1238 están en el mismo momento musical en forma de columnas,
1241 \consists "Note_heads_engraver"
1242 \consists "Text_engraver"
1243 \consists "Rhythmic_column_engraver"
1246 Las cabezas de todas las notas se deben situar sobre la línea
1250 \consists "Pitch_squash_engraver"
1251 squashedPosition = #0
1254 El grabador @code{Pitch_squash_engraver} modifica las cabezas de
1255 nota (creadas por el grabador @code{Note_heads_engraver}) y
1256 establece sus posiciones verticales al valor de
1257 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea
1260 Las notas parecen barras inclinadas y no tienen plica:
1263 \override NoteHead.style = #'slash
1267 Todos estos complementos o plug-ins tienen que comunicarse bajo el
1268 control del contexto. Los mecanismos con el que se comunican los
1269 contextos se establecen mediante la declaración del @code{\type}
1270 (tipo) del contexto. Dentro de un bloque @code{\layout}, casi
1271 todos los contextos serán del tipo @code{Engraver_group}. Algunos
1272 contextos especiales y los contextos de los bloques @code{\midi}
1273 usan otros tipos. La copia y la modificación de una definición de
1274 contexto existente también cumplimentan el tipo. Como este
1275 ejemplo crea una definición partiendo de cero, tiene que ser
1276 especificada explícitamente.
1279 \type "Engraver_group"
1282 Al juntarlo todo, obtenemos
1287 \type "Engraver_group"
1288 \consists "Note_heads_engraver"
1289 \consists "Text_engraver"
1290 \consists "Rhythmic_column_engraver"
1291 \consists "Pitch_squash_engraver"
1292 squashedPosition = #0
1293 \override NoteHead.style = #'slash
1300 Los contextos dan lugar a jerarquías. Queremos poner el contexto
1301 @code{ImproVoice} dentro del contexto @code{Staff}, igual que los
1302 contextos de voz normales. Por tanto, modificamos la definición
1303 de @code{Staff} con la instrucción @code{\accepts} (acepta),
1312 @funindex \inherit-acceptability
1313 Con frecuencia, al reutilizar una definición de contexto
1314 existente, el contexto resultante se puede usar en cualquier lugar
1315 donde el contexto original hubiera podido hacerlo.
1320 \inherit-acceptability @var{to} @var{from}
1325 consigue que tengamos contextos del tipo @var{to} aceptados por
1326 todos los contextos que asimismo aceptan @var{from}. Por ejemplo,
1332 \inherit-acceptability "ImproVoice" "Voice"
1337 añade un @code{\accepts} para @code{ImproVoice} tanto a la
1338 definición de @code{Staff} como a la de @code{RhythmicStaff}.
1341 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega),
1342 lo que a veces se necesita cuando se están reutilizando
1343 definiciones de contexto existentes.
1345 Organizar las piezas requeridas dentro de un bloque @code{\layout}
1354 \inherit-acceptability "ImproVoice" "Voice"
1358 Así pues, la salida que aparece al comienzo de esta sub-sección se
1367 c c_"mientras tocas :)"
1373 Para completar el ejemplo, los cambios que afectan a la jerarquía
1374 de contextos se deben repetir dentro de un bloque @code{\midi} de
1375 manera que la salida MIDI dependa de las mismas relaciones de
1380 Referencia de funcionamiento interno:
1381 @rinternals{Note_heads_engraver},
1382 @rinternals{Text_engraver},
1383 @rinternals{Rhythmic_column_engraver},
1384 @rinternals{Pitch_squash_engraver}.
1387 @node Orden de disposición de los contextos
1388 @subsection Orden de disposición de los contextos
1389 @translationof Context layout order
1391 @cindex contextos, orden de disposición
1395 Los contextos se disponen en un sistema normalmente desde arriba
1396 hacia abajo en el orden en que se encuentran en el archivo de
1397 entrada. Cuando los contextos se anidan unos dentro de otros, el
1398 contexto exterior incluye a los contextos anidados tal y como se
1399 especifica en el archivo de entrada, siempre y cuando los
1400 contextos interiores estén incluidos en la lista @qq{accepts} del
1401 contexto externo. Los contextos anidados que no está nincluidos
1402 en la lista @qq{accepts} del contexto externo se recolocan debajo
1403 del contexto externo en lugar de anidarse dentro de él.
1405 La lista @qq{accepts} de un contexto se puede cambiar con las
1406 instrucciones @code{\accepts} (acepta) o @code{\denies} (niega).
1407 @code{\accepts} añade un contexto a la lista @qq{accepts} y
1408 @code{\denies} elimina un contexto de la lista.
1410 Por ejemplo, un grupo de pentagramas con un corchete cuadrado no
1411 se encuentra normalmente en el interior de un pentagrama con llave
1412 curva que tenga conectadas las líneas divisorias, y un
1413 @code{GrandStaff} para piano no acepta un @code{StaffGroup} dentro
1414 de él, de forma predeterminada.
1416 @lilypond[verbatim,quote]
1423 \new Staff { \set Staff.instrumentName = bottom f'1 }
1428 Sin embargo, usando la instrucción @code{\accepts}, se puede
1429 añadir un @code{StaffGroup} al contexto @code{GrandStaff}:
1431 @lilypond[verbatim,quote]
1438 \new Staff { \set Staff.instrumentName = bottom f'1 }
1443 \accepts "StaffGroup"
1449 @code{\denies} se usa principalmente cuando un contexto nuevo se
1450 está basando en otro, pero los anidamientos requeridos difieren.
1451 Por ejemplo, el contexto @code{VaticanaStaff} está basado en el
1452 contexto @code{Staff}, pero con el contexto @code{VaticanaVoice}
1453 sustituido por el contexto @code{Voice} en la lista @qq{accepts}.
1456 @cindex contextos implícitos
1457 @cindex implícitos, contextos
1458 @funindex \defaultchild
1460 Observe que discretamente se crea un contexto de forma implícita
1461 si se encuentra una instrucción donde no hay un contexto apropiado
1464 Dentro de una definición de contexto, el tipo de un subcontexto
1465 que se va a crear implícitamente se especifica usando
1466 @code{\defaultchild} (hijo predeterminado). Algunos eventos
1467 musicales requieren un contexto @samp{Bottom} (inferior): cuando
1468 se encuentra este evento, se crean subcontextos de forma recursiva
1469 hasta que se alcanza un contexto que no tiene establecido el
1470 @samp{defaultchild}.
1472 La creación implícita de contextos puede dar lugar a pentagramas o
1473 partituras nuevos no esperados. La utilización de @code{\new}
1474 para crear contextos explícitamente evita esos problemas.
1476 @cindex alignAboveContext
1477 @cindex alignBelowContext
1478 @funindex alignAboveContext
1479 @funindex alignBelowContext
1481 En ocasiones se necesita que un contexto exista durante un breve
1482 intervalo de tiempo, siendo un buen ejemplo el contexto de
1483 pentagrama de un ossia. Esto se consigue normalmente mediante la
1484 introducción de la definición del contexto en el lugar apropiado
1485 en paralelo con la sección correspondiente de la música principal.
1486 De forma predeterminada, el contexto tempral se coloca debajo de
1487 todos los contextos existentes. Para reposicionarlo por encima
1488 del contexto que tenga el nombre @qq{principal}, debería definirse
1492 \new Staff \with @{ alignAboveContext = #"principal" @}
1495 Se presenta una situación similar cuando se posiciona un contexto
1496 temporal de letra de una canción dentro de una disposición de varios
1497 pentagramas tal como @code{ChoirStaff}, por ejemplo, cuando se añade
1498 una segunda estrofa a una sección que se repite. De forma
1499 predeterminada, el contexto temporal de letra se coloca debajo de los
1500 pentagramas inferiores. Mediante la definición del contexto temporal
1501 de letra con @code{alignBelowContext} se puede posicionar
1502 correctamente debajo del contexto de letra con nombre que contiene el
1503 texto de la primera estrofa.
1505 En diversos lugares pueden verse ejemplos que muestran esta
1506 recolocación de contextos temporales: véase
1507 @rlearning{Anidado de expresiones musicales},
1508 @ref{Modificación de pentagramas sueltos} y
1509 @ref{Técnicas específicas para la letra}.
1512 Manual de aprendizaje:
1513 @rlearning{Anidado de expresiones musicales}.
1515 Referencia de la notación:
1516 @ref{Modificación de pentagramas sueltos},
1517 @ref{Técnicas específicas para la letra}.
1519 Manual de utilización del programa:
1520 @rprogram{Aparece un pentagrama de más}.
1522 Archivos instalados:
1523 @file{ly/engraver-init.ly}.
1526 @node Explicación del Manual de referencia de funcionamiento interno
1527 @section Explicación del Manual de referencia de funcionamiento interno
1528 @translationof Explaining the Internals Reference
1531 * Navegar por la referencia del programa::
1532 * Interfaces de la presentación::
1533 * Determinar la propiedad del grob::
1534 * Convenciones de nombres::
1538 @node Navegar por la referencia del programa
1539 @subsection Navegar por la referencia del programa
1540 @translationof Navigating the program reference
1542 Supongamos que queremos mover la indicación de digitación del
1543 fragmento siguiente:
1545 @lilypond[quote,fragment,verbatim]
1549 Si hace una visita a la documentación en busca de instrucciones de
1550 digitación (en @ref{Indicaciones de digitación}), encontrará:
1553 @strong{Véase también}
1555 Referencia de funcionamiento interno: @rinternals{Fingering}.
1560 La referencia del programador se encuentra disponible en forma de
1561 documento HTML. Se recomienda mucho que lo lea en la forma HTML,
1562 bien en línea o bien descargando los archivos de la documentación
1563 HTML. Esta sección sería mucho más difícil de entender si está
1564 utilizando el manual en formato PDF.
1567 Siga el enlace que lleva a @rinternals{Fingering}. Al principio
1568 de la página, puede ver
1571 Los objetos de digitación se crean por parte de:
1572 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1575 Siguiendo los enlaces relacionados dentro de la referencia del
1576 programa, podemos seguir el flujo de información dentro del
1581 @item @rinternals{Fingering}:
1582 los objetos @rinternals{Fingering} se crean por parte de:
1583 @rinternals{Fingering_engraver}
1585 @item @rinternals{Fingering_engraver}:
1586 Tipos de música aceptados: @rinternals{fingering-event}
1588 @item @rinternals{fingering-event}:
1589 El tipo de evento musical @code{fingering-event} está descrito en
1590 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1593 Este camino se recorre en contra de la corriente de información
1594 del programa: comienza por la salida y acaba en el evento de
1595 entrada. También podríamos haber empezado por un evento de la
1596 entrada, y leído siguiendo el flujo de información terminando en
1597 su caso en el objeto (u objetos) de la salida.
1599 La referencia del programa también se puede examinar como un
1600 documento normal. Contiene capítulos que tratan de
1602 @rinternals{Music definitions},
1605 @code{Music definitions}
1607 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada
1608 uno de los capítulos relaciona todas las definiciones utilizadas y
1609 todas las propiedades que se pueden ajustar.
1612 @node Interfaces de la presentación
1613 @subsection Interfaces de la presentación
1614 @translationof Layout interfaces
1616 @cindex interfaz de la presentación
1617 @cindex presentación, interfaz de la
1620 La página HTML que pudimos ver en la sección anterior describe el
1621 objeto de presentación llamado @rinternals{Fingering}. Dicho
1622 objeto es un símbolo dentro de la partitura. Tiene propiedades
1623 que guardan números (como grosores y direcciones), pero también
1624 punteros a objetos relacionados. Un objeto de presentación
1625 también se llama un @emph{Grob}, que es una abreviatura de
1626 Graphical Object (objeto gráfico). Para ver más detalles acerca
1627 de los objetos gráficos o Grobs, consulte
1628 @rinternals{grob-interface}.
1630 La página dedicada a @code{Fingering} relaciona las definiciones del
1631 objeto @code{Fingering}. Por ejemplo, la página dice
1634 @code{padding} (dimensión, en espacios de pentagrama):
1640 lo que significa que el número se mantendrá a una distancia de al
1641 menos 0.5 de la cabeza de la nota.
1644 Cada objeto de presentación puede tener varias funciones como
1645 elemento notacional o tipográfico. Por ejemplo, el objeto de
1646 digitación Fingering tiene los siguientes aspectos
1650 Su tamaño es independiente del espaciado horizontal, al contrario
1651 de las ligaduras o las barras de las figuras.
1654 Es un elemento de texto. Casi seguro que es un texto muy corto.
1657 este elemento de texto se tipografía con un tipo de letra, no como
1658 las ligaduras o las barras de las figuras.
1661 Horizontalmente, el centro del símbolo se debe alinear con el
1662 centro de la cabeza de la nota.
1665 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1668 La posición vertical también está coordinada con otros símbolos de
1669 superíndice y de subíndice.
1672 Cada uno de estos aspectos se capta en lo que se llaman
1673 @emph{interface}s, que se relacionan al final de la página dedicada a
1674 @rinternals{Fingering}
1677 Este objeto contempla los siguientes interfaces:
1678 @rinternals{item-interface},
1679 @rinternals{self-alignment-interface},
1680 @rinternals{side-position-interface}, @rinternals{text-interface},
1681 @rinternals{text-script-interface}, @rinternals{font-interface},
1682 @rinternals{finger-interface} y @rinternals{grob-interface}.
1685 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1686 página del respectivo interfaz del objeto. Cada interfaz tiene un
1687 cierto número de propiedades. Algunas de ellas no son para que el
1688 usuario las pueda ajustar (@q{Propiedades internas}), pero otras
1689 sí se pueden modificar.
1691 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1692 realmente esto no significa mucho. El archivo de inicialización
1693 (véase @rlearning{Otras fuentes de información})
1694 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1699 (avoid-slur . around)
1700 (slur-padding . 0.2)
1701 (staff-padding . 0.5)
1702 (self-alignment-X . 0)
1703 (self-alignment-Y . 0)
1704 (script-priority . 100)
1705 (stencil . ,ly:text-interface::print)
1706 (direction . ,ly:script-interface::calc-direction)
1707 (font-encoding . fetaText)
1708 (font-size . -5) ; don't overlap when next to heads.
1709 (meta . ((class . Item)
1710 (interfaces . (finger-interface
1712 text-script-interface
1714 side-position-interface
1715 self-alignment-interface
1716 item-interface))))))
1720 Como podemos ver, el objeto @code{Fingering} no es más que un
1721 montón de valores de variables, y la página web de la Referencia
1722 de funcionamiento interno se genera directamente a partir de esta
1726 @node Determinar la propiedad del grob
1727 @subsection Determinar la propiedad del grob
1728 @translationof Determining the grob property
1730 Recordemos que queríamos cambiar la posición del @b{2} en
1732 @lilypond[quote,fragment,verbatim]
1736 Puesto que el @b{2} se encuentra colocado verticalmente sobre su
1737 nota, tenemos que negociar con el interfaz asociado con esta
1738 colocación. Esto se hace usando @code{side-position-interface}.
1739 La página que describe este interface dice:
1742 @code{side-position-interface}
1744 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1745 soporte). La propiedad @code{direction} significa dónde poner el
1746 objeto víctima con relación al soporte (¿a la izquierda o a la
1747 derecha, encima o debajo?)
1751 @cindex padding (relleno)
1753 Debajo de esta descripción, la variable @code{padding} (relleno)
1759 (dimensión, en espacios de pentagrama)
1761 Añadir esta cantidad de espacio adicional entre objetos que están
1766 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1767 digitación de la cabeza de la nota. La siguiente orden inserta un
1768 espacio en blanco de tres @qq{espacios de pentagrama} entre la
1769 nota y la digitación:
1772 \once \override Voice.Fingering.padding = #3
1775 Al insertar este relleno antes de que se haya creado el objeto de
1776 digitación, llegamos al siguiente resultado:
1778 @lilypond[quote,fragment,verbatim]
1779 \once \override Voice.Fingering.padding = #3
1783 En este caso, el contexto de este truco es @code{Voice}. Véase el
1784 apartado dedicado al añadido @rinternals{Fingering_engraver}, que
1788 El grabador Fingering_engraver forma parte de los contextos:
1789 @dots{} @rinternals{Voice}
1793 @node Convenciones de nombres
1794 @subsection Convenciones de nombres
1795 @translationof Naming conventions
1797 Se hace necesario presentar una panorámica de las diversas
1798 convenciones de nomenclatura:
1801 @item funciones de Scheme: minúsculas-con-guiones (lo que incluye a los nombres de una sola palabra)
1803 @item funciones de Scheme específicas de LilyPond: ly:más-estilo-de-scheme
1805 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1807 @item interfaces de Grobs: estilo-scheme
1809 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1811 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1813 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1815 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1819 Preguntas aún sin respuesta
1821 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1823 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1828 @node Modificar las propiedades
1829 @section Modificar las propiedades
1830 @translationof Modifying properties
1833 * Panorámica de la modificación de las propiedades::
1834 * La instrucción set::
1835 * La instrucción override::
1836 * La instrucción tweak::
1837 * set frente a override::
1838 * Modificación de las listas-A::
1842 @node Panorámica de la modificación de las propiedades
1843 @subsection Panorámica de la modificación de las propiedades
1844 @translationof Overview of modifying properties
1846 Cada contexto es responsable de la creación de ciertos tipos de
1847 objetos gráficos. Los ajustes que se usan para imprimir estos
1848 objetos también se almacenan por contexto. Mediante la
1849 modificación de estos ajustes, se puede alterar la apariencia de
1852 Existen dos tipos diferentes de propiedades almacenadas en los
1853 contextos: las propiedades de contexto y las propiedades de grob.
1854 Las propiedades de contexto son propiedades que se aplican al
1855 contexto como un todo y controlan la forma en que el propio
1856 contexto se imprime. Por contra, las propiedades de grob se
1857 aplican a los tipos de grob específicos que se imprimirán dentro
1860 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar
1861 los valores de las propiedades de contexto. Las instrucciones
1862 @code{\override} y @code{\revert} se usan para cambiar los valores
1863 de las propiedades de grob.
1866 La sintaxis de esto es
1869 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1872 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1873 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1874 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1875 disposición}). Este último es un símbolo, y por ello debe ir
1876 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1877 explica cómo se deben cumplimentar los conceptos @var{nombre},
1878 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1879 funcionalidad des esta instrucción.
1884 \override Staff.Stem.thickness = #4.0
1888 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1889 grosor de una línea del pentagrama como unidad). Puesto que la
1890 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1891 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1892 Aquí vemos la instrucción en pleno funcionamiento:
1894 @lilypond[quote,fragment,verbatim]
1896 \override Staff.Stem.thickness = #4.0
1902 La instrucción @code{\override} modifica la definición de la plica
1903 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1904 que la instrucción se ha interpretado, todas las plicas se engrosan.
1906 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1907 omitir, ocasionando que se utilice el contexto predeterminado
1908 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1909 solo paso de tiempo.
1911 @lilypond[quote,fragment,verbatim]
1913 \once \override Stem.thickness = #4.0
1918 El @code{\override} se debe hacer antes de que el objeto se inicia.
1919 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1920 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1921 en el momento en que se crea el objeto. En este ejemplo:
1923 @lilypond[quote,fragment,verbatim]
1924 \override Slur.thickness = #3.0
1926 \override Beam.beam-thickness = #0.6
1931 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1932 la instrucción para @code{Beam}, la barra, va después de que la barra
1933 se ha iniciado, y por ello no tiene ningún efecto.
1935 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1936 un contexto deshace una instrucción @code{\override}; como con
1937 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1938 del mismo contexto. En otras palabras, el @code{\revert} del
1939 siguiente ejemplo no hace nada.
1942 \override Voice.Stem.thickness = #4.0
1943 \revert Staff.Stem.thickness
1946 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1947 dentro de las propiedades normales. Para trucarlas, utilice
1948 instrucciones de la forma
1950 @c leave this as a long long
1952 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1959 \override Stem.details.beamed-lengths = #'(4 4 3)
1965 Referencia de funcionamiento interno:
1966 @rinternals{Backend},
1967 @rinternals{All layout objects},
1968 @rinternals{OverrideProperty},
1969 @rinternals{RevertProperty},
1970 @rinternals{PropertySet}.
1973 El «back-end» o motor de salida no es muy estricto en la
1974 comprobación de tipos de las propiedades de objetos. Las
1975 referencias cíclicas en valores Scheme de propiedades pueden
1976 producir cuelgues o salidas abruptas, o las dos cosas.
1979 @node La instrucción set
1980 @subsection La instrucción @code{@bs{}set}
1981 @translationof The set command
1985 @cindex cambiar propiedades
1987 Cada contexto puede tener distintas @emph{propiedades}, variables
1988 contenidas dentro de ese contexto. Se pueden cambiar mientras
1989 dura el paso de interpretación. Se consigue insertando la
1990 instrucción @code{\set} dentro de la música:
1993 \set @var{contexto}.@var{propiedad} = #@var{valor}
1996 @var{valor} es un objeto de Scheme, razón por la que va precedido
1997 del carácter almohadilla,@tie{}@code{#}.
1999 El nombre de las propiedades de contexto suele ir en minúsculas
2000 con mayúscula en medio. Controlan sobre todo la traducción de la
2001 música a la notación, p.ej. @code{localAlterations} (para
2002 determinar si hay que impriir alteraciones o no), o
2003 @code{measurePosition} (para determinar cuándo hay que imprimir
2004 una línea divisoria). El valor de las propiedades de contexto
2005 puede modifcarse con el tiempo durante la interpretación de la
2006 música; un ejemplo obvio es @code{measurePosition}. Las
2007 propiedades de contexto se modifican mediante la instrucción
2010 Por ejemplo, los silencios multicompás se combinan en un solo
2011 compás si el valor de la propiedad de contexto @code{skipBars} se
2012 establece a @code{#t} (verdadero):
2014 @lilypond[quote,fragment,verbatim]
2016 \set Score.skipBars = ##t
2020 Si se omite el argumento @var{context}, entonces se utiliza el
2021 contexto actual de nivel más bajo (normalmente @code{ChordNames},
2022 @code{Voice} o @code{Lyrics}). En este ejemplo:
2024 @lilypond[quote,fragment,verbatim]
2025 \set Score.autoBeaming = ##f
2028 \set autoBeaming = ##t
2036 El cambio se aplica @q{al vuelo}, mientras dura la música, de
2037 forma que el ajuste sólo afecta al segundo grupo de corcheas.
2039 Observe que el contexto del nivel más bajo no siempre contiene la
2040 propiedad que querríamos modificar: por ejemplo, intentar ajustar
2041 el valor de la propiedad @code{skipBars} del contexto
2042 predeterminado del nivel más bajo, que en este caso es
2043 @code{Voice}, no tendrá ningún efecto, porque skipBars es una
2044 propiedad del contexto @code{Score}.
2046 @lilypond[quote,fragment,verbatim]
2052 Los contextos son jerárquicos, y si se ha especificado un contexto
2053 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
2054 también a todos los contextos @code{Voice} dentro del pentagrama
2059 También existe una instrucción @code{\unset}:
2061 \unset @var{contexto}.@var{propiedad}
2065 que elimina la definición de @var{propiedad}. Esta instrucción
2066 elimina la definición solamente si está establecida dentro de
2067 @var{contexto}. Properties that have been set in enclosing contexts will
2068 not be altered by an unset in an enclosed context:
2070 @lilypond[quote,fragment,verbatim]
2071 \set Score.autoBeaming = ##t
2075 \unset Score.autoBeaming
2083 Como @code{\set}, el argumento @var{contexto} no se tiene que
2084 especificar para un contexto del nivel más bajo, por lo que los
2088 \set Voice.autoBeaming = ##t
2089 \set autoBeaming = ##t
2093 son equivalentes si el contexto inferior en curso es @code{Voice}.
2097 Los ajustes con @code{\set} o @code{\unset} que se aplican
2098 solamente a un único paso de tiempo se pueden escribir con
2099 @code{\once}, por ejemplo en
2101 @lilypond[quote,fragment,verbatim]
2103 \once \set fontSize = #4.7
2108 En el manual de Referencia de funcionamiento interno hay una
2109 descripción completa de todas las propiedades de contexto
2110 disponibles, consulte
2112 @rinternals{Tunable context properties}.
2115 Traducción @expansion{} Propiedades de contexto modificables por el
2120 Referencia de funcionamiento interno:
2121 @rinternals{Tunable context properties}.
2123 @node La instrucción override
2124 @subsection La instrucción @code{\override}
2125 @translationof The override command
2127 @cindex grob, propiedades de
2128 @cindex propiedades de grob
2131 Existe un tipo especial de propiedad de contexto: la descripción
2132 de los grobs. Las decscripciones de los grobs reciben un nombre
2133 en @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen
2134 los @q{ajustes predeterminados} para un tipo particular de grob,
2135 en forma de lista asociativa. Consulte
2136 @file{scm/define-grobs.scm} para ver los ajustes de cada
2137 descripción de grob. Las descripciones de grob se modifican con
2140 La sintaxis de la instrucción @code{\override} es
2143 \override [@var{contexto}.]@var{NombreDelGrob}.@var{propiedad} = #@var{valor}
2146 Por ejemplo, podemos aumentar el grosor de la plica de una figura
2147 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
2148 @code{Stem} (plica):
2150 @lilypond[quote,fragment,verbatim]
2152 \override Voice.Stem.thickness = #3.0
2156 Si no se ha especificado ningún contexto en la instrucción
2157 @code{\override}, se utiliza el contexto del nivel inferior:
2159 @lilypond[quote,fragment,verbatim]
2160 \override Staff.Stem.thickness = #3.0
2164 \override Stem.thickness = #0.5
2173 Algunas opciones susceptibles de trucaje, se llaman
2174 @q{subpropiedades} y residen dentro de las propiedades. Para
2175 efectura trujajes sobre ellas, utilice instrucciones de la forma
2178 \override Stem.details.beamed-lengths = #'(4 4 3)
2181 o para modificar los extremos de los objetos extensos, utilice una
2182 forma como las siguientes:
2185 \override TextSpanner.bound-details.left.text = #"left text"
2186 \override TextSpanner.bound-details.right.text = #"right text"
2190 @cindex reversión de sobreescrituras
2191 @cindex sobreescrituras, reversión de
2193 El efecto de una instrucción de sobreescritura @code{\override} se
2194 puede deshacer con @code{\revert}.
2196 La sintaxis de la instrucción @code{\revert} es
2199 \revert [@var{Contexto}.]@var{NombreDelGrob}.@var{propiedad}
2204 @lilypond[quote,verbatim]
2207 \override Voice.Stem.thickness = #3.0
2209 \revert Voice.Stem.thickness
2214 Los efectos de @code{\override} y @code{\revert} se aplican a
2215 todos los grobs del contexto afectado partiendo del momento actual
2218 @lilypond[quote,verbatim]
2222 \override Staff.Stem.thickness = #3.0
2227 \revert Staff.Stem.thickness
2234 @cindex sobreescritura para un solo momento
2236 Se puede usar @code{\once} con @code{\override} o @code{\revert}
2237 para afectar solamente al instante de tiempo actual:
2239 @lilypond[quote,verbatim]
2242 \override Stem.thickness = #3.0
2247 \once \override Stem.thickness = #3.0
2255 Las instrucciones que modifican la salida tienen por lo general un
2259 \override Voice.Stem.thickness = #3.0
2263 Para construir este truco debemos determinar los siguientes datos:
2266 @item el contexto: aquí @code{Voice}.
2267 @item el objeto de presentación: aquí @code{Stem}.
2268 @item la propiedad de presentación: aquí @code{thickness}.
2269 @item un valor adecuado: aquí @code{3.0}.
2272 @cindex documentación interna
2273 @cindex buscar objetos gráficos
2274 @cindex gráficos, descripción de los objetos
2277 @cindex interna, documentación
2279 Para muchas propiedades, independientemente del tipo de datos de la
2280 propiedad, si se establece el valor de la propiedad a falso
2281 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
2282 ignore por completo dicha propiedad. Esto es especialmente útil para
2283 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
2284 causarían problemas.
2286 Mostraremos a continuación cómo localizar esta información en el
2287 manual de notación y en la referencia de funcionamiento interno.
2291 Referencia de funcionamiento interno:
2292 @rinternals{Backend}
2295 @node La instrucción tweak
2296 @subsection La instrucción @code{\tweak}
2297 @translationof The tweak command
2302 El cambio de las propiedades de grob mediante @code{\override} produce
2303 la aplicación del cambio a todos los grobs dados en el contexto en el
2304 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
2305 podemos desear que los cambios se apliquen a un solo grob en lugar de
2306 a todos los grobs del contexto afectado. Esto se consigue con la
2307 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
2310 \tweak [@var{objeto-de-presentación}.]@var{propiedad-del-grob} @var{valor}
2313 Es opcional especificar el @var{objeto-de-presentación}. La
2314 instrucción @code{\tweak} se aplica al objeto musical que viene
2315 inmediatamente después de @var{valor} dentro del flujo musical.
2318 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
2319 los objetos gráficos. Para objetos que resultan directamente de un
2320 elemento de código de la entrada, puede usar la función @code{\tweak},
2323 @lilypond[verbatim,quote]
2329 \tweak duration-log #1
2339 El uso principal de la instrucción @code{\tweak} es modificar
2340 solamente uno de varios elementos de notación que dan comienzo en el
2341 mismo momento musical, como las notas de un acorde, o corchetes de
2342 tresillo que empiezan al mismo tiempo.
2344 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
2345 a continuación de forma directa, sin necesidad de especificar el
2346 nombre del grob o el contexto. Para que esto funcione, es necesario
2347 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
2348 al objeto al que se aplica, después de que el archivo de entrada se ha
2349 convertido en un flujo musical. Con frecuencia no es el caso, pues
2350 muchos elementos adicionales se insertan en la corriente musical de
2351 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
2352 parte de un acorde, LilyPond inserta implícitamente un evento
2353 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
2354 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
2355 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
2356 en el flujo musical, permaneciendo así adyacente a la nota, y con la
2357 posibilidad de modificarla.
2361 @lilypond[verbatim,fragment,quote]
2362 <\tweak color #red c''>4
2366 pero esto no funciona:
2368 @lilypond[verbatim,fragment,quote]
2369 \tweak color #red c''4
2374 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
2375 consulte @rlearning{Métodos de trucaje}.
2377 Si se colocan varios elementos similares en el mismo momento
2378 musical, la instrucción @code{\override} no se puede usar para
2379 modificar uno solo de ellos: aquí es donde se debe usar la
2380 instrucción @code{\tweak}. Entre los elementos que pueden
2381 aparecer más de una vez en el mismo momento musical están los
2384 @c TODO expand to include any further uses of \tweak
2386 @item las cabezas de las notas de un acorde
2387 @item signos de articulación sobre la misma nota
2388 @item ligaduras de unión entre notas de un acorde
2389 @item corchetes de grupos especials que comienzan en el mismo momento
2392 @c TODO add examples of these
2394 @cindex acorde, modificación de una nota
2396 En este ejemplo se modifican el color de una cabeza y el tipo de
2397 otra, dentro del mismo acorde:
2399 @lilypond[verbatim,fragment,quote]
2404 \tweak duration-log #1
2409 @code{\tweak} se puede usar para modificar ligaduras de expresión:
2411 @lilypond[verbatim,quote]
2412 \relative { c'-\tweak thickness #5 ( d e f) }
2416 Para que funcione la instrucción @code{\tweak}, debe permanecer
2417 adyacente al objeto al que se ha de aplicar después de que el código
2418 de entrada se ha convertido a un flujo musical. El trucaje de un
2419 acorde completo no hace nada porque su evento musical actúa solamente
2420 como un contenedor, y todos los objetos de presentación se crean a
2421 partir de eventos dentro del @code{EventChord}:
2423 @lilypond[verbatim,fragment,quote]
2424 \tweak color #red c''4
2425 \tweak color #red <c'' e''>4
2426 <\tweak color #red c'' e''>4
2429 La instrucción @code{\tweak} sencilla no se puede usar para
2430 modificar ningún objeto que no se haya creado directamente a
2431 partir de la entrada. Concretamente, no afecta a las plicas,
2432 barras automáticas ni alteraciones, porque éstos se generan
2433 posteriormente por parte de objetos de presentación
2434 @code{NoteHead} más que por elementos musicales del flujo de
2437 Tales objetos de presentación creados indirectamente se pueden
2438 trucar usando la forma de la instrucción @code{\tweak} en que el
2439 nombre del grob se especifica de forma explícita:
2441 @lilypond[fragment,verbatim,quote]
2442 \tweak Stem.color #red
2443 \tweak Beam.color #green c''8 e''
2444 <c'' e'' \tweak Accidental.font-size #-3 ges''>4
2447 No se puede usar @code{\tweak} para modificar las claves o las
2448 indicaciones de compás, porque éstos se separan de cualquier
2449 instrucción @code{\tweak} precedente dentro del flujo de entrada
2450 merced a la inserción automática de elementos adicionales que se
2451 requieren para especificar el contexto.
2453 Se pueden colocar varias instrucciones @code{\tweak} antes de un
2454 elemento de notación; todos le afectan:
2456 @lilypond[verbatim,fragment,quote]
2458 -\tweak style #'dashed-line
2459 -\tweak dash-fraction #0.2
2460 -\tweak thickness #3
2466 El flujo musical que se genera a partir de una sección de un
2467 archivo de entrada (incluido cualquier elemento insertado
2468 automáticamente) puede examinarse, véase
2469 @rextend{Presentación de las expresiones musicales}. Esto puede
2470 ser de utilidad en la determinación de lo que puede modificarse
2471 por medio de una instrucción @code{\tweak}.
2474 Manual de aprendizaje:
2475 @rlearning{Métodos de trucaje}.
2477 Manual de extensión:
2478 @rextend{Presentación de las expresiones musicales}.
2482 @cindex trucar puntos de control
2483 @cindex control, trucar puntos de
2485 No se puede usar la instrucción @code{\tweak} para modificar los
2486 puntos de control de una sola de varias ligaduras de unión dentro
2487 de un acorde, aparte de la primera que se encuentre en el código
2491 @node set frente a override
2492 @subsection @code{\set} frente a @code{\override}
2493 @translationof set versus override
2495 @c TODO Should't a bunch of that be explained earlier?
2500 Tanto la instrucción @code{\set} como @code{\override} manipulan
2501 propiedades asociadas a contextos. En ambos casos las propiedades
2502 siguen una@emph{jerarquía de contextos}: las propiedades que no se
2503 establecen dentro del contexto aún presentan los valores del
2504 contexto de su padre respectivo.
2506 El valor y la duración en el tiempo de una propiedad de contexto
2507 son dinámicos y están disponibles solamente cuando la música se
2508 está interpretando o @q{iterando}. En el momento de la creación
2509 del contexto, se inicializan las propiedades a partir de las
2510 definiciones correspondientes (así como otras posibles
2511 modificaciones) de dicho contexto. Cualquier cambio posterior se
2512 obtiene a través de instrucciones de establecimiento de
2513 propiedades dentro de la propia música.
2515 Las definiciones de grob (objetos gráficos) son una clase
2516 @emph{especial} de propiedades de contexto, pues su estructura y
2517 uso son distintos de las propiedades de contexto ordinarias. A
2518 diferencia de las propiedades de los contextos normales, las
2519 definiciones de grob se subdividen en @emph{propiedades de grob}.
2521 Además, en contraste con las propiedades de contexto normales, las
2522 definiciones de grob tienen su propio conjunto de @q{utilidades de
2523 mantenimiento} de las propiedades individuales y, en su caso,
2524 sub-propiedades. Esto supone que es posible definir las distintas
2525 partes dentro de diferentes contextos y aún tener la definición
2526 completa del grob en el momento de su creación, montada a partir
2527 de todas las piezas proporcionadas por el contexto actual y su
2528 ancestro o ancestros, conjuntamente.
2530 Un grob u objeto gráfico se crea normalmente por parte de un
2531 grabador en el momento de la interpretación de una expresión
2532 musical y recibe sus propiedades iniciales de la definición de
2533 grob en curso del contexto del grabador. El grabador (u otras
2534 partes del @q{backend} de LilyPond) pueden después modificar (o
2535 añadirse a) las propiedades iniciales del grob; sin embargo, ello
2536 no afecta a la definición de grob del contexto.
2538 Lo que LilyPond conoce como @q{propiedades de grob} en el contexto
2539 del trucaje a nivel de usuario son en realidad las propiedades de
2540 la definición de grob de un contexto.
2542 Se accede a las definiciones de grob con un conjunto de
2543 instrucciones diferente. Se manipulan usando @code{\override} y
2544 @code{\revert} y tienen un nombre que empieza con una letra
2545 mayúscula (como @samp{NoteHead}) mientras que las propiedades de
2546 contexto ordinarias se manipulan utilizando @code{\set} y
2547 @code{\unset} y se nombran empezando en letra minúscula.
2549 @cindex tweak, relación con @code{\override}
2551 @funindex \overrideProperty
2553 Las instrucciones @code{\tweak} y @code{\overrideProperty} cambian
2554 las propiedades de grob pasando por encima de las propiedades de
2555 contexto completamente. En su lugar, atrapan a los grobs tan
2556 pronto se crean, y establecen propiedades sobre ellos directamente
2557 con @code{\tweak} cuando se originan a partir de un evento musical
2558 o, en el caso de @code{\overrideProperty}, para una sobreescritura
2561 @node Modificación de las listas-A
2562 @subsection Modificación de las listas-A
2563 @translationof Modifying alists
2565 Ciertas propiedades configurables por parte del usuario se
2566 representan internamente como @emph{listas-A} (listas
2567 asociativas), que almacenan duplas de @emph{claves} y
2568 @emph{valores}. La estructura de una lista-A es la siguiente:
2571 '((@var{clave1} . @var{valor1})
2572 (@var{clave2} . @var{valor2})
2573 (@var{clave3} . @var{valor3})
2577 Si una lista-A es una propiedad de un grob o una variable de
2578 @code{\paper}, sus claves se pueden modificar individualmente sin
2579 que afecte a las otras claves.
2581 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2582 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2583 del grob @code{StaffGrouper}. La propiedad es una lista-A con
2584 cuatro claves: @code{basic-distance} (distancia básica),
2585 @code{minimum-distance} (distancia mínima), @code{padding}
2586 (relleno) y @code{stretchability} (ampliabilidad). Los ajustes
2587 estándar para esta propiedad se relacionan en la sección
2588 @qq{Backend} de la Referencia de Funcionamiento Interno (véase
2589 @rinternals{StaffGrouper}):
2592 '((basic-distance . 9)
2593 (minimum-distance . 7)
2595 (stretchability . 5))
2598 Una forma de acercar los pentagramas entre sí es reducir el valor
2599 de la clave @code{basic-distance} (@code{9}) para que se
2600 corresponda con el valor de @code{minimum-distance} (@code{7}).
2601 Para modificar una única clave de forma individual, utilice una
2602 @emph{declaración anidada}:
2604 @lilypond[quote,verbatim]
2605 % default space between staves
2607 \new Staff { \clef treble c''1 }
2608 \new Staff { \clef bass c1 }
2611 % reduced space between staves
2612 \new PianoStaff \with {
2613 % this is the nested declaration
2614 \override StaffGrouper.staff-staff-spacing.basic-distance = #7
2616 \new Staff { \clef treble c''1 }
2617 \new Staff { \clef bass c1 }
2621 La utilización de una declaración anidada actualiza la clave
2622 especificada (como @code{basic-distance} en el ejemplo anterior)
2623 sin alterar ninguna de las otras claves que ya se habían
2624 establecido para la misma propiedad.
2626 Ahora, supongamos que deseamos que los pentagramas estén tan
2627 próximos como sea posible sin que se superpongan. La manera más
2628 sencilla de hacerlo es establecer las cuatro claves de la lista-A
2629 a cero. Sin embargo, no es necesario escribir cuatro
2630 declaraciones anidadas, una por cada clave. En lugar de eso, se
2631 puede redefinir completamente la propiedad con una sola
2632 declaración, como una lista-A:
2634 @lilypond[quote,verbatim]
2635 \new PianoStaff \with {
2636 \override StaffGrouper.staff-staff-spacing =
2637 #'((basic-distance . 0)
2638 (minimum-distance . 0)
2640 (stretchability . 0))
2642 \new Staff { \clef treble c''1 }
2643 \new Staff { \clef bass c1 }
2647 Observe que cualquier clave que no haya sido relacionada
2648 explícitamente en la definición de la lista-A, será reiniciada a
2649 sus valores @emph{predeterminados si no se han fijado}. En el
2650 caso de @code{staff-staff-spacing}, el valor de cualquier clave no
2651 fijada se reiniciaría a cero (excepto @code{stretchability}, que
2652 toma el valor de @code{basic-distance} si no se fija). Así, las
2653 dos declaraciones siguientes son equivalentes:
2656 \override StaffGrouper.staff-staff-spacing =
2657 #'((basic-distance . 7))
2659 \override StaffGrouper.staff-staff-spacing =
2660 #'((basic-distance . 7)
2661 (minimum-distance . 0)
2663 (stretchability . 7))
2666 Una consecuencia de esto (posiblemente no intencionada) es la
2667 eliminación de cualquier valor estándar que se establezca en un
2668 archivo de inicio y que se carga cada vez que se compila un
2669 archivo de entrada. En el ejemplo anterior, los ajustes estándar
2670 para @code{padding} y @code{minimum-distance} (definidos en
2671 @file{scm/define-grobs.scm}) se reinician a sus valores
2672 predeterminados si no se han fijado (cero para las dos claves).
2673 La definición de una propiedad o variable como una lista-A (de
2674 cualquier tamaño) siempre reinicia todos los valores de clave no
2675 establecidos a sus valores predeterminados si no se han fijado.
2676 Ano ser que este sea el resultado deseado, es más seguro
2677 actualizar los valores de clave individualmente con una
2678 declaración anidada.
2680 @warning{Las declaraciones anidadas no funcionan para las listas-A
2681 de propiedades de contexto (como @code{beamExceptions},
2682 @code{keyAlterations}, @code{timeSignatureSettings}, etc.). Estas
2683 propiedades sólo se pueden modificar redefiniéndolas completamente
2687 @node Conceptos y propiedades útiles
2688 @section Conceptos y propiedades útiles
2689 @translationof Useful concepts and properties
2693 * Modos de entrada::
2694 * Dirección y posición::
2695 * Distancias y medidas::
2697 * Propiedades del símbolo del pentagrama::
2698 * Objetos de extensión::
2699 * Visibilidad de los objetos::
2700 * Estilos de línea::
2701 * Rotación de objetos::
2704 @node Modos de entrada
2705 @subsection Modos de entrada
2706 @translationof Input modes
2708 La forma en que se interpreta la notación contenida dentro de un
2709 archivo de entrada, está determinada por el modo de entrada en
2712 @subsubsubheading Modo de acordes
2714 Se activa con la instrucción @code{\chordmode} y produce que la
2715 entrada se interprete con al sintaxis de la notación de acordes,
2716 véase @ref{Notación de acordes}. Los acordes se imprimen como
2717 notas sobre un pentagrama.
2719 El modo de acordes se activa también con la instrucción
2720 @code{\chords}. Esto crea también un contexto @code{ChordNames}
2721 nuevo y produce que el código que sigue se interprete con la
2722 sintaxis de la notación de acordes y se imprima como nombres de
2723 acorde dentro del contexto @code{ChordNames}, véase @ref{Impresión
2724 de los nombres de acorde}.
2726 @subsubsubheading Modo de percusión
2728 Se activa con la instrucción @code{\drummode} y produce que el
2729 código de entrada se interprete con la sintaxis de la notación de
2730 percusión, véase @ref{Notación básica de percusión}.
2732 El modo de percusión también se activa con la instrucción
2733 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y
2734 hace que el código que sigue se interprete con la sintaxis de la
2735 notación de percusión y se imprima como símbolos de percusión
2736 sobre un pentagrama de percusión, véase @ref{Notación básica de
2739 @subsubsubheading Modo de cifras
2741 Se activa con la instrucción @code{\figuremode} y hace que el código
2742 de entrada se interprete con la sintaxis del bajo cifrado, véase
2743 @ref{Introducir el bajo cifrado}.
2745 El modo de cifras también se activa con la instrucción
2746 @code{\figures}. También crea un contexto de @code{FiguredBass}
2747 nuevo y hace que el código que viene a continuación se interprete
2748 con la sintaxis del bajo cifrado y se imprima como símbolos de
2749 bajo cifrado dentro del contexto @code{FiguredBass}, véase
2750 @ref{Introducción al bajo cifrado}.
2752 @subsubsubheading Modos de traste y tablatura
2754 No existen modos de entrada especiales para introducir símbolos de
2755 trastes y de tablatura.
2757 Para crear diagramas de trastes, escriba las notas o acordes en el
2758 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2759 véase @ref{Tablaturas predeterminadas}.
2761 Para crear diagramas de trastes encima de un pentagrama, podemos
2762 elegir entre dos posibilidades. Se puede usar el contexto
2763 @code{FretBoards} (véase @ref{Diagramas de traste automáticos}) o
2764 se pueden introducir como elementos de marcado encima de las notas
2765 utilizando la instrucción @code{\fret-diagram}, véase
2766 @ref{Marcas de diagramas de trastes}.
2768 @subsubsubheading Modo de letra
2770 Se activa con la instrucción @code{\lyricmode}, y hace que la
2771 entrada se interprete como sílabas de la letra de la canción con
2772 duraciones opcionales y modificadores de letra asociados, véase
2775 El modo de letra también se habilita con la instrucción
2776 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics}
2777 nuevo y una instrucción @code{\lyricsto} implícita que asocia la
2778 letra que viene a continuación con la música precedente.
2780 @subsubsubheading Modo de marcado
2782 Se activa con la instrucción @code{\markup}, y hace que la entrada
2783 se interprete con la sintaxis del marcado, véase
2784 @ref{Text markup commands}.
2786 @subsubsubheading Modo de notas
2788 Es el modo predeterminado o se puede activar con la instrucción
2789 @code{\notemode}. La entrada se interpreta como alturas,
2790 duraciones, marcado, etc. y se imprime como notación musical sobre
2793 Normalmente no es necesario especificar el modo de notas de forma
2794 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2795 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2796 otro modo y queremos insertar algo que solamente se puede hacer
2797 con la sintaxis del modo de notas.
2800 @node Dirección y posición
2801 @subsection Dirección y posición
2802 @translationof Direction and placement
2804 Al tipografiar música, la dirección y colocación de muchos
2805 elementos es cuestión de elección. Por ejemplo, las plicas de las
2806 notas se pueden dirigir hacia arriba o hacia abajo; la letra, las
2807 indicaciones dinámicas y otras marcas expresivas se pueden colocar
2808 encima o debajo del pentagrama; el texto se pude alinear a la
2809 izquierda, a la derecha o centrado; etc. La mayoría de estas
2810 elecciones pueden dejarse que LilyPond las determine
2811 automáticamente, pero en ciertos casos puede ser deseable forzar
2812 una dirección o colocación concreta.
2815 * Indicadores de dirección de las articulaciones::
2816 * La propiedad de dirección::
2820 @node Indicadores de dirección de las articulaciones
2821 @unnumberedsubsubsec Indicadores de dirección de las articulaciones
2822 @translationof Articulation direction indicators
2824 De forma predeterminada algunas direcciones siempre son hacia
2825 arriba o siempre hacia abajo (p. ej. los matices o el calderón),
2826 mientras que otras cosas pueden alternar entre arriba y abajo en
2827 función de la dirección de las plicas (como las ligaduras o los
2830 @c TODO Add table showing these
2832 Se puede sobreescribir la acción predeterminada mediante el
2833 prefijado de la articulación por un @emph{indicacor de dirección}.
2834 Están disponibles tres indicadores de dirección: @code{^} (que
2835 significa @qq{arriba}), @code{_} (que significa @qq{abajo}) o
2836 @code{-} (que significa @qq{usar la dirección predeterminada}).
2837 El indicador de dirección se puede normalmente omitir, en cuyo
2838 caso se supone el indicador predeterminado @code{-}, pero se
2839 necesita un indicador de dirección @strong{siempre} antes de:
2842 @item las instrucciones @code{\tweak}
2843 @item las instrucciones @code{\markup}
2844 @item las instrucciones @code{\tag}
2845 @item los marcados de cadena, p.ej. -"cadena"
2846 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2847 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2850 Estas indicaciones afectan sólo a la nota siguiente.
2852 @lilypond[verbatim,quote]
2862 @node La propiedad de dirección
2863 @unnumberedsubsubsec La propiedad de dirección
2864 @translationof The direction property
2866 La posición o dirección de muchos objetos de presentación está
2867 controlada por la propiedad @code{direction}.
2869 El valor de la propiedad @code{direction} se puede establecer al
2870 valor @code{1}, con el significado de @qq{hacia arriba} o
2871 @qq{encima}, o a @w{@code{-1}}, con el significado de @qq{hacia
2872 abajo} o @qq{debajo}. Se pueden usar los símbolos @code{UP} y
2873 @code{DOWN} en sustitución de @code{1} y @w{@code{-1}}
2874 respectivamente. La dirección predeterminada se puede especificar
2875 estableciendo @code{direction} a @code{0} ó a @code{CENTER}. De
2876 forma alternativa, en muchos casos existen instrucciones
2877 predefinidas para especificar la dirección. Todas ellas son de la
2881 \xxxUp, \xxxDown o \xxxNeutral
2885 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
2886 predeterminada}. Véase @rlearning{Objetos interiores al
2889 En alguna que otra ocasión como en el arpegio, el valor de la
2890 propiedad @code{direction} puede especificar si el objeto se debe
2891 colocar a la izquierda o a la derecha del objeto padre. En este
2892 caso @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y
2893 @code{1} ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó
2894 @code{CENTER} significan @qq{utilizar la dirección
2897 Estas indicaciones afectan a todas las notas hasta que son
2900 @lilypond[verbatim,quote]
2911 En música polifónica, en general es mejor especificar una voz
2912 explícita que cambiar la dirección de un objeto. Para ver más
2913 información, véase @ref{Varias voces}.
2916 Manual de aprendizaje:
2917 @rlearning{Objetos interiores al pentagrama}.
2919 Referencia de la notación:
2923 @node Distancias y medidas
2924 @subsection Distancias y medidas
2925 @translationof Distances and measurements
2927 @cindex distancias absolutas
2928 @cindex distancias escaladas
2935 Las distancias en LilyPond son de dos tipos: absolutas y
2938 Las distancias absolutas se usan para especificar márgenes,
2939 sangrados y otros detalles de diseño de página, y de forma
2940 predeterminada se especifican en milímetros. Las distancias se
2941 pueden especificar en otras unidades escribiendo después de la
2942 cifra indicativa de la cantidad, @code{\mm}, @code{\cm},
2943 @code{\in}@tie{}(pulgadas), o @code{\pt}@tie{}(puntos, 1/72.27
2944 pulgadas). Las distancias de diseño de página se pueden
2945 especificar también en unidades escalables (véase el párrafo
2946 siguiente) adjuntando @code{\staff-space} a la cantidad. La
2947 disposición de página se describe en detalle en @ref{Disposición
2950 Las distancias escaladas siempre se especifican en unidades de un
2951 espacio del pentagrama o, más raramente, medio espacio del
2952 pentagrama. El espacio de pentagrama es la distancia entre dos
2953 líneas del pentagrama adyacentes. El valor predeterminado se
2954 puede cambiar globalmente fijando el tamaño global del pentagrama,
2955 o se puede sobreescribir localmente cambiando la propiedad
2956 @code{staff-space} del objeto @code{StaffSymbol}. Las distancias
2957 escaladas se escalan automáticamente con cualquier cambio al
2958 tamaño global del pentagrama o a la propiedad @code{staff-space}
2959 del objeto @code{StaffSymbol}, pero las fuentes tipográficas se
2960 escalan solamente con los cambios efectuados al tamaño global del
2961 pentagrama. Así, el tamaño global del pentagrama posibilita la
2962 fácil variación del tamaño general de una partitura impresa. Para
2963 ver los métodos de establecimiento del tamaño global del
2964 pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2968 Si se necesita dibujar sólo una sección de una partitura a una
2969 escala distinta, por ejemplo una sección ossia o una nota al pie,
2970 no se puede simplemente cambiar el tamaño global del pentagrama
2971 porque esto afectaría a toda la partitura. En tales casos, el
2972 cambio de tamaño se hace sobreescribiendo tanto la propiedad
2973 @code{staff-space} de @code{StaffSymbol} como el tamaño de las
2974 fuentes tipográficas. Está a nuestra disposición una función de
2975 Scheme, @code{magstep}, para convertir de un cambio en el tamaño
2976 de la fuente al cambio equivalente en @code{staff-space}. Para
2977 ver una explicación y un ejemplo de su utilización, consulte
2978 @rlearning{Longitud y grosor de los objetos}.
2981 Manual de aprendizaje:
2982 @rlearning{Longitud y grosor de los objetos}.
2984 Referencia de la notación:
2985 @ref{Disposición de la página},
2986 @ref{Establecer el tamaño del pentagrama}.
2990 @subsection Dimensiones
2991 @translationof Dimensions
2994 @cindex caja circundante
2996 Las dimensiones de un objeto gráfico especifican las posiciones de
2997 los límites izquierdo y derecho, así como los límites inferior y
2998 superior de las cajas limítrofes de los objetos como distancias a
2999 partir del punto de referencia del objeto en unidades de espacios
3000 de pentagrama. Estas posiciones se codifican frecuentemente como
3001 dos parejas de valores de Scheme. Por ejemplo, la instrucción de
3002 marcado de texto @code{\with-dimensions} toma tres argumentos, de
3003 los cuales los dos primeros son una pareja de Scheme que da las
3004 posiiciones de los bordes izquierdo y derecho y otra pareja de
3005 Scheme que da las posiciones de los límites inferior y superior:
3008 \with-dimensions #'(-5 . 10) #'(-3 . 15) @var{arg}
3011 Esto especifica una caja circundante para @var{arg} con su límite
3012 izquierdo en -5, su límite derecho en 10, el inferior en -3 y el
3013 superior e 15, todos ellos medidos a partir del punto de
3014 referencia del objeto en unidades de espacios de pentagrama.
3017 Referencia de la notación:
3018 @ref{Distancias y medidas}.
3021 @node Propiedades del símbolo del pentagrama
3022 @subsection Propiedades del símbolo del pentagrama
3023 @translationof Staff symbol properties
3025 @cindex ajuste del símbolo del pentagrama
3026 @cindex dibujar el símbolo del pentagrama
3027 @cindex pentagrama, establecer el símbolo del
3029 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
3030 @c Need to think of uses for these properties. Eg 'line-positions
3031 @c is used in a snippet to thicken centre line.
3032 @c If retained, add @ref to here in 1.6.2 -td
3034 Se puede definir al mismo tiempo la posición vertical de las
3035 líneas de la pauta y el número de líneas de la misma. Como
3036 muestra el siguiente ejemplo, las posiciones de las notas no están
3037 influidas por las posiciones de las líneas de la pauta.
3039 @warning{La propiedad @code{'line-positions} sobreescribe a la
3040 propiedad @code{'line-count}. El número de líneas de la pauta
3041 está definido implícitamente por el número de elementos de la
3042 lista de valores de @code{'line-positions}.}
3044 @lilypond[verbatim,quote]
3046 \override StaffSymbol.line-positions = #'(7 3 0 -4 -6 -7)
3048 \relative { a4 e' f b | d1 }
3051 Se puede modificar la anchura de la pauta. Las unidades son
3052 espacios de pentagrama. El espaciado de los objetos dentro del
3053 pentagrama no resulta afectado por este ajuste.
3055 @lilypond[verbatim,quote]
3057 \override StaffSymbol.width = #23
3059 \relative { a4 e' f b | d1 }
3063 @node Objetos de extensión
3064 @subsection Objetos de extensión
3065 @translationof Spanners
3067 Muchos objetos de notación musical abarcan varias notas o incluso
3068 varios compases. Son ejemplos los crescendi, trinos, corchetes de
3069 grupo especial y corchetes de primera y segunda vez. Estos
3070 objetos se llaman @qq{spanners} u «objetos de extensión», y tienen
3071 propiedades especiales para controlar su apariencia y
3072 comportamiento. Algunas de estas propiedades son comunes a todos
3073 los objetos de extensión; otras se limitan a un subconjunto de los
3076 Todos los objetos de extensión contemplan el interface
3077 @code{spanner-interface}. Algunos, básicamente aquellos que
3078 trazan una línea recta entre los dos objetos, contemplan también
3079 el interface @code{line-spanner-interface}.
3082 * Uso del spanner-interface::
3083 * Uso del line-spanner-interface::
3086 @node Uso del spanner-interface
3087 @unnumberedsubsubsec Uso del @code{spanner-interface}
3088 @translationof Using the spanner-interface
3090 Este interface proporciona dos propiedades que se aplican a varios
3093 @subsubsubheading La propiedad @code{minimum-length} (longitud mínima)
3095 La longitud mínima del objeto de extensión se especifica a través
3096 de la propiedad @code{minimum-length}. Su aumento suele producir
3097 el efecto necesario de aumentar el espaciado de las notas entre
3098 los dos puntos extremos. Sin embargo, esta sobreescritura no
3099 tiene ningún efecto sobre muchos extensores, pues su longitud está
3100 determinada por otras consideraciones. Más abajo se muestran
3101 algunos ejemplos de dónde es efectiva.
3111 Works as long as callback is made:
3115 Works not at all for:
3124 @lilypond[verbatim,quote,fragment]
3127 % increase the length of the tie
3128 -\tweak minimum-length #5
3132 @lilypond[verbatim,quote]
3133 \relative \compressMMRests {
3136 % increase the length of the rest bar
3137 \once \override MultiMeasureRest.minimum-length = #20
3143 @lilypond[verbatim,quote]
3146 % increase the length of the hairpin
3147 \override Hairpin.minimum-length = #20
3152 Esta sobreescritura se puede usar también para aumentar la
3153 longitud de las ligaduras de expresión y de fraseo:
3155 @lilypond[verbatim,quote]
3159 -\tweak minimum-length #5
3164 -\tweak minimum-length #5
3169 Para algunos objetos de presentación, la propiedad
3170 @code{minimum-length} es efectiva sólo si se llama explícitamente
3171 al procedimiento @code{set-spacing-rods}. Para hacerlo, se debe
3172 fijar la propiedad @code{springs-and-rods} al valor
3173 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud
3174 mínima de un glissando no tiene efecto a no ser que se establezca
3175 la propiedad @code{springs-and-rods}:
3177 @lilypond[verbatim,fragment,quote]
3181 % not effective alone
3182 \once \override Glissando.minimum-length = #20
3185 % effective only when both overrides are present
3186 \once \override Glissando.minimum-length = #20
3187 \once \override Glissando.springs-and-rods = #ly:spanner::set-spacing-rods
3191 Lo mismo se puede decir del objeto @code{Beam}:
3193 @lilypond[verbatim,fragment,quote]
3194 % not effective alone
3195 \once \override Beam.minimum-length = #20
3198 % effective only when both overrides are present
3199 \once \override Beam.minimum-length = #20
3200 \once \override Beam.springs-and-rods = #ly:spanner::set-spacing-rods
3204 @subsubsubheading La propiedad @code{to-barline}
3206 La segunda propiedad útil del @code{spanner-interface} es
3207 @code{to-barline}. De forma predeterminada tiene el valor cierto,
3208 haciendo que los reguladores y otros objetos de extensión que
3209 terminan sobre la primera nota de un compás, en vez de eso
3210 terminen en la línea divisoria inmediatamente precedente. Si se
3211 establece al valor falso, el extensor llegará más allá de la barra
3212 de compás y terminará exactamente sobre la nota:
3214 @lilypond[verbatim,quote]
3216 a' \< a a a a \! a a a \break
3217 \override Hairpin.to-barline = ##f
3218 a \< a a a a \! a a a
3222 Esta propiedad no es efectiva para todos los extensores. Por
3223 ejemplo, su establecimiento a @code{#t} no tienen ningún efecto
3224 sobre las ligaduras de expresión o de fraseo, o sobre otros
3225 extensores para los que terminar en la barra de compás no tendría
3228 @node Uso del line-spanner-interface
3229 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
3230 @translationof Using the line-spanner-interface
3232 Entre los objetos que contemplan el interface
3233 @code{line-spanner-interface} se encuentran
3236 @item @code{DynamicTextSpanner}
3237 @item @code{Glissando}
3238 @item @code{TextSpanner}
3239 @item @code{TrillSpanner}
3240 @item @code{VoiceFollower}
3243 La rutina responsable de dibujar los sellos de estos extensores es
3244 @code{ly:line-spanner::print}. esta rutina determina la
3245 localización exacta de los dos puntos extremos y traza una línea
3246 entre ellos, en el estilo solicitado. Las posiciones de los dos
3247 puntos extremos del extensor se calculan al vuelo, pero es posible
3248 sobreescribir sus coordenadas Y. Las propiedades que se deben
3249 especificar están anidadas a dos niveles de profundidad en la
3250 jerarquía de propiedades, pero la sintaxis de la instrucción
3251 @code{\override} es bastante sencilla:
3253 @lilypond[quote,fragment,verbatim]
3255 \once \override Glissando.bound-details.left.Y = #3
3256 \once \override Glissando.bound-details.right.Y = #-2
3260 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
3261 siendo el punto del cero la línea central del pentagrama. Para el
3262 glissando, esto es el valor de @code{Y} en la coordenada X que
3263 corresponde al punto central de cada cabeza de nota si nos
3264 imaginamos que la línea se extiende hasta allí.
3266 Si no está fijado @code{Y}, su valor se calcula a partir de la
3267 posición vertical del punto de anclaje correspondiente del
3270 En caso de salto de línea, los valores para los puntos extremos se
3271 especifican por las sub-listas @code{left-broken} y
3272 @code{right-broken} de @code{bound-details}. Por ejemplo:
3274 @lilypond[ragged-right,fragment,verbatim,quote]
3275 \override Glissando.breakable = ##t
3276 \override Glissando.bound-details.right-broken.Y = #-3
3277 c''1 \glissando \break
3281 Un número de propiedades adicionales de las sub-listas @code{left}
3282 y @code{right} de la propiedad @code{bound-details} se pueden
3283 especificar de la misma forma que @code{Y}:
3287 Establece la coordenada Y del punto extremo, en desplazamientos de
3288 @code{staff-space}s desde la línea central del pentagrama. De
3289 forma predeterminada es el centro del objeto ancla, y así un
3290 glissando apunta al centro vertical de la cabeza de la nota.
3292 Para extensores horizontales como los extensores de texto y los
3293 trinos, está inamoviblemente codificado como 0.
3295 @item attach-dir (dirección de anclaje)
3296 Determina dónde comienza y termina la línea en la dirección X, con
3297 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o
3298 @code{LEFT}, izquierda) hace que la línea comience o termine en el
3299 lado izquierdo de la cabeza de la nota a la que está anclado.
3302 Es la coordenada X absoluta del punto extremo. Se suele calcular
3303 al vuelo, y su sobreescritura no tiene un efecto útil.
3305 @item stencil (sello)
3306 Los extensores de línea pueden tener símbolos al comienzo o al
3307 final, lo que está contenido en esta sub-propiedad. Esto es para
3308 uso interno; se recomienda en su lugar el uso de @code{text}.
3311 Es un elemento de marcado que se evalúa para dar lugar al sello.
3312 Se usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los
3313 objetos de extensión horizontales.
3315 @lilypond[quote,ragged-right,fragment,verbatim]
3316 \override TextSpanner.bound-details.left.text
3317 = \markup { \small \bold Slower }
3318 \relative { c''2\startTextSpan b c a\stopTextSpan }
3321 @item stencil-align-dir-y (alineación del sello en y)
3322 @item stencil-offset (desplazamiento del sello)
3323 Si no se modifican uno u otro, el sello se coloca sencillamente en
3324 el punto extremo, centrado sobre la línea, como viene definido por
3325 las subpropiedades @code{X} e @code{Y}. Si se fijan
3326 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
3327 símbolo del borde verticalmente con relación al extremo de la
3330 @lilypond[quote,fragment,verbatim]
3331 \override TextSpanner.bound-details.left.stencil-align-dir-y = #-2
3332 \override TextSpanner.bound-details.right.stencil-align-dir-y = #UP
3334 \override TextSpanner.bound-details.left.text = #"ggg"
3335 \override TextSpanner.bound-details.right.text = #"hhh"
3337 \relative { c'4^\startTextSpan c c c \stopTextSpan }
3340 Observe que los valores negativos mueven el texto @emph{hacia
3341 arriba}, al contrario de lo que podría esperarse, pues el valor de
3342 @w{@code{-1}} o @code{DOWN} (abajo) significa alinear el borde
3343 @emph{inferior} del texto con la línea de extensión. Un valor de
3344 @code{1} o @code{UP} (arriba) alinea el borde superior del texto
3345 con la línea extensora.
3347 @item arrow (flecha)
3348 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
3349 flecha en el extremo de la línea.
3351 @item padding (relleno)
3352 Esta sub-propiedad controla el espacio entre el punto extremo
3353 especificado de la línea y el extremo real. Sin relleno, un
3354 glissando empezaría y terminaría en el centro de la cabeza de las
3359 La función musical @code{\endSpanners} finaliza de forma prematura
3360 el extensor que comienza sobre la nota que sigue inmediatamente a
3361 continuación. Se termina después de una nota exactamente, o en la
3362 siguiente barra de compás si @code{to-barline} es verdadero y se
3363 produce una divisoria antes de la siguiente nota.
3365 @lilypond[verbatim,quote,ragged-right]
3368 c2 \startTextSpan c2 c2
3374 Si se usa @code{\endSpanners} no es necesario cerrar
3375 \startTextSpan con \stopTextSpan, ni cerrar los reguladores con
3379 Referencia de funcionamiento interno:
3380 @rinternals{TextSpanner},
3381 @rinternals{Glissando},
3382 @rinternals{VoiceFollower},
3383 @rinternals{TrillSpanner},
3384 @rinternals{line-spanner-interface}.
3387 @node Visibilidad de los objetos
3388 @subsection Visibilidad de los objetos
3389 @translationof Visibility of objects
3391 @cindex objetos, visibilidad de
3392 @cindex grobs, visibilidad de
3393 @cindex visibilidad de los objetos
3395 Hay cuatro formas principales en que se puede controlar la
3396 visibilidad de los objetos de presentación: se puede eliminar su
3397 sello, se pueden volver transparentes, se pueden pintar de blanco,
3398 o se puede sobreescribir su propiedad @code{break-visibility}.
3399 Las tres primeras se aplican a todos los objetos de presentación;
3400 la última sólo a unos pocos: los objetos @emph{divisibles}. El
3401 Manual de aprendizaje introduce estas cuatro técnicas, véase
3402 @rlearning{Visibilidad y color de los objetos}.
3404 Hay también algunas otras técnicas que son específicas de ciertos
3405 objetos de presentación. Se estudian bajo Consideraciones
3409 * Eliminar el sello::
3410 * Hacer transparentes los objetos::
3411 * Pintar los objetos de blanco::
3412 * Uso de break-visibility (visibilidad en el salto)::
3413 * Consideraciones especiales::
3417 @node Eliminar el sello
3418 @unnumberedsubsubsec Eliminar el sello
3419 @translationof Removing the stencil
3421 @cindex sello, eliminar
3424 Todo objeto de presentación tiene una propiedad stencil (sello).
3425 De forma predeterminada está establecida a la función específica
3426 que dibuja ese objeto. Si se sobreescribe esta propiedad a
3427 @code{#f} no se llama a ninguna función y el objeto no se dibuja.
3428 La acción predeterminada se puede recuperar con @code{\revert}.
3430 @lilypond[quote,fragment,verbatim]
3432 \override Score.BarLine.stencil = ##f
3434 \revert Score.BarLine.stencil
3438 Esta operación, bastante común, tiene la forma abreviada
3439 @code{\omit} como atajo:
3441 @lilypond[quote,fragment,verbatim]
3445 \undo \omit Score.BarLine
3450 @node Hacer transparentes los objetos
3451 @unnumberedsubsubsec Hacer transparentes los objetos
3452 @translationof Making objects transparent
3454 @cindex transparentes, hacer los objetos
3457 Todo objeto de presentación tiene una propiedad transparent
3458 (transparente) que de forma predeterminada está establecida a
3459 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio
3462 @lilypond[quote,fragment,verbatim]
3464 \once \override NoteHead.transparent = ##t
3468 Esta operación, bastante común, tiene la forma abreviada @code{\hide}
3471 @lilypond[quote,fragment,verbatim]
3473 \once \hide NoteHead
3478 @node Pintar los objetos de blanco
3479 @unnumberedsubsubsec Pintar los objetos de blanco
3480 @translationof Painting objects white
3482 @cindex objetos, coloreado de
3483 @cindex coloreado de objetos
3485 @cindex impresión, orden de
3486 @cindex sobreescritura de objetos
3487 @cindex objetos, sobreescritura de
3488 @cindex grobs, sobreescritura de
3490 Todo objeto de presentación tiene una propiedad de color que de
3491 forma predeterminada está establecida a @code{black} (negro). Si
3492 se sobreescribe a @code{white} (blanco) el objeto será
3493 indistinguible del fondo blanco. Sin embargo, si el objeto cruza
3494 a otros objetos, el color de los puntos de cruce queda determinado
3495 por el orden en que se dibujan estos objetos, lo que puede dejar
3496 una imagen fantasma del objeto blanco, como puede verse aquí:
3498 @lilypond[quote,fragment,verbatim]
3499 \override Staff.Clef.color = #white
3503 Se puede evitar esto cambiando el orden de impresión de los
3504 objetos. Todos los objetos de presentación tienen una propiedad
3505 @code{layer} (capa) que se debe establecer a un valor entero. Los
3506 objetos con el valor de @code{layer} más bajo se dibujan primero,
3507 después se dibujan los objetos con valores progresivamente
3508 mayores, y así los objetos con valores más altos se dibujan encima
3509 de los que tienen valores más bajos. De forma predeterminada,
3510 casi todos los objetos tienen asignado un valor @code{layer} de
3511 @code{1}, aunque algunos objetos, entre ellos el pentagrama y las
3512 líneas divisorias, @code{StaffSymbol} y @code{BarLine}, tienen
3513 asignado un calor de @code{0}. El orden de impresión de los
3514 objetos con el mismo valor de @code{layer} es indeterminado.
3516 En el ejemplo de arriba, la clave blanca, con un valor
3517 @code{layer} predeterminado de @code{1}, se dibuja después de las
3518 líneas del pentagrama (valor @code{layer} predeterminado de
3519 @code{0}), sobreimpresionándolas. Para cambiarlo, se debe dar al
3520 objeto @code{Clef} un valor de @code{layer} más bajo, digamos
3521 @w{@code{-1}}, para que se dibuje antes:
3523 @lilypond[quote,fragment,verbatim]
3524 \override Staff.Clef.color = #white
3525 \override Staff.Clef.layer = #-1
3530 @node Uso de break-visibility (visibilidad en el salto)
3531 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
3532 @translationof Using break-visibility
3534 @c TODO Add making other objects breakable
3536 @cindex break-visibility
3538 Casi todos los objetos de presentación se imprimen una sola vez,
3539 pero algunos como las líneas divisorias, claves, indicaciones de
3540 compás y armaduras de tonalidad, se pueden tener que imprimir dos
3541 veces cuando se produce un salto de línea : una vez al final de la
3542 línea y otra al comienzo de la siguiente. Estos objetos reciben
3543 el nombre de @emph{divisibles}, y tienen una propiedad,
3544 @code{break-visibility} (visibilidad en el salto), para controlar
3545 su visibilidad en las tres posiciones en que pueden aparecer: al
3546 comienzo de una línea, dentro de la línea si se produce un cambio,
3547 y al final de la línea si el cambio se produce en ese lugar.
3549 Por ejemplo, la indicación de compás se imprime de forma
3550 predeterminada al comienzo de la primera línea y en ningún otro
3551 lugar a no ser que cambie, en cuyo caso se imprime en el punto en
3552 que se produce el cambio. Si este cambio se produce al final de
3553 una línea, la nueva indicación de compás se imprime al principio
3554 de la línea siguiente y también al final de la línea anterior como
3555 indicación de precaución.
3557 Este comportamiento se controla por medio de la propiedad
3558 @code{break-visibility}, que se explica en
3559 @c Leave this ref on a newline - formats incorrectly otherwise -td
3560 @rlearning{Visibilidad y color de los objetos}. Esta propiedad
3561 toma un vector de tres valores booleanos que, por orden,
3562 determinan si el objeto se imprime al final, dentro, o al
3563 principio de la línea. O, para ser más exactos: antes del salto
3564 de línea, si no hay salto, o después del salto.
3566 Como alternativa se puede especificar cualquiera de las ocho
3567 combinaciones mediante funciones predefinidas cuya definición está
3568 en @file{scm/output-lib.scm}, donde las tres últimas columnas
3569 indican si los objetos de presentación serán visibles en las
3570 posiciones que se muestran en el encabezamiento de cada columna:
3572 @multitable {@code{begin-of-line-invisible}} {@code{#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
3573 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
3574 @headitem de función @tab de vector @tab salto @tab salto @tab salto
3576 @item @code{all-visible} @tab @code{#(#t #t #t)} @tab sí @tab sí @tab sí
3577 @item @code{begin-of-line-visible} @tab @code{#(#f #f #t)} @tab no @tab no @tab sí
3578 @item @code{center-visible} @tab @code{#(#f #t #f)} @tab no @tab sí @tab no
3579 @item @code{end-of-line-visible} @tab @code{#(#t #f #f)} @tab sí @tab no @tab no
3580 @item @code{begin-of-line-invisible} @tab @code{#(#t #t #f)} @tab sí @tab sí @tab no
3581 @item @code{center-invisible} @tab @code{#(#t #f #t)} @tab sí @tab no @tab sí
3582 @item @code{end-of-line-invisible} @tab @code{#(#f #t #t)} @tab no @tab sí @tab sí
3583 @item @code{all-invisible} @tab @code{#(#f #f #f)} @tab no @tab no @tab no
3586 Los ajustes predeterminados de @code{break-visibility} dependen
3587 del objeto de presentación. La tabla siguiente muestra todos los
3588 objetos de presentación de interés que resultan afectados por
3589 @code{break-visibility} y el ajuste predeterminado de esta
3592 @multitable @columnfractions .3 .3 .4
3594 @headitem Objeto @tab Contexto usual @tab Valor predet.
3596 @c omit Ambitus as it appears not to be affected by break-visibility -td
3597 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
3598 @item @code{BarLine} @tab @code{Score} @tab calculado
3599 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
3600 @c omit the following item until it can be explained -td
3601 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
3602 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3603 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
3604 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
3605 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3606 @item @code{KeyCancellation} @tab @code{Staff} @tab @code{begin-of-line-invisible}
3607 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
3608 @c omit LeftEdge until it can be explained -td
3609 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
3610 @item @code{ClefModifier} @tab @code{Staff} @tab @code{begin-of-line-visible}
3611 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
3612 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
3616 El ejemplo de abajo muestra el uso de la forma de vector para
3617 controlar la visibilidad de las líneas divisorias:
3619 @lilypond[quote,verbatim,ragged-right]
3623 % Remove bar line at the end of the current line
3624 \once \override Score.BarLine.break-visibility = ##(#f #t #t)
3631 Aunque los tres componentes del vector utilizado para
3632 sobreescribir @code{break-visibility} deben estar presentes, no
3633 todos son efectivos para todos los objetos de presentación, y
3634 algunas combinaciones pueden incluso dar errores. Son de
3635 aplicación las siguientes limitaciones:
3639 Las líneas divisorias no se pueden imprimir al principio de la línea.
3642 No se puede imprimir el número de compás al principio de la
3643 @emph{primera} línea a no ser que su valor establecido sea
3644 distinto de @code{1}.
3646 @item Clave: véase la sección siguiente.
3649 Las repeticiones dobles de tipo porcentaje se imprimen todas
3650 siempre o bien no se imprimen nunca. Utilice @code{begin-of
3651 line-invisible} para imprimirlas y @code{all-invisible} para
3654 @item Armadura: véase la sección siguiente.
3656 @item ClefModifier: véase la sección siguiente.
3660 @node Consideraciones especiales
3661 @unnumberedsubsubsec Consideraciones especiales
3662 @translationof Special considerations
3664 @subsubsubheading Visibilidad después de un cambio explícito
3666 @cindex armadura, visibilidad después de un cambio explícito
3667 @cindex explicitKeySignatureVisibility
3668 @cindex clave, visibilidad después de un cambio explícito
3669 @cindex explicitClefVisibility
3671 La propiedad @code{break-visibility} controla la visibilidad de
3672 las armaduras y cambios de clave sólo al principio de las líneas,
3673 es decir, después de un salto. No tiene ningún efecto sobre la
3674 visibilidad de la armadura o la clave después de un cambio
3675 explícito de tonalidad o de clave dentro o al final de una línea.
3676 En el ejemplo siguiente la armadura que sigue al cambio explícito
3677 de tonalidad a Si bemol mayor es visible incluso con
3678 @code{all-invisible} establecido.
3680 @lilypond[quote,verbatim,ragged-right]
3684 % Try to remove all key signatures
3685 \override Staff.KeySignature.break-visibility = #all-invisible
3694 La visibilidad de estos cambios explícitos de tonalidad y de clave
3695 se controla por medio de las propiedades
3696 @code{explicitKeySignatureVisibility} y
3697 @code{explicitClefVisibility}. Son los equivalentes de la
3698 propiedad @code{break-visibility} y las dos toman un vector de
3699 tres valores booleanos o las funciones predefinidas relacionadas
3700 anteriormente, exactamente igual que @code{break-visibility}. Las
3701 dos son propiedades del contexto Staff, no de los propios objetos
3702 de presentación, y por tanto se establecen utilizando la
3703 instrucción @code{\set}. Las dos están establecidas de forma
3704 predeterminada al valor @code{all-visible}. Estas propiedades
3705 controlan sólo la visibilidad de las armaduras y las claves que
3706 resultan de los cambios explícitos y no afectan a las armaduras y
3707 tonalidades que están al principio de las líneas; para quitarlas,
3708 aún se debe sobreescribir la propiedad @code{break-visibility} en
3709 el objeto correspondiente.
3711 @lilypond[quote,verbatim,ragged-right]
3715 \set Staff.explicitKeySignatureVisibility = #all-invisible
3716 \override Staff.KeySignature.break-visibility = #all-invisible
3724 @subsubsubheading Visibilidad de las alteraciones de precaución
3726 Para eliminar las alteraciones de cancelación que se imprimen en
3727 un cambio de tonalidad explícito, establezca la propiedad
3728 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3730 @lilypond[quote,verbatim,ragged-right]
3734 \set Staff.explicitKeySignatureVisibility = #all-invisible
3735 \set Staff.printKeyCancellation = ##f
3736 \override Staff.KeySignature.break-visibility = #all-invisible
3744 Con estas sobreescrituras solamente permanecen las alteraciones
3745 accidentales delante de las notas para indicar el cambio de
3748 Observe que al modificar la tonalidad a Do@tie{}mayor o
3749 La@tie{}menor, las alteraciones de cancelación serían @emph{la
3750 única} indicación del cambio de armadura. En este caso, el
3751 establecimiento de @code{printKeyCancellation} al valor @code{#f}
3752 no tiene ningún efecto:
3754 @lilypond[quote,verbatim,ragged-right]
3758 \set Staff.explicitKeySignatureVisibility = #all-invisible
3759 \set Staff.printKeyCancellation = ##f
3767 En lugar de ello, para suprimir las alteraciones de cancelación
3768 aún cuando la armadura cambia a Do@tie{}mayor o a La@tie{}menor,
3769 sobreescriba la visibilidad del grob @code{KeyCancellation}:
3771 @lilypond[quote,verbatim,ragged-right]
3775 \set Staff.explicitKeySignatureVisibility = #all-invisible
3776 \override Staff.KeyCancellation.break-visibility = #all-invisible
3784 @c TODO Add visibility of cautionary accidentals before notes
3786 @subsubsubheading Líneas divisorias automáticas
3788 @cindex automaticBars
3789 @cindex líneas divisorias, eliminación
3791 Como caso especial, la impresión de las líneas divisorias también
3792 se puede inhabilitar estableciendo la propiedad
3793 @code{automaticBars} en el contexto Score. Si se fija a
3794 @code{#f}, las barras de compás no se imprimen automáticamente; se
3795 deben crear explícitamente con una instrucción @code{\bar}. A
3796 diferencia de la instrucción predefinida @code{\cadenzaOn}, los
3797 compases se siguen contando. La generación de compases continúa
3798 de acuerdo a esta cuenta si esta propiedad se establece
3799 posteriormente a @code{#t}. Si se fija al valor @code{#f}, sólo
3800 pueden producirse saltos de línea en instrucciones @code{\bar}
3805 @subsubsubheading Claves transportadas
3807 @cindex transportadas, visibilidad de las claves
3808 @cindex visibilidad de las claves transportadas
3809 @cindex claves, visibilidad de la transposición
3811 El pequeño símbolo de transposición sobre una clave se produce por
3812 parte del objeto @code{ClefModifier}. Su visibilidad se hereda
3813 automáticamente de la del objeto @code{Clef}, así que no es
3814 necesario aplicar las sobreescrituras correspondientes
3815 @code{break-visibility} a los objetos @code{ClefModifier} para
3816 suprimir los símbolos de transposición u octavación para las
3819 Para los cambios de clave explícitos, la propiedad
3820 @code{explicitClefVisibility} controla tanto el símbolo de clave
3821 como el símbolo de transposición o de octava asociado.
3824 Manual de aprendizaje:
3825 @rlearning{Visibilidad y color de los objetos}
3828 @node Estilos de línea
3829 @subsection Estilos de línea
3830 @translationof Line styles
3832 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3833 @i{accelerando} y los @i{trinos} se escriben como texto y se
3834 extienden sobre muchos compases mediante líneas, a veces punteadas
3837 Todos ellos usan las mismas rutinas que el glissando para dibujar
3838 los textos y las líneas, y por ello el ajuste fino de su
3839 comportamiento se hace de la misma manera. Se hace con un spanner
3840 (un objeto de extensión), y la rutina responsable de dibujar los
3841 objetos de extensión es @code{ly:line-spanner::print}. Esta rutina
3842 determina la colocación exacta de los dos @i{extremos del objeto
3843 de extensión} y dibuja una línea entre ellos, en el estilo
3846 He aquí un ejemplo de los distintos estilos de línea disponibles,
3847 y cómo aplicarles ajustes finos.
3849 @lilypond[ragged-right,verbatim,quote]
3852 \once \override Glissando.style = #'dashed-line
3854 \override Glissando.style = #'dotted-line
3856 \override Glissando.style = #'zigzag
3858 \override Glissando.style = #'trill
3863 Las posiciones de los puntos extremos del objeto de extensión se
3864 computan al vuelo para cada uno de los objetos gráficos, pero es
3865 posible sobreescribirlos:
3868 @lilypond[ragged-right,verbatim,quote]
3871 \once \override Glissando.bound-details.right.Y = #-2
3876 El valor de @code{Y} está establecido a @w{@code{-2}} para el
3877 extremo derecho. El lado izquierdo se puede ajustar de forma
3878 similar especificando @code{left} en vez de @code{right}.
3880 Si no está establecido @code{Y}, el valor se computa a partir de la
3881 posición vertical de los puntos de anclaje izquierdo y derecho del
3884 Son posibles otros ajustes de los extensores, para ver más
3885 detalles consulte @ref{Objetos de extensión}.
3888 @node Rotación de objetos
3889 @subsection Rotación de objetos
3890 @translationof Rotating objects
3892 Tanto los objetos de presentación como los elementos de texto de
3893 marcado se pueden girar cualquier ángulo respecto a cualquier
3894 punto, pero difiere el método de hacerlo.
3897 * Rotación de objetos de presentación::
3898 * Rotación de elementos de marcado::
3901 @node Rotación de objetos de presentación
3902 @unnumberedsubsubsec Rotación de objetos de presentación
3903 @translationof Rotating layout objects
3905 @cindex rotating objects
3906 @cindex objects, rotating
3908 Todos los objetos de presentación que contemplan el interface
3909 @code{grob-interface} se pueden rotar estableciendo su propiedad
3910 @code{rotation}. Acepta una lista de tres elementos: el ángulo de
3911 la rotación en sentido antihorario, y las coordenadas x e y del
3912 punto con relación al punto de referencia del objeto, alrededor
3913 del que se va a realizar la rotación. El ángulo de rotación se
3914 especifica en grados y las coordenadas en espacios de pentagrama.
3916 El ángulo de rotación y las coordenadas del punto de rotación se
3917 deben determinar por ensayo y error.
3919 @cindex reguladores en ángulo
3920 @cindex ángulo, reguladores en
3922 Solamente en ciertas ocasiones es útil la rotación de objetos de
3923 presentación; el ejemplo siguiente muestra una situación en que
3926 @lilypond[quote,fragment,verbatim]
3928 \override Hairpin.rotation = #'(20 -1 0)
3933 @node Rotación de elementos de marcado
3934 @unnumberedsubsubsec Rotación de elementos de marcado
3935 @translationof Rotating markup
3937 Todos los textos de marcado se pueden rotar para que se dispongan
3938 en cualquier ángulo precediéndolos de la instrucción
3939 @code{\rotate}. La instrucción acepta dos argumentos: el ángulo
3940 de rotación en grados en sentido antihorario, y el texto que
3941 rotar. Los límites que ocupa el texto no se rotan: toman su valor
3942 a partir de los extremos de las coordenadas x e y del texto
3943 rotado. En el ejemplo siguiente la propiedad
3944 @code{outside-staff-priority} del texto se establece a @code{#f}
3945 para desactivar la evitación automática de colisiones, lo que
3946 empuja al texto a una posición muy alta.
3948 @lilypond[quote,fragment,verbatim]
3949 \override TextScript.outside-staff-priority = ##f
3950 g4^\markup { \rotate #30 "a G" }
3951 b^\markup { \rotate #30 "a B" }
3952 des'^\markup { \rotate #30 "a D-Flat" }
3953 fis'^\markup { \rotate #30 "an F-Sharp" }
3957 @node Trucos avanzados
3958 @section Trucos avanzados
3959 @translationof Advanced tweaks
3961 Esta sección trata sobre distintos enfoques en la realización de
3962 ajustes finos a la apariencia de la partitura impresa.
3965 * Alineación de objetos::
3966 * Agrupación vertical de objetos gráficos::
3967 * Modificación de los sellos::
3968 * Modificación de las formas::
3969 * Modificación de objetos de extensión divididos::
3970 * Contenedores unpure-pure::
3974 Manual de aprendizaje:
3975 @rlearning{Trucar la salida},
3976 @rlearning{Otras fuentes de información}.
3978 Referencia de la notación:
3979 @ref{Explicación del Manual de referencia de funcionamiento interno},
3980 @ref{Modificar las propiedades}.
3982 Manual de extensión:
3983 @rextend{Interfaces para programadores}.
3986 @file{scm/define-grobs.scm}.
3988 Fragmentos de código:
3989 @rlsr{Tweaks and overrides}.
3991 Referencia de funcionamiento interno:
3992 @rinternals{All layout objects}.
3995 @node Alineación de objetos
3996 @subsection Alineación de objetos
3997 @translationof Aligning objects
3999 Los objetos gráficos que soportan el interface
4000 @code{self-alignment-interface} y/o el
4001 @code{side-position-interface} se pueden alinear contra un objeto
4002 colocado previamente, de diversas maneras. Para ver una lista de
4003 estos objetos, consulte @rinternals{self-alignment-interface} y
4004 @rinternals{side-position-interface}.
4006 Todos los objetos gráficos tienen un punto de referencia, una
4007 extensión horizontal y una extensión vertical. La extensión
4008 horizontal es una pareja de números que dan los desplazamientos a
4009 partir del punto de referencia de los bordes izquierdo y derecho,
4010 siendo negativos los desplazamientos hacia la izquierda. La
4011 extensión vertical es una pareja de números que dan el
4012 desplazamiento a partir del punto de referencia hasta los bordes
4013 inferior y superior, siendo negativos los desplazamientos hacia
4016 La posición de un objeto sobre el pentagrama viene dada por los
4017 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
4018 valor de @code{X-offset} da el desplazamiento desde la coordenada
4019 X del punto de referencia del objeto padre, y el valor de
4020 @code{Y-offset} da el desplazamiento a partir de la línea central
4021 del pentagrama. Los valores de @code{X-offset} y @code{Y-offset}
4022 se pueden establecer directamente o se puede dejar que se calculen
4023 por parte de procedimientos para conseguir una alineación con el
4026 @warning{Muchos objetos tienen consideraciones de posicionamiento
4027 especiales que hacen que se ignore o se modifique cualquier ajuste
4028 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
4029 objeto contemple el interface @code{self-alignment-interface}. La
4030 sobreescritura de las propiedades @code{X-offset} ó
4031 @code{Y-offset} a un valor fijo hace que se descarte la respectiva
4032 propiedad @code{self-alignment}.}
4034 Por ejemplo, una alteración accidental se puede reposicionar
4035 verticalmente estableciendo @code{Y-offset} pero los cambios a
4036 @code{X-offset} no tienen ningún efecto.
4038 Las letras de ensayo se pueden alinear con objetos divisibles como
4039 líneas divisorias, claves, armaduras e indicaciones de compás.
4040 Hay propiedades especiales que se encuentran en
4041 @code{break-aligned-interface} para el posicionamiento de las
4042 letras de ensayo sobre dichos objetos.
4045 Referencia de la notación:
4046 @ref{Uso del break-alignable-interface}.
4048 Manual de extensión:
4049 @rextend{Funciones de callback}.
4052 * Establecer directamente X-offset e Y-offset::
4053 * Uso del side-position-interface::
4054 * Uso del self-alignment-interface::
4055 * Uso del break-alignable-interface::
4059 @node Establecer directamente X-offset e Y-offset
4060 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
4061 @translationof Setting X-offset and Y-offset directly
4063 Se pueden dar valores numéricos a las propiedades @code{X-offset}
4064 y @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra
4065 tres notas con una digitación en su posición predeterminada y con
4066 los valores @code{X-offset} y @code{Y-offset} modificados.
4068 @lilypond[verbatim,fragment,quote]
4075 -\tweak X-offset #-1
4083 @node Uso del side-position-interface
4084 @unnumberedsubsubsec Uso del @code{side-position-interface}
4085 @translationof Using the side-position-interface
4087 Un objeto que contempla el @code{side-position-interface} se puede
4088 colocar junto a su objeto padre de forma que los bordes
4089 especificados de los dos objetos se toquen. El objeto se puede
4090 situar encima, debajo, a la derecha o a la izquierda del objeto
4091 padre. El padre no se puede especificar; viene determinado por el
4092 orden de los elementos en el flujo de entrada. Casi todos los
4093 objetos tienen la cabeza de la nota asociada como padre.
4095 Los valores de las propiedades @code{side-axis} y @code{direction}
4096 determinan dónde colocar el objeto, como sigue:
4098 @c TODO add an example of each to the table
4100 @multitable @columnfractions .3 .3 .3
4101 @headitem @code{side-axis} @tab @code{direction} @tab
4102 @headitem propiedad @tab propiedad @tab colocación
4104 @item @code{0} @tab @w{@code{-1}} @tab izquierda
4105 @item @code{0} @tab @code{1} @tab derecha
4106 @item @code{1} @tab @w{@code{-1}} @tab debajo
4107 @item @code{1} @tab @code{1} @tab encima
4111 Si @code{side-axis} es @code{0}, @code{X-offset} se debe
4112 establecer al procedimiento
4113 @code{ly:side-position-interface::x-aligned-side}. Este
4114 procedimiento devuelve el calor correcto de @code{X-offset} para
4115 situar el objeto al lado izquierdo o derecho del padre de acuerdo
4116 con el valor de @code{direction}.
4118 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe
4119 establecer al procedimiento
4120 @code{ly:side-position-interface::y-aligned-side}. Este
4121 procedimiento devuelve el valor correcto de @code{Y-offset} para
4122 situar el objeto encima o debajo del padre de acuerdo con el valor
4123 de @code{direction}.
4125 @c TODO Add examples
4128 @node Uso del self-alignment-interface
4129 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
4130 @translationof Using the self-alignment-interface
4132 @subsubsubheading Auto-alineación horizontal de los objetos
4134 La alineación horizontal de un objeto que contempla el interface
4135 @code{self-alignment-interface} está controlada por el valor de la
4136 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
4137 @code{X-offset} de este objeto esté establecida a
4138 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le
4139 puede dar a @code{self-alignment-X} cualquier valor real, en
4140 unidades de la mitad de la extensión X total del objeto. Los
4141 valores negativos mueven el objeto a la derecha, los positivos
4142 hacia la izquierda. Un valor de @code{0} centra el objeto sobre
4143 el punto de referencia de su padre, un valor de @w{@code{-1}}
4144 alinea el borde izquierdo del objeto sobre el punto de referencia
4145 de su padre, y un valor de @code{1} alinea el borde derecho del
4146 objeto sobre el punto de referencia de su padre. Se pueden usar
4147 los símbolos @code{LEFT}, @code{CENTER} y @code{RIGHT} en
4148 sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
4151 Normalmente se usaría la instrucción @code{\override} para
4152 modificar el valor de @code{self-alignment-X}, pero se puede usar
4153 la instrucción @code{\tweak} para alinear varias anotaciones por
4154 separado sobre una sola nota:
4156 @lilypond[quote,verbatim,fragment]
4158 -\tweak self-alignment-X #-1
4160 -\tweak self-alignment-X #0
4162 -\tweak self-alignment-X #RIGHT
4164 -\tweak self-alignment-X #-2.5
4165 ^"aligned further to the right"
4168 @subsubsubheading Auto-alineación vertical de los objetos
4170 Los objetos se pueden alinear verticalmente en una forma análoga a la
4171 alineación horizontal si la propiedad @code{Y-offset} está establecida
4172 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
4173 a menudo se encuentran implicados otros mecanismos en la alineación
4174 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
4175 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
4176 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
4177 las dimensiones verticales del objeto, que suele ser bastante pequeño,
4178 por lo que pueden requerirse números bastante grandes. Un valor de
4179 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
4180 referencia del objeto padre, un valor de @code{0} alinea el centro del
4181 objeto con el punto de referencia del padre, y un valor de @code{1}
4182 alinea el borde superior del objeto con el punto de referencia del
4183 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
4184 @code{UP} en sustitución de @w{@code{-1}},
4185 @code{0} y @code{1}, respectivamente.
4187 @emph{Auto-alineación de objetos en las dos direcciones}
4189 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
4190 alinear un objeto en las dos direcciones simultáneamente.
4192 El ejemplo siguiente muestra cómo ajustar una digitación de forma
4193 que se acerque a la cabeza dela nota.
4195 @lilypond[quote,verbatim,fragment]
4197 -\tweak self-alignment-X #0.5 % move horizontally left
4198 -\tweak Y-offset #ly:self-alignment-interface::y-aligned-on-self
4199 -\tweak self-alignment-Y #-1 % move vertically up
4204 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
4206 @c Cannot document as they do not seem to operate consistently on all objects -td
4207 @c TODO investigate further
4209 The @code{aligned-on-parent} procedures are used in the same way
4210 as the @code{aligned-on-self} procedures, they difference being
4211 that they permit an object to be aligned with the @emph{edges} of
4212 the parent rather than the parent's reference point. The following
4213 example shows the difference:
4217 @lilypond[verbatim,quote]
4223 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
4225 @c Cannot document as they do not seem to operate consistently on all objects -td
4226 @c TODO investigate further
4230 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
4233 @node Uso del break-alignable-interface
4234 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
4235 @translationof Using the break-alignable-interface
4237 @cindex alineación a objetos
4238 @cindex break-align-symbols
4240 Las letras de ensayo se pueden alinear con objetos de notación
4241 distintos a las barras de compás. Estos objetos son
4242 @code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
4243 @code{staff-bar}, @code{left-edge}, @code{key-cancellation},
4244 @code{key-signature} y @code{time-signature}.
4246 Cada tipo de objeto tiene su propio punto de referencia
4247 predeterminado, con el que se alinean las marcas de ensayo:
4249 @lilypond[verbatim,quote,fragment]
4250 % The rehearsal mark will be aligned to the right edge of the Clef
4251 \override Score.RehearsalMark.break-align-symbols = #'(clef)
4256 % The rehearsal mark will be aligned to the left edge of the Time Signature
4257 \override Score.RehearsalMark.break-align-symbols = #'(time-signature)
4263 % The rehearsal mark will be centered above the Breath Mark
4264 \override Score.RehearsalMark.break-align-symbols = #'(breathing-sign)
4273 Se puede especificar una lista de posibles objetos para la
4274 alineación. Si algunos de los objetos son invisibles en ese punto
4275 debido al valor de @code{break-visibility} o a valores de
4276 visibilidad explícitos para las armaduras y las claves, la letra
4277 de ensayo o número de compás se alinean con el primer objeto de la
4278 lista que sea visible. Si ningún objeto de la lista es visible,
4279 el objeto se alinea con la línea divisoria. Si la línea divisoria
4280 es invisible, el objeto se alinea con el punto en el que se
4281 encontraría la línea divisoria.
4283 @lilypond[verbatim,quote,fragment]
4284 % The rehearsal mark will be aligned to the right edge of the Key Signature
4285 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4290 % The rehearsal mark will be aligned to the right edge of the Clef
4291 \set Staff.explicitKeySignatureVisibility = #all-invisible
4292 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4297 % The rehearsal mark will be centered above the Bar Line
4298 \set Staff.explicitKeySignatureVisibility = #all-invisible
4299 \set Staff.explicitClefVisibility = #all-invisible
4300 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4307 La alineación de la letra de ensayo con relación al objeto de
4308 notación se puede cambiar, como se ve en el ejemplo siguiente. En
4309 una partitura con varios pentagramas, este ajuste se debe hacer
4310 para todos los pentagramas.
4312 @lilypond[verbatim,quote,fragment]
4313 % The RehearsalMark will be aligned with the right edge of the Key Signature
4314 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4320 % The RehearsalMark will be centered above the Key Signature
4321 \once \override Score.KeySignature.break-align-anchor-alignment = #CENTER
4325 % The RehearsalMark will be aligned with the left edge of the Key Signature
4326 \once \override Score.KeySignature.break-align-anchor-alignment = #LEFT
4332 La letra de ensayo también se puede desplazar al borde derecho o
4333 izquierdo en una medida arbitraria. Las unidades son espacios de
4336 @lilypond[verbatim,quote,fragment]
4337 % The RehearsalMark will be aligned with the left edge of the Key Signature
4338 % and then shifted right by 3.5 staff-spaces
4339 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4340 \once \override Score.KeySignature.break-align-anchor = #3.5
4344 % The RehearsalMark will be aligned with the left edge of the Key Signature
4345 % and then shifted left by 2 staff-spaces
4346 \once \override Score.KeySignature.break-align-anchor = #-2
4353 @node Agrupación vertical de objetos gráficos
4354 @subsection Agrupación vertical de objetos gráficos
4355 @translationof Vertical grouping of grobs
4357 @c TODO Expand this section
4359 Los grobs (objetos gráficos) @code{VerticalAlignment} y
4360 @code{VerticalAxisGroup} trabajan de manera coordinada.
4361 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
4362 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
4363 distintos grobs agrupados previamente por
4364 @code{VerticalAxisGroup}. Normalmente sólo existe un
4365 @code{VerticalAlignment} por cada partitura, pero cada
4366 @code{Staff}, @code{Lyrics}, etc. tiene su propio
4367 @code{VerticalAxisGroup}.
4370 @node Modificación de los sellos
4371 @subsection Modificación de los sellos
4372 @translationof Modifying stencils
4374 Todos los objetos de presentación tienen una propiedad
4375 @code{stencil} que es parte del @code{grob-interface}. De forma
4376 predeterminada, esta propiedad suele estar establecida a una
4377 función específica del objeto que está hecha a medida para
4378 disponer el símbolo que lo representa en la salida. Por ejemplo,
4379 el ajuste estándar para la propiedad @code{stencil} del objeto
4380 @code{MultiMeasureRest} es @code{ly:multi-measure-rest::print}.
4382 El símbolo estándar de cualquier objeto se puede sustituir
4383 modificando la propiedad @code{stencil} para que haga referencia a
4384 un procedimiento diferente escrito especialmente. Esto requiere
4385 un alto nivel de conocimiento del funcionamiento interno de
4386 LilyPond, pero hay una forma más fácil que a menudo puede dar
4387 resultados adecuados.
4389 El procedimiento es establecer la propiedad @code{stencil} al
4390 procedimiento que imprime texto (@code{ly:text-interface::print})
4391 y añadir una propiedad @code{text} al objeto ajustada para que
4392 contenga el texto de marcado que produce el símbolo requerido.
4393 Debido a la flexibilidad del marcado, se pueden conseguir muchas
4394 cosas; en particular, consulte @ref{Notación gráfica dentro de
4395 elementos de marcado}.
4397 El ejemplo siguiente muestra esto cambiando el símbolo de la
4398 cabeza de la nota a unas aspas dentro de una circunferencia.
4400 @lilypond[verbatim,quote]
4402 \once \override NoteHead.stencil = #ly:text-interface::print
4403 \once \override NoteHead.text = \markup {
4405 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
4406 \musicglyph #"noteheads.s2cross"
4414 Cualquiera de los glifos de la fuente tipográfica Feta se puede
4415 pasar a la instrucción de marcado @code{\musicglyph}: véase
4416 @ref{La tipografía Feta}.
4418 Se pueden insertar en línea tanto imágenes en formato @file{EPS}
4419 como instrucciones de Postscript usando las instrucciones de
4420 marcado @code{\epsfile} y @code{\postscript} respectivamente;
4421 véase @ref{Graphic}.
4425 Referencia de la notación:
4426 @ref{Notación gráfica dentro de elementos de marcado},
4427 @ref{Formatear el texto},
4428 @ref{Text markup commands},
4429 @ref{La tipografía Feta},
4433 @node Modificación de las formas
4434 @subsection Modificación de las formas
4435 @translationof Modifying shapes
4438 * Modificación de ligaduras de unión y de expresión::
4442 @node Modificación de ligaduras de unión y de expresión
4443 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
4444 @translationof Modifying ties and slurs
4446 @cindex ligaduras de expresión, modificar
4447 @cindex ligaduras de unión, modificar
4448 @cindex Bézier, curvas de, puntos de control
4449 @cindex puntos de control en curvas de Bézier
4451 Las ligaduras de unión (@code{Tie}s), de expresión (@code{Slur}s),
4452 de fraseo (@code{PhrasingSlur}s), de dejar vibrar
4453 (@code{LaissezVibrerTie}s) y de repetición (@code{RepeatTie}s) se
4454 trazan como curvas de Bézier de tercer orden. Si la forma de la
4455 ligadura calculada automáticamente no resulta óptima, se puede
4456 modificar su forma manualmente de dos formas:
4460 mediante la especificación de los desplazamientos que se quieren
4461 realizar sobre los puntos de control de la curva de Bézier
4462 calculada automáticamente, o bien
4465 mediante la especificación explícita de las posiciones de los
4466 cuatro puntos de control que se requieren para definir la curva
4470 A continuación se explican ambos métodos. El primer método es más
4471 adecuado cuando solo se requieren ligeros ajustes de la curva; el
4472 segundo puede ser mejor para crear curvas que tienen relación con
4475 @subsubsubheading Curvas de Bézier cúbicas
4477 Las curvas Bézier de tercer orden o cúbicas están definidas por
4478 cuatro puntos de control. El primer y cuarto puntos de control
4479 son exactamente los puntos extremos de comienzo y de final de la
4480 curva. Los dos puntos de control intermedios definen la forma.
4481 Se pueden encontrar en la web animaciones que muestran cómo se
4482 traza la curva, pero la descripción siguiente puede ser de ayuda.
4483 La curva comienza a partir del primer punto de control
4484 dirigiéndose directamente hacia el segundo, curvándose
4485 progresivamente para dirigirse hacia el tercero y continuando la
4486 curva hacia el cuarto, llegando a éste en viaje directo desde el
4487 tercer punto de control. La curva está contenida enteramente
4488 dentro del cuadrilátero definido por los cuatro puntos de control.
4489 Todas las traslaciones, rotaciones y escalado de los puntos de
4490 control producen exactamente las mismas operaciones sobre la
4493 @subsubsubheading Especificar desplazamientos a partir de los puntos de control actuales
4495 @cindex conformar ligaduras
4498 En este ejemplo, la colocación automática de la ligadura no
4499 resulta óptima, y @code{\tieDown} no es la solución.
4501 @lilypond[verbatim,quote]
4505 \relative { r4 <g' c,> <g c,> <g c,> }
4509 El ajuste de los puntos de control de la ligadura mediante la
4510 instrucción @code{\shape} permite evitar las colisiones.
4512 La sintaxis de @code{\shape} es:
4515 [-]\shape @var{desplazamientos} @var{elemento}
4518 Esta instrucción recoloca los puntos de control de @var{elemento}
4519 en las cantidades dadas por @var{desplazamientos}. El argumento
4520 @var{desplazamientos} es una lista de parejas de números o una
4521 lista de tales listas. Cada elemento de una pareja representa el
4522 desplazamiento de una de las coordenadas de un punto de control.
4523 Si el @var{elemento} es una cadena de caracteres, el resultado es
4524 @code{\once\override} para el tipo de grob especificado. Si
4525 @var{elemento} es una expresión musical, el resultado es la misma
4526 expresión musical con la consiguiente modificación aplicada.
4528 En otras palabras, la función @code{\shape} puede actuar como una
4529 instrucción @code{\once\override} o como una instrucción
4530 @code{\tweak} dependiendo de si el argumento @var{elemento} es el
4531 nombre de un grob, como @qq{Slur}, o una expresión musical, como
4532 @qq{(}. El argumento @var{desplazamientos} especifica los
4533 desplazamientos de los cuatro puntos de control como una lista de
4534 cuatro parejas de valores (dx . dy) en unidades de espacios de
4535 pentagrama (o una lista de tales listas si la curva tiene más de
4538 El guión precedente se exige si, y sólo si, se usa la forma
4541 Así, usando el mismo ejemplo de arriba y la forma
4542 @code{\once\override} de la instrucción @code{\shape}, lo
4543 siguiente tiene el efecto de elevar la ligadura de unión en la
4544 mitad de un espacio de pentagrama:
4546 @lilypond[verbatim,quote]
4549 \shape #'((0 . 0.5) (0 . 0.5) (0 . 0.5) (0 . 0.5)) Tie
4553 \relative { r4 <g' c,> <g c,> <g c,> }
4557 Este posicionamiento de la ligadura de unión es mejor, pero quizá
4558 debería elevarse más en la parte central. El ejemplo siguiente
4559 hace esto, esta vez usando la forma alternativa @code{\tweak}:
4561 @lilypond[verbatim,quote]
4564 e'1-\shape #'((0 . 0.5) (0 . 1) (0 . 1) (0 . 0.5)) ~ e'
4567 \relative { r4 <g' c,> <g c,> <g c,> }
4571 Los cambios en las posiciones horizontales de los puntos de
4572 control se pueden hacer de la misma forma, y dos curvas distintas
4573 que dan comienzo en el mismo momento musical se pueden conformar
4576 @lilypond[verbatim,quote,ragged-right]
4578 c''8(\( a) a'4 e c\)
4579 \shape #'((0.7 . -0.4) (0.5 . -0.4) (0.3 . -0.3) (0 . -0.2)) Slur
4580 \shape #'((0 . 0) (0 . 0.5) (0 . 0.5) (0 . 0)) PhrasingSlur
4585 La función @code{\shape} también puede desplazar los puntos de
4586 control de las curvas que se extienden atravesando saltos de
4587 línea. Cada pieza de la curva dividida puede recibir su propia
4588 lista de desplazamientos. Si no se necesita hacer cambios a uno
4589 de los segmentos en particular, se puede usar una lista vacía como
4590 contenedor. En este ejemplo, el salto de línea hace que la única
4591 ligadura de expresión aparezca como si fueran dos:
4593 @lilypond[verbatim,quote,ragged-right]
4601 Los cambios en la forma de las dos mitades de la ligadura de
4602 expresión deja más claro que la ligadura continúa más allá del
4605 @lilypond[verbatim,quote,ragged-right]
4606 % () may be used as a shorthand for ((0 . 0) (0 . 0) (0 . 0) (0 . 0))
4607 % if any of the segments does not need to be changed
4610 (( 0 . 0) (0 . 0) (0 . 0) (0 . 1))
4611 ((0.5 . 1.5) (1 . 0) (0 . 0) (0 . -1.5))
4619 En una curva en forma de «S» siempre es necesario ajustar
4620 manualmente los puntos de control: LilyPond nunca escoge tales
4621 formas automáticamente.
4623 @lilypond[verbatim,quote]
4625 c8( e b-> f d' a e-> g)
4626 \shape #'((0 . -1) (5.5 . -0.5) (-5.5 . -10.5) (0 . -5.5)) PhrasingSlur
4627 c8\( e b-> f d' a e-> g\)
4631 @subsubsubheading Especificar los puntos de control explícitamente
4633 Las coordenadas de los puntos de contro de Bézier se especifican
4634 en unidades de espacios de pentagrama. La coordenada@tie{}X es
4635 relativa al punto de referencia al que se adjunta la ligadura, y
4636 la coordenada@tie{}Y es relativa a la línea central del
4637 pentagrama. Las coordenadas se especifican como una lista de
4638 cuatro parejas de números decimales (reales). Un enfoque consiste
4639 en estimar las coordenadas de los dos extremos, y después adivinar
4640 los dos puntos intermedios. Los valores óptimos se encuentran
4641 después por ensayo y error. Tenga en cuenta que estos valores
4642 podrían requerir un ajuste manual si se hace posteriormente
4643 cualquier cambio manual a la música o a la disposición.
4645 Una situación en la que es preferible especificar los puntos de
4646 control explícitamente a especificar los desplazamientos es cuando
4647 se necesita especificarlos de forma relativa a una nota única. A
4648 continuación presentamos un ejemplo de esto. Muestra una forma de
4649 indicar una ligadura que se extiende hacia el interior de las
4650 casillas de primera y segunda vez de una repetición.
4652 @lilypond[verbatim,quote]
4655 \repeat volta 3 { c4 d( e f }
4660 % create a slur and move it to a new position
4661 % the <> is just an empty chord to carry the slur termination
4662 -\tweak control-points #'((-2 . 3.8) (-1 . 3.9) (0 . 4) (1 . 3.4)) ( <> )
4667 % create a slur and move it to a new position
4668 -\tweak control-points #'((-2 . 3) (-1 . 3.1) (0 . 3.2) (1 . 2.4)) ( <> )
4676 No es posible modificar la forma de las ligaduras de unión o de
4677 expresión cambiando la propiedad @code{control-points} si hay más
4678 de una en el mismo momento musical, ni siquiera usando la
4679 instrucción @code{\tweak}. Sin embargo, se puede sobreescribir la
4680 propiedad @code{tie-configuration} de @code{TieColumn} para fijar
4681 la línea de inicio y la dirección según se requiera.
4684 Referencia de funcionamiento interno:
4685 @rinternals{TieColumn}.
4688 @node Modificación de objetos de extensión divididos
4689 @subsection Modificación de objetos de extensión divididos
4690 @translationof Modifying broken spanners
4693 * Uso de alterBroken::
4696 @node Uso de alterBroken
4697 @unnumberedsubsubsec Uso de @code{\alterBroken}
4698 @translationof Using alterBroken
4700 @cindex extensión, modificación de objetos de
4701 @cindex divididos, modificación de objetos de extensión
4702 @funindex \alterBroken
4704 Cuando un @qq{spanner} u objeto extenso atraviesa uno o varios
4705 saltos de línea, cada fragmento hereda los atributos del objeto de
4706 extensión original. Así, el trucado ordinario de un objeto
4707 dividido aplica las mismas modificaciones a todos y cada uno de
4708 sus segmentos. En el ejemplo que aparece a continuación, la
4709 sobreescritura de @code{thickness} (grosor) afecta a la ligadura a
4710 ambos lados del salto de línea.
4712 @lilypond[verbatim,quote,ragged-right]
4715 \once\override Slur.thickness = 10
4722 Es posible modificar de forma independiente el aspecto de los
4723 fragmentos individuales de un objeto de extensión dividido, con la
4724 instrucción @code{\alterBroken}. Esta instrucción puede producir
4725 un @code{\override} o bien un @code{\tweak} de una propiedad del
4726 objeto de extensión.
4728 La sintaxis de @code{\alterBroken} es
4731 [-]\alterBroken @var{propiedad} @var{valores} @var{elemento}
4734 El argumento @var{valores} es una lista de valores, uno por cada
4735 fragmento. Si @var{elemento} el el nombre de un grob como
4736 @code{Slur} o @code{Staff.PianoPedalBracket}, el resultado es una
4737 instrucción de sobreescritura @code{\override} del tipo de grob
4738 especificado. Si @var{elemento} es una expresión musical como
4739 @qq{(} o @qq{[} el resultado es la misma expresión musical con el
4740 correspondiente truco aplicado.
4742 El guión inicial se debe utilizar con la forma de trucaje,
4743 @code{\tweak}. No lo escriba cuando utilice @code{\alterBroken}
4744 como una operación de sobreescritura, @code{\override}.
4746 En su uso como @code{\override}, @code{\alterBroken} puede ir
4747 precedido de @code{\once} o @code{\temporary} y ser revertido con
4748 @code{\revert} con el argumento @var{propiedad}.
4750 EL código siguiente aplica un @code{\override} independiente a
4751 cada uno de los fragmentos de la ligadura del ejemplo anterior:
4753 @lilypond[verbatim,quote,ragged-right]
4756 \alterBroken thickness #'(10 1) Slur
4763 La instrucción @code{\alterBroken} se puede usar con cualquier
4764 objeto de extensión, incluidos @code{Tie}, @code{PhrasingSlur},
4765 @code{Beam} y @code{TextSpanner}. Por ejemplo, un editor que está
4766 preparando una edición académica podría desear indicar la ausencia
4767 de parte de una ligadura de fraseo en una fuente haciendo
4768 discontinuo solamente el segmento que se ha añadido. El siguiente
4769 ejemplo ilustra de qué manera se puede hacer esto, en este caso
4770 usando la forma @code{\tweak} de la instrucción:
4772 @lilypond[verbatim,quote,ragged-right]
4773 % The empty list is conveniently used below, because it is the
4774 % default setting of dash-definition, resulting in a solid curve.
4776 c''2-\alterBroken dash-definition #'(() ((0 1.0 0.4 0.75))) \(e
4782 Es importante comprender que @code{\alterBroken} fija cada pieza
4783 del objeto fragmentado al valor correspondiente dentro del
4784 argumento @var{valores}. Cuando hay menos valores que piezas,
4785 cualquier fragmento adicional recibe la asignación de la lista
4786 vacía. Esto puede conllevar resultados no deseados si la
4787 propiedad de disposición no está establecida a la lista vacía de
4788 forma predeterminada. En estos casos, se debe asignar a cada
4789 segmento un valor adecuado.
4792 Los saltos de línea pueden ocurrir en distintos lugares según
4793 cambia la disposición de la música. Los ajustes elegidos para
4794 @code{\alterBroken} podrían no ser adecuados para un objeto de
4795 extensión que ya no está dividido o que se fragmenta en más piezas
4796 que antes. El uso explícito (manual) de saltos de línea mediante
4797 @code{\break} puede prevenir situaciones como ésta.
4799 La instrucción @code{\alterBroken} no es efectiva para propiedades
4800 de los objetos extensos accedidas antes del salto de línea, como
4805 @rextend{Trucos difíciles}.
4808 @node Contenedores unpure-pure
4809 @subsection Contenedores unpure-pure
4810 @translationof Unpure-pure containers
4812 @cindex Scheme, contenedores puros
4813 @cindex Scheme, contenedores no-puros
4814 @cindex puros, contenedores de Scheme
4815 @cindex no-puros: contenedores de Scheme
4816 @cindex horizontal, sobreescribir el espaciado
4818 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para
4819 la sobreescritura de los cálculos del espaciado en el @emph{eje Y}
4820 (concretamente @code{Y-offset} e @code{Y-extent}) con una función
4821 de Scheme en lugar de un literal, es decir, un número o una pareja
4824 Para ciertos objetos gráficos, las dimensiones @code{Y-extent}
4825 están basadas en la propiedad @code{stencil}, la sobreescritura de
4826 la propiedad de sello de éstos requiere una sobreescritura
4827 adicional de @code{Y-extent} con un contenedor unpure-pure.
4828 Cuando una función sobreescribe una dimensión @code{Y-offset} y/o
4829 @code{Y-extent} se supone que esto dispara los cálculos de los
4830 saltos de línea prematuramente durante la compilación. Así pues,
4831 la función no se evalúa en absoluto (devolviendo por lo general un
4832 valor de @samp{0} o @samp{'(0 . 0)}) lo que puede dar lugar a
4833 colisiones. Una función @q{pura} no afecta a las propiedades,
4834 objetos o suicidios de grobs, y por ello siempre ven sus valores
4835 relacionados con el eje Y evaluados correctamente.
4837 Actualmente hay unas treinta funciones que ya se consideran
4838 @q{puras} y los contenedores Unpure-pure son una manera de
4839 establecer funciones que no están en esta lista como @q{puras}.
4840 La función @q{pura} se evalúa @emph{antes} de cualquier salto de
4841 línea y así el espaciado horizontal se puede ajustar @q{a tiempo}.
4842 La función @q{impura} se evalúa entonces @emph{después} del salto
4845 @warning{Dado que es difícil saber siempre qué funciones están en
4846 esta lista, recomendamos que cualquier función @q{pura} que
4847 estemos creando no utilice los grobs @code{Beam} o
4848 @code{VerticalAlignment}.}
4850 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
4852 @code{(ly:make-unpure-pure-container f0 f1)}
4854 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
4855 1}) y el primer argumento siempre debe ser el grob. Ésta es la
4856 función que da el resultado real. @var{f1} es la función que se
4857 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
4858 primer argumento debe ser siempre el grob pero los argumentos segundo
4859 y tercero son argumentos de @q{inicio} y de @q{final}.
4861 @var{inicio} y @var{final} son, a todos los efectos, valores mudos
4862 que sólo tienen importancia para los @code{objetos de extensión}
4863 (o sea: @code{Hairpin}, regulador, o @code{Beam}, barra), que
4864 pueden devolver distintas estimaciones de altura basadas en una
4865 columna de inicio y una de final.
4867 El resto son los otros argumentos para la primera función (que
4868 puede no ser ninguno si @var{n = 1}).
4870 El resultado de la segunda función se usa como una aproximación del
4871 valor necesario, que se usa entonces por la primera función para
4872 obtener el valor real que se usa a continuación para el ajuste de
4873 precisión mucho más tardío durante el proceso de espaciado.
4875 @c TODO: The following example supposedly showing a collision no longer
4876 @c 'works' since 2.18.x. Another example of a collision is needed.
4879 @lilypond[verbatim,quote,ragged-right]
4880 #(define (square-line-circle-space grob)
4881 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
4882 (notename (ly:pitch-notename pitch)))
4883 (if (= 0 (modulo notename 2))
4884 (make-circle-stencil 0.5 0.0 #t)
4885 (make-filled-box-stencil '(0 . 1.0)
4888 squareLineCircleSpace = {
4889 \override NoteHead.stencil = #square-line-circle-space
4892 smartSquareLineCircleSpace = {
4893 \squareLineCircleSpace
4894 \override NoteHead.Y-extent =
4895 #(ly:make-unpure-pure-container
4896 ly:grob::stencil-height
4897 (lambda (grob start end) (ly:grob::stencil-height grob)))
4900 \new Voice \with { \remove "Stem_engraver" }
4902 \squareLineCircleSpace
4904 \smartSquareLineCircleSpace
4909 En el primer compás, sin el contenedor @emph{unpure-pure}, el
4910 motor de espaciado no conoce la anchura de la cabeza de la nota y
4911 permite que colisione con las alteraciones accidentales. En el
4912 segundo compás, el motor de espaciado conoce la anchura de las
4913 cabezas de las notas y evita la colisión mediante el alargamiento
4914 de la línea en la medida adecuada.
4916 Normalmente, para cálculos simples se pueden usar funciones casi
4917 idénticas tanto para las partes @q{no pura} y @q{pura},
4918 simplemente cambiando el número de argumentos que se pasan a, y el
4919 ámbito de, la función. Este caso de utilización es lo bastante
4920 frecuente como para que @code{ly:make-unpure-pure-container}
4921 construya dicha segunda función de forma predeterminada cuando se
4922 llama con solo un argumento de función.
4924 @warning{Si una función está caracterizada como @q{pura} y resulta
4925 que no lo es, el resultado puede ser inesperado.}
4928 @node Uso de las funciones musicales
4929 @section Uso de las funciones musicales
4930 @translationof Using music functions
4932 @c TODO -- add @seealso, etc. to these subsections
4934 Dondequiera que se necesite reutilizar trucos con distintas
4935 expresiones musicales, con frecuencia conviene hacer que el truco
4936 forme parte de una @emph{función musical}. En esta sección
4937 estudiaremos solamente las funciones de @emph{sustitución}, en las
4938 que el objeto es sustituir una variable dentro de un fragmento de
4939 código de entrada de LilyPond. Se describen otras funciones más
4940 complejas en @rextend{Funciones musicales}.
4943 * Sintaxis de las funciones de sustitución::
4944 * Ejemplos de funciones de sustitución::
4948 @node Sintaxis de las funciones de sustitución
4949 @subsection Sintaxis de las funciones de sustitución
4950 @translationof Substitution function syntax
4952 Es fácil hacer una función que sustituya una variable dentro de
4953 código de LilyPond. La forma general de estas funciones es
4957 #(define-music-function
4958 (@var{arg1} @var{arg2} @dots{})
4959 (@var{type1?} @var{type2?} @dots{})
4961 @var{@dots{}música@dots{}}
4968 @multitable @columnfractions .33 .66
4969 @item @code{@var{argN}}
4970 @tab @var{n}-ésimo argumento
4972 @item @code{@var{typeN?}}
4973 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
4974 debe devolver @code{#t}.
4976 @item @code{@var{@dots{}música@dots{}}}
4977 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
4978 lugares en que sólo se permiten construcciones de LilyPond) o
4979 @code{#} (para usarlo como un valor de Scheme o un argumento de
4980 función musical o música dentro de listas de música) para
4981 referenciar argumentos (p.ej. @samp{#arg1}).
4984 Es necesaria la lista de predicados de tipo. Algunos de los
4985 predicados de tipo más comunes que se utilizan en las funciones
4990 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
5002 Para ver una lista de los predicados de tipo disponibles, consulte
5003 @ref{Predicados de tipo predefinidos}. También se permiten los
5004 predicados de tipo definidos por el usuario.
5007 Referencia de la notación:
5008 @ref{Predicados de tipo predefinidos}.
5010 Expansión de LilyPond:
5011 @rextend{Sintaxis de las funciones musicales}.
5013 Archivos instalados:
5014 @file{lily/music-scheme.cc},
5016 @file{scm/lily.scm}.
5019 @node Ejemplos de funciones de sustitución
5020 @subsection Ejemplos de funciones de sustitución
5021 @translationof Substitution function examples
5023 Esta sección presenta algunos ejemplos de funciones de
5024 sustitución. No pretenden ser exhaustivas, sino demostrar algunas
5025 de las posibilidades de las funciones de sustitución sencillas.
5027 En el primer ejemplo se define una función que simplifica el
5028 ajuste del relleno de un elemento de inscripción de texto
5031 @lilypond[quote,verbatim,ragged-right]
5033 #(define-music-function
5037 \once \override TextScript.padding = #padding
5041 c''4^"piu mosso" b a b
5043 c4^"piu mosso" b a b
5045 c4^"piu mosso" b a b
5049 Además de números, podemos usar expresiones musicales, como notas,
5050 para los argumentos de las funciones musicales:
5052 @lilypond[quote,verbatim,ragged-right]
5054 #(define-music-function
5058 \tweak NoteHead.stencil #ly:text-interface::print
5059 \tweak NoteHead.text
5060 \markup \musicglyph #"custodes.mensural.u0"
5061 \tweak Stem.stencil ##f
5065 \relative { c'4 d e f \custosNote g }
5069 Ambas funciones son expresiones únicas sencillas en las que solo
5070 falta el último elemento de una lamada de función o
5071 sobreescritura. Para estas definiciones de función en particular,
5072 existe una sintaxis alternativa más simple que consiste
5073 simplemente en escribir la parte constante de la expresión y
5074 sustituir el elemento final que falta por @code{\etc}:
5076 @lilypond[quote,verbatim,ragged-right]
5078 \once \override TextScript.padding = \etc
5081 c''4^"piu mosso" b a b
5083 c4^"piu mosso" b a b
5085 c4^"piu mosso" b a b
5089 @lilypond[quote,verbatim,ragged-right]
5091 \tweak NoteHead.stencil #ly:text-interface::print
5092 \tweak NoteHead.text
5093 \markup \musicglyph #"custodes.mensural.u0"
5094 \tweak Stem.stencil ##f
5097 \relative { c'4 d e f \custosNote g }
5101 Se pueden definir funciones de sustitución con más de un
5104 @lilypond[quote,verbatim,ragged-right]
5106 #(define-music-function
5110 \once \override Score.MetronomeMark.padding = #padding
5111 \tempo \markup { \bold #tempotext }
5115 \tempo \markup { "Low tempo" }
5117 \tempoPadded #4.0 "High tempo"
5122 @c TODO: add appropriate @@ref's here.