1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 8713b2d59884a2043803584b7b9a3b0bdf719ae6
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::
38 @node Introduction to tweaks
39 @subsection Introduction to tweaks
41 El @q{Trucaje} es un término de LilyPond que denota los diversos
42 métodos que el usuario tiene a su disposición para modificar el
43 proceso de interpretación del archivo de entrada y cambiar la
44 apariencia de la salida impresa. Algunos trucos son muy fáciles de
45 usar; otros son más complejos. Pero en su conjunto, los métodos de
46 trucaje disponibles posibilitan conseguir casi cualquier apariencia
47 que deseemos en la música impresa.
49 En esta sección vamos a estudiar los conceptos básicos que se
50 necesitan para comprender el trucaje. Más tarde daremos un amplio
51 abanico de instrucciones listas para usar, que podrá simplemente
52 copiar para obtener el mismo efecto en sus partituras, y al mismo
53 tiempo mostraremos la forma de construir dichas instrucciones para que
54 pueda aprender cómo desarrollar sus propios trucos.
56 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
57 la sección @ref{Contexts and engravers}, pues los Contextos, los
58 Grabadores y las Propiedades que se contienen en ellos son
59 fundamentales para comprender y construir los trucos.
61 @node Objects and interfaces
62 @subsection Objects and interfaces
69 El trucaje consiste en modificar el funcionamiento y estructura
70 interna del programa LilyPond, por lo que en primer lugar
71 introduciremos algunos términos que se usan para describir dichas
72 operaciones y estructuras internas.
74 El término @q{Objeto} es un término genérico que se usa para referirse
75 a la multitud de estructuras internas que LilyPond construye durante
76 el procesado de un archivo de entrada. Así, cuando se encuentra una
77 instrucción como @code{\new Staff}, se construye un objeto nuevo del
78 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
79 las propiedades asociadas con ese pentagrama en particular, por
80 ejemplo, su nombre y su armadura, además de otros detalles de los
81 grabadores que se han asignado para que operen dentro del contexto del
82 pentagrama. De forma similar, hay objetos que guardan las propieades
83 de todos los demás contextos, como objetos de @code{Voice}, objetos de
84 @code{Score}, objetos de @code{Lyrics}, así como objetos que
85 representan todos los elementos notacionales como líneas divisorias,
86 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
87 objeto tiene su propio conjunto de valores de propiedad.
89 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
90 representan elementos de notación sobre la salida impresa como cabezas
91 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
92 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
93 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
94 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
95 mencionado, y también todos ellos tienen propiedades asociadas, como
96 su posición, tamaño, color,etc.
98 Ciertos objetos de presentación son aún más especializados. Las
99 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
100 y baja, y muchos otros objetos gráficos no están situados en un solo
101 lugar: tienen un punto de inicio, un punto de final, y quizá otras
102 propiedades relacionadas con su forma. Los objetos con una forma
103 extendida como estos, reciben el nombre de «Objetos de extensión» o
106 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
107 incluso aunque son bastante diferentes, comparten funcionalidades que
108 se deben procesar de la misma manera. Por ejemplo, todos los objetos
109 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
110 propiedades se procesan de la misma forma durante la interpretación
111 del archivo de entrada por parte de LilyPond. Para simplificar estas
112 operaciones internas, estas acciones t propiedades comunes se agrupan
113 en un objeto llamado @code{grob-interface}, interface de grob. Hay
114 muchas otras agrupaciones de propiedades comunes como ésta, y cada
115 unoa recibe un nombre que acaba en @code{interface}. En total hay más
116 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
117 interés y de utilidad para el usuario.
119 Estos son, en fin, los términos principales relativos a los objetos
120 que vamos a utilizar en este capítulo.
122 @node Naming conventions of objects and properties
123 @subsection Naming conventions of objects and properties
125 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
126 sección @ref{Contexts and engravers}. En este lugar, para más fácil
127 referencia, presentamos una lista de los tipos de objetos y
128 propiedades más comunes, junto con las convenciones según las cuales
129 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
130 utilizado una «A» mayúscula para denotar cualquier carácter alfabético
131 en mayúsculas, y «aaa» para cualquier número de caracteres alfabéticos
132 en minúscula. Otros caracteres se utilizan literalmente como están.
134 @multitable @columnfractions .33 .33 .33
135 @headitem Objeto o tipo de propiedad
136 @tab Convención de nomenclatura
139 @tab Aaaa o AaaaAaaaAaaa
140 @tab Staff, GrandStaff
141 @item Objetos de presentación
142 @tab Aaaa o AaaaAaaaAaaa
145 @tab Aaaa_aaa_engraver
146 @tab Clef_engraver, Note_heads_engraver
148 @tab aaa-aaa-interface
149 @tab grob-interface, break-aligned-interface
150 @item Propiedades de contextos
151 @tab aaa o aaaAaaaAaaa
152 @tab alignAboveContext, skipBars
153 @item Propiedades de objetos de presentación
154 @tab aaa o aaa-aaa-aaa
155 @tab direction, beam-thickness
158 Como podremos ver en breve, las propiedades de distintos tipos de
159 objeto se modifican por parte de diferentes instrucciones; así pues,
160 es útil poder reconocer el tipo de objeto a partir de sus nombres de
163 @node Tweaking methods
164 @subsection Tweaking methods
166 @strong{La instrucción \override}
168 @cindex override, instrucción
171 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
172 usan para cambiar las propiedades de los @strong{contextos} y para
173 quitar y poner @strong{grabadores}, en @ref{Modifying context
174 properties} y @ref{Adding and removing engravers}. Ahora debemos
175 examinar algunas instrucciones importantes más.
177 La instrucción que cambia las propiedades de los @strong{objetos de
178 presentación} es @code{\override}. Puesto que esta instrucción debe
179 modificar propiedades internas que se encuentran en un lugar profundo
180 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
181 las instrucciones que hemos visto hasta ahora. Tiene que saber
182 exactamente qué propiedad de qué objeto y en qué contexto se debe
183 modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
185 La sintaxis genérica de esta instrucción es:
188 \override @emph{contexto}.@emph{objeto_de_presentación}
189 #'@emph{propiedad_de_presentación} = #@emph{valor}
193 Esto establecerá la propiedad de nombre
194 @emph{propiedad_de_presentación} del objeto de presentación con el
195 nombre @emph{objeto_de_presentación}, que es miembro del contexto
196 @emph{contexto}, al valor @emph{valor}.
198 El @emph{contexto} se puede omitir (y normalmente así es) cuando el
199 contexto requerido se encuentra implicado sin ambigüedad y es uno de
200 los contextos del nivel más bajo, es decir: @code{Voice},
201 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
202 ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
204 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
205 valores, pero para ilustrar el formato y utilización de estas
206 iinstrucciones usaremos sólo unas cuantas propiedades y valores
207 sencillos que sean fáciles de entender.
209 Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
210 propiedad de presentación, y el @code{#}, que debe preceder al valor.
211 Deben estar presentes siempre y de esa forma exacta. Es la
212 instrucción de uso más común dentro del trucaje, y durante la mayor
213 parte del resto de este capítulo presentaremos ejemplos de cómo se
214 usa. A continuación hay un ejemplo sencillo para cambiar el color de
217 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
219 \override NoteHead #'color = #red
221 \override NoteHead #'color = #green
225 @strong{La instrucción \revert}
227 @cindex revert, instrucción
230 Una vez sobreescrita, la proopiedad retiene su nuevo valor hasta que
231 se sobreescribe de nuevo o se encuentra una instrucción
232 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
233 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
234 valor predeterminado original; observe que no es a su valor previo si
235 se han utilizado varias instrucciones @code{\override}.
238 \revert @emph{contexto}.@emph{objeto_de_presentación} #'@emph{propiedad_de_presentación}
241 Una vez más, igual que @emph{contexto} dentro de la instrucción
242 @code{\override}, con frecuencia no es necesario especificar el
243 @emph{contexto}. Se omitirá en muchos de los ejemplos siguientes.
244 Aquí devolvemos el color de la cabeza al valor predeterminado para las
247 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
249 \override NoteHead #'color = #red
251 \override NoteHead #'color = #green
253 \revert NoteHead #'color
257 @strong{El prefijo \once}
259 Tanto la instrucción @code{\override} como @code{\set} se pueden
260 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
261 @code{\override} o @code{\set} sea efectiva solamente durante el
262 tiempo musical en curso y antes de que la propiedad vuelva a tener
263 otra vez su valor predeterminado. Utilizando el mismo ejemplo,
264 podemos cambiar el color de una sola nota de la siguiente manera:
266 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
268 \once \override NoteHead #'color = #red
270 \once \override NoteHead #'color = #green
274 @strong{La instrucción \overrideProperty}
276 @cindex overrideProperty, instrucción
277 @funindex \overrideProperty
279 Hay otra forma para la instrucción de sobreescritura,
280 @code{\overrideProperty}, que ocasionalmente es necesaria. La
281 mencionamos aquí con un propósito de exhaustividad, pero para ver más
282 detalles consulte @ruser{Difficult tweaks}.
283 @c Maybe explain in a later iteration -td
285 @strong{La instrucción \tweak}
287 @cindex tweak, instrucción
290 La última instrucción de trucaje que está disponible es @code{\tweak}.
291 Se debe utilizar para cambiar las propiedades de objetos que suceden
292 en el mismo momento musical, como las notas de un acorde. El uso de
293 @code{\override} para la sobreescritura afectaría a todas las notas
294 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
295 elemento del flujo de entrada.
297 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la nota
298 intermedia (el Mi) en un acorde de Do mayor. En primer lugar, veamos
299 lo que haría @code{\once \override}:
301 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
303 \once \override NoteHead #'font-size = #-3
308 Vemos que la sobreescritura con override afecta a @emph{todas} las
309 notas del acorde. Esto es así porque todas las notas de un acorde
310 ocurren en el mismo @emph{momento musical}, y la acción de
311 @code{\once} es aplicar la sobreescritura a todos los oobjetos de
312 presentación del tipo especificado que ocurren en el mismo momento
313 musical que la propia instrucción de sobreescritura @code{\override}.
315 LA instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
316 el elemento inmediatamente siguiente dentro del flujjo de entrada.
317 Sin embargo, es efectivo solamente sobre objetos que se crean
318 directamente a partir del flujo de entrada, en esencia las cabezas y
319 las articulaciones (los objetos como las plicas y las alteraciones se
320 crean con posterioridad y no se pueden trucar de esta forma). Es más,
321 cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
322 dentro de un acorde, es decir, dentro de ángulos simples, así que para
323 trucar una sola nota la instrucción @code{\tweak} se debe colocar
324 dentro de ángulos simples junto con la nota.
326 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
327 se cambiaría de la siguiente forma:
329 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
331 <c \tweak #'font-size #-3 e g>4
334 Observe que la sintaxis de @code{\tweak} es diferente de la de la
335 instrucción @code{\override}. Ni el contexto ni el objeto de
336 presentación se deben especificar; de hecho, generaría un error
337 hacerlo. Los dos están implícitos por el siguiente elemento del flujo
338 de entrada. Así que la sintaxis genérica de la instrucción
339 @code{\tweak} es, simmplemente:
342 \tweak #'@emph{propiedad_de_presentación} = #@emph{valor}
345 Una instrucción @code{\tweak} también se puede usar para modificar
346 sólo una de una serie de articulaciones, como se muestra aquí:
348 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
350 -\tweak #'color #red ^Red
351 -\tweak #'color #green _Green
354 Observe que la instrucción @code{\tweak} debe venir precedida de una
355 marca de articulación como si ella misma fuera una articulación.
357 @cindex grupos especiales anidados
358 @cindex tresillos anidados
359 @cindex corchete del grupo especial
360 @cindex grupo especial, corchete de
361 @cindex tresillo, corchete de
362 @funindex TupletBracket
364 La instrucción @code{\tweak} también se debe usar para cambiar la
365 apariencia de uno solo de un conjunto de grupos especiales anidados
366 que comiencen en el mismo instante musical. En el siguiente ejemplo,
367 el corchete del tresillo largo y el primero de los tres corchetes
368 cortos empiezan en el mismo momento musical, y por ello cualquier
369 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
370 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
371 @code{\tweak} especifica que el corchete del tresillo largo se debe
372 colocar por encima de las notas y el segundo especifica que el número
373 del tresillo se debe imprimir en rojo sobre el corchete del primer
376 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
377 \tweak #'direction #up
380 \times 2/3 { c8[ c8 c8] }
381 \times 2/3 { c8[ c8 c8] }
382 \times 2/3 { c8[ c8 c8] }
386 Encontrará más detalles de la instrucción @code{\tweak} en
387 @ruser{Objects connected to the input}.
389 Si los grupos anidados no comienzan en el mismo momento, su apariencia
390 se puede modificar de la forma usual mediante instrucciones
393 @c NOTE Tuplet brackets collide if notes are high on staff
395 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
396 \times 2/3 { c8[ c c]}
397 \once \override TupletNumber
398 #'text = #tuplet-number::calc-fraction-text
402 \once \override TupletNumber #'transparent = ##t
403 \times 2/3 { c8[ c c] }
404 \times 2/3 { c8[ c c]}
410 @section Moving objects
412 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos
413 elementos de notación se pueden superponer, lo que es una lástima,
414 pero en casi todos los casos se resuelve fácilmente.
416 @c FIXME: find a better example for 5.1 Moving Objects. -gp
417 @c yes, I want this TODO to be visible to end-users. It's better
418 @c than having nothing at all.
419 HACER: con las nuevas funcionalidades de espaciado en la versión 2.12, estos ejemplos específicos
420 ya no son de relevancia. Sin embargo siguen demostrando las poderosas funcionalidades de lilypond,
421 así que quedan aquí hasta que alguien elabore unos ejemplos mejores.
423 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
424 % temporary code to break this example:
425 \override TextScript #'outside-staff-priority = ##f
426 e4^\markup{ \italic ritenuto } g b e
431 La solución más fácil es aumentar la distancia entre el objeto
432 (texto en este caso, pero muy bien podrían ser digitaciones o dinámicas)
433 y la nota. En LilyPond, esto se llama la propiedad
434 @code{padding} (relleno); se mide en espacios de pentagrama. Para la mayor
435 parte de los objetos, este valor ronda la cantidad de 1.0 o menos (varía dependiendo del
436 objeto). Queremos aumentarlo, así que probaremos el valor 1.5
438 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
439 % temporary code to break this example:
440 \override TextScript #'outside-staff-priority = ##f
441 \once \override TextScript #'padding = #1.5
442 e4^\markup{ \italic ritenuto } g b e
445 Esto tiene un mejor aspecto, pero no es suficiente. Después de probar
446 con algunos valores, creemos que 2.3 es el mejor número en este caso. Sin embargo
447 esta cantidad es el mero resultado del ensayo y error y de mi gusto personal
448 acerca de la notación. Pruebe el ejemplo anterior con 2.3... pero también con otros valores
449 mayores (y menores). ¿Cuál cree que queda mejor?
451 La propiedad @code{staff-padding} (relleno de pentagrama) está estrechamente relacionada.
452 @code{padding} controla la cantidad de espacio mínima entre un objeto y el objeto más cercano
453 (generalmente la nota o las líneas del pentagrama);
454 @code{staff-padding} controla la cantidad mínima de espacio entre un
455 objeto y el pentagrama. Ello supone una sutil diferencia, pero podrá
456 observar el comportamiento a continuación.
458 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
459 % temporary code to break this example:
460 \override TextScript #'outside-staff-priority = ##f
462 \once \override TextScript #'padding = #4.6
464 \once \override TextScript #'staff-padding = #4.6
465 c4^"piu mosso" fis a g
467 c'4^"piu mosso" b a b
468 \once \override TextScript #'padding = #4.6
470 \once \override TextScript #'staff-padding = #4.6
471 c4^"piu mosso" fis a g
474 @cindex desplazamiento adicional
476 Otra solución nos proporciona un control absoluto sobre la situación del objeto: podemos
477 moverlo horizontal o verticalmente. Se hace con la propiedad
478 @code{extra-offset} (desplazamiento adicional). Es ligeramente más complicado y puede
479 causar otros problemas. Cuando movemos objetos con @code{extra-offset},
480 el movimiento se hace después de que LilyPond haya colocado todos los demás objetos.
482 que el resultado podría entrar en conflicto con otros objetos.
484 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
485 % temporary code to break this example:
486 \override TextScript #'outside-staff-priority = ##f
487 \once \override TextScript #'extra-offset = #'( 1.0 . -1.0 )
488 e4^\markup{ \italic ritenuto } g b e
491 Con @code{extra-offset}, el primer número controla el movimiento
492 horizontal (negativo hacia la izquierda); el segundo número controla el movimiento
493 vertical (positivo hacia arriba). Después de algunos ensayos, hemos decidido que los siguientes valores
496 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
497 % temporary code to break this example:
498 \override TextScript #'outside-staff-priority = ##f
499 \once \override TextScript #'extra-offset = #'( -1.6 . 1.0 )
500 e4^\markup{ \italic ritenuto } g b e
504 Una vez más, estos números son simplemente el resultado de algunos experimentos y
505 de observar la salida. Quizá prefiera que el texto se encuentre algo más arriba,
506 o a la izquierda, o en cualquier dirección. ¡Pruébelo y observe el resultado!
508 Una advertencia final: en esta sección hemos usado
511 \once \override TextScript @dots{}
514 Esto altera la presentación del texto para la nota siguiente. Si la nota no
515 tiene ningún texto, este truco no hace nada (y @strong{no} se queda esperando al
516 siguiente fragmento de texto). Para cambiar el comportamiento permanentemente a partir
517 del comando, omita el @code{\once}. Para detener este truco, use
518 @code{\revert} (revertir). Todo esto se explica en profundidad en
519 @ruser{The \override command}.
521 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
522 % temporary code to break this example:
523 \override TextScript #'outside-staff-priority = ##f
525 \once \override TextScript #'padding = #4.6
528 \once \override TextScript #'padding = #4.6
532 \override TextScript #'padding = #4.6
535 \revert TextScript #'padding
541 En el presente manual: @ruser{The \override command}, @ruser{Common tweaks}.
544 @node Fixing overlapping notation
545 @section Fixing overlapping notation
547 En @ruser{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
548 El mismo mecanismo se puede usar para mover otros tipos de
549 objetos; simplemente sustituya @code{TextScript} con el nombre de
552 Para encontrar el nombre del objeto, consulte la sección @q{@strong{véase también}} al
553 final de la página relevante dentro de la documentación. Por ejemplo, al
554 final de @ruser{Dynamics}, vemos
559 Referencia del programa: @internalsref{DynamicText}, @internalsref{Hairpin}.
560 La posición vertical de estos símbolos se maneja por medio de
561 @internalsref{DynamicLineSpanner}.
565 Así que para mover expresiones dinámicas verticalmente, usamos
568 \override DynamicLineSpanner #'padding = #2.0
571 No podemos listar todos y cada uno de los objetos, pero presentamos a continuación una lista
572 de los objetos más comunes.
574 @multitable @columnfractions .33 .66
575 @headitem Tipo de objeto @tab Nombre del objeto
576 @item Expresiones dinámicas (verticalmente) @tab @code{DynamicLineSpanner}
577 @item Expresiones dinámicas (horizontalmente) @tab @code{DynamicText}
578 @item Ligaduras de unión @tab @code{Tie}
579 @item Ligaduras de expresión @tab @code{Slur}
580 @item Articulaciones @tab @code{Script}
581 @item Digitaciones @tab @code{Fingering}
582 @item Texto, p.ej. @code{^"text"} @tab @code{TextScript}
583 @item Llamadas de ensayo o marcas de texto @tab @code{RehearsalMark}
588 @section Common tweaks
590 Algunas sustituciones son tan comunes que se proporcionan comandos preestablecidos
591 como atajos, como @code{\slurUp} (ligadura hacia arriba) y @code{\stemDown} (plica hacia abajo). Estos
592 comandos se describen dentro de la Referencia de Notación bajo las secciones
595 La lista completa de modificaciones disponibles para cada tipo de
596 objeto (como ligaduras o barras de corchea) están documentadas en la Referencia del
597 Programa. Sin embargo, muchos objetos de la presentación comparten propiedades que se pueden
598 usar para aplicar trucos genéricos.
605 La propiedad @code{padding} (relleno) se puede establecer de forma que incremente
606 (o disminuya) la distancia entre símbolos que se imprimen encima
607 o debajo de las notas. Se aplica a todos los objetos con
608 @code{side-position-interface}.
610 @lilypond[quote,fragment,relative=1,verbatim]
612 \override Script #'padding = #3
616 @lilypond[quote,fragment,relative=1,verbatim]
617 % This will not work, see below:
618 \override MetronomeMark #'padding = #3
622 \override Score.MetronomeMark #'padding = #3
627 Observe en el segundo ejemplo cuán importante es determinar qué contexto
628 maneja un objeto determinado. Debido a que el objeto @code{MetronomeMark} (indicación metronómica)
629 se maneja en el contexto @code{Score}, los cambios de propiedades dentro del
630 contexto @code{Voice} no se tendrán en cuenta. Para ver más detalles, consulte
631 @ruser{Constructing a tweak}.
633 @cindex extra-offset (desplazamiento adicional)
636 La propiedad @code{extra-offset} mueve objetos en la salida;
637 requiere una pareja de números. El primer número
638 controla el movimiento horizontal, un número positivo moverá
639 el objeto hacia la derecha. El segundo número controla el movimiento
640 vertical; un número positivo lo desplazará hacia arriba. La
641 propiedad @code{extra-offset} es una funcionalidad de bajo nivel: el motor
642 de formateo es completamente olvidadizo respecto de estos desplazamientos.
644 En el ejemplo siguiente, la segunda digitación se desplaza un poco hacia
645 la izquierda y 1.8 espacios de pentagrama hacia abajo:
647 @lilypond[quote,fragment,relative=1,verbatim]
650 \once \override Fingering
651 #'extra-offset = #'(-0.3 . -1.8)
656 El establecimiento de la propiedad @code{transparent} provocará que un objeto se imprima
657 con @q{tinta invisible}: el objeto no se imprime, pero se conserva todo el resto
658 de su comportamiento. El objeto aún ocupa un espacio, toma parte en las colisiones,
659 y se le pueden adjuntar ligaduras de unión o de expresión y barras de corchea.
661 @cindex objetos transparentes
662 @cindex quitar objetos
663 @cindex ocultar objetos
664 @cindex objetos invisibles
665 El ejemplo siguiente demuestra cómo conectar distintas voces
666 utilizando ligaduras. Normalmente las ligaduras sólo unen dos notas de la misma voz.
667 Al introducir una ligadura en una voz distinta,
669 @lilypond[quote,fragment,relative=2]
678 y suprimiendo la primera plica hacia arriba en dicha voz, la ligadura parece cruzarse de una
682 @lilypond[quote,fragment,relative=2,verbatim]
684 \once \override Stem #'transparent = ##t
691 Para asegurarse de que la plica que hemos suprimido no aprieta demasiado a la
692 ligadura, también alargamos la plica, estableciendo su @code{length} (longitud) a
695 @lilypond[quote,fragment,relative=2,verbatim]
697 \once \override Stem #'transparent = ##t
698 \once \override Stem #'length = #8
707 @cindex Trucos, distancias
710 Las distancias en LilyPond se miden en espacios de pentagrama, mientras que
711 las propiedades de grosor se miden en grosores de líneas de pentagrama. Algunas
712 propiedades son diferentes; por ejemplo, el grosor de las barras de corchea
713 se mide en espacios de pentagrama. Para más información, consulte la porción
714 correspondiente de la referencia del programa.
721 @node Size of objects
722 @subsection Size of objects
724 UNTRANSLATED NODE: IGNORE ME
727 @section Default files
729 La documentación de la Referencia del Programa contiene una gran cantidad de información
730 sobre LilyPond, pero más información aún se puede obtener a partir de la observación
731 de los archivos internos de LilyPond.
733 Algunos ajustes por omisión como las definiciones de las
734 @code{\header@{@}}s (encabezamientos) están almacenados en archivos @code{.ly}.
735 Otros ajustes como las definiciones de los comandos de marcado se almacenan
736 como archivos @code{.scm} (de Scheme). Cae fuera del ámbito de presente manual
737 cualquier explicación más profunda; los usuarios están advertidos de que se necesita
738 una considerable cantidad de conocimientos técnicos
739 para comprender estos archivos.
743 @item Linux: @file{@var{directorio_de_instalación}/lilypond/usr/share/lilypond/current/}
746 @file{@var{carpeta_de_instalación}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
747 Para llegar aquí, o bien entre con @code{cd} en este directorio desde el
748 Terminal, o haga control-clic sobre la aplicación LilyPond y elija
749 @q{Mostrar el Contenido del Paquete}.
751 @item Windows: @file{@var{carpeta_de_instalación}/LilyPond/usr/share/lilypond/current/}
755 Los directorios @file{ly/} y @file{scm/} son de especial interés.
756 Archivos como @file{ly/property-init.ly} y
757 @file{ly/declarations-init.ly} definen todos los trucos comunes.
760 @node Fitting music onto fewer pages
761 @section Fitting music onto fewer pages
763 A veces puede acabar con uno o dos pentagramas en una segunda página
764 (o tercera, o cuarta...). Es fastidioso sobre todo si observa las
765 páginas anteriores y parece haber
766 espacio suficiente en ellas.
768 Al investigar asuntos relacionados con la presentación, la herramienta
769 @code{annotate-spacing} (anotar el espaciado) no tiene precio.
770 Este comando imprime los valores de algunos comandos de espaciado;
771 consulte @ruser{Displaying spacing} para ver más detalles. A partir de
772 la salida de de @code{annotate-spacing}, podemos ver qué márgenes podríamos desear alterar.
774 Aparte de los márgenes, existen otras opciones para ahorrar espacio:
778 Puede indicarle a LilyPond que coloque los sistemas tan juntos como sea
779 posible (para que quepan tantos sistemas como sea posible sobre una página),
780 pero luego separar estos sistemas para que no haya ningún espacio vacío
781 al final de la página.
785 between-system-padding = #0.1
786 between-system-space = #0.1
787 ragged-last-bottom = ##f
793 Puede forzar el número de sistemas (es decir, si LilyPond quiere
794 tipografiar la música con 11 sistemas, puede forzarlo
804 Evite (o reduzca) el uso de objetos que aumenten el tamaño
805 vertical de un sistema. Por ejemplo, las repeticiones con
806 primera y segunda vez necesitan espacio adicional. Si
807 estas repeticiones abarcan dos sistemas, ocuparán más espacio
808 que un solo sistema con las repeticiones y otro sistema sin ellas.
810 Otro ejemplo es desplazar las expresiones dinámicas que se
811 @q{asoman por encima} de un sistema.
813 @lilypond[verbatim,quote,fragment]
816 \override DynamicLineSpanner #'padding = #-1.8
817 \override DynamicText #'extra-offset = #'( -2.1 . 0)
823 Altere el espaciado horizontal por medio de @code{SpacingSpanner}. Consulte
824 @ruser{Changing horizontal spacing} para ver más detalles.
826 @lilypond[verbatim,quote]
829 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
830 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
831 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
832 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
837 \override SpacingSpanner
838 #'base-shortest-duration = #(ly:make-moment 1 4)
847 @node Advanced tweaks with Scheme
848 @section Advanced tweaks with Scheme
850 Hemos visto cómo la salida de LilyPond se puede modificar de manera muy profunda utilizando
852 @code{\override TextScript #'extra-offset = ( 1 . -1)}. Pero
853 tenemos un potencial incluso mayor si utilizamos Scheme. Para ver una explicación completa
854 de esto, consulte el @ruser{Scheme tutorial} e
855 @ruser{Interfaces for programmers}.
857 Podemos usar Scheme simplemente para sobreponer (@code{\override}) comandos,
859 @lilypond[quote,verbatim,ragged-right]
860 padText = #(define-music-function (parser location padding) (number?)
862 \once \override TextScript #'padding = #$padding
870 c4^"piu mosso" fis a g
874 Podemos usarlo para crear comandos nuevos,
876 @lilypond[quote,verbatim,ragged-right]
877 tempoMark = #(define-music-function (parser location padding marktext)
880 \once \override Score . RehearsalMark #'padding = $padding
881 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
882 \mark \markup { \bold $marktext }
887 \tempoMark #3.0 #"Allegro"
892 E incluso se le pueden pasar expresiones musicales.
894 @lilypond[quote,verbatim,ragged-right]
895 pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
902 \pattern {d16 dis} { ais16-> b\p }
907 @node Avoiding tweaks with slower processing
908 @section Avoiding tweaks with slower processing
910 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
911 procesa los archivos. Estos comandos consumen tiempo, pero el
912 resultado puede necesitar menos trucos manuales.
915 %% asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
916 \override Score.PaperColumn #'keep-inside-line = ##t