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. See TRANSLATION for details.
12 @node Trucar la salida
13 @chapter Trucar la salida
14 @translationof Tweaking output
16 Este capítulo trata de cómo modificar la salida. LilyPond es extremadamente
17 configurable; prácticamente todos los fragmentos de la salida se pueden cambiar.
21 * Elementos de trucaje::
22 * Manual de referencia de funcionamiento interno::
23 * Apariencia de los objetos::
24 * Colocación de los objetos::
25 * Colisiones de objetos::
26 * Trucajes adicionales::
29 @node Elementos de trucaje
30 @section Elementos de trucaje
31 @translationof Tweaking basics
34 * Introducción al trucaje::
35 * Objetos e interfaces::
36 * Convenciones de nombres de objetos y propiedades::
37 * Métodos de trucaje::
40 @node Introducción al trucaje
41 @subsection Introducción al trucaje
42 @translationof Introduction to tweaks
44 El @q{Trucaje} es un término de LilyPond que denota los diversos
45 métodos que el usuario tiene a su disposición para modificar el
46 proceso de interpretación del archivo de entrada y cambiar la
47 apariencia de la salida impresa. Algunos trucos son muy fáciles de
48 usar; otros son más complejos. Pero en su conjunto, los métodos de
49 trucaje disponibles posibilitan conseguir casi cualquier apariencia
50 que deseemos en la música impresa.
52 En esta sección vamos a estudiar los conceptos básicos que se
53 necesitan para comprender el trucaje. Más tarde daremos un amplio
54 abanico de instrucciones listas para usar, que podrá simplemente
55 copiar para obtener el mismo efecto en sus partituras, y al mismo
56 tiempo mostraremos la forma de construir dichas instrucciones para que
57 pueda aprender cómo desarrollar sus propios trucos.
59 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
60 la sección @ref{Contextos y grabadores}, pues los Contextos, los
61 Grabadores y las Propiedades que se contienen en ellos son
62 fundamentales para comprender y construir los trucos.
64 @node Objetos e interfaces
65 @subsection Objetos e interfaces
66 @translationof Objects and interfaces
70 @cindex objeto de extensión
72 @cindex propiedades de objetos
73 @cindex objeto, propiedades de
74 @cindex layout (disposición), objeto de
75 @cindex objeto de disposición (layout)
77 El trucaje consiste en modificar el funcionamiento y estructura
78 interna del programa LilyPond, por lo que en primer lugar
79 introduciremos algunos términos que se usan para describir dichas
80 operaciones y estructuras internas.
82 El término @q{Objeto} es un término genérico que se usa para referirse
83 a la multitud de estructuras internas que LilyPond construye durante
84 el procesado de un archivo de entrada. Así, cuando se encuentra una
85 instrucción como @code{\new Staff}, se construye un objeto nuevo del
86 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
87 las propiedades asociadas con ese pentagrama en particular, por
88 ejemplo, su nombre y su armadura, además de otros detalles de los
89 grabadores que se han asignado para que operen dentro del contexto del
90 pentagrama. De forma similar, hay objetos que guardan las propiedades
91 de todos los demás contextos, como objetos de @code{Voice}, objetos de
92 @code{Score}, objetos de @code{Lyrics}, así como objetos que
93 representan todos los elementos notacionales como líneas divisorias,
94 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
95 objeto tiene su propio conjunto de valores de propiedad.
97 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
98 representan elementos de notación sobre la salida impresa como cabezas
99 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
100 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
101 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
102 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
103 mencionado, y también todos ellos tienen propiedades asociadas, como
104 su posición, tamaño, color,etc.
106 Ciertos objetos de presentación son aún más especializados. Las
107 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
108 y baja, y muchos otros objetos gráficos no están situados en un solo
109 lugar: tienen un punto de inicio, un punto de final, y quizá otras
110 propiedades relacionadas con su forma. Los objetos con una forma
111 extendida como estos, reciben el nombre de «Objetos de extensión» o
114 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
115 incluso aunque son bastante diferentes, comparten funcionalidades que
116 se deben procesar de la misma manera. Por ejemplo, todos los objetos
117 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
118 propiedades se procesan de la misma forma durante la interpretación
119 del archivo de entrada por parte de LilyPond. Para simplificar estas
120 operaciones internas, estas acciones y propiedades comunes se agrupan
121 en un objeto llamado @code{grob-interface}, interface de grob. Hay
122 muchas otras agrupaciones de propiedades comunes como ésta, y cada
123 una recibe un nombre que acaba en @code{interface}. En total hay más
124 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
125 interés y de utilidad para el usuario.
127 Estos son, en fin, los términos principales relativos a los objetos
128 que vamos a utilizar en este capítulo.
130 @node Convenciones de nombres de objetos y propiedades
131 @subsection Convenciones de nombres de objetos y propiedades
132 @translationof Naming conventions of objects and properties
134 @cindex nomenclatura, convenciones de, para objetos
135 @cindex nomenclatura, convenciones de, para propiedades
136 @cindex objetos, convenciones de nomenclatura
137 @cindex propiedades, convenciones de nomenclatura
139 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
140 sección @ref{Contextos y grabadores}. En este lugar, para más fácil
141 referencia, presentamos una lista de los tipos de objetos y
142 propiedades más comunes, junto con las convenciones según las cuales
143 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
144 utilizado una @q{A} mayúscula para denotar cualquier carácter
145 alfabético en mayúsculas, y @q{aaa} para cualquier número de
146 caracteres alfabéticos en minúscula. Otros caracteres se utilizan
147 literalmente como están.
149 @multitable @columnfractions .33 .33 .33
150 @headitem Objeto o tipo de propiedad
151 @tab Convención de nomenclatura
154 @tab Aaaa o AaaaAaaaAaaa
155 @tab Staff, GrandStaff
156 @item Objetos de presentación
157 @tab Aaaa o AaaaAaaaAaaa
160 @tab Aaaa_aaa_engraver
161 @tab Clef_engraver, Note_heads_engraver
163 @tab aaa-aaa-interface
164 @tab grob-interface, break-aligned-interface
165 @item Propiedades de contextos
166 @tab aaa o aaaAaaaAaaa
167 @tab alignAboveContext, skipBars
168 @item Propiedades de objetos de presentación
169 @tab aaa o aaa-aaa-aaa
170 @tab direction, beam-thickness
173 Como podremos ver en breve, las propiedades de distintos tipos de
174 objeto se modifican por parte de diferentes instrucciones; así pues,
175 es útil poder reconocer el tipo de objeto a partir de sus nombres de
178 @node Métodos de trucaje
179 @subsection Métodos de trucaje
180 @translationof Tweaking methods
182 @cindex trucaje, métodos de
184 @strong{La instrucción \override}
186 @cindex override, instrucción
187 @cindex override (sobreescritura), sintaxis de
192 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
193 usan para cambiar las propiedades de los @strong{contextos} y para
194 quitar y poner @strong{grabadores}, en @ref{Modificar las propiedades de los contextos} y @ref{Añadir y eliminar grabadores}. Ahora debemos
195 examinar algunas otras instrucciones importantes.
197 La instrucción que cambia las propiedades de los @strong{objetos de
198 presentación} es @code{\override}. Puesto que esta instrucción debe
199 modificar propiedades internas que se encuentran en un lugar profundo
200 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
201 las instrucciones que hemos usado hasta ahora. Tiene que saber
202 exactamente qué propiedad de qué objeto y en qué contexto se debe
203 modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
205 La sintaxis genérica de esta instrucción es:
208 \override @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación} =
213 Esto establecerá la propiedad de nombre
214 @var{propiedad-de-presentación} del objeto de presentación con el
215 nombre @var{ObjetoDePresentación}, que es miembro del contexto
216 @var{Contexto}, al valor @var{valor}.
218 El @var{contexto} se puede omitir (y normalmente así es) cuando el
219 contexto requerido se encuentra implicado sin ambigüedad y es uno de
220 los contextos del nivel más bajo, es decir: @code{Voice},
221 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
222 ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
224 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
225 valores, pero para ilustrar el formato y utilización de estas
226 instrucciones usaremos sólo unas cuantas propiedades y valores
227 sencillos que sean fáciles de entender.
229 Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
230 propiedad de presentación, y el @code{#}, que debe preceder al valor.
231 Deben estar presentes siempre y de esa forma exacta. Es la
232 instrucción de uso más común dentro del trucaje, y durante la mayor
233 parte del resto de este capítulo presentaremos ejemplos de cómo se
234 usa. A continuación hay un ejemplo sencillo para cambiar el color de
237 @cindex color, propiedad, ejemplo
238 @cindex NoteHead, ejemplo de sobreescritura
240 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
242 \override NoteHead #'color = #red
244 \override NoteHead #'color = #green
248 @strong{La instrucción \revert}
250 @cindex revert, instrucción
255 Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
256 se sobreescribe de nuevo o se encuentra una instrucción
257 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
258 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
259 valor predeterminado original; observe que no es a su valor previo si
260 se han utilizado varias instrucciones @code{\override}.
263 \revert @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación}
266 Una vez más, igual que @var{Contexto} dentro de la instrucción
267 @code{\override}, con frecuencia no es necesario especificar el
268 @var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
269 Aquí devolvemos el color de la cabeza al valor predeterminado para las
272 @cindex color, propiedad, ejemplo
273 @cindex NoteHead, ejemplo de sobreescritura
275 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
277 \override NoteHead #'color = #red
279 \override NoteHead #'color = #green
281 \revert NoteHead #'color
285 @strong{El prefijo \once}
290 Tanto la instrucción @code{\override} como @code{\set} se pueden
291 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
292 @code{\override} o @code{\set} sea efectiva solamente durante el
293 tiempo musical en curso y antes de que la propiedad vuelva a tener
294 otra vez su valor predeterminado. Utilizando el mismo ejemplo,
295 podemos cambiar el color de una sola nota de la siguiente manera:
297 @cindex color, propiedad, ejemplo
298 @cindex NoteHead, ejemplo de sobreescritura
300 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
302 \once \override NoteHead #'color = #red
304 \once \override NoteHead #'color = #green
308 @strong{La instrucción \overrideProperty}
310 @cindex overrideProperty, instrucción
312 @funindex \overrideProperty
313 @funindex overrideProperty
315 Hay otra forma para la instrucción de sobreescritura,
316 @code{\overrideProperty}, que ocasionalmente es necesaria. La
317 mencionamos aquí con un propósito de exhaustividad, pero para ver más
318 detalles consulte @ruser{Trucos difíciles}.
319 @c Maybe explain in a later iteration -td
321 @strong{La instrucción \tweak}
323 @cindex tweak, instrucción
328 La última instrucción de trucaje que está disponible es @code{\tweak}.
329 Se debe utilizar para cambiar las propiedades de objetos que suceden
330 en el mismo momento musical, como las notas de un acorde. El uso de
331 @code{\override} para la sobreescritura afectaría a todas las notas
332 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
333 elemento del flujo de entrada.
335 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
336 cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
337 primer lugar, veamos lo que haría @code{\once \override}:
339 @cindex font-size, propiedad, ejemplo
340 @cindex NoteHead, ejemplo de sobreescritura
342 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
344 \once \override NoteHead #'font-size = #-3
349 Vemos que la sobreescritura con override afecta a @emph{todas} las
350 cabezas de las notas del acorde. Esto es así porque todas las notas
351 de un acorde ocurren en el mismo @emph{momento musical}, y la acción
352 de @code{\once} es aplicar la sobreescritura a todos los objetos de
353 presentación del tipo especificado que ocurren en el mismo momento
354 musical que la propia instrucción de sobreescritura @code{\override}.
356 La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
357 el elemento inmediatamente siguiente dentro del flujo de entrada. Sin
358 embargo, es efectivo solamente sobre objetos que se crean directamente
359 a partir del flujo de entrada, en esencia las cabezas y las
360 articulaciones; los objetos como las plicas y las alteraciones se
361 crean con posterioridad y no se pueden trucar de esta forma. Es más,
362 cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
363 dentro de un acorde, es decir, dentro de ángulos simples, así que para
364 trucar una sola nota la instrucción @code{\tweak} se debe colocar
365 dentro de ángulos simples junto con la nota.
367 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
368 se cambiaría de la siguiente forma:
370 @cindex font-size, propiedad, ejemplo
371 @cindex @code{\tweak}, ejemplo
373 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
375 <c \tweak #'font-size #-3 e g>4
378 Observe que la sintaxis de @code{\tweak} no es igual que la de
379 @code{\override}. Ni el contexto ni el objeto de presentación se
380 deben especificar; de hecho, generaría un error hacerlo. Los dos
381 están implícitos por el siguiente elemento del flujo de entrada.
382 Observe también que no debe haber un signo igual. Así que la sintaxis
383 genérica de la instrucción @code{\tweak} es, simplemente,
386 \tweak #'@var{propiedad-de-presentación} #@var{valor}
389 Una instrucción @code{\tweak} también se puede usar para modificar
390 sólo una de una serie de articulaciones, como se muestra aquí:
392 @cindex color, propiedad, ejemplo
393 @cindex @code{\tweak}, ejemplo
395 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
397 -\tweak #'color #red ^Red
398 -\tweak #'color #green _Green
402 Observe que la instrucción @code{\tweak} debe venir precedida de una
403 marca de articulación como si ella misma fuera una articulación.
405 @cindex grupos especiales anidados
406 @cindex tresillos anidados
407 @cindex corchete del grupo especial
408 @cindex corchete de tresillo
409 @cindex grupo especial, corchete de
410 @cindex tresillo, corchete de
412 @funindex TupletBracket
414 La instrucción @code{\tweak} también se debe usar para cambiar la
415 apariencia de uno solo de un conjunto de grupos especiales anidados
416 que comiencen en el mismo instante musical. En el siguiente ejemplo,
417 el corchete del tresillo largo y el primero de los tres corchetes
418 cortos empiezan en el mismo momento musical, y por ello cualquier
419 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
420 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
421 @code{\tweak} especifica que el corchete del tresillo largo se debe
422 colocar por encima de las notas y el segundo especifica que el número
423 del tresillo se debe imprimir en rojo sobre el corchete del primer
426 @cindex @code{\tweak}, ejemplo
427 @cindex direction, propiedad, ejemplo
428 @cindex color, propiedad, ejemplo
430 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
431 \tweak #'direction #up
434 \times 2/3 { c8[ c8 c8] }
435 \times 2/3 { c8[ c8 c8] }
436 \times 2/3 { c8[ c8 c8] }
440 Si los grupos anidados no comienzan en el mismo momento, su apariencia
441 se puede modificar de la forma usual mediante instrucciones
444 @cindex text, propiedad, ejemplo
445 @cindex tuplet-number, función, ejemplo
446 @cindex transparent, propiedad, ejemplo
447 @cindex TupletNumber, ejemplo de sobreescritura
449 @c NOTE Tuplet brackets collide if notes are high on staff
451 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
452 \times 2/3 { c8[ c c]}
453 \once \override TupletNumber
454 #'text = #tuplet-number::calc-fraction-text
458 \once \override TupletNumber #'transparent = ##t
459 \times 2/3 { c8[ c c] }
460 \times 2/3 { c8[ c c]}
466 Referencia de la notación:
467 @ruser{La instrucción tweak}.
470 @node Manual de referencia de funcionamiento interno
471 @section Manual de referencia de funcionamiento interno
472 @translationof The Internals Reference manual
474 @cindex Internals Reference
477 * Propiedades de los objetos de presentación::
478 * Propiedades de los interfaces::
479 * Tipos de propiedades::
482 @node Propiedades de los objetos de presentación
483 @subsection Propiedades de los objetos de presentación
484 @translationof Properties of layout objects
486 @cindex propiedades de los objetos de presentación
487 @cindex propiedades de los grobs
488 @cindex grobs, propiedades de
489 @cindex presentación, propiedades de los objetos de
490 @cindex Referencia de funcionamiento interno
492 Suponga que tiene una partitura con una ligadura de expresión que para
493 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
494 debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
495 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
496 piensa que una cierta instrucción de sobreescritura @code{\override}
497 será necesaria. Pero ¿existe una propiedad de grosor para las
498 ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
499 interviene el Manual de Funcionamiento Interno. Contiene toda la
500 información que puede necesitar para construir ésta y todas las demás
501 instrucciones @code{\override}, de sobreescritura.
503 Una advertencia antes de dirigir nuestra mirada a la referencia de
504 funcionamiento interno. Éste es un documento de @strong{referencia},
505 lo que significa que hay pocas o ninguna explicación en él: su
506 propósito es presentar la información de forma precisa y concisa. Por
507 tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
508 La guía y las explicaciones que presentamos aquí le permitirán extraer
509 la información de la referencia de funcionamiento interno por sí mismo
510 con tan sólo algo de práctica.
512 @cindex sobreescritura, ejemplo de
513 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
514 @cindex @code{\addlyrics}, ejemplo
517 Utilicemos un ejemplo concreto con un sencillo fragmento de música
520 @lilypond[quote,verbatim,relative=2]
525 g[( e]) e d[( f]) a |
529 The man who feels love's sweet e -- mo -- tion
534 Suponga ahora que decidimos que nos gustan las ligaduras algo más
535 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
536 presentación, así que la cuestión es @q{¿Hay una propiedad
537 perteneciente a las ligaduras de expresión que controle su grosor?}
538 Para responder a esta pregunta debemos mirar el manual de Referencia
539 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
540 (Internals Reference) en inglés}.
542 El RFI de la versión de LilyPond que está usando se puede encontrar en
543 la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
544 página de la documentación y siga el enlace Manual de Referencia de
545 Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
546 sería mejor que utilizase la versión en HTML, no la @q{en una sola
547 página} ni el PDF. Para que los siguientes párrafos tengan algún
548 sentido deberá consultarlo realmente al tiempo que lee.
550 @c Link names in English as those pages are not yet translated. FV
551 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
552 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
553 información sobre los objetos de presentación. Una vez allí, bajo el
554 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
555 objects}. La página que aparece relaciona todos los objetos de
556 presentación que se usan en su versión de LilyPond, en orden
557 alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
558 relacionadas las propiedades de las ligaduras de expresión o Slurs.
560 Una forma alternativa de encontrar esta página es a partir de la
561 Referencia de la Notación. En una de las páginas que tratan de las
562 ligaduras de expresión podrá encontrar un enlace al manual de
563 referencia del funcionamiento interno. Este enlace le llevará
564 directamente a esta página, aunque si tiene una idea del nombre del
565 objeto de presentación que pretende trucar, le resultará más fácil ir
566 directamente al RFI y buscar allí.
568 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
569 dice en primer lugar que los objetos Slur se crean por el grabador
570 Slur_engraver. A continuación relaciona los ajustes estándar.
571 Observe que @strong{no} están en orden alfabético. Navegue hacia
572 abajo buscando una propiedad que pudiera controlar el grosor de las
573 ligaduras, y encontrará
576 @code{thickness} (number)
578 Line thickness, generally measured in @code{line-thickness}
581 Esto promete ser una buena opción para cambiar el grosor. Nos dice
582 que el valor de @code{thickness} es un simple @emph{número}, que el
583 valor predeterminado es 1.2, y que las unidades están dentro de otra
584 propiedad llamada @code{line-thickness}.
586 Como dijimos con anterioridad, existen entre pocas y ninguna
587 explicación en el RFI, pero ya tenemos información suficiente para
588 probar a cambiar el grosor de la ligadura. Vemos que el nombre del
589 objeto de presentación es @code{Slur}, que el nombre de la propiedad
590 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
591 un número algo más grande que 1.2 si queremos hacer las ligaduras más
594 Ahora podemos construir la instrucción de sobreescritura
595 @code{\override} simplemente mediante la sustitución de los valores
596 que hemos encontrado para los nombres, omitiendo el contexto.
597 Usaremos un valor muy grande para el grosor al principio, para estar
598 seguros de que la instrucción está funcionando. Obtenemos lo
602 \override Slur #'thickness = #5.0
605 ¡No olvide el @code{#'} antes del nombre de la propiedad y @code{#}
606 antes del valor nuevo!
608 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
609 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
610 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
611 cerca de ella.} Hagámoslo así:
613 @cindex Slur, ejemplo de sobreescritura
614 @cindex thickness, propiedad, ejemplo
616 @lilypond[quote,verbatim,relative=2]
620 % Increase thickness of all following slurs from 1.2 to 5.0
621 \override Slur #'thickness = #5.0
623 g[( e]) e d[( f]) a |
627 The man who feels love's sweet e -- mo -- tion
633 y podemos ver que la ligadura, es sin duda, más pesada.
635 Así pues, ésta es la forma básica de construir instrucciones
636 @code{\override} o de sobreescritura. Existen unas cuantas
637 complicaciones más con las que nos encontraremos en secciones
638 posteriores, pero ahora conoce todos los principios esenciales que
639 necesita para hacerlo por sí mismo (aunque aún necesita algo de
640 práctica). La cual vendrá proporcionada por los ejemplos que vienen a
643 @subheading Búsqueda del contexto
645 @cindex contexto, encontrar
646 @cindex contexto, buscar el, correcto
648 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
649 especificar el contexto? ¿Cuál sería? Podemos suponer que las
650 ligaduras están en el contexto de Voz, por estar claramente asociados
651 de manera estrecha con las líneas individuales de música, pero
652 ¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
653 de la página del RFI que describe las ligaduras (Slur), donde dice
654 @q{Slur objects are created by: Slur engraver} («Los objetos de
655 ligadura de expresión se crean por: el grabador Slur»). Así pues, las
656 ligaduras de expresión se crean en cualquier contexto en el que se
657 encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
658 página del grabador @code{Slur_engraver}. Al final del todo, dice que
659 el grabador @code{Slur_engraver} es parte de cinco contextos de voz,
660 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
661 suposición era acertada. Y a causa de que @code{Voice} es uno de los
662 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
663 por el hecho de que estamos escribiendo notas, podemos omitirlo en
666 @subheading Sobreescritura por una sola vez
668 @cindex sobreescritura por una sola vez
669 @cindex once override
674 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
675 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
676 ligadura fuese más gruesa? Esto se consigue con la instrucción o
677 prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
678 @code{\override} ocasiona que solamente cambie la ligadura que
679 comienza en la nota @strong{inmediata siguiente}. Si la nota
680 inmediata siguiente no da inicio a una ligadura, la instrucción no
681 tiene ningún efecto en absoluto: no se recuerda hasta que se
682 encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
683 la instrucción que lleva @code{\once} se debe reposicionar de la forma
686 @cindex Slur, ejemplo de sobreescritura
687 @cindex thickness, propiedad, ejemplo
689 @lilypond[quote,verbatim,relative=2]
694 % Increase thickness of immediately following slur only
695 \once \override Slur #'thickness = #5.0
697 g[( e]) e d[( f]) a |
701 The man who feels love's sweet e -- mo -- tion
707 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
709 La instrucción o prefijo @code{\once} también se puede usar antes de
710 la instrucción @code{\set}.
712 @subheading Recuperación del ajuste
715 @cindex predeterminadas, recuperar las propiedades
720 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
721 fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
722 una de ellas precedida por el prefijo @code{\once}, situadas
723 inmediatamente antes de cada una de las notas en que comienzan las
726 @cindex Slur, ejemplo de sobreescritura
727 @cindex thickness, propiedad, ejemplo
729 @lilypond[quote,verbatim,relative=2]
734 % Increase thickness of immediately following slur only
735 \once \override Slur #'thickness = #5.0
737 % Increase thickness of immediately following slur only
738 \once \override Slur #'thickness = #5.0
739 g[( e]) e d[( f]) a |
743 The man who feels love's sweet e -- mo -- tion
749 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
750 instrucción @code{\revert} (restablecer) para devolver la propiedad
751 del grosor, @code{thickness}, a su valor predeterminado después de la
754 @cindex Slur, ejemplo de sobreescritura
755 @cindex thickness, propiedad, ejemplo
757 @lilypond[quote,verbatim,relative=2]
762 % Increase thickness of all following slurs from 1.2 to 5.0
763 \override Slur #'thickness = #5.0
766 % Revert thickness of all following slurs to default of 1.2
767 \revert Slur #'thickness
772 The man who feels love's sweet e -- mo -- tion
778 la instrucción @code{\revert} se puede utilizar para devolver
779 cualquier propiedad que se haya cambiado con @code{\override} a su
780 valor predeterminado. Puede utilizar el método que mejor se adapte a
781 aquello que quiere hacer.
783 Así finaliza nuestra introducción al manual de RFI, y el método básico
784 de trucaje. A continuación, en las últimas secciones de este capítulo
785 encontrará varios ejemplos, en parte para introducirle en algunas de
786 las posibilidades adicionales del manual RFI, y en parte para
787 proporcionarle más práctica en cómo extraer información de él. Estos
788 ejemplos irán conteniendo cada vez menos palabras de guía y
791 @node Propiedades de los interfaces
792 @subsection Propiedades de los interfaces
793 @translationof Properties found in interfaces
796 @cindex propiedades de los interfaces
797 @cindex interfaces, propiedades
799 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
800 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
801 En primer lugar miramos en la página del RFI que relaciona todos los
802 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
803 pueda controlar la letra de la canción. Encontramos @code{LyricText},
804 que parece adecuado. Al seguir este enlace se presentan las
805 propiedades ajustables para el texto de la letra. Estos incluyen
806 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
807 una forma cursiva. Esto es porque la propiedad de la forma es común a
808 todos los objetos de fuente tipográfica, y por tanto, en vez de
809 incluirlo en cada uno de los objetos de presentación, se agrupa junto
810 con otras propiedades comunes similares y se deposita en un
811 @strong{Interface}, el interface de las fuentes tipográficas
812 @code{font-interface}.
814 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
815 de los interfaces, y descubrir qué objetos usan estas propiedades de
818 Mire de nuevo la página del RFI que describe a LyricText. Al final de
819 la página hay una lista de enlaces a los interfaces que LyricText
820 contempla. La lista tiene siete elementos, entre ellos
821 @code{font-interface}. Al seguir este enlace llegamos a las
822 propiedades asociadas con este interface, que también son propiedades
823 de todos los objetos que lo llevan, entre ellos LyricText.
825 Ahora vemos todas las propiedades ajustables por el usuario que
826 controlan las tipografías, entre ellas @code{font-shape(symbol)},
827 donde @code{symbol} se puede establecer a @code{upright} (recta),
828 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
830 Observará que @code{font-series} y @code{font-size} también se
831 encuentran aquí relacionadas. Esto inmediatamente hace que surja la
832 pregunta: ¿Por qué están las propiedades comunes de tipografía
833 @code{font-series} y @code{font-size} relacionadas bajo
834 @code{LyricText} así como bajo el interface @code{font-interface} pero
835 @code{font-shape} no lo está? La respuesta es que @code{font-series}
836 y @code{font-size} se cambian a partir de sus valores predeterminados
837 globales cuando se crea un objeto @code{LyricText}, pero
838 @code{font-shape} no lo hace. Entonces los elementos de la lista
839 @code{LyricText} le dicen los valores para esas dos propiedades que
840 son de aplicación para @code{LyricText}. Otros objetos que contemplan
841 @code{font-interface} establecerán dichas propiedades de forma
842 diferente cuando se crean.
844 Veamos si ahora podemos construir la instrucción @code{\override} para
845 cambiar la letra a cursiva. El objeto es @code{LyricText}, la
846 propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
847 antes, omitiremos el contexto.
849 Como nota aparte, aunque una nota importante, observe que a causa de
850 que los valores de @code{font-shape} son símbolos, deben ir precedidos
851 de un apóstrofo, @code{'}. Esa es la razón por la que se necesitan
852 apóstrofos antes de @code{thickness} en el ejemplo anterior y en
853 @code{font-shape}. Los dos son también símbolos. Los símbolos son
854 nombres especiales que son conocidos por LilyPond internamente.
855 Algunos de ellos son nombres de propiedades, como @code{thickness} o
856 @code{font-shape}, otros se utilizan como valores que se les puede dar
857 a las propiedades, como @code{italic}. Observe la distinción entre
858 esto y las cadenas de texto arbitrarias, que aparecerían
859 entrecomilladas como @code{"a text string"}. Para ver más detalles
860 relacionados con los símbolos y las cadenas, consulte @ref{Tutorial de Scheme}.
862 Así pues, la instrucción @code{\override} necesaria para imprimir la
863 letra en cursiva, es:
866 \override LyricText #'font-shape = #'italic
870 Esto debe escribirse justo delante de la letra a la que debe afectar,
873 @cindex font-shape, propiedad, ejemplo
874 @cindex italic, ejemplo
875 @cindex LyricText, ejemplo de sobreescritura
876 @cindex @code{\addlyrics}, ejemplo
878 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
883 g[( e]) e d[( f]) a |
887 \override LyricText #'font-shape = #'italic
888 The man who feels love's sweet e -- mo -- tion
894 y toda la letra se imprime en cursiva.
896 @subheading Especificación del contexto en modo letra
898 @cindex contexto, especificación en modo letra
899 @cindex letra, modo, especificar el contexto en
901 En el caso de la letra, si intenta especificar el contexto en el
902 formato que acabamos de dar, la instrucción no funcionará. Una
903 sílaba escrita en el modo letra, «lyricmode» termina en un espacio, un
904 salto de línea o un dígito. Cualquier otro carácter se incluye como
905 parte de la sílaba. Por esta razón, un espacio o salto de línea debe
906 aparecer antes del último símbolo @code{@}} para evitar que se incluya
907 como parte de la sílaba final. De forma similar, se deben insertar
908 espacios antes y después del punto, @q{.}, separando el nombre del
909 contexto del nombre del objeto, pues en caso contrario los dos nombres
910 se juntarán y el intérprete no podrá reconocerlos. Así pues, la
914 \override Lyrics . LyricText #'font-shape = #'italic
917 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
918 final y la llave de cierre.}
920 @warning{En las sobreescrituras con override dentro de la letra,
921 escriba siempre espacios antes y después del punto que separa el
922 nombre del contexto y el nombre del objeto.}
926 Manual de aprendizaje:
927 @ref{Tutorial de Scheme}.
930 @node Tipos de propiedades
931 @subsection Tipos de propiedades
932 @translationof Types of properties
934 @cindex propiedades, tipos de
936 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
937 @code{símbolo}. Para que sea válido, el valor que se da a una
938 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
939 tipo. El tipo de la propiedad se muestra siempre entre paréntesis
940 después del nombre de la propiedad en el RFI. He aquí una lista de
941 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
942 algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
943 @code{#}, por supuesto, delante de estos valores cuando se introducen
944 en la instrucción @code{\override}.
946 @multitable @columnfractions .2 .45 .35
947 @headitem Tipo de propiedad
951 @tab Verdadero o Falso, representado por #t o #f
952 @tab @code{#t}, @code{#f}
953 @item Dimensión (en espacios de pentagrama)
954 @tab Un número decimal positivo (en unidades de espacios de pentagrama)
955 @tab @code{2.5}, @code{0.34}
957 @tab Una constante válida de dirección o su equivalente numérico (se permiten valores decimales entre -1 y 1)
958 @tab @code{LEFT}, @code{CENTER}, @code{UP},
961 @tab Un número entero positivo
962 @tab @code{3}, @code{1}
964 @tab Un conjunto de valores separados por espacios, encerrado entre paréntesis y precedido de un apóstrofo
965 @tab @code{'(left-edge staff-bar)}, @code{'(1)},
966 @code{'(1.0 0.25 0.5)}
968 @tab Cualquier elemento válido de marcado de texto
969 @tab @code{\markup @{ \italic "cresc." @}}
971 @tab Una fracción de redonda construida con la función make-moment
972 @tab @code{(ly:make-moment 1 4)},
973 @code{(ly:make-moment 3 8)}
975 @tab Cualquier valor decimal positivo o negativo
976 @tab @code{3.5}, @code{-2.45}
977 @item Pareja (de números)
978 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
979 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
981 @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
982 @tab @code{'italic}, @code{'inside}
984 @tab Un procedimiento o @code{#f} para no producir ninguna acción
985 @tab @code{bend::print}, @code{ly:text-interface::print},
988 @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofo-almohadilla, @code{'#}.
989 @tab @code{'#(#t #t #f)}
994 Manual de aprendizaje:
995 @ref{Tutorial de Scheme}.
998 @node Apariencia de los objetos
999 @section Apariencia de los objetos
1000 @translationof Appearance of objects
1002 Ahora vamos a poner en práctica lo que hemos aprendido con unos
1003 cuantos ejemplos que muestran cómo se pueden usar los trucos para
1004 cambiar el aspecto de la música impresa.
1007 * Visibilidad y color de los objetos::
1008 * Tamaño de los objetos::
1009 * Longitud y grosor de los objetos::
1012 @node Visibilidad y color de los objetos
1013 @subsection Visibilidad y color de los objetos
1014 @translationof Visibility and color of objects
1016 Dentro de un uso educativo de la música, podríamos desear imprimir una
1017 partitura con ciertos elementos omitidos como ejercicio para el
1018 alumno, a quien se le pide que los complete. A la manera de ejemplo
1019 sencillo, supongamos que el ejercicio es escribir las líneas
1020 divisorias que faltan en un fragmento musical. Pero las líneas
1021 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
1024 Antes de enredarnos con esto, recordemos que las propiedades de los
1025 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
1026 @ref{Propiedades de los interfaces}). Esto es simplemente agrupar
1027 las propiedades que se pueden usar juntas para trucar un objeto
1028 gráfico: si una de ellas se necesita para un objeto, también las
1029 otras. Así, ciertos objetos usan las propiedades de algunos
1030 interfaces, otros usan las de otros interfaces. Los interfaces que
1031 contienen las propiedades que un determinado grob necesita se
1032 encuentran relacionadas en el manual RFI al final de la página que
1033 describe dicho grob, y esas propiedades se pueden ver mirando dichos
1036 Hemos explicado cómo encontrar información sobre los grobs en
1037 @ref{Propiedades de los objetos de presentación}. Usando el mismo enfoque, vamos al
1038 RFI para buscar el objeto de presentación que imprime las líneas
1039 divisorias. A través del enlace @emph{Backend} y @emph{All layout
1040 objects} encontramos que hay un objeto de presentación llamado
1041 @code{BarLine}. Entre sus propiedades se encuentran dos que controlan
1042 la visibilidad: @code{break-visibility} y @code{stencil}. Las líneas
1043 divisorias también contemplan un número de interfaces, entre ellos el
1044 @code{grob-interface}, donde podemos encontrar las propiedades
1045 @code{transparent} y @code{color}. Todas ellas pueden afectar la
1046 visibilidad de las barras de compás (y, por supuesto, por extensión,
1047 también la de muchos otros objetos de presentación). Vamos a
1048 considerar cada uno de ellos por orden.
1050 @subheading stencil (sello)
1052 @cindex stencil (sello), propiedad
1054 Esta propiedad controla la apariencia de las barras de compás mediante
1055 la especificación del símbolo (o «glifo») que se debe imprimir. Igual
1056 que como otras muchas propiedades, se puede establecer de forma que no
1057 imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
1058 antes, omitiendo el Contexto implícito, @code{Voice}:
1060 @cindex BarLine, ejemplo de sobreescritura
1061 @cindex stencil, propiedad, ejemplo
1063 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1066 \override BarLine #'stencil = ##f
1068 g, a16 b8 c d4 e16 |
1073 Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
1074 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
1075 objeto BarLine. Al principio de la página dice @qq{Barline objects
1076 are created by: Bar_engraver} (los objetos Barline se crean por el
1077 grabador Bar_engraver). Vaya a la página del grabador
1078 @code{Bar_engraver} siguiendo el enlace. Al final da una lista de
1079 contextos en los que el grabador de líneas divisorias opera. Todos
1080 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
1081 @code{\override} no funcionara como esperábamos, es porque
1082 @code{Barline} no se encuentra en el contexto predeterminado
1083 @code{Voice}. Si el contexto no se especifica correctamente, la
1084 instrucción simplemente no funciona. No se produce ningún mensaje de
1085 error, y no se registra nada en el archivo log de registro. Vamos a
1086 intentar corregirlo escribiendo el contexto correcto:
1088 @cindex BarLine, ejemplo de sobreescritura
1089 @cindex stencil, propiedad, ejemplo
1091 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1094 \override Staff.BarLine #'stencil = ##f
1096 g, a16 b8 c d4 e16 |
1101 Ahora las barras de compás han desaparecido.
1103 Sin embargo, observe que el establecimiento de la propiedad
1104 @code{stencil} al valor @code{#f} produce errores cuando las se
1105 requieren las dimensiones del objeto para un procesamiento correcto.
1106 Por ejemplo, se generan errores si la propiedad @code{stencil} del
1107 objeto @code{NoteHead} se establece al valor @code{#f}. Si es el
1108 caso, podemos en vez de ello utilizar la función @code{point-stencil},
1109 que establece el sello a un objeto con tamaño nulo:
1111 @lilypond[quote,verbatim,relative=2]
1114 \once \override NoteHead #'stencil = #point-stencil
1119 @subheading break-visibility (visibilidad en el salto)
1121 @cindex break-visibility, propiedad
1123 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI que
1124 la propiedad @code{break-visibility} requiere un vector de tres
1125 valores booleanos. Controlan respectivamente si las barras de compás
1126 se imprimen al final de una línea, en mitad de una línea, y al
1127 principio de las líneas. Para nuestro ejemplo, queremos que todas las
1128 barras de compás se supriman, por lo que el valor que necesitamos es
1129 @code{'#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
1130 de @code{Staff}. Observe también que al escribir este valor tenemos
1131 @code{#'#} antes del paréntesis de apertura. Se necesita @code{'#}
1132 como parte del valor para introducir un vector, y el primer símbolo de
1133 almohadilla @code{#} se necesita, como siempre, para preceder el valor
1134 en sí dentro de la instrucción @code{\override}.
1136 @cindex BarLine, ejemplo de sobreescritura
1137 @cindex break-visibility, propiedad, ejemplo
1139 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1142 \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
1144 g, a16 b8 c d4 e16 |
1149 Y podemos ver que esto también quita todas las líneas divisorias.
1151 @subheading transparent (transparente)
1153 @cindex transparent, propiedad
1154 @cindex transparencia
1156 En la relación de propiedades que se especifican en la página del
1157 @code{grob-interface} del RFI podemos ver que la propiedad
1158 @code{transparent} es un valor booleano. Esto se debe establecer a
1159 @code{#t} para hacer que el grob sea transparente. En el ejemplo
1160 siguiente vamos a hacer que la indicación de compás, y no las líneas
1161 divisorias, sea transparente. Para hacerlo tenemos que buscar el
1162 nombre del grob de la indicación de compás. Volviendo a la página
1163 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1164 presentación @code{TimeSignature}. Se produce por parte del grabador
1165 @code{Time_signature_engraver} que como puede comprobar vive dentro
1166 del contexto de @code{Staff} y también contempla el interface
1167 @code{grob-interface}. Así pues, la instrucción que hace transparente
1168 a la indicación de compás es:
1170 @cindex TimeSignature, ejemplo de sobreescritura
1171 @cindex transparent, propiedad, ejemplo
1173 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1176 \override Staff.TimeSignature #'transparent = ##t
1178 g, a16 b8 c d4 e16 |
1184 El compás ya no está, pero esta instrucción deja una separación en el
1185 lugar donde antes estaba la indicación de compás. Quizá esto es lo
1186 que queremos para un ejercicio en que el alumno deba escribirlo, pero
1187 en otras circunstancias esta separación podría no ser deseable. En
1188 vez de eso, para quitarla, el stencil o «sello» de la indicación de
1189 compás se debe establecer al valor @code{#f}:
1191 @cindex TimeSignature, ejemplo de sobreescritura
1192 @cindex stencil, propiedad, ejemplo
1194 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1197 \override Staff.TimeSignature #'stencil = ##f
1199 g, a16 b8 c d4 e16 |
1205 y la diferencia es obvia: al establecer el sello al valor @code{#f}
1206 quitamos el objeto por completo; al hacer el objeto @code{transparent}
1207 lo dejamos donde está, pero lo hacemos invisible.
1211 @cindex color, propiedad
1213 Para finalizar, intentemos hacer invisibles las barras de compás
1214 pintándolas de color blanco (hay un problema relacionado, que consiste
1215 en que la línea divisoria blanca puede tapar o no tapar las líneas del
1216 pentagrama a las que cruza. Podrá observar en algunos de los ejemplos
1217 que aparecen a continuación, que esto sucede de forma impredecible.
1218 Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
1219 estudian en @ruser{Pintar los objetos de blanco}; de momento estamos
1220 estudiando el color, por lo que le rogamos que acepte esta limitación
1223 El interface @code{grob-interface} especifica que la propiedad del
1224 color es una lista, pero no hay ninguna explicación sobre lo que debe
1225 ir en esa lista. La lista que requiere es realmente una lista de
1226 valores en unidades internas, pero para evitar tener que saber cuáles
1227 son, se ofrecen varias vías para la especificación de los colores. La
1228 primera forma es utilizar uno de los colores @q{normales} que están
1229 relacionados en la primera tabla de la @ruser{Lista de colores}. Para
1230 poner las líneas divisorias de color blanco, escribimos:
1232 @cindex BarLine, ejemplo de sobreescritura
1233 @cindex color, propiedad, ejemplo
1235 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1238 \override Staff.BarLine #'color = #white
1240 g, a16 b8 c d4 e16 |
1246 y de nuevo podemos comprobar que las barras de compás no son visibles.
1247 Observe que @emph{white} no viene precedido de un apóstrofo: no es un
1248 símbolo, sino una @emph{función}. Cuando se invoca, proporciona la
1249 lista de valores internos que se requieren para establecer el color a
1250 blanco. Los otros colores de la lista normal también son funciones.
1251 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1252 una de las otras funciones de la lista.
1254 @cindex colores de X11
1255 @cindex X11, colores de
1259 La segunda forma de cambiar el color es utilizar la lista de nombres
1260 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
1261 convierte los nombres de colores de X11 en la lista de valores
1262 internos, @code{x11-color}, de la siguiente manera:
1264 @cindex BarLine, ejemplo de sobreescritura
1265 @cindex color, propiedad, ejemplo
1267 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1270 \override Staff.BarLine #'color = #(x11-color 'white)
1272 g, a16 b8 c d4 e16 |
1278 Observe que en este caso la función @code{x11-color} toma un símbolo
1279 como argumento, así que el símbolo debe ir precedido de un apóstrofo y
1280 los dos deben ir entre paréntesis.
1282 @cindex rgb, colores
1287 Aún hay una tercera función, que convierte valores RGB en colores
1288 internos: la función @code{rgb-color}. Toma tres argumentos que dan
1289 las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
1290 valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
1291 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1292 @code{(rgb-color 1 1 1)}:
1294 @cindex BarLine, ejemplo de sobreescritura
1295 @cindex color, propiedad, ejemplo
1297 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1300 \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1302 g, a16 b8 c d4 e16 |
1307 Finalmente, existe también una escala de grises como parte del
1308 conjunto de colores de X11. Varían desde el negro, @code{'grey0'},
1309 hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
1310 estableciendo todos los objetos de presentación de nuestro ejemplo a
1311 varias gradaciones de gris:
1313 @cindex StaffSymbol, ejemplo de sobreescritura
1314 @cindex TimeSignature, ejemplo de sobreescritura
1315 @cindex Clef, ejemplo de sobreescritura
1316 @cindex NoteHead, ejemplo de sobreescritura
1317 @cindex Stem, ejemplo de sobreescritura
1318 @cindex BarLine, ejemplo de sobreescritura
1319 @cindex color property, ejemplo
1320 @cindex x11-color, ejemplo de utilización
1322 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1325 \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
1326 \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1327 \override Staff.Clef #'color = #(x11-color 'grey60)
1328 \override Voice.NoteHead #'color = #(x11-color 'grey85)
1329 \override Voice.Stem #'color = #(x11-color 'grey85)
1330 \override Staff.BarLine #'color = #(x11-color 'grey10)
1332 g, a16 b8 c d4 e16 |
1338 Observe los contextos asociados con cada uno de los objetos de
1339 presentación. Es importante que estén correctamente escritos, o las
1340 instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
1341 que se encuentra el grabador correspondiente. El contesto
1342 predeterminado para los grabadores puede encontrarse empezando por el
1343 objeto de presentación, de ahí al grabador que lo produce, y en la
1344 página del grabador del RFI aparece en qué contexto se puede encontrar
1345 normalmente el grabador.
1348 @node Tamaño de los objetos
1349 @subsection Tamaño de los objetos
1350 @translationof Size of objects
1352 @cindex cambiar el tamaño de los objetos
1353 @cindex tamaño de los objetos
1354 @cindex objetos, tamaño de
1355 @cindex objetos, cambiar el tamaño de
1357 Empezaremos examinando de nuevo un ejemplo anterior (véase
1358 @ref{Anidado de expresiones musicales}) que nos mostraba cómo introducir un
1359 pentagrama temporal, como en un @rglos{ossia}.
1361 @cindex alignAboveContext, propiedad, ejemplo
1362 @cindex @code{\with}, ejemplo
1364 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1365 \new Staff ="main" {
1372 alignAboveContext = #"main" }
1380 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1381 por lo normal se imprimen más pequeños que el pentagrama principal.
1382 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1383 el sello de cada uno de ellos a @code{#f}, como sigue:
1385 @cindex alignAboveContext, propiedad, ejemplo
1386 @cindex @code{\with}, ejemplo
1387 @cindex stencil, propiedad, ejemplo
1388 @cindex Clef, ejemplo de sobreescritura
1389 @cindex TimeSignature, ejemplo de sobreescritura
1391 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1392 \new Staff ="main" {
1399 alignAboveContext = #"main"
1402 \override Staff.Clef #'stencil = ##f
1403 \override Staff.TimeSignature #'stencil = ##f
1413 donde el par de llaves adicional después de la cláusula @code{\with}
1414 es necesario para asegurar que la sobreescritura encerrada y la música
1415 se aplican al pentagrama de ossia.
1417 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1418 usando @code{\with} y modificar los sellos de clave y de compás con
1419 \override? La diferencia principal es que los cambios que se realizan
1420 en una cláusula @code{\with} se hacen en el momento en que se crea el
1421 contexto, y permanecen activos como valores @strong{predeterminados}
1422 durante toda la duración de dicho contexto, mientras que las
1423 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1424 música son dinámicas: hacen cambios sincronizados con un punto
1425 concreto de la música. Si los cambios se deshacen o se devuelven
1426 mediante @code{\unset} o @code{\revert} volverán a su valor
1427 predeterminado que será el establecido en la cláusula @code{\with}, o
1428 si no se ha establecido ninguno en este lugar, los valores
1429 predeterminados normales.
1431 Ciertas propiedades de contexto se pueden modificar solamente dentro
1432 de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
1433 cambiar después de que el contexto se ha creado.
1434 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1435 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1436 alineación está decidida y no tendría sentido intentar cambiarla más
1439 Los valores predeterminados de las propiedades de los objetos de
1440 presentación también se pueden establecer dentro de cláusulas
1441 @code{\with}. Simplemente utilice la instrucción @code{\override}
1442 normal dejando aparte el nombre del contexto, ya que está definido sin
1443 ambigüedad como el contexto que la cláusula @code{\with} está
1444 modificando. De hecho, se producirá un error si se especifica un
1445 contexto en este lugar.
1447 Así pues, podemos reemplazar el ejemplo anterior con
1449 @cindex alignAboveContext, propiedad, ejemplo
1450 @cindex @code{\with}, example
1451 @cindex Clef, ejemplo de sobreescritura
1452 @cindex TimeSignature, ejemplo de sobreescritura
1454 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1455 \new Staff ="main" {
1462 alignAboveContext = #"main"
1463 % Don't print clefs in this staff
1464 \override Clef #'stencil = ##f
1465 % Don't print time signatures in this staff
1466 \override TimeSignature #'stencil = ##f
1475 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1478 Ciertos objetos de presentación se crean como glifos sacados de una
1479 fuente tipográfica. Entre ellos se encuentran las cabezas,
1480 alteraciones, elementos de marcado, claves, indicaciones de compás,
1481 indicaciones dinámicas y la letra de las canciones. Su tamaño se
1482 cambia mediante la modificación de la propiedad @code{font-size}, como
1483 veremos en breve. Otros objetos de presentación como ligaduras de
1484 unión y de expresión (en general, objetos de extensión) se trazan
1485 individualmente, por lo que no hay un tamaño de tipografía
1486 @code{font-size} asociado a ellos. Estos objetos generalmente derivan
1487 su tamaño de los objetos a los que están adosados, y por ello
1488 normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
1489 otras propiedades como la longitud de las plicas y las barras de
1490 compás, el grosor de las barras de corchea y otras líneas, y la
1491 separación de las líneas del pentagrama se deben modificar de otras
1494 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1495 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1496 cambiar el tamaño de las tipografías de cada uno de los tipos de
1497 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1500 \override NoteHead #'font-size = #-2
1503 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1504 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1505 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1512 Los dos enunciados producirían una reducción del tamaño de la
1513 tipografía en dos pasos a partir de su valor previo, donde cada paso
1514 reduce o aumenta el tamaño aproximadamente en un 12%.
1516 Vamos a probarlo en nuestro ejemplo del ossia:
1518 @cindex alignAboveContext, propiedad, ejemplo
1519 @cindex @code{\with}, ejemplo
1520 @cindex Clef, ejemplo de sobreescritura
1521 @cindex TimeSignature, ejemplo de sobreescritura
1522 @cindex fontSize, propiedad, ejemplo
1524 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1525 \new Staff ="main" {
1532 alignAboveContext = #"main"
1533 \override Clef #'stencil = ##f
1534 \override TimeSignature #'stencil = ##f
1535 % Reduce all font sizes by ~24%
1545 Aún no está demasiado bien. Las cabezas y los corchetes de las notas
1546 son más pequeños, pero las plicas son demasiado largas en proporción,
1547 y las líneas del pentagrama están demasiado separadas entre sí. Se
1548 debe reducir su escala en proporción a la reducción de la tipografía.
1549 El siguiente apartado trata sobre cómo se hace esto.
1551 @node Longitud y grosor de los objetos
1552 @subsection Longitud y grosor de los objetos
1553 @translationof Length and thickness of objects
1559 @cindex tamaño, cambiar
1560 @cindex plica, cambiar la longitud
1561 @cindex pentagrama, cambiar la separación de las líneas
1563 Las distancias y longitudes en LilyPond se miden generalmente en
1564 espacios de pentagrama, la distancia entre líneas adyacentes de la
1565 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1566 de las propiedades de @code{thickness} (grosor) se miden en unidades
1567 de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
1568 de forma predeterminada, a las líneas de los reguladores se les da un
1569 grosor de 1 unidad de @code{line-thickness}, mientras que el
1570 @code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
1571 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1572 barras de corchea se mide en espacios de pentagrama.
1574 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1575 tamaño de la tipografía? Se puede hacer con la ayuda de una función
1576 especial que se llama @code{magstep}, pensada especialmente para este
1577 propósito. Toma un argumento, el cambio de tamaño de la tipografía
1578 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1579 para reducir otros objetos en la misma proporción. Se usa de la
1582 @cindex alignAboveContext, propiedad, ejemplo
1583 @cindex @code{\with}, ejemplo
1584 @cindex Clef, ejemplo de sobreescritura
1585 @cindex TimeSignature, ejemplo de sobreescritura
1586 @cindex fontSize, propiedad, ejemplo
1587 @cindex StaffSymbol, ejemplo de sobreescritura
1588 @cindex magstep, función, ejemplo de utilización
1589 @cindex staff-space, propiedad, ejemplo
1590 @cindex stencil, propiedad, ejemplo
1592 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1593 \new Staff ="main" {
1600 alignAboveContext = #"main"
1601 \override Clef #'stencil = ##f
1602 \override TimeSignature #'stencil = ##f
1604 % Reduce stem length and line spacing to match
1605 \override StaffSymbol #'staff-space = #(magstep -2)
1615 Puesto que la longitud de las plicas y muchas otras propiedades
1616 relacionadas con la longitudes calculan siempre con relación al valor
1617 de la propiedad @code{staff-space}, su longitud también ve reducida su
1618 escala automáticamente. Observe que esto afecta solamente a la escala
1619 vertical del ossia: la escala horizontal se determina por medio de la
1620 disposición de la música principal con el objeto de mantenerse en
1621 sincronía con ella, de forma que no resulte afectada por ninguno de
1622 estos cambios de tamaño. Por supuesto, si la escala de toda la música
1623 principal se cambiase de esta forma, entonces el espaciado horizontal
1624 se vería afectado. Trataremos de esto más tarde en la sección sobre
1627 Esto, en fin, completa la creación de un ossia. Los tamaños y
1628 longitudes del resto de los objetos se pueden modificar de manera
1631 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1632 grosor de las diversas líneas dibujadas como divisorias, barras de
1633 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1634 ajuste global. Si el grosor de cualquier objeto de presentación en
1635 particular necesita ajustarse, se puede hacer mejor mediante la
1636 sobreescritura de su propiedad @code{thickness}. Anteriormente
1637 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1638 @ref{Propiedades de los objetos de presentación}. El grosor de todos los objetos
1639 trazados (es decir, aquellos que no se producen a partir de una
1640 tipografía) se pueden cambiar de la misma forma.
1643 @node Colocación de los objetos
1644 @section Colocación de los objetos
1645 @translationof Placement of objects
1648 * Comportamiento automático::
1649 * Objetos interiores al pentagrama::
1650 * Objetos fuera del pentagrama::
1654 @node Comportamiento automático
1655 @subsection Comportamiento automático
1656 @translationof Automatic behaviour
1658 @cindex dentro del pentagrama, objetos
1659 @cindex fuera del pentagrama, objetos
1660 @cindex objetos dentro del pentagrama
1661 @cindex objetos fuera del pentagrama
1663 Hay ciertos objetos en notación musical que pertenecen al pentagrama y
1664 otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
1665 objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
1668 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1669 pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
1670 se fijan por la propia música; se posicionan verticalmente sobre
1671 líneas específicas del pentagrama o están unidos a otros objetos
1672 posicionados de esta forma. Las colisiones entre cabezas, plicas y
1673 alteraciones en acordes de notas muy juntas, normalmente se evitan
1674 automáticamente. Hay instrucciones y sobreescrituras que pueden
1675 modificar este comportamiento automático, como veremos en breve.
1677 Entre los objetos que pertenecen al exterior de la pauta se encuentran
1678 cosas como las marcas de ensayo, las marcas de texto y las de
1679 dinámica. La regla de LilyPond para la colocación vertical de los
1680 objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
1681 como sea posible, pero no tan cerca como para que puedan chocar con
1682 algún otro objeto. LilyPond utiliza la propiedad
1683 @code{outside-staff-priority} para determinar el orden en que se deben
1684 situar los objetos, como veremos ahora.
1686 En primer lugar, LilyPond sitúa todos los objetos
1687 dentro-del-pentagrama. Después ordena los objetos
1688 fuera-del-pentagrama de acuerdo con su prioridad
1689 @code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
1690 toman de uno en uno, comenzando por el que tiene la prioridad
1691 @code{outside-staff-priority} más baja, y se sitúan de forma que no
1692 colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
1693 grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
1694 la prioridad @code{outside-staff-priority} más baja se colocará más
1695 cerca del pentagrama. Si dos objetos tienen la misma
1696 @code{outside-staff-priority}, el que se ha encontrado primero se
1697 situará más cerca de la pauta.
1699 En el siguiente ejemplo, todos los textos de marcado tienen la misma
1700 prioridad (pues no se ha establecido explícitamente). Observe que
1701 @q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
1702 acomodado por debajo de @q{Text2}.
1704 @cindex markup, ejemplo
1706 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1713 Los pentagramas también se posicionan, de forma predeterminada, tan
1714 cerca unos de otros como sea posible (sujeto a una separación mínima).
1715 Si las notas se proyectan muy lejos en dirección a un pentagrama
1716 adyacente, forzarán a alejarse a los pentagramas sólo si en caso
1717 contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
1718 siguiente muestra esta acomodación @q{nestling} de las notas sobre
1719 pentagramas adyacentes:
1721 @lilypond[quote,ragged-right,verbatim]
1724 \relative c' { c a, }
1727 \relative c'''' { c a, }
1733 @node Objetos interiores al pentagrama
1734 @subsection Objetos interiores al pentagrama
1735 @translationof Within-staff objects
1737 Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la
1738 dirección de las ligaduras de expresión y de unión, digitaciones y
1739 todo lo demás que dependa de la dirección de las plicas. Cuando se
1740 escribe música polifónica, estas instrucciones son esenciales para que
1741 puedan distinguirse varias líneas melódicas entrelazadas. Pero
1742 ocasionalmente puede ser necesario sobreescribir este comportamiento
1743 automático. Se puede hacer por secciones de música completas o
1744 incluso para una nota individual. La propiedad que controla este
1745 comportamiento es la propiedad de @code{direction} (dirección) de cada
1746 objeto de presentación. En primer lugar explicaremos qué hace esto, y
1747 luego introduciremos algunas instrucciones listas para usar que le
1748 evitarán tener que codificar sobreescrituras explícitas para las
1749 modificaciones más comunes.
1751 Algunos objetos de presentación como las ligaduras se curvan hacia
1752 arriba o hacia abajo; otros como las plicas y los corchetes también se
1753 mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
1754 hacia abajo. Esto se controla automáticamente cuando está establecida
1755 la propiedad @code{direction}.
1766 El ejemplo siguiente muestra en el compás 1 el comportamiento
1767 predeterminado de las plicas, con las de las notas agudas apuntando
1768 hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
1769 todas las plicas forzadas hacia abajo, cuatro notas con las plicas
1770 forzadas hacia arriba, y por último cuatro notas devueltas al
1771 comportamiento predeterminado.
1773 @cindex Stem, ejemplo de sobreescritura
1774 @cindex direction, propiedad, ejemplo
1776 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1778 \override Stem #'direction = #DOWN
1780 \override Stem #'direction = #UP
1782 \revert Stem #'direction
1786 Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
1787 (arriba). Éstos tienen los valores @code{-1} y @code{+1}
1788 respectivamente, y dichos valores numéricos también se pueden usar
1789 directamente. El valor @code{0} también se puede usar en algunos
1790 casos. Se trata simplemente con el significado de @code{UP} para las
1791 plicas, pero para algunos objetos tiene el significado de
1792 @q{centrado}. Existe una constante @code{CENTER} que tiene el valor
1795 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
1796 están disponibles instrucciones predefinidas equivalentes más
1797 sencillas. Aquí podemos ver una tabla de las más comunes. Se
1798 menciona el significado de cada una allí donde no es obvio.
1800 @multitable @columnfractions .2 .2 .25 .35
1801 @headitem Abajo o Izquierda
1802 @tab Arriba o Derecha
1805 @item @code{\arpeggioArrowDown}
1806 @tab @code{\arpeggioArrowUp}
1807 @tab @code{\arpeggioNormal}
1808 @tab La flecha está abajo, arriba o no hay flecha
1809 @item @code{\dotsDown}
1811 @tab @code{\dotsNeutral}
1812 @tab Dirección del desplazamiento para evitar las líneas del pentagrama
1813 @item @code{\dynamicDown}
1814 @tab @code{\dynamicUp}
1815 @tab @code{\dynamicNeutral}
1817 @item @code{\phrasingSlurDown}
1818 @tab @code{\phrasingSlurUp}
1819 @tab @code{\phrasingSlurNeutral}
1820 @tab Nota: diferente de las instrucciones de ligaduras de expresión
1821 @item @code{\slurDown}
1823 @tab @code{\slurNeutral}
1825 @item @code{\stemDown}
1827 @tab @code{\stemNeutral}
1829 @item @code{\textSpannerDown}
1830 @tab @code{\textSpannerUp}
1831 @tab @code{\textSpannerNeutral}
1832 @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
1833 @item @code{\tieDown}
1835 @tab @code{\tieNeutral}
1837 @item @code{\tupletDown}
1838 @tab @code{\tupletUp}
1839 @tab @code{\tupletNeutral}
1840 @tab Los grupos especiales están debajo o encima de las notas
1843 Observe que estas instrucciones predefinidas @strong{no} pueden ir
1844 precedidas de @code{\once}. Si quiere limitar el efecto a una sola
1845 nota, deberá elegir entre usar la instrucción @code{\once \override}
1846 equivalente, o usar la instrucción predefinida, seguida después de la
1847 nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
1849 @subheading Digitaciones
1851 @cindex digitación, colocación
1852 @cindex digitación de acordes
1854 La colocación de las digitaciones sobre notas sueltas también se puede
1855 controlar mediante la propiedad @code{direction}, pero los cambios
1856 sobre @code{direction} no tienen ningún efecto sobre las notas de los
1857 acordes. Como veremos, existen instrucciones especiales que permiten
1858 controlar las digitaciones de notas individuales, situando la
1859 digitación encima, debajo, a la izquierda o a la derecha de cada nota.
1861 En primer lugar, he aquí el efecto de @code{direction} sobre las
1862 digitaciones aplicadas a notas sueltas. Se muestra en el primer
1863 compás el comportamiento predeterminado, y en los dos compases
1864 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
1866 @cindex Fingering, ejemplo de sobreescritura
1867 @cindex direction, propiedad, ejemplo
1869 @lilypond[quote,verbatim,relative=2]
1871 \override Fingering #'direction = #DOWN
1873 \override Fingering #'direction = #UP
1877 Sin embargo, la sobreescritura de la propiedad @code{direction} no es
1878 la forma más sencilla de especificar manualmente la digitación por
1879 encima o por debajo de las notas; suele ser preferible usar @code{_} o
1880 @code{^} en lugar de @code{-}, antes del número de la digitación.
1881 Este es el ejemplo anterior utilizando este método:
1883 @cindex fingering, ejemplo
1884 @cindex digitación, ejemplo
1886 @lilypond[quote,verbatim,relative=2]
1892 La propiedad @code{direction} se ignora para los acordes, pero los
1893 prefijos direccionales @code{_} y @code{^} sí funcionan. De forma
1894 predeterminada, las digitaciones se colocan automáticamente encima y
1895 debajo de las notas de un acorde, como se muestra aquí:
1897 @cindex fingering, ejemplo
1898 @cindex digitación, ejemplo
1900 @lilypond[quote,verbatim,relative=2]
1907 pero se puede forzar de manera que todos o algunos de los números de
1908 digitación estén por encima o por debajo:
1910 @cindex fingering, ejemplo
1911 @cindex digitación, ejemplo
1913 @lilypond[quote,verbatim,relative=2]
1919 Es posible ejercer un control aún mayor sobre la colocación de las
1920 digitaciones mediante la utilización de la instrucción @code{\set
1921 fingeringOrientations}. El formato de esta instrucción es:
1924 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
1928 se utiliza @code{\set} porque @code{fingeringOrientations} es una
1929 propiedad del contexto @code{Voice}, creado y usado por el grabador
1930 @code{New_fingering_engraver}.
1932 La propiedad se puede establecer al valor de una lista de entre uno y
1933 tres valores. Controla si las digitaciones se pueden colocar por
1934 encima (si @code{up} aparece en la lista), por debajo (si aparece
1935 @code{down}), a la izquierda (si aparece @code{left}) o a la derecha
1936 (si aparece @code{right}). A la inversa, si una colocación no está en
1937 la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
1938 coma estas restricciones y se trabaja la mejor colocación para la
1939 digitación de las notas de los acordes que siguen. Observe que
1940 @code{left} y @code{right} son mutuamente excluyentes: las
1941 digitaciones pueden situarse en un lado o en el otro, no en los dos.
1943 @warning{Para controlar la colocación de la digitación de una sola
1944 nota usando esta instrucción es necesario escribirla como un acorde de
1945 una sola nota encerrándola entre ángulos simples.}
1947 Aquí podemos ver algunos ejemplos:
1949 @cindex fingering, ejemplo
1950 @cindex digitación, ejemplo
1951 @cindex @code{\set}, ejemplo de utilización
1952 @cindex fingeringOrientations, propiedad, ejemplo
1954 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1955 \set fingeringOrientations = #'(left)
1957 < c-1 e-2 g-3 b-5 > 4
1958 \set fingeringOrientations = #'(left)
1960 < c-1 e-2 g-3 b-5 > 4
1961 \set fingeringOrientations = #'(up left down)
1963 < c-1 e-2 g-3 b-5 > 4
1964 \set fingeringOrientations = #'(up left)
1966 < c-1 e-2 g-3 b-5 > 4
1967 \set fingeringOrientations = #'(right)
1969 < c-1 e-2 g-3 b-5 > 4
1973 Si la digitación parece un poco superpoblada, se puede reducir el
1974 tamaño @code{font-size}. El valor predeterminado puede verse en el
1975 objeto @code{Fingering} del RFI que es @code{-5}, así que probaremos
1978 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1979 \override Fingering #'font-size = #-7
1980 \set fingeringOrientations = #'(left)
1982 < c-1 e-2 g-3 b-5 > 4
1983 \set fingeringOrientations = #'(left)
1985 < c-1 e-2 g-3 b-5 > 4
1986 \set fingeringOrientations = #'(up left down)
1988 < c-1 e-2 g-3 b-5 > 4
1989 \set fingeringOrientations = #'(up left)
1991 < c-1 e-2 g-3 b-5 > 4
1992 \set fingeringOrientations = #'(right)
1994 < c-1 e-2 g-3 b-5 > 4
1998 @node Objetos fuera del pentagrama
1999 @subsection Objetos fuera del pentagrama
2000 @translationof Outside-staff objects
2002 Los objetos fuera-del-pentagrama se colocan automáticamente para
2003 evitar las colisiones. Los objetos que tienen el valor más bajo de la
2004 propiedad @code{outside-staff-priority} se sitúan más cerca del
2005 pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
2006 tanto como sea necesario para evitar la colisión. La prioridad
2007 @code{outside-staff-priority} se defina en el @code{grob-interface} y
2008 así es una propiedad de todos los objetos de presentación. De forma
2009 predeterminada se establece a @code{#f} para todos los objetos
2010 dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
2011 fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
2012 presenta los valores numéricos predeterminados para algunos de los
2013 objetos fuera-del-pentagrama que están inicialmente dentro de los
2014 contextos @code{Staff} o @code{Voice}.
2016 @multitable @columnfractions .3 .3 .3
2017 @headitem Objeto de presentación
2019 @tab Controla la posición de:
2020 @item @code{MultiMeasureRestText}
2022 @tab Texto sobre silencios de compás completo
2023 @item @code{TextScript}
2025 @tab Elementos de marcado de texto
2026 @item @code{OttavaBracket}
2028 @tab Corchetes de octava alta y baja
2029 @item @code{TextSpanner}
2031 @tab Objetos de extensión de texto
2032 @item @code{DynamicLineSpanner}
2034 @tab Todas las indicaciones dinámicas
2035 @item @code{VoltaBracketSpanner}
2037 @tab Corchetes de primera y segunda vez
2038 @item @code{TrillSpanner}
2040 @tab Trinos mantenidos
2043 He aquí un ejemplo que muestra la situación predeterminada de algunos
2046 @cindex texto, extensiones de
2047 @cindex octava alta y baja, corchete de
2049 @funindex \startTextSpan
2050 @funindex startTextSpan
2051 @funindex \stopTextSpan
2052 @funindex stopTextSpan
2054 @cindex TextSpanner, ejemplo de sobreescritura
2055 @cindex bound-details, propiedad, ejemplo
2057 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2058 % Set details for later Text Spanner
2059 \override TextSpanner #'(bound-details left text)
2060 = \markup { \small \bold Slower }
2061 % Place dynamics above staff
2063 % Start Ottava Bracket
2068 % Add Dynamic Line Spanner
2074 c\ff c \stopTextSpan
2075 % Stop Ottava Bracket
2080 Este ejemplo también muestra cómo crear textos con extensión (Text
2081 Spanners): textos con líneas extensoras por encima de una sección de
2082 música. El extensor abarca desde la instrucción @code{\startTextSpan}
2083 hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
2084 define por medio de la instrucción @code{\override TextSpanner}. Para
2085 ver más detalles, consulte @ruser{Extensiones de texto}.
2087 También muestra la manera de crear corchetes de octava alta y baja.
2089 @cindex trucar la situación de los números de compás
2090 @cindex números de compás, ajustar posición
2091 @cindex trucar la situación de marcas metronómicas
2092 @cindex metrónomo, situación de las indicaciones de
2093 @cindex trucar la situación de las letras de ensayo
2094 @cindex ensayo, letras, trucar la colocación
2096 Observe que los números de compás, las indicaciones metronómicas y las
2097 mercas de ensayo no se muestran. De forma predeterminada, se crean
2098 dentro del contexto @code{Score} y su prioridad
2099 @code{outside-staff-priority} se ignora con relación a los objetos de
2100 presentación que se crean dentro del contexto @code{Staff}. Si quiere
2101 colocar los números de compás, indicaciones metronómicas o llamadas de
2102 ensayo en concordancia con el valor de su
2103 @code{outside-staff-priority}, los grabadores
2104 @code{Bar_number_engraver}, @code{Metronome_mark_engraver} o
2105 @code{Mark_engraver} respectivamente se deben eliminar del contexto
2106 @code{Score} y colocarlos en el contexto @code{Staff} del nivel
2107 superior. Si se hace así, estas marcas obtendrán los siguientes
2108 valores predeterminados de @code{outside-staff-priority}:
2110 @multitable @columnfractions .3 .3
2111 @headitem Objeto de presentación @tab Prioridad
2112 @item @code{RehearsalMark} @tab @code{1500}
2113 @item @code{MetronomeMark} @tab @code{1000}
2114 @item @code{BarNumber} @tab @code{ 100}
2117 Si los valores predeterminados de @code{outside-staff-priority} no le
2118 ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
2119 de cualquiera de los objetos. Suponga que quisiéramos que el corchete
2120 de octava estuviera situado por debajo del elemento extensor de texto
2121 en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
2122 prioridad de @code{OttavaBracket} en el RFI o en las tablas
2123 anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
2124 recordando que @code{OttavaBracket} se crea dentro del contexto de
2127 @cindex TextSpanner, ejemplo de sobreescritura
2128 @cindex bound-details, propiedad, ejemplo
2130 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2131 % Set details for later Text Spanner
2132 \override TextSpanner #'(bound-details left text)
2133 = \markup { \small \bold Slower }
2134 % Place dynamics above staff
2136 %Place following Ottava Bracket below Text Spanners
2137 \once \override Staff.OttavaBracket #'outside-staff-priority = #340
2138 % Start Ottava Bracket
2143 % Add Dynamic Line Spanner
2149 c\ff c \stopTextSpan
2150 % Stop Ottava Bracket
2155 @cindex ligaduras y outside-staff-priority
2156 @cindex ligaduras y articulaciones
2157 @cindex articulaciones y ligaduras
2159 De forma predeterminada, las ligaduras de expresión están clasificadas
2160 como objetos dentro-del-pentagrama, pero con frecuencia aparecen
2161 encima del pentagrama si las notas que une son muy agudas. Ello puede
2162 empujar a una posición muy elevada a los objetos fuera-del-pentagrama
2163 como las articulaciones, pues la ligadura se colocará en primer lugar.
2164 La propiedad @code{avoid-slur} de la articulación se puede establecer
2165 al valor @code{'inside} (por dentro) para llevarla al interior de la
2166 ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si
2167 la prioridad @code{outside-staff-priority} está también ajustada al
2168 valor @code{#f}. De forma alternativa, la prioridad
2169 @code{outside-staff-priority} de la ligadura se puede fijar en un
2170 valor numérico para hacer que se sitúe en línea con otros objetos
2171 fuera del pentagrama de acuerdo con este valor. He aquí un ejemplo
2172 que muestra el efecto de los dos métodos:
2174 @lilypond[quote,verbatim,relative=2]
2175 c4( c^\markup\tiny\sharp d4.) c8
2177 \once \override TextScript #'avoid-slur = #'inside
2178 \once \override TextScript #'outside-staff-priority = ##f
2179 c^\markup\tiny\sharp d4.) c8
2180 \once \override Slur #'outside-staff-priority = #500
2181 c4( c^\markup\tiny\sharp d4.) c8
2184 Los cambios en @code{outside-staff-priority} también se pueden emplear
2185 para controlar la situación vertical de los objetos individuales,
2186 aunque los resultados pueden no siempre ser deseables. Suponga que
2187 quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
2188 bajo el epígrafe Comportamiento Automático de más arriba (véase
2189 @ref{Comportamiento automático}). Todo lo que debemos hacer es localizar la
2190 prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
2191 aumentar la prioridad de @qq{Text3} hasta un valor superior:
2193 @cindex TextScript, ejemplo de sobreescritura
2194 @cindex outside-staff-priority, propiedad, ejemplo
2196 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2199 \once \override TextScript #'outside-staff-priority = #500
2204 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
2205 también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
2206 desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
2207 realmente queremos hacer es posicionar todas las anotaciones a la
2208 misma distancia por encima del pentagrama? Para hacerlo, vamos a
2209 necesitar claramente espaciar las notas en sentido horizontal para
2210 hacer sitio para el texto. Esto se hace empleando la instrucción
2211 @code{textLengthOn}.
2213 @subheading \textLengthOn
2215 @cindex notas, espaciar junto al texto
2217 @funindex \textLengthOn
2218 @funindex textLengthOn
2219 @funindex \textLengthOff
2220 @funindex textLengthOff
2222 De forma predeterminada, el texto producido mediante marcado no ocupa
2223 ningún espacio horizontal en cuanto se refiere a la disposición de la
2224 música. La instrucción @code{\textLengthOn} invierte este
2225 comportamiento, ocasionando que las notas resulten tan espaciadas como
2226 sea necesario para acomodar el texto:
2228 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2229 \textLengthOn % Cause notes to space out to accommodate text
2236 La instrucción para volver al comportamiento predeterminado es
2237 @code{\textLengthOff}. Recuerde que @code{\once} funciona solamente
2238 con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
2239 que no se puede usar con @code{\textLengthOn}.
2241 @cindex marcado, texto de, permitir las colisiones en
2243 El texto de marcado también evita las notas que se proyectan por
2244 encima del pentagrama. Si esto no es lo que deseamos, el
2245 desplazamiento automático hacia arriba se puede desactivar mediante el
2246 establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
2247 muestra cómo el texto de marcado interactúa con tales notas.
2249 @cindex TextScript, ejemplo de sobreescritura
2250 @cindex outside-staff-priority, propiedad, ejemplo
2252 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2253 % This markup is short enough to fit without collision
2257 % This is too long to fit, so it is displaced upwards
2261 % Turn off collision avoidance
2262 \once \override TextScript #'outside-staff-priority = ##f
2266 % Turn off collision avoidance
2267 \once \override TextScript #'outside-staff-priority = ##f
2268 \textLengthOn % and turn on textLengthOn
2269 c,,2^"Long Text " % Spaces at end are honored
2274 @subheading Matices dinámicos
2276 @cindex trucar la colocación de los matices
2277 @cindex dinámica, trucar la colocación de las indicaciones de
2278 @cindex matices, trucar la colocación
2280 Las indicaciones de matiz dinámico normalmente se colocarán por debajo
2281 del pentagrama, pero se pueden posicionar por encima con la
2282 instrucción @code{dynamicUp}. Se situarán verticalmente respecto a la
2283 nota a la que van adosadas, y flotarán por debajo (o por encima) de
2284 todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
2285 y números de compás. Esto puede ofrecer resultados bastante
2286 aceptables, como muestra este ejemplo:
2288 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2293 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2294 ees,2.~\)\mf ees4 r8 |
2297 Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
2298 muy cerca, la colocación automática evitará las colisiones desplazando
2299 las marcas dinámicas posteriores más lejos, aunque este puede no ser
2300 el lugar óptimo, como muestra el siguiente ejemplo más bien
2303 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2309 Si se presentara una situación similar en música @q{real}, podría ser
2310 preferible espaciar las notas un poco más entre sí, de forma que todas
2311 las marcas dinámicas puedan caber a la misma distancia vertical desde
2312 el pentagrama. Hemos sido capaces de hacer esto para el texto de
2313 marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
2314 una instrucción equivalente para las indicaciones de matiz dinámico.
2315 Por tanto, tendremos que averiguar cómo hacerlo utilizando
2316 instrucciones @code{\override}.
2318 @subheading Escalado de un «Grob»
2320 @cindex grob, cambio de tamaño de un
2321 @cindex escala de los grobs
2323 En primer lugar debemos aprender cómo se especifica el tamaño de los
2324 grobs. Todos los grobs tienen un punto de referencia definido dentro
2325 de ellos que se usa para colocarlos respecto a su objeto padre.
2326 Entonces, este punto del grob se posiciona a una distancia horizontal,
2327 @code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
2328 de su padre. La dimensión horizontal del objeto viene dada por una
2329 pareja de números, @code{X-extent}, que dice dónde están los límites
2330 izquierdo y derecho respecto del punto de referencia. La amplitud
2331 vertical se define de forma similar mediante una pareja de números,
2332 @code{Y-extent}. Éstas son propiedades de todos los grobs que
2333 contemplan el @code{grob-interface}.
2335 @cindex @code{extra-spacing-width}
2337 De forma predeterminada, los objetos fuera-del-pentagrama reciben una
2338 anchura cero, de manera que pueden solaparse en la dirección
2339 horizontal. Esto se hace mediante el truco de añadir una cantidad
2340 infinita a la dimensión más a la izquierda y menos infinito a la
2341 dimensión más a la derecha estableciendo el valor de
2342 @code{extra-spacing-width} a @code{'(+inf.0 . -inf.0)}. Así, para
2343 asegurar que no se superponen en la dirección horizontal tendremos que
2344 sobreescribir este valor de @code{extra-spacing-width} a @code{'(0
2345 . 0)} de forma que el verdadero ancho se presente. Esta es la
2346 instrucción que lo hace para las indicaciones dinámicas:
2349 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2353 Veamos si funciona en nuestro ejemplo anterior:
2355 @cindex DynamicText, ejemplo de sobreescritura
2356 @cindex extra-spacing-width, propiedad, ejemplo
2358 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2360 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2365 Bueno, ciertamente ha hecho que las marcas dinámicas ya no estén
2366 desplazadas, pero aún quedan dos problemas. Las marcas tendrían que
2367 separarse un poco más entre sí, y sería mejor si todas estuvieran a la
2368 misma distancia del pentagrama. Podemos resolver el primer problema
2369 fácilmente. En vez de hacer cero la anchura
2370 @code{extra-spacing-width}, podemos añadirle algo más. Las unidades
2371 son el espacio entre dos líneas de pentagrama, así que al mover el
2372 límite izquierdo media unidad a la izquierda y el límite derecho media
2373 unidad hacia la derecha, deberíamos conseguirlo:
2375 @cindex DynamicText, ejemplo de sobreescritura
2376 @cindex extra-spacing-width, propiedad, ejemplo
2378 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2380 % Extend width by 1 staff space
2381 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2386 Esto tiene un mejor aspecto, pero quizá habríamos preferido que las
2387 indicaciones de dinámica estuvieran alineadas sobre la misma línea de
2388 base en lugar de ir hacia arriba y hacia abajo con las notas. La
2389 propiedad que lo hace es @code{staff-padding} (relleno de pentagrama)
2390 que se estudia en la sección siguiente.
2393 @node Colisiones de objetos
2394 @section Colisiones de objetos
2395 @translationof Collisions of objects
2399 * Arreglar notación con superposiciones::
2400 * Ejemplos reales de música::
2404 @subsection Mover objetos
2405 @translationof Moving objects
2407 @cindex mover objetos superpuestos
2408 @cindex mover objetos que colisionan
2409 @cindex mover grobs que colisionan
2410 @cindex objetos que colisionan, mover
2411 @cindex grobs que colisionan, mover
2413 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
2414 de notación se pueden superponer, lo que es una lástima, pero en
2415 realidad es bastante poco frecuente. Normalmente la necesidad de
2416 mover objetos es por claridad o razones estéticas: el aspecto es mejor
2417 con un poco más o un poco menos de espacio de separación.
2419 Existen tres enfoques principales que llevan a la resolución de
2420 superposiciones en la notación. Se deben considerar en el siguiente
2425 La @strong{dirección} de uno de los objetos que se superponen se puede
2426 cambiar usando las instrucciones predefinidas que están relacionadas
2427 arriba para los objetos dentro-del-pentagrama (véase @ref{Objetos interiores al pentagrama}). Se pueden recolocar fácilmente las plicas, ligaduras de
2428 expresión y de unión, barras de corchea, indicaciones dinámicas, texto
2429 y grupos de valoración especial de esta forma. La limitación es que
2430 sólo tiene la posibilidad de elegir entre dos posiciones, y podría ser
2431 que ninguna de ellas sea la adecuada.
2434 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2435 colocando los objetos de presentación, se pueden modificar usando la
2436 instrucción de sobreescritura @code{\override}. Las ventadas de hacer
2437 cambios a este tipo de propiedad son: a) que algún otro objeto se
2438 moverá automáticamente si es necesario, para dejarle sitio, y b) una
2439 única sobreescritura se puede aplicar a todas las instancias del mismo
2440 tipo de objeto. Entre tales propiedades se encuentran:
2445 @code{direction} (dirección)
2447 Ya se ha estudiado con cierto detalle: véase @ref{Objetos interiores al pentagrama}.
2450 @code{padding} (relleno), @code{left-padding} (relleno por la
2451 izquierda), @code{right-padding} (relleno por la derecha),
2452 @code{staff-padding} (relleno de pentagrama)
2455 @cindex left-padding, propiedad
2456 @cindex padding, propiedad
2457 @cindex right-padding, propiedad
2458 @cindex staff-padding, propiedad
2460 Según un objeto se está colocando, el valor de su propiedad de relleno
2461 @code{padding} especifica el espacio intermedio que se debe dejar
2462 entre él mismo y el límite más próximo del objeto contra el que se
2463 está colocando. Observe que es el valor de @code{padding} del objeto
2464 @strong{que se está colocando} el que se usa; el valor de
2465 @code{padding} del objeto que ya está colocado se ignora. Los
2466 espacios intermedios especificados mediante @code{padding} se pueden
2467 aplicar a todos los objetos que contemplan el interface
2468 @code{side-position-interface}.
2470 En lugar de con @code{padding}, la colocación de los grupos de
2471 alteraciones se controla con @code{left-padding} y
2472 @code{right-padding}. Estas propiedades se encontrarán en el objeto
2473 @code{AccidentalPlacement} que, observe, vive dentro del contexto de
2474 @strong{staff}. Durante el proceso tipográfico, las cabezas de las
2475 notas se componen tipográficamente en primer lugar, y después las
2476 alteraciones, si existen, se añaden a la izquierda de las cabezas
2477 utilizando la propiedad de relleno por la derecha @code{right-padding}
2478 para determinar la separación entre la alteración y la cabeza. así
2479 pues, sólo la propiedad de relleno por la derecha @code{right-padding}
2480 del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
2481 de las alteraciones.
2483 La propiedad @code{staff-padding} está estrechamente relacionada con
2484 la propiedad @code{padding}: @code{padding} controla la separación
2485 mínima entre cualquier objeto que contemple el interface
2486 @code{side-position-interface} y el objeto más cercano (generalmente
2487 la nota o las líneas del pentagrama); @code{staff-padding} se aplica
2488 sólo a los objetos que siempre se sitúan fuera del pentagrama:
2489 controla la separación mínima entre dicho objeto y el pentagrama.
2490 Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
2491 que se posicionan respecto a la nota en vez de hacerlo respecto al
2492 pentagrama, incluso aunque puede ser sobreescrito sin error por tales
2493 objetos: simplemente se ignora.
2495 Para descubrir qué propiedad de relleno se necesita para el objeto que
2496 quiere recolocar, debe volver al manual de RFI y buscar las
2497 propiedades del objeto. Tenga cuidado porque las propiedades de
2498 relleno podrían no estar en el objeto más obvio, así que busque en los
2499 objetos que puedan tener alguna relación con él.
2501 Todos los valores de relleno se miden en espacios del pentagrama.
2502 Para la mayor parte de los objetos el valor se establece de forma
2503 predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
2504 Se puede sobreescribir si se necesita una separación intermedia mayor
2508 @code{self-alignment-X} (Auto-alineamiento en el eje X)
2510 @cindex self-alignment-X, propiedad
2512 Esta propiedad se puede usar para alinear el objeto a la izquierda, a
2513 la derecha, o centrarlo con respecto al punto de referencia del objeto
2514 «padre». Se puede usar con todos los objetos que contemplan el
2516 @code{self-alignment-interface}. En general son objetos que contienen
2517 texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
2518 forma alternativa se puede especificar un valor numérico entre
2519 @code{-1} y @code{+1}, donde @code{-1} es alineado por la izquierda,
2520 @code{+1} es alineado por la derecha, y los números intermedios mueven
2521 el texto progresivamente desde alineado por la izquierda hasta alineado
2522 por la derecha. Se pueden especificar valores numéricos mayores de
2523 @code{1} para mover el texto incluso más lejos hacia la izquierda, o
2524 menos de @code{-1} para alejarlo más hacia la derecha. Un cambio en
2525 @code{1} en el valor corresponde a un movimiento de la mitad de la
2526 longitud total del propio texto.
2529 @code{extra-spacing-width} (anchura de separación adicional)
2531 @cindex extra-spacing-width, propiedad
2533 Esta propiedad está disponible para todos los objetos que contemplan
2534 el interface @code{item-interface}. Toma dos números, el primero se
2535 suma al límite izquierdo y el segundo se suma al límite derecho. Los
2536 números negativos desplazan el límite a la izquierda y los positivos a
2537 la derecha, por lo que para ensanchar un objeto el primer número debe
2538 ser negativo y el segundo positivo. Observe que no todos los objetos
2539 ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
2540 (alteración) sólo toma nota del primer número (el borde izquierdo).
2543 @code{staff-position} (posición de pentagrama)
2545 @cindex staff-position, propiedad
2547 @code{staff-position} es una propiedad del interface
2548 @code{staff-symbol-referencer-interface}, que está contemplado por los
2549 objetos que se colocan con relación al pentagrama. Especifica la
2550 posición vertical del objeto con relación a la tercera línea del
2551 pentagrama en medios espacios de pentagrama. Es útil en la
2552 resolución de colisiones entre objetos de presentación como silencios
2553 multi-compás, ligaduras de unión y notas en distintas voces.
2556 @code{force-hshift} (forzar desplazamiento horizontal)
2558 @cindex force-hshift, propiedad
2560 Las notas muy juntas de un acorde, o aquellas que ocurren al mismo
2561 tiempo en voces distintas, se disponen en dos (y ocasionalmente más)
2562 columnas para evitar la superposición de las cabezas. Éstas reciben
2563 el nombre de columnas de notas, y se crea un objeto llamado
2564 @code{NoteColumn} para disponer las notas en dicha columna.
2566 La propiedad @code{force-hshift} es una propiedad de una
2567 @code{NoteColumn} (realmente lo es del interface
2568 @code{note-column-interface}). Modificarlo permite mover una columna
2569 de notas en unidades adecuadas a una columna de notas, por ejemplo la
2570 anchura de la cabeza de la nota de la primera voz. Se debe usar en
2571 situaciones complejas donde las instrucciones @code{\shiftOn} normales
2572 (véase @ref{Voces explícitas}) no resuelven el
2573 conflicto entre las notas. Es preferible a la propiedad
2574 @code{extra-offset} para este propósito porque no hay necesidad de
2575 averiguar la distancia en espacios de pentagrama, y mover las notas
2576 dentro o fuera de una @code{NoteColumn} afecta a otras acciones como a
2577 la fusión entre cabezas de nota.
2582 Finalmente, cuando todo lo demás falla, los objetos se pueden
2583 reposicionar manualmente con relación a la tercera línea del
2584 pentagrama verticalmente, o desplazándolas una cierta distancia a una
2585 nueva posición. Las desventajas son que los valores correctos para el
2586 reposicionamiento se deben adivinar, a menudo por ensayo y error, para
2587 cada objeto individual y, puesto que el movimiento se hace después de
2588 que LilyPond ha colocado todos los demás objetos es usuario es
2589 responsable de evitar cualquier colisión que pudiera producirse. Pero
2590 la dificultar principal con este enfoque es que los valores de
2591 reposicionado podrían tener que ser vueltos a calcular si la música se
2592 modifica más tarde. Las propiedades que se pueden usar para este tipo
2593 de posicionamiento manual son:
2596 @item extra-offset (desplazamiento adicional)
2598 @cindex extra-offset, propiedad
2600 Esta propiedad se aplica a cualquier objeto de presentación que
2601 contemple el @code{grob-interface}. Toma una pareja de números que
2602 especifican el desplazamiento adicional en las direcciones horizontal
2603 y vertical. Los números negativos mueven el objeto a la izquierda o
2604 hacia abajo. Las unidades son espacios de pentagrama. El
2605 desplazamiento adicional se hace después de que la composición
2606 tipográfica de los objetos ha terminado, así que un objeto puede ser
2607 reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
2609 @item positions (posiciones)
2611 @cindex positions, propiedad
2613 Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
2614 la altura de las barras de corchea, ligaduras de expresión y corchetes
2615 de grupos de valoración especial. Toma una pareja de números que dan
2616 la posición de los extremos izquierdo y derecho de la barra, ligadura,
2617 etc. con relación a la tercera línea del pentagrama. Las unidades son
2618 espacios de pentagrama. Observe, sin embargo, que las ligaduras de
2619 expresión y de fraseo no se pueden reposicionar en cantidades
2620 arbitrariamente grandes. LilyPond en primer lugar genera una lista de
2621 posiciones posibles para la ligadura y de forma predeterminada
2622 encuentra la ligadura que tiene @qq{mejor aspecto}. Si la propiedad
2623 @code{positions} se ha sobreescrito, la ligadura que está más cerca de
2624 las posiciones que se han solicitado, se selecciona de la lista.
2629 Un objeto en particular podría no tener todas estas propiedades. Es
2630 necesario ir al manual RFI para buscar qué propiedades se encuentran
2631 disponibles para el objeto en cuestión.
2634 Aquí presentamos una lista de los objetos que es más probable que
2635 estén implicados en colisiones, con el nombre del objeto que habría
2636 que buscar en el RFI para descubrir qué propiedades se deben usar para
2639 @multitable @columnfractions .5 .5
2640 @headitem Tipo de objeto @tab Nombre del objeto
2641 @item Articulaciones @tab @code{Script}
2642 @item Barras @tab @code{Beam}
2643 @item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
2644 @item Dinámica (horizontalmente) @tab @code{DynamicText}
2645 @item Digitaciones @tab @code{Fingering}
2646 @item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
2647 @item Ligaduras de expresión @tab @code{Slur}
2648 @item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
2649 @item Ligaduras de unión @tab @code{Tie}
2650 @item Grupos de valoración especial @tab @code{TupletBracket}
2654 @node Arreglar notación con superposiciones
2655 @subsection Arreglar notación con superposiciones
2656 @translationof Fixing overlapping notation
2658 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
2659 en la sección anterior, para resolver problemas de notación que se
2662 @subheading la propiedad padding (relleno)
2665 @cindex arreglar notación que se superpone
2666 @cindex superpuesta, notación
2668 La propiedad @code{padding} se puede ajustar para aumentar (o
2669 disminuir) la distancia entre símbolos impresos encima o debajo de las
2672 @cindex Script, ejemplo de sobreescritura
2673 @cindex padding, propiedad, ejemplo
2675 @lilypond[quote,fragment,relative=1,verbatim]
2677 \override Script #'padding = #3
2681 @cindex MetronomeMark, ejemplo de sobreescritura
2682 @cindex padding, propiedad, ejemplo
2684 @lilypond[quote,fragment,relative=1,verbatim]
2685 % This will not work, see below:
2686 \override MetronomeMark #'padding = #3
2690 \override Score.MetronomeMark #'padding = #3
2695 Observe en el segundo ejemplo la gran importancia que tiene saber qué
2696 contexto maneja un determinado objeto. Puesto que el objeto
2697 @code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
2698 cambios de propiedades en el contexto @code{Voice} pasarán
2699 inadvertidos. Para ver más detalles, consulte @ruser{Modificar las propiedades}.
2701 Si la propiedad de relleno @code{padding} de un objeto se incrementa
2702 cuando dicho objeto se encuentra en una pila de objetos que se están
2703 colocando de acuerdo a su prioridad @code{outside-staff-priority},
2704 entonces ese objeto se moverá, y también todos los que están por fuera
2708 @subheading left-padding y right-padding (relleno por la izquierda y por la derecha)
2710 @cindex left-padding, propiedad
2711 @cindex right-padding, propiedad
2713 La propiedad @code{right-padding} afecta al espaciado entre la
2714 alteración y la nota a que se aplica. Normalmente no es necesaria,
2715 pero el ejemplo siguiente muestra una situación en la que sí se
2716 necesita. Suponga que queremos presentar un acorde que contiene un Si
2717 natural y un Si bemol. Para evitar la ambigüedad querríamos preceder
2718 las notas con un becuadro y un bemol. Aquí vienen varios intentos de
2721 @cindex Accidental, ejemplo de sobreescritura
2722 @cindex text, propiedad, ejemplo
2723 @cindex stencil, propiedad, ejemplo
2724 @cindex AccidentalPlacement, ejemplo de sobreescritura
2725 @cindex right-padding, propiedad, ejemplo
2727 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2733 Ninguno de ellos funciona y el segundo además presenta una fea
2734 colisión entre las dos alteraciones.
2736 Una forma de conseguirlo es sobreescribir el sello de la alteración
2737 con un elemento de marcado que contenga los símbolos de becuadro y
2738 bemol en el orden que nos gustaría que estuvieran, así:
2740 @lilypond[quote,ragged-right,verbatim]
2741 naturalplusflat = \markup { \natural \flat }
2743 \once \override Accidental
2744 #'stencil = #ly:text-interface::print
2745 \once \override Accidental #'text = #naturalplusflat
2746 \once \override Score.AccidentalPlacement #'right-padding = #1.5
2752 Esto utiliza necesariamente una sobreescritura para el sello de la
2753 alteración que no se estudiará hasta más adelante. El tipo de sello
2754 debe ser un procedimiento, aquí modificado para que imprima el
2755 contenido de la propiedad @code{text} del objeto @code{Accidental},
2756 que a su vez está establecido como un signo de becuadro seguido de un
2757 bemol. Entonces el conjunto se puede separar de la cabeza de la nota
2758 sobreescribiendo @code{right-padding}.
2762 @subheading la propiedad staff-padding (relleno de pentagrama)
2764 @cindex alineación de objetos sobre la línea base
2765 @cindex objetos, alineación sobre la línea base
2767 @code{staff-padding} se puede usar para alinear objetos como matices
2768 dinámicos a lo largo de una línea de base a una altura fija sobre el
2769 pentagrama, en lugar de hacerlo a una altura que dependa de la
2770 posición de la nota a la que están adosados. No es una propiedad de
2771 @code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
2772 porque la línea de base debe aplicarse por igual a @strong{todas} las
2773 dinámicas, entre ellas las que se han creado como objetos de
2774 extensión. Así que ésta es la forma de alinear las indicaciones de
2775 matiz en el ejemplo de la sección anterior:
2777 @cindex DynamicText, ejemplo de sobreescritura
2778 @cindex extra-spacing-width, propiedad, ejemplo
2779 @cindex DynamicLineSpanner, ejemplo de sobreescritura
2780 @cindex staff-padding, propiedad, ejemplo
2782 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2784 % Extend width by 1 unit
2785 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2786 % Align dynamics to a base line 2 units above staff
2787 \override DynamicLineSpanner #'staff-padding = #2
2792 @subheading la propiedad self-alignment-X (auto-alineación en X)
2794 El ejemplo siguiente muestra cómo esto puede resolver la colisión
2795 entre un objeto de digitación de cuerda y la plica de una nota
2796 mediante el alineamiento del límite derecho con el punto de referencia
2799 @cindex StringNumber, ejemplo de sobreescritura
2800 @cindex self-alignment-X, propiedad, ejemplo
2802 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
2805 \once \override StringNumber #'self-alignment-X = #RIGHT
2809 @subheading la propiedad staff-position (posición en el pentagrama)
2811 @cindex objeto, colisión dentro del pentagrama
2813 Los silencios multi-compás en una voz pueden chocar con las notas en
2814 otra voz. Puesto que estos silencios se tipografían centrados entre
2815 las barras de compás se necesitaría bastante esfuerzo para que
2816 LilyPond averiguara qué otras notas podrían chocar con él, ya que
2817 actualmente todo el manejo de colisiones entre notas y silencios se
2818 hace solamente para notas y silencios que ocurren al mismo tiempo. He
2819 aquí un ejemplo de colisión de este tipo:
2821 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2822 << {c c c c} \\ {R1} >>
2825 La mejor solución aquí es mover el silencio multi-compás hacia abajo,
2826 pues el silencio está en la voz dos. El ajuste predeterminado para
2827 @code{\voiceTwo} (es decir, en la segunda voz de una construcción
2828 @code{<<@{...@} \\ @{...@}>>}) es que @code{staff-position} tenga el
2829 valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
2830 cuatro semi-espacios de pentagrama, al valor @code{-8}.
2832 @cindex MultiMeasureRest, ejemplo de sobreescritura
2833 @cindex staff-position, propiedad, ejemplo
2835 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2839 \override MultiMeasureRest #'staff-position = #-8
2844 Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
2845 la línea adicional por encima del silencio se inserta automáticamente.
2847 @subheading la propiedad extra-offset (desplazamiento adicional)
2849 @cindex posicionar objetos
2850 @cindex posicionar grobs
2851 @cindex objetos, posicionar
2852 @cindex grobs, posicionar
2854 La propiedad @code{extra-offset} da un completo control sobre el
2855 posicionamiento de un objeto tanto vertical como horizontalmente.
2857 En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
2858 a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
2860 @cindex Fingering, ejemplo de sobreescritura
2861 @cindex extra-offset, propiedad, ejemplo
2863 @lilypond[quote,fragment,relative=1,verbatim]
2866 \once \override Fingering
2867 #'extra-offset = #'(-0.3 . -1.8)
2872 @subheading la propiedad positions (posiciones)
2874 @cindex controlar manualmente grupos especiales, ligaduras y barras
2875 @cindex manual, control, de grupos especiales, ligaduras y barras
2876 @cindex grupos especiales, barras de, control manual
2877 @cindex ligaduras de expresión, control manual
2878 @cindex ligaduras de fraseo, control manual
2879 @cindex barras de corchea, control manual
2881 La propiedad @code{positions} permite controlar manualmente la
2882 posición e inclinación de los tresillos, ligaduras de expresión y de
2883 fraseo, y barras de corchea. He aquí un ejemplo que tiene una fea
2884 ligadura de fraseo debido a que intenta evitar la ligadura de
2885 expresión que está sobre la acciaccatura.
2887 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2888 r4 \acciaccatura e8\( d8 c ~c d c d\)
2892 Simplemente podemos mover la ligadura de fraseo por encima de las
2893 notas, y de hecho ésta será la solución preferida:
2895 @cindex PhrasingSlur, ejemplo de sobreescritura
2896 @cindex positions, propiedad, ejemplo
2898 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2901 \acciaccatura e8\( d8 c ~c d c d\)
2905 Pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
2906 sería mover el extremo izquierdo de la ligadura de fraseo un poco
2907 hacia abajo usando la propiedad @code{positions}. Esto también
2908 resuelve la forma algo indecente de la ligadura.
2910 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2912 \once \override PhrasingSlur #'positions = #'(-4 . -3)
2914 e8\( d8 c ~c d c d\)
2917 Presentamos un ejemplo más extraído del comienzo del pentagrama de la
2918 mano izquierda del preludio de Chopin Op 28 No. 2. vemos que la barra
2919 choca con las notas superiores:
2921 @lilypond[quote,verbatim,fragment,ragged-right]
2924 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2925 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2930 Esto se puede resolver manualmente elevando los dos extremos de la
2931 barra desde su posición a dos espacios de pentagrama sobre la línea
2932 central hasta, digamos, 3 espacios:
2934 @cindex Beam, ejemplo de sobreescritura
2935 @cindex positions, propiedad, ejemplo
2937 @lilypond[quote,verbatim,fragment,ragged-right]
2941 \override Beam #'positions = #'(3 . 3)
2946 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2951 Observe que la sobreescritura sigue aplicándose en la primera voz del
2952 segundo bloque de corcheas, pero no a ninguna de las barras de la
2955 @subheading la propiedad force-hshift (forzar desplazamiento horizontal)
2957 @c FIXME: formatting stuff (ie not important right now IMO)
2958 @c @a nchor Chopin finally corrected TODOgp
2960 Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
2961 Chopin que presentamos al final de @ref{Oigo voces}, que
2962 dejamos con este aspecto:
2964 @lilypond[quote,verbatim,fragment,ragged-right]
2965 \new Staff \relative c'' {
2968 { c2 aes4. bes8 } \\
2980 Las dos notas inferiores del primer acorde (es decir, las que están en
2981 al tercera voz) no deberían separarse de la columna de notas de las dos
2982 notas agudas. Para corregir esto, establecemos el valor de
2983 @code{force-hshift} (que es una propiedad de @code{NoteColumn}) de
2984 esas notas a cero. La nota más grave del segundo acorde se sitúa
2985 mejor justo a la derecha de las más agudas. Lo conseguimos
2986 estableciendo el valor de @code{force-hshift} de esta nota a 0.5, o
2987 sea, la anchura de media cabeza de nota a la derecha de la columna de
2990 Presentamos a continuación el resultado final:
2992 @cindex NoteColumn, ejemplo de sobreescritura
2993 @cindex force-hshift, propiedad, ejemplo
2995 @lilypond[quote,verbatim,fragment,ragged-right]
2996 \new Staff \relative c'' {
2999 { c2 aes4. bes8 } \\
3002 \once \override NoteColumn #'force-hshift = #0 <ees c>2
3003 \once \override NoteColumn #'force-hshift = #0.5 des2
3011 @node Ejemplos reales de música
3012 @subsection Ejemplos reales de música
3013 @translationof Real music example
3015 Finalizaremos esta sección sobre los trucos mostrando los pasos que se
3016 deben tomar para tratar con un ejemplo complicado que necesita varios
3017 trucos para producir el resultado deseado. El ejemplo se ha escogido
3018 deliberadamente para ilustrar el uso de la Referencia de la Notación
3019 para resolver problemas de notación poco comunes. No es
3020 representativo de un proceso de grabado más usual, por lo que ¡le
3021 recomendamos que no deje que estas dificultades le desanimen!
3022 ¡Afortunadamente, las dificultades como éstas no son muy comunes!
3024 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
3025 compases 6 al 9, la transición entre el Lento inicial y el Moderato.
3026 Presentamos en primer lugar el aspecto que queremos que tenga el
3027 resultado, pero para evitar complicar demasiado el ejemplo hemos
3028 quitado las indicaciones dinámicas, las digitaciones y el pedal.
3030 @c The following should appear as music without code
3031 @lilypond[quote,ragged-right]
3032 rhMusic = \relative c'' {
3035 \once \override Tie #'staff-position = #3.5
3039 \mergeDifferentlyHeadedOn
3040 \mergeDifferentlyDottedOn
3041 bes2.^\markup {\bold "Moderato"} r8
3043 {c,8[ d fis bes a] | }
3045 % Reposition the c2 to the right of the merged note
3046 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3047 % Move the c2 out of the main note column so the merge will work
3050 % Stem on the d2 must be down to permit merging
3051 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3055 \mergeDifferentlyHeadedOff
3056 \mergeDifferentlyDottedOff
3060 lhMusic = \relative c' {
3062 <d g, d>1)\arpeggio |
3069 \new Staff = "RH" <<
3073 \new Staff = "LH" <<
3082 Observamos en primer lugar que la parte de la mano derecha del tercer
3083 compás requiere cuatro voces. Son las cinco corcheas unidas por una
3084 barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
3085 y el Fa sostenido negra con puntillo, que también está fundida con la
3086 corchea de su misma altura. Todo lo demás está en una sola voz, así
3087 que lo más fácil es introducir estas cuatro voces temporalmente en el
3088 momento en que se necesiten. Si ha olvidado cómo hacerlo, lea
3089 @ref{Oigo voces}. Vamos a comenzar introduciendo las notas
3090 como dos variables y disponiendo la estructura de pentagramas en un
3091 bloque Score, y veremos qué produce LilyPond de forma predeterminada:
3093 @lilypond[quote,verbatim,ragged-right]
3094 rhMusic = \relative c'' {
3099 % Start polyphonic section of four voices
3101 {c,8 d fis bes a | }
3112 lhMusic = \relative c' {
3121 \new Staff = "RH" <<
3125 \new Staff = "LH" <<
3134 Todas las notas son correctas, pero el aspecto está lejos de ser
3135 satisfactorio. La ligadura de unión choca con el cambio de compás, el
3136 barrado del tercer compás es incorrecto, las notas no se funden
3137 correctamente, y faltan algunos elementos de notación. En primer
3138 lugar trataremos con lo más fácil. Podemos corregir el barrado de las
3139 corcheas insertando una barra manualmente, y podemos añadir fácilmente
3140 la ligadura de expresión de la mano izquierda y la ligadura de fraseo
3141 de la mano derecha, pues todo ello se estudió en el Tutorial. Al
3142 hacerlo así obtenemos:
3144 @lilypond[quote,verbatim,ragged-right]
3145 rhMusic = \relative c'' {
3150 % Start polyphonic section of four voices
3152 {c,8[ d fis bes a] | }
3163 lhMusic = \relative c' {
3172 \new Staff = "RH" <<
3176 \new Staff = "LH" <<
3185 El primer compás ahora es correcto. El segundo compás contiene un
3186 arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
3187 sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
3188 que volver e la Referencia de la Notación. Buscando la palabra
3189 @q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
3190 que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
3191 doble barra se produce por medio de la instrucción @code{\bar "||"}.
3192 Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
3193 la colisión entre la ligadura de unión y la indicación de compás.
3194 Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
3195 mover objetos anteriormente en @ref{Mover objetos}, donde dice que
3196 los objetos que están situados de forma relativa al pentagrama se
3197 pueden mover sobreescribiendo su propiedad @code{staff-position}, que
3198 se especifica en unidades de medio espacio de pentagrama respecto de
3199 la línea central del pentagrama. Así pues, la sobreescritura
3200 siguiente colocada justo antes de la primera nota ligada subirá la
3201 ligadura 3.5 medios espacios de pentagrama por encima de la línea
3204 @code{\once \override Tie #'staff-position = #3.5}
3206 Con esto se completa el compás dos, dando como resultado:
3208 @lilypond[quote,verbatim,ragged-right]
3209 rhMusic = \relative c'' {
3211 \once \override Tie #'staff-position = #3.5
3216 % Start polyphonic section of four voices
3218 {c,8[ d fis bes a] | }
3229 lhMusic = \relative c' {
3231 <d g, d>1)\arpeggio |
3238 \new Staff = "RH" <<
3242 \new Staff = "LH" <<
3251 Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
3252 tutorial nos enseñó cómo escribir texto en negrita mediante la
3253 instrucción @code{\markup}, por lo que añadir @q{Moderato} en negrita
3254 es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
3255 voces? Aquí es donde debemos volver a buscar ayuda en el manual de
3256 Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
3257 el índice de la Referencia de la notación llegamos rápidamente a las
3258 instrucciones para mezclar notas con distinta cabeza y con o sin
3259 puntillo, en @ruser{Resolución de las colisiones}. En nuestro ejemplo tenemos
3260 que fusionar ambos tipos de nota en el transcurso de la sección
3261 polifónica del compás 3; por tanto, en virtud de la información que
3262 aparece en la Referencia de la Notación, escribimos
3265 \mergeDifferentlyHeadedOn
3266 \mergeDifferentlyDottedOn
3270 al principio de la sección, y
3273 \mergeDifferentlyHeadedOff
3274 \mergeDifferentlyDottedOff
3278 al final, dando como resultado:
3280 @lilypond[quote,verbatim,ragged-right]
3281 rhMusic = \relative c'' {
3283 \once \override Tie #'staff-position = #3.5
3287 bes2.^\markup {\bold "Moderato"} r8
3288 \mergeDifferentlyHeadedOn
3289 \mergeDifferentlyDottedOn
3290 % Start polyphonic section of four voices
3292 {c,8[ d fis bes a] | }
3300 \mergeDifferentlyHeadedOff
3301 \mergeDifferentlyDottedOff
3305 lhMusic = \relative c' {
3307 <d g, d>1)\arpeggio |
3314 \new Staff = "RH" <<
3318 \new Staff = "LH" <<
3327 Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
3328 dos Re. ¿Por qué no? La respuesta está en la misma sección de la
3329 Referencia de la Notación: las notas que se fusionan deben tener las
3330 plicas en direcciones opuestas y dos notas no se pueden fusionar bien
3331 si hay una tercera nota en la misma columna. Aquí los dos Re tienen
3332 las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
3333 cambiar la dirección de la plica usando @code{\stemDown}, y la
3334 Referencia de la Notación también explica cómo mover el Do: aplicar un
3335 desplazamiento usando una de las instrucciones @code{\shift}. Pero
3336 ¿cuál? El Do está en la voz dos que tiene desactivado el
3337 desplazamiento, y los dos Re están en las voces uno y tres, que tienen
3338 el desplazamiento desactivado y activado, respectivamente. Por ello
3339 tenemos que desplazar el Do un nivel más todavía, usando
3340 @code{\shiftOnn} para evitar que interfiera con los dos Re. Al
3341 aplicar estos cambios obtenemos:
3343 @cindex Tie, ejemplo de sobreescritura
3344 @cindex staff-position, propiedad, ejemplo
3346 @lilypond[quote,verbatim,ragged-right]
3347 rhMusic = \relative c'' {
3349 \once \override Tie #'staff-position = #3.5
3353 bes2.^\markup {\bold "Moderato"} r8
3354 \mergeDifferentlyHeadedOn
3355 \mergeDifferentlyDottedOn
3356 % Start polyphonic section of four voices
3358 {c,8[ d fis bes a] | }
3360 % Move the c2 out of the main note column so the merge will work
3361 {c,8~ \shiftOnn c2 | }
3363 % Stem on the d2 must be down to permit merging
3364 {s8 \stemDown d2 | }
3368 \mergeDifferentlyHeadedOff
3369 \mergeDifferentlyDottedOff
3373 lhMusic = \relative c' {
3375 <d g, d>1)\arpeggio |
3382 \new Staff = "RH" <<
3386 \new Staff = "LH" <<
3395 Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
3396 sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
3397 colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
3398 partir de trucos anteriores: hacemos la plica transparente, y movemos
3399 el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
3402 @cindex NoteColumn, ejemplo de sobreescritura
3403 @cindex force-hshift, propiedad, ejemplo
3404 @cindex Stem, ejemplo de sobreescritura
3405 @cindex transparent, propiedad, ejemplo
3407 @lilypond[quote,verbatim,ragged-right]
3408 rhMusic = \relative c'' {
3411 \once \override Tie #'staff-position = #3.5
3415 bes2.^\markup {\bold "Moderato"} r8
3416 \mergeDifferentlyHeadedOn
3417 \mergeDifferentlyDottedOn
3419 {c,8[ d fis bes a] | }
3421 % Reposition the c2 to the right of the merged note
3422 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3423 % Move the c2 out of the main note column so the merge will work
3426 % Stem on the d2 must be down to permit merging
3427 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3431 \mergeDifferentlyHeadedOff
3432 \mergeDifferentlyDottedOff
3436 lhMusic = \relative c' {
3438 <d g, d>1)\arpeggio |
3445 \new Staff = "RH" <<
3449 \new Staff = "LH" <<
3459 @node Trucajes adicionales
3460 @section Trucajes adicionales
3461 @translationof Further tweaking
3464 * Otras aplicaciones de los trucos::
3465 * Uso de variables para los trucos::
3466 * Otras fuentes de información::
3467 * Evitar los trucos con un proceso ralentizado::
3468 * Trucos avanzados con Scheme::
3471 @node Otras aplicaciones de los trucos
3472 @subsection Otras aplicaciones de los trucos
3473 @translationof Other uses for tweaks
3475 @cindex transparent, uso de la propiedad
3476 @cindex objetos, hace invisibles
3477 @cindex eliminar objetos
3478 @cindex objetos, eliminar
3479 @cindex objetos, ocultar
3480 @cindex ocultar objetos
3481 @cindex invisibles, objetos
3482 @cindex objetos invisibles
3483 @cindex ligar notas entre voces distintas
3485 @subheading Ligar notas entre voces distintas
3487 El ejemplo siguiente muestra cómo conectar notas que están en
3488 distintas voces utilizando ligaduras de unión. Normalmente sólo se
3489 pueden conectar mediante ligaduras de unión dos notas que estén en la
3490 misma voz. Usando dos voces, con las notas ligadas en una de ellas:
3492 @lilypond[quote,fragment,relative=2]
3493 << { b8~ b8\noBeam }
3499 y borrando la primera plica hacia arriba en esa voz, da la impresión
3500 de que la ligadura se cruza entre las voces:
3502 @cindex Stem, ejemplo de sobreescritura
3503 @cindex transparent, propiedad, ejemplo
3505 @lilypond[quote,fragment,relative=2,verbatim]
3508 \once \override Stem #'transparent = ##t
3516 Para estar seguros de que la plica que acabamos de borrar no aprieta
3517 demasiado a la ligadura, podemos alargar la plica estableciendo su
3518 valor de longitud @code{length} a @code{8},
3520 @lilypond[quote,fragment,relative=2,verbatim]
3523 \once \override Stem #'transparent = ##t
3524 \once \override Stem #'length = #8
3532 @subheading Simulación de un calderón en el MIDI
3534 @cindex sello, uso de la propiedad
3535 @cindex fermata, realización en MIDI
3537 Para los objetos fuera-del-pentagrama, normalmente es mejor
3538 sobreescribir la propiedad @code{stencil} («sello») del objeto que su
3539 propiedad @code{transparent} cuando desee quitarlos de la salida
3540 impresa. Mediante el establecimiento de la propiedad @code{stencil}
3541 de un objeto al valor @code{#f} podemos quitar el objeto por completo
3542 de la salida impresa. Esto significa que no tiene efecto sobre la
3543 colocación de otros objetos que pudieran colocarse en relación a él.
3545 Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
3546 propósito de simular un calderón en la salida MIDI, seguramente no
3547 querríamos que la indicación metronómica apareciese en la salida
3548 impresa, y no querríamos influir sobre la separación entre los dos
3549 sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
3550 pentagrama. Por lo tanto, establecer su propiedad @code{stencil} al
3551 valor @code{#f} sería la mejor manera. Mostramos aquí el efecto de
3554 @cindex MetronomeMark, ejemplo de sobreescritura
3555 @cindex transparent, propiedad, ejemplo
3557 @lilypond[quote,verbatim,ragged-right]
3560 % Visible tempo marking
3563 \once \override Score.MetronomeMark #'transparent = ##t
3564 % Invisible tempo marking to lengthen fermata in MIDI
3567 % New tempo for next section
3576 @cindex MetronomeMark, ejemplo de sobreescritura
3577 @cindex stencil, propiedad, ejemplo
3579 @lilypond[quote,verbatim,ragged-right]
3582 % Visible tempo marking
3585 \once \override Score.MetronomeMark #'stencil = ##f
3586 % Invisible tempo marking to lengthen fermata in MIDI
3589 % New tempo for next section
3599 Ambos métodos quitan de la salida impresa la indicación metronómica
3600 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
3601 queríamos, pero la indicación metronómica transparente de la primera
3602 línea fuerza una colocación muy alta de la indicación de tempo que
3603 sigue, mientras que la segunda (con el sello suprimido) no lo hace.
3605 @node Uso de variables para los trucos
3606 @subsection Uso de variables para los trucos
3607 @translationof Using variables for tweaks
3609 @cindex variables, uso de, para trucos
3610 @cindex usar variables para hacer trucos
3611 @cindex trucos, usar variables para hacer
3613 Las instrucciones de sobreescritura son con frecuencia largas y
3614 tediosas de escribir, y se tienen que escribir de forma absolutamente
3615 correcta. Si las mismas sobreescrituras se van a utilizar muchas
3616 veces, podría merecer la pena definir variables para guardarlas.
3618 Supongamos que queremos realzar ciertas palabras de la letra de una
3619 canción imprimiéndolas en cursiva y negrita. Las instrucciones
3620 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
3621 canciones si están incluidas, junto con la palabra o palabras que se
3622 pretenden modificar, dentro de un @code{\markup}, lo que las hace
3623 tediosas de escribir. La necesidad de incluir las propias palabras
3624 impide que se puedan usar en variables simples. ¿Podríamos, como
3625 alternativa, utilizar las instrucciones @code{\override} y
3629 @code{\override Lyrics . LyricText #'font-shape = #'italic}
3630 @code{\override Lyrics . LyricText #'font-series = #'bold}
3632 @code{\revert Lyrics . LyricText #'font-shape}
3633 @code{\revert Lyrics . LyricText #'font-series}
3636 Estas instrucciones también serían extremadamente tediosas de escribir
3637 si hubiera muchas palabras que quisiéramos subrayar. Pero sí
3638 @emph{podemos} definirlas como dos variables y usarlas para delimitar
3639 las palabras que destacar. Otra ventaja de la utilización de
3640 variables para estas sobreescrituras es que ya no son necesarios los
3641 espacios que rodean al punto, puesto que no se interpretan
3642 directamente en el modo @code{\lyricmode}. He aquí un ejemplo de
3643 esto, aunque en la práctica quizá elegiríamos unos nombres de variable
3644 más cortos para que fueran más rápidos de teclear:
3646 @cindex LyricText, ejemplo de sobreescritura
3647 @cindex font-shape, propiedad, ejemplo
3648 @cindex font-series, propiedad, ejemplo
3650 @lilypond[quote,verbatim]
3652 \override Lyrics.LyricText #'font-shape = #'italic
3653 \override Lyrics.LyricText #'font-series = #'bold
3656 \revert Lyrics.LyricText #'font-shape
3657 \revert Lyrics.LyricText #'font-series
3660 global = { \time 4/4 \partial 4 \key c \major}
3661 SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
3662 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f f e }
3663 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
3664 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
3665 VerseOne = \lyrics { E -- | ter -- nal \emphasize Fa -- ther, \normal | strong to save, }
3666 VerseTwo = \lyricmode { O | \emphasize Christ, \normal whose voice the | wa -- ters heard, }
3667 VerseThree = \lyricmode { O | \emphasize Ho -- ly Spi -- rit, \normal | who didst brood }
3668 VerseFour = \lyricmode { O | \emphasize Tri -- ni -- ty \normal of | love and pow'r }
3674 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
3675 \new Voice = "Alto" { \voiceTwo \AltoMusic }
3676 \new Lyrics \lyricsto "Soprano" { \VerseOne }
3677 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
3678 \new Lyrics \lyricsto "Soprano" { \VerseThree }
3679 \new Lyrics \lyricsto "Soprano" { \VerseFour }
3683 \new Voice = "Tenor" { \voiceOne \TenorMusic }
3684 \new Voice = "Bass" { \voiceTwo \BassMusic }
3691 @node Otras fuentes de información
3692 @subsection Otras fuentes de información
3693 @translationof Other sources of information
3695 La documentación del manual de Referencia de Funcionamiento Interno
3696 contiene montañas de información sobre LilyPond, pero se puede obtener
3697 más información aún leyendo los archivos internos de LilyPond. Para
3698 echarles un vistazo, en primer lugar debe buscar la carpeta
3699 correspondiente a su sistema. La ubicación de esta carpeta depende
3700 (a) de si consiguió el programa LilyPond descargando un binario
3701 precompilado desde el sitio web lilypond.org o si lo instaló mediante
3702 un gestor de paquetes (es decir, distribuido con Linux, o instalado
3703 bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
3704 qué sistema operativo está utilizando:
3707 @strong{Descargado de lilypond.org}
3713 @file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/share/lilypond/current/}
3718 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/Resources/share/lilypond/current/}
3719 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
3720 bien manteniendo pulsada la tecla de Control y haciendo click sobre la
3721 aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
3726 Mediante el Explorador de Windows, diríjase a
3727 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/share/lilypond/current/}
3731 @strong{Instalado mediante un gestor de paquetes o compilado a partir de la fuente}
3734 @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
3735 se encuentra determinado por su administrador de paquetes o guión
3736 @code{configure}, y @var{X.Y.Z} es el número de la versión de
3741 Dentro de esta carpeta, las dos subcarpetas interesantes son
3744 @item @file{ly/} - contiene archivos en formato LilyPond
3745 @item @file{scm/} - contiene archivos en formato Scheme
3748 Vamos a comenzar observando algunos archivos que están en @file{ly/}.
3749 Abra @file{ly/property-init.ly} con un editor de textos. El mismo que
3750 usaría normalmente para los archivos @code{.ly} servirá perfectamente.
3751 Este archivo contiene las definiciones de todas las instrucciones
3752 estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} y
3753 @code{\slurDotted}. Podrá ver que no son nada más que definiciones de
3754 variables que contienen una o varias instrucciones @code{\override}.
3755 Por ejemplo, @code{/tieDotted} está definido de tal forma que su valor
3760 \override Tie #'dash-period = #0.75
3761 \override Tie #'dash-fraction = #0.1
3765 Si no le gustan los valores predeterminados, estas instrucciones
3766 predefinidas se pueden redefinir con facilidad como cualquier otra
3767 variable, al principio de su archivo de código de entrada.
3769 Los siguientes son los archivos más útiles que se encuentran en
3772 @multitable @columnfractions .4 .6
3775 @item @file{ly/engraver-init.ly}
3776 @tab Definiciones de Contextos de grabadores
3777 @item @file{ly/paper-defaults-init.ly}
3778 @tab especificaciones de valores predeterminados relacionados con el papel
3779 @item @file{ly/performer-init.ly}
3780 @tab Definiciones de Contextos de interpretación
3781 @item @file{ly/property-init.ly}
3782 @tab Definiciones de todas las instrucciones predefinidas que son comunes
3783 @item @file{ly/spanner-init.ly}
3784 @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
3787 Otros ajustes (como las definiciones de las instrucciones de marcado)
3788 se almacenan como archivos @code{.scm} (de Scheme). El lenguaje de
3789 programación Scheme se utiliza para proporcionar un interfaz
3790 programable en el funcionamiento interno de LilyPond. Cualquier
3791 explicación adicional sobre estos archivos se encuentra por el momento
3792 fuera del ámbito de este manual, porque se requieren conocimientos del
3793 lenguaje Scheme. Se advierte a los usuarios que se necesita una
3794 importante cantidad de conocimientos técnicos o de tiempo para
3795 comprender el lenguaje Scheme y estos archivos (véase @ref{Tutorial de Scheme}).
3797 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
3800 @multitable @columnfractions .4 .6
3803 @item @file{scm/auto-beam.scm}
3804 @tab Valores predeterminados de sub-barrado
3805 @item @file{scm/define-grobs.scm}
3806 @tab valores predeterminados de las propiedades de grobs
3807 @item @file{scm/define-markup-commands.scm}
3808 @tab Especificar todas las instrucciones de marcado
3809 @item @file{scm/midi.scm}
3810 @tab Ajustes predeterminados para la salida MIDI
3811 @item @file{scm/output-lib.scm}
3812 @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
3813 @item @file{scm/parser-clef.scm}
3814 @tab Definiciones de las claves contempladas
3815 @item @file{scm/script.scm}
3816 @tab Ajustes predeterminados para las articulaciones
3821 @node Evitar los trucos con un proceso ralentizado
3822 @subsection Evitar los trucos con un proceso ralentizado
3823 @translationof Avoiding tweaks with slower processing
3825 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
3826 procesa los archivos. Estas instrucciones consumen tiempo, pero el
3827 resultado puede necesitar menos trucos manuales para obtener un
3828 resultado aceptable. Si una inscripción de texto o parte de la letra
3829 se sale de los márgenes, estas comprobaciones comprimirán dicha línea
3830 en la medida justa como para que encaje dentro de los márgenes.
3832 Para que sean efectivos bajo cualquier circunstancia, estas
3833 comprobaciones deben habilitarse colocando las instrucciones de
3834 sobreescritura dentro del bloque @code{\with} dentro de un Score, y no
3835 en línea con la música, de la forma siguiente:
3840 % asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
3841 \override PaperColumn #'keep-inside-line = ##t
3842 \override NonMusicalPaperColumn #'keep-inside-line = ##t
3848 @node Trucos avanzados con Scheme
3849 @subsection Trucos avanzados con Scheme
3850 @translationof Advanced tweaks with Scheme
3852 Aunque es posible hacer muchas cosas con las instrucciones
3853 @code{\override} y @code{\tweak} , tenemos una forma incluso más
3854 poderosa de modificar el funcionamiento de LilyPond, a través de un
3855 interface programable hacia las operaciones internas de LilyPond. Se
3856 puede incorporar código escrito en el lenguaje de programación Scheme,
3857 directamente en el mecanismo de funcionamiento de LilyPond. Por
3858 supuesto, para hacer esto se necesitan al menos unos conocimientos
3859 básicos de programación en Scheme, y damos una introducción en el
3860 @ref{Tutorial de Scheme}.
3862 Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
3863 dar a una propiedad un valor constante, se puede establecer al
3864 resultado de un procedimiento de Scheme que se invoca cada vez que
3865 LilyPond accede a esta propiedad. La propiedad se puede establecer
3866 dinámicamente a un valor determinado por el procedimiento en el
3867 momento en que se invoca. En este ejemplo damos a las cabezas de las
3868 notas un color que depende de su posición dentro del pentagrama.
3870 @cindex x11-color, función, ejemplo de utilización
3871 @cindex NoteHead, ejemplo de sobreescritura
3872 @cindex color, propiedad, establecer a procedimiento de Scheme
3874 @lilypond[quote,verbatim,ragged-right]
3875 #(define (color-notehead grob)
3876 "Color the notehead according to its position on the staff."
3877 (let ((mod-position (modulo (ly:grob-property grob 'staff-position) 7)))
3879 ;; Return rainbow colors
3880 ((1) (x11-color 'red )) ; for C
3881 ((2) (x11-color 'orange )) ; for D
3882 ((3) (x11-color 'yellow )) ; for E
3883 ((4) (x11-color 'green )) ; for F
3884 ((5) (x11-color 'blue )) ; for G
3885 ((6) (x11-color 'purple )) ; for A
3886 ((0) (x11-color 'violet )) ; for B
3892 % Arrange to obtain color from color-notehead procedure
3893 \override NoteHead #'color = #color-notehead
3900 Some -- where o -- ver the Rain -- bow, way up high,
3904 Se pueden encontrar ejemplos adicionales que muestran la utilización
3905 de estos interfaces programables, en @ref{Trucos con Scheme}.