1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: c5a0ac92e560d0600b2c614490f2da8d8f51c0e3
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
11 @chapter Tweaking output
13 Este capítulo trata de cómo modificar la salida. LilyPond es extremadamente
14 configurable; prácticamente todos los fragmentos de la salida se pueden cambiar.
18 * Introduction to tweaks::
19 * Objects and interfaces::
22 @node Introduction to tweaks
23 @subsection Introduction to tweaks
25 El @q{Trucaje} es un término de LilyPond que denota los diversos
26 métodos que el usuario tiene a su disposición para modificar el
27 proceso de interpretación del archivo de entrada y cambiar la
28 apariencia de la salida impresa. Algunos trucos son muy fáciles de
29 usar; otros son más complejos. Pero en su conjunto, los métodos de
30 trucaje disponibles posibilitan conseguir casi cualquier apariencia
31 que deseemos en la música impresa.
33 En esta sección vamos a estudiar los conceptos básicos que se
34 necesitan para comprender el trucaje. Más tarde daremos un amplio
35 abanico de instrucciones listas para usar, que podrá simplemente
36 copiar para obtener el mismo efecto en sus partituras, y al mismo
37 tiempo mostraremos la forma de construir dichas instrucciones para que
38 pueda aprender cómo desarrollar sus propios trucos.
40 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
41 la sección @ref{Contexts and engravers}, pues los Contextos, los
42 Grabadores y las Propiedades que se contienen en ellos son
43 fundamentales para comprender y construir los trucos.
45 @node Objects and interfaces
46 @subsection Objects and interfaces
53 El trucaje consiste en modificar el funcionamiento y estructura
54 interna del programa LilyPond, por lo que en primer lugar
55 introduciremos algunos términos que se usan para describir dichas
56 operaciones y estructuras internas.
58 El término @q{Objeto} es un término genérico que se usa para referirse
59 a la multitud de estructuras internas que LilyPond construye durante
60 el procesado de un archivo de entrada. Así, cuando se encuentra una
61 instrucción como @code{\new Staff}, se construye un objeto nuevo del
62 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
63 las propiedades asociadas con ese pentagrama en particular, por
64 ejemplo, su nombre y su armadura, además de otros detalles de los
65 grabadores que se han asignado para que operen dentro del contexto del
66 pentagrama. De forma similar, hay objetos que guardan las propieades
67 de todos los demás contextos, como objetos de @code{Voice}, objetos de
68 @code{Score}, objetos de @code{Lyrics}, así como objetos que
69 representan todos los elementos notacionales como líneas divisorias,
70 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
71 objeto tiene su propio conjunto de valores de propiedad.
73 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
74 representan elementos de notación sobre la salida impresa como cabezas
75 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
76 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
77 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
78 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
79 mencionado, y también todos ellos tienen propiedades asociadas, como
80 su posición, tamaño, color,etc.
82 Ciertos objetos de presentación son aún más especializados. Las
83 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
84 y baja, y muchos otros objetos gráficos no están situados en un solo
85 lugar: tienen un punto de inicio, un punto de final, y quizá otras
86 propiedades relacionadas con su forma. Los objetos con una forma
87 extendida como estos, reciben el nombre de «Objetos de extensión» o
90 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
91 incluso aunque son bastante diferentes, comparten funcionalidades que
92 se deben procesar de la misma manera. Por ejemplo, todos los objetos
93 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
94 propiedades se procesan de la misma forma durante la interpretación
95 del archivo de entrada por parte de LilyPond. Para simplificar estas
96 operaciones internas, estas acciones t propiedades comunes se agrupan
97 en un objeto llamado @code{grob-interface}, interface de grob. Hay
98 muchas otras agrupaciones de propiedades comunes como ésta, y cada
99 unoa recibe un nombre que acaba en @code{interface}. En total hay más
100 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
101 interés y de utilidad para el usuario.
103 Estos son, en fin, los términos principales relativos a los objetos
104 que vamos a utilizar en este capítulo.
108 @section Moving objects
110 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos
111 elementos de notación se pueden superponer, lo que es una lástima,
112 pero en casi todos los casos se resuelve fácilmente.
114 @c FIXME: find a better example for 5.1 Moving Objects. -gp
115 @c yes, I want this TODO to be visible to end-users. It's better
116 @c than having nothing at all.
117 HACER: con las nuevas funcionalidades de espaciado en la versión 2.12, estos ejemplos específicos
118 ya no son de relevancia. Sin embargo siguen demostrando las poderosas funcionalidades de lilypond,
119 así que quedan aquí hasta que alguien elabore unos ejemplos mejores.
121 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
122 % temporary code to break this example:
123 \override TextScript #'outside-staff-priority = ##f
124 e4^\markup{ \italic ritenuto } g b e
129 La solución más fácil es aumentar la distancia entre el objeto
130 (texto en este caso, pero muy bien podrían ser digitaciones o dinámicas)
131 y la nota. En LilyPond, esto se llama la propiedad
132 @code{padding} (relleno); se mide en espacios de pentagrama. Para la mayor
133 parte de los objetos, este valor ronda la cantidad de 1.0 o menos (varía dependiendo del
134 objeto). Queremos aumentarlo, así que probaremos el valor 1.5
136 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
137 % temporary code to break this example:
138 \override TextScript #'outside-staff-priority = ##f
139 \once \override TextScript #'padding = #1.5
140 e4^\markup{ \italic ritenuto } g b e
143 Esto tiene un mejor aspecto, pero no es suficiente. Después de probar
144 con algunos valores, creemos que 2.3 es el mejor número en este caso. Sin embargo
145 esta cantidad es el mero resultado del ensayo y error y de mi gusto personal
146 acerca de la notación. Pruebe el ejemplo anterior con 2.3... pero también con otros valores
147 mayores (y menores). ¿Cuál cree que queda mejor?
149 La propiedad @code{staff-padding} (relleno de pentagrama) está estrechamente relacionada.
150 @code{padding} controla la cantidad de espacio mínima entre un objeto y el objeto más cercano
151 (generalmente la nota o las líneas del pentagrama);
152 @code{staff-padding} controla la cantidad mínima de espacio entre un
153 objeto y el pentagrama. Ello supone una sutil diferencia, pero podrá
154 observar el comportamiento a continuación.
156 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
157 % temporary code to break this example:
158 \override TextScript #'outside-staff-priority = ##f
160 \once \override TextScript #'padding = #4.6
162 \once \override TextScript #'staff-padding = #4.6
163 c4^"piu mosso" fis a g
165 c'4^"piu mosso" b a b
166 \once \override TextScript #'padding = #4.6
168 \once \override TextScript #'staff-padding = #4.6
169 c4^"piu mosso" fis a g
172 @cindex desplazamiento adicional
174 Otra solución nos proporciona un control absoluto sobre la situación del objeto: podemos
175 moverlo horizontal o verticalmente. Se hace con la propiedad
176 @code{extra-offset} (desplazamiento adicional). Es ligeramente más complicado y puede
177 causar otros problemas. Cuando movemos objetos con @code{extra-offset},
178 el movimiento se hace después de que LilyPond haya colocado todos los demás objetos.
180 que el resultado podría entrar en conflicto con otros objetos.
182 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
183 % temporary code to break this example:
184 \override TextScript #'outside-staff-priority = ##f
185 \once \override TextScript #'extra-offset = #'( 1.0 . -1.0 )
186 e4^\markup{ \italic ritenuto } g b e
189 Con @code{extra-offset}, el primer número controla el movimiento
190 horizontal (negativo hacia la izquierda); el segundo número controla el movimiento
191 vertical (positivo hacia arriba). Después de algunos ensayos, hemos decidido que los siguientes valores
194 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
195 % temporary code to break this example:
196 \override TextScript #'outside-staff-priority = ##f
197 \once \override TextScript #'extra-offset = #'( -1.6 . 1.0 )
198 e4^\markup{ \italic ritenuto } g b e
202 Una vez más, estos números son simplemente el resultado de algunos experimentos y
203 de observar la salida. Quizá prefiera que el texto se encuentre algo más arriba,
204 o a la izquierda, o en cualquier dirección. ¡Pruébelo y observe el resultado!
206 Una advertencia final: en esta sección hemos usado
209 \once \override TextScript @dots{}
212 Esto altera la presentación del texto para la nota siguiente. Si la nota no
213 tiene ningún texto, este truco no hace nada (y @strong{no} se queda esperando al
214 siguiente fragmento de texto). Para cambiar el comportamiento permanentemente a partir
215 del comando, omita el @code{\once}. Para detener este truco, use
216 @code{\revert} (revertir). Todo esto se explica en profundidad en
217 @ruser{The \override command}.
219 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
220 % temporary code to break this example:
221 \override TextScript #'outside-staff-priority = ##f
223 \once \override TextScript #'padding = #4.6
226 \once \override TextScript #'padding = #4.6
230 \override TextScript #'padding = #4.6
233 \revert TextScript #'padding
239 En el presente manual: @ruser{The \override command}, @ruser{Common tweaks}.
242 @node Fixing overlapping notation
243 @section Fixing overlapping notation
245 En @ruser{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
246 El mismo mecanismo se puede usar para mover otros tipos de
247 objetos; simplemente sustituya @code{TextScript} con el nombre de
250 Para encontrar el nombre del objeto, consulte la sección @q{@strong{véase también}} al
251 final de la página relevante dentro de la documentación. Por ejemplo, al
252 final de @ruser{Dynamics}, vemos
257 Referencia del programa: @internalsref{DynamicText}, @internalsref{Hairpin}.
258 La posición vertical de estos símbolos se maneja por medio de
259 @internalsref{DynamicLineSpanner}.
263 Así que para mover expresiones dinámicas verticalmente, usamos
266 \override DynamicLineSpanner #'padding = #2.0
269 No podemos listar todos y cada uno de los objetos, pero presentamos a continuación una lista
270 de los objetos más comunes.
272 @multitable @columnfractions .33 .66
273 @headitem Tipo de objeto @tab Nombre del objeto
274 @item Expresiones dinámicas (verticalmente) @tab @code{DynamicLineSpanner}
275 @item Expresiones dinámicas (horizontalmente) @tab @code{DynamicText}
276 @item Ligaduras de unión @tab @code{Tie}
277 @item Ligaduras de expresión @tab @code{Slur}
278 @item Articulaciones @tab @code{Script}
279 @item Digitaciones @tab @code{Fingering}
280 @item Texto, p.ej. @code{^"text"} @tab @code{TextScript}
281 @item Llamadas de ensayo o marcas de texto @tab @code{RehearsalMark}
286 @section Common tweaks
288 Algunas sustituciones son tan comunes que se proporcionan comandos preestablecidos
289 como atajos, como @code{\slurUp} (ligadura hacia arriba) y @code{\stemDown} (plica hacia abajo). Estos
290 comandos se describen dentro de la Referencia de Notación bajo las secciones
293 La lista completa de modificaciones disponibles para cada tipo de
294 objeto (como ligaduras o barras de corchea) están documentadas en la Referencia del
295 Programa. Sin embargo, muchos objetos de la presentación comparten propiedades que se pueden
296 usar para aplicar trucos genéricos.
303 La propiedad @code{padding} (relleno) se puede establecer de forma que incremente
304 (o disminuya) la distancia entre símbolos que se imprimen encima
305 o debajo de las notas. Se aplica a todos los objetos con
306 @code{side-position-interface}.
308 @lilypond[quote,fragment,relative=1,verbatim]
310 \override Script #'padding = #3
314 @lilypond[quote,fragment,relative=1,verbatim]
315 % This will not work, see below:
316 \override MetronomeMark #'padding = #3
320 \override Score.MetronomeMark #'padding = #3
325 Observe en el segundo ejemplo cuán importante es determinar qué contexto
326 maneja un objeto determinado. Debido a que el objeto @code{MetronomeMark} (indicación metronómica)
327 se maneja en el contexto @code{Score}, los cambios de propiedades dentro del
328 contexto @code{Voice} no se tendrán en cuenta. Para ver más detalles, consulte
329 @ruser{Constructing a tweak}.
331 @cindex extra-offset (desplazamiento adicional)
334 La propiedad @code{extra-offset} mueve objetos en la salida;
335 requiere una pareja de números. El primer número
336 controla el movimiento horizontal, un número positivo moverá
337 el objeto hacia la derecha. El segundo número controla el movimiento
338 vertical; un número positivo lo desplazará hacia arriba. La
339 propiedad @code{extra-offset} es una funcionalidad de bajo nivel: el motor
340 de formateo es completamente olvidadizo respecto de estos desplazamientos.
342 En el ejemplo siguiente, la segunda digitación se desplaza un poco hacia
343 la izquierda y 1.8 espacios de pentagrama hacia abajo:
345 @lilypond[quote,fragment,relative=1,verbatim]
348 \once \override Fingering
349 #'extra-offset = #'(-0.3 . -1.8)
354 El establecimiento de la propiedad @code{transparent} provocará que un objeto se imprima
355 con @q{tinta invisible}: el objeto no se imprime, pero se conserva todo el resto
356 de su comportamiento. El objeto aún ocupa un espacio, toma parte en las colisiones,
357 y se le pueden adjuntar ligaduras de unión o de expresión y barras de corchea.
359 @cindex objetos transparentes
360 @cindex quitar objetos
361 @cindex ocultar objetos
362 @cindex objetos invisibles
363 El ejemplo siguiente demuestra cómo conectar distintas voces
364 utilizando ligaduras. Normalmente las ligaduras sólo unen dos notas de la misma voz.
365 Al introducir una ligadura en una voz distinta,
367 @lilypond[quote,fragment,relative=2]
376 y suprimiendo la primera plica hacia arriba en dicha voz, la ligadura parece cruzarse de una
380 @lilypond[quote,fragment,relative=2,verbatim]
382 \once \override Stem #'transparent = ##t
389 Para asegurarse de que la plica que hemos suprimido no aprieta demasiado a la
390 ligadura, también alargamos la plica, estableciendo su @code{length} (longitud) a
393 @lilypond[quote,fragment,relative=2,verbatim]
395 \once \override Stem #'transparent = ##t
396 \once \override Stem #'length = #8
405 @cindex Trucos, distancias
408 Las distancias en LilyPond se miden en espacios de pentagrama, mientras que
409 las propiedades de grosor se miden en grosores de líneas de pentagrama. Algunas
410 propiedades son diferentes; por ejemplo, el grosor de las barras de corchea
411 se mide en espacios de pentagrama. Para más información, consulte la porción
412 correspondiente de la referencia del programa.
419 @node Size of objects
420 @subsection Size of objects
422 UNTRANSLATED NODE: IGNORE ME
425 @section Default files
427 La documentación de la Referencia del Programa contiene una gran cantidad de información
428 sobre LilyPond, pero más información aún se puede obtener a partir de la observación
429 de los archivos internos de LilyPond.
431 Algunos ajustes por omisión como las definiciones de las
432 @code{\header@{@}}s (encabezamientos) están almacenados en archivos @code{.ly}.
433 Otros ajustes como las definiciones de los comandos de marcado se almacenan
434 como archivos @code{.scm} (de Scheme). Cae fuera del ámbito de presente manual
435 cualquier explicación más profunda; los usuarios están advertidos de que se necesita
436 una considerable cantidad de conocimientos técnicos
437 para comprender estos archivos.
441 @item Linux: @file{@var{directorio_de_instalación}/lilypond/usr/share/lilypond/current/}
444 @file{@var{carpeta_de_instalación}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
445 Para llegar aquí, o bien entre con @code{cd} en este directorio desde el
446 Terminal, o haga control-clic sobre la aplicación LilyPond y elija
447 @q{Mostrar el Contenido del Paquete}.
449 @item Windows: @file{@var{carpeta_de_instalación}/LilyPond/usr/share/lilypond/current/}
453 Los directorios @file{ly/} y @file{scm/} son de especial interés.
454 Archivos como @file{ly/property-init.ly} y
455 @file{ly/declarations-init.ly} definen todos los trucos comunes.
458 @node Fitting music onto fewer pages
459 @section Fitting music onto fewer pages
461 A veces puede acabar con uno o dos pentagramas en una segunda página
462 (o tercera, o cuarta...). Es fastidioso sobre todo si observa las
463 páginas anteriores y parece haber
464 espacio suficiente en ellas.
466 Al investigar asuntos relacionados con la presentación, la herramienta
467 @code{annotate-spacing} (anotar el espaciado) no tiene precio.
468 Este comando imprime los valores de algunos comandos de espaciado;
469 consulte @ruser{Displaying spacing} para ver más detalles. A partir de
470 la salida de de @code{annotate-spacing}, podemos ver qué márgenes podríamos desear alterar.
472 Aparte de los márgenes, existen otras opciones para ahorrar espacio:
476 Puede indicarle a LilyPond que coloque los sistemas tan juntos como sea
477 posible (para que quepan tantos sistemas como sea posible sobre una página),
478 pero luego separar estos sistemas para que no haya ningún espacio vacío
479 al final de la página.
483 between-system-padding = #0.1
484 between-system-space = #0.1
485 ragged-last-bottom = ##f
491 Puede forzar el número de sistemas (es decir, si LilyPond quiere
492 tipografiar la música con 11 sistemas, puede forzarlo
502 Evite (o reduzca) el uso de objetos que aumenten el tamaño
503 vertical de un sistema. Por ejemplo, las repeticiones con
504 primera y segunda vez necesitan espacio adicional. Si
505 estas repeticiones abarcan dos sistemas, ocuparán más espacio
506 que un solo sistema con las repeticiones y otro sistema sin ellas.
508 Otro ejemplo es desplazar las expresiones dinámicas que se
509 @q{asoman por encima} de un sistema.
511 @lilypond[verbatim,quote,fragment]
514 \override DynamicLineSpanner #'padding = #-1.8
515 \override DynamicText #'extra-offset = #'( -2.1 . 0)
521 Altere el espaciado horizontal por medio de @code{SpacingSpanner}. Consulte
522 @ruser{Changing horizontal spacing} para ver más detalles.
524 @lilypond[verbatim,quote]
527 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
528 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
529 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
530 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
535 \override SpacingSpanner
536 #'base-shortest-duration = #(ly:make-moment 1 4)
545 @node Advanced tweaks with Scheme
546 @section Advanced tweaks with Scheme
548 Hemos visto cómo la salida de LilyPond se puede modificar de manera muy profunda utilizando
550 @code{\override TextScript #'extra-offset = ( 1 . -1)}. Pero
551 tenemos un potencial incluso mayor si utilizamos Scheme. Para ver una explicación completa
552 de esto, consulte el @ruser{Scheme tutorial} e
553 @ruser{Interfaces for programmers}.
555 Podemos usar Scheme simplemente para sobreponer (@code{\override}) comandos,
557 @lilypond[quote,verbatim,ragged-right]
558 padText = #(define-music-function (parser location padding) (number?)
560 \once \override TextScript #'padding = #$padding
568 c4^"piu mosso" fis a g
572 Podemos usarlo para crear comandos nuevos,
574 @lilypond[quote,verbatim,ragged-right]
575 tempoMark = #(define-music-function (parser location padding marktext)
578 \once \override Score . RehearsalMark #'padding = $padding
579 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
580 \mark \markup { \bold $marktext }
585 \tempoMark #3.0 #"Allegro"
590 E incluso se le pueden pasar expresiones musicales.
592 @lilypond[quote,verbatim,ragged-right]
593 pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
600 \pattern {d16 dis} { ais16-> b\p }
605 @node Avoiding tweaks with slower processing
606 @section Avoiding tweaks with slower processing
608 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
609 procesa los archivos. Estos comandos consumen tiempo, pero el
610 resultado puede necesitar menos trucos manuales.
613 %% asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
614 \override Score.PaperColumn #'keep-inside-line = ##t