1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: c377d85f06e524599d20e9edf102ae186ede5e77
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
524 en que no tienen nada que hacer. Así, los contextos de
525 @code{Voice} mueren tan pronto como ya no contienen ningún evento,
526 los contextos de @code{Staff} mueren tan pronto como todos los
527 contextos de @code{Voice} que contenían ya no contengan ningún
528 evento, etc. Esto puede ocasionar dificultades si se tiene que
529 hacer referencia a contextos anteriores que ya han muerto, por
530 ejemplo, al cambiar de pentagramas con instrucciones
531 @code{\change}, asociar letra con una voz mediante instrucciones
532 @code{\lyricsto}, o cuando se añaden eventos musicales adicionales
533 a un contexto anterior.
535 Existe una excepción a esta regla general: dentro de una
536 construcción @code{@{@dots{}@}} (música secuencial), la noción que
537 la construcción tiene del @qq{contexto actual} descenderá un nivel
538 cada vez que un elemento de la secuencia finaliza en un
539 subcontexto del contexto anterior. Esto evita la creación espúrea
540 de contextos implícitos en ciertas situaciones, pero significa que
541 el primer contexto dentro del que se desciende, se va a mantener
542 vivo hasta el final de la expresión.
544 Como contraste, los contextos de una expresión hecha con la
545 construcción @code{<<@dots{}>>} (música simultánea) no se
546 prolongan, por lo que si una instrucción que crea un contexto se
547 encierra en otro par de @code{<<@dots{}>>}, se impedirá que el
548 contexto persista durante toda la duración de la secuencia
549 @code{@{@dots{}@}} que lo contiene.
551 Cualquier contexto se puede mantener vivo si nos aseguramos de que
552 tiene algo que hacer en cualquier momento musical dado. Los
553 contextos de @code{Staff} se mantienen con vida si nos aseguramos
554 de que una de sus voces se mantiene viva. Una manera de hacerlo
555 es añadir silencios de separación a una voz en paralelo con la
556 música real. Éstos deben añadirse a todos y cada uno de los
557 contextos de @code{Voice} que se hayan de mantener vivos. Si se
558 van a usar esporádicamente varias voces, es más seguro mantenerlas
559 todas vivas en lugar de tratar de confiar en las excepciones que
560 hemos mencionado arriba.
562 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
563 vivas de esta manera durante la duración de la pieza:
565 @lilypond[quote,verbatim]
566 musicA = \relative { d''4 d d d }
567 musicB = \relative { g'4 g g g }
570 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
571 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
576 \context Voice = "A" {
580 \context Voice = "B" {
584 \context Voice = "A" { \musicA }
585 \context Voice = "B" { \musicB }
586 \context Voice = "A" { \musicA }
597 @cindex letra, alineación con melodía esporádica
599 El ejemplo siguiente muestra cómo se puede escribir una línea
600 melódica esporádica con letra utilizando este enfoque. Por
601 supuesto, en una situación real la melodía y el acompañamiento
602 consistirían en varias secciones diferentes.
604 @lilypond[quote,verbatim]
605 melody = \relative { a'4 a a a }
606 accompaniment = \relative { d'4 d d d }
607 words = \lyricmode { These words fol -- low the mel -- o -- dy }
610 \new Staff = "music" {
612 \new Voice = "melody" {
614 s1*4 % Keep Voice "melody" alive for 4 bars
617 \new Voice = "accompaniment" {
622 \context Voice = "melody" { \melody }
623 \context Voice = "accompaniment" { \accompaniment }
625 \context Voice = "accompaniment" { \accompaniment }
627 \context Voice = "melody" { \melody }
628 \context Voice = "accompaniment" { \accompaniment }
633 \new Lyrics \with { alignAboveContext = #"music" }
634 \lyricsto "melody" { \words }
639 Una forma alternativa, que podría resultar mejor en muchas
640 situaciones, es mantener con vida la línea melódica simplemente
641 incluyendo notas espaciadoras para alinearla correctamente con el
644 @lilypond[quote,verbatim]
651 accompaniment = \relative {
657 words = \lyricmode { These words fol -- low the mel -- o -- dy }
661 \new Staff = "music" {
663 \new Voice = "melody" {
667 \new Voice = "accompaniment" {
673 \new Lyrics \with { alignAboveContext = #"music" }
674 \lyricsto "melody" { \words }
680 @node Modificar los complementos (plug-ins) de contexto
681 @subsection Modificar los complementos (plug-ins) de contexto
682 @translationof Modifying context plug-ins
684 @c TODO Should this be Modifying engravers or Modifying contexts?
686 Los contextos de notación (como @code{Score} y @code{Staff}) no
687 sólo almacenan propiedades, también contienen «plug-ins» o
688 complementos llamados @q{grabadores} que crean elementos de
689 notación. Por ejemplo, el contexto @code{Voice} contiene un
690 grabador @code{Note_heads_engraver} que crea las cabezas de nota y
691 el contexto @code{Staff} contiene un grabador @code{Key_engraver}
692 que crea la armadura.
694 Para ver una descripción completa de todos y cada uno de los
695 complementos, consulte
697 @rinternals{Engravers and Performers}.
700 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
702 Cada contexto que se describe en
704 @rinternals{Contexts}
707 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
709 relaciona los grabadores que se usan para ese contexto.
712 Puede ser de utilidad jugar un poco con estos complementos. Se
713 hace iniciando un contexto nuevo con @code{\new} o @code{\context}
719 \new @var{contexto} \with @{
727 @emph{@dots{}música@dots{}}
732 donde los @dots{} deben ser el nombre de un grabador. Aquí
733 tenemos un ejemplo sencillo que suprime los grabadores
734 @code{Time_signature_engraver} y @code{Clef_engraver} de un
735 contexto @code{Staff}:
737 @lilypond[quote,verbatim]
739 \new Staff \relative {
743 \remove "Time_signature_engraver"
744 \remove "Clef_engraver"
751 En el segundo pentagrama no hay indicación de compás ni clave.
752 Éste es un método bastante rudimentario de hacer que desaparezcan
753 los objetos porque afecta a todo el pentagrama. Este método
754 también afecta al espaciado, lo que puede ser deseable o no serlo.
755 Se muestran métodos más sofisticados para quitar objetos en
756 @rlearning{Visibilidad y color de los objetos}.
758 El ejemplo siguiente muestra una aplicación práctica. Normalmente
759 las líneas divisorias y las indicaciones de compás están
760 sincronizadas a lo largo de toda la partitura. Lo hacen los
761 grabadores @code{Timing_translator} y
762 @code{Default_bar_line_engraver}. Estos complementos mantienen al
763 día la administración de las indicaciones de compás, posición
764 dentro del compás, etc. Moviendo estos grabadores desde el
765 contexto de @code{Score} al de @code{Staff}, podemos conseguir una
766 partitura en la que cada pentagrama tiene su propio compás
769 @cindex polimétricas, partituras
770 @cindex compases distintos al mismo tiempo
772 @lilypond[quote,verbatim]
776 \consists "Timing_translator"
777 \consists "Default_bar_line_engraver"
784 \consists "Timing_translator"
785 \consists "Default_bar_line_engraver"
795 \remove "Timing_translator"
796 \remove "Default_bar_line_engraver"
804 El orden en que los grabadores se especifican es el orden en que
805 se llaman para realizar su tarea de procesamiento. Normalmente,
806 el orden en que se especifican los grabadores no tiene
807 importancia, pero en algunos casos especiales sí la tiene, por
808 ejemplo donde un grabador escribe una propiedad y otro la lee, o
809 donde un grabador crea un groby otro debe procesarlo.
811 Las siguientes ordenaciones son importantes:
815 el grabador de compases @code{Bar_engraver} debe ir normalmente en
819 el grabador de digitaciones @code{New_fingering_engraver} debe ir
820 antes del grabador @code{Script_column_engraver} de columnas de
824 el @code{Timing_translator} debe ir antes del grabador de números
825 de compás @code{Bar_number_engraver}.
831 @file{ly/engraver-init.ly}.
834 @node Cambiar los valores por omisión de los contextos
835 @subsection Cambiar los valores por omisión de los contextos
836 @translationof Changing context default settings
838 @cindex predeterminadas, cambio de propiedades de contexto
839 @cindex contexto, cambiar propiedades predeterminadas de
841 Se pueden cambiar las propiedades de contexto y de grob con las
842 instrucciones @code{\set} y @code{\override}, tal y como se
843 describe en @ref{Modificar las propiedades}. Estas instrucciones
844 crean eventos musicales, haciendo que los cambios tengan efecto en
845 el punto temporal en que la música se está procesando.
847 Por contra, esta sección explica la forma de cambiarlos valores
848 @emph{predeterminados} de las propiedades de contexto y de grob en
849 el momento en que se crea el contexto. Existen dos formas de
850 hacerlo. Una modifica los valores predeterminados en todos los
851 contextos de un tipo dado, y el otro modifica los valores
852 predeterminados solamente en una instancia concreta de un
856 * Cambiar todos los contextos del mismo tipo::
857 * Cambiar solamente un contexto determinado::
858 * Orden de precedencia::
861 @node Cambiar todos los contextos del mismo tipo
862 @unnumberedsubsubsec Cambiar todos los contextos del mismo tipo
863 @translationof Changing all contexts of the same type
865 @cindex \context dentro de un bloque \layout
869 Los ajustes de contexto predeterminados que se han de usar para la
870 composición tipográfica dentro de @code{Score}, @code{Staff},
871 @code{Voice} y otros contextos se pueden especificar en un bloque
872 @code{\context} dentro de cualquier bloque @code{\layout}.
874 Los ajustes para la salida MIDI, al contrario que para la
875 composición tipográfica, se tendrán que especificar aparte en
876 bloques @code{\midi} (véase
877 @ref{Definiciones de salida - estructura de los contextos}).
879 El bloque @code{\layout} se debe colocar dentro del bloque
880 @code{\score} al que se aplica, después de la música.
886 [ajustes de contexto para todos los contextos Voice]
890 [ajustes de contexto para todos los contextos Staff]
895 Se pueden especificar los siguientes tipos de ajustes:
899 Una instrucción @code{\override}, pero omitiendo el nombre del
902 @lilypond[quote,verbatim]
905 a'4^"Thicker stems" a a a
911 \override Stem.thickness = #4.0
918 Estableciendo una propiedad de contexto directamente
920 @lilypond[quote,verbatim]
923 a'4^"Smaller font" a a a
936 Una instrucción predefinida tal como @code{\dynamicUp} o una
937 expresión musical como @code{\accidentalStyle dodecaphonic}
939 @lilypond[quote,verbatim]
942 a'4^"Dynamics above" a a a
952 \accidentalStyle dodecaphonic
959 Una variable definida por el usuario que contenga un bloque
960 @code{\with}; para ver detalles acerca del bloque @code{\with},
961 consulte @ref{Cambiar solamente un contexto determinado}.
963 @lilypond[quote,verbatim]
964 StaffDefaults = \with {
971 a'4^"Smaller font" a a a
986 Las instrucciones de ajuste de propiedades se pueden disponer
987 dentro de un bloque @code{\layout} sin que estén encerradas en un
988 bloque @code{\context}. Tales ajustes son equivalentes a incluir
989 las mismas instrucciones de ajuste de propiedades al comienzo de
990 cada uno de los contextos del tipo especificado. Si no se
991 especifica ningún contexto, @emph{todos y cada uno} de los
992 contextos del nivel inferior quedan afectados, véase
993 @ref{Contextos del nivel más bajo. Voces}. La sintaxis de una
994 instrucción de ajuste de propiedades dentro de un bloque
995 @code{\layout} es la misma que si la misma instrucción estuviera
996 escrita en el propio flujo musical.
998 @lilypond[quote,verbatim]
1002 a'4^"Smaller font" a a a
1007 \accidentalStyle dodecaphonic
1009 \override Voice.Stem.thickness = #4.0
1015 @node Cambiar solamente un contexto determinado
1016 @unnumberedsubsubsec Cambiar solamente un contexto determinado
1017 @translationof Changing just one specific context
1022 Las propiedades de contexto de una única instancia de contexto
1023 pueden cambiarse dentro de un bloque @code{\with}. Todas las
1024 demás instancias de contexto del mismo tipo retienen los ajustes
1025 predeterminados que LilyPond tiene programados y que se modifican
1026 por parte de cualquier bloque @code{\layout} que se encuentre
1027 dentro del ámbito. El bloque @code{\with} se debe situar
1028 inmediatamente después de las instrucciones @code{\new}
1032 \new Staff \with @{ [ajustes de contexto para esta instancia de contexto solamente] @}
1038 De forma alternativa, si la música se escribe usando la forma
1039 corta de las instrucciones de especificación de modo, como por
1040 ejemplo @code{\chords} en lugar de @code{\chordmode}, la
1041 instrucción @code{\with} se debe colocar inmediatamente después de
1042 la instrucción que especifica el modo:
1045 \chords \with @{ [ajustes de contexto para esta instancia de contexto (implícita) solamente] @}
1052 dado que es el contexto implícito creado por estas formas breves
1053 el que se quiere modificar. Se aplica la misma consideración a
1054 las otras formas cortas de especificar el modo de entrada
1055 (@code{\drums}, @code{\figures}), véase @ref{Modos de entrada}.
1057 Dado las modificaciones de contexto especificadas en bloques
1058 @code{\with} están dentro de la música, afectarán a @emph{todas}
1059 las salidas (tipografía @emph{y también} el MIDI), a diferencia de
1060 los cambios que se hacen dentro de una definición de salida.
1062 Se pueden especificar los siguientes tipos de ajustes:
1066 Una instrucción @code{\override}, pero omitiendo el nombre del
1069 @lilypond[quote,verbatim]
1072 \new Voice \with { \override Stem.thickness = #4.0 }
1075 a'4^"Thick stems" a a a
1084 Estableciendo una propiedad de contexto directamente
1086 @lilypond[quote,verbatim]
1091 a'4^"Default font" a a a
1095 \new Staff \with { fontSize = #-4 }
1098 a'4^"Smaller font" a a a
1107 Una instrucción predefinida tal como @code{\dynamicUp}
1109 @lilypond[quote,verbatim]
1115 a'4^"Dynamics below" a a a
1120 \new Staff \with { \accidentalStyle dodecaphonic }
1122 \new Voice \with { \dynamicUp }
1125 a'4^"Dynamics above" a a a
1137 Referencia de la notación:
1138 @ref{Modos de entrada}
1140 @node Orden de precedencia
1141 @unnumberedsubsubsec Orden de precedencia
1142 @translationof Order of precedence
1144 El valor de una propiedad que se aplica en un momento determinado
1145 se determina de la siguiente forma:
1149 si está en efecto una instrucción @code{\override} o @code{\set}
1150 dentro del flujo musical, se usa dicho valor,
1153 de lo contrario, se usa el valor predeterminado tomado de un
1154 enunciado @code{\with} en las instrucciones de inicio del
1158 de lo contrario, se usa el valor tomado del bloque @code{\context}
1159 más reciente que corresponda dentro de los bloques @code{\layout}
1163 de lo contrario se usa el valor predeterminado que LilyPond lleva
1168 Manual de aprendizaje:
1169 @rlearning{Modificar las propiedades de los contextos}.
1171 Referencia de la notación:
1172 @ref{Explicación de los contextos},
1173 @ref{Contextos del nivel más bajo. Voces},
1174 @ref{La instrucción set},
1175 @ref{La instrucción override},
1176 @ref{El bloque layout,,El bloque @code{@bs{}layout}}.
1179 @node Definir contextos nuevos
1180 @subsection Definir contextos nuevos
1181 @translationof Defining new contexts
1183 @cindex contextos, definición de nuevos
1184 @cindex grabadores, incluir en contextos
1193 Los contextos específicos, como @code{Staff} y @code{Voice}, están
1194 construidos a partir de bloques sencillos. Es posible crear
1195 nuevos tipos de contextos con combinaciones distintas de añadidos
1198 El siguiente ejemplo muestra cómo construir un tipo diferente de
1199 contexto de @code{Voice} partiendo de cero. Será parecido a
1200 @code{Voice}, pero imprime solamente cabezas centradas en forma de
1201 barra inclinada. Se puede usar para indicar improvisación en
1204 @lilypond[quote,ragged-right]
1205 \layout { \context {
1207 \type "Engraver_group"
1208 \consists "Note_heads_engraver"
1209 \consists "Rhythmic_column_engraver"
1210 \consists "Text_engraver"
1211 \consists "Pitch_squash_engraver"
1212 squashedPosition = #0
1213 \override NoteHead.style = #'slash
1218 \accepts "ImproVoice"
1222 a'4 d8 bes8 \new ImproVoice { c4^"ad lib" c
1223 c4 c^"undress" c_"while playing :)" c }
1229 Estos ajustes se definen dentro de un bloque @code{\context} que a
1230 su vez está dentro de un bloque @code{\layout},
1240 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
1241 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
1243 En primer lugar es necesario definir un nombre para el nuevo
1250 Debido a que es parecido al contexto @code{Voice}, queremos
1251 órdenes que funcionen dentro de los contextos @code{Voice}
1252 (existentes) para que siga funcionando. Esto se consigue dando al
1253 contexto nuevo un alias de @code{Voice},
1259 El contexto imprimirá notas y textos explicativos, por ello
1260 tenemos que añadir los grabadores que aportan esta funcionalidad,
1261 y además el grabador que agrupa las notas, plicas y silencios que
1262 están en el mismo momento musical en forma de columnas,
1265 \consists "Note_heads_engraver"
1266 \consists "Text_engraver"
1267 \consists "Rhythmic_column_engraver"
1270 Las cabezas de todas las notas se deben situar sobre la línea
1274 \consists "Pitch_squash_engraver"
1275 squashedPosition = #0
1278 El grabador @code{Pitch_squash_engraver} modifica las cabezas de
1279 nota (creadas por el grabador @code{Note_heads_engraver}) y
1280 establece sus posiciones verticales al valor de
1281 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea
1284 Las notas parecen barras inclinadas y no tienen plica:
1287 \override NoteHead.style = #'slash
1291 Todos estos complementos o plug-ins tienen que comunicarse bajo el
1292 control del contexto. Los mecanismos con el que se comunican los
1293 contextos se establecen mediante la declaración del @code{\type}
1294 (tipo) del contexto. Dentro de un bloque @code{\layout}, casi
1295 todos los contextos serán del tipo @code{Engraver_group}. Algunos
1296 contextos especiales y los contextos de los bloques @code{\midi}
1297 usan otros tipos. La copia y la modificación de una definición de
1298 contexto existente también cumplimentan el tipo. Como este
1299 ejemplo crea una definición partiendo de cero, tiene que ser
1300 especificada explícitamente.
1303 \type "Engraver_group"
1306 Al juntarlo todo, obtenemos
1311 \type "Engraver_group"
1312 \consists "Note_heads_engraver"
1313 \consists "Text_engraver"
1314 \consists "Rhythmic_column_engraver"
1315 \consists "Pitch_squash_engraver"
1316 squashedPosition = #0
1317 \override NoteHead.style = #'slash
1324 Los contextos dan lugar a jerarquías. Queremos poner el contexto
1325 @code{ImproVoice} dentro del contexto @code{Staff}, igual que los
1326 contextos de voz normales. Por tanto, modificamos la definición
1327 de @code{Staff} con la instrucción @code{\accepts} (acepta),
1336 @funindex \inherit-acceptability
1337 Con frecuencia, al reutilizar una definición de contexto
1338 existente, el contexto resultante se puede usar en cualquier lugar
1339 donde el contexto original hubiera podido hacerlo.
1344 \inherit-acceptability @var{to} @var{from}
1349 consigue que tengamos contextos del tipo @var{to} aceptados por
1350 todos los contextos que asimismo aceptan @var{from}. Por ejemplo,
1356 \inherit-acceptability "ImproVoice" "Voice"
1361 añade un @code{\accepts} para @code{ImproVoice} tanto a la
1362 definición de @code{Staff} como a la de @code{RhythmicStaff}.
1365 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega),
1366 lo que a veces se necesita cuando se están reutilizando
1367 definiciones de contexto existentes.
1369 Organizar las piezas requeridas dentro de un bloque @code{\layout}
1378 \inherit-acceptability "ImproVoice" "Voice"
1382 Así pues, la salida que aparece al comienzo de esta sub-sección se
1391 c c_"mientras tocas :)"
1397 Para completar el ejemplo, los cambios que afectan a la jerarquía
1398 de contextos se deben repetir dentro de un bloque @code{\midi} de
1399 manera que la salida MIDI dependa de las mismas relaciones de
1404 Referencia de funcionamiento interno:
1405 @rinternals{Note_heads_engraver},
1406 @rinternals{Text_engraver},
1407 @rinternals{Rhythmic_column_engraver},
1408 @rinternals{Pitch_squash_engraver}.
1411 @node Orden de disposición de los contextos
1412 @subsection Orden de disposición de los contextos
1413 @translationof Context layout order
1415 @cindex contextos, orden de disposición
1419 Los contextos se disponen en un sistema normalmente desde arriba
1420 hacia abajo en el orden en que se encuentran en el archivo de
1421 entrada. Cuando los contextos se anidan unos dentro de otros, el
1422 contexto exterior incluye a los contextos anidados tal y como se
1423 especifica en el archivo de entrada, siempre y cuando los
1424 contextos interiores estén incluidos en la lista @qq{accepts} del
1425 contexto externo. Los contextos anidados que no está nincluidos
1426 en la lista @qq{accepts} del contexto externo se recolocan debajo
1427 del contexto externo en lugar de anidarse dentro de él.
1429 La lista @qq{accepts} de un contexto se puede cambiar con las
1430 instrucciones @code{\accepts} (acepta) o @code{\denies} (niega).
1431 @code{\accepts} añade un contexto a la lista @qq{accepts} y
1432 @code{\denies} elimina un contexto de la lista.
1434 Por ejemplo, un grupo de pentagramas con un corchete cuadrado no
1435 se encuentra normalmente en el interior de un pentagrama con llave
1436 curva que tenga conectadas las líneas divisorias, y un
1437 @code{GrandStaff} para piano no acepta un @code{StaffGroup} dentro
1438 de él, de forma predeterminada.
1440 @lilypond[verbatim,quote]
1447 \new Staff { \set Staff.instrumentName = bottom f'1 }
1452 Sin embargo, usando la instrucción @code{\accepts}, se puede
1453 añadir un @code{StaffGroup} al contexto @code{GrandStaff}:
1455 @lilypond[verbatim,quote]
1462 \new Staff { \set Staff.instrumentName = bottom f'1 }
1467 \accepts "StaffGroup"
1473 @code{\denies} se usa principalmente cuando un contexto nuevo se
1474 está basando en otro, pero los anidamientos requeridos difieren.
1475 Por ejemplo, el contexto @code{VaticanaStaff} está basado en el
1476 contexto @code{Staff}, pero con el contexto @code{VaticanaVoice}
1477 sustituido por el contexto @code{Voice} en la lista @qq{accepts}.
1480 @cindex contextos implícitos
1481 @cindex implícitos, contextos
1482 @funindex \defaultchild
1484 Observe que discretamente se crea un contexto de forma implícita
1485 si se encuentra una instrucción donde no hay un contexto apropiado
1488 Dentro de una definición de contexto, el tipo de un subcontexto
1489 que se va a crear implícitamente se especifica usando
1490 @code{\defaultchild} (hijo predeterminado). Algunos eventos
1491 musicales requieren un contexto @samp{Bottom} (inferior): cuando
1492 se encuentra este evento, se crean subcontextos de forma recursiva
1493 hasta que se alcanza un contexto que no tiene establecido el
1494 @samp{defaultchild}.
1496 La creación implícita de contextos puede dar lugar a pentagramas o
1497 partituras nuevos no esperados. La utilización de @code{\new}
1498 para crear contextos explícitamente evita esos problemas.
1500 @cindex alignAboveContext
1501 @cindex alignBelowContext
1502 @funindex alignAboveContext
1503 @funindex alignBelowContext
1505 En ocasiones se necesita que un contexto exista durante un breve
1506 intervalo de tiempo, siendo un buen ejemplo el contexto de
1507 pentagrama de un ossia. Esto se consigue normalmente mediante la
1508 introducción de la definición del contexto en el lugar apropiado
1509 en paralelo con la sección correspondiente de la música principal.
1510 De forma predeterminada, el contexto tempral se coloca debajo de
1511 todos los contextos existentes. Para reposicionarlo por encima
1512 del contexto que tenga el nombre @qq{principal}, debería definirse
1516 \new Staff \with @{ alignAboveContext = #"principal" @}
1519 Se presenta una situación similar cuando se posiciona un contexto
1520 temporal de letra de una canción dentro de una disposición de varios
1521 pentagramas tal como @code{ChoirStaff}, por ejemplo, cuando se añade
1522 una segunda estrofa a una sección que se repite. De forma
1523 predeterminada, el contexto temporal de letra se coloca debajo de los
1524 pentagramas inferiores. Mediante la definición del contexto temporal
1525 de letra con @code{alignBelowContext} se puede posicionar
1526 correctamente debajo del contexto de letra con nombre que contiene el
1527 texto de la primera estrofa.
1529 En diversos lugares pueden verse ejemplos que muestran esta
1530 recolocación de contextos temporales: véase
1531 @rlearning{Anidado de expresiones musicales},
1532 @ref{Modificación de pentagramas sueltos} y
1533 @ref{Técnicas específicas para la letra}.
1536 Manual de aprendizaje:
1537 @rlearning{Anidado de expresiones musicales}.
1539 Referencia de la notación:
1540 @ref{Modificación de pentagramas sueltos},
1541 @ref{Técnicas específicas para la letra}.
1543 Manual de utilización del programa:
1544 @rprogram{Aparece un pentagrama de más}.
1546 Archivos instalados:
1547 @file{ly/engraver-init.ly}.
1550 @node Explicación del Manual de referencia de funcionamiento interno
1551 @section Explicación del Manual de referencia de funcionamiento interno
1552 @translationof Explaining the Internals Reference
1555 * Navegar por la referencia del programa::
1556 * Interfaces de la presentación::
1557 * Determinar la propiedad del grob::
1558 * Convenciones de nombres::
1562 @node Navegar por la referencia del programa
1563 @subsection Navegar por la referencia del programa
1564 @translationof Navigating the program reference
1566 Supongamos que queremos mover la indicación de digitación del
1567 fragmento siguiente:
1569 @lilypond[quote,fragment,verbatim]
1573 Si hace una visita a la documentación en busca de instrucciones de
1574 digitación (en @ref{Indicaciones de digitación}), encontrará:
1577 @strong{Véase también}
1579 Referencia de funcionamiento interno: @rinternals{Fingering}.
1584 La referencia del programador se encuentra disponible en forma de
1585 documento HTML. Se recomienda mucho que lo lea en la forma HTML,
1586 bien en línea o bien descargando los archivos de la documentación
1587 HTML. Esta sección sería mucho más difícil de entender si está
1588 utilizando el manual en formato PDF.
1591 Siga el enlace que lleva a @rinternals{Fingering}. Al principio
1592 de la página, puede ver
1595 Los objetos de digitación se crean por parte de:
1596 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1599 Siguiendo los enlaces relacionados dentro de la referencia del
1600 programa, podemos seguir el flujo de información dentro del
1605 @item @rinternals{Fingering}:
1606 los objetos @rinternals{Fingering} se crean por parte de:
1607 @rinternals{Fingering_engraver}
1609 @item @rinternals{Fingering_engraver}:
1610 Tipos de música aceptados: @rinternals{fingering-event}
1612 @item @rinternals{fingering-event}:
1613 El tipo de evento musical @code{fingering-event} está descrito en
1614 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1617 Este camino se recorre en contra de la corriente de información
1618 del programa: comienza por la salida y acaba en el evento de
1619 entrada. También podríamos haber empezado por un evento de la
1620 entrada, y leído siguiendo el flujo de información terminando en
1621 su caso en el objeto (u objetos) de la salida.
1623 La referencia del programa también se puede examinar como un
1624 documento normal. Contiene capítulos que tratan de
1626 @rinternals{Music definitions},
1629 @code{Music definitions}
1631 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada
1632 uno de los capítulos relaciona todas las definiciones utilizadas y
1633 todas las propiedades que se pueden ajustar.
1636 @node Interfaces de la presentación
1637 @subsection Interfaces de la presentación
1638 @translationof Layout interfaces
1640 @cindex interfaz de la presentación
1641 @cindex presentación, interfaz de la
1644 La página HTML que pudimos ver en la sección anterior describe el
1645 objeto de presentación llamado @rinternals{Fingering}. Dicho
1646 objeto es un símbolo dentro de la partitura. Tiene propiedades
1647 que guardan números (como grosores y direcciones), pero también
1648 punteros a objetos relacionados. Un objeto de presentación
1649 también se llama un @emph{Grob}, que es una abreviatura de
1650 Graphical Object (objeto gráfico). Para ver más detalles acerca
1651 de los objetos gráficos o Grobs, consulte
1652 @rinternals{grob-interface}.
1654 La página dedicada a @code{Fingering} relaciona las definiciones del
1655 objeto @code{Fingering}. Por ejemplo, la página dice
1658 @code{padding} (dimensión, en espacios de pentagrama):
1664 lo que significa que el número se mantendrá a una distancia de al
1665 menos 0.5 de la cabeza de la nota.
1668 Cada objeto de presentación puede tener varias funciones como
1669 elemento notacional o tipográfico. Por ejemplo, el objeto de
1670 digitación Fingering tiene los siguientes aspectos
1674 Su tamaño es independiente del espaciado horizontal, al contrario
1675 de las ligaduras o las barras de las figuras.
1678 Es un elemento de texto. Casi seguro que es un texto muy corto.
1681 este elemento de texto se tipografía con un tipo de letra, no como
1682 las ligaduras o las barras de las figuras.
1685 Horizontalmente, el centro del símbolo se debe alinear con el
1686 centro de la cabeza de la nota.
1689 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1692 La posición vertical también está coordinada con otros símbolos de
1693 superíndice y de subíndice.
1696 Cada uno de estos aspectos se capta en lo que se llaman
1697 @emph{interface}s, que se relacionan al final de la página dedicada a
1698 @rinternals{Fingering}
1701 Este objeto contempla los siguientes interfaces:
1702 @rinternals{item-interface},
1703 @rinternals{self-alignment-interface},
1704 @rinternals{side-position-interface}, @rinternals{text-interface},
1705 @rinternals{text-script-interface}, @rinternals{font-interface},
1706 @rinternals{finger-interface} y @rinternals{grob-interface}.
1709 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1710 página del respectivo interfaz del objeto. Cada interfaz tiene un
1711 cierto número de propiedades. Algunas de ellas no son para que el
1712 usuario las pueda ajustar (@q{Propiedades internas}), pero otras
1713 sí se pueden modificar.
1715 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1716 realmente esto no significa mucho. El archivo de inicialización
1717 (véase @rlearning{Otras fuentes de información})
1718 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1723 (avoid-slur . around)
1724 (slur-padding . 0.2)
1725 (staff-padding . 0.5)
1726 (self-alignment-X . 0)
1727 (self-alignment-Y . 0)
1728 (script-priority . 100)
1729 (stencil . ,ly:text-interface::print)
1730 (direction . ,ly:script-interface::calc-direction)
1731 (font-encoding . fetaText)
1732 (font-size . -5) ; don't overlap when next to heads.
1733 (meta . ((class . Item)
1734 (interfaces . (finger-interface
1736 text-script-interface
1738 side-position-interface
1739 self-alignment-interface
1740 item-interface))))))
1744 Como podemos ver, el objeto @code{Fingering} no es más que un
1745 montón de valores de variables, y la página web de la Referencia
1746 de funcionamiento interno se genera directamente a partir de esta
1750 @node Determinar la propiedad del grob
1751 @subsection Determinar la propiedad del grob
1752 @translationof Determining the grob property
1754 Recordemos que queríamos cambiar la posición del @b{2} en
1756 @lilypond[quote,fragment,verbatim]
1760 Puesto que el @b{2} se encuentra colocado verticalmente sobre su
1761 nota, tenemos que negociar con el interfaz asociado con esta
1762 colocación. Esto se hace usando @code{side-position-interface}.
1763 La página que describe este interface dice:
1766 @code{side-position-interface}
1768 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1769 soporte). La propiedad @code{direction} significa dónde poner el
1770 objeto víctima con relación al soporte (¿a la izquierda o a la
1771 derecha, encima o debajo?)
1775 @cindex padding (relleno)
1777 Debajo de esta descripción, la variable @code{padding} (relleno)
1783 (dimensión, en espacios de pentagrama)
1785 Añadir esta cantidad de espacio adicional entre objetos que están
1790 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1791 digitación de la cabeza de la nota. La siguiente orden inserta un
1792 espacio en blanco de tres @qq{espacios de pentagrama} entre la
1793 nota y la digitación:
1796 \once \override Voice.Fingering.padding = #3
1799 Al insertar este relleno antes de que se haya creado el objeto de
1800 digitación, llegamos al siguiente resultado:
1802 @lilypond[quote,fragment,verbatim]
1803 \once \override Voice.Fingering.padding = #3
1807 En este caso, el contexto de este truco es @code{Voice}. Véase el
1808 apartado dedicado al añadido @rinternals{Fingering_engraver}, que
1812 El grabador Fingering_engraver forma parte de los contextos:
1813 @dots{} @rinternals{Voice}
1817 @node Convenciones de nombres
1818 @subsection Convenciones de nombres
1819 @translationof Naming conventions
1821 Se hace necesario presentar una panorámica de las diversas
1822 convenciones de nomenclatura:
1825 @item funciones de Scheme: minúsculas-con-guiones (lo que incluye a los nombres de una sola palabra)
1827 @item funciones de Scheme específicas de LilyPond: ly:más-estilo-de-scheme
1829 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1831 @item interfaces de Grobs: estilo-scheme
1833 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1835 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1837 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1839 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1843 Preguntas aún sin respuesta
1845 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1847 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1852 @node Modificar las propiedades
1853 @section Modificar las propiedades
1854 @translationof Modifying properties
1857 * Panorámica de la modificación de las propiedades::
1858 * La instrucción set::
1859 * La instrucción override::
1860 * La instrucción tweak::
1861 * set frente a override::
1862 * Modificación de las listas-A::
1866 @node Panorámica de la modificación de las propiedades
1867 @subsection Panorámica de la modificación de las propiedades
1868 @translationof Overview of modifying properties
1870 Cada contexto es responsable de la creación de ciertos tipos de
1871 objetos gráficos. Los ajustes que se usan para imprimir estos
1872 objetos también se almacenan por contexto. Mediante la
1873 modificación de estos ajustes, se puede alterar la apariencia de
1876 Existen dos tipos diferentes de propiedades almacenadas en los
1877 contextos: las propiedades de contexto y las propiedades de grob.
1878 Las propiedades de contexto son propiedades que se aplican al
1879 contexto como un todo y controlan la forma en que el propio
1880 contexto se imprime. Por contra, las propiedades de grob se
1881 aplican a los tipos de grob específicos que se imprimirán dentro
1884 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar
1885 los valores de las propiedades de contexto. Las instrucciones
1886 @code{\override} y @code{\revert} se usan para cambiar los valores
1887 de las propiedades de grob.
1890 La sintaxis de esto es
1893 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1896 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1897 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1898 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1899 disposición}). Este último es un símbolo, y por ello debe ir
1900 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1901 explica cómo se deben cumplimentar los conceptos @var{nombre},
1902 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1903 funcionalidad des esta instrucción.
1908 \override Staff.Stem.thickness = #4.0
1912 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1913 grosor de una línea del pentagrama como unidad). Puesto que la
1914 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1915 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1916 Aquí vemos la instrucción en pleno funcionamiento:
1918 @lilypond[quote,fragment,verbatim]
1920 \override Staff.Stem.thickness = #4.0
1926 La instrucción @code{\override} modifica la definición de la plica
1927 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1928 que la instrucción se ha interpretado, todas las plicas se engrosan.
1930 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1931 omitir, ocasionando que se utilice el contexto predeterminado
1932 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1933 solo paso de tiempo.
1935 @lilypond[quote,fragment,verbatim]
1937 \once \override Stem.thickness = #4.0
1942 El @code{\override} se debe hacer antes de que el objeto se inicia.
1943 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1944 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1945 en el momento en que se crea el objeto. En este ejemplo:
1947 @lilypond[quote,fragment,verbatim]
1948 \override Slur.thickness = #3.0
1950 \override Beam.beam-thickness = #0.6
1955 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1956 la instrucción para @code{Beam}, la barra, va después de que la barra
1957 se ha iniciado, y por ello no tiene ningún efecto.
1959 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1960 un contexto deshace una instrucción @code{\override}; como con
1961 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1962 del mismo contexto. En otras palabras, el @code{\revert} del
1963 siguiente ejemplo no hace nada.
1966 \override Voice.Stem.thickness = #4.0
1967 \revert Staff.Stem.thickness
1970 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1971 dentro de las propiedades normales. Para trucarlas, utilice
1972 instrucciones de la forma
1974 @c leave this as a long long
1976 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1983 \override Stem.details.beamed-lengths = #'(4 4 3)
1989 Referencia de funcionamiento interno:
1990 @rinternals{Backend},
1991 @rinternals{All layout objects},
1992 @rinternals{OverrideProperty},
1993 @rinternals{RevertProperty},
1994 @rinternals{PropertySet}.
1997 El «back-end» o motor de salida no es muy estricto en la
1998 comprobación de tipos de las propiedades de objetos. Las
1999 referencias cíclicas en valores Scheme de propiedades pueden
2000 producir cuelgues o salidas abruptas, o las dos cosas.
2003 @node La instrucción set
2004 @subsection La instrucción @code{@bs{}set}
2005 @translationof The set command
2009 @cindex cambiar propiedades
2011 Cada contexto puede tener distintas @emph{propiedades}, variables
2012 contenidas dentro de ese contexto. Se pueden cambiar mientras
2013 dura el paso de interpretación. Se consigue insertando la
2014 instrucción @code{\set} dentro de la música:
2017 \set @var{contexto}.@var{propiedad} = #@var{valor}
2020 @var{valor} es un objeto de Scheme, razón por la que va precedido
2021 del carácter almohadilla,@tie{}@code{#}.
2023 El nombre de las propiedades de contexto suele ir en minúsculas
2024 con mayúscula en medio. Controlan sobre todo la traducción de la
2025 música a la notación, p.ej. @code{localAlterations} (para
2026 determinar si hay que impriir alteraciones o no), o
2027 @code{measurePosition} (para determinar cuándo hay que imprimir
2028 una línea divisoria). El valor de las propiedades de contexto
2029 puede modifcarse con el tiempo durante la interpretación de la
2030 música; un ejemplo obvio es @code{measurePosition}. Las
2031 propiedades de contexto se modifican mediante la instrucción
2034 Por ejemplo, los silencios multicompás se combinan en un solo
2035 compás si el valor de la propiedad de contexto @code{skipBars} se
2036 establece a @code{#t} (verdadero):
2038 @lilypond[quote,fragment,verbatim]
2040 \set Score.skipBars = ##t
2044 Si se omite el argumento @var{context}, entonces se utiliza el
2045 contexto actual de nivel más bajo (normalmente @code{ChordNames},
2046 @code{Voice} o @code{Lyrics}). En este ejemplo:
2048 @lilypond[quote,fragment,verbatim]
2049 \set Score.autoBeaming = ##f
2052 \set autoBeaming = ##t
2060 El cambio se aplica @q{al vuelo}, mientras dura la música, de
2061 forma que el ajuste sólo afecta al segundo grupo de corcheas.
2063 Observe que el contexto del nivel más bajo no siempre contiene la
2064 propiedad que querríamos modificar: por ejemplo, intentar ajustar
2065 el valor de la propiedad @code{skipBars} del contexto
2066 predeterminado del nivel más bajo, que en este caso es
2067 @code{Voice}, no tendrá ningún efecto, porque skipBars es una
2068 propiedad del contexto @code{Score}.
2070 @lilypond[quote,fragment,verbatim]
2076 Los contextos son jerárquicos, y si se ha especificado un contexto
2077 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
2078 también a todos los contextos @code{Voice} dentro del pentagrama
2083 También existe una instrucción @code{\unset}:
2085 \unset @var{contexto}.@var{propiedad}
2089 que elimina la definición de @var{propiedad}. Esta instrucción
2090 elimina la definición solamente si está establecida dentro de
2091 @var{contexto}. Properties that have been set in enclosing contexts will
2092 not be altered by an unset in an enclosed context:
2094 @lilypond[quote,fragment,verbatim]
2095 \set Score.autoBeaming = ##t
2099 \unset Score.autoBeaming
2107 Como @code{\set}, el argumento @var{contexto} no se tiene que
2108 especificar para un contexto del nivel más bajo, por lo que los
2112 \set Voice.autoBeaming = ##t
2113 \set autoBeaming = ##t
2117 son equivalentes si el contexto inferior en curso es @code{Voice}.
2121 Los ajustes con @code{\set} o @code{\unset} que se aplican
2122 solamente a un único paso de tiempo se pueden escribir con
2123 @code{\once}, por ejemplo en
2125 @lilypond[quote,fragment,verbatim]
2127 \once \set fontSize = #4.7
2132 En el manual de Referencia de funcionamiento interno hay una
2133 descripción completa de todas las propiedades de contexto
2134 disponibles, consulte
2136 @rinternals{Tunable context properties}.
2139 Traducción @expansion{} Propiedades de contexto modificables por el
2144 Referencia de funcionamiento interno:
2145 @rinternals{Tunable context properties}.
2147 @node La instrucción override
2148 @subsection La instrucción @code{\override}
2149 @translationof The override command
2151 @cindex grob, propiedades de
2152 @cindex propiedades de grob
2155 Existe un tipo especial de propiedad de contexto: la descripción
2156 de los grobs. Las decscripciones de los grobs reciben un nombre
2157 en @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen
2158 los @q{ajustes predeterminados} para un tipo particular de grob,
2159 en forma de lista asociativa. Consulte
2160 @file{scm/define-grobs.scm} para ver los ajustes de cada
2161 descripción de grob. Las descripciones de grob se modifican con
2164 La sintaxis de la instrucción @code{\override} es
2167 \override [@var{contexto}.]@var{NombreDelGrob}.@var{propiedad} = #@var{valor}
2170 Por ejemplo, podemos aumentar el grosor de la plica de una figura
2171 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
2172 @code{Stem} (plica):
2174 @lilypond[quote,fragment,verbatim]
2176 \override Voice.Stem.thickness = #3.0
2180 Si no se ha especificado ningún contexto en la instrucción
2181 @code{\override}, se utiliza el contexto del nivel inferior:
2183 @lilypond[quote,fragment,verbatim]
2184 \override Staff.Stem.thickness = #3.0
2188 \override Stem.thickness = #0.5
2197 Algunas opciones susceptibles de trucaje, se llaman
2198 @q{subpropiedades} y residen dentro de las propiedades. Para
2199 efectura trujajes sobre ellas, utilice instrucciones de la forma
2202 \override Stem.details.beamed-lengths = #'(4 4 3)
2205 o para modificar los extremos de los objetos extensos, utilice una
2206 forma como las siguientes:
2209 \override TextSpanner.bound-details.left.text = #"left text"
2210 \override TextSpanner.bound-details.right.text = #"right text"
2214 @cindex reversión de sobreescrituras
2215 @cindex sobreescrituras, reversión de
2217 El efecto de una instrucción de sobreescritura @code{\override} se
2218 puede deshacer con @code{\revert}.
2220 La sintaxis de la instrucción @code{\revert} es
2223 \revert [@var{Contexto}.]@var{NombreDelGrob}.@var{propiedad}
2228 @lilypond[quote,verbatim]
2231 \override Voice.Stem.thickness = #3.0
2233 \revert Voice.Stem.thickness
2238 Los efectos de @code{\override} y @code{\revert} se aplican a
2239 todos los grobs del contexto afectado partiendo del momento actual
2242 @lilypond[quote,verbatim]
2246 \override Staff.Stem.thickness = #3.0
2251 \revert Staff.Stem.thickness
2258 @cindex sobreescritura para un solo momento
2260 Se puede usar @code{\once} con @code{\override} o @code{\revert}
2261 para afectar solamente al instante de tiempo actual:
2263 @lilypond[quote,verbatim]
2266 \override Stem.thickness = #3.0
2271 \once \override Stem.thickness = #3.0
2279 Las instrucciones que modifican la salida tienen por lo general un
2283 \override Voice.Stem.thickness = #3.0
2287 Para construir este truco debemos determinar los siguientes datos:
2290 @item el contexto: aquí @code{Voice}.
2291 @item el objeto de presentación: aquí @code{Stem}.
2292 @item la propiedad de presentación: aquí @code{thickness}.
2293 @item un valor adecuado: aquí @code{3.0}.
2296 @cindex documentación interna
2297 @cindex buscar objetos gráficos
2298 @cindex gráficos, descripción de los objetos
2301 @cindex interna, documentación
2303 Para muchas propiedades, independientemente del tipo de datos de la
2304 propiedad, si se establece el valor de la propiedad a falso
2305 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
2306 ignore por completo dicha propiedad. Esto es especialmente útil para
2307 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
2308 causarían problemas.
2310 Mostraremos a continuación cómo localizar esta información en el
2311 manual de notación y en la referencia de funcionamiento interno.
2315 Referencia de funcionamiento interno:
2316 @rinternals{Backend}
2319 @node La instrucción tweak
2320 @subsection La instrucción @code{\tweak}
2321 @translationof The tweak command
2326 El cambio de las propiedades de grob mediante @code{\override} produce
2327 la aplicación del cambio a todos los grobs dados en el contexto en el
2328 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
2329 podemos desear que los cambios se apliquen a un solo grob en lugar de
2330 a todos los grobs del contexto afectado. Esto se consigue con la
2331 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
2334 \tweak [@var{objeto-de-presentación}.]@var{propiedad-del-grob} @var{valor}
2337 Es opcional especificar el @var{objeto-de-presentación}. La
2338 instrucción @code{\tweak} se aplica al objeto musical que viene
2339 inmediatamente después de @var{valor} dentro del flujo musical.
2342 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
2343 los objetos gráficos. Para objetos que resultan directamente de un
2344 elemento de código de la entrada, puede usar la función @code{\tweak},
2347 @lilypond[verbatim,quote]
2353 \tweak duration-log #1
2363 El uso principal de la instrucción @code{\tweak} es modificar
2364 solamente uno de varios elementos de notación que dan comienzo en el
2365 mismo momento musical, como las notas de un acorde, o corchetes de
2366 tresillo que empiezan al mismo tiempo.
2368 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
2369 a continuación de forma directa, sin necesidad de especificar el
2370 nombre del grob o el contexto. Para que esto funcione, es necesario
2371 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
2372 al objeto al que se aplica, después de que el archivo de entrada se ha
2373 convertido en un flujo musical. Con frecuencia no es el caso, pues
2374 muchos elementos adicionales se insertan en la corriente musical de
2375 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
2376 parte de un acorde, LilyPond inserta implícitamente un evento
2377 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
2378 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
2379 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
2380 en el flujo musical, permaneciendo así adyacente a la nota, y con la
2381 posibilidad de modificarla.
2385 @lilypond[verbatim,fragment,quote]
2386 <\tweak color #red c''>4
2390 pero esto no funciona:
2392 @lilypond[verbatim,fragment,quote]
2393 \tweak color #red c''4
2398 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
2399 consulte @rlearning{Métodos de trucaje}.
2401 Si se colocan varios elementos similares en el mismo momento
2402 musical, la instrucción @code{\override} no se puede usar para
2403 modificar uno solo de ellos: aquí es donde se debe usar la
2404 instrucción @code{\tweak}. Entre los elementos que pueden
2405 aparecer más de una vez en el mismo momento musical están los
2408 @c TODO expand to include any further uses of \tweak
2410 @item las cabezas de las notas de un acorde
2411 @item signos de articulación sobre la misma nota
2412 @item ligaduras de unión entre notas de un acorde
2413 @item corchetes de grupos especials que comienzan en el mismo momento
2416 @c TODO add examples of these
2418 @cindex acorde, modificación de una nota
2420 En este ejemplo se modifican el color de una cabeza y el tipo de
2421 otra, dentro del mismo acorde:
2423 @lilypond[verbatim,fragment,quote]
2428 \tweak duration-log #1
2433 @code{\tweak} se puede usar para modificar ligaduras de expresión:
2435 @lilypond[verbatim,quote]
2436 \relative { c'-\tweak thickness #5 ( d e f) }
2440 Para que funcione la instrucción @code{\tweak}, debe permanecer
2441 adyacente al objeto al que se ha de aplicar después de que el código
2442 de entrada se ha convertido a un flujo musical. El trucaje de un
2443 acorde completo no hace nada porque su evento musical actúa solamente
2444 como un contenedor, y todos los objetos de presentación se crean a
2445 partir de eventos dentro del @code{EventChord}:
2447 @lilypond[verbatim,fragment,quote]
2448 \tweak color #red c''4
2449 \tweak color #red <c'' e''>4
2450 <\tweak color #red c'' e''>4
2453 La instrucción @code{\tweak} sencilla no se puede usar para
2454 modificar ningún objeto que no se haya creado directamente a
2455 partir de la entrada. Concretamente, no afecta a las plicas,
2456 barras automáticas ni alteraciones, porque éstos se generan
2457 posteriormente por parte de objetos de presentación
2458 @code{NoteHead} más que por elementos musicales del flujo de
2461 Tales objetos de presentación creados indirectamente se pueden
2462 trucar usando la forma de la instrucción @code{\tweak} en que el
2463 nombre del grob se especifica de forma explícita:
2465 @lilypond[fragment,verbatim,quote]
2466 \tweak Stem.color #red
2467 \tweak Beam.color #green c''8 e''
2468 <c'' e'' \tweak Accidental.font-size #-3 ges''>4
2471 No se puede usar @code{\tweak} para modificar las claves o las
2472 indicaciones de compás, porque éstos se separan de cualquier
2473 instrucción @code{\tweak} precedente dentro del flujo de entrada
2474 merced a la inserción automática de elementos adicionales que se
2475 requieren para especificar el contexto.
2477 Se pueden colocar varias instrucciones @code{\tweak} antes de un
2478 elemento de notación; todos le afectan:
2480 @lilypond[verbatim,fragment,quote]
2482 -\tweak style #'dashed-line
2483 -\tweak dash-fraction #0.2
2484 -\tweak thickness #3
2490 El flujo musical que se genera a partir de una sección de un
2491 archivo de entrada (incluido cualquier elemento insertado
2492 automáticamente) puede examinarse, véase
2493 @rextend{Presentación de las expresiones musicales}. Esto puede
2494 ser de utilidad en la determinación de lo que puede modificarse
2495 por medio de una instrucción @code{\tweak}.
2498 Manual de aprendizaje:
2499 @rlearning{Métodos de trucaje}.
2501 Manual de extensión:
2502 @rextend{Presentación de las expresiones musicales}.
2506 @cindex trucar puntos de control
2507 @cindex control, trucar puntos de
2509 No se puede usar la instrucción @code{\tweak} para modificar los
2510 puntos de control de una sola de varias ligaduras de unión dentro
2511 de un acorde, aparte de la primera que se encuentre en el código
2515 @node set frente a override
2516 @subsection @code{\set} frente a @code{\override}
2517 @translationof set versus override
2519 @c TODO Should't a bunch of that be explained earlier?
2524 Tanto la instrucción @code{\set} como @code{\override} manipulan
2525 propiedades asociadas a contextos. En ambos casos las propiedades
2526 siguen una@emph{jerarquía de contextos}: las propiedades que no se
2527 establecen dentro del contexto aún presentan los valores del
2528 contexto de su padre respectivo.
2530 El valor y la duración en el tiempo de una propiedad de contexto
2531 son dinámicos y están disponibles solamente cuando la música se
2532 está interpretando o @q{iterando}. En el momento de la creación
2533 del contexto, se inicializan las propiedades a partir de las
2534 definiciones correspondientes (así como otras posibles
2535 modificaciones) de dicho contexto. Cualquier cambio posterior se
2536 obtiene a través de instrucciones de establecimiento de
2537 propiedades dentro de la propia música.
2539 Las definiciones de grob (objetos gráficos) son una clase
2540 @emph{especial} de propiedades de contexto, pues su estructura y
2541 uso son distintos de las propiedades de contexto ordinarias. A
2542 diferencia de las propiedades de los contextos normales, las
2543 definiciones de grob se subdividen en @emph{propiedades de grob}.
2545 Además, en contraste con las propiedades de contexto normales, las
2546 definiciones de grob tienen su propio conjunto de @q{utilidades de
2547 mantenimiento} de las propiedades individuales y, en su caso,
2548 sub-propiedades. Esto supone que es posible definir las distintas
2549 partes dentro de diferentes contextos y aún tener la definición
2550 completa del grob en el momento de su creación, montada a partir
2551 de todas las piezas proporcionadas por el contexto actual y su
2552 ancestro o ancestros, conjuntamente.
2554 Un grob u objeto gráfico se crea normalmente por parte de un
2555 grabador en el momento de la interpretación de una expresión
2556 musical y recibe sus propiedades iniciales de la definición de
2557 grob en curso del contexto del grabador. El grabador (u otras
2558 partes del @q{backend} de LilyPond) pueden después modificar (o
2559 añadirse a) las propiedades iniciales del grob; sin embargo, ello
2560 no afecta a la definición de grob del contexto.
2562 Lo que LilyPond conoce como @q{propiedades de grob} en el contexto
2563 del trucaje a nivel de usuario son en realidad las propiedades de
2564 la definición de grob de un contexto.
2566 Se accede a las definiciones de grob con un conjunto de
2567 instrucciones diferente. Se manipulan usando @code{\override} y
2568 @code{\revert} y tienen un nombre que empieza con una letra
2569 mayúscula (como @samp{NoteHead}) mientras que las propiedades de
2570 contexto ordinarias se manipulan utilizando @code{\set} y
2571 @code{\unset} y se nombran empezando en letra minúscula.
2573 @cindex tweak, relación con @code{\override}
2575 @funindex \overrideProperty
2577 Las instrucciones @code{\tweak} y @code{\overrideProperty} cambian
2578 las propiedades de grob pasando por encima de las propiedades de
2579 contexto completamente. En su lugar, atrapan a los grobs tan
2580 pronto se crean, y establecen propiedades sobre ellos directamente
2581 con @code{\tweak} cuando se originan a partir de un evento musical
2582 o, en el caso de @code{\overrideProperty}, para una sobreescritura
2585 @node La instrucción offset
2586 @subsection La instrucción @code{\offset}
2587 @translationof The offset command
2590 @cindex desplazamiento
2591 @cindex valores predeterminados, desplazar
2593 Aunque es posible fijar propiedades de grob a valores nuevos con
2594 las instrucciones @code{\override}, @code{\tweak} y
2595 @code{\overrideProperty}, muchas veces conviene más modificar
2596 dichas propiedades en una cantidad relativa al valor
2597 predeterminado. La instrucción @code{\offset} se encuentra
2598 disponible para este fin.
2600 La sintaxis de @code{\offset} es
2603 [-]\offset @var{propiedad} @var{incrementos} @var{elemento}
2606 La instrucción funciona añadiendo el contenido de
2607 @var{incrementos} al ajuste predeterminado de la @var{propiedad}
2608 del grob indicado por @var{elemento}.
2610 Dependiendo de la formulación de la instrucción, @code{\offset}
2611 puede actuar como un @code{\tweak} (trucaje) o como un
2612 @code{\override} (sobreescritura). Las variaciones en su uso se
2613 explicarán después de haber examinado las propiedades de grob que
2614 se pueden usar con @code{\offset}.
2616 @subsubsubheading{Propiedades que admiten el desplazamiento}
2618 Muchas, pero no todas, las propiedades de grob admiten la
2619 aplicación de un desplazamiento. Si @var{propiedad} no se puede
2620 desplazar, el objeto permanece sin cambios y se emite una
2621 advertencia. En estos casos se deben usar en su lugar
2622 @code{\override} o @code{\tweak} para modificar el objeto.
2624 Se puede trabajar por ensayo y error y dejar que las advertencias
2625 nos sirvan de guía para saber lo que puede o no puede ser
2626 desplazado. Sin embargo, es posible un enfoque más sistemático.
2628 Los criterios siguientes determinan si una propiedad se puede
2629 modificar con @code{\offset}:
2634 La propiedad tiene un @q{ajuste predeterminado} en la descripción
2635 del grob. Tales propiedades aparecen listadas para cada grob en
2636 @rinternals{All layout objects} (y también están en
2637 @file{scm/define-grobs.scm}).
2640 La propiedad admite un valor numérico. Entre los valores
2641 numéricos se encuentran @code{number}, una lista de
2642 @code{number}s, @code{number-pair}, y @code{number-pair-list}.
2643 Las páginas de @rinternals{All layout objects} contienen una lista
2644 de los tipos de datos característicos de cada propiedad. No
2645 importa si el ajuste predeterminado es una función.
2648 La propiedad no puede ser una @q{subpropiedad} (una propiedad que
2649 reside dentro de otra propiedad).
2652 Las propiedades establecidas a valores infinitos no se pueden
2653 desplazar. No hay ninguna forma sensata de incrementar los valores
2654 infinitos positivos o negativos.
2657 Los ejemplos siguientes tratan diversas propiedades de grob frente
2658 a los criterios que se han expuesto.
2662 @item Propiedades que se pueden desplazar
2666 @item @code{Hairpin.height}
2668 Esta propiedad no es una subpropiedad, y está en la lista que
2669 aparece en @rinternals{Hairpin}. En cuanto a su valor, admite
2670 @q{dimension, in staff space} (dimensión, en espacios de
2671 pentagrama) fijado a @code{0.6666} (que claramente es un
2672 @code{number} no infinito).
2674 @item @code{Arpeggio.positions}
2676 En la lista de la página que describe @rinternals{Arpeggio}
2677 aparece una propiedad @code{positions} que admite una @q{pareja de
2678 números}. Su valor predeterminado es
2679 @code{ly:arpeggio::positions}, que es un @q{callback} que se
2680 evalúa durante la fase de tipografiado para dar como resultado una
2681 pareja de números para cualguier objeto @code{Arpeggio} dado.
2685 @item Propiedades que no admiten el desplazamiento
2689 @item @code{Hairpin.color}
2691 No hay un listado para @code{color} en @rinternals{Hairpin}.
2693 @item @code{Hairpin.circled-tip}
2695 La lista de @code{Hairpin.circled-tip} en la página de
2696 @rinternals{Hairpin} muestra que admite un valor @code{boolean}.
2697 Los valores booleanos so no numéricos.
2699 @item @code{Stem.details.lengths}
2701 Aunque está listado en @rinternals{Stem} y su valor por omisión es
2702 una lista de @code{number}s, es una @q{subpropiedad}. Por el
2703 momento no se contemplan las @q{propiedades anidadas}.
2709 @subsubsubheading{@bs{}offset como sobreescritura}
2711 Si @var{elemento} es un nombre de grob como @code{Arpeggio} o
2712 @code{Staff.OttavaBracket}, el resultado es un @code{\override} o
2713 sobreescritura de el tipo de grob especificado.
2716 \offset @var{propiedad} @var{incremento} [@var{contexto}.]@var{NombreDeGrob}
2719 Observe que el guión precedente @emph{nunca} se utiliza con la
2720 forma @q{override}, de igual manera que nunca se usa con la propia
2721 instrucción @code{\override}.
2723 El ejemplo siguiente usa la forma @q{override}, de sobreescritura,
2724 para alargar los arpegios predeterminados que aparecen en el
2725 primer compás para que cubran todo el tamaño de los acordes. Los
2726 arpegios se amplían en medio espacio de pentagrama hacia arriba y
2727 hacia abajo. También se muestra la misma operación efectuada
2728 sobre el primer acorde con una sobreescritura normal de la
2729 propiedad the @code{positions}. Este método no es en absoluto
2730 expresivo de la acción de @q{ampliar en medio espacio de
2731 pentagrama}, porque los extremos se tienen que especificar
2732 mediante coordenadas absolutas, no relativas. Además, se
2733 necesitarían sobreescrituras individuales para los otros acordes,
2734 ya que varían en tamaño y posición.
2736 @lilypond[quote,verbatim]
2738 <c' e' g'>\arpeggio <a' c'' e''>\arpeggio
2739 <d' f' a' c''>\arpeggio <c' e' g' b' d'' f'' a''>\arpeggio
2745 \offset positions #'(-0.5 . 0.5) Arpeggio
2748 \once \override Arpeggio.positions = #'(-3.5 . -0.5)
2749 <c' e' g'>1\arpeggio
2754 En su uso como @q{override}, @code{\offset} se puede hacer
2755 preceder por @code{\once} o por @code{\temporary} y revertirse
2756 mediante @code{\revert} con la @var{propiedad}. Esto se sigue a
2757 partir del hecho de que @code{\offset} en realidad crea un
2758 @code{\override} para la @var{propiedad}.
2760 @lilypond[quote,verbatim]
2761 music = { c'8\< d' e' f'\! }
2765 \offset height 1 Hairpin
2768 \revert Hairpin.height
2771 \once \offset height 1 Hairpin
2774 \override Hairpin.height = 0.2
2776 \temporary \offset height 2 Hairpin
2779 \revert Hairpin.height
2785 Así como @code{\override}, la forma @q{override} de @code{\offset}
2786 se puede usar con @code{\undo} y con @code{\single}.
2788 @lilypond[quote,verbatim]
2789 longStem = \offset length 6 Stem
2792 \longStem c'4 c''' c' c''
2794 \undo \longStem c'4 c''' c' c''
2796 \single \longStem c'4 c''' c' c''
2801 @subsubsubheading{@bs{}offset como trucaje}
2803 Si @var{elemento} es una expresión musical como @code{(} o
2804 @code{\arpeggio}, el resultado es la misma expresión musical con
2805 un trucaje aplicado.
2808 [-]\offset [@var{NombreDeGrob}.]@var{propiedad} @var{incrementos} @var{expresión-musical}
2811 La sintaxis de @code{\offset} en forma de @q{tweak} es análoga a
2812 la propia instrucción @code{\tweak}, tanto en orden como en cuanto
2813 a la presencia o ausencia del guión inicial.
2815 El ejemplo siguiente usa la forma @q{tweak} para ajustar la
2816 posición vertical del objeto @code{BreathingSign}. Compárelo con
2817 la instrucción @code{\tweak} normal que también aparece. La
2818 sintaxis es equivalente; sin embargo, la salida de @code{\tweak}
2819 es menos intuitiva, ya que @code{BreathingSign.Y-offset} se
2820 calcula a partir de la tercera línea del pentagrama. No es
2821 necesario saber cómo se calcula @code{Y-offset}, al usar
2824 @lilypond[quote,verbatim]
2829 \offset Y-offset 2 \breathe
2831 \tweak Y-offset 3 \breathe
2835 En el ejemplo anterior, los objetos trucados se crearon
2836 directamente a partir de la entrada del usuario: la instrucción
2837 @code{\breathe} era una instrucción explícita para devolver un
2838 objeto @code{BreathingSign}. Dado que el objeto de la instrucción
2839 no es ambiguo, no había necesidad de especificar el nombre del
2840 objeto. Sin embargo, cuando un objeto se crea
2841 @emph{indirectamente}, es necesario incluir el nombre del grob.
2842 Es lo mismo que para la instrucción @code{\tweak}.
2844 En el ejemplo siguiente, el objeto @code{Beam} se baja en dos
2845 espacios de pentagrama aplicando @code{\offset} a la propiedad
2848 La primera aplicación de @code{\offset} exige que se incluya el
2849 nombre del grob, porque nada en el código de entrada crea
2850 explícitamente la barra. En la segunda aplicación, la barra se
2851 crea manualmente con la expresión musical @code{[}; por tanto, el
2852 nombre del grob no es necesario (también aparece en la ilustración
2853 una abreviatura: un solo número se aplica a los dos miembros de
2856 @lilypond[quote,verbatim]
2859 \offset Beam.positions #'(-2 . -2)
2862 c''8-\offset positions #-2 [ g'' e'' d'']
2866 @subsubsubheading{@bs{}offset con objetos extensos divididos}
2868 También es posible modificar segmentos de un objeto que se
2869 extiende sobre un salto o saltos de línea. En este caso,
2870 @var{offsets} admite una lista de valores del tipo de datos
2871 requerido por la propiedad.
2873 La instrucción @code{\offset} usada de esta forma es similar a la
2874 instrucción @code{\alterBroken}
2875 (véase @ref{Modificación de objetos de extensión divididos}). Sin
2876 embargo, a diferencia de @code{\alterBroken}, los valores que se
2877 le dan a @code{\offset} son relativos, no absolutos.
2879 El ejemplo siguiente desplaza el objeto @q{dividido}
2880 @code{OttavaBracket} a través de su propiedad
2881 @code{staff-padding}. Dado que la propiedad toma un
2882 @code{number}, se le proporciona a @var{incrementos} una lista de
2883 números para aplicarlos a los dos segmentos creados por el salto
2884 de línea. La parte de corchete de la primera línea queda, en
2885 realidad, inalterada, ya que se añade @code{0} a su valor por
2886 omisión de @code{staff-padding}. El segmento que está en la
2887 segunda línea se eleva tres espacios de pentagrama a partir de su
2888 altura por omisión. La altura predeterminada resulta ser
2889 @code{2}, aunque no es necesario saberlo para conseguir la
2892 @lilypond[quote,verbatim]
2894 \offset staff-padding #'(0 3) Staff.OttavaBracket
2902 El ejemplo siguiente copia el efecto de la instrucción
2903 @code{\shape} mediante el incremento de la propiedad
2904 @code{control-points} del objeto @code{Slur}. Aquí,
2905 @var{incrementos} es una lista de parejas de números, una por cada
2906 segmento de la ligadura. Este ejemplo produce un resultado
2907 idéntico a la ilustración correspondiente que aparece en
2908 @ref{Modificación de las formas}.
2910 @lilypond[quote,verbatim]
2912 c'4-\offset control-points #'(
2913 ((0 . 0) (0 . 0) (0 . 0) (0 . 1))
2914 ((0.5 . 1.5) (1 . 0) (0 . 0) (0 . -1.5))
2922 @node Modificación de las listas-A
2923 @subsection Modificación de las listas-A
2924 @translationof Modifying alists
2926 Ciertas propiedades configurables por parte del usuario se
2927 representan internamente como @emph{listas-A} (listas
2928 asociativas), que almacenan duplas de @emph{claves} y
2929 @emph{valores}. La estructura de una lista-A es la siguiente:
2932 '((@var{clave1} . @var{valor1})
2933 (@var{clave2} . @var{valor2})
2934 (@var{clave3} . @var{valor3})
2938 Si una lista-A es una propiedad de un grob o una variable de
2939 @code{\paper}, sus claves se pueden modificar individualmente sin
2940 que afecte a las otras claves.
2942 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2943 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2944 del grob @code{StaffGrouper}. La propiedad es una lista-A con
2945 cuatro claves: @code{basic-distance} (distancia básica),
2946 @code{minimum-distance} (distancia mínima), @code{padding}
2947 (relleno) y @code{stretchability} (ampliabilidad). Los ajustes
2948 estándar para esta propiedad se relacionan en la sección
2949 @qq{Backend} de la Referencia de Funcionamiento Interno (véase
2950 @rinternals{StaffGrouper}):
2953 '((basic-distance . 9)
2954 (minimum-distance . 7)
2956 (stretchability . 5))
2959 Una forma de acercar los pentagramas entre sí es reducir el valor
2960 de la clave @code{basic-distance} (@code{9}) para que se
2961 corresponda con el valor de @code{minimum-distance} (@code{7}).
2962 Para modificar una única clave de forma individual, utilice una
2963 @emph{declaración anidada}:
2965 @lilypond[quote,verbatim]
2966 % default space between staves
2968 \new Staff { \clef treble c''1 }
2969 \new Staff { \clef bass c1 }
2972 % reduced space between staves
2973 \new PianoStaff \with {
2974 % this is the nested declaration
2975 \override StaffGrouper.staff-staff-spacing.basic-distance = #7
2977 \new Staff { \clef treble c''1 }
2978 \new Staff { \clef bass c1 }
2982 La utilización de una declaración anidada actualiza la clave
2983 especificada (como @code{basic-distance} en el ejemplo anterior)
2984 sin alterar ninguna de las otras claves que ya se habían
2985 establecido para la misma propiedad.
2987 Ahora, supongamos que deseamos que los pentagramas estén tan
2988 próximos como sea posible sin que se superpongan. La manera más
2989 sencilla de hacerlo es establecer las cuatro claves de la lista-A
2990 a cero. Sin embargo, no es necesario escribir cuatro
2991 declaraciones anidadas, una por cada clave. En lugar de eso, se
2992 puede redefinir completamente la propiedad con una sola
2993 declaración, como una lista-A:
2995 @lilypond[quote,verbatim]
2996 \new PianoStaff \with {
2997 \override StaffGrouper.staff-staff-spacing =
2998 #'((basic-distance . 0)
2999 (minimum-distance . 0)
3001 (stretchability . 0))
3003 \new Staff { \clef treble c''1 }
3004 \new Staff { \clef bass c1 }
3008 Observe que cualquier clave que no haya sido relacionada
3009 explícitamente en la definición de la lista-A, será reiniciada a
3010 sus valores @emph{predeterminados si no se han fijado}. En el
3011 caso de @code{staff-staff-spacing}, el valor de cualquier clave no
3012 fijada se reiniciaría a cero (excepto @code{stretchability}, que
3013 toma el valor de @code{basic-distance} si no se fija). Así, las
3014 dos declaraciones siguientes son equivalentes:
3017 \override StaffGrouper.staff-staff-spacing =
3018 #'((basic-distance . 7))
3020 \override StaffGrouper.staff-staff-spacing =
3021 #'((basic-distance . 7)
3022 (minimum-distance . 0)
3024 (stretchability . 7))
3027 Una consecuencia de esto (posiblemente no intencionada) es la
3028 eliminación de cualquier valor estándar que se establezca en un
3029 archivo de inicio y que se carga cada vez que se compila un
3030 archivo de entrada. En el ejemplo anterior, los ajustes estándar
3031 para @code{padding} y @code{minimum-distance} (definidos en
3032 @file{scm/define-grobs.scm}) se reinician a sus valores
3033 predeterminados si no se han fijado (cero para las dos claves).
3034 La definición de una propiedad o variable como una lista-A (de
3035 cualquier tamaño) siempre reinicia todos los valores de clave no
3036 establecidos a sus valores predeterminados si no se han fijado.
3037 Ano ser que este sea el resultado deseado, es más seguro
3038 actualizar los valores de clave individualmente con una
3039 declaración anidada.
3041 @warning{Las declaraciones anidadas no funcionan para las listas-A
3042 de propiedades de contexto (como @code{beamExceptions},
3043 @code{keyAlterations}, @code{timeSignatureSettings}, etc.). Estas
3044 propiedades sólo se pueden modificar redefiniéndolas completamente
3048 @node Conceptos y propiedades útiles
3049 @section Conceptos y propiedades útiles
3050 @translationof Useful concepts and properties
3054 * Modos de entrada::
3055 * Dirección y posición::
3056 * Distancias y medidas::
3058 * Propiedades del símbolo del pentagrama::
3059 * Objetos de extensión::
3060 * Visibilidad de los objetos::
3061 * Estilos de línea::
3062 * Rotación de objetos::
3065 @node Modos de entrada
3066 @subsection Modos de entrada
3067 @translationof Input modes
3069 La forma en que se interpreta la notación contenida dentro de un
3070 archivo de entrada, está determinada por el modo de entrada en
3072 there are two ways of specifying the mode: a long form, e.g.
3073 @code{\chordmode}, and a short form, e.g. @code{\chords}. The long
3074 form is typically used when supplying input to a variable or when
3075 entering input directly into an explicitly created context. The short
3076 form implicitly creates a context of the correct type for the input and
3077 passes the input directly to it. It is useful in simple situations
3078 when there is no requirement to explicitly create the receiving context.
3080 @subsubsubheading Modo de acordes
3082 Se activa con la instrucción @code{\chordmode} y produce que la
3083 entrada se interprete con al sintaxis de la notación de acordes,
3084 véase @ref{Notación de acordes}. Music in chord mode is rendered as chords on a staff
3085 when entered into a @code{Staff} context, as chord names when entered
3086 into a @code{ChordNames} context or as fret boards when entered into
3087 a @code{FretBoards} context.
3089 El modo de acordes se activa también con la instrucción
3090 @code{\chords}. Esto también produce que el código que sigue se interprete con la
3091 sintaxis de la notación de acordes but in addition it implicitly creates a new
3092 @code{ChordNames} context and renders the input into it as chord names, véase @ref{Impresión de los nombres de acorde}.
3094 @subsubsubheading Modo de percusión
3096 Se activa con la instrucción @code{\drummode} y produce que el
3097 código de entrada se interprete con la sintaxis de la notación de
3098 percusión, véase @ref{Notación básica de percusión}. Music in drum mode is rendered as
3099 percussion notes when entered into a @code{DrumStaff} context.
3101 El modo de percusión también se activa con la instrucción
3102 @code{\drums}. También
3103 hace que el código que sigue se interprete con la sintaxis de la
3104 notación de percusión but in addition it implicitly creates a new
3105 @code{DrumStaff} context and renders the input into it as percussion
3106 notes, véase @ref{Notación básica de
3109 @subsubsubheading Modo de cifras
3111 Se activa con la instrucción @code{\figuremode} y hace que el código
3112 de entrada se interprete con la sintaxis del bajo cifrado, véase
3113 @ref{Introducir el bajo cifrado}. Music in figure mode is rendered as
3114 figured bass when entered into a @code{FiguredBass} context or a
3115 @code{Staff} context.
3117 El modo de cifras también se activa con la instrucción
3118 @code{\figures}. También hace que el código que viene a continuación se interprete
3119 con la sintaxis del bajo cifrado but in addition it implicitly creates a new
3120 @code{FiguredBass} context and renders the input into it as figured
3122 @ref{Introducción al bajo cifrado}.
3124 @subsubsubheading Modos de traste y tablatura
3126 No existen modos de entrada especiales para introducir símbolos de
3127 trastes y de tablatura.
3129 Para crear diagramas de trastes, escriba las notas o acordes en el
3130 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
3131 véase @ref{Tablaturas predeterminadas}.
3133 Para crear diagramas de trastes encima de un pentagrama, enter notes or chords in either
3134 note mode or chord mode and render them in a @code{FretBoards} context, véase @ref{Diagramas de traste automáticos}. Alternatively, los diagramas de trastes se pueden introducir como elementos de marcado encima de las notas
3135 utilizando la instrucción @code{\fret-diagram}, véase
3136 @ref{Marcas de diagramas de trastes}.
3138 @subsubsubheading Modo de letra
3140 Se activa con la instrucción @code{\lyricmode}, y hace que la
3141 entrada se interprete como sílabas de la letra de la canción con
3142 duraciones opcionales y modificadores de letra asociados, véase
3143 @ref{Música vocal}. Input in
3144 lyric mode is rendered as lyric syllables when entered into a
3145 @code{Lyrics} context.
3147 El modo de letra también se habilita con la instrucción
3148 @code{\addlyrics}. This
3149 also causes the following input to be interpreted as lyric syllables
3150 but in addition it implicitly creates a new @code{Lyrics} context and
3151 renders the input into it as lyric syllables.
3153 Lyric mode is also activated with the @code{\addlyrics} command. Esto también crea un contexto @code{Lyrics}
3154 nuevo y además añade una instrucción @code{\lyricsto} implícita que asocia la
3155 letra que viene a continuación con la música precedente, véase @ref{Automatic syllable durations}.
3157 @subsubsubheading Modo de marcado
3159 Se activa con la instrucción @code{\markup}, y hace que la entrada
3160 se interprete con la sintaxis del marcado, véase
3161 @ref{Text markup commands}.
3163 @subsubsubheading Modo de notas
3165 Es el modo predeterminado o se puede activar con la instrucción
3166 @code{\notemode}. La entrada se interpreta como alturas,
3167 duraciones, marcado, etc. y se imprime como notación musical sobre
3170 Normalmente no es necesario especificar el modo de notas de forma
3171 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
3172 ejemplo si estamos en el modo de letra, en el modo de acordes o en
3173 otro modo y queremos insertar algo que solamente se puede hacer
3174 con la sintaxis del modo de notas.
3177 @node Dirección y posición
3178 @subsection Dirección y posición
3179 @translationof Direction and placement
3181 Al tipografiar música, la dirección y colocación de muchos
3182 elementos es cuestión de elección. Por ejemplo, las plicas de las
3183 notas se pueden dirigir hacia arriba o hacia abajo; la letra, las
3184 indicaciones dinámicas y otras marcas expresivas se pueden colocar
3185 encima o debajo del pentagrama; el texto se pude alinear a la
3186 izquierda, a la derecha o centrado; etc. La mayoría de estas
3187 elecciones pueden dejarse que LilyPond las determine
3188 automáticamente, pero en ciertos casos puede ser deseable forzar
3189 una dirección o colocación concreta.
3192 * Indicadores de dirección de las articulaciones::
3193 * La propiedad de dirección::
3197 @node Indicadores de dirección de las articulaciones
3198 @unnumberedsubsubsec Indicadores de dirección de las articulaciones
3199 @translationof Articulation direction indicators
3201 De forma predeterminada algunas direcciones siempre son hacia
3202 arriba o siempre hacia abajo (p. ej. los matices o el calderón),
3203 mientras que otras cosas pueden alternar entre arriba y abajo en
3204 función de la dirección de las plicas (como las ligaduras o los
3207 @c TODO Add table showing these
3209 Se puede sobreescribir la acción predeterminada mediante el
3210 prefijado de la articulación por un @emph{indicacor de dirección}.
3211 Están disponibles tres indicadores de dirección: @code{^} (que
3212 significa @qq{arriba}), @code{_} (que significa @qq{abajo}) o
3213 @code{-} (que significa @qq{usar la dirección predeterminada}).
3214 El indicador de dirección se puede normalmente omitir, en cuyo
3215 caso se supone el indicador predeterminado @code{-}, pero se
3216 necesita un indicador de dirección @strong{siempre} antes de:
3219 @item las instrucciones @code{\tweak}
3220 @item las instrucciones @code{\markup}
3221 @item las instrucciones @code{\tag}
3222 @item los marcados de cadena, p.ej. -"cadena"
3223 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
3224 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
3227 Estas indicaciones afectan sólo a la nota siguiente.
3229 @lilypond[verbatim,quote]
3239 @node La propiedad de dirección
3240 @unnumberedsubsubsec La propiedad de dirección
3241 @translationof The direction property
3243 La posición o dirección de muchos objetos de presentación está
3244 controlada por la propiedad @code{direction}.
3246 El valor de la propiedad @code{direction} se puede establecer al
3247 valor @code{1}, con el significado de @qq{hacia arriba} o
3248 @qq{encima}, o a @w{@code{-1}}, con el significado de @qq{hacia
3249 abajo} o @qq{debajo}. Se pueden usar los símbolos @code{UP} y
3250 @code{DOWN} en sustitución de @code{1} y @w{@code{-1}}
3251 respectivamente. La dirección predeterminada se puede especificar
3252 estableciendo @code{direction} a @code{0} ó a @code{CENTER}. De
3253 forma alternativa, en muchos casos existen instrucciones
3254 predefinidas para especificar la dirección. Todas ellas son de la
3258 \xxxUp, \xxxDown or \xxxNeutral
3262 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
3263 predeterminada}. Véase @rlearning{Objetos interiores al
3266 En alguna que otra ocasión como en el arpegio, el valor de la
3267 propiedad @code{direction} puede especificar si el objeto se debe
3268 colocar a la izquierda o a la derecha del objeto padre. En este
3269 caso @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y
3270 @code{1} ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó
3271 @code{CENTER} significan @qq{utilizar la dirección
3274 Estas indicaciones afectan a todas las notas hasta que son
3277 @lilypond[verbatim,quote]
3288 En música polifónica, en general es mejor especificar una voz
3289 explícita que cambiar la dirección de un objeto. Para ver más
3290 información, véase @ref{Varias voces}.
3293 Manual de aprendizaje:
3294 @rlearning{Objetos interiores al pentagrama}.
3296 Referencia de la notación:
3300 @node Distancias y medidas
3301 @subsection Distancias y medidas
3302 @translationof Distances and measurements
3304 @cindex distancias absolutas
3305 @cindex distancias escaladas
3312 Las distancias en LilyPond son de dos tipos: absolutas y
3315 Las distancias absolutas se usan para especificar márgenes,
3316 sangrados y otros detalles de diseño de página, y de forma
3317 predeterminada se especifican en milímetros. Las distancias se
3318 pueden especificar en otras unidades escribiendo después de la
3319 cifra indicativa de la cantidad, @code{\mm}, @code{\cm},
3320 @code{\in}@tie{}(pulgadas), o @code{\pt}@tie{}(puntos, 1/72.27
3321 pulgadas). Las distancias de diseño de página se pueden
3322 especificar también en unidades escalables (véase el párrafo
3323 siguiente) adjuntando @code{\staff-space} a la cantidad. La
3324 disposición de página se describe en detalle en @ref{Disposición
3327 Las distancias escaladas siempre se especifican en unidades de un
3328 espacio del pentagrama o, más raramente, medio espacio del
3329 pentagrama. El espacio de pentagrama es la distancia entre dos
3330 líneas del pentagrama adyacentes. El valor predeterminado se
3331 puede cambiar globalmente fijando el tamaño global del pentagrama,
3332 o se puede sobreescribir localmente cambiando la propiedad
3333 @code{staff-space} del objeto @code{StaffSymbol}. Las distancias
3334 escaladas se escalan automáticamente con cualquier cambio al
3335 tamaño global del pentagrama o a la propiedad @code{staff-space}
3336 del objeto @code{StaffSymbol}, pero las fuentes tipográficas se
3337 escalan solamente con los cambios efectuados al tamaño global del
3338 pentagrama. Así, el tamaño global del pentagrama posibilita la
3339 fácil variación del tamaño general de una partitura impresa. Para
3340 ver los métodos de establecimiento del tamaño global del
3341 pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
3345 Si se necesita dibujar sólo una sección de una partitura a una
3346 escala distinta, por ejemplo una sección ossia o una nota al pie,
3347 no se puede simplemente cambiar el tamaño global del pentagrama
3348 porque esto afectaría a toda la partitura. En tales casos, el
3349 cambio de tamaño se hace sobreescribiendo tanto la propiedad
3350 @code{staff-space} de @code{StaffSymbol} como el tamaño de las
3351 fuentes tipográficas. Está a nuestra disposición una función de
3352 Scheme, @code{magstep}, para convertir de un cambio en el tamaño
3353 de la fuente al cambio equivalente en @code{staff-space}. Para
3354 ver una explicación y un ejemplo de su utilización, consulte
3355 @rlearning{Longitud y grosor de los objetos}.
3358 Manual de aprendizaje:
3359 @rlearning{Longitud y grosor de los objetos}.
3361 Referencia de la notación:
3362 @ref{Disposición de la página},
3363 @ref{Establecer el tamaño del pentagrama}.
3367 @subsection Dimensiones
3368 @translationof Dimensions
3371 @cindex caja circundante
3373 Las dimensiones de un objeto gráfico especifican las posiciones de
3374 los límites izquierdo y derecho, así como los límites inferior y
3375 superior de las cajas limítrofes de los objetos como distancias a
3376 partir del punto de referencia del objeto en unidades de espacios
3377 de pentagrama. Estas posiciones se codifican frecuentemente como
3378 dos parejas de valores de Scheme. Por ejemplo, la instrucción de
3379 marcado de texto @code{\with-dimensions} toma tres argumentos, de
3380 los cuales los dos primeros son una pareja de Scheme que da las
3381 posiiciones de los bordes izquierdo y derecho y otra pareja de
3382 Scheme que da las posiciones de los límites inferior y superior:
3385 \with-dimensions #'(-5 . 10) #'(-3 . 15) @var{arg}
3388 Esto especifica una caja circundante para @var{arg} con su límite
3389 izquierdo en -5, su límite derecho en 10, el inferior en -3 y el
3390 superior e 15, todos ellos medidos a partir del punto de
3391 referencia del objeto en unidades de espacios de pentagrama.
3394 Referencia de la notación:
3395 @ref{Distancias y medidas}.
3398 @node Propiedades del símbolo del pentagrama
3399 @subsection Propiedades del símbolo del pentagrama
3400 @translationof Staff symbol properties
3402 @cindex ajuste del símbolo del pentagrama
3403 @cindex dibujar el símbolo del pentagrama
3404 @cindex pentagrama, establecer el símbolo del
3406 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
3407 @c Need to think of uses for these properties. Eg 'line-positions
3408 @c is used in a snippet to thicken centre line.
3409 @c If retained, add @ref to here in 1.6.2 -td
3411 Se puede definir al mismo tiempo la posición vertical de las
3412 líneas de la pauta y el número de líneas de la misma. Como
3413 muestra el siguiente ejemplo, las posiciones de las notas no están
3414 influidas por las posiciones de las líneas de la pauta.
3416 @warning{La propiedad @code{'line-positions} sobreescribe a la
3417 propiedad @code{'line-count}. El número de líneas de la pauta
3418 está definido implícitamente por el número de elementos de la
3419 lista de valores de @code{'line-positions}.}
3421 @lilypond[verbatim,quote]
3423 \override StaffSymbol.line-positions = #'(7 3 0 -4 -6 -7)
3425 \relative { a4 e' f b | d1 }
3428 Se puede modificar la anchura de la pauta. Las unidades son
3429 espacios de pentagrama. El espaciado de los objetos dentro del
3430 pentagrama no resulta afectado por este ajuste.
3432 @lilypond[verbatim,quote]
3434 \override StaffSymbol.width = #23
3436 \relative { a4 e' f b | d1 }
3440 @node Objetos de extensión
3441 @subsection Objetos de extensión
3442 @translationof Spanners
3444 Muchos objetos de notación musical abarcan varias notas o incluso
3445 varios compases. Son ejemplos los crescendi, trinos, corchetes de
3446 grupo especial y corchetes de primera y segunda vez. Estos
3447 objetos se llaman @qq{spanners} u «objetos de extensión», y tienen
3448 propiedades especiales para controlar su apariencia y
3449 comportamiento. Algunas de estas propiedades son comunes a todos
3450 los objetos de extensión; otras se limitan a un subconjunto de los
3453 Todos los objetos de extensión contemplan el interface
3454 @code{spanner-interface}. Algunos, básicamente aquellos que
3455 trazan una línea recta entre los dos objetos, contemplan también
3456 el interface @code{line-spanner-interface}.
3459 * Uso del spanner-interface::
3460 * Uso del line-spanner-interface::
3463 @node Uso del spanner-interface
3464 @unnumberedsubsubsec Uso del @code{spanner-interface}
3465 @translationof Using the spanner-interface
3467 Este interface proporciona dos propiedades que se aplican a varios
3470 @subsubsubheading La propiedad @code{minimum-length} (longitud mínima)
3472 La longitud mínima del objeto de extensión se especifica a través
3473 de la propiedad @code{minimum-length}. Su aumento suele producir
3474 el efecto necesario de aumentar el espaciado de las notas entre
3475 los dos puntos extremos. Sin embargo, esta sobreescritura no
3476 tiene ningún efecto sobre muchos extensores, pues su longitud está
3477 determinada por otras consideraciones. Más abajo se muestran
3478 algunos ejemplos de dónde es efectiva.
3488 Works as long as callback is made:
3492 Works not at all for:
3501 @lilypond[verbatim,quote,fragment]
3504 % increase the length of the tie
3505 -\tweak minimum-length #5
3509 @lilypond[verbatim,quote]
3510 \relative \compressMMRests {
3513 % increase the length of the rest bar
3514 \once \override MultiMeasureRest.minimum-length = #20
3520 @lilypond[verbatim,quote]
3523 % increase the length of the hairpin
3524 \override Hairpin.minimum-length = #20
3529 Esta sobreescritura se puede usar también para aumentar la
3530 longitud de las ligaduras de expresión y de fraseo:
3532 @lilypond[verbatim,quote]
3536 -\tweak minimum-length #5
3541 -\tweak minimum-length #5
3546 Para algunos objetos de presentación, la propiedad
3547 @code{minimum-length} es efectiva sólo si se llama explícitamente
3548 al procedimiento @code{set-spacing-rods}. Para hacerlo, se debe
3549 fijar la propiedad @code{springs-and-rods} al valor
3550 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud
3551 mínima de un glissando no tiene efecto a no ser que se establezca
3552 la propiedad @code{springs-and-rods}:
3554 @lilypond[verbatim,fragment,quote]
3558 % not effective alone
3559 \once \override Glissando.minimum-length = #20
3562 % effective only when both overrides are present
3563 \once \override Glissando.minimum-length = #20
3564 \once \override Glissando.springs-and-rods = #ly:spanner::set-spacing-rods
3568 Lo mismo se puede decir del objeto @code{Beam}:
3570 @lilypond[verbatim,fragment,quote]
3571 % not effective alone
3572 \once \override Beam.minimum-length = #20
3575 % effective only when both overrides are present
3576 \once \override Beam.minimum-length = #20
3577 \once \override Beam.springs-and-rods = #ly:spanner::set-spacing-rods
3581 @subsubsubheading La propiedad @code{to-barline}
3583 La segunda propiedad útil del @code{spanner-interface} es
3584 @code{to-barline}. De forma predeterminada tiene el valor cierto,
3585 haciendo que los reguladores y otros objetos de extensión que
3586 terminan sobre la primera nota de un compás, en vez de eso
3587 terminen en la línea divisoria inmediatamente precedente. Si se
3588 establece al valor falso, el extensor llegará más allá de la barra
3589 de compás y terminará exactamente sobre la nota:
3591 @lilypond[verbatim,quote]
3593 a' \< a a a a \! a a a \break
3594 \override Hairpin.to-barline = ##f
3595 a \< a a a a \! a a a
3599 Esta propiedad no es efectiva para todos los extensores. Por
3600 ejemplo, su establecimiento a @code{#t} no tienen ningún efecto
3601 sobre las ligaduras de expresión o de fraseo, o sobre otros
3602 extensores para los que terminar en la barra de compás no tendría
3605 @node Uso del line-spanner-interface
3606 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
3607 @translationof Using the line-spanner-interface
3609 Entre los objetos que contemplan el interface
3610 @code{line-spanner-interface} se encuentran
3613 @item @code{DynamicTextSpanner}
3614 @item @code{Glissando}
3615 @item @code{TextSpanner}
3616 @item @code{TrillSpanner}
3617 @item @code{VoiceFollower}
3620 La rutina responsable de dibujar los sellos de estos extensores es
3621 @code{ly:line-spanner::print}. esta rutina determina la
3622 localización exacta de los dos puntos extremos y traza una línea
3623 entre ellos, en el estilo solicitado. Las posiciones de los dos
3624 puntos extremos del extensor se calculan al vuelo, pero es posible
3625 sobreescribir sus coordenadas Y. Las propiedades que se deben
3626 especificar están anidadas a dos niveles de profundidad en la
3627 jerarquía de propiedades, pero la sintaxis de la instrucción
3628 @code{\override} es bastante sencilla:
3630 @lilypond[quote,fragment,verbatim]
3632 \once \override Glissando.bound-details.left.Y = #3
3633 \once \override Glissando.bound-details.right.Y = #-2
3637 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
3638 siendo el punto del cero la línea central del pentagrama. Para el
3639 glissando, esto es el valor de @code{Y} en la coordenada X que
3640 corresponde al punto central de cada cabeza de nota si nos
3641 imaginamos que la línea se extiende hasta allí.
3643 Si no está fijado @code{Y}, su valor se calcula a partir de la
3644 posición vertical del punto de anclaje correspondiente del
3647 En caso de salto de línea, los valores para los puntos extremos se
3648 especifican por las sub-listas @code{left-broken} y
3649 @code{right-broken} de @code{bound-details}. Por ejemplo:
3651 @lilypond[ragged-right,fragment,verbatim,quote]
3652 \override Glissando.breakable = ##t
3653 \override Glissando.bound-details.right-broken.Y = #-3
3654 c''1 \glissando \break
3658 Un número de propiedades adicionales de las sub-listas @code{left}
3659 y @code{right} de la propiedad @code{bound-details} se pueden
3660 especificar de la misma forma que @code{Y}:
3664 Establece la coordenada Y del punto extremo, en desplazamientos de
3665 @code{staff-space}s desde la línea central del pentagrama. De
3666 forma predeterminada es el centro del objeto ancla, y así un
3667 glissando apunta al centro vertical de la cabeza de la nota.
3669 Para extensores horizontales como los extensores de texto y los
3670 trinos, está inamoviblemente codificado como 0.
3672 @item attach-dir (dirección de anclaje)
3673 Determina dónde comienza y termina la línea en la dirección X, con
3674 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o
3675 @code{LEFT}, izquierda) hace que la línea comience o termine en el
3676 lado izquierdo de la cabeza de la nota a la que está anclado.
3679 Es la coordenada X absoluta del punto extremo. Se suele calcular
3680 al vuelo, y su sobreescritura no tiene un efecto útil.
3682 @item stencil (sello)
3683 Los extensores de línea pueden tener símbolos al comienzo o al
3684 final, lo que está contenido en esta sub-propiedad. Esto es para
3685 uso interno; se recomienda en su lugar el uso de @code{text}.
3688 Es un elemento de marcado que se evalúa para dar lugar al sello.
3689 Se usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los
3690 objetos de extensión horizontales.
3692 @lilypond[quote,ragged-right,fragment,verbatim]
3693 \override TextSpanner.bound-details.left.text
3694 = \markup { \small \bold Slower }
3695 \relative { c''2\startTextSpan b c a\stopTextSpan }
3698 @item stencil-align-dir-y (alineación del sello en y)
3699 @item stencil-offset (desplazamiento del sello)
3700 Si no se modifican uno u otro, el sello se coloca sencillamente en
3701 el punto extremo, centrado sobre la línea, como viene definido por
3702 las subpropiedades @code{X} e @code{Y}. Si se fijan
3703 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
3704 símbolo del borde verticalmente con relación al extremo de la
3707 @lilypond[quote,fragment,verbatim]
3708 \override TextSpanner.bound-details.left.stencil-align-dir-y = #-2
3709 \override TextSpanner.bound-details.right.stencil-align-dir-y = #UP
3711 \override TextSpanner.bound-details.left.text = #"ggg"
3712 \override TextSpanner.bound-details.right.text = #"hhh"
3714 \relative { c'4^\startTextSpan c c c \stopTextSpan }
3717 Observe que los valores negativos mueven el texto @emph{hacia
3718 arriba}, al contrario de lo que podría esperarse, pues el valor de
3719 @w{@code{-1}} o @code{DOWN} (abajo) significa alinear el borde
3720 @emph{inferior} del texto con la línea de extensión. Un valor de
3721 @code{1} o @code{UP} (arriba) alinea el borde superior del texto
3722 con la línea extensora.
3724 @item arrow (flecha)
3725 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
3726 flecha en el extremo de la línea.
3728 @item padding (relleno)
3729 Esta sub-propiedad controla el espacio entre el punto extremo
3730 especificado de la línea y el extremo real. Sin relleno, un
3731 glissando empezaría y terminaría en el centro de la cabeza de las
3736 La función musical @code{\endSpanners} finaliza de forma prematura
3737 el extensor que comienza sobre la nota que sigue inmediatamente a
3738 continuación. Se termina después de una nota exactamente, o en la
3739 siguiente barra de compás si @code{to-barline} es verdadero y se
3740 produce una divisoria antes de la siguiente nota.
3742 @lilypond[verbatim,quote,ragged-right]
3745 c2 \startTextSpan c2 c2
3751 Si se usa @code{\endSpanners} no es necesario cerrar
3752 \startTextSpan con \stopTextSpan, ni cerrar los reguladores con
3756 Referencia de funcionamiento interno:
3757 @rinternals{TextSpanner},
3758 @rinternals{Glissando},
3759 @rinternals{VoiceFollower},
3760 @rinternals{TrillSpanner},
3761 @rinternals{line-spanner-interface}.
3764 @node Visibilidad de los objetos
3765 @subsection Visibilidad de los objetos
3766 @translationof Visibility of objects
3768 @cindex objetos, visibilidad de
3769 @cindex grobs, visibilidad de
3770 @cindex visibilidad de los objetos
3772 Hay cuatro formas principales en que se puede controlar la
3773 visibilidad de los objetos de presentación: se puede eliminar su
3774 sello, se pueden volver transparentes, se pueden pintar de blanco,
3775 o se puede sobreescribir su propiedad @code{break-visibility}.
3776 Las tres primeras se aplican a todos los objetos de presentación;
3777 la última sólo a unos pocos: los objetos @emph{divisibles}. El
3778 Manual de aprendizaje introduce estas cuatro técnicas, véase
3779 @rlearning{Visibilidad y color de los objetos}.
3781 Hay también algunas otras técnicas que son específicas de ciertos
3782 objetos de presentación. Se estudian bajo Consideraciones
3786 * Eliminar el sello::
3787 * Hacer transparentes los objetos::
3788 * Pintar los objetos de blanco::
3789 * Uso de break-visibility (visibilidad en el salto)::
3790 * Consideraciones especiales::
3794 @node Eliminar el sello
3795 @unnumberedsubsubsec Eliminar el sello
3796 @translationof Removing the stencil
3798 @cindex sello, eliminar
3801 Todo objeto de presentación tiene una propiedad stencil (sello).
3802 De forma predeterminada está establecida a la función específica
3803 que dibuja ese objeto. Si se sobreescribe esta propiedad a
3804 @code{#f} no se llama a ninguna función y el objeto no se dibuja.
3805 La acción predeterminada se puede recuperar con @code{\revert}.
3807 @lilypond[quote,fragment,verbatim]
3809 \override Score.BarLine.stencil = ##f
3811 \revert Score.BarLine.stencil
3815 Esta operación, bastante común, tiene la forma abreviada
3816 @code{\omit} como atajo:
3818 @lilypond[quote,fragment,verbatim]
3822 \undo \omit Score.BarLine
3827 @node Hacer transparentes los objetos
3828 @unnumberedsubsubsec Hacer transparentes los objetos
3829 @translationof Making objects transparent
3831 @cindex transparentes, hacer los objetos
3834 Todo objeto de presentación tiene una propiedad transparent
3835 (transparente) que de forma predeterminada está establecida a
3836 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio
3839 @lilypond[quote,fragment,verbatim]
3841 \once \override NoteHead.transparent = ##t
3845 Esta operación, bastante común, tiene la forma abreviada @code{\hide}
3848 @lilypond[quote,fragment,verbatim]
3850 \once \hide NoteHead
3855 @node Pintar los objetos de blanco
3856 @unnumberedsubsubsec Pintar los objetos de blanco
3857 @translationof Painting objects white
3859 @cindex objetos, coloreado de
3860 @cindex coloreado de objetos
3862 @cindex impresión, orden de
3863 @cindex sobreescritura de objetos
3864 @cindex objetos, sobreescritura de
3865 @cindex grobs, sobreescritura de
3867 Todo objeto de presentación tiene una propiedad de color que de
3868 forma predeterminada está establecida a @code{black} (negro). Si
3869 se sobreescribe a @code{white} (blanco) el objeto será
3870 indistinguible del fondo blanco. Sin embargo, si el objeto cruza
3871 a otros objetos, el color de los puntos de cruce queda determinado
3872 por el orden en que se dibujan estos objetos, lo que puede dejar
3873 una imagen fantasma del objeto blanco, como puede verse aquí:
3875 @lilypond[quote,fragment,verbatim]
3876 \override Staff.Clef.color = #white
3880 Se puede evitar esto cambiando el orden de impresión de los
3881 objetos. Todos los objetos de presentación tienen una propiedad
3882 @code{layer} (capa) que se debe establecer a un valor entero. Los
3883 objetos con el valor de @code{layer} más bajo se dibujan primero,
3884 después se dibujan los objetos con valores progresivamente
3885 mayores, y así los objetos con valores más altos se dibujan encima
3886 de los que tienen valores más bajos. De forma predeterminada,
3887 casi todos los objetos tienen asignado un valor @code{layer} de
3888 @code{1}, aunque algunos objetos, entre ellos el pentagrama y las
3889 líneas divisorias, @code{StaffSymbol} y @code{BarLine}, tienen
3890 asignado un calor de @code{0}. El orden de impresión de los
3891 objetos con el mismo valor de @code{layer} es indeterminado.
3893 En el ejemplo de arriba, la clave blanca, con un valor
3894 @code{layer} predeterminado de @code{1}, se dibuja después de las
3895 líneas del pentagrama (valor @code{layer} predeterminado de
3896 @code{0}), sobreimpresionándolas. Para cambiarlo, se debe dar al
3897 objeto @code{Clef} un valor de @code{layer} más bajo, digamos
3898 @w{@code{-1}}, para que se dibuje antes:
3900 @lilypond[quote,fragment,verbatim]
3901 \override Staff.Clef.color = #white
3902 \override Staff.Clef.layer = #-1
3907 @node Uso de break-visibility (visibilidad en el salto)
3908 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
3909 @translationof Using break-visibility
3911 @c TODO Add making other objects breakable
3913 @cindex break-visibility
3915 Casi todos los objetos de presentación se imprimen una sola vez,
3916 pero algunos como las líneas divisorias, claves, indicaciones de
3917 compás y armaduras de tonalidad, se pueden tener que imprimir dos
3918 veces cuando se produce un salto de línea : una vez al final de la
3919 línea y otra al comienzo de la siguiente. Estos objetos reciben
3920 el nombre de @emph{divisibles}, y tienen una propiedad,
3921 @code{break-visibility} (visibilidad en el salto), para controlar
3922 su visibilidad en las tres posiciones en que pueden aparecer: al
3923 comienzo de una línea, dentro de la línea si se produce un cambio,
3924 y al final de la línea si el cambio se produce en ese lugar.
3926 Por ejemplo, la indicación de compás se imprime de forma
3927 predeterminada al comienzo de la primera línea y en ningún otro
3928 lugar a no ser que cambie, en cuyo caso se imprime en el punto en
3929 que se produce el cambio. Si este cambio se produce al final de
3930 una línea, la nueva indicación de compás se imprime al principio
3931 de la línea siguiente y también al final de la línea anterior como
3932 indicación de precaución.
3934 Este comportamiento se controla por medio de la propiedad
3935 @code{break-visibility}, que se explica en
3936 @c Leave this ref on a newline - formats incorrectly otherwise -td
3937 @rlearning{Visibilidad y color de los objetos}. Esta propiedad
3938 toma un vector de tres valores booleanos que, por orden,
3939 determinan si el objeto se imprime al final, dentro, o al
3940 principio de la línea. O, para ser más exactos: antes del salto
3941 de línea, si no hay salto, o después del salto.
3943 Como alternativa se puede especificar cualquiera de las ocho
3944 combinaciones mediante funciones predefinidas cuya definición está
3945 en @file{scm/output-lib.scm}, donde las tres últimas columnas
3946 indican si los objetos de presentación serán visibles en las
3947 posiciones que se muestran en el encabezamiento de cada columna:
3949 @multitable {@code{begin-of-line-invisible}} {@code{#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
3950 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
3951 @headitem de función @tab de vector @tab salto @tab salto @tab salto
3953 @item @code{all-visible} @tab @code{#(#t #t #t)} @tab sí @tab sí @tab sí
3954 @item @code{begin-of-line-visible} @tab @code{#(#f #f #t)} @tab no @tab no @tab sí
3955 @item @code{center-visible} @tab @code{#(#f #t #f)} @tab no @tab sí @tab no
3956 @item @code{end-of-line-visible} @tab @code{#(#t #f #f)} @tab sí @tab no @tab no
3957 @item @code{begin-of-line-invisible} @tab @code{#(#t #t #f)} @tab sí @tab sí @tab no
3958 @item @code{center-invisible} @tab @code{#(#t #f #t)} @tab sí @tab no @tab sí
3959 @item @code{end-of-line-invisible} @tab @code{#(#f #t #t)} @tab no @tab sí @tab sí
3960 @item @code{all-invisible} @tab @code{#(#f #f #f)} @tab no @tab no @tab no
3963 Los ajustes predeterminados de @code{break-visibility} dependen
3964 del objeto de presentación. La tabla siguiente muestra todos los
3965 objetos de presentación de interés que resultan afectados por
3966 @code{break-visibility} y el ajuste predeterminado de esta
3969 @multitable @columnfractions .3 .3 .4
3971 @headitem Objeto @tab Contexto usual @tab Valor predet.
3973 @c omit Ambitus as it appears not to be affected by break-visibility -td
3974 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
3975 @item @code{BarLine} @tab @code{Score} @tab calculado
3976 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
3977 @c omit the following item until it can be explained -td
3978 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
3979 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3980 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
3981 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
3982 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3983 @item @code{KeyCancellation} @tab @code{Staff} @tab @code{begin-of-line-invisible}
3984 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
3985 @c omit LeftEdge until it can be explained -td
3986 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
3987 @item @code{ClefModifier} @tab @code{Staff} @tab @code{begin-of-line-visible}
3988 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
3989 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
3993 El ejemplo de abajo muestra el uso de la forma de vector para
3994 controlar la visibilidad de las líneas divisorias:
3996 @lilypond[quote,verbatim,ragged-right]
4000 % Remove bar line at the end of the current line
4001 \once \override Score.BarLine.break-visibility = ##(#f #t #t)
4008 Aunque los tres componentes del vector utilizado para
4009 sobreescribir @code{break-visibility} deben estar presentes, no
4010 todos son efectivos para todos los objetos de presentación, y
4011 algunas combinaciones pueden incluso dar errores. Son de
4012 aplicación las siguientes limitaciones:
4016 Las líneas divisorias no se pueden imprimir al principio de la línea.
4019 No se puede imprimir el número de compás al principio de la
4020 @emph{primera} línea a no ser que su valor establecido sea
4021 distinto de @code{1}.
4023 @item Clave: véase la sección siguiente.
4026 Las repeticiones dobles de tipo porcentaje se imprimen todas
4027 siempre o bien no se imprimen nunca. Utilice @code{begin-of
4028 line-invisible} para imprimirlas y @code{all-invisible} para
4031 @item Armadura: véase la sección siguiente.
4033 @item ClefModifier: véase la sección siguiente.
4037 @node Consideraciones especiales
4038 @unnumberedsubsubsec Consideraciones especiales
4039 @translationof Special considerations
4041 @subsubsubheading Visibilidad después de un cambio explícito
4043 @cindex armadura, visibilidad después de un cambio explícito
4044 @cindex explicitKeySignatureVisibility
4045 @cindex clave, visibilidad después de un cambio explícito
4046 @cindex explicitClefVisibility
4048 La propiedad @code{break-visibility} controla la visibilidad de
4049 las armaduras y cambios de clave sólo al principio de las líneas,
4050 es decir, después de un salto. No tiene ningún efecto sobre la
4051 visibilidad de la armadura o la clave después de un cambio
4052 explícito de tonalidad o de clave dentro o al final de una línea.
4053 En el ejemplo siguiente la armadura que sigue al cambio explícito
4054 de tonalidad a Si bemol mayor es visible incluso con
4055 @code{all-invisible} establecido.
4057 @lilypond[quote,verbatim,ragged-right]
4061 % Try to remove all key signatures
4062 \override Staff.KeySignature.break-visibility = #all-invisible
4071 La visibilidad de estos cambios explícitos de tonalidad y de clave
4072 se controla por medio de las propiedades
4073 @code{explicitKeySignatureVisibility} y
4074 @code{explicitClefVisibility}. Son los equivalentes de la
4075 propiedad @code{break-visibility} y las dos toman un vector de
4076 tres valores booleanos o las funciones predefinidas relacionadas
4077 anteriormente, exactamente igual que @code{break-visibility}. Las
4078 dos son propiedades del contexto Staff, no de los propios objetos
4079 de presentación, y por tanto se establecen utilizando la
4080 instrucción @code{\set}. Las dos están establecidas de forma
4081 predeterminada al valor @code{all-visible}. Estas propiedades
4082 controlan sólo la visibilidad de las armaduras y las claves que
4083 resultan de los cambios explícitos y no afectan a las armaduras y
4084 tonalidades que están al principio de las líneas; para quitarlas,
4085 aún se debe sobreescribir la propiedad @code{break-visibility} en
4086 el objeto correspondiente.
4088 @lilypond[quote,verbatim,ragged-right]
4092 \set Staff.explicitKeySignatureVisibility = #all-invisible
4093 \override Staff.KeySignature.break-visibility = #all-invisible
4101 @subsubsubheading Visibilidad de las alteraciones de precaución
4103 Para eliminar las alteraciones de cancelación que se imprimen en
4104 un cambio de tonalidad explícito, establezca la propiedad
4105 @code{printKeyCancellation} del contexto Staff a @code{#f}:
4107 @lilypond[quote,verbatim,ragged-right]
4111 \set Staff.explicitKeySignatureVisibility = #all-invisible
4112 \set Staff.printKeyCancellation = ##f
4113 \override Staff.KeySignature.break-visibility = #all-invisible
4121 Con estas sobreescrituras solamente permanecen las alteraciones
4122 accidentales delante de las notas para indicar el cambio de
4125 Observe que al modificar la tonalidad a Do@tie{}mayor o
4126 La@tie{}menor, las alteraciones de cancelación serían @emph{la
4127 única} indicación del cambio de armadura. En este caso, el
4128 establecimiento de @code{printKeyCancellation} al valor @code{#f}
4129 no tiene ningún efecto:
4131 @lilypond[quote,verbatim,ragged-right]
4135 \set Staff.explicitKeySignatureVisibility = #all-invisible
4136 \set Staff.printKeyCancellation = ##f
4144 En lugar de ello, para suprimir las alteraciones de cancelación
4145 aún cuando la armadura cambia a Do@tie{}mayor o a La@tie{}menor,
4146 sobreescriba la visibilidad del grob @code{KeyCancellation}:
4148 @lilypond[quote,verbatim,ragged-right]
4152 \set Staff.explicitKeySignatureVisibility = #all-invisible
4153 \override Staff.KeyCancellation.break-visibility = #all-invisible
4161 @c TODO Add visibility of cautionary accidentals before notes
4163 @subsubsubheading Líneas divisorias automáticas
4165 @cindex automaticBars
4166 @cindex líneas divisorias, eliminación
4168 Como caso especial, la impresión de las líneas divisorias también
4169 se puede inhabilitar estableciendo la propiedad
4170 @code{automaticBars} en el contexto Score. Si se fija a
4171 @code{#f}, las barras de compás no se imprimen automáticamente; se
4172 deben crear explícitamente con una instrucción @code{\bar}. A
4173 diferencia de la instrucción predefinida @code{\cadenzaOn}, los
4174 compases se siguen contando. La generación de compases continúa
4175 de acuerdo a esta cuenta si esta propiedad se establece
4176 posteriormente a @code{#t}. Si se fija al valor @code{#f}, sólo
4177 pueden producirse saltos de línea en instrucciones @code{\bar}
4182 @subsubsubheading Claves transportadas
4184 @cindex transportadas, visibilidad de las claves
4185 @cindex visibilidad de las claves transportadas
4186 @cindex claves, visibilidad de la transposición
4188 El pequeño símbolo de transposición sobre una clave se produce por
4189 parte del objeto @code{ClefModifier}. Su visibilidad se hereda
4190 automáticamente de la del objeto @code{Clef}, así que no es
4191 necesario aplicar las sobreescrituras correspondientes
4192 @code{break-visibility} a los objetos @code{ClefModifier} para
4193 suprimir los símbolos de transposición u octavación para las
4196 Para los cambios de clave explícitos, la propiedad
4197 @code{explicitClefVisibility} controla tanto el símbolo de clave
4198 como el símbolo de transposición o de octava asociado.
4201 Manual de aprendizaje:
4202 @rlearning{Visibilidad y color de los objetos}
4205 @node Estilos de línea
4206 @subsection Estilos de línea
4207 @translationof Line styles
4209 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
4210 @i{accelerando} y los @i{trinos} se escriben como texto y se
4211 extienden sobre muchos compases mediante líneas, a veces punteadas
4214 Todos ellos usan las mismas rutinas que el glissando para dibujar
4215 los textos y las líneas, y por ello el ajuste fino de su
4216 comportamiento se hace de la misma manera. Se hace con un spanner
4217 (un objeto de extensión), y la rutina responsable de dibujar los
4218 objetos de extensión es @code{ly:line-spanner::print}. Esta rutina
4219 determina la colocación exacta de los dos @i{extremos del objeto
4220 de extensión} y dibuja una línea entre ellos, en el estilo
4223 He aquí un ejemplo de los distintos estilos de línea disponibles,
4224 y cómo aplicarles ajustes finos.
4226 @lilypond[ragged-right,verbatim,quote]
4229 \once \override Glissando.style = #'dashed-line
4231 \override Glissando.style = #'dotted-line
4233 \override Glissando.style = #'zigzag
4235 \override Glissando.style = #'trill
4240 Las posiciones de los puntos extremos del objeto de extensión se
4241 computan al vuelo para cada uno de los objetos gráficos, pero es
4242 posible sobreescribirlos:
4245 @lilypond[ragged-right,verbatim,quote]
4248 \once \override Glissando.bound-details.right.Y = #-2
4253 El valor de @code{Y} está establecido a @w{@code{-2}} para el
4254 extremo derecho. El lado izquierdo se puede ajustar de forma
4255 similar especificando @code{left} en vez de @code{right}.
4257 Si no está establecido @code{Y}, el valor se computa a partir de la
4258 posición vertical de los puntos de anclaje izquierdo y derecho del
4261 Son posibles otros ajustes de los extensores, para ver más
4262 detalles consulte @ref{Objetos de extensión}.
4265 @node Rotación de objetos
4266 @subsection Rotación de objetos
4267 @translationof Rotating objects
4269 Tanto los objetos de presentación como los elementos de texto de
4270 marcado se pueden girar cualquier ángulo respecto a cualquier
4271 punto, pero difiere el método de hacerlo.
4274 * Rotación de objetos de presentación::
4275 * Rotación de elementos de marcado::
4278 @node Rotación de objetos de presentación
4279 @unnumberedsubsubsec Rotación de objetos de presentación
4280 @translationof Rotating layout objects
4282 @cindex rotating objects
4283 @cindex objects, rotating
4285 Todos los objetos de presentación que contemplan el interface
4286 @code{grob-interface} se pueden rotar estableciendo su propiedad
4287 @code{rotation}. Acepta una lista de tres elementos: el ángulo de
4288 la rotación en sentido antihorario, y las coordenadas x e y del
4289 punto con relación al punto de referencia del objeto, alrededor
4290 del que se va a realizar la rotación. El ángulo de rotación se
4291 especifica en grados y las coordenadas en espacios de pentagrama.
4293 El ángulo de rotación y las coordenadas del punto de rotación se
4294 deben determinar por ensayo y error.
4296 @cindex reguladores en ángulo
4297 @cindex ángulo, reguladores en
4299 Solamente en ciertas ocasiones es útil la rotación de objetos de
4300 presentación; el ejemplo siguiente muestra una situación en que
4303 @lilypond[quote,fragment,verbatim]
4305 \override Hairpin.rotation = #'(20 -1 0)
4310 @node Rotación de elementos de marcado
4311 @unnumberedsubsubsec Rotación de elementos de marcado
4312 @translationof Rotating markup
4314 Todos los textos de marcado se pueden rotar para que se dispongan
4315 en cualquier ángulo precediéndolos de la instrucción
4316 @code{\rotate}. La instrucción acepta dos argumentos: el ángulo
4317 de rotación en grados en sentido antihorario, y el texto que
4318 rotar. Los límites que ocupa el texto no se rotan: toman su valor
4319 a partir de los extremos de las coordenadas x e y del texto
4320 rotado. En el ejemplo siguiente la propiedad
4321 @code{outside-staff-priority} del texto se establece a @code{#f}
4322 para desactivar la evitación automática de colisiones, lo que
4323 empuja al texto a una posición muy alta.
4325 @lilypond[quote,fragment,verbatim]
4326 \override TextScript.outside-staff-priority = ##f
4327 g4^\markup { \rotate #30 "a G" }
4328 b^\markup { \rotate #30 "a B" }
4329 des'^\markup { \rotate #30 "a D-Flat" }
4330 fis'^\markup { \rotate #30 "an F-Sharp" }
4334 @node Trucos avanzados
4335 @section Trucos avanzados
4336 @translationof Advanced tweaks
4338 Esta sección trata sobre distintos enfoques en la realización de
4339 ajustes finos a la apariencia de la partitura impresa.
4342 * Alineación de objetos::
4343 * Agrupación vertical de objetos gráficos::
4344 * Modificación de los sellos::
4345 * Modificación de las formas::
4346 * Modificación de objetos de extensión divididos::
4347 * Contenedores unpure-pure::
4351 Manual de aprendizaje:
4352 @rlearning{Trucar la salida},
4353 @rlearning{Otras fuentes de información}.
4355 Referencia de la notación:
4356 @ref{Explicación del Manual de referencia de funcionamiento interno},
4357 @ref{Modificar las propiedades}.
4359 Manual de extensión:
4360 @rextend{Interfaces para programadores}.
4363 @file{scm/define-grobs.scm}.
4365 Fragmentos de código:
4366 @rlsr{Tweaks and overrides}.
4368 Referencia de funcionamiento interno:
4369 @rinternals{All layout objects}.
4372 @node Alineación de objetos
4373 @subsection Alineación de objetos
4374 @translationof Aligning objects
4376 Los objetos gráficos que soportan el interface
4377 @code{self-alignment-interface} y/o el
4378 @code{side-position-interface} se pueden alinear contra un objeto
4379 colocado previamente, de diversas maneras. Para ver una lista de
4380 estos objetos, consulte @rinternals{self-alignment-interface} y
4381 @rinternals{side-position-interface}.
4383 Todos los objetos gráficos tienen un punto de referencia, una
4384 extensión horizontal y una extensión vertical. La extensión
4385 horizontal es una pareja de números que dan los desplazamientos a
4386 partir del punto de referencia de los bordes izquierdo y derecho,
4387 siendo negativos los desplazamientos hacia la izquierda. La
4388 extensión vertical es una pareja de números que dan el
4389 desplazamiento a partir del punto de referencia hasta los bordes
4390 inferior y superior, siendo negativos los desplazamientos hacia
4393 La posición de un objeto sobre el pentagrama viene dada por los
4394 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
4395 valor de @code{X-offset} da el desplazamiento desde la coordenada
4396 X del punto de referencia del objeto padre, y el valor de
4397 @code{Y-offset} da el desplazamiento a partir de la línea central
4398 del pentagrama. Los valores de @code{X-offset} y @code{Y-offset}
4399 se pueden establecer directamente o se puede dejar que se calculen
4400 por parte de procedimientos para conseguir una alineación con el
4403 @warning{Muchos objetos tienen consideraciones de posicionamiento
4404 especiales que hacen que se ignore o se modifique cualquier ajuste
4405 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
4406 objeto contemple el interface @code{self-alignment-interface}. La
4407 sobreescritura de las propiedades @code{X-offset} ó
4408 @code{Y-offset} a un valor fijo hace que se descarte la respectiva
4409 propiedad @code{self-alignment}.}
4411 Por ejemplo, una alteración accidental se puede reposicionar
4412 verticalmente estableciendo @code{Y-offset} pero los cambios a
4413 @code{X-offset} no tienen ningún efecto.
4415 Las letras de ensayo se pueden alinear con objetos divisibles como
4416 líneas divisorias, claves, armaduras e indicaciones de compás.
4417 Hay propiedades especiales que se encuentran en
4418 @code{break-aligned-interface} para el posicionamiento de las
4419 letras de ensayo sobre dichos objetos.
4422 Referencia de la notación:
4423 @ref{Uso del break-alignable-interface}.
4425 Manual de extensión:
4426 @rextend{Funciones de callback}.
4429 * Establecer directamente X-offset e Y-offset::
4430 * Uso del side-position-interface::
4431 * Uso del self-alignment-interface::
4432 * Uso del break-alignable-interface::
4436 @node Establecer directamente X-offset e Y-offset
4437 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
4438 @translationof Setting X-offset and Y-offset directly
4440 Se pueden dar valores numéricos a las propiedades @code{X-offset}
4441 y @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra
4442 tres notas con una digitación en su posición predeterminada y con
4443 los valores @code{X-offset} y @code{Y-offset} modificados.
4445 @lilypond[verbatim,fragment,quote]
4452 -\tweak X-offset #-1
4460 @node Uso del side-position-interface
4461 @unnumberedsubsubsec Uso del @code{side-position-interface}
4462 @translationof Using the side-position-interface
4464 Un objeto que contempla el @code{side-position-interface} se puede
4465 colocar junto a su objeto padre de forma que los bordes
4466 especificados de los dos objetos se toquen. El objeto se puede
4467 situar encima, debajo, a la derecha o a la izquierda del objeto
4468 padre. El padre no se puede especificar; viene determinado por el
4469 orden de los elementos en el flujo de entrada. Casi todos los
4470 objetos tienen la cabeza de la nota asociada como padre.
4472 Los valores de las propiedades @code{side-axis} y @code{direction}
4473 determinan dónde colocar el objeto, como sigue:
4475 @c TODO add an example of each to the table
4477 @multitable @columnfractions .3 .3 .3
4478 @headitem @code{side-axis} @tab @code{direction} @tab
4479 @headitem propiedad @tab propiedad @tab colocación
4481 @item @code{0} @tab @w{@code{-1}} @tab izquierda
4482 @item @code{0} @tab @code{1} @tab derecha
4483 @item @code{1} @tab @w{@code{-1}} @tab debajo
4484 @item @code{1} @tab @code{1} @tab encima
4488 Si @code{side-axis} es @code{0}, @code{X-offset} se debe
4489 establecer al procedimiento
4490 @code{ly:side-position-interface::x-aligned-side}. Este
4491 procedimiento devuelve el calor correcto de @code{X-offset} para
4492 situar el objeto al lado izquierdo o derecho del padre de acuerdo
4493 con el valor de @code{direction}.
4495 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe
4496 establecer al procedimiento
4497 @code{ly:side-position-interface::y-aligned-side}. Este
4498 procedimiento devuelve el valor correcto de @code{Y-offset} para
4499 situar el objeto encima o debajo del padre de acuerdo con el valor
4500 de @code{direction}.
4502 @c TODO Add examples
4505 @node Uso del self-alignment-interface
4506 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
4507 @translationof Using the self-alignment-interface
4509 @subsubsubheading Auto-alineación horizontal de los objetos
4511 La alineación horizontal de un objeto que contempla el interface
4512 @code{self-alignment-interface} está controlada por el valor de la
4513 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
4514 @code{X-offset} de este objeto esté establecida a
4515 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le
4516 puede dar a @code{self-alignment-X} cualquier valor real, en
4517 unidades de la mitad de la extensión X total del objeto. Los
4518 valores negativos mueven el objeto a la derecha, los positivos
4519 hacia la izquierda. Un valor de @code{0} centra el objeto sobre
4520 el punto de referencia de su padre, un valor de @w{@code{-1}}
4521 alinea el borde izquierdo del objeto sobre el punto de referencia
4522 de su padre, y un valor de @code{1} alinea el borde derecho del
4523 objeto sobre el punto de referencia de su padre. Se pueden usar
4524 los símbolos @code{LEFT}, @code{CENTER} y @code{RIGHT} en
4525 sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
4528 Normalmente se usaría la instrucción @code{\override} para
4529 modificar el valor de @code{self-alignment-X}, pero se puede usar
4530 la instrucción @code{\tweak} para alinear varias anotaciones por
4531 separado sobre una sola nota:
4533 @lilypond[quote,verbatim,fragment]
4535 -\tweak self-alignment-X #-1
4537 -\tweak self-alignment-X #0
4539 -\tweak self-alignment-X #RIGHT
4541 -\tweak self-alignment-X #-2.5
4542 ^"aligned further to the right"
4545 @subsubsubheading Auto-alineación vertical de los objetos
4547 Los objetos se pueden alinear verticalmente en una forma análoga a la
4548 alineación horizontal si la propiedad @code{Y-offset} está establecida
4549 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
4550 a menudo se encuentran implicados otros mecanismos en la alineación
4551 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
4552 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
4553 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
4554 las dimensiones verticales del objeto, que suele ser bastante pequeño,
4555 por lo que pueden requerirse números bastante grandes. Un valor de
4556 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
4557 referencia del objeto padre, un valor de @code{0} alinea el centro del
4558 objeto con el punto de referencia del padre, y un valor de @code{1}
4559 alinea el borde superior del objeto con el punto de referencia del
4560 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
4561 @code{UP} en sustitución de @w{@code{-1}},
4562 @code{0} y @code{1}, respectivamente.
4564 @emph{Auto-alineación de objetos en las dos direcciones}
4566 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
4567 alinear un objeto en las dos direcciones simultáneamente.
4569 El ejemplo siguiente muestra cómo ajustar una digitación de forma
4570 que se acerque a la cabeza dela nota.
4572 @lilypond[quote,verbatim,fragment]
4574 -\tweak self-alignment-X #0.5 % move horizontally left
4575 -\tweak Y-offset #ly:self-alignment-interface::y-aligned-on-self
4576 -\tweak self-alignment-Y #-1 % move vertically up
4581 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
4583 @c Cannot document as they do not seem to operate consistently on all objects -td
4584 @c TODO investigate further
4586 The @code{aligned-on-parent} procedures are used in the same way
4587 as the @code{aligned-on-self} procedures, they difference being
4588 that they permit an object to be aligned with the @emph{edges} of
4589 the parent rather than the parent's reference point. The following
4590 example shows the difference:
4594 @lilypond[verbatim,quote]
4600 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
4602 @c Cannot document as they do not seem to operate consistently on all objects -td
4603 @c TODO investigate further
4607 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
4610 @node Uso del break-alignable-interface
4611 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
4612 @translationof Using the break-alignable-interface
4614 @cindex alineación a objetos
4615 @cindex break-align-symbols
4617 Las letras de ensayo se pueden alinear con objetos de notación
4618 distintos a las barras de compás. Estos objetos son
4619 @code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
4620 @code{staff-bar}, @code{left-edge}, @code{key-cancellation},
4621 @code{key-signature} y @code{time-signature}.
4623 Cada tipo de objeto tiene su propio punto de referencia
4624 predeterminado, con el que se alinean las marcas de ensayo:
4626 @lilypond[verbatim,quote,fragment]
4627 % The rehearsal mark will be aligned to the right edge of the Clef
4628 \override Score.RehearsalMark.break-align-symbols = #'(clef)
4633 % The rehearsal mark will be aligned to the left edge of the Time Signature
4634 \override Score.RehearsalMark.break-align-symbols = #'(time-signature)
4640 % The rehearsal mark will be centered above the Breath Mark
4641 \override Score.RehearsalMark.break-align-symbols = #'(breathing-sign)
4650 Se puede especificar una lista de posibles objetos para la
4651 alineación. Si algunos de los objetos son invisibles en ese punto
4652 debido al valor de @code{break-visibility} o a valores de
4653 visibilidad explícitos para las armaduras y las claves, la letra
4654 de ensayo o número de compás se alinean con el primer objeto de la
4655 lista que sea visible. Si ningún objeto de la lista es visible,
4656 el objeto se alinea con la línea divisoria. Si la línea divisoria
4657 es invisible, el objeto se alinea con el punto en el que se
4658 encontraría la línea divisoria.
4660 @lilypond[verbatim,quote,fragment]
4661 % The rehearsal mark will be aligned to the right edge of the Key Signature
4662 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4667 % The rehearsal mark will be aligned to the right edge of the Clef
4668 \set Staff.explicitKeySignatureVisibility = #all-invisible
4669 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4674 % The rehearsal mark will be centered above the Bar Line
4675 \set Staff.explicitKeySignatureVisibility = #all-invisible
4676 \set Staff.explicitClefVisibility = #all-invisible
4677 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4684 La alineación de la letra de ensayo con relación al objeto de
4685 notación se puede cambiar, como se ve en el ejemplo siguiente. En
4686 una partitura con varios pentagramas, este ajuste se debe hacer
4687 para todos los pentagramas.
4689 @lilypond[verbatim,quote,fragment]
4690 % The RehearsalMark will be aligned with the right edge of the Key Signature
4691 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4697 % The RehearsalMark will be centered above the Key Signature
4698 \once \override Score.KeySignature.break-align-anchor-alignment = #CENTER
4702 % The RehearsalMark will be aligned with the left edge of the Key Signature
4703 \once \override Score.KeySignature.break-align-anchor-alignment = #LEFT
4709 La letra de ensayo también se puede desplazar al borde derecho o
4710 izquierdo en una medida arbitraria. Las unidades son espacios de
4713 @lilypond[verbatim,quote,fragment]
4714 % The RehearsalMark will be aligned with the left edge of the Key Signature
4715 % and then shifted right by 3.5 staff-spaces
4716 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4717 \once \override Score.KeySignature.break-align-anchor = #3.5
4721 % The RehearsalMark will be aligned with the left edge of the Key Signature
4722 % and then shifted left by 2 staff-spaces
4723 \once \override Score.KeySignature.break-align-anchor = #-2
4730 @node Agrupación vertical de objetos gráficos
4731 @subsection Agrupación vertical de objetos gráficos
4732 @translationof Vertical grouping of grobs
4734 @c TODO Expand this section
4736 Los grobs (objetos gráficos) @code{VerticalAlignment} y
4737 @code{VerticalAxisGroup} trabajan de manera coordinada.
4738 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
4739 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
4740 distintos grobs agrupados previamente por
4741 @code{VerticalAxisGroup}. Normalmente sólo existe un
4742 @code{VerticalAlignment} por cada partitura, pero cada
4743 @code{Staff}, @code{Lyrics}, etc. tiene su propio
4744 @code{VerticalAxisGroup}.
4747 @node Modificación de los sellos
4748 @subsection Modificación de los sellos
4749 @translationof Modifying stencils
4751 Todos los objetos de presentación tienen una propiedad
4752 @code{stencil} que es parte del @code{grob-interface}. De forma
4753 predeterminada, esta propiedad suele estar establecida a una
4754 función específica del objeto que está hecha a medida para
4755 disponer el símbolo que lo representa en la salida. Por ejemplo,
4756 el ajuste estándar para la propiedad @code{stencil} del objeto
4757 @code{MultiMeasureRest} es @code{ly:multi-measure-rest::print}.
4759 El símbolo estándar de cualquier objeto se puede sustituir
4760 modificando la propiedad @code{stencil} para que haga referencia a
4761 un procedimiento diferente escrito especialmente. Esto requiere
4762 un alto nivel de conocimiento del funcionamiento interno de
4763 LilyPond, pero hay una forma más fácil que a menudo puede dar
4764 resultados adecuados.
4766 El procedimiento es establecer la propiedad @code{stencil} al
4767 procedimiento que imprime texto (@code{ly:text-interface::print})
4768 y añadir una propiedad @code{text} al objeto ajustada para que
4769 contenga el texto de marcado que produce el símbolo requerido.
4770 Debido a la flexibilidad del marcado, se pueden conseguir muchas
4771 cosas; en particular, consulte @ref{Notación gráfica dentro de
4772 elementos de marcado}.
4774 El ejemplo siguiente muestra esto cambiando el símbolo de la
4775 cabeza de la nota a unas aspas dentro de una circunferencia.
4777 @lilypond[verbatim,quote]
4779 \once \override NoteHead.stencil = #ly:text-interface::print
4780 \once \override NoteHead.text = \markup {
4782 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
4783 \musicglyph #"noteheads.s2cross"
4791 Cualquiera de los glifos de @emph{Feta} usados en la fuente tipográfica Emmentaler se puede
4792 pasar a la instrucción de marcado @code{\musicglyph}: véase
4793 @ref{La tipografía Emmentaler}.
4795 Se pueden insertar en línea tanto imágenes en formato @file{EPS}
4796 como instrucciones de Postscript usando las instrucciones de
4797 marcado @code{\epsfile} y @code{\postscript} respectivamente;
4798 véase @ref{Graphic}.
4802 Referencia de la notación:
4803 @ref{Notación gráfica dentro de elementos de marcado},
4804 @ref{Formatear el texto},
4805 @ref{Text markup commands},
4806 @ref{La tipografía Emmentaler},
4810 @node Modificación de las formas
4811 @subsection Modificación de las formas
4812 @translationof Modifying shapes
4815 * Modificación de ligaduras de unión y de expresión::
4819 @node Modificación de ligaduras de unión y de expresión
4820 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
4821 @translationof Modifying ties and slurs
4823 @cindex ligaduras de expresión, modificar
4824 @cindex ligaduras de unión, modificar
4825 @cindex Bézier, curvas de, puntos de control
4826 @cindex puntos de control en curvas de Bézier
4828 Las ligaduras de unión (@code{Tie}s), de expresión (@code{Slur}s),
4829 de fraseo (@code{PhrasingSlur}s), de dejar vibrar
4830 (@code{LaissezVibrerTie}s) y de repetición (@code{RepeatTie}s) se
4831 trazan como curvas de Bézier de tercer orden. Si la forma de la
4832 ligadura calculada automáticamente no resulta óptima, se puede
4833 modificar su forma manualmente de dos formas:
4837 mediante la especificación de los desplazamientos que se quieren
4838 realizar sobre los puntos de control de la curva de Bézier
4839 calculada automáticamente, o bien
4842 mediante la especificación explícita de las posiciones de los
4843 cuatro puntos de control que se requieren para definir la curva
4847 A continuación se explican ambos métodos. El primer método es más
4848 adecuado cuando solo se requieren ligeros ajustes de la curva; el
4849 segundo puede ser mejor para crear curvas que tienen relación con
4852 @subsubsubheading Curvas de Bézier cúbicas
4854 Las curvas Bézier de tercer orden o cúbicas están definidas por
4855 cuatro puntos de control. El primer y cuarto puntos de control
4856 son exactamente los puntos extremos de comienzo y de final de la
4857 curva. Los dos puntos de control intermedios definen la forma.
4858 Se pueden encontrar en la web animaciones que muestran cómo se
4859 traza la curva, pero la descripción siguiente puede ser de ayuda.
4860 La curva comienza a partir del primer punto de control
4861 dirigiéndose directamente hacia el segundo, curvándose
4862 progresivamente para dirigirse hacia el tercero y continuando la
4863 curva hacia el cuarto, llegando a éste en viaje directo desde el
4864 tercer punto de control. La curva está contenida enteramente
4865 dentro del cuadrilátero definido por los cuatro puntos de control.
4866 Todas las traslaciones, rotaciones y escalado de los puntos de
4867 control producen exactamente las mismas operaciones sobre la
4870 @subsubsubheading Especificar desplazamientos a partir de los puntos de control actuales
4872 @cindex conformar ligaduras
4875 En este ejemplo, la colocación automática de la ligadura no
4876 resulta óptima, y @code{\tieDown} no es la solución.
4878 @lilypond[verbatim,quote]
4882 \relative { r4 <g' c,> <g c,> <g c,> }
4886 El ajuste de los puntos de control de la ligadura mediante la
4887 instrucción @code{\shape} permite evitar las colisiones.
4889 La sintaxis de @code{\shape} es:
4892 [-]\shape @var{desplazamientos} @var{elemento}
4895 Esta instrucción recoloca los puntos de control de @var{elemento}
4896 en las cantidades dadas por @var{desplazamientos}. El argumento
4897 @var{desplazamientos} es una lista de parejas de números o una
4898 lista de tales listas. Cada elemento de una pareja representa el
4899 desplazamiento de una de las coordenadas de un punto de control.
4900 Si el @var{elemento} es una cadena de caracteres, el resultado es
4901 @code{\once\override} para el tipo de grob especificado. Si
4902 @var{elemento} es una expresión musical, el resultado es la misma
4903 expresión musical con la consiguiente modificación aplicada.
4905 En otras palabras, la función @code{\shape} puede actuar como una
4906 instrucción @code{\once\override} o como una instrucción
4907 @code{\tweak} dependiendo de si el argumento @var{elemento} es el
4908 nombre de un grob, como @qq{Slur}, o una expresión musical, como
4909 @qq{(}. El argumento @var{desplazamientos} especifica los
4910 desplazamientos de los cuatro puntos de control como una lista de
4911 cuatro parejas de valores (dx . dy) en unidades de espacios de
4912 pentagrama (o una lista de tales listas si la curva tiene más de
4915 El guión precedente se exige si, y sólo si, se usa la forma
4918 Así, usando el mismo ejemplo de arriba y la forma
4919 @code{\once\override} de la instrucción @code{\shape}, lo
4920 siguiente tiene el efecto de elevar la ligadura de unión en la
4921 mitad de un espacio de pentagrama:
4923 @lilypond[verbatim,quote]
4926 \shape #'((0 . 0.5) (0 . 0.5) (0 . 0.5) (0 . 0.5)) Tie
4930 \relative { r4 <g' c,> <g c,> <g c,> }
4934 Este posicionamiento de la ligadura de unión es mejor, pero quizá
4935 debería elevarse más en la parte central. El ejemplo siguiente
4936 hace esto, esta vez usando la forma alternativa @code{\tweak}:
4938 @lilypond[verbatim,quote]
4941 e'1-\shape #'((0 . 0.5) (0 . 1) (0 . 1) (0 . 0.5)) ~ e'
4944 \relative { r4 <g' c,> <g c,> <g c,> }
4948 Los cambios en las posiciones horizontales de los puntos de
4949 control se pueden hacer de la misma forma, y dos curvas distintas
4950 que dan comienzo en el mismo momento musical se pueden conformar
4953 @lilypond[verbatim,quote,ragged-right]
4955 c''8(\( a) a'4 e c\)
4956 \shape #'((0.7 . -0.4) (0.5 . -0.4) (0.3 . -0.3) (0 . -0.2)) Slur
4957 \shape #'((0 . 0) (0 . 0.5) (0 . 0.5) (0 . 0)) PhrasingSlur
4962 La función @code{\shape} también puede desplazar los puntos de
4963 control de las curvas que se extienden atravesando saltos de
4964 línea. Cada pieza de la curva dividida puede recibir su propia
4965 lista de desplazamientos. Si no se necesita hacer cambios a uno
4966 de los segmentos en particular, se puede usar una lista vacía como
4967 contenedor. En este ejemplo, el salto de línea hace que la única
4968 ligadura de expresión aparezca como si fueran dos:
4970 @lilypond[verbatim,quote,ragged-right]
4978 Los cambios en la forma de las dos mitades de la ligadura de
4979 expresión deja más claro que la ligadura continúa más allá del
4982 @lilypond[verbatim,quote,ragged-right]
4983 % () may be used as a shorthand for ((0 . 0) (0 . 0) (0 . 0) (0 . 0))
4984 % if any of the segments does not need to be changed
4987 (( 0 . 0) (0 . 0) (0 . 0) (0 . 1))
4988 ((0.5 . 1.5) (1 . 0) (0 . 0) (0 . -1.5))
4996 En una curva en forma de «S» siempre es necesario ajustar
4997 manualmente los puntos de control: LilyPond nunca escoge tales
4998 formas automáticamente.
5000 @lilypond[verbatim,quote]
5002 c8( e b-> f d' a e-> g)
5003 \shape #'((0 . -1) (5.5 . -0.5) (-5.5 . -10.5) (0 . -5.5)) PhrasingSlur
5004 c8\( e b-> f d' a e-> g\)
5008 @subsubsubheading Especificar los puntos de control explícitamente
5010 Las coordenadas de los puntos de contro de Bézier se especifican
5011 en unidades de espacios de pentagrama. La coordenada@tie{}X es
5012 relativa al punto de referencia al que se adjunta la ligadura, y
5013 la coordenada@tie{}Y es relativa a la línea central del
5014 pentagrama. Las coordenadas se especifican como una lista de
5015 cuatro parejas de números decimales (reales). Un enfoque consiste
5016 en estimar las coordenadas de los dos extremos, y después adivinar
5017 los dos puntos intermedios. Los valores óptimos se encuentran
5018 después por ensayo y error. Tenga en cuenta que estos valores
5019 podrían requerir un ajuste manual si se hace posteriormente
5020 cualquier cambio manual a la música o a la disposición.
5022 Una situación en la que es preferible especificar los puntos de
5023 control explícitamente a especificar los desplazamientos es cuando
5024 se necesita especificarlos de forma relativa a una nota única. A
5025 continuación presentamos un ejemplo de esto. Muestra una forma de
5026 indicar una ligadura que se extiende hacia el interior de las
5027 casillas de primera y segunda vez de una repetición.
5029 @lilypond[verbatim,quote]
5032 \repeat volta 3 { c4 d( e f }
5037 % create a slur and move it to a new position
5038 % the <> is just an empty chord to carry the slur termination
5039 -\tweak control-points #'((-2 . 3.8) (-1 . 3.9) (0 . 4) (1 . 3.4)) ( <> )
5044 % create a slur and move it to a new position
5045 -\tweak control-points #'((-2 . 3) (-1 . 3.1) (0 . 3.2) (1 . 2.4)) ( <> )
5053 No es posible modificar la forma de las ligaduras de unión o de
5054 expresión cambiando la propiedad @code{control-points} si hay más
5055 de una en el mismo momento musical, ni siquiera usando la
5056 instrucción @code{\tweak}. Sin embargo, se puede sobreescribir la
5057 propiedad @code{tie-configuration} de @code{TieColumn} para fijar
5058 la línea de inicio y la dirección según se requiera.
5061 Referencia de funcionamiento interno:
5062 @rinternals{TieColumn}.
5065 @node Modificación de objetos de extensión divididos
5066 @subsection Modificación de objetos de extensión divididos
5067 @translationof Modifying broken spanners
5070 * Uso de alterBroken::
5073 @node Uso de alterBroken
5074 @unnumberedsubsubsec Uso de @code{\alterBroken}
5075 @translationof Using alterBroken
5077 @cindex extensión, modificación de objetos de
5078 @cindex divididos, modificación de objetos de extensión
5079 @funindex \alterBroken
5081 Cuando un @qq{spanner} u objeto extenso atraviesa uno o varios
5082 saltos de línea, cada fragmento hereda los atributos del objeto de
5083 extensión original. Así, el trucado ordinario de un objeto
5084 dividido aplica las mismas modificaciones a todos y cada uno de
5085 sus segmentos. En el ejemplo que aparece a continuación, la
5086 sobreescritura de @code{thickness} (grosor) afecta a la ligadura a
5087 ambos lados del salto de línea.
5089 @lilypond[verbatim,quote,ragged-right]
5092 \once\override Slur.thickness = 10
5099 Es posible modificar de forma independiente el aspecto de los
5100 fragmentos individuales de un objeto de extensión dividido, con la
5101 instrucción @code{\alterBroken}. Esta instrucción puede producir
5102 un @code{\override} o bien un @code{\tweak} de una propiedad del
5103 objeto de extensión.
5105 La sintaxis de @code{\alterBroken} es
5108 [-]\alterBroken @var{propiedad} @var{valores} @var{elemento}
5111 El argumento @var{valores} es una lista de valores, uno por cada
5112 fragmento. Si @var{elemento} el el nombre de un grob como
5113 @code{Slur} o @code{Staff.PianoPedalBracket}, el resultado es una
5114 instrucción de sobreescritura @code{\override} del tipo de grob
5115 especificado. Si @var{elemento} es una expresión musical como
5116 @qq{(} o @qq{[} el resultado es la misma expresión musical con el
5117 correspondiente truco aplicado.
5119 El guión inicial se debe utilizar con la forma de trucaje,
5120 @code{\tweak}. No lo escriba cuando utilice @code{\alterBroken}
5121 como una operación de sobreescritura, @code{\override}.
5123 En su uso como @code{\override}, @code{\alterBroken} puede ir
5124 precedido de @code{\once} o @code{\temporary} y ser revertido con
5125 @code{\revert} con el argumento @var{propiedad}.
5127 EL código siguiente aplica un @code{\override} independiente a
5128 cada uno de los fragmentos de la ligadura del ejemplo anterior:
5130 @lilypond[verbatim,quote,ragged-right]
5133 \alterBroken thickness #'(10 1) Slur
5140 La instrucción @code{\alterBroken} se puede usar con cualquier
5141 objeto de extensión, incluidos @code{Tie}, @code{PhrasingSlur},
5142 @code{Beam} y @code{TextSpanner}. Por ejemplo, un editor que está
5143 preparando una edición académica podría desear indicar la ausencia
5144 de parte de una ligadura de fraseo en una fuente haciendo
5145 discontinuo solamente el segmento que se ha añadido. El siguiente
5146 ejemplo ilustra de qué manera se puede hacer esto, en este caso
5147 usando la forma @code{\tweak} de la instrucción:
5149 @lilypond[verbatim,quote,ragged-right]
5150 % The empty list is conveniently used below, because it is the
5151 % default setting of dash-definition, resulting in a solid curve.
5153 c''2-\alterBroken dash-definition #'(() ((0 1.0 0.4 0.75))) \(e
5159 Es importante comprender que @code{\alterBroken} fija cada pieza
5160 del objeto fragmentado al valor correspondiente dentro del
5161 argumento @var{valores}. Cuando hay menos valores que piezas,
5162 cualquier fragmento adicional recibe la asignación de la lista
5163 vacía. Esto puede conllevar resultados no deseados si la
5164 propiedad de disposición no está establecida a la lista vacía de
5165 forma predeterminada. En estos casos, se debe asignar a cada
5166 segmento un valor adecuado.
5169 Los saltos de línea pueden ocurrir en distintos lugares según
5170 cambia la disposición de la música. Los ajustes elegidos para
5171 @code{\alterBroken} podrían no ser adecuados para un objeto de
5172 extensión que ya no está dividido o que se fragmenta en más piezas
5173 que antes. El uso explícito (manual) de saltos de línea mediante
5174 @code{\break} puede prevenir situaciones como ésta.
5176 La instrucción @code{\alterBroken} no es efectiva para propiedades
5177 de los objetos extensos accedidas antes del salto de línea, como
5182 @rextend{Trucos difíciles}.
5185 @node Contenedores unpure-pure
5186 @subsection Contenedores unpure-pure
5187 @translationof Unpure-pure containers
5189 @cindex Scheme, contenedores puros
5190 @cindex Scheme, contenedores no-puros
5191 @cindex puros, contenedores de Scheme
5192 @cindex no-puros: contenedores de Scheme
5193 @cindex horizontal, sobreescribir el espaciado
5195 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para
5196 la sobreescritura de los cálculos del espaciado en el @emph{eje Y}
5197 (concretamente @code{Y-offset} e @code{Y-extent}) con una función
5198 de Scheme en lugar de un literal, es decir, un número o una pareja
5201 Para ciertos objetos gráficos, las dimensiones @code{Y-extent}
5202 están basadas en la propiedad @code{stencil}, la sobreescritura de
5203 la propiedad de sello de éstos requiere una sobreescritura
5204 adicional de @code{Y-extent} con un contenedor unpure-pure.
5205 Cuando una función sobreescribe una dimensión @code{Y-offset} y/o
5206 @code{Y-extent} se supone que esto dispara los cálculos de los
5207 saltos de línea prematuramente durante la compilación. Así pues,
5208 la función no se evalúa en absoluto (devolviendo por lo general un
5209 valor de @samp{0} o @samp{'(0 . 0)}) lo que puede dar lugar a
5210 colisiones. Una función @q{pura} no afecta a las propiedades,
5211 objetos o suicidios de grobs, y por ello siempre ven sus valores
5212 relacionados con el eje Y evaluados correctamente.
5214 Actualmente hay unas treinta funciones que ya se consideran
5215 @q{puras} y los contenedores Unpure-pure son una manera de
5216 establecer funciones que no están en esta lista como @q{puras}.
5217 La función @q{pura} se evalúa @emph{antes} de cualquier salto de
5218 línea y así el espaciado horizontal se puede ajustar @q{a tiempo}.
5219 La función @q{impura} se evalúa entonces @emph{después} del salto
5222 @warning{Dado que es difícil saber siempre qué funciones están en
5223 esta lista, recomendamos que cualquier función @q{pura} que
5224 estemos creando no utilice los grobs @code{Beam} o
5225 @code{VerticalAlignment}.}
5227 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
5229 @code{(ly:make-unpure-pure-container f0 f1)}
5231 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
5232 1}) y el primer argumento siempre debe ser el grob. Ésta es la
5233 función que da el resultado real. @var{f1} es la función que se
5234 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
5235 primer argumento debe ser siempre el grob pero los argumentos segundo
5236 y tercero son argumentos de @q{inicio} y de @q{final}.
5238 @var{inicio} y @var{final} son, a todos los efectos, valores mudos
5239 que sólo tienen importancia para los @code{objetos de extensión}
5240 (o sea: @code{Hairpin}, regulador, o @code{Beam}, barra), que
5241 pueden devolver distintas estimaciones de altura basadas en una
5242 columna de inicio y una de final.
5244 El resto son los otros argumentos para la primera función (que
5245 puede no ser ninguno si @var{n = 1}).
5247 El resultado de la segunda función se usa como una aproximación del
5248 valor necesario, que se usa entonces por la primera función para
5249 obtener el valor real que se usa a continuación para el ajuste de
5250 precisión mucho más tardío durante el proceso de espaciado.
5252 @c TODO: The following example supposedly showing a collision no longer
5253 @c 'works' since 2.18.x. Another example of a collision is needed.
5256 @lilypond[verbatim,quote,ragged-right]
5257 #(define (square-line-circle-space grob)
5258 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
5259 (notename (ly:pitch-notename pitch)))
5260 (if (= 0 (modulo notename 2))
5261 (make-circle-stencil 0.5 0.0 #t)
5262 (make-filled-box-stencil '(0 . 1.0)
5265 squareLineCircleSpace = {
5266 \override NoteHead.stencil = #square-line-circle-space
5269 smartSquareLineCircleSpace = {
5270 \squareLineCircleSpace
5271 \override NoteHead.Y-extent =
5272 #(ly:make-unpure-pure-container
5273 ly:grob::stencil-height
5274 (lambda (grob start end) (ly:grob::stencil-height grob)))
5277 \new Voice \with { \remove "Stem_engraver" }
5279 \squareLineCircleSpace
5281 \smartSquareLineCircleSpace
5286 En el primer compás, sin el contenedor @emph{unpure-pure}, el
5287 motor de espaciado no conoce la anchura de la cabeza de la nota y
5288 permite que colisione con las alteraciones accidentales. En el
5289 segundo compás, el motor de espaciado conoce la anchura de las
5290 cabezas de las notas y evita la colisión mediante el alargamiento
5291 de la línea en la medida adecuada.
5293 Normalmente, para cálculos simples se pueden usar funciones casi
5294 idénticas tanto para las partes @q{no pura} y @q{pura},
5295 simplemente cambiando el número de argumentos que se pasan a, y el
5296 ámbito de, la función. Este caso de utilización es lo bastante
5297 frecuente como para que @code{ly:make-unpure-pure-container}
5298 construya dicha segunda función de forma predeterminada cuando se
5299 llama con solo un argumento de función.
5301 @warning{Si una función está caracterizada como @q{pura} y resulta
5302 que no lo es, el resultado puede ser inesperado.}
5305 @node Uso de las funciones musicales
5306 @section Uso de las funciones musicales
5307 @translationof Using music functions
5309 @c TODO -- add @seealso, etc. to these subsections
5311 Dondequiera que se necesite reutilizar trucos con distintas
5312 expresiones musicales, con frecuencia conviene hacer que el truco
5313 forme parte de una @emph{función musical}. En esta sección
5314 estudiaremos solamente las funciones de @emph{sustitución}, en las
5315 que el objeto es sustituir una variable dentro de un fragmento de
5316 código de entrada de LilyPond. Se describen otras funciones más
5317 complejas en @rextend{Funciones musicales}.
5320 * Sintaxis de las funciones de sustitución::
5321 * Ejemplos de funciones de sustitución::
5325 @node Sintaxis de las funciones de sustitución
5326 @subsection Sintaxis de las funciones de sustitución
5327 @translationof Substitution function syntax
5329 Es fácil hacer una función que sustituya una variable dentro de
5330 código de LilyPond. La forma general de estas funciones es
5334 #(define-music-function
5335 (@var{arg1} @var{arg2} @dots{})
5336 (@var{type1?} @var{type2?} @dots{})
5338 @var{@dots{}música@dots{}}
5345 @multitable @columnfractions .33 .66
5346 @item @code{@var{argN}}
5347 @tab @var{n}-ésimo argumento
5349 @item @code{@var{typeN?}}
5350 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
5351 debe devolver @code{#t}.
5353 @item @code{@var{@dots{}música@dots{}}}
5354 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
5355 lugares en que sólo se permiten construcciones de LilyPond) o
5356 @code{#} (para usarlo como un valor de Scheme o un argumento de
5357 función musical o música dentro de listas de música) para
5358 referenciar argumentos (p.ej. @samp{#arg1}).
5361 Es necesaria la lista de predicados de tipo. Algunos de los
5362 predicados de tipo más comunes que se utilizan en las funciones
5367 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
5379 Para ver una lista de los predicados de tipo disponibles, consulte
5380 @ref{Predicados de tipo predefinidos}. También se permiten los
5381 predicados de tipo definidos por el usuario.
5384 Referencia de la notación:
5385 @ref{Predicados de tipo predefinidos}.
5387 Expansión de LilyPond:
5388 @rextend{Sintaxis de las funciones musicales}.
5390 Archivos instalados:
5391 @file{lily/music-scheme.cc},
5393 @file{scm/lily.scm}.
5396 @node Ejemplos de funciones de sustitución
5397 @subsection Ejemplos de funciones de sustitución
5398 @translationof Substitution function examples
5400 Esta sección presenta algunos ejemplos de funciones de
5401 sustitución. No pretenden ser exhaustivas, sino demostrar algunas
5402 de las posibilidades de las funciones de sustitución sencillas.
5404 En el primer ejemplo se define una función que simplifica el
5405 ajuste del relleno de un elemento de inscripción de texto
5408 @lilypond[quote,verbatim,ragged-right]
5410 #(define-music-function
5414 \once \override TextScript.padding = #padding
5418 c''4^"piu mosso" b a b
5420 c4^"piu mosso" b a b
5422 c4^"piu mosso" b a b
5426 Además de números, podemos usar expresiones musicales, como notas,
5427 para los argumentos de las funciones musicales:
5429 @lilypond[quote,verbatim,ragged-right]
5431 #(define-music-function
5435 \tweak NoteHead.stencil #ly:text-interface::print
5436 \tweak NoteHead.text
5437 \markup \musicglyph #"custodes.mensural.u0"
5438 \tweak Stem.stencil ##f
5442 \relative { c'4 d e f \custosNote g }
5446 Ambas funciones son expresiones únicas sencillas en las que solo
5447 falta el último elemento de una lamada de función o
5448 sobreescritura. Para estas definiciones de función en particular,
5449 existe una sintaxis alternativa más simple que consiste
5450 simplemente en escribir la parte constante de la expresión y
5451 sustituir el elemento final que falta por @code{\etc}:
5453 @lilypond[quote,verbatim,ragged-right]
5455 \once \override TextScript.padding = \etc
5458 c''4^"piu mosso" b a b
5460 c4^"piu mosso" b a b
5462 c4^"piu mosso" b a b
5466 @lilypond[quote,verbatim,ragged-right]
5468 \tweak NoteHead.stencil #ly:text-interface::print
5469 \tweak NoteHead.text
5470 \markup \musicglyph #"custodes.mensural.u0"
5471 \tweak Stem.stencil ##f
5474 \relative { c'4 d e f \custosNote g }
5478 Se pueden definir funciones de sustitución con más de un
5481 @lilypond[quote,verbatim,ragged-right]
5483 #(define-music-function
5487 \once \override Score.MetronomeMark.padding = #padding
5488 \tempo \markup { \bold #tempotext }
5492 \tempo \markup { "Low tempo" }
5494 \tempoPadded #4.0 "High tempo"
5499 @c TODO: add appropriate @@ref's here.