1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 2f036270de7077d87ffc4b204e7a0618f59e86f6
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
11 @chapter Tweaking output
13 Este capítulo trata de cómo modificar la salida. LilyPond es extremadamente
14 configurable; prácticamente todos los fragmentos de la salida se pueden cambiar.
19 * The Internals Reference manual::
20 * Appearance of objects::
22 * Fixing overlapping notation::
25 * Fitting music onto fewer pages::
26 * Avoiding tweaks with slower processing::
27 * Advanced tweaks with Scheme::
31 @section Tweaking basics
34 * Introduction to tweaks::
35 * Objects and interfaces::
36 * Naming conventions of objects and properties::
40 @node Introduction to tweaks
41 @subsection Introduction to tweaks
43 El @q{Trucaje} es un término de LilyPond que denota los diversos
44 métodos que el usuario tiene a su disposición para modificar el
45 proceso de interpretación del archivo de entrada y cambiar la
46 apariencia de la salida impresa. Algunos trucos son muy fáciles de
47 usar; otros son más complejos. Pero en su conjunto, los métodos de
48 trucaje disponibles posibilitan conseguir casi cualquier apariencia
49 que deseemos en la música impresa.
51 En esta sección vamos a estudiar los conceptos básicos que se
52 necesitan para comprender el trucaje. Más tarde daremos un amplio
53 abanico de instrucciones listas para usar, que podrá simplemente
54 copiar para obtener el mismo efecto en sus partituras, y al mismo
55 tiempo mostraremos la forma de construir dichas instrucciones para que
56 pueda aprender cómo desarrollar sus propios trucos.
58 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
59 la sección @ref{Contexts and engravers}, pues los Contextos, los
60 Grabadores y las Propiedades que se contienen en ellos son
61 fundamentales para comprender y construir los trucos.
63 @node Objects and interfaces
64 @subsection Objects and interfaces
71 El trucaje consiste en modificar el funcionamiento y estructura
72 interna del programa LilyPond, por lo que en primer lugar
73 introduciremos algunos términos que se usan para describir dichas
74 operaciones y estructuras internas.
76 El término @q{Objeto} es un término genérico que se usa para referirse
77 a la multitud de estructuras internas que LilyPond construye durante
78 el procesado de un archivo de entrada. Así, cuando se encuentra una
79 instrucción como @code{\new Staff}, se construye un objeto nuevo del
80 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
81 las propiedades asociadas con ese pentagrama en particular, por
82 ejemplo, su nombre y su armadura, además de otros detalles de los
83 grabadores que se han asignado para que operen dentro del contexto del
84 pentagrama. De forma similar, hay objetos que guardan las propieades
85 de todos los demás contextos, como objetos de @code{Voice}, objetos de
86 @code{Score}, objetos de @code{Lyrics}, así como objetos que
87 representan todos los elementos notacionales como líneas divisorias,
88 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
89 objeto tiene su propio conjunto de valores de propiedad.
91 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
92 representan elementos de notación sobre la salida impresa como cabezas
93 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
94 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
95 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
96 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
97 mencionado, y también todos ellos tienen propiedades asociadas, como
98 su posición, tamaño, color,etc.
100 Ciertos objetos de presentación son aún más especializados. Las
101 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
102 y baja, y muchos otros objetos gráficos no están situados en un solo
103 lugar: tienen un punto de inicio, un punto de final, y quizá otras
104 propiedades relacionadas con su forma. Los objetos con una forma
105 extendida como estos, reciben el nombre de «Objetos de extensión» o
108 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
109 incluso aunque son bastante diferentes, comparten funcionalidades que
110 se deben procesar de la misma manera. Por ejemplo, todos los objetos
111 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
112 propiedades se procesan de la misma forma durante la interpretación
113 del archivo de entrada por parte de LilyPond. Para simplificar estas
114 operaciones internas, estas acciones t propiedades comunes se agrupan
115 en un objeto llamado @code{grob-interface}, interface de grob. Hay
116 muchas otras agrupaciones de propiedades comunes como ésta, y cada
117 unoa recibe un nombre que acaba en @code{interface}. En total hay más
118 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
119 interés y de utilidad para el usuario.
121 Estos son, en fin, los términos principales relativos a los objetos
122 que vamos a utilizar en este capítulo.
124 @node Naming conventions of objects and properties
125 @subsection Naming conventions of objects and properties
127 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
128 sección @ref{Contexts and engravers}. En este lugar, para más fácil
129 referencia, presentamos una lista de los tipos de objetos y
130 propiedades más comunes, junto con las convenciones según las cuales
131 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
132 utilizado una «A» mayúscula para denotar cualquier carácter alfabético
133 en mayúsculas, y «aaa» para cualquier número de caracteres alfabéticos
134 en minúscula. Otros caracteres se utilizan literalmente como están.
136 @multitable @columnfractions .33 .33 .33
137 @headitem Objeto o tipo de propiedad
138 @tab Convención de nomenclatura
141 @tab Aaaa o AaaaAaaaAaaa
142 @tab Staff, GrandStaff
143 @item Objetos de presentación
144 @tab Aaaa o AaaaAaaaAaaa
147 @tab Aaaa_aaa_engraver
148 @tab Clef_engraver, Note_heads_engraver
150 @tab aaa-aaa-interface
151 @tab grob-interface, break-aligned-interface
152 @item Propiedades de contextos
153 @tab aaa o aaaAaaaAaaa
154 @tab alignAboveContext, skipBars
155 @item Propiedades de objetos de presentación
156 @tab aaa o aaa-aaa-aaa
157 @tab direction, beam-thickness
160 Como podremos ver en breve, las propiedades de distintos tipos de
161 objeto se modifican por parte de diferentes instrucciones; así pues,
162 es útil poder reconocer el tipo de objeto a partir de sus nombres de
165 @node Tweaking methods
166 @subsection Tweaking methods
168 @strong{La instrucción \override}
170 @cindex override, instrucción
173 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
174 usan para cambiar las propiedades de los @strong{contextos} y para
175 quitar y poner @strong{grabadores}, en @ref{Modifying context
176 properties} y @ref{Adding and removing engravers}. Ahora debemos
177 examinar algunas instrucciones importantes más.
179 La instrucción que cambia las propiedades de los @strong{objetos de
180 presentación} es @code{\override}. Puesto que esta instrucción debe
181 modificar propiedades internas que se encuentran en un lugar profundo
182 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
183 las instrucciones que hemos visto hasta ahora. Tiene que saber
184 exactamente qué propiedad de qué objeto y en qué contexto se debe
185 modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
187 La sintaxis genérica de esta instrucción es:
190 \override @emph{contexto}.@emph{objeto_de_presentación}
191 #'@emph{propiedad_de_presentación} = #@emph{valor}
195 Esto establecerá la propiedad de nombre
196 @emph{propiedad_de_presentación} del objeto de presentación con el
197 nombre @emph{objeto_de_presentación}, que es miembro del contexto
198 @emph{contexto}, al valor @emph{valor}.
200 El @emph{contexto} se puede omitir (y normalmente así es) cuando el
201 contexto requerido se encuentra implicado sin ambigüedad y es uno de
202 los contextos del nivel más bajo, es decir: @code{Voice},
203 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
204 ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
206 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
207 valores, pero para ilustrar el formato y utilización de estas
208 iinstrucciones usaremos sólo unas cuantas propiedades y valores
209 sencillos que sean fáciles de entender.
211 Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
212 propiedad de presentación, y el @code{#}, que debe preceder al valor.
213 Deben estar presentes siempre y de esa forma exacta. Es la
214 instrucción de uso más común dentro del trucaje, y durante la mayor
215 parte del resto de este capítulo presentaremos ejemplos de cómo se
216 usa. A continuación hay un ejemplo sencillo para cambiar el color de
219 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
221 \override NoteHead #'color = #red
223 \override NoteHead #'color = #green
227 @strong{La instrucción \revert}
229 @cindex revert, instrucción
232 Una vez sobreescrita, la proopiedad retiene su nuevo valor hasta que
233 se sobreescribe de nuevo o se encuentra una instrucción
234 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
235 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
236 valor predeterminado original; observe que no es a su valor previo si
237 se han utilizado varias instrucciones @code{\override}.
240 \revert @emph{contexto}.@emph{objeto_de_presentación} #'@emph{propiedad_de_presentación}
243 Una vez más, igual que @emph{contexto} dentro de la instrucción
244 @code{\override}, con frecuencia no es necesario especificar el
245 @emph{contexto}. Se omitirá en muchos de los ejemplos siguientes.
246 Aquí devolvemos el color de la cabeza al valor predeterminado para las
249 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
251 \override NoteHead #'color = #red
253 \override NoteHead #'color = #green
255 \revert NoteHead #'color
259 @strong{El prefijo \once}
261 Tanto la instrucción @code{\override} como @code{\set} se pueden
262 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
263 @code{\override} o @code{\set} sea efectiva solamente durante el
264 tiempo musical en curso y antes de que la propiedad vuelva a tener
265 otra vez su valor predeterminado. Utilizando el mismo ejemplo,
266 podemos cambiar el color de una sola nota de la siguiente manera:
268 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
270 \once \override NoteHead #'color = #red
272 \once \override NoteHead #'color = #green
276 @strong{La instrucción \overrideProperty}
278 @cindex overrideProperty, instrucción
279 @funindex \overrideProperty
281 Hay otra forma para la instrucción de sobreescritura,
282 @code{\overrideProperty}, que ocasionalmente es necesaria. La
283 mencionamos aquí con un propósito de exhaustividad, pero para ver más
284 detalles consulte @ruser{Difficult tweaks}.
285 @c Maybe explain in a later iteration -td
287 @strong{La instrucción \tweak}
289 @cindex tweak, instrucción
292 La última instrucción de trucaje que está disponible es @code{\tweak}.
293 Se debe utilizar para cambiar las propiedades de objetos que suceden
294 en el mismo momento musical, como las notas de un acorde. El uso de
295 @code{\override} para la sobreescritura afectaría a todas las notas
296 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
297 elemento del flujo de entrada.
299 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la nota
300 intermedia (el Mi) en un acorde de Do mayor. En primer lugar, veamos
301 lo que haría @code{\once \override}:
303 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
305 \once \override NoteHead #'font-size = #-3
310 Vemos que la sobreescritura con override afecta a @emph{todas} las
311 notas del acorde. Esto es así porque todas las notas de un acorde
312 ocurren en el mismo @emph{momento musical}, y la acción de
313 @code{\once} es aplicar la sobreescritura a todos los oobjetos de
314 presentación del tipo especificado que ocurren en el mismo momento
315 musical que la propia instrucción de sobreescritura @code{\override}.
317 LA instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
318 el elemento inmediatamente siguiente dentro del flujjo de entrada.
319 Sin embargo, es efectivo solamente sobre objetos que se crean
320 directamente a partir del flujo de entrada, en esencia las cabezas y
321 las articulaciones (los objetos como las plicas y las alteraciones se
322 crean con posterioridad y no se pueden trucar de esta forma). Es más,
323 cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
324 dentro de un acorde, es decir, dentro de ángulos simples, así que para
325 trucar una sola nota la instrucción @code{\tweak} se debe colocar
326 dentro de ángulos simples junto con la nota.
328 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
329 se cambiaría de la siguiente forma:
331 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
333 <c \tweak #'font-size #-3 e g>4
336 Observe que la sintaxis de @code{\tweak} es diferente de la de la
337 instrucción @code{\override}. Ni el contexto ni el objeto de
338 presentación se deben especificar; de hecho, generaría un error
339 hacerlo. Los dos están implícitos por el siguiente elemento del flujo
340 de entrada. Así que la sintaxis genérica de la instrucción
341 @code{\tweak} es, simmplemente:
344 \tweak #'@emph{propiedad_de_presentación} = #@emph{valor}
347 Una instrucción @code{\tweak} también se puede usar para modificar
348 sólo una de una serie de articulaciones, como se muestra aquí:
350 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
352 -\tweak #'color #red ^Red
353 -\tweak #'color #green _Green
356 Observe que la instrucción @code{\tweak} debe venir precedida de una
357 marca de articulación como si ella misma fuera una articulación.
359 @cindex grupos especiales anidados
360 @cindex tresillos anidados
361 @cindex corchete del grupo especial
362 @cindex grupo especial, corchete de
363 @cindex tresillo, corchete de
364 @funindex TupletBracket
366 La instrucción @code{\tweak} también se debe usar para cambiar la
367 apariencia de uno solo de un conjunto de grupos especiales anidados
368 que comiencen en el mismo instante musical. En el siguiente ejemplo,
369 el corchete del tresillo largo y el primero de los tres corchetes
370 cortos empiezan en el mismo momento musical, y por ello cualquier
371 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
372 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
373 @code{\tweak} especifica que el corchete del tresillo largo se debe
374 colocar por encima de las notas y el segundo especifica que el número
375 del tresillo se debe imprimir en rojo sobre el corchete del primer
378 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
379 \tweak #'direction #up
382 \times 2/3 { c8[ c8 c8] }
383 \times 2/3 { c8[ c8 c8] }
384 \times 2/3 { c8[ c8 c8] }
388 Encontrará más detalles de la instrucción @code{\tweak} en
389 @ruser{Objects connected to the input}.
391 Si los grupos anidados no comienzan en el mismo momento, su apariencia
392 se puede modificar de la forma usual mediante instrucciones
395 @c NOTE Tuplet brackets collide if notes are high on staff
397 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
398 \times 2/3 { c8[ c c]}
399 \once \override TupletNumber
400 #'text = #tuplet-number::calc-fraction-text
404 \once \override TupletNumber #'transparent = ##t
405 \times 2/3 { c8[ c c] }
406 \times 2/3 { c8[ c c]}
410 @node The Internals Reference manual
411 @section The Internals Reference manual
413 @cindex Internals Reference
416 * Properties of layout objects::
417 * Properties found in interfaces::
418 * Types of properties::
421 @node Properties of layout objects
422 @subsection Properties of layout objects
424 @cindex propiedades de los objetos de presentación
425 @cindex propiedades de los grobs
426 @cindex grobs, propiedades de
427 @cindex presentación, propiedades de los objetos de
429 Suponga que tiene una partitura con una ligadura de expresión que para
430 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
431 debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
432 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
433 piensa que una cierta instrucción de sobreescritura @code{\override}
434 será necesaria. Pero ¿existe una propiedad de grosor para las
435 ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
436 interviene el Manual de Funcionamiento Interno. Contiene toda la
437 información que puede necesitar para construir ésta y todas las demás
438 instrucciones @code{\override}, de sobreescritura.
440 Una advertencia antes de dirigir nuestra mirada a la referencia de
441 funcionamiento interno. Éste es un documento de @strong{referencia},
442 lo que significa que hay pocas o ninguna explicación en él: su
443 propósito es presentar la información de forma precisa y concisa. Por
444 tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
445 La guía y las explicaciones que presentamos aquí le permitirán extraer
446 la información de la referencia de funcionamiento interno por sí mismo
447 con tan sólo algo de práctica.
449 @cindex sobreescritura, ejemplo de
450 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
452 Utilicemos un ejemplo concreto con un sencillo fragmento de música
455 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
460 g[( e]) e d[( f]) a |
464 The man who feels love's sweet e -- mo -- tion
469 Suponga ahora que decidimos que nos gustan las ligaduras algo más
470 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
471 presentación, así que la cuestión es @q{¿Hay una propiedad
472 perteneciente a las ligaduras de expresión que controle su grosor?}
473 Para responder a esta pregunta debemos mirar el manual de Referencia
474 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
475 (Internals Reference) en inglés}.
477 El RFI de la versión de LilyPond que está usando se puede encontrar en
478 la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
479 página de la documentación y siga el enlace Manual de Referencia de
480 Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
481 sería mejor que utilizase la versión html, no la @q{en una sola
482 página} ni el PDF. Para que los siguientes párrafos tengan algún
483 sentido deberá consultarlo realmente al tiempo que lee.
485 @c Link names in English as these pages are not yet translated
486 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
487 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
488 información sobre los objetos de presentación. Una vez allí, bajo el
489 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
490 objects}. La página que aparece relaciona todos los objetos de
491 presentación que se usan en su versión de LilyPond, en orden
492 alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
493 relacionadas las propiedades de las ligaduras de expresión o Slurs.
495 (Una forma alternativa de encontrar esta página es a partir de la
496 Referencia de la Notación. En una de las páginas que tratan de las
497 ligaduras de expresión podrá encontrar un enlace al manual de
498 referencia del funcioonamiento interno. Este enlace le llevará
499 directamente a esta página, aunque con frecuencia es más fácil ir
500 directamente al RFI y buscar allí.)
502 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
503 dice en primer lugar que los objetos Slur se crean por el grabador
504 Slur_engraver. A continuación relaciona los ajustes estándar.
505 Observe que @strong{no} están en orden alfabético. Navegue hacia
506 abajo buscando una propiedad que pudiera controlar el grosor de las
507 ligaduras, y encontrará
510 @code{thickness} (number)
512 Line thickness, generally measured in @code{line-thickness}
515 Esto promete ser una buena opción para cambiar el grosor. Nos dice
516 que el valor de @code{thickness} es un simple @emph{número}, que el
517 valor predeterminado es 1.2, y que las unidades están dentro de otra
518 propiedad llamada @code{line-thickness}.
520 Como dijimos con anterioridad, existen entre pocas y ninguna
521 explicación en el RFI, pero ya tenemos información suficiente para
522 probar a cambiar el grosor de la ligadura. Vemos que el nombre del
523 objeto de presentación es @code{Slur}, que el nombre de la propiedad
524 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
525 un número algo más grande que 1.2 si queremos hacer las ligaduras más
528 Ahora podemos construir la instrucción de sobreescritura
529 @code{\override} simplemente mediante la sustitución de los valores
530 que hemos encontrado para los nombres, omitiendo el contexto.
531 Usaremos un valor muy grande para el grosor al principio, para estar
532 seguros de que la instrucción está funcionando. Obtenemos lo
536 \override Slur #'thickness = #5.0
539 ¡No olvide el @code{#'} antes del nombre de la propiedad y @code{#}
540 antes del valor nuevo!
542 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
543 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
544 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
545 cerca de ella.} Hagámoslo así:
547 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
551 % Increase thickness of all following slurs from 1.2 to 5.0
552 \override Slur #'thickness = #5.0
554 g[( e]) e d[( f]) a |
558 The man who feels love's sweet e -- mo -- tion
564 y podemos ver que la ligadura, es sin duda, más pesada.
566 Así pues, ésta es la forma básica de construir instrucciones
567 @code{\override} o de sobreescritura. Existen unas cuantas
568 complicaciones más con las que nos encontraremos en secciones
569 posteriores, pero ahora conoce todos los principios esenciales que
570 necesita para hacerlo por sí mismo (aunque aún necesita algo de
571 práctica). La cual vendrá proporcionada por los ejemplos que vienen a
574 @subheading Finding the context
575 @cindex contexto, encontrar
577 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
578 especificar el contexto? ¿Cuál sería? Podemos suponer que las
579 ligaduras están en el contexto de Voz, por estar claramente asociados
580 de manera estrecha con las líneas individuales de música, pero
581 ¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
582 de la página del RFI que describe las ligaduras (Slur), donde dice
583 @q{Slur objects are created by: Slur engraver} («Los objetos de
584 ligadura de expresión se crean por: el grabador Slur»). Así pues, las
585 ligaduras de expresión se crean en cualquier contexto en el que se
586 encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
587 página del grabador @code{Slur_engraver}. Al final del todo, dice que
588 el grabador @code{Slur_engraver} es parte de cinco contextos de voz,
589 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
590 suposición era acertada. Y a causa de que @code{Voice} es uno de los
591 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
592 por el hecho de que estamos escribiendo notas, podemos omitirlo en
595 @subheading Overriding once only
597 @cindex sobreescritura por una sola vez
598 @cindex once override
601 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
602 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
603 ligadura fuese más gruesa? Esto se consigue con la instrucción o
604 prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
605 @code{\override} ocasiona que solamente cambie la ligadura que
606 comienza en la nota @strong{inmediata siguiente}. Si la nota
607 inmediata siguiente no da inicio a una ligadura, la instrucción no
608 tiene niingún efecto en absoluto: no se recuerda hasta que se
609 encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
610 la instrucción que lleva @code{\once} se debe reposicionar de la forma
613 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
618 % Increase thickness of immediately following slur only
619 \once \override Slur #'thickness = #5.0
621 g[( e]) e d[( f]) a |
625 The man who feels love's sweet e -- mo -- tion
631 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
633 La instrucción o prefijo @code{\once} también se puede usar antes de
634 la instrucción @code{\set}.
636 @subheading Reverting
639 @cindex predeterminadas, devolver a las propiedades
642 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
643 fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
644 una de ellas precedida por el prefijo @code{\once}, situadas
645 inmediatamente antes de cada una de las notas en que comienzan las
648 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
653 % Increase thickness of immediately following slur only
654 \once \override Slur #'thickness = #5.0
656 % Increase thickness of immediately following slur only
657 \once \override Slur #'thickness = #5.0
658 g[( e]) e d[( f]) a |
662 The man who feels love's sweet e -- mo -- tion
668 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
669 instrucción @code{\revert} (restablecer) para devolver la propiedad
670 del grosor, @code{thickness}, a su valor predeterminado después de la
673 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
678 % Increase thickness of all following slurs from 1.2 to 5.0
679 \override Slur #'thickness = #5.0
682 % Revert thickness of all following slurs to default of 1.2
683 \revert Slur #'thickness
688 The man who feels love's sweet e -- mo -- tion
694 la instrucción @code{\revert} se puede utilizar para devolver
695 cualquier propiedad que se haya cambiado con @code{\override} a su
696 valor predeterminado. Puede utilizar el método que mejor se adapte a
697 aquello que quere hacer.
699 Así finaliza nuestra introducción al manual de RFI, y el método básico
700 de trucaje. A continuación, en las últimas secciones de este capítulo
701 encontrará varios ejemplos, en parte para introducirle en algunas de
702 las posibilidades adicionales del manual RFI, y en parte para
703 proporcionarle más práctica en cómo extraer información de él. Estos
704 ejemplos irán conteniendo cada vez menos palabras de guía y
707 @node Properties found in interfaces
708 @subsection Properties found in interfaces
710 @cindex propiedades de los interfaces
711 @cindex interfaces, propiedades
713 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
714 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
715 En primer lugar miramos en la página del RFI que relaciona todos los
716 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
717 pueda conteolar la letra de la canción. Encontramos @code{LyricText},
718 que parece adecuado. Al seguir este enlace se presentan las
719 propiedades ajustables para el texto de la letra. Estos incluyen
720 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
721 una forma cursiva. Esto es porque la propiedad de la forma es común a
722 todos los objetos de fuente tipográfica, y por tanto, en vez de
723 incluirlo en cada uno de los objetos de preesentación, se agrupa junto
724 con otras propiedades comunes similares y se deposita en un
725 @strong{Interface}, el interface de las fuentes tipográficas
726 @code{font-interface}.
728 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
729 de los interfaces, y descubrir qué objetos usan estas propiedades de
732 Mire de nuevo la página del RFI que decribe a LyricText. Al final de
733 la página hay una lista de enlaces (en las versiones de html del RFI)
734 a los interfaces que LyricText contempla. La lista tiene siete
735 elementos, entre ellos @code{font-interface}. Al seguir este enlace
736 llegamos a las propiedades asociadas con este interface, que también
737 son propiedades de todos los objetos que lo llevan, entre ellos
740 Ahora vemos todas las propiedades ajustables por el usuario que
741 controlan las tipografías, entre ellas @code{font-shape(symbol)},
742 donde @code{symbol} se puede establecer a @code{upright} (recta),
743 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
745 Observará que @code{font-series} y @code{font-size} también se
746 encuentran aquí relacionadas. Esto inmediatamente hace que surja la
747 pregunta: ¿Por qué están las propiedades comunes de tipografía
748 @code{font-series} y @code{font-size} relacionadas bajo
749 @code{LyricText} así como bajo el interface @code{font-interface} pero
750 @code{font-shape} no lo está? La respuesta es que @code{font-series}
751 y @code{font-size} se cambian a partir de sus valores predeterminados
752 globales cuando se crea un objeto @code{LyricText}, pero
753 @code{font-shape} no lo hace. Entonces los elementos de la lista
754 @code{LyricText} le dicen los valores para esas dos propiedades que
755 son de aplicación para @code{LyricText}. Otros objetos que contemplan
756 @code{font-interface} establecerán dichas propiedades de forma
757 diferente cuando se crean.
759 Veamos si ahora podemos construir la instrucción @code{\override} para
760 cambiar la letra a cursiva. El objeto es @code{LyricText}, la
761 propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
762 antes, omitiremos el contexto.
764 Como nota aparte, aunque una nota importante, observe que a causa de
765 que los valores de @code{font-shape} son símbolos, deben ir precedidos
766 de un apóstrofe, @code{'}. Esa es la razón por la que se necesitan
767 apóstrofes antes de @code{thickness} en el ejemplo anterior y en
768 @code{font-shape}. Los dos son también símbolos. Los símbolos son
769 nombres especiales que son conocidos por LilyPond internamente.
770 Algunos de ellos son nombres de propiedades, como @code{thickness} o
771 @code{font-shape}, otros son en efecto valores especiales que se les
772 puede dar a las propiedades, como @code{italic}. Observe la
773 distincion entre esto y las cadenas de texto arbitrarias, que
774 aparecerían entrecomilladas como @code{"a text string"}.
776 De acuerdo, entonces la instrucción @code{\override} que necesitamos
777 para imprimir la letra en cursiva sería
780 \override LyricText #'font-shape = #'italic
784 y debe colocarse justo delante de, y cerca de, la letra a la que debe
787 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
792 g[( e]) e d[( f]) a |
796 \override LyricText #'font-shape = #'italic
797 The man who feels love's sweet e -- mo -- tion
803 y toda la letra se imprime en cursiva.
805 @subheading Specifying the context in lyric mode
806 @cindex contexto, especificación en modo letra
808 En el caso de la letra, si intenta especificar el contexto en el
809 formato que acabamnos de dar, la instrucción no funcionará. Una
810 sílaba escrita en el modo letra, «lyricmode» temina en un espacio, un
811 salto de línea o un dígito. Cualquier otro carácter se incluye como
812 parte de la sílaba. Por esta razón, un espacio o salto de línea debe
813 aparecer antes del último símbolo @code{@}} para evitar que se incluya
814 como parte de la sílaba final. De forma similar, se deben insertar
815 espacios antes y después del punto, @q{.}, separando el nombre del
816 contexto del nombre del objeto, pues en caso contrario los dos nombres
817 se juntarán y el intérprete no podrá reconocerlos. Así pues, la
821 \override Lyrics . LyricText #'font-shape = #'italic
824 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
825 final y la llave de cierre.}
827 @warning{En las sobreescrituras con override dentro de la letra,
828 escriba siempre espacios antes y después del punto que separa el
829 nombre del contexto y el nombre del objeto.}
831 @node Types of properties
832 @subsection Types of properties
834 @cindex propiedades, tipos de
836 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
837 @code{símbolo}. Para que sea válido, el valor que se da a una
838 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
839 tipo. El tipo de la propiedad se muestra siempre entre paréntesis
840 después del nombre de la propiedad en el RFI. He aquí una lista de
841 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
842 algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
843 @code{#}, por supuesto, delante de estos valores cuando se introducen
844 en la instrucción @code{\override}.
846 @multitable @columnfractions .2 .45 .35
847 @headitem Tipo de propiedad
851 @tab Verdadero o Falso, representado por #t o #f
852 @tab @code{#t}, @code{#f}
853 @item Dimensión (en espacios de pentagrama)
854 @tab Un número decimal positivo (en unidades de espacios de pentagrama)
855 @tab @code{2.5}, @code{0.34}
857 @tab Una constante válida de dirección o su equivalente numérico
858 @tab @code{#LEFT}, @code{#CENTER}, @code{#UP},
861 @tab Un número entero positivo
862 @tab @code{3}, @code{1}
864 @tab Un conjunto de elementos entre paréntesis separados por espacios y precedido de un apóstrofe
865 @tab @code{'(left-edge staff-bar)}, @code{'(1)},
866 @code{'(1.0 0.25 0.5)}
868 @tab Cualquier elemento válido de marcado de texto
869 @tab @code{\markup @{ \italic "cresc." @}}
871 @tab Una fracción de redonda construida con la función make-moment
872 @tab @code{(ly:make-moment 1 4)},
873 @code{(ly:make-moment 3 8)}
875 @tab Cualquier valor decimal positivo o negativo
876 @tab @code{3.5}, @code{-2.45}
877 @item Pareja (de números)
878 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofe
879 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
881 @tab Cualquiera del conjunto de símbolos premitidos para esa propiedad, precedido de un apóstrofe
882 @tab @code{'italic}, @code{'inside}
884 @tab Un procedimiento o @code{#f} (para no producir ninguna acción)
885 @tab @code{bend::print}, @code{ly:text-interface::print},
888 @tab Una lista de tres elementos encerrados entre paréntesis y precedida de una almohadilla, @code{#}.
889 @tab @code{#(#t #t #f)}
892 @node Appearance of objects
893 @section Appearance of objects
895 Ahora vamos a poner en práctica lo que hemos aprendido con unos
896 cuantos ejemplos que muestran cómo se pueden usar los trucos para
897 cambiar el aspecto de la música impresa.
900 * Visibility and color of objects::
902 * Length and thickness of objects::
905 @node Visibility and color of objects
906 @subsection Visibility and color of objects
908 Dentro de un uso educativo de la música, podríamos desear imprimir una
909 partitura con ciertos elementos omitidos como ejercicio para el
910 alumno, a quien se le pide que los complete. A la manera de ejemplo
911 sencillo, supongamos que el ejercicio es escribir las líneas
912 divisorias que faltan en un fragmento musical. Pero las líneas
913 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
916 Antes de enredarnos con esto, recordemos que las propiedades de los
917 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
918 @ref{Properties found in interfaces}). Esto es simplemente agrupar
919 las propiedades que normalmente se necesitan juntas: si una de ellas
920 se necesita para un objeto, también las otras. Así, ciertos objetos
921 necesitan las propiedades de algunos interfaces, otros necesitan las
922 de otros interfaces. Los interfaces que contienen las propiedades que
923 un determinado grob necesita se ecuentran relacionadas en el manual
924 RFI al final de la página que describe dicho grob, y esas propiedades
925 se pueden ver mirando dichos interfaces.
927 Hemos explicado cómo encontrar información sobre los grobs en
928 @ref{Properties of layout objects}. Usando el mismo enfoque, vamos al
929 RFI para biscar el objeto de presentación que imprime las líneas
930 divisorias. A través del enlace @emph{Backend} y @emph{All layout
931 objects} encontramos que hay un objeto de presentación llamado
932 @code{BarLine}. Entre sus propiedades se encuentran dos que controlan
933 la visibilidad: @code{break-visibility} y @code{stencil}. Las líneas
934 divisorias también contemplan un número de interfaces, entre ellos el
935 @code{grob-interface}, donde podemos encontrar las propiedades
936 @code{transparent} y @code{color}. Todas ellas pueden afectar la
937 visibilidad de las barras de compás (y, por supuesto, por extensión,
938 tambén la de muchos otros objetos de presentación). Vamos a
939 considerar cada uno de ellos por orden.
942 @cindex stencil (sello), propiedad
944 Esta propiedad controla la apariencia de las barras de compás mediante
945 la especificación del símbolo (o «glifo») que se debe imprimir. Igual
946 que como otras muchas propiedades, se puede establecer de forma que no
947 imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
948 antes, omitiendo el Contexto implícito, @code{Voice}:
950 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
953 \override BarLine #'stencil = ##f
960 Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
961 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
962 objeto BarLine. Al principio de la página dice @qq{Barline objects
963 are created by: Bar_engraver} (los objetos Barline se crean por el
964 grabador Bar_engraver). Vaya a la página del grabador
965 @code{Bar_engraver} siguiendo el enlace. Al final da una lista de
966 contextos en los que el grabador de líneas divisorias opera. Todos
967 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
968 @code{\override} no funcionara como esperábamos, es porque
969 @code{Barline} no se encuentra en el contexto predeterminado
970 @code{Voice}. Si el contexto se especifica mal, la instrucción
971 simplemente no funciona. No se produce ningún mensaje de error, y no
972 se registra nada en el archivo log de registro. Vamos a intentar
973 corregirlo escribiendo el contexto correcto:
975 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
978 \override Staff.BarLine #'stencil = ##f
985 Ahora las barras de compás han desaparecido.
987 @subheading break-visibility
989 @cindex break-visibility property
991 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI que
992 la propiedad @code{break-visibility} requiere un vector de tres
993 valores booleanos. Controlan respectivamente si las barras de compás
994 se imprimen al final de una línea, en mitad de una línea, y al
995 principio de las líneas. Para nuestro ejemplo, queremos que todas las
996 barras de compás se supriman, por lo que el valor que necesitamos es
997 @code{#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
998 de @code{Staff}. Observa también que al escribir este valor tenemos
999 dos símbolos de almohadilla antes del paréntesis de apertura. Se
1000 necesita uno como parte del valor para introducir un vector, y se
1001 necesita otro más, como siempre, para precered el propio valor dentro
1002 de la instrucción @code{\override}.
1004 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1007 \override Staff.BarLine #'break-visibility = ##(#f #f #f)
1009 g, a16 b8 c d4 e16 |
1014 Y podemos ver que esto también quita todas las líneas divisorias.
1016 @subheading transparent
1017 @cindex transparente, propiedad
1019 En la relación de propiedades que se especifican en la página del
1020 @code{grob-interface} del RFI podemos ver que la propiedad
1021 @code{transparent} es un valor booleano. Esto se debe establecer a
1022 @code{#t} para hacer que el grob sea transparente. En el ejemplo
1023 siguiente vamos a hacer que la indicación de compás, y no las líneas
1024 divisorias, sea transparente. Para hacerlo tenemos que buscar el
1025 nombre del grob de la indicación de compás. Volviendo a la página
1026 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1027 presentación @code{TimeSignature}. Se produce por parte del grabador
1028 @code{Time_signature_engraver} que como puede comprobar vive dentro
1029 del contexto de @code{Staff} y también contempla el interface
1030 @code{grob-interface}. Así pues, la instrucción que hace transparente
1031 a la indicación de compás es:
1033 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1036 \override Staff.TimeSignature #'transparent = ##t
1038 g, a16 b8 c d4 e16 |
1044 El compás ya no está, pero esta instrucción deja una separación en el
1045 lugar donde antes estaba la indicación de compás. Quizá esto es lo
1046 que queremos para un ejercicio en que el alumno deba escribirlo, pero
1047 en otras circunstancias esta separación podría no ser deseable. En
1048 vez de eso, para quitarla, el stencil o «sello» de la indicación de
1049 compás se debe establecer al valor @code{#f}:
1051 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1054 \override Staff.TimeSignature #'stencil = ##f
1056 g, a16 b8 c d4 e16 |
1062 y la diferencia es obvia: al establecer el sello al valor @code{#f}
1063 quitamos el objeto por completo; al hacer el objeto @code{transparent}
1064 lo dejamos donde está, pero lo hacemos invisible.
1067 @cindex color, propiedad
1069 PAra finalizar, podríamos hacer invisibles las barras de compás
1070 pintándolas de color blanco. El interface @code{grob-interface}
1071 especifica que la propiedad del color es una lista, pero no hay
1072 ninguna explicación sobre lo que debe ir en esa lista. La lista que
1073 requiere es realmente una lista de valores en unidades internas, pero
1074 para evitar tener que saber cuáles son, se ofrecen varias vías para la
1075 especificación de los colores. La primera forma es utilizar uno de
1076 los colores @q{normales} que están relacionados en la primera tabla de
1077 la @ruser{List of colors}. Para poner las líneas divisorias de color
1080 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1083 \override Staff.BarLine #'color = #white
1085 g, a16 b8 c d4 e16 |
1091 y de nuevo podemos comprobar que las barras de compás no son visibles.
1092 Observe que @emph{white} no viene precedido de un apóstrofe: no es un
1093 símbolo, sino una @emph{función}. Cuando se invoca, proporciona la
1094 lista de valores internos que se requieren para establecer el color a
1095 blanco. Los otros colores de la lista normal también son funciones.
1096 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1097 una de las otras funciones de la lista.
1099 @cindex colores de X11
1100 @cindex X11, colores de
1102 La segunda forma de cambiar el color es utilizar la lista de nombres
1103 de colores de X11 que aparecen en la segunda lista de @ruser{List of
1104 colors}. Sin embargo, éstos deben ir precedidos de otra función, que
1105 convierte los nombres de colores de X11 en la lista de valores
1106 internos, @code{x11-color}, de la siguiente manera:
1108 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1111 \override Staff.BarLine #'color = #(x11-color 'white)
1113 g, a16 b8 c d4 e16 |
1119 Observe que en este caso la función @code{x11-color} toma un símbolo
1120 como argumento, así que el símbolo debe ir precedido de un apóstrofe y
1121 los dos deben ir entre paréntesis.
1123 @cindex rgb, colores
1126 Aún hay una tercera función, que convierte valores RGB en colores
1127 internos: la función @code{rgb-color}. Toma tres argumentos que dan
1128 las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
1129 valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
1130 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1131 @code{(rgb-color 1 1 1)}:
1133 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1136 \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1138 g, a16 b8 c d4 e16 |
1143 Finalmente, existe también una escala de grises como parte del
1144 conjunto de colores de X11. Varían desde el negro, @code{'grey0'},
1145 hsta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
1146 estableciendo todos los objetos de presentación de nuestro ejemplo a
1147 varias gradaciones de gris:
1149 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1152 \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
1153 \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1154 \override Staff.Clef #'color = #(x11-color 'grey60)
1155 \override Voice.NoteHead #'color = #(x11-color 'grey85)
1156 \override Voice.Stem #'color = #(x11-color 'grey85)
1157 \override Staff.BarLine #'color = #(x11-color 'grey10)
1159 g, a16 b8 c d4 e16 |
1165 Observe los contextos asociados con cada uno de los objetos de
1166 presentación. Es importante que estén correctamente escritos, o las
1167 instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
1168 que se encuentra el grabador correspondiente. El contesto
1169 predeterminado para los grabadores puede encontrarse empezando por el
1170 objeto de presentación, de ahí al grabador que lo produce, y en la
1171 página del grabador del RFI aparece en qué contexto se puede encontrar
1172 normalmente el grabador.
1175 @node Size of objects
1176 @subsection Size of objects
1178 Empezaremos examinando de nuevo un ejemplo anterior (véase
1179 @ref{Nesting music expressions}) que nos mostraba cómo introducir un
1180 pentagrama temporal, como en un @rglos{ossia}.
1182 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1183 \new Staff ="main" {
1190 alignAboveContext = "main" }
1198 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1199 por lo normal se imprimen más pequeños que el pentagrama principal.
1200 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1201 el sello de cada uno de ellos a @code{#f}, como sigue:
1203 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1204 \new Staff ="main" {
1211 alignAboveContext = "main"
1214 \override Staff.Clef #'stencil = ##f
1215 \override Staff.TimeSignature #'stencil = ##f
1225 donde el par de llaves adicional después de la cláusula @code{\with}
1226 es necesario para asegurar que la sobreescritura encerrada y la música
1227 se aplican al pentagrama de ossia.
1229 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1230 usando @code{\with} y modificar los sellos de clave y de compás con
1231 \override? La diferencia principal es que los cambios que se realizan
1232 enuna cláusula @code{\with} se hacen en el momento en que se crea el
1233 contexto, y permanecen activos como valores @strong{predeterminados}
1234 durante toda la duración de dicho contexto, mientras que las
1235 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1236 música son dinámicas: hacen cambios sincronizados con un punto
1237 concreto de la música. Si los cambios se deshacen o se devuelven
1238 mediante @code{\unset} o @code{\revert} volverán a su valor
1239 predeterminado que será el establecido en la cláusula @code{\with}, o
1240 si no se ha establecido ninguno en este lugar, los valores
1241 predeterminados normales.
1243 Ciertas propiedades de contexto se pueden modificar solamente dentro
1244 de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
1245 cambiar después de que el contexto se ha creado.
1246 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1247 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1248 alineación está decidida y no tendría sentido intentar cambiarla más
1251 Los valores predeterminados de las propiedades de los objetos de
1252 presentación también se pueden establever dentro de cláusulas
1253 @code{\with}. Simplemente utilice la instrucción @code{\override}
1254 normal dejando aparte el nombre del contextom ya que está definido sin
1255 ambigüedad como el contexto que la cláusula @code{\with} está
1256 modificando. De hecho, se producirá un error si se especifica un
1257 contexto en este lugar.
1259 Así pues, podemos reemplazar el ejemplo anterior con
1261 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1262 \new Staff ="main" {
1269 alignAboveContext = "main"
1270 % Don't print clefs in this staff
1271 \override Clef #'stencil = ##f
1272 % Don't print time signatures in this staff
1273 \override TimeSignature #'stencil = ##f
1282 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1285 Ciertos objetos de presentación se crean como glifos sacados de una
1286 fuente tipográfica. Entre ellos se encuentran las cabezas,
1287 alteraciones, elementos de marcado, claves, indicaciones de compás,
1288 indicaciones dinámicas y la letra de las canciones. Su tamaño se
1289 cambia mediante la modificación de la propiedad @code{font-size}, como
1290 veremos en breve. Otros objetos de presentación como ligaduras de
1291 unión y de expresión (en general, objetos de extensión) se trazan
1292 individualmente, por lo que no hay un tamaño de tipografía
1293 @code{font-size} asociado a ellos. Estos objetos generalmente derivan
1294 su tamaño de los objetos a los que están adosados, y por ello
1295 normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
1296 otras propiedades como la longitud de las plicas y las barras de
1297 compás, el grosor de las barras de corchea y otras líneas, y la
1298 separación de las líneas del pentagrama se deben modificar de otras
1301 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1302 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1303 cambiar el tamaño de las tipografías de cada uno de los tipos de
1304 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1307 \override NoteHead #'font-size = #-2
1310 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1311 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1312 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1319 Los dos enunciados producirían una reducción del tamaño de la
1320 tipografía en dos pasos a partir de su valor previo, donde cada paso
1321 reduce o aumenta el tamaño aproximadamente en un 12%.
1323 Vamos a probarlo en nuestro ejemplo del ossia:
1325 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1326 \new Staff ="main" {
1333 alignAboveContext = "main"
1334 \override Clef #'stencil = ##f
1335 \override TimeSignature #'stencil = ##f
1336 % Reduce all font sizes by ~24%
1346 Aún no está demasiado bien. Las cabezas y los corchetes de las notas
1347 son más pequeños, pero las plicas son demasiado largas en proporción,
1348 y las líneas del pentagrama están demasiado separadas entre sí. Se
1349 debe reducir su escala en proporción a la reducción de la tipografía.
1350 El siguiente apartado trata sobre cómo se hace esto.
1352 @node Length and thickness of objects
1353 @subsection Length and thickness of objects
1359 @cindex tamaño, cambiar
1360 @cindex plica, cambiar la longitud
1361 @cindex pentagrama, cambiar la separación de las líneas
1363 Las distancias y longitudes en LilyPond se miden generalmente en
1364 espacios de pentagrama, la distancia entre líneas adyacentes de la
1365 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1366 de las propiedades de @code{thickness} (grosor) se miden en unidades
1367 de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
1368 de forma predeterminada, a las líneas de los reguladores se les da un
1369 grosor de 1 unidad de @code{line-thickness}, mientras que el
1370 @code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
1371 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1372 barras de corchea se mide en espacios de pentagrama.
1374 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1375 tamaño de la tipografía? Se puede hacer con la ayuda de una función
1376 especial que se llama @code{magstep}, pensada especialmente para este
1377 propósito. Toma un argumento, el cambio de tamaño de la tipografía
1378 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1379 para reducir otros objetos en la misma proporción. Se usa de la
1382 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1383 \new Staff ="main" {
1390 alignAboveContext = "main"
1391 \override Clef #'stencil = ##f
1392 \override TimeSignature #'stencil = ##f
1394 % Reduce stem length and line spacing to match
1395 \override StaffSymbol #'staff-space = #(magstep -2)
1405 Puesto que la longitud de las plicas y muchas otras propiedades
1406 relacionadas con la longitudse calculan siempre con relación al valor
1407 de la propiedad @code{staff-space}, su longitud también ve reducida su
1408 escala automáticamente. Observe que esto afecta solamente a la escala
1409 vertical del ossia: la escala horizontal se determina por medio de la
1410 disposición de la música principal con el objeto de mantenerse en
1411 sincronía con ella, de forma que no resulte afectada por ninguno de
1412 estos cambios de tamaño. Por supuesto, si la escala de toda la música
1413 principal se cambiase de esta forma, entonces el espaciado horizontal
1414 se vería afectado. Trataremos de esto más tarde en la sección sobre
1417 Esto, en fin, completa la creación de un ossia. Los tamaños y
1418 longitudes del resto de los objetos se pueden modificar de manera
1421 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1422 grosor de las diversas líneas dibujadas como divisorias, barras de
1423 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1424 ajuste global. Si el grosor de cualquier objeto de presentación en
1425 particular necesita ajustarse, se puede hacer mejor mediante la
1426 sobreescritura de su propiedad @code{thickness}. Anteriormente
1427 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1428 @ref{Properties of layout objects}. El grosor de todos los objetos
1429 trazados (es decir, aquellos que no se producen a partir de una
1430 tipografía) se pueden cambiar de la misma forma.
1432 @node Moving objects
1433 @section Moving objects
1435 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
1436 de notación se pueden superponer, lo que es una lástima, pero en casi
1437 todos los casos se resuelve fácilmente.
1439 @c FIXME: find a better example for 5.1 Moving Objects. -gp
1440 @c yes, I want this TODO to be visible to end-users. It's better
1441 @c than having nothing at all.
1442 HACER: con las nuevas funcionalidades de espaciado en la versión 2.12, estos ejemplos específicos
1443 ya no son de relevancia. Sin embargo siguen demostrando las poderosas funcionalidades de lilypond,
1444 así que quedan aquí hasta que alguien elabore unos ejemplos mejores.
1446 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1447 % temporary code to break this example:
1448 \override TextScript #'outside-staff-priority = ##f
1449 e4^\markup{ \italic ritenuto } g b e
1454 La solución más fácil es aumentar la distancia entre el objeto
1455 (texto en este caso, pero muy bien podrían ser digitaciones o dinámicas)
1456 y la nota. En LilyPond, esto se llama la propiedad
1457 @code{padding} (relleno); se mide en espacios de pentagrama. Para la mayor
1458 parte de los objetos, este valor ronda la cantidad de 1.0 o menos (varía dependiendo del
1459 objeto). Queremos aumentarlo, así que probaremos el valor 1.5
1461 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1462 % temporary code to break this example:
1463 \override TextScript #'outside-staff-priority = ##f
1464 \once \override TextScript #'padding = #1.5
1465 e4^\markup{ \italic ritenuto } g b e
1468 Esto tiene un mejor aspecto, pero no es suficiente. Después de probar
1469 con algunos valores, creemos que 2.3 es el mejor número en este caso. Sin embargo
1470 esta cantidad es el mero resultado del ensayo y error y de mi gusto personal
1471 acerca de la notación. Pruebe el ejemplo anterior con 2.3... pero también con otros valores
1472 mayores (y menores). ¿Cuál cree que queda mejor?
1474 La propiedad @code{staff-padding} (relleno de pentagrama) está estrechamente relacionada.
1475 @code{padding} controla la cantidad de espacio mínima entre un objeto y el objeto más cercano
1476 (generalmente la nota o las líneas del pentagrama);
1477 @code{staff-padding} controla la cantidad mínima de espacio entre un
1478 objeto y el pentagrama. Ello supone una sutil diferencia, pero podrá
1479 observar el comportamiento a continuación.
1481 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1482 % temporary code to break this example:
1483 \override TextScript #'outside-staff-priority = ##f
1484 c4^"piu mosso" b a b
1485 \once \override TextScript #'padding = #4.6
1486 c4^"piu mosso" d e f
1487 \once \override TextScript #'staff-padding = #4.6
1488 c4^"piu mosso" fis a g
1490 c'4^"piu mosso" b a b
1491 \once \override TextScript #'padding = #4.6
1492 c4^"piu mosso" d e f
1493 \once \override TextScript #'staff-padding = #4.6
1494 c4^"piu mosso" fis a g
1497 @cindex desplazamiento adicional
1499 Otra solución nos proporciona un control absoluto sobre la situación del objeto: podemos
1500 moverlo horizontal o verticalmente. Se hace con la propiedad
1501 @code{extra-offset} (desplazamiento adicional). Es ligeramente más complicado y puede
1502 causar otros problemas. Cuando movemos objetos con @code{extra-offset},
1503 el movimiento se hace después de que LilyPond haya colocado todos los demás objetos.
1505 que el resultado podría entrar en conflicto con otros objetos.
1507 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1508 % temporary code to break this example:
1509 \override TextScript #'outside-staff-priority = ##f
1510 \once \override TextScript #'extra-offset = #'( 1.0 . -1.0 )
1511 e4^\markup{ \italic ritenuto } g b e
1514 Con @code{extra-offset}, el primer número controla el movimiento
1515 horizontal (negativo hacia la izquierda); el segundo número controla el movimiento
1516 vertical (positivo hacia arriba). Después de algunos ensayos, hemos decidido que los siguientes valores
1519 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1520 % temporary code to break this example:
1521 \override TextScript #'outside-staff-priority = ##f
1522 \once \override TextScript #'extra-offset = #'( -1.6 . 1.0 )
1523 e4^\markup{ \italic ritenuto } g b e
1527 Una vez más, estos números son simplemente el resultado de algunos experimentos y
1528 de observar la salida. Quizá prefiera que el texto se encuentre algo más arriba,
1529 o a la izquierda, o en cualquier dirección. ¡Pruébelo y observe el resultado!
1531 Una advertencia final: en esta sección hemos usado
1534 \once \override TextScript @dots{}
1537 Esto altera la presentación del texto para la nota siguiente. Si la nota no
1538 tiene ningún texto, este truco no hace nada (y @strong{no} se queda esperando al
1539 siguiente fragmento de texto). Para cambiar el comportamiento permanentemente a partir
1540 del comando, omita el @code{\once}. Para detener este truco, use
1541 @code{\revert} (revertir). Todo esto se explica en profundidad en
1542 @ruser{The \override command}.
1544 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
1545 % temporary code to break this example:
1546 \override TextScript #'outside-staff-priority = ##f
1548 \once \override TextScript #'padding = #4.6
1550 c4^"piu mosso" d e f
1551 \once \override TextScript #'padding = #4.6
1552 c4^"piu mosso" d e f
1553 c4^"piu mosso" d e f
1555 \override TextScript #'padding = #4.6
1556 c4^"piu mosso" d e f
1557 c4^"piu mosso" d e f
1558 \revert TextScript #'padding
1559 c4^"piu mosso" d e f
1564 En el presente manual: @ruser{The \override command}, @ruser{Common tweaks}.
1567 @node Fixing overlapping notation
1568 @section Fixing overlapping notation
1570 En @ruser{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
1571 El mismo mecanismo se puede usar para mover otros tipos de
1572 objetos; simplemente sustituya @code{TextScript} con el nombre de
1575 Para encontrar el nombre del objeto, consulte la sección @q{@strong{véase también}} al
1576 final de la página relevante dentro de la documentación. Por ejemplo, al
1577 final de @ruser{Dynamics}, vemos
1582 Referencia del programa: @internalsref{DynamicText}, @internalsref{Hairpin}.
1583 La posición vertical de estos símbolos se maneja por medio de
1584 @internalsref{DynamicLineSpanner}.
1588 Así que para mover expresiones dinámicas verticalmente, usamos
1591 \override DynamicLineSpanner #'padding = #2.0
1594 No podemos listar todos y cada uno de los objetos, pero presentamos a continuación una lista
1595 de los objetos más comunes.
1597 @multitable @columnfractions .33 .66
1598 @headitem Tipo de objeto @tab Nombre del objeto
1599 @item Expresiones dinámicas (verticalmente) @tab @code{DynamicLineSpanner}
1600 @item Expresiones dinámicas (horizontalmente) @tab @code{DynamicText}
1601 @item Ligaduras de unión @tab @code{Tie}
1602 @item Ligaduras de expresión @tab @code{Slur}
1603 @item Articulaciones @tab @code{Script}
1604 @item Digitaciones @tab @code{Fingering}
1605 @item Texto, p.ej. @code{^"text"} @tab @code{TextScript}
1606 @item Llamadas de ensayo o marcas de texto @tab @code{RehearsalMark}
1611 @section Common tweaks
1613 Algunas sustituciones son tan comunes que se proporcionan comandos preestablecidos
1614 como atajos, como @code{\slurUp} (ligadura hacia arriba) y @code{\stemDown} (plica hacia abajo). Estos
1615 comandos se describen dentro de la Referencia de Notación bajo las secciones
1618 La lista completa de modificaciones disponibles para cada tipo de
1619 objeto (como ligaduras o barras de corchea) están documentadas en la Referencia del
1620 Programa. Sin embargo, muchos objetos de la presentación comparten propiedades que se pueden
1621 usar para aplicar trucos genéricos.
1628 La propiedad @code{padding} (relleno) se puede establecer de forma que incremente
1629 (o disminuya) la distancia entre símbolos que se imprimen encima
1630 o debajo de las notas. Se aplica a todos los objetos con
1631 @code{side-position-interface}.
1633 @lilypond[quote,fragment,relative=1,verbatim]
1635 \override Script #'padding = #3
1639 @lilypond[quote,fragment,relative=1,verbatim]
1640 % This will not work, see below:
1641 \override MetronomeMark #'padding = #3
1645 \override Score.MetronomeMark #'padding = #3
1650 Observe en el segundo ejemplo cuán importante es determinar qué contexto
1651 maneja un objeto determinado. Debido a que el objeto @code{MetronomeMark} (indicación metronómica)
1652 se maneja en el contexto @code{Score}, los cambios de propiedades dentro del
1653 contexto @code{Voice} no se tendrán en cuenta. Para ver más detalles, consulte
1654 @ruser{Constructing a tweak}.
1656 @cindex extra-offset (desplazamiento adicional)
1659 La propiedad @code{extra-offset} mueve objetos en la salida;
1660 requiere una pareja de números. El primer número
1661 controla el movimiento horizontal, un número positivo moverá
1662 el objeto hacia la derecha. El segundo número controla el movimiento
1663 vertical; un número positivo lo desplazará hacia arriba. La
1664 propiedad @code{extra-offset} es una funcionalidad de bajo nivel: el motor
1665 de formateo es completamente olvidadizo respecto de estos desplazamientos.
1667 En el ejemplo siguiente, la segunda digitación se desplaza un poco hacia
1668 la izquierda y 1.8 espacios de pentagrama hacia abajo:
1670 @lilypond[quote,fragment,relative=1,verbatim]
1673 \once \override Fingering
1674 #'extra-offset = #'(-0.3 . -1.8)
1679 El establecimiento de la propiedad @code{transparent} provocará que un objeto se imprima
1680 con @q{tinta invisible}: el objeto no se imprime, pero se conserva todo el resto
1681 de su comportamiento. El objeto aún ocupa un espacio, toma parte en las colisiones,
1682 y se le pueden adjuntar ligaduras de unión o de expresión y barras de corchea.
1684 @cindex objetos transparentes
1685 @cindex quitar objetos
1686 @cindex ocultar objetos
1687 @cindex objetos invisibles
1688 El ejemplo siguiente demuestra cómo conectar distintas voces
1689 utilizando ligaduras. Normalmente las ligaduras sólo unen dos notas de la misma voz.
1690 Al introducir una ligadura en una voz distinta,
1692 @lilypond[quote,fragment,relative=2]
1701 y suprimiendo la primera plica hacia arriba en dicha voz, la ligadura parece cruzarse de una
1705 @lilypond[quote,fragment,relative=2,verbatim]
1707 \once \override Stem #'transparent = ##t
1714 Para asegurarse de que la plica que hemos suprimido no aprieta demasiado a la
1715 ligadura, también alargamos la plica, estableciendo su @code{length} (longitud) a
1718 @lilypond[quote,fragment,relative=2,verbatim]
1720 \once \override Stem #'transparent = ##t
1721 \once \override Stem #'length = #8
1730 @cindex Trucos, distancias
1733 Las distancias en LilyPond se miden en espacios de pentagrama, mientras que
1734 las propiedades de grosor se miden en grosores de líneas de pentagrama. Algunas
1735 propiedades son diferentes; por ejemplo, el grosor de las barras de corchea
1736 se mide en espacios de pentagrama. Para más información, consulte la porción
1737 correspondiente de la referencia del programa.
1742 @section Default files
1744 La documentación de la Referencia del Programa contiene una gran cantidad de información
1745 sobre LilyPond, pero más información aún se puede obtener a partir de la observación
1746 de los archivos internos de LilyPond.
1748 Algunos ajustes por omisión como las definiciones de las
1749 @code{\header@{@}}s (encabezamientos) están almacenados en archivos @code{.ly}.
1750 Otros ajustes como las definiciones de los comandos de marcado se almacenan
1751 como archivos @code{.scm} (de Scheme). Cae fuera del ámbito de presente manual
1752 cualquier explicación más profunda; los usuarios están advertidos de que se necesita
1753 una considerable cantidad de conocimientos técnicos
1754 para comprender estos archivos.
1758 @item Linux: @file{@var{directorio_de_instalación}/lilypond/usr/share/lilypond/current/}
1761 @file{@var{carpeta_de_instalación}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
1762 Para llegar aquí, o bien entre con @code{cd} en este directorio desde el
1763 Terminal, o haga control-clic sobre la aplicación LilyPond y elija
1764 @q{Mostrar el Contenido del Paquete}.
1766 @item Windows: @file{@var{carpeta_de_instalación}/LilyPond/usr/share/lilypond/current/}
1770 Los directorios @file{ly/} y @file{scm/} son de especial interés.
1771 Archivos como @file{ly/property-init.ly} y
1772 @file{ly/declarations-init.ly} definen todos los trucos comunes.
1775 @node Fitting music onto fewer pages
1776 @section Fitting music onto fewer pages
1778 A veces puede acabar con uno o dos pentagramas en una segunda página
1779 (o tercera, o cuarta...). Es fastidioso sobre todo si observa las
1780 páginas anteriores y parece haber
1781 espacio suficiente en ellas.
1783 Al investigar asuntos relacionados con la presentación, la herramienta
1784 @code{annotate-spacing} (anotar el espaciado) no tiene precio.
1785 Este comando imprime los valores de algunos comandos de espaciado;
1786 consulte @ruser{Displaying spacing} para ver más detalles. A partir de
1787 la salida de de @code{annotate-spacing}, podemos ver qué márgenes podríamos desear alterar.
1789 Aparte de los márgenes, existen otras opciones para ahorrar espacio:
1793 Puede indicarle a LilyPond que coloque los sistemas tan juntos como sea
1794 posible (para que quepan tantos sistemas como sea posible sobre una página),
1795 pero luego separar estos sistemas para que no haya ningún espacio vacío
1796 al final de la página.
1800 between-system-padding = #0.1
1801 between-system-space = #0.1
1802 ragged-last-bottom = ##f
1808 Puede forzar el número de sistemas (es decir, si LilyPond quiere
1809 tipografiar la música con 11 sistemas, puede forzarlo
1819 Evite (o reduzca) el uso de objetos que aumenten el tamaño
1820 vertical de un sistema. Por ejemplo, las repeticiones con
1821 primera y segunda vez necesitan espacio adicional. Si
1822 estas repeticiones abarcan dos sistemas, ocuparán más espacio
1823 que un solo sistema con las repeticiones y otro sistema sin ellas.
1825 Otro ejemplo es desplazar las expresiones dinámicas que se
1826 @q{asoman por encima} de un sistema.
1828 @lilypond[verbatim,quote,fragment]
1831 \override DynamicLineSpanner #'padding = #-1.8
1832 \override DynamicText #'extra-offset = #'( -2.1 . 0)
1838 Altere el espaciado horizontal por medio de @code{SpacingSpanner}. Consulte
1839 @ruser{Changing horizontal spacing} para ver más detalles.
1841 @lilypond[verbatim,quote]
1844 g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
1845 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
1846 d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
1847 g4 e e2 | f4 d d2 | c4 e g g | c,1 |
1852 \override SpacingSpanner
1853 #'base-shortest-duration = #(ly:make-moment 1 4)
1861 @node Avoiding tweaks with slower processing
1862 @section Avoiding tweaks with slower processing
1864 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
1865 procesa los archivos. Estos comandos consumen tiempo, pero el
1866 resultado puede necesitar menos trucos manuales.
1869 %% asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
1870 \override Score.PaperColumn #'keep-inside-line = ##t
1873 @node Advanced tweaks with Scheme
1874 @section Advanced tweaks with Scheme
1876 Hemos visto cómo la salida de LilyPond se puede modificar de manera muy profunda utilizando
1878 @code{\override TextScript #'extra-offset = ( 1 . -1)}. Pero
1879 tenemos un potencial incluso mayor si utilizamos Scheme. Para ver una explicación completa
1880 de esto, consulte el @ruser{Scheme tutorial} e
1881 @ruser{Interfaces for programmers}.
1883 Podemos usar Scheme simplemente para sobreponer (@code{\override}) comandos,
1885 @lilypond[quote,verbatim,ragged-right]
1886 padText = #(define-music-function (parser location padding) (number?)
1888 \once \override TextScript #'padding = #$padding
1892 c4^"piu mosso" b a b
1894 c4^"piu mosso" d e f
1896 c4^"piu mosso" fis a g
1900 Podemos usarlo para crear comandos nuevos,
1902 @lilypond[quote,verbatim,ragged-right]
1903 tempoMark = #(define-music-function (parser location padding marktext)
1906 \once \override Score . RehearsalMark #'padding = $padding
1907 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
1908 \mark \markup { \bold $marktext }
1913 \tempoMark #3.0 #"Allegro"
1918 E incluso se le pueden pasar expresiones musicales.
1920 @lilypond[quote,verbatim,ragged-right]
1921 pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
1928 \pattern {d16 dis} { ais16-> b\p }