1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 88f1608ae6fd17b05344bafb2f0721aafdac657b
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
13 @chapter Tweaking output
15 Este capítulo trata de cómo modificar la salida. LilyPond es extremadamente
16 configurable; prácticamente todos los fragmentos de la salida se pueden cambiar.
21 * The Internals Reference manual::
22 * Appearance of objects::
23 * Placement of objects::
24 * Collisions of objects::
29 @section Tweaking basics
32 * Introduction to tweaks::
33 * Objects and interfaces::
34 * Naming conventions of objects and properties::
38 @node Introduction to tweaks
39 @subsection Introduction to tweaks
41 El @q{Trucaje} es un término de LilyPond que denota los diversos
42 métodos que el usuario tiene a su disposición para modificar el
43 proceso de interpretación del archivo de entrada y cambiar la
44 apariencia de la salida impresa. Algunos trucos son muy fáciles de
45 usar; otros son más complejos. Pero en su conjunto, los métodos de
46 trucaje disponibles posibilitan conseguir casi cualquier apariencia
47 que deseemos en la música impresa.
49 En esta sección vamos a estudiar los conceptos básicos que se
50 necesitan para comprender el trucaje. Más tarde daremos un amplio
51 abanico de instrucciones listas para usar, que podrá simplemente
52 copiar para obtener el mismo efecto en sus partituras, y al mismo
53 tiempo mostraremos la forma de construir dichas instrucciones para que
54 pueda aprender cómo desarrollar sus propios trucos.
56 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
57 la sección @ref{Contexts and engravers}, pues los Contextos, los
58 Grabadores y las Propiedades que se contienen en ellos son
59 fundamentales para comprender y construir los trucos.
61 @node Objects and interfaces
62 @subsection Objects and interfaces
69 El trucaje consiste en modificar el funcionamiento y estructura
70 interna del programa LilyPond, por lo que en primer lugar
71 introduciremos algunos términos que se usan para describir dichas
72 operaciones y estructuras internas.
74 El término @q{Objeto} es un término genérico que se usa para referirse
75 a la multitud de estructuras internas que LilyPond construye durante
76 el procesado de un archivo de entrada. Así, cuando se encuentra una
77 instrucción como @code{\new Staff}, se construye un objeto nuevo del
78 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
79 las propiedades asociadas con ese pentagrama en particular, por
80 ejemplo, su nombre y su armadura, además de otros detalles de los
81 grabadores que se han asignado para que operen dentro del contexto del
82 pentagrama. De forma similar, hay objetos que guardan las propiedades
83 de todos los demás contextos, como objetos de @code{Voice}, objetos de
84 @code{Score}, objetos de @code{Lyrics}, así como objetos que
85 representan todos los elementos notacionales como líneas divisorias,
86 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
87 objeto tiene su propio conjunto de valores de propiedad.
89 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
90 representan elementos de notación sobre la salida impresa como cabezas
91 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
92 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
93 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
94 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
95 mencionado, y también todos ellos tienen propiedades asociadas, como
96 su posición, tamaño, color,etc.
98 Ciertos objetos de presentación son aún más especializados. Las
99 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
100 y baja, y muchos otros objetos gráficos no están situados en un solo
101 lugar: tienen un punto de inicio, un punto de final, y quizá otras
102 propiedades relacionadas con su forma. Los objetos con una forma
103 extendida como estos, reciben el nombre de «Objetos de extensión» o
106 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
107 incluso aunque son bastante diferentes, comparten funcionalidades que
108 se deben procesar de la misma manera. Por ejemplo, todos los objetos
109 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
110 propiedades se procesan de la misma forma durante la interpretación
111 del archivo de entrada por parte de LilyPond. Para simplificar estas
112 operaciones internas, estas acciones y propiedades comunes se agrupan
113 en un objeto llamado @code{grob-interface}, interface de grob. Hay
114 muchas otras agrupaciones de propiedades comunes como ésta, y cada
115 una recibe un nombre que acaba en @code{interface}. En total hay más
116 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
117 interés y de utilidad para el usuario.
119 Estos son, en fin, los términos principales relativos a los objetos
120 que vamos a utilizar en este capítulo.
122 @node Naming conventions of objects and properties
123 @subsection Naming conventions of objects and properties
125 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
126 sección @ref{Contexts and engravers}. En este lugar, para más fácil
127 referencia, presentamos una lista de los tipos de objetos y
128 propiedades más comunes, junto con las convenciones según las cuales
129 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
130 utilizado una @q{A} mayúscula para denotar cualquier carácter
131 alfabético en mayúsculas, y @q{aaa} para cualquier número de
132 caracteres alfabéticos en minúscula. Otros caracteres se utilizan
133 literalmente como están.
135 @multitable @columnfractions .33 .33 .33
136 @headitem Objeto o tipo de propiedad
137 @tab Convención de nomenclatura
140 @tab Aaaa o AaaaAaaaAaaa
141 @tab Staff, GrandStaff
142 @item Objetos de presentación
143 @tab Aaaa o AaaaAaaaAaaa
146 @tab Aaaa_aaa_engraver
147 @tab Clef_engraver, Note_heads_engraver
149 @tab aaa-aaa-interface
150 @tab grob-interface, break-aligned-interface
151 @item Propiedades de contextos
152 @tab aaa o aaaAaaaAaaa
153 @tab alignAboveContext, skipBars
154 @item Propiedades de objetos de presentación
155 @tab aaa o aaa-aaa-aaa
156 @tab direction, beam-thickness
159 Como podremos ver en breve, las propiedades de distintos tipos de
160 objeto se modifican por parte de diferentes instrucciones; así pues,
161 es útil poder reconocer el tipo de objeto a partir de sus nombres de
164 @node Tweaking methods
165 @subsection Tweaking methods
167 @strong{La instrucción \override}
169 @cindex override, instrucción
172 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
173 usan para cambiar las propiedades de los @strong{contextos} y para
174 quitar y poner @strong{grabadores}, en @ref{Modifying context
175 properties} y @ref{Adding and removing engravers}. Ahora debemos
176 examinar algunas instrucciones importantes más.
178 La instrucción que cambia las propiedades de los @strong{objetos de
179 presentación} es @code{\override}. Puesto que esta instrucción debe
180 modificar propiedades internas que se encuentran en un lugar profundo
181 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
182 las instrucciones que hemos visto hasta ahora. Tiene que saber
183 exactamente qué propiedad de qué objeto y en qué contexto se debe
184 modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
186 La sintaxis genérica de esta instrucción es:
189 \override @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación} = #@var{valor}
193 Esto establecerá la propiedad de nombre
194 @var{propiedad-de-presentación} del objeto de presentación con el
195 nombre @var{ObjetoDePresentación}, que es miembro del contexto
196 @var{Contexto}, al valor @var{valor}.
198 El @var{contexto} se puede omitir (y normalmente así es) cuando el
199 contexto requerido se encuentra implicado sin ambigüedad y es uno de
200 los contextos del nivel más bajo, es decir: @code{Voice},
201 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
202 ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
204 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
205 valores, pero para ilustrar el formato y utilización de estas
206 instrucciones usaremos sólo unas cuantas propiedades y valores
207 sencillos que sean fáciles de entender.
209 Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
210 propiedad de presentación, y el @code{#}, que debe preceder al valor.
211 Deben estar presentes siempre y de esa forma exacta. Es la
212 instrucción de uso más común dentro del trucaje, y durante la mayor
213 parte del resto de este capítulo presentaremos ejemplos de cómo se
214 usa. A continuación hay un ejemplo sencillo para cambiar el color de
217 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
219 \override NoteHead #'color = #red
221 \override NoteHead #'color = #green
225 @strong{La instrucción \revert}
227 @cindex revert, instrucción
230 Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
231 se sobreescribe de nuevo o se encuentra una instrucción
232 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
233 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
234 valor predeterminado original; observe que no es a su valor previo si
235 se han utilizado varias instrucciones @code{\override}.
238 \revert @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación}
241 Una vez más, igual que @var{Contexto} dentro de la instrucción
242 @code{\override}, con frecuencia no es necesario especificar el
243 @var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
244 Aquí devolvemos el color de la cabeza al valor predeterminado para las
247 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
249 \override NoteHead #'color = #red
251 \override NoteHead #'color = #green
253 \revert NoteHead #'color
257 @strong{El prefijo \once}
259 Tanto la instrucción @code{\override} como @code{\set} se pueden
260 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
261 @code{\override} o @code{\set} sea efectiva solamente durante el
262 tiempo musical en curso y antes de que la propiedad vuelva a tener
263 otra vez su valor predeterminado. Utilizando el mismo ejemplo,
264 podemos cambiar el color de una sola nota de la siguiente manera:
266 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
268 \once \override NoteHead #'color = #red
270 \once \override NoteHead #'color = #green
274 @strong{La instrucción \overrideProperty}
276 @cindex overrideProperty, instrucción
277 @funindex \overrideProperty
279 Hay otra forma para la instrucción de sobreescritura,
280 @code{\overrideProperty}, que ocasionalmente es necesaria. La
281 mencionamos aquí con un propósito de exhaustividad, pero para ver más
282 detalles consulte @ruser{Difficult tweaks}.
283 @c Maybe explain in a later iteration -td
285 @strong{La instrucción \tweak}
287 @cindex tweak, instrucción
290 La última instrucción de trucaje que está disponible es @code{\tweak}.
291 Se debe utilizar para cambiar las propiedades de objetos que suceden
292 en el mismo momento musical, como las notas de un acorde. El uso de
293 @code{\override} para la sobreescritura afectaría a todas las notas
294 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
295 elemento del flujo de entrada.
297 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
298 cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
299 primer lugar, veamos lo que haría @code{\once \override}:
301 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
303 \once \override NoteHead #'font-size = #-3
308 Vemos que la sobreescritura con override afecta a @emph{todas} las
309 cabezas de las notas del acorde. Esto es así porque todas las notas
310 de un acorde ocurren en el mismo @emph{momento musical}, y la acción
311 de @code{\once} es aplicar la sobreescritura a todos los objetos de
312 presentación del tipo especificado que ocurren en el mismo momento
313 musical que la propia instrucción de sobreescritura @code{\override}.
315 La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
316 el elemento inmediatamente siguiente dentro del flujo de entrada. Sin
317 embargo, es efectivo solamente sobre objetos que se crean directamente
318 a partir del flujo de entrada, en esencia las cabezas y las
319 articulaciones; los objetos como las plicas y las alteraciones se
320 crean con posterioridad y no se pueden trucar de esta forma. Es más,
321 cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
322 dentro de un acorde, es decir, dentro de ángulos simples, así que para
323 trucar una sola nota la instrucción @code{\tweak} se debe colocar
324 dentro de ángulos simples junto con la nota.
326 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
327 se cambiaría de la siguiente forma:
329 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
331 <c \tweak #'font-size #-3 e g>4
334 Observe que la sintaxis de @code{\tweak} no es igual que la de
335 @code{\override}. Ni el contexto ni el objeto de
336 presentación se deben especificar; de hecho, generaría un error
337 hacerlo. Los dos están implícitos por el siguiente elemento del flujo
338 de entrada. Así que la sintaxis genérica de la instrucción
339 @code{\tweak} es, simplemente,
342 \tweak #'@var{propiedad-de-presentación} = #@var{valor}
345 Una instrucción @code{\tweak} también se puede usar para modificar
346 sólo una de una serie de articulaciones, como se muestra aquí:
348 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
350 -\tweak #'color #red ^Red
351 -\tweak #'color #green _Green
355 Observe que la instrucción @code{\tweak} debe venir precedida de una
356 marca de articulación como si ella misma fuera una articulación.
358 @cindex grupos especiales anidados
359 @cindex tresillos anidados
360 @cindex corchete del grupo especial
361 @cindex grupo especial, corchete de
362 @cindex tresillo, corchete de
363 @funindex TupletBracket
365 La instrucción @code{\tweak} también se debe usar para cambiar la
366 apariencia de uno solo de un conjunto de grupos especiales anidados
367 que comiencen en el mismo instante musical. En el siguiente ejemplo,
368 el corchete del tresillo largo y el primero de los tres corchetes
369 cortos empiezan en el mismo momento musical, y por ello cualquier
370 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
371 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
372 @code{\tweak} especifica que el corchete del tresillo largo se debe
373 colocar por encima de las notas y el segundo especifica que el número
374 del tresillo se debe imprimir en rojo sobre el corchete del primer
377 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
378 \tweak #'direction #up
381 \times 2/3 { c8[ c8 c8] }
382 \times 2/3 { c8[ c8 c8] }
383 \times 2/3 { c8[ c8 c8] }
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]}
408 Referencia de la notación:
409 @ruser{The tweak command}.
412 @node The Internals Reference manual
413 @section The Internals Reference manual
415 @cindex Internals Reference
418 * Properties of layout objects::
419 * Properties found in interfaces::
420 * Types of properties::
423 @node Properties of layout objects
424 @subsection Properties of layout objects
426 @cindex propiedades de los objetos de presentación
427 @cindex propiedades de los grobs
428 @cindex grobs, propiedades de
429 @cindex presentación, propiedades de los objetos de
431 Suponga que tiene una partitura con una ligadura de expresión que para
432 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
433 debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
434 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
435 piensa que una cierta instrucción de sobreescritura @code{\override}
436 será necesaria. Pero ¿existe una propiedad de grosor para las
437 ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
438 interviene el Manual de Funcionamiento Interno. Contiene toda la
439 información que puede necesitar para construir ésta y todas las demás
440 instrucciones @code{\override}, de sobreescritura.
442 Una advertencia antes de dirigir nuestra mirada a la referencia de
443 funcionamiento interno. Éste es un documento de @strong{referencia},
444 lo que significa que hay pocas o ninguna explicación en él: su
445 propósito es presentar la información de forma precisa y concisa. Por
446 tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
447 La guía y las explicaciones que presentamos aquí le permitirán extraer
448 la información de la referencia de funcionamiento interno por sí mismo
449 con tan sólo algo de práctica.
451 @cindex sobreescritura, ejemplo de
452 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
454 Utilicemos un ejemplo concreto con un sencillo fragmento de música
457 @lilypond[quote,verbatim,relative=2]
462 g[( e]) e d[( f]) a |
466 The man who feels love's sweet e -- mo -- tion
471 Suponga ahora que decidimos que nos gustan las ligaduras algo más
472 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
473 presentación, así que la cuestión es @q{¿Hay una propiedad
474 perteneciente a las ligaduras de expresión que controle su grosor?}
475 Para responder a esta pregunta debemos mirar el manual de Referencia
476 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
477 (Internals Reference) en inglés}.
479 El RFI de la versión de LilyPond que está usando se puede encontrar en
480 la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
481 página de la documentación y siga el enlace Manual de Referencia de
482 Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
483 sería mejor que utilizase la versión en HTML, no la @q{en una sola
484 página} ni el PDF. Para que los siguientes párrafos tengan algún
485 sentido deberá consultarlo realmente al tiempo que lee.
487 @c Link names in English as those pages are not yet translated. FV
488 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
489 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
490 información sobre los objetos de presentación. Una vez allí, bajo el
491 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
492 objects}. La página que aparece relaciona todos los objetos de
493 presentación que se usan en su versión de LilyPond, en orden
494 alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
495 relacionadas las propiedades de las ligaduras de expresión o Slurs.
497 Una forma alternativa de encontrar esta página es a partir de la
498 Referencia de la Notación. En una de las páginas que tratan de las
499 ligaduras de expresión podrá encontrar un enlace al manual de
500 referencia del funcionamiento interno. Este enlace le llevará
501 directamente a esta página, aunque si tiene una idea del nombre del
502 objeto de presentación que pretende trucar, le resultará más fácil ir
503 directamente al RFI y buscar allí.
505 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
506 dice en primer lugar que los objetos Slur se crean por el grabador
507 Slur_engraver. A continuación relaciona los ajustes estándar.
508 Observe que @strong{no} están en orden alfabético. Navegue hacia
509 abajo buscando una propiedad que pudiera controlar el grosor de las
510 ligaduras, y encontrará
513 @code{thickness} (number)
515 Line thickness, generally measured in @code{line-thickness}
518 Esto promete ser una buena opción para cambiar el grosor. Nos dice
519 que el valor de @code{thickness} es un simple @emph{número}, que el
520 valor predeterminado es 1.2, y que las unidades están dentro de otra
521 propiedad llamada @code{line-thickness}.
523 Como dijimos con anterioridad, existen entre pocas y ninguna
524 explicación en el RFI, pero ya tenemos información suficiente para
525 probar a cambiar el grosor de la ligadura. Vemos que el nombre del
526 objeto de presentación es @code{Slur}, que el nombre de la propiedad
527 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
528 un número algo más grande que 1.2 si queremos hacer las ligaduras más
531 Ahora podemos construir la instrucción de sobreescritura
532 @code{\override} simplemente mediante la sustitución de los valores
533 que hemos encontrado para los nombres, omitiendo el contexto.
534 Usaremos un valor muy grande para el grosor al principio, para estar
535 seguros de que la instrucción está funcionando. Obtenemos lo
539 \override Slur #'thickness = #5.0
542 ¡No olvide el @code{#'} antes del nombre de la propiedad y @code{#}
543 antes del valor nuevo!
545 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
546 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
547 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
548 cerca de ella.} Hagámoslo así:
550 @lilypond[quote,verbatim,relative=2]
554 % Increase thickness of all following slurs from 1.2 to 5.0
555 \override Slur #'thickness = #5.0
557 g[( e]) e d[( f]) a |
561 The man who feels love's sweet e -- mo -- tion
567 y podemos ver que la ligadura, es sin duda, más pesada.
569 Así pues, ésta es la forma básica de construir instrucciones
570 @code{\override} o de sobreescritura. Existen unas cuantas
571 complicaciones más con las que nos encontraremos en secciones
572 posteriores, pero ahora conoce todos los principios esenciales que
573 necesita para hacerlo por sí mismo (aunque aún necesita algo de
574 práctica). La cual vendrá proporcionada por los ejemplos que vienen a
577 @subheading Finding the context
578 @cindex contexto, encontrar
580 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
581 especificar el contexto? ¿Cuál sería? Podemos suponer que las
582 ligaduras están en el contexto de Voz, por estar claramente asociados
583 de manera estrecha con las líneas individuales de música, pero
584 ¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
585 de la página del RFI que describe las ligaduras (Slur), donde dice
586 @q{Slur objects are created by: Slur engraver} («Los objetos de
587 ligadura de expresión se crean por: el grabador Slur»). Así pues, las
588 ligaduras de expresión se crean en cualquier contexto en el que se
589 encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
590 página del grabador @code{Slur_engraver}. Al final del todo, dice que
591 el grabador @code{Slur_engraver} es parte de cinco contextos de voz,
592 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
593 suposición era acertada. Y a causa de que @code{Voice} es uno de los
594 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
595 por el hecho de que estamos escribiendo notas, podemos omitirlo en
598 @subheading Overriding once only
600 @cindex sobreescritura por una sola vez
601 @cindex once override
604 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
605 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
606 ligadura fuese más gruesa? Esto se consigue con la instrucción o
607 prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
608 @code{\override} ocasiona que solamente cambie la ligadura que
609 comienza en la nota @strong{inmediata siguiente}. Si la nota
610 inmediata siguiente no da inicio a una ligadura, la instrucción no
611 tiene ningún efecto en absoluto: no se recuerda hasta que se
612 encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
613 la instrucción que lleva @code{\once} se debe reposicionar de la forma
616 @lilypond[quote,verbatim,relative=2]
621 % Increase thickness of immediately following slur only
622 \once \override Slur #'thickness = #5.0
624 g[( e]) e d[( f]) a |
628 The man who feels love's sweet e -- mo -- tion
634 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
636 La instrucción o prefijo @code{\once} también se puede usar antes de
637 la instrucción @code{\set}.
639 @subheading Reverting
642 @cindex predeterminadas, devolver a las propiedades
645 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
646 fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
647 una de ellas precedida por el prefijo @code{\once}, situadas
648 inmediatamente antes de cada una de las notas en que comienzan las
651 @lilypond[quote,verbatim,relative=2]
656 % Increase thickness of immediately following slur only
657 \once \override Slur #'thickness = #5.0
659 % Increase thickness of immediately following slur only
660 \once \override Slur #'thickness = #5.0
661 g[( e]) e d[( f]) a |
665 The man who feels love's sweet e -- mo -- tion
671 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
672 instrucción @code{\revert} (restablecer) para devolver la propiedad
673 del grosor, @code{thickness}, a su valor predeterminado después de la
676 @lilypond[quote,verbatim,relative=2]
681 % Increase thickness of all following slurs from 1.2 to 5.0
682 \override Slur #'thickness = #5.0
685 % Revert thickness of all following slurs to default of 1.2
686 \revert Slur #'thickness
691 The man who feels love's sweet e -- mo -- tion
697 la instrucción @code{\revert} se puede utilizar para devolver
698 cualquier propiedad que se haya cambiado con @code{\override} a su
699 valor predeterminado. Puede utilizar el método que mejor se adapte a
700 aquello que quiere hacer.
702 Así finaliza nuestra introducción al manual de RFI, y el método básico
703 de trucaje. A continuación, en las últimas secciones de este capítulo
704 encontrará varios ejemplos, en parte para introducirle en algunas de
705 las posibilidades adicionales del manual RFI, y en parte para
706 proporcionarle más práctica en cómo extraer información de él. Estos
707 ejemplos irán conteniendo cada vez menos palabras de guía y
710 @node Properties found in interfaces
711 @subsection Properties found in interfaces
713 @cindex propiedades de los interfaces
714 @cindex interfaces, propiedades
716 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
717 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
718 En primer lugar miramos en la página del RFI que relaciona todos los
719 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
720 pueda controlar la letra de la canción. Encontramos @code{LyricText},
721 que parece adecuado. Al seguir este enlace se presentan las
722 propiedades ajustables para el texto de la letra. Estos incluyen
723 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
724 una forma cursiva. Esto es porque la propiedad de la forma es común a
725 todos los objetos de fuente tipográfica, y por tanto, en vez de
726 incluirlo en cada uno de los objetos de presentación, se agrupa junto
727 con otras propiedades comunes similares y se deposita en un
728 @strong{Interface}, el interface de las fuentes tipográficas
729 @code{font-interface}.
731 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
732 de los interfaces, y descubrir qué objetos usan estas propiedades de
735 Mire de nuevo la página del RFI que describe a LyricText. Al final de
736 la página hay una lista de enlaces a los interfaces que LyricText
737 contempla. La lista tiene siete elementos, entre ellos
738 @code{font-interface}. Al seguir este enlace llegamos a las
739 propiedades asociadas con este interface, que también son propiedades
740 de todos los objetos que lo llevan, entre ellos LyricText.
742 Ahora vemos todas las propiedades ajustables por el usuario que
743 controlan las tipografías, entre ellas @code{font-shape(symbol)},
744 donde @code{symbol} se puede establecer a @code{upright} (recta),
745 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
747 Observará que @code{font-series} y @code{font-size} también se
748 encuentran aquí relacionadas. Esto inmediatamente hace que surja la
749 pregunta: ¿Por qué están las propiedades comunes de tipografía
750 @code{font-series} y @code{font-size} relacionadas bajo
751 @code{LyricText} así como bajo el interface @code{font-interface} pero
752 @code{font-shape} no lo está? La respuesta es que @code{font-series}
753 y @code{font-size} se cambian a partir de sus valores predeterminados
754 globales cuando se crea un objeto @code{LyricText}, pero
755 @code{font-shape} no lo hace. Entonces los elementos de la lista
756 @code{LyricText} le dicen los valores para esas dos propiedades que
757 son de aplicación para @code{LyricText}. Otros objetos que contemplan
758 @code{font-interface} establecerán dichas propiedades de forma
759 diferente cuando se crean.
761 Veamos si ahora podemos construir la instrucción @code{\override} para
762 cambiar la letra a cursiva. El objeto es @code{LyricText}, la
763 propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
764 antes, omitiremos el contexto.
766 Como nota aparte, aunque una nota importante, observe que a causa de
767 que los valores de @code{font-shape} son símbolos, deben ir precedidos
768 de un apóstrofo, @code{'}. Esa es la razón por la que se necesitan
769 apóstrofos antes de @code{thickness} en el ejemplo anterior y en
770 @code{font-shape}. Los dos son también símbolos. Los símbolos son
771 nombres especiales que son conocidos por LilyPond internamente.
772 Algunos de ellos son nombres de propiedades, como @code{thickness} o
773 @code{font-shape}, otros se utilizan como valores que se les puede dar
774 a las propiedades, como @code{italic}. Observe la distinción entre
775 esto y las cadenas de texto arbitrarias, que aparecerían
776 entrecomilladas como @code{"a text string"}. Para ver más detalles
777 relacionados con los símbolos y las cadenas, consulte @ref{Scheme
780 Así pues, la instrucción @code{\override} que necesitamos para
781 imprimir la letra en cursiva sería
784 \override LyricText #'font-shape = #'italic
788 y debe colocarse justo delante de, y cerca de, la letra a la que debe
791 @lilypond[quote,verbatim,relative=2]
796 g[( e]) e d[( f]) a |
800 \override LyricText #'font-shape = #'italic
801 The man who feels love's sweet e -- mo -- tion
807 y toda la letra se imprime en cursiva.
809 @subheading Specifying the context in lyric mode
810 @cindex contexto, especificación en modo letra
812 En el caso de la letra, si intenta especificar el contexto en el
813 formato que acabamos de dar, la instrucción no funcionará. Una
814 sílaba escrita en el modo letra, «lyricmode» termina en un espacio, un
815 salto de línea o un dígito. Cualquier otro carácter se incluye como
816 parte de la sílaba. Por esta razón, un espacio o salto de línea debe
817 aparecer antes del último símbolo @code{@}} para evitar que se incluya
818 como parte de la sílaba final. De forma similar, se deben insertar
819 espacios antes y después del punto, @q{.}, separando el nombre del
820 contexto del nombre del objeto, pues en caso contrario los dos nombres
821 se juntarán y el intérprete no podrá reconocerlos. Así pues, la
825 \override Lyrics . LyricText #'font-shape = #'italic
828 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
829 final y la llave de cierre.}
831 @warning{En las sobreescrituras con override dentro de la letra,
832 escriba siempre espacios antes y después del punto que separa el
833 nombre del contexto y el nombre del objeto.}
837 Manual de aprendizaje:
838 @ref{Scheme tutorial}.
840 @node Types of properties
841 @subsection Types of properties
843 @cindex propiedades, tipos de
845 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
846 @code{símbolo}. Para que sea válido, el valor que se da a una
847 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
848 tipo. El tipo de la propiedad se muestra siempre entre paréntesis
849 después del nombre de la propiedad en el RFI. He aquí una lista de
850 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
851 algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
852 @code{#}, por supuesto, delante de estos valores cuando se introducen
853 en la instrucción @code{\override}.
855 @multitable @columnfractions .2 .45 .35
856 @headitem Tipo de propiedad
860 @tab Verdadero o Falso, representado por #t o #f
861 @tab @code{#t}, @code{#f}
862 @item Dimensión (en espacios de pentagrama)
863 @tab Un número decimal positivo (en unidades de espacios de pentagrama)
864 @tab @code{2.5}, @code{0.34}
866 @tab Una constante válida de dirección o su equivalente numérico (se permiten valores decimales entre -1 y 1)
867 @tab @code{LEFT}, @code{CENTER}, @code{UP},
870 @tab Un número entero positivo
871 @tab @code{3}, @code{1}
873 @tab Un conjunto de valores separados por espacios, encerrado entre paréntesis y precedido de un apóstrofo
874 @tab @code{'(left-edge staff-bar)}, @code{'(1)},
875 @code{'(1.0 0.25 0.5)}
877 @tab Cualquier elemento válido de marcado de texto
878 @tab @code{\markup @{ \italic "cresc." @}}
880 @tab Una fracción de redonda construida con la función make-moment
881 @tab @code{(ly:make-moment 1 4)},
882 @code{(ly:make-moment 3 8)}
884 @tab Cualquier valor decimal positivo o negativo
885 @tab @code{3.5}, @code{-2.45}
886 @item Pareja (de números)
887 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
888 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
890 @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
891 @tab @code{'italic}, @code{'inside}
893 @tab Un procedimiento o @code{#f} para no producir ninguna acción
894 @tab @code{bend::print}, @code{ly:text-interface::print},
897 @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofo-almohadilla, @code{'#}.
898 @tab @code{'#(#t #t #f)}
903 Manual de aprendizaje:
904 @ref{Scheme tutorial}.
906 @node Appearance of objects
907 @section Appearance of objects
909 Ahora vamos a poner en práctica lo que hemos aprendido con unos
910 cuantos ejemplos que muestran cómo se pueden usar los trucos para
911 cambiar el aspecto de la música impresa.
914 * Visibility and color of objects::
916 * Length and thickness of objects::
919 @node Visibility and color of objects
920 @subsection Visibility and color of objects
922 Dentro de un uso educativo de la música, podríamos desear imprimir una
923 partitura con ciertos elementos omitidos como ejercicio para el
924 alumno, a quien se le pide que los complete. A la manera de ejemplo
925 sencillo, supongamos que el ejercicio es escribir las líneas
926 divisorias que faltan en un fragmento musical. Pero las líneas
927 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
930 Antes de enredarnos con esto, recordemos que las propiedades de los
931 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
932 @ref{Properties found in interfaces}). Esto es simplemente agrupar
933 las propiedades que se pueden usar juntas para trucar un objeto
934 gráfico: si una de ellas se necesita para un objeto, también las
935 otras. Así, ciertos objetos usan las propiedades de algunos
936 interfaces, otros usan las de otros interfaces. Los interfaces que
937 contienen las propiedades que un determinado grob necesita se
938 encuentran relacionadas en el manual RFI al final de la página que
939 describe dicho grob, y esas propiedades se pueden ver mirando dichos
942 Hemos explicado cómo encontrar información sobre los grobs en
943 @ref{Properties of layout objects}. Usando el mismo enfoque, vamos al
944 RFI para buscar el objeto de presentación que imprime las líneas
945 divisorias. A través del enlace @emph{Backend} y @emph{All layout
946 objects} encontramos que hay un objeto de presentación llamado
947 @code{BarLine}. Entre sus propiedades se encuentran dos que controlan
948 la visibilidad: @code{break-visibility} y @code{stencil}. Las líneas
949 divisorias también contemplan un número de interfaces, entre ellos el
950 @code{grob-interface}, donde podemos encontrar las propiedades
951 @code{transparent} y @code{color}. Todas ellas pueden afectar la
952 visibilidad de las barras de compás (y, por supuesto, por extensión,
953 también la de muchos otros objetos de presentación). Vamos a
954 considerar cada uno de ellos por orden.
957 @cindex stencil (sello), propiedad
959 Esta propiedad controla la apariencia de las barras de compás mediante
960 la especificación del símbolo (o «glifo») que se debe imprimir. Igual
961 que como otras muchas propiedades, se puede establecer de forma que no
962 imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
963 antes, omitiendo el Contexto implícito, @code{Voice}:
965 @lilypond[quote,verbatim,relative=2]
968 \override BarLine #'stencil = ##f
975 Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
976 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
977 objeto BarLine. Al principio de la página dice @qq{Barline objects
978 are created by: Bar_engraver} (los objetos Barline se crean por el
979 grabador Bar_engraver). Vaya a la página del grabador
980 @code{Bar_engraver} siguiendo el enlace. Al final da una lista de
981 contextos en los que el grabador de líneas divisorias opera. Todos
982 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
983 @code{\override} no funcionara como esperábamos, es porque
984 @code{Barline} no se encuentra en el contexto predeterminado
985 @code{Voice}. Si el contexto se especifica mal, la instrucción
986 simplemente no funciona. No se produce ningún mensaje de error, y no
987 se registra nada en el archivo log de registro. Vamos a intentar
988 corregirlo escribiendo el contexto correcto:
990 @lilypond[quote,verbatim,relative=2]
993 \override Staff.BarLine #'stencil = ##f
1000 Ahora las barras de compás han desaparecido.
1002 @subheading break-visibility
1004 @cindex break-visibility property
1006 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI que
1007 la propiedad @code{break-visibility} requiere un vector de tres
1008 valores booleanos. Controlan respectivamente si las barras de compás
1009 se imprimen al final de una línea, en mitad de una línea, y al
1010 principio de las líneas. Para nuestro ejemplo, queremos que todas las
1011 barras de compás se supriman, por lo que el valor que necesitamos es
1012 @code{'#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
1013 de @code{Staff}. Observe también que al escribir este valor tenemos
1014 @code{#'#} antes del paréntesis de apertura. Se necesita @code{'#}
1015 como parte del valor para introducir un vector, y el primer símbolo de
1016 almohadilla @code{#} se necesita, como siempre, para preceder el valor
1017 en sí dentro de la instrucción @code{\override}.
1019 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1022 \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
1024 g, a16 b8 c d4 e16 |
1029 Y podemos ver que esto también quita todas las líneas divisorias.
1031 @subheading transparent
1032 @cindex transparente, propiedad
1034 En la relación de propiedades que se especifican en la página del
1035 @code{grob-interface} del RFI podemos ver que la propiedad
1036 @code{transparent} es un valor booleano. Esto se debe establecer a
1037 @code{#t} para hacer que el grob sea transparente. En el ejemplo
1038 siguiente vamos a hacer que la indicación de compás, y no las líneas
1039 divisorias, sea transparente. Para hacerlo tenemos que buscar el
1040 nombre del grob de la indicación de compás. Volviendo a la página
1041 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1042 presentación @code{TimeSignature}. Se produce por parte del grabador
1043 @code{Time_signature_engraver} que como puede comprobar vive dentro
1044 del contexto de @code{Staff} y también contempla el interface
1045 @code{grob-interface}. Así pues, la instrucción que hace transparente
1046 a la indicación de compás es:
1048 @lilypond[quote,verbatim,relative=2]
1051 \override Staff.TimeSignature #'transparent = ##t
1053 g, a16 b8 c d4 e16 |
1059 El compás ya no está, pero esta instrucción deja una separación en el
1060 lugar donde antes estaba la indicación de compás. Quizá esto es lo
1061 que queremos para un ejercicio en que el alumno deba escribirlo, pero
1062 en otras circunstancias esta separación podría no ser deseable. En
1063 vez de eso, para quitarla, el stencil o «sello» de la indicación de
1064 compás se debe establecer al valor @code{#f}:
1066 @lilypond[quote,verbatim,relative=2]
1069 \override Staff.TimeSignature #'stencil = ##f
1071 g, a16 b8 c d4 e16 |
1077 y la diferencia es obvia: al establecer el sello al valor @code{#f}
1078 quitamos el objeto por completo; al hacer el objeto @code{transparent}
1079 lo dejamos donde está, pero lo hacemos invisible.
1082 @cindex color, propiedad
1084 Para finalizar, intentemos hacer invisibles las barras de compás
1085 pintándolas de color blanco (hay un problema relacionado, que consiste
1086 en que la línea divisoria blanca puede tapar o no tapar las líneas del
1087 pentagrama a las que cruza. Podrá observar en algunos de los ejemplos
1088 que aparecen a continuación, que esto sucede de forma impredecible.
1089 Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
1090 estudian en @ruser{Painting objects white}; de momento estamos
1091 estudiando el color, por lo que le rogamos que acepte esta limitación
1094 El interface @code{grob-interface} especifica que la propiedad del
1095 color es una lista, pero no hay ninguna explicación sobre lo que debe
1096 ir en esa lista. La lista que requiere es realmente una lista de
1097 valores en unidades internas, pero para evitar tener que saber cuáles
1098 son, se ofrecen varias vías para la especificación de los colores. La
1099 primera forma es utilizar uno de los colores @q{normales} que están
1100 relacionados en la primera tabla de la @ruser{List of colors}. Para
1101 poner las líneas divisorias de color blanco, escribimos:
1103 @lilypond[quote,verbatim,relative=2]
1106 \override Staff.BarLine #'color = #white
1108 g, a16 b8 c d4 e16 |
1114 y de nuevo podemos comprobar que las barras de compás no son visibles.
1115 Observe que @emph{white} no viene precedido de un apóstrofo: no es un
1116 símbolo, sino una @emph{función}. Cuando se invoca, proporciona la
1117 lista de valores internos que se requieren para establecer el color a
1118 blanco. Los otros colores de la lista normal también son funciones.
1119 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1120 una de las otras funciones de la lista.
1122 @cindex colores de X11
1123 @cindex X11, colores de
1125 La segunda forma de cambiar el color es utilizar la lista de nombres
1126 de colores de X11 que aparecen en la segunda lista de @ruser{List of
1127 colors}. Sin embargo, éstos deben ir precedidos de otra función, que
1128 convierte los nombres de colores de X11 en la lista de valores
1129 internos, @code{x11-color}, de la siguiente manera:
1131 @lilypond[quote,verbatim,relative=2]
1134 \override Staff.BarLine #'color = #(x11-color 'white)
1136 g, a16 b8 c d4 e16 |
1142 Observe que en este caso la función @code{x11-color} toma un símbolo
1143 como argumento, así que el símbolo debe ir precedido de un apóstrofo y
1144 los dos deben ir entre paréntesis.
1146 @cindex rgb, colores
1149 Aún hay una tercera función, que convierte valores RGB en colores
1150 internos: la función @code{rgb-color}. Toma tres argumentos que dan
1151 las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
1152 valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
1153 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1154 @code{(rgb-color 1 1 1)}:
1156 @lilypond[quote,verbatim,relative=2]
1159 \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1161 g, a16 b8 c d4 e16 |
1166 Finalmente, existe también una escala de grises como parte del
1167 conjunto de colores de X11. Varían desde el negro, @code{'grey0'},
1168 hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
1169 estableciendo todos los objetos de presentación de nuestro ejemplo a
1170 varias gradaciones de gris:
1172 @lilypond[quote,verbatim,relative=2]
1175 \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
1176 \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1177 \override Staff.Clef #'color = #(x11-color 'grey60)
1178 \override Voice.NoteHead #'color = #(x11-color 'grey85)
1179 \override Voice.Stem #'color = #(x11-color 'grey85)
1180 \override Staff.BarLine #'color = #(x11-color 'grey10)
1182 g, a16 b8 c d4 e16 |
1188 Observe los contextos asociados con cada uno de los objetos de
1189 presentación. Es importante que estén correctamente escritos, o las
1190 instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
1191 que se encuentra el grabador correspondiente. El contesto
1192 predeterminado para los grabadores puede encontrarse empezando por el
1193 objeto de presentación, de ahí al grabador que lo produce, y en la
1194 página del grabador del RFI aparece en qué contexto se puede encontrar
1195 normalmente el grabador.
1198 @node Size of objects
1199 @subsection Size of objects
1201 Empezaremos examinando de nuevo un ejemplo anterior (véase
1202 @ref{Nesting music expressions}) que nos mostraba cómo introducir un
1203 pentagrama temporal, como en un @rglos{ossia}.
1205 @lilypond[quote,verbatim,relative=2]
1206 \new Staff ="main" {
1213 alignAboveContext = "main" }
1221 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1222 por lo normal se imprimen más pequeños que el pentagrama principal.
1223 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1224 el sello de cada uno de ellos a @code{#f}, como sigue:
1226 @lilypond[quote,verbatim,relative=2]
1227 \new Staff ="main" {
1234 alignAboveContext = "main"
1237 \override Staff.Clef #'stencil = ##f
1238 \override Staff.TimeSignature #'stencil = ##f
1248 donde el par de llaves adicional después de la cláusula @code{\with}
1249 es necesario para asegurar que la sobreescritura encerrada y la música
1250 se aplican al pentagrama de ossia.
1252 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1253 usando @code{\with} y modificar los sellos de clave y de compás con
1254 \override? La diferencia principal es que los cambios que se realizan
1255 en una cláusula @code{\with} se hacen en el momento en que se crea el
1256 contexto, y permanecen activos como valores @strong{predeterminados}
1257 durante toda la duración de dicho contexto, mientras que las
1258 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1259 música son dinámicas: hacen cambios sincronizados con un punto
1260 concreto de la música. Si los cambios se deshacen o se devuelven
1261 mediante @code{\unset} o @code{\revert} volverán a su valor
1262 predeterminado que será el establecido en la cláusula @code{\with}, o
1263 si no se ha establecido ninguno en este lugar, los valores
1264 predeterminados normales.
1266 Ciertas propiedades de contexto se pueden modificar solamente dentro
1267 de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
1268 cambiar después de que el contexto se ha creado.
1269 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1270 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1271 alineación está decidida y no tendría sentido intentar cambiarla más
1274 Los valores predeterminados de las propiedades de los objetos de
1275 presentación también se pueden establecer dentro de cláusulas
1276 @code{\with}. Simplemente utilice la instrucción @code{\override}
1277 normal dejando aparte el nombre del contexto, ya que está definido sin
1278 ambigüedad como el contexto que la cláusula @code{\with} está
1279 modificando. De hecho, se producirá un error si se especifica un
1280 contexto en este lugar.
1282 Así pues, podemos reemplazar el ejemplo anterior con
1284 @lilypond[quote,verbatim,relative=2]
1285 \new Staff ="main" {
1292 alignAboveContext = "main"
1293 % Don't print clefs in this staff
1294 \override Clef #'stencil = ##f
1295 % Don't print time signatures in this staff
1296 \override TimeSignature #'stencil = ##f
1305 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1308 Ciertos objetos de presentación se crean como glifos sacados de una
1309 fuente tipográfica. Entre ellos se encuentran las cabezas,
1310 alteraciones, elementos de marcado, claves, indicaciones de compás,
1311 indicaciones dinámicas y la letra de las canciones. Su tamaño se
1312 cambia mediante la modificación de la propiedad @code{font-size}, como
1313 veremos en breve. Otros objetos de presentación como ligaduras de
1314 unión y de expresión (en general, objetos de extensión) se trazan
1315 individualmente, por lo que no hay un tamaño de tipografía
1316 @code{font-size} asociado a ellos. Estos objetos generalmente derivan
1317 su tamaño de los objetos a los que están adosados, y por ello
1318 normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
1319 otras propiedades como la longitud de las plicas y las barras de
1320 compás, el grosor de las barras de corchea y otras líneas, y la
1321 separación de las líneas del pentagrama se deben modificar de otras
1324 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1325 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1326 cambiar el tamaño de las tipografías de cada uno de los tipos de
1327 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1330 \override NoteHead #'font-size = #-2
1333 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1334 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1335 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1342 Los dos enunciados producirían una reducción del tamaño de la
1343 tipografía en dos pasos a partir de su valor previo, donde cada paso
1344 reduce o aumenta el tamaño aproximadamente en un 12%.
1346 Vamos a probarlo en nuestro ejemplo del ossia:
1348 @lilypond[quote,verbatim,relative=2]
1349 \new Staff ="main" {
1356 alignAboveContext = "main"
1357 \override Clef #'stencil = ##f
1358 \override TimeSignature #'stencil = ##f
1359 % Reduce all font sizes by ~24%
1369 Aún no está demasiado bien. Las cabezas y los corchetes de las notas
1370 son más pequeños, pero las plicas son demasiado largas en proporción,
1371 y las líneas del pentagrama están demasiado separadas entre sí. Se
1372 debe reducir su escala en proporción a la reducción de la tipografía.
1373 El siguiente apartado trata sobre cómo se hace esto.
1375 @node Length and thickness of objects
1376 @subsection Length and thickness of objects
1382 @cindex tamaño, cambiar
1383 @cindex plica, cambiar la longitud
1384 @cindex pentagrama, cambiar la separación de las líneas
1386 Las distancias y longitudes en LilyPond se miden generalmente en
1387 espacios de pentagrama, la distancia entre líneas adyacentes de la
1388 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1389 de las propiedades de @code{thickness} (grosor) se miden en unidades
1390 de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
1391 de forma predeterminada, a las líneas de los reguladores se les da un
1392 grosor de 1 unidad de @code{line-thickness}, mientras que el
1393 @code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
1394 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1395 barras de corchea se mide en espacios de pentagrama.
1397 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1398 tamaño de la tipografía? Se puede hacer con la ayuda de una función
1399 especial que se llama @code{magstep}, pensada especialmente para este
1400 propósito. Toma un argumento, el cambio de tamaño de la tipografía
1401 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1402 para reducir otros objetos en la misma proporción. Se usa de la
1405 @lilypond[quote,verbatim,relative=2]
1406 \new Staff ="main" {
1413 alignAboveContext = "main"
1414 \override Clef #'stencil = ##f
1415 \override TimeSignature #'stencil = ##f
1417 % Reduce stem length and line spacing to match
1418 \override StaffSymbol #'staff-space = #(magstep -2)
1428 Puesto que la longitud de las plicas y muchas otras propiedades
1429 relacionadas con la longitudes calculan siempre con relación al valor
1430 de la propiedad @code{staff-space}, su longitud también ve reducida su
1431 escala automáticamente. Observe que esto afecta solamente a la escala
1432 vertical del ossia: la escala horizontal se determina por medio de la
1433 disposición de la música principal con el objeto de mantenerse en
1434 sincronía con ella, de forma que no resulte afectada por ninguno de
1435 estos cambios de tamaño. Por supuesto, si la escala de toda la música
1436 principal se cambiase de esta forma, entonces el espaciado horizontal
1437 se vería afectado. Trataremos de esto más tarde en la sección sobre
1440 Esto, en fin, completa la creación de un ossia. Los tamaños y
1441 longitudes del resto de los objetos se pueden modificar de manera
1444 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1445 grosor de las diversas líneas dibujadas como divisorias, barras de
1446 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1447 ajuste global. Si el grosor de cualquier objeto de presentación en
1448 particular necesita ajustarse, se puede hacer mejor mediante la
1449 sobreescritura de su propiedad @code{thickness}. Anteriormente
1450 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1451 @ref{Properties of layout objects}. El grosor de todos los objetos
1452 trazados (es decir, aquellos que no se producen a partir de una
1453 tipografía) se pueden cambiar de la misma forma.
1456 @node Placement of objects
1457 @section Placement of objects
1460 * Automatic behaviour::
1461 * Within-staff objects::
1462 * Outside staff objects::
1466 @node Automatic behaviour
1467 @subsection Automatic behaviour
1469 Hay ciertos objetos en notación musical que pertenecen al pentagrama y
1470 otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
1471 objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
1474 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1475 pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
1476 se fijan por la propia música; se posicionan verticalmente sobre
1477 líneas específicas del pentagrama o están unidos a otros objetos
1478 posicionados de esta forma. Las colisiones entre cabezas, plicas y
1479 alteraciones en acordes de notas muy juntas, normalmente se evitan
1480 automáticamente. Hay instrucciones y sobreescrituras que pueden
1481 modificar este comportamiento automático, como veremos en breve.
1483 Entre los objetos que pertenecen al exterior de la pauta se encuentran
1484 cosas como las marcas de ensayo, las marcas de texto y las de
1485 dinámica. La regla de LilyPond para la colocación vertical de los
1486 objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
1487 como sea posible, pero no tan cerca como para que puedan chocar con
1488 algún otro objeto. LilyPond utiliza la propiedad
1489 @code{outside-staff-priority} para determinar el orden en que se deben
1490 situar los objetos, como veremos ahora.
1492 En primer lugar, LilyPond sitúa todos los objetos
1493 dentro-del-pentagrama. Después ordena los objetos
1494 fuera-del-pentagrama de acuerdo con su prioridad
1495 @code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
1496 toman de uno en uno, comenzando por el que tiene la prioridad
1497 @code{outside-staff-priority} más baja, y se sitúan de forma que no
1498 colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
1499 grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
1500 la prioridad @code{outside-staff-priority} más baja se colocará más
1501 cerca del pentagrama. Si dos objetos tienen la misma
1502 @code{outside-staff-priority}, el que se ha encontrado primero se
1503 situará más cerca de la pauta.
1505 En el siguiente ejemplo, todos los textos de marcado tienen la misma
1506 prioridad (pues no se ha establecido explícitamente). Observe que
1507 @q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
1508 acomodado por debajo de @q{Text2}.
1510 @lilypond[quote,verbatim,relative=2]
1517 Los pentagramas también se posicionan, de forma predeterminada, tan
1518 cerca unos de otros como sea posible (sujeto a una separación mínima).
1519 Si las notas se proyectan muy lejos en dirección a un pentagrama
1520 adyacente, forzarán a alejarse a los pentagramas sólo si en caso
1521 contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
1522 siguiente muestra esta acomodación @q{nestling} de las notas sobre
1523 pentagramas adyacentes:
1525 @lilypond[quote,ragged-right,verbatim]
1528 \relative c' { c a, }
1531 \relative c'''' { c a, }
1537 @node Within-staff objects
1538 @subsection Within-staff objects
1540 Ya hemos visto cómo las instrucciones @code{\voiceXXX} affectan a la
1541 dirección de las ligaduras de expresión y de unión, digitaciones y
1542 todo lo demás que dependa de la dirección de las plicas. Cuando se
1543 escribe música polifónica, estas instrucciones son esenciales para que
1544 puedan distinguirse varias líneas melódicas entrelazadas. Pero
1545 ocasionalmente puede ser necesario sobreescribir este comportamiento
1546 automático. Se puede hacer por secciones de música completas o
1547 incluso para una nota individual. La propiedad que controla este
1548 comportamiento es la propiedad de @code{direction} (dirección) de cada
1549 objeto de presentación. En primer lugar explicaremos qué hace esto, y
1550 luego introduciremos algunas instrucciones listas para usar que le
1551 evitarán tener que codificar sobreescrituras explícitas para las
1552 modificaciones más comunes.
1554 Algunos objetos de presentación como las ligaduras se curvan hacia
1555 arriba o hacia abajo; otros como las plicas y los corchetes también se
1556 mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
1557 hacia abajo. Esto se controla automáticamente cuando está establecida
1558 la propiedad @code{direction}.
1560 El ejemplo siguiente muestra en el compás 1 el comportamiento
1561 predeterminado de las plicas, con las de las notas agudas apuntando
1562 hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
1563 todas las plicas forzadas hacia abajo, cuatro notas con las plicas
1564 forzadas hacia arriba, y por último cuatro notas devueltas al
1565 comportamiento predeterminado.
1567 @lilypond[quote,verbatim,relative=2]
1569 \override Stem #'direction = #DOWN
1571 \override Stem #'direction = #UP
1573 \revert Stem #'direction
1577 Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
1578 (arriba). Éstos tienen los valores @code{-1} y @code{+1}
1579 respectivamente, y dichos valores numéricos también se pueden usar
1580 directamente. El valor @code{0} también se puede usar en algunos
1581 casos. Se trata simplemente con el significado de @code{UP} para las
1582 plicas, pero para algunos objetos tiene el significado de
1583 @q{centrado}. Existe una constante @code{CENTER} que tiene el valor
1586 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
1587 están disponibles instrucciones predefinidas equivalentes más
1588 sencillas. Aquí podemos ver una tabla de las más comunes. Se
1589 menciona el significado de cada una allí donde no es obvio.
1591 @multitable @columnfractions .2 .2 .25 .35
1592 @headitem Abajo o Izquierda
1593 @tab Arriba o Derecha
1596 @item @code{\arpeggioArrowDown}
1597 @tab @code{\arpeggioArrowUp}
1598 @tab @code{\arpeggioNormal}
1599 @tab La flecha está abajo, arriba o no hay flecha
1600 @item @code{\dotsDown}
1602 @tab @code{\dotsNeutral}
1603 @tab Dirección del desplazamiento para evitar las líneas del pentagrama
1604 @item @code{\dynamicDown}
1605 @tab @code{\dynamicUp}
1606 @tab @code{\dynamicNeutral}
1608 @item @code{\phrasingSlurDown}
1609 @tab @code{\phrasingSlurUp}
1610 @tab @code{\phrasingSlurNeutral}
1611 @tab Nota: diferente de las instrucciones de ligaduras de expresión
1612 @item @code{\slurDown}
1614 @tab @code{\slurNeutral}
1616 @item @code{\stemDown}
1618 @tab @code{\stemNeutral}
1620 @item @code{\textSpannerDown}
1621 @tab @code{\textSpannerUp}
1622 @tab @code{\textSpannerNeutral}
1623 @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
1624 @item @code{\tieDown}
1626 @tab @code{\tieNeutral}
1628 @item @code{\tupletDown}
1629 @tab @code{\tupletUp}
1630 @tab @code{\tupletNeutral}
1631 @tab Los grupos especiales están debajo o encima de las notas
1634 Observe que estas instrucciones predefinidas @strong{no} pueden ir
1635 precedidas de @code{\once}. Si quiere limitar el efecto a una sola
1636 nota, deberá elegir entre usar la instrucción @code{\once \override}
1637 equivalente, o usar la instrucción predefinida, seguida después de la
1638 nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
1640 @subheading Fingering
1641 @cindex digitación, colocación
1643 La colocación de las digitaciones se puede controlar también por el
1644 valor de su propiedad @code{direction}, pero los cambios en
1645 @code{direction} no afectan a los acordes. Como veremos, existen
1646 instrucciones especiales que permiten controlar las digitaciones de
1647 notas individuales, situando la digitación encima, debajo, a la
1648 izquierda o a la derecha de cada nota.
1650 En primer lugar, he aquí el efecto de @code{direction} sobre las
1651 digitaciones aplicadas a notas sueltas; el primer compás muestra el
1652 comportamiento predeterminado, y los dos compases siguientes muestran
1653 el efecto de especificar @code{DOWN} y @code{UP}:
1655 @lilypond[quote,verbatim,relative=2]
1657 \override Fingering #'direction = #DOWN
1659 \override Fingering #'direction = #UP
1663 Sin embargo, la sobreescritura de la propiedad @code{direction} no es
1664 la manera más sencilla de poner manualmente las digitaciones encima o
1665 debajo de las notas; suele ser preferible utilizar @code{_} o @code{^}
1666 en lugar de @code{-} antes de la digitación. He aquí el ejemplo
1667 anterior usando este método:
1669 @lilypond[quote,verbatim,relative=2]
1675 La propiedad @code{direction} se ignora para los acordes, pero los
1676 prefijos direccionales @code{_} y @code{^} funcionan. De forma
1677 predeterminada las digitaciones se colocan automáticamente encima y
1678 debajo de las notas del acorde, como se muestra aquí:
1680 @lilypond[quote,verbatim,relative=2]
1687 pero esto se puede sobreescribir para forzar manualmente que todos o
1688 cualquiera de los números de digitación individuales están encima o
1691 @lilypond[quote,verbatim,relative=2]
1697 Es posible tener un control incluso mayor sobre la situación exacta de
1698 las digitaciones mediante la utilización de la instrucción @code{\set
1699 fingeringOrientations}. El formato de esta instrucción es
1702 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
1706 se utiliza @code{\set} porque @code{fingeringOrientations} es una
1707 propiedad del contexto @code{Voice}, creado y usado por el grabador
1708 @code{New_fingering_engraver}.
1710 La propiedad se puede establecer al valor de una lista de entre uno y
1711 tres valores. Controla si las digitaciones se pueden colocar por
1712 encima (si @code{up} aparece en la lista), por debajo (si aparece
1713 @code{down}), a la izquierda (si aparece @code{left}) o a la derecha
1714 (si aparece @code{right}). A la inversa, si una colocación no está en
1715 la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
1716 coma estas restricciones y se trabaja la mejor colocación para la
1717 digitación de las notas de los acordes que siguen. Observe que
1718 @code{left} y @code{right} son mutuamente excluyentes: las
1719 digitaciones pueden situarse en un lado o en el otro, no en los dos.
1721 @warning{Para controlar la colocación de la digitación de una sola
1722 nota usando esta instrucción es necesario escribirla como un acorde de
1723 una sola nota encerrándola entre ángulos simples.}
1725 Aquí podemos ver algunos ejemplos:
1727 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1728 \set fingeringOrientations = #'(left)
1730 < c-1 e-2 g-3 b-5 > 4
1731 \set fingeringOrientations = #'(left)
1733 < c-1 e-2 g-3 b-5 > 4
1734 \set fingeringOrientations = #'(up left down)
1736 < c-1 e-2 g-3 b-5 > 4
1737 \set fingeringOrientations = #'(up left)
1739 < c-1 e-2 g-3 b-5 > 4
1740 \set fingeringOrientations = #'(right)
1742 < c-1 e-2 g-3 b-5 > 4
1746 Si la digitación parece un poco superpoblada, se puede reducir el
1747 tamaño @code{font-size}. El valor predeterminado puede verse en el
1748 objeto @code{Fingering} del RFI que es @code{-5}, así que probaremos
1751 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1752 \override Fingering #'font-size = #-7
1753 \set fingeringOrientations = #'(left)
1755 < c-1 e-2 g-3 b-5 > 4
1756 \set fingeringOrientations = #'(left)
1758 < c-1 e-2 g-3 b-5 > 4
1759 \set fingeringOrientations = #'(up left down)
1761 < c-1 e-2 g-3 b-5 > 4
1762 \set fingeringOrientations = #'(up left)
1764 < c-1 e-2 g-3 b-5 > 4
1765 \set fingeringOrientations = #'(right)
1767 < c-1 e-2 g-3 b-5 > 4
1770 @node Outside staff objects
1771 @subsection Outside staff objects
1773 Los objetos fuera-del-pentagrama se colocan automáticamente para
1774 evitar las colisiones. Los objetos que tienen el valor más bajo de la
1775 propiedad @code{outside-staff-priority} se sitúan más cerca del
1776 pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
1777 tanto como sea necesario para evitar la colisión. La prioridad
1778 @code{outside-staff-priority} se defina en el @code{grob-interface} y
1779 así es una propiedad de todos los objetos de presentación. De forma
1780 predeterminada se establece a @code{#f} para todos los objetos
1781 dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
1782 fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
1783 presenta los valores numéricos predeterminados para algunos de los
1784 objetos fuera-del-pentagrama que están inicialmente dentro de los
1785 contextos @code{Staff} o @code{Voice}.
1787 @multitable @columnfractions .3 .3 .3
1788 @headitem Objeto de presentación
1790 @tab Controla la posición de:
1791 @item @code{MultiMeasureRestText}
1793 @tab Texto sobre silencios de compás completo
1794 @item @code{TextScript}
1796 @tab Elementos de marcado de texto
1797 @item @code{OttavaBracket}
1799 @tab Corchetes de octava alta y baja
1800 @item @code{TextSpanner}
1802 @tab Objetos de extensión de texto
1803 @item @code{DynamicLineSpanner}
1805 @tab Todas las indicaciones dinámicas
1806 @item @code{VoltaBracketSpanner}
1808 @tab Corchetes de primera y segunda vez
1809 @item @code{TrillSpanner}
1811 @tab Trinos mantenidos
1814 He aquí un ejemplo que muestra la situación predeterminada de algunos
1817 @cindex texto, extensiones de
1818 @funindex \startTextSpan
1819 @funindex \stopTextSpan
1820 @cindex octava alta y baja, corchete de
1822 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1823 % Set details for later Text Spanner
1824 \override TextSpanner #'bound-details #'left #'text
1825 = \markup { \small \bold Slower }
1826 % Place dynamics above staff
1828 % Start Ottava Bracket
1833 % Add Dynamic Line Spanner
1839 c\ff c \stopTextSpan
1840 % Stop Ottava Bracket
1845 Este ejemplo también muestra cómo crear textos con extensión (Text
1846 Spanners): textos con líneas extensoras por encima de una sección de
1847 música. El extensor abarca desde la instrucción @code{\startTextSpan}
1848 hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
1849 define por medio de la instrucción @code{\override TextSpanner}. Para
1850 ver más detalles, consulte @ruser{Text spanners}.
1852 También muestra la manera de crear corchetes de octava alta y baja.
1854 Observe que los números de compás, las indicaciones metronómicas y las
1855 mercas de ensayo no se muestran. De forma predeterminada, se crean
1856 dentro del contexto @code{Score} y su prioridad
1857 @code{outside-staff-priority} se ignora con relación a los objetos de
1858 presentación que se crean dentro del contexto @code{Staff}. Si quiere
1859 colocar los números de compás, indicaciones metronómicas o llamadas de
1860 ensayo en concordancia con el valor de su
1861 @code{outside-staff-priority}, los grabadores
1862 @code{Bar_number_engraver}, @code{Metronome_mark_engraver} o
1863 @code{Mark_engraver} respectivamente se deben eliminar del contexto
1864 @code{Score} y colocarlos en el contexto @code{Staff} del nivel
1865 superior. Si se hace así, estas marcas obtendrán los siguientes
1866 valores predeterminados de @code{outside-staff-priority}:
1868 @multitable @columnfractions .3 .3
1869 @headitem Objeto de presentación @tab Prioridad
1870 @item @code{RehearsalMark} @tab @code{1500}
1871 @item @code{MetronomeMark} @tab @code{1000}
1872 @item @code{BarNumber} @tab @code{ 100}
1875 Si los valores predeterminados de @code{outside-staff-priority} no le
1876 ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
1877 de cualquiera de los objetos. Suponga que quisiéramos que el corchete
1878 de octava estuviera situado por debajo del elemento extensor de texto
1879 en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
1880 prioridad de @code{OttavaBracket} en el RFI o en las tablas
1881 anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
1882 recordando que @code{OttavaBracket} se crea dentro del contexto de
1885 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1886 % Set details for later Text Spanner
1887 \override TextSpanner #'bound-details #'left #'text
1888 = \markup { \small \bold Slower }
1889 % Place dynamics above staff
1891 %Place following Ottava Bracket below Text Spanners
1892 \once \override Staff.OttavaBracket #'outside-staff-priority = #340
1893 % Start Ottava Bracket
1898 % Add Dynamic Line Spanner
1904 c\ff c \stopTextSpan
1905 % Stop Ottava Bracket
1910 Los cambios en @code{outside-staff-priority} también se pueden emplear
1911 para controlar la situación vertical de los objetos individuales,
1912 aunque los resultados pueden no siempre ser deseables. Suponga que
1913 quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
1914 bajo el epígrafe Comportamiento Automático de más arriba (véase
1915 @ref{Automatic behaviour}). Todo lo que debemos hacer es localizar la
1916 prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
1917 aumentar la prioridad de @qq{Text3} hasta un valor superior:
1919 @lilypond[quote,verbatim,relative=2]
1922 \once \override TextScript #'outside-staff-priority = #500
1927 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
1928 también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
1929 desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
1930 realmente queremos hacer es posicionar todas las anotaciones a la
1931 misma distancia por encima del pentagrama? Para hacerlo, vamos a
1932 necesitar claramente espaciar las notas en sentido horizontal para
1933 hacer sitio para el texto. Esto se hace empleando la instrucción
1934 @code{textLengthOn}.
1936 @subheading \textLengthOn
1938 @funindex \textLengthOn
1939 @cindex notas, espaciar junto al texto
1941 De forma predeterminada, el texto producido mediante marcado no ocupa
1942 ningún espacio horizontal en cuanto se refiere a la disposición de la
1943 música. La instrucción @code{\textLengthOn} invierte este
1944 comportamiento, ocasionando que las notas resulten tan espaciadas como
1945 sea necesario para acomodar el texto:
1947 @lilypond[quote,verbatim,relative=2]
1948 \textLengthOn % Cause notes to space out to accommodate text
1955 La instrucción para volver al comportamiento predeterminado es
1956 @code{\textLengthOff}. Recuerde que @code{\once} funciona solamente
1957 con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
1958 que no se puede usar con @code{\textLengthOn}.
1960 El texto de marcado también evita las notas que se proyectan por
1961 encima del pentagrama. Si esto no es lo que deseamos, el
1962 desplazamiento automático hacia arriba se puede desactivar mediante el
1963 establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
1964 muestra cómo el texto de marcado interactúa con tales notas.
1966 @lilypond[quote,verbatim,relative=2]
1967 % This markup is short enough to fit without collision
1971 % This is too long to fit, so it is displaced upwards
1975 % Turn off collision avoidance
1976 \once \override TextScript #'outside-staff-priority = ##f
1980 % Turn off collision avoidance
1981 \once \override TextScript #'outside-staff-priority = ##f
1982 \textLengthOn % and turn on textLengthOn
1983 c,,2^"Long Text " % Spaces at end are honoured
1988 @subheading Dynamics
1990 Las indicaciones de matiz dinámico normalmente se colocarán por debajo
1991 del pentagrama, pero se pueden posicionar por encima con la
1992 instrucción @code{dynamicUp}. Se situarán verticalmente respecto a la
1993 nota a la que van adosadas, y flotarán por debajo (o por encima) de
1994 todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
1995 y números de compás. Esto puede ofrecer resultados bastante
1996 aceptables, como muestra este ejemplo:
1998 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2003 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2004 ees,2.~\)\mf ees4 r8 |
2007 Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
2008 muy cerca, la colocación automática evitará las colisiones desplazando
2009 las marcas dinámicas posteriores más lejos, aunque este puede no ser
2010 el lugar óptimo, como muestra el siguiente ejemplo más bien
2013 @lilypond[quote,verbatim,relative=2]
2019 Si se presentara una situación similar en música @q{real}, podría ser
2020 preferible espaciar las notas un poco más entre sí, de forma que todas
2021 las marcas dinámicas puedan caber a la misma distancia vertical desde
2022 el pentagrama. Hemos sido capaces de hacer esto para el texto de
2023 marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
2024 una instrucción equivalente para las indicaciones de matiz dinámico.
2025 Por tanto, tendremos que averiguar cómo hacerlo utilizando
2026 instrucciones @code{\override}.
2028 @subheading Grob sizing
2030 @cindex grob, cambio de tamaño de un
2031 @cindex escala de los grobs
2032 @cindex @code{X-offset}
2033 @cindex @code{Y-offset}
2034 @cindex @code{X-extent}
2035 @cindex @code{Y-extent}
2037 En primer lugar debemos aprender cómo se especifica el tamaño de los
2038 grobs. Todos los grobs tienen un punto de referencia definido dentro
2039 de ellos que se usa para colocarlos respecto a su objeto padre.
2040 Entonces, este punto del grob se posiciona a una distancia horizontal,
2041 @code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
2042 de su padre. La dimensión horizontal del objeto viene dada por una
2043 pareja de números, @code{X-extent}, que dice dónde están los límites
2044 izquierdo y derecho respecto del punto de referencia. La amplitud
2045 vertical se define de forma similar mediante una pareja de números,
2046 @code{Y-extent}. Éstas son propiedades de todos los grobs que
2047 contemplan el @code{grob-interface}.
2049 @cindex @code{extra-spacing-width}
2051 De forma predeterminada, los objetos fuera-del-pentagrama reciben una
2052 anchura cero, de manera que pueden solaparse en la dirección
2053 horizontal. Esto se hace mediante el truco de añadir una cantidad
2054 infinita a la dimensión más a la izquierda y menos infinito a la
2055 dimensión más a la derecha estableciendo el valor de
2056 @code{extra-spacing-width} a @code{'(+inf.0 . -inf.0)}. Así, para
2057 asegurar que no se superponen en la dirección horizontal tendremos que
2058 sobreescribir este valor de @code{extra-spacing-width} a @code{'(0
2059 . 0)} de forma que el verdadero ancho se presente. Esta es la
2060 instrucción que lo hace para las indicaciones dinámicas:
2063 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2067 Veamos si funciona en nuestro ejemplo anterior:
2069 @lilypond[quote,verbatim,relative=2]
2071 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2076 Bueno, ciertamente ha hecho que las marcas dinámicas ya no estén
2077 desplazadas, pero aún quedan dos problemas. Las marcas tendrían que
2078 separarse un poco más entre sí, y sería mejor si todas estuvieran a la
2079 misma distancia del pentagrama. Podemos resolver el primer problema
2080 fácilmente. En vez de hacer cero la anchura
2081 @code{extra-spacing-width}, podemos añadirle algo más. Las unidades
2082 son el espacio entre dos líneas de pentagrama, así que al mover el
2083 límite izquierdo media unidad a la izquierda y el límite derecho media
2084 unidad hacia la derecha, deberíamos conseguirlo:
2086 @lilypond[quote,verbatim,relative=2]
2088 % Extend width by 1 staff space
2089 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2094 Esto tiene un mejor aspecto, pero quizá habríamos preferido que las
2095 indicaciones de dinámica estuvieran alineadas sobre la misma línea de
2096 base en lugar de ir hacia arriba y hacia abajo con las notas. La
2097 propiedad que lo hace es @code{staff-padding} (relleno de pentagrama)
2098 que se estudia en la sección siguiente.
2101 @node Collisions of objects
2102 @section Collisions of objects
2106 * Fixing overlapping notation::
2107 * Real music example::
2110 @node Moving objects
2111 @subsection Moving objects
2113 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
2114 de notación se pueden superponer, lo que es una lástima, pero en
2115 realidad es bastante poco frecuente. Normalmente la necesidad de
2116 mover objetos es por claridad o razones estéticas: el aspecto es mejor
2117 con un poco más o un poco menos de espacio de separación.
2119 Existen tres enfoques principales que llevan a la resolución de
2120 superposiciones en la notación. Se deben considerar en el siguiente
2125 La @strong{dirección} de uno de los objetos que se superponen se puede
2126 cambiar usando las instrucciones predefinidas que están relacionadas
2127 arriba para los objetos dentro-del-pentagrama (véase @ref{Within-staff
2128 objects}). Se pueden recolocar fácilmente las plicas, ligaduras de
2129 expresión y de unión, barras de corchea, indicaciones dinámicas, texto
2130 y grupos de valoración especial de esta forma. La limitación es que
2131 sólo tiene la posibilidad de elegir entre dos posiciones, y podría ser
2132 que ninguna de ellas sea la adecuada.
2135 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2136 colocando los objetos de presentación, se pueden modificar usando la
2137 instrucción de sobreescritura @code{\override}. Las ventadas de hacer
2138 cambios a este tipo de propiedad son: a) que algún otro objeto se
2139 moverá automáticamente si es necesario, para dejarle sitio, y b) una
2140 única sobreescritura se puede aplicar a todas las instancias del mismo
2141 tipo de objeto. Entre tales propiedades se encuentran:
2146 @code{direction} (dirección)
2148 Ya se ha estudiado con cierto detalle: véase @ref{Within-staff
2152 @code{padding} (relleno), @code{left-padding} (relleno por la
2153 izquierda), @code{right-padding} (relleno por la derecha),
2154 @code{staff-padding} (relleno de pentagrama)
2156 @cindex left-padding, propiedad
2157 @cindex padding, propiedad
2158 @cindex right-padding, propiedad
2159 @cindex staff-padding, propiedad
2160 Según un objeto se está colocando, el valor de su propiedad de relleno
2161 @code{padding} especifica el espacio intermedio que se debe dejar
2162 entre él mismo y el límite más próximo del objeto contra el que se
2163 está colocando. Observe que es el valor de @code{padding} del objeto
2164 @strong{que se está colocando} el que se usa; el valor de
2165 @code{padding} del objeto que ya está colocado se ignora. Los
2166 espacios intermedios especificados mediante @code{padding} se pueden
2167 aplicar a todos los objetos que contemplan el interface
2168 @code{side-position-interface}.
2170 En lugar de con @code{padding}, la colocación de los grupos de
2171 alteraciones se controla con @code{left-padding} y
2172 @code{right-padding}. Estas propiedades se encontrarán en el objeto
2173 @code{AccidentalPlacement} que, observe, vive dentro del contexto de
2174 @strong{staff}. Durante el proceso tipográfico, las cabezas de las
2175 notas se componen tipográficamente en primer lugar, y después las
2176 alteraciones, si existen, se añaden a la izquierda de las cabezas
2177 utilizando la propiedad de relleno por la derecha @code{right-padding}
2178 para determinar la separación entre la alteración y la cabeza. así
2179 pues, sólo la propiedad de relleno por la derecha @code{right-padding}
2180 del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
2181 de las alteraciones.
2183 La propiedad @code{staff-padding} está estrechamente relacionada con
2184 la propiedad @code{padding}: @code{padding} controla la separación
2185 mínima entre cualquier objeto que contemple el interface
2186 @code{side-position-interface} y el objeto más cercano (generalmente
2187 la nota o las líneas del pentagrama); @code{staff-padding} se aplica
2188 sólo a los objetos que siempre se sitúan fuera del pentagrama:
2189 controla la separación mínima entre dicho objeto y el pentagrama.
2190 Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
2191 que se posicionan respecto a la nota en vez de hacerlo respecto al
2192 pentagrama, incluso aunque puede ser sobreescrito sin error por tales
2193 objetos: simplemente se ignora.
2195 Para descubrir qué propiedad de relleno se necesita para el objeto que
2196 quiere recolocar, debe volver al manual de RFI y buscar las
2197 propiedades del objeto. Tenga cuidado porque las propiedades de
2198 relleno podrían no estar en el objeto más obvio, así que busque en los
2199 objetos que puedan tener alguna relación con él.
2201 Todos los valores de relleno se miden en espacios del pentagrama.
2202 Para la mayor parte de los objetos el valor se establece de forma
2203 predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
2204 Se puede sobreescribir si se necesita una separación intermedia mayor
2208 @code{self-alignment-X} (Auto-alineamiento en el eje X)
2210 @cindex self-alignment-X, propiedad
2211 Esta propiedad se puede usar para alinear el objeto a la izquierda, a
2212 la derecha, o centrarlo con respecto al punto de referencia del objeto
2213 «padre». Se puede usar con todos los objetos que contemplan el
2215 @code{self-alignment-interface}. En general son objetos que contienen
2216 texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
2217 forma alternativa se puede especificar un valor numérico entre
2218 @code{-1} y @code{+1}, donde @code{-1} es alineado por la izquierda,
2219 @code{+1} es alineado por la derecha, y los números intermedios mueven
2220 el texto progresivamente desde alineado por la izquierda hasta alineado
2221 por la derecha. Se pueden especificar valores numéricos mayores de
2222 @code{1} para mover el texto incluso más lejos hacia la izquierda, o
2223 menos de @code{-1} para alejarlo más hacia la derecha. Un cambio en
2224 @code{1} en el valor corresponde a un movimiento de la mitad de la
2225 longitud total del propio texto.
2228 @code{extra-spacing-width} (anchura de separación adicional)
2230 @cindex extra-spacing-width, propiedad
2231 Esta propiedad está disponible para todos los objetos que contemplan
2232 el interface @code{item-interface}. Toma dos números, el primero se
2233 suma al límite izquierdo y el segundo se suma al límite derecho. Los
2234 números negativos desplazan el límite a la izquierda y los positivos a
2235 la derecha, por lo que para ensanchar un objeto el primer número debe
2236 ser negativo y el segundo positivo. Observe que no todos los objetos
2237 ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
2238 (alteración) sólo toma nota del primer número (el borde izquierdo).
2241 @code{staff-position} (posición de pentagrama)
2243 @cindex staff-position, propiedad
2244 @code{staff-position} es una propiedad del interface
2245 @code{staff-symbol-referencer-interface}, que está contemplado por los
2246 objetos que se colocan con relación al pentagrama. Especifica la
2247 posición vertical del objeto con relación a la tercera línea del
2248 pentagrama en medios espacios de pentagrama. Es útil en la
2249 resolución de colisiones entre objetos de presentación como silencios
2250 multi-compás, ligaduras de unión y notas en distintas voces.
2253 @code{force-hshift} (forzar desplazamiento horizontal)
2255 @cindex force-hshift, propiedad
2257 Las notas muy juntas de un acorde, o aquellas que ocurren al mismo
2258 tiempo en voces distintas, se disponen en dos (y ocasionalmente más)
2259 columnas para evitar la superposición de las cabezas. Éstas reciben
2260 el nombre de columnas de notas, y se crea un objeto llamado
2261 @code{NoteColumn} para disponer las notas en dicha columna.
2263 La propiedad @code{force-hshift} es una propiedad de una
2264 @code{NoteColumn} (realmente lo es del interface
2265 @code{note-column-interface}). Modificarlo permite mover una columna
2266 de notas en unidades adecuadas a una columna de notas, por ejemplo la
2267 anchura de la cabeza de la nota de la primera voz. Se debe usar en
2268 situaciones complejas donde las instrucciones @code{\shiftOn} normales
2269 (véase @ref{Explicitly instantiating voices}) no resuelven el
2270 conflicto entre las notas. Es preferible a la propiedad
2271 @code{extra-offset} para este propósito porque no hay necesidad de
2272 averiguar la distancia en espacios de pentagrama, y mover las notas
2273 dentro o fuera de una @code{NoteColumn} afecta a otras acciones como a
2274 la fusión entre cabezas de nota.
2279 Finalmente, cuando todo lo demás falla, los objetos se pueden
2280 reposicionar manualmente con relación a la tercera línea del
2281 pentagrama verticalmente, o desplazándolas una cierta distancia a una
2282 nueva posición. Las desventajas son que los valores correctos para el
2283 reposicionamiento se deben adivinar, a menudo por ensayo y error, para
2284 cada objeto individual y, puesto que el movimiento se hace después de
2285 que LilyPond ha colocado todos los demás objetos es usuario es
2286 responsable de evitar cualquier colisión que pudiera producirse. Pero
2287 la dificultar principal con este enfoque es que los valores de
2288 reposicionado podrían tener que ser vueltos a calcular si la música se
2289 modifica más tarde. Las propiedades que se pueden usar para este tipo
2290 de posicionamiento manual son:
2293 @item extra-offset (desplazamiento adicional)
2294 @cindex extra-offset, propiedad
2295 Esta propiedad se aplica a cualquier objeto de presentación que
2296 contemple el @code{grob-interface}. Toma una pareja de números que
2297 especifican el desplazamiento adicional en las direcciones horizontal
2298 y vertical. Los números negativos mueven el objeto a la izquierda o
2299 hacia abajo. Las unidades son espacios de pentagrama. El
2300 desplazamiento adicional se hace después de que la composición
2301 tipográfica de los objetos ha terminado, así que un objeto puede ser
2302 reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
2304 @item positions (posiciones)
2305 @cindex positions, propiedad
2306 Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
2307 la altura de las barras de corchea, ligaduras de expresión y corchetes
2308 de grupos de valoración especial. Toma una pareja de números que dan
2309 la posición de los extremos izquierdo y derecho de la barra, ligadura,
2310 etc. con relación a la tercera línea del pentagrama. Las unidades son
2311 espacios de pentagrama. Observe, sin embargo, que las ligaduras de
2312 expresión y de fraseo no se pueden reposicionar en cantidades
2313 arbitrariamente grandes. LilyPond en primer lugar genera una lista de
2314 posiciones posibles para la ligadura y de forma predeterminada
2315 encuentra la ligadura que tiene @qq{mejor aspecto}. Si la propiedad
2316 @code{positions} se ha sobreescrito, la ligadura que está más cerca de
2317 las posiciones que se han solicitado, se selecciona de la lista.
2322 Un objeto en particular podría no tener todas estas propiedades. Es
2323 necesario ir al manual RFI para buscar qué propiedades se encuentran
2324 disponibles para el objeto en cuestión.
2327 Aquí presentamos una lista de los objetos que es más probable que
2328 estén implicados en colisiones, con el nombre del objeto que habría
2329 que buscar en el RFI para descubrir qué propiedades se deben usar para
2332 @multitable @columnfractions .5 .5
2333 @headitem Tipo de objeto @tab Nombre del objeto
2334 @item Articulaciones @tab @code{Script}
2335 @item Barras @tab @code{Beam}
2336 @item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
2337 @item Dinámica (horizontalmente) @tab @code{DynamicText}
2338 @item Digitaciones @tab @code{Fingering}
2339 @item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
2340 @item Ligaduras de expresión @tab @code{Slur}
2341 @item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
2342 @item Ligaduras de unión @tab @code{Tie}
2343 @item Grupos de valoración especial @tab @code{TupletBracket}
2347 @node Fixing overlapping notation
2348 @subsection Fixing overlapping notation
2350 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
2351 en la sección anterior, para resolver problemas de notación que se
2354 @subheading padding property
2355 @cindex relleno, propiedad
2356 @cindex padding, propiedad
2358 La propiedad @code{padding} se puede ajustar para aumentar (o
2359 disminuir) la distancia entre símbolos impresos encima o debajo de las
2362 @lilypond[quote,fragment,relative=1,verbatim]
2364 \override Script #'padding = #3
2368 @lilypond[quote,fragment,relative=1,verbatim]
2369 % This will not work, see below:
2370 \override MetronomeMark #'padding = #3
2374 \override Score.MetronomeMark #'padding = #3
2379 Observe en el segundo ejemplo la gran importancia que tiene saber qué
2380 contexto maneja un determinado objeto. Puesto que el objeto
2381 @code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
2382 cambios de propiedades en el contexto @code{Voice} pasarán
2383 inadvertidos. Para ver más detalles, consulte @ruser{Modifying
2386 Si la propiedad de relleno @code{padding} de un objeto se incrementa
2387 cuando dicho objeto se encuentra en una pila de objetos que se están
2388 colocando de acuerdo a su prioridad @code{outside-staff-priority},
2389 entonces ese objeto se moverá, y también todos los que están por fuera
2393 @subheading left-padding and right-padding
2394 @cindex left-padding, propiedad
2395 @cindex right-padding, propiedad
2397 La propiedad @code{right-padding} afecta al espaciado entre la
2398 alteración y la nota a que se aplica. Normalmente no es necesaria,
2399 pero el ejemplo siguiente muestra una situación en la que sí se
2400 necesita. Suponga que queremos presentar un acorde que contiene un Si
2401 natural y un Si bemol. Para evitar la ambigüedad querríamos preceder
2402 las notas con un becuadro y un bemol. Aquí vienen varios intentos de
2405 @lilypond[quote,verbatim,relative=2]
2411 Ninguno de ellos funciona y el segundo además presenta una fea
2412 colisión entre las dos alteraciones.
2414 Una forma de conseguirlo es sobreescribir el sello de la alteración
2415 con un elemento de marcado que contenga los símbolos de becuadro y
2416 bemol en el orden que nos gustaría que estuvieran, así:
2418 @lilypond[quote,ragged-right,verbatim]
2419 naturalplusflat = \markup { \natural \flat }
2421 \once \override Accidental
2422 #'stencil = #ly:text-interface::print
2423 \once \override Accidental #'text = #naturalplusflat
2424 \once \override Score.AccidentalPlacement #'right-padding = #1.5
2430 Esto utiliza necesariamente una sobreescritura para el sello de la
2431 alteración que no se estudiará hasta más adelante. El tipo de sello
2432 debe ser un procedimiento, aquí modificado para que imprima el
2433 contenido de la propiedad @code{text} del objeto @code{Accidental},
2434 que a su vez está establecido como un signo de becuadro seguido de un
2435 bemol. Entonces el conjunto se puede separar de la cabeza de la nota
2436 sobreescribiendo @code{right-padding}.
2440 @subheading staff-padding property
2441 @cindex staff-padding, propiedad
2443 @code{staff-padding} se puede usar para alinear objetos como matices
2444 dinámicos a lo largo de una línea de base a una altura fija sobre el
2445 pentagrama, en lugar de hacerlo a una altura que dependa de la
2446 posición de la nota a la que están adosados. No es una propiedad de
2447 @code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
2448 porque la línea de base debe aplicarse por igual a @strong{todas} las
2449 dinámicas, entre ellas las que se han creado como objetos de
2450 extensión. Así que ésta es la forma de alinear las indicaciones de
2451 matiz en el ejemplo de la sección anterior:
2453 @lilypond[quote,verbatim,relative=2]
2455 % Extend width by 1 unit
2456 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2457 % Align dynamics to a base line 2 units above staff
2458 \override DynamicLineSpanner #'staff-padding = #2
2463 @subheading self-alignment-X property
2464 @cindex self-alignment-X, propiedad
2466 El ejemplo siguiente muestra cómo esto puede resolver la colisión
2467 entre un objeto de digitación de cuerda y la plica de una nota
2468 mediante el alineamiento del límite derecho con el punto de referencia
2471 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
2474 \once \override StringNumber #'self-alignment-X = #RIGHT
2478 @subheading staff-position property
2479 @cindex staff-position, propiedad
2481 Los silencios multi-compás en una voz pueden chocar con las notas en
2482 otra voz. Puesto que estos silencios se tipografían centrados entre
2483 las barras de compás se necesitaría bastante esfuerzo para que
2484 LilyPond averiguara qué otras notas podrían chocar con él, ya que
2485 actualmente todo el manejo de colisiones entre notas y silencios se
2486 hace solamente para notas y silencios que ocurren al mismo tiempo. He
2487 aquí un ejemplo de colisión de este tipo:
2489 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2490 << {c c c c} \\ {R1} >>
2493 La mejor solución aquí es mover el silencio multi-compás hacia abajo,
2494 pues el silencio está en la voz dos. El ajuste predeterminado para
2495 @code{\voiceTwo} (es decir, en la segunda voz de una construcción
2496 @code{<<@{...@} \\ @{...@}>>}) es que @code{staff-position} tenga el
2497 valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
2498 cuatro semi-espacios de pentagrama, al valor @code{-8}.
2500 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2504 \override MultiMeasureRest #'staff-position = #-8
2509 Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
2510 la línea adicional por encima del silencio se inserta automáticamente.
2512 @subheading extra-offset property
2513 @cindex extra-offset, propiedad
2515 La propiedad @code{extra-offset} da un completo control sobre el
2516 posicionamiento de un objeto tanto vertical como horizontalmente.
2518 En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
2519 a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
2521 @lilypond[quote,fragment,relative=1,verbatim]
2524 \once \override Fingering
2525 #'extra-offset = #'(-0.3 . -1.8)
2530 @subheading positions property
2531 @cindex positions, propiedad
2533 La propiedad @code{positions} permite controlar manualmente la
2534 posición e inclinación de los tresillos, ligaduras de expresión y de
2535 fraseo, y barras de corchea. He aquí un ejemplo que tiene una fea
2536 ligadura de fraseo debido a que intenta evitar la ligadura de
2537 expresión que está sobre la acciaccatura.
2539 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2540 r4 \acciaccatura e8\( d8 c ~c d c d\)
2544 Simplemente podemos mover la ligadura de fraseo por encima de las
2545 notas, y de hecho ésta será la solución preferida:
2547 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2550 \acciaccatura e8\( d8 c ~c d c d\)
2554 pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
2555 sería mover el extremo izquierdo de la ligadura de fraseo un poco
2556 hacia abajo usando la propiedad @code{positions}. Esto también
2557 resuelve la forma algo indecente de la ligadura.
2559 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2561 \once \override PhrasingSlur #'positions = #'(-4 . -3)
2563 e8\( d8 c ~c d c d\)
2566 Presentamos un ejemplo más extraído del comienzo del pentagrama de la
2567 mano izquierda del preludio de Chopin Op 28 No. 2. vemos que la barra
2568 choca con las notas superiores:
2570 @lilypond[quote,verbatim,fragment,ragged-right]
2573 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2574 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2579 Esto se puede resolver manualmente elevando los dos extremos de la
2580 barra desde su posición a dos espacios de pentagrama sobre la línea
2581 central hasta, digamos, 3 espacios:
2583 @lilypond[quote,verbatim,fragment,ragged-right]
2587 \override Beam #'positions = #'(3 . 3)
2592 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2597 Observe que la sobreescritura sigue aplicándose en la primera voz del
2598 segundo bloque de corcheas, pero no a ninguna de las barras de la
2601 @subheading force-hshift property
2602 @cindex force-hshift, propiedad
2603 @c FIXME: formatting stuff (ie not important right now IMO)
2604 @c @a nchor Chopin finally corrected TODOgp
2606 Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
2607 Chopin que presentamos al final de @ref{I'm hearing Voices}, que
2608 dejamos con este aspecto:
2610 @lilypond[quote,verbatim,fragment,ragged-right]
2611 \new Staff \relative c'' {
2614 { c2 aes4. bes8 } \\
2626 Las dos notas inferiores del primer acorde (es decir, las que están en
2627 al tercera voz) no deberían separarse de la columna de notas de las dos
2628 notas agudas. Para corregir esto, establecemos el valor de
2629 @code{force-hshift} (que es una propiedad de @code{NoteColumn}) de
2630 esas notas a cero. La nota más grave del segundo acorde se sitúa
2631 mejor justo a la derecha de las más agudas. Lo conseguimos
2632 estableciendo el valor de @code{force-hshift} de esta nota a 0.5, o
2633 sea, la anchura de media cabeza de nota a la derecha de la columna de
2636 Presentamos a continuación el resultado final:
2638 @lilypond[quote,verbatim,fragment,ragged-right]
2639 \new Staff \relative c'' {
2642 { c2 aes4. bes8 } \\
2645 \once \override NoteColumn #'force-hshift = #0 <ees c>2
2646 \once \override NoteColumn #'force-hshift = #0.5 des2
2654 @node Real music example
2655 @subsection Real music example
2657 Finalizaremos esta sección sobre los trucos mostrando los pasos que se
2658 deben tomar para tratar con un ejemplo complicado que necesita varios
2659 trucos para producir el resultado deseado. El ejemplo se ha escogido
2660 deliberadamente para ilustrar el uso de la Referencia de la Notación
2661 para resolver problemas de notación poco comunes. No es
2662 representativo de un proceso de grabado más usual, por lo que ¡le
2663 recomendamos que no deje que estas dificultades le desanimen!
2664 ¡Afortunadamente, las dificultades como éstas no son muy comunes!
2666 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
2667 compases 6 al 9, la transición entre el Lento inicial y el Moderato.
2668 Presentamos en primer lugar el aspecto que queremos que tenga el
2669 resultado, pero para evitar complicar demasiado el ejemplo hemos
2670 quitado las indicaciones dinámicas, las digitaciones y el pedal.
2672 @c The following should appear as music without code
2673 @lilypond[quote,ragged-right]
2674 rhMusic = \relative c'' {
2677 \once \override Tie #'staff-position = #3.5
2681 \mergeDifferentlyHeadedOn
2682 \mergeDifferentlyDottedOn
2683 bes2.^\markup {\bold "Moderato"} r8
2685 {c,8[ d fis bes a] | }
2687 % Reposition the c2 to the right of the merged note
2688 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
2689 % Move the c2 out of the main note column so the merge will work
2692 % Stem on the d2 must be down to permit merging
2693 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
2697 \mergeDifferentlyHeadedOff
2698 \mergeDifferentlyDottedOff
2702 lhMusic = \relative c' {
2704 <d g, d>1)\arpeggio |
2711 \new Staff = "RH" <<
2715 \new Staff = "LH" <<
2724 Observamos en primer lugar que la parte de la mano derecha del tercer
2725 compás requiere cuatro voces. Son las cinco corcheas unidas por una
2726 barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
2727 y el Fa sostenido negra con puntillo, que también está fundida con la
2728 corchea de su misma altura. Todo lo demás está en una sola voz, así
2729 que lo más fácil es introducir estas cuatro voces temporalmente en el
2730 momento en que se necesiten. Si ha olvidado cómo hacerlo, lea
2731 @ref{I'm hearing Voices}. Vamos a comenzar introduciendo las notas
2732 como dos variables y disponiendo la estructura de pentagramas en un
2733 bloque score, y veremos qué produce LilyPond de forma predeterminada:
2735 @lilypond[quote,verbatim,ragged-right]
2736 rhMusic = \relative c'' {
2741 % Start polyphonic section of four voices
2743 {c,8 d fis bes a | }
2754 lhMusic = \relative c' {
2763 \new Staff = "RH" <<
2767 \new Staff = "LH" <<
2776 Todas las notas son correctas, pero el aspecto está lejos de ser
2777 satisfactorio. La ligadura de unión choca con el cambio de compás, el
2778 barrado del tercer compás es incorrecto, las notas no se funden
2779 correctamente, y faltan algunos elementos de notación. En primer
2780 lugar trataremos con lo más fácil. Podemos corregir el barrado de las
2781 corcheas insertando una barra manualmente, y podemos añadir fácilmente
2782 la ligadura de expresión de la mano izquierda y la ligadura de fraseo
2783 de la mano derecha, pues todo ello se estudió en el Tutorial. Al
2784 hacerlo así obtenemos:
2786 @lilypond[quote,verbatim,ragged-right]
2787 rhMusic = \relative c'' {
2792 % Start polyphonic section of four voices
2794 {c,8[ d fis bes a] | }
2805 lhMusic = \relative c' {
2814 \new Staff = "RH" <<
2818 \new Staff = "LH" <<
2827 El primer compás ahora es correcto. El segundo compás contiene un
2828 arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
2829 sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
2830 que volver e la Referencia de la Notación. Buscando la palabra
2831 @q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
2832 que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
2833 doble barra se produce por medio de la instrucción @code{\bar "||"}.
2834 Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
2835 la colisión entre la ligadura de unión y la indicación de compás.
2836 Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
2837 mover objetos anteriormente en @ref{Moving objects}, donde dice que
2838 los objetos que están situados de forma relativa al pentagrama se
2839 pueden mover sobreescribiendo su propiedad @code{staff-position}, que
2840 se especifica en unidades de medio espacio de pentagrama respecto de
2841 la línea central del pentagrama. Así pues, la sobreescritura
2842 siguiente colocada justo antes de la primera nota ligada subirá la
2843 ligadura 3.5 medios espacios de pentagrama por encima de la línea
2846 @code{\once \override Tie #'staff-position = #3.5}
2848 Con esto se completa el compás dos, dando como resultado:
2850 @lilypond[quote,verbatim,ragged-right]
2851 rhMusic = \relative c'' {
2853 \once \override Tie #'staff-position = #3.5
2858 % Start polyphonic section of four voices
2860 {c,8[ d fis bes a] | }
2871 lhMusic = \relative c' {
2873 <d g, d>1)\arpeggio |
2880 \new Staff = "RH" <<
2884 \new Staff = "LH" <<
2893 Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
2894 tutorial nos enseñó cómo escribir texto en negrita mediante la
2895 instrucción @code{\markup}, por lo que añadir @q{Moderato} en negrita
2896 es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
2897 voces? Aquí es donde debemos volver a buscar ayuda en el manual de
2898 Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
2899 el índice de la Referencia de la notación llegamos rápidamente a las
2900 instrucciones para mezclar notas con distinta cabeza y con o sin
2901 puntillo, en @ruser{Collision resolution}. En nuestro ejemplo tenemos
2902 que fusionar ambos tipos de nota en el transcurso de la sección
2903 polifónica del compás 3; por tanto, en virtud de la información que
2904 aparece en la Referencia de la Notación, escribimos
2907 \mergeDifferentlyHeadedOn
2908 \mergeDifferentlyDottedOn
2912 al principio de la sección, y
2915 \mergeDifferentlyHeadedOff
2916 \mergeDifferentlyDottedOff
2920 al final, dando como resultado:
2922 @lilypond[quote,verbatim,ragged-right]
2923 rhMusic = \relative c'' {
2925 \once \override Tie #'staff-position = #3.5
2929 bes2.^\markup {\bold "Moderato"} r8
2930 \mergeDifferentlyHeadedOn
2931 \mergeDifferentlyDottedOn
2932 % Start polyphonic section of four voices
2934 {c,8[ d fis bes a] | }
2942 \mergeDifferentlyHeadedOff
2943 \mergeDifferentlyDottedOff
2947 lhMusic = \relative c' {
2949 <d g, d>1)\arpeggio |
2956 \new Staff = "RH" <<
2960 \new Staff = "LH" <<
2969 Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
2970 dos Re. ¿Por qué no? La respuesta está en la misma sección de la
2971 Referencia de la Notación: las notas que se fusionan deben tener las
2972 plicas en direcciones opuestas y dos notas no se pueden fusionar bien
2973 si hay una tercera nota en la misma columna. Aquí los dos Re tienen
2974 las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
2975 cambiar la dirección de la plica usando @code{\stemDown}, y la
2976 Referencia de la Notación también explica cómo mover el Do: aplicar un
2977 desplazamiento usando una de las instrucciones @code{\shift}. Pero
2978 ¿cuál? El Do está en la voz dos que tiene desactivado el
2979 desplazamiento, y los dos Re están en las voces uno y tres, que tienen
2980 el desplazamiento desactivado y activado, respectivamente. Por ello
2981 tenemos que desplazar el Do un nivel más todavía, usando
2982 @code{\shiftOnn} para evitar que interfiera con los dos Re. Al
2983 aplicar estos cambios obtenemos:
2985 @lilypond[quote,verbatim,ragged-right]
2986 rhMusic = \relative c'' {
2988 \once \override Tie #'staff-position = #3.5
2992 bes2.^\markup {\bold "Moderato"} r8
2993 \mergeDifferentlyHeadedOn
2994 \mergeDifferentlyDottedOn
2995 % Start polyphonic section of four voices
2997 {c,8[ d fis bes a] | }
2999 % Move the c2 out of the main note column so the merge will work
3000 {c,8~ \shiftOnn c2 | }
3002 % Stem on the d2 must be down to permit merging
3003 {s8 \stemDown d2 | }
3007 \mergeDifferentlyHeadedOff
3008 \mergeDifferentlyDottedOff
3012 lhMusic = \relative c' {
3014 <d g, d>1)\arpeggio |
3021 \new Staff = "RH" <<
3025 \new Staff = "LH" <<
3034 Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
3035 sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
3036 colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
3037 partir de trucos anteriores: hacemos la plica transparente, y movemos
3038 el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
3041 @lilypond[quote,verbatim,ragged-right]
3042 rhMusic = \relative c'' {
3045 \once \override Tie #'staff-position = #3.5
3049 bes2.^\markup {\bold "Moderato"} r8
3050 \mergeDifferentlyHeadedOn
3051 \mergeDifferentlyDottedOn
3053 {c,8[ d fis bes a] | }
3055 % Reposition the c2 to the right of the merged note
3056 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3057 % Move the c2 out of the main note column so the merge will work
3060 % Stem on the d2 must be down to permit merging
3061 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3065 \mergeDifferentlyHeadedOff
3066 \mergeDifferentlyDottedOff
3070 lhMusic = \relative c' {
3072 <d g, d>1)\arpeggio |
3079 \new Staff = "RH" <<
3083 \new Staff = "LH" <<
3093 @node Further tweaking
3094 @section Further tweaking
3097 * Other uses for tweaks::
3098 * Using variables for tweaks::
3099 * Other sources of information::
3100 * Avoiding tweaks with slower processing::
3101 * Advanced tweaks with Scheme::
3104 @node Other uses for tweaks
3105 @subsection Other uses for tweaks
3107 @cindex transparent, uso de la propiedad
3108 @cindex objetos, hace invisibles
3109 @cindex eliminar objetos
3110 @cindex objetos, eliminar
3111 @cindex ocultar objetos
3112 @cindex invisibles, objetos
3113 @cindex ligar notas entre voces distintas
3115 @subheading Tying notes across voices
3117 El ejemplo siguiente muestra cómo conectar notas que están en
3118 distintas voces utilizando ligaduras de unión. Normalmente sólo se
3119 pueden conectar mediante ligaduras de unión dos notas que estén en la
3120 misma voz. Usando dos voces, con las notas ligadas en una de ellas:
3122 @lilypond[quote,fragment,relative=2]
3123 << { b8~ b8\noBeam }
3129 y borrando la primera plica hacia arriba en esa voz, da la impresión
3130 de que la ligadura se cruza entre las voces:
3132 @lilypond[quote,fragment,relative=2,verbatim]
3135 \once \override Stem #'transparent = ##t
3143 Para estar seguros de que la plica que acabamos de borrar no aprieta
3144 demasiado a la ligadura, podemos alargar la plica estableciendo su
3145 valor de longitud @code{length} a @code{8},
3147 @lilypond[quote,fragment,relative=2,verbatim]
3150 \once \override Stem #'transparent = ##t
3151 \once \override Stem #'length = #8
3159 @subheading Simulating a fermata in MIDI
3161 @cindex sello, uso de la propiedad
3162 @cindex fermata, realización en MIDI
3164 Para los objetos fuera-del-pentagrama, normalmente es mejor
3165 sobreescribir la propiedad @code{stencil} («sello») del objeto que su
3166 propiedad @code{transparent} cuando desee quitarlos de la salida
3167 impresa. Mediante el establecimiento de la propiedad @code{stencil}
3168 de un objeto al valor @code{#f} podemos quitar el objeto por completo
3169 de la salida impresa. Esto significa que no tiene efecto sobre la
3170 colocación de otros objetos que pudieran colocarse en relación a él.
3172 Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
3173 propósito de simular un calderón en la salida MIDI, seguramente no
3174 querríamos que la indicación metronómica apareciese en la salida
3175 impresa, y no querríamos influir sobre la separación entre los dos
3176 sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
3177 pentagrama. Por lo tanto, establecer su propiedad @code{stencil} al
3178 valor @code{#f} sería la mejor manera. Mostramos aquí el efecto de
3181 @lilypond[quote,verbatim,ragged-right]
3184 % Visible tempo marking
3187 \once \override Score.MetronomeMark #'transparent = ##t
3188 % Invisible tempo marking to lengthen fermata in MIDI
3191 % New tempo for next section
3200 @lilypond[quote,verbatim,ragged-right]
3203 % Visible tempo marking
3206 \once \override Score.MetronomeMark #'stencil = ##f
3207 % Invisible tempo marking to lengthen fermata in MIDI
3210 % New tempo for next section
3220 Ambos métodos quitan de la salida impresa la indicación metronómica
3221 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
3222 queríamos, pero la indicación metronómica transparente de la primera
3223 línea fuerza una colocación muy alta de la indicación de tempo que
3224 sigue, meintras que la segunda (con el sello suprimido) no lo hace.
3226 @node Using variables for tweaks
3227 @subsection Using variables for tweaks
3229 Las instrucciones de sobreescritura son con frecuencia largas y
3230 tediosas de escribir, y se tienen que escribir de forma absolutamente
3231 correcta. Si las mismas sobreescrituras se van a utilizar muchas
3232 veces, podría merecer la pena definir variables para guardarlas.
3233 Suponga que queremos realzar ciertas palabras de la letra de una
3234 canción imprimiéndolas en cursiva y negrita. Las instrucciones
3235 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
3236 canciones si están incluidas dentro de un @code{\markup}, lo que las
3237 hace tediosas de escribir. ¿Podríamos, como alternativa, utilizar las
3238 instrucciones @code{\override} y @code{\revert}?
3241 @code{\override Lyrics . LyricText #'font-shape = #'italic}
3242 @code{\override Lyrics . LyricText #'font-series = #'bold}
3244 @code{\revert Lyrics . LyricText #'font-shape}
3245 @code{\revert Lyrics . LyricText #'font-series}
3248 Estas instrucciones también serían extremadamente tediosas de escribir
3249 si hubiera muchas palabras que quisiéramos subrayar. Entonces, en vez
3250 de esto las definimos como dos variables, y las usamos de la siguiente
3251 forma, aunque normalmente quizá elegiríamos unos nombres de variable
3252 más cortos para que fueran más rápidos de teclear:
3254 @lilypond[quote,verbatim]
3256 \override Lyrics . LyricText #'font-shape = #'italic
3257 \override Lyrics . LyricText #'font-series = #'bold
3260 \revert Lyrics . LyricText #'font-shape
3261 \revert Lyrics . LyricText #'font-series
3264 global = { \time 4/4 \partial 4 \key c \major}
3265 SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
3266 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f f e }
3267 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
3268 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
3269 VerseOne = \lyrics { E -- | ter -- nal \emphasize Fa -- ther, \normal | strong to save, }
3270 VerseTwo = \lyricmode { O | \emphasize Christ, \normal whose voice the | wa -- ters heard, }
3271 VerseThree = \lyricmode { O | \emphasize Ho -- ly Spi -- rit, \normal | who didst brood }
3272 VerseFour = \lyricmode { O | \emphasize Tri -- ni -- ty \normal of | love and pow'r }
3278 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
3279 \new Voice = "Alto" { \voiceTwo \AltoMusic }
3280 \new Lyrics \lyricsto "Soprano" { \VerseOne }
3281 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
3282 \new Lyrics \lyricsto "Soprano" { \VerseThree }
3283 \new Lyrics \lyricsto "Soprano" { \VerseFour }
3287 \new Voice = "Tenor" { \voiceOne \TenorMusic }
3288 \new Voice = "Bass" { \voiceTwo \BassMusic }
3295 @node Other sources of information
3296 @subsection Other sources of information
3298 La documentación del manual de Referencia de Funcionamiento Interno
3299 contiene montañas de información sobre LilyPond, pero se puede obtener
3300 más información aún leyendo los archivos internos de LilyPond. Para
3301 echarles un vistazo, en primer lugar debe buscar la carpeta
3302 correspondiente a su sistema. La ubicación de esta carpeta depende
3303 (a) de si consiguió el programa LilyPond descargando un binario
3304 precompilado desde el sitio web lilypond.org o si lo instaló mediante
3305 un gestor de paquetes (es decir, distribuido con Linux, o instalado
3306 bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
3307 qué sistema operativo está utilizando:
3310 @strong{Descargado de lilypond.org}
3316 @file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/share/lilypond/current/}
3321 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/Resources/share/lilypond/current/}
3322 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
3323 bien manteniendo pulsada la tecla de Control y haciendo click sobre la
3324 aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
3329 Mediante el Explorador de Windows, diríjase a
3330 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/share/lilypond/current/}
3334 @strong{Instalado mediante un gestor de paquetes o compilado a partir de la fuente}
3337 @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
3338 se encuentra determinado por su administrador de paquetes o guión
3339 @code{configure}, y @var{X.Y.Z} es el número de la versión de
3344 Dentro de esta carpeta, las dos subcarpetas interesantes son
3347 @item @file{ly/} - contiene archivos en formato LilyPond
3348 @item @file{scm/} - contiene archivos en formato Scheme
3351 Vamos a comenzar observando algunos archivos que están en @file{ly/}.
3352 Abra @file{ly/property-init.ly} con un editor de textos. El mismo que
3353 usaría normalmente para los archivos @code{.ly} servirá perfectamente.
3354 Este archivo contiene las definiciones de todas las instrucciones
3355 incorporadas como estándar dentro de LilyPond, como por ejemplo
3356 @code{\stemUp} y @code{\slurDotted}. Podrá ver que no son nada más
3357 que definiciones de variables que contienen una o varias instrucciones
3358 @code{\override}. Por ejemplo, @code{/tieDotted} está definido de tal
3359 forma que su valor es:
3363 \override Tie #'dash-period = #0.75
3364 \override Tie #'dash-fraction = #0.1
3368 Si no le gustan los valores predeterminados, estas instrucciones
3369 incorporadas se pueden redefinir con facilidad como cualquier otra
3370 variable, al principio de su archivo de código de entrada.
3372 Los siguientes son los archivos más útiles que se encuentran en
3375 @multitable @columnfractions .4 .6
3378 @item @file{ly/engraver-init.ly}
3379 @tab Definiciones de Contextos de grabadores
3380 @item @file{ly/paper-defaults.ly}
3381 @tab especificaciones de valores predeterminados relacionados con el papel
3382 @item @file{ly/performer-init.ly}
3383 @tab Definiciones de Contextos de interpretación
3384 @item @file{ly/property-init.ly}
3385 @tab Definiciones de todas las instrucciones incorporadas que son comunes
3388 Otros ajustes (como las definiciones de las instrucciones de marcado)
3389 se almacenan como archivos @code{.scm} (de Scheme). El lenguaje de
3390 programación Scheme se utiliza para proporcionar un interfaz
3391 programable en el funcionamiento interno de LilyPond. Cualquier
3392 explicación adicional sobre estos archivos se encuentra por el momento
3393 fuera del ámbito de este manual, porque se requieren conocimientos del
3394 lenguaje Scheme. Se advierte a los usuarios que se necesita una
3395 importante cantidad de conocimientos técnicos o de tiempo para
3396 comprender el lenguaje Scheme y estos archivos (véase @ref{Scheme
3399 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
3402 @multitable @columnfractions .4 .6
3405 @item @file{scm/auto-beam.scm}
3406 @tab Valores predeterminados de sub-barrado
3407 @item @file{scm/define-grobs.scm}
3408 @tab valores predeterminados de las propiedades de grobs
3409 @item @file{scm/define-markup-commands.scm}
3410 @tab Especificar todas las instrucciones de marcado
3411 @item @file{scm/midi.scm}
3412 @tab Ajustes predeterminados para la salida MIDI
3413 @item @file{scm/output-lib.scm}
3414 @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
3415 @item @file{scm/parser-clef.scm}
3416 @tab Definiciones de las claves contempladas
3417 @item @file{scm/script.scm}
3418 @tab Ajustes predeterminados para las articulaciones
3423 @node Avoiding tweaks with slower processing
3424 @subsection Avoiding tweaks with slower processing
3426 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
3427 procesa los archivos. Estas instrucciones consumen tiempo, pero el
3428 resultado puede necesitar menos trucos manuales para obtener un
3429 resultado aceptable. Si una inscripción de texto o parte de la letra
3430 se sale de los márgenes, estas comprobaciones comprimirán dicha línea
3431 en la medida justa como para que encaje dentro de los márgenes.
3433 Para que sean efectivos bajo cualquier circunstancia, estas
3434 comprobaciones deben habilitarse colocando las instrucciones de
3435 sobreescritura dentro del bloque @code{\with} dentro de un Score, y no
3436 en línea con la música, de la forma siguiente:
3441 % asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
3442 \override PaperColumn #'keep-inside-line = ##t
3443 \override NonMusicalPaperColumn #'keep-inside-line = ##t
3449 @node Advanced tweaks with Scheme
3450 @subsection Advanced tweaks with Scheme
3452 Aunque es posible hacer muchas cosas con las instrucciones
3453 @code{\override} y @code{\tweak} , tenemos una forma incluso más
3454 poderosa de modificar el funcionamiento de LilyPond, a través de un
3455 interface programable hacia las operaciones internas de LilyPond. Se
3456 puede incorporar código escrito en el lenguaje de programación Scheme,
3457 directamente en el mecanismo de funcionamiento de LilyPond. Por
3458 supuesto, para hacer esto se necesitan al menos unos conocimientos
3459 básicos de programación en Scheme, y damos una introducción en el
3460 @ref{Scheme tutorial}.
3462 Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
3463 dar a una propiedad un valor constante, se puede establecer al
3464 resultado de un procedimiento de Scheme que se invoca cada vez que
3465 LilyPond accede a esta propiedad. La propiedad se puede establecer
3466 dinámicamente a un valor determinado por el procedimiento en el
3467 momento en que se invoca. En este ejemplo damos a las cabezas de las
3468 notas un color que depende de su posición dentro del pentagrama.
3470 @lilypond[quote,verbatim,ragged-right]
3471 #(define (color-notehead grob)
3472 "Color the notehead according to its position on the staff."
3473 (let ((mod-position (modulo (ly:grob-property grob 'staff-position) 7)))
3475 ;; Return rainbow colors
3476 ((1) (x11-color 'red )) ; for C
3477 ((2) (x11-color 'orange )) ; for D
3478 ((3) (x11-color 'yellow )) ; for E
3479 ((4) (x11-color 'green )) ; for F
3480 ((5) (x11-color 'blue )) ; for G
3481 ((6) (x11-color 'purple )) ; for A
3482 ((0) (x11-color 'violet )) ; for B
3488 % Arrange to obtain color from color-notehead procedure
3489 \override NoteHead #'color = #color-notehead
3496 Some -- where o -- ver the Rain -- bow way up high,
3500 Se pueden encontrar ejemplos adicionales que muestran la utilización
3501 de estos interfaces programables, en @ref{Tweaking with Scheme}.