1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 5f51567fbc5d7a811e147ebd01f103e066f36b3a
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Trucar la salida
14 @chapter Trucar la salida
15 @translationof Tweaking output
17 Este capítulo trata de cómo modificar la salida. LilyPond es extremadamente
18 configurable; prácticamente todos los fragmentos de la salida se pueden cambiar.
22 * Elementos de trucaje::
23 * Manual de referencia de funcionamiento interno::
24 * Apariencia de los objetos::
25 * Colocación de los objetos::
26 * Colisiones de objetos::
27 * Trucajes adicionales::
30 @node Elementos de trucaje
31 @section Elementos de trucaje
32 @translationof Tweaking basics
35 * Introducción al trucaje::
36 * Objetos e interfaces::
37 * Convenciones de nombres de objetos y propiedades::
38 * Métodos de trucaje::
41 @node Introducción al trucaje
42 @subsection Introducción al trucaje
43 @translationof Introduction to tweaks
45 El @q{Trucaje} es un término de LilyPond que denota los diversos
46 métodos que el usuario tiene a su disposición para modificar el
47 proceso de interpretación del archivo de entrada y cambiar la
48 apariencia de la salida impresa. Algunos trucos son muy fáciles de
49 usar; otros son más complejos. Pero en su conjunto, los métodos de
50 trucaje disponibles posibilitan conseguir casi cualquier apariencia
51 que deseemos en la música impresa.
53 En esta sección vamos a estudiar los conceptos básicos que se
54 necesitan para comprender el trucaje. Más tarde daremos un amplio
55 abanico de instrucciones listas para usar, que podrá simplemente
56 copiar para obtener el mismo efecto en sus partituras, y al mismo
57 tiempo mostraremos la forma de construir dichas instrucciones para que
58 pueda aprender cómo desarrollar sus propios trucos.
60 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
61 la sección @ref{Contextos y grabadores}, pues los Contextos, los
62 Grabadores y las Propiedades que se contienen en ellos son
63 fundamentales para comprender y construir los trucos.
65 @node Objetos e interfaces
66 @subsection Objetos e interfaces
67 @translationof Objects and interfaces
71 @cindex objeto de extensión
73 @cindex propiedades de objetos
74 @cindex objeto, propiedades de
75 @cindex layout (disposición), objeto de
76 @cindex objeto de disposición (layout)
78 El trucaje consiste en modificar el funcionamiento y estructura
79 interna del programa LilyPond, por lo que en primer lugar
80 introduciremos algunos términos que se usan para describir dichas
81 operaciones y estructuras internas.
83 El término @q{Objeto} es un término genérico que se usa para referirse
84 a la multitud de estructuras internas que LilyPond construye durante
85 el procesado de un archivo de entrada. Así, cuando se encuentra una
86 instrucción como @code{\new Staff}, se construye un objeto nuevo del
87 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
88 las propiedades asociadas con ese pentagrama en particular, por
89 ejemplo, su nombre y su armadura, además de otros detalles de los
90 grabadores que se han asignado para que operen dentro del contexto del
91 pentagrama. De forma similar, hay objetos que guardan las propiedades
92 de todos los demás contextos, como objetos de @code{Voice}, objetos de
93 @code{Score}, objetos de @code{Lyrics}, así como objetos que
94 representan todos los elementos notacionales como líneas divisorias,
95 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
96 objeto tiene su propio conjunto de valores de propiedad.
98 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
99 representan elementos de notación sobre la salida impresa como cabezas
100 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
101 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
102 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
103 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
104 mencionado, y también todos ellos tienen propiedades asociadas, como
105 su posición, tamaño, color,etc.
107 Ciertos objetos de presentación son aún más especializados. Las
108 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
109 y baja, y muchos otros objetos gráficos no están situados en un solo
110 lugar: tienen un punto de inicio, un punto de final, y quizá otras
111 propiedades relacionadas con su forma. Los objetos con una forma
112 extendida como estos, reciben el nombre de «Objetos de extensión» o
115 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
116 incluso aunque son bastante diferentes, comparten funcionalidades que
117 se deben procesar de la misma manera. Por ejemplo, todos los objetos
118 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
119 propiedades se procesan de la misma forma durante la interpretación
120 del archivo de entrada por parte de LilyPond. Para simplificar estas
121 operaciones internas, estas acciones y propiedades comunes se agrupan
122 en un objeto llamado @code{grob-interface}, interface de grob. Hay
123 muchas otras agrupaciones de propiedades comunes como ésta, y cada
124 una recibe un nombre que acaba en @code{interface}. En total hay más
125 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
126 interés y de utilidad para el usuario.
128 Estos son, en fin, los términos principales relativos a los objetos
129 que vamos a utilizar en este capítulo.
131 @node Convenciones de nombres de objetos y propiedades
132 @subsection Convenciones de nombres de objetos y propiedades
133 @translationof Naming conventions of objects and properties
135 @cindex nomenclatura, convenciones de, para objetos
136 @cindex nomenclatura, convenciones de, para propiedades
137 @cindex objetos, convenciones de nomenclatura
138 @cindex propiedades, convenciones de nomenclatura
140 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
141 sección @ref{Contextos y grabadores}. En este lugar, para más fácil
142 referencia, presentamos una lista de los tipos de objetos y
143 propiedades más comunes, junto con las convenciones según las cuales
144 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
145 utilizado una @q{A} mayúscula para denotar cualquier carácter
146 alfabético en mayúsculas, y @q{aaa} para cualquier número de
147 caracteres alfabéticos en minúscula. Otros caracteres se utilizan
148 literalmente como están.
150 @multitable @columnfractions .33 .33 .33
151 @headitem Objeto o tipo de propiedad
152 @tab Convención de nomenclatura
155 @tab Aaaa o AaaaAaaaAaaa
156 @tab Staff, GrandStaff
157 @item Objetos de presentación
158 @tab Aaaa o AaaaAaaaAaaa
161 @tab Aaaa_aaa_engraver
162 @tab Clef_engraver, Note_heads_engraver
164 @tab aaa-aaa-interface
165 @tab grob-interface, break-aligned-interface
166 @item Propiedades de contextos
167 @tab aaa o aaaAaaaAaaa
168 @tab alignAboveContext, skipBars
169 @item Propiedades de objetos de presentación
170 @tab aaa o aaa-aaa-aaa
171 @tab direction, beam-thickness
174 Como podremos ver en breve, las propiedades de distintos tipos de
175 objeto se modifican por parte de diferentes instrucciones; así pues,
176 es útil poder reconocer el tipo de objeto a partir de sus nombres de
179 @node Métodos de trucaje
180 @subsection Métodos de trucaje
181 @translationof Tweaking methods
183 @cindex trucaje, métodos de
185 @strong{La instrucción \override}
187 @cindex override, instrucción
188 @cindex override (sobreescritura), sintaxis de
193 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
194 usan para cambiar las propiedades de los @strong{contextos} y para
195 quitar y poner @strong{grabadores}, en @ref{Modificar las propiedades de los contextos} y @ref{Añadir y eliminar grabadores}. Ahora debemos
196 examinar algunas otras instrucciones importantes.
198 La instrucción que cambia las propiedades de los @strong{objetos de
199 presentación} es @code{\override}. Puesto que esta instrucción debe
200 modificar propiedades internas que se encuentran en un lugar profundo
201 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
202 las instrucciones que hemos usado hasta ahora. Tiene que saber
203 exactamente qué propiedad de qué objeto y en qué contexto se debe
204 modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
206 La sintaxis genérica de esta instrucción es:
209 \override @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación} =
214 Esto establecerá la propiedad de nombre
215 @var{propiedad-de-presentación} del objeto de presentación con el
216 nombre @var{ObjetoDePresentación}, que es miembro del contexto
217 @var{Contexto}, al valor @var{valor}.
219 El @var{contexto} se puede omitir (y normalmente así es) cuando el
220 contexto requerido se encuentra implicado sin ambigüedad y es uno de
221 los contextos del nivel más bajo, es decir: @code{Voice},
222 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
223 ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
225 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
226 valores, pero para ilustrar el formato y utilización de estas
227 instrucciones usaremos sólo unas cuantas propiedades y valores
228 sencillos que sean fáciles de entender.
230 Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
231 propiedad de presentación, y el @code{#}, que debe preceder al valor.
232 Deben estar presentes siempre y de esa forma exacta. Es la
233 instrucción de uso más común dentro del trucaje, y durante la mayor
234 parte del resto de este capítulo presentaremos ejemplos de cómo se
235 usa. A continuación hay un ejemplo sencillo para cambiar el color de
238 @cindex color, propiedad, ejemplo
239 @cindex NoteHead, ejemplo de sobreescritura
241 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
243 \override NoteHead #'color = #red
245 \override NoteHead #'color = #green
249 @strong{La instrucción \revert}
251 @cindex revert, instrucción
256 Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
257 se sobreescribe de nuevo o se encuentra una instrucción
258 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
259 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
260 valor predeterminado original; observe que no es a su valor previo si
261 se han utilizado varias instrucciones @code{\override}.
264 \revert @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación}
267 Una vez más, igual que @var{Contexto} dentro de la instrucción
268 @code{\override}, con frecuencia no es necesario especificar el
269 @var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
270 Aquí devolvemos el color de la cabeza al valor predeterminado para las
273 @cindex color, propiedad, ejemplo
274 @cindex NoteHead, ejemplo de sobreescritura
276 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
278 \override NoteHead #'color = #red
280 \override NoteHead #'color = #green
282 \revert NoteHead #'color
286 @strong{El prefijo \once}
291 Tanto la instrucción @code{\override} como @code{\set} se pueden
292 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
293 @code{\override} o @code{\set} sea efectiva solamente durante el
294 tiempo musical en curso y antes de que la propiedad vuelva a tener
295 otra vez su valor predeterminado. Utilizando el mismo ejemplo,
296 podemos cambiar el color de una sola nota de la siguiente manera:
298 @cindex color, propiedad, ejemplo
299 @cindex NoteHead, ejemplo de sobreescritura
301 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
303 \once \override NoteHead #'color = #red
305 \once \override NoteHead #'color = #green
309 @strong{La instrucción \overrideProperty}
311 @cindex overrideProperty, instrucción
313 @funindex \overrideProperty
314 @funindex overrideProperty
316 Hay otra forma para la instrucción de sobreescritura,
317 @code{\overrideProperty}, que ocasionalmente es necesaria. La
318 mencionamos aquí con un propósito de exhaustividad, pero para ver más
319 detalles consulte @ruser{Trucos difíciles}.
320 @c Maybe explain in a later iteration -td
322 @strong{La instrucción \tweak}
324 @cindex tweak, instrucción
329 La última instrucción de trucaje que está disponible es @code{\tweak}.
330 Se debe utilizar para cambiar las propiedades de objetos que suceden
331 en el mismo momento musical, como las notas de un acorde. El uso de
332 @code{\override} para la sobreescritura afectaría a todas las notas
333 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
334 elemento del flujo de entrada.
336 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
337 cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
338 primer lugar, veamos lo que haría @code{\once \override}:
340 @cindex font-size, propiedad, ejemplo
341 @cindex NoteHead, ejemplo de sobreescritura
343 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
345 \once \override NoteHead #'font-size = #-3
350 Vemos que la sobreescritura con override afecta a @emph{todas} las
351 cabezas de las notas del acorde. Esto es así porque todas las notas
352 de un acorde ocurren en el mismo @emph{momento musical}, y la acción
353 de @code{\once} es aplicar la sobreescritura a todos los objetos de
354 presentación del tipo especificado que ocurren en el mismo momento
355 musical que la propia instrucción de sobreescritura @code{\override}.
357 La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
358 el elemento inmediatamente siguiente dentro del flujo de entrada. Sin
359 embargo, es efectivo solamente sobre objetos que se crean directamente
360 a partir del flujo de entrada, en esencia las cabezas y las
361 articulaciones; los objetos como las plicas y las alteraciones se
362 crean con posterioridad y no se pueden trucar de esta forma. Es más,
363 cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
364 dentro de un acorde, es decir, dentro de ángulos simples, así que para
365 trucar una sola nota la instrucción @code{\tweak} se debe colocar
366 dentro de ángulos simples junto con la nota.
368 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
369 se cambiaría de la siguiente forma:
371 @cindex font-size, propiedad, ejemplo
372 @cindex @code{\tweak}, ejemplo
374 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
376 <c \tweak #'font-size #-3 e g>4
379 Observe que la sintaxis de @code{\tweak} no es igual que la de
380 @code{\override}. Ni el contexto ni el objeto de presentación se
381 deben especificar; de hecho, generaría un error hacerlo. Los dos
382 están implícitos por el siguiente elemento del flujo de entrada.
383 Observe también que no debe haber un signo igual. Así que la sintaxis
384 genérica de la instrucción @code{\tweak} es, simplemente,
387 \tweak #'@var{propiedad-de-presentación} #@var{valor}
390 Una instrucción @code{\tweak} también se puede usar para modificar
391 sólo una de una serie de articulaciones, como se muestra aquí:
393 @cindex color, propiedad, ejemplo
394 @cindex @code{\tweak}, ejemplo
396 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
398 -\tweak #'color #red ^Red
399 -\tweak #'color #green _Green
403 Observe que la instrucción @code{\tweak} debe venir precedida de una
404 marca de articulación como si ella misma fuera una articulación.
406 @cindex grupos especiales anidados
407 @cindex tresillos anidados
408 @cindex corchete del grupo especial
409 @cindex corchete de tresillo
410 @cindex grupo especial, corchete de
411 @cindex tresillo, corchete de
413 @funindex TupletBracket
415 La instrucción @code{\tweak} también se debe usar para cambiar la
416 apariencia de uno solo de un conjunto de grupos especiales anidados
417 que comiencen en el mismo instante musical. En el siguiente ejemplo,
418 el corchete del tresillo largo y el primero de los tres corchetes
419 cortos empiezan en el mismo momento musical, y por ello cualquier
420 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
421 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
422 @code{\tweak} especifica que el corchete del tresillo largo se debe
423 colocar por encima de las notas y el segundo especifica que el número
424 del tresillo se debe imprimir en rojo sobre el corchete del primer
427 @cindex @code{\tweak}, ejemplo
428 @cindex direction, propiedad, ejemplo
429 @cindex color, propiedad, ejemplo
431 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
432 \tweak #'direction #up
435 \times 2/3 { c8[ c8 c8] }
436 \times 2/3 { c8[ c8 c8] }
437 \times 2/3 { c8[ c8 c8] }
441 Si los grupos anidados no comienzan en el mismo momento, su apariencia
442 se puede modificar de la forma usual mediante instrucciones
445 @cindex text, propiedad, ejemplo
446 @cindex tuplet-number, función, ejemplo
447 @cindex transparent, propiedad, ejemplo
448 @cindex TupletNumber, ejemplo de sobreescritura
450 @c NOTE Tuplet brackets collide if notes are high on staff
452 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
453 \times 2/3 { c8[ c c]}
454 \once \override TupletNumber
455 #'text = #tuplet-number::calc-fraction-text
459 \once \override TupletNumber #'transparent = ##t
460 \times 2/3 { c8[ c c] }
461 \times 2/3 { c8[ c c]}
467 Referencia de la notación:
468 @ruser{La instrucción tweak}.
471 @node Manual de referencia de funcionamiento interno
472 @section Manual de referencia de funcionamiento interno
473 @translationof The Internals Reference manual
475 @cindex Internals Reference
478 * Propiedades de los objetos de presentación::
479 * Propiedades de los interfaces::
480 * Tipos de propiedades::
483 @node Propiedades de los objetos de presentación
484 @subsection Propiedades de los objetos de presentación
485 @translationof Properties of layout objects
487 @cindex propiedades de los objetos de presentación
488 @cindex propiedades de los grobs
489 @cindex grobs, propiedades de
490 @cindex presentación, propiedades de los objetos de
491 @cindex Referencia de funcionamiento interno
493 Suponga que tiene una partitura con una ligadura de expresión que para
494 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
495 debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
496 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
497 piensa que una cierta instrucción de sobreescritura @code{\override}
498 será necesaria. Pero ¿existe una propiedad de grosor para las
499 ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
500 interviene el Manual de Funcionamiento Interno. Contiene toda la
501 información que puede necesitar para construir ésta y todas las demás
502 instrucciones @code{\override}, de sobreescritura.
504 Una advertencia antes de dirigir nuestra mirada a la referencia de
505 funcionamiento interno. Éste es un documento de @strong{referencia},
506 lo que significa que hay pocas o ninguna explicación en él: su
507 propósito es presentar la información de forma precisa y concisa. Por
508 tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
509 La guía y las explicaciones que presentamos aquí le permitirán extraer
510 la información de la referencia de funcionamiento interno por sí mismo
511 con tan sólo algo de práctica.
513 @cindex sobreescritura, ejemplo de
514 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
515 @cindex @code{\addlyrics}, ejemplo
518 Utilicemos un ejemplo concreto con un sencillo fragmento de música
521 @lilypond[quote,verbatim,relative=2]
526 g[( e]) e d[( f]) a |
530 The man who feels love's sweet e -- mo -- tion
535 Suponga ahora que decidimos que nos gustan las ligaduras algo más
536 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
537 presentación, así que la cuestión es @q{¿Hay una propiedad
538 perteneciente a las ligaduras de expresión que controle su grosor?}
539 Para responder a esta pregunta debemos mirar el manual de Referencia
540 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
541 (Internals Reference) en inglés}.
543 El RFI de la versión de LilyPond que está usando se puede encontrar en
544 la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
545 página de la documentación y siga el enlace Manual de Referencia de
546 Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
547 sería mejor que utilizase la versión en HTML, no la @q{en una sola
548 página} ni el PDF. Para que los siguientes párrafos tengan algún
549 sentido deberá consultarlo realmente al tiempo que lee.
551 @c Link names in English as those pages are not yet translated. FV
552 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
553 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
554 información sobre los objetos de presentación. Una vez allí, bajo el
555 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
556 objects}. La página que aparece relaciona todos los objetos de
557 presentación que se usan en su versión de LilyPond, en orden
558 alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
559 relacionadas las propiedades de las ligaduras de expresión o Slurs.
561 Una forma alternativa de encontrar esta página es a partir de la
562 Referencia de la Notación. En una de las páginas que tratan de las
563 ligaduras de expresión podrá encontrar un enlace al manual de
564 referencia del funcionamiento interno. Este enlace le llevará
565 directamente a esta página, aunque si tiene una idea del nombre del
566 objeto de presentación que pretende trucar, le resultará más fácil ir
567 directamente al RFI y buscar allí.
569 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
570 dice en primer lugar que los objetos Slur se crean por el grabador
571 Slur_engraver. A continuación relaciona los ajustes estándar.
572 Observe que @strong{no} están en orden alfabético. Navegue hacia
573 abajo buscando una propiedad que pudiera controlar el grosor de las
574 ligaduras, y encontrará
577 @code{thickness} (number)
579 Line thickness, generally measured in @code{line-thickness}
582 Esto promete ser una buena opción para cambiar el grosor. Nos dice
583 que el valor de @code{thickness} es un simple @emph{número}, que el
584 valor predeterminado es 1.2, y que las unidades están dentro de otra
585 propiedad llamada @code{line-thickness}.
587 Como dijimos con anterioridad, existen entre pocas y ninguna
588 explicación en el RFI, pero ya tenemos información suficiente para
589 probar a cambiar el grosor de la ligadura. Vemos que el nombre del
590 objeto de presentación es @code{Slur}, que el nombre de la propiedad
591 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
592 un número algo más grande que 1.2 si queremos hacer las ligaduras más
595 Ahora podemos construir la instrucción de sobreescritura
596 @code{\override} simplemente mediante la sustitución de los valores
597 que hemos encontrado para los nombres, omitiendo el contexto.
598 Usaremos un valor muy grande para el grosor al principio, para estar
599 seguros de que la instrucción está funcionando. Obtenemos lo
603 \override Slur #'thickness = #5.0
606 ¡No olvide el @code{#'} antes del nombre de la propiedad y @code{#}
607 antes del valor nuevo!
609 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
610 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
611 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
612 cerca de ella.} Hagámoslo así:
614 @cindex Slur, ejemplo de sobreescritura
615 @cindex thickness, propiedad, ejemplo
617 @lilypond[quote,verbatim,relative=2]
621 % Increase thickness of all following slurs from 1.2 to 5.0
622 \override Slur #'thickness = #5.0
624 g[( e]) e d[( f]) a |
628 The man who feels love's sweet e -- mo -- tion
634 y podemos ver que la ligadura, es sin duda, más pesada.
636 Así pues, ésta es la forma básica de construir instrucciones
637 @code{\override} o de sobreescritura. Existen unas cuantas
638 complicaciones más con las que nos encontraremos en secciones
639 posteriores, pero ahora conoce todos los principios esenciales que
640 necesita para hacerlo por sí mismo (aunque aún necesita algo de
641 práctica). La cual vendrá proporcionada por los ejemplos que vienen a
644 @subheading Búsqueda del contexto
646 @cindex contexto, encontrar
647 @cindex contexto, buscar el, correcto
649 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
650 especificar el contexto? ¿Cuál sería? Podemos suponer que las
651 ligaduras están en el contexto de Voz, por estar claramente asociados
652 de manera estrecha con las líneas individuales de música, pero
653 ¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
654 de la página del RFI que describe las ligaduras (Slur), donde dice
655 @q{Slur objects are created by: Slur engraver} («Los objetos de
656 ligadura de expresión se crean por: el grabador Slur»). Así pues, las
657 ligaduras de expresión se crean en cualquier contexto en el que se
658 encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
659 página del grabador @code{Slur_engraver}. Al final del todo, dice que
660 el grabador @code{Slur_engraver} es parte de cinco contextos de voz,
661 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
662 suposición era acertada. Y a causa de que @code{Voice} es uno de los
663 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
664 por el hecho de que estamos escribiendo notas, podemos omitirlo en
667 @subheading Sobreescritura por una sola vez
669 @cindex sobreescritura por una sola vez
670 @cindex once override
675 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
676 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
677 ligadura fuese más gruesa? Esto se consigue con la instrucción o
678 prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
679 @code{\override} ocasiona que solamente cambie la ligadura que
680 comienza en la nota @strong{inmediata siguiente}. Si la nota
681 inmediata siguiente no da inicio a una ligadura, la instrucción no
682 tiene ningún efecto en absoluto: no se recuerda hasta que se
683 encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
684 la instrucción que lleva @code{\once} se debe reposicionar de la forma
687 @cindex Slur, ejemplo de sobreescritura
688 @cindex thickness, propiedad, ejemplo
690 @lilypond[quote,verbatim,relative=2]
695 % Increase thickness of immediately following slur only
696 \once \override Slur #'thickness = #5.0
698 g[( e]) e d[( f]) a |
702 The man who feels love's sweet e -- mo -- tion
708 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
710 La instrucción o prefijo @code{\once} también se puede usar antes de
711 la instrucción @code{\set}.
713 @subheading Recuperación del ajuste
716 @cindex predeterminadas, recuperar las propiedades
721 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
722 fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
723 una de ellas precedida por el prefijo @code{\once}, situadas
724 inmediatamente antes de cada una de las notas en que comienzan las
727 @cindex Slur, ejemplo de sobreescritura
728 @cindex thickness, propiedad, ejemplo
730 @lilypond[quote,verbatim,relative=2]
735 % Increase thickness of immediately following slur only
736 \once \override Slur #'thickness = #5.0
738 % Increase thickness of immediately following slur only
739 \once \override Slur #'thickness = #5.0
740 g[( e]) e d[( f]) a |
744 The man who feels love's sweet e -- mo -- tion
750 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
751 instrucción @code{\revert} (restablecer) para devolver la propiedad
752 del grosor, @code{thickness}, a su valor predeterminado después de la
755 @cindex Slur, ejemplo de sobreescritura
756 @cindex thickness, propiedad, ejemplo
758 @lilypond[quote,verbatim,relative=2]
763 % Increase thickness of all following slurs from 1.2 to 5.0
764 \override Slur #'thickness = #5.0
767 % Revert thickness of all following slurs to default of 1.2
768 \revert Slur #'thickness
773 The man who feels love's sweet e -- mo -- tion
779 la instrucción @code{\revert} se puede utilizar para devolver
780 cualquier propiedad que se haya cambiado con @code{\override} a su
781 valor predeterminado. Puede utilizar el método que mejor se adapte a
782 aquello que quiere hacer.
784 Así finaliza nuestra introducción al manual de RFI, y el método básico
785 de trucaje. A continuación, en las últimas secciones de este capítulo
786 encontrará varios ejemplos, en parte para introducirle en algunas de
787 las posibilidades adicionales del manual RFI, y en parte para
788 proporcionarle más práctica en cómo extraer información de él. Estos
789 ejemplos irán conteniendo cada vez menos palabras de guía y
792 @node Propiedades de los interfaces
793 @subsection Propiedades de los interfaces
794 @translationof Properties found in interfaces
797 @cindex propiedades de los interfaces
798 @cindex interfaces, propiedades
800 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
801 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
802 En primer lugar miramos en la página del RFI que relaciona todos los
803 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
804 pueda controlar la letra de la canción. Encontramos @code{LyricText},
805 que parece adecuado. Al seguir este enlace se presentan las
806 propiedades ajustables para el texto de la letra. Estos incluyen
807 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
808 una forma cursiva. Esto es porque la propiedad de la forma es común a
809 todos los objetos de fuente tipográfica, y por tanto, en vez de
810 incluirlo en cada uno de los objetos de presentación, se agrupa junto
811 con otras propiedades comunes similares y se deposita en un
812 @strong{Interface}, el interface de las fuentes tipográficas
813 @code{font-interface}.
815 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
816 de los interfaces, y descubrir qué objetos usan estas propiedades de
819 Mire de nuevo la página del RFI que describe a LyricText. Al final de
820 la página hay una lista de enlaces a los interfaces que LyricText
821 contempla. La lista tiene siete elementos, entre ellos
822 @code{font-interface}. Al seguir este enlace llegamos a las
823 propiedades asociadas con este interface, que también son propiedades
824 de todos los objetos que lo llevan, entre ellos LyricText.
826 Ahora vemos todas las propiedades ajustables por el usuario que
827 controlan las tipografías, entre ellas @code{font-shape(symbol)},
828 donde @code{symbol} se puede establecer a @code{upright} (recta),
829 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
831 Observará que @code{font-series} y @code{font-size} también se
832 encuentran aquí relacionadas. Esto inmediatamente hace que surja la
833 pregunta: ¿Por qué están las propiedades comunes de tipografía
834 @code{font-series} y @code{font-size} relacionadas bajo
835 @code{LyricText} así como bajo el interface @code{font-interface} pero
836 @code{font-shape} no lo está? La respuesta es que @code{font-series}
837 y @code{font-size} se cambian a partir de sus valores predeterminados
838 globales cuando se crea un objeto @code{LyricText}, pero
839 @code{font-shape} no lo hace. Entonces los elementos de la lista
840 @code{LyricText} le dicen los valores para esas dos propiedades que
841 son de aplicación para @code{LyricText}. Otros objetos que contemplan
842 @code{font-interface} establecerán dichas propiedades de forma
843 diferente cuando se crean.
845 Veamos si ahora podemos construir la instrucción @code{\override} para
846 cambiar la letra a cursiva. El objeto es @code{LyricText}, la
847 propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
848 antes, omitiremos el contexto.
850 Como nota aparte, aunque una nota importante, observe que a causa de
851 que los valores de @code{font-shape} son símbolos, deben ir precedidos
852 de un apóstrofo, @code{'}. Esa es la razón por la que se necesitan
853 apóstrofos antes de @code{thickness} en el ejemplo anterior y en
854 @code{font-shape}. Los dos son también símbolos. Los símbolos son
855 nombres especiales que son conocidos por LilyPond internamente.
856 Algunos de ellos son nombres de propiedades, como @code{thickness} o
857 @code{font-shape}, otros se utilizan como valores que se les puede dar
858 a las propiedades, como @code{italic}. Observe la distinción entre
859 esto y las cadenas de texto arbitrarias, que aparecerían
860 entrecomilladas como @code{"a text string"}. Para ver más detalles
861 relacionados con los símbolos y las cadenas, consulte @ref{Tutorial de Scheme}.
863 Así pues, la instrucción @code{\override} necesaria para imprimir la
864 letra en cursiva, es:
867 \override LyricText #'font-shape = #'italic
871 Esto debe escribirse justo delante de la letra a la que debe afectar,
874 @cindex font-shape, propiedad, ejemplo
875 @cindex italic, ejemplo
876 @cindex LyricText, ejemplo de sobreescritura
877 @cindex @code{\addlyrics}, ejemplo
879 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
884 g[( e]) e d[( f]) a |
888 \override LyricText #'font-shape = #'italic
889 The man who feels love's sweet e -- mo -- tion
895 y toda la letra se imprime en cursiva.
897 @subheading Especificación del contexto en modo letra
899 @cindex contexto, especificación en modo letra
900 @cindex letra, modo, especificar el contexto en
902 En el caso de la letra, si intenta especificar el contexto en el
903 formato que acabamos de dar, la instrucción no funcionará. Una
904 sílaba escrita en el modo letra, «lyricmode» termina en un espacio, un
905 salto de línea o un dígito. Cualquier otro carácter se incluye como
906 parte de la sílaba. Por esta razón, un espacio o salto de línea debe
907 aparecer antes del último símbolo @code{@}} para evitar que se incluya
908 como parte de la sílaba final. De forma similar, se deben insertar
909 espacios antes y después del punto, @q{.}, separando el nombre del
910 contexto del nombre del objeto, pues en caso contrario los dos nombres
911 se juntarán y el intérprete no podrá reconocerlos. Así pues, la
915 \override Lyrics . LyricText #'font-shape = #'italic
918 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
919 final y la llave de cierre.}
921 @warning{En las sobreescrituras con override dentro de la letra,
922 escriba siempre espacios antes y después del punto que separa el
923 nombre del contexto y el nombre del objeto.}
927 Manual de aprendizaje:
928 @ref{Tutorial de Scheme}.
931 @node Tipos de propiedades
932 @subsection Tipos de propiedades
933 @translationof Types of properties
935 @cindex propiedades, tipos de
937 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
938 @code{símbolo}. Para que sea válido, el valor que se da a una
939 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
940 tipo. El tipo de la propiedad se muestra siempre entre paréntesis
941 después del nombre de la propiedad en el RFI. He aquí una lista de
942 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
943 algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
944 @code{#}, por supuesto, delante de estos valores cuando se introducen
945 en la instrucción @code{\override}.
947 @multitable @columnfractions .2 .45 .35
948 @headitem Tipo de propiedad
952 @tab Verdadero o Falso, representado por #t o #f
953 @tab @code{#t}, @code{#f}
954 @item Dimensión (en espacios de pentagrama)
955 @tab Un número decimal positivo (en unidades de espacios de pentagrama)
956 @tab @code{2.5}, @code{0.34}
958 @tab Una constante válida de dirección o su equivalente numérico (se permiten valores decimales entre -1 y 1)
959 @tab @code{LEFT}, @code{CENTER}, @code{UP},
962 @tab Un número entero positivo
963 @tab @code{3}, @code{1}
965 @tab Un conjunto de valores separados por espacios, encerrado entre paréntesis y precedido de un apóstrofo
966 @tab @code{'(left-edge staff-bar)}, @code{'(1)},
967 @code{'(1.0 0.25 0.5)}
969 @tab Cualquier elemento válido de marcado de texto
970 @tab @code{\markup @{ \italic "cresc." @}}
972 @tab Una fracción de redonda construida con la función make-moment
973 @tab @code{(ly:make-moment 1 4)},
974 @code{(ly:make-moment 3 8)}
976 @tab Cualquier valor decimal positivo o negativo
977 @tab @code{3.5}, @code{-2.45}
978 @item Pareja (de números)
979 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
980 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
982 @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
983 @tab @code{'italic}, @code{'inside}
985 @tab Un procedimiento o @code{#f} para no producir ninguna acción
986 @tab @code{bend::print}, @code{ly:text-interface::print},
989 @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofo-almohadilla, @code{'#}.
990 @tab @code{'#(#t #t #f)}
995 Manual de aprendizaje:
996 @ref{Tutorial de Scheme}.
999 @node Apariencia de los objetos
1000 @section Apariencia de los objetos
1001 @translationof Appearance of objects
1003 Ahora vamos a poner en práctica lo que hemos aprendido con unos
1004 cuantos ejemplos que muestran cómo se pueden usar los trucos para
1005 cambiar el aspecto de la música impresa.
1008 * Visibilidad y color de los objetos::
1009 * Tamaño de los objetos::
1010 * Longitud y grosor de los objetos::
1013 @node Visibilidad y color de los objetos
1014 @subsection Visibilidad y color de los objetos
1015 @translationof Visibility and color of objects
1017 Dentro de un uso educativo de la música, podríamos desear imprimir una
1018 partitura con ciertos elementos omitidos como ejercicio para el
1019 alumno, a quien se le pide que los complete. A la manera de ejemplo
1020 sencillo, supongamos que el ejercicio es escribir las líneas
1021 divisorias que faltan en un fragmento musical. Pero las líneas
1022 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
1025 Antes de enredarnos con esto, recordemos que las propiedades de los
1026 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
1027 @ref{Propiedades de los interfaces}). Esto es simplemente agrupar
1028 las propiedades que se pueden usar juntas para trucar un objeto
1029 gráfico: si una de ellas se necesita para un objeto, también las
1030 otras. Así, ciertos objetos usan las propiedades de algunos
1031 interfaces, otros usan las de otros interfaces. Los interfaces que
1032 contienen las propiedades que un determinado grob necesita se
1033 encuentran relacionadas en el manual RFI al final de la página que
1034 describe dicho grob, y esas propiedades se pueden ver mirando dichos
1037 Hemos explicado cómo encontrar información sobre los grobs en
1038 @ref{Propiedades de los objetos de presentación}. Usando el mismo enfoque, vamos al
1039 RFI para buscar el objeto de presentación que imprime las líneas
1040 divisorias. A través del enlace @emph{Backend} y @emph{All layout
1041 objects} encontramos que hay un objeto de presentación llamado
1042 @code{BarLine}. Entre sus propiedades se encuentran dos que controlan
1043 la visibilidad: @code{break-visibility} y @code{stencil}. Las líneas
1044 divisorias también contemplan un número de interfaces, entre ellos el
1045 @code{grob-interface}, donde podemos encontrar las propiedades
1046 @code{transparent} y @code{color}. Todas ellas pueden afectar la
1047 visibilidad de las barras de compás (y, por supuesto, por extensión,
1048 también la de muchos otros objetos de presentación). Vamos a
1049 considerar cada uno de ellos por orden.
1051 @subheading stencil (sello)
1053 @cindex stencil (sello), propiedad
1055 Esta propiedad controla la apariencia de las barras de compás mediante
1056 la especificación del símbolo (o «glifo») que se debe imprimir. Igual
1057 que como otras muchas propiedades, se puede establecer de forma que no
1058 imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
1059 antes, omitiendo el Contexto implícito, @code{Voice}:
1061 @cindex BarLine, ejemplo de sobreescritura
1062 @cindex stencil, propiedad, ejemplo
1064 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1067 \override BarLine #'stencil = ##f
1069 g, a16 b8 c d4 e16 |
1074 Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
1075 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
1076 objeto BarLine. Al principio de la página dice @qq{Barline objects
1077 are created by: Bar_engraver} (los objetos Barline se crean por el
1078 grabador Bar_engraver). Vaya a la página del grabador
1079 @code{Bar_engraver} siguiendo el enlace. Al final da una lista de
1080 contextos en los que el grabador de líneas divisorias opera. Todos
1081 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
1082 @code{\override} no funcionara como esperábamos, es porque
1083 @code{Barline} no se encuentra en el contexto predeterminado
1084 @code{Voice}. Si el contexto no se especifica correctamente, la
1085 instrucción simplemente no funciona. No se produce ningún mensaje de
1086 error, y no se registra nada en el archivo log de registro. Vamos a
1087 intentar corregirlo escribiendo el contexto correcto:
1089 @cindex BarLine, ejemplo de sobreescritura
1090 @cindex stencil, propiedad, ejemplo
1092 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1095 \override Staff.BarLine #'stencil = ##f
1097 g, a16 b8 c d4 e16 |
1102 Ahora las barras de compás han desaparecido.
1104 Sin embargo, observe que el establecimiento de la propiedad
1105 @code{stencil} al valor @code{#f} produce errores cuando las se
1106 requieren las dimensiones del objeto para un procesamiento correcto.
1107 Por ejemplo, se generan errores si la propiedad @code{stencil} del
1108 objeto @code{NoteHead} se establece al valor @code{#f}. Si es el
1109 caso, podemos en vez de ello utilizar la función @code{point-stencil},
1110 que establece el sello a un objeto con tamaño nulo:
1112 @lilypond[quote,verbatim,relative=2]
1115 \once \override NoteHead #'stencil = #point-stencil
1120 @subheading break-visibility (visibilidad en el salto)
1122 @cindex break-visibility, propiedad
1124 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI que
1125 la propiedad @code{break-visibility} requiere un vector de tres
1126 valores booleanos. Controlan respectivamente si las barras de compás
1127 se imprimen al final de una línea, en mitad de una línea, y al
1128 principio de las líneas. Para nuestro ejemplo, queremos que todas las
1129 barras de compás se supriman, por lo que el valor que necesitamos es
1130 @code{'#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
1131 de @code{Staff}. Observe también que al escribir este valor tenemos
1132 @code{#'#} antes del paréntesis de apertura. Se necesita @code{'#}
1133 como parte del valor para introducir un vector, y el primer símbolo de
1134 almohadilla @code{#} se necesita, como siempre, para preceder el valor
1135 en sí dentro de la instrucción @code{\override}.
1137 @cindex BarLine, ejemplo de sobreescritura
1138 @cindex break-visibility, propiedad, ejemplo
1140 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1143 \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
1145 g, a16 b8 c d4 e16 |
1150 Y podemos ver que esto también quita todas las líneas divisorias.
1152 @subheading transparent (transparente)
1154 @cindex transparent, propiedad
1155 @cindex transparencia
1157 En la relación de propiedades que se especifican en la página del
1158 @code{grob-interface} del RFI podemos ver que la propiedad
1159 @code{transparent} es un valor booleano. Esto se debe establecer a
1160 @code{#t} para hacer que el grob sea transparente. En el ejemplo
1161 siguiente vamos a hacer que la indicación de compás, y no las líneas
1162 divisorias, sea transparente. Para hacerlo tenemos que buscar el
1163 nombre del grob de la indicación de compás. Volviendo a la página
1164 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1165 presentación @code{TimeSignature}. Se produce por parte del grabador
1166 @code{Time_signature_engraver} que como puede comprobar vive dentro
1167 del contexto de @code{Staff} y también contempla el interface
1168 @code{grob-interface}. Así pues, la instrucción que hace transparente
1169 a la indicación de compás es:
1171 @cindex TimeSignature, ejemplo de sobreescritura
1172 @cindex transparent, propiedad, ejemplo
1174 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1177 \override Staff.TimeSignature #'transparent = ##t
1179 g, a16 b8 c d4 e16 |
1185 El compás ya no está, pero esta instrucción deja una separación en el
1186 lugar donde antes estaba la indicación de compás. Quizá esto es lo
1187 que queremos para un ejercicio en que el alumno deba escribirlo, pero
1188 en otras circunstancias esta separación podría no ser deseable. En
1189 vez de eso, para quitarla, el stencil o «sello» de la indicación de
1190 compás se debe establecer al valor @code{#f}:
1192 @cindex TimeSignature, ejemplo de sobreescritura
1193 @cindex stencil, propiedad, ejemplo
1195 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1198 \override Staff.TimeSignature #'stencil = ##f
1200 g, a16 b8 c d4 e16 |
1206 y la diferencia es obvia: al establecer el sello al valor @code{#f}
1207 quitamos el objeto por completo; al hacer el objeto @code{transparent}
1208 lo dejamos donde está, pero lo hacemos invisible.
1212 @cindex color, propiedad
1214 Para finalizar, intentemos hacer invisibles las barras de compás
1215 pintándolas de color blanco (hay un problema relacionado, que consiste
1216 en que la línea divisoria blanca puede tapar o no tapar las líneas del
1217 pentagrama a las que cruza. Podrá observar en algunos de los ejemplos
1218 que aparecen a continuación, que esto sucede de forma impredecible.
1219 Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
1220 estudian en @ruser{Pintar los objetos de blanco}; de momento estamos
1221 estudiando el color, por lo que le rogamos que acepte esta limitación
1224 El interface @code{grob-interface} especifica que la propiedad del
1225 color es una lista, pero no hay ninguna explicación sobre lo que debe
1226 ir en esa lista. La lista que requiere es realmente una lista de
1227 valores en unidades internas, pero para evitar tener que saber cuáles
1228 son, se ofrecen varias vías para la especificación de los colores. La
1229 primera forma es utilizar uno de los colores @q{normales} que están
1230 relacionados en la primera tabla de la @ruser{Lista de colores}. Para
1231 poner las líneas divisorias de color blanco, escribimos:
1233 @cindex BarLine, ejemplo de sobreescritura
1234 @cindex color, propiedad, ejemplo
1236 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1239 \override Staff.BarLine #'color = #white
1241 g, a16 b8 c d4 e16 |
1247 y de nuevo podemos comprobar que las barras de compás no son visibles.
1248 Observe que @emph{white} no viene precedido de un apóstrofo: no es un
1249 símbolo, sino una @emph{función}. Cuando se invoca, proporciona la
1250 lista de valores internos que se requieren para establecer el color a
1251 blanco. Los otros colores de la lista normal también son funciones.
1252 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1253 una de las otras funciones de la lista.
1255 @cindex colores de X11
1256 @cindex X11, colores de
1260 La segunda forma de cambiar el color es utilizar la lista de nombres
1261 de colores de X11 que aparecen en la segunda lista de @ruser{Lista de colores}. Sin embargo, éstos deben ir precedidos de otra función, que
1262 convierte los nombres de colores de X11 en la lista de valores
1263 internos, @code{x11-color}, de la siguiente manera:
1265 @cindex BarLine, ejemplo de sobreescritura
1266 @cindex color, propiedad, ejemplo
1268 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1271 \override Staff.BarLine #'color = #(x11-color 'white)
1273 g, a16 b8 c d4 e16 |
1279 Observe que en este caso la función @code{x11-color} toma un símbolo
1280 como argumento, así que el símbolo debe ir precedido de un apóstrofo y
1281 los dos deben ir entre paréntesis.
1283 @cindex rgb, colores
1288 Aún hay una tercera función, que convierte valores RGB en colores
1289 internos: la función @code{rgb-color}. Toma tres argumentos que dan
1290 las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
1291 valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
1292 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1293 @code{(rgb-color 1 1 1)}:
1295 @cindex BarLine, ejemplo de sobreescritura
1296 @cindex color, propiedad, ejemplo
1298 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1301 \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1303 g, a16 b8 c d4 e16 |
1308 Finalmente, existe también una escala de grises como parte del
1309 conjunto de colores de X11. Varían desde el negro, @code{'grey0'},
1310 hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
1311 estableciendo todos los objetos de presentación de nuestro ejemplo a
1312 varias gradaciones de gris:
1314 @cindex StaffSymbol, ejemplo de sobreescritura
1315 @cindex TimeSignature, ejemplo de sobreescritura
1316 @cindex Clef, ejemplo de sobreescritura
1317 @cindex NoteHead, ejemplo de sobreescritura
1318 @cindex Stem, ejemplo de sobreescritura
1319 @cindex BarLine, ejemplo de sobreescritura
1320 @cindex color property, ejemplo
1321 @cindex x11-color, ejemplo de utilización
1323 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1326 \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
1327 \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1328 \override Staff.Clef #'color = #(x11-color 'grey60)
1329 \override Voice.NoteHead #'color = #(x11-color 'grey85)
1330 \override Voice.Stem #'color = #(x11-color 'grey85)
1331 \override Staff.BarLine #'color = #(x11-color 'grey10)
1333 g, a16 b8 c d4 e16 |
1339 Observe los contextos asociados con cada uno de los objetos de
1340 presentación. Es importante que estén correctamente escritos, o las
1341 instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
1342 que se encuentra el grabador correspondiente. El contesto
1343 predeterminado para los grabadores puede encontrarse empezando por el
1344 objeto de presentación, de ahí al grabador que lo produce, y en la
1345 página del grabador del RFI aparece en qué contexto se puede encontrar
1346 normalmente el grabador.
1349 @node Tamaño de los objetos
1350 @subsection Tamaño de los objetos
1351 @translationof Size of objects
1353 @cindex cambiar el tamaño de los objetos
1354 @cindex tamaño de los objetos
1355 @cindex objetos, tamaño de
1356 @cindex objetos, cambiar el tamaño de
1358 Empezaremos examinando de nuevo un ejemplo anterior (véase
1359 @ref{Anidado de expresiones musicales}) que nos mostraba cómo introducir un
1360 pentagrama temporal, como en un @rglos{ossia}.
1362 @cindex alignAboveContext, propiedad, ejemplo
1363 @cindex @code{\with}, ejemplo
1365 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1366 \new Staff ="main" {
1373 alignAboveContext = #"main" }
1381 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1382 por lo normal se imprimen más pequeños que el pentagrama principal.
1383 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1384 el sello de cada uno de ellos a @code{#f}, como sigue:
1386 @cindex alignAboveContext, propiedad, ejemplo
1387 @cindex @code{\with}, ejemplo
1388 @cindex stencil, propiedad, ejemplo
1389 @cindex Clef, ejemplo de sobreescritura
1390 @cindex TimeSignature, ejemplo de sobreescritura
1392 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1393 \new Staff ="main" {
1400 alignAboveContext = #"main"
1403 \override Staff.Clef #'stencil = ##f
1404 \override Staff.TimeSignature #'stencil = ##f
1414 donde el par de llaves adicional después de la cláusula @code{\with}
1415 es necesario para asegurar que la sobreescritura encerrada y la música
1416 se aplican al pentagrama de ossia.
1418 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1419 usando @code{\with} y modificar los sellos de clave y de compás con
1420 \override? La diferencia principal es que los cambios que se realizan
1421 en una cláusula @code{\with} se hacen en el momento en que se crea el
1422 contexto, y permanecen activos como valores @strong{predeterminados}
1423 durante toda la duración de dicho contexto, mientras que las
1424 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1425 música son dinámicas: hacen cambios sincronizados con un punto
1426 concreto de la música. Si los cambios se deshacen o se devuelven
1427 mediante @code{\unset} o @code{\revert} volverán a su valor
1428 predeterminado que será el establecido en la cláusula @code{\with}, o
1429 si no se ha establecido ninguno en este lugar, los valores
1430 predeterminados normales.
1432 Ciertas propiedades de contexto se pueden modificar solamente dentro
1433 de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
1434 cambiar después de que el contexto se ha creado.
1435 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1436 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1437 alineación está decidida y no tendría sentido intentar cambiarla más
1440 Los valores predeterminados de las propiedades de los objetos de
1441 presentación también se pueden establecer dentro de cláusulas
1442 @code{\with}. Simplemente utilice la instrucción @code{\override}
1443 normal dejando aparte el nombre del contexto, ya que está definido sin
1444 ambigüedad como el contexto que la cláusula @code{\with} está
1445 modificando. De hecho, se producirá un error si se especifica un
1446 contexto en este lugar.
1448 Así pues, podemos reemplazar el ejemplo anterior con
1450 @cindex alignAboveContext, propiedad, ejemplo
1451 @cindex @code{\with}, example
1452 @cindex Clef, ejemplo de sobreescritura
1453 @cindex TimeSignature, ejemplo de sobreescritura
1455 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1456 \new Staff ="main" {
1463 alignAboveContext = #"main"
1464 % Don't print clefs in this staff
1465 \override Clef #'stencil = ##f
1466 % Don't print time signatures in this staff
1467 \override TimeSignature #'stencil = ##f
1476 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1479 Ciertos objetos de presentación se crean como glifos sacados de una
1480 fuente tipográfica. Entre ellos se encuentran las cabezas,
1481 alteraciones, elementos de marcado, claves, indicaciones de compás,
1482 indicaciones dinámicas y la letra de las canciones. Su tamaño se
1483 cambia mediante la modificación de la propiedad @code{font-size}, como
1484 veremos en breve. Otros objetos de presentación como ligaduras de
1485 unión y de expresión (en general, objetos de extensión) se trazan
1486 individualmente, por lo que no hay un tamaño de tipografía
1487 @code{font-size} asociado a ellos. Estos objetos generalmente derivan
1488 su tamaño de los objetos a los que están adosados, y por ello
1489 normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
1490 otras propiedades como la longitud de las plicas y las barras de
1491 compás, el grosor de las barras de corchea y otras líneas, y la
1492 separación de las líneas del pentagrama se deben modificar de otras
1495 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1496 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1497 cambiar el tamaño de las tipografías de cada uno de los tipos de
1498 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1501 \override NoteHead #'font-size = #-2
1504 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1505 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1506 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1513 Los dos enunciados producirían una reducción del tamaño de la
1514 tipografía en dos pasos a partir de su valor previo, donde cada paso
1515 reduce o aumenta el tamaño aproximadamente en un 12%.
1517 Vamos a probarlo en nuestro ejemplo del ossia:
1519 @cindex alignAboveContext, propiedad, ejemplo
1520 @cindex @code{\with}, ejemplo
1521 @cindex Clef, ejemplo de sobreescritura
1522 @cindex TimeSignature, ejemplo de sobreescritura
1523 @cindex fontSize, propiedad, ejemplo
1525 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1526 \new Staff ="main" {
1533 alignAboveContext = #"main"
1534 \override Clef #'stencil = ##f
1535 \override TimeSignature #'stencil = ##f
1536 % Reduce all font sizes by ~24%
1546 Aún no está demasiado bien. Las cabezas y los corchetes de las notas
1547 son más pequeños, pero las plicas son demasiado largas en proporción,
1548 y las líneas del pentagrama están demasiado separadas entre sí. Se
1549 debe reducir su escala en proporción a la reducción de la tipografía.
1550 El siguiente apartado trata sobre cómo se hace esto.
1552 @node Longitud y grosor de los objetos
1553 @subsection Longitud y grosor de los objetos
1554 @translationof Length and thickness of objects
1560 @cindex tamaño, cambiar
1561 @cindex plica, cambiar la longitud
1562 @cindex pentagrama, cambiar la separación de las líneas
1564 Las distancias y longitudes en LilyPond se miden generalmente en
1565 espacios de pentagrama, la distancia entre líneas adyacentes de la
1566 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1567 de las propiedades de @code{thickness} (grosor) se miden en unidades
1568 de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
1569 de forma predeterminada, a las líneas de los reguladores se les da un
1570 grosor de 1 unidad de @code{line-thickness}, mientras que el
1571 @code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
1572 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1573 barras de corchea se mide en espacios de pentagrama.
1575 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1576 tamaño de la tipografía? Se puede hacer con la ayuda de una función
1577 especial que se llama @code{magstep}, pensada especialmente para este
1578 propósito. Toma un argumento, el cambio de tamaño de la tipografía
1579 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1580 para reducir otros objetos en la misma proporción. Se usa de la
1583 @cindex alignAboveContext, propiedad, ejemplo
1584 @cindex @code{\with}, ejemplo
1585 @cindex Clef, ejemplo de sobreescritura
1586 @cindex TimeSignature, ejemplo de sobreescritura
1587 @cindex fontSize, propiedad, ejemplo
1588 @cindex StaffSymbol, ejemplo de sobreescritura
1589 @cindex magstep, función, ejemplo de utilización
1590 @cindex staff-space, propiedad, ejemplo
1591 @cindex stencil, propiedad, ejemplo
1593 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1594 \new Staff ="main" {
1601 alignAboveContext = #"main"
1602 \override Clef #'stencil = ##f
1603 \override TimeSignature #'stencil = ##f
1605 % Reduce stem length and line spacing to match
1606 \override StaffSymbol #'staff-space = #(magstep -2)
1616 Puesto que la longitud de las plicas y muchas otras propiedades
1617 relacionadas con la longitudes calculan siempre con relación al valor
1618 de la propiedad @code{staff-space}, su longitud también ve reducida su
1619 escala automáticamente. Observe que esto afecta solamente a la escala
1620 vertical del ossia: la escala horizontal se determina por medio de la
1621 disposición de la música principal con el objeto de mantenerse en
1622 sincronía con ella, de forma que no resulte afectada por ninguno de
1623 estos cambios de tamaño. Por supuesto, si la escala de toda la música
1624 principal se cambiase de esta forma, entonces el espaciado horizontal
1625 se vería afectado. Trataremos de esto más tarde en la sección sobre
1628 Esto, en fin, completa la creación de un ossia. Los tamaños y
1629 longitudes del resto de los objetos se pueden modificar de manera
1632 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1633 grosor de las diversas líneas dibujadas como divisorias, barras de
1634 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1635 ajuste global. Si el grosor de cualquier objeto de presentación en
1636 particular necesita ajustarse, se puede hacer mejor mediante la
1637 sobreescritura de su propiedad @code{thickness}. Anteriormente
1638 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1639 @ref{Propiedades de los objetos de presentación}. El grosor de todos los objetos
1640 trazados (es decir, aquellos que no se producen a partir de una
1641 tipografía) se pueden cambiar de la misma forma.
1644 @node Colocación de los objetos
1645 @section Colocación de los objetos
1646 @translationof Placement of objects
1649 * Comportamiento automático::
1650 * Objetos interiores al pentagrama::
1651 * Objetos fuera del pentagrama::
1655 @node Comportamiento automático
1656 @subsection Comportamiento automático
1657 @translationof Automatic behaviour
1659 @cindex dentro del pentagrama, objetos
1660 @cindex fuera del pentagrama, objetos
1661 @cindex objetos dentro del pentagrama
1662 @cindex objetos fuera del pentagrama
1664 Hay ciertos objetos en notación musical que pertenecen al pentagrama y
1665 otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
1666 objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
1669 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1670 pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
1671 se fijan por la propia música; se posicionan verticalmente sobre
1672 líneas específicas del pentagrama o están unidos a otros objetos
1673 posicionados de esta forma. Las colisiones entre cabezas, plicas y
1674 alteraciones en acordes de notas muy juntas, normalmente se evitan
1675 automáticamente. Hay instrucciones y sobreescrituras que pueden
1676 modificar este comportamiento automático, como veremos en breve.
1678 Entre los objetos que pertenecen al exterior de la pauta se encuentran
1679 cosas como las marcas de ensayo, las marcas de texto y las de
1680 dinámica. La regla de LilyPond para la colocación vertical de los
1681 objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
1682 como sea posible, pero no tan cerca como para que puedan chocar con
1683 algún otro objeto. LilyPond utiliza la propiedad
1684 @code{outside-staff-priority} para determinar el orden en que se deben
1685 situar los objetos, como veremos ahora.
1687 En primer lugar, LilyPond sitúa todos los objetos
1688 dentro-del-pentagrama. Después ordena los objetos
1689 fuera-del-pentagrama de acuerdo con su prioridad
1690 @code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
1691 toman de uno en uno, comenzando por el que tiene la prioridad
1692 @code{outside-staff-priority} más baja, y se sitúan de forma que no
1693 colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
1694 grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
1695 la prioridad @code{outside-staff-priority} más baja se colocará más
1696 cerca del pentagrama. Si dos objetos tienen la misma
1697 @code{outside-staff-priority}, el que se ha encontrado primero se
1698 situará más cerca de la pauta.
1700 En el siguiente ejemplo, todos los textos de marcado tienen la misma
1701 prioridad (pues no se ha establecido explícitamente). Observe que
1702 @q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
1703 acomodado por debajo de @q{Text2}.
1705 @cindex markup, ejemplo
1707 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1714 Los pentagramas también se posicionan, de forma predeterminada, tan
1715 cerca unos de otros como sea posible (sujeto a una separación mínima).
1716 Si las notas se proyectan muy lejos en dirección a un pentagrama
1717 adyacente, forzarán a alejarse a los pentagramas sólo si en caso
1718 contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
1719 siguiente muestra esta acomodación @q{nestling} de las notas sobre
1720 pentagramas adyacentes:
1722 @lilypond[quote,ragged-right,verbatim]
1725 \relative c' { c a, }
1728 \relative c'''' { c a, }
1734 @node Objetos interiores al pentagrama
1735 @subsection Objetos interiores al pentagrama
1736 @translationof Within-staff objects
1738 Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la
1739 dirección de las ligaduras de expresión y de unión, digitaciones y
1740 todo lo demás que dependa de la dirección de las plicas. Cuando se
1741 escribe música polifónica, estas instrucciones son esenciales para que
1742 puedan distinguirse varias líneas melódicas entrelazadas. Pero
1743 ocasionalmente puede ser necesario sobreescribir este comportamiento
1744 automático. Se puede hacer por secciones de música completas o
1745 incluso para una nota individual. La propiedad que controla este
1746 comportamiento es la propiedad de @code{direction} (dirección) de cada
1747 objeto de presentación. En primer lugar explicaremos qué hace esto, y
1748 luego introduciremos algunas instrucciones listas para usar que le
1749 evitarán tener que codificar sobreescrituras explícitas para las
1750 modificaciones más comunes.
1752 Algunos objetos de presentación como las ligaduras se curvan hacia
1753 arriba o hacia abajo; otros como las plicas y los corchetes también se
1754 mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
1755 hacia abajo. Esto se controla automáticamente cuando está establecida
1756 la propiedad @code{direction}.
1767 El ejemplo siguiente muestra en el compás 1 el comportamiento
1768 predeterminado de las plicas, con las de las notas agudas apuntando
1769 hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
1770 todas las plicas forzadas hacia abajo, cuatro notas con las plicas
1771 forzadas hacia arriba, y por último cuatro notas devueltas al
1772 comportamiento predeterminado.
1774 @cindex Stem, ejemplo de sobreescritura
1775 @cindex direction, propiedad, ejemplo
1777 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1779 \override Stem #'direction = #DOWN
1781 \override Stem #'direction = #UP
1783 \revert Stem #'direction
1787 Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
1788 (arriba). Éstos tienen los valores @code{-1} y @code{+1}
1789 respectivamente, y dichos valores numéricos también se pueden usar
1790 directamente. El valor @code{0} también se puede usar en algunos
1791 casos. Se trata simplemente con el significado de @code{UP} para las
1792 plicas, pero para algunos objetos tiene el significado de
1793 @q{centrado}. Existe una constante @code{CENTER} que tiene el valor
1796 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
1797 están disponibles instrucciones predefinidas equivalentes más
1798 sencillas. Aquí podemos ver una tabla de las más comunes. Se
1799 menciona el significado de cada una allí donde no es obvio.
1801 @multitable @columnfractions .2 .2 .25 .35
1802 @headitem Abajo o Izquierda
1803 @tab Arriba o Derecha
1806 @item @code{\arpeggioArrowDown}
1807 @tab @code{\arpeggioArrowUp}
1808 @tab @code{\arpeggioNormal}
1809 @tab La flecha está abajo, arriba o no hay flecha
1810 @item @code{\dotsDown}
1812 @tab @code{\dotsNeutral}
1813 @tab Dirección del desplazamiento para evitar las líneas del pentagrama
1814 @item @code{\dynamicDown}
1815 @tab @code{\dynamicUp}
1816 @tab @code{\dynamicNeutral}
1818 @item @code{\phrasingSlurDown}
1819 @tab @code{\phrasingSlurUp}
1820 @tab @code{\phrasingSlurNeutral}
1821 @tab Nota: diferente de las instrucciones de ligaduras de expresión
1822 @item @code{\slurDown}
1824 @tab @code{\slurNeutral}
1826 @item @code{\stemDown}
1828 @tab @code{\stemNeutral}
1830 @item @code{\textSpannerDown}
1831 @tab @code{\textSpannerUp}
1832 @tab @code{\textSpannerNeutral}
1833 @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
1834 @item @code{\tieDown}
1836 @tab @code{\tieNeutral}
1838 @item @code{\tupletDown}
1839 @tab @code{\tupletUp}
1840 @tab @code{\tupletNeutral}
1841 @tab Los grupos especiales están debajo o encima de las notas
1844 Observe que estas instrucciones predefinidas @strong{no} pueden ir
1845 precedidas de @code{\once}. Si quiere limitar el efecto a una sola
1846 nota, deberá elegir entre usar la instrucción @code{\once \override}
1847 equivalente, o usar la instrucción predefinida, seguida después de la
1848 nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
1850 @subheading Digitaciones
1852 @cindex digitación, colocación
1853 @cindex digitación de acordes
1855 La colocación de las digitaciones sobre notas sueltas también se puede
1856 controlar mediante la propiedad @code{direction}, pero los cambios
1857 sobre @code{direction} no tienen ningún efecto sobre las notas de los
1858 acordes. Como veremos, existen instrucciones especiales que permiten
1859 controlar las digitaciones de notas individuales, situando la
1860 digitación encima, debajo, a la izquierda o a la derecha de cada nota.
1862 En primer lugar, he aquí el efecto de @code{direction} sobre las
1863 digitaciones aplicadas a notas sueltas. Se muestra en el primer
1864 compás el comportamiento predeterminado, y en los dos compases
1865 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
1867 @cindex Fingering, ejemplo de sobreescritura
1868 @cindex direction, propiedad, ejemplo
1870 @lilypond[quote,verbatim,relative=2]
1872 \override Fingering #'direction = #DOWN
1874 \override Fingering #'direction = #UP
1878 Sin embargo, la sobreescritura de la propiedad @code{direction} no es
1879 la forma más sencilla de especificar manualmente la digitación por
1880 encima o por debajo de las notas; suele ser preferible usar @code{_} o
1881 @code{^} en lugar de @code{-}, antes del número de la digitación.
1882 Este es el ejemplo anterior utilizando este método:
1884 @cindex fingering, ejemplo
1885 @cindex digitación, ejemplo
1887 @lilypond[quote,verbatim,relative=2]
1893 La propiedad @code{direction} se ignora para los acordes, pero los
1894 prefijos direccionales @code{_} y @code{^} sí funcionan. De forma
1895 predeterminada, las digitaciones se colocan automáticamente encima y
1896 debajo de las notas de un acorde, como se muestra aquí:
1898 @cindex fingering, ejemplo
1899 @cindex digitación, ejemplo
1901 @lilypond[quote,verbatim,relative=2]
1908 pero se puede forzar de manera que todos o algunos de los números de
1909 digitación estén por encima o por debajo:
1911 @cindex fingering, ejemplo
1912 @cindex digitación, ejemplo
1914 @lilypond[quote,verbatim,relative=2]
1920 Es posible ejercer un control aún mayor sobre la colocación de las
1921 digitaciones mediante la utilización de la instrucción @code{\set
1922 fingeringOrientations}. El formato de esta instrucción es:
1925 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
1929 se utiliza @code{\set} porque @code{fingeringOrientations} es una
1930 propiedad del contexto @code{Voice}, creado y usado por el grabador
1931 @code{New_fingering_engraver}.
1933 La propiedad se puede establecer al valor de una lista de entre uno y
1934 tres valores. Controla si las digitaciones se pueden colocar por
1935 encima (si @code{up} aparece en la lista), por debajo (si aparece
1936 @code{down}), a la izquierda (si aparece @code{left}) o a la derecha
1937 (si aparece @code{right}). A la inversa, si una colocación no está en
1938 la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
1939 coma estas restricciones y se trabaja la mejor colocación para la
1940 digitación de las notas de los acordes que siguen. Observe que
1941 @code{left} y @code{right} son mutuamente excluyentes: las
1942 digitaciones pueden situarse en un lado o en el otro, no en los dos.
1944 @warning{Para controlar la colocación de la digitación de una sola
1945 nota usando esta instrucción es necesario escribirla como un acorde de
1946 una sola nota encerrándola entre ángulos simples.}
1948 Aquí podemos ver algunos ejemplos:
1950 @cindex fingering, ejemplo
1951 @cindex digitación, ejemplo
1952 @cindex @code{\set}, ejemplo de utilización
1953 @cindex fingeringOrientations, propiedad, ejemplo
1955 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1956 \set fingeringOrientations = #'(left)
1958 < c-1 e-2 g-3 b-5 > 4
1959 \set fingeringOrientations = #'(left)
1961 < c-1 e-2 g-3 b-5 > 4
1962 \set fingeringOrientations = #'(up left down)
1964 < c-1 e-2 g-3 b-5 > 4
1965 \set fingeringOrientations = #'(up left)
1967 < c-1 e-2 g-3 b-5 > 4
1968 \set fingeringOrientations = #'(right)
1970 < c-1 e-2 g-3 b-5 > 4
1974 Si la digitación parece un poco superpoblada, se puede reducir el
1975 tamaño @code{font-size}. El valor predeterminado puede verse en el
1976 objeto @code{Fingering} del RFI que es @code{-5}, así que probaremos
1979 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1980 \override Fingering #'font-size = #-7
1981 \set fingeringOrientations = #'(left)
1983 < c-1 e-2 g-3 b-5 > 4
1984 \set fingeringOrientations = #'(left)
1986 < c-1 e-2 g-3 b-5 > 4
1987 \set fingeringOrientations = #'(up left down)
1989 < c-1 e-2 g-3 b-5 > 4
1990 \set fingeringOrientations = #'(up left)
1992 < c-1 e-2 g-3 b-5 > 4
1993 \set fingeringOrientations = #'(right)
1995 < c-1 e-2 g-3 b-5 > 4
1999 @node Objetos fuera del pentagrama
2000 @subsection Objetos fuera del pentagrama
2001 @translationof Outside-staff objects
2003 Los objetos fuera-del-pentagrama se colocan automáticamente para
2004 evitar las colisiones. Los objetos que tienen el valor más bajo de la
2005 propiedad @code{outside-staff-priority} se sitúan más cerca del
2006 pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
2007 tanto como sea necesario para evitar la colisión. La prioridad
2008 @code{outside-staff-priority} se defina en el @code{grob-interface} y
2009 así es una propiedad de todos los objetos de presentación. De forma
2010 predeterminada se establece a @code{#f} para todos los objetos
2011 dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
2012 fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
2013 presenta los valores numéricos predeterminados para algunos de los
2014 objetos fuera-del-pentagrama que están inicialmente dentro de los
2015 contextos @code{Staff} o @code{Voice}.
2017 @multitable @columnfractions .3 .3 .3
2018 @headitem Objeto de presentación
2020 @tab Controla la posición de:
2021 @item @code{MultiMeasureRestText}
2023 @tab Texto sobre silencios de compás completo
2024 @item @code{TextScript}
2026 @tab Elementos de marcado de texto
2027 @item @code{OttavaBracket}
2029 @tab Corchetes de octava alta y baja
2030 @item @code{TextSpanner}
2032 @tab Objetos de extensión de texto
2033 @item @code{DynamicLineSpanner}
2035 @tab Todas las indicaciones dinámicas
2036 @item @code{VoltaBracketSpanner}
2038 @tab Corchetes de primera y segunda vez
2039 @item @code{TrillSpanner}
2041 @tab Trinos mantenidos
2044 He aquí un ejemplo que muestra la situación predeterminada de algunos
2047 @cindex texto, extensiones de
2048 @cindex octava alta y baja, corchete de
2050 @funindex \startTextSpan
2051 @funindex startTextSpan
2052 @funindex \stopTextSpan
2053 @funindex stopTextSpan
2055 @cindex TextSpanner, ejemplo de sobreescritura
2056 @cindex bound-details, propiedad, ejemplo
2058 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2059 % Set details for later Text Spanner
2060 \override TextSpanner #'(bound-details left text)
2061 = \markup { \small \bold Slower }
2062 % Place dynamics above staff
2064 % Start Ottava Bracket
2069 % Add Dynamic Line Spanner
2075 c\ff c \stopTextSpan
2076 % Stop Ottava Bracket
2081 Este ejemplo también muestra cómo crear textos con extensión (Text
2082 Spanners): textos con líneas extensoras por encima de una sección de
2083 música. El extensor abarca desde la instrucción @code{\startTextSpan}
2084 hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
2085 define por medio de la instrucción @code{\override TextSpanner}. Para
2086 ver más detalles, consulte @ruser{Extensiones de texto}.
2088 También muestra la manera de crear corchetes de octava alta y baja.
2090 @cindex trucar la situación de los números de compás
2091 @cindex números de compás, ajustar posición
2092 @cindex trucar la situación de marcas metronómicas
2093 @cindex metrónomo, situación de las indicaciones de
2094 @cindex trucar la situación de las letras de ensayo
2095 @cindex ensayo, letras, trucar la colocación
2097 Observe que los números de compás, las indicaciones metronómicas y las
2098 mercas de ensayo no se muestran. De forma predeterminada, se crean
2099 dentro del contexto @code{Score} y su prioridad
2100 @code{outside-staff-priority} se ignora con relación a los objetos de
2101 presentación que se crean dentro del contexto @code{Staff}. Si quiere
2102 colocar los números de compás, indicaciones metronómicas o llamadas de
2103 ensayo en concordancia con el valor de su
2104 @code{outside-staff-priority}, los grabadores
2105 @code{Bar_number_engraver}, @code{Metronome_mark_engraver} o
2106 @code{Mark_engraver} respectivamente se deben eliminar del contexto
2107 @code{Score} y colocarlos en el contexto @code{Staff} del nivel
2108 superior. Si se hace así, estas marcas obtendrán los siguientes
2109 valores predeterminados de @code{outside-staff-priority}:
2111 @multitable @columnfractions .3 .3
2112 @headitem Objeto de presentación @tab Prioridad
2113 @item @code{RehearsalMark} @tab @code{1500}
2114 @item @code{MetronomeMark} @tab @code{1000}
2115 @item @code{BarNumber} @tab @code{ 100}
2118 Si los valores predeterminados de @code{outside-staff-priority} no le
2119 ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
2120 de cualquiera de los objetos. Suponga que quisiéramos que el corchete
2121 de octava estuviera situado por debajo del elemento extensor de texto
2122 en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
2123 prioridad de @code{OttavaBracket} en el RFI o en las tablas
2124 anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
2125 recordando que @code{OttavaBracket} se crea dentro del contexto de
2128 @cindex TextSpanner, ejemplo de sobreescritura
2129 @cindex bound-details, propiedad, ejemplo
2131 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2132 % Set details for later Text Spanner
2133 \override TextSpanner #'(bound-details left text)
2134 = \markup { \small \bold Slower }
2135 % Place dynamics above staff
2137 %Place following Ottava Bracket below Text Spanners
2138 \once \override Staff.OttavaBracket #'outside-staff-priority = #340
2139 % Start Ottava Bracket
2144 % Add Dynamic Line Spanner
2150 c\ff c \stopTextSpan
2151 % Stop Ottava Bracket
2156 @cindex ligaduras y outside-staff-priority
2157 @cindex ligaduras y articulaciones
2158 @cindex articulaciones y ligaduras
2160 De forma predeterminada, las ligaduras de expresión están clasificadas
2161 como objetos dentro-del-pentagrama, pero con frecuencia aparecen
2162 encima del pentagrama si las notas que une son muy agudas. Ello puede
2163 empujar a una posición muy elevada a los objetos fuera-del-pentagrama
2164 como las articulaciones, pues la ligadura se colocará en primer lugar.
2165 La propiedad @code{avoid-slur} de la articulación se puede establecer
2166 al valor @code{'inside} (por dentro) para llevarla al interior de la
2167 ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si
2168 la prioridad @code{outside-staff-priority} está también ajustada al
2169 valor @code{#f}. De forma alternativa, la prioridad
2170 @code{outside-staff-priority} de la ligadura se puede fijar en un
2171 valor numérico para hacer que se sitúe en línea con otros objetos
2172 fuera del pentagrama de acuerdo con este valor. He aquí un ejemplo
2173 que muestra el efecto de los dos métodos:
2175 @lilypond[quote,verbatim,relative=2]
2176 c4( c^\markup\tiny\sharp d4.) c8
2178 \once \override TextScript #'avoid-slur = #'inside
2179 \once \override TextScript #'outside-staff-priority = ##f
2180 c^\markup\tiny\sharp d4.) c8
2181 \once \override Slur #'outside-staff-priority = #500
2182 c4( c^\markup\tiny\sharp d4.) c8
2185 Los cambios en @code{outside-staff-priority} también se pueden emplear
2186 para controlar la situación vertical de los objetos individuales,
2187 aunque los resultados pueden no siempre ser deseables. Suponga que
2188 quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
2189 bajo el epígrafe Comportamiento Automático de más arriba (véase
2190 @ref{Comportamiento automático}). Todo lo que debemos hacer es localizar la
2191 prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
2192 aumentar la prioridad de @qq{Text3} hasta un valor superior:
2194 @cindex TextScript, ejemplo de sobreescritura
2195 @cindex outside-staff-priority, propiedad, ejemplo
2197 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2200 \once \override TextScript #'outside-staff-priority = #500
2205 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
2206 también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
2207 desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
2208 realmente queremos hacer es posicionar todas las anotaciones a la
2209 misma distancia por encima del pentagrama? Para hacerlo, vamos a
2210 necesitar claramente espaciar las notas en sentido horizontal para
2211 hacer sitio para el texto. Esto se hace empleando la instrucción
2212 @code{textLengthOn}.
2214 @subheading \textLengthOn
2216 @cindex notas, espaciar junto al texto
2218 @funindex \textLengthOn
2219 @funindex textLengthOn
2220 @funindex \textLengthOff
2221 @funindex textLengthOff
2223 De forma predeterminada, el texto producido mediante marcado no ocupa
2224 ningún espacio horizontal en cuanto se refiere a la disposición de la
2225 música. La instrucción @code{\textLengthOn} invierte este
2226 comportamiento, ocasionando que las notas resulten tan espaciadas como
2227 sea necesario para acomodar el texto:
2229 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2230 \textLengthOn % Cause notes to space out to accommodate text
2237 La instrucción para volver al comportamiento predeterminado es
2238 @code{\textLengthOff}. Recuerde que @code{\once} funciona solamente
2239 con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
2240 que no se puede usar con @code{\textLengthOn}.
2242 @cindex marcado, texto de, permitir las colisiones en
2244 El texto de marcado también evita las notas que se proyectan por
2245 encima del pentagrama. Si esto no es lo que deseamos, el
2246 desplazamiento automático hacia arriba se puede desactivar mediante el
2247 establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
2248 muestra cómo el texto de marcado interactúa con tales notas.
2250 @cindex TextScript, ejemplo de sobreescritura
2251 @cindex outside-staff-priority, propiedad, ejemplo
2253 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2254 % This markup is short enough to fit without collision
2258 % This is too long to fit, so it is displaced upwards
2262 % Turn off collision avoidance
2263 \once \override TextScript #'outside-staff-priority = ##f
2267 % Turn off collision avoidance
2268 \once \override TextScript #'outside-staff-priority = ##f
2269 \textLengthOn % and turn on textLengthOn
2270 c,,2^"Long Text " % Spaces at end are honored
2275 @subheading Matices dinámicos
2277 @cindex trucar la colocación de los matices
2278 @cindex dinámica, trucar la colocación de las indicaciones de
2279 @cindex matices, trucar la colocación
2281 Las indicaciones de matiz dinámico normalmente se colocarán por debajo
2282 del pentagrama, pero se pueden posicionar por encima con la
2283 instrucción @code{dynamicUp}. Se situarán verticalmente respecto a la
2284 nota a la que van adosadas, y flotarán por debajo (o por encima) de
2285 todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
2286 y números de compás. Esto puede ofrecer resultados bastante
2287 aceptables, como muestra este ejemplo:
2289 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2294 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2295 ees,2.~\)\mf ees4 r8 |
2298 Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
2299 muy cerca, la colocación automática evitará las colisiones desplazando
2300 las marcas dinámicas posteriores más lejos, aunque este puede no ser
2301 el lugar óptimo, como muestra el siguiente ejemplo más bien
2304 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2310 Si se presentara una situación similar en música @q{real}, podría ser
2311 preferible espaciar las notas un poco más entre sí, de forma que todas
2312 las marcas dinámicas puedan caber a la misma distancia vertical desde
2313 el pentagrama. Hemos sido capaces de hacer esto para el texto de
2314 marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
2315 una instrucción equivalente para las indicaciones de matiz dinámico.
2316 Por tanto, tendremos que averiguar cómo hacerlo utilizando
2317 instrucciones @code{\override}.
2319 @subheading Escalado de un «Grob»
2321 @cindex grob, cambio de tamaño de un
2322 @cindex escala de los grobs
2324 En primer lugar debemos aprender cómo se especifica el tamaño de los
2325 grobs. Todos los grobs tienen un punto de referencia definido dentro
2326 de ellos que se usa para colocarlos respecto a su objeto padre.
2327 Entonces, este punto del grob se posiciona a una distancia horizontal,
2328 @code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
2329 de su padre. La dimensión horizontal del objeto viene dada por una
2330 pareja de números, @code{X-extent}, que dice dónde están los límites
2331 izquierdo y derecho respecto del punto de referencia. La amplitud
2332 vertical se define de forma similar mediante una pareja de números,
2333 @code{Y-extent}. Éstas son propiedades de todos los grobs que
2334 contemplan el @code{grob-interface}.
2336 @cindex @code{extra-spacing-width}
2338 De forma predeterminada, los objetos fuera-del-pentagrama reciben una
2339 anchura cero, de manera que pueden solaparse en la dirección
2340 horizontal. Esto se hace mediante el truco de añadir una cantidad
2341 infinita a la dimensión más a la izquierda y menos infinito a la
2342 dimensión más a la derecha estableciendo el valor de
2343 @code{extra-spacing-width} a @code{'(+inf.0 . -inf.0)}. Así, para
2344 asegurar que no se superponen en la dirección horizontal tendremos que
2345 sobreescribir este valor de @code{extra-spacing-width} a @code{'(0
2346 . 0)} de forma que el verdadero ancho se presente. Esta es la
2347 instrucción que lo hace para las indicaciones dinámicas:
2350 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2354 Veamos si funciona en nuestro ejemplo anterior:
2356 @cindex DynamicText, ejemplo de sobreescritura
2357 @cindex extra-spacing-width, propiedad, ejemplo
2359 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2361 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2366 Bueno, ciertamente ha hecho que las marcas dinámicas ya no estén
2367 desplazadas, pero aún quedan dos problemas. Las marcas tendrían que
2368 separarse un poco más entre sí, y sería mejor si todas estuvieran a la
2369 misma distancia del pentagrama. Podemos resolver el primer problema
2370 fácilmente. En vez de hacer cero la anchura
2371 @code{extra-spacing-width}, podemos añadirle algo más. Las unidades
2372 son el espacio entre dos líneas de pentagrama, así que al mover el
2373 límite izquierdo media unidad a la izquierda y el límite derecho media
2374 unidad hacia la derecha, deberíamos conseguirlo:
2376 @cindex DynamicText, ejemplo de sobreescritura
2377 @cindex extra-spacing-width, propiedad, ejemplo
2379 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2381 % Extend width by 1 staff space
2382 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2387 Esto tiene un mejor aspecto, pero quizá habríamos preferido que las
2388 indicaciones de dinámica estuvieran alineadas sobre la misma línea de
2389 base en lugar de ir hacia arriba y hacia abajo con las notas. La
2390 propiedad que lo hace es @code{staff-padding} (relleno de pentagrama)
2391 que se estudia en la sección siguiente.
2394 @node Colisiones de objetos
2395 @section Colisiones de objetos
2396 @translationof Collisions of objects
2400 * Arreglar notación con superposiciones::
2401 * Ejemplos reales de música::
2405 @subsection Mover objetos
2406 @translationof Moving objects
2408 @cindex mover objetos superpuestos
2409 @cindex mover objetos que colisionan
2410 @cindex mover grobs que colisionan
2411 @cindex objetos que colisionan, mover
2412 @cindex grobs que colisionan, mover
2414 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
2415 de notación se pueden superponer, lo que es una lástima, pero en
2416 realidad es bastante poco frecuente. Normalmente la necesidad de
2417 mover objetos es por claridad o razones estéticas: el aspecto es mejor
2418 con un poco más o un poco menos de espacio de separación.
2420 Existen tres enfoques principales que llevan a la resolución de
2421 superposiciones en la notación. Se deben considerar en el siguiente
2426 La @strong{dirección} de uno de los objetos que se superponen se puede
2427 cambiar usando las instrucciones predefinidas que están relacionadas
2428 arriba para los objetos dentro-del-pentagrama (véase @ref{Objetos interiores al pentagrama}). Se pueden recolocar fácilmente las plicas, ligaduras de
2429 expresión y de unión, barras de corchea, indicaciones dinámicas, texto
2430 y grupos de valoración especial de esta forma. La limitación es que
2431 sólo tiene la posibilidad de elegir entre dos posiciones, y podría ser
2432 que ninguna de ellas sea la adecuada.
2435 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2436 colocando los objetos de presentación, se pueden modificar usando la
2437 instrucción de sobreescritura @code{\override}. Las ventadas de hacer
2438 cambios a este tipo de propiedad son: a) que algún otro objeto se
2439 moverá automáticamente si es necesario, para dejarle sitio, y b) una
2440 única sobreescritura se puede aplicar a todas las instancias del mismo
2441 tipo de objeto. Entre tales propiedades se encuentran:
2446 @code{direction} (dirección)
2448 Ya se ha estudiado con cierto detalle: véase @ref{Objetos interiores al pentagrama}.
2451 @code{padding} (relleno), @code{left-padding} (relleno por la
2452 izquierda), @code{right-padding} (relleno por la derecha),
2453 @code{staff-padding} (relleno de pentagrama)
2456 @cindex left-padding, propiedad
2457 @cindex padding, propiedad
2458 @cindex right-padding, propiedad
2459 @cindex staff-padding, propiedad
2461 Según un objeto se está colocando, el valor de su propiedad de relleno
2462 @code{padding} especifica el espacio intermedio que se debe dejar
2463 entre él mismo y el límite más próximo del objeto contra el que se
2464 está colocando. Observe que es el valor de @code{padding} del objeto
2465 @strong{que se está colocando} el que se usa; el valor de
2466 @code{padding} del objeto que ya está colocado se ignora. Los
2467 espacios intermedios especificados mediante @code{padding} se pueden
2468 aplicar a todos los objetos que contemplan el interface
2469 @code{side-position-interface}.
2471 En lugar de con @code{padding}, la colocación de los grupos de
2472 alteraciones se controla con @code{left-padding} y
2473 @code{right-padding}. Estas propiedades se encontrarán en el objeto
2474 @code{AccidentalPlacement} que, observe, vive dentro del contexto de
2475 @strong{staff}. Durante el proceso tipográfico, las cabezas de las
2476 notas se componen tipográficamente en primer lugar, y después las
2477 alteraciones, si existen, se añaden a la izquierda de las cabezas
2478 utilizando la propiedad de relleno por la derecha @code{right-padding}
2479 para determinar la separación entre la alteración y la cabeza. así
2480 pues, sólo la propiedad de relleno por la derecha @code{right-padding}
2481 del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
2482 de las alteraciones.
2484 La propiedad @code{staff-padding} está estrechamente relacionada con
2485 la propiedad @code{padding}: @code{padding} controla la separación
2486 mínima entre cualquier objeto que contemple el interface
2487 @code{side-position-interface} y el objeto más cercano (generalmente
2488 la nota o las líneas del pentagrama); @code{staff-padding} se aplica
2489 sólo a los objetos que siempre se sitúan fuera del pentagrama:
2490 controla la separación mínima entre dicho objeto y el pentagrama.
2491 Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
2492 que se posicionan respecto a la nota en vez de hacerlo respecto al
2493 pentagrama, incluso aunque puede ser sobreescrito sin error por tales
2494 objetos: simplemente se ignora.
2496 Para descubrir qué propiedad de relleno se necesita para el objeto que
2497 quiere recolocar, debe volver al manual de RFI y buscar las
2498 propiedades del objeto. Tenga cuidado porque las propiedades de
2499 relleno podrían no estar en el objeto más obvio, así que busque en los
2500 objetos que puedan tener alguna relación con él.
2502 Todos los valores de relleno se miden en espacios del pentagrama.
2503 Para la mayor parte de los objetos el valor se establece de forma
2504 predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
2505 Se puede sobreescribir si se necesita una separación intermedia mayor
2509 @code{self-alignment-X} (Auto-alineamiento en el eje X)
2511 @cindex self-alignment-X, propiedad
2513 Esta propiedad se puede usar para alinear el objeto a la izquierda, a
2514 la derecha, o centrarlo con respecto al punto de referencia del objeto
2515 «padre». Se puede usar con todos los objetos que contemplan el
2517 @code{self-alignment-interface}. En general son objetos que contienen
2518 texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
2519 forma alternativa se puede especificar un valor numérico entre
2520 @code{-1} y @code{+1}, donde @code{-1} es alineado por la izquierda,
2521 @code{+1} es alineado por la derecha, y los números intermedios mueven
2522 el texto progresivamente desde alineado por la izquierda hasta alineado
2523 por la derecha. Se pueden especificar valores numéricos mayores de
2524 @code{1} para mover el texto incluso más lejos hacia la izquierda, o
2525 menos de @code{-1} para alejarlo más hacia la derecha. Un cambio en
2526 @code{1} en el valor corresponde a un movimiento de la mitad de la
2527 longitud total del propio texto.
2530 @code{extra-spacing-width} (anchura de separación adicional)
2532 @cindex extra-spacing-width, propiedad
2534 Esta propiedad está disponible para todos los objetos que contemplan
2535 el interface @code{item-interface}. Toma dos números, el primero se
2536 suma al límite izquierdo y el segundo se suma al límite derecho. Los
2537 números negativos desplazan el límite a la izquierda y los positivos a
2538 la derecha, por lo que para ensanchar un objeto el primer número debe
2539 ser negativo y el segundo positivo. Observe que no todos los objetos
2540 ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
2541 (alteración) sólo toma nota del primer número (el borde izquierdo).
2544 @code{staff-position} (posición de pentagrama)
2546 @cindex staff-position, propiedad
2548 @code{staff-position} es una propiedad del interface
2549 @code{staff-symbol-referencer-interface}, que está contemplado por los
2550 objetos que se colocan con relación al pentagrama. Especifica la
2551 posición vertical del objeto con relación a la tercera línea del
2552 pentagrama en medios espacios de pentagrama. Es útil en la
2553 resolución de colisiones entre objetos de presentación como silencios
2554 multi-compás, ligaduras de unión y notas en distintas voces.
2557 @code{force-hshift} (forzar desplazamiento horizontal)
2559 @cindex force-hshift, propiedad
2561 Las notas muy juntas de un acorde, o aquellas que ocurren al mismo
2562 tiempo en voces distintas, se disponen en dos (y ocasionalmente más)
2563 columnas para evitar la superposición de las cabezas. Éstas reciben
2564 el nombre de columnas de notas, y se crea un objeto llamado
2565 @code{NoteColumn} para disponer las notas en dicha columna.
2567 La propiedad @code{force-hshift} es una propiedad de una
2568 @code{NoteColumn} (realmente lo es del interface
2569 @code{note-column-interface}). Modificarlo permite mover una columna
2570 de notas en unidades adecuadas a una columna de notas, por ejemplo la
2571 anchura de la cabeza de la nota de la primera voz. Se debe usar en
2572 situaciones complejas donde las instrucciones @code{\shiftOn} normales
2573 (véase @ref{Voces explícitas}) no resuelven el
2574 conflicto entre las notas. Es preferible a la propiedad
2575 @code{extra-offset} para este propósito porque no hay necesidad de
2576 averiguar la distancia en espacios de pentagrama, y mover las notas
2577 dentro o fuera de una @code{NoteColumn} afecta a otras acciones como a
2578 la fusión entre cabezas de nota.
2583 Finalmente, cuando todo lo demás falla, los objetos se pueden
2584 reposicionar manualmente con relación a la tercera línea del
2585 pentagrama verticalmente, o desplazándolas una cierta distancia a una
2586 nueva posición. Las desventajas son que los valores correctos para el
2587 reposicionamiento se deben adivinar, a menudo por ensayo y error, para
2588 cada objeto individual y, puesto que el movimiento se hace después de
2589 que LilyPond ha colocado todos los demás objetos es usuario es
2590 responsable de evitar cualquier colisión que pudiera producirse. Pero
2591 la dificultar principal con este enfoque es que los valores de
2592 reposicionado podrían tener que ser vueltos a calcular si la música se
2593 modifica más tarde. Las propiedades que se pueden usar para este tipo
2594 de posicionamiento manual son:
2597 @item extra-offset (desplazamiento adicional)
2599 @cindex extra-offset, propiedad
2601 Esta propiedad se aplica a cualquier objeto de presentación que
2602 contemple el @code{grob-interface}. Toma una pareja de números que
2603 especifican el desplazamiento adicional en las direcciones horizontal
2604 y vertical. Los números negativos mueven el objeto a la izquierda o
2605 hacia abajo. Las unidades son espacios de pentagrama. El
2606 desplazamiento adicional se hace después de que la composición
2607 tipográfica de los objetos ha terminado, así que un objeto puede ser
2608 reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
2610 @item positions (posiciones)
2612 @cindex positions, propiedad
2614 Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
2615 la altura de las barras de corchea, ligaduras de expresión y corchetes
2616 de grupos de valoración especial. Toma una pareja de números que dan
2617 la posición de los extremos izquierdo y derecho de la barra, ligadura,
2618 etc. con relación a la tercera línea del pentagrama. Las unidades son
2619 espacios de pentagrama. Observe, sin embargo, que las ligaduras de
2620 expresión y de fraseo no se pueden reposicionar en cantidades
2621 arbitrariamente grandes. LilyPond en primer lugar genera una lista de
2622 posiciones posibles para la ligadura y de forma predeterminada
2623 encuentra la ligadura que tiene @qq{mejor aspecto}. Si la propiedad
2624 @code{positions} se ha sobreescrito, la ligadura que está más cerca de
2625 las posiciones que se han solicitado, se selecciona de la lista.
2630 Un objeto en particular podría no tener todas estas propiedades. Es
2631 necesario ir al manual RFI para buscar qué propiedades se encuentran
2632 disponibles para el objeto en cuestión.
2635 Aquí presentamos una lista de los objetos que es más probable que
2636 estén implicados en colisiones, con el nombre del objeto que habría
2637 que buscar en el RFI para descubrir qué propiedades se deben usar para
2640 @multitable @columnfractions .5 .5
2641 @headitem Tipo de objeto @tab Nombre del objeto
2642 @item Articulaciones @tab @code{Script}
2643 @item Barras @tab @code{Beam}
2644 @item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
2645 @item Dinámica (horizontalmente) @tab @code{DynamicText}
2646 @item Digitaciones @tab @code{Fingering}
2647 @item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
2648 @item Ligaduras de expresión @tab @code{Slur}
2649 @item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
2650 @item Ligaduras de unión @tab @code{Tie}
2651 @item Grupos de valoración especial @tab @code{TupletBracket}
2655 @node Arreglar notación con superposiciones
2656 @subsection Arreglar notación con superposiciones
2657 @translationof Fixing overlapping notation
2659 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
2660 en la sección anterior, para resolver problemas de notación que se
2663 @subheading la propiedad padding (relleno)
2666 @cindex arreglar notación que se superpone
2667 @cindex superpuesta, notación
2669 La propiedad @code{padding} se puede ajustar para aumentar (o
2670 disminuir) la distancia entre símbolos impresos encima o debajo de las
2673 @cindex Script, ejemplo de sobreescritura
2674 @cindex padding, propiedad, ejemplo
2676 @lilypond[quote,fragment,relative=1,verbatim]
2678 \override Script #'padding = #3
2682 @cindex MetronomeMark, ejemplo de sobreescritura
2683 @cindex padding, propiedad, ejemplo
2685 @lilypond[quote,fragment,relative=1,verbatim]
2686 % This will not work, see below:
2687 \override MetronomeMark #'padding = #3
2691 \override Score.MetronomeMark #'padding = #3
2696 Observe en el segundo ejemplo la gran importancia que tiene saber qué
2697 contexto maneja un determinado objeto. Puesto que el objeto
2698 @code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
2699 cambios de propiedades en el contexto @code{Voice} pasarán
2700 inadvertidos. Para ver más detalles, consulte @ruser{Modificar las propiedades}.
2702 Si la propiedad de relleno @code{padding} de un objeto se incrementa
2703 cuando dicho objeto se encuentra en una pila de objetos que se están
2704 colocando de acuerdo a su prioridad @code{outside-staff-priority},
2705 entonces ese objeto se moverá, y también todos los que están por fuera
2709 @subheading left-padding y right-padding (relleno por la izquierda y por la derecha)
2711 @cindex left-padding, propiedad
2712 @cindex right-padding, propiedad
2714 La propiedad @code{right-padding} afecta al espaciado entre la
2715 alteración y la nota a que se aplica. Normalmente no es necesaria,
2716 pero el ejemplo siguiente muestra una situación en la que sí se
2717 necesita. Suponga que queremos presentar un acorde que contiene un Si
2718 natural y un Si bemol. Para evitar la ambigüedad querríamos preceder
2719 las notas con un becuadro y un bemol. Aquí vienen varios intentos de
2722 @cindex Accidental, ejemplo de sobreescritura
2723 @cindex text, propiedad, ejemplo
2724 @cindex stencil, propiedad, ejemplo
2725 @cindex AccidentalPlacement, ejemplo de sobreescritura
2726 @cindex right-padding, propiedad, ejemplo
2728 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2734 Ninguno de ellos funciona y el segundo además presenta una fea
2735 colisión entre las dos alteraciones.
2737 Una forma de conseguirlo es sobreescribir el sello de la alteración
2738 con un elemento de marcado que contenga los símbolos de becuadro y
2739 bemol en el orden que nos gustaría que estuvieran, así:
2741 @lilypond[quote,ragged-right,verbatim]
2742 naturalplusflat = \markup { \natural \flat }
2744 \once \override Accidental
2745 #'stencil = #ly:text-interface::print
2746 \once \override Accidental #'text = #naturalplusflat
2747 \once \override Score.AccidentalPlacement #'right-padding = #1.5
2753 Esto utiliza necesariamente una sobreescritura para el sello de la
2754 alteración que no se estudiará hasta más adelante. El tipo de sello
2755 debe ser un procedimiento, aquí modificado para que imprima el
2756 contenido de la propiedad @code{text} del objeto @code{Accidental},
2757 que a su vez está establecido como un signo de becuadro seguido de un
2758 bemol. Entonces el conjunto se puede separar de la cabeza de la nota
2759 sobreescribiendo @code{right-padding}.
2763 @subheading la propiedad staff-padding (relleno de pentagrama)
2765 @cindex alineación de objetos sobre la línea base
2766 @cindex objetos, alineación sobre la línea base
2768 @code{staff-padding} se puede usar para alinear objetos como matices
2769 dinámicos a lo largo de una línea de base a una altura fija sobre el
2770 pentagrama, en lugar de hacerlo a una altura que dependa de la
2771 posición de la nota a la que están adosados. No es una propiedad de
2772 @code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
2773 porque la línea de base debe aplicarse por igual a @strong{todas} las
2774 dinámicas, entre ellas las que se han creado como objetos de
2775 extensión. Así que ésta es la forma de alinear las indicaciones de
2776 matiz en el ejemplo de la sección anterior:
2778 @cindex DynamicText, ejemplo de sobreescritura
2779 @cindex extra-spacing-width, propiedad, ejemplo
2780 @cindex DynamicLineSpanner, ejemplo de sobreescritura
2781 @cindex staff-padding, propiedad, ejemplo
2783 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2785 % Extend width by 1 unit
2786 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2787 % Align dynamics to a base line 2 units above staff
2788 \override DynamicLineSpanner #'staff-padding = #2
2793 @subheading la propiedad self-alignment-X (auto-alineación en X)
2795 El ejemplo siguiente muestra cómo esto puede resolver la colisión
2796 entre un objeto de digitación de cuerda y la plica de una nota
2797 mediante el alineamiento del límite derecho con el punto de referencia
2800 @cindex StringNumber, ejemplo de sobreescritura
2801 @cindex self-alignment-X, propiedad, ejemplo
2803 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
2806 \once \override StringNumber #'self-alignment-X = #RIGHT
2810 @subheading la propiedad staff-position (posición en el pentagrama)
2812 @cindex objeto, colisión dentro del pentagrama
2814 Los silencios multi-compás en una voz pueden chocar con las notas en
2815 otra voz. Puesto que estos silencios se tipografían centrados entre
2816 las barras de compás se necesitaría bastante esfuerzo para que
2817 LilyPond averiguara qué otras notas podrían chocar con él, ya que
2818 actualmente todo el manejo de colisiones entre notas y silencios se
2819 hace solamente para notas y silencios que ocurren al mismo tiempo. He
2820 aquí un ejemplo de colisión de este tipo:
2822 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2823 << {c c c c} \\ {R1} >>
2826 La mejor solución aquí es mover el silencio multi-compás hacia abajo,
2827 pues el silencio está en la voz dos. El ajuste predeterminado para
2828 @code{\voiceTwo} (es decir, en la segunda voz de una construcción
2829 @code{<<@{...@} \\ @{...@}>>}) es que @code{staff-position} tenga el
2830 valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
2831 cuatro semi-espacios de pentagrama, al valor @code{-8}.
2833 @cindex MultiMeasureRest, ejemplo de sobreescritura
2834 @cindex staff-position, propiedad, ejemplo
2836 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2840 \override MultiMeasureRest #'staff-position = #-8
2845 Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
2846 la línea adicional por encima del silencio se inserta automáticamente.
2848 @subheading la propiedad extra-offset (desplazamiento adicional)
2850 @cindex posicionar objetos
2851 @cindex posicionar grobs
2852 @cindex objetos, posicionar
2853 @cindex grobs, posicionar
2855 La propiedad @code{extra-offset} da un completo control sobre el
2856 posicionamiento de un objeto tanto vertical como horizontalmente.
2858 En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
2859 a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
2861 @cindex Fingering, ejemplo de sobreescritura
2862 @cindex extra-offset, propiedad, ejemplo
2864 @lilypond[quote,fragment,relative=1,verbatim]
2867 \once \override Fingering
2868 #'extra-offset = #'(-0.3 . -1.8)
2873 @subheading la propiedad positions (posiciones)
2875 @cindex controlar manualmente grupos especiales, ligaduras y barras
2876 @cindex manual, control, de grupos especiales, ligaduras y barras
2877 @cindex grupos especiales, barras de, control manual
2878 @cindex ligaduras de expresión, control manual
2879 @cindex ligaduras de fraseo, control manual
2880 @cindex barras de corchea, control manual
2882 La propiedad @code{positions} permite controlar manualmente la
2883 posición e inclinación de los tresillos, ligaduras de expresión y de
2884 fraseo, y barras de corchea. He aquí un ejemplo que tiene una fea
2885 ligadura de fraseo debido a que intenta evitar la ligadura de
2886 expresión que está sobre la acciaccatura.
2888 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2889 r4 \acciaccatura e8\( d8 c ~c d c d\)
2893 Simplemente podemos mover la ligadura de fraseo por encima de las
2894 notas, y de hecho ésta será la solución preferida:
2896 @cindex PhrasingSlur, ejemplo de sobreescritura
2897 @cindex positions, propiedad, ejemplo
2899 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2902 \acciaccatura e8\( d8 c ~c d c d\)
2906 Pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
2907 sería mover el extremo izquierdo de la ligadura de fraseo un poco
2908 hacia abajo usando la propiedad @code{positions}. Esto también
2909 resuelve la forma algo indecente de la ligadura.
2911 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2913 \once \override PhrasingSlur #'positions = #'(-4 . -3)
2915 e8\( d8 c ~c d c d\)
2918 Presentamos un ejemplo más extraído del comienzo del pentagrama de la
2919 mano izquierda del preludio de Chopin Op 28 No. 2. vemos que la barra
2920 choca con las notas superiores:
2922 @lilypond[quote,verbatim,fragment,ragged-right]
2925 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2926 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2931 Esto se puede resolver manualmente elevando los dos extremos de la
2932 barra desde su posición a dos espacios de pentagrama sobre la línea
2933 central hasta, digamos, 3 espacios:
2935 @cindex Beam, ejemplo de sobreescritura
2936 @cindex positions, propiedad, ejemplo
2938 @lilypond[quote,verbatim,fragment,ragged-right]
2942 \override Beam #'positions = #'(3 . 3)
2947 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2952 Observe que la sobreescritura sigue aplicándose en la primera voz del
2953 segundo bloque de corcheas, pero no a ninguna de las barras de la
2956 @subheading la propiedad force-hshift (forzar desplazamiento horizontal)
2958 @c FIXME: formatting stuff (ie not important right now IMO)
2959 @c @a nchor Chopin finally corrected TODOgp
2961 Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
2962 Chopin que presentamos al final de @ref{Oigo voces}, que
2963 dejamos con este aspecto:
2965 @lilypond[quote,verbatim,fragment,ragged-right]
2966 \new Staff \relative c'' {
2969 { c2 aes4. bes8 } \\
2981 Las dos notas inferiores del primer acorde (es decir, las que están en
2982 al tercera voz) no deberían separarse de la columna de notas de las dos
2983 notas agudas. Para corregir esto, establecemos el valor de
2984 @code{force-hshift} (que es una propiedad de @code{NoteColumn}) de
2985 esas notas a cero. La nota más grave del segundo acorde se sitúa
2986 mejor justo a la derecha de las más agudas. Lo conseguimos
2987 estableciendo el valor de @code{force-hshift} de esta nota a 0.5, o
2988 sea, la anchura de media cabeza de nota a la derecha de la columna de
2991 Presentamos a continuación el resultado final:
2993 @cindex NoteColumn, ejemplo de sobreescritura
2994 @cindex force-hshift, propiedad, ejemplo
2996 @lilypond[quote,verbatim,fragment,ragged-right]
2997 \new Staff \relative c'' {
3000 { c2 aes4. bes8 } \\
3003 \once \override NoteColumn #'force-hshift = #0 <ees c>2
3004 \once \override NoteColumn #'force-hshift = #0.5 des2
3012 @node Ejemplos reales de música
3013 @subsection Ejemplos reales de música
3014 @translationof Real music example
3016 Finalizaremos esta sección sobre los trucos mostrando los pasos que se
3017 deben tomar para tratar con un ejemplo complicado que necesita varios
3018 trucos para producir el resultado deseado. El ejemplo se ha escogido
3019 deliberadamente para ilustrar el uso de la Referencia de la Notación
3020 para resolver problemas de notación poco comunes. No es
3021 representativo de un proceso de grabado más usual, por lo que ¡le
3022 recomendamos que no deje que estas dificultades le desanimen!
3023 ¡Afortunadamente, las dificultades como éstas no son muy comunes!
3025 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
3026 compases 6 al 9, la transición entre el Lento inicial y el Moderato.
3027 Presentamos en primer lugar el aspecto que queremos que tenga el
3028 resultado, pero para evitar complicar demasiado el ejemplo hemos
3029 quitado las indicaciones dinámicas, las digitaciones y el pedal.
3031 @c The following should appear as music without code
3032 @lilypond[quote,ragged-right]
3033 rhMusic = \relative c'' {
3036 \once \override Tie #'staff-position = #3.5
3040 \mergeDifferentlyHeadedOn
3041 \mergeDifferentlyDottedOn
3042 bes2.^\markup {\bold "Moderato"} r8
3044 {c,8[ d fis bes a] | }
3046 % Reposition the c2 to the right of the merged note
3047 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3048 % Move the c2 out of the main note column so the merge will work
3051 % Stem on the d2 must be down to permit merging
3052 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3056 \mergeDifferentlyHeadedOff
3057 \mergeDifferentlyDottedOff
3061 lhMusic = \relative c' {
3063 <d g, d>1)\arpeggio |
3070 \new Staff = "RH" <<
3074 \new Staff = "LH" <<
3083 Observamos en primer lugar que la parte de la mano derecha del tercer
3084 compás requiere cuatro voces. Son las cinco corcheas unidas por una
3085 barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
3086 y el Fa sostenido negra con puntillo, que también está fundida con la
3087 corchea de su misma altura. Todo lo demás está en una sola voz, así
3088 que lo más fácil es introducir estas cuatro voces temporalmente en el
3089 momento en que se necesiten. Si ha olvidado cómo hacerlo, lea
3090 @ref{Oigo voces}. Vamos a comenzar introduciendo las notas
3091 como dos variables y disponiendo la estructura de pentagramas en un
3092 bloque Score, y veremos qué produce LilyPond de forma predeterminada:
3094 @lilypond[quote,verbatim,ragged-right]
3095 rhMusic = \relative c'' {
3100 % Start polyphonic section of four voices
3102 {c,8 d fis bes a | }
3113 lhMusic = \relative c' {
3122 \new Staff = "RH" <<
3126 \new Staff = "LH" <<
3135 Todas las notas son correctas, pero el aspecto está lejos de ser
3136 satisfactorio. La ligadura de unión choca con el cambio de compás, el
3137 barrado del tercer compás es incorrecto, las notas no se funden
3138 correctamente, y faltan algunos elementos de notación. En primer
3139 lugar trataremos con lo más fácil. Podemos corregir el barrado de las
3140 corcheas insertando una barra manualmente, y podemos añadir fácilmente
3141 la ligadura de expresión de la mano izquierda y la ligadura de fraseo
3142 de la mano derecha, pues todo ello se estudió en el Tutorial. Al
3143 hacerlo así obtenemos:
3145 @lilypond[quote,verbatim,ragged-right]
3146 rhMusic = \relative c'' {
3151 % Start polyphonic section of four voices
3153 {c,8[ d fis bes a] | }
3164 lhMusic = \relative c' {
3173 \new Staff = "RH" <<
3177 \new Staff = "LH" <<
3186 El primer compás ahora es correcto. El segundo compás contiene un
3187 arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
3188 sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
3189 que volver e la Referencia de la Notación. Buscando la palabra
3190 @q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
3191 que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
3192 doble barra se produce por medio de la instrucción @code{\bar "||"}.
3193 Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
3194 la colisión entre la ligadura de unión y la indicación de compás.
3195 Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
3196 mover objetos anteriormente en @ref{Mover objetos}, donde dice que
3197 los objetos que están situados de forma relativa al pentagrama se
3198 pueden mover sobreescribiendo su propiedad @code{staff-position}, que
3199 se especifica en unidades de medio espacio de pentagrama respecto de
3200 la línea central del pentagrama. Así pues, la sobreescritura
3201 siguiente colocada justo antes de la primera nota ligada subirá la
3202 ligadura 3.5 medios espacios de pentagrama por encima de la línea
3205 @code{\once \override Tie #'staff-position = #3.5}
3207 Con esto se completa el compás dos, dando como resultado:
3209 @lilypond[quote,verbatim,ragged-right]
3210 rhMusic = \relative c'' {
3212 \once \override Tie #'staff-position = #3.5
3217 % Start polyphonic section of four voices
3219 {c,8[ d fis bes a] | }
3230 lhMusic = \relative c' {
3232 <d g, d>1)\arpeggio |
3239 \new Staff = "RH" <<
3243 \new Staff = "LH" <<
3252 Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
3253 tutorial nos enseñó cómo escribir texto en negrita mediante la
3254 instrucción @code{\markup}, por lo que añadir @q{Moderato} en negrita
3255 es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
3256 voces? Aquí es donde debemos volver a buscar ayuda en el manual de
3257 Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
3258 el índice de la Referencia de la notación llegamos rápidamente a las
3259 instrucciones para mezclar notas con distinta cabeza y con o sin
3260 puntillo, en @ruser{Resolución de las colisiones}. En nuestro ejemplo tenemos
3261 que fusionar ambos tipos de nota en el transcurso de la sección
3262 polifónica del compás 3; por tanto, en virtud de la información que
3263 aparece en la Referencia de la Notación, escribimos
3266 \mergeDifferentlyHeadedOn
3267 \mergeDifferentlyDottedOn
3271 al principio de la sección, y
3274 \mergeDifferentlyHeadedOff
3275 \mergeDifferentlyDottedOff
3279 al final, dando como resultado:
3281 @lilypond[quote,verbatim,ragged-right]
3282 rhMusic = \relative c'' {
3284 \once \override Tie #'staff-position = #3.5
3288 bes2.^\markup {\bold "Moderato"} r8
3289 \mergeDifferentlyHeadedOn
3290 \mergeDifferentlyDottedOn
3291 % Start polyphonic section of four voices
3293 {c,8[ d fis bes a] | }
3301 \mergeDifferentlyHeadedOff
3302 \mergeDifferentlyDottedOff
3306 lhMusic = \relative c' {
3308 <d g, d>1)\arpeggio |
3315 \new Staff = "RH" <<
3319 \new Staff = "LH" <<
3328 Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
3329 dos Re. ¿Por qué no? La respuesta está en la misma sección de la
3330 Referencia de la Notación: las notas que se fusionan deben tener las
3331 plicas en direcciones opuestas y dos notas no se pueden fusionar bien
3332 si hay una tercera nota en la misma columna. Aquí los dos Re tienen
3333 las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
3334 cambiar la dirección de la plica usando @code{\stemDown}, y la
3335 Referencia de la Notación también explica cómo mover el Do: aplicar un
3336 desplazamiento usando una de las instrucciones @code{\shift}. Pero
3337 ¿cuál? El Do está en la voz dos que tiene desactivado el
3338 desplazamiento, y los dos Re están en las voces uno y tres, que tienen
3339 el desplazamiento desactivado y activado, respectivamente. Por ello
3340 tenemos que desplazar el Do un nivel más todavía, usando
3341 @code{\shiftOnn} para evitar que interfiera con los dos Re. Al
3342 aplicar estos cambios obtenemos:
3344 @cindex Tie, ejemplo de sobreescritura
3345 @cindex staff-position, propiedad, ejemplo
3347 @lilypond[quote,verbatim,ragged-right]
3348 rhMusic = \relative c'' {
3350 \once \override Tie #'staff-position = #3.5
3354 bes2.^\markup {\bold "Moderato"} r8
3355 \mergeDifferentlyHeadedOn
3356 \mergeDifferentlyDottedOn
3357 % Start polyphonic section of four voices
3359 {c,8[ d fis bes a] | }
3361 % Move the c2 out of the main note column so the merge will work
3362 {c,8~ \shiftOnn c2 | }
3364 % Stem on the d2 must be down to permit merging
3365 {s8 \stemDown d2 | }
3369 \mergeDifferentlyHeadedOff
3370 \mergeDifferentlyDottedOff
3374 lhMusic = \relative c' {
3376 <d g, d>1)\arpeggio |
3383 \new Staff = "RH" <<
3387 \new Staff = "LH" <<
3396 Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
3397 sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
3398 colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
3399 partir de trucos anteriores: hacemos la plica transparente, y movemos
3400 el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
3403 @cindex NoteColumn, ejemplo de sobreescritura
3404 @cindex force-hshift, propiedad, ejemplo
3405 @cindex Stem, ejemplo de sobreescritura
3406 @cindex transparent, propiedad, ejemplo
3408 @lilypond[quote,verbatim,ragged-right]
3409 rhMusic = \relative c'' {
3412 \once \override Tie #'staff-position = #3.5
3416 bes2.^\markup {\bold "Moderato"} r8
3417 \mergeDifferentlyHeadedOn
3418 \mergeDifferentlyDottedOn
3420 {c,8[ d fis bes a] | }
3422 % Reposition the c2 to the right of the merged note
3423 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3424 % Move the c2 out of the main note column so the merge will work
3427 % Stem on the d2 must be down to permit merging
3428 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3432 \mergeDifferentlyHeadedOff
3433 \mergeDifferentlyDottedOff
3437 lhMusic = \relative c' {
3439 <d g, d>1)\arpeggio |
3446 \new Staff = "RH" <<
3450 \new Staff = "LH" <<
3460 @node Trucajes adicionales
3461 @section Trucajes adicionales
3462 @translationof Further tweaking
3465 * Otras aplicaciones de los trucos::
3466 * Uso de variables para los trucos::
3467 * Otras fuentes de información::
3468 * Evitar los trucos con un proceso ralentizado::
3469 * Trucos avanzados con Scheme::
3472 @node Otras aplicaciones de los trucos
3473 @subsection Otras aplicaciones de los trucos
3474 @translationof Other uses for tweaks
3476 @cindex transparent, uso de la propiedad
3477 @cindex objetos, hace invisibles
3478 @cindex eliminar objetos
3479 @cindex objetos, eliminar
3480 @cindex objetos, ocultar
3481 @cindex ocultar objetos
3482 @cindex invisibles, objetos
3483 @cindex objetos invisibles
3484 @cindex ligar notas entre voces distintas
3486 @subheading Ligar notas entre voces distintas
3488 El ejemplo siguiente muestra cómo conectar notas que están en
3489 distintas voces utilizando ligaduras de unión. Normalmente sólo se
3490 pueden conectar mediante ligaduras de unión dos notas que estén en la
3491 misma voz. Usando dos voces, con las notas ligadas en una de ellas:
3493 @lilypond[quote,fragment,relative=2]
3494 << { b8~ b8\noBeam }
3500 y borrando la primera plica hacia arriba en esa voz, da la impresión
3501 de que la ligadura se cruza entre las voces:
3503 @cindex Stem, ejemplo de sobreescritura
3504 @cindex transparent, propiedad, ejemplo
3506 @lilypond[quote,fragment,relative=2,verbatim]
3509 \once \override Stem #'transparent = ##t
3517 Para estar seguros de que la plica que acabamos de borrar no aprieta
3518 demasiado a la ligadura, podemos alargar la plica estableciendo su
3519 valor de longitud @code{length} a @code{8},
3521 @lilypond[quote,fragment,relative=2,verbatim]
3524 \once \override Stem #'transparent = ##t
3525 \once \override Stem #'length = #8
3533 @subheading Simulación de un calderón en el MIDI
3535 @cindex sello, uso de la propiedad
3536 @cindex fermata, realización en MIDI
3538 Para los objetos fuera-del-pentagrama, normalmente es mejor
3539 sobreescribir la propiedad @code{stencil} («sello») del objeto que su
3540 propiedad @code{transparent} cuando desee quitarlos de la salida
3541 impresa. Mediante el establecimiento de la propiedad @code{stencil}
3542 de un objeto al valor @code{#f} podemos quitar el objeto por completo
3543 de la salida impresa. Esto significa que no tiene efecto sobre la
3544 colocación de otros objetos que pudieran colocarse en relación a él.
3546 Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
3547 propósito de simular un calderón en la salida MIDI, seguramente no
3548 querríamos que la indicación metronómica apareciese en la salida
3549 impresa, y no querríamos influir sobre la separación entre los dos
3550 sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
3551 pentagrama. Por lo tanto, establecer su propiedad @code{stencil} al
3552 valor @code{#f} sería la mejor manera. Mostramos aquí el efecto de
3555 @cindex MetronomeMark, ejemplo de sobreescritura
3556 @cindex transparent, propiedad, ejemplo
3558 @lilypond[quote,verbatim,ragged-right]
3561 % Visible tempo marking
3564 \once \override Score.MetronomeMark #'transparent = ##t
3565 % Invisible tempo marking to lengthen fermata in MIDI
3568 % New tempo for next section
3577 @cindex MetronomeMark, ejemplo de sobreescritura
3578 @cindex stencil, propiedad, ejemplo
3580 @lilypond[quote,verbatim,ragged-right]
3583 % Visible tempo marking
3586 \once \override Score.MetronomeMark #'stencil = ##f
3587 % Invisible tempo marking to lengthen fermata in MIDI
3590 % New tempo for next section
3600 Ambos métodos quitan de la salida impresa la indicación metronómica
3601 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
3602 queríamos, pero la indicación metronómica transparente de la primera
3603 línea fuerza una colocación muy alta de la indicación de tempo que
3604 sigue, mientras que la segunda (con el sello suprimido) no lo hace.
3606 @node Uso de variables para los trucos
3607 @subsection Uso de variables para los trucos
3608 @translationof Using variables for tweaks
3610 @cindex variables, uso de, para trucos
3611 @cindex usar variables para hacer trucos
3612 @cindex trucos, usar variables para hacer
3614 Las instrucciones de sobreescritura son con frecuencia largas y
3615 tediosas de escribir, y se tienen que escribir de forma absolutamente
3616 correcta. Si las mismas sobreescrituras se van a utilizar muchas
3617 veces, podría merecer la pena definir variables para guardarlas.
3619 Supongamos que queremos realzar ciertas palabras de la letra de una
3620 canción imprimiéndolas en cursiva y negrita. Las instrucciones
3621 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
3622 canciones si están incluidas, junto con la palabra o palabras que se
3623 pretenden modificar, dentro de un @code{\markup}, lo que las hace
3624 tediosas de escribir. La necesidad de incluir las propias palabras
3625 impide que se puedan usar en variables simples. ¿Podríamos, como
3626 alternativa, utilizar las instrucciones @code{\override} y
3630 @code{\override Lyrics . LyricText #'font-shape = #'italic}
3631 @code{\override Lyrics . LyricText #'font-series = #'bold}
3633 @code{\revert Lyrics . LyricText #'font-shape}
3634 @code{\revert Lyrics . LyricText #'font-series}
3637 Estas instrucciones también serían extremadamente tediosas de escribir
3638 si hubiera muchas palabras que quisiéramos subrayar. Pero sí
3639 @emph{podemos} definirlas como dos variables y usarlas para delimitar
3640 las palabras que destacar. Otra ventaja de la utilización de
3641 variables para estas sobreescrituras es que ya no son necesarios los
3642 espacios que rodean al punto, puesto que no se interpretan
3643 directamente en el modo @code{\lyricmode}. He aquí un ejemplo de
3644 esto, aunque en la práctica quizá elegiríamos unos nombres de variable
3645 más cortos para que fueran más rápidos de teclear:
3647 @cindex LyricText, ejemplo de sobreescritura
3648 @cindex font-shape, propiedad, ejemplo
3649 @cindex font-series, propiedad, ejemplo
3651 @lilypond[quote,verbatim]
3653 \override Lyrics.LyricText #'font-shape = #'italic
3654 \override Lyrics.LyricText #'font-series = #'bold
3657 \revert Lyrics.LyricText #'font-shape
3658 \revert Lyrics.LyricText #'font-series
3661 global = { \time 4/4 \partial 4 \key c \major}
3662 SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
3663 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f f e }
3664 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
3665 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
3666 VerseOne = \lyrics { E -- | ter -- nal \emphasize Fa -- ther, \normal | strong to save, }
3667 VerseTwo = \lyricmode { O | \emphasize Christ, \normal whose voice the | wa -- ters heard, }
3668 VerseThree = \lyricmode { O | \emphasize Ho -- ly Spi -- rit, \normal | who didst brood }
3669 VerseFour = \lyricmode { O | \emphasize Tri -- ni -- ty \normal of | love and pow'r }
3675 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
3676 \new Voice = "Alto" { \voiceTwo \AltoMusic }
3677 \new Lyrics \lyricsto "Soprano" { \VerseOne }
3678 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
3679 \new Lyrics \lyricsto "Soprano" { \VerseThree }
3680 \new Lyrics \lyricsto "Soprano" { \VerseFour }
3684 \new Voice = "Tenor" { \voiceOne \TenorMusic }
3685 \new Voice = "Bass" { \voiceTwo \BassMusic }
3692 @node Otras fuentes de información
3693 @subsection Otras fuentes de información
3694 @translationof Other sources of information
3696 La documentación del manual de Referencia de Funcionamiento Interno
3697 contiene montañas de información sobre LilyPond, pero se puede obtener
3698 más información aún leyendo los archivos internos de LilyPond. Para
3699 echarles un vistazo, en primer lugar debe buscar la carpeta
3700 correspondiente a su sistema. La ubicación de esta carpeta depende
3701 (a) de si consiguió el programa LilyPond descargando un binario
3702 precompilado desde el sitio web lilypond.org o si lo instaló mediante
3703 un gestor de paquetes (es decir, distribuido con Linux, o instalado
3704 bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
3705 qué sistema operativo está utilizando:
3708 @strong{Descargado de lilypond.org}
3714 @file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/share/lilypond/current/}
3719 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/Resources/share/lilypond/current/}
3720 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
3721 bien manteniendo pulsada la tecla de Control y haciendo click sobre la
3722 aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
3727 Mediante el Explorador de Windows, diríjase a
3728 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/share/lilypond/current/}
3732 @strong{Instalado mediante un gestor de paquetes o compilado a partir de la fuente}
3735 @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
3736 se encuentra determinado por su administrador de paquetes o guión
3737 @code{configure}, y @var{X.Y.Z} es el número de la versión de
3742 Dentro de esta carpeta, las dos subcarpetas interesantes son
3745 @item @file{ly/} - contiene archivos en formato LilyPond
3746 @item @file{scm/} - contiene archivos en formato Scheme
3749 Vamos a comenzar observando algunos archivos que están en @file{ly/}.
3750 Abra @file{ly/property-init.ly} con un editor de textos. El mismo que
3751 usaría normalmente para los archivos @code{.ly} servirá perfectamente.
3752 Este archivo contiene las definiciones de todas las instrucciones
3753 estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} y
3754 @code{\slurDotted}. Podrá ver que no son nada más que definiciones de
3755 variables que contienen una o varias instrucciones @code{\override}.
3756 Por ejemplo, @code{/tieDotted} está definido de tal forma que su valor
3761 \override Tie #'dash-period = #0.75
3762 \override Tie #'dash-fraction = #0.1
3766 Si no le gustan los valores predeterminados, estas instrucciones
3767 predefinidas se pueden redefinir con facilidad como cualquier otra
3768 variable, al principio de su archivo de código de entrada.
3770 Los siguientes son los archivos más útiles que se encuentran en
3773 @multitable @columnfractions .4 .6
3776 @item @file{ly/engraver-init.ly}
3777 @tab Definiciones de Contextos de grabadores
3778 @item @file{ly/paper-defaults-init.ly}
3779 @tab especificaciones de valores predeterminados relacionados con el papel
3780 @item @file{ly/performer-init.ly}
3781 @tab Definiciones de Contextos de interpretación
3782 @item @file{ly/property-init.ly}
3783 @tab Definiciones de todas las instrucciones predefinidas que son comunes
3784 @item @file{ly/spanner-init.ly}
3785 @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
3788 Otros ajustes (como las definiciones de las instrucciones de marcado)
3789 se almacenan como archivos @code{.scm} (de Scheme). El lenguaje de
3790 programación Scheme se utiliza para proporcionar un interfaz
3791 programable en el funcionamiento interno de LilyPond. Cualquier
3792 explicación adicional sobre estos archivos se encuentra por el momento
3793 fuera del ámbito de este manual, porque se requieren conocimientos del
3794 lenguaje Scheme. Se advierte a los usuarios que se necesita una
3795 importante cantidad de conocimientos técnicos o de tiempo para
3796 comprender el lenguaje Scheme y estos archivos (véase @ref{Tutorial de Scheme}).
3798 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
3801 @multitable @columnfractions .4 .6
3804 @item @file{scm/auto-beam.scm}
3805 @tab Valores predeterminados de sub-barrado
3806 @item @file{scm/define-grobs.scm}
3807 @tab valores predeterminados de las propiedades de grobs
3808 @item @file{scm/define-markup-commands.scm}
3809 @tab Especificar todas las instrucciones de marcado
3810 @item @file{scm/midi.scm}
3811 @tab Ajustes predeterminados para la salida MIDI
3812 @item @file{scm/output-lib.scm}
3813 @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
3814 @item @file{scm/parser-clef.scm}
3815 @tab Definiciones de las claves contempladas
3816 @item @file{scm/script.scm}
3817 @tab Ajustes predeterminados para las articulaciones
3822 @node Evitar los trucos con un proceso ralentizado
3823 @subsection Evitar los trucos con un proceso ralentizado
3824 @translationof Avoiding tweaks with slower processing
3826 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
3827 procesa los archivos. Estas instrucciones consumen tiempo, pero el
3828 resultado puede necesitar menos trucos manuales para obtener un
3829 resultado aceptable. Si una inscripción de texto o parte de la letra
3830 se sale de los márgenes, estas comprobaciones comprimirán dicha línea
3831 en la medida justa como para que encaje dentro de los márgenes.
3833 Para que sean efectivos bajo cualquier circunstancia, estas
3834 comprobaciones deben habilitarse colocando las instrucciones de
3835 sobreescritura dentro del bloque @code{\with} dentro de un Score, y no
3836 en línea con la música, de la forma siguiente:
3841 % asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
3842 \override PaperColumn #'keep-inside-line = ##t
3843 \override NonMusicalPaperColumn #'keep-inside-line = ##t
3849 @node Trucos avanzados con Scheme
3850 @subsection Trucos avanzados con Scheme
3851 @translationof Advanced tweaks with Scheme
3853 Aunque es posible hacer muchas cosas con las instrucciones
3854 @code{\override} y @code{\tweak} , tenemos una forma incluso más
3855 poderosa de modificar el funcionamiento de LilyPond, a través de un
3856 interface programable hacia las operaciones internas de LilyPond. Se
3857 puede incorporar código escrito en el lenguaje de programación Scheme,
3858 directamente en el mecanismo de funcionamiento de LilyPond. Por
3859 supuesto, para hacer esto se necesitan al menos unos conocimientos
3860 básicos de programación en Scheme, y damos una introducción en el
3861 @ref{Tutorial de Scheme}.
3863 Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
3864 dar a una propiedad un valor constante, se puede establecer al
3865 resultado de un procedimiento de Scheme que se invoca cada vez que
3866 LilyPond accede a esta propiedad. La propiedad se puede establecer
3867 dinámicamente a un valor determinado por el procedimiento en el
3868 momento en que se invoca. En este ejemplo damos a las cabezas de las
3869 notas un color que depende de su posición dentro del pentagrama.
3871 @cindex x11-color, función, ejemplo de utilización
3872 @cindex NoteHead, ejemplo de sobreescritura
3873 @cindex color, propiedad, establecer a procedimiento de Scheme
3875 @lilypond[quote,verbatim,ragged-right]
3876 #(define (color-notehead grob)
3877 "Color the notehead according to its position on the staff."
3878 (let ((mod-position (modulo (ly:grob-property grob 'staff-position) 7)))
3880 ;; Return rainbow colors
3881 ((1) (x11-color 'red )) ; for C
3882 ((2) (x11-color 'orange )) ; for D
3883 ((3) (x11-color 'yellow )) ; for E
3884 ((4) (x11-color 'green )) ; for F
3885 ((5) (x11-color 'blue )) ; for G
3886 ((6) (x11-color 'purple )) ; for A
3887 ((0) (x11-color 'violet )) ; for B
3893 % Arrange to obtain color from color-notehead procedure
3894 \override NoteHead #'color = #color-notehead
3901 Some -- where o -- ver the Rain -- bow, way up high,
3905 Se pueden encontrar ejemplos adicionales que muestran la utilización
3906 de estos interfaces programables, en @ref{Trucos con Scheme}.