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
1175 Los contextos específicos, como @code{Staff} y @code{Voice}, están
1176 construidos a partir de bloques sencillos. Es posible crear
1177 nuevos tipos de contextos con combinaciones distintas de añadidos
1180 El siguiente ejemplo muestra cómo construir un tipo diferente de
1181 contexto de @code{Voice} partiendo de cero. Será parecido a
1182 @code{Voice}, pero imprime solamente cabezas centradas en forma de
1183 barra inclinada. Se puede usar para indicar improvisación en
1186 @lilypond[quote,ragged-right]
1187 \layout { \context {
1189 \type "Engraver_group"
1190 \consists "Note_heads_engraver"
1191 \consists "Rhythmic_column_engraver"
1192 \consists "Text_engraver"
1193 \consists "Pitch_squash_engraver"
1194 squashedPosition = #0
1195 \override NoteHead.style = #'slash
1200 \accepts "ImproVoice"
1204 a'4 d8 bes8 \new ImproVoice { c4^"ad lib" c
1205 c4 c^"undress" c_"while playing :)" c }
1211 Estos ajustes se definen dentro de un bloque @code{\context} que a
1212 su vez está dentro de un bloque @code{\layout},
1222 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
1223 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
1225 En primer lugar es necesario definir un nombre para el nuevo
1232 Debido a que es parecido al contexto @code{Voice}, queremos
1233 órdenes que funcionen dentro de los contextos @code{Voice}
1234 (existentes) para que siga funcionando. Esto se consigue dando al
1235 contexto nuevo un alias de @code{Voice},
1241 El contexto imprimirá notas y textos explicativos, por ello
1242 tenemos que añadir los grabadores que aportan esta funcionalidad,
1243 y además el grabador que agrupa las notas, plicas y silencios que
1244 están en el mismo momento musical en forma de columnas,
1247 \consists "Note_heads_engraver"
1248 \consists "Text_engraver"
1249 \consists "Rhythmic_column_engraver"
1252 Las cabezas de todas las notas se deben situar sobre la línea
1256 \consists "Pitch_squash_engraver"
1257 squashedPosition = #0
1260 El grabador @code{Pitch_squash_engraver} modifica las cabezas de
1261 nota (creadas por el grabador @code{Note_heads_engraver}) y
1262 establece sus posiciones verticales al valor de
1263 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea
1266 Las notas parecen barras inclinadas y no tienen plica:
1269 \override NoteHead.style = #'slash
1273 Todos estos complementos o plug-ins tienen que comunicarse bajo el
1274 control del contexto. Los mecanismos con el que se comunican los
1275 contextos se establecen mediante la declaración del @code{\type}
1276 (tipo) del contexto. Dentro de un bloque @code{\layout}, casi
1277 todos los contextos serán del tipo @code{Engraver_group}. Algunos
1278 contextos especiales y los contextos de los bloques @code{\midi}
1279 usan otros tipos. La copia y la modificación de una definición de
1280 contexto existente también cumplimentan el tipo. Como este
1281 ejemplo crea una definición partiendo de cero, tiene que ser
1282 especificada explícitamente.
1285 \type "Engraver_group"
1288 Al juntarlo todo, obtenemos
1293 \type "Engraver_group"
1294 \consists "Note_heads_engraver"
1295 \consists "Text_engraver"
1296 \consists "Rhythmic_column_engraver"
1297 \consists "Pitch_squash_engraver"
1298 squashedPosition = #0
1299 \override NoteHead.style = #'slash
1306 Los contextos dan lugar a jerarquías. Queremos poner el contexto
1307 @code{ImproVoice} dentro del contexto @code{Staff}, igual que los
1308 contextos de voz normales. Por tanto, modificamos la definición
1309 de @code{Staff} con la instrucción @code{\accepts} (acepta),
1318 @funindex \inherit-acceptability
1319 Con frecuencia, al reutilizar una definición de contexto
1320 existente, el contexto resultante se puede usar en cualquier lugar
1321 donde el contexto original hubiera podido hacerlo.
1326 \inherit-acceptability @var{to} @var{from}
1331 consigue que tengamos contextos del tipo @var{to} aceptados por
1332 todos los contextos que asimismo aceptan @var{from}. Por ejemplo,
1338 \inherit-acceptability "ImproVoice" "Voice"
1343 añade un @code{\accepts} para @code{ImproVoice} tanto a la
1344 definición de @code{Staff} como a la de @code{RhythmicStaff}.
1347 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega),
1348 lo que a veces se necesita cuando se están reutilizando
1349 definiciones de contexto existentes.
1351 Organizar las piezas requeridas dentro de un bloque @code{\layout}
1360 \inherit-acceptability "ImproVoice" "Voice"
1364 Así pues, la salida que aparece al comienzo de esta sub-sección se
1373 c c_"mientras tocas :)"
1379 Para completar el ejemplo, los cambios que afectan a la jerarquía
1380 de contextos se deben repetir dentro de un bloque @code{\midi} de
1381 manera que la salida MIDI dependa de las mismas relaciones de
1386 Referencia de funcionamiento interno:
1387 @rinternals{Note_heads_engraver},
1388 @rinternals{Text_engraver},
1389 @rinternals{Rhythmic_column_engraver},
1390 @rinternals{Pitch_squash_engraver}.
1393 @node Orden de disposición de los contextos
1394 @subsection Orden de disposición de los contextos
1395 @translationof Context layout order
1397 @cindex contextos, orden de disposición
1401 Los contextos se disponen en un sistema normalmente desde arriba
1402 hacia abajo en el orden en que se encuentran en el archivo de
1403 entrada. Cuando los contextos se anidan unos dentro de otros, el
1404 contexto exterior incluye a los contextos anidados tal y como se
1405 especifica en el archivo de entrada, siempre y cuando los
1406 contextos interiores estén incluidos en la lista @qq{accepts} del
1407 contexto externo. Los contextos anidados que no está nincluidos
1408 en la lista @qq{accepts} del contexto externo se recolocan debajo
1409 del contexto externo en lugar de anidarse dentro de él.
1411 La lista @qq{accepts} de un contexto se puede cambiar con las
1412 instrucciones @code{\accepts} (acepta) o @code{\denies} (niega).
1413 @code{\accepts} añade un contexto a la lista @qq{accepts} y
1414 @code{\denies} elimina un contexto de la lista.
1416 Por ejemplo, un grupo de pentagramas con un corchete cuadrado no
1417 se encuentra normalmente en el interior de un pentagrama con llave
1418 curva que tenga conectadas las líneas divisorias, y un
1419 @code{GrandStaff} para piano no acepta un @code{StaffGroup} dentro
1420 de él, de forma predeterminada.
1422 @lilypond[verbatim,quote]
1429 \new Staff { \set Staff.instrumentName = bottom f'1 }
1434 Sin embargo, usando la instrucción @code{\accepts}, se puede
1435 añadir un @code{StaffGroup} al contexto @code{GrandStaff}:
1437 @lilypond[verbatim,quote]
1444 \new Staff { \set Staff.instrumentName = bottom f'1 }
1449 \accepts "StaffGroup"
1455 @code{\denies} se usa principalmente cuando un contexto nuevo se
1456 está basando en otro, pero los anidamientos requeridos difieren.
1457 Por ejemplo, el contexto @code{VaticanaStaff} está basado en el
1458 contexto @code{Staff}, pero con el contexto @code{VaticanaVoice}
1459 sustituido por el contexto @code{Voice} en la lista @qq{accepts}.
1462 @cindex contextos implícitos
1463 @cindex implícitos, contextos
1464 @funindex \defaultchild
1466 Observe que discretamente se crea un contexto de forma implícita
1467 si se encuentra una instrucción donde no hay un contexto apropiado
1470 Dentro de una definición de contexto, el tipo de un subcontexto
1471 que se va a crear implícitamente se especifica usando
1472 @code{\defaultchild} (hijo predeterminado). Algunos eventos
1473 musicales requieren un contexto @samp{Bottom} (inferior): cuando
1474 se encuentra este evento, se crean subcontextos de forma recursiva
1475 hasta que se alcanza un contexto que no tiene establecido el
1476 @samp{defaultchild}.
1478 La creación implícita de contextos puede dar lugar a pentagramas o
1479 partituras nuevos no esperados. La utilización de @code{\new}
1480 para crear contextos explícitamente evita esos problemas.
1482 @cindex alignAboveContext
1483 @cindex alignBelowContext
1484 @funindex alignAboveContext
1485 @funindex alignBelowContext
1487 En ocasiones se necesita que un contexto exista durante un breve
1488 intervalo de tiempo, siendo un buen ejemplo el contexto de
1489 pentagrama de un ossia. Esto se consigue normalmente mediante la
1490 introducción de la definición del contexto en el lugar apropiado
1491 en paralelo con la sección correspondiente de la música principal.
1492 De forma predeterminada, el contexto tempral se coloca debajo de
1493 todos los contextos existentes. Para reposicionarlo por encima
1494 del contexto que tenga el nombre @qq{principal}, debería definirse
1498 @code{\new Staff \with @{ alignAboveContext = #"principal" @} }
1501 Se presenta una situación similar cuando se posiciona un contexto
1502 temporal de letra de una canción dentro de una disposición de varios
1503 pentagramas tal como @code{ChoirStaff}, por ejemplo, cuando se añade
1504 una segunda estrofa a una sección que se repite. De forma
1505 predeterminada, el contexto temporal de letra se coloca debajo de los
1506 pentagramas inferiores. Mediante la definición del contexto temporal
1507 de letra con @code{alignBelowContext} se puede posicionar
1508 correctamente debajo del contexto de letra con nombre que contiene el
1509 texto de la primera estrofa.
1511 En diversos lugares pueden verse ejemplos que muestran esta
1512 recolocación de contextos temporales: véase
1513 @rlearning{Anidado de expresiones musicales},
1514 @ref{Modificación de pentagramas sueltos} y
1515 @ref{Técnicas específicas para la letra}.
1518 Manual de aprendizaje:
1519 @rlearning{Anidado de expresiones musicales}.
1521 Referencia de la notación:
1522 @ref{Modificación de pentagramas sueltos},
1523 @ref{Técnicas específicas para la letra}.
1525 Manual de utilización del programa:
1526 @rprogram{Aparece un pentagrama de más}.
1528 Archivos instalados:
1529 @file{ly/engraver-init.ly}.
1532 @node Explicación del Manual de referencia de funcionamiento interno
1533 @section Explicación del Manual de referencia de funcionamiento interno
1534 @translationof Explaining the Internals Reference
1537 * Navegar por la referencia del programa::
1538 * Interfaces de la presentación::
1539 * Determinar la propiedad del grob::
1540 * Convenciones de nombres::
1544 @node Navegar por la referencia del programa
1545 @subsection Navegar por la referencia del programa
1546 @translationof Navigating the program reference
1548 Supongamos que queremos mover la indicación de digitación del
1549 fragmento siguiente:
1551 @lilypond[quote,fragment,verbatim]
1555 Si hace una visita a la documentación en busca de instrucciones de
1556 digitación (en @ref{Indicaciones de digitación}), encontrará:
1559 @strong{Véase también}
1561 Referencia de funcionamiento interno: @rinternals{Fingering}.
1566 La referencia del programador se encuentra disponible en forma de
1567 documento HTML. Se recomienda mucho que lo lea en la forma HTML,
1568 bien en línea o bien descargando los archivos de la documentación
1569 HTML. Esta sección sería mucho más difícil de entender si está
1570 utilizando el manual en formato PDF.
1573 Siga el enlace que lleva a @rinternals{Fingering}. Al principio
1574 de la página, puede ver
1577 Los objetos de digitación se crean por parte de:
1578 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1581 Siguiendo los enlaces relacionados dentro de la referencia del
1582 programa, podemos seguir el flujo de información dentro del
1587 @item @rinternals{Fingering}:
1588 los objetos @rinternals{Fingering} se crean por parte de:
1589 @rinternals{Fingering_engraver}
1591 @item @rinternals{Fingering_engraver}:
1592 Tipos de música aceptados: @rinternals{fingering-event}
1594 @item @rinternals{fingering-event}:
1595 El tipo de evento musical @code{fingering-event} está descrito en
1596 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1599 Este camino se recorre en contra de la corriente de información
1600 del programa: comienza por la salida y acaba en el evento de
1601 entrada. También podríamos haber empezado por un evento de la
1602 entrada, y leído siguiendo el flujo de información terminando en
1603 su caso en el objeto (u objetos) de la salida.
1605 La referencia del programa también se puede examinar como un
1606 documento normal. Contiene capítulos que tratan de
1608 @rinternals{Music definitions},
1611 @code{Music definitions}
1613 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada
1614 uno de los capítulos relaciona todas las definiciones utilizadas y
1615 todas las propiedades que se pueden ajustar.
1618 @node Interfaces de la presentación
1619 @subsection Interfaces de la presentación
1620 @translationof Layout interfaces
1622 @cindex interfaz de la presentación
1623 @cindex presentación, interfaz de la
1626 La página HTML que pudimos ver en la sección anterior describe el
1627 objeto de presentación llamado @rinternals{Fingering}. Dicho
1628 objeto es un símbolo dentro de la partitura. Tiene propiedades
1629 que guardan números (como grosores y direcciones), pero también
1630 punteros a objetos relacionados. Un objeto de presentación
1631 también se llama un @emph{Grob}, que es una abreviatura de
1632 Graphical Object (objeto gráfico). Para ver más detalles acerca
1633 de los objetos gráficos o Grobs, consulte
1634 @rinternals{grob-interface}.
1636 La página dedicada a @code{Fingering} relaciona las definiciones del
1637 objeto @code{Fingering}. Por ejemplo, la página dice
1640 @code{padding} (dimensión, en espacios de pentagrama):
1646 lo que significa que el número se mantendrá a una distancia de al
1647 menos 0.5 de la cabeza de la nota.
1650 Cada objeto de presentación puede tener varias funciones como
1651 elemento notacional o tipográfico. Por ejemplo, el objeto de
1652 digitación Fingering tiene los siguientes aspectos
1656 Su tamaño es independiente del espaciado horizontal, al contrario
1657 de las ligaduras o las barras de las figuras.
1660 Es un elemento de texto. Casi seguro que es un texto muy corto.
1663 este elemento de texto se tipografía con un tipo de letra, no como
1664 las ligaduras o las barras de las figuras.
1667 Horizontalmente, el centro del símbolo se debe alinear con el
1668 centro de la cabeza de la nota.
1671 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1674 La posición vertical también está coordinada con otros símbolos de
1675 superíndice y de subíndice.
1678 Cada uno de estos aspectos se capta en lo que se llaman
1679 @emph{interface}s, que se relacionan al final de la página dedicada a
1680 @rinternals{Fingering}
1683 Este objeto contempla los siguientes interfaces:
1684 @rinternals{item-interface},
1685 @rinternals{self-alignment-interface},
1686 @rinternals{side-position-interface}, @rinternals{text-interface},
1687 @rinternals{text-script-interface}, @rinternals{font-interface},
1688 @rinternals{finger-interface} y @rinternals{grob-interface}.
1691 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1692 página del respectivo interfaz del objeto. Cada interfaz tiene un
1693 cierto número de propiedades. Algunas de ellas no son para que el
1694 usuario las pueda ajustar (@q{Propiedades internas}), pero otras
1695 sí se pueden modificar.
1697 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1698 realmente esto no significa mucho. El archivo de inicialización
1699 (véase @rlearning{Otras fuentes de información})
1700 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1705 (avoid-slur . around)
1706 (slur-padding . 0.2)
1707 (staff-padding . 0.5)
1708 (self-alignment-X . 0)
1709 (self-alignment-Y . 0)
1710 (script-priority . 100)
1711 (stencil . ,ly:text-interface::print)
1712 (direction . ,ly:script-interface::calc-direction)
1713 (font-encoding . fetaText)
1714 (font-size . -5) ; don't overlap when next to heads.
1715 (meta . ((class . Item)
1716 (interfaces . (finger-interface
1718 text-script-interface
1720 side-position-interface
1721 self-alignment-interface
1722 item-interface))))))
1726 Como podemos ver, el objeto @code{Fingering} no es más que un
1727 montón de valores de variables, y la página web de la Referencia
1728 de funcionamiento interno se genera directamente a partir de esta
1732 @node Determinar la propiedad del grob
1733 @subsection Determinar la propiedad del grob
1734 @translationof Determining the grob property
1736 Recordemos que queríamos cambiar la posición del @b{2} en
1738 @lilypond[quote,fragment,verbatim]
1742 Puesto que el @b{2} se encuentra colocado verticalmente sobre su
1743 nota, tenemos que negociar con el interfaz asociado con esta
1744 colocación. Esto se hace usando @code{side-position-interface}.
1745 La página que describe este interface dice:
1748 @code{side-position-interface}
1750 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1751 soporte). La propiedad @code{direction} significa dónde poner el
1752 objeto víctima con relación al soporte (¿a la izquierda o a la
1753 derecha, encima o debajo?)
1757 @cindex padding (relleno)
1759 Debajo de esta descripción, la variable @code{padding} (relleno)
1765 (dimensión, en espacios de pentagrama)
1767 Añadir esta cantidad de espacio adicional entre objetos que están
1772 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1773 digitación de la cabeza de la nota. La siguiente orden inserta un
1774 espacio en blanco de tres @qq{espacios de pentagrama} entre la
1775 nota y la digitación:
1778 \once \override Voice.Fingering.padding = #3
1781 Al insertar este relleno antes de que se haya creado el objeto de
1782 digitación, llegamos al siguiente resultado:
1784 @lilypond[quote,fragment,verbatim]
1785 \once \override Voice.Fingering.padding = #3
1789 En este caso, el contexto de este truco es @code{Voice}. Véase el
1790 apartado dedicado al añadido @rinternals{Fingering_engraver}, que
1794 El grabador Fingering_engraver forma parte de los contextos:
1795 @dots{} @rinternals{Voice}
1799 @node Convenciones de nombres
1800 @subsection Convenciones de nombres
1801 @translationof Naming conventions
1803 Se hace necesario presentar una panorámica de las diversas
1804 convenciones de nomenclatura:
1807 @item funciones de Scheme: minúsculas-con-guiones (lo que incluye a los nombres de una sola palabra)
1809 @item funciones de Scheme específicas de LilyPond: ly:más-estilo-de-scheme
1811 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1813 @item interfaces de Grobs: estilo-scheme
1815 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1817 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1819 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1821 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1825 Preguntas aún sin respuesta
1827 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1829 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1834 @node Modificar las propiedades
1835 @section Modificar las propiedades
1836 @translationof Modifying properties
1839 * Panorámica de la modificación de las propiedades::
1840 * La instrucción set::
1841 * La instrucción override::
1842 * La instrucción tweak::
1843 * set frente a override::
1844 * Modificación de las listas-A::
1848 @node Panorámica de la modificación de las propiedades
1849 @subsection Panorámica de la modificación de las propiedades
1850 @translationof Overview of modifying properties
1852 Cada contexto es responsable de la creación de ciertos tipos de
1853 objetos gráficos. Los ajustes que se usan para imprimir estos
1854 objetos también se almacenan por contexto. Mediante la
1855 modificación de estos ajustes, se puede alterar la apariencia de
1858 Existen dos tipos diferentes de propiedades almacenadas en los
1859 contextos: las propiedades de contexto y las propiedades de grob.
1860 Las propiedades de contexto son propiedades que se aplican al
1861 contexto como un todo y controlan la forma en que el propio
1862 contexto se imprime. Por contra, las propiedades de grob se
1863 aplican a los tipos de grob específicos que se imprimirán dentro
1866 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar
1867 los valores de las propiedades de contexto. Las instrucciones
1868 @code{\override} y @code{\revert} se usan para cambiar los valores
1869 de las propiedades de grob.
1872 La sintaxis de esto es
1875 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1878 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1879 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1880 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1881 disposición}). Este último es un símbolo, y por ello debe ir
1882 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1883 explica cómo se deben cumplimentar los conceptos @var{nombre},
1884 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1885 funcionalidad des esta instrucción.
1890 \override Staff.Stem.thickness = #4.0
1894 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1895 grosor de una línea del pentagrama como unidad). Puesto que la
1896 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1897 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1898 Aquí vemos la instrucción en pleno funcionamiento:
1900 @lilypond[quote,fragment,verbatim]
1902 \override Staff.Stem.thickness = #4.0
1908 La instrucción @code{\override} modifica la definición de la plica
1909 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1910 que la instrucción se ha interpretado, todas las plicas se engrosan.
1912 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1913 omitir, ocasionando que se utilice el contexto predeterminado
1914 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1915 solo paso de tiempo.
1917 @lilypond[quote,fragment,verbatim]
1919 \once \override Stem.thickness = #4.0
1924 El @code{\override} se debe hacer antes de que el objeto se inicia.
1925 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1926 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1927 en el momento en que se crea el objeto. En este ejemplo:
1929 @lilypond[quote,fragment,verbatim]
1930 \override Slur.thickness = #3.0
1932 \override Beam.beam-thickness = #0.6
1937 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1938 la instrucción para @code{Beam}, la barra, va después de que la barra
1939 se ha iniciado, y por ello no tiene ningún efecto.
1941 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1942 un contexto deshace una instrucción @code{\override}; como con
1943 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1944 del mismo contexto. En otras palabras, el @code{\revert} del
1945 siguiente ejemplo no hace nada.
1948 \override Voice.Stem.thickness = #4.0
1949 \revert Staff.Stem.thickness
1952 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1953 dentro de las propiedades normales. Para trucarlas, utilice
1954 instrucciones de la forma
1956 @c leave this as a long long
1958 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1965 \override Stem.details.beamed-lengths = #'(4 4 3)
1971 Referencia de funcionamiento interno:
1972 @rinternals{Backend},
1973 @rinternals{All layout objects},
1974 @rinternals{OverrideProperty},
1975 @rinternals{RevertProperty},
1976 @rinternals{PropertySet}.
1979 El «back-end» o motor de salida no es muy estricto en la
1980 comprobación de tipos de las propiedades de objetos. Las
1981 referencias cíclicas en valores Scheme de propiedades pueden
1982 producir cuelgues o salidas abruptas, o las dos cosas.
1985 @node La instrucción set
1986 @subsection La instrucción @code{@bs{}set}
1987 @translationof The set command
1991 @cindex cambiar propiedades
1993 Cada contexto puede tener distintas @emph{propiedades}, variables
1994 contenidas dentro de ese contexto. Se pueden cambiar mientras
1995 dura el paso de interpretación. Se consigue insertando la
1996 instrucción @code{\set} dentro de la música:
1999 \set @var{contexto}.@var{propiedad} = #@var{valor}
2002 @var{valor} es un objeto de Scheme, razón por la que va precedido
2003 del carácter almohadilla,@tie{}@code{#}.
2005 El nombre de las propiedades de contexto suele ir en minúsculas
2006 con mayúscula en medio. Controlan sobre todo la traducción de la
2007 música a la notación, p.ej. @code{localAlterations} (para
2008 determinar si hay que impriir alteraciones o no), o
2009 @code{measurePosition} (para determinar cuándo hay que imprimir
2010 una línea divisoria). El valor de las propiedades de contexto
2011 puede modifcarse con el tiempo durante la interpretación de la
2012 música; un ejemplo obvio es @code{measurePosition}. Las
2013 propiedades de contexto se modifican mediante la instrucción
2016 Por ejemplo, los silencios multicompás se combinan en un solo
2017 compás si el valor de la propiedad de contexto @code{skipBars} se
2018 establece a @code{#t} (verdadero):
2020 @lilypond[quote,fragment,verbatim]
2022 \set Score.skipBars = ##t
2026 Si se omite el argumento @var{context}, entonces se utiliza el
2027 contexto actual de nivel más bajo (normalmente @code{ChordNames},
2028 @code{Voice} o @code{Lyrics}). En este ejemplo:
2030 @lilypond[quote,fragment,verbatim]
2031 \set Score.autoBeaming = ##f
2034 \set autoBeaming = ##t
2042 El cambio se aplica @q{al vuelo}, mientras dura la música, de
2043 forma que el ajuste sólo afecta al segundo grupo de corcheas.
2045 Observe que el contexto del nivel más bajo no siempre contiene la
2046 propiedad que querríamos modificar: por ejemplo, intentar ajustar
2047 el valor de la propiedad @code{skipBars} del contexto
2048 predeterminado del nivel más bajo, que en este caso es
2049 @code{Voice}, no tendrá ningún efecto, porque skipBars es una
2050 propiedad del contexto @code{Score}.
2052 @lilypond[quote,fragment,verbatim]
2058 Los contextos son jerárquicos, y si se ha especificado un contexto
2059 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
2060 también a todos los contextos @code{Voice} dentro del pentagrama
2065 También existe una instrucción @code{\unset}:
2067 \unset @var{contexto}.@var{propiedad}
2071 que elimina la definición de @var{propiedad}. Esta instrucción
2072 elimina la definición solamente si está establecida dentro de
2073 @var{contexto}. Properties that have been set in enclosing contexts will
2074 not be altered by an unset in an enclosed context:
2076 @lilypond[quote,fragment,verbatim]
2077 \set Score.autoBeaming = ##t
2081 \unset Score.autoBeaming
2089 Como @code{\set}, el argumento @var{contexto} no se tiene que
2090 especificar para un contexto del nivel más bajo, por lo que los
2094 \set Voice.autoBeaming = ##t
2095 \set autoBeaming = ##t
2099 son equivalentes si el contexto inferior en curso es @code{Voice}.
2103 Los ajustes con @code{\set} o @code{\unset} que se aplican
2104 solamente a un único paso de tiempo se pueden escribir con
2105 @code{\once}, por ejemplo en
2107 @lilypond[quote,fragment,verbatim]
2109 \once \set fontSize = #4.7
2114 En el manual de Referencia de funcionamiento interno hay una
2115 descripción completa de todas las propiedades de contexto
2116 disponibles, consulte
2118 @rinternals{Tunable context properties}.
2121 Traducción @expansion{} Propiedades de contexto modificables por el
2126 Referencia de funcionamiento interno:
2127 @rinternals{Tunable context properties}.
2129 @node La instrucción override
2130 @subsection La instrucción @code{\override}
2131 @translationof The override command
2133 @cindex grob, propiedades de
2134 @cindex propiedades de grob
2137 Existe un tipo especial de propiedad de contexto: la descripción
2138 de los grobs. Las decscripciones de los grobs reciben un nombre
2139 en @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen
2140 los @q{ajustes predeterminados} para un tipo particular de grob,
2141 en forma de lista asociativa. Consulte
2142 @file{scm/define-grobs.scm} para ver los ajustes de cada
2143 descripción de grob. Las descripciones de grob se modifican con
2146 La sintaxis de la instrucción @code{\override} es
2149 \override [@var{contexto}.]@var{NombreDelGrob}.@var{propiedad} = #@var{valor}
2152 Por ejemplo, podemos aumentar el grosor de la plica de una figura
2153 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
2154 @code{Stem} (plica):
2156 @lilypond[quote,fragment,verbatim]
2158 \override Voice.Stem.thickness = #3.0
2162 Si no se ha especificado ningún contexto en la instrucción
2163 @code{\override}, se utiliza el contexto del nivel inferior:
2165 @lilypond[quote,fragment,verbatim]
2166 \override Staff.Stem.thickness = #3.0
2170 \override Stem.thickness = #0.5
2179 Algunas opciones susceptibles de trucaje, se llaman
2180 @q{subpropiedades} y residen dentro de las propiedades. Para
2181 efectura trujajes sobre ellas, utilice instrucciones de la forma
2184 \override Stem.details.beamed-lengths = #'(4 4 3)
2187 o para modificar los extremos de los objetos extensos, utilice una
2188 forma como las siguientes:
2191 \override TextSpanner.bound-details.left.text = #"left text"
2192 \override TextSpanner.bound-details.right.text = #"right text"
2196 @cindex reversión de sobreescrituras
2197 @cindex sobreescrituras, reversión de
2199 El efecto de una instrucción de sobreescritura @code{\override} se
2200 puede deshacer con @code{\revert}.
2202 La sintaxis de la instrucción @code{\revert} es
2205 \revert [@var{Contexto}.]@var{NombreDelGrob}.@var{propiedad}
2210 @lilypond[quote,verbatim]
2213 \override Voice.Stem.thickness = #3.0
2215 \revert Voice.Stem.thickness
2220 Los efectos de @code{\override} y @code{\revert} se aplican a
2221 todos los grobs del contexto afectado partiendo del momento actual
2224 @lilypond[quote,verbatim]
2228 \override Staff.Stem.thickness = #3.0
2233 \revert Staff.Stem.thickness
2240 @cindex sobreescritura para un solo momento
2242 Se puede usar @code{\once} con @code{\override} o @code{\revert}
2243 para afectar solamente al instante de tiempo actual:
2245 @lilypond[quote,verbatim]
2248 \override Stem.thickness = #3.0
2253 \once \override Stem.thickness = #3.0
2261 Las instrucciones que modifican la salida tienen por lo general un
2265 \override Voice.Stem.thickness = #3.0
2269 Para construir este truco debemos determinar los siguientes datos:
2272 @item el contexto: aquí @code{Voice}.
2273 @item el objeto de presentación: aquí @code{Stem}.
2274 @item la propiedad de presentación: aquí @code{thickness}.
2275 @item un valor adecuado: aquí @code{3.0}.
2278 @cindex documentación interna
2279 @cindex buscar objetos gráficos
2280 @cindex gráficos, descripción de los objetos
2283 @cindex interna, documentación
2285 Para muchas propiedades, independientemente del tipo de datos de la
2286 propiedad, si se establece el valor de la propiedad a falso
2287 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
2288 ignore por completo dicha propiedad. Esto es especialmente útil para
2289 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
2290 causarían problemas.
2292 Mostraremos a continuación cómo localizar esta información en el
2293 manual de notación y en la referencia de funcionamiento interno.
2297 Referencia de funcionamiento interno:
2298 @rinternals{Backend}
2301 @node La instrucción tweak
2302 @subsection La instrucción @code{\tweak}
2303 @translationof The tweak command
2308 El cambio de las propiedades de grob mediante @code{\override} produce
2309 la aplicación del cambio a todos los grobs dados en el contexto en el
2310 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
2311 podemos desear que los cambios se apliquen a un solo grob en lugar de
2312 a todos los grobs del contexto afectado. Esto se consigue con la
2313 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
2316 \tweak [@var{objeto-de-presentación}.]@var{propiedad-del-grob} @var{valor}
2319 Es opcional especificar el @var{objeto-de-presentación}. La
2320 instrucción @code{\tweak} se aplica al objeto musical que viene
2321 inmediatamente después de @var{valor} dentro del flujo musical.
2324 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
2325 los objetos gráficos. Para objetos que resultan directamente de un
2326 elemento de código de la entrada, puede usar la función @code{\tweak},
2329 @lilypond[verbatim,quote]
2335 \tweak duration-log #1
2345 El uso principal de la instrucción @code{\tweak} es modificar
2346 solamente uno de varios elementos de notación que dan comienzo en el
2347 mismo momento musical, como las notas de un acorde, o corchetes de
2348 tresillo que empiezan al mismo tiempo.
2350 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
2351 a continuación de forma directa, sin necesidad de especificar el
2352 nombre del grob o el contexto. Para que esto funcione, es necesario
2353 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
2354 al objeto al que se aplica, después de que el archivo de entrada se ha
2355 convertido en un flujo musical. Con frecuencia no es el caso, pues
2356 muchos elementos adicionales se insertan en la corriente musical de
2357 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
2358 parte de un acorde, LilyPond inserta implícitamente un evento
2359 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
2360 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
2361 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
2362 en el flujo musical, permaneciendo así adyacente a la nota, y con la
2363 posibilidad de modificarla.
2367 @lilypond[verbatim,fragment,quote]
2368 <\tweak color #red c''>4
2372 pero esto no funciona:
2374 @lilypond[verbatim,fragment,quote]
2375 \tweak color #red c''4
2380 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
2381 consulte @rlearning{Métodos de trucaje}.
2383 Si se colocan varios elementos similares en el mismo momento
2384 musical, la instrucción @code{\override} no se puede usar para
2385 modificar uno solo de ellos: aquí es donde se debe usar la
2386 instrucción @code{\tweak}. Entre los elementos que pueden
2387 aparecer más de una vez en el mismo momento musical están los
2390 @c TODO expand to include any further uses of \tweak
2392 @item las cabezas de las notas de un acorde
2393 @item signos de articulación sobre la misma nota
2394 @item ligaduras de unión entre notas de un acorde
2395 @item corchetes de grupos especials que comienzan en el mismo momento
2398 @c TODO add examples of these
2400 @cindex acorde, modificación de una nota
2402 En este ejemplo se modifican el color de una cabeza y el tipo de
2403 otra, dentro del mismo acorde:
2405 @lilypond[verbatim,fragment,quote]
2410 \tweak duration-log #1
2415 @code{\tweak} se puede usar para modificar ligaduras de expresión:
2417 @lilypond[verbatim,quote]
2418 \relative { c'-\tweak thickness #5 ( d e f) }
2422 Para que funcione la instrucción @code{\tweak}, debe permanecer
2423 adyacente al objeto al que se ha de aplicar después de que el código
2424 de entrada se ha convertido a un flujo musical. El trucaje de un
2425 acorde completo no hace nada porque su evento musical actúa solamente
2426 como un contenedor, y todos los objetos de presentación se crean a
2427 partir de eventos dentro del @code{EventChord}:
2429 @lilypond[verbatim,fragment,quote]
2430 \tweak color #red c''4
2431 \tweak color #red <c'' e''>4
2432 <\tweak color #red c'' e''>4
2435 La instrucción @code{\tweak} sencilla no se puede usar para
2436 modificar ningún objeto que no se haya creado directamente a
2437 partir de la entrada. Concretamente, no afecta a las plicas,
2438 barras automáticas ni alteraciones, porque éstos se generan
2439 posteriormente por parte de objetos de presentación
2440 @code{NoteHead} más que por elementos musicales del flujo de
2443 Tales objetos de presentación creados indirectamente se pueden
2444 trucar usando la forma de la instrucción @code{\tweak} en que el
2445 nombre del grob se especifica de forma explícita:
2447 @lilypond[fragment,verbatim,quote]
2448 \tweak Stem.color #red
2449 \tweak Beam.color #green c''8 e''
2450 <c'' e'' \tweak Accidental.font-size #-3 ges''>4
2453 No se puede usar @code{\tweak} para modificar las claves o las
2454 indicaciones de compás, porque éstos se separan de cualquier
2455 instrucción @code{\tweak} precedente dentro del flujo de entrada
2456 merced a la inserción automática de elementos adicionales que se
2457 requieren para especificar el contexto.
2459 Se pueden colocar varias instrucciones @code{\tweak} antes de un
2460 elemento de notación; todos le afectan:
2462 @lilypond[verbatim,fragment,quote]
2464 -\tweak style #'dashed-line
2465 -\tweak dash-fraction #0.2
2466 -\tweak thickness #3
2472 El flujo musical que se genera a partir de una sección de un
2473 archivo de entrada (incluido cualquier elemento insertado
2474 automáticamente) puede examinarse, véase
2475 @rextend{Presentación de las expresiones musicales}. Esto puede
2476 ser de utilidad en la determinación de lo que puede modificarse
2477 por medio de una instrucción @code{\tweak}.
2480 Manual de aprendizaje:
2481 @rlearning{Métodos de trucaje}.
2483 Manual de extensión:
2484 @rextend{Presentación de las expresiones musicales}.
2488 @cindex trucar puntos de control
2489 @cindex control, trucar puntos de
2491 No se puede usar la instrucción @code{\tweak} para modificar los
2492 puntos de control de una sola de varias ligaduras de unión dentro
2493 de un acorde, aparte de la primera que se encuentre en el código
2497 @node set frente a override
2498 @subsection @code{\set} frente a @code{\override}
2499 @translationof set versus override
2501 @c TODO Should't a bunch of that be explained earlier?
2506 Tanto la instrucción @code{\set} como @code{\override} manipulan
2507 propiedades asociadas a contextos. En ambos casos las propiedades
2508 siguen una@emph{jerarquía de contextos}: las propiedades que no se
2509 establecen dentro del contexto aún presentan los valores del
2510 contexto de su padre respectivo.
2512 El valor y la duración en el tiempo de una propiedad de contexto
2513 son dinámicos y están disponibles solamente cuando la música se
2514 está interpretando o @q{iterando}. En el momento de la creación
2515 del contexto, se inicializan las propiedades a partir de las
2516 definiciones correspondientes (así como otras posibles
2517 modificaciones) de dicho contexto. Cualquier cambio posterior se
2518 obtiene a través de instrucciones de establecimiento de
2519 propiedades dentro de la propia música.
2521 Las definiciones de grob (objetos gráficos) son una clase
2522 @emph{especial} de propiedades de contexto, pues su estructura y
2523 uso son distintos de las propiedades de contexto ordinarias. A
2524 diferencia de las propiedades de los contextos normales, las
2525 definiciones de grob se subdividen en @emph{propiedades de grob}.
2527 Además, en contraste con las propiedades de contexto normales, las
2528 definiciones de grob tienen su propio conjunto de @q{utilidades de
2529 mantenimiento} de las propiedades individuales y, en su caso,
2530 sub-propiedades. Esto supone que es posible definir las distintas
2531 partes dentro de diferentes contextos y aún tener la definición
2532 completa del grob en el momento de su creación, montada a partir
2533 de todas las piezas proporcionadas por el contexto actual y su
2534 ancestro o ancestros, conjuntamente.
2536 Un grob u objeto gráfico se crea normalmente por parte de un
2537 grabador en el momento de la interpretación de una expresión
2538 musical y recibe sus propiedades iniciales de la definición de
2539 grob en curso del contexto del grabador. El grabador (u otras
2540 partes del @q{backend} de LilyPond) pueden después modificar (o
2541 añadirse a) las propiedades iniciales del grob; sin embargo, ello
2542 no afecta a la definición de grob del contexto.
2544 Lo que LilyPond conoce como @q{propiedades de grob} en el contexto
2545 del trucaje a nivel de usuario son en realidad las propiedades de
2546 la definición de grob de un contexto.
2548 Se accede a las definiciones de grob con un conjunto de
2549 instrucciones diferente. Se manipulan usando @code{\override} y
2550 @code{\revert} y tienen un nombre que empieza con una letra
2551 mayúscula (como @samp{NoteHead}) mientras que las propiedades de
2552 contexto ordinarias se manipulan utilizando @code{\set} y
2553 @code{\unset} y se nombran empezando en letra minúscula.
2555 @cindex tweak, relación con @code{\override}
2557 @funindex \overrideProperty
2559 Las instrucciones @code{\tweak} y @code{\overrideProperty} cambian
2560 las propiedades de grob pasando por encima de las propiedades de
2561 contexto completamente. En su lugar, atrapan a los grobs tan
2562 pronto se crean, y establecen propiedades sobre ellos directamente
2563 con @code{\tweak} cuando se originan a partir de un evento musical
2564 o, en el caso de @code{\overrideProperty}, para una sobreescritura
2567 @node Modificación de las listas-A
2568 @subsection Modificación de las listas-A
2569 @translationof Modifying alists
2571 Ciertas propiedades configurables por parte del usuario se
2572 representan internamente como @emph{listas-A} (listas
2573 asociativas), que almacenan duplas de @emph{claves} y
2574 @emph{valores}. La estructura de una lista-A es la siguiente:
2577 '((@var{clave1} . @var{valor1})
2578 (@var{clave2} . @var{valor2})
2579 (@var{clave3} . @var{valor3})
2583 Si una lista-A es una propiedad de un grob o una variable de
2584 @code{\paper}, sus claves se pueden modificar individualmente sin
2585 que afecte a las otras claves.
2587 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2588 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2589 del grob @code{StaffGrouper}. La propiedad es una lista-A con
2590 cuatro claves: @code{basic-distance} (distancia básica),
2591 @code{minimum-distance} (distancia mínima), @code{padding}
2592 (relleno) y @code{stretchability} (ampliabilidad). Los ajustes
2593 estándar para esta propiedad se relacionan en la sección
2594 @qq{Backend} de la Referencia de Funcionamiento Interno (véase
2595 @rinternals{StaffGrouper}):
2598 '((basic-distance . 9)
2599 (minimum-distance . 7)
2601 (stretchability . 5))
2604 Una forma de acercar los pentagramas entre sí es reducir el valor
2605 de la clave @code{basic-distance} (@code{9}) para que se
2606 corresponda con el valor de @code{minimum-distance} (@code{7}).
2607 Para modificar una única clave de forma individual, utilice una
2608 @emph{declaración anidada}:
2610 @lilypond[quote,verbatim]
2611 % default space between staves
2613 \new Staff { \clef treble c''1 }
2614 \new Staff { \clef bass c1 }
2617 % reduced space between staves
2618 \new PianoStaff \with {
2619 % this is the nested declaration
2620 \override StaffGrouper.staff-staff-spacing.basic-distance = #7
2622 \new Staff { \clef treble c''1 }
2623 \new Staff { \clef bass c1 }
2627 La utilización de una declaración anidada actualiza la clave
2628 especificada (como @code{basic-distance} en el ejemplo anterior)
2629 sin alterar ninguna de las otras claves que ya se habían
2630 establecido para la misma propiedad.
2632 Ahora, supongamos que deseamos que los pentagramas estén tan
2633 próximos como sea posible sin que se superpongan. La manera más
2634 sencilla de hacerlo es establecer las cuatro claves de la lista-A
2635 a cero. Sin embargo, no es necesario escribir cuatro
2636 declaraciones anidadas, una por cada clave. En lugar de eso, se
2637 puede redefinir completamente la propiedad con una sola
2638 declaración, como una lista-A:
2640 @lilypond[quote,verbatim]
2641 \new PianoStaff \with {
2642 \override StaffGrouper.staff-staff-spacing =
2643 #'((basic-distance . 0)
2644 (minimum-distance . 0)
2646 (stretchability . 0))
2648 \new Staff { \clef treble c''1 }
2649 \new Staff { \clef bass c1 }
2653 Observe que cualquier clave que no haya sido relacionada
2654 explícitamente en la definición de la lista-A, será reiniciada a
2655 sus valores @emph{predeterminados si no se han fijado}. En el
2656 caso de @code{staff-staff-spacing}, el valor de cualquier clave no
2657 fijada se reiniciaría a cero (excepto @code{stretchability}, que
2658 toma el valor de @code{basic-distance} si no se fija). Así, las
2659 dos declaraciones siguientes son equivalentes:
2662 \override StaffGrouper.staff-staff-spacing =
2663 #'((basic-distance . 7))
2665 \override StaffGrouper.staff-staff-spacing =
2666 #'((basic-distance . 7)
2667 (minimum-distance . 0)
2669 (stretchability . 7))
2672 Una consecuencia de esto (posiblemente no intencionada) es la
2673 eliminación de cualquier valor estándar que se establezca en un
2674 archivo de inicio y que se carga cada vez que se compila un
2675 archivo de entrada. En el ejemplo anterior, los ajustes estándar
2676 para @code{padding} y @code{minimum-distance} (definidos en
2677 @file{scm/define-grobs.scm}) se reinician a sus valores
2678 predeterminados si no se han fijado (cero para las dos claves).
2679 La definición de una propiedad o variable como una lista-A (de
2680 cualquier tamaño) siempre reinicia todos los valores de clave no
2681 establecidos a sus valores predeterminados si no se han fijado.
2682 Ano ser que este sea el resultado deseado, es más seguro
2683 actualizar los valores de clave individualmente con una
2684 declaración anidada.
2686 @warning{Las declaraciones anidadas no funcionan para las listas-A
2687 de propiedades de contexto (como @code{beamExceptions},
2688 @code{keyAlterations}, @code{timeSignatureSettings}, etc.). Estas
2689 propiedades sólo se pueden modificar redefiniéndolas completamente
2693 @node Conceptos y propiedades útiles
2694 @section Conceptos y propiedades útiles
2695 @translationof Useful concepts and properties
2699 * Modos de entrada::
2700 * Dirección y posición::
2701 * Distancias y medidas::
2703 * Propiedades del símbolo del pentagrama::
2704 * Objetos de extensión::
2705 * Visibilidad de los objetos::
2706 * Estilos de línea::
2707 * Rotación de objetos::
2710 @node Modos de entrada
2711 @subsection Modos de entrada
2712 @translationof Input modes
2714 La forma en que se interpreta la notación contenida dentro de un
2715 archivo de entrada, está determinada por el modo de entrada en
2718 @subsubsubheading Modo de acordes
2720 Se activa con la instrucción @code{\chordmode} y produce que la
2721 entrada se interprete con al sintaxis de la notación de acordes,
2722 véase @ref{Notación de acordes}. Los acordes se imprimen como
2723 notas sobre un pentagrama.
2725 El modo de acordes se activa también con la instrucción
2726 @code{\chords}. Esto crea también un contexto @code{ChordNames}
2727 nuevo y produce que el código que sigue se interprete con la
2728 sintaxis de la notación de acordes y se imprima como nombres de
2729 acorde dentro del contexto @code{ChordNames}, véase @ref{Impresión
2730 de los nombres de acorde}.
2732 @subsubsubheading Modo de percusión
2734 Se activa con la instrucción @code{\drummode} y produce que el
2735 código de entrada se interprete con la sintaxis de la notación de
2736 percusión, véase @ref{Notación básica de percusión}.
2738 El modo de percusión también se activa con la instrucción
2739 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y
2740 hace que el código que sigue se interprete con la sintaxis de la
2741 notación de percusión y se imprima como símbolos de percusión
2742 sobre un pentagrama de percusión, véase @ref{Notación básica de
2745 @subsubsubheading Modo de cifras
2747 Se activa con la instrucción @code{\figuremode} y hace que el código
2748 de entrada se interprete con la sintaxis del bajo cifrado, véase
2749 @ref{Introducir el bajo cifrado}.
2751 El modo de cifras también se activa con la instrucción
2752 @code{\figures}. También crea un contexto de @code{FiguredBass}
2753 nuevo y hace que el código que viene a continuación se interprete
2754 con la sintaxis del bajo cifrado y se imprima como símbolos de
2755 bajo cifrado dentro del contexto @code{FiguredBass}, véase
2756 @ref{Introducción al bajo cifrado}.
2758 @subsubsubheading Modos de traste y tablatura
2760 No existen modos de entrada especiales para introducir símbolos de
2761 trastes y de tablatura.
2763 Para crear diagramas de trastes, escriba las notas o acordes en el
2764 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2765 véase @ref{Tablaturas predeterminadas}.
2767 Para crear diagramas de trastes encima de un pentagrama, podemos
2768 elegir entre dos posibilidades. Se puede usar el contexto
2769 @code{FretBoards} (véase @ref{Diagramas de traste automáticos}) o
2770 se pueden introducir como elementos de marcado encima de las notas
2771 utilizando la instrucción @code{\fret-diagram}, véase
2772 @ref{Marcas de diagramas de trastes}.
2774 @subsubsubheading Modo de letra
2776 Se activa con la instrucción @code{\lyricmode}, y hace que la
2777 entrada se interprete como sílabas de la letra de la canción con
2778 duraciones opcionales y modificadores de letra asociados, véase
2781 El modo de letra también se habilita con la instrucción
2782 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics}
2783 nuevo y una instrucción @code{\lyricsto} implícita que asocia la
2784 letra que viene a continuación con la música precedente.
2786 @subsubsubheading Modo de marcado
2788 Se activa con la instrucción @code{\markup}, y hace que la entrada
2789 se interprete con la sintaxis del marcado, véase
2790 @ref{Text markup commands}.
2792 @subsubsubheading Modo de notas
2794 Es el modo predeterminado o se puede activar con la instrucción
2795 @code{\notemode}. La entrada se interpreta como alturas,
2796 duraciones, marcado, etc. y se imprime como notación musical sobre
2799 Normalmente no es necesario especificar el modo de notas de forma
2800 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2801 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2802 otro modo y queremos insertar algo que solamente se puede hacer
2803 con la sintaxis del modo de notas.
2806 @node Dirección y posición
2807 @subsection Dirección y posición
2808 @translationof Direction and placement
2810 Al tipografiar música, la dirección y colocación de muchos
2811 elementos es cuestión de elección. Por ejemplo, las plicas de las
2812 notas se pueden dirigir hacia arriba o hacia abajo; la letra, las
2813 indicaciones dinámicas y otras marcas expresivas se pueden colocar
2814 encima o debajo del pentagrama; el texto se pude alinear a la
2815 izquierda, a la derecha o centrado; etc. La mayoría de estas
2816 elecciones pueden dejarse que LilyPond las determine
2817 automáticamente, pero en ciertos casos puede ser deseable forzar
2818 una dirección o colocación concreta.
2821 * Indicadores de dirección de las articulaciones::
2822 * La propiedad de dirección::
2826 @node Indicadores de dirección de las articulaciones
2827 @unnumberedsubsubsec Indicadores de dirección de las articulaciones
2828 @translationof Articulation direction indicators
2830 De forma predeterminada algunas direcciones siempre son hacia
2831 arriba o siempre hacia abajo (p. ej. los matices o el calderón),
2832 mientras que otras cosas pueden alternar entre arriba y abajo en
2833 función de la dirección de las plicas (como las ligaduras o los
2836 @c TODO Add table showing these
2838 Se puede sobreescribir la acción predeterminada mediante el
2839 prefijado de la articulación por un @emph{indicacor de dirección}.
2840 Están disponibles tres indicadores de dirección: @code{^} (que
2841 significa @qq{arriba}), @code{_} (que significa @qq{abajo}) o
2842 @code{-} (que significa @qq{usar la dirección predeterminada}).
2843 El indicador de dirección se puede normalmente omitir, en cuyo
2844 caso se supone el indicador predeterminado @code{-}, pero se
2845 necesita un indicador de dirección @strong{siempre} antes de:
2848 @item las instrucciones @code{\tweak}
2849 @item las instrucciones @code{\markup}
2850 @item las instrucciones @code{\tag}
2851 @item los marcados de cadena, p.ej. -"cadena"
2852 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2853 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2856 Estas indicaciones afectan sólo a la nota siguiente.
2858 @lilypond[verbatim,quote]
2868 @node La propiedad de dirección
2869 @unnumberedsubsubsec La propiedad de dirección
2870 @translationof The direction property
2872 La posición o dirección de muchos objetos de presentación está
2873 controlada por la propiedad @code{direction}.
2875 El valor de la propiedad @code{direction} se puede establecer al
2876 valor @code{1}, con el significado de @qq{hacia arriba} o
2877 @qq{encima}, o a @w{@code{-1}}, con el significado de @qq{hacia
2878 abajo} o @qq{debajo}. Se pueden usar los símbolos @code{UP} y
2879 @code{DOWN} en sustitución de @code{1} y @w{@code{-1}}
2880 respectivamente. La dirección predeterminada se puede especificar
2881 estableciendo @code{direction} a @code{0} ó a @code{CENTER}. De
2882 forma alternativa, en muchos casos existen instrucciones
2883 predefinidas para especificar la dirección. Todas ellas son de la
2887 @code{\xxxUp}, @code{\xxxDown} o @code{\xxxNeutral}
2891 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
2892 predeterminada}. Véase @rlearning{Objetos interiores al
2895 En alguna que otra ocasión como en el arpegio, el valor de la
2896 propiedad @code{direction} puede especificar si el objeto se debe
2897 colocar a la izquierda o a la derecha del objeto padre. En este
2898 caso @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y
2899 @code{1} ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó
2900 @code{CENTER} significan @qq{utilizar la dirección
2903 Estas indicaciones afectan a todas las notas hasta que son
2906 @lilypond[verbatim,quote]
2917 En música polifónica, en general es mejor especificar una voz
2918 explícita que cambiar la dirección de un objeto. Para ver más
2919 información, véase @ref{Varias voces}.
2922 Manual de aprendizaje:
2923 @rlearning{Objetos interiores al pentagrama}.
2925 Referencia de la notación:
2929 @node Distancias y medidas
2930 @subsection Distancias y medidas
2931 @translationof Distances and measurements
2933 @cindex distancias absolutas
2934 @cindex distancias escaladas
2941 Las distancias en LilyPond son de dos tipos: absolutas y
2944 Las distancias absolutas se usan para especificar márgenes,
2945 sangrados y otros detalles de diseño de página, y de forma
2946 predeterminada se especifican en milímetros. Las distancias se
2947 pueden especificar en otras unidades escribiendo después de la
2948 cifra indicativa de la cantidad, @code{\mm}, @code{\cm},
2949 @code{\in}@tie{}(pulgadas), o @code{\pt}@tie{}(puntos, 1/72.27
2950 pulgadas). Las distancias de diseño de página se pueden
2951 especificar también en unidades escalables (véase el párrafo
2952 siguiente) adjuntando @code{\staff-space} a la cantidad. La
2953 disposición de página se describe en detalle en @ref{Disposición
2956 Las distancias escaladas siempre se especifican en unidades de un
2957 espacio del pentagrama o, más raramente, medio espacio del
2958 pentagrama. El espacio de pentagrama es la distancia entre dos
2959 líneas del pentagrama adyacentes. El valor predeterminado se
2960 puede cambiar globalmente fijando el tamaño global del pentagrama,
2961 o se puede sobreescribir localmente cambiando la propiedad
2962 @code{staff-space} del objeto @code{StaffSymbol}. Las distancias
2963 escaladas se escalan automáticamente con cualquier cambio al
2964 tamaño global del pentagrama o a la propiedad @code{staff-space}
2965 del objeto @code{StaffSymbol}, pero las fuentes tipográficas se
2966 escalan solamente con los cambios efectuados al tamaño global del
2967 pentagrama. Así, el tamaño global del pentagrama posibilita la
2968 fácil variación del tamaño general de una partitura impresa. Para
2969 ver los métodos de establecimiento del tamaño global del
2970 pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2974 Si se necesita dibujar sólo una sección de una partitura a una
2975 escala distinta, por ejemplo una sección ossia o una nota al pie,
2976 no se puede simplemente cambiar el tamaño global del pentagrama
2977 porque esto afectaría a toda la partitura. En tales casos, el
2978 cambio de tamaño se hace sobreescribiendo tanto la propiedad
2979 @code{staff-space} de @code{StaffSymbol} como el tamaño de las
2980 fuentes tipográficas. Está a nuestra disposición una función de
2981 Scheme, @code{magstep}, para convertir de un cambio en el tamaño
2982 de la fuente al cambio equivalente en @code{staff-space}. Para
2983 ver una explicación y un ejemplo de su utilización, consulte
2984 @rlearning{Longitud y grosor de los objetos}.
2987 Manual de aprendizaje:
2988 @rlearning{Longitud y grosor de los objetos}.
2990 Referencia de la notación:
2991 @ref{Disposición de la página},
2992 @ref{Establecer el tamaño del pentagrama}.
2996 @subsection Dimensiones
2997 @translationof Dimensions
3000 @cindex caja circundante
3002 Las dimensiones de un objeto gráfico especifican las posiciones de
3003 los límites izquierdo y derecho, así como los límites inferior y
3004 superior de las cajas limítrofes de los objetos como distancias a
3005 partir del punto de referencia del objeto en unidades de espacios
3006 de pentagrama. Estas posiciones se codifican frecuentemente como
3007 dos parejas de valores de Scheme. Por ejemplo, la instrucción de
3008 marcado de texto @code{\with-dimensions} toma tres argumentos, de
3009 los cuales los dos primeros son una pareja de Scheme que da las
3010 posiiciones de los bordes izquierdo y derecho y otra pareja de
3011 Scheme que da las posiciones de los límites inferior y superior:
3014 \with-dimensions #'(-5 . 10) #'(-3 . 15) @var{arg}
3017 Esto especifica una caja circundante para @var{arg} con su límite
3018 izquierdo en -5, su límite derecho en 10, el inferior en -3 y el
3019 superior e 15, todos ellos medidos a partir del punto de
3020 referencia del objeto en unidades de espacios de pentagrama.
3023 Referencia de la notación:
3024 @ref{Distancias y medidas}.
3027 @node Propiedades del símbolo del pentagrama
3028 @subsection Propiedades del símbolo del pentagrama
3029 @translationof Staff symbol properties
3031 @cindex ajuste del símbolo del pentagrama
3032 @cindex dibujar el símbolo del pentagrama
3033 @cindex pentagrama, establecer el símbolo del
3035 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
3036 @c Need to think of uses for these properties. Eg 'line-positions
3037 @c is used in a snippet to thicken centre line.
3038 @c If retained, add @ref to here in 1.6.2 -td
3040 Se puede definir al mismo tiempo la posición vertical de las
3041 líneas de la pauta y el número de líneas de la misma. Como
3042 muestra el siguiente ejemplo, las posiciones de las notas no están
3043 influidas por las posiciones de las líneas de la pauta.
3045 @warning{La propiedad @code{'line-positions} sobreescribe a la
3046 propiedad @code{'line-count}. El número de líneas de la pauta
3047 está definido implícitamente por el número de elementos de la
3048 lista de valores de @code{'line-positions}.}
3050 @lilypond[verbatim,quote]
3052 \override StaffSymbol.line-positions = #'(7 3 0 -4 -6 -7)
3054 \relative { a4 e' f b | d1 }
3057 Se puede modificar la anchura de la pauta. Las unidades son
3058 espacios de pentagrama. El espaciado de los objetos dentro del
3059 pentagrama no resulta afectado por este ajuste.
3061 @lilypond[verbatim,quote]
3063 \override StaffSymbol.width = #23
3065 \relative { a4 e' f b | d1 }
3069 @node Objetos de extensión
3070 @subsection Objetos de extensión
3071 @translationof Spanners
3073 Muchos objetos de notación musical abarcan varias notas o incluso
3074 varios compases. Son ejemplos los crescendi, trinos, corchetes de
3075 grupo especial y corchetes de primera y segunda vez. Estos
3076 objetos se llaman @qq{spanners} u «objetos de extensión», y tienen
3077 propiedades especiales para controlar su apariencia y
3078 comportamiento. Algunas de estas propiedades son comunes a todos
3079 los objetos de extensión; otras se limitan a un subconjunto de los
3082 Todos los objetos de extensión contemplan el interface
3083 @code{spanner-interface}. Algunos, básicamente aquellos que
3084 trazan una línea recta entre los dos objetos, contemplan también
3085 el interface @code{line-spanner-interface}.
3088 * Uso del spanner-interface::
3089 * Uso del line-spanner-interface::
3092 @node Uso del spanner-interface
3093 @unnumberedsubsubsec Uso del @code{spanner-interface}
3094 @translationof Using the spanner-interface
3096 Este interface proporciona dos propiedades que se aplican a varios
3099 @subsubsubheading La propiedad @code{minimum-length} (longitud mínima)
3101 La longitud mínima del objeto de extensión se especifica a través
3102 de la propiedad @code{minimum-length}. Su aumento suele producir
3103 el efecto necesario de aumentar el espaciado de las notas entre
3104 los dos puntos extremos. Sin embargo, esta sobreescritura no
3105 tiene ningún efecto sobre muchos extensores, pues su longitud está
3106 determinada por otras consideraciones. Más abajo se muestran
3107 algunos ejemplos de dónde es efectiva.
3117 Works as long as callback is made:
3121 Works not at all for:
3130 @lilypond[verbatim,quote,fragment]
3133 % increase the length of the tie
3134 -\tweak minimum-length #5
3138 @lilypond[verbatim,quote]
3139 \relative \compressMMRests {
3142 % increase the length of the rest bar
3143 \once \override MultiMeasureRest.minimum-length = #20
3149 @lilypond[verbatim,quote]
3152 % increase the length of the hairpin
3153 \override Hairpin.minimum-length = #20
3158 Esta sobreescritura se puede usar también para aumentar la
3159 longitud de las ligaduras de expresión y de fraseo:
3161 @lilypond[verbatim,quote]
3165 -\tweak minimum-length #5
3170 -\tweak minimum-length #5
3175 Para algunos objetos de presentación, la propiedad
3176 @code{minimum-length} es efectiva sólo si se llama explícitamente
3177 al procedimiento @code{set-spacing-rods}. Para hacerlo, se debe
3178 fijar la propiedad @code{springs-and-rods} al valor
3179 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud
3180 mínima de un glissando no tiene efecto a no ser que se establezca
3181 la propiedad @code{springs-and-rods}:
3183 @lilypond[verbatim,fragment,quote]
3187 % not effective alone
3188 \once \override Glissando.minimum-length = #20
3191 % effective only when both overrides are present
3192 \once \override Glissando.minimum-length = #20
3193 \once \override Glissando.springs-and-rods = #ly:spanner::set-spacing-rods
3197 Lo mismo se puede decir del objeto @code{Beam}:
3199 @lilypond[verbatim,fragment,quote]
3200 % not effective alone
3201 \once \override Beam.minimum-length = #20
3204 % effective only when both overrides are present
3205 \once \override Beam.minimum-length = #20
3206 \once \override Beam.springs-and-rods = #ly:spanner::set-spacing-rods
3210 @subsubsubheading La propiedad @code{to-barline}
3212 La segunda propiedad útil del @code{spanner-interface} es
3213 @code{to-barline}. De forma predeterminada tiene el valor cierto,
3214 haciendo que los reguladores y otros objetos de extensión que
3215 terminan sobre la primera nota de un compás, en vez de eso
3216 terminen en la línea divisoria inmediatamente precedente. Si se
3217 establece al valor falso, el extensor llegará más allá de la barra
3218 de compás y terminará exactamente sobre la nota:
3220 @lilypond[verbatim,quote]
3222 a' \< a a a a \! a a a \break
3223 \override Hairpin.to-barline = ##f
3224 a \< a a a a \! a a a
3228 Esta propiedad no es efectiva para todos los extensores. Por
3229 ejemplo, su establecimiento a @code{#t} no tienen ningún efecto
3230 sobre las ligaduras de expresión o de fraseo, o sobre otros
3231 extensores para los que terminar en la barra de compás no tendría
3234 @node Uso del line-spanner-interface
3235 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
3236 @translationof Using the line-spanner-interface
3238 Entre los objetos que contemplan el interface
3239 @code{line-spanner-interface} se encuentran
3242 @item @code{DynamicTextSpanner}
3243 @item @code{Glissando}
3244 @item @code{TextSpanner}
3245 @item @code{TrillSpanner}
3246 @item @code{VoiceFollower}
3249 La rutina responsable de dibujar los sellos de estos extensores es
3250 @code{ly:line-spanner::print}. esta rutina determina la
3251 localización exacta de los dos puntos extremos y traza una línea
3252 entre ellos, en el estilo solicitado. Las posiciones de los dos
3253 puntos extremos del extensor se calculan al vuelo, pero es posible
3254 sobreescribir sus coordenadas Y. Las propiedades que se deben
3255 especificar están anidadas a dos niveles de profundidad en la
3256 jerarquía de propiedades, pero la sintaxis de la instrucción
3257 @code{\override} es bastante sencilla:
3259 @lilypond[quote,fragment,verbatim]
3261 \once \override Glissando.bound-details.left.Y = #3
3262 \once \override Glissando.bound-details.right.Y = #-2
3266 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
3267 siendo el punto del cero la línea central del pentagrama. Para el
3268 glissando, esto es el valor de @code{Y} en la coordenada X que
3269 corresponde al punto central de cada cabeza de nota si nos
3270 imaginamos que la línea se extiende hasta allí.
3272 Si no está fijado @code{Y}, su valor se calcula a partir de la
3273 posición vertical del punto de anclaje correspondiente del
3276 En caso de salto de línea, los valores para los puntos extremos se
3277 especifican por las sub-listas @code{left-broken} y
3278 @code{right-broken} de @code{bound-details}. Por ejemplo:
3280 @lilypond[ragged-right,fragment,verbatim,quote]
3281 \override Glissando.breakable = ##t
3282 \override Glissando.bound-details.right-broken.Y = #-3
3283 c''1 \glissando \break
3287 Un número de propiedades adicionales de las sub-listas @code{left}
3288 y @code{right} de la propiedad @code{bound-details} se pueden
3289 especificar de la misma forma que @code{Y}:
3293 Establece la coordenada Y del punto extremo, en desplazamientos de
3294 @code{staff-space}s desde la línea central del pentagrama. De
3295 forma predeterminada es el centro del objeto ancla, y así un
3296 glissando apunta al centro vertical de la cabeza de la nota.
3298 Para extensores horizontales como los extensores de texto y los
3299 trinos, está inamoviblemente codificado como 0.
3301 @item attach-dir (dirección de anclaje)
3302 Determina dónde comienza y termina la línea en la dirección X, con
3303 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o
3304 @code{LEFT}, izquierda) hace que la línea comience o termine en el
3305 lado izquierdo de la cabeza de la nota a la que está anclado.
3308 Es la coordenada X absoluta del punto extremo. Se suele calcular
3309 al vuelo, y su sobreescritura no tiene un efecto útil.
3311 @item stencil (sello)
3312 Los extensores de línea pueden tener símbolos al comienzo o al
3313 final, lo que está contenido en esta sub-propiedad. Esto es para
3314 uso interno; se recomienda en su lugar el uso de @code{text}.
3317 Es un elemento de marcado que se evalúa para dar lugar al sello.
3318 Se usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los
3319 objetos de extensión horizontales.
3321 @lilypond[quote,ragged-right,fragment,verbatim]
3322 \override TextSpanner.bound-details.left.text
3323 = \markup { \small \bold Slower }
3324 \relative { c''2\startTextSpan b c a\stopTextSpan }
3327 @item stencil-align-dir-y (alineación del sello en y)
3328 @item stencil-offset (desplazamiento del sello)
3329 Si no se modifican uno u otro, el sello se coloca sencillamente en
3330 el punto extremo, centrado sobre la línea, como viene definido por
3331 las subpropiedades @code{X} e @code{Y}. Si se fijan
3332 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
3333 símbolo del borde verticalmente con relación al extremo de la
3336 @lilypond[quote,fragment,verbatim]
3337 \override TextSpanner.bound-details.left.stencil-align-dir-y = #-2
3338 \override TextSpanner.bound-details.right.stencil-align-dir-y = #UP
3340 \override TextSpanner.bound-details.left.text = #"ggg"
3341 \override TextSpanner.bound-details.right.text = #"hhh"
3343 \relative { c'4^\startTextSpan c c c \stopTextSpan }
3346 Observe que los valores negativos mueven el texto @emph{hacia
3347 arriba}, al contrario de lo que podría esperarse, pues el valor de
3348 @w{@code{-1}} o @code{DOWN} (abajo) significa alinear el borde
3349 @emph{inferior} del texto con la línea de extensión. Un valor de
3350 @code{1} o @code{UP} (arriba) alinea el borde superior del texto
3351 con la línea extensora.
3353 @item arrow (flecha)
3354 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
3355 flecha en el extremo de la línea.
3357 @item padding (relleno)
3358 Esta sub-propiedad controla el espacio entre el punto extremo
3359 especificado de la línea y el extremo real. Sin relleno, un
3360 glissando empezaría y terminaría en el centro de la cabeza de las
3365 La función musical @code{\endSpanners} finaliza de forma prematura
3366 el extensor que comienza sobre la nota que sigue inmediatamente a
3367 continuación. Se termina después de una nota exactamente, o en la
3368 siguiente barra de compás si @code{to-barline} es verdadero y se
3369 produce una divisoria antes de la siguiente nota.
3371 @lilypond[verbatim,quote,ragged-right]
3374 c2 \startTextSpan c2 c2
3380 Si se usa @code{\endSpanners} no es necesario cerrar
3381 \startTextSpan con \stopTextSpan, ni cerrar los reguladores con
3385 Referencia de funcionamiento interno:
3386 @rinternals{TextSpanner},
3387 @rinternals{Glissando},
3388 @rinternals{VoiceFollower},
3389 @rinternals{TrillSpanner},
3390 @rinternals{line-spanner-interface}.
3393 @node Visibilidad de los objetos
3394 @subsection Visibilidad de los objetos
3395 @translationof Visibility of objects
3397 @cindex objetos, visibilidad de
3398 @cindex grobs, visibilidad de
3399 @cindex visibilidad de los objetos
3401 Hay cuatro formas principales en que se puede controlar la
3402 visibilidad de los objetos de presentación: se puede eliminar su
3403 sello, se pueden volver transparentes, se pueden pintar de blanco,
3404 o se puede sobreescribir su propiedad @code{break-visibility}.
3405 Las tres primeras se aplican a todos los objetos de presentación;
3406 la última sólo a unos pocos: los objetos @emph{divisibles}. El
3407 Manual de aprendizaje introduce estas cuatro técnicas, véase
3408 @rlearning{Visibilidad y color de los objetos}.
3410 Hay también algunas otras técnicas que son específicas de ciertos
3411 objetos de presentación. Se estudian bajo Consideraciones
3415 * Eliminar el sello::
3416 * Hacer transparentes los objetos::
3417 * Pintar los objetos de blanco::
3418 * Uso de break-visibility (visibilidad en el salto)::
3419 * Consideraciones especiales::
3423 @node Eliminar el sello
3424 @unnumberedsubsubsec Eliminar el sello
3425 @translationof Removing the stencil
3427 @cindex sello, eliminar
3430 Todo objeto de presentación tiene una propiedad stencil (sello).
3431 De forma predeterminada está establecida a la función específica
3432 que dibuja ese objeto. Si se sobreescribe esta propiedad a
3433 @code{#f} no se llama a ninguna función y el objeto no se dibuja.
3434 La acción predeterminada se puede recuperar con @code{\revert}.
3436 @lilypond[quote,fragment,verbatim]
3438 \override Score.BarLine.stencil = ##f
3440 \revert Score.BarLine.stencil
3444 Esta operación, bastante común, tiene la forma abreviada
3445 @code{\omit} como atajo:
3447 @lilypond[quote,fragment,verbatim]
3451 \undo \omit Score.BarLine
3456 @node Hacer transparentes los objetos
3457 @unnumberedsubsubsec Hacer transparentes los objetos
3458 @translationof Making objects transparent
3460 @cindex transparentes, hacer los objetos
3463 Todo objeto de presentación tiene una propiedad transparent
3464 (transparente) que de forma predeterminada está establecida a
3465 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio
3468 @lilypond[quote,fragment,verbatim]
3470 \once \override NoteHead.transparent = ##t
3474 Esta operación, bastante común, tiene la forma abreviada @code{\hide}
3477 @lilypond[quote,fragment,verbatim]
3479 \once \hide NoteHead
3484 @node Pintar los objetos de blanco
3485 @unnumberedsubsubsec Pintar los objetos de blanco
3486 @translationof Painting objects white
3488 @cindex objetos, coloreado de
3489 @cindex coloreado de objetos
3491 @cindex impresión, orden de
3492 @cindex sobreescritura de objetos
3493 @cindex objetos, sobreescritura de
3494 @cindex grobs, sobreescritura de
3496 Todo objeto de presentación tiene una propiedad de color que de
3497 forma predeterminada está establecida a @code{black} (negro). Si
3498 se sobreescribe a @code{white} (blanco) el objeto será
3499 indistinguible del fondo blanco. Sin embargo, si el objeto cruza
3500 a otros objetos, el color de los puntos de cruce queda determinado
3501 por el orden en que se dibujan estos objetos, lo que puede dejar
3502 una imagen fantasma del objeto blanco, como puede verse aquí:
3504 @lilypond[quote,fragment,verbatim]
3505 \override Staff.Clef.color = #white
3509 Se puede evitar esto cambiando el orden de impresión de los
3510 objetos. Todos los objetos de presentación tienen una propiedad
3511 @code{layer} (capa) que se debe establecer a un valor entero. Los
3512 objetos con el valor de @code{layer} más bajo se dibujan primero,
3513 después se dibujan los objetos con valores progresivamente
3514 mayores, y así los objetos con valores más altos se dibujan encima
3515 de los que tienen valores más bajos. De forma predeterminada,
3516 casi todos los objetos tienen asignado un valor @code{layer} de
3517 @code{1}, aunque algunos objetos, entre ellos el pentagrama y las
3518 líneas divisorias, @code{StaffSymbol} y @code{BarLine}, tienen
3519 asignado un calor de @code{0}. El orden de impresión de los
3520 objetos con el mismo valor de @code{layer} es indeterminado.
3522 En el ejemplo de arriba, la clave blanca, con un valor
3523 @code{layer} predeterminado de @code{1}, se dibuja después de las
3524 líneas del pentagrama (valor @code{layer} predeterminado de
3525 @code{0}), sobreimpresionándolas. Para cambiarlo, se debe dar al
3526 objeto @code{Clef} un valor de @code{layer} más bajo, digamos
3527 @w{@code{-1}}, para que se dibuje antes:
3529 @lilypond[quote,fragment,verbatim]
3530 \override Staff.Clef.color = #white
3531 \override Staff.Clef.layer = #-1
3536 @node Uso de break-visibility (visibilidad en el salto)
3537 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
3538 @translationof Using break-visibility
3540 @c TODO Add making other objects breakable
3542 @cindex break-visibility
3544 Casi todos los objetos de presentación se imprimen una sola vez,
3545 pero algunos como las líneas divisorias, claves, indicaciones de
3546 compás y armaduras de tonalidad, se pueden tener que imprimir dos
3547 veces cuando se produce un salto de línea : una vez al final de la
3548 línea y otra al comienzo de la siguiente. Estos objetos reciben
3549 el nombre de @emph{divisibles}, y tienen una propiedad,
3550 @code{break-visibility} (visibilidad en el salto), para controlar
3551 su visibilidad en las tres posiciones en que pueden aparecer: al
3552 comienzo de una línea, dentro de la línea si se produce un cambio,
3553 y al final de la línea si el cambio se produce en ese lugar.
3555 Por ejemplo, la indicación de compás se imprime de forma
3556 predeterminada al comienzo de la primera línea y en ningún otro
3557 lugar a no ser que cambie, en cuyo caso se imprime en el punto en
3558 que se produce el cambio. Si este cambio se produce al final de
3559 una línea, la nueva indicación de compás se imprime al principio
3560 de la línea siguiente y también al final de la línea anterior como
3561 indicación de precaución.
3563 Este comportamiento se controla por medio de la propiedad
3564 @code{break-visibility}, que se explica en
3565 @c Leave this ref on a newline - formats incorrectly otherwise -td
3566 @rlearning{Visibilidad y color de los objetos}. Esta propiedad
3567 toma un vector de tres valores booleanos que, por orden,
3568 determinan si el objeto se imprime al final, dentro, o al
3569 principio de la línea. O, para ser más exactos: antes del salto
3570 de línea, si no hay salto, o después del salto.
3572 Como alternativa se puede especificar cualquiera de las ocho
3573 combinaciones mediante funciones predefinidas cuya definición está
3574 en @file{scm/output-lib.scm}, donde las tres últimas columnas
3575 indican si los objetos de presentación serán visibles en las
3576 posiciones que se muestran en el encabezamiento de cada columna:
3578 @multitable {@code{begin-of-line-invisible}} {@code{#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
3579 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
3580 @headitem de función @tab de vector @tab salto @tab salto @tab salto
3582 @item @code{all-visible} @tab @code{#(#t #t #t)} @tab sí @tab sí @tab sí
3583 @item @code{begin-of-line-visible} @tab @code{#(#f #f #t)} @tab no @tab no @tab sí
3584 @item @code{center-visible} @tab @code{#(#f #t #f)} @tab no @tab sí @tab no
3585 @item @code{end-of-line-visible} @tab @code{#(#t #f #f)} @tab sí @tab no @tab no
3586 @item @code{begin-of-line-invisible} @tab @code{#(#t #t #f)} @tab sí @tab sí @tab no
3587 @item @code{center-invisible} @tab @code{#(#t #f #t)} @tab sí @tab no @tab sí
3588 @item @code{end-of-line-invisible} @tab @code{#(#f #t #t)} @tab no @tab sí @tab sí
3589 @item @code{all-invisible} @tab @code{#(#f #f #f)} @tab no @tab no @tab no
3592 Los ajustes predeterminados de @code{break-visibility} dependen
3593 del objeto de presentación. La tabla siguiente muestra todos los
3594 objetos de presentación de interés que resultan afectados por
3595 @code{break-visibility} y el ajuste predeterminado de esta
3598 @multitable @columnfractions .3 .3 .4
3600 @headitem Objeto @tab Contexto usual @tab Valor predet.
3602 @c omit Ambitus as it appears not to be affected by break-visibility -td
3603 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
3604 @item @code{BarLine} @tab @code{Score} @tab calculado
3605 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
3606 @c omit the following item until it can be explained -td
3607 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
3608 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3609 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
3610 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
3611 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3612 @item @code{KeyCancellation} @tab @code{Staff} @tab @code{begin-of-line-invisible}
3613 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
3614 @c omit LeftEdge until it can be explained -td
3615 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
3616 @item @code{ClefModifier} @tab @code{Staff} @tab @code{begin-of-line-visible}
3617 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
3618 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
3622 El ejemplo de abajo muestra el uso de la forma de vector para
3623 controlar la visibilidad de las líneas divisorias:
3625 @lilypond[quote,verbatim,ragged-right]
3629 % Remove bar line at the end of the current line
3630 \once \override Score.BarLine.break-visibility = ##(#f #t #t)
3637 Aunque los tres componentes del vector utilizado para
3638 sobreescribir @code{break-visibility} deben estar presentes, no
3639 todos son efectivos para todos los objetos de presentación, y
3640 algunas combinaciones pueden incluso dar errores. Son de
3641 aplicación las siguientes limitaciones:
3645 Las líneas divisorias no se pueden imprimir al principio de la línea.
3648 No se puede imprimir el número de compás al principio de la
3649 @emph{primera} línea a no ser que su valor establecido sea
3650 distinto de @code{1}.
3652 @item Clave: véase la sección siguiente.
3655 Las repeticiones dobles de tipo porcentaje se imprimen todas
3656 siempre o bien no se imprimen nunca. Utilice @code{begin-of
3657 line-invisible} para imprimirlas y @code{all-invisible} para
3660 @item Armadura: véase la sección siguiente.
3662 @item ClefModifier: véase la sección siguiente.
3666 @node Consideraciones especiales
3667 @unnumberedsubsubsec Consideraciones especiales
3668 @translationof Special considerations
3670 @subsubsubheading Visibilidad después de un cambio explícito
3672 @cindex armadura, visibilidad después de un cambio explícito
3673 @cindex explicitKeySignatureVisibility
3674 @cindex clave, visibilidad después de un cambio explícito
3675 @cindex explicitClefVisibility
3677 La propiedad @code{break-visibility} controla la visibilidad de
3678 las armaduras y cambios de clave sólo al principio de las líneas,
3679 es decir, después de un salto. No tiene ningún efecto sobre la
3680 visibilidad de la armadura o la clave después de un cambio
3681 explícito de tonalidad o de clave dentro o al final de una línea.
3682 En el ejemplo siguiente la armadura que sigue al cambio explícito
3683 de tonalidad a Si bemol mayor es visible incluso con
3684 @code{all-invisible} establecido.
3686 @lilypond[quote,verbatim,ragged-right]
3690 % Try to remove all key signatures
3691 \override Staff.KeySignature.break-visibility = #all-invisible
3700 La visibilidad de estos cambios explícitos de tonalidad y de clave
3701 se controla por medio de las propiedades
3702 @code{explicitKeySignatureVisibility} y
3703 @code{explicitClefVisibility}. Son los equivalentes de la
3704 propiedad @code{break-visibility} y las dos toman un vector de
3705 tres valores booleanos o las funciones predefinidas relacionadas
3706 anteriormente, exactamente igual que @code{break-visibility}. Las
3707 dos son propiedades del contexto Staff, no de los propios objetos
3708 de presentación, y por tanto se establecen utilizando la
3709 instrucción @code{\set}. Las dos están establecidas de forma
3710 predeterminada al valor @code{all-visible}. Estas propiedades
3711 controlan sólo la visibilidad de las armaduras y las claves que
3712 resultan de los cambios explícitos y no afectan a las armaduras y
3713 tonalidades que están al principio de las líneas; para quitarlas,
3714 aún se debe sobreescribir la propiedad @code{break-visibility} en
3715 el objeto correspondiente.
3717 @lilypond[quote,verbatim,ragged-right]
3721 \set Staff.explicitKeySignatureVisibility = #all-invisible
3722 \override Staff.KeySignature.break-visibility = #all-invisible
3730 @subsubsubheading Visibilidad de las alteraciones de precaución
3732 Para eliminar las alteraciones de cancelación que se imprimen en
3733 un cambio de tonalidad explícito, establezca la propiedad
3734 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3736 @lilypond[quote,verbatim,ragged-right]
3740 \set Staff.explicitKeySignatureVisibility = #all-invisible
3741 \set Staff.printKeyCancellation = ##f
3742 \override Staff.KeySignature.break-visibility = #all-invisible
3750 Con estas sobreescrituras solamente permanecen las alteraciones
3751 accidentales delante de las notas para indicar el cambio de
3754 Observe que al modificar la tonalidad a Do@tie{}mayor o
3755 La@tie{}menor, las alteraciones de cancelación serían @emph{la
3756 única} indicación del cambio de armadura. En este caso, el
3757 establecimiento de @code{printKeyCancellation} al valor @code{#f}
3758 no tiene ningún efecto:
3760 @lilypond[quote,verbatim,ragged-right]
3764 \set Staff.explicitKeySignatureVisibility = #all-invisible
3765 \set Staff.printKeyCancellation = ##f
3773 En lugar de ello, para suprimir las alteraciones de cancelación
3774 aún cuando la armadura cambia a Do@tie{}mayor o a La@tie{}menor,
3775 sobreescriba la visibilidad del grob @code{KeyCancellation}:
3777 @lilypond[quote,verbatim,ragged-right]
3781 \set Staff.explicitKeySignatureVisibility = #all-invisible
3782 \override Staff.KeyCancellation.break-visibility = #all-invisible
3790 @c TODO Add visibility of cautionary accidentals before notes
3792 @subsubsubheading Líneas divisorias automáticas
3794 @cindex automaticBars
3795 @cindex líneas divisorias, eliminación
3797 Como caso especial, la impresión de las líneas divisorias también
3798 se puede inhabilitar estableciendo la propiedad
3799 @code{automaticBars} en el contexto Score. Si se fija a
3800 @code{#f}, las barras de compás no se imprimen automáticamente; se
3801 deben crear explícitamente con una instrucción @code{\bar}. A
3802 diferencia de la instrucción predefinida @code{\cadenzaOn}, los
3803 compases se siguen contando. La generación de compases continúa
3804 de acuerdo a esta cuenta si esta propiedad se establece
3805 posteriormente a @code{#t}. Si se fija al valor @code{#f}, sólo
3806 pueden producirse saltos de línea en instrucciones @code{\bar}
3811 @subsubsubheading Claves transportadas
3813 @cindex transportadas, visibilidad de las claves
3814 @cindex visibilidad de las claves transportadas
3815 @cindex claves, visibilidad de la transposición
3817 El pequeño símbolo de transposición sobre una clave se produce por
3818 parte del objeto @code{ClefModifier}. Su visibilidad se hereda
3819 automáticamente de la del objeto @code{Clef}, así que no es
3820 necesario aplicar las sobreescrituras correspondientes
3821 @code{break-visibility} a los objetos @code{ClefModifier} para
3822 suprimir los símbolos de transposición u octavación para las
3825 Para los cambios de clave explícitos, la propiedad
3826 @code{explicitClefVisibility} controla tanto el símbolo de clave
3827 como el símbolo de transposición o de octava asociado.
3830 Manual de aprendizaje:
3831 @rlearning{Visibilidad y color de los objetos}
3834 @node Estilos de línea
3835 @subsection Estilos de línea
3836 @translationof Line styles
3838 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3839 @i{accelerando} y los @i{trinos} se escriben como texto y se
3840 extienden sobre muchos compases mediante líneas, a veces punteadas
3843 Todos ellos usan las mismas rutinas que el glissando para dibujar
3844 los textos y las líneas, y por ello el ajuste fino de su
3845 comportamiento se hace de la misma manera. Se hace con un spanner
3846 (un objeto de extensión), y la rutina responsable de dibujar los
3847 objetos de extensión es @code{ly:line-spanner::print}. Esta rutina
3848 determina la colocación exacta de los dos @i{extremos del objeto
3849 de extensión} y dibuja una línea entre ellos, en el estilo
3852 He aquí un ejemplo de los distintos estilos de línea disponibles,
3853 y cómo aplicarles ajustes finos.
3855 @lilypond[ragged-right,verbatim,quote]
3858 \once \override Glissando.style = #'dashed-line
3860 \override Glissando.style = #'dotted-line
3862 \override Glissando.style = #'zigzag
3864 \override Glissando.style = #'trill
3869 Las posiciones de los puntos extremos del objeto de extensión se
3870 computan al vuelo para cada uno de los objetos gráficos, pero es
3871 posible sobreescribirlos:
3874 @lilypond[ragged-right,verbatim,quote]
3877 \once \override Glissando.bound-details.right.Y = #-2
3882 El valor de @code{Y} está establecido a @w{@code{-2}} para el
3883 extremo derecho. El lado izquierdo se puede ajustar de forma
3884 similar especificando @code{left} en vez de @code{right}.
3886 Si no está establecido @code{Y}, el valor se computa a partir de la
3887 posición vertical de los puntos de anclaje izquierdo y derecho del
3890 Son posibles otros ajustes de los extensores, para ver más
3891 detalles consulte @ref{Objetos de extensión}.
3894 @node Rotación de objetos
3895 @subsection Rotación de objetos
3896 @translationof Rotating objects
3898 Tanto los objetos de presentación como los elementos de texto de
3899 marcado se pueden girar cualquier ángulo respecto a cualquier
3900 punto, pero difiere el método de hacerlo.
3903 * Rotación de objetos de presentación::
3904 * Rotación de elementos de marcado::
3907 @node Rotación de objetos de presentación
3908 @unnumberedsubsubsec Rotación de objetos de presentación
3909 @translationof Rotating layout objects
3911 @cindex rotating objects
3912 @cindex objects, rotating
3914 Todos los objetos de presentación que contemplan el interface
3915 @code{grob-interface} se pueden rotar estableciendo su propiedad
3916 @code{rotation}. Acepta una lista de tres elementos: el ángulo de
3917 la rotación en sentido antihorario, y las coordenadas x e y del
3918 punto con relación al punto de referencia del objeto, alrededor
3919 del que se va a realizar la rotación. El ángulo de rotación se
3920 especifica en grados y las coordenadas en espacios de pentagrama.
3922 El ángulo de rotación y las coordenadas del punto de rotación se
3923 deben determinar por ensayo y error.
3925 @cindex reguladores en ángulo
3926 @cindex ángulo, reguladores en
3928 Solamente en ciertas ocasiones es útil la rotación de objetos de
3929 presentación; el ejemplo siguiente muestra una situación en que
3932 @lilypond[quote,fragment,verbatim]
3934 \override Hairpin.rotation = #'(20 -1 0)
3939 @node Rotación de elementos de marcado
3940 @unnumberedsubsubsec Rotación de elementos de marcado
3941 @translationof Rotating markup
3943 Todos los textos de marcado se pueden rotar para que se dispongan
3944 en cualquier ángulo precediéndolos de la instrucción
3945 @code{\rotate}. La instrucción acepta dos argumentos: el ángulo
3946 de rotación en grados en sentido antihorario, y el texto que
3947 rotar. Los límites que ocupa el texto no se rotan: toman su valor
3948 a partir de los extremos de las coordenadas x e y del texto
3949 rotado. En el ejemplo siguiente la propiedad
3950 @code{outside-staff-priority} del texto se establece a @code{#f}
3951 para desactivar la evitación automática de colisiones, lo que
3952 empuja al texto a una posición muy alta.
3954 @lilypond[quote,fragment,verbatim]
3955 \override TextScript.outside-staff-priority = ##f
3956 g4^\markup { \rotate #30 "a G" }
3957 b^\markup { \rotate #30 "a B" }
3958 des'^\markup { \rotate #30 "a D-Flat" }
3959 fis'^\markup { \rotate #30 "an F-Sharp" }
3963 @node Trucos avanzados
3964 @section Trucos avanzados
3965 @translationof Advanced tweaks
3967 Esta sección trata sobre distintos enfoques en la realización de
3968 ajustes finos a la apariencia de la partitura impresa.
3971 * Alineación de objetos::
3972 * Agrupación vertical de objetos gráficos::
3973 * Modificación de los sellos::
3974 * Modificación de las formas::
3975 * Modificación de objetos de extensión divididos::
3976 * Contenedores unpure-pure::
3980 Manual de aprendizaje:
3981 @rlearning{Trucar la salida},
3982 @rlearning{Otras fuentes de información}.
3984 Referencia de la notación:
3985 @ref{Explicación del Manual de referencia de funcionamiento interno},
3986 @ref{Modificar las propiedades}.
3988 Manual de extensión:
3989 @rextend{Interfaces para programadores}.
3992 @file{scm/define-grobs.scm}.
3994 Fragmentos de código:
3995 @rlsr{Tweaks and overrides}.
3997 Referencia de funcionamiento interno:
3998 @rinternals{All layout objects}.
4001 @node Alineación de objetos
4002 @subsection Alineación de objetos
4003 @translationof Aligning objects
4005 Los objetos gráficos que soportan el interface
4006 @code{self-alignment-interface} y/o el
4007 @code{side-position-interface} se pueden alinear contra un objeto
4008 colocado previamente, de diversas maneras. Para ver una lista de
4009 estos objetos, consulte @rinternals{self-alignment-interface} y
4010 @rinternals{side-position-interface}.
4012 Todos los objetos gráficos tienen un punto de referencia, una
4013 extensión horizontal y una extensión vertical. La extensión
4014 horizontal es una pareja de números que dan los desplazamientos a
4015 partir del punto de referencia de los bordes izquierdo y derecho,
4016 siendo negativos los desplazamientos hacia la izquierda. La
4017 extensión vertical es una pareja de números que dan el
4018 desplazamiento a partir del punto de referencia hasta los bordes
4019 inferior y superior, siendo negativos los desplazamientos hacia
4022 La posición de un objeto sobre el pentagrama viene dada por los
4023 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
4024 valor de @code{X-offset} da el desplazamiento desde la coordenada
4025 X del punto de referencia del objeto padre, y el valor de
4026 @code{Y-offset} da el desplazamiento a partir de la línea central
4027 del pentagrama. Los valores de @code{X-offset} y @code{Y-offset}
4028 se pueden establecer directamente o se puede dejar que se calculen
4029 por parte de procedimientos para conseguir una alineación con el
4032 @warning{Muchos objetos tienen consideraciones de posicionamiento
4033 especiales que hacen que se ignore o se modifique cualquier ajuste
4034 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
4035 objeto contemple el interface @code{self-alignment-interface}. La
4036 sobreescritura de las propiedades @code{X-offset} ó
4037 @code{Y-offset} a un valor fijo hace que se descarte la respectiva
4038 propiedad @code{self-alignment}.}
4040 Por ejemplo, una alteración accidental se puede reposicionar
4041 verticalmente estableciendo @code{Y-offset} pero los cambios a
4042 @code{X-offset} no tienen ningún efecto.
4044 Las letras de ensayo se pueden alinear con objetos divisibles como
4045 líneas divisorias, claves, armaduras e indicaciones de compás.
4046 Hay propiedades especiales que se encuentran en
4047 @code{break-aligned-interface} para el posicionamiento de las
4048 letras de ensayo sobre dichos objetos.
4051 Referencia de la notación:
4052 @ref{Uso del break-alignable-interface}.
4054 Manual de extensión:
4055 @rextend{Funciones de callback}.
4058 * Establecer directamente X-offset e Y-offset::
4059 * Uso del side-position-interface::
4060 * Uso del self-alignment-interface::
4061 * Uso del break-alignable-interface::
4065 @node Establecer directamente X-offset e Y-offset
4066 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
4067 @translationof Setting X-offset and Y-offset directly
4069 Se pueden dar valores numéricos a las propiedades @code{X-offset}
4070 y @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra
4071 tres notas con una digitación en su posición predeterminada y con
4072 los valores @code{X-offset} y @code{Y-offset} modificados.
4074 @lilypond[verbatim,fragment,quote]
4081 -\tweak X-offset #-1
4089 @node Uso del side-position-interface
4090 @unnumberedsubsubsec Uso del @code{side-position-interface}
4091 @translationof Using the side-position-interface
4093 Un objeto que contempla el @code{side-position-interface} se puede
4094 colocar junto a su objeto padre de forma que los bordes
4095 especificados de los dos objetos se toquen. El objeto se puede
4096 situar encima, debajo, a la derecha o a la izquierda del objeto
4097 padre. El padre no se puede especificar; viene determinado por el
4098 orden de los elementos en el flujo de entrada. Casi todos los
4099 objetos tienen la cabeza de la nota asociada como padre.
4101 Los valores de las propiedades @code{side-axis} y @code{direction}
4102 determinan dónde colocar el objeto, como sigue:
4104 @c TODO add an example of each to the table
4106 @multitable @columnfractions .3 .3 .3
4107 @headitem @code{side-axis} @tab @code{direction} @tab
4108 @headitem propiedad @tab propiedad @tab colocación
4110 @item @code{0} @tab @w{@code{-1}} @tab izquierda
4111 @item @code{0} @tab @code{1} @tab derecha
4112 @item @code{1} @tab @w{@code{-1}} @tab debajo
4113 @item @code{1} @tab @code{1} @tab encima
4117 Si @code{side-axis} es @code{0}, @code{X-offset} se debe
4118 establecer al procedimiento
4119 @code{ly:side-position-interface::x-aligned-side}. Este
4120 procedimiento devuelve el calor correcto de @code{X-offset} para
4121 situar el objeto al lado izquierdo o derecho del padre de acuerdo
4122 con el valor de @code{direction}.
4124 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe
4125 establecer al procedimiento
4126 @code{ly:side-position-interface::y-aligned-side}. Este
4127 procedimiento devuelve el valor correcto de @code{Y-offset} para
4128 situar el objeto encima o debajo del padre de acuerdo con el valor
4129 de @code{direction}.
4131 @c TODO Add examples
4134 @node Uso del self-alignment-interface
4135 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
4136 @translationof Using the self-alignment-interface
4138 @subsubsubheading Auto-alineación horizontal de los objetos
4140 La alineación horizontal de un objeto que contempla el interface
4141 @code{self-alignment-interface} está controlada por el valor de la
4142 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
4143 @code{X-offset} de este objeto esté establecida a
4144 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le
4145 puede dar a @code{self-alignment-X} cualquier valor real, en
4146 unidades de la mitad de la extensión X total del objeto. Los
4147 valores negativos mueven el objeto a la derecha, los positivos
4148 hacia la izquierda. Un valor de @code{0} centra el objeto sobre
4149 el punto de referencia de su padre, un valor de @w{@code{-1}}
4150 alinea el borde izquierdo del objeto sobre el punto de referencia
4151 de su padre, y un valor de @code{1} alinea el borde derecho del
4152 objeto sobre el punto de referencia de su padre. Se pueden usar
4153 los símbolos @code{LEFT}, @code{CENTER} y @code{RIGHT} en
4154 sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
4157 Normalmente se usaría la instrucción @code{\override} para
4158 modificar el valor de @code{self-alignment-X}, pero se puede usar
4159 la instrucción @code{\tweak} para alinear varias anotaciones por
4160 separado sobre una sola nota:
4162 @lilypond[quote,verbatim,fragment]
4164 -\tweak self-alignment-X #-1
4166 -\tweak self-alignment-X #0
4168 -\tweak self-alignment-X #RIGHT
4170 -\tweak self-alignment-X #-2.5
4171 ^"aligned further to the right"
4174 @subsubsubheading Auto-alineación vertical de los objetos
4176 Los objetos se pueden alinear verticalmente en una forma análoga a la
4177 alineación horizontal si la propiedad @code{Y-offset} está establecida
4178 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
4179 a menudo se encuentran implicados otros mecanismos en la alineación
4180 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
4181 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
4182 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
4183 las dimensiones verticales del objeto, que suele ser bastante pequeño,
4184 por lo que pueden requerirse números bastante grandes. Un valor de
4185 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
4186 referencia del objeto padre, un valor de @code{0} alinea el centro del
4187 objeto con el punto de referencia del padre, y un valor de @code{1}
4188 alinea el borde superior del objeto con el punto de referencia del
4189 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
4190 @code{UP} en sustitución de @w{@code{-1}},
4191 @code{0} y @code{1}, respectivamente.
4193 @emph{Auto-alineación de objetos en las dos direcciones}
4195 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
4196 alinear un objeto en las dos direcciones simultáneamente.
4198 El ejemplo siguiente muestra cómo ajustar una digitación de forma
4199 que se acerque a la cabeza dela nota.
4201 @lilypond[quote,verbatim,fragment]
4203 -\tweak self-alignment-X #0.5 % move horizontally left
4204 -\tweak Y-offset #ly:self-alignment-interface::y-aligned-on-self
4205 -\tweak self-alignment-Y #-1 % move vertically up
4210 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
4212 @c Cannot document as they do not seem to operate consistently on all objects -td
4213 @c TODO investigate further
4215 The @code{aligned-on-parent} procedures are used in the same way
4216 as the @code{aligned-on-self} procedures, they difference being
4217 that they permit an object to be aligned with the @emph{edges} of
4218 the parent rather than the parent's reference point. The following
4219 example shows the difference:
4223 @lilypond[verbatim,quote]
4229 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
4231 @c Cannot document as they do not seem to operate consistently on all objects -td
4232 @c TODO investigate further
4236 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
4239 @node Uso del break-alignable-interface
4240 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
4241 @translationof Using the break-alignable-interface
4243 @cindex alineación a objetos
4244 @cindex break-align-symbols
4246 Las letras de ensayo se pueden alinear con objetos de notación
4247 distintos a las barras de compás. Estos objetos son
4248 @code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
4249 @code{staff-bar}, @code{left-edge}, @code{key-cancellation},
4250 @code{key-signature} y @code{time-signature}.
4252 Cada tipo de objeto tiene su propio punto de referencia
4253 predeterminado, con el que se alinean las marcas de ensayo:
4255 @lilypond[verbatim,quote,fragment]
4256 % The rehearsal mark will be aligned to the right edge of the Clef
4257 \override Score.RehearsalMark.break-align-symbols = #'(clef)
4262 % The rehearsal mark will be aligned to the left edge of the Time Signature
4263 \override Score.RehearsalMark.break-align-symbols = #'(time-signature)
4269 % The rehearsal mark will be centered above the Breath Mark
4270 \override Score.RehearsalMark.break-align-symbols = #'(breathing-sign)
4279 Se puede especificar una lista de posibles objetos para la
4280 alineación. Si algunos de los objetos son invisibles en ese punto
4281 debido al valor de @code{break-visibility} o a valores de
4282 visibilidad explícitos para las armaduras y las claves, la letra
4283 de ensayo o número de compás se alinean con el primer objeto de la
4284 lista que sea visible. Si ningún objeto de la lista es visible,
4285 el objeto se alinea con la línea divisoria. Si la línea divisoria
4286 es invisible, el objeto se alinea con el punto en el que se
4287 encontraría la línea divisoria.
4289 @lilypond[verbatim,quote,fragment]
4290 % The rehearsal mark will be aligned to the right edge of the Key Signature
4291 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4296 % The rehearsal mark will be aligned to the right edge of the Clef
4297 \set Staff.explicitKeySignatureVisibility = #all-invisible
4298 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4303 % The rehearsal mark will be centered above the Bar Line
4304 \set Staff.explicitKeySignatureVisibility = #all-invisible
4305 \set Staff.explicitClefVisibility = #all-invisible
4306 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4313 La alineación de la letra de ensayo con relación al objeto de
4314 notación se puede cambiar, como se ve en el ejemplo siguiente. En
4315 una partitura con varios pentagramas, este ajuste se debe hacer
4316 para todos los pentagramas.
4318 @lilypond[verbatim,quote,fragment]
4319 % The RehearsalMark will be aligned with the right edge of the Key Signature
4320 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4326 % The RehearsalMark will be centered above the Key Signature
4327 \once \override Score.KeySignature.break-align-anchor-alignment = #CENTER
4331 % The RehearsalMark will be aligned with the left edge of the Key Signature
4332 \once \override Score.KeySignature.break-align-anchor-alignment = #LEFT
4338 La letra de ensayo también se puede desplazar al borde derecho o
4339 izquierdo en una medida arbitraria. Las unidades son espacios de
4342 @lilypond[verbatim,quote,fragment]
4343 % The RehearsalMark will be aligned with the left edge of the Key Signature
4344 % and then shifted right by 3.5 staff-spaces
4345 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4346 \once \override Score.KeySignature.break-align-anchor = #3.5
4350 % The RehearsalMark will be aligned with the left edge of the Key Signature
4351 % and then shifted left by 2 staff-spaces
4352 \once \override Score.KeySignature.break-align-anchor = #-2
4359 @node Agrupación vertical de objetos gráficos
4360 @subsection Agrupación vertical de objetos gráficos
4361 @translationof Vertical grouping of grobs
4363 @c TODO Expand this section
4365 Los grobs (objetos gráficos) @code{VerticalAlignment} y
4366 @code{VerticalAxisGroup} trabajan de manera coordinada.
4367 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
4368 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
4369 distintos grobs agrupados previamente por
4370 @code{VerticalAxisGroup}. Normalmente sólo existe un
4371 @code{VerticalAlignment} por cada partitura, pero cada
4372 @code{Staff}, @code{Lyrics}, etc. tiene su propio
4373 @code{VerticalAxisGroup}.
4376 @node Modificación de los sellos
4377 @subsection Modificación de los sellos
4378 @translationof Modifying stencils
4380 Todos los objetos de presentación tienen una propiedad
4381 @code{stencil} que es parte del @code{grob-interface}. De forma
4382 predeterminada, esta propiedad suele estar establecida a una
4383 función específica del objeto que está hecha a medida para
4384 disponer el símbolo que lo representa en la salida. Por ejemplo,
4385 el ajuste estándar para la propiedad @code{stencil} del objeto
4386 @code{MultiMeasureRest} es @code{ly:multi-measure-rest::print}.
4388 El símbolo estándar de cualquier objeto se puede sustituir
4389 modificando la propiedad @code{stencil} para que haga referencia a
4390 un procedimiento diferente escrito especialmente. Esto requiere
4391 un alto nivel de conocimiento del funcionamiento interno de
4392 LilyPond, pero hay una forma más fácil que a menudo puede dar
4393 resultados adecuados.
4395 El procedimiento es establecer la propiedad @code{stencil} al
4396 procedimiento que imprime texto (@code{ly:text-interface::print})
4397 y añadir una propiedad @code{text} al objeto ajustada para que
4398 contenga el texto de marcado que produce el símbolo requerido.
4399 Debido a la flexibilidad del marcado, se pueden conseguir muchas
4400 cosas; en particular, consulte @ref{Notación gráfica dentro de
4401 elementos de marcado}.
4403 El ejemplo siguiente muestra esto cambiando el símbolo de la
4404 cabeza de la nota a unas aspas dentro de una circunferencia.
4406 @lilypond[verbatim,quote]
4408 \once \override NoteHead.stencil = #ly:text-interface::print
4409 \once \override NoteHead.text = \markup {
4411 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
4412 \musicglyph #"noteheads.s2cross"
4420 Cualquiera de los glifos de la fuente tipográfica Feta se puede
4421 pasar a la instrucción de marcado @code{\musicglyph}: véase
4422 @ref{La tipografía Feta}.
4424 Se pueden insertar en línea tanto imágenes en formato @file{EPS}
4425 como instrucciones de Postscript usando las instrucciones de
4426 marcado @code{\epsfile} y @code{\postscript} respectivamente;
4427 véase @ref{Graphic}.
4431 Referencia de la notación:
4432 @ref{Notación gráfica dentro de elementos de marcado},
4433 @ref{Formatear el texto},
4434 @ref{Text markup commands},
4435 @ref{La tipografía Feta},
4439 @node Modificación de las formas
4440 @subsection Modificación de las formas
4441 @translationof Modifying shapes
4444 * Modificación de ligaduras de unión y de expresión::
4448 @node Modificación de ligaduras de unión y de expresión
4449 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
4450 @translationof Modifying ties and slurs
4452 @cindex ligaduras de expresión, modificar
4453 @cindex ligaduras de unión, modificar
4454 @cindex Bézier, curvas de, puntos de control
4455 @cindex puntos de control en curvas de Bézier
4457 Las ligaduras de unión (@code{Tie}s), de expresión (@code{Slur}s),
4458 de fraseo (@code{PhrasingSlur}s), de dejar vibrar
4459 (@code{LaissezVibrerTie}s) y de repetición (@code{RepeatTie}s) se
4460 trazan como curvas de Bézier de tercer orden. Si la forma de la
4461 ligadura calculada automáticamente no resulta óptima, se puede
4462 modificar su forma manualmente de dos formas:
4466 mediante la especificación de los desplazamientos que se quieren
4467 realizar sobre los puntos de control de la curva de Bézier
4468 calculada automáticamente, o bien
4471 mediante la especificación explícita de las posiciones de los
4472 cuatro puntos de control que se requieren para definir la curva
4476 A continuación se explican ambos métodos. El primer método es más
4477 adecuado cuando solo se requieren ligeros ajustes de la curva; el
4478 segundo puede ser mejor para crear curvas que tienen relación con
4481 @subsubsubheading Curvas de Bézier cúbicas
4483 Las curvas Bézier de tercer orden o cúbicas están definidas por
4484 cuatro puntos de control. El primer y cuarto puntos de control
4485 son exactamente los puntos extremos de comienzo y de final de la
4486 curva. Los dos puntos de control intermedios definen la forma.
4487 Se pueden encontrar en la web animaciones que muestran cómo se
4488 traza la curva, pero la descripción siguiente puede ser de ayuda.
4489 La curva comienza a partir del primer punto de control
4490 dirigiéndose directamente hacia el segundo, curvándose
4491 progresivamente para dirigirse hacia el tercero y continuando la
4492 curva hacia el cuarto, llegando a éste en viaje directo desde el
4493 tercer punto de control. La curva está contenida enteramente
4494 dentro del cuadrilátero definido por los cuatro puntos de control.
4495 Todas las traslaciones, rotaciones y escalado de los puntos de
4496 control producen exactamente las mismas operaciones sobre la
4499 @subsubsubheading Especificar desplazamientos a partir de los puntos de control actuales
4501 @cindex conformar ligaduras
4504 En este ejemplo, la colocación automática de la ligadura no
4505 resulta óptima, y @code{\tieDown} no es la solución.
4507 @lilypond[verbatim,quote]
4511 \relative { r4 <g' c,> <g c,> <g c,> }
4515 El ajuste de los puntos de control de la ligadura mediante la
4516 instrucción @code{\shape} permite evitar las colisiones.
4518 La sintaxis de @code{\shape} es:
4521 [-]@code{\shape} @var{desplazamientos} @var{elemento}
4524 Esta instrucción recoloca los puntos de control de @var{elemento}
4525 en las cantidades dadas por @var{desplazamientos}. El argumento
4526 @var{desplazamientos} es una lista de parejas de números o una
4527 lista de tales listas. Cada elemento de una pareja representa el
4528 desplazamiento de una de las coordenadas de un punto de control.
4529 Si el @var{elemento} es una cadena de caracteres, el resultado es
4530 @code{\once\override} para el tipo de grob especificado. Si
4531 @var{elemento} es una expresión musical, el resultado es la misma
4532 expresión musical con la consiguiente modificación aplicada.
4534 En otras palabras, la función @code{\shape} puede actuar como una
4535 instrucción @code{\once\override} o como una instrucción
4536 @code{\tweak} dependiendo de si el argumento @var{elemento} es el
4537 nombre de un grob, como @qq{Slur}, o una expresión musical, como
4538 @qq{(}. El argumento @var{desplazamientos} especifica los
4539 desplazamientos de los cuatro puntos de control como una lista de
4540 cuatro parejas de valores (dx . dy) en unidades de espacios de
4541 pentagrama (o una lista de tales listas si la curva tiene más de
4544 El guión precedente se exige si, y sólo si, se usa la forma
4547 Así, usando el mismo ejemplo de arriba y la forma
4548 @code{\once\override} de la instrucción @code{\shape}, lo
4549 siguiente tiene el efecto de elevar la ligadura de unión en la
4550 mitad de un espacio de pentagrama:
4552 @lilypond[verbatim,quote]
4555 \shape #'((0 . 0.5) (0 . 0.5) (0 . 0.5) (0 . 0.5)) Tie
4559 \relative { r4 <g' c,> <g c,> <g c,> }
4563 Este posicionamiento de la ligadura de unión es mejor, pero quizá
4564 debería elevarse más en la parte central. El ejemplo siguiente
4565 hace esto, esta vez usando la forma alternativa @code{\tweak}:
4567 @lilypond[verbatim,quote]
4570 e'1-\shape #'((0 . 0.5) (0 . 1) (0 . 1) (0 . 0.5)) ~ e'
4573 \relative { r4 <g' c,> <g c,> <g c,> }
4577 Los cambios en las posiciones horizontales de los puntos de
4578 control se pueden hacer de la misma forma, y dos curvas distintas
4579 que dan comienzo en el mismo momento musical se pueden conformar
4582 @lilypond[verbatim,quote,ragged-right]
4584 c''8(\( a) a'4 e c\)
4585 \shape #'((0.7 . -0.4) (0.5 . -0.4) (0.3 . -0.3) (0 . -0.2)) Slur
4586 \shape #'((0 . 0) (0 . 0.5) (0 . 0.5) (0 . 0)) PhrasingSlur
4591 La función @code{\shape} también puede desplazar los puntos de
4592 control de las curvas que se extienden atravesando saltos de
4593 línea. Cada pieza de la curva dividida puede recibir su propia
4594 lista de desplazamientos. Si no se necesita hacer cambios a uno
4595 de los segmentos en particular, se puede usar una lista vacía como
4596 contenedor. En este ejemplo, el salto de línea hace que la única
4597 ligadura de expresión aparezca como si fueran dos:
4599 @lilypond[verbatim,quote,ragged-right]
4607 Los cambios en la forma de las dos mitades de la ligadura de
4608 expresión deja más claro que la ligadura continúa más allá del
4611 @lilypond[verbatim,quote,ragged-right]
4612 % () may be used as a shorthand for ((0 . 0) (0 . 0) (0 . 0) (0 . 0))
4613 % if any of the segments does not need to be changed
4616 (( 0 . 0) (0 . 0) (0 . 0) (0 . 1))
4617 ((0.5 . 1.5) (1 . 0) (0 . 0) (0 . -1.5))
4625 En una curva en forma de «S» siempre es necesario ajustar
4626 manualmente los puntos de control: LilyPond nunca escoge tales
4627 formas automáticamente.
4629 @lilypond[verbatim,quote]
4631 c8( e b-> f d' a e-> g)
4632 \shape #'((0 . -1) (5.5 . -0.5) (-5.5 . -10.5) (0 . -5.5)) PhrasingSlur
4633 c8\( e b-> f d' a e-> g\)
4637 @subsubsubheading Especificar los puntos de control explícitamente
4639 Las coordenadas de los puntos de contro de Bézier se especifican
4640 en unidades de espacios de pentagrama. La coordenada@tie{}X es
4641 relativa al punto de referencia al que se adjunta la ligadura, y
4642 la coordenada@tie{}Y es relativa a la línea central del
4643 pentagrama. Las coordenadas se especifican como una lista de
4644 cuatro parejas de números decimales (reales). Un enfoque consiste
4645 en estimar las coordenadas de los dos extremos, y después adivinar
4646 los dos puntos intermedios. Los valores óptimos se encuentran
4647 después por ensayo y error. Tenga en cuenta que estos valores
4648 podrían requerir un ajuste manual si se hace posteriormente
4649 cualquier cambio manual a la música o a la disposición.
4651 Una situación en la que es preferible especificar los puntos de
4652 control explícitamente a especificar los desplazamientos es cuando
4653 se necesita especificarlos de forma relativa a una nota única. A
4654 continuación presentamos un ejemplo de esto. Muestra una forma de
4655 indicar una ligadura que se extiende hacia el interior de las
4656 casillas de primera y segunda vez de una repetición.
4658 @lilypond[verbatim,quote]
4661 \repeat volta 3 { c4 d( e f }
4666 % create a slur and move it to a new position
4667 % the <> is just an empty chord to carry the slur termination
4668 -\tweak control-points #'((-2 . 3.8) (-1 . 3.9) (0 . 4) (1 . 3.4)) ( <> )
4673 % create a slur and move it to a new position
4674 -\tweak control-points #'((-2 . 3) (-1 . 3.1) (0 . 3.2) (1 . 2.4)) ( <> )
4682 No es posible modificar la forma de las ligaduras de unión o de
4683 expresión cambiando la propiedad @code{control-points} si hay más
4684 de una en el mismo momento musical, ni siquiera usando la
4685 instrucción @code{\tweak}. Sin embargo, se puede sobreescribir la
4686 propiedad @code{tie-configuration} de @code{TieColumn} para fijar
4687 la línea de inicio y la dirección según se requiera.
4690 Referencia de funcionamiento interno:
4691 @rinternals{TieColumn}.
4694 @node Modificación de objetos de extensión divididos
4695 @subsection Modificación de objetos de extensión divididos
4696 @translationof Modifying broken spanners
4699 * Uso de alterBroken::
4702 @node Uso de alterBroken
4703 @unnumberedsubsubsec Uso de @code{\alterBroken}
4704 @translationof Using alterBroken
4706 @cindex extensión, modificación de objetos de
4707 @cindex divididos, modificación de objetos de extensión
4708 @funindex \alterBroken
4710 Cuando un @qq{spanner} u objeto extenso atraviesa uno o varios
4711 saltos de línea, cada fragmento hereda los atributos del objeto de
4712 extensión original. Así, el trucado ordinario de un objeto
4713 dividido aplica las mismas modificaciones a todos y cada uno de
4714 sus segmentos. En el ejemplo que aparece a continuación, la
4715 sobreescritura de @code{thickness} (grosor) afecta a la ligadura a
4716 ambos lados del salto de línea.
4718 @lilypond[verbatim,quote,ragged-right]
4721 \once\override Slur.thickness = 10
4728 Es posible modificar de forma independiente el aspecto de los
4729 fragmentos individuales de un objeto de extensión dividido, con la
4730 instrucción @code{\alterBroken}. Esta instrucción puede producir
4731 un @code{\override} o bien un @code{\tweak} de una propiedad del
4732 objeto de extensión.
4734 La sintaxis de @code{\alterBroken} es
4737 [-]@code{\alterBroken} @var{propiedad} @var{valores} @var{elemento}
4740 El argumento @var{valores} es una lista de valores, uno por cada
4741 fragmento. Si @var{elemento} el el nombre de un grob como
4742 @code{Slur} o @code{Staff.PianoPedalBracket}, el resultado es una
4743 instrucción de sobreescritura @code{\override} del tipo de grob
4744 especificado. Si @var{elemento} es una expresión musical como
4745 @qq{(} o @qq{[} el resultado es la misma expresión musical con el
4746 correspondiente truco aplicado.
4748 El guión inicial se debe utilizar con la forma de trucaje,
4749 @code{\tweak}. No lo escriba cuando utilice @code{\alterBroken}
4750 como una operación de sobreescritura, @code{\override}.
4752 En su uso como @code{\override}, @code{\alterBroken} puede ir
4753 precedido de @code{\once} o @code{\temporary} y ser revertido con
4754 @code{\revert} con el argumento @var{propiedad}.
4756 EL código siguiente aplica un @code{\override} independiente a
4757 cada uno de los fragmentos de la ligadura del ejemplo anterior:
4759 @lilypond[verbatim,quote,ragged-right]
4762 \alterBroken thickness #'(10 1) Slur
4769 La instrucción @code{\alterBroken} se puede usar con cualquier
4770 objeto de extensión, incluidos @code{Tie}, @code{PhrasingSlur},
4771 @code{Beam} y @code{TextSpanner}. Por ejemplo, un editor que está
4772 preparando una edición académica podría desear indicar la ausencia
4773 de parte de una ligadura de fraseo en una fuente haciendo
4774 discontinuo solamente el segmento que se ha añadido. El siguiente
4775 ejemplo ilustra de qué manera se puede hacer esto, en este caso
4776 usando la forma @code{\tweak} de la instrucción:
4778 @lilypond[verbatim,quote,ragged-right]
4779 % The empty list is conveniently used below, because it is the
4780 % default setting of dash-definition, resulting in a solid curve.
4782 c''2-\alterBroken dash-definition #'(() ((0 1.0 0.4 0.75))) \(e
4788 Es importante comprender que @code{\alterBroken} fija cada pieza
4789 del objeto fragmentado al valor correspondiente dentro del
4790 argumento @var{valores}. Cuando hay menos valores que piezas,
4791 cualquier fragmento adicional recibe la asignación de la lista
4792 vacía. Esto puede conllevar resultados no deseados si la
4793 propiedad de disposición no está establecida a la lista vacía de
4794 forma predeterminada. En estos casos, se debe asignar a cada
4795 segmento un valor adecuado.
4798 Los saltos de línea pueden ocurrir en distintos lugares según
4799 cambia la disposición de la música. Los ajustes elegidos para
4800 @code{\alterBroken} podrían no ser adecuados para un objeto de
4801 extensión que ya no está dividido o que se fragmenta en más piezas
4802 que antes. El uso explícito (manual) de saltos de línea mediante
4803 @code{\break} puede prevenir situaciones como ésta.
4805 La instrucción @code{\alterBroken} no es efectiva para propiedades
4806 de los objetos extensos accedidas antes del salto de línea, como
4811 @rextend{Trucos difíciles}.
4814 @node Contenedores unpure-pure
4815 @subsection Contenedores unpure-pure
4816 @translationof Unpure-pure containers
4818 @cindex Scheme, contenedores puros
4819 @cindex Scheme, contenedores no-puros
4820 @cindex puros, contenedores de Scheme
4821 @cindex no-puros: contenedores de Scheme
4822 @cindex horizontal, sobreescribir el espaciado
4824 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para
4825 la sobreescritura de los cálculos del espaciado en el @emph{eje Y}
4826 (concretamente @code{Y-offset} e @code{Y-extent}) con una función
4827 de Scheme en lugar de un literal, es decir, un número o una pareja
4830 Para ciertos objetos gráficos, las dimensiones @code{Y-extent}
4831 están basadas en la propiedad @code{stencil}, la sobreescritura de
4832 la propiedad de sello de éstos requiere una sobreescritura
4833 adicional de @code{Y-extent} con un contenedor unpure-pure.
4834 Cuando una función sobreescribe una dimensión @code{Y-offset} y/o
4835 @code{Y-extent} se supone que esto dispara los cálculos de los
4836 saltos de línea prematuramente durante la compilación. Así pues,
4837 la función no se evalúa en absoluto (devolviendo por lo general un
4838 valor de @samp{0} o @samp{'(0 . 0)}) lo que puede dar lugar a
4839 colisiones. Una función @q{pura} no afecta a las propiedades,
4840 objetos o suicidios de grobs, y por ello siempre ven sus valores
4841 relacionados con el eje Y evaluados correctamente.
4843 Actualmente hay unas treinta funciones que ya se consideran
4844 @q{puras} y los contenedores Unpure-pure son una manera de
4845 establecer funciones que no están en esta lista como @q{puras}.
4846 La función @q{pura} se evalúa @emph{antes} de cualquier salto de
4847 línea y así el espaciado horizontal se puede ajustar @q{a tiempo}.
4848 La función @q{impura} se evalúa entonces @emph{después} del salto
4851 @warning{Dado que es difícil saber siempre qué funciones están en
4852 esta lista, recomendamos que cualquier función @q{pura} que
4853 estemos creando no utilice los grobs @code{Beam} o
4854 @code{VerticalAlignment}.}
4856 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
4858 @code{(ly:make-unpure-pure-container f0 f1)}
4860 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
4861 1}) y el primer argumento siempre debe ser el grob. Ésta es la
4862 función que da el resultado real. @var{f1} es la función que se
4863 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
4864 primer argumento debe ser siempre el grob pero los argumentos segundo
4865 y tercero son argumentos de @q{inicio} y de @q{final}.
4867 @var{inicio} y @var{final} son, a todos los efectos, valores mudos
4868 que sólo tienen importancia para los @code{objetos de extensión}
4869 (o sea: @code{Hairpin}, regulador, o @code{Beam}, barra), que
4870 pueden devolver distintas estimaciones de altura basadas en una
4871 columna de inicio y una de final.
4873 El resto son los otros argumentos para la primera función (que
4874 puede no ser ninguno si @var{n = 1}).
4876 El resultado de la segunda función se usa como una aproximación del
4877 valor necesario, que se usa entonces por la primera función para
4878 obtener el valor real que se usa a continuación para el ajuste de
4879 precisión mucho más tardío durante el proceso de espaciado.
4881 @c TODO: The following example supposedly showing a collision no longer
4882 @c 'works' since 2.18.x. Another example of a collision is needed.
4885 @lilypond[verbatim,quote,ragged-right]
4886 #(define (square-line-circle-space grob)
4887 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
4888 (notename (ly:pitch-notename pitch)))
4889 (if (= 0 (modulo notename 2))
4890 (make-circle-stencil 0.5 0.0 #t)
4891 (make-filled-box-stencil '(0 . 1.0)
4894 squareLineCircleSpace = {
4895 \override NoteHead.stencil = #square-line-circle-space
4898 smartSquareLineCircleSpace = {
4899 \squareLineCircleSpace
4900 \override NoteHead.Y-extent =
4901 #(ly:make-unpure-pure-container
4902 ly:grob::stencil-height
4903 (lambda (grob start end) (ly:grob::stencil-height grob)))
4906 \new Voice \with { \remove "Stem_engraver" }
4908 \squareLineCircleSpace
4910 \smartSquareLineCircleSpace
4915 En el primer compás, sin el contenedor @emph{unpure-pure}, el
4916 motor de espaciado no conoce la anchura de la cabeza de la nota y
4917 permite que colisione con las alteraciones accidentales. En el
4918 segundo compás, el motor de espaciado conoce la anchura de las
4919 cabezas de las notas y evita la colisión mediante el alargamiento
4920 de la línea en la medida adecuada.
4922 Normalmente, para cálculos simples se pueden usar funciones casi
4923 idénticas tanto para las partes @q{no pura} y @q{pura},
4924 simplemente cambiando el número de argumentos que se pasan a, y el
4925 ámbito de, la función. Este caso de utilización es lo bastante
4926 frecuente como para que @code{ly:make-unpure-pure-container}
4927 construya dicha segunda función de forma predeterminada cuando se
4928 llama con solo un argumento de función.
4930 @warning{Si una función está caracterizada como @q{pura} y resulta
4931 que no lo es, el resultado puede ser inesperado.}
4934 @node Uso de las funciones musicales
4935 @section Uso de las funciones musicales
4936 @translationof Using music functions
4938 @c TODO -- add @seealso, etc. to these subsections
4940 Dondequiera que se necesite reutilizar trucos con distintas
4941 expresiones musicales, con frecuencia conviene hacer que el truco
4942 forme parte de una @emph{función musical}. En esta sección
4943 estudiaremos solamente las funciones de @emph{sustitución}, en las
4944 que el objeto es sustituir una variable dentro de un fragmento de
4945 código de entrada de LilyPond. Se describen otras funciones más
4946 complejas en @rextend{Funciones musicales}.
4949 * Sintaxis de las funciones de sustitución::
4950 * Ejemplos de funciones de sustitución::
4954 @node Sintaxis de las funciones de sustitución
4955 @subsection Sintaxis de las funciones de sustitución
4956 @translationof Substitution function syntax
4958 Es fácil hacer una función que sustituya una variable dentro de
4959 código de LilyPond. La forma general de estas funciones es
4963 #(define-music-function
4964 (@var{arg1} @var{arg2} @dots{})
4965 (@var{type1?} @var{type2?} @dots{})
4967 @var{@dots{}música@dots{}}
4974 @multitable @columnfractions .33 .66
4975 @item @code{@var{argN}}
4976 @tab @var{n}-ésimo argumento
4978 @item @code{@var{typeN?}}
4979 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
4980 debe devolver @code{#t}.
4982 @item @code{@var{@dots{}música@dots{}}}
4983 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
4984 lugares en que sólo se permiten construcciones de Lilypond) o
4985 @code{#} (para usarlo como un valor de Scheme o un argumento de
4986 función musical o música dentro de listas de música) para
4987 referenciar argumentos (p.ej. @samp{#arg1}).
4990 Es necesaria la lista de predicados de tipo. Algunos de los
4991 predicados de tipo más comunes que se utilizan en las funciones
4996 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
5008 Para ver una lista de los predicados de tipo disponibles, consulte
5009 @ref{Predicados de tipo predefinidos}. También se permiten los
5010 predicados de tipo definidos por el usuario.
5013 Referencia de la notación:
5014 @ref{Predicados de tipo predefinidos}.
5016 Expansión de LilyPond:
5017 @rextend{Sintaxis de las funciones musicales}.
5019 Archivos instalados:
5020 @file{lily/music-scheme.cc},
5022 @file{scm/lily.scm}.
5025 @node Ejemplos de funciones de sustitución
5026 @subsection Ejemplos de funciones de sustitución
5027 @translationof Substitution function examples
5029 Esta sección presenta algunos ejemplos de funciones de
5030 sustitución. No pretenden ser exhaustivas, sino demostrar algunas
5031 de las posibilidades de las funciones de sustitución sencillas.
5033 En el primer ejemplo se define una función que simplifica el
5034 ajuste del relleno de un elemento de inscripción de texto
5037 @lilypond[quote,verbatim,ragged-right]
5039 #(define-music-function
5043 \once \override TextScript.padding = #padding
5047 c''4^"piu mosso" b a b
5049 c4^"piu mosso" b a b
5051 c4^"piu mosso" b a b
5055 Además de números, podemos usar expresiones musicales, como notas,
5056 para los argumentos de las funciones musicales:
5058 @lilypond[quote,verbatim,ragged-right]
5060 #(define-music-function
5064 \tweak NoteHead.stencil #ly:text-interface::print
5065 \tweak NoteHead.text
5066 \markup \musicglyph #"custodes.mensural.u0"
5067 \tweak Stem.stencil ##f
5071 \relative { c'4 d e f \custosNote g }
5075 Ambas funciones son expresiones únicas sencillas en las que solo
5076 falta el último elemento de una lamada de función o
5077 sobreescritura. Para estas definiciones de función en particular,
5078 existe una sintaxis alternativa más simple que consiste
5079 simplemente en escribir la parte constante de la expresión y
5080 sustituir el elemento final que falta por @code{\etc}:
5082 @lilypond[quote,verbatim,ragged-right]
5084 \once \override TextScript.padding = \etc
5087 c''4^"piu mosso" b a b
5089 c4^"piu mosso" b a b
5091 c4^"piu mosso" b a b
5095 @lilypond[quote,verbatim,ragged-right]
5097 \tweak NoteHead.stencil #ly:text-interface::print
5098 \tweak NoteHead.text
5099 \markup \musicglyph #"custodes.mensural.u0"
5100 \tweak Stem.stencil ##f
5103 \relative { c'4 d e f \custosNote g }
5107 Se pueden definir funciones de sustitución con más de un
5110 @lilypond[quote,verbatim,ragged-right]
5112 #(define-music-function
5116 \once \override Score.MetronomeMark.padding = #padding
5117 \tempo \markup { \bold #tempotext }
5121 \tempo \markup { "Low tempo" }
5123 \tempoPadded #4.0 "High tempo"
5128 @c TODO: add appropriate @@ref's here.