1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: a34c05adfcc1e0976250ffefd34d4eb73daecab1
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 * The Internals Reference manual::
20 * Appearance of objects::
21 * Placement of objects::
22 * Collisions of objects::
27 @section Tweaking basics
30 * Introduction to tweaks::
31 * Objects and interfaces::
32 * Naming conventions of objects and properties::
36 @node Introduction to tweaks
37 @subsection Introduction to tweaks
39 El @q{Trucaje} es un término de LilyPond que denota los diversos
40 métodos que el usuario tiene a su disposición para modificar el
41 proceso de interpretación del archivo de entrada y cambiar la
42 apariencia de la salida impresa. Algunos trucos son muy fáciles de
43 usar; otros son más complejos. Pero en su conjunto, los métodos de
44 trucaje disponibles posibilitan conseguir casi cualquier apariencia
45 que deseemos en la música impresa.
47 En esta sección vamos a estudiar los conceptos básicos que se
48 necesitan para comprender el trucaje. Más tarde daremos un amplio
49 abanico de instrucciones listas para usar, que podrá simplemente
50 copiar para obtener el mismo efecto en sus partituras, y al mismo
51 tiempo mostraremos la forma de construir dichas instrucciones para que
52 pueda aprender cómo desarrollar sus propios trucos.
54 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
55 la sección @ref{Contexts and engravers}, pues los Contextos, los
56 Grabadores y las Propiedades que se contienen en ellos son
57 fundamentales para comprender y construir los trucos.
59 @node Objects and interfaces
60 @subsection Objects and interfaces
67 El trucaje consiste en modificar el funcionamiento y estructura
68 interna del programa LilyPond, por lo que en primer lugar
69 introduciremos algunos términos que se usan para describir dichas
70 operaciones y estructuras internas.
72 El término @q{Objeto} es un término genérico que se usa para referirse
73 a la multitud de estructuras internas que LilyPond construye durante
74 el procesado de un archivo de entrada. Así, cuando se encuentra una
75 instrucción como @code{\new Staff}, se construye un objeto nuevo del
76 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
77 las propiedades asociadas con ese pentagrama en particular, por
78 ejemplo, su nombre y su armadura, además de otros detalles de los
79 grabadores que se han asignado para que operen dentro del contexto del
80 pentagrama. De forma similar, hay objetos que guardan las propieades
81 de todos los demás contextos, como objetos de @code{Voice}, objetos de
82 @code{Score}, objetos de @code{Lyrics}, así como objetos que
83 representan todos los elementos notacionales como líneas divisorias,
84 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
85 objeto tiene su propio conjunto de valores de propiedad.
87 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
88 representan elementos de notación sobre la salida impresa como cabezas
89 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
90 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
91 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
92 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
93 mencionado, y también todos ellos tienen propiedades asociadas, como
94 su posición, tamaño, color,etc.
96 Ciertos objetos de presentación son aún más especializados. Las
97 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
98 y baja, y muchos otros objetos gráficos no están situados en un solo
99 lugar: tienen un punto de inicio, un punto de final, y quizá otras
100 propiedades relacionadas con su forma. Los objetos con una forma
101 extendida como estos, reciben el nombre de «Objetos de extensión» o
104 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
105 incluso aunque son bastante diferentes, comparten funcionalidades que
106 se deben procesar de la misma manera. Por ejemplo, todos los objetos
107 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
108 propiedades se procesan de la misma forma durante la interpretación
109 del archivo de entrada por parte de LilyPond. Para simplificar estas
110 operaciones internas, estas acciones t propiedades comunes se agrupan
111 en un objeto llamado @code{grob-interface}, interface de grob. Hay
112 muchas otras agrupaciones de propiedades comunes como ésta, y cada
113 unoa recibe un nombre que acaba en @code{interface}. En total hay más
114 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
115 interés y de utilidad para el usuario.
117 Estos son, en fin, los términos principales relativos a los objetos
118 que vamos a utilizar en este capítulo.
120 @node Naming conventions of objects and properties
121 @subsection Naming conventions of objects and properties
123 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
124 sección @ref{Contexts and engravers}. En este lugar, para más fácil
125 referencia, presentamos una lista de los tipos de objetos y
126 propiedades más comunes, junto con las convenciones según las cuales
127 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
128 utilizado una «A» mayúscula para denotar cualquier carácter alfabético
129 en mayúsculas, y «aaa» para cualquier número de caracteres alfabéticos
130 en minúscula. Otros caracteres se utilizan literalmente como están.
132 @multitable @columnfractions .33 .33 .33
133 @headitem Objeto o tipo de propiedad
134 @tab Convención de nomenclatura
137 @tab Aaaa o AaaaAaaaAaaa
138 @tab Staff, GrandStaff
139 @item Objetos de presentación
140 @tab Aaaa o AaaaAaaaAaaa
143 @tab Aaaa_aaa_engraver
144 @tab Clef_engraver, Note_heads_engraver
146 @tab aaa-aaa-interface
147 @tab grob-interface, break-aligned-interface
148 @item Propiedades de contextos
149 @tab aaa o aaaAaaaAaaa
150 @tab alignAboveContext, skipBars
151 @item Propiedades de objetos de presentación
152 @tab aaa o aaa-aaa-aaa
153 @tab direction, beam-thickness
156 Como podremos ver en breve, las propiedades de distintos tipos de
157 objeto se modifican por parte de diferentes instrucciones; así pues,
158 es útil poder reconocer el tipo de objeto a partir de sus nombres de
161 @node Tweaking methods
162 @subsection Tweaking methods
164 @strong{La instrucción \override}
166 @cindex override, instrucción
169 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
170 usan para cambiar las propiedades de los @strong{contextos} y para
171 quitar y poner @strong{grabadores}, en @ref{Modifying context
172 properties} y @ref{Adding and removing engravers}. Ahora debemos
173 examinar algunas instrucciones importantes más.
175 La instrucción que cambia las propiedades de los @strong{objetos de
176 presentación} es @code{\override}. Puesto que esta instrucción debe
177 modificar propiedades internas que se encuentran en un lugar profundo
178 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
179 las instrucciones que hemos visto hasta ahora. Tiene que saber
180 exactamente qué propiedad de qué objeto y en qué contexto se debe
181 modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
183 La sintaxis genérica de esta instrucción es:
186 \override @emph{contexto}.@emph{objeto_de_presentación}
187 #'@emph{propiedad_de_presentación} = #@emph{valor}
191 Esto establecerá la propiedad de nombre
192 @emph{propiedad_de_presentación} del objeto de presentación con el
193 nombre @emph{objeto_de_presentación}, que es miembro del contexto
194 @emph{contexto}, al valor @emph{valor}.
196 El @emph{contexto} se puede omitir (y normalmente así es) cuando el
197 contexto requerido se encuentra implicado sin ambigüedad y es uno de
198 los contextos del nivel más bajo, es decir: @code{Voice},
199 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
200 ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
202 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
203 valores, pero para ilustrar el formato y utilización de estas
204 iinstrucciones usaremos sólo unas cuantas propiedades y valores
205 sencillos que sean fáciles de entender.
207 Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
208 propiedad de presentación, y el @code{#}, que debe preceder al valor.
209 Deben estar presentes siempre y de esa forma exacta. Es la
210 instrucción de uso más común dentro del trucaje, y durante la mayor
211 parte del resto de este capítulo presentaremos ejemplos de cómo se
212 usa. A continuación hay un ejemplo sencillo para cambiar el color de
215 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
217 \override NoteHead #'color = #red
219 \override NoteHead #'color = #green
223 @strong{La instrucción \revert}
225 @cindex revert, instrucción
228 Una vez sobreescrita, la proopiedad retiene su nuevo valor hasta que
229 se sobreescribe de nuevo o se encuentra una instrucción
230 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
231 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
232 valor predeterminado original; observe que no es a su valor previo si
233 se han utilizado varias instrucciones @code{\override}.
236 \revert @emph{contexto}.@emph{objeto_de_presentación} #'@emph{propiedad_de_presentación}
239 Una vez más, igual que @emph{contexto} dentro de la instrucción
240 @code{\override}, con frecuencia no es necesario especificar el
241 @emph{contexto}. Se omitirá en muchos de los ejemplos siguientes.
242 Aquí devolvemos el color de la cabeza al valor predeterminado para las
245 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
247 \override NoteHead #'color = #red
249 \override NoteHead #'color = #green
251 \revert NoteHead #'color
255 @strong{El prefijo \once}
257 Tanto la instrucción @code{\override} como @code{\set} se pueden
258 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
259 @code{\override} o @code{\set} sea efectiva solamente durante el
260 tiempo musical en curso y antes de que la propiedad vuelva a tener
261 otra vez su valor predeterminado. Utilizando el mismo ejemplo,
262 podemos cambiar el color de una sola nota de la siguiente manera:
264 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
266 \once \override NoteHead #'color = #red
268 \once \override NoteHead #'color = #green
272 @strong{La instrucción \overrideProperty}
274 @cindex overrideProperty, instrucción
275 @funindex \overrideProperty
277 Hay otra forma para la instrucción de sobreescritura,
278 @code{\overrideProperty}, que ocasionalmente es necesaria. La
279 mencionamos aquí con un propósito de exhaustividad, pero para ver más
280 detalles consulte @ruser{Difficult tweaks}.
281 @c Maybe explain in a later iteration -td
283 @strong{La instrucción \tweak}
285 @cindex tweak, instrucción
288 La última instrucción de trucaje que está disponible es @code{\tweak}.
289 Se debe utilizar para cambiar las propiedades de objetos que suceden
290 en el mismo momento musical, como las notas de un acorde. El uso de
291 @code{\override} para la sobreescritura afectaría a todas las notas
292 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
293 elemento del flujo de entrada.
295 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la nota
296 intermedia (el Mi) en un acorde de Do mayor. En primer lugar, veamos
297 lo que haría @code{\once \override}:
299 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
301 \once \override NoteHead #'font-size = #-3
306 Vemos que la sobreescritura con override afecta a @emph{todas} las
307 notas del acorde. Esto es así porque todas las notas de un acorde
308 ocurren en el mismo @emph{momento musical}, y la acción de
309 @code{\once} es aplicar la sobreescritura a todos los oobjetos de
310 presentación del tipo especificado que ocurren en el mismo momento
311 musical que la propia instrucción de sobreescritura @code{\override}.
313 LA instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
314 el elemento inmediatamente siguiente dentro del flujjo de entrada.
315 Sin embargo, es efectivo solamente sobre objetos que se crean
316 directamente a partir del flujo de entrada, en esencia las cabezas y
317 las articulaciones (los objetos como las plicas y las alteraciones se
318 crean con posterioridad y no se pueden trucar de esta forma). Es más,
319 cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
320 dentro de un acorde, es decir, dentro de ángulos simples, así que para
321 trucar una sola nota la instrucción @code{\tweak} se debe colocar
322 dentro de ángulos simples junto con la nota.
324 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
325 se cambiaría de la siguiente forma:
327 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
329 <c \tweak #'font-size #-3 e g>4
332 Observe que la sintaxis de @code{\tweak} es diferente de la de la
333 instrucción @code{\override}. Ni el contexto ni el objeto de
334 presentación se deben especificar; de hecho, generaría un error
335 hacerlo. Los dos están implícitos por el siguiente elemento del flujo
336 de entrada. Así que la sintaxis genérica de la instrucción
337 @code{\tweak} es, simmplemente:
340 \tweak #'@emph{propiedad_de_presentación} = #@emph{valor}
343 Una instrucción @code{\tweak} también se puede usar para modificar
344 sólo una de una serie de articulaciones, como se muestra aquí:
346 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
348 -\tweak #'color #red ^Red
349 -\tweak #'color #green _Green
352 Observe que la instrucción @code{\tweak} debe venir precedida de una
353 marca de articulación como si ella misma fuera una articulación.
355 @cindex grupos especiales anidados
356 @cindex tresillos anidados
357 @cindex corchete del grupo especial
358 @cindex grupo especial, corchete de
359 @cindex tresillo, corchete de
360 @funindex TupletBracket
362 La instrucción @code{\tweak} también se debe usar para cambiar la
363 apariencia de uno solo de un conjunto de grupos especiales anidados
364 que comiencen en el mismo instante musical. En el siguiente ejemplo,
365 el corchete del tresillo largo y el primero de los tres corchetes
366 cortos empiezan en el mismo momento musical, y por ello cualquier
367 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
368 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
369 @code{\tweak} especifica que el corchete del tresillo largo se debe
370 colocar por encima de las notas y el segundo especifica que el número
371 del tresillo se debe imprimir en rojo sobre el corchete del primer
374 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
375 \tweak #'direction #up
378 \times 2/3 { c8[ c8 c8] }
379 \times 2/3 { c8[ c8 c8] }
380 \times 2/3 { c8[ c8 c8] }
384 Encontrará más detalles de la instrucción @code{\tweak} en
385 @ruser{Objects connected to the input}.
387 Si los grupos anidados no comienzan en el mismo momento, su apariencia
388 se puede modificar de la forma usual mediante instrucciones
391 @c NOTE Tuplet brackets collide if notes are high on staff
393 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
394 \times 2/3 { c8[ c c]}
395 \once \override TupletNumber
396 #'text = #tuplet-number::calc-fraction-text
400 \once \override TupletNumber #'transparent = ##t
401 \times 2/3 { c8[ c c] }
402 \times 2/3 { c8[ c c]}
406 @node The Internals Reference manual
407 @section The Internals Reference manual
409 @cindex Internals Reference
412 * Properties of layout objects::
413 * Properties found in interfaces::
414 * Types of properties::
417 @node Properties of layout objects
418 @subsection Properties of layout objects
420 @cindex propiedades de los objetos de presentación
421 @cindex propiedades de los grobs
422 @cindex grobs, propiedades de
423 @cindex presentación, propiedades de los objetos de
425 Suponga que tiene una partitura con una ligadura de expresión que para
426 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
427 debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
428 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
429 piensa que una cierta instrucción de sobreescritura @code{\override}
430 será necesaria. Pero ¿existe una propiedad de grosor para las
431 ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
432 interviene el Manual de Funcionamiento Interno. Contiene toda la
433 información que puede necesitar para construir ésta y todas las demás
434 instrucciones @code{\override}, de sobreescritura.
436 Una advertencia antes de dirigir nuestra mirada a la referencia de
437 funcionamiento interno. Éste es un documento de @strong{referencia},
438 lo que significa que hay pocas o ninguna explicación en él: su
439 propósito es presentar la información de forma precisa y concisa. Por
440 tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
441 La guía y las explicaciones que presentamos aquí le permitirán extraer
442 la información de la referencia de funcionamiento interno por sí mismo
443 con tan sólo algo de práctica.
445 @cindex sobreescritura, ejemplo de
446 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
448 Utilicemos un ejemplo concreto con un sencillo fragmento de música
451 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
456 g[( e]) e d[( f]) a |
460 The man who feels love's sweet e -- mo -- tion
465 Suponga ahora que decidimos que nos gustan las ligaduras algo más
466 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
467 presentación, así que la cuestión es @q{¿Hay una propiedad
468 perteneciente a las ligaduras de expresión que controle su grosor?}
469 Para responder a esta pregunta debemos mirar el manual de Referencia
470 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
471 (Internals Reference) en inglés}.
473 El RFI de la versión de LilyPond que está usando se puede encontrar en
474 la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
475 página de la documentación y siga el enlace Manual de Referencia de
476 Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
477 sería mejor que utilizase la versión html, no la @q{en una sola
478 página} ni el PDF. Para que los siguientes párrafos tengan algún
479 sentido deberá consultarlo realmente al tiempo que lee.
481 @c Link names in English as these pages are not yet translated
482 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
483 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
484 información sobre los objetos de presentación. Una vez allí, bajo el
485 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
486 objects}. La página que aparece relaciona todos los objetos de
487 presentación que se usan en su versión de LilyPond, en orden
488 alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
489 relacionadas las propiedades de las ligaduras de expresión o Slurs.
491 (Una forma alternativa de encontrar esta página es a partir de la
492 Referencia de la Notación. En una de las páginas que tratan de las
493 ligaduras de expresión podrá encontrar un enlace al manual de
494 referencia del funcioonamiento interno. Este enlace le llevará
495 directamente a esta página, aunque con frecuencia es más fácil ir
496 directamente al RFI y buscar allí.)
498 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
499 dice en primer lugar que los objetos Slur se crean por el grabador
500 Slur_engraver. A continuación relaciona los ajustes estándar.
501 Observe que @strong{no} están en orden alfabético. Navegue hacia
502 abajo buscando una propiedad que pudiera controlar el grosor de las
503 ligaduras, y encontrará
506 @code{thickness} (number)
508 Line thickness, generally measured in @code{line-thickness}
511 Esto promete ser una buena opción para cambiar el grosor. Nos dice
512 que el valor de @code{thickness} es un simple @emph{número}, que el
513 valor predeterminado es 1.2, y que las unidades están dentro de otra
514 propiedad llamada @code{line-thickness}.
516 Como dijimos con anterioridad, existen entre pocas y ninguna
517 explicación en el RFI, pero ya tenemos información suficiente para
518 probar a cambiar el grosor de la ligadura. Vemos que el nombre del
519 objeto de presentación es @code{Slur}, que el nombre de la propiedad
520 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
521 un número algo más grande que 1.2 si queremos hacer las ligaduras más
524 Ahora podemos construir la instrucción de sobreescritura
525 @code{\override} simplemente mediante la sustitución de los valores
526 que hemos encontrado para los nombres, omitiendo el contexto.
527 Usaremos un valor muy grande para el grosor al principio, para estar
528 seguros de que la instrucción está funcionando. Obtenemos lo
532 \override Slur #'thickness = #5.0
535 ¡No olvide el @code{#'} antes del nombre de la propiedad y @code{#}
536 antes del valor nuevo!
538 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
539 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
540 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
541 cerca de ella.} Hagámoslo así:
543 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
547 % Increase thickness of all following slurs from 1.2 to 5.0
548 \override Slur #'thickness = #5.0
550 g[( e]) e d[( f]) a |
554 The man who feels love's sweet e -- mo -- tion
560 y podemos ver que la ligadura, es sin duda, más pesada.
562 Así pues, ésta es la forma básica de construir instrucciones
563 @code{\override} o de sobreescritura. Existen unas cuantas
564 complicaciones más con las que nos encontraremos en secciones
565 posteriores, pero ahora conoce todos los principios esenciales que
566 necesita para hacerlo por sí mismo (aunque aún necesita algo de
567 práctica). La cual vendrá proporcionada por los ejemplos que vienen a
570 @subheading Finding the context
571 @cindex contexto, encontrar
573 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
574 especificar el contexto? ¿Cuál sería? Podemos suponer que las
575 ligaduras están en el contexto de Voz, por estar claramente asociados
576 de manera estrecha con las líneas individuales de música, pero
577 ¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
578 de la página del RFI que describe las ligaduras (Slur), donde dice
579 @q{Slur objects are created by: Slur engraver} («Los objetos de
580 ligadura de expresión se crean por: el grabador Slur»). Así pues, las
581 ligaduras de expresión se crean en cualquier contexto en el que se
582 encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
583 página del grabador @code{Slur_engraver}. Al final del todo, dice que
584 el grabador @code{Slur_engraver} es parte de cinco contextos de voz,
585 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
586 suposición era acertada. Y a causa de que @code{Voice} es uno de los
587 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
588 por el hecho de que estamos escribiendo notas, podemos omitirlo en
591 @subheading Overriding once only
593 @cindex sobreescritura por una sola vez
594 @cindex once override
597 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
598 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
599 ligadura fuese más gruesa? Esto se consigue con la instrucción o
600 prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
601 @code{\override} ocasiona que solamente cambie la ligadura que
602 comienza en la nota @strong{inmediata siguiente}. Si la nota
603 inmediata siguiente no da inicio a una ligadura, la instrucción no
604 tiene niingún efecto en absoluto: no se recuerda hasta que se
605 encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
606 la instrucción que lleva @code{\once} se debe reposicionar de la forma
609 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
614 % Increase thickness of immediately following slur only
615 \once \override Slur #'thickness = #5.0
617 g[( e]) e d[( f]) a |
621 The man who feels love's sweet e -- mo -- tion
627 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
629 La instrucción o prefijo @code{\once} también se puede usar antes de
630 la instrucción @code{\set}.
632 @subheading Reverting
635 @cindex predeterminadas, devolver a las propiedades
638 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
639 fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
640 una de ellas precedida por el prefijo @code{\once}, situadas
641 inmediatamente antes de cada una de las notas en que comienzan las
644 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
649 % Increase thickness of immediately following slur only
650 \once \override Slur #'thickness = #5.0
652 % Increase thickness of immediately following slur only
653 \once \override Slur #'thickness = #5.0
654 g[( e]) e d[( f]) a |
658 The man who feels love's sweet e -- mo -- tion
664 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
665 instrucción @code{\revert} (restablecer) para devolver la propiedad
666 del grosor, @code{thickness}, a su valor predeterminado después de la
669 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
674 % Increase thickness of all following slurs from 1.2 to 5.0
675 \override Slur #'thickness = #5.0
678 % Revert thickness of all following slurs to default of 1.2
679 \revert Slur #'thickness
684 The man who feels love's sweet e -- mo -- tion
690 la instrucción @code{\revert} se puede utilizar para devolver
691 cualquier propiedad que se haya cambiado con @code{\override} a su
692 valor predeterminado. Puede utilizar el método que mejor se adapte a
693 aquello que quere hacer.
695 Así finaliza nuestra introducción al manual de RFI, y el método básico
696 de trucaje. A continuación, en las últimas secciones de este capítulo
697 encontrará varios ejemplos, en parte para introducirle en algunas de
698 las posibilidades adicionales del manual RFI, y en parte para
699 proporcionarle más práctica en cómo extraer información de él. Estos
700 ejemplos irán conteniendo cada vez menos palabras de guía y
703 @node Properties found in interfaces
704 @subsection Properties found in interfaces
706 @cindex propiedades de los interfaces
707 @cindex interfaces, propiedades
709 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
710 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
711 En primer lugar miramos en la página del RFI que relaciona todos los
712 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
713 pueda conteolar la letra de la canción. Encontramos @code{LyricText},
714 que parece adecuado. Al seguir este enlace se presentan las
715 propiedades ajustables para el texto de la letra. Estos incluyen
716 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
717 una forma cursiva. Esto es porque la propiedad de la forma es común a
718 todos los objetos de fuente tipográfica, y por tanto, en vez de
719 incluirlo en cada uno de los objetos de preesentación, se agrupa junto
720 con otras propiedades comunes similares y se deposita en un
721 @strong{Interface}, el interface de las fuentes tipográficas
722 @code{font-interface}.
724 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
725 de los interfaces, y descubrir qué objetos usan estas propiedades de
728 Mire de nuevo la página del RFI que decribe a LyricText. Al final de
729 la página hay una lista de enlaces (en las versiones de html del RFI)
730 a los interfaces que LyricText contempla. La lista tiene siete
731 elementos, entre ellos @code{font-interface}. Al seguir este enlace
732 llegamos a las propiedades asociadas con este interface, que también
733 son propiedades de todos los objetos que lo llevan, entre ellos
736 Ahora vemos todas las propiedades ajustables por el usuario que
737 controlan las tipografías, entre ellas @code{font-shape(symbol)},
738 donde @code{symbol} se puede establecer a @code{upright} (recta),
739 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
741 Observará que @code{font-series} y @code{font-size} también se
742 encuentran aquí relacionadas. Esto inmediatamente hace que surja la
743 pregunta: ¿Por qué están las propiedades comunes de tipografía
744 @code{font-series} y @code{font-size} relacionadas bajo
745 @code{LyricText} así como bajo el interface @code{font-interface} pero
746 @code{font-shape} no lo está? La respuesta es que @code{font-series}
747 y @code{font-size} se cambian a partir de sus valores predeterminados
748 globales cuando se crea un objeto @code{LyricText}, pero
749 @code{font-shape} no lo hace. Entonces los elementos de la lista
750 @code{LyricText} le dicen los valores para esas dos propiedades que
751 son de aplicación para @code{LyricText}. Otros objetos que contemplan
752 @code{font-interface} establecerán dichas propiedades de forma
753 diferente cuando se crean.
755 Veamos si ahora podemos construir la instrucción @code{\override} para
756 cambiar la letra a cursiva. El objeto es @code{LyricText}, la
757 propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
758 antes, omitiremos el contexto.
760 Como nota aparte, aunque una nota importante, observe que a causa de
761 que los valores de @code{font-shape} son símbolos, deben ir precedidos
762 de un apóstrofe, @code{'}. Esa es la razón por la que se necesitan
763 apóstrofes antes de @code{thickness} en el ejemplo anterior y en
764 @code{font-shape}. Los dos son también símbolos. Los símbolos son
765 nombres especiales que son conocidos por LilyPond internamente.
766 Algunos de ellos son nombres de propiedades, como @code{thickness} o
767 @code{font-shape}, otros son en efecto valores especiales que se les
768 puede dar a las propiedades, como @code{italic}. Observe la
769 distincion entre esto y las cadenas de texto arbitrarias, que
770 aparecerían entrecomilladas como @code{"a text string"}.
772 De acuerdo, entonces la instrucción @code{\override} que necesitamos
773 para imprimir la letra en cursiva sería
776 \override LyricText #'font-shape = #'italic
780 y debe colocarse justo delante de, y cerca de, la letra a la que debe
783 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
788 g[( e]) e d[( f]) a |
792 \override LyricText #'font-shape = #'italic
793 The man who feels love's sweet e -- mo -- tion
799 y toda la letra se imprime en cursiva.
801 @subheading Specifying the context in lyric mode
802 @cindex contexto, especificación en modo letra
804 En el caso de la letra, si intenta especificar el contexto en el
805 formato que acabamnos de dar, la instrucción no funcionará. Una
806 sílaba escrita en el modo letra, «lyricmode» temina en un espacio, un
807 salto de línea o un dígito. Cualquier otro carácter se incluye como
808 parte de la sílaba. Por esta razón, un espacio o salto de línea debe
809 aparecer antes del último símbolo @code{@}} para evitar que se incluya
810 como parte de la sílaba final. De forma similar, se deben insertar
811 espacios antes y después del punto, @q{.}, separando el nombre del
812 contexto del nombre del objeto, pues en caso contrario los dos nombres
813 se juntarán y el intérprete no podrá reconocerlos. Así pues, la
817 \override Lyrics . LyricText #'font-shape = #'italic
820 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
821 final y la llave de cierre.}
823 @warning{En las sobreescrituras con override dentro de la letra,
824 escriba siempre espacios antes y después del punto que separa el
825 nombre del contexto y el nombre del objeto.}
827 @node Types of properties
828 @subsection Types of properties
830 @cindex propiedades, tipos de
832 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
833 @code{símbolo}. Para que sea válido, el valor que se da a una
834 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
835 tipo. El tipo de la propiedad se muestra siempre entre paréntesis
836 después del nombre de la propiedad en el RFI. He aquí una lista de
837 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
838 algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
839 @code{#}, por supuesto, delante de estos valores cuando se introducen
840 en la instrucción @code{\override}.
842 @multitable @columnfractions .2 .45 .35
843 @headitem Tipo de propiedad
847 @tab Verdadero o Falso, representado por #t o #f
848 @tab @code{#t}, @code{#f}
849 @item Dimensión (en espacios de pentagrama)
850 @tab Un número decimal positivo (en unidades de espacios de pentagrama)
851 @tab @code{2.5}, @code{0.34}
853 @tab Una constante válida de dirección o su equivalente numérico
854 @tab @code{#LEFT}, @code{#CENTER}, @code{#UP},
857 @tab Un número entero positivo
858 @tab @code{3}, @code{1}
860 @tab Un conjunto de elementos entre paréntesis separados por espacios y precedido de un apóstrofe
861 @tab @code{'(left-edge staff-bar)}, @code{'(1)},
862 @code{'(1.0 0.25 0.5)}
864 @tab Cualquier elemento válido de marcado de texto
865 @tab @code{\markup @{ \italic "cresc." @}}
867 @tab Una fracción de redonda construida con la función make-moment
868 @tab @code{(ly:make-moment 1 4)},
869 @code{(ly:make-moment 3 8)}
871 @tab Cualquier valor decimal positivo o negativo
872 @tab @code{3.5}, @code{-2.45}
873 @item Pareja (de números)
874 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofe
875 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
877 @tab Cualquiera del conjunto de símbolos premitidos para esa propiedad, precedido de un apóstrofe
878 @tab @code{'italic}, @code{'inside}
880 @tab Un procedimiento o @code{#f} (para no producir ninguna acción)
881 @tab @code{bend::print}, @code{ly:text-interface::print},
884 @tab Una lista de tres elementos encerrados entre paréntesis y precedida de una almohadilla, @code{#}.
885 @tab @code{#(#t #t #f)}
888 @node Appearance of objects
889 @section Appearance of objects
891 Ahora vamos a poner en práctica lo que hemos aprendido con unos
892 cuantos ejemplos que muestran cómo se pueden usar los trucos para
893 cambiar el aspecto de la música impresa.
896 * Visibility and color of objects::
898 * Length and thickness of objects::
901 @node Visibility and color of objects
902 @subsection Visibility and color of objects
904 Dentro de un uso educativo de la música, podríamos desear imprimir una
905 partitura con ciertos elementos omitidos como ejercicio para el
906 alumno, a quien se le pide que los complete. A la manera de ejemplo
907 sencillo, supongamos que el ejercicio es escribir las líneas
908 divisorias que faltan en un fragmento musical. Pero las líneas
909 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
912 Antes de enredarnos con esto, recordemos que las propiedades de los
913 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
914 @ref{Properties found in interfaces}). Esto es simplemente agrupar
915 las propiedades que normalmente se necesitan juntas: si una de ellas
916 se necesita para un objeto, también las otras. Así, ciertos objetos
917 necesitan las propiedades de algunos interfaces, otros necesitan las
918 de otros interfaces. Los interfaces que contienen las propiedades que
919 un determinado grob necesita se ecuentran relacionadas en el manual
920 RFI al final de la página que describe dicho grob, y esas propiedades
921 se pueden ver mirando dichos interfaces.
923 Hemos explicado cómo encontrar información sobre los grobs en
924 @ref{Properties of layout objects}. Usando el mismo enfoque, vamos al
925 RFI para biscar el objeto de presentación que imprime las líneas
926 divisorias. A través del enlace @emph{Backend} y @emph{All layout
927 objects} encontramos que hay un objeto de presentación llamado
928 @code{BarLine}. Entre sus propiedades se encuentran dos que controlan
929 la visibilidad: @code{break-visibility} y @code{stencil}. Las líneas
930 divisorias también contemplan un número de interfaces, entre ellos el
931 @code{grob-interface}, donde podemos encontrar las propiedades
932 @code{transparent} y @code{color}. Todas ellas pueden afectar la
933 visibilidad de las barras de compás (y, por supuesto, por extensión,
934 tambén la de muchos otros objetos de presentación). Vamos a
935 considerar cada uno de ellos por orden.
938 @cindex stencil (sello), propiedad
940 Esta propiedad controla la apariencia de las barras de compás mediante
941 la especificación del símbolo (o «glifo») que se debe imprimir. Igual
942 que como otras muchas propiedades, se puede establecer de forma que no
943 imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
944 antes, omitiendo el Contexto implícito, @code{Voice}:
946 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
949 \override BarLine #'stencil = ##f
956 Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
957 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
958 objeto BarLine. Al principio de la página dice @qq{Barline objects
959 are created by: Bar_engraver} (los objetos Barline se crean por el
960 grabador Bar_engraver). Vaya a la página del grabador
961 @code{Bar_engraver} siguiendo el enlace. Al final da una lista de
962 contextos en los que el grabador de líneas divisorias opera. Todos
963 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
964 @code{\override} no funcionara como esperábamos, es porque
965 @code{Barline} no se encuentra en el contexto predeterminado
966 @code{Voice}. Si el contexto se especifica mal, la instrucción
967 simplemente no funciona. No se produce ningún mensaje de error, y no
968 se registra nada en el archivo log de registro. Vamos a intentar
969 corregirlo escribiendo el contexto correcto:
971 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
974 \override Staff.BarLine #'stencil = ##f
981 Ahora las barras de compás han desaparecido.
983 @subheading break-visibility
985 @cindex break-visibility property
987 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI que
988 la propiedad @code{break-visibility} requiere un vector de tres
989 valores booleanos. Controlan respectivamente si las barras de compás
990 se imprimen al final de una línea, en mitad de una línea, y al
991 principio de las líneas. Para nuestro ejemplo, queremos que todas las
992 barras de compás se supriman, por lo que el valor que necesitamos es
993 @code{#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
994 de @code{Staff}. Observa también que al escribir este valor tenemos
995 dos símbolos de almohadilla antes del paréntesis de apertura. Se
996 necesita uno como parte del valor para introducir un vector, y se
997 necesita otro más, como siempre, para precered el propio valor dentro
998 de la instrucción @code{\override}.
1000 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1003 \override Staff.BarLine #'break-visibility = ##(#f #f #f)
1005 g, a16 b8 c d4 e16 |
1010 Y podemos ver que esto también quita todas las líneas divisorias.
1012 @subheading transparent
1013 @cindex transparente, propiedad
1015 En la relación de propiedades que se especifican en la página del
1016 @code{grob-interface} del RFI podemos ver que la propiedad
1017 @code{transparent} es un valor booleano. Esto se debe establecer a
1018 @code{#t} para hacer que el grob sea transparente. En el ejemplo
1019 siguiente vamos a hacer que la indicación de compás, y no las líneas
1020 divisorias, sea transparente. Para hacerlo tenemos que buscar el
1021 nombre del grob de la indicación de compás. Volviendo a la página
1022 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1023 presentación @code{TimeSignature}. Se produce por parte del grabador
1024 @code{Time_signature_engraver} que como puede comprobar vive dentro
1025 del contexto de @code{Staff} y también contempla el interface
1026 @code{grob-interface}. Así pues, la instrucción que hace transparente
1027 a la indicación de compás es:
1029 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1032 \override Staff.TimeSignature #'transparent = ##t
1034 g, a16 b8 c d4 e16 |
1040 El compás ya no está, pero esta instrucción deja una separación en el
1041 lugar donde antes estaba la indicación de compás. Quizá esto es lo
1042 que queremos para un ejercicio en que el alumno deba escribirlo, pero
1043 en otras circunstancias esta separación podría no ser deseable. En
1044 vez de eso, para quitarla, el stencil o «sello» de la indicación de
1045 compás se debe establecer al valor @code{#f}:
1047 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1050 \override Staff.TimeSignature #'stencil = ##f
1052 g, a16 b8 c d4 e16 |
1058 y la diferencia es obvia: al establecer el sello al valor @code{#f}
1059 quitamos el objeto por completo; al hacer el objeto @code{transparent}
1060 lo dejamos donde está, pero lo hacemos invisible.
1063 @cindex color, propiedad
1065 PAra finalizar, podríamos hacer invisibles las barras de compás
1066 pintándolas de color blanco. El interface @code{grob-interface}
1067 especifica que la propiedad del color es una lista, pero no hay
1068 ninguna explicación sobre lo que debe ir en esa lista. La lista que
1069 requiere es realmente una lista de valores en unidades internas, pero
1070 para evitar tener que saber cuáles son, se ofrecen varias vías para la
1071 especificación de los colores. La primera forma es utilizar uno de
1072 los colores @q{normales} que están relacionados en la primera tabla de
1073 la @ruser{List of colors}. Para poner las líneas divisorias de color
1076 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1079 \override Staff.BarLine #'color = #white
1081 g, a16 b8 c d4 e16 |
1087 y de nuevo podemos comprobar que las barras de compás no son visibles.
1088 Observe que @emph{white} no viene precedido de un apóstrofe: no es un
1089 símbolo, sino una @emph{función}. Cuando se invoca, proporciona la
1090 lista de valores internos que se requieren para establecer el color a
1091 blanco. Los otros colores de la lista normal también son funciones.
1092 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1093 una de las otras funciones de la lista.
1095 @cindex colores de X11
1096 @cindex X11, colores de
1098 La segunda forma de cambiar el color es utilizar la lista de nombres
1099 de colores de X11 que aparecen en la segunda lista de @ruser{List of
1100 colors}. Sin embargo, éstos deben ir precedidos de otra función, que
1101 convierte los nombres de colores de X11 en la lista de valores
1102 internos, @code{x11-color}, de la siguiente manera:
1104 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1107 \override Staff.BarLine #'color = #(x11-color 'white)
1109 g, a16 b8 c d4 e16 |
1115 Observe que en este caso la función @code{x11-color} toma un símbolo
1116 como argumento, así que el símbolo debe ir precedido de un apóstrofe y
1117 los dos deben ir entre paréntesis.
1119 @cindex rgb, colores
1122 Aún hay una tercera función, que convierte valores RGB en colores
1123 internos: la función @code{rgb-color}. Toma tres argumentos que dan
1124 las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
1125 valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
1126 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1127 @code{(rgb-color 1 1 1)}:
1129 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1132 \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1134 g, a16 b8 c d4 e16 |
1139 Finalmente, existe también una escala de grises como parte del
1140 conjunto de colores de X11. Varían desde el negro, @code{'grey0'},
1141 hsta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
1142 estableciendo todos los objetos de presentación de nuestro ejemplo a
1143 varias gradaciones de gris:
1145 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1148 \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
1149 \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1150 \override Staff.Clef #'color = #(x11-color 'grey60)
1151 \override Voice.NoteHead #'color = #(x11-color 'grey85)
1152 \override Voice.Stem #'color = #(x11-color 'grey85)
1153 \override Staff.BarLine #'color = #(x11-color 'grey10)
1155 g, a16 b8 c d4 e16 |
1161 Observe los contextos asociados con cada uno de los objetos de
1162 presentación. Es importante que estén correctamente escritos, o las
1163 instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
1164 que se encuentra el grabador correspondiente. El contesto
1165 predeterminado para los grabadores puede encontrarse empezando por el
1166 objeto de presentación, de ahí al grabador que lo produce, y en la
1167 página del grabador del RFI aparece en qué contexto se puede encontrar
1168 normalmente el grabador.
1171 @node Size of objects
1172 @subsection Size of objects
1174 Empezaremos examinando de nuevo un ejemplo anterior (véase
1175 @ref{Nesting music expressions}) que nos mostraba cómo introducir un
1176 pentagrama temporal, como en un @rglos{ossia}.
1178 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1179 \new Staff ="main" {
1186 alignAboveContext = "main" }
1194 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1195 por lo normal se imprimen más pequeños que el pentagrama principal.
1196 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1197 el sello de cada uno de ellos a @code{#f}, como sigue:
1199 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1200 \new Staff ="main" {
1207 alignAboveContext = "main"
1210 \override Staff.Clef #'stencil = ##f
1211 \override Staff.TimeSignature #'stencil = ##f
1221 donde el par de llaves adicional después de la cláusula @code{\with}
1222 es necesario para asegurar que la sobreescritura encerrada y la música
1223 se aplican al pentagrama de ossia.
1225 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1226 usando @code{\with} y modificar los sellos de clave y de compás con
1227 \override? La diferencia principal es que los cambios que se realizan
1228 enuna cláusula @code{\with} se hacen en el momento en que se crea el
1229 contexto, y permanecen activos como valores @strong{predeterminados}
1230 durante toda la duración de dicho contexto, mientras que las
1231 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1232 música son dinámicas: hacen cambios sincronizados con un punto
1233 concreto de la música. Si los cambios se deshacen o se devuelven
1234 mediante @code{\unset} o @code{\revert} volverán a su valor
1235 predeterminado que será el establecido en la cláusula @code{\with}, o
1236 si no se ha establecido ninguno en este lugar, los valores
1237 predeterminados normales.
1239 Ciertas propiedades de contexto se pueden modificar solamente dentro
1240 de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
1241 cambiar después de que el contexto se ha creado.
1242 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1243 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1244 alineación está decidida y no tendría sentido intentar cambiarla más
1247 Los valores predeterminados de las propiedades de los objetos de
1248 presentación también se pueden establever dentro de cláusulas
1249 @code{\with}. Simplemente utilice la instrucción @code{\override}
1250 normal dejando aparte el nombre del contextom ya que está definido sin
1251 ambigüedad como el contexto que la cláusula @code{\with} está
1252 modificando. De hecho, se producirá un error si se especifica un
1253 contexto en este lugar.
1255 Así pues, podemos reemplazar el ejemplo anterior con
1257 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1258 \new Staff ="main" {
1265 alignAboveContext = "main"
1266 % Don't print clefs in this staff
1267 \override Clef #'stencil = ##f
1268 % Don't print time signatures in this staff
1269 \override TimeSignature #'stencil = ##f
1278 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1281 Ciertos objetos de presentación se crean como glifos sacados de una
1282 fuente tipográfica. Entre ellos se encuentran las cabezas,
1283 alteraciones, elementos de marcado, claves, indicaciones de compás,
1284 indicaciones dinámicas y la letra de las canciones. Su tamaño se
1285 cambia mediante la modificación de la propiedad @code{font-size}, como
1286 veremos en breve. Otros objetos de presentación como ligaduras de
1287 unión y de expresión (en general, objetos de extensión) se trazan
1288 individualmente, por lo que no hay un tamaño de tipografía
1289 @code{font-size} asociado a ellos. Estos objetos generalmente derivan
1290 su tamaño de los objetos a los que están adosados, y por ello
1291 normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
1292 otras propiedades como la longitud de las plicas y las barras de
1293 compás, el grosor de las barras de corchea y otras líneas, y la
1294 separación de las líneas del pentagrama se deben modificar de otras
1297 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1298 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1299 cambiar el tamaño de las tipografías de cada uno de los tipos de
1300 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1303 \override NoteHead #'font-size = #-2
1306 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1307 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1308 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1315 Los dos enunciados producirían una reducción del tamaño de la
1316 tipografía en dos pasos a partir de su valor previo, donde cada paso
1317 reduce o aumenta el tamaño aproximadamente en un 12%.
1319 Vamos a probarlo en nuestro ejemplo del ossia:
1321 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1322 \new Staff ="main" {
1329 alignAboveContext = "main"
1330 \override Clef #'stencil = ##f
1331 \override TimeSignature #'stencil = ##f
1332 % Reduce all font sizes by ~24%
1342 Aún no está demasiado bien. Las cabezas y los corchetes de las notas
1343 son más pequeños, pero las plicas son demasiado largas en proporción,
1344 y las líneas del pentagrama están demasiado separadas entre sí. Se
1345 debe reducir su escala en proporción a la reducción de la tipografía.
1346 El siguiente apartado trata sobre cómo se hace esto.
1348 @node Length and thickness of objects
1349 @subsection Length and thickness of objects
1355 @cindex tamaño, cambiar
1356 @cindex plica, cambiar la longitud
1357 @cindex pentagrama, cambiar la separación de las líneas
1359 Las distancias y longitudes en LilyPond se miden generalmente en
1360 espacios de pentagrama, la distancia entre líneas adyacentes de la
1361 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1362 de las propiedades de @code{thickness} (grosor) se miden en unidades
1363 de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
1364 de forma predeterminada, a las líneas de los reguladores se les da un
1365 grosor de 1 unidad de @code{line-thickness}, mientras que el
1366 @code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
1367 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1368 barras de corchea se mide en espacios de pentagrama.
1370 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1371 tamaño de la tipografía? Se puede hacer con la ayuda de una función
1372 especial que se llama @code{magstep}, pensada especialmente para este
1373 propósito. Toma un argumento, el cambio de tamaño de la tipografía
1374 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1375 para reducir otros objetos en la misma proporción. Se usa de la
1378 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1379 \new Staff ="main" {
1386 alignAboveContext = "main"
1387 \override Clef #'stencil = ##f
1388 \override TimeSignature #'stencil = ##f
1390 % Reduce stem length and line spacing to match
1391 \override StaffSymbol #'staff-space = #(magstep -2)
1401 Puesto que la longitud de las plicas y muchas otras propiedades
1402 relacionadas con la longitudse calculan siempre con relación al valor
1403 de la propiedad @code{staff-space}, su longitud también ve reducida su
1404 escala automáticamente. Observe que esto afecta solamente a la escala
1405 vertical del ossia: la escala horizontal se determina por medio de la
1406 disposición de la música principal con el objeto de mantenerse en
1407 sincronía con ella, de forma que no resulte afectada por ninguno de
1408 estos cambios de tamaño. Por supuesto, si la escala de toda la música
1409 principal se cambiase de esta forma, entonces el espaciado horizontal
1410 se vería afectado. Trataremos de esto más tarde en la sección sobre
1413 Esto, en fin, completa la creación de un ossia. Los tamaños y
1414 longitudes del resto de los objetos se pueden modificar de manera
1417 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1418 grosor de las diversas líneas dibujadas como divisorias, barras de
1419 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1420 ajuste global. Si el grosor de cualquier objeto de presentación en
1421 particular necesita ajustarse, se puede hacer mejor mediante la
1422 sobreescritura de su propiedad @code{thickness}. Anteriormente
1423 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1424 @ref{Properties of layout objects}. El grosor de todos los objetos
1425 trazados (es decir, aquellos que no se producen a partir de una
1426 tipografía) se pueden cambiar de la misma forma.
1429 @node Placement of objects
1430 @section Placement of objects
1433 * Automatic behaviour::
1434 * Within-staff objects::
1435 * Outside staff objects::
1439 @node Automatic behaviour
1440 @subsection Automatic behaviour
1442 Hay ciertos objetos en notación musical que pertenecen al pentagrama y
1443 otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
1444 objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
1447 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1448 pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
1449 se fijan por la propia música; se posicionan verticalmente sobre
1450 líneas específicas del pentagrama o están unidos a otros objetos
1451 posicionados de esta forma. Las colisiones entre cabezas, plicas y
1452 alteraciones en acordes de notas muy juntas, normalmente se evitan
1453 automáticamente. Hay instrucciones y sobreescrituras que pueden
1454 modificar este comportamiento automático, como veremos en breve.
1456 Entre los objetos que pertenecen al exterior de la pauta se encuentran
1457 cosas como las marcas de ensayo, las marcas de texto y las de
1458 dinámica. La regla de LilyPond para la colocación vertical de los
1459 objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
1460 como sea posible, pero no tan cerca como para que puedan chocar con
1461 algún otro objeto. LilyPond utiliza la propiedad
1462 @code{outside-staff-priority} para determinar el orden en que se deben
1463 situar los objetos, como veremos ahora.
1465 En primer lugar, LilyPond sitúa todos los objetos
1466 dentro-del-pentagrama. Después ordena los objetos
1467 fuera-del-pentagrama de acuerdo con su prioridad
1468 @code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
1469 toman de uno en uno, comenzando por el que tiene la prioridad
1470 @code{outside-staff-priority} más baja, y se sitúan de forma que no
1471 colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
1472 grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
1473 la prioridad @code{outside-staff-priority} más baja se colocará más
1474 cerca del pentagrama. Si dos objetos tienen la misma
1475 @code{outside-staff-priority}, el que se ha encontrado primero se
1476 situará más cerca de la pauta.
1478 En el siguiente ejemplo, todos los textos de marcado tienen la misma
1479 prioridad (pues no se ha establecido explícitamente). Observe que
1480 @q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
1481 acomodado por debajo de @q{Text2}.
1483 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1490 Los pentagramas también se posicionan, de forma predeterminada, tan
1491 cerca unos de otros como sea posible (sujeto a una separación mínima).
1492 Si las notas se proyectan muy lejos en dirección a un pentagrama
1493 adyacente, forzarán a alejarse a los pentagramas sólo si en caso
1494 contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
1495 siguiente muestra esta acomodación @q{nestling} de las notas sobre
1496 pentagramas adyacentes:
1498 @lilypond[quote,ragged-right,verbatim]
1501 \relative c' { c a, }
1504 \relative c'''' { c a, }
1510 @node Within-staff objects
1511 @subsection Within-staff objects
1513 Ya hemos visto cómo las instrucciones @code{\voiceXXX} affectan a la
1514 dirección de las ligaduras de expresión y de unión, digitaciones y
1515 todo lo demás que dependa de la dirección de las plicas. Cuando se
1516 escribe música polifónica, estas instrucciones son esenciales para que
1517 puedan distinguirse varias líneas melódicas entrelazadas. Pero
1518 ocasionalmente puede ser necesario sobreescribir este comportamiento
1519 automático. Se puede hacer por secciones de música completas o
1520 incluso para una nota individual. La propiedad que controla este
1521 comportamiento es la propiedad de @code{direction} (dirección) de cada
1522 objeto de presentación. En primer lugar explicaremos qué hace esto, y
1523 lueco introduciremos algunas instrucciones listas para usar que le
1524 evitarán tener que codificar sobreescrituras explícitas para las
1525 modificaciones más comunes.
1527 Algunos objetos de presentación como las ligaduras se curvan hacia
1528 arriba o hacia abajo; otros como las plicas y los corchetes también se
1529 mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
1530 hacia abajo. Esto se controla automáticamente cuando está establecida
1531 la propiedad @code{direction}.
1533 El ejemplo siguiente muestra en el compás 1 el comportamiento
1534 predeterminado de las plicas, con las de las notas agudas apuntando
1535 hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
1536 todas las plicas forzadas hacia abajo, cuatro notas con las plicas
1537 forzadas hacia arriba, y por último cuatro notas devueltas al
1538 comportamiento predeterminado.
1540 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1542 \override Stem #'direction = #DOWN
1544 \override Stem #'direction = #UP
1546 \revert Stem #'direction
1550 Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
1551 (arriba). Éstos tienen los valores @code{-1} y @code{+1}
1552 respectivamente, y dichos valores numéricos también se pueden usar
1553 directamente. El valor @code{0} también se puede usar en algunos
1554 casos. Se trata simplemente con el significado de @code{UP} para las
1555 plicas, pero para algunos objetos tiene el significado de
1556 @q{centrado}. Existe una constante @code{CENTER} que tiene el valor
1559 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
1560 están disponibles instrucciones predefinidas equivalentes más
1561 sencillas. Aquí podemos ver una tabla de las más comunes. Se
1562 menciona el significado de cada una allí donde no es obvio.
1564 @multitable @columnfractions .2 .2 .2 .4
1565 @headitem Abajo o Izquierda
1566 @tab Arriba o Derecha
1569 @item @code{\arpeggioDown}
1570 @tab @code{\arpeggioUp}
1571 @tab @code{\arpeggioNeutral}
1572 @tab La flecha está abajo, arriba o no hay flecha
1573 @item @code{\dotsDown}
1575 @tab @code{\dotsNeutral}
1576 @tab Dirección del desplazamiento para evitar las líneas del pentagrama
1577 @item @code{\dynamicDown}
1578 @tab @code{\dynamicUp}
1579 @tab @code{\dynamicNeutral}
1581 @item @code{\phrasingSlurDown}
1582 @tab @code{\phrasingSlurUp}
1583 @tab @code{\phrasingSlurNeutral}
1584 @tab Nota: diferente de las instrucciones de ligaduras de expresión
1585 @item @code{\slurDown}
1587 @tab @code{\slurNeutral}
1589 @item @code{\stemDown}
1591 @tab @code{\stemNeutral}
1593 @item @code{\textSpannerDown}
1594 @tab @code{\textSpannerUp}
1595 @tab @code{\textSpannerNeutral}
1596 @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
1597 @item @code{\tieDown}
1599 @tab @code{\tieNeutral}
1601 @item @code{\tupletDown}
1602 @tab @code{\tupletUp}
1603 @tab @code{\tupletNeutral}
1604 @tab Los grupos especiales están debajo o encima de las notas
1607 Observe que estas instrucciones predefinidas @strong{no} pueden ir
1608 precedidas de @code{\once}. Si quiere limitar el efecto a una sola
1609 nota, deberá elegir entre usar la instrucción @code{\once \override}
1610 equivalente, o usar la instrucción predefinida, seguida después de la
1611 nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
1613 @subheading Fingering
1614 @cindex digitación, colocación
1616 La colocación de las digitaciones también resulta afectada por el
1617 valor de su propiedad @code{direction}, pero existen instrucciones
1618 especiales que permiten controlar las digitaciones de notas
1619 individuales, situando la digitación encima, debajo, a la izquierda o
1620 a la derecha de cada nota.
1622 En primer lugar, he aquí el efecto de @code{direction} sobre las
1623 digitaciones; el primer compás muestra el comportamiento
1624 predeterminado, y después el efecto de especificar @code{DOWN} y
1627 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1629 \override Fingering #'direction = #DOWN
1631 \override Fingering #'direction = #UP
1635 Así es como se controla la digitación sobre notas aisladas, pero la
1636 propiedad @code{direction} se ignora para los acordes. En su lugar,
1637 de forma predeterminada las digitaciones se colocan automáticamente
1638 encima y debajo de las notas del acorde, como se muestra aquí:
1640 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1646 Es posible tener un mayor control sobre la situación exacta de las
1647 digitaciones mediante la utilización de la instrucción @code{\set
1648 fingeringOrientations}. El formato de esta instrucción es
1651 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
1655 se utiliza @code{\set} porque @code{fingeringOrientations} es una
1656 propiedad del contexto @code{Voice}, creado y usado por el grabador
1657 @code{New_fingering_engraver}.
1659 La propiedad se puede establecer al valor de una lista de entre uno y
1660 tres valores. Controla si las digitaciones se pueden colocar por
1661 encima (si @code{up} aparece en la lista), por debajo (si aparece
1662 @code{down}), a la izquierda (si aparece @code{left}) o a la derecha
1663 (si aparece @code{right}). A la inversa, si una colocación no está en
1664 la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
1665 coma estas restricciones y se trabaja la mejor colocación para la
1666 digitación de las notas de los acordes que siguen. Observe que
1667 @code{left} y @code{right} son mutuamente excluyentes: las
1668 digitaciones pueden situarse en un lado o en el otro, no en los dos.
1670 Para controlar la colocación de la digitacion de una sola nota usando
1671 esta instrucción es necesario escribirla como un acorde de una sola
1672 nota encerrándola entre ángulos simples.
1674 Aquí podemos ver algunos ejemplos:
1676 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1677 \set fingeringOrientations = #'(left)
1679 < c-1 e-2 g-3 b-5 > 4
1680 \set fingeringOrientations = #'(left)
1682 < c-1 e-2 g-3 b-5 > 4
1683 \set fingeringOrientations = #'(up left down)
1685 < c-1 e-2 g-3 b-5 > 4
1686 \set fingeringOrientations = #'(up left)
1688 < c-1 e-2 g-3 b-5 > 4
1689 \set fingeringOrientations = #'(right)
1691 < c-1 e-2 g-3 b-5 > 4
1695 Si la digitación parece un poco superpoblada, se puede reducir el
1696 tamaño @code{font-size}. El valor predeterminado puede verse en el
1697 objeto @code{Fingering} del RFI que es @code{-5}, así que probaremos
1700 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1701 \override Fingering #'font-size = #-7
1702 \set fingeringOrientations = #'(left)
1704 < c-1 e-2 g-3 b-5 > 4
1705 \set fingeringOrientations = #'(left)
1707 < c-1 e-2 g-3 b-5 > 4
1708 \set fingeringOrientations = #'(up left down)
1710 < c-1 e-2 g-3 b-5 > 4
1711 \set fingeringOrientations = #'(up left)
1713 < c-1 e-2 g-3 b-5 > 4
1714 \set fingeringOrientations = #'(right)
1716 < c-1 e-2 g-3 b-5 > 4
1719 @node Outside staff objects
1720 @subsection Outside staff objects
1722 Los objetos fuera-del-pentagrama se colocan automáticamente para
1723 evitar las colisiones. Los objetos que tienen el valor más bajo de la
1724 propiedad @code{outside-staff-priority} se sitúan más cerca del
1725 pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
1726 tanto como sea necesario para evitar la colisión. La prioridad
1727 @code{outside-staff-priority} se defina en el @code{grob-interface} y
1728 así es una propiedad de todos los objetos de presentación. De forma
1729 predeterminada se establece a @code{#f} para todos los objetos
1730 dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
1731 fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
1732 presenta los valores numéricos predeterminados para algunos de los
1733 objetos fuera-del-pentagrama que están inicialmente dentro de los
1734 contextos @code{Staff} o @code{Voice}.
1736 @multitable @columnfractions .3 .3 .3
1737 @headitem Objeto de presentación
1739 @tab Controla la posición de:
1740 @item @code{MultiMeasureRestText}
1742 @tab Texto sobre silencios de compás completo
1743 @item @code{TextScript}
1745 @tab Elementos de marcado de texto
1746 @item @code{OttavaBracket}
1748 @tab Corchetes de octava alta y baja
1749 @item @code{TextSpanner}
1751 @tab Objetos de extensión de texto
1752 @item @code{DynamicLineSpanner}
1754 @tab Todas las indicaciones dinámicas
1755 @item @code{VoltaBracketSpanner}
1757 @tab Corchetes de primera y segunda vez
1758 @item @code{TrillSpanner}
1760 @tab Trinos mantenidos
1763 He aquí un ejemplo que muestra la situación predeterminada de algunos
1766 @cindex texto, extensiones de
1767 @funindex \startTextSpan
1768 @funindex \stopTextSpan
1769 @cindex octava alta y baja, corchete de
1771 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1772 % Set details for later Text Spanner
1773 \override TextSpanner #'bound-details #'left #'text
1774 = \markup { \small \bold Slower }
1775 % Place dynamics above staff
1777 % Start Ottava Bracket
1782 % Add Dynamic Line Spanner
1788 c\ff c \stopTextSpan
1789 % Stop Ottava Bracket
1794 Este ejemplo también muestra cómo crear textos con extensión (Text
1795 Spanners) : textos con líneas extensoras por encima de una sección de
1796 música. El extensor abarca desde la instrucción @code{\startTextSpan}
1797 hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
1798 define por medio de la instrucción @code{\override TextSpanner}. Para
1799 ver más detalles, consulte @ruser{Text spanners}.
1801 También muestra la manera de crear corchetes de octava alta y baja.
1803 Observe que los números de compás, las indicaciones metronómicas y las
1804 mercas de ensayo no se muestran. De forma predeterminada, se crean
1805 dentro del contexto @code{Score} y su prioridad
1806 @code{outside-staff-priority} se ignora con relación a los objetos de
1807 presentación que se crean dentro del contexto @code{Staff}. Si quiere
1808 colocar los números de compás, indicaciones metronómicas o llamadas de
1809 ensayo en concordancia con el valor de su
1810 @code{outside-staff-priority}, los grabadores
1811 @code{Bar_number_engraver}, @code{Metronome_mark_engraver} o
1812 @code{Mark_engraver} respectivamente se deben eliminar del contexto
1813 @code{Score} y colocarlos en el contexto @code{Staff} del nivel
1814 superior. Si se hace así, estas marcas obtendrán los siguientes
1815 valores predeterminados de @code{outside-staff-priority}:
1817 @multitable @columnfractions .3 .3
1818 @headitem Objeto de presentación @tab Prioridad
1819 @item @code{RehearsalMark} @tab @code{1500}
1820 @item @code{MetronomeMark} @tab @code{1000}
1821 @item @code{BarNumber} @tab @code{ 100}
1824 Si los valores predeterminados de @code{outside-staff-priority} no le
1825 ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
1826 de cualquiera de los objetos. Suponga que quisiéramos que el corchete
1827 de octava estuviera situado por debajo del elemento extensor de texto
1828 en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
1829 prioridad de @code{OttavaBracket} en el RFI o en las tablas
1830 anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
1831 recordando que @code{OttavaBracket} se crea dentro del contexto de
1834 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1835 % Set details for later Text Spanner
1836 \override TextSpanner #'bound-details #'left #'text
1837 = \markup { \small \bold Slower }
1838 % Place dynamics above staff
1840 %Place following Ottava Bracket below Text Spanners
1841 \once \override Staff.OttavaBracket #'outside-staff-priority = #340
1842 % Start Ottava Bracket
1847 % Add Dynamic Line Spanner
1853 c\ff c \stopTextSpan
1854 % Stop Ottava Bracket
1859 Los cambios en @code{outside-staff-priority} también se pueden emplear
1860 para controlar la situación vertical de los objetos individuales,
1861 aunque los resultados pueden no siempre ser deseables. Suponga que
1862 quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
1863 bajo el epígrafe Comportamiento Automático de más arriba (véase
1864 @ref{Automatic behaviour}). Todo lo que debemos hacer es localizar la
1865 prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
1866 aumentar la prioridad de @qq{Text3} hasta un valor superior:
1868 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1871 \once \override TextScript #'outside-staff-priority = #500
1876 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
1877 también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
1878 desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
1879 realmente queremos hacer es posicionar todas las anotaciones a la
1880 misma distancia por encima del pentagrama? Para hacerlo, vamos a
1881 necesitar claramente espaciar las notas en sentido horizontal para
1882 hacer sitio para el texto. Estoo se hace empleando la instrucción
1883 @code{textLengthOn}.
1885 @subheading \textLengthOn
1887 @funindex \textLengthOn
1888 @cindex notas, espaciar junto al texto
1890 De forma predeterminada, el texto producido mediante marcado no ocupa
1891 ningún espacio horizontal en cuanto se refiere a la disposición de la
1892 música. La instrucción @code{\textLengthOn} invierte este
1893 comportamiento, ocasionando que las notas resulten tan espaciadas como
1894 sea necesario para acomodar el texto:
1896 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1897 \textLengthOn % Cause notes to space out to accommodate text
1904 La instrucción para volver al comportamiento predeterminado es
1905 @code{\textLengthOff}. Recuerde que @code{\once} funciona solamente
1906 con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
1907 que no se puede usar con @code{\textLengthOn}.
1909 El texto de marcado también evita las notas que se proyectan por
1910 encima del pentagrama. Si esto no es lo que deseamos, el
1911 desplazamiento automático hacia arriba se puede desactivar mediante el
1912 establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
1913 muestra cómo el texto de marcado interactúa con tales notas.
1915 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1916 % This markup is short enough to fit without collision
1920 % This is too long to fit, so it is displaced upwards
1924 % Turn off collision avoidance
1925 \once \override TextScript #'outside-staff-priority = ##f
1929 % Turn off collision avoidance
1930 \once \override TextScript #'outside-staff-priority = ##f
1931 \textLengthOn % and turn on textLengthOn
1932 c,,2^"Long Text " % Spaces at end are honoured
1937 @subheading Dynamics
1939 Las indicaciones de matiz dinámico normalmente se colocarán por debajo
1940 del pentagrama, pero se pueden posicionar por encima con la
1941 instrucción @code{dynamicUp}. Se situarán verticalmente respecto a la
1942 nota a la que van adosadas, y flotarán por debajo (o por encima) de
1943 todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
1944 y números de compás. Esto puede ofrecer resultados bastante
1945 aceptables, como muestra este ejemplo:
1947 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1952 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
1953 ees,2.~\)\mf ees4 r8 |
1956 Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
1957 muy cerca, la colocación automática evitará las colisiones desplazando
1958 las marcas dinámicas posteriores más lejos, aunque este puede no ser
1959 el lugar óptimo, como muestra el siguiente ejemplo más bien
1962 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1968 Si se presentara una situación similar en música @q{real}, podría ser
1969 preferible espaciar las notas un poco más entre sí, de forma que todas
1970 las marcas dinámicas puedan caber a la misma distancia vertical desde
1971 el pentagrama. Hemos sido capaces de hacer esto para el texto de
1972 marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
1973 una instrucción equivalente para las indicaciones de matiz dinámico.
1974 Por tanto, tendremos que averiguar cómo hacerlo utilizando
1975 instrucciones @code{\override}.
1977 @subheading Grob sizing
1979 @cindex grob, cambio de tamaño de un
1980 @cindex escala de los grobs
1981 @cindex @code{X-offset}
1982 @cindex @code{Y-offset}
1983 @cindex @code{X-extent}
1984 @cindex @code{Y-extent}
1986 En primer lugar debemos aprender cómo se especifica el tamaño de los
1987 grobs. Todos los grobs tienen un punto de referencia definido dentro
1988 de ellos que se usa para colocarlos respecto a su objeto padre.
1989 Entonces, este punto del grob se posiciona a una distancia horizontal,
1990 @code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
1991 de su padre. La dimensión horizontal del objeto viene dada por una
1992 pareja de números, @code{X-extent}, que dice dónde están los límites
1993 izquierdo y derecho respecto del punto de referencia. La amplitud
1994 vertical se define de forma similar mediante una pareja de números,
1995 @code{Y-extent}. Éstas son propiedades de todos los grobs que
1996 contemplan el @code{grob-interface}.
1998 @cindex @code{extra-spacing-width}
2000 De forma predeterminada, los objetos fuera-del-pentagrama reciben una
2001 anchura cero, de manera que pueden solaparse en la dirección
2002 horizontal. Esto se hace mediante el truco de añadir una cantidad
2003 infinita a la dimensión más a la izquierda y menos infinito a la
2004 dimensión más a la derecha estableciendo el valor de
2005 @code{extra-spacing-width} a @code{'(+inf.0 . -inf.0)}. Así, para
2006 asegurar que no se superponen en la dirección horizontal tendremos que
2007 sobreescribir este valor de @code{extra-spacing-width} a @code{'(0
2008 . 0)} de forma que el verdadero ancho se presente. Esta es la
2009 instrucción que lo hace para las indicaciones dinámicas:
2012 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2016 Veamos si funciona en nuestro ejemplo anterior:
2018 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2020 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2025 Bueno, ciertamente ha hecho que las marcas dinámicas ya no estén
2026 desplazadas, pero aún quedan dos problemas. Las marcas tendrían que
2027 separarse un poco más entre sí, y sería mejor si todas estuvieran a la
2028 misma distancia del pentagrama. Podemos resolver el primer problema
2029 fácilmente. En vez de hacer cero la anchura
2030 @code{extra-spacing-width}, podemos añadirle algo más. Las unidades
2031 son el espacio entre dos líneas de pentagrama, así que al mover el
2032 límite izquierdo media unidad a la izquierda y el límite derecho media
2033 unidad hacia la derecha, deberíamos conseguirlo:
2035 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2037 % Extend width by 1 staff space
2038 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2043 Esto tiene un mejor aspecto, pero quizá habríamos preferido que las
2044 indicaciones de dinámica estuvieran alineadas sobre la misma línea de
2045 base en lugar de ir hacia arriba y hacia abajo con las notas. La
2046 propiedad que lo hace es @code{staff-padding} (relleno de pentagrama)
2047 que se estudia en la sección siguiente.
2050 @node Collisions of objects
2051 @section Collisions of objects
2055 * Fixing overlapping notation::
2056 * Real music example::
2059 @node Moving objects
2060 @subsection Moving objects
2062 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
2063 de notación se pueden superponer, lo que es una lástima, pero en
2064 realidad es bastante poco frecuente. Normalmente la necesidad de
2065 mover objetos es por claridad o razones estéticas: el aspecto es mejor
2066 con un poco más o un poco menos de espacio de separación.
2068 Existen tres enfoques principales que llevan a la resolución de
2069 superposiciones en la notaciónThere are three main main approaches to
2070 resolving overlapping notation. Se deben considerar en el siguiente
2075 La @strong{dirección} de uno de los objetos que se superponen se puede
2076 cambiar usando las instrucciones predefinidas que están relacionadas
2077 arriba para los objetos dentro-del-pentagrama (véase @ref{Within-staff
2078 objects}). Se pueden recolocar fácilmente las plicas, ligaduras de
2079 expresión y de unión, barras de corchea, indicaciones dinámicas, texto
2080 y grupos de valoración especial de esta forma. La limitación es que
2081 sólo tiene la posibilidad de elegir entre dos posiciones, y podría ser
2082 que ninguna de ellas sea la adecuada.
2085 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2086 colocando los objetos de presentación, se pueden modificar usando la
2087 instrucción de sobreescritura @code{\override}. Las ventadas de hacer
2088 cambios a este tipo de propiedad son: a) que algún otro objeto se
2089 moverá automáticamente si es necesario, para dejarle sitio, y b) una
2090 única sobreescritura se puede aplicar a todas las instancias del mismo
2091 tipo de objeto. Entre tales propiedades se encuentran:
2095 @code{direction} (dirección)
2097 Ya se ha estudiado con cierto detalle: véase @ref{Within-staff
2101 @code{padding} (relleno), @code{left-padding} (relleno por la
2102 izquierda), @code{right-padding} (relleno por la derecha),
2103 @code{staff-padding} (relleno de pentagrama)
2105 @cindex left-padding, propiedad
2106 @cindex padding, propiedad
2107 @cindex right-padding, propiedad
2108 @cindex staff-padding, propiedad
2109 Según un objeto se está colocando, el valor de su propiedad de relleno
2110 @code{padding} especifica el espacio intermedio que se debe dejar
2111 entre él mismo y el límite más próximo del objeto contra el que se
2112 está colocando. Observe que es el valor de @code{padding} del objeto
2113 @strong{que se está colocando} el que se usa; el valor de
2114 @code{padding} del objeto que ya está colocado se ignora. Los
2115 espacios intermedios especificados mediante @code{padding} se pueden
2116 aplicar a todos los objetos que contemplan el interface
2117 @code{side-position-interface}.
2119 En lugar de con @code{padding}, la colocación de los grupos de
2120 alteraciones se controla con @code{left-padding} y
2121 @code{right-padding}. Eestas propiedades se encontrarán en el objeto
2122 @code{AccidentalPlacement} que, observe, vive dentro del contexto de
2123 @strong{staff}. Como las alteraciones accidentales siempre se
2124 posicionan según las cabezas de las notas y a su izquierda, solamente
2125 tiene algún efecto la propiedad de relleno por la derecha
2126 @code{right-padding}.
2128 La propiedad @code{staff-padding} está estrechamente relacionada con
2129 la propiedad @code{padding}: @code{padding} controla la separación
2130 mínima entre cualquier objeto que contemple el interface
2131 @code{side-position-interface} y el objeto más cercano (generalmente
2132 la nota o las líneas del pentagrama); @code{staff-padding} se aplica
2133 sólo a los objetos que siempre se sitúan fuera del pentagrama:
2134 controla la separación mínima entre dicho objeto y el pentagrama.
2135 Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
2136 que se posicionan respecto a la nota en vez de hacerlo respecto al
2137 pentagrama, incluso aunque puede ser sobreescrito sin error por tales
2138 objetos: simplemente se ignora.
2140 Para descubrir qué propiedad de relleno se necesita para el objeto que
2141 quiere recolocar, debe volver al manual de RFI y buscar las
2142 propiedades del objeto. Tenga cuidado porque las propiedades de
2143 relleno podrían no estar en el objeto más obvio, así que busque en los
2144 objetos que puedan tener alguna relación con él.
2146 Todos los valores de relleno se miden en espacios del pentagrama.
2147 Para la mayor parte de los objetos el valor se establece de forma
2148 predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
2149 Se puede sobreescribir si se necesita una separación intermedia mayor
2153 @code{self-alignment-X} (Auto-alineamiento en el eje X)
2155 @cindex self-alignment-X, propiedad
2156 Esta propiedad se puede usar para alinear el objeto a la izquierda, a
2157 la derecha, o centrarlo con respecto al punto de referencia del objeto
2158 «padre». Se puede usar con todos los objetos que contemplan el
2159 interfaceIt may be used with all objects which support the
2160 @code{self-alignment-interface}. En general son objetos que contienen
2161 texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
2162 forma alternativa se puede especificar un valor numérico entre
2163 @code{-1} y @code{+1}, donde @code{-1} es alineado por la izquierda,
2164 @code{+1} es alineado por la derecha, y los números intermedios mueven
2165 el texto progresivamente desde alinado por la izquierda hasta alineado
2166 por la derecha. Se pueden especificar valores numéricos mayores de
2167 @code{1} para mover el texto incluso más lejos hacia la izquierda, o
2168 menos de @code{-1} para alejarlo más hacia la derecha. Un cambio en
2169 @code{1} en el valor corresponde a un movimiento de la mitad de la
2170 longitud total del propio texto.
2173 @code{extra-spacing-width} (anchura de separación adicional)
2175 @cindex extra-spacing-width, propiedad
2176 Esta propiedad está disponible para todos los objetos que contemplan
2177 el interface @code{item-interface}. Toma dos números, el primero se
2178 suma al límite izquierdo y el segundo se suma al límite derecho. Los
2179 números negativos desplazan el límite a la izquierda y los positivos a
2180 la derecha, por lo que para ensanchar un objeto el primer número debe
2181 ser negativo y el segundo positivo. Observe que no todos los objetos
2182 ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
2183 (alteración) sólo toma nota del primer número (el borde izquierdo).
2186 @code{staff-position} (posición de pentagrama)
2188 @cindex staff-position, propiedad
2189 @code{staff-position} es una propiedad del interface
2190 @code{staff-symbol-referencer-interface}, que está contemplado por los
2191 objetos que se colocan con relación al pentgrama. Especifica la
2192 posición vertical del objeto con relación a la tercera línea del
2193 pentagrama en medios espacios de pentagrama. Ees útil en la
2194 resolución de colisiones entre objetos de presentación como silencios
2195 multi-compás, ligaduras de unión y notas en distintas voces.
2198 @code{force-hshift} (forzar desplazamiento horizontal)
2200 @cindex force-hshift, propiedad
2202 Las notas muy juntas de un acorde, o aquellas que ocurren al mismo
2203 tiempo en voces distintas, se disponen en dos (y ocasionalmente más)
2204 columnas para evitar la superposición de las cabezas. Éstas reciben
2205 el nombre de columnas de notas, y se crea un objeto llamado
2206 @code{NoteColumn} para disponer las notas en dicha columna.
2208 La propiedad @code{force-hshift} es una propiedad de una
2209 @code{NoteColumn} (realmente lo es del interface
2210 @code{note-column-interface}). Modificarlo permite mover una columna
2211 de notas en unidades adecuadas a una columna de notas, por ejemplo la
2212 anchura de la cabeza de la nota de la primera voz. Se debe usar en
2213 situaciones complejas donde las instrucciones @code{\shiftOn} normales
2214 (véase @ref{Explicitly instantiating voices}) no resuelven el
2215 conflicto entre las notas. Es preferible a la propiedad
2216 @code{extra-offset} para este propósito porque no hay necesidad de
2217 averiguar la distancia en espacios de pentagrama, y mover las notas
2218 dentro o fuera de una @code{NoteColumn} afecta a otras acciones como a
2219 la fusión entre cabezas de nota.
2223 En general no todos los objetos tienen todas estas propiedades. Es
2224 encesario ir al manual RFI para buscar qué propiedades se encuentran
2225 disponibles para el objeto en cuestión.
2228 Finalmente, cuando todo lo demás falla, los objetos se pueden
2229 reposicionar manualmente con relación a la tercera línea del
2230 pentagrama verticalmente, o desplazándolas una cierta distancia a una
2231 nueva posición. Las desventajas son que los valores correctos para el
2232 reposicionamiento se deben adivinar, a menudo por ensayo y error, para
2233 cada objeto indvidual y, puesto que el movimiento se hace después de
2234 que LilyPond ha colocado todos los demás objetos es usuario es
2235 responsable de evitar cualquier colisión que pudiera producirse. Pero
2236 la dificultar principal con este enfoque es que los valores de
2237 reposicionado podrían tener que ser vueltos a calcular si la música se
2238 modifica más tarde. Las propiedades que se pueden usar para este tipo
2239 de posicionamiento manual son:
2242 @item extra-offset (desplazamiento adicional)
2243 @cindex extra-offset, propiedad
2244 Esta propiedad se aplica a cualquier objeto de presentación que
2245 contemple el @code{grob-interface}. Toma una pareja de números que
2246 especifican el desplazamiento adicional en las direcciones horizontal
2247 y vertical. Los números negativos mueven el objeto a la isquierda o
2248 hacia abajo. Las unidades son espacios de pentagrama. El
2249 desplazamiento adicional se hace después de que la composición
2250 tipográfica de los objetos ha terminado, así que un objeto puede ser
2251 reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
2253 @item positions (posiciones)
2254 @cindex positions, propiedad
2255 Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
2256 la altura de las barras de corchea, ligaduras de expresión y corchetes
2257 de grupos de valoración especial. Toma una pareja de números que dan
2258 la posición de los extremos izquierdo y derecho de la barra, ligadura,
2259 etc. con relacion a la tercera línea del pentagrama. Las unidades son
2260 espacios de pentagrama. Observe, sin embargo, que las ligaduras de
2261 expresión y de fraseo no se pueden reposicionar en cantidades
2262 arbitrariamente grandes. LilyPond en primer lugar genera una lista de
2263 posiciones posibles para la ligadura y de forma predeterminada
2264 encuentra la ligadura que tiene @qq{mejor aspecto}. Si la porpiedad
2265 @code{positions} se ha sobreescrito, la ligadura que está más cerca de
2266 las posiciones que se han solicitado, se selecciona de la lista.
2269 En general no todos los objetos tienen todas estas propiedades. Es
2270 encesario ir al manual RFI para buscar qué propiedades se encuentran
2271 disponibles para el objeto en cuestión.
2275 Aquí presentamos una lista de los objetos que es más probable que
2276 estén implicados en colisiones, con el nombre del objeto que habría
2277 que buscar en el RFI para descubrir qué propiedades se deben usar para
2280 @multitable @columnfractions .5 .5
2281 @headitem Tipo de objeto @tab Nombre del objeto
2282 @item Articulaciones @tab @code{Script}
2283 @item Barras @tab @code{Beam}
2284 @item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
2285 @item Dynamica (horizontalmente) @tab @code{DynamicText}
2286 @item Digitaciones @tab @code{Fingering}
2287 @item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
2288 @item Ligaduras de expresión @tab @code{Slur}
2289 @item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
2290 @item Ligaduras de unión @tab @code{Tie}
2291 @item Grupos de valoración especial @tab @code{TupletBracket}
2295 @node Fixing overlapping notation
2296 @subsection Fixing overlapping notation
2298 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
2299 en la sección anterior, para resolver problemas de notación que se
2302 @subheading padding property
2303 @cindex relleno, propiedad
2304 @cindex padding, propiedad
2306 La propiedad @code{padding} se puede ajustar para aumentar (o
2307 disminuir) la distancia entre símbolos impresos encima o debajo de las
2310 @lilypond[quote,fragment,relative=1,verbatim]
2312 \override Script #'padding = #3
2316 @lilypond[quote,fragment,relative=1,verbatim]
2317 % This will not work, see below:
2318 \override MetronomeMark #'padding = #3
2322 \override Score.MetronomeMark #'padding = #3
2327 Observe en el segundo ejemplo la gran importancia que tiene saber qué
2328 contexto maneja un determinado objeto. Puesto que el objeto
2329 @code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
2330 cambios de propiedades en el contexto @code{Voice} pasarán
2331 inadvertidos. Para ver más detalles, consulte @ruser{Constructing a
2334 Si la propiedad de relleno @code{padding} de un objetp se incrementa
2335 cuando dicho objeto se encuentra en una pila de objetos que se están
2336 colocando de acuerdo a su prioridad @code{outside-staff-priority},
2337 entonces ese objeto se moverá, y también todos los que están por fuera
2341 @subheading left-padding and right-padding
2342 @cindex left-padding, propiedad
2343 @cindex right-padding, propiedad
2345 La propiedad @code{right-padding} afecta al espaciado entre la
2346 alteración y la nota a que se aplica. Normalmente no es necesaria,
2347 pero el ejemplo siguiente muestra una situación en la que sí se
2348 necesita. Suponga que queremos presentar un acorde que contiene un Si
2349 natural y un Si bemol. Para evitar la ambigüedad querríamos preceder
2350 las notas con un becuadro y un bemol. Aquí vienen varios intentos de
2353 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2359 Ninguno de ellos funciona y el segundo además presenta una fea
2360 colisión entre las dos alteraciones.
2362 Una forma de conseguirlo es sobreescribir el sello de la alteración
2363 con un elemento de marcado que contenga los símbolos de becuadro y
2364 bemol en el orden que nos gustaría que estuvieran, así:
2366 @lilypond[quote,ragged-right,verbatim]
2367 naturalplusflat = \markup { \natural \flat }
2369 \once \override Accidental
2370 #'stencil = #ly:text-interface::print
2371 \once \override Accidental #'text = #naturalplusflat
2372 \once \override Score.AccidentalPlacement #'right-padding = #1.5
2378 Esto utiliza necesariamente una sobreescritura para el sello de la
2379 alteración que no se estudiará hasta más adelante. El tipo de sello
2380 debe ser un procedimiento, aquí modificado para que imprima el
2381 contenido de la propiedad @code{text} del objeto @code{Accidental},
2382 que a su vez está establecido como un signo de becuadro seguido de un
2383 bemol. Entonces el conjunto se puede separar de la cabeza de la nota
2384 sobreescribiendo @code{right-padding}.
2388 @subheading staff-padding property
2389 @cindex staff-padding, propiedad
2391 @code{staff-padding} se puede usar para alinear objetos como matices
2392 dinámicos a lo largo de una línea de base a una altura fija sobre el
2393 pentagrama, en lugar de hacerlo a una altura que dependa de la
2394 posición de la nota a la que están adosados. No es una propiedad de
2395 @code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
2396 porque la línea de base debe aplicarse por igual a @strong{todas} las
2397 dinámicas, entre ellas las que se han creado como objetos de
2398 extensión. Así que ésta es la forma de alinear las indicaciones de
2399 matiz en el ejemplo de la sección anterior:
2401 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2403 % Extend width by 1 unit
2404 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2405 % Align dynamics to a base line 2 units above staff
2406 \override DynamicLineSpanner #'staff-padding = #2
2411 @subheading self-alignment-X property
2412 @cindex self-alignment-X, propiedad
2414 El ejemplo siguiente muestra cómo esto puede resolver la colisión
2415 entre un objeto de digitación de cuerda y la plica de una nota
2416 mediante el alineamiento del límite derecho con el punto de referencia
2419 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
2422 \once \override StringNumber #'self-alignment-X = #RIGHT
2426 @subheading staff-position property
2427 @cindex staff-position, propiedad
2429 Los silencios multi-compás en una voz pueden chocar con las notas en
2430 otra voz. Puesto que estos silencios se tipografían centrados entre
2431 las barras de compás se necesitaría bastante esfuerzo para que
2432 LilyPond averigüara qué otras notas podrína chocar con él, ya que
2433 actualmente todo el manejo de colisiones entre notas y silencios se
2434 hace solamente para notas y silencios que ocurren al mismo tiempo. He
2435 aquí un ejemplo de colisión de este tipo:
2437 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2438 << {c c c c} \\ {R1} >>
2441 La mejor solución aquí es mover el silencio multi-compás hacia abajo,
2442 pues el silencio está en la voz dos. El ajuste predeterminado para
2443 @code{\voiceTwo} (es decir, en la segunda voz de una construcción
2444 @code{<<@{...@} \\ @{...@}>>}) es que @code{staff-position} tenga el
2445 valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
2446 cuatro semi-espacios de pentagrama, al valor @code{-8}.
2448 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2452 \override MultiMeasureRest #'staff-position = #-8
2457 Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
2458 la línea adicional por encima del silencio se inserta automáticamente.
2460 @subheading extra-offset property
2461 @cindex extra-offset, propiedad
2463 La propiedad @code{extra-offset} da un completo control sobre el
2464 posicionamiento de un objeto tanto vertical como horizontalmente.
2466 En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
2467 a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
2469 @lilypond[quote,fragment,relative=1,verbatim]
2472 \once \override Fingering
2473 #'extra-offset = #'(-0.3 . -1.8)
2478 @subheading positions property
2479 @cindex positions, propiedad
2481 La propiedad @code{positions} permite controlar manualmente la
2482 posición e inclinación de los tresillos, ligaduras de expresión y de
2483 fraseo, y barras de corchea. He aquí un ejemplo que tiene una fea
2484 ligadura de fraseo debido a que intenta evitar la ligadura de
2485 expresión que está sobre la acciaccatura.
2487 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2488 r4 \acciaccatura e8\( d8 c ~c d c d\)
2492 Simplemente podemos mover la ligadura de fraseo por encima de las
2493 notas, y de hecho ésta será la solución preferida:
2495 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2498 \acciaccatura e8\( d8 c ~c d c d\)
2502 pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
2503 sería mover el extremo izquierdo de la ligadura de fraseo un poco
2504 hacia abajo usando la propiedad @code{positions}. Esto también
2505 resuelve la forma algo indecente de la ligadura.
2507 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2509 \once \override PhrasingSlur #'positions = #'(-4 . -3)
2511 e8\( d8 c ~c d c d\)
2514 Presentamos un ejemplo más extraído del comienzo del pentagrama de la
2515 mano izquierda del preludio de Chopin Op 28 No. 2. vemos que la barra
2516 choca con las notas superiores:
2518 @lilypond[quote,verbatim,fragment,ragged-right]
2521 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2522 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2527 Esto se puede resolver manualmente elevando los dos extremos de la
2528 barra desde su posición a dos espacios de pentagrama sobre la línea
2529 central hasta, digamos, 3 espacios:
2531 @lilypond[quote,verbatim,fragment,ragged-right]
2535 \override Beam #'positions = #'(3 . 3)
2540 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2545 Observe que la sobreescritura sigue aplicándose en la primera voz del
2546 segundo bloque de corcheas, pero no a ninguna de las barras de la
2549 @subheading force-hshift property
2550 @cindex force-hshift, propiedad
2551 @c FIXME: formatting stuff (ie not important right now IMO)
2552 @c @a nchor Chopin finally corrected TODOgp
2554 Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
2555 Chopin que presentamos al final de @ref{I'm hearing Voices}, que
2556 dejamos con este aspecto:
2558 @lilypond[quote,verbatim,fragment,ragged-right]
2559 \new Staff \relative c'' {
2562 { c2 aes4. bes8 } \\
2574 Las dos notas inferiores del primer acorde (es decir, las que están en
2575 al tercera voz) no deberían separarse de la colmna de notas de las dos
2576 notas agudas. Para corregir esto, establecemos el valor de
2577 @code{force-hshift} (que es una propiedad de @code{NoteColumn}) de
2578 esas notas a cero. La nota más grave del segundo acorde se sitúa
2579 mejor justo a la derecha de las más agudas. Lo conseguimos
2580 estableciendo el valor de @code{force-hshift} de esta nota a 0.5, o
2581 sea, la anchura de media cabeza de nota a la derecha de la columna de
2584 Presentamos a continuación el resultado final:
2586 @lilypond[quote,verbatim,fragment,ragged-right]
2587 \new Staff \relative c'' {
2590 { c2 aes4. bes8 } \\
2593 \once \override NoteColumn #'force-hshift = #0 <ees c>2
2594 \once \override NoteColumn #'force-hshift = #0.5 des2
2602 @node Real music example
2603 @subsection Real music example
2605 Finalizaremos esta sección sobre los trucos mostrando los pasos que se
2606 deben tomar para tratar con un ejemplo complicado que necesita varios
2607 trucos para producir el resultado deseado. El ejemplo se ha escogido
2608 deliberadamente para ilustrar el uso de la Referencia de la Notación
2609 para resolver problemas de notación poco comunes. No es
2610 representativo de un proceso de grabado más usual, por lo que ¡le
2611 recomendamos que no deje que estas dificultades le desanimen!
2612 ¡Afortunadamente, las dificultadoes como éstas no son muy comunes!
2614 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
2615 compases 6 al 9, la transición entre el Lento inicial y el Moderato.
2616 Presentamos en primer lugar el aspecto que queremos que tenga el
2617 resultado, pero para evitar complicar demasiado el ejemplo hemos
2618 quitado las indicaciones dinámicas, las digitaciones y el pedal.
2620 @c The following should appear as music without code
2621 @lilypond[quote,ragged-right]
2622 rhMusic = \relative c'' {
2625 \once \override Tie #'staff-position = #3.5
2629 \override Staff.NoteCollision #'merge-differently-headed = ##t
2630 \override Staff.NoteCollision #'merge-differently-dotted = ##t
2631 bes2.^\markup {\bold "Moderato"} r8
2633 {c,8[ d fis bes a] | }
2635 % Reposition the c2 to the right of the merged note
2636 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
2637 % Move the c2 out of the main note column so the merge will work
2640 % Stem on the d2 must be down to permit merging
2641 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
2645 \revert Staff.NoteCollision #'merge-differently-headed
2646 \revert Staff.NoteCollision #'merge-differently-dotted
2650 lhMusic = \relative c' {
2652 <d g, d>1)\arpeggio |
2659 \new Staff = "RH" <<
2663 \new Staff = "LH" <<
2672 Observamos en primer lugar que la parte de la mano derecha del tercer
2673 compás requiere cuatro voces. Son las cinco corcheas unidas por una
2674 barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
2675 y el Fa sostenido negra con puntillo, que también está fundida con la
2676 corchea de su misma altura. Todo lo demás está en una sola voz, así
2677 que lo más fácil es introducir estas cuatro voces temporalmente en el
2678 momento en que se necesiten. Si ha olvidado cómo hacerlo, lea
2679 @ref{I'm hearing Voices}. Vamos a comenzar introduciendo las notas
2680 como dos variables y disponiendo la estructura de pentagramas en un
2681 bloque score, y veremos qúe produce LilyPond de forma predeterminada:
2683 @lilypond[quote,verbatim,ragged-right]
2684 rhMusic = \relative c'' {
2689 % Start polyphonic section of four voices
2691 {c,8 d fis bes a | }
2702 lhMusic = \relative c' {
2711 \new Staff = "RH" <<
2715 \new Staff = "LH" <<
2724 Todas las notas son correctas, pero el aspecto está lejos de ser
2725 satisfactorio. La ligadura de unión choca con el cambio de compás, el
2726 barrado del tercer compás es incorrecto, las notas no se funden
2727 correctamente, y faltan algunos elementos de notación. En primer
2728 lugar trataremos con lo más fácil. Podemos corregir el barrado de las
2729 corcheas insertando una barra manualmente, y podemos añadir fácilmente
2730 la ligadura de expresión de la mano izquierda y la ligadura de fraseo
2731 de la mano derecha, pues todo ello se estudió en el Tutorial. Al
2732 hacerlo así obtenemos:
2734 @lilypond[quote,verbatim,ragged-right]
2735 rhMusic = \relative c'' {
2740 % Start polyphonic section of four voices
2742 {c,8[ d fis bes a] | }
2753 lhMusic = \relative c' {
2762 \new Staff = "RH" <<
2766 \new Staff = "LH" <<
2775 El primer compás ahora es correcto. El segundo compás contiene un
2776 arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
2777 sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
2778 que volver e la Referencia de la Notación. Buscando la palabra
2779 @q{arpegio} y @q{línea divisoria} en el índice nos puestra rápidamente
2780 que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
2781 doble barra se produce por medio de la instrucción @code{\bar "||"}.
2782 Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
2783 la colisión entre la ligadura de unión y la indicación de compás.
2784 Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
2785 mover objetos anteriormente en @ref{Moving objects}, donde dice que
2786 los objetos que están situados de forma relativa al pentagrama se
2787 pueden mover sobreescribiendo su propiedad @code{staff-position}, que
2788 se especifica en unidades de medio espacio de pentagrama respecto de
2789 la línea central del pentagrama. Así pues, la sobreescritura
2790 siguiente colocada justo antes de la primera nota ligada subirá la
2791 ligadura 3.5 medios espacios de pentagrama por encima de la línea
2794 @code{\once \override Tie #'staff-position = #3.5}
2796 This completes bar two, giving:
2798 @lilypond[quote,verbatim,ragged-right]
2799 rhMusic = \relative c'' {
2801 \once \override Tie #'staff-position = #3.5
2806 % Start polyphonic section of four voices
2808 {c,8[ d fis bes a] | }
2819 lhMusic = \relative c' {
2821 <d g, d>1)\arpeggio |
2828 \new Staff = "RH" <<
2832 \new Staff = "LH" <<
2841 Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
2842 tutorial nos enseñó cómo escribir texto en negrita mediante la
2843 instrucción @code{\markup}, por lo que añadir @q{Moderato} en engrita
2844 es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
2845 voces? El índice de la Referencia de laa Notación no mencina la
2846 mezcla de notas, pero una búsqueda de texto por la palabra @q{fusión}
2847 o @q{mezcla} nos lleva rápidamente a las sobreescrituras necesarias
2848 para mezclar o fusionar notas con distinta cabeza y con o sin puntillo
2849 en @ruser{Collision Resolution}. En nuestro ejemplo tenemos que
2850 fusionar ambos tipos de nota en el transcurso de la sección polifónica
2851 del compás 3; por tanto, en virtud de la información que aparece en la
2852 Referencia de la Notación, escribimos
2855 \override Staff.NoteCollision #'merge-differently-headed = ##t
2856 \override Staff.NoteCollision #'merge-differently-dotted = ##t
2860 al principio de la sección, y
2863 \revert Staff.NoteCollision #'merge-differently-headed
2864 \revert Staff.NoteCollision #'merge-differently-dotted
2868 al final, dando como resultado:
2870 @lilypond[quote,verbatim,ragged-right]
2871 rhMusic = \relative c'' {
2873 \once \override Tie #'staff-position = #3.5
2877 bes2.^\markup {\bold "Moderato"} r8
2878 \override Staff.NoteCollision #'merge-differently-headed = ##t
2879 \override Staff.NoteCollision #'merge-differently-dotted = ##t
2880 % Start polyphonic section of four voices
2882 {c,8[ d fis bes a] | }
2890 \revert Staff.NoteCollision #'merge-differently-headed
2891 \revert Staff.NoteCollision #'merge-differently-dotted
2895 lhMusic = \relative c' {
2897 <d g, d>1)\arpeggio |
2904 \new Staff = "RH" <<
2908 \new Staff = "LH" <<
2917 Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
2918 dos Re. ¿Por qué no? La respuesta está en la misma sección de la
2919 Referencia de la Notación: las notas que se fusionan deben tener las
2920 plicas en direcciones opuestas y dos notas no se pueden fusionar bien
2921 si hay una tercera nota en la misma columna. Aquí los dos Re tienen
2922 las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
2923 cambiar la dirección de la plica usando @code{\stemDown}, y la
2924 Referencia de la Notación también explica cómo mover el Do: aplicar un
2925 desplazamiento usando una de las instrucciones @code{\shift}. Pero
2926 ¿cuál? El Do está en la voz dos que tiene desactivado el
2927 desplazamiento, y los dos Re están en las voces uno y tres, que tienen
2928 el desplazamiento desactivado y activado, respectivamente. Por ello
2929 tenemos que desplazar el Do un nivel más todavía, usando
2930 @code{\shiftOnn} para evitar que interfiera con los dos Re. Al
2931 aplicar estos cambios obtenemos:
2933 @lilypond[quote,verbatim,ragged-right]
2934 rhMusic = \relative c'' {
2936 \once \override Tie #'staff-position = #3.5
2940 bes2.^\markup {\bold "Moderato"} r8
2941 \override Staff.NoteCollision #'merge-differently-headed = ##t
2942 \override Staff.NoteCollision #'merge-differently-dotted = ##t
2943 % Start polyphonic section of four voices
2945 {c,8[ d fis bes a] | }
2947 % Move the c2 out of the main note column so the merge will work
2948 {c,8~ \shiftOnn c2 | }
2950 % Stem on the d2 must be down to permit merging
2951 {s8 \stemDown d2 | }
2955 \revert Staff.NoteCollision #'merge-differently-headed
2956 \revert Staff.NoteCollision #'merge-differently-dotted
2960 lhMusic = \relative c' {
2962 <d g, d>1)\arpeggio |
2969 \new Staff = "RH" <<
2973 \new Staff = "LH" <<
2982 Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
2983 sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
2984 colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
2985 partir de trucos anteriores: hacemos la plica transparente, y movemos
2986 el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
2989 @lilypond[quote,verbatim,ragged-right]
2990 rhMusic = \relative c'' {
2993 \once \override Tie #'staff-position = #3.5
2997 bes2.^\markup {\bold "Moderato"} r8
2998 \override Staff.NoteCollision #'merge-differently-headed = ##t
2999 \override Staff.NoteCollision #'merge-differently-dotted = ##t
3001 {c,8[ d fis bes a] | }
3003 % Reposition the c2 to the right of the merged note
3004 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3005 % Move the c2 out of the main note column so the merge will work
3008 % Stem on the d2 must be down to permit merging
3009 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3013 \revert Staff.NoteCollision #'merge-differently-headed
3014 \revert Staff.NoteCollision #'merge-differently-dotted
3018 lhMusic = \relative c' {
3020 <d g, d>1)\arpeggio |
3027 \new Staff = "RH" <<
3031 \new Staff = "LH" <<
3041 @node Further tweaking
3042 @section Further tweaking
3045 * Other uses for tweaks::
3046 * Using variables for tweaks::
3047 * Other sources of information::
3048 * Avoiding tweaks with slower processing::
3049 * Advanced tweaks with Scheme::
3052 @node Other uses for tweaks
3053 @subsection Other uses for tweaks
3057 @cindex transparent, uso de la propiedad
3058 @cindex objetos, hace invisibles
3059 @cindex eliminar objetos
3060 @cindex objetos, eliminar
3061 @cindex ocultar objetos
3062 @cindex invisibles, objetos
3063 @cindex ligar notas entre voces distintas
3066 @subheading Tying notes across voices
3068 El ejemplo siguiente muestra cómo conectar notas que están en
3069 distintas voces utilizando ligaudras de unión. Normalmente sólo se
3070 pueden conectar mediante ligaduras de unión dos notas que estén en la
3071 misma voz. Usando dos voces, con las notas ligadas en una de ellas:
3073 @lilypond[quote,fragment,relative=2]
3074 << { b8~ b8\noBeam }
3080 y borrando la primera plica hacia arriba en esa voz, da la impresión
3081 de que la ligadura se cruza entre las voces:
3083 @lilypond[quote,fragment,relative=2,verbatim]
3086 \once \override Stem #'transparent = ##t
3094 Para estar seguros de que la plica que acabamos de borrar no aprieta
3095 demasiado a la ligadura, podemos alargar la plica estableciendo su
3096 valor de longitud @code{length} a @code{8},
3098 @lilypond[quote,fragment,relative=2,verbatim]
3101 \once \override Stem #'transparent = ##t
3102 \once \override Stem #'length = #8
3111 @subheading Simulating a fermata
3113 @cindex sello, uso de la propiedad
3114 @cindex fermata, realización en MIDI
3116 Para los objetos fuera-del-pentagrama, normalmente es mejor
3117 sobreescribir la propiedad @code{stencil} («sello») del objeto que su
3118 propiedad @code{transparent} cuando desee quitarlos de la salida
3119 impresa. Mediante el establecimiento de la propiedad @code{stencil}
3120 de un objeto al valor @code{#f} podemos quitar el objeto por completo
3121 de la salida impresa. Esto significa que no tiene efecto sobre la
3122 colocación de otros objetos que pudieran colocarse en relación a él.
3124 Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
3125 propósito de simular un calderón en la salida MIDI, seguramente no
3126 querríamos que la indicación metronómica apareciese en la salida
3127 impresa, y no querríamos influir sobre la separación entre los dos
3128 sistemas o entre las notas del pentagrama. Por lo tanto, establecer
3129 su propiedad @code{stencil} al valor @code{#f} sería la mejor manera.
3130 Mostramos aquí el efecto de los dos métodos:
3132 @lilypond[quote,verbatim,ragged-right]
3135 % Visible tempo marking
3138 \once \override Score.MetronomeMark #'transparent = ##t
3139 % Invisible tempo marking to lengthen fermata note in MIDI
3142 \once \override Score.MetronomeMark #'stencil = ##f
3143 % Invisible tempo marking to restore tempo in MIDI
3153 Ambos métodos quitan la indicación metronómica de la salida impresa, y
3154 los dos afectan al tempo del MIDI tal y como queríamos, pero la
3155 primera indicación de metrónomo (la transparente) aún influye sobre la
3156 separación de las notas, mientras que la segunda (sin «sello») no
3161 @node Using variables for tweaks
3162 @subsection Using variables for tweaks
3164 Las instrucciones de sobreescritura son con frecuencia largas y
3165 tediosas de escribir, y se tienen que escribir de forma absolutamente
3166 correcta. Si las mismas sobreescrituras se van a utilizar muchas
3167 veces, podría merecer la pena definir variables para guardarlas.
3168 Suponga que queremos realzar ciertas palabras de la letra de una
3169 canción imprimiéndolas en cursiva y negrita. Las instrucciones
3170 @code{\italic} y @code{\bold} no funcionan dentro de la letra de las
3171 canciones, así que tenemos de usar en su lugar las siguientes
3172 instrucciones @code{\override} y @code{\revert}:
3175 @code{\override Lyrics . LyricText #'font-shape = #'italic}
3176 @code{\override Lyrics . LyricText #'font-series = #'bold}
3178 @code{\revert Lyrics . LyricText #'font-shape}
3179 @code{\revert Lyrics . LyricText #'font-series}
3182 Estas instrucciones serían extremadamente tediosas de escribir si
3183 hubiera muchas palabras que quisiéramos subrayar. Entonces, en vez de
3184 esto las definimos como dos variables, y las usamos de la siguiente
3187 @lilypond[quote,verbatim]
3189 \override Lyrics . LyricText #'font-shape = #'italic
3190 \override Lyrics . LyricText #'font-series = #'bold
3193 \revert Lyrics . LyricText #'font-shape
3194 \revert Lyrics . LyricText #'font-series
3197 global = { \time 4/4 \partial 4 \key c \major}
3198 SopMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
3199 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f f e }
3200 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
3201 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
3202 VerseOne = \lyrics { E -- | ter -- nal \emph Fa -- ther, \norm | strong to save, }
3203 VerseTwo = \lyricmode { O | \emph Christ, \norm whose voice the | wa -- ters heard, }
3204 VerseThree = \lyricmode { O | \emph Ho -- ly Spi -- rit, \norm | who didst brood }
3205 VerseFour = \lyricmode { O | \emph Tri -- ni -- ty \norm of | love and pow'r }
3211 \new Voice = "Sop" { \voiceOne \global \SopMusic }
3212 \new Voice = "Alto" { \voiceTwo \AltoMusic }
3213 \new Lyrics \lyricsto "Sop" { \VerseOne }
3214 \new Lyrics \lyricsto "Sop" { \VerseTwo }
3215 \new Lyrics \lyricsto "Sop" { \VerseThree }
3216 \new Lyrics \lyricsto "Sop" { \VerseFour }
3220 \new Voice = "Tenor" { \voiceOne \TenorMusic }
3221 \new Voice = "Bass" { \voiceTwo \BassMusic }
3229 @node Other sources of information
3230 @subsection Other sources of information
3232 La documentación del manual de Referencia de Funcionamiento Interno
3233 contiene montañas de información sobre LilyPond, pero se puede obtener
3234 más información aún leyendo los archivos internos de LilyPond. Para
3235 echarles un vistazo, en primer lugar busque la carpeta correspondiente
3236 a su sistema, de la siguiente forma:
3241 @file{@var{installdir}/lilypond/usr/share/lilypond/current/}
3246 @file{@var{installdir}/LilyPond.app/Contents/Resources/share/lilypond/current/}
3247 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
3248 bien manteniendo pulsada la tecla de Control y haciendo click sobre la
3249 aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
3254 Mediante el Explorador de Windows, diríjase a
3255 @file{@var{installdir}/LilyPond/usr/share/lilypond/current/}
3257 Dentro de esta carpeta, las dos subcarpetas interesantes son
3260 @item @file{../ly/ } - contains files in LilyPond format
3261 @item @file{../scm/} - contains files in Scheme format
3264 Vamos a comenzar observando algunos archivos que están en
3265 @file{../ly/}. Abra @file{../ly/property-init.ly} con un editor de
3266 textos. El mismo que usaría normalmente para los archivos @code{.ly}
3267 servirá perfectamente. Este archivo contiene las definiciones de
3268 todas las instrucciones incorporadas como estándar dentro de LilyPond,
3269 como por ejemplo @code{\stemUp} y @code{\slurDotted}. Podrá ver que
3270 no son nada más que definiciones de variables que contienen una o
3271 varias instrucciones @code{\override}. Por ejemplo, @code{/tieDotted}
3272 está definido de tal forma que su valor es:
3276 \override Tie #'dash-period = #0.75
3277 \override Tie #'dash-fraction = #0.1
3281 Si no le gustan los valores predeterminados, estas instrucciones
3282 incorporadas se pueden redefinir con facilidad como cualquier otra
3283 variable, al principio de su archivo de código de entrada.
3285 Los siguientes son los archivos más útiles que se encuentran en
3288 @multitable @columnfractions .4 .6
3291 @item @file{../ly/engraver-init.ly}
3292 @tab Definiciones de Contextos de grabadores
3293 @item @file{../ly/paper-defaults.ly}
3294 @tab especificaciones de valores predeterminados relacionados con el papel
3295 @item @file{../ly/performer-init.ly}
3296 @tab Definiciones de Contextos de interpretación
3297 @item @file{../ly/property-init.ly}
3298 @tab Definiciones de todas las instrucciones incorporadas que son comunes
3301 Otros ajustes (como las definiciones de las instrucciones de marcado)
3302 se almacenan como archivos @code{.scm} (de Scheme). El lenguaje de
3303 programación Scheme se utiliza para proporcionar un interfaz
3304 programable en el funcionamiento interno de LilyPond. Cualquier
3305 explicación adicional sobre estos archivos se encuentra por el momento
3306 fuera del ámbito de este manual, porque se requieren conocimientos del
3307 lenguaje Scheme. Se advierte a los usuarios que se necesita una
3308 importante cantidad de conocimientos técnicos o de tiempo para
3309 comprender el lenguaje Scheme y estos archivos (véase @ref{Scheme
3312 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
3315 @multitable @columnfractions .4 .6
3318 @item @file{../scm/auto-beam.scm}
3319 @tab Valores predeteminados de sub-barrado
3320 @item @file{../scm/define-grobs.scm}
3321 @tab valores predeterminados de las propiedades de grobs
3322 @item @file{../scm/define-markup-commands.scm}
3323 @tab Especificar todas las instrucciones de marcado
3324 @item @file{../scm/midi.scm}
3325 @tab Ajustes predeterminados para la salida MIDI
3326 @item @file{../scm/output-lib.scm}
3327 @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
3328 @item @file{../scm/parser-clef.scm}
3329 @tab Definiciones de las claves contempladas
3330 @item @file{../scm/script.scm}
3331 @tab Ajustes predeterminados para las articulaciones
3336 @node Avoiding tweaks with slower processing
3337 @subsection Avoiding tweaks with slower processing
3339 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
3340 procesa los archivos. Estos comandos consumen tiempo, pero el
3341 resultado puede necesitar menos trucos manuales.
3344 %% asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
3345 \override Score.PaperColumn #'keep-inside-line = ##t
3348 @node Advanced tweaks with Scheme
3349 @subsection Advanced tweaks with Scheme
3351 Hemos visto cómo la salida de LilyPond se puede modificar de manera muy profunda utilizando
3353 @code{\override TextScript #'extra-offset = ( 1 . -1)}. Pero
3354 tenemos un potencial incluso mayor si utilizamos Scheme. Para ver una explicación completa
3355 de esto, consulte el @ruser{Scheme tutorial} e
3356 @ruser{Interfaces for programmers}.
3358 Podemos usar Scheme simplemente para sobreponer (@code{\override}) comandos,
3360 @lilypond[quote,verbatim,ragged-right]
3361 padText = #(define-music-function (parser location padding) (number?)
3363 \once \override TextScript #'padding = #$padding
3367 c4^"piu mosso" b a b
3369 c4^"piu mosso" d e f
3371 c4^"piu mosso" fis a g
3375 Podemos usarlo para crear comandos nuevos,
3377 @lilypond[quote,verbatim,ragged-right]
3378 tempoMark = #(define-music-function (parser location padding marktext)
3381 \once \override Score . RehearsalMark #'padding = $padding
3382 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
3383 \mark \markup { \bold $marktext }
3388 \tempoMark #3.0 #"Allegro"
3393 E incluso se le pueden pasar expresiones musicales.
3395 @lilypond[quote,verbatim,ragged-right]
3396 pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
3403 \pattern {d16 dis} { ais16-> b\p }