1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: d3081b92dcfcce31ce268de6ceb640930eb270ef
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.
20 * Fixing overlapping notation::
23 * Fitting music onto fewer pages::
24 * Advanced tweaks with Scheme::
25 * Avoiding tweaks with slower processing::
29 @section Tweaking basics
32 * Introduction to tweaks::
33 * Objects and interfaces::
34 * Naming conventions of objects and properties::
37 @node Introduction to tweaks
38 @subsection Introduction to tweaks
40 El @q{Trucaje} es un término de LilyPond que denota los diversos
41 métodos que el usuario tiene a su disposición para modificar el
42 proceso de interpretación del archivo de entrada y cambiar la
43 apariencia de la salida impresa. Algunos trucos son muy fáciles de
44 usar; otros son más complejos. Pero en su conjunto, los métodos de
45 trucaje disponibles posibilitan conseguir casi cualquier apariencia
46 que deseemos en la música impresa.
48 En esta sección vamos a estudiar los conceptos básicos que se
49 necesitan para comprender el trucaje. Más tarde daremos un amplio
50 abanico de instrucciones listas para usar, que podrá simplemente
51 copiar para obtener el mismo efecto en sus partituras, y al mismo
52 tiempo mostraremos la forma de construir dichas instrucciones para que
53 pueda aprender cómo desarrollar sus propios trucos.
55 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
56 la sección @ref{Contexts and engravers}, pues los Contextos, los
57 Grabadores y las Propiedades que se contienen en ellos son
58 fundamentales para comprender y construir los trucos.
60 @node Objects and interfaces
61 @subsection Objects and interfaces
68 El trucaje consiste en modificar el funcionamiento y estructura
69 interna del programa LilyPond, por lo que en primer lugar
70 introduciremos algunos términos que se usan para describir dichas
71 operaciones y estructuras internas.
73 El término @q{Objeto} es un término genérico que se usa para referirse
74 a la multitud de estructuras internas que LilyPond construye durante
75 el procesado de un archivo de entrada. Así, cuando se encuentra una
76 instrucción como @code{\new Staff}, se construye un objeto nuevo del
77 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
78 las propiedades asociadas con ese pentagrama en particular, por
79 ejemplo, su nombre y su armadura, además de otros detalles de los
80 grabadores que se han asignado para que operen dentro del contexto del
81 pentagrama. De forma similar, hay objetos que guardan las propieades
82 de todos los demás contextos, como objetos de @code{Voice}, objetos de
83 @code{Score}, objetos de @code{Lyrics}, así como objetos que
84 representan todos los elementos notacionales como líneas divisorias,
85 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
86 objeto tiene su propio conjunto de valores de propiedad.
88 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
89 representan elementos de notación sobre la salida impresa como cabezas
90 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
91 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
92 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
93 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
94 mencionado, y también todos ellos tienen propiedades asociadas, como
95 su posición, tamaño, color,etc.
97 Ciertos objetos de presentación son aún más especializados. Las
98 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
99 y baja, y muchos otros objetos gráficos no están situados en un solo
100 lugar: tienen un punto de inicio, un punto de final, y quizá otras
101 propiedades relacionadas con su forma. Los objetos con una forma
102 extendida como estos, reciben el nombre de «Objetos de extensión» o
105 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
106 incluso aunque son bastante diferentes, comparten funcionalidades que
107 se deben procesar de la misma manera. Por ejemplo, todos los objetos
108 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
109 propiedades se procesan de la misma forma durante la interpretación
110 del archivo de entrada por parte de LilyPond. Para simplificar estas
111 operaciones internas, estas acciones t propiedades comunes se agrupan
112 en un objeto llamado @code{grob-interface}, interface de grob. Hay
113 muchas otras agrupaciones de propiedades comunes como ésta, y cada
114 unoa recibe un nombre que acaba en @code{interface}. En total hay más
115 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
116 interés y de utilidad para el usuario.
118 Estos son, en fin, los términos principales relativos a los objetos
119 que vamos a utilizar en este capítulo.
121 @node Naming conventions of objects and properties
122 @subsection Naming conventions of objects and properties
124 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
125 sección @ref{Contexts and engravers}. En este lugar, para más fácil
126 referencia, presentamos una lista de los tipos de objetos y
127 propiedades más comunes, junto con las convenciones según las cuales
128 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
129 utilizado una «A» mayúscula para denotar cualquier carácter alfabético
130 en mayúsculas, y «aaa» para cualquier número de caracteres alfabéticos
131 en minúscula. Otros caracteres se utilizan literalmente como están.
133 @multitable @columnfractions .33 .33 .33
134 @headitem Objeto o tipo de propiedad
135 @tab Comnvención de nomenclatura
138 @tab Aaaa o AaaaAaaaAaaa
139 @tab Staff, GrandStaff
140 @item Objetos de presentación
141 @tab Aaaa o AaaaAaaaAaaa
144 @tab Aaaa_aaa_engraver
145 @tab Clef_engraver, Note_heads_engraver
147 @tab aaa-aaa-interface
148 @tab grob-interface, break-aligned-interface
149 @item Propiedades de contextos
150 @tab aaa o aaaAaaaAaaa
151 @tab alignAboveContext, skipBars
152 @item Propiedades de objetos de presentación
153 @tab aaa o aaa-aaa-aaa
154 @tab direction, beam-thickness
157 Como podremos ver en breve, las propiedades de distintos tipos de
158 objeto se modifican por parte de diferentes instrucciones; así pues,
159 es útil poder reconocer el tipo de objeto a partir de sus nombres de
164 @section Moving objects
166 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos
167 elementos de notación se pueden superponer, lo que es una lástima,
168 pero en casi todos los casos se resuelve fácilmente.
170 @c FIXME: find a better example for 5.1 Moving Objects. -gp
171 @c yes, I want this TODO to be visible to end-users. It's better
172 @c than having nothing at all.
173 HACER: con las nuevas funcionalidades de espaciado en la versión 2.12, estos ejemplos específicos
174 ya no son de relevancia. Sin embargo siguen demostrando las poderosas funcionalidades de lilypond,
175 así que quedan aquí hasta que alguien elabore unos ejemplos mejores.
177 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
178 % temporary code to break this example:
179 \override TextScript #'outside-staff-priority = ##f
180 e4^\markup{ \italic ritenuto } g b e
185 La solución más fácil es aumentar la distancia entre el objeto
186 (texto en este caso, pero muy bien podrían ser digitaciones o dinámicas)
187 y la nota. En LilyPond, esto se llama la propiedad
188 @code{padding} (relleno); se mide en espacios de pentagrama. Para la mayor
189 parte de los objetos, este valor ronda la cantidad de 1.0 o menos (varía dependiendo del
190 objeto). Queremos aumentarlo, así que probaremos el valor 1.5
192 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
193 % temporary code to break this example:
194 \override TextScript #'outside-staff-priority = ##f
195 \once \override TextScript #'padding = #1.5
196 e4^\markup{ \italic ritenuto } g b e
199 Esto tiene un mejor aspecto, pero no es suficiente. Después de probar
200 con algunos valores, creemos que 2.3 es el mejor número en este caso. Sin embargo
201 esta cantidad es el mero resultado del ensayo y error y de mi gusto personal
202 acerca de la notación. Pruebe el ejemplo anterior con 2.3... pero también con otros valores
203 mayores (y menores). ¿Cuál cree que queda mejor?
205 La propiedad @code{staff-padding} (relleno de pentagrama) está estrechamente relacionada.
206 @code{padding} controla la cantidad de espacio mínima entre un objeto y el objeto más cercano
207 (generalmente la nota o las líneas del pentagrama);
208 @code{staff-padding} controla la cantidad mínima de espacio entre un
209 objeto y el pentagrama. Ello supone una sutil diferencia, pero podrá
210 observar el comportamiento a continuación.
212 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
213 % temporary code to break this example:
214 \override TextScript #'outside-staff-priority = ##f
216 \once \override TextScript #'padding = #4.6
218 \once \override TextScript #'staff-padding = #4.6
219 c4^"piu mosso" fis a g
221 c'4^"piu mosso" b a b
222 \once \override TextScript #'padding = #4.6
224 \once \override TextScript #'staff-padding = #4.6
225 c4^"piu mosso" fis a g
228 @cindex desplazamiento adicional
230 Otra solución nos proporciona un control absoluto sobre la situación del objeto: podemos
231 moverlo horizontal o verticalmente. Se hace con la propiedad
232 @code{extra-offset} (desplazamiento adicional). Es ligeramente más complicado y puede
233 causar otros problemas. Cuando movemos objetos con @code{extra-offset},
234 el movimiento se hace después de que LilyPond haya colocado todos los demás objetos.
236 que el resultado podría entrar en conflicto con otros objetos.
238 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
239 % temporary code to break this example:
240 \override TextScript #'outside-staff-priority = ##f
241 \once \override TextScript #'extra-offset = #'( 1.0 . -1.0 )
242 e4^\markup{ \italic ritenuto } g b e
245 Con @code{extra-offset}, el primer número controla el movimiento
246 horizontal (negativo hacia la izquierda); el segundo número controla el movimiento
247 vertical (positivo hacia arriba). Después de algunos ensayos, hemos decidido que los siguientes valores
250 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
251 % temporary code to break this example:
252 \override TextScript #'outside-staff-priority = ##f
253 \once \override TextScript #'extra-offset = #'( -1.6 . 1.0 )
254 e4^\markup{ \italic ritenuto } g b e
258 Una vez más, estos números son simplemente el resultado de algunos experimentos y
259 de observar la salida. Quizá prefiera que el texto se encuentre algo más arriba,
260 o a la izquierda, o en cualquier dirección. ¡Pruébelo y observe el resultado!
262 Una advertencia final: en esta sección hemos usado
265 \once \override TextScript @dots{}
268 Esto altera la presentación del texto para la nota siguiente. Si la nota no
269 tiene ningún texto, este truco no hace nada (y @strong{no} se queda esperando al
270 siguiente fragmento de texto). Para cambiar el comportamiento permanentemente a partir
271 del comando, omita el @code{\once}. Para detener este truco, use
272 @code{\revert} (revertir). Todo esto se explica en profundidad en
273 @ruser{The \override command}.
275 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
276 % temporary code to break this example:
277 \override TextScript #'outside-staff-priority = ##f
279 \once \override TextScript #'padding = #4.6
282 \once \override TextScript #'padding = #4.6
286 \override TextScript #'padding = #4.6
289 \revert TextScript #'padding
295 En el presente manual: @ruser{The \override command}, @ruser{Common tweaks}.
298 @node Fixing overlapping notation
299 @section Fixing overlapping notation
301 En @ruser{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
302 El mismo mecanismo se puede usar para mover otros tipos de
303 objetos; simplemente sustituya @code{TextScript} con el nombre de
306 Para encontrar el nombre del objeto, consulte la sección @q{@strong{véase también}} al
307 final de la página relevante dentro de la documentación. Por ejemplo, al
308 final de @ruser{Dynamics}, vemos
313 Referencia del programa: @internalsref{DynamicText}, @internalsref{Hairpin}.
314 La posición vertical de estos símbolos se maneja por medio de
315 @internalsref{DynamicLineSpanner}.
319 Así que para mover expresiones dinámicas verticalmente, usamos
322 \override DynamicLineSpanner #'padding = #2.0
325 No podemos listar todos y cada uno de los objetos, pero presentamos a continuación una lista
326 de los objetos más comunes.
328 @multitable @columnfractions .33 .66
329 @headitem Tipo de objeto @tab Nombre del objeto
330 @item Expresiones dinámicas (verticalmente) @tab @code{DynamicLineSpanner}
331 @item Expresiones dinámicas (horizontalmente) @tab @code{DynamicText}
332 @item Ligaduras de unión @tab @code{Tie}
333 @item Ligaduras de expresión @tab @code{Slur}
334 @item Articulaciones @tab @code{Script}
335 @item Digitaciones @tab @code{Fingering}
336 @item Texto, p.ej. @code{^"text"} @tab @code{TextScript}
337 @item Llamadas de ensayo o marcas de texto @tab @code{RehearsalMark}
342 @section Common tweaks
344 Algunas sustituciones son tan comunes que se proporcionan comandos preestablecidos
345 como atajos, como @code{\slurUp} (ligadura hacia arriba) y @code{\stemDown} (plica hacia abajo). Estos
346 comandos se describen dentro de la Referencia de Notación bajo las secciones
349 La lista completa de modificaciones disponibles para cada tipo de
350 objeto (como ligaduras o barras de corchea) están documentadas en la Referencia del
351 Programa. Sin embargo, muchos objetos de la presentación comparten propiedades que se pueden
352 usar para aplicar trucos genéricos.
359 La propiedad @code{padding} (relleno) se puede establecer de forma que incremente
360 (o disminuya) la distancia entre símbolos que se imprimen encima
361 o debajo de las notas. Se aplica a todos los objetos con
362 @code{side-position-interface}.
364 @lilypond[quote,fragment,relative=1,verbatim]
366 \override Script #'padding = #3
370 @lilypond[quote,fragment,relative=1,verbatim]
371 % This will not work, see below:
372 \override MetronomeMark #'padding = #3
376 \override Score.MetronomeMark #'padding = #3
381 Observe en el segundo ejemplo cuán importante es determinar qué contexto
382 maneja un objeto determinado. Debido a que el objeto @code{MetronomeMark} (indicación metronómica)
383 se maneja en el contexto @code{Score}, los cambios de propiedades dentro del
384 contexto @code{Voice} no se tendrán en cuenta. Para ver más detalles, consulte
385 @ruser{Constructing a tweak}.
387 @cindex extra-offset (desplazamiento adicional)
390 La propiedad @code{extra-offset} mueve objetos en la salida;
391 requiere una pareja de números. El primer número
392 controla el movimiento horizontal, un número positivo moverá
393 el objeto hacia la derecha. El segundo número controla el movimiento
394 vertical; un número positivo lo desplazará hacia arriba. La
395 propiedad @code{extra-offset} es una funcionalidad de bajo nivel: el motor
396 de formateo es completamente olvidadizo respecto de estos desplazamientos.
398 En el ejemplo siguiente, la segunda digitación se desplaza un poco hacia
399 la izquierda y 1.8 espacios de pentagrama hacia abajo:
401 @lilypond[quote,fragment,relative=1,verbatim]
404 \once \override Fingering
405 #'extra-offset = #'(-0.3 . -1.8)
410 El establecimiento de la propiedad @code{transparent} provocará que un objeto se imprima
411 con @q{tinta invisible}: el objeto no se imprime, pero se conserva todo el resto
412 de su comportamiento. El objeto aún ocupa un espacio, toma parte en las colisiones,
413 y se le pueden adjuntar ligaduras de unión o de expresión y barras de corchea.
415 @cindex objetos transparentes
416 @cindex quitar objetos
417 @cindex ocultar objetos
418 @cindex objetos invisibles
419 El ejemplo siguiente demuestra cómo conectar distintas voces
420 utilizando ligaduras. Normalmente las ligaduras sólo unen dos notas de la misma voz.
421 Al introducir una ligadura en una voz distinta,
423 @lilypond[quote,fragment,relative=2]
432 y suprimiendo la primera plica hacia arriba en dicha voz, la ligadura parece cruzarse de una
436 @lilypond[quote,fragment,relative=2,verbatim]
438 \once \override Stem #'transparent = ##t
445 Para asegurarse de que la plica que hemos suprimido no aprieta demasiado a la
446 ligadura, también alargamos la plica, estableciendo su @code{length} (longitud) a
449 @lilypond[quote,fragment,relative=2,verbatim]
451 \once \override Stem #'transparent = ##t
452 \once \override Stem #'length = #8
461 @cindex Trucos, distancias
464 Las distancias en LilyPond se miden en espacios de pentagrama, mientras que
465 las propiedades de grosor se miden en grosores de líneas de pentagrama. Algunas
466 propiedades son diferentes; por ejemplo, el grosor de las barras de corchea
467 se mide en espacios de pentagrama. Para más información, consulte la porción
468 correspondiente de la referencia del programa.
475 @node Size of objects
476 @subsection Size of objects
478 UNTRANSLATED NODE: IGNORE ME
481 @section Default files
483 La documentación de la Referencia del Programa contiene una gran cantidad de información
484 sobre LilyPond, pero más información aún se puede obtener a partir de la observación
485 de los archivos internos de LilyPond.
487 Algunos ajustes por omisión como las definiciones de las
488 @code{\header@{@}}s (encabezamientos) están almacenados en archivos @code{.ly}.
489 Otros ajustes como las definiciones de los comandos de marcado se almacenan
490 como archivos @code{.scm} (de Scheme). Cae fuera del ámbito de presente manual
491 cualquier explicación más profunda; los usuarios están advertidos de que se necesita
492 una considerable cantidad de conocimientos técnicos
493 para comprender estos archivos.
497 @item Linux: @file{@var{directorio_de_instalación}/lilypond/usr/share/lilypond/current/}
500 @file{@var{carpeta_de_instalación}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
501 Para llegar aquí, o bien entre con @code{cd} en este directorio desde el
502 Terminal, o haga control-clic sobre la aplicación LilyPond y elija
503 @q{Mostrar el Contenido del Paquete}.
505 @item Windows: @file{@var{carpeta_de_instalación}/LilyPond/usr/share/lilypond/current/}
509 Los directorios @file{ly/} y @file{scm/} son de especial interés.
510 Archivos como @file{ly/property-init.ly} y
511 @file{ly/declarations-init.ly} definen todos los trucos comunes.
514 @node Fitting music onto fewer pages
515 @section Fitting music onto fewer pages
517 A veces puede acabar con uno o dos pentagramas en una segunda página
518 (o tercera, o cuarta...). Es fastidioso sobre todo si observa las
519 páginas anteriores y parece haber
520 espacio suficiente en ellas.
522 Al investigar asuntos relacionados con la presentación, la herramienta
523 @code{annotate-spacing} (anotar el espaciado) no tiene precio.
524 Este comando imprime los valores de algunos comandos de espaciado;
525 consulte @ruser{Displaying spacing} para ver más detalles. A partir de
526 la salida de de @code{annotate-spacing}, podemos ver qué márgenes podríamos desear alterar.
528 Aparte de los márgenes, existen otras opciones para ahorrar espacio:
532 Puede indicarle a LilyPond que coloque los sistemas tan juntos como sea
533 posible (para que quepan tantos sistemas como sea posible sobre una página),
534 pero luego separar estos sistemas para que no haya ningún espacio vacío
535 al final de la página.
539 between-system-padding = #0.1
540 between-system-space = #0.1
541 ragged-last-bottom = ##f
547 Puede forzar el número de sistemas (es decir, si LilyPond quiere
548 tipografiar la música con 11 sistemas, puede forzarlo
558 Evite (o reduzca) el uso de objetos que aumenten el tamaño
559 vertical de un sistema. Por ejemplo, las repeticiones con
560 primera y segunda vez necesitan espacio adicional. Si
561 estas repeticiones abarcan dos sistemas, ocuparán más espacio
562 que un solo sistema con las repeticiones y otro sistema sin ellas.
564 Otro ejemplo es desplazar las expresiones dinámicas que se
565 @q{asoman por encima} de un sistema.
567 @lilypond[verbatim,quote,fragment]
570 \override DynamicLineSpanner #'padding = #-1.8
571 \override DynamicText #'extra-offset = #'( -2.1 . 0)
577 Altere el espaciado horizontal por medio de @code{SpacingSpanner}. Consulte
578 @ruser{Changing horizontal spacing} para ver más detalles.
580 @lilypond[verbatim,quote]
583 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
584 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
585 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
586 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
591 \override SpacingSpanner
592 #'base-shortest-duration = #(ly:make-moment 1 4)
601 @node Advanced tweaks with Scheme
602 @section Advanced tweaks with Scheme
604 Hemos visto cómo la salida de LilyPond se puede modificar de manera muy profunda utilizando
606 @code{\override TextScript #'extra-offset = ( 1 . -1)}. Pero
607 tenemos un potencial incluso mayor si utilizamos Scheme. Para ver una explicación completa
608 de esto, consulte el @ruser{Scheme tutorial} e
609 @ruser{Interfaces for programmers}.
611 Podemos usar Scheme simplemente para sobreponer (@code{\override}) comandos,
613 @lilypond[quote,verbatim,ragged-right]
614 padText = #(define-music-function (parser location padding) (number?)
616 \once \override TextScript #'padding = #$padding
624 c4^"piu mosso" fis a g
628 Podemos usarlo para crear comandos nuevos,
630 @lilypond[quote,verbatim,ragged-right]
631 tempoMark = #(define-music-function (parser location padding marktext)
634 \once \override Score . RehearsalMark #'padding = $padding
635 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
636 \mark \markup { \bold $marktext }
641 \tempoMark #3.0 #"Allegro"
646 E incluso se le pueden pasar expresiones musicales.
648 @lilypond[quote,verbatim,ragged-right]
649 pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
656 \pattern {d16 dis} { ais16-> b\p }
661 @node Avoiding tweaks with slower processing
662 @section Avoiding tweaks with slower processing
664 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
665 procesa los archivos. Estos comandos consumen tiempo, pero el
666 resultado puede necesitar menos trucos manuales.
669 %% asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
670 \override Score.PaperColumn #'keep-inside-line = ##t