1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 28add695953862ef4a87f9fbeadd1d02dc299244
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::
1545 @node Navegar por la referencia del programa
1546 @subsection Navegar por la referencia del programa
1547 @translationof Navigating the program reference
1549 Supongamos que queremos mover la indicación de digitación del
1550 fragmento siguiente:
1552 @lilypond[quote,fragment,verbatim]
1556 Si hace una visita a la documentación en busca de instrucciones de
1557 digitación (en @ref{Indicaciones de digitación}), encontrará:
1560 @strong{Véase también}
1562 Referencia de funcionamiento interno: @rinternals{Fingering}.
1567 La referencia del programador se encuentra disponible en forma de
1568 documento HTML. Se recomienda mucho que lo lea en la forma HTML,
1569 bien en línea o bien descargando los archivos de la documentación
1570 HTML. Esta sección sería mucho más difícil de entender si está
1571 utilizando el manual en formato PDF.
1574 Siga el enlace que lleva a @rinternals{Fingering}. Al principio
1575 de la página, puede ver
1578 Los objetos de digitación se crean por parte de:
1579 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1582 Siguiendo los enlaces relacionados dentro de la referencia del
1583 programa, podemos seguir el flujo de información dentro del
1588 @item @rinternals{Fingering}:
1589 los objetos @rinternals{Fingering} se crean por parte de:
1590 @rinternals{Fingering_engraver}
1592 @item @rinternals{Fingering_engraver}:
1593 Tipos de música aceptados: @rinternals{fingering-event}
1595 @item @rinternals{fingering-event}:
1596 El tipo de evento musical @code{fingering-event} está descrito en
1597 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1600 Este camino se recorre en contra de la corriente de información
1601 del programa: comienza por la salida y acaba en el evento de
1602 entrada. También podríamos haber empezado por un evento de la
1603 entrada, y leído siguiendo el flujo de información terminando en
1604 su caso en el objeto (u objetos) de la salida.
1606 La referencia del programa también se puede examinar como un
1607 documento normal. Contiene capítulos que tratan de
1609 @rinternals{Music definitions},
1612 @code{Music definitions}
1614 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada
1615 uno de los capítulos relaciona todas las definiciones utilizadas y
1616 todas las propiedades que se pueden ajustar.
1619 @node Interfaces de la presentación
1620 @subsection Interfaces de la presentación
1621 @translationof Layout interfaces
1623 @cindex interfaz de la presentación
1624 @cindex presentación, interfaz de la
1627 La página HTML que pudimos ver en la sección anterior describe el
1628 objeto de presentación llamado @rinternals{Fingering}. Dicho
1629 objeto es un símbolo dentro de la partitura. Tiene propiedades
1630 que guardan números (como grosores y direcciones), pero también
1631 punteros a objetos relacionados. Un objeto de presentación
1632 también se llama un @emph{Grob}, que es una abreviatura de
1633 Graphical Object (objeto gráfico). Para ver más detalles acerca
1634 de los objetos gráficos o Grobs, consulte
1635 @rinternals{grob-interface}.
1637 La página dedicada a @code{Fingering} relaciona las definiciones del
1638 objeto @code{Fingering}. Por ejemplo, la página dice
1641 @code{padding} (dimensión, en espacios de pentagrama):
1647 lo que significa que el número se mantendrá a una distancia de al
1648 menos 0.5 de la cabeza de la nota.
1651 Cada objeto de presentación puede tener varias funciones como
1652 elemento notacional o tipográfico. Por ejemplo, el objeto de
1653 digitación Fingering tiene los siguientes aspectos
1657 Su tamaño es independiente del espaciado horizontal, al contrario
1658 de las ligaduras o las barras de las figuras.
1661 Es un elemento de texto. Casi seguro que es un texto muy corto.
1664 este elemento de texto se tipografía con un tipo de letra, no como
1665 las ligaduras o las barras de las figuras.
1668 Horizontalmente, el centro del símbolo se debe alinear con el
1669 centro de la cabeza de la nota.
1672 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1675 La posición vertical también está coordinada con otros símbolos de
1676 superíndice y de subíndice.
1679 Cada uno de estos aspectos se capta en lo que se llaman
1680 @emph{interface}s, que se relacionan al final de la página dedicada a
1681 @rinternals{Fingering}
1684 Este objeto contempla los siguientes interfaces:
1685 @rinternals{item-interface},
1686 @rinternals{self-alignment-interface},
1687 @rinternals{side-position-interface}, @rinternals{text-interface},
1688 @rinternals{text-script-interface}, @rinternals{font-interface},
1689 @rinternals{finger-interface} y @rinternals{grob-interface}.
1692 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1693 página del respectivo interfaz del objeto. Cada interfaz tiene un
1694 cierto número de propiedades. Algunas de ellas no son para que el
1695 usuario las pueda ajustar (@q{Propiedades internas}), pero otras
1696 sí se pueden modificar.
1698 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1699 realmente esto no significa mucho. El archivo de inicialización
1700 (véase @rlearning{Otras fuentes de información})
1701 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1706 (avoid-slur . around)
1707 (slur-padding . 0.2)
1708 (staff-padding . 0.5)
1709 (self-alignment-X . 0)
1710 (self-alignment-Y . 0)
1711 (script-priority . 100)
1712 (stencil . ,ly:text-interface::print)
1713 (direction . ,ly:script-interface::calc-direction)
1714 (font-encoding . fetaText)
1715 (font-size . -5) ; don't overlap when next to heads.
1716 (meta . ((class . Item)
1717 (interfaces . (finger-interface
1719 text-script-interface
1721 side-position-interface
1722 self-alignment-interface
1723 item-interface))))))
1727 Como podemos ver, el objeto @code{Fingering} no es más que un
1728 montón de valores de variables, y la página web de la Referencia
1729 de funcionamiento interno se genera directamente a partir de esta
1733 @node Determinar la propiedad del grob
1734 @subsection Determinar la propiedad del grob
1735 @translationof Determining the grob property
1737 Recordemos que queríamos cambiar la posición del @b{2} en
1739 @lilypond[quote,fragment,verbatim]
1743 Puesto que el @b{2} se encuentra colocado verticalmente sobre su
1744 nota, tenemos que negociar con el interfaz asociado con esta
1745 colocación. Esto se hace usando @code{side-position-interface}.
1746 La página que describe este interface dice:
1749 @code{side-position-interface}
1751 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1752 soporte). La propiedad @code{direction} significa dónde poner el
1753 objeto víctima con relación al soporte (¿a la izquierda o a la
1754 derecha, encima o debajo?)
1758 @cindex padding (relleno)
1760 Debajo de esta descripción, la variable @code{padding} (relleno)
1766 (dimensión, en espacios de pentagrama)
1768 Añadir esta cantidad de espacio adicional entre objetos que están
1773 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1774 digitación de la cabeza de la nota. La siguiente orden inserta un
1775 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1778 \once \override Voice.Fingering.padding = #3
1781 Al insertar esta instrucción antes de que se haya creado el objeto
1782 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1785 @lilypond[quote,relative=2,verbatim]
1786 \once \override Voice.Fingering.padding = #3
1792 En este caso, el contexto de este truco es @code{Voice}. Este
1793 hecho se puede deducir también a partir de la referencia del
1794 programa, ya que la página dedicada al añadido
1795 @rinternals{Fingering_engraver} dice
1798 El grabador Fingering_engraver es parte de los contextos: @dots{}
1803 @node Convenciones de nombres
1804 @subsection Convenciones de nombres
1805 @translationof Naming conventions
1807 Se hace necesario presentar una panorámica de las diversas
1808 convenciones de nomenclatura:
1811 @item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
1812 @item funciones de Scheme: ly:más-estilo-de-scheme
1813 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1814 @item interfaces de Grobs: estilo-scheme
1815 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1816 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1817 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1818 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1822 Preguntas aún sin respuesta
1824 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1825 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1830 @node Modificar las propiedades
1831 @section Modificar las propiedades
1832 @translationof Modifying properties
1835 * Panorámica de la modificación de las propiedades::
1836 * La instrucción set::
1837 * La instrucción override::
1838 * La instrucción tweak::
1839 * set frente a override::
1840 * Modificación de las listas-A::
1844 @node Panorámica de la modificación de las propiedades
1845 @subsection Panorámica de la modificación de las propiedades
1846 @translationof Overview of modifying properties
1848 Cada contexto es responsable de la creación de ciertos tipos de
1849 objetos gráficos. Los ajustes que se usan para imprimir estos
1850 objetos también se almacenan por contexto. Mediante la
1851 modificación de estos ajustes, se puede alterar la apariencia de
1854 Existen dos tipos diferentes de propiedades almacenadas en los
1855 contextos: las propiedades de contexto y las propiedades de grob.
1856 Las propiedades de contexto son propiedades que se aplican al
1857 contexto como un todo y controlan la forma en que el propio
1858 contexto se imprime. Por contra, las propiedades de grob se
1859 aplican a los tipos de grob específicos que se imprimirán dentro
1862 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar
1863 los valores de las propiedades de contexto. Las instrucciones
1864 @code{\override} y @code{\revert} se usan para cambiar los valores
1865 de las propiedades de grob.
1868 La sintaxis de esto es
1871 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1874 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1875 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1876 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1877 disposición}). Este último es un símbolo, y por ello debe ir
1878 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1879 explica cómo se deben cumplimentar los conceptos @var{nombre},
1880 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1881 funcionalidad des esta instrucción.
1886 \override Staff.Stem.thickness = #4.0
1890 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1891 grosor de una línea del pentagrama como unidad). Puesto que la
1892 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1893 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1894 Aquí vemos la instrucción en pleno funcionamiento:
1896 @lilypond[quote,fragment,verbatim]
1898 \override Staff.Stem.thickness = #4.0
1904 La instrucción @code{\override} modifica la definición de la plica
1905 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1906 que la instrucción se ha interpretado, todas las plicas se engrosan.
1908 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1909 omitir, ocasionando que se utilice el contexto predeterminado
1910 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1911 solo paso de tiempo.
1913 @lilypond[quote,fragment,verbatim]
1915 \once \override Stem.thickness = #4.0
1920 El @code{\override} se debe hacer antes de que el objeto se inicia.
1921 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1922 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1923 en el momento en que se crea el objeto. En este ejemplo:
1925 @lilypond[quote,fragment,verbatim]
1926 \override Slur.thickness = #3.0
1928 \override Beam.beam-thickness = #0.6
1933 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1934 la instrucción para @code{Beam}, la barra, va después de que la barra
1935 se ha iniciado, y por ello no tiene ningún efecto.
1937 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1938 un contexto deshace una instrucción @code{\override}; como con
1939 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1940 del mismo contexto. En otras palabras, el @code{\revert} del
1941 siguiente ejemplo no hace nada.
1944 \override Voice.Stem.thickness = #4.0
1945 \revert Staff.Stem.thickness
1948 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1949 dentro de las propiedades normales. Para trucarlas, utilice
1950 instrucciones de la forma
1952 @c leave this as a long long
1954 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1961 \override Stem.details.beamed-lengths = #'(4 4 3)
1967 Referencia de funcionamiento interno:
1968 @rinternals{Backend},
1969 @rinternals{All layout objects},
1970 @rinternals{OverrideProperty},
1971 @rinternals{RevertProperty},
1972 @rinternals{PropertySet}.
1975 El «back-end» o motor de salida no es muy estricto en la
1976 comprobación de tipos de las propiedades de objetos. Las
1977 referencias cíclicas en valores Scheme de propiedades pueden
1978 producir cuelgues o salidas abruptas, o las dos cosas.
1981 @node La instrucción set
1982 @subsection La instrucción @code{@bs{}set}
1983 @translationof The set command
1987 @cindex cambiar propiedades
1989 Cada contexto puede tener distintas @emph{propiedades}, variables
1990 contenidas dentro de ese contexto. Se pueden cambiar mientras
1991 dura el paso de interpretación. Se consigue insertando la
1992 instrucción @code{\set} dentro de la música:
1995 \set @var{contexto}.@var{propiedad} = #@var{valor}
1998 @var{valor} es un objeto de Scheme, razón por la que va precedido
1999 del carácter almohadilla,@tie{}@code{#}.
2001 El nombre de las propiedades de contexto suele ir en minúsculas
2002 con mayúscula en medio. Controlan sobre todo la traducción de la
2003 música a la notación, p.ej. @code{localAlterations} (para
2004 determinar si hay que impriir alteraciones o no), o
2005 @code{measurePosition} (para determinar cuándo hay que imprimir
2006 una línea divisoria). El valor de las propiedades de contexto
2007 puede modifcarse con el tiempo durante la interpretación de la
2008 música; un ejemplo obvio es @code{measurePosition}. Las
2009 propiedades de contexto se modifican mediante la instrucción
2012 Por ejemplo, los silencios multicompás se combinan en un solo
2013 compás si el valor de la propiedad de contexto @code{skipBars} se
2014 establece a @code{#t} (verdadero):
2016 @lilypond[quote,fragment,verbatim]
2018 \set Score.skipBars = ##t
2022 Si se omite el argumento @var{context}, entonces se utiliza el
2023 contexto actual de nivel más bajo (normalmente @code{ChordNames},
2024 @code{Voice} o @code{Lyrics}). En este ejemplo:
2026 @lilypond[quote,fragment,verbatim]
2027 \set Score.autoBeaming = ##f
2030 \set autoBeaming = ##t
2038 El cambio se aplica @q{al vuelo}, mientras dura la música, de
2039 forma que el ajuste sólo afecta al segundo grupo de corcheas.
2041 Observe que el contexto del nivel más bajo no siempre contiene la
2042 propiedad que querríamos modificar: por ejemplo, intentar ajustar
2043 el valor de la propiedad @code{skipBars} del contexto
2044 predeterminado del nivel más bajo, que en este caso es
2045 @code{Voice}, no tendrá ningún efecto, porque skipBars es una
2046 propiedad del contexto @code{Score}.
2048 @lilypond[quote,fragment,verbatim]
2054 Los contextos son jerárquicos, y si se ha especificado un contexto
2055 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
2056 también a todos los contextos @code{Voice} dentro del pentagrama
2061 También existe una instrucción @code{\unset}:
2063 \unset @var{contexto}.@var{propiedad}
2067 que elimina la definición de @var{propiedad}. Esta instrucción
2068 elimina la definición solamente si está establecida dentro de
2069 @var{contexto}. Properties that have been set in enclosing contexts will
2070 not be altered by an unset in an enclosed context:
2072 @lilypond[quote,fragment,verbatim]
2073 \set Score.autoBeaming = ##t
2077 \unset Score.autoBeaming
2085 Como @code{\set}, el argumento @var{contexto} no se tiene que
2086 especificar para un contexto del nivel más bajo, por lo que los
2090 \set Voice.autoBeaming = ##t
2091 \set autoBeaming = ##t
2095 son equivalentes si el contexto inferior en curso es @code{Voice}.
2099 Los ajustes con @code{\set} o @code{\unset} que se aplican
2100 solamente a un único paso de tiempo se pueden escribir con
2101 @code{\once}, por ejemplo en
2103 @lilypond[quote,fragment,verbatim]
2105 \once \set fontSize = #4.7
2110 En el manual de Referencia de funcionamiento interno hay una
2111 descripción completa de todas las propiedades de contexto
2112 disponibles, consulte
2114 @rinternals{Tunable context properties}.
2117 Traducción @expansion{} Propiedades de contexto modificables por el
2122 Referencia de funcionamiento interno:
2123 @rinternals{Tunable context properties}.
2125 @node La instrucción override
2126 @subsection La instrucción @code{\override}
2127 @translationof The override command
2129 @cindex grob, propiedades de
2130 @cindex propiedades de grob
2133 Existe un tipo especial de propiedad de contexto: la descripción
2134 de los grobs. Las decscripciones de los grobs reciben un nombre
2135 en @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen
2136 los @q{ajustes predeterminados} para un tipo particular de grob,
2137 en forma de lista asociativa. Consulte
2138 @file{scm/define-grobs.scm} para ver los ajustes de cada
2139 descripción de grob. Las descripciones de grob se modifican con
2142 La sintaxis de la instrucción @code{\override} es
2145 \override [@var{contexto}.]@var{NombreDelGrob}.@var{propiedad} = #@var{valor}
2148 Por ejemplo, podemos aumentar el grosor de la plica de una figura
2149 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
2150 @code{Stem} (plica):
2152 @lilypond[quote,fragment,verbatim]
2154 \override Voice.Stem.thickness = #3.0
2158 Si no se ha especificado ningún contexto en la instrucción
2159 @code{\override}, se utiliza el contexto del nivel inferior:
2161 @lilypond[quote,fragment,verbatim]
2162 \override Staff.Stem.thickness = #3.0
2166 \override Stem.thickness = #0.5
2175 Algunas opciones susceptibles de trucaje, se llaman
2176 @q{subpropiedades} y residen dentro de las propiedades. Para
2177 efectura trujajes sobre ellas, utilice instrucciones de la forma
2180 \override Stem.details.beamed-lengths = #'(4 4 3)
2183 o para modificar los extremos de los objetos extensos, utilice una
2184 forma como las siguientes:
2187 \override TextSpanner.bound-details.left.text = #"left text"
2188 \override TextSpanner.bound-details.right.text = #"right text"
2192 @cindex reversión de sobreescrituras
2193 @cindex sobreescrituras, reversión de
2195 El efecto de una instrucción de sobreescritura @code{\override} se
2196 puede deshacer con @code{\revert}.
2198 La sintaxis de la instrucción @code{\revert} es
2201 \revert [@var{Contexto}.]@var{NombreDelGrob}.@var{propiedad}
2206 @lilypond[quote,verbatim]
2209 \override Voice.Stem.thickness = #3.0
2211 \revert Voice.Stem.thickness
2216 Los efectos de @code{\override} y @code{\revert} se aplican a
2217 todos los grobs del contexto afectado partiendo del momento actual
2220 @lilypond[quote,verbatim]
2224 \override Staff.Stem.thickness = #3.0
2229 \revert Staff.Stem.thickness
2236 @cindex sobreescritura para un solo momento
2238 Se puede usar @code{\once} con @code{\override} o @code{\revert}
2239 para afectar solamente al instante de tiempo actual:
2241 @lilypond[quote,verbatim]
2244 \override Stem.thickness = #3.0
2249 \once \override Stem.thickness = #3.0
2257 Las instrucciones que modifican la salida tienen por lo general un
2261 \override Voice.Stem.thickness = #3.0
2265 Para construir este truco debemos determinar los siguientes datos:
2268 @item el contexto: aquí @code{Voice}.
2269 @item el objeto de presentación: aquí @code{Stem}.
2270 @item la propiedad de presentación: aquí @code{thickness}.
2271 @item un valor adecuado: aquí @code{3.0}.
2274 @cindex documentación interna
2275 @cindex buscar objetos gráficos
2276 @cindex gráficos, descripción de los objetos
2279 @cindex interna, documentación
2281 Para muchas propiedades, independientemente del tipo de datos de la
2282 propiedad, si se establece el valor de la propiedad a falso
2283 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
2284 ignore por completo dicha propiedad. Esto es especialmente útil para
2285 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
2286 causarían problemas.
2288 Mostraremos a continuación cómo localizar esta información en el
2289 manual de notación y en la referencia de funcionamiento interno.
2293 Referencia de funcionamiento interno:
2294 @rinternals{Backend}
2297 @node La instrucción tweak
2298 @subsection La instrucción @code{\tweak}
2299 @translationof The tweak command
2304 El cambio de las propiedades de grob mediante @code{\override} produce
2305 la aplicación del cambio a todos los grobs dados en el contexto en el
2306 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
2307 podemos desear que los cambios se apliquen a un solo grob en lugar de
2308 a todos los grobs del contexto afectado. Esto se consigue con la
2309 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
2312 \tweak [@var{objeto-de-presentación}.]@var{propiedad-del-grob} @var{valor}
2315 Es opcional especificar el @var{objeto-de-presentación}. La
2316 instrucción @code{\tweak} se aplica al objeto musical que viene
2317 inmediatamente después de @var{valor} dentro del flujo musical.
2320 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
2321 los objetos gráficos. Para objetos que resultan directamente de un
2322 elemento de código de la entrada, puede usar la función @code{\tweak},
2325 @lilypond[verbatim,quote]
2331 \tweak duration-log #1
2341 El uso principal de la instrucción @code{\tweak} es modificar
2342 solamente uno de varios elementos de notación que dan comienzo en el
2343 mismo momento musical, como las notas de un acorde, o corchetes de
2344 tresillo que empiezan al mismo tiempo.
2346 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
2347 a continuación de forma directa, sin necesidad de especificar el
2348 nombre del grob o el contexto. Para que esto funcione, es necesario
2349 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
2350 al objeto al que se aplica, después de que el archivo de entrada se ha
2351 convertido en un flujo musical. Con frecuencia no es el caso, pues
2352 muchos elementos adicionales se insertan en la corriente musical de
2353 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
2354 parte de un acorde, LilyPond inserta implícitamente un evento
2355 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
2356 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
2357 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
2358 en el flujo musical, permaneciendo así adyacente a la nota, y con la
2359 posibilidad de modificarla.
2363 @lilypond[verbatim,fragment,quote]
2364 <\tweak color #red c''>4
2368 pero esto no funciona:
2370 @lilypond[verbatim,fragment,quote]
2371 \tweak color #red c''4
2376 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
2377 consulte @rlearning{Métodos de trucaje}.
2379 Si se colocan varios elementos similares en el mismo momento
2380 musical, la instrucción @code{\override} no se puede usar para
2381 modificar uno solo de ellos: aquí es donde se debe usar la
2382 instrucción @code{\tweak}. Entre los elementos que pueden
2383 aparecer más de una vez en el mismo momento musical están los
2386 @c TODO expand to include any further uses of \tweak
2388 @item las cabezas de las notas de un acorde
2389 @item signos de articulación sobre la misma nota
2390 @item ligaduras de unión entre notas de un acorde
2391 @item corchetes de grupos especials que comienzan en el mismo momento
2394 @c TODO add examples of these
2396 @cindex acorde, modificación de una nota
2398 En este ejemplo se modifican el color de una cabeza y el tipo de
2399 otra, dentro del mismo acorde:
2401 @lilypond[verbatim,fragment,quote]
2406 \tweak duration-log #1
2411 @code{\tweak} se puede usar para modificar ligaduras de expresión:
2413 @lilypond[verbatim,quote]
2414 \relative { c'-\tweak thickness #5 ( d e f) }
2418 Para que funcione la instrucción @code{\tweak}, debe permanecer
2419 adyacente al objeto al que se ha de aplicar después de que el código
2420 de entrada se ha convertido a un flujo musical. El trucaje de un
2421 acorde completo no hace nada porque su evento musical actúa solamente
2422 como un contenedor, y todos los objetos de presentación se crean a
2423 partir de eventos dentro del @code{EventChord}:
2425 @lilypond[verbatim,fragment,quote]
2426 \tweak color #red c''4
2427 \tweak color #red <c'' e''>4
2428 <\tweak color #red c'' e''>4
2431 La instrucción @code{\tweak} sencilla no se puede usar para
2432 modificar ningún objeto que no se haya creado directamente a
2433 partir de la entrada. Concretamente, no afecta a las plicas,
2434 barras automáticas ni alteraciones, porque éstos se generan
2435 posteriormente por parte de objetos de presentación
2436 @code{NoteHead} más que por elementos musicales del flujo de
2439 Tales objetos de presentación creados indirectamente se pueden
2440 trucar usando la forma de la instrucción @code{\tweak} en que el
2441 nombre del grob se especifica de forma explícita:
2443 @lilypond[fragment,verbatim,quote]
2444 \tweak Stem.color #red
2445 \tweak Beam.color #green c''8 e''
2446 <c'' e'' \tweak Accidental.font-size #-3 ges''>4
2449 No se puede usar @code{\tweak} para modificar las claves o las
2450 indicaciones de compás, porque éstos se separan de cualquier
2451 instrucción @code{\tweak} precedente dentro del flujo de entrada
2452 merced a la inserción automática de elementos adicionales que se
2453 requieren para especificar el contexto.
2455 Se pueden colocar varias instrucciones @code{\tweak} antes de un
2456 elemento de notación; todos le afectan:
2458 @lilypond[verbatim,fragment,quote]
2460 -\tweak style #'dashed-line
2461 -\tweak dash-fraction #0.2
2462 -\tweak thickness #3
2468 El flujo musical que se genera a partir de una sección de un
2469 archivo de entrada (incluido cualquier elemento insertado
2470 automáticamente) puede examinarse, véase
2471 @rextend{Presentación de las expresiones musicales}. Esto puede
2472 ser de utilidad en la determinación de lo que puede modificarse
2473 por medio de una instrucción @code{\tweak}.
2476 Manual de aprendizaje:
2477 @rlearning{Métodos de trucaje}.
2479 Manual de extensión:
2480 @rextend{Presentación de las expresiones musicales}.
2484 @cindex trucar puntos de control
2485 @cindex control, trucar puntos de
2487 No se puede usar la instrucción @code{\tweak} para modificar los
2488 puntos de control de una sola de varias ligaduras de unión dentro
2489 de un acorde, aparte de la primera que se encuentre en el código
2493 @node set frente a override
2494 @subsection @code{\set} frente a @code{\override}
2495 @translationof set versus override
2497 @c TODO Should't a bunch of that be explained earlier?
2501 Tanto @code{\set} como @code{\override} manipulan propiedades
2502 asociadas a contextos. En ambos casos las propiedades tienen en
2503 cuenta la jerarquía de contextos: las propiedades no establecidas en
2504 el propio contexto presentan los valores del contexto padre
2507 El valor y la duración en el tiempo de las propiedades de contexto
2508 son dinámicos y están disponibles solamente cuando la música se
2509 está interpretando o @q{iterando}. En el momento de la creación
2510 del contexto, se inicializan las propiedades a partir de la
2511 definición de contexto correspondiente y las posibles
2512 modificaciones de contexto. Después de esto, cualquier cambio se
2513 obtiene a través de instrucciones de establecimiento de
2514 propiedades dentro de la propia música.
2516 Ahora bien, las definiciones de grob (objetos gráficos) son una
2517 clase especial de propiedades de contexto. Dado que su
2518 estructura, mantenimiento y utilización es distinta de las
2519 propiedades de contexto ordinarias, se accede a ellas con un
2520 conjunto de instrucciones diferente, y se estudian por separado
2521 dentro de la documentación.
2523 A diferencia de las propiedades de contexto normales, las
2524 definiciones de grob están subdivididas en propiedades de grob.
2525 Un @qq{grob} (objeto gráfico) se crea normalmente por parte de un
2526 grabador en el momento de la interpretación de una expresión
2527 musical y recibe sus propiedades iniciales de la definición de
2528 grob en curso del contexto del grabador. El grabador (u otras
2529 partes del @q{backend} de LilyPond) pueden después añadir o
2530 modificar propiedades del grob, pero ello no afecta a la
2531 definición de grob del contexto.
2533 Lo que conocemos como @q{propiedades de grob} en el contexto del
2534 trucaje a nivel de usuario son en realidad las propiedades de la
2535 definición de grob de un contexto. A diferencia de las
2536 propiedades de contexto normales, las definiciones de grob
2537 mantienen la contabilidad necesaria para seguir la pista de sus
2538 partes, las propiedades de grob individuales (e incluso
2539 subpropiedades de éstos), de forma separada, de forma que es
2540 posible definir dichas partes dentro de contextos diferentes y
2541 hacer que la definición de grob en su conjunto, en el momento de
2542 la creación del grob, se monte a partir de las piezas
2543 proporcionadas en diferentes contextos entre el contexto actual y
2544 sus contextos padre.
2546 Las definiciones de grob se manipulan usando @code{\override} y
2547 @code{\revert} y tienen un nombre que empieza con una letra mayúscula
2548 (como @samp{NoteHead}) mientras que las propiedades de contexto
2549 ordinarias se manipulan utilizando @code{\set} y @code{\unset} y se
2550 nombran empezando en letra minúscula.
2552 @cindex tweak, relación con @code{\override}
2554 @funindex \overrideProperty
2555 Las instrucciones especiales @code{\tweak} y @code{\overrideProperty}
2556 cambian las propiedades de grob pasando por encima de las propiedades
2557 de contexto completamente. En su lugar, atrapan a los grobs tan
2558 pronto se crean, y después establecen propiedades sobre ellos
2559 directamente cuando se originan a partir de un evento musical trucado
2560 o son de un tipo en particular, respectivamente.
2562 @node Modificación de las listas-A
2563 @subsection Modificación de las listas-A
2564 @translationof Modifying alists
2566 Ciertas propiedades configurables por parte del usuario se
2567 representan internamente como @emph{listas-A} (listas
2568 asociativas), que almacenan duplas de @emph{claves} y
2569 @emph{valores}. La estructura de una lista-A es la siguiente:
2572 '((@var{clave1} . @var{valor1})
2573 (@var{clave2} . @var{valor2})
2574 (@var{clave3} . @var{valor3})
2578 Si una lista-A es una propiedad de un grob o una variable de
2579 @code{\paper}, sus claves se pueden modificar individualmente sin
2580 que afecte a las otras claves.
2582 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2583 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2584 del grob @code{StaffGrouper}. La propiedad es una lista-A con
2585 cuatro claves: @code{basic-distance} (distancia básica),
2586 @code{minimum-distance} (distancia mínima), @code{padding}
2587 (relleno) y @code{stretchability} (ampliabilidad). Los ajustes
2588 estándar para esta propiedad se relacionan en la sección
2589 @qq{Backend} de la Referencia de Funcionamiento Interno (véase
2590 @rinternals{StaffGrouper}):
2593 '((basic-distance . 9)
2594 (minimum-distance . 7)
2596 (stretchability . 5))
2599 Una forma de acercar los pentagramas entre sí es reducir el valor
2600 de la clave @code{basic-distance} (@code{9}) para que se
2601 corresponda con el valor de @code{minimum-distance} (@code{7}).
2602 Para modificar una única clave de forma individual, utilice una
2603 @emph{declaración anidada}:
2605 @lilypond[quote,verbatim]
2606 % default space between staves
2608 \new Staff { \clef treble c''1 }
2609 \new Staff { \clef bass c1 }
2612 % reduced space between staves
2613 \new PianoStaff \with {
2614 % this is the nested declaration
2615 \override StaffGrouper.staff-staff-spacing.basic-distance = #7
2617 \new Staff { \clef treble c''1 }
2618 \new Staff { \clef bass c1 }
2622 La utilización de una declaración anidada actualiza la clave
2623 especificada (como @code{basic-distance} en el ejemplo anterior)
2624 sin alterar ninguna de las otras claves que ya se habían
2625 establecido para la misma propiedad.
2627 Ahora, supongamos que deseamos que los pentagramas estén tan
2628 próximos como sea posible sin que se superpongan. La manera más
2629 sencilla de hacerlo es establecer las cuatro claves de la lista-A
2630 a cero. Sin embargo, no es necesario escribir cuatro
2631 declaraciones anidadas, una por cada clave. En lugar de eso, se
2632 puede redefinir completamente la propiedad con una sola
2633 declaración, como una lista-A:
2635 @lilypond[quote,verbatim]
2636 \new PianoStaff \with {
2637 \override StaffGrouper.staff-staff-spacing =
2638 #'((basic-distance . 0)
2639 (minimum-distance . 0)
2641 (stretchability . 0))
2643 \new Staff { \clef treble c''1 }
2644 \new Staff { \clef bass c1 }
2648 Observe que cualquier clave que no haya sido relacionada
2649 explícitamente en la definición de la lista-A, será reiniciada a
2650 sus valores @emph{predeterminados si no se han fijado}. En el
2651 caso de @code{staff-staff-spacing}, el valor de cualquier clave no
2652 fijada se reiniciaría a cero (excepto @code{stretchability}, que
2653 toma el valor de @code{basic-distance} si no se fija). Así, las
2654 dos declaraciones siguientes son equivalentes:
2657 \override StaffGrouper.staff-staff-spacing =
2658 #'((basic-distance . 7))
2660 \override StaffGrouper.staff-staff-spacing =
2661 #'((basic-distance . 7)
2662 (minimum-distance . 0)
2664 (stretchability . 7))
2667 Una consecuencia de esto (posiblemente no intencionada) es la
2668 eliminación de cualquier valor estándar que se establezca en un
2669 archivo de inicio y que se carga cada vez que se compila un
2670 archivo de entrada. En el ejemplo anterior, los ajustes estándar
2671 para @code{padding} y @code{minimum-distance} (definidos en
2672 @file{scm/define-grobs.scm}) se reinician a sus valores
2673 predeterminados si no se han fijado (cero para las dos claves).
2674 La definición de una propiedad o variable como una lista-A (de
2675 cualquier tamaño) siempre reinicia todos los valores de clave no
2676 establecidos a sus valores predeterminados si no se han fijado.
2677 Ano ser que este sea el resultado deseado, es más seguro
2678 actualizar los valores de clave individualmente con una
2679 declaración anidada.
2681 @warning{Las declaraciones anidadas no funcionan para las listas-A
2682 de propiedades de contexto (como @code{beamExceptions},
2683 @code{keyAlterations}, @code{timeSignatureSettings}, etc.). Estas
2684 propiedades sólo se pueden modificar redefiniéndolas completamente
2688 @node Conceptos y propiedades útiles
2689 @section Conceptos y propiedades útiles
2690 @translationof Useful concepts and properties
2694 * Modos de entrada::
2695 * Dirección y posición::
2696 * Distancias y medidas::
2698 * Propiedades del símbolo del pentagrama::
2699 * Objetos de extensión::
2700 * Visibilidad de los objetos::
2701 * Estilos de línea::
2702 * Rotación de objetos::
2706 @node Modos de entrada
2707 @subsection Modos de entrada
2708 @translationof Input modes
2710 La forma en que se interpreta la notación contenida dentro de un
2711 archivo de entrada, está determinada por el modo de entrada en
2714 @subsubsubheading Modo de acordes
2716 Se activa con la instrucción @code{\chordmode} y produce que la
2717 entrada se interprete con al sintaxis de la notación de acordes,
2718 véase @ref{Notación de acordes}. Los acordes se imprimen como
2719 notas sobre un pentagrama.
2721 El modo de acordes se activa también con la instrucción
2722 @code{\chords}. Esto crea también un contexto @code{ChordNames}
2723 nuevo y produce que el código que sigue se interprete con la
2724 sintaxis de la notación de acordes y se imprima como nombres de
2725 acorde dentro del contexto @code{ChordNames}, véase @ref{Impresión
2726 de los nombres de acorde}.
2728 @subsubsubheading Modo de percusión
2730 Se activa con la instrucción @code{\drummode} y produce que el
2731 código de entrada se interprete con la sintaxis de la notación de
2732 percusión, véase @ref{Notación básica de percusión}.
2734 El modo de percusión también se activa con la instrucción
2735 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y
2736 hace que el código que sigue se interprete con la sintaxis de la
2737 notación de percusión y se imprima como símbolos de percusión
2738 sobre un pentagrama de percusión, véase @ref{Notación básica de
2741 @subsubsubheading Modo de cifras
2743 Se activa con la instrucción @code{\figuremode} y hace que el código
2744 de entrada se interprete con la sintaxis del bajo cifrado, véase
2745 @ref{Introducir el bajo cifrado}.
2747 El modo de cifras también se activa con la instrucción
2748 @code{\figures}. También crea un contexto de @code{FiguredBass}
2749 nuevo y hace que el código que viene a continuación se interprete
2750 con la sintaxis del bajo cifrado y se imprima como símbolos de
2751 bajo cifrado dentro del contexto @code{FiguredBass}, véase
2752 @ref{Introducción al bajo cifrado}.
2754 @subsubsubheading Modos de traste y tablatura
2756 No existen modos de entrada especiales para introducir símbolos de
2757 trastes y de tablatura.
2759 Para crear diagramas de trastes, escriba las notas o acordes en el
2760 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2761 véase @ref{Tablaturas predeterminadas}.
2763 Para crear diagramas de trastes encima de un pentagrama,
2764 escríbalos como elementos de marcado encima de las notas
2765 utilizando la instrucción @code{\fret-diagram}, véase @ref{Marcas
2766 de diagramas de trastes}.
2768 @subsubsubheading Modo de letra
2770 Se activa con la instrucción @code{\lyricmode}, y hace que la
2771 entrada se interprete como sílabas de la letra de la canción con
2772 duraciones opcionales y modificadores de letra asociados, véase
2775 El modo de letra también se habilita con la instrucción
2776 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics}
2777 nuevo y una instrucción @code{\lyricsto} implícita que asocia la
2778 letra que viene a continuación con la música precedente.
2780 @subsubsubheading Modo de marcado
2782 Se activa con la instrucción @code{\markup}, y hace que la entrada
2783 se interprete con la sintaxis del marcado, véase @ref{Text markup
2786 @subsubsubheading Modo de notas
2788 Es el modo predeterminado o se puede activar con la instrucción
2789 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
2790 marcado, etc. y se imprime como notación musical sobre un pentagrama.
2792 Normalmente no es necesario especificar el modo de notas de forma
2793 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2794 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2795 otro modo y queremos insertar algo que solamente se puede hacer
2796 con la sintaxis del modo de notas.
2799 @node Dirección y posición
2800 @subsection Dirección y posición
2801 @translationof Direction and placement
2803 Al tipografiar música, la dirección y colocación de muchos
2804 elementos es cuestión de elección. Por ejemplo, las plicas de las
2805 notas se pueden dirigir hacia arriba o hacia abajo; la letra, las
2806 indicaciones dinámicas y otras marcas expresivas se pueden colocar
2807 encima o debajo del pentagrama; el texto se pude alinear a la
2808 izquierda, a la derecha o centrado; etc. La mayoría de estas
2809 elecciones pueden dejarse que LilyPond las determine
2810 automáticamente, pero en ciertos casos puede ser deseable forzar
2811 una dirección o colocación concreta.
2814 * Indicadores de dirección de las articulaciones::
2815 * La propiedad de dirección::
2818 @node Indicadores de dirección de las articulaciones
2819 @unnumberedsubsubsec Indicadores de dirección de las articulaciones
2820 @translationof Articulation direction indicators
2822 De forma predeterminada algunas direcciones siempre son hacia
2823 arriba o siempre hacia abajo (p. ej. los matices o el calderón),
2824 mientras que otras cosas pueden alternar entre arriba y abajo en
2825 función de la dirección de las plicas (como las ligaduras o los
2828 @c TODO Add table showing these
2830 Se puede sobreescribir la acción predeterminada mediante el
2831 prefijado de la articulación por un @emph{indicacor de dirección}.
2832 Están disponibles tres indicadores de dirección: @code{^} (que
2833 significa @qq{arriba}), @code{_} (que significa @qq{abajo}) o
2834 @code{-} (que significa @qq{usar la dirección predeterminada}).
2835 El indicador de dirección se puede normalmente omitir, en cuyo
2836 caso se supone el indicador predeterminado @code{-}, pero se
2837 necesita un indicador de dirección @strong{siempre} antes de:
2840 @item las instrucciones @code{\tweak}
2841 @item las instrucciones @code{\markup}
2842 @item las instrucciones @code{\tag}
2843 @item los marcados de cadena, p.ej. -"cadena"
2844 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2845 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2848 Estas indicaciones afectan sólo a la nota siguiente.
2850 @lilypond[verbatim,quote]
2859 @node La propiedad de dirección
2860 @unnumberedsubsubsec La propiedad de dirección
2861 @translationof The direction property
2863 La posición o dirección de muchos objetos de presentación está
2864 controlada por la propiedad @code{direction}.
2866 El valor de la propiedad @code{direction} se puede establecer al
2867 valor @code{1}, con el significado de @qq{hacia arriba} o
2868 @qq{encima}, o a @w{@code{-1}}, con el significado de @qq{hacia
2869 abajo} o @qq{debajo}. Se pueden usar los símbolos @code{UP} y
2870 @code{DOWN} en sustitución de @code{1} y @w{@code{-1}}
2871 respectivamente. La dirección predeterminada se puede especificar
2872 estableciendo @code{direction} a @code{0} ó a @code{CENTER}. De
2873 forma alternativa, en muchos casos existen instrucciones
2874 predefinidas para especificar la dirección. Todas ellas son de la
2878 @code{\xxxUp}, @code{\xxxDown} o @code{\xxxNeutral}
2882 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
2883 predeterminada}. Véase @rlearning{Objetos interiores al
2886 En alguna que otra ocasión como en el arpegio, el valor de la
2887 propiedad @code{direction} puede especificar si el objeto se debe
2888 colocar a la izquierda o a la derecha del objeto padre. En este
2889 caso @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y
2890 @code{1} ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó
2891 @code{CENTER} significan @qq{utilizar la dirección
2894 Estas indicaciones afectan a todas las notas hasta que son
2897 @lilypond[verbatim,quote]
2908 En música polifónica, en general es mejor especificar una voz
2909 explícita que cambiar la dirección de un objeto. Para ver más
2910 información, véase @ref{Varias voces}.
2913 Manual de aprendizaje:
2914 @rlearning{Objetos interiores al pentagrama}.
2916 Referencia de la notación:
2920 @node Distancias y medidas
2921 @subsection Distancias y medidas
2922 @translationof Distances and measurements
2924 @cindex distancias absolutas
2925 @cindex distancias escaladas
2932 Las distancias en LilyPond son de dos tipos: absolutas y
2935 Las distancias absolutas se usan para especificar márgenes,
2936 sangrados y otros detalles de diseño de página, y de forma
2937 predeterminada se especifican en milímetros. Las distancias se
2938 pueden especificar en otras unidades escribiendo después de la
2939 cifra indicativa de la cantidad, @code{\mm}, @code{\cm},
2940 @code{\in}@tie{}(pulgadas), o @code{\pt}@tie{}(puntos, 1/72.27
2941 pulgadas). Las distancias de diseño de página se pueden
2942 especificar también en unidades escalables (véase el párrafo
2943 siguiente) adjuntando @code{\staff-space} a la cantidad. La
2944 disposición de página se describe en detalle en @ref{Disposición
2947 Las distancias escaladas siempre se especifican en unidades de un
2948 espacio del pentagrama o, más raramente, medio espacio del
2949 pentagrama. El espacio de pentagrama es la distancia entre dos
2950 líneas del pentagrama adyacentes. El valor predeterminado se
2951 puede cambiar globalmente fijando el tamaño global del pentagrama,
2952 o se puede sobreescribir localmente cambiando la propiedad
2953 @code{staff-space} del objeto @code{StaffSymbol}. Las distancias
2954 escaladas se escalan automáticamente con cualquier cambio al
2955 tamaño global del pentagrama o a la propiedad @code{staff-space}
2956 del objeto @code{StaffSymbol}, pero las fuentes tipográficas se
2957 escalan solamente con los cambios efectuados al tamaño global del
2958 pentagrama. Así, el tamaño global del pentagrama posibilita la
2959 fácil variación del tamaño general de una partitura impresa. Para
2960 ver los métodos de establecimiento del tamaño global del
2961 pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2965 Si se necesita dibujar sólo una sección de una partitura a una
2966 escala distinta, por ejemplo una sección ossia o una nota al pie,
2967 no se puede simplemente cambiar el tamaño global del pentagrama
2968 porque esto afectaría a toda la partitura. En tales casos, el
2969 cambio de tamaño se hace sobreescribiendo tanto la propiedad
2970 @code{staff-space} de @code{StaffSymbol} como el tamaño de las
2971 fuentes tipográficas. Está a nuestra disposición una función de
2972 Scheme, @code{magstep}, para convertir de un cambio en el tamaño
2973 de la fuente al cambio equivalente en @code{staff-space}. Para
2974 ver una explicación y un ejemplo de su utilización, consulte
2975 @rlearning{Longitud y grosor de los objetos}.
2978 Manual de aprendizaje:
2979 @rlearning{Longitud y grosor de los objetos}.
2981 Referencia de la notación:
2982 @ref{Disposición de la página},
2983 @ref{Establecer el tamaño del pentagrama}.
2987 @subsection Dimensiones
2988 @translationof Dimensions
2991 @cindex caja circundante
2993 Las dimensiones de un objeto gráfico especifican las posiciones de
2994 los límites izquierdo y derecho, así como los límites inferior y
2995 superior de las cajas limítrofes de los objetos como distancias a
2996 partir del punto de referencia del objeto en unidades de espacios
2997 de pentagrama. Estas posiciones se codifican frecuentemente como
2998 dos parejas de valores de Scheme. Por ejemplo, la instrucción de
2999 marcado de texto @code{\with-dimensions} toma tres argumentos, de
3000 los cuales los dos primeros son una pareja de Scheme que da las
3001 posiiciones de los bordes izquierdo y derecho y otra pareja de
3002 Scheme que da las posiciones de los límites inferior y superior:
3005 \with-dimensions #'(-5 . 10) #'(-3 . 15) @var{arg}
3008 Esto especifica una caja circundante para @var{arg} con su límite
3009 izquierdo en -5, su límite derecho en 10, el inferior en -3 y el
3010 superior e 15, todos ellos medidos a partir del punto de
3011 referencia del objeto en unidades de espacios de pentagrama.
3014 Referencia de la notación:
3015 @ref{Distancias y medidas}.
3018 @node Propiedades del símbolo del pentagrama
3019 @subsection Propiedades del símbolo del pentagrama
3020 @translationof Staff symbol properties
3022 @cindex ajuste del símbolo del pentagrama
3023 @cindex dibujar el símbolo del pentagrama
3024 @cindex pentagrama, establecer el símbolo del
3026 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
3027 @c Need to think of uses for these properties. Eg 'line-positions
3028 @c is used in a snippet to thicken centre line.
3029 @c If retained, add @ref to here in 1.6.2 -td
3031 Se puede definir al mismo tiempo la posición vertical de las
3032 líneas de la pauta y el número de líneas de la misma. Como
3033 muestra el siguiente ejemplo, las posiciones de las notas no están
3034 influidas por las posiciones de las líneas de la pauta.
3036 @warning{La propiedad @code{'line-positions} sobreescribe a la
3037 propiedad @code{'line-count}. El número de líneas de la pauta
3038 está definido implícitamente por el número de elementos de la
3039 lista de valores de @code{'line-positions}.}
3041 @lilypond[verbatim,quote]
3043 \override StaffSymbol.line-positions = #'(7 3 0 -4 -6 -7)
3045 \relative { a4 e' f b | d1 }
3048 Se puede modificar la anchura de la pauta. Las unidades son
3049 espacios de pentagrama. El espaciado de los objetos dentro del
3050 pentagrama no resulta afectado por este ajuste.
3052 @lilypond[verbatim,quote]
3054 \override StaffSymbol.width = #23
3056 \relative { a4 e' f b | d1 }
3060 @node Objetos de extensión
3061 @subsection Objetos de extensión
3062 @translationof Spanners
3064 Muchos objetos de notación musical abarcan varias notas o incluso
3065 varios compases. Son ejemplos los crescendi, trinos, corchetes de
3066 grupo especial y corchetes de primera y segunda vez. Estos
3067 objetos se llaman @qq{spanners} u «objetos de extensión», y tienen
3068 propiedades especiales para controlar su apariencia y
3069 comportamiento. Algunas de estas propiedades son comunes a todos
3070 los objetos de extensión; otras se limitan a un subconjunto de los
3073 Todos los objetos de extensión contemplan el interface
3074 @code{spanner-interface}. Algunos, básicamente aquellos que
3075 trazan una línea recta entre los dos objetos, contemplan también
3076 el interface @code{line-spanner-interface}.
3079 * Uso del spanner-interface::
3080 * Uso del line-spanner-interface::
3083 @node Uso del spanner-interface
3084 @unnumberedsubsubsec Uso del @code{spanner-interface}
3085 @translationof Using the spanner-interface
3087 Este interface proporciona dos propiedades que se aplican a varios
3090 @subsubsubheading La propiedad @code{minimum-length} (longitud mínima)
3092 La longitud mínima del objeto de extensión se especifica a través
3093 de la propiedad @code{minimum-length}. Su aumento suele producir
3094 el efecto necesario de aumentar el espaciado de las notas entre
3095 los dos puntos extremos. Sin embargo, esta sobreescritura no
3096 tiene ningún efecto sobre muchos extensores, pues su longitud está
3097 determinada por otras consideraciones. Más abajo se muestran
3098 algunos ejemplos de dónde es efectiva.
3108 Works as long as callback is made:
3112 Works not at all for:
3121 @lilypond[verbatim,quote,fragment]
3124 % increase the length of the tie
3125 -\tweak minimum-length #5
3129 @lilypond[verbatim,quote]
3130 \relative \compressMMRests {
3133 % increase the length of the rest bar
3134 \once \override MultiMeasureRest.minimum-length = #20
3140 @lilypond[verbatim,quote]
3143 % increase the length of the hairpin
3144 \override Hairpin.minimum-length = #20
3149 Esta sobreescritura se puede usar también para aumentar la
3150 longitud de las ligaduras de expresión y de fraseo:
3152 @lilypond[verbatim,quote]
3156 -\tweak minimum-length #5
3161 -\tweak minimum-length #5
3166 Para algunos objetos de presentación, la propiedad
3167 @code{minimum-length} es efectiva sólo si se llama explícitamente
3168 al procedimiento @code{set-spacing-rods}. Para hacerlo, se debe
3169 fijar la propiedad @code{springs-and-rods} al valor
3170 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud
3171 mínima de un glissando no tiene efecto a no ser que se establezca
3172 la propiedad @code{springs-and-rods}:
3174 @lilypond[verbatim,fragment,quote]
3178 % not effective alone
3179 \once \override Glissando.minimum-length = #20
3182 % effective only when both overrides are present
3183 \once \override Glissando.minimum-length = #20
3184 \once \override Glissando.springs-and-rods = #ly:spanner::set-spacing-rods
3188 Lo mismo se puede decir del objeto @code{Beam}:
3190 @lilypond[verbatim,fragment,quote]
3191 % not effective alone
3192 \once \override Beam.minimum-length = #20
3195 % effective only when both overrides are present
3196 \once \override Beam.minimum-length = #20
3197 \once \override Beam.springs-and-rods = #ly:spanner::set-spacing-rods
3201 @subsubsubheading La propiedad @code{to-barline}
3203 La segunda propiedad útil del @code{spanner-interface} es
3204 @code{to-barline}. De forma predeterminada tiene el valor cierto,
3205 haciendo que los reguladores y otros objetos de extensión que
3206 terminan sobre la primera nota de un compás, en vez de eso
3207 terminen en la línea divisoria inmediatamente precedente. Si se
3208 establece al valor falso, el extensor llegará más allá de la barra
3209 de compás y terminará exactamente sobre la nota:
3211 @lilypond[verbatim,quote]
3213 a' \< a a a a \! a a a \break
3214 \override Hairpin.to-barline = ##f
3215 a \< a a a a \! a a a
3219 Esta propiedad no es efectiva para todos los extensores. Por
3220 ejemplo, su establecimiento a @code{#t} no tienen ningún efecto
3221 sobre las ligaduras de expresión o de fraseo, o sobre otros
3222 extensores para los que terminar en la barra de compás no tendría
3225 @node Uso del line-spanner-interface
3226 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
3227 @translationof Using the line-spanner-interface
3229 Entre los objetos que contemplan el interface
3230 @code{line-spanner-interface} se encuentran
3233 @item @code{DynamicTextSpanner}
3234 @item @code{Glissando}
3235 @item @code{TextSpanner}
3236 @item @code{TrillSpanner}
3237 @item @code{VoiceFollower}
3240 La rutina responsable de dibujar los sellos de estos extensores es
3241 @code{ly:line-spanner::print}. esta rutina determina la
3242 localización exacta de los dos puntos extremos y traza una línea
3243 entre ellos, en el estilo solicitado. Las posiciones de los dos
3244 puntos extremos del extensor se calculan al vuelo, pero es posible
3245 sobreescribir sus coordenadas Y. Las propiedades que se deben
3246 especificar están anidadas a dos niveles de profundidad en la
3247 jerarquía de propiedades, pero la sintaxis de la instrucción
3248 @code{\override} es bastante sencilla:
3250 @lilypond[quote,fragment,verbatim]
3252 \once \override Glissando.bound-details.left.Y = #3
3253 \once \override Glissando.bound-details.right.Y = #-2
3257 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
3258 siendo el punto del cero la línea central del pentagrama. Para el
3259 glissando, esto es el valor de @code{Y} en la coordenada X que
3260 corresponde al punto central de cada cabeza de nota si nos
3261 imaginamos que la línea se extiende hasta allí.
3263 Si no está fijado @code{Y}, su valor se calcula a partir de la
3264 posición vertical del punto de anclaje correspondiente del
3267 En caso de salto de línea, los valores para los puntos extremos se
3268 especifican por las sub-listas @code{left-broken} y
3269 @code{right-broken} de @code{bound-details}. Por ejemplo:
3271 @lilypond[ragged-right,fragment,verbatim,quote]
3272 \override Glissando.breakable = ##t
3273 \override Glissando.bound-details.right-broken.Y = #-3
3274 c''1 \glissando \break
3278 Un número de propiedades adicionales de las sub-listas @code{left}
3279 y @code{right} de la propiedad @code{bound-details} se pueden
3280 especificar de la misma forma que @code{Y}:
3284 Establece la coordenada Y del punto extremo, en desplazamientos de
3285 @code{staff-space}s desde la línea central del pentagrama. De
3286 forma predeterminada es el centro del objeto ancla, y así un
3287 glissando apunta al centro vertical de la cabeza de la nota.
3289 Para extensores horizontales como los extensores de texto y los
3290 trinos, está inamoviblemente codificado como 0.
3292 @item attach-dir (dirección de anclaje)
3293 Determina dónde comienza y termina la línea en la dirección X, con
3294 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o
3295 @code{LEFT}, izquierda) hace que la línea comience o termine en el
3296 lado izquierdo de la cabeza de la nota a la que está anclado.
3299 Es la coordenada X absoluta del punto extremo. Se suele calcular
3300 al vuelo, y su sobreescritura no tiene un efecto útil.
3302 @item stencil (sello)
3303 Los extensores de línea pueden tener símbolos al comienzo o al
3304 final, lo que está contenido en esta sub-propiedad. Esto es para
3305 uso interno; se recomienda en su lugar el uso de @code{text}.
3308 Es un elemento de marcado que se evalúa para dar lugar al sello.
3309 Se usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los
3310 objetos de extensión horizontales.
3312 @lilypond[quote,ragged-right,fragment,verbatim]
3313 \override TextSpanner.bound-details.left.text
3314 = \markup { \small \bold Slower }
3315 \relative { c''2\startTextSpan b c a\stopTextSpan }
3318 @item stencil-align-dir-y (alineación del sello en y)
3319 @item stencil-offset (desplazamiento del sello)
3320 Si no se modifican uno u otro, el sello se coloca sencillamente en
3321 el punto extremo, centrado sobre la línea, como viene definido por
3322 las subpropiedades @code{X} e @code{Y}. Si se fijan
3323 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
3324 símbolo del borde verticalmente con relación al extremo de la
3327 @lilypond[quote,fragment,verbatim]
3328 \override TextSpanner.bound-details.left.stencil-align-dir-y = #-2
3329 \override TextSpanner.bound-details.right.stencil-align-dir-y = #UP
3331 \override TextSpanner.bound-details.left.text = #"ggg"
3332 \override TextSpanner.bound-details.right.text = #"hhh"
3334 \relative { c'4^\startTextSpan c c c \stopTextSpan }
3337 Observe que los valores negativos mueven el texto @emph{hacia
3338 arriba}, al contrario de lo que podría esperarse, pues el valor de
3339 @w{@code{-1}} o @code{DOWN} (abajo) significa alinear el borde
3340 @emph{inferior} del texto con la línea de extensión. Un valor de
3341 @code{1} o @code{UP} (arriba) alinea el borde superior del texto
3342 con la línea extensora.
3344 @item arrow (flecha)
3345 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
3346 flecha en el extremo de la línea.
3348 @item padding (relleno)
3349 Esta sub-propiedad controla el espacio entre el punto extremo
3350 especificado de la línea y el extremo real. Sin relleno, un
3351 glissando empezaría y terminaría en el centro de la cabeza de las
3356 La función musical @code{\endSpanners} finaliza de forma prematura
3357 el extensor que comienza sobre la nota que sigue inmediatamente a
3358 continuación. Se termina después de una nota exactamente, o en la
3359 siguiente barra de compás si @code{to-barline} es verdadero y se
3360 produce una divisoria antes de la siguiente nota.
3362 @lilypond[verbatim,quote,ragged-right]
3365 c2 \startTextSpan c2 c2
3371 Si se usa @code{\endSpanners} no es necesario cerrar
3372 \startTextSpan con \stopTextSpan, ni cerrar los reguladores con
3376 Referencia de funcionamiento interno:
3377 @rinternals{TextSpanner},
3378 @rinternals{Glissando},
3379 @rinternals{VoiceFollower},
3380 @rinternals{TrillSpanner},
3381 @rinternals{line-spanner-interface}.
3384 @node Visibilidad de los objetos
3385 @subsection Visibilidad de los objetos
3386 @translationof Visibility of objects
3388 @cindex objetos, visibilidad de
3389 @cindex grobs, visibilidad de
3390 @cindex visibilidad de los objetos
3392 Hay cuatro formas principales en que se puede controlar la
3393 visibilidad de los objetos de presentación: se puede eliminar su
3394 sello, se pueden volver transparentes, se pueden pintar de blanco,
3395 o se puede sobreescribir su propiedad @code{break-visibility}.
3396 Las tres primeras se aplican a todos los objetos de presentación;
3397 la última sólo a unos pocos: los objetos @emph{divisibles}. El
3398 Manual de aprendizaje introduce estas cuatro técnicas, véase
3399 @rlearning{Visibilidad y color de los objetos}.
3401 Hay también algunas otras técnicas que son específicas de ciertos
3402 objetos de presentación. Se estudian bajo Consideraciones
3406 * Eliminar el sello::
3407 * Hacer transparentes los objetos::
3408 * Pintar los objetos de blanco::
3409 * Uso de break-visibility (visibilidad en el salto)::
3410 * Consideraciones especiales::
3414 @node Eliminar el sello
3415 @unnumberedsubsubsec Eliminar el sello
3416 @translationof Removing the stencil
3418 @cindex sello, eliminar
3421 Todo objeto de presentación tiene una propiedad stencil (sello).
3422 De forma predeterminada está establecida a la función específica
3423 que dibuja ese objeto. Si se sobreescribe esta propiedad a
3424 @code{#f} no se llama a ninguna función y el objeto no se dibuja.
3425 La acción predeterminada se puede recuperar con @code{\revert}.
3427 @lilypond[quote,fragment,verbatim]
3429 \override Score.BarLine.stencil = ##f
3431 \revert Score.BarLine.stencil
3435 Esta operación, bastante común, tiene la forma abreviada
3436 @code{\omit} como atajo:
3438 @lilypond[quote,fragment,verbatim]
3442 \undo \omit Score.BarLine
3447 @node Hacer transparentes los objetos
3448 @unnumberedsubsubsec Hacer transparentes los objetos
3449 @translationof Making objects transparent
3451 @cindex transparentes, hacer los objetos
3454 Todo objeto de presentación tiene una propiedad transparent
3455 (transparente) que de forma predeterminada está establecida a
3456 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio
3459 @lilypond[quote,fragment,verbatim]
3461 \once \override NoteHead.transparent = ##t
3465 Esta operación, bastante común, tiene la forma abreviada @code{\hide}
3468 @lilypond[quote,fragment,verbatim]
3470 \once \hide NoteHead
3475 @node Pintar los objetos de blanco
3476 @unnumberedsubsubsec Pintar los objetos de blanco
3477 @translationof Painting objects white
3479 @cindex objetos, coloreado de
3480 @cindex coloreado de objetos
3482 @cindex impresión, orden de
3483 @cindex sobreescritura de objetos
3484 @cindex objetos, sobreescritura de
3485 @cindex grobs, sobreescritura de
3487 Todo objeto de presentación tiene una propiedad de color que de
3488 forma predeterminada está establecida a @code{black} (negro). Si
3489 se sobreescribe a @code{white} (blanco) el objeto será
3490 indistinguible del fondo blanco. Sin embargo, si el objeto cruza
3491 a otros objetos, el color de los puntos de cruce queda determinado
3492 por el orden en que se dibujan estos objetos, lo que puede dejar
3493 una imagen fantasma del objeto blanco, como puede verse aquí:
3495 @lilypond[quote,fragment,verbatim]
3496 \override Staff.Clef.color = #white
3500 Se puede evitar esto cambiando el orden de impresión de los
3501 objetos. Todos los objetos de presentación tienen una propiedad
3502 @code{layer} (capa) que se debe establecer a un valor entero. Los
3503 objetos con el valor de @code{layer} más bajo se dibujan primero,
3504 después se dibujan los objetos con valores progresivamente
3505 mayores, y así los objetos con valores más altos se dibujan encima
3506 de los que tienen valores más bajos. De forma predeterminada,
3507 casi todos los objetos tienen asignado un valor @code{layer} de
3508 @code{1}, aunque algunos objetos, entre ellos el pentagrama y las
3509 líneas divisorias, @code{StaffSymbol} y @code{BarLine}, tienen
3510 asignado un calor de @code{0}. El orden de impresión de los
3511 objetos con el mismo valor de @code{layer} es indeterminado.
3513 En el ejemplo de arriba, la clave blanca, con un valor
3514 @code{layer} predeterminado de @code{1}, se dibuja después de las
3515 líneas del pentagrama (valor @code{layer} predeterminado de
3516 @code{0}), sobreimpresionándolas. Para cambiarlo, se debe dar al
3517 objeto @code{Clef} un valor de @code{layer} más bajo, digamos
3518 @w{@code{-1}}, para que se dibuje antes:
3520 @lilypond[quote,fragment,verbatim]
3521 \override Staff.Clef.color = #white
3522 \override Staff.Clef.layer = #-1
3527 @node Uso de break-visibility (visibilidad en el salto)
3528 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
3529 @translationof Using break-visibility
3531 @c TODO Add making other objects breakable
3533 @cindex break-visibility
3535 Casi todos los objetos de presentación se imprimen una sola vez,
3536 pero algunos como las líneas divisorias, claves, indicaciones de
3537 compás y armaduras de tonalidad, se pueden tener que imprimir dos
3538 veces cuando se produce un salto de línea : una vez al final de la
3539 línea y otra al comienzo de la siguiente. Estos objetos reciben
3540 el nombre de @emph{divisibles}, y tienen una propiedad,
3541 @code{break-visibility} (visibilidad en el salto), para controlar
3542 su visibilidad en las tres posiciones en que pueden aparecer: al
3543 comienzo de una línea, dentro de la línea si se produce un cambio,
3544 y al final de la línea si el cambio se produce en ese lugar.
3546 Por ejemplo, la indicación de compás se imprime de forma
3547 predeterminada al comienzo de la primera línea y en ningún otro
3548 lugar a no ser que cambie, en cuyo caso se imprime en el punto en
3549 que se produce el cambio. Si este cambio se produce al final de
3550 una línea, la nueva indicación de compás se imprime al principio
3551 de la línea siguiente y también al final de la línea anterior como
3552 indicación de precaución.
3554 Este comportamiento se controla por medio de la propiedad
3555 @code{break-visibility}, que se explica en
3556 @c Leave this ref on a newline - formats incorrectly otherwise -td
3557 @rlearning{Visibilidad y color de los objetos}. Esta propiedad
3558 toma un vector de tres valores booleanos que, por orden,
3559 determinan si el objeto se imprime al final, dentro, o al
3560 principio de la línea. O, para ser más exactos: antes del salto
3561 de línea, si no hay salto, o después del salto.
3563 Como alternativa se puede especificar cualquiera de las ocho
3564 combinaciones mediante funciones predefinidas cuya definición está
3565 en @file{scm/output-lib.scm}, donde las tres últimas columnas
3566 indican si los objetos de presentación serán visibles en las
3567 posiciones que se muestran en el encabezamiento de cada columna:
3569 @multitable {@code{begin-of-line-invisible}} {@code{#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
3570 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
3571 @headitem de función @tab de vector @tab salto @tab salto @tab salto
3573 @item @code{all-visible} @tab @code{#(#t #t #t)} @tab sí @tab sí @tab sí
3574 @item @code{begin-of-line-visible} @tab @code{#(#f #f #t)} @tab no @tab no @tab sí
3575 @item @code{center-visible} @tab @code{#(#f #t #f)} @tab no @tab sí @tab no
3576 @item @code{end-of-line-visible} @tab @code{#(#t #f #f)} @tab sí @tab no @tab no
3577 @item @code{begin-of-line-invisible} @tab @code{#(#t #t #f)} @tab sí @tab sí @tab no
3578 @item @code{center-invisible} @tab @code{#(#t #f #t)} @tab sí @tab no @tab sí
3579 @item @code{end-of-line-invisible} @tab @code{#(#f #t #t)} @tab no @tab sí @tab sí
3580 @item @code{all-invisible} @tab @code{#(#f #f #f)} @tab no @tab no @tab no
3583 Los ajustes predeterminados de @code{break-visibility} dependen
3584 del objeto de presentación. La tabla siguiente muestra todos los
3585 objetos de presentación de interés que resultan afectados por
3586 @code{break-visibility} y el ajuste predeterminado de esta
3589 @multitable @columnfractions .3 .3 .4
3591 @headitem Objeto @tab Contexto usual @tab Valor predet.
3593 @c omit Ambitus as it appears not to be affected by break-visibility -td
3594 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
3595 @item @code{BarLine} @tab @code{Score} @tab calculado
3596 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
3597 @c omit the following item until it can be explained -td
3598 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
3599 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3600 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
3601 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
3602 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3603 @item @code{KeyCancellation} @tab @code{Staff} @tab @code{begin-of-line-invisible}
3604 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
3605 @c omit LeftEdge until it can be explained -td
3606 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
3607 @item @code{ClefModifier} @tab @code{Staff} @tab @code{begin-of-line-visible}
3608 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
3609 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
3613 El ejemplo de abajo muestra el uso de la forma de vector para
3614 controlar la visibilidad de las líneas divisorias:
3616 @lilypond[quote,verbatim,ragged-right]
3620 % Remove bar line at the end of the current line
3621 \once \override Score.BarLine.break-visibility = ##(#f #t #t)
3628 Aunque los tres componentes del vector utilizado para
3629 sobreescribir @code{break-visibility} deben estar presentes, no
3630 todos son efectivos para todos los objetos de presentación, y
3631 algunas combinaciones pueden incluso dar errores. Son de
3632 aplicación las siguientes limitaciones:
3635 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
3636 @item No se puede imprimir el número de compás al principio de la primera
3637 línea a no ser que su valor establecido sea distinto de 1.
3638 @item Clave: véase más abajo
3639 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
3640 se suprimen por completo. Utilice begin-of line-invisible para
3641 imprimirlas y all-invisible para suprimirlas.
3642 @item Armadura: véase más abajo
3643 @item ClefModifier: véase más abajo
3647 @node Consideraciones especiales
3648 @unnumberedsubsubsec Consideraciones especiales
3649 @translationof Special considerations
3651 @subsubsubheading Visibilidad después de un cambio explícito
3653 @cindex armadura, visibilidad después de un cambio explícito
3654 @cindex explicitKeySignatureVisibility
3655 @cindex clave, visibilidad después de un cambio explícito
3656 @cindex explicitClefVisibility
3658 La propiedad @code{break-visibility} controla la visibilidad de
3659 las armaduras y cambios de clave sólo al principio de las líneas,
3660 es decir, después de un salto. No tiene ningún efecto sobre la
3661 visibilidad de la armadura o la clave después de un cambio
3662 explícito de tonalidad o de clave dentro o al final de una línea.
3663 En el ejemplo siguiente la armadura que sigue al cambio explícito
3664 de tonalidad a Si bemol mayor es visible incluso con
3665 @code{all-invisible} establecido.
3667 @lilypond[quote,verbatim,ragged-right]
3671 % Try to remove all key signatures
3672 \override Staff.KeySignature.break-visibility = #all-invisible
3681 La visibilidad de estos cambios explícitos de tonalidad y de clave
3682 se controla por medio de las propiedades
3683 @code{explicitKeySignatureVisibility} y
3684 @code{explicitClefVisibility}. Son los equivalentes de la
3685 propiedad @code{break-visibility} y las dos toman un vector de
3686 tres valores booleanos o las funciones predefinidas relacionadas
3687 anteriormente, exactamente igual que @code{break-visibility}. Las
3688 dos son propiedades del contexto Staff, no de los propios objetos
3689 de presentación, y por tanto se establecen utilizando la
3690 instrucción @code{\set}. Las dos están establecidas de forma
3691 predeterminada al valor @code{all-visible}. Estas propiedades
3692 controlan sólo la visibilidad de las armaduras y las claves que
3693 resultan de los cambios explícitos y no afectan a las armaduras y
3694 tonalidades que están al principio de las líneas; para quitarlas,
3695 aún se debe sobreescribir la propiedad @code{break-visibility} en
3696 el objeto correspondiente.
3698 @lilypond[quote,verbatim,ragged-right]
3702 \set Staff.explicitKeySignatureVisibility = #all-invisible
3703 \override Staff.KeySignature.break-visibility = #all-invisible
3711 @subsubsubheading Visibilidad de las alteraciones de precaución
3713 Para eliminar las alteraciones de cancelación que se imprimen en
3714 un cambio de tonalidad explícito, establezca la propiedad
3715 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3717 @lilypond[quote,verbatim,ragged-right]
3721 \set Staff.explicitKeySignatureVisibility = #all-invisible
3722 \set Staff.printKeyCancellation = ##f
3723 \override Staff.KeySignature.break-visibility = #all-invisible
3731 Con estas sobreescrituras solamente permanecen las alteraciones
3732 accidentales delante de las notas para indicar el cambio de
3735 Observe que al modificar la tonalidad a Do@tie{}mayor o
3736 La@tie{}menor, las alteraciones de cancelación serían @emph{la
3737 única} indicación del cambio de armadura. En este caso, el
3738 establecimiento de @code{printKeyCancellation} al valor @code{#f}
3739 no tiene ningún efecto:
3741 @lilypond[quote,verbatim,ragged-right]
3745 \set Staff.explicitKeySignatureVisibility = #all-invisible
3746 \set Staff.printKeyCancellation = ##f
3754 En lugar de ello, para suprimir las alteraciones de cancelación
3755 aún cuando la armadura cambia a Do@tie{}mayor o a La@tie{}menor,
3756 sobreescriba la visibilidad del grob @code{KeyCancellation}:
3758 @lilypond[quote,verbatim,ragged-right]
3762 \set Staff.explicitKeySignatureVisibility = #all-invisible
3763 \override Staff.KeyCancellation.break-visibility = #all-invisible
3771 @c TODO Add visibility of cautionary accidentals before notes
3773 @subsubsubheading Líneas divisorias automáticas
3775 @cindex automaticBars
3776 @cindex líneas divisorias, eliminación
3778 Como caso especial, la impresión de las líneas divisorias también
3779 se puede inhabilitar estableciendo la propiedad
3780 @code{automaticBars} en el contexto Score. Si se fija a
3781 @code{#f}, las barras de compás no se imprimen automáticamente; se
3782 deben crear explícitamente con una instrucción @code{\bar}. A
3783 diferencia de la instrucción predefinida @code{\cadenzaOn}, los
3784 compases se siguen contando. La generación de compases continúa
3785 de acuerdo a esta cuenta si esta propiedad se establece
3786 posteriormente a @code{#t}. Si se fija al valor @code{#f}, sólo
3787 pueden producirse saltos de línea en instrucciones @code{\bar}
3792 @subsubsubheading Claves transportadas
3794 @cindex transportadas, visibilidad de las claves
3795 @cindex visibilidad de las claves transportadas
3796 @cindex claves, visibilidad de la transposición
3798 El pequeño símbolo de transposición sobre una clave se produce por
3799 parte del objeto @code{ClefModifier}. Su visibilidad se hereda
3800 automáticamente de la del objeto @code{Clef}, así que no es
3801 necesario aplicar las sobreescrituras correspondientes
3802 @code{break-visibility} a los objetos @code{ClefModifier} para
3803 suprimir los símbolos de transposición u octavación para las
3806 Para los cambios de clave explícitos, la propiedad
3807 @code{explicitClefVisibility} controla tanto el símbolo de clave
3808 como el símbolo de transposición o de octava asociado.
3811 Manual de aprendizaje:
3812 @rlearning{Visibilidad y color de los objetos}
3815 @node Estilos de línea
3816 @subsection Estilos de línea
3817 @translationof Line styles
3819 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3820 @i{accelerando} y los @i{trinos} se escriben como texto y se
3821 extienden sobre muchos compases mediante líneas, a veces punteadas
3824 Todos ellos usan las mismas rutinas que el glissando para dibujar
3825 los textos y las líneas, y por ello el ajuste fino de su
3826 comportamiento se hace de la misma manera. Se hace con un spanner
3827 (un objeto de extensión), y la rutina responsable de dibujar los
3828 objetos de extensión es @code{ly:line-spanner::print}. Esta rutina
3829 determina la colocación exacta de los dos @i{extremos del objeto
3830 de extensión} y dibuja una línea entre ellos, en el estilo
3833 He aquí un ejemplo de los distintos estilos de línea disponibles,
3834 y cómo aplicarles ajustes finos.
3836 @lilypond[ragged-right,verbatim,quote]
3839 \once \override Glissando.style = #'dashed-line
3841 \override Glissando.style = #'dotted-line
3843 \override Glissando.style = #'zigzag
3845 \override Glissando.style = #'trill
3850 Las posiciones de los puntos extremos del objeto de extensión se
3851 computan al vuelo para cada uno de los objetos gráficos, pero es
3852 posible sobreescribirlos:
3855 @lilypond[ragged-right,verbatim,quote]
3858 \once \override Glissando.bound-details.right.Y = #-2
3863 El valor de @code{Y} está establecido a @w{@code{-2}} para el
3864 extremo derecho. El lado izquierdo se puede ajustar de forma
3865 similar especificando @code{left} en vez de @code{right}.
3867 Si no está establecido @code{Y}, el valor se computa a partir de la
3868 posición vertical de los puntos de anclaje izquierdo y derecho del
3871 Son posibles otros ajustes de los extensores, para ver más
3872 detalles consulte @ref{Objetos de extensión}.
3875 @node Rotación de objetos
3876 @subsection Rotación de objetos
3877 @translationof Rotating objects
3879 Tanto los objetos de presentación como los elementos de texto de
3880 marcado se pueden girar cualquier ángulo respecto a cualquier
3881 punto, pero difiere el método de hacerlo.
3884 * Rotación de objetos de presentación::
3885 * Rotación de elementos de marcado::
3888 @node Rotación de objetos de presentación
3889 @unnumberedsubsubsec Rotación de objetos de presentación
3890 @translationof Rotating layout objects
3892 @cindex rotating objects
3893 @cindex objects, rotating
3895 Todos los objetos de presentación que contemplan el interface
3896 @code{grob-interface} se pueden rotar estableciendo su propiedad
3897 @code{rotation}. Acepta una lista de tres elementos: el ángulo de
3898 la rotación en sentido antihorario, y las coordenadas x e y del
3899 punto con relación al punto de referencia del objeto, alrededor
3900 del que se va a realizar la rotación. El ángulo de rotación se
3901 especifica en grados y las coordenadas en espacios de pentagrama.
3903 El ángulo de rotación y las coordenadas del punto de rotación se
3904 deben determinar por ensayo y error.
3906 @cindex reguladores en ángulo
3907 @cindex ángulo, reguladores en
3909 Solamente en ciertas ocasiones es útil la rotación de objetos de
3910 presentación; el ejemplo siguiente muestra una situación en que
3913 @lilypond[quote,fragment,verbatim]
3915 \override Hairpin.rotation = #'(20 -1 0)
3920 @node Rotación de elementos de marcado
3921 @unnumberedsubsubsec Rotación de elementos de marcado
3922 @translationof Rotating markup
3924 Todos los textos de marcado se pueden rotar para que se dispongan
3925 en cualquier ángulo precediéndolos de la instrucción
3926 @code{\rotate}. La instrucción acepta dos argumentos: el ángulo
3927 de rotación en grados en sentido antihorario, y el texto que
3928 rotar. Los límites que ocupa el texto no se rotan: toman su valor
3929 a partir de los extremos de las coordenadas x e y del texto
3930 rotado. En el ejemplo siguiente la propiedad
3931 @code{outside-staff-priority} del texto se establece a @code{#f}
3932 para desactivar la evitación automática de colisiones, lo que
3933 empuja al texto a una posición muy alta.
3935 @lilypond[quote,fragment,verbatim]
3936 \override TextScript.outside-staff-priority = ##f
3937 g4^\markup { \rotate #30 "a G" }
3938 b^\markup { \rotate #30 "a B" }
3939 des'^\markup { \rotate #30 "a D-Flat" }
3940 fis'^\markup { \rotate #30 "an F-Sharp" }
3944 @node Trucos avanzados
3945 @section Trucos avanzados
3946 @translationof Advanced tweaks
3948 Esta sección trata sobre distintos enfoques en la realización de
3949 ajustes finos a la apariencia de la partitura impresa.
3952 * Alineación de objetos::
3953 * Agrupación vertical de objetos gráficos::
3954 * Modificación de los sellos::
3955 * Modificación de las formas::
3956 * Modificación de objetos de extensión divididos::
3957 * Contenedores unpure-pure::
3961 Manual de aprendizaje:
3962 @rlearning{Trucar la salida},
3963 @rlearning{Otras fuentes de información}.
3965 Referencia de la notación:
3966 @ref{Explicación del Manual de referencia de funcionamiento interno},
3967 @ref{Modificar las propiedades}.
3969 Manual de extensión:
3970 @rextend{Interfaces para programadores}.
3973 @file{scm/define-grobs.scm}.
3975 Fragmentos de código:
3976 @rlsr{Tweaks and overrides}.
3978 Referencia de funcionamiento interno:
3979 @rinternals{All layout objects}.
3982 @node Alineación de objetos
3983 @subsection Alineación de objetos
3984 @translationof Aligning objects
3986 Los objetos gráficos que soportan el interface
3987 @code{self-alignment-interface} y/o el
3988 @code{side-position-interface} se pueden alinear contra un objeto
3989 colocado previamente, de diversas maneras. Para ver una lista de
3990 estos objetos, consulte @rinternals{self-alignment-interface} y
3991 @rinternals{side-position-interface}.
3993 Todos los objetos gráficos tienen un punto de referencia, una
3994 extensión horizontal y una extensión vertical. La extensión
3995 horizontal es una pareja de números que dan los desplazamientos a
3996 partir del punto de referencia de los bordes izquierdo y derecho,
3997 siendo negativos los desplazamientos hacia la izquierda. La
3998 extensión vertical es una pareja de números que dan el
3999 desplazamiento a partir del punto de referencia hasta los bordes
4000 inferior y superior, siendo negativos los desplazamientos hacia
4003 La posición de un objeto sobre el pentagrama viene dada por los
4004 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
4005 valor de @code{X-offset} da el desplazamiento desde la coordenada
4006 X del punto de referencia del objeto padre, y el valor de
4007 @code{Y-offset} da el desplazamiento a partir de la línea central
4008 del pentagrama. Los valores de @code{X-offset} y @code{Y-offset}
4009 se pueden establecer directamente o se puede dejar que se calculen
4010 por parte de procedimientos para conseguir una alineación con el
4013 @warning{Muchos objetos tienen consideraciones de posicionamiento
4014 especiales que hacen que se ignore o se modifique cualquier ajuste
4015 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
4016 objeto contemple el interface @code{self-alignment-interface}. La
4017 sobreescritura de las propiedades @code{X-offset} ó
4018 @code{Y-offset} a un valor fijo hace que se descarte la respectiva
4019 propiedad @code{self-alignment}.}
4021 Por ejemplo, una alteración accidental se puede reposicionar
4022 verticalmente estableciendo @code{Y-offset} pero los cambios a
4023 @code{X-offset} no tienen ningún efecto.
4025 Las letras de ensayo se pueden alinear con objetos divisibles como
4026 líneas divisorias, claves, armaduras e indicaciones de compás.
4027 Hay propiedades especiales que se encuentran en
4028 @code{break-aligned-interface} para el posicionamiento de las
4029 letras de ensayo sobre dichos objetos.
4032 Referencia de la notación:
4033 @ref{Uso del break-alignable-interface}.
4035 Manual de extensión:
4036 @rextend{Funciones de callback}.
4039 * Establecer directamente X-offset e Y-offset::
4040 * Uso del side-position-interface::
4041 * Uso del self-alignment-interface::
4042 * Uso del break-alignable-interface::
4046 @node Establecer directamente X-offset e Y-offset
4047 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
4048 @translationof Setting X-offset and Y-offset directly
4050 Se pueden dar valores numéricos a las propiedades @code{X-offset}
4051 y @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra
4052 tres notas con una digitación en su posición predeterminada y con
4053 los valores @code{X-offset} y @code{Y-offset} modificados.
4055 @lilypond[verbatim,fragment,quote]
4062 -\tweak X-offset #-1
4070 @node Uso del side-position-interface
4071 @unnumberedsubsubsec Uso del @code{side-position-interface}
4072 @translationof Using the side-position-interface
4074 Un objeto que contempla el @code{side-position-interface} se puede
4075 colocar junto a su objeto padre de forma que los bordes
4076 especificados de los dos objetos se toquen. El objeto se puede
4077 situar encima, debajo, a la derecha o a la izquierda del objeto
4078 padre. El padre no se puede especificar; viene determinado por el
4079 orden de los elementos en el flujo de entrada. Casi todos los
4080 objetos tienen la cabeza de la nota asociada como padre.
4082 Los valores de las propiedades @code{side-axis} y @code{direction}
4083 determinan dónde colocar el objeto, como sigue:
4085 @c TODO add an example of each to the table
4087 @multitable @columnfractions .3 .3 .3
4088 @headitem @code{side-axis} @tab @code{direction} @tab
4089 @headitem propiedad @tab propiedad @tab colocación
4091 @item @code{0} @tab @w{@code{-1}} @tab izquierda
4092 @item @code{0} @tab @code{1} @tab derecha
4093 @item @code{1} @tab @w{@code{-1}} @tab debajo
4094 @item @code{1} @tab @code{1} @tab encima
4098 Si @code{side-axis} es @code{0}, @code{X-offset} se debe
4099 establecer al procedimiento
4100 @code{ly:side-position-interface::x-aligned-side}. Este
4101 procedimiento devuelve el calor correcto de @code{X-offset} para
4102 situar el objeto al lado izquierdo o derecho del padre de acuerdo
4103 con el valor de @code{direction}.
4105 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe
4106 establecer al procedimiento
4107 @code{ly:side-position-interface::y-aligned-side}. Este
4108 procedimiento devuelve el valor correcto de @code{Y-offset} para
4109 situar el objeto encima o debajo del padre de acuerdo con el valor
4110 de @code{direction}.
4112 @c TODO Add examples
4115 @node Uso del self-alignment-interface
4116 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
4117 @translationof Using the self-alignment-interface
4119 @subsubsubheading Auto-alineación horizontal de los objetos
4121 La alineación horizontal de un objeto que contempla el interface
4122 @code{self-alignment-interface} está controlada por el valor de la
4123 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
4124 @code{X-offset} de este objeto esté establecida a
4125 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le
4126 puede dar a @code{self-alignment-X} cualquier valor real, en
4127 unidades de la mitad de la extensión X total del objeto. Los
4128 valores negativos mueven el objeto a la derecha, los positivos
4129 hacia la izquierda. Un valor de @code{0} centra el objeto sobre
4130 el punto de referencia de su padre, un valor de @w{@code{-1}}
4131 alinea el borde izquierdo del objeto sobre el punto de referencia
4132 de su padre, y un valor de @code{1} alinea el borde derecho del
4133 objeto sobre el punto de referencia de su padre. Se pueden usar
4134 los símbolos @code{LEFT}, @code{CENTER} y @code{RIGHT} en
4135 sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
4138 Normalmente se usaría la instrucción @code{\override} para
4139 modificar el valor de @code{self-alignment-X}, pero se puede usar
4140 la instrucción @code{\tweak} para alinear varias anotaciones por
4141 separado sobre una sola nota:
4143 @lilypond[quote,verbatim,fragment]
4145 -\tweak self-alignment-X #-1
4147 -\tweak self-alignment-X #0
4149 -\tweak self-alignment-X #RIGHT
4151 -\tweak self-alignment-X #-2.5
4152 ^"aligned further to the right"
4155 @subsubsubheading Auto-alineación vertical de los objetos
4157 Los objetos se pueden alinear verticalmente en una forma análoga a la
4158 alineación horizontal si la propiedad @code{Y-offset} está establecida
4159 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
4160 a menudo se encuentran implicados otros mecanismos en la alineación
4161 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
4162 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
4163 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
4164 las dimensiones verticales del objeto, que suele ser bastante pequeño,
4165 por lo que pueden requerirse números bastante grandes. Un valor de
4166 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
4167 referencia del objeto padre, un valor de @code{0} alinea el centro del
4168 objeto con el punto de referencia del padre, y un valor de @code{1}
4169 alinea el borde superior del objeto con el punto de referencia del
4170 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
4171 @code{UP} en sustitución de @w{@code{-1}},
4172 @code{0} y @code{1}, respectivamente.
4174 @emph{Auto-alineación de objetos en las dos direcciones}
4176 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
4177 alinear un objeto en las dos direcciones simultáneamente.
4179 El ejemplo siguiente muestra cómo ajustar una digitación de forma
4180 que se acerque a la cabeza dela nota.
4182 @lilypond[quote,verbatim,fragment]
4184 -\tweak self-alignment-X #0.5 % move horizontally left
4185 -\tweak Y-offset #ly:self-alignment-interface::y-aligned-on-self
4186 -\tweak self-alignment-Y #-1 % move vertically up
4191 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
4193 @c Cannot document as they do not seem to operate consistently on all objects -td
4194 @c TODO investigate further
4196 The @code{aligned-on-parent} procedures are used in the same way
4197 as the @code{aligned-on-self} procedures, they difference being
4198 that they permit an object to be aligned with the @emph{edges} of
4199 the parent rather than the parent's reference point. The following
4200 example shows the difference:
4204 @lilypond[verbatim,quote]
4210 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
4212 @c Cannot document as they do not seem to operate consistently on all objects -td
4213 @c TODO investigate further
4217 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
4220 @node Uso del break-alignable-interface
4221 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
4222 @translationof Using the break-alignable-interface
4224 @cindex alineación a objetos
4225 @cindex break-align-symbols
4227 Las letras de ensayo se pueden alinear con objetos de notación
4228 distintos a las barras de compás. Estos objetos son
4229 @code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
4230 @code{staff-bar}, @code{left-edge}, @code{key-cancellation},
4231 @code{key-signature} y @code{time-signature}.
4233 Cada tipo de objeto tiene su propio punto de referencia
4234 predeterminado, con el que se alinean las marcas de ensayo:
4236 @lilypond[verbatim,quote,fragment]
4237 % The rehearsal mark will be aligned to the right edge of the Clef
4238 \override Score.RehearsalMark.break-align-symbols = #'(clef)
4243 % The rehearsal mark will be aligned to the left edge of the Time Signature
4244 \override Score.RehearsalMark.break-align-symbols = #'(time-signature)
4250 % The rehearsal mark will be centered above the Breath Mark
4251 \override Score.RehearsalMark.break-align-symbols = #'(breathing-sign)
4260 Se puede especificar una lista de posibles objetos para la
4261 alineación. Si algunos de los objetos son invisibles en ese punto
4262 debido al valor de @code{break-visibility} o a valores de
4263 visibilidad explícitos para las armaduras y las claves, la letra
4264 de ensayo o número de compás se alinean con el primer objeto de la
4265 lista que sea visible. Si ningún objeto de la lista es visible,
4266 el objeto se alinea con la línea divisoria. Si la línea divisoria
4267 es invisible, el objeto se alinea con el punto en el que se
4268 encontraría la línea divisoria.
4270 @lilypond[verbatim,quote,fragment]
4271 % The rehearsal mark will be aligned to the right edge of the Key Signature
4272 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4277 % The rehearsal mark will be aligned to the right edge of the Clef
4278 \set Staff.explicitKeySignatureVisibility = #all-invisible
4279 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4284 % The rehearsal mark will be centered above the Bar Line
4285 \set Staff.explicitKeySignatureVisibility = #all-invisible
4286 \set Staff.explicitClefVisibility = #all-invisible
4287 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4294 La alineación de la letra de ensayo con relación al objeto de
4295 notación se puede cambiar, como se ve en el ejemplo siguiente. En
4296 una partitura con varios pentagramas, este ajuste se debe hacer
4297 para todos los pentagramas.
4299 @lilypond[verbatim,quote,fragment]
4300 % The RehearsalMark will be aligned with the right edge of the Key Signature
4301 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4307 % The RehearsalMark will be centered above the Key Signature
4308 \once \override Score.KeySignature.break-align-anchor-alignment = #CENTER
4312 % The RehearsalMark will be aligned with the left edge of the Key Signature
4313 \once \override Score.KeySignature.break-align-anchor-alignment = #LEFT
4319 La letra de ensayo también se puede desplazar al borde derecho o
4320 izquierdo en una medida arbitraria. Las unidades son espacios de
4323 @lilypond[verbatim,quote,fragment]
4324 % The RehearsalMark will be aligned with the left edge of the Key Signature
4325 % and then shifted right by 3.5 staff-spaces
4326 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4327 \once \override Score.KeySignature.break-align-anchor = #3.5
4331 % The RehearsalMark will be aligned with the left edge of the Key Signature
4332 % and then shifted left by 2 staff-spaces
4333 \once \override Score.KeySignature.break-align-anchor = #-2
4340 @node Agrupación vertical de objetos gráficos
4341 @subsection Agrupación vertical de objetos gráficos
4342 @translationof Vertical grouping of grobs
4344 @c TODO Expand this section
4346 Los grobs (objetos gráficos) @code{VerticalAlignment} y
4347 @code{VerticalAxisGroup} trabajan de manera coordinada.
4348 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
4349 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
4350 distintos grobs agrupados previamente por
4351 @code{VerticalAxisGroup}. Normalmente sólo existe un
4352 @code{VerticalAlignment} por cada partitura, pero cada
4353 @code{Staff}, @code{Lyrics}, etc. tiene su propio
4354 @code{VerticalAxisGroup}.
4357 @node Modificación de los sellos
4358 @subsection Modificación de los sellos
4359 @translationof Modifying stencils
4361 Todos los objetos de presentación tienen una propiedad
4362 @code{stencil} que es parte del @code{grob-interface}. De forma
4363 predeterminada, esta propiedad suele estar establecida a una
4364 función específica del objeto que está hecha a medida para
4365 disponer el símbolo que lo representa en la salida. Por ejemplo,
4366 el ajuste estándar para la propiedad @code{stencil} del objeto
4367 @code{MultiMeasureRest} es @code{ly:multi-measure-rest::print}.
4369 El símbolo estándar de cualquier objeto se puede sustituir
4370 modificando la propiedad @code{stencil} para que haga referencia a
4371 un procedimiento diferente escrito especialmente. Esto requiere
4372 un alto nivel de conocimiento del funcionamiento interno de
4373 LilyPond, pero hay una forma más fácil que a menudo puede dar
4374 resultados adecuados.
4376 El procedimiento es establecer la propiedad @code{stencil} al
4377 procedimiento que imprime texto (@code{ly:text-interface::print})
4378 y añadir una propiedad @code{text} al objeto ajustada para que
4379 contenga el texto de marcado que produce el símbolo requerido.
4380 Debido a la flexibilidad del marcado, se pueden conseguir muchas
4381 cosas; en particular, consulte @ref{Notación gráfica dentro de
4382 elementos de marcado}.
4384 El ejemplo siguiente muestra esto cambiando el símbolo de la
4385 cabeza de la nota a unas aspas dentro de una circunferencia.
4387 @lilypond[verbatim,quote]
4389 \once \override NoteHead.stencil = #ly:text-interface::print
4390 \once \override NoteHead.text = \markup {
4392 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
4393 \musicglyph #"noteheads.s2cross"
4401 Cualquiera de los glifos de la fuente tipográfica Feta se puede
4402 pasar a la instrucción de marcado @code{\musicglyph}: véase
4403 @ref{La tipografía Feta}.
4405 @c TODO Add inserting eps files or ref to later
4407 @c TODO Add inserting Postscript or ref to later
4410 Referencia de la notación:
4411 @ref{Notación gráfica dentro de elementos de marcado},
4412 @ref{Formatear el texto},
4413 @ref{Text markup commands},
4414 @ref{La tipografía Feta}.
4417 @node Modificación de las formas
4418 @subsection Modificación de las formas
4419 @translationof Modifying shapes
4422 * Modificación de ligaduras de unión y de expresión::
4426 @node Modificación de ligaduras de unión y de expresión
4427 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
4428 @translationof Modifying ties and slurs
4430 @cindex ligaduras de expresión, modificar
4431 @cindex ligaduras de unión, modificar
4432 @cindex Bézier, curvas de, puntos de control
4433 @cindex puntos de control en curvas de Bézier
4435 Las ligaduras de unión (@code{Tie}s), de expresión (@code{Slur}s),
4436 de fraseo (@code{PhrasingSlur}s), de dejar vibrar
4437 (@code{LaissezVibrerTie}s) y de repetición (@code{RepeatTie}s) se
4438 trazan como curvas de Bézier de tercer orden. Si la forma de la
4439 ligadura calculada automáticamente no resulta óptima, se puede
4440 modificar su forma manualmente de dos formas:
4444 mediante la especificación de los desplazamientos que se quieren
4445 realizar sobre los puntos de control de la curva de Bézier
4446 calculada automáticamente, o bien
4449 mediante la especificación explícita de las posiciones de los
4450 cuatro puntos de control que se requieren para definir la curva
4454 A continuación se explican ambos métodos. El primer método es más
4455 adecuado cuando solo se requieren ligeros ajustes de la curva; el
4456 segundo puede ser mejor para crear curvas que tienen relación con
4459 @subsubsubheading Curvas de Bézier cúbicas
4461 Las curvas Bézier de tercer orden o cúbicas están definidas por
4462 cuatro puntos de control. El primer y cuarto puntos de control
4463 son exactamente los puntos extremos de comienzo y de final de la
4464 curva. Los dos puntos de control intermedios definen la forma.
4465 Se pueden encontrar en la web animaciones que muestran cómo se
4466 traza la curva, pero la descripción siguiente puede ser de ayuda.
4467 La curva comienza a partir del primer punto de control
4468 dirigiéndose directamente hacia el segundo, curvándose
4469 progresivamente para dirigirse hacia el tercero y continuando la
4470 curva hacia el cuarto, llegando a éste en viaje directo desde el
4471 tercer punto de control. La curva está contenida enteramente
4472 dentro del cuadrilátero definido por los cuatro puntos de control.
4473 Todas las traslaciones, rotaciones y escalado de los puntos de
4474 control producen exactamente las mismas operaciones sobre la
4477 @subsubsubheading Especificar desplazamientos a partir de los puntos de control actuales
4479 @cindex conformar ligaduras
4482 En este ejemplo, la colocación automática de la ligadura no
4483 resulta óptima, y @code{\tieDown} no es la solución.
4485 @lilypond[verbatim,quote]
4489 \relative { r4 <g' c,> <g c,> <g c,> }
4493 El ajuste de los puntos de control de la ligadura mediante la
4494 instrucción @code{\shape} permite evitar las colisiones.
4496 La sintaxis de @code{\shape} es:
4499 [-]@code{\shape} @var{desplazamientos} @var{elemento}
4502 Esta instrucción recoloca los puntos de control de @var{elemento}
4503 en las cantidades dadas por @var{desplazamientos}. El argumento
4504 @var{desplazamientos} es una lista de parejas de números o una
4505 lista de tales listas. Cada elemento de una pareja representa el
4506 desplazamiento de una de las coordenadas de un punto de control.
4507 Si el @var{elemento} es una cadena de caracteres, el resultado es
4508 @code{\once\override} para el tipo de grob especificado. Si
4509 @var{elemento} es una expresión musical, el resultado es la misma
4510 expresión musical con la consiguiente modificación aplicada.
4512 En otras palabras, la función @code{\shape} puede actuar como una
4513 instrucción @code{\once\override} o como una instrucción
4514 @code{\tweak} dependiendo de si el argumento @var{elemento} es el
4515 nombre de un grob, como @qq{Slur}, o una expresión musical, como
4516 @qq{(}. El argumento @var{desplazamientos} especifica los
4517 desplazamientos de los cuatro puntos de control como una lista de
4518 cuatro parejas de valores (dx . dy) en unidades de espacios de
4519 pentagrama (o una lista de tales listas si la curva tiene más de
4522 El guión precedente se exige si, y sólo si, se usa la forma
4525 Así, usando el mismo ejemplo de arriba y la forma
4526 @code{\once\override} de la instrucción @code{\shape}, lo
4527 siguiente tiene el efecto de elevar la ligadura de unión en la
4528 mitad de un espacio de pentagrama:
4530 @lilypond[verbatim,quote]
4533 \shape #'((0 . 0.5) (0 . 0.5) (0 . 0.5) (0 . 0.5)) Tie
4537 \relative { r4 <g' c,> <g c,> <g c,> }
4541 Este posicionamiento de la ligadura de unión es mejor, pero quizá
4542 debería elevarse más en la parte central. El ejemplo siguiente
4543 hace esto, esta vez usando la forma alternativa @code{\tweak}:
4545 @lilypond[verbatim,quote]
4548 e'1-\shape #'((0 . 0.5) (0 . 1) (0 . 1) (0 . 0.5)) ~ e'
4551 \relative { r4 <g' c,> <g c,> <g c,> }
4555 Los cambios en las posiciones horizontales de los puntos de
4556 control se pueden hacer de la misma forma, y dos curvas distintas
4557 que dan comienzo en el mismo momento musical se pueden conformar
4560 @lilypond[verbatim,quote,ragged-right]
4562 c''8(\( a) a'4 e c\)
4563 \shape #'((0.7 . -0.4) (0.5 . -0.4) (0.3 . -0.3) (0 . -0.2)) Slur
4564 \shape #'((0 . 0) (0 . 0.5) (0 . 0.5) (0 . 0)) PhrasingSlur
4569 La función @code{\shape} también puede desplazar los puntos de
4570 control de las curvas que se extienden atravesando saltos de
4571 línea. Cada pieza de la curva dividida puede recibir su propia
4572 lista de desplazamientos. Si no se necesita hacer cambios a uno
4573 de los segmentos en particular, se puede usar una lista vacía como
4574 contenedor. En este ejemplo, el salto de línea hace que la única
4575 ligadura de expresión aparezca como si fueran dos:
4577 @lilypond[verbatim,quote,ragged-right]
4585 Los cambios en la forma de las dos mitades de la ligadura de
4586 expresión deja más claro que la ligadura continúa más allá del
4589 @lilypond[verbatim,quote,ragged-right]
4590 % () may be used as a shorthand for ((0 . 0) (0 . 0) (0 . 0) (0 . 0))
4591 % if any of the segments does not need to be changed
4594 (( 0 . 0) (0 . 0) (0 . 0) (0 . 1))
4595 ((0.5 . 1.5) (1 . 0) (0 . 0) (0 . -1.5))
4603 En una curva en forma de «S» siempre es necesario ajustar
4604 manualmente los puntos de control: LilyPond nunca escoge tales
4605 formas automáticamente.
4607 @lilypond[verbatim,quote]
4609 c8( e b-> f d' a e-> g)
4610 \shape #'((0 . -1) (5.5 . -0.5) (-5.5 . -10.5) (0 . -5.5)) PhrasingSlur
4611 c8\( e b-> f d' a e-> g\)
4615 @subsubsubheading Especificar los puntos de control explícitamente
4617 Las coordenadas de los puntos de contro de Bézier se especifican
4618 en unidades de espacios de pentagrama. La coordenada@tie{}X es
4619 relativa al punto de referencia al que se adjunta la ligadura, y
4620 la coordenada@tie{}Y es relativa a la línea central del
4621 pentagrama. Las coordenadas se especifican como una lista de
4622 cuatro parejas de números decimales (reales). Un enfoque consiste
4623 en estimar las coordenadas de los dos extremos, y después adivinar
4624 los dos puntos intermedios. Los valores óptimos se encuentran
4625 después por ensayo y error. Tenga en cuenta que estos valores
4626 podrían requerir un ajuste manual si se hace posteriormente
4627 cualquier cambio manual a la música o a la disposición.
4629 Una situación en la que es preferible especificar los puntos de
4630 control explícitamente a especificar los desplazamientos es cuando
4631 se necesita especificarlos de forma relativa a una nota única. A
4632 continuación presentamos un ejemplo de esto. Muestra una forma de
4633 indicar una ligadura que se extiende hacia el interior de las
4634 casillas de primera y segunda vez de una repetición.
4636 @lilypond[verbatim,quote]
4639 \repeat volta 3 { c4 d( e f }
4644 % create a slur and move it to a new position
4645 % the <> is just an empty chord to carry the slur termination
4646 -\tweak control-points #'((-2 . 3.8) (-1 . 3.9) (0 . 4) (1 . 3.4)) ( <> )
4651 % create a slur and move it to a new position
4652 -\tweak control-points #'((-2 . 3) (-1 . 3.1) (0 . 3.2) (1 . 2.4)) ( <> )
4660 No es posible modificar la forma de las ligaduras de unión o de
4661 expresión cambiando la propiedad @code{control-points} si hay más
4662 de una en el mismo momento musical, ni siquiera usando la
4663 instrucción @code{\tweak}. Sin embargo, se puede sobreescribir la
4664 propiedad @code{tie-configuration} de @code{TieColumn} para fijar
4665 la línea de inicio y la dirección según se requiera.
4668 Referencia de funcionamiento interno:
4669 @rinternals{TieColumn}.
4672 @node Modificación de objetos de extensión divididos
4673 @subsection Modificación de objetos de extensión divididos
4674 @translationof Modifying broken spanners
4677 * Uso de alterBroken::
4680 @node Uso de alterBroken
4681 @unnumberedsubsubsec Uso de @code{\alterBroken}
4682 @translationof Using alterBroken
4684 @cindex extensión, modificación de objetos de
4685 @cindex divididos, modificación de objetos de extensión
4686 @funindex \alterBroken
4688 Cuando un @qq{spanner} u objeto extenso atraviesa uno o varios
4689 saltos de línea, cada fragmento hereda los atributos del objeto de
4690 extensión original. Así, el trucado ordinario de un objeto
4691 dividido aplica las mismas modificaciones a todos y cada uno de
4692 sus segmentos. En el ejemplo que aparece a continuación, la
4693 sobreescritura de @code{thickness} (grosor) afecta a la ligadura a
4694 ambos lados del salto de línea.
4696 @lilypond[verbatim,quote,ragged-right]
4699 \once\override Slur.thickness = 10
4706 Es posible modificar de forma independiente el aspecto de los
4707 fragmentos individuales de un objeto de extensión dividido, con la
4708 instrucción @code{\alterBroken}. Esta instrucción puede producir
4709 un @code{\override} o bien un @code{\tweak} de una propiedad del
4710 objeto de extensión.
4712 La sintaxis de @code{\alterBroken} es
4715 [-]@code{\alterBroken} @var{propiedad} @var{valores} @var{elemento}
4718 El argumento @var{valores} es una lista de valores, uno por cada
4719 fragmento. Si @var{elemento} el el nombre de un grob como
4720 @code{Slur} o @code{Staff.PianoPedalBracket}, el resultado es una
4721 instrucción de sobreescritura @code{\override} del tipo de grob
4722 especificado. Si @var{elemento} es una expresión musical como
4723 @qq{(} o @qq{[} el resultado es la misma expresión musical con el
4724 correspondiente truco aplicado.
4726 El guión inicial se debe utilizar con la forma de trucaje,
4727 @code{\tweak}. No lo escriba cuando utilice @code{\alterBroken}
4728 como una operación de sobreescritura, @code{\override}.
4730 En su uso como @code{\override}, @code{\alterBroken} puede ir
4731 precedido de @code{\once} o @code{\temporary} y ser revertido con
4732 @code{\revert} con el argumento @var{propiedad}.
4734 EL código siguiente aplica un @code{\override} independiente a
4735 cada uno de los fragmentos de la ligadura del ejemplo anterior:
4737 @lilypond[verbatim,quote,ragged-right]
4740 \alterBroken thickness #'(10 1) Slur
4747 La instrucción @code{\alterBroken} se puede usar con cualquier
4748 objeto de extensión, incluidos @code{Tie}, @code{PhrasingSlur},
4749 @code{Beam} y @code{TextSpanner}. Por ejemplo, un editor que está
4750 preparando una edición académica podría desear indicar la ausencia
4751 de parte de una ligadura de fraseo en una fuente haciendo
4752 discontinuo solamente el segmento que se ha añadido. El siguiente
4753 ejemplo ilustra de qué manera se puede hacer esto, en este caso
4754 usando la forma @code{\tweak} de la instrucción:
4756 @lilypond[verbatim,quote,ragged-right]
4757 % The empty list is conveniently used below, because it is the
4758 % default setting of dash-definition, resulting in a solid curve.
4760 c''2-\alterBroken dash-definition #'(() ((0 1.0 0.4 0.75))) \(e
4766 Es importante comprender que @code{\alterBroken} fija cada pieza
4767 del objeto fragmentado al valor correspondiente dentro del
4768 argumento @var{valores}. Cuando hay menos valores que piezas,
4769 cualquier fragmento adicional recibe la asignación de la lista
4770 vacía. Esto puede conllevar resultados no deseados si la
4771 propiedad de disposición no está establecida a la lista vacía de
4772 forma predeterminada. En estos casos, se debe asignar a cada
4773 segmento un valor adecuado.
4776 Los saltos de línea pueden ocurrir en distintos lugares según
4777 cambia la disposición de la música. Los ajustes elegidos para
4778 @code{\alterBroken} podrían no ser adecuados para un objeto de
4779 extensión que ya no está dividido o que se fragmenta en más piezas
4780 que antes. El uso explícito (manual) de saltos de línea mediante
4781 @code{\break} puede prevenir situaciones como ésta.
4783 La instrucción @code{\alterBroken} no es efectiva para propiedades
4784 de los objetos extensos accedidas antes del salto de línea, como
4789 @rextend{Trucos difíciles}.
4792 @node Contenedores unpure-pure
4793 @subsection Contenedores unpure-pure
4794 @translationof Unpure-pure containers
4796 @cindex Scheme, contenedores puros
4797 @cindex Scheme, contenedores no-puros
4798 @cindex puros, contenedores de Scheme
4799 @cindex no-puros: contenedores de Scheme
4800 @cindex horizontal, sobreescribir el espaciado
4802 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para
4803 la sobreescritura de los cálculos del espaciado en el @emph{eje Y}
4804 (concretamente @code{Y-offset} e @code{Y-extent}) con una función
4805 de Scheme en lugar de un literal, es decir, un número o una pareja
4808 Para ciertos objetos gráficos, las dimensiones @code{Y-extent}
4809 están basadas en la propiedad @code{stencil}, la sobreescritura de
4810 la propiedad de sello de éstos requiere una sobreescritura
4811 adicional de @code{Y-extent} con un contenedor unpure-pure.
4812 Cuando una función sobreescribe una dimensión @code{Y-offset} y/o
4813 @code{Y-extent} se supone que esto dispara los cálculos de los
4814 saltos de línea prematuramente durante la compilación. Así pues,
4815 la función no se evalúa en absoluto (devolviendo por lo general un
4816 valor de @samp{0} o @samp{'(0 . 0)}) lo que puede dar lugar a
4817 colisiones. Una función @q{pura} no afecta a las propiedades,
4818 objetos o suicidios de grobs, y por ello siempre ven sus valores
4819 relacionados con el eje Y evaluados correctamente.
4821 Actualmente hay unas treinta funciones que ya se consideran
4822 @q{puras} y los contenedores Unpure-pure son una manera de
4823 establecer funciones que no están en esta lista como @q{puras}.
4824 La función @q{pura} se evalúa @emph{antes} de cualquier salto de
4825 línea y así el espaciado horizontal se puede ajustar @q{a tiempo}.
4826 La función @q{impura} se evalúa entonces @emph{después} del salto
4829 @warning{Dado que es difícil saber siempre qué funciones están en
4830 esta lista, recomendamos que cualquier función @q{pura} que
4831 estemos creando no utilice los grobs @code{Beam} o
4832 @code{VerticalAlignment}.}
4834 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
4836 @code{(ly:make-unpure-pure-container f0 f1)}
4838 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
4839 1}) y el primer argumento siempre debe ser el grob. Ésta es la
4840 función que da el resultado real. @var{f1} es la función que se
4841 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
4842 primer argumento debe ser siempre el grob pero los argumentos segundo
4843 y tercero son argumentos de @q{inicio} y de @q{final}.
4845 @var{inicio} y @var{final} son, a todos los efectos, valores mudos
4846 que sólo tienen importancia para los @code{objetos de extensión}
4847 (o sea: @code{Hairpin}, regulador, o @code{Beam}, barra), que
4848 pueden devolver distintas estimaciones de altura basadas en una
4849 columna de inicio y una de final.
4851 El resto son los otros argumentos para la primera función (que
4852 puede no ser ninguno si @var{n = 1}).
4854 El resultado de la segunda función se usa como una aproximación del
4855 valor necesario, que se usa entonces por la primera función para
4856 obtener el valor real que se usa a continuación para el ajuste de
4857 precisión mucho más tardío durante el proceso de espaciado.
4859 @lilypond[verbatim,quote,ragged-right]
4860 #(define (square-line-circle-space grob)
4861 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
4862 (notename (ly:pitch-notename pitch)))
4863 (if (= 0 (modulo notename 2))
4864 (make-circle-stencil 0.5 0.0 #t)
4865 (make-filled-box-stencil '(0 . 1.0)
4868 squareLineCircleSpace = {
4869 \override NoteHead.stencil = #square-line-circle-space
4872 smartSquareLineCircleSpace = {
4873 \squareLineCircleSpace
4874 \override NoteHead.Y-extent =
4875 #(ly:make-unpure-pure-container
4876 ly:grob::stencil-height
4877 (lambda (grob start end) (ly:grob::stencil-height grob)))
4880 \new Voice \with { \remove "Stem_engraver" }
4882 \squareLineCircleSpace
4884 \smartSquareLineCircleSpace
4889 En el primer compás, sin el contenedor @emph{unpure-pure}, el
4890 motor de espaciado no conoce la anchura de la cabeza de la nota y
4891 permite que colisione con las alteraciones accidentales. En el
4892 segundo compás, el motor de espaciado conoce la anchura de las
4893 cabezas de las notas y evita la colisión mediante el alargamiento
4894 de la línea en la medida adecuada.
4896 Normalmente, para cálculos simples se pueden usar funciones casi
4897 idénticas tanto para las partes @q{no pura} y @q{pura},
4898 simplemente cambiando el número de argumentos que se pasan a, y el
4899 ámbito de, la función. Este caso de utilización es lo bastante
4900 frecuente como para que @code{ly:make-unpure-pure-container}
4901 construya dicha segunda función de forma predeterminada cuando se
4902 llama con solo un argumento de función.
4904 @warning{Si una función está caracterizada como @q{pura} y resulta
4905 que no lo es, el resultado puede ser inesperado.}
4908 @node Uso de las funciones musicales
4909 @section Uso de las funciones musicales
4910 @translationof Using music functions
4912 @c TODO -- add @seealso, etc. to these subsections
4914 Dondequiera que se necesite reutilizar trucos con distintas
4915 expresiones musicales, con frecuencia conviene hacer que el truco
4916 forme parte de una @emph{función musical}. En esta sección
4917 estudiaremos solamente las funciones de @emph{sustitución}, en las
4918 que el objeto es sustituir una variable dentro de un fragmento de
4919 código de entrada de LilyPond. Se describen otras funciones más
4920 complejas en @rextend{Funciones musicales}.
4923 * Sintaxis de las funciones de sustitución::
4924 * Ejemplos de funciones de sustitución::
4928 @node Sintaxis de las funciones de sustitución
4929 @subsection Sintaxis de las funciones de sustitución
4930 @translationof Substitution function syntax
4932 Es fácil hacer una función que sustituya una variable dentro de
4933 código de LilyPond. La forma general de estas funciones es
4937 #(define-music-function
4938 (@var{arg1} @var{arg2} @dots{})
4939 (@var{type1?} @var{type2?} @dots{})
4941 @var{@dots{}música@dots{}}
4948 @multitable @columnfractions .33 .66
4949 @item @code{@var{argN}}
4950 @tab @var{n}-ésimo argumento
4952 @item @code{@var{typeN?}}
4953 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
4954 debe devolver @code{#t}.
4956 @item @code{@var{@dots{}música@dots{}}}
4957 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
4958 lugares en que sólo se permiten construcciones de Lilypond) o
4959 @code{#} (para usarlo como un valor de Scheme o un argumento de
4960 función musical o música dentro de listas de música) para
4961 referenciar argumentos (p.ej. @samp{#arg1}).
4964 Es necesaria la lista de predicados de tipo. Algunos de los
4965 predicados de tipo más comunes que se utilizan en las funciones
4970 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
4982 Para ver una lista de los predicados de tipo disponibles, consulte
4983 @ref{Predicados de tipo predefinidos}. También se permiten los
4984 predicados de tipo definidos por el usuario.
4987 Referencia de la notación:
4988 @ref{Predicados de tipo predefinidos}.
4990 Expansión de LilyPond:
4991 @rextend{Sintaxis de las funciones musicales}.
4993 Archivos instalados:
4994 @file{lily/music-scheme.cc},
4996 @file{scm/lily.scm}.
4999 @node Ejemplos de funciones de sustitución
5000 @subsection Ejemplos de funciones de sustitución
5001 @translationof Substitution function examples
5003 Esta sección presenta algunos ejemplos de funciones de
5004 sustitución. No pretenden ser exhaustivas, sino demostrar algunas
5005 de las posibilidades de las funciones de sustitución sencillas.
5007 En el primer ejemplo se define una función que simplifica el
5008 ajuste del relleno de un elemento de inscripción de texto
5011 @lilypond[quote,verbatim,ragged-right]
5013 #(define-music-function
5017 \once \override TextScript.padding = #padding
5021 c''4^"piu mosso" b a b
5023 c4^"piu mosso" b a b
5025 c4^"piu mosso" b a b
5029 Además de números, podemos usar expresiones musicales, como notas,
5030 para los argumentos de las funciones musicales:
5032 @lilypond[quote,verbatim,ragged-right]
5034 #(define-music-function
5038 \tweak NoteHead.stencil #ly:text-interface::print
5039 \tweak NoteHead.text
5040 \markup \musicglyph #"custodes.mensural.u0"
5041 \tweak Stem.stencil ##f
5045 \relative { c'4 d e f \custosNote g }
5049 Ambas funciones son expresiones únicas sencillas en las que solo
5050 falta el último elemento de una lamada de función o
5051 sobreescritura. Para estas definiciones de función en particular,
5052 existe una sintaxis alternativa más simple que consiste
5053 simplemente en escribir la parte constante de la expresión y
5054 sustituir el elemento final que falta por @code{\etc}:
5056 @lilypond[quote,verbatim,ragged-right]
5058 \once \override TextScript.padding = \etc
5061 c''4^"piu mosso" b a b
5063 c4^"piu mosso" b a b
5065 c4^"piu mosso" b a b
5069 @lilypond[quote,verbatim,ragged-right]
5071 \tweak NoteHead.stencil #ly:text-interface::print
5072 \tweak NoteHead.text
5073 \markup \musicglyph #"custodes.mensural.u0"
5074 \tweak Stem.stencil ##f
5077 \relative { c'4 d e f \custosNote g }
5081 Se pueden definir funciones de sustitución con más de un
5084 @lilypond[quote,verbatim,ragged-right]
5086 #(define-music-function
5090 \once \override Score.MetronomeMark.padding = #padding
5091 \tempo \markup { \bold #tempotext }
5095 \tempo \markup { "Low tempo" }
5097 \tempoPadded #4.0 "High tempo"
5102 @c TODO: add appropriate @@ref's here.