1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 0204d415337bf74ae8626f396e6ea3cc5669c8f2
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.
19 * Fixing overlapping notation::
22 * Fitting music onto fewer pages::
23 * Advanced tweaks with Scheme::
24 * Avoiding tweaks with slower processing::
29 @section Moving objects
31 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos
32 elementos de notación se pueden superponer, lo que es una lástima,
33 pero en casi todos los casos se resuelve fácilmente.
35 @c FIXME: find a better example for 5.1 Moving Objects. -gp
36 @c yes, I want this TODO to be visible to end-users. It's better
37 @c than having nothing at all.
38 HACER: con las nuevas funcionalidades de espaciado en la versión 2.12, estos ejemplos específicos
39 ya no son de relevancia. Sin embargo siguen demostrando las poderosas funcionalidades de lilypond,
40 así que quedan aquí hasta que alguien elabore unos ejemplos mejores.
42 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
43 % temporary code to break this example:
44 \override TextScript #'outside-staff-priority = ##f
45 e4^\markup{ \italic ritenuto } g b e
50 La solución más fácil es aumentar la distancia entre el objeto
51 (texto en este caso, pero muy bien podrían ser digitaciones o dinámicas)
52 y la nota. En LilyPond, esto se llama la propiedad
53 @code{padding} (relleno); se mide en espacios de pentagrama. Para la mayor
54 parte de los objetos, este valor ronda la cantidad de 1.0 o menos (varía dependiendo del
55 objeto). Queremos aumentarlo, así que probaremos el valor 1.5
57 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
58 % temporary code to break this example:
59 \override TextScript #'outside-staff-priority = ##f
60 \once \override TextScript #'padding = #1.5
61 e4^\markup{ \italic ritenuto } g b e
64 Esto tiene un mejor aspecto, pero no es suficiente. Después de probar
65 con algunos valores, creemos que 2.3 es el mejor número en este caso. Sin embargo
66 esta cantidad es el mero resultado del ensayo y error y de mi gusto personal
67 acerca de la notación. Pruebe el ejemplo anterior con 2.3... pero también con otros valores
68 mayores (y menores). ¿Cuál cree que queda mejor?
70 La propiedad @code{staff-padding} (relleno de pentagrama) está estrechamente relacionada.
71 @code{padding} controla la cantidad de espacio mínima entre un objeto y el objeto más cercano
72 (generalmente la nota o las líneas del pentagrama);
73 @code{staff-padding} controla la cantidad mínima de espacio entre un
74 objeto y el pentagrama. Ello supone una sutil diferencia, pero podrá
75 observar el comportamiento a continuación.
77 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
78 % temporary code to break this example:
79 \override TextScript #'outside-staff-priority = ##f
81 \once \override TextScript #'padding = #4.6
83 \once \override TextScript #'staff-padding = #4.6
84 c4^"piu mosso" fis a g
87 \once \override TextScript #'padding = #4.6
89 \once \override TextScript #'staff-padding = #4.6
90 c4^"piu mosso" fis a g
93 @cindex desplazamiento adicional
95 Otra solución nos proporciona un control absoluto sobre la situación del objeto: podemos
96 moverlo horizontal o verticalmente. Se hace con la propiedad
97 @code{extra-offset} (desplazamiento adicional). Es ligeramente más complicado y puede
98 causar otros problemas. Cuando movemos objetos con @code{extra-offset},
99 el movimiento se hace después de que LilyPond haya colocado todos los demás objetos.
101 que el resultado podría entrar en conflicto con otros objetos.
103 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
104 % temporary code to break this example:
105 \override TextScript #'outside-staff-priority = ##f
106 \once \override TextScript #'extra-offset = #'( 1.0 . -1.0 )
107 e4^\markup{ \italic ritenuto } g b e
110 Con @code{extra-offset}, el primer número controla el movimiento
111 horizontal (negativo hacia la izquierda); el segundo número controla el movimiento
112 vertical (positivo hacia arriba). Después de algunos ensayos, hemos decidido que los siguientes valores
115 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
116 % temporary code to break this example:
117 \override TextScript #'outside-staff-priority = ##f
118 \once \override TextScript #'extra-offset = #'( -1.6 . 1.0 )
119 e4^\markup{ \italic ritenuto } g b e
123 Una vez más, estos números son simplemente el resultado de algunos experimentos y
124 de observar la salida. Quizá prefiera que el texto se encuentre algo más arriba,
125 o a la izquierda, o en cualquier dirección. ¡Pruébelo y observe el resultado!
127 Una advertencia final: en esta sección hemos usado
130 \once \override TextScript @dots{}
133 Esto altera la presentación del texto para la nota siguiente. Si la nota no
134 tiene ningún texto, este truco no hace nada (y @strong{no} se queda esperando al
135 siguiente fragmento de texto). Para cambiar el comportamiento permanentemente a partir
136 del comando, omita el @code{\once}. Para detener este truco, use
137 @code{\revert} (revertir). Todo esto se explica en profundidad en
138 @ruser{The \override command}.
140 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
141 % temporary code to break this example:
142 \override TextScript #'outside-staff-priority = ##f
144 \once \override TextScript #'padding = #4.6
147 \once \override TextScript #'padding = #4.6
151 \override TextScript #'padding = #4.6
154 \revert TextScript #'padding
160 En el presente manual: @ruser{The \override command}, @ruser{Common tweaks}.
163 @node Fixing overlapping notation
164 @section Fixing overlapping notation
166 En @ruser{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
167 El mismo mecanismo se puede usar para mover otros tipos de
168 objetos; simplemente sustituya @code{TextScript} con el nombre de
171 Para encontrar el nombre del objeto, consulte la sección @q{@strong{véase también}} al
172 final de la página relevante dentro de la documentación. Por ejemplo, al
173 final de @ruser{Dynamics}, vemos
178 Referencia del programa: @internalsref{DynamicText}, @internalsref{Hairpin}.
179 La posición vertical de estos símbolos se maneja por medio de
180 @internalsref{DynamicLineSpanner}.
184 Así que para mover expresiones dinámicas verticalmente, usamos
187 \override DynamicLineSpanner #'padding = #2.0
190 No podemos listar todos y cada uno de los objetos, pero presentamos a continuación una lista
191 de los objetos más comunes.
193 @multitable @columnfractions .33 .66
194 @headitem Tipo de objeto @tab Nombre del objeto
195 @item Expresiones dinámicas (verticalmente) @tab @code{DynamicLineSpanner}
196 @item Expresiones dinámicas (horizontalmente) @tab @code{DynamicText}
197 @item Ligaduras de unión @tab @code{Tie}
198 @item Ligaduras de expresión @tab @code{Slur}
199 @item Articulaciones @tab @code{Script}
200 @item Digitaciones @tab @code{Fingering}
201 @item Texto, p.ej. @code{^"text"} @tab @code{TextScript}
202 @item Llamadas de ensayo o marcas de texto @tab @code{RehearsalMark}
207 @section Common tweaks
209 Algunas sustituciones son tan comunes que se proporcionan comandos preestablecidos
210 como atajos, como @code{\slurUp} (ligadura hacia arriba) y @code{\stemDown} (plica hacia abajo). Estos
211 comandos se describen dentro de la Referencia de Notación bajo las secciones
214 La lista completa de modificaciones disponibles para cada tipo de
215 objeto (como ligaduras o barras de corchea) están documentadas en la Referencia del
216 Programa. Sin embargo, muchos objetos de la presentación comparten propiedades que se pueden
217 usar para aplicar trucos genéricos.
224 La propiedad @code{padding} (relleno) se puede establecer de forma que incremente
225 (o disminuya) la distancia entre símbolos que se imprimen encima
226 o debajo de las notas. Se aplica a todos los objetos con
227 @code{side-position-interface}.
229 @lilypond[quote,fragment,relative=1,verbatim]
231 \override Script #'padding = #3
235 @lilypond[quote,fragment,relative=1,verbatim]
236 % This will not work, see below:
237 \override MetronomeMark #'padding = #3
241 \override Score.MetronomeMark #'padding = #3
246 Observe en el segundo ejemplo cuán importante es determinar qué contexto
247 maneja un objeto determinado. Debido a que el objeto @code{MetronomeMark} (indicación metronómica)
248 se maneja en el contexto @code{Score}, los cambios de propiedades dentro del
249 contexto @code{Voice} no se tendrán en cuenta. Para ver más detalles, consulte
250 @ruser{Constructing a tweak}.
252 @cindex extra-offset (desplazamiento adicional)
255 La propiedad @code{extra-offset} mueve objetos en la salida;
256 requiere una pareja de números. El primer número
257 controla el movimiento horizontal, un número positivo moverá
258 el objeto hacia la derecha. El segundo número controla el movimiento
259 vertical; un número positivo lo desplazará hacia arriba. La
260 propiedad @code{extra-offset} es una funcionalidad de bajo nivel: el motor
261 de formateo es completamente olvidadizo respecto de estos desplazamientos.
263 En el ejemplo siguiente, la segunda digitación se desplaza un poco hacia
264 la izquierda y 1.8 espacios de pentagrama hacia abajo:
266 @lilypond[quote,fragment,relative=1,verbatim]
269 \once \override Fingering
270 #'extra-offset = #'(-0.3 . -1.8)
275 El establecimiento de la propiedad @code{transparent} provocará que un objeto se imprima
276 con @q{tinta invisible}: el objeto no se imprime, pero se conserva todo el resto
277 de su comportamiento. El objeto aún ocupa un espacio, toma parte en las colisiones,
278 y se le pueden adjuntar ligaduras de unión o de expresión y barras de corchea.
280 @cindex objetos transparentes
281 @cindex quitar objetos
282 @cindex ocultar objetos
283 @cindex objetos invisibles
284 El ejemplo siguiente demuestra cómo conectar distintas voces
285 utilizando ligaduras. Normalmente las ligaduras sólo unen dos notas de la misma voz.
286 Al introducir una ligadura en una voz distinta,
288 @lilypond[quote,fragment,relative=2]
297 y suprimiendo la primera plica hacia arriba en dicha voz, la ligadura parece cruzarse de una
301 @lilypond[quote,fragment,relative=2,verbatim]
303 \once \override Stem #'transparent = ##t
310 Para asegurarse de que la plica que hemos suprimido no aprieta demasiado a la
311 ligadura, también alargamos la plica, estableciendo su @code{length} (longitud) a
314 @lilypond[quote,fragment,relative=2,verbatim]
316 \once \override Stem #'transparent = ##t
317 \once \override Stem #'length = #8
326 @cindex Trucos, distancias
329 Las distancias en LilyPond se miden en espacios de pentagrama, mientras que
330 las propiedades de grosor se miden en grosores de líneas de pentagrama. Algunas
331 propiedades son diferentes; por ejemplo, el grosor de las barras de corchea
332 se mide en espacios de pentagrama. Para más información, consulte la porción
333 correspondiente de la referencia del programa.
336 @node Size of objects
337 @subsection Size of objects
339 UNTRANSLATED NODE: IGNORE ME
342 @section Default files
344 La documentación de la Referencia del Programa contiene una gran cantidad de información
345 sobre LilyPond, pero más información aún se puede obtener a partir de la observación
346 de los archivos internos de LilyPond.
348 Algunos ajustes por omisión como las definiciones de las
349 @code{\header@{@}}s (encabezamientos) están almacenados en archivos @code{.ly}.
350 Otros ajustes como las definiciones de los comandos de marcado se almacenan
351 como archivos @code{.scm} (de Scheme). Cae fuera del ámbito de presente manual
352 cualquier explicación más profunda; los usuarios están advertidos de que se necesita
353 una considerable cantidad de conocimientos técnicos
354 para comprender estos archivos.
358 @item Linux: @file{@var{directorio_de_instalación}/lilypond/usr/share/lilypond/current/}
361 @file{@var{carpeta_de_instalación}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
362 Para llegar aquí, o bien entre con @code{cd} en este directorio desde el
363 Terminal, o haga control-clic sobre la aplicación LilyPond y elija
364 @q{Mostrar el Contenido del Paquete}.
366 @item Windows: @file{@var{carpeta_de_instalación}/LilyPond/usr/share/lilypond/current/}
370 Los directorios @file{ly/} y @file{scm/} son de especial interés.
371 Archivos como @file{ly/property-init.ly} y
372 @file{ly/declarations-init.ly} definen todos los trucos comunes.
375 @node Fitting music onto fewer pages
376 @section Fitting music onto fewer pages
378 A veces puede acabar con uno o dos pentagramas en una segunda página
379 (o tercera, o cuarta...). Es fastidioso sobre todo si observa las
380 páginas anteriores y parece haber
381 espacio suficiente en ellas.
383 Al investigar asuntos relacionados con la presentación, la herramienta
384 @code{annotate-spacing} (anotar el espaciado) no tiene precio.
385 Este comando imprime los valores de algunos comandos de espaciado;
386 consulte @ruser{Displaying spacing} para ver más detalles. A partir de
387 la salida de de @code{annotate-spacing}, podemos ver qué márgenes podríamos desear alterar.
389 Aparte de los márgenes, existen otras opciones para ahorrar espacio:
393 Puede indicarle a LilyPond que coloque los sistemas tan juntos como sea
394 posible (para que quepan tantos sistemas como sea posible sobre una página),
395 pero luego separar estos sistemas para que no haya ningún espacio vacío
396 al final de la página.
400 between-system-padding = #0.1
401 between-system-space = #0.1
402 ragged-last-bottom = ##f
408 Puede forzar el número de sistemas (es decir, si LilyPond quiere
409 tipografiar la música con 11 sistemas, puede forzarlo
419 Evite (o reduzca) el uso de objetos que aumenten el tamaño
420 vertical de un sistema. Por ejemplo, las repeticiones con
421 primera y segunda vez necesitan espacio adicional. Si
422 estas repeticiones abarcan dos sistemas, ocuparán más espacio
423 que un solo sistema con las repeticiones y otro sistema sin ellas.
425 Otro ejemplo es desplazar las expresiones dinámicas que se
426 @q{asoman por encima} de un sistema.
428 @lilypond[verbatim,quote,fragment]
431 \override DynamicLineSpanner #'padding = #-1.8
432 \override DynamicText #'extra-offset = #'( -2.1 . 0)
438 Altere el espaciado horizontal por medio de @code{SpacingSpanner}. Consulte
439 @ruser{Changing horizontal spacing} para ver más detalles.
441 @lilypond[verbatim,quote]
444 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
445 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
446 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
447 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
452 \override SpacingSpanner
453 #'base-shortest-duration = #(ly:make-moment 1 4)
462 @node Advanced tweaks with Scheme
463 @section Advanced tweaks with Scheme
465 Hemos visto cómo la salida de LilyPond se puede modificar de manera muy profunda utilizando
467 @code{\override TextScript #'extra-offset = ( 1 . -1)}. Pero
468 tenemos un potencial incluso mayor si utilizamos Scheme. Para ver una explicación completa
469 de esto, consulte el @ruser{Scheme tutorial} e
470 @ruser{Interfaces for programmers}.
472 Podemos usar Scheme simplemente para sobreponer (@code{\override}) comandos,
474 @lilypond[quote,verbatim,ragged-right]
475 padText = #(define-music-function (parser location padding) (number?)
477 \once \override TextScript #'padding = #$padding
485 c4^"piu mosso" fis a g
489 Podemos usarlo para crear comandos nuevos,
491 @lilypond[quote,verbatim,ragged-right]
492 tempoMark = #(define-music-function (parser location padding marktext)
495 \once \override Score . RehearsalMark #'padding = $padding
496 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
497 \mark \markup { \bold $marktext }
502 \tempoMark #3.0 #"Allegro"
507 E incluso se le pueden pasar expresiones musicales.
509 @lilypond[quote,verbatim,ragged-right]
510 pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
517 \pattern {d16 dis} { ais16-> b\p }
522 @node Avoiding tweaks with slower processing
523 @section Avoiding tweaks with slower processing
525 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
526 procesa los archivos. Estos comandos consumen tiempo, pero el
527 resultado puede necesitar menos trucos manuales.
530 %% asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
531 \override Score.PaperColumn #'keep-inside-line = ##t