1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: d4f58bb3ad4e7fe1967a6b48f25e3addffc8aa14
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
13 @chapter Tweaking output
15 Este capítulo trata de cómo modificar la salida. LilyPond es extremadamente
16 configurable; prácticamente todos los fragmentos de la salida se pueden cambiar.
21 * The Internals Reference manual::
22 * Appearance of objects::
23 * Placement of objects::
24 * Collisions of objects::
29 @section Tweaking basics
32 * Introduction to tweaks::
33 * Objects and interfaces::
34 * Naming conventions of objects and properties::
38 @node Introduction to tweaks
39 @subsection Introduction to tweaks
41 El @q{Trucaje} es un término de LilyPond que denota los diversos
42 métodos que el usuario tiene a su disposición para modificar el
43 proceso de interpretación del archivo de entrada y cambiar la
44 apariencia de la salida impresa. Algunos trucos son muy fáciles de
45 usar; otros son más complejos. Pero en su conjunto, los métodos de
46 trucaje disponibles posibilitan conseguir casi cualquier apariencia
47 que deseemos en la música impresa.
49 En esta sección vamos a estudiar los conceptos básicos que se
50 necesitan para comprender el trucaje. Más tarde daremos un amplio
51 abanico de instrucciones listas para usar, que podrá simplemente
52 copiar para obtener el mismo efecto en sus partituras, y al mismo
53 tiempo mostraremos la forma de construir dichas instrucciones para que
54 pueda aprender cómo desarrollar sus propios trucos.
56 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
57 la sección @ref{Contexts and engravers}, pues los Contextos, los
58 Grabadores y las Propiedades que se contienen en ellos son
59 fundamentales para comprender y construir los trucos.
61 @node Objects and interfaces
62 @subsection Objects and interfaces
66 @cindex objeto de extensión
68 @cindex propiedades de objetos
69 @cindex objeto, propiedades de
70 @cindex layout (disposición), objeto de
71 @cindex objeto de disposición (layout)
73 El trucaje consiste en modificar el funcionamiento y estructura
74 interna del programa LilyPond, por lo que en primer lugar
75 introduciremos algunos términos que se usan para describir dichas
76 operaciones y estructuras internas.
78 El término @q{Objeto} es un término genérico que se usa para referirse
79 a la multitud de estructuras internas que LilyPond construye durante
80 el procesado de un archivo de entrada. Así, cuando se encuentra una
81 instrucción como @code{\new Staff}, se construye un objeto nuevo del
82 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
83 las propiedades asociadas con ese pentagrama en particular, por
84 ejemplo, su nombre y su armadura, además de otros detalles de los
85 grabadores que se han asignado para que operen dentro del contexto del
86 pentagrama. De forma similar, hay objetos que guardan las propiedades
87 de todos los demás contextos, como objetos de @code{Voice}, objetos de
88 @code{Score}, objetos de @code{Lyrics}, así como objetos que
89 representan todos los elementos notacionales como líneas divisorias,
90 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
91 objeto tiene su propio conjunto de valores de propiedad.
93 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
94 representan elementos de notación sobre la salida impresa como cabezas
95 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
96 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
97 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
98 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
99 mencionado, y también todos ellos tienen propiedades asociadas, como
100 su posición, tamaño, color,etc.
102 Ciertos objetos de presentación son aún más especializados. Las
103 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
104 y baja, y muchos otros objetos gráficos no están situados en un solo
105 lugar: tienen un punto de inicio, un punto de final, y quizá otras
106 propiedades relacionadas con su forma. Los objetos con una forma
107 extendida como estos, reciben el nombre de «Objetos de extensión» o
110 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
111 incluso aunque son bastante diferentes, comparten funcionalidades que
112 se deben procesar de la misma manera. Por ejemplo, todos los objetos
113 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
114 propiedades se procesan de la misma forma durante la interpretación
115 del archivo de entrada por parte de LilyPond. Para simplificar estas
116 operaciones internas, estas acciones y propiedades comunes se agrupan
117 en un objeto llamado @code{grob-interface}, interface de grob. Hay
118 muchas otras agrupaciones de propiedades comunes como ésta, y cada
119 una recibe un nombre que acaba en @code{interface}. En total hay más
120 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
121 interés y de utilidad para el usuario.
123 Estos son, en fin, los términos principales relativos a los objetos
124 que vamos a utilizar en este capítulo.
126 @node Naming conventions of objects and properties
127 @subsection Naming conventions of objects and properties
129 @cindex nomenclatura, convenciones de, para objetos
130 @cindex nomenclatura, convenciones de, para propiedades
131 @cindex objetos, convenciones de nomenclatura
132 @cindex propiedades, convenciones de nomenclatura
134 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
135 sección @ref{Contexts and engravers}. En este lugar, para más fácil
136 referencia, presentamos una lista de los tipos de objetos y
137 propiedades más comunes, junto con las convenciones según las cuales
138 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
139 utilizado una @q{A} mayúscula para denotar cualquier carácter
140 alfabético en mayúsculas, y @q{aaa} para cualquier número de
141 caracteres alfabéticos en minúscula. Otros caracteres se utilizan
142 literalmente como están.
144 @multitable @columnfractions .33 .33 .33
145 @headitem Objeto o tipo de propiedad
146 @tab Convención de nomenclatura
149 @tab Aaaa o AaaaAaaaAaaa
150 @tab Staff, GrandStaff
151 @item Objetos de presentación
152 @tab Aaaa o AaaaAaaaAaaa
155 @tab Aaaa_aaa_engraver
156 @tab Clef_engraver, Note_heads_engraver
158 @tab aaa-aaa-interface
159 @tab grob-interface, break-aligned-interface
160 @item Propiedades de contextos
161 @tab aaa o aaaAaaaAaaa
162 @tab alignAboveContext, skipBars
163 @item Propiedades de objetos de presentación
164 @tab aaa o aaa-aaa-aaa
165 @tab direction, beam-thickness
168 Como podremos ver en breve, las propiedades de distintos tipos de
169 objeto se modifican por parte de diferentes instrucciones; así pues,
170 es útil poder reconocer el tipo de objeto a partir de sus nombres de
173 @node Tweaking methods
174 @subsection Tweaking methods
176 @cindex trucaje, métodos de
178 @strong{La instrucción \override}
180 @cindex override, instrucción
181 @cindex override (sobreescritura), sintaxis de
186 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
187 usan para cambiar las propiedades de los @strong{contextos} y para
188 quitar y poner @strong{grabadores}, en @ref{Modifying context
189 properties} y @ref{Adding and removing engravers}. Ahora debemos
190 examinar algunas instrucciones importantes más.
192 La instrucción que cambia las propiedades de los @strong{objetos de
193 presentación} es @code{\override}. Puesto que esta instrucción debe
194 modificar propiedades internas que se encuentran en un lugar profundo
195 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
196 las instrucciones que hemos visto hasta ahora. Tiene que saber
197 exactamente qué propiedad de qué objeto y en qué contexto se debe
198 modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
200 La sintaxis genérica de esta instrucción es:
203 \override @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación} =
208 Esto establecerá la propiedad de nombre
209 @var{propiedad-de-presentación} del objeto de presentación con el
210 nombre @var{ObjetoDePresentación}, que es miembro del contexto
211 @var{Contexto}, al valor @var{valor}.
213 El @var{contexto} se puede omitir (y normalmente así es) cuando el
214 contexto requerido se encuentra implicado sin ambigüedad y es uno de
215 los contextos del nivel más bajo, es decir: @code{Voice},
216 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
217 ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
219 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
220 valores, pero para ilustrar el formato y utilización de estas
221 instrucciones usaremos sólo unas cuantas propiedades y valores
222 sencillos que sean fáciles de entender.
224 Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
225 propiedad de presentación, y el @code{#}, que debe preceder al valor.
226 Deben estar presentes siempre y de esa forma exacta. Es la
227 instrucción de uso más común dentro del trucaje, y durante la mayor
228 parte del resto de este capítulo presentaremos ejemplos de cómo se
229 usa. A continuación hay un ejemplo sencillo para cambiar el color de
232 @cindex color, propiedad, ejemplo
233 @cindex NoteHead, ejemplo de sobreescritura
235 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
237 \override NoteHead #'color = #red
239 \override NoteHead #'color = #green
243 @strong{La instrucción \revert}
245 @cindex revert, instrucción
250 Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
251 se sobreescribe de nuevo o se encuentra una instrucción
252 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
253 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
254 valor predeterminado original; observe que no es a su valor previo si
255 se han utilizado varias instrucciones @code{\override}.
258 \revert @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación}
261 Una vez más, igual que @var{Contexto} dentro de la instrucción
262 @code{\override}, con frecuencia no es necesario especificar el
263 @var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
264 Aquí devolvemos el color de la cabeza al valor predeterminado para las
267 @cindex color, propiedad, ejemplo
268 @cindex NoteHead, ejemplo de sobreescritura
270 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
272 \override NoteHead #'color = #red
274 \override NoteHead #'color = #green
276 \revert NoteHead #'color
280 @strong{El prefijo \once}
285 Tanto la instrucción @code{\override} como @code{\set} se pueden
286 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
287 @code{\override} o @code{\set} sea efectiva solamente durante el
288 tiempo musical en curso y antes de que la propiedad vuelva a tener
289 otra vez su valor predeterminado. Utilizando el mismo ejemplo,
290 podemos cambiar el color de una sola nota de la siguiente manera:
292 @cindex color, propiedad, ejemplo
293 @cindex NoteHead, ejemplo de sobreescritura
295 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
297 \once \override NoteHead #'color = #red
299 \once \override NoteHead #'color = #green
303 @strong{La instrucción \overrideProperty}
305 @cindex overrideProperty, instrucción
307 @funindex \overrideProperty
308 @funindex overrideProperty
310 Hay otra forma para la instrucción de sobreescritura,
311 @code{\overrideProperty}, que ocasionalmente es necesaria. La
312 mencionamos aquí con un propósito de exhaustividad, pero para ver más
313 detalles consulte @ruser{Difficult tweaks}.
314 @c Maybe explain in a later iteration -td
316 @strong{La instrucción \tweak}
318 @cindex tweak, instrucción
323 La última instrucción de trucaje que está disponible es @code{\tweak}.
324 Se debe utilizar para cambiar las propiedades de objetos que suceden
325 en el mismo momento musical, como las notas de un acorde. El uso de
326 @code{\override} para la sobreescritura afectaría a todas las notas
327 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
328 elemento del flujo de entrada.
330 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
331 cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
332 primer lugar, veamos lo que haría @code{\once \override}:
334 @cindex font-size, propiedad, ejemplo
335 @cindex NoteHead, ejemplo de sobreescritura
337 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
339 \once \override NoteHead #'font-size = #-3
344 Vemos que la sobreescritura con override afecta a @emph{todas} las
345 cabezas de las notas del acorde. Esto es así porque todas las notas
346 de un acorde ocurren en el mismo @emph{momento musical}, y la acción
347 de @code{\once} es aplicar la sobreescritura a todos los objetos de
348 presentación del tipo especificado que ocurren en el mismo momento
349 musical que la propia instrucción de sobreescritura @code{\override}.
351 La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
352 el elemento inmediatamente siguiente dentro del flujo de entrada. Sin
353 embargo, es efectivo solamente sobre objetos que se crean directamente
354 a partir del flujo de entrada, en esencia las cabezas y las
355 articulaciones; los objetos como las plicas y las alteraciones se
356 crean con posterioridad y no se pueden trucar de esta forma. Es más,
357 cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
358 dentro de un acorde, es decir, dentro de ángulos simples, así que para
359 trucar una sola nota la instrucción @code{\tweak} se debe colocar
360 dentro de ángulos simples junto con la nota.
362 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
363 se cambiaría de la siguiente forma:
365 @cindex font-size, propiedad, ejemplo
366 @cindex @code{\tweak}, ejemplo
368 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
370 <c \tweak #'font-size #-3 e g>4
373 Observe que la sintaxis de @code{\tweak} no es igual que la de
374 @code{\override}. Ni el contexto ni el objeto de presentación se
375 deben especificar; de hecho, generaría un error hacerlo. Los dos
376 están implícitos por el siguiente elemento del flujo de entrada.
377 Observe también que no debe haber un signo igual. Así que la sintaxis
378 genérica de la instrucción @code{\tweak} es, simplemente,
381 \tweak #'@var{propiedad-de-presentación} #@var{valor}
384 Una instrucción @code{\tweak} también se puede usar para modificar
385 sólo una de una serie de articulaciones, como se muestra aquí:
387 @cindex color, propiedad, ejemplo
388 @cindex @code{\tweak}, ejemplo
390 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
392 -\tweak #'color #red ^Red
393 -\tweak #'color #green _Green
397 Observe que la instrucción @code{\tweak} debe venir precedida de una
398 marca de articulación como si ella misma fuera una articulación.
400 @cindex grupos especiales anidados
401 @cindex tresillos anidados
402 @cindex corchete del grupo especial
403 @cindex corchete de tresillo
404 @cindex grupo especial, corchete de
405 @cindex tresillo, corchete de
407 @funindex TupletBracket
409 La instrucción @code{\tweak} también se debe usar para cambiar la
410 apariencia de uno solo de un conjunto de grupos especiales anidados
411 que comiencen en el mismo instante musical. En el siguiente ejemplo,
412 el corchete del tresillo largo y el primero de los tres corchetes
413 cortos empiezan en el mismo momento musical, y por ello cualquier
414 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
415 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
416 @code{\tweak} especifica que el corchete del tresillo largo se debe
417 colocar por encima de las notas y el segundo especifica que el número
418 del tresillo se debe imprimir en rojo sobre el corchete del primer
421 @cindex @code{\tweak}, ejemplo
422 @cindex direction, propiedad, ejemplo
423 @cindex color, propiedad, ejemplo
425 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
426 \tweak #'direction #up
429 \times 2/3 { c8[ c8 c8] }
430 \times 2/3 { c8[ c8 c8] }
431 \times 2/3 { c8[ c8 c8] }
435 Si los grupos anidados no comienzan en el mismo momento, su apariencia
436 se puede modificar de la forma usual mediante instrucciones
439 @cindex text, propiedad, ejemplo
440 @cindex tuplet-number, función, ejemplo
441 @cindex transparent, propiedad, ejemplo
442 @cindex TupletNumber, ejemplo de sobreescritura
444 @c NOTE Tuplet brackets collide if notes are high on staff
446 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
447 \times 2/3 { c8[ c c]}
448 \once \override TupletNumber
449 #'text = #tuplet-number::calc-fraction-text
453 \once \override TupletNumber #'transparent = ##t
454 \times 2/3 { c8[ c c] }
455 \times 2/3 { c8[ c c]}
461 Referencia de la notación:
462 @ruser{The tweak command}.
465 @node The Internals Reference manual
466 @section The Internals Reference manual
468 @cindex Internals Reference
471 * Properties of layout objects::
472 * Properties found in interfaces::
473 * Types of properties::
476 @node Properties of layout objects
477 @subsection Properties of layout objects
479 @cindex propiedades de los objetos de presentación
480 @cindex propiedades de los grobs
481 @cindex grobs, propiedades de
482 @cindex presentación, propiedades de los objetos de
483 @cindex Referencia de funcionamiento interno
485 Suponga que tiene una partitura con una ligadura de expresión que para
486 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
487 debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
488 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
489 piensa que una cierta instrucción de sobreescritura @code{\override}
490 será necesaria. Pero ¿existe una propiedad de grosor para las
491 ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
492 interviene el Manual de Funcionamiento Interno. Contiene toda la
493 información que puede necesitar para construir ésta y todas las demás
494 instrucciones @code{\override}, de sobreescritura.
496 Una advertencia antes de dirigir nuestra mirada a la referencia de
497 funcionamiento interno. Éste es un documento de @strong{referencia},
498 lo que significa que hay pocas o ninguna explicación en él: su
499 propósito es presentar la información de forma precisa y concisa. Por
500 tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
501 La guía y las explicaciones que presentamos aquí le permitirán extraer
502 la información de la referencia de funcionamiento interno por sí mismo
503 con tan sólo algo de práctica.
505 @cindex sobreescritura, ejemplo de
506 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
507 @cindex @code{\addlyrics}, ejemplo
510 Utilicemos un ejemplo concreto con un sencillo fragmento de música
513 @lilypond[quote,verbatim,relative=2]
518 g[( e]) e d[( f]) a |
522 The man who feels love's sweet e -- mo -- tion
527 Suponga ahora que decidimos que nos gustan las ligaduras algo más
528 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
529 presentación, así que la cuestión es @q{¿Hay una propiedad
530 perteneciente a las ligaduras de expresión que controle su grosor?}
531 Para responder a esta pregunta debemos mirar el manual de Referencia
532 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
533 (Internals Reference) en inglés}.
535 El RFI de la versión de LilyPond que está usando se puede encontrar en
536 la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
537 página de la documentación y siga el enlace Manual de Referencia de
538 Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
539 sería mejor que utilizase la versión en HTML, no la @q{en una sola
540 página} ni el PDF. Para que los siguientes párrafos tengan algún
541 sentido deberá consultarlo realmente al tiempo que lee.
543 @c Link names in English as those pages are not yet translated. FV
544 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
545 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
546 información sobre los objetos de presentación. Una vez allí, bajo el
547 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
548 objects}. La página que aparece relaciona todos los objetos de
549 presentación que se usan en su versión de LilyPond, en orden
550 alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
551 relacionadas las propiedades de las ligaduras de expresión o Slurs.
553 Una forma alternativa de encontrar esta página es a partir de la
554 Referencia de la Notación. En una de las páginas que tratan de las
555 ligaduras de expresión podrá encontrar un enlace al manual de
556 referencia del funcionamiento interno. Este enlace le llevará
557 directamente a esta página, aunque si tiene una idea del nombre del
558 objeto de presentación que pretende trucar, le resultará más fácil ir
559 directamente al RFI y buscar allí.
561 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
562 dice en primer lugar que los objetos Slur se crean por el grabador
563 Slur_engraver. A continuación relaciona los ajustes estándar.
564 Observe que @strong{no} están en orden alfabético. Navegue hacia
565 abajo buscando una propiedad que pudiera controlar el grosor de las
566 ligaduras, y encontrará
569 @code{thickness} (number)
571 Line thickness, generally measured in @code{line-thickness}
574 Esto promete ser una buena opción para cambiar el grosor. Nos dice
575 que el valor de @code{thickness} es un simple @emph{número}, que el
576 valor predeterminado es 1.2, y que las unidades están dentro de otra
577 propiedad llamada @code{line-thickness}.
579 Como dijimos con anterioridad, existen entre pocas y ninguna
580 explicación en el RFI, pero ya tenemos información suficiente para
581 probar a cambiar el grosor de la ligadura. Vemos que el nombre del
582 objeto de presentación es @code{Slur}, que el nombre de la propiedad
583 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
584 un número algo más grande que 1.2 si queremos hacer las ligaduras más
587 Ahora podemos construir la instrucción de sobreescritura
588 @code{\override} simplemente mediante la sustitución de los valores
589 que hemos encontrado para los nombres, omitiendo el contexto.
590 Usaremos un valor muy grande para el grosor al principio, para estar
591 seguros de que la instrucción está funcionando. Obtenemos lo
595 \override Slur #'thickness = #5.0
598 ¡No olvide el @code{#'} antes del nombre de la propiedad y @code{#}
599 antes del valor nuevo!
601 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
602 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
603 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
604 cerca de ella.} Hagámoslo así:
606 @cindex Slur, ejemplo de sobreescritura
607 @cindex thickness, propiedad, ejemplo
609 @lilypond[quote,verbatim,relative=2]
613 % Increase thickness of all following slurs from 1.2 to 5.0
614 \override Slur #'thickness = #5.0
616 g[( e]) e d[( f]) a |
620 The man who feels love's sweet e -- mo -- tion
626 y podemos ver que la ligadura, es sin duda, más pesada.
628 Así pues, ésta es la forma básica de construir instrucciones
629 @code{\override} o de sobreescritura. Existen unas cuantas
630 complicaciones más con las que nos encontraremos en secciones
631 posteriores, pero ahora conoce todos los principios esenciales que
632 necesita para hacerlo por sí mismo (aunque aún necesita algo de
633 práctica). La cual vendrá proporcionada por los ejemplos que vienen a
636 @subheading Finding the context
638 @cindex contexto, encontrar
639 @cindex contexto, buscar el, correcto
641 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
642 especificar el contexto? ¿Cuál sería? Podemos suponer que las
643 ligaduras están en el contexto de Voz, por estar claramente asociados
644 de manera estrecha con las líneas individuales de música, pero
645 ¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
646 de la página del RFI que describe las ligaduras (Slur), donde dice
647 @q{Slur objects are created by: Slur engraver} («Los objetos de
648 ligadura de expresión se crean por: el grabador Slur»). Así pues, las
649 ligaduras de expresión se crean en cualquier contexto en el que se
650 encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
651 página del grabador @code{Slur_engraver}. Al final del todo, dice que
652 el grabador @code{Slur_engraver} es parte de cinco contextos de voz,
653 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
654 suposición era acertada. Y a causa de que @code{Voice} es uno de los
655 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
656 por el hecho de que estamos escribiendo notas, podemos omitirlo en
659 @subheading Overriding once only
661 @cindex sobreescritura por una sola vez
662 @cindex once override
667 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
668 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
669 ligadura fuese más gruesa? Esto se consigue con la instrucción o
670 prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
671 @code{\override} ocasiona que solamente cambie la ligadura que
672 comienza en la nota @strong{inmediata siguiente}. Si la nota
673 inmediata siguiente no da inicio a una ligadura, la instrucción no
674 tiene ningún efecto en absoluto: no se recuerda hasta que se
675 encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
676 la instrucción que lleva @code{\once} se debe reposicionar de la forma
679 @cindex Slur, ejemplo de sobreescritura
680 @cindex thickness, propiedad, ejemplo
682 @lilypond[quote,verbatim,relative=2]
687 % Increase thickness of immediately following slur only
688 \once \override Slur #'thickness = #5.0
690 g[( e]) e d[( f]) a |
694 The man who feels love's sweet e -- mo -- tion
700 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
702 La instrucción o prefijo @code{\once} también se puede usar antes de
703 la instrucción @code{\set}.
705 @subheading Reverting
708 @cindex predeterminadas, recuperar las propiedades
713 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
714 fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
715 una de ellas precedida por el prefijo @code{\once}, situadas
716 inmediatamente antes de cada una de las notas en que comienzan las
719 @cindex Slur, ejemplo de sobreescritura
720 @cindex thickness, propiedad, ejemplo
722 @lilypond[quote,verbatim,relative=2]
727 % Increase thickness of immediately following slur only
728 \once \override Slur #'thickness = #5.0
730 % Increase thickness of immediately following slur only
731 \once \override Slur #'thickness = #5.0
732 g[( e]) e d[( f]) a |
736 The man who feels love's sweet e -- mo -- tion
742 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
743 instrucción @code{\revert} (restablecer) para devolver la propiedad
744 del grosor, @code{thickness}, a su valor predeterminado después de la
747 @cindex Slur, ejemplo de sobreescritura
748 @cindex thickness, propiedad, ejemplo
750 @lilypond[quote,verbatim,relative=2]
755 % Increase thickness of all following slurs from 1.2 to 5.0
756 \override Slur #'thickness = #5.0
759 % Revert thickness of all following slurs to default of 1.2
760 \revert Slur #'thickness
765 The man who feels love's sweet e -- mo -- tion
771 la instrucción @code{\revert} se puede utilizar para devolver
772 cualquier propiedad que se haya cambiado con @code{\override} a su
773 valor predeterminado. Puede utilizar el método que mejor se adapte a
774 aquello que quiere hacer.
776 Así finaliza nuestra introducción al manual de RFI, y el método básico
777 de trucaje. A continuación, en las últimas secciones de este capítulo
778 encontrará varios ejemplos, en parte para introducirle en algunas de
779 las posibilidades adicionales del manual RFI, y en parte para
780 proporcionarle más práctica en cómo extraer información de él. Estos
781 ejemplos irán conteniendo cada vez menos palabras de guía y
784 @node Properties found in interfaces
785 @subsection Properties found in interfaces
788 @cindex propiedades de los interfaces
789 @cindex interfaces, propiedades
791 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
792 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
793 En primer lugar miramos en la página del RFI que relaciona todos los
794 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
795 pueda controlar la letra de la canción. Encontramos @code{LyricText},
796 que parece adecuado. Al seguir este enlace se presentan las
797 propiedades ajustables para el texto de la letra. Estos incluyen
798 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
799 una forma cursiva. Esto es porque la propiedad de la forma es común a
800 todos los objetos de fuente tipográfica, y por tanto, en vez de
801 incluirlo en cada uno de los objetos de presentación, se agrupa junto
802 con otras propiedades comunes similares y se deposita en un
803 @strong{Interface}, el interface de las fuentes tipográficas
804 @code{font-interface}.
806 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
807 de los interfaces, y descubrir qué objetos usan estas propiedades de
810 Mire de nuevo la página del RFI que describe a LyricText. Al final de
811 la página hay una lista de enlaces a los interfaces que LyricText
812 contempla. La lista tiene siete elementos, entre ellos
813 @code{font-interface}. Al seguir este enlace llegamos a las
814 propiedades asociadas con este interface, que también son propiedades
815 de todos los objetos que lo llevan, entre ellos LyricText.
817 Ahora vemos todas las propiedades ajustables por el usuario que
818 controlan las tipografías, entre ellas @code{font-shape(symbol)},
819 donde @code{symbol} se puede establecer a @code{upright} (recta),
820 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
822 Observará que @code{font-series} y @code{font-size} también se
823 encuentran aquí relacionadas. Esto inmediatamente hace que surja la
824 pregunta: ¿Por qué están las propiedades comunes de tipografía
825 @code{font-series} y @code{font-size} relacionadas bajo
826 @code{LyricText} así como bajo el interface @code{font-interface} pero
827 @code{font-shape} no lo está? La respuesta es que @code{font-series}
828 y @code{font-size} se cambian a partir de sus valores predeterminados
829 globales cuando se crea un objeto @code{LyricText}, pero
830 @code{font-shape} no lo hace. Entonces los elementos de la lista
831 @code{LyricText} le dicen los valores para esas dos propiedades que
832 son de aplicación para @code{LyricText}. Otros objetos que contemplan
833 @code{font-interface} establecerán dichas propiedades de forma
834 diferente cuando se crean.
836 Veamos si ahora podemos construir la instrucción @code{\override} para
837 cambiar la letra a cursiva. El objeto es @code{LyricText}, la
838 propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
839 antes, omitiremos el contexto.
841 Como nota aparte, aunque una nota importante, observe que a causa de
842 que los valores de @code{font-shape} son símbolos, deben ir precedidos
843 de un apóstrofo, @code{'}. Esa es la razón por la que se necesitan
844 apóstrofos antes de @code{thickness} en el ejemplo anterior y en
845 @code{font-shape}. Los dos son también símbolos. Los símbolos son
846 nombres especiales que son conocidos por LilyPond internamente.
847 Algunos de ellos son nombres de propiedades, como @code{thickness} o
848 @code{font-shape}, otros se utilizan como valores que se les puede dar
849 a las propiedades, como @code{italic}. Observe la distinción entre
850 esto y las cadenas de texto arbitrarias, que aparecerían
851 entrecomilladas como @code{"a text string"}. Para ver más detalles
852 relacionados con los símbolos y las cadenas, consulte @ref{Scheme
855 Así pues, la instrucción @code{\override} que necesitamos para
856 imprimir la letra en cursiva sería
859 \override LyricText #'font-shape = #'italic
863 y debe colocarse justo delante de, y cerca de, la letra a la que debe
866 @cindex font-shape, propiedad, ejemplo
867 @cindex italic, ejemplo
868 @cindex LyricText, ejemplo de sobreescritura
869 @cindex @code{\addlyrics}, ejemplo
871 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
876 g[( e]) e d[( f]) a |
880 \override LyricText #'font-shape = #'italic
881 The man who feels love's sweet e -- mo -- tion
887 y toda la letra se imprime en cursiva.
889 @subheading Specifying the context in lyric mode
891 @cindex contexto, especificación en modo letra
892 @cindex letra, modo, especificar el contexto en
894 En el caso de la letra, si intenta especificar el contexto en el
895 formato que acabamos de dar, la instrucción no funcionará. Una
896 sílaba escrita en el modo letra, «lyricmode» termina en un espacio, un
897 salto de línea o un dígito. Cualquier otro carácter se incluye como
898 parte de la sílaba. Por esta razón, un espacio o salto de línea debe
899 aparecer antes del último símbolo @code{@}} para evitar que se incluya
900 como parte de la sílaba final. De forma similar, se deben insertar
901 espacios antes y después del punto, @q{.}, separando el nombre del
902 contexto del nombre del objeto, pues en caso contrario los dos nombres
903 se juntarán y el intérprete no podrá reconocerlos. Así pues, la
907 \override Lyrics . LyricText #'font-shape = #'italic
910 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
911 final y la llave de cierre.}
913 @warning{En las sobreescrituras con override dentro de la letra,
914 escriba siempre espacios antes y después del punto que separa el
915 nombre del contexto y el nombre del objeto.}
919 Manual de aprendizaje:
920 @ref{Scheme tutorial}.
923 @node Types of properties
924 @subsection Types of properties
926 @cindex propiedades, tipos de
928 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
929 @code{símbolo}. Para que sea válido, el valor que se da a una
930 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
931 tipo. El tipo de la propiedad se muestra siempre entre paréntesis
932 después del nombre de la propiedad en el RFI. He aquí una lista de
933 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
934 algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
935 @code{#}, por supuesto, delante de estos valores cuando se introducen
936 en la instrucción @code{\override}.
938 @multitable @columnfractions .2 .45 .35
939 @headitem Tipo de propiedad
943 @tab Verdadero o Falso, representado por #t o #f
944 @tab @code{#t}, @code{#f}
945 @item Dimensión (en espacios de pentagrama)
946 @tab Un número decimal positivo (en unidades de espacios de pentagrama)
947 @tab @code{2.5}, @code{0.34}
949 @tab Una constante válida de dirección o su equivalente numérico (se permiten valores decimales entre -1 y 1)
950 @tab @code{LEFT}, @code{CENTER}, @code{UP},
953 @tab Un número entero positivo
954 @tab @code{3}, @code{1}
956 @tab Un conjunto de valores separados por espacios, encerrado entre paréntesis y precedido de un apóstrofo
957 @tab @code{'(left-edge staff-bar)}, @code{'(1)},
958 @code{'(1.0 0.25 0.5)}
960 @tab Cualquier elemento válido de marcado de texto
961 @tab @code{\markup @{ \italic "cresc." @}}
963 @tab Una fracción de redonda construida con la función make-moment
964 @tab @code{(ly:make-moment 1 4)},
965 @code{(ly:make-moment 3 8)}
967 @tab Cualquier valor decimal positivo o negativo
968 @tab @code{3.5}, @code{-2.45}
969 @item Pareja (de números)
970 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
971 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
973 @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
974 @tab @code{'italic}, @code{'inside}
976 @tab Un procedimiento o @code{#f} para no producir ninguna acción
977 @tab @code{bend::print}, @code{ly:text-interface::print},
980 @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofo-almohadilla, @code{'#}.
981 @tab @code{'#(#t #t #f)}
986 Manual de aprendizaje:
987 @ref{Scheme tutorial}.
990 @node Appearance of objects
991 @section Appearance of objects
993 Ahora vamos a poner en práctica lo que hemos aprendido con unos
994 cuantos ejemplos que muestran cómo se pueden usar los trucos para
995 cambiar el aspecto de la música impresa.
998 * Visibility and color of objects::
1000 * Length and thickness of objects::
1003 @node Visibility and color of objects
1004 @subsection Visibility and color of objects
1006 Dentro de un uso educativo de la música, podríamos desear imprimir una
1007 partitura con ciertos elementos omitidos como ejercicio para el
1008 alumno, a quien se le pide que los complete. A la manera de ejemplo
1009 sencillo, supongamos que el ejercicio es escribir las líneas
1010 divisorias que faltan en un fragmento musical. Pero las líneas
1011 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
1014 Antes de enredarnos con esto, recordemos que las propiedades de los
1015 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
1016 @ref{Properties found in interfaces}). Esto es simplemente agrupar
1017 las propiedades que se pueden usar juntas para trucar un objeto
1018 gráfico: si una de ellas se necesita para un objeto, también las
1019 otras. Así, ciertos objetos usan las propiedades de algunos
1020 interfaces, otros usan las de otros interfaces. Los interfaces que
1021 contienen las propiedades que un determinado grob necesita se
1022 encuentran relacionadas en el manual RFI al final de la página que
1023 describe dicho grob, y esas propiedades se pueden ver mirando dichos
1026 Hemos explicado cómo encontrar información sobre los grobs en
1027 @ref{Properties of layout objects}. Usando el mismo enfoque, vamos al
1028 RFI para buscar el objeto de presentación que imprime las líneas
1029 divisorias. A través del enlace @emph{Backend} y @emph{All layout
1030 objects} encontramos que hay un objeto de presentación llamado
1031 @code{BarLine}. Entre sus propiedades se encuentran dos que controlan
1032 la visibilidad: @code{break-visibility} y @code{stencil}. Las líneas
1033 divisorias también contemplan un número de interfaces, entre ellos el
1034 @code{grob-interface}, donde podemos encontrar las propiedades
1035 @code{transparent} y @code{color}. Todas ellas pueden afectar la
1036 visibilidad de las barras de compás (y, por supuesto, por extensión,
1037 también la de muchos otros objetos de presentación). Vamos a
1038 considerar cada uno de ellos por orden.
1042 @cindex stencil (sello), propiedad
1044 Esta propiedad controla la apariencia de las barras de compás mediante
1045 la especificación del símbolo (o «glifo») que se debe imprimir. Igual
1046 que como otras muchas propiedades, se puede establecer de forma que no
1047 imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
1048 antes, omitiendo el Contexto implícito, @code{Voice}:
1050 @cindex BarLine, ejemplo de sobreescritura
1051 @cindex stencil, propiedad, ejemplo
1053 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1056 \override BarLine #'stencil = ##f
1058 g, a16 b8 c d4 e16 |
1063 Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
1064 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
1065 objeto BarLine. Al principio de la página dice @qq{Barline objects
1066 are created by: Bar_engraver} (los objetos Barline se crean por el
1067 grabador Bar_engraver). Vaya a la página del grabador
1068 @code{Bar_engraver} siguiendo el enlace. Al final da una lista de
1069 contextos en los que el grabador de líneas divisorias opera. Todos
1070 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
1071 @code{\override} no funcionara como esperábamos, es porque
1072 @code{Barline} no se encuentra en el contexto predeterminado
1073 @code{Voice}. Si el contexto se especifica mal, la instrucción
1074 simplemente no funciona. No se produce ningún mensaje de error, y no
1075 se registra nada en el archivo log de registro. Vamos a intentar
1076 corregirlo escribiendo el contexto correcto:
1078 @cindex BarLine, ejemplo de sobreescritura
1079 @cindex stencil, propiedad, ejemplo
1081 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1084 \override Staff.BarLine #'stencil = ##f
1086 g, a16 b8 c d4 e16 |
1091 Ahora las barras de compás han desaparecido.
1093 Sin embargo, observe que el establecimiento de la propiedad
1094 @code{stencil} al valor @code{#f} produce errores cuando las se
1095 requieren las dimensiones del objeto para un procesamiento correcto.
1096 Por ejemplo, se generan errores si la propiedad @code{stencil} del
1097 objeto @code{NoteHead} se establece al valor @code{#f}.
1099 @subheading break-visibility
1101 @cindex break-visibility, propiedad
1103 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI que
1104 la propiedad @code{break-visibility} requiere un vector de tres
1105 valores booleanos. Controlan respectivamente si las barras de compás
1106 se imprimen al final de una línea, en mitad de una línea, y al
1107 principio de las líneas. Para nuestro ejemplo, queremos que todas las
1108 barras de compás se supriman, por lo que el valor que necesitamos es
1109 @code{'#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
1110 de @code{Staff}. Observe también que al escribir este valor tenemos
1111 @code{#'#} antes del paréntesis de apertura. Se necesita @code{'#}
1112 como parte del valor para introducir un vector, y el primer símbolo de
1113 almohadilla @code{#} se necesita, como siempre, para preceder el valor
1114 en sí dentro de la instrucción @code{\override}.
1116 @cindex BarLine, ejemplo de sobreescritura
1117 @cindex break-visibility, propiedad, ejemplo
1119 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1122 \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
1124 g, a16 b8 c d4 e16 |
1129 Y podemos ver que esto también quita todas las líneas divisorias.
1131 @subheading transparent
1133 @cindex transparent, propiedad
1134 @cindex transparencia
1136 En la relación de propiedades que se especifican en la página del
1137 @code{grob-interface} del RFI podemos ver que la propiedad
1138 @code{transparent} es un valor booleano. Esto se debe establecer a
1139 @code{#t} para hacer que el grob sea transparente. En el ejemplo
1140 siguiente vamos a hacer que la indicación de compás, y no las líneas
1141 divisorias, sea transparente. Para hacerlo tenemos que buscar el
1142 nombre del grob de la indicación de compás. Volviendo a la página
1143 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1144 presentación @code{TimeSignature}. Se produce por parte del grabador
1145 @code{Time_signature_engraver} que como puede comprobar vive dentro
1146 del contexto de @code{Staff} y también contempla el interface
1147 @code{grob-interface}. Así pues, la instrucción que hace transparente
1148 a la indicación de compás es:
1150 @cindex TimeSignature, ejemplo de sobreescritura
1151 @cindex transparent, propiedad, ejemplo
1153 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1156 \override Staff.TimeSignature #'transparent = ##t
1158 g, a16 b8 c d4 e16 |
1164 El compás ya no está, pero esta instrucción deja una separación en el
1165 lugar donde antes estaba la indicación de compás. Quizá esto es lo
1166 que queremos para un ejercicio en que el alumno deba escribirlo, pero
1167 en otras circunstancias esta separación podría no ser deseable. En
1168 vez de eso, para quitarla, el stencil o «sello» de la indicación de
1169 compás se debe establecer al valor @code{#f}:
1171 @cindex TimeSignature, ejemplo de sobreescritura
1172 @cindex stencil, propiedad, ejemplo
1174 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1177 \override Staff.TimeSignature #'stencil = ##f
1179 g, a16 b8 c d4 e16 |
1185 y la diferencia es obvia: al establecer el sello al valor @code{#f}
1186 quitamos el objeto por completo; al hacer el objeto @code{transparent}
1187 lo dejamos donde está, pero lo hacemos invisible.
1191 @cindex color, propiedad
1193 Para finalizar, intentemos hacer invisibles las barras de compás
1194 pintándolas de color blanco (hay un problema relacionado, que consiste
1195 en que la línea divisoria blanca puede tapar o no tapar las líneas del
1196 pentagrama a las que cruza. Podrá observar en algunos de los ejemplos
1197 que aparecen a continuación, que esto sucede de forma impredecible.
1198 Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
1199 estudian en @ruser{Painting objects white}; de momento estamos
1200 estudiando el color, por lo que le rogamos que acepte esta limitación
1203 El interface @code{grob-interface} especifica que la propiedad del
1204 color es una lista, pero no hay ninguna explicación sobre lo que debe
1205 ir en esa lista. La lista que requiere es realmente una lista de
1206 valores en unidades internas, pero para evitar tener que saber cuáles
1207 son, se ofrecen varias vías para la especificación de los colores. La
1208 primera forma es utilizar uno de los colores @q{normales} que están
1209 relacionados en la primera tabla de la @ruser{List of colors}. Para
1210 poner las líneas divisorias de color blanco, escribimos:
1212 @cindex BarLine, ejemplo de sobreescritura
1213 @cindex color, propiedad, ejemplo
1215 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1218 \override Staff.BarLine #'color = #white
1220 g, a16 b8 c d4 e16 |
1226 y de nuevo podemos comprobar que las barras de compás no son visibles.
1227 Observe que @emph{white} no viene precedido de un apóstrofo: no es un
1228 símbolo, sino una @emph{función}. Cuando se invoca, proporciona la
1229 lista de valores internos que se requieren para establecer el color a
1230 blanco. Los otros colores de la lista normal también son funciones.
1231 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1232 una de las otras funciones de la lista.
1234 @cindex colores de X11
1235 @cindex X11, colores de
1239 La segunda forma de cambiar el color es utilizar la lista de nombres
1240 de colores de X11 que aparecen en la segunda lista de @ruser{List of
1241 colors}. Sin embargo, éstos deben ir precedidos de otra función, que
1242 convierte los nombres de colores de X11 en la lista de valores
1243 internos, @code{x11-color}, de la siguiente manera:
1245 @cindex BarLine, ejemplo de sobreescritura
1246 @cindex color, propiedad, ejemplo
1248 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1251 \override Staff.BarLine #'color = #(x11-color 'white)
1253 g, a16 b8 c d4 e16 |
1259 Observe que en este caso la función @code{x11-color} toma un símbolo
1260 como argumento, así que el símbolo debe ir precedido de un apóstrofo y
1261 los dos deben ir entre paréntesis.
1263 @cindex rgb, colores
1268 Aún hay una tercera función, que convierte valores RGB en colores
1269 internos: la función @code{rgb-color}. Toma tres argumentos que dan
1270 las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
1271 valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
1272 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1273 @code{(rgb-color 1 1 1)}:
1275 @cindex BarLine, ejemplo de sobreescritura
1276 @cindex color, propiedad, ejemplo
1278 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1281 \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1283 g, a16 b8 c d4 e16 |
1288 Finalmente, existe también una escala de grises como parte del
1289 conjunto de colores de X11. Varían desde el negro, @code{'grey0'},
1290 hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
1291 estableciendo todos los objetos de presentación de nuestro ejemplo a
1292 varias gradaciones de gris:
1294 @cindex StaffSymbol, ejemplo de sobreescritura
1295 @cindex TimeSignature, ejemplo de sobreescritura
1296 @cindex Clef, ejemplo de sobreescritura
1297 @cindex NoteHead, ejemplo de sobreescritura
1298 @cindex Stem, ejemplo de sobreescritura
1299 @cindex BarLine, ejemplo de sobreescritura
1300 @cindex color property, ejemplo
1301 @cindex x11-color, ejemplo de utilización
1303 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1306 \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
1307 \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1308 \override Staff.Clef #'color = #(x11-color 'grey60)
1309 \override Voice.NoteHead #'color = #(x11-color 'grey85)
1310 \override Voice.Stem #'color = #(x11-color 'grey85)
1311 \override Staff.BarLine #'color = #(x11-color 'grey10)
1313 g, a16 b8 c d4 e16 |
1319 Observe los contextos asociados con cada uno de los objetos de
1320 presentación. Es importante que estén correctamente escritos, o las
1321 instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
1322 que se encuentra el grabador correspondiente. El contesto
1323 predeterminado para los grabadores puede encontrarse empezando por el
1324 objeto de presentación, de ahí al grabador que lo produce, y en la
1325 página del grabador del RFI aparece en qué contexto se puede encontrar
1326 normalmente el grabador.
1329 @node Size of objects
1330 @subsection Size of objects
1332 @cindex cambiar el tamaño de los objetos
1333 @cindex tamaño de los objetos
1334 @cindex objetos, tamaño de
1335 @cindex objetos, cambiar el tamaño de
1337 Empezaremos examinando de nuevo un ejemplo anterior (véase
1338 @ref{Nesting music expressions}) que nos mostraba cómo introducir un
1339 pentagrama temporal, como en un @rglos{ossia}.
1341 @cindex alignAboveContext, propiedad, ejemplo
1342 @cindex @code{\with}, ejemplo
1344 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1345 \new Staff ="main" {
1352 alignAboveContext = #"main" }
1360 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1361 por lo normal se imprimen más pequeños que el pentagrama principal.
1362 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1363 el sello de cada uno de ellos a @code{#f}, como sigue:
1365 @cindex alignAboveContext, propiedad, ejemplo
1366 @cindex @code{\with}, ejemplo
1367 @cindex stencil, propiedad, ejemplo
1368 @cindex Clef, ejemplo de sobreescritura
1369 @cindex TimeSignature, ejemplo de sobreescritura
1371 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1372 \new Staff ="main" {
1379 alignAboveContext = #"main"
1382 \override Staff.Clef #'stencil = ##f
1383 \override Staff.TimeSignature #'stencil = ##f
1393 donde el par de llaves adicional después de la cláusula @code{\with}
1394 es necesario para asegurar que la sobreescritura encerrada y la música
1395 se aplican al pentagrama de ossia.
1397 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1398 usando @code{\with} y modificar los sellos de clave y de compás con
1399 \override? La diferencia principal es que los cambios que se realizan
1400 en una cláusula @code{\with} se hacen en el momento en que se crea el
1401 contexto, y permanecen activos como valores @strong{predeterminados}
1402 durante toda la duración de dicho contexto, mientras que las
1403 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1404 música son dinámicas: hacen cambios sincronizados con un punto
1405 concreto de la música. Si los cambios se deshacen o se devuelven
1406 mediante @code{\unset} o @code{\revert} volverán a su valor
1407 predeterminado que será el establecido en la cláusula @code{\with}, o
1408 si no se ha establecido ninguno en este lugar, los valores
1409 predeterminados normales.
1411 Ciertas propiedades de contexto se pueden modificar solamente dentro
1412 de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
1413 cambiar después de que el contexto se ha creado.
1414 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1415 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1416 alineación está decidida y no tendría sentido intentar cambiarla más
1419 Los valores predeterminados de las propiedades de los objetos de
1420 presentación también se pueden establecer dentro de cláusulas
1421 @code{\with}. Simplemente utilice la instrucción @code{\override}
1422 normal dejando aparte el nombre del contexto, ya que está definido sin
1423 ambigüedad como el contexto que la cláusula @code{\with} está
1424 modificando. De hecho, se producirá un error si se especifica un
1425 contexto en este lugar.
1427 Así pues, podemos reemplazar el ejemplo anterior con
1429 @cindex alignAboveContext, propiedad, ejemplo
1430 @cindex @code{\with}, example
1431 @cindex Clef, ejemplo de sobreescritura
1432 @cindex TimeSignature, ejemplo de sobreescritura
1434 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1435 \new Staff ="main" {
1442 alignAboveContext = #"main"
1443 % Don't print clefs in this staff
1444 \override Clef #'stencil = ##f
1445 % Don't print time signatures in this staff
1446 \override TimeSignature #'stencil = ##f
1455 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1458 Ciertos objetos de presentación se crean como glifos sacados de una
1459 fuente tipográfica. Entre ellos se encuentran las cabezas,
1460 alteraciones, elementos de marcado, claves, indicaciones de compás,
1461 indicaciones dinámicas y la letra de las canciones. Su tamaño se
1462 cambia mediante la modificación de la propiedad @code{font-size}, como
1463 veremos en breve. Otros objetos de presentación como ligaduras de
1464 unión y de expresión (en general, objetos de extensión) se trazan
1465 individualmente, por lo que no hay un tamaño de tipografía
1466 @code{font-size} asociado a ellos. Estos objetos generalmente derivan
1467 su tamaño de los objetos a los que están adosados, y por ello
1468 normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
1469 otras propiedades como la longitud de las plicas y las barras de
1470 compás, el grosor de las barras de corchea y otras líneas, y la
1471 separación de las líneas del pentagrama se deben modificar de otras
1474 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1475 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1476 cambiar el tamaño de las tipografías de cada uno de los tipos de
1477 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1480 \override NoteHead #'font-size = #-2
1483 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1484 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1485 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1492 Los dos enunciados producirían una reducción del tamaño de la
1493 tipografía en dos pasos a partir de su valor previo, donde cada paso
1494 reduce o aumenta el tamaño aproximadamente en un 12%.
1496 Vamos a probarlo en nuestro ejemplo del ossia:
1498 @cindex alignAboveContext, propiedad, ejemplo
1499 @cindex @code{\with}, ejemplo
1500 @cindex Clef, ejemplo de sobreescritura
1501 @cindex TimeSignature, ejemplo de sobreescritura
1502 @cindex fontSize, propiedad, ejemplo
1504 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1505 \new Staff ="main" {
1512 alignAboveContext = #"main"
1513 \override Clef #'stencil = ##f
1514 \override TimeSignature #'stencil = ##f
1515 % Reduce all font sizes by ~24%
1525 Aún no está demasiado bien. Las cabezas y los corchetes de las notas
1526 son más pequeños, pero las plicas son demasiado largas en proporción,
1527 y las líneas del pentagrama están demasiado separadas entre sí. Se
1528 debe reducir su escala en proporción a la reducción de la tipografía.
1529 El siguiente apartado trata sobre cómo se hace esto.
1531 @node Length and thickness of objects
1532 @subsection Length and thickness of objects
1538 @cindex tamaño, cambiar
1539 @cindex plica, cambiar la longitud
1540 @cindex pentagrama, cambiar la separación de las líneas
1542 Las distancias y longitudes en LilyPond se miden generalmente en
1543 espacios de pentagrama, la distancia entre líneas adyacentes de la
1544 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1545 de las propiedades de @code{thickness} (grosor) se miden en unidades
1546 de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
1547 de forma predeterminada, a las líneas de los reguladores se les da un
1548 grosor de 1 unidad de @code{line-thickness}, mientras que el
1549 @code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
1550 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1551 barras de corchea se mide en espacios de pentagrama.
1553 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1554 tamaño de la tipografía? Se puede hacer con la ayuda de una función
1555 especial que se llama @code{magstep}, pensada especialmente para este
1556 propósito. Toma un argumento, el cambio de tamaño de la tipografía
1557 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1558 para reducir otros objetos en la misma proporción. Se usa de la
1561 @cindex alignAboveContext, propiedad, ejemplo
1562 @cindex @code{\with}, ejemplo
1563 @cindex Clef, ejemplo de sobreescritura
1564 @cindex TimeSignature, ejemplo de sobreescritura
1565 @cindex fontSize, propiedad, ejemplo
1566 @cindex StaffSymbol, ejemplo de sobreescritura
1567 @cindex magstep, función, ejemplo de utilización
1568 @cindex staff-space, propiedad, ejemplo
1569 @cindex stencil, propiedad, ejemplo
1571 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1572 \new Staff ="main" {
1579 alignAboveContext = #"main"
1580 \override Clef #'stencil = ##f
1581 \override TimeSignature #'stencil = ##f
1583 % Reduce stem length and line spacing to match
1584 \override StaffSymbol #'staff-space = #(magstep -2)
1594 Puesto que la longitud de las plicas y muchas otras propiedades
1595 relacionadas con la longitudes calculan siempre con relación al valor
1596 de la propiedad @code{staff-space}, su longitud también ve reducida su
1597 escala automáticamente. Observe que esto afecta solamente a la escala
1598 vertical del ossia: la escala horizontal se determina por medio de la
1599 disposición de la música principal con el objeto de mantenerse en
1600 sincronía con ella, de forma que no resulte afectada por ninguno de
1601 estos cambios de tamaño. Por supuesto, si la escala de toda la música
1602 principal se cambiase de esta forma, entonces el espaciado horizontal
1603 se vería afectado. Trataremos de esto más tarde en la sección sobre
1606 Esto, en fin, completa la creación de un ossia. Los tamaños y
1607 longitudes del resto de los objetos se pueden modificar de manera
1610 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1611 grosor de las diversas líneas dibujadas como divisorias, barras de
1612 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1613 ajuste global. Si el grosor de cualquier objeto de presentación en
1614 particular necesita ajustarse, se puede hacer mejor mediante la
1615 sobreescritura de su propiedad @code{thickness}. Anteriormente
1616 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1617 @ref{Properties of layout objects}. El grosor de todos los objetos
1618 trazados (es decir, aquellos que no se producen a partir de una
1619 tipografía) se pueden cambiar de la misma forma.
1622 @node Placement of objects
1623 @section Placement of objects
1626 * Automatic behaviour::
1627 * Within-staff objects::
1628 * Outside-staff objects::
1632 @node Automatic behaviour
1633 @subsection Automatic behaviour
1635 @cindex dentro del pentagrama, objetos
1636 @cindex fuera del pentagrama, objetos
1637 @cindex objetos dentro del pentagrama
1638 @cindex objetos fuera del pentagrama
1640 Hay ciertos objetos en notación musical que pertenecen al pentagrama y
1641 otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
1642 objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
1645 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1646 pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
1647 se fijan por la propia música; se posicionan verticalmente sobre
1648 líneas específicas del pentagrama o están unidos a otros objetos
1649 posicionados de esta forma. Las colisiones entre cabezas, plicas y
1650 alteraciones en acordes de notas muy juntas, normalmente se evitan
1651 automáticamente. Hay instrucciones y sobreescrituras que pueden
1652 modificar este comportamiento automático, como veremos en breve.
1654 Entre los objetos que pertenecen al exterior de la pauta se encuentran
1655 cosas como las marcas de ensayo, las marcas de texto y las de
1656 dinámica. La regla de LilyPond para la colocación vertical de los
1657 objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
1658 como sea posible, pero no tan cerca como para que puedan chocar con
1659 algún otro objeto. LilyPond utiliza la propiedad
1660 @code{outside-staff-priority} para determinar el orden en que se deben
1661 situar los objetos, como veremos ahora.
1663 En primer lugar, LilyPond sitúa todos los objetos
1664 dentro-del-pentagrama. Después ordena los objetos
1665 fuera-del-pentagrama de acuerdo con su prioridad
1666 @code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
1667 toman de uno en uno, comenzando por el que tiene la prioridad
1668 @code{outside-staff-priority} más baja, y se sitúan de forma que no
1669 colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
1670 grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
1671 la prioridad @code{outside-staff-priority} más baja se colocará más
1672 cerca del pentagrama. Si dos objetos tienen la misma
1673 @code{outside-staff-priority}, el que se ha encontrado primero se
1674 situará más cerca de la pauta.
1676 En el siguiente ejemplo, todos los textos de marcado tienen la misma
1677 prioridad (pues no se ha establecido explícitamente). Observe que
1678 @q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
1679 acomodado por debajo de @q{Text2}.
1681 @cindex markup, ejemplo
1683 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1690 Los pentagramas también se posicionan, de forma predeterminada, tan
1691 cerca unos de otros como sea posible (sujeto a una separación mínima).
1692 Si las notas se proyectan muy lejos en dirección a un pentagrama
1693 adyacente, forzarán a alejarse a los pentagramas sólo si en caso
1694 contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
1695 siguiente muestra esta acomodación @q{nestling} de las notas sobre
1696 pentagramas adyacentes:
1698 @lilypond[quote,ragged-right,verbatim]
1701 \relative c' { c a, }
1704 \relative c'''' { c a, }
1710 @node Within-staff objects
1711 @subsection Within-staff objects
1713 Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la
1714 dirección de las ligaduras de expresión y de unión, digitaciones y
1715 todo lo demás que dependa de la dirección de las plicas. Cuando se
1716 escribe música polifónica, estas instrucciones son esenciales para que
1717 puedan distinguirse varias líneas melódicas entrelazadas. Pero
1718 ocasionalmente puede ser necesario sobreescribir este comportamiento
1719 automático. Se puede hacer por secciones de música completas o
1720 incluso para una nota individual. La propiedad que controla este
1721 comportamiento es la propiedad de @code{direction} (dirección) de cada
1722 objeto de presentación. En primer lugar explicaremos qué hace esto, y
1723 luego introduciremos algunas instrucciones listas para usar que le
1724 evitarán tener que codificar sobreescrituras explícitas para las
1725 modificaciones más comunes.
1727 Algunos objetos de presentación como las ligaduras se curvan hacia
1728 arriba o hacia abajo; otros como las plicas y los corchetes también se
1729 mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
1730 hacia abajo. Esto se controla automáticamente cuando está establecida
1731 la propiedad @code{direction}.
1742 El ejemplo siguiente muestra en el compás 1 el comportamiento
1743 predeterminado de las plicas, con las de las notas agudas apuntando
1744 hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
1745 todas las plicas forzadas hacia abajo, cuatro notas con las plicas
1746 forzadas hacia arriba, y por último cuatro notas devueltas al
1747 comportamiento predeterminado.
1749 @cindex Stem, ejemplo de sobreescritura
1750 @cindex direction, propiedad, ejemplo
1752 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1754 \override Stem #'direction = #DOWN
1756 \override Stem #'direction = #UP
1758 \revert Stem #'direction
1762 Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
1763 (arriba). Éstos tienen los valores @code{-1} y @code{+1}
1764 respectivamente, y dichos valores numéricos también se pueden usar
1765 directamente. El valor @code{0} también se puede usar en algunos
1766 casos. Se trata simplemente con el significado de @code{UP} para las
1767 plicas, pero para algunos objetos tiene el significado de
1768 @q{centrado}. Existe una constante @code{CENTER} que tiene el valor
1771 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
1772 están disponibles instrucciones predefinidas equivalentes más
1773 sencillas. Aquí podemos ver una tabla de las más comunes. Se
1774 menciona el significado de cada una allí donde no es obvio.
1776 @multitable @columnfractions .2 .2 .25 .35
1777 @headitem Abajo o Izquierda
1778 @tab Arriba o Derecha
1781 @item @code{\arpeggioArrowDown}
1782 @tab @code{\arpeggioArrowUp}
1783 @tab @code{\arpeggioNormal}
1784 @tab La flecha está abajo, arriba o no hay flecha
1785 @item @code{\dotsDown}
1787 @tab @code{\dotsNeutral}
1788 @tab Dirección del desplazamiento para evitar las líneas del pentagrama
1789 @item @code{\dynamicDown}
1790 @tab @code{\dynamicUp}
1791 @tab @code{\dynamicNeutral}
1793 @item @code{\phrasingSlurDown}
1794 @tab @code{\phrasingSlurUp}
1795 @tab @code{\phrasingSlurNeutral}
1796 @tab Nota: diferente de las instrucciones de ligaduras de expresión
1797 @item @code{\slurDown}
1799 @tab @code{\slurNeutral}
1801 @item @code{\stemDown}
1803 @tab @code{\stemNeutral}
1805 @item @code{\textSpannerDown}
1806 @tab @code{\textSpannerUp}
1807 @tab @code{\textSpannerNeutral}
1808 @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
1809 @item @code{\tieDown}
1811 @tab @code{\tieNeutral}
1813 @item @code{\tupletDown}
1814 @tab @code{\tupletUp}
1815 @tab @code{\tupletNeutral}
1816 @tab Los grupos especiales están debajo o encima de las notas
1819 Observe que estas instrucciones predefinidas @strong{no} pueden ir
1820 precedidas de @code{\once}. Si quiere limitar el efecto a una sola
1821 nota, deberá elegir entre usar la instrucción @code{\once \override}
1822 equivalente, o usar la instrucción predefinida, seguida después de la
1823 nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
1825 @subheading Fingering
1827 @cindex digitación, colocación
1828 @cindex digitación de acordes
1830 La colocación de las digitaciones sobre notas sueltas también se puede
1831 controlar mediante la propiedad @code{direction}, pero los cambios
1832 sobre @code{direction} no tienen ningún efecto sobre las notas de los
1833 acordes. Como veremos, existen instrucciones especiales que permiten
1834 controlar las digitaciones de notas individuales, situando la
1835 digitación encima, debajo, a la izquierda o a la derecha de cada nota.
1837 En primer lugar, he aquí el efecto de @code{direction} sobre las
1838 digitaciones aplicadas a notas sueltas. Se muestra en el primer
1839 compás el comportamiento predeterminado, y en los dos compases
1840 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
1842 @cindex Fingering, ejemplo de sobreescritura
1843 @cindex direction, propiedad, ejemplo
1845 @lilypond[quote,verbatim,relative=2]
1847 \override Fingering #'direction = #DOWN
1849 \override Fingering #'direction = #UP
1853 Sin embargo, la sobreescritura de la propiedad @code{direction} no es
1854 la forma más sencilla de especificar manualmente la digitación por
1855 encima o por debajo de las notas; suele ser preferible usar @code{_} o
1856 @code{^} en lugar de @code{-}, antes del número de la digitación.
1857 Este es el ejemplo anterior utilizando este método:
1859 @cindex fingering, ejemplo
1860 @cindex digitación, ejemplo
1862 @lilypond[quote,verbatim,relative=2]
1868 La propiedad @code{direction} se ignora para los acordes, pero los
1869 prefijos direccionales @code{_} y @code{^} sí funcionan. De forma
1870 predeterminada, las digitaciones se colocan automáticamente encima y
1871 debajo de las notas de un acorde, como se muestra aquí:
1873 @cindex fingering, ejemplo
1874 @cindex digitación, ejemplo
1876 @lilypond[quote,verbatim,relative=2]
1883 pero se puede forzar de manera que todos o algunos de los números de
1884 digitación estén por encima o por debajo:
1886 @cindex fingering, ejemplo
1887 @cindex digitación, ejemplo
1889 @lilypond[quote,verbatim,relative=2]
1895 Es posible ejercer un control aún mayor sobre la colocación de las
1896 digitaciones mediante la utilización de la instrucción @code{\set
1897 fingeringOrientations}. El formato de esta instrucción es:
1900 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
1904 se utiliza @code{\set} porque @code{fingeringOrientations} es una
1905 propiedad del contexto @code{Voice}, creado y usado por el grabador
1906 @code{New_fingering_engraver}.
1908 La propiedad se puede establecer al valor de una lista de entre uno y
1909 tres valores. Controla si las digitaciones se pueden colocar por
1910 encima (si @code{up} aparece en la lista), por debajo (si aparece
1911 @code{down}), a la izquierda (si aparece @code{left}) o a la derecha
1912 (si aparece @code{right}). A la inversa, si una colocación no está en
1913 la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
1914 coma estas restricciones y se trabaja la mejor colocación para la
1915 digitación de las notas de los acordes que siguen. Observe que
1916 @code{left} y @code{right} son mutuamente excluyentes: las
1917 digitaciones pueden situarse en un lado o en el otro, no en los dos.
1919 @warning{Para controlar la colocación de la digitación de una sola
1920 nota usando esta instrucción es necesario escribirla como un acorde de
1921 una sola nota encerrándola entre ángulos simples.}
1923 Aquí podemos ver algunos ejemplos:
1925 @cindex fingering, ejemplo
1926 @cindex digitación, ejemplo
1927 @cindex @code{\set}, ejemplo de utilización
1928 @cindex fingeringOrientations, propiedad, ejemplo
1930 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1931 \set fingeringOrientations = #'(left)
1933 < c-1 e-2 g-3 b-5 > 4
1934 \set fingeringOrientations = #'(left)
1936 < c-1 e-2 g-3 b-5 > 4
1937 \set fingeringOrientations = #'(up left down)
1939 < c-1 e-2 g-3 b-5 > 4
1940 \set fingeringOrientations = #'(up left)
1942 < c-1 e-2 g-3 b-5 > 4
1943 \set fingeringOrientations = #'(right)
1945 < c-1 e-2 g-3 b-5 > 4
1949 Si la digitación parece un poco superpoblada, se puede reducir el
1950 tamaño @code{font-size}. El valor predeterminado puede verse en el
1951 objeto @code{Fingering} del RFI que es @code{-5}, así que probaremos
1954 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1955 \override Fingering #'font-size = #-7
1956 \set fingeringOrientations = #'(left)
1958 < c-1 e-2 g-3 b-5 > 4
1959 \set fingeringOrientations = #'(left)
1961 < c-1 e-2 g-3 b-5 > 4
1962 \set fingeringOrientations = #'(up left down)
1964 < c-1 e-2 g-3 b-5 > 4
1965 \set fingeringOrientations = #'(up left)
1967 < c-1 e-2 g-3 b-5 > 4
1968 \set fingeringOrientations = #'(right)
1970 < c-1 e-2 g-3 b-5 > 4
1974 @node Outside-staff objects
1975 @subsection Outside-staff objects
1977 Los objetos fuera-del-pentagrama se colocan automáticamente para
1978 evitar las colisiones. Los objetos que tienen el valor más bajo de la
1979 propiedad @code{outside-staff-priority} se sitúan más cerca del
1980 pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
1981 tanto como sea necesario para evitar la colisión. La prioridad
1982 @code{outside-staff-priority} se defina en el @code{grob-interface} y
1983 así es una propiedad de todos los objetos de presentación. De forma
1984 predeterminada se establece a @code{#f} para todos los objetos
1985 dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
1986 fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
1987 presenta los valores numéricos predeterminados para algunos de los
1988 objetos fuera-del-pentagrama que están inicialmente dentro de los
1989 contextos @code{Staff} o @code{Voice}.
1991 @multitable @columnfractions .3 .3 .3
1992 @headitem Objeto de presentación
1994 @tab Controla la posición de:
1995 @item @code{MultiMeasureRestText}
1997 @tab Texto sobre silencios de compás completo
1998 @item @code{TextScript}
2000 @tab Elementos de marcado de texto
2001 @item @code{OttavaBracket}
2003 @tab Corchetes de octava alta y baja
2004 @item @code{TextSpanner}
2006 @tab Objetos de extensión de texto
2007 @item @code{DynamicLineSpanner}
2009 @tab Todas las indicaciones dinámicas
2010 @item @code{VoltaBracketSpanner}
2012 @tab Corchetes de primera y segunda vez
2013 @item @code{TrillSpanner}
2015 @tab Trinos mantenidos
2018 He aquí un ejemplo que muestra la situación predeterminada de algunos
2021 @cindex texto, extensiones de
2022 @cindex octava alta y baja, corchete de
2024 @funindex \startTextSpan
2025 @funindex startTextSpan
2026 @funindex \stopTextSpan
2027 @funindex stopTextSpan
2029 @cindex TextSpanner, ejemplo de sobreescritura
2030 @cindex bound-details, propiedad, ejemplo
2032 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2033 % Set details for later Text Spanner
2034 \override TextSpanner #'(bound-details left text)
2035 = \markup { \small \bold Slower }
2036 % Place dynamics above staff
2038 % Start Ottava Bracket
2043 % Add Dynamic Line Spanner
2049 c\ff c \stopTextSpan
2050 % Stop Ottava Bracket
2055 Este ejemplo también muestra cómo crear textos con extensión (Text
2056 Spanners): textos con líneas extensoras por encima de una sección de
2057 música. El extensor abarca desde la instrucción @code{\startTextSpan}
2058 hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
2059 define por medio de la instrucción @code{\override TextSpanner}. Para
2060 ver más detalles, consulte @ruser{Text spanners}.
2062 También muestra la manera de crear corchetes de octava alta y baja.
2064 @cindex trucar la situación de los números de compás
2065 @cindex números de compás, ajustar posición
2066 @cindex trucar la situación de marcas metronómicas
2067 @cindex metrónomo, situación de las indicaciones de
2068 @cindex trucar la situación de las letras de ensayo
2069 @cindex ensayo, letras, trucar la colocación
2071 Observe que los números de compás, las indicaciones metronómicas y las
2072 mercas de ensayo no se muestran. De forma predeterminada, se crean
2073 dentro del contexto @code{Score} y su prioridad
2074 @code{outside-staff-priority} se ignora con relación a los objetos de
2075 presentación que se crean dentro del contexto @code{Staff}. Si quiere
2076 colocar los números de compás, indicaciones metronómicas o llamadas de
2077 ensayo en concordancia con el valor de su
2078 @code{outside-staff-priority}, los grabadores
2079 @code{Bar_number_engraver}, @code{Metronome_mark_engraver} o
2080 @code{Mark_engraver} respectivamente se deben eliminar del contexto
2081 @code{Score} y colocarlos en el contexto @code{Staff} del nivel
2082 superior. Si se hace así, estas marcas obtendrán los siguientes
2083 valores predeterminados de @code{outside-staff-priority}:
2085 @multitable @columnfractions .3 .3
2086 @headitem Objeto de presentación @tab Prioridad
2087 @item @code{RehearsalMark} @tab @code{1500}
2088 @item @code{MetronomeMark} @tab @code{1000}
2089 @item @code{BarNumber} @tab @code{ 100}
2092 Si los valores predeterminados de @code{outside-staff-priority} no le
2093 ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
2094 de cualquiera de los objetos. Suponga que quisiéramos que el corchete
2095 de octava estuviera situado por debajo del elemento extensor de texto
2096 en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
2097 prioridad de @code{OttavaBracket} en el RFI o en las tablas
2098 anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
2099 recordando que @code{OttavaBracket} se crea dentro del contexto de
2102 @cindex TextSpanner, ejemplo de sobreescritura
2103 @cindex bound-details, propiedad, ejemplo
2105 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2106 % Set details for later Text Spanner
2107 \override TextSpanner #'(bound-details left text)
2108 = \markup { \small \bold Slower }
2109 % Place dynamics above staff
2111 %Place following Ottava Bracket below Text Spanners
2112 \once \override Staff.OttavaBracket #'outside-staff-priority = #340
2113 % Start Ottava Bracket
2118 % Add Dynamic Line Spanner
2124 c\ff c \stopTextSpan
2125 % Stop Ottava Bracket
2130 @cindex ligaduras y outside-staff-priority
2131 @cindex ligaduras y articulaciones
2132 @cindex articulaciones y ligaduras
2134 De forma predeterminada, las ligaduras de expresión están clasificadas
2135 como objetos dentro-del-pentagrama, pero con frecuencia aparecen
2136 encima del pentagrama si las notas que une son muy agudas. Ello puede
2137 empujar a una posición muy elevada a los objetos fuera-del-pentagrama
2138 como las articulaciones, pues la ligadura se colocará en primer lugar.
2139 La propiedad @code{avoid-slur} de la articulación se puede establecer
2140 al valor @code{'inside} (por dentro) para llevarla al interior de la
2141 ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si
2142 la prioridad @code{outside-staff-priority} está también ajustada al
2143 valor @code{#f}. De forma alternativa, la prioridad
2144 @code{outside-staff-priority} de la ligadura se puede fijar en un
2145 valor numérico para hacer que se sitúe en línea con otros objetos
2146 fuera del pentagrama de acuerdo con este valor. He aquí un ejemplo
2147 que muestra el efecto de los dos métodos:
2149 @lilypond[quote,verbatim,relative=2]
2150 c4( c^\markup\tiny\sharp d4.) c8
2152 \once \override TextScript #'avoid-slur = #'inside
2153 \once \override TextScript #'outside-staff-priority = ##f
2154 c^\markup\tiny\sharp d4.) c8
2155 \once \override Slur #'outside-staff-priority = #500
2156 c4( c^\markup\tiny\sharp d4.) c8
2159 Los cambios en @code{outside-staff-priority} también se pueden emplear
2160 para controlar la situación vertical de los objetos individuales,
2161 aunque los resultados pueden no siempre ser deseables. Suponga que
2162 quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
2163 bajo el epígrafe Comportamiento Automático de más arriba (véase
2164 @ref{Automatic behaviour}). Todo lo que debemos hacer es localizar la
2165 prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
2166 aumentar la prioridad de @qq{Text3} hasta un valor superior:
2168 @cindex TextScript, ejemplo de sobreescritura
2169 @cindex outside-staff-priority, propiedad, ejemplo
2171 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2174 \once \override TextScript #'outside-staff-priority = #500
2179 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
2180 también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
2181 desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
2182 realmente queremos hacer es posicionar todas las anotaciones a la
2183 misma distancia por encima del pentagrama? Para hacerlo, vamos a
2184 necesitar claramente espaciar las notas en sentido horizontal para
2185 hacer sitio para el texto. Esto se hace empleando la instrucción
2186 @code{textLengthOn}.
2188 @subheading \textLengthOn
2190 @cindex notas, espaciar junto al texto
2192 @funindex \textLengthOn
2193 @funindex textLengthOn
2194 @funindex \textLengthOff
2195 @funindex textLengthOff
2197 De forma predeterminada, el texto producido mediante marcado no ocupa
2198 ningún espacio horizontal en cuanto se refiere a la disposición de la
2199 música. La instrucción @code{\textLengthOn} invierte este
2200 comportamiento, ocasionando que las notas resulten tan espaciadas como
2201 sea necesario para acomodar el texto:
2203 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2204 \textLengthOn % Cause notes to space out to accommodate text
2211 La instrucción para volver al comportamiento predeterminado es
2212 @code{\textLengthOff}. Recuerde que @code{\once} funciona solamente
2213 con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
2214 que no se puede usar con @code{\textLengthOn}.
2216 @cindex marcado, texto de, permitir las colisiones en
2218 El texto de marcado también evita las notas que se proyectan por
2219 encima del pentagrama. Si esto no es lo que deseamos, el
2220 desplazamiento automático hacia arriba se puede desactivar mediante el
2221 establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
2222 muestra cómo el texto de marcado interactúa con tales notas.
2224 @cindex TextScript, ejemplo de sobreescritura
2225 @cindex outside-staff-priority, propiedad, ejemplo
2227 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2228 % This markup is short enough to fit without collision
2232 % This is too long to fit, so it is displaced upwards
2236 % Turn off collision avoidance
2237 \once \override TextScript #'outside-staff-priority = ##f
2241 % Turn off collision avoidance
2242 \once \override TextScript #'outside-staff-priority = ##f
2243 \textLengthOn % and turn on textLengthOn
2244 c,,2^"Long Text " % Spaces at end are honored
2249 @subheading Dynamics
2251 @cindex trucar la colocación de los matices
2252 @cindex dinámica, trucar la colocación de las indicaciones de
2253 @cindex matices, trucar la colocación
2255 Las indicaciones de matiz dinámico normalmente se colocarán por debajo
2256 del pentagrama, pero se pueden posicionar por encima con la
2257 instrucción @code{dynamicUp}. Se situarán verticalmente respecto a la
2258 nota a la que van adosadas, y flotarán por debajo (o por encima) de
2259 todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
2260 y números de compás. Esto puede ofrecer resultados bastante
2261 aceptables, como muestra este ejemplo:
2263 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2268 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2269 ees,2.~\)\mf ees4 r8 |
2272 Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
2273 muy cerca, la colocación automática evitará las colisiones desplazando
2274 las marcas dinámicas posteriores más lejos, aunque este puede no ser
2275 el lugar óptimo, como muestra el siguiente ejemplo más bien
2278 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2284 Si se presentara una situación similar en música @q{real}, podría ser
2285 preferible espaciar las notas un poco más entre sí, de forma que todas
2286 las marcas dinámicas puedan caber a la misma distancia vertical desde
2287 el pentagrama. Hemos sido capaces de hacer esto para el texto de
2288 marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
2289 una instrucción equivalente para las indicaciones de matiz dinámico.
2290 Por tanto, tendremos que averiguar cómo hacerlo utilizando
2291 instrucciones @code{\override}.
2293 @subheading Grob sizing
2295 @cindex grob, cambio de tamaño de un
2296 @cindex escala de los grobs
2298 En primer lugar debemos aprender cómo se especifica el tamaño de los
2299 grobs. Todos los grobs tienen un punto de referencia definido dentro
2300 de ellos que se usa para colocarlos respecto a su objeto padre.
2301 Entonces, este punto del grob se posiciona a una distancia horizontal,
2302 @code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
2303 de su padre. La dimensión horizontal del objeto viene dada por una
2304 pareja de números, @code{X-extent}, que dice dónde están los límites
2305 izquierdo y derecho respecto del punto de referencia. La amplitud
2306 vertical se define de forma similar mediante una pareja de números,
2307 @code{Y-extent}. Éstas son propiedades de todos los grobs que
2308 contemplan el @code{grob-interface}.
2310 @cindex @code{extra-spacing-width}
2312 De forma predeterminada, los objetos fuera-del-pentagrama reciben una
2313 anchura cero, de manera que pueden solaparse en la dirección
2314 horizontal. Esto se hace mediante el truco de añadir una cantidad
2315 infinita a la dimensión más a la izquierda y menos infinito a la
2316 dimensión más a la derecha estableciendo el valor de
2317 @code{extra-spacing-width} a @code{'(+inf.0 . -inf.0)}. Así, para
2318 asegurar que no se superponen en la dirección horizontal tendremos que
2319 sobreescribir este valor de @code{extra-spacing-width} a @code{'(0
2320 . 0)} de forma que el verdadero ancho se presente. Esta es la
2321 instrucción que lo hace para las indicaciones dinámicas:
2324 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2328 Veamos si funciona en nuestro ejemplo anterior:
2330 @cindex DynamicText, ejemplo de sobreescritura
2331 @cindex extra-spacing-width, propiedad, ejemplo
2333 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2335 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2340 Bueno, ciertamente ha hecho que las marcas dinámicas ya no estén
2341 desplazadas, pero aún quedan dos problemas. Las marcas tendrían que
2342 separarse un poco más entre sí, y sería mejor si todas estuvieran a la
2343 misma distancia del pentagrama. Podemos resolver el primer problema
2344 fácilmente. En vez de hacer cero la anchura
2345 @code{extra-spacing-width}, podemos añadirle algo más. Las unidades
2346 son el espacio entre dos líneas de pentagrama, así que al mover el
2347 límite izquierdo media unidad a la izquierda y el límite derecho media
2348 unidad hacia la derecha, deberíamos conseguirlo:
2350 @cindex DynamicText, ejemplo de sobreescritura
2351 @cindex extra-spacing-width, propiedad, ejemplo
2353 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2355 % Extend width by 1 staff space
2356 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2361 Esto tiene un mejor aspecto, pero quizá habríamos preferido que las
2362 indicaciones de dinámica estuvieran alineadas sobre la misma línea de
2363 base en lugar de ir hacia arriba y hacia abajo con las notas. La
2364 propiedad que lo hace es @code{staff-padding} (relleno de pentagrama)
2365 que se estudia en la sección siguiente.
2368 @node Collisions of objects
2369 @section Collisions of objects
2373 * Fixing overlapping notation::
2374 * Real music example::
2377 @node Moving objects
2378 @subsection Moving objects
2380 @cindex mover objetos superpuestos
2381 @cindex mover objetos que colisionan
2382 @cindex mover grobs que colisionan
2383 @cindex objetos que colisionan, mover
2384 @cindex grobs que colisionan, mover
2386 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
2387 de notación se pueden superponer, lo que es una lástima, pero en
2388 realidad es bastante poco frecuente. Normalmente la necesidad de
2389 mover objetos es por claridad o razones estéticas: el aspecto es mejor
2390 con un poco más o un poco menos de espacio de separación.
2392 Existen tres enfoques principales que llevan a la resolución de
2393 superposiciones en la notación. Se deben considerar en el siguiente
2398 La @strong{dirección} de uno de los objetos que se superponen se puede
2399 cambiar usando las instrucciones predefinidas que están relacionadas
2400 arriba para los objetos dentro-del-pentagrama (véase @ref{Within-staff
2401 objects}). Se pueden recolocar fácilmente las plicas, ligaduras de
2402 expresión y de unión, barras de corchea, indicaciones dinámicas, texto
2403 y grupos de valoración especial de esta forma. La limitación es que
2404 sólo tiene la posibilidad de elegir entre dos posiciones, y podría ser
2405 que ninguna de ellas sea la adecuada.
2408 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2409 colocando los objetos de presentación, se pueden modificar usando la
2410 instrucción de sobreescritura @code{\override}. Las ventadas de hacer
2411 cambios a este tipo de propiedad son: a) que algún otro objeto se
2412 moverá automáticamente si es necesario, para dejarle sitio, y b) una
2413 única sobreescritura se puede aplicar a todas las instancias del mismo
2414 tipo de objeto. Entre tales propiedades se encuentran:
2419 @code{direction} (dirección)
2421 Ya se ha estudiado con cierto detalle: véase @ref{Within-staff
2425 @code{padding} (relleno), @code{left-padding} (relleno por la
2426 izquierda), @code{right-padding} (relleno por la derecha),
2427 @code{staff-padding} (relleno de pentagrama)
2430 @cindex left-padding, propiedad
2431 @cindex padding, propiedad
2432 @cindex right-padding, propiedad
2433 @cindex staff-padding, propiedad
2435 Según un objeto se está colocando, el valor de su propiedad de relleno
2436 @code{padding} especifica el espacio intermedio que se debe dejar
2437 entre él mismo y el límite más próximo del objeto contra el que se
2438 está colocando. Observe que es el valor de @code{padding} del objeto
2439 @strong{que se está colocando} el que se usa; el valor de
2440 @code{padding} del objeto que ya está colocado se ignora. Los
2441 espacios intermedios especificados mediante @code{padding} se pueden
2442 aplicar a todos los objetos que contemplan el interface
2443 @code{side-position-interface}.
2445 En lugar de con @code{padding}, la colocación de los grupos de
2446 alteraciones se controla con @code{left-padding} y
2447 @code{right-padding}. Estas propiedades se encontrarán en el objeto
2448 @code{AccidentalPlacement} que, observe, vive dentro del contexto de
2449 @strong{staff}. Durante el proceso tipográfico, las cabezas de las
2450 notas se componen tipográficamente en primer lugar, y después las
2451 alteraciones, si existen, se añaden a la izquierda de las cabezas
2452 utilizando la propiedad de relleno por la derecha @code{right-padding}
2453 para determinar la separación entre la alteración y la cabeza. así
2454 pues, sólo la propiedad de relleno por la derecha @code{right-padding}
2455 del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
2456 de las alteraciones.
2458 La propiedad @code{staff-padding} está estrechamente relacionada con
2459 la propiedad @code{padding}: @code{padding} controla la separación
2460 mínima entre cualquier objeto que contemple el interface
2461 @code{side-position-interface} y el objeto más cercano (generalmente
2462 la nota o las líneas del pentagrama); @code{staff-padding} se aplica
2463 sólo a los objetos que siempre se sitúan fuera del pentagrama:
2464 controla la separación mínima entre dicho objeto y el pentagrama.
2465 Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
2466 que se posicionan respecto a la nota en vez de hacerlo respecto al
2467 pentagrama, incluso aunque puede ser sobreescrito sin error por tales
2468 objetos: simplemente se ignora.
2470 Para descubrir qué propiedad de relleno se necesita para el objeto que
2471 quiere recolocar, debe volver al manual de RFI y buscar las
2472 propiedades del objeto. Tenga cuidado porque las propiedades de
2473 relleno podrían no estar en el objeto más obvio, así que busque en los
2474 objetos que puedan tener alguna relación con él.
2476 Todos los valores de relleno se miden en espacios del pentagrama.
2477 Para la mayor parte de los objetos el valor se establece de forma
2478 predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
2479 Se puede sobreescribir si se necesita una separación intermedia mayor
2483 @code{self-alignment-X} (Auto-alineamiento en el eje X)
2485 @cindex self-alignment-X, propiedad
2487 Esta propiedad se puede usar para alinear el objeto a la izquierda, a
2488 la derecha, o centrarlo con respecto al punto de referencia del objeto
2489 «padre». Se puede usar con todos los objetos que contemplan el
2491 @code{self-alignment-interface}. En general son objetos que contienen
2492 texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
2493 forma alternativa se puede especificar un valor numérico entre
2494 @code{-1} y @code{+1}, donde @code{-1} es alineado por la izquierda,
2495 @code{+1} es alineado por la derecha, y los números intermedios mueven
2496 el texto progresivamente desde alineado por la izquierda hasta alineado
2497 por la derecha. Se pueden especificar valores numéricos mayores de
2498 @code{1} para mover el texto incluso más lejos hacia la izquierda, o
2499 menos de @code{-1} para alejarlo más hacia la derecha. Un cambio en
2500 @code{1} en el valor corresponde a un movimiento de la mitad de la
2501 longitud total del propio texto.
2504 @code{extra-spacing-width} (anchura de separación adicional)
2506 @cindex extra-spacing-width, propiedad
2508 Esta propiedad está disponible para todos los objetos que contemplan
2509 el interface @code{item-interface}. Toma dos números, el primero se
2510 suma al límite izquierdo y el segundo se suma al límite derecho. Los
2511 números negativos desplazan el límite a la izquierda y los positivos a
2512 la derecha, por lo que para ensanchar un objeto el primer número debe
2513 ser negativo y el segundo positivo. Observe que no todos los objetos
2514 ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
2515 (alteración) sólo toma nota del primer número (el borde izquierdo).
2518 @code{staff-position} (posición de pentagrama)
2520 @cindex staff-position, propiedad
2522 @code{staff-position} es una propiedad del interface
2523 @code{staff-symbol-referencer-interface}, que está contemplado por los
2524 objetos que se colocan con relación al pentagrama. Especifica la
2525 posición vertical del objeto con relación a la tercera línea del
2526 pentagrama en medios espacios de pentagrama. Es útil en la
2527 resolución de colisiones entre objetos de presentación como silencios
2528 multi-compás, ligaduras de unión y notas en distintas voces.
2531 @code{force-hshift} (forzar desplazamiento horizontal)
2533 @cindex force-hshift, propiedad
2535 Las notas muy juntas de un acorde, o aquellas que ocurren al mismo
2536 tiempo en voces distintas, se disponen en dos (y ocasionalmente más)
2537 columnas para evitar la superposición de las cabezas. Éstas reciben
2538 el nombre de columnas de notas, y se crea un objeto llamado
2539 @code{NoteColumn} para disponer las notas en dicha columna.
2541 La propiedad @code{force-hshift} es una propiedad de una
2542 @code{NoteColumn} (realmente lo es del interface
2543 @code{note-column-interface}). Modificarlo permite mover una columna
2544 de notas en unidades adecuadas a una columna de notas, por ejemplo la
2545 anchura de la cabeza de la nota de la primera voz. Se debe usar en
2546 situaciones complejas donde las instrucciones @code{\shiftOn} normales
2547 (véase @ref{Explicitly instantiating voices}) no resuelven el
2548 conflicto entre las notas. Es preferible a la propiedad
2549 @code{extra-offset} para este propósito porque no hay necesidad de
2550 averiguar la distancia en espacios de pentagrama, y mover las notas
2551 dentro o fuera de una @code{NoteColumn} afecta a otras acciones como a
2552 la fusión entre cabezas de nota.
2557 Finalmente, cuando todo lo demás falla, los objetos se pueden
2558 reposicionar manualmente con relación a la tercera línea del
2559 pentagrama verticalmente, o desplazándolas una cierta distancia a una
2560 nueva posición. Las desventajas son que los valores correctos para el
2561 reposicionamiento se deben adivinar, a menudo por ensayo y error, para
2562 cada objeto individual y, puesto que el movimiento se hace después de
2563 que LilyPond ha colocado todos los demás objetos es usuario es
2564 responsable de evitar cualquier colisión que pudiera producirse. Pero
2565 la dificultar principal con este enfoque es que los valores de
2566 reposicionado podrían tener que ser vueltos a calcular si la música se
2567 modifica más tarde. Las propiedades que se pueden usar para este tipo
2568 de posicionamiento manual son:
2571 @item extra-offset (desplazamiento adicional)
2573 @cindex extra-offset, propiedad
2575 Esta propiedad se aplica a cualquier objeto de presentación que
2576 contemple el @code{grob-interface}. Toma una pareja de números que
2577 especifican el desplazamiento adicional en las direcciones horizontal
2578 y vertical. Los números negativos mueven el objeto a la izquierda o
2579 hacia abajo. Las unidades son espacios de pentagrama. El
2580 desplazamiento adicional se hace después de que la composición
2581 tipográfica de los objetos ha terminado, así que un objeto puede ser
2582 reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
2584 @item positions (posiciones)
2586 @cindex positions, propiedad
2588 Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
2589 la altura de las barras de corchea, ligaduras de expresión y corchetes
2590 de grupos de valoración especial. Toma una pareja de números que dan
2591 la posición de los extremos izquierdo y derecho de la barra, ligadura,
2592 etc. con relación a la tercera línea del pentagrama. Las unidades son
2593 espacios de pentagrama. Observe, sin embargo, que las ligaduras de
2594 expresión y de fraseo no se pueden reposicionar en cantidades
2595 arbitrariamente grandes. LilyPond en primer lugar genera una lista de
2596 posiciones posibles para la ligadura y de forma predeterminada
2597 encuentra la ligadura que tiene @qq{mejor aspecto}. Si la propiedad
2598 @code{positions} se ha sobreescrito, la ligadura que está más cerca de
2599 las posiciones que se han solicitado, se selecciona de la lista.
2604 Un objeto en particular podría no tener todas estas propiedades. Es
2605 necesario ir al manual RFI para buscar qué propiedades se encuentran
2606 disponibles para el objeto en cuestión.
2609 Aquí presentamos una lista de los objetos que es más probable que
2610 estén implicados en colisiones, con el nombre del objeto que habría
2611 que buscar en el RFI para descubrir qué propiedades se deben usar para
2614 @multitable @columnfractions .5 .5
2615 @headitem Tipo de objeto @tab Nombre del objeto
2616 @item Articulaciones @tab @code{Script}
2617 @item Barras @tab @code{Beam}
2618 @item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
2619 @item Dinámica (horizontalmente) @tab @code{DynamicText}
2620 @item Digitaciones @tab @code{Fingering}
2621 @item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
2622 @item Ligaduras de expresión @tab @code{Slur}
2623 @item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
2624 @item Ligaduras de unión @tab @code{Tie}
2625 @item Grupos de valoración especial @tab @code{TupletBracket}
2629 @node Fixing overlapping notation
2630 @subsection Fixing overlapping notation
2632 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
2633 en la sección anterior, para resolver problemas de notación que se
2636 @subheading padding property
2639 @cindex arreglar notación que se superpone
2640 @cindex superpuesta, notación
2642 La propiedad @code{padding} se puede ajustar para aumentar (o
2643 disminuir) la distancia entre símbolos impresos encima o debajo de las
2646 @cindex Script, ejemplo de sobreescritura
2647 @cindex padding, propiedad, ejemplo
2649 @lilypond[quote,fragment,relative=1,verbatim]
2651 \override Script #'padding = #3
2655 @cindex MetronomeMark, ejemplo de sobreescritura
2656 @cindex padding, propiedad, ejemplo
2658 @lilypond[quote,fragment,relative=1,verbatim]
2659 % This will not work, see below:
2660 \override MetronomeMark #'padding = #3
2664 \override Score.MetronomeMark #'padding = #3
2669 Observe en el segundo ejemplo la gran importancia que tiene saber qué
2670 contexto maneja un determinado objeto. Puesto que el objeto
2671 @code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
2672 cambios de propiedades en el contexto @code{Voice} pasarán
2673 inadvertidos. Para ver más detalles, consulte @ruser{Modifying
2676 Si la propiedad de relleno @code{padding} de un objeto se incrementa
2677 cuando dicho objeto se encuentra en una pila de objetos que se están
2678 colocando de acuerdo a su prioridad @code{outside-staff-priority},
2679 entonces ese objeto se moverá, y también todos los que están por fuera
2683 @subheading left-padding and right-padding
2685 @cindex left-padding, propiedad
2686 @cindex right-padding, propiedad
2688 La propiedad @code{right-padding} afecta al espaciado entre la
2689 alteración y la nota a que se aplica. Normalmente no es necesaria,
2690 pero el ejemplo siguiente muestra una situación en la que sí se
2691 necesita. Suponga que queremos presentar un acorde que contiene un Si
2692 natural y un Si bemol. Para evitar la ambigüedad querríamos preceder
2693 las notas con un becuadro y un bemol. Aquí vienen varios intentos de
2696 @cindex Accidental, ejemplo de sobreescritura
2697 @cindex text, propiedad, ejemplo
2698 @cindex stencil, propiedad, ejemplo
2699 @cindex AccidentalPlacement, ejemplo de sobreescritura
2700 @cindex right-padding, propiedad, ejemplo
2702 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2708 Ninguno de ellos funciona y el segundo además presenta una fea
2709 colisión entre las dos alteraciones.
2711 Una forma de conseguirlo es sobreescribir el sello de la alteración
2712 con un elemento de marcado que contenga los símbolos de becuadro y
2713 bemol en el orden que nos gustaría que estuvieran, así:
2715 @lilypond[quote,ragged-right,verbatim]
2716 naturalplusflat = \markup { \natural \flat }
2718 \once \override Accidental
2719 #'stencil = #ly:text-interface::print
2720 \once \override Accidental #'text = #naturalplusflat
2721 \once \override Score.AccidentalPlacement #'right-padding = #1.5
2727 Esto utiliza necesariamente una sobreescritura para el sello de la
2728 alteración que no se estudiará hasta más adelante. El tipo de sello
2729 debe ser un procedimiento, aquí modificado para que imprima el
2730 contenido de la propiedad @code{text} del objeto @code{Accidental},
2731 que a su vez está establecido como un signo de becuadro seguido de un
2732 bemol. Entonces el conjunto se puede separar de la cabeza de la nota
2733 sobreescribiendo @code{right-padding}.
2737 @subheading staff-padding property
2739 @cindex alineación de objetos sobre la línea base
2740 @cindex objetos, alineación sobre la línea base
2742 @code{staff-padding} se puede usar para alinear objetos como matices
2743 dinámicos a lo largo de una línea de base a una altura fija sobre el
2744 pentagrama, en lugar de hacerlo a una altura que dependa de la
2745 posición de la nota a la que están adosados. No es una propiedad de
2746 @code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
2747 porque la línea de base debe aplicarse por igual a @strong{todas} las
2748 dinámicas, entre ellas las que se han creado como objetos de
2749 extensión. Así que ésta es la forma de alinear las indicaciones de
2750 matiz en el ejemplo de la sección anterior:
2752 @cindex DynamicText, ejemplo de sobreescritura
2753 @cindex extra-spacing-width, propiedad, ejemplo
2754 @cindex DynamicLineSpanner, ejemplo de sobreescritura
2755 @cindex staff-padding, propiedad, ejemplo
2757 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2759 % Extend width by 1 unit
2760 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2761 % Align dynamics to a base line 2 units above staff
2762 \override DynamicLineSpanner #'staff-padding = #2
2767 @subheading self-alignment-X property
2769 El ejemplo siguiente muestra cómo esto puede resolver la colisión
2770 entre un objeto de digitación de cuerda y la plica de una nota
2771 mediante el alineamiento del límite derecho con el punto de referencia
2774 @cindex StringNumber, ejemplo de sobreescritura
2775 @cindex self-alignment-X, propiedad, ejemplo
2777 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
2780 \once \override StringNumber #'self-alignment-X = #RIGHT
2784 @subheading staff-position property
2786 @cindex objeto, colisión dentro del pentagrama
2788 Los silencios multi-compás en una voz pueden chocar con las notas en
2789 otra voz. Puesto que estos silencios se tipografían centrados entre
2790 las barras de compás se necesitaría bastante esfuerzo para que
2791 LilyPond averiguara qué otras notas podrían chocar con él, ya que
2792 actualmente todo el manejo de colisiones entre notas y silencios se
2793 hace solamente para notas y silencios que ocurren al mismo tiempo. He
2794 aquí un ejemplo de colisión de este tipo:
2796 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2797 << {c c c c} \\ {R1} >>
2800 La mejor solución aquí es mover el silencio multi-compás hacia abajo,
2801 pues el silencio está en la voz dos. El ajuste predeterminado para
2802 @code{\voiceTwo} (es decir, en la segunda voz de una construcción
2803 @code{<<@{...@} \\ @{...@}>>}) es que @code{staff-position} tenga el
2804 valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
2805 cuatro semi-espacios de pentagrama, al valor @code{-8}.
2807 @cindex MultiMeasureRest, ejemplo de sobreescritura
2808 @cindex staff-position, propiedad, ejemplo
2810 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2814 \override MultiMeasureRest #'staff-position = #-8
2819 Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
2820 la línea adicional por encima del silencio se inserta automáticamente.
2822 @subheading extra-offset property
2824 @cindex posicionar objetos
2825 @cindex posicionar grobs
2826 @cindex objetos, posicionar
2827 @cindex grobs, posicionar
2829 La propiedad @code{extra-offset} da un completo control sobre el
2830 posicionamiento de un objeto tanto vertical como horizontalmente.
2832 En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
2833 a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
2835 @cindex Fingering, ejemplo de sobreescritura
2836 @cindex extra-offset, propiedad, ejemplo
2838 @lilypond[quote,fragment,relative=1,verbatim]
2841 \once \override Fingering
2842 #'extra-offset = #'(-0.3 . -1.8)
2847 @subheading positions property
2849 @cindex controlar manualmente grupos especiales, ligaduras y barras
2850 @cindex manual, control, de grupos especiales, ligaduras y barras
2851 @cindex grupos especiales, barras de, control manual
2852 @cindex ligaduras de expresión, control manual
2853 @cindex ligaduras de fraseo, control manual
2854 @cindex barras de corchea, control manual
2856 La propiedad @code{positions} permite controlar manualmente la
2857 posición e inclinación de los tresillos, ligaduras de expresión y de
2858 fraseo, y barras de corchea. He aquí un ejemplo que tiene una fea
2859 ligadura de fraseo debido a que intenta evitar la ligadura de
2860 expresión que está sobre la acciaccatura.
2862 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2863 r4 \acciaccatura e8\( d8 c ~c d c d\)
2867 Simplemente podemos mover la ligadura de fraseo por encima de las
2868 notas, y de hecho ésta será la solución preferida:
2870 @cindex PhrasingSlur, ejemplo de sobreescritura
2871 @cindex positions, propiedad, ejemplo
2873 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2876 \acciaccatura e8\( d8 c ~c d c d\)
2880 Pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
2881 sería mover el extremo izquierdo de la ligadura de fraseo un poco
2882 hacia abajo usando la propiedad @code{positions}. Esto también
2883 resuelve la forma algo indecente de la ligadura.
2885 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2887 \once \override PhrasingSlur #'positions = #'(-4 . -3)
2889 e8\( d8 c ~c d c d\)
2892 Presentamos un ejemplo más extraído del comienzo del pentagrama de la
2893 mano izquierda del preludio de Chopin Op 28 No. 2. vemos que la barra
2894 choca con las notas superiores:
2896 @lilypond[quote,verbatim,fragment,ragged-right]
2899 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2900 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2905 Esto se puede resolver manualmente elevando los dos extremos de la
2906 barra desde su posición a dos espacios de pentagrama sobre la línea
2907 central hasta, digamos, 3 espacios:
2909 @cindex Beam, ejemplo de sobreescritura
2910 @cindex positions, propiedad, ejemplo
2912 @lilypond[quote,verbatim,fragment,ragged-right]
2916 \override Beam #'positions = #'(3 . 3)
2921 << {b,8 ais, b, g,} \\ {e, g e, g} >>
2926 Observe que la sobreescritura sigue aplicándose en la primera voz del
2927 segundo bloque de corcheas, pero no a ninguna de las barras de la
2930 @subheading force-hshift property
2932 @c FIXME: formatting stuff (ie not important right now IMO)
2933 @c @a nchor Chopin finally corrected TODOgp
2935 Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
2936 Chopin que presentamos al final de @ref{I'm hearing Voices}, que
2937 dejamos con este aspecto:
2939 @lilypond[quote,verbatim,fragment,ragged-right]
2940 \new Staff \relative c'' {
2943 { c2 aes4. bes8 } \\
2955 Las dos notas inferiores del primer acorde (es decir, las que están en
2956 al tercera voz) no deberían separarse de la columna de notas de las dos
2957 notas agudas. Para corregir esto, establecemos el valor de
2958 @code{force-hshift} (que es una propiedad de @code{NoteColumn}) de
2959 esas notas a cero. La nota más grave del segundo acorde se sitúa
2960 mejor justo a la derecha de las más agudas. Lo conseguimos
2961 estableciendo el valor de @code{force-hshift} de esta nota a 0.5, o
2962 sea, la anchura de media cabeza de nota a la derecha de la columna de
2965 Presentamos a continuación el resultado final:
2967 @cindex NoteColumn, ejemplo de sobreescritura
2968 @cindex force-hshift, propiedad, ejemplo
2970 @lilypond[quote,verbatim,fragment,ragged-right]
2971 \new Staff \relative c'' {
2974 { c2 aes4. bes8 } \\
2977 \once \override NoteColumn #'force-hshift = #0 <ees c>2
2978 \once \override NoteColumn #'force-hshift = #0.5 des2
2986 @node Real music example
2987 @subsection Real music example
2989 Finalizaremos esta sección sobre los trucos mostrando los pasos que se
2990 deben tomar para tratar con un ejemplo complicado que necesita varios
2991 trucos para producir el resultado deseado. El ejemplo se ha escogido
2992 deliberadamente para ilustrar el uso de la Referencia de la Notación
2993 para resolver problemas de notación poco comunes. No es
2994 representativo de un proceso de grabado más usual, por lo que ¡le
2995 recomendamos que no deje que estas dificultades le desanimen!
2996 ¡Afortunadamente, las dificultades como éstas no son muy comunes!
2998 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
2999 compases 6 al 9, la transición entre el Lento inicial y el Moderato.
3000 Presentamos en primer lugar el aspecto que queremos que tenga el
3001 resultado, pero para evitar complicar demasiado el ejemplo hemos
3002 quitado las indicaciones dinámicas, las digitaciones y el pedal.
3004 @c The following should appear as music without code
3005 @lilypond[quote,ragged-right]
3006 rhMusic = \relative c'' {
3009 \once \override Tie #'staff-position = #3.5
3013 \mergeDifferentlyHeadedOn
3014 \mergeDifferentlyDottedOn
3015 bes2.^\markup {\bold "Moderato"} r8
3017 {c,8[ d fis bes a] | }
3019 % Reposition the c2 to the right of the merged note
3020 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3021 % Move the c2 out of the main note column so the merge will work
3024 % Stem on the d2 must be down to permit merging
3025 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3029 \mergeDifferentlyHeadedOff
3030 \mergeDifferentlyDottedOff
3034 lhMusic = \relative c' {
3036 <d g, d>1)\arpeggio |
3043 \new Staff = "RH" <<
3047 \new Staff = "LH" <<
3056 Observamos en primer lugar que la parte de la mano derecha del tercer
3057 compás requiere cuatro voces. Son las cinco corcheas unidas por una
3058 barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
3059 y el Fa sostenido negra con puntillo, que también está fundida con la
3060 corchea de su misma altura. Todo lo demás está en una sola voz, así
3061 que lo más fácil es introducir estas cuatro voces temporalmente en el
3062 momento en que se necesiten. Si ha olvidado cómo hacerlo, lea
3063 @ref{I'm hearing Voices}. Vamos a comenzar introduciendo las notas
3064 como dos variables y disponiendo la estructura de pentagramas en un
3065 bloque Score, y veremos qué produce LilyPond de forma predeterminada:
3067 @lilypond[quote,verbatim,ragged-right]
3068 rhMusic = \relative c'' {
3073 % Start polyphonic section of four voices
3075 {c,8 d fis bes a | }
3086 lhMusic = \relative c' {
3095 \new Staff = "RH" <<
3099 \new Staff = "LH" <<
3108 Todas las notas son correctas, pero el aspecto está lejos de ser
3109 satisfactorio. La ligadura de unión choca con el cambio de compás, el
3110 barrado del tercer compás es incorrecto, las notas no se funden
3111 correctamente, y faltan algunos elementos de notación. En primer
3112 lugar trataremos con lo más fácil. Podemos corregir el barrado de las
3113 corcheas insertando una barra manualmente, y podemos añadir fácilmente
3114 la ligadura de expresión de la mano izquierda y la ligadura de fraseo
3115 de la mano derecha, pues todo ello se estudió en el Tutorial. Al
3116 hacerlo así obtenemos:
3118 @lilypond[quote,verbatim,ragged-right]
3119 rhMusic = \relative c'' {
3124 % Start polyphonic section of four voices
3126 {c,8[ d fis bes a] | }
3137 lhMusic = \relative c' {
3146 \new Staff = "RH" <<
3150 \new Staff = "LH" <<
3159 El primer compás ahora es correcto. El segundo compás contiene un
3160 arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
3161 sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
3162 que volver e la Referencia de la Notación. Buscando la palabra
3163 @q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
3164 que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
3165 doble barra se produce por medio de la instrucción @code{\bar "||"}.
3166 Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
3167 la colisión entre la ligadura de unión y la indicación de compás.
3168 Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
3169 mover objetos anteriormente en @ref{Moving objects}, donde dice que
3170 los objetos que están situados de forma relativa al pentagrama se
3171 pueden mover sobreescribiendo su propiedad @code{staff-position}, que
3172 se especifica en unidades de medio espacio de pentagrama respecto de
3173 la línea central del pentagrama. Así pues, la sobreescritura
3174 siguiente colocada justo antes de la primera nota ligada subirá la
3175 ligadura 3.5 medios espacios de pentagrama por encima de la línea
3178 @code{\once \override Tie #'staff-position = #3.5}
3180 Con esto se completa el compás dos, dando como resultado:
3182 @lilypond[quote,verbatim,ragged-right]
3183 rhMusic = \relative c'' {
3185 \once \override Tie #'staff-position = #3.5
3190 % Start polyphonic section of four voices
3192 {c,8[ d fis bes a] | }
3203 lhMusic = \relative c' {
3205 <d g, d>1)\arpeggio |
3212 \new Staff = "RH" <<
3216 \new Staff = "LH" <<
3225 Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
3226 tutorial nos enseñó cómo escribir texto en negrita mediante la
3227 instrucción @code{\markup}, por lo que añadir @q{Moderato} en negrita
3228 es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
3229 voces? Aquí es donde debemos volver a buscar ayuda en el manual de
3230 Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
3231 el índice de la Referencia de la notación llegamos rápidamente a las
3232 instrucciones para mezclar notas con distinta cabeza y con o sin
3233 puntillo, en @ruser{Collision resolution}. En nuestro ejemplo tenemos
3234 que fusionar ambos tipos de nota en el transcurso de la sección
3235 polifónica del compás 3; por tanto, en virtud de la información que
3236 aparece en la Referencia de la Notación, escribimos
3239 \mergeDifferentlyHeadedOn
3240 \mergeDifferentlyDottedOn
3244 al principio de la sección, y
3247 \mergeDifferentlyHeadedOff
3248 \mergeDifferentlyDottedOff
3252 al final, dando como resultado:
3254 @lilypond[quote,verbatim,ragged-right]
3255 rhMusic = \relative c'' {
3257 \once \override Tie #'staff-position = #3.5
3261 bes2.^\markup {\bold "Moderato"} r8
3262 \mergeDifferentlyHeadedOn
3263 \mergeDifferentlyDottedOn
3264 % Start polyphonic section of four voices
3266 {c,8[ d fis bes a] | }
3274 \mergeDifferentlyHeadedOff
3275 \mergeDifferentlyDottedOff
3279 lhMusic = \relative c' {
3281 <d g, d>1)\arpeggio |
3288 \new Staff = "RH" <<
3292 \new Staff = "LH" <<
3301 Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
3302 dos Re. ¿Por qué no? La respuesta está en la misma sección de la
3303 Referencia de la Notación: las notas que se fusionan deben tener las
3304 plicas en direcciones opuestas y dos notas no se pueden fusionar bien
3305 si hay una tercera nota en la misma columna. Aquí los dos Re tienen
3306 las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
3307 cambiar la dirección de la plica usando @code{\stemDown}, y la
3308 Referencia de la Notación también explica cómo mover el Do: aplicar un
3309 desplazamiento usando una de las instrucciones @code{\shift}. Pero
3310 ¿cuál? El Do está en la voz dos que tiene desactivado el
3311 desplazamiento, y los dos Re están en las voces uno y tres, que tienen
3312 el desplazamiento desactivado y activado, respectivamente. Por ello
3313 tenemos que desplazar el Do un nivel más todavía, usando
3314 @code{\shiftOnn} para evitar que interfiera con los dos Re. Al
3315 aplicar estos cambios obtenemos:
3317 @cindex Tie, ejemplo de sobreescritura
3318 @cindex staff-position, propiedad, ejemplo
3320 @lilypond[quote,verbatim,ragged-right]
3321 rhMusic = \relative c'' {
3323 \once \override Tie #'staff-position = #3.5
3327 bes2.^\markup {\bold "Moderato"} r8
3328 \mergeDifferentlyHeadedOn
3329 \mergeDifferentlyDottedOn
3330 % Start polyphonic section of four voices
3332 {c,8[ d fis bes a] | }
3334 % Move the c2 out of the main note column so the merge will work
3335 {c,8~ \shiftOnn c2 | }
3337 % Stem on the d2 must be down to permit merging
3338 {s8 \stemDown d2 | }
3342 \mergeDifferentlyHeadedOff
3343 \mergeDifferentlyDottedOff
3347 lhMusic = \relative c' {
3349 <d g, d>1)\arpeggio |
3356 \new Staff = "RH" <<
3360 \new Staff = "LH" <<
3369 Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
3370 sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
3371 colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
3372 partir de trucos anteriores: hacemos la plica transparente, y movemos
3373 el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
3376 @cindex NoteColumn, ejemplo de sobreescritura
3377 @cindex force-hshift, propiedad, ejemplo
3378 @cindex Stem, ejemplo de sobreescritura
3379 @cindex transparent, propiedad, ejemplo
3381 @lilypond[quote,verbatim,ragged-right]
3382 rhMusic = \relative c'' {
3385 \once \override Tie #'staff-position = #3.5
3389 bes2.^\markup {\bold "Moderato"} r8
3390 \mergeDifferentlyHeadedOn
3391 \mergeDifferentlyDottedOn
3393 {c,8[ d fis bes a] | }
3395 % Reposition the c2 to the right of the merged note
3396 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3397 % Move the c2 out of the main note column so the merge will work
3400 % Stem on the d2 must be down to permit merging
3401 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3405 \mergeDifferentlyHeadedOff
3406 \mergeDifferentlyDottedOff
3410 lhMusic = \relative c' {
3412 <d g, d>1)\arpeggio |
3419 \new Staff = "RH" <<
3423 \new Staff = "LH" <<
3433 @node Further tweaking
3434 @section Further tweaking
3437 * Other uses for tweaks::
3438 * Using variables for tweaks::
3439 * Other sources of information::
3440 * Avoiding tweaks with slower processing::
3441 * Advanced tweaks with Scheme::
3444 @node Other uses for tweaks
3445 @subsection Other uses for tweaks
3447 @cindex transparent, uso de la propiedad
3448 @cindex objetos, hace invisibles
3449 @cindex eliminar objetos
3450 @cindex objetos, eliminar
3451 @cindex objetos, ocultar
3452 @cindex ocultar objetos
3453 @cindex invisibles, objetos
3454 @cindex objetos invisibles
3455 @cindex ligar notas entre voces distintas
3457 @subheading Tying notes across voices
3459 El ejemplo siguiente muestra cómo conectar notas que están en
3460 distintas voces utilizando ligaduras de unión. Normalmente sólo se
3461 pueden conectar mediante ligaduras de unión dos notas que estén en la
3462 misma voz. Usando dos voces, con las notas ligadas en una de ellas:
3464 @lilypond[quote,fragment,relative=2]
3465 << { b8~ b8\noBeam }
3471 y borrando la primera plica hacia arriba en esa voz, da la impresión
3472 de que la ligadura se cruza entre las voces:
3474 @cindex Stem, ejemplo de sobreescritura
3475 @cindex transparent, propiedad, ejemplo
3477 @lilypond[quote,fragment,relative=2,verbatim]
3480 \once \override Stem #'transparent = ##t
3488 Para estar seguros de que la plica que acabamos de borrar no aprieta
3489 demasiado a la ligadura, podemos alargar la plica estableciendo su
3490 valor de longitud @code{length} a @code{8},
3492 @lilypond[quote,fragment,relative=2,verbatim]
3495 \once \override Stem #'transparent = ##t
3496 \once \override Stem #'length = #8
3504 @subheading Simulating a fermata in MIDI
3506 @cindex sello, uso de la propiedad
3507 @cindex fermata, realización en MIDI
3509 Para los objetos fuera-del-pentagrama, normalmente es mejor
3510 sobreescribir la propiedad @code{stencil} («sello») del objeto que su
3511 propiedad @code{transparent} cuando desee quitarlos de la salida
3512 impresa. Mediante el establecimiento de la propiedad @code{stencil}
3513 de un objeto al valor @code{#f} podemos quitar el objeto por completo
3514 de la salida impresa. Esto significa que no tiene efecto sobre la
3515 colocación de otros objetos que pudieran colocarse en relación a él.
3517 Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
3518 propósito de simular un calderón en la salida MIDI, seguramente no
3519 querríamos que la indicación metronómica apareciese en la salida
3520 impresa, y no querríamos influir sobre la separación entre los dos
3521 sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
3522 pentagrama. Por lo tanto, establecer su propiedad @code{stencil} al
3523 valor @code{#f} sería la mejor manera. Mostramos aquí el efecto de
3526 @cindex MetronomeMark, ejemplo de sobreescritura
3527 @cindex transparent, propiedad, ejemplo
3529 @lilypond[quote,verbatim,ragged-right]
3532 % Visible tempo marking
3535 \once \override Score.MetronomeMark #'transparent = ##t
3536 % Invisible tempo marking to lengthen fermata in MIDI
3539 % New tempo for next section
3548 @cindex MetronomeMark, ejemplo de sobreescritura
3549 @cindex stencil, propiedad, ejemplo
3551 @lilypond[quote,verbatim,ragged-right]
3554 % Visible tempo marking
3557 \once \override Score.MetronomeMark #'stencil = ##f
3558 % Invisible tempo marking to lengthen fermata in MIDI
3561 % New tempo for next section
3571 Ambos métodos quitan de la salida impresa la indicación metronómica
3572 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
3573 queríamos, pero la indicación metronómica transparente de la primera
3574 línea fuerza una colocación muy alta de la indicación de tempo que
3575 sigue, mientras que la segunda (con el sello suprimido) no lo hace.
3577 @node Using variables for tweaks
3578 @subsection Using variables for tweaks
3580 @cindex variables, uso de, para trucos
3581 @cindex usar variables para hacer trucos
3582 @cindex trucos, usar variables para hacer
3584 Las instrucciones de sobreescritura son con frecuencia largas y
3585 tediosas de escribir, y se tienen que escribir de forma absolutamente
3586 correcta. Si las mismas sobreescrituras se van a utilizar muchas
3587 veces, podría merecer la pena definir variables para guardarlas.
3589 Supongamos que queremos realzar ciertas palabras de la letra de una
3590 canción imprimiéndolas en cursiva y negrita. Las instrucciones
3591 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
3592 canciones si están incluidas, junto con la palabra o palabras que se
3593 pretenden modificar, dentro de un @code{\markup}, lo que las hace
3594 tediosas de escribir. La necesidad de incluir las propias palabras
3595 impide que se puedan usar en variables simples. ¿Podríamos, como
3596 alternativa, utilizar las instrucciones @code{\override} y
3600 @code{\override Lyrics . LyricText #'font-shape = #'italic}
3601 @code{\override Lyrics . LyricText #'font-series = #'bold}
3603 @code{\revert Lyrics . LyricText #'font-shape}
3604 @code{\revert Lyrics . LyricText #'font-series}
3607 Estas instrucciones también serían extremadamente tediosas de escribir
3608 si hubiera muchas palabras que quisiéramos subrayar. Pero sí
3609 @emph{podemos} definirlas como dos variables y usarlas para delimitar
3610 las palabras que destacar. Otra ventaja de la utilización de
3611 variables para estas sobreescrituras es que ya no son necesarios los
3612 espacios que rodean al punto, puesto que no se interpretan
3613 directamente en el modo @code{\lyricmode}. He aquí un ejemplo de
3614 esto, aunque en la práctica quizá elegiríamos unos nombres de variable
3615 más cortos para que fueran más rápidos de teclear:
3617 @cindex LyricText, ejemplo de sobreescritura
3618 @cindex font-shape, propiedad, ejemplo
3619 @cindex font-series, propiedad, ejemplo
3621 @lilypond[quote,verbatim]
3623 \override Lyrics.LyricText #'font-shape = #'italic
3624 \override Lyrics.LyricText #'font-series = #'bold
3627 \revert Lyrics.LyricText #'font-shape
3628 \revert Lyrics.LyricText #'font-series
3631 global = { \time 4/4 \partial 4 \key c \major}
3632 SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
3633 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f f e }
3634 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
3635 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
3636 VerseOne = \lyrics { E -- | ter -- nal \emphasize Fa -- ther, \normal | strong to save, }
3637 VerseTwo = \lyricmode { O | \emphasize Christ, \normal whose voice the | wa -- ters heard, }
3638 VerseThree = \lyricmode { O | \emphasize Ho -- ly Spi -- rit, \normal | who didst brood }
3639 VerseFour = \lyricmode { O | \emphasize Tri -- ni -- ty \normal of | love and pow'r }
3645 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
3646 \new Voice = "Alto" { \voiceTwo \AltoMusic }
3647 \new Lyrics \lyricsto "Soprano" { \VerseOne }
3648 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
3649 \new Lyrics \lyricsto "Soprano" { \VerseThree }
3650 \new Lyrics \lyricsto "Soprano" { \VerseFour }
3654 \new Voice = "Tenor" { \voiceOne \TenorMusic }
3655 \new Voice = "Bass" { \voiceTwo \BassMusic }
3662 @node Other sources of information
3663 @subsection Other sources of information
3665 La documentación del manual de Referencia de Funcionamiento Interno
3666 contiene montañas de información sobre LilyPond, pero se puede obtener
3667 más información aún leyendo los archivos internos de LilyPond. Para
3668 echarles un vistazo, en primer lugar debe buscar la carpeta
3669 correspondiente a su sistema. La ubicación de esta carpeta depende
3670 (a) de si consiguió el programa LilyPond descargando un binario
3671 precompilado desde el sitio web lilypond.org o si lo instaló mediante
3672 un gestor de paquetes (es decir, distribuido con Linux, o instalado
3673 bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
3674 qué sistema operativo está utilizando:
3677 @strong{Descargado de lilypond.org}
3683 @file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/share/lilypond/current/}
3688 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/Resources/share/lilypond/current/}
3689 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
3690 bien manteniendo pulsada la tecla de Control y haciendo click sobre la
3691 aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
3696 Mediante el Explorador de Windows, diríjase a
3697 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/share/lilypond/current/}
3701 @strong{Instalado mediante un gestor de paquetes o compilado a partir de la fuente}
3704 @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
3705 se encuentra determinado por su administrador de paquetes o guión
3706 @code{configure}, y @var{X.Y.Z} es el número de la versión de
3711 Dentro de esta carpeta, las dos subcarpetas interesantes son
3714 @item @file{ly/} - contiene archivos en formato LilyPond
3715 @item @file{scm/} - contiene archivos en formato Scheme
3718 Vamos a comenzar observando algunos archivos que están en @file{ly/}.
3719 Abra @file{ly/property-init.ly} con un editor de textos. El mismo que
3720 usaría normalmente para los archivos @code{.ly} servirá perfectamente.
3721 Este archivo contiene las definiciones de todas las instrucciones
3722 estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} y
3723 @code{\slurDotted}. Podrá ver que no son nada más que definiciones de
3724 variables que contienen una o varias instrucciones @code{\override}.
3725 Por ejemplo, @code{/tieDotted} está definido de tal forma que su valor
3730 \override Tie #'dash-period = #0.75
3731 \override Tie #'dash-fraction = #0.1
3735 Si no le gustan los valores predeterminados, estas instrucciones
3736 predefinidas se pueden redefinir con facilidad como cualquier otra
3737 variable, al principio de su archivo de código de entrada.
3739 Los siguientes son los archivos más útiles que se encuentran en
3742 @multitable @columnfractions .4 .6
3745 @item @file{ly/engraver-init.ly}
3746 @tab Definiciones de Contextos de grabadores
3747 @item @file{ly/paper-defaults-init.ly}
3748 @tab especificaciones de valores predeterminados relacionados con el papel
3749 @item @file{ly/performer-init.ly}
3750 @tab Definiciones de Contextos de interpretación
3751 @item @file{ly/property-init.ly}
3752 @tab Definiciones de todas las instrucciones predefinidas que son comunes
3753 @item @file{ly/spanner-init.ly}
3754 @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
3757 Otros ajustes (como las definiciones de las instrucciones de marcado)
3758 se almacenan como archivos @code{.scm} (de Scheme). El lenguaje de
3759 programación Scheme se utiliza para proporcionar un interfaz
3760 programable en el funcionamiento interno de LilyPond. Cualquier
3761 explicación adicional sobre estos archivos se encuentra por el momento
3762 fuera del ámbito de este manual, porque se requieren conocimientos del
3763 lenguaje Scheme. Se advierte a los usuarios que se necesita una
3764 importante cantidad de conocimientos técnicos o de tiempo para
3765 comprender el lenguaje Scheme y estos archivos (véase @ref{Scheme
3768 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
3771 @multitable @columnfractions .4 .6
3774 @item @file{scm/auto-beam.scm}
3775 @tab Valores predeterminados de sub-barrado
3776 @item @file{scm/define-grobs.scm}
3777 @tab valores predeterminados de las propiedades de grobs
3778 @item @file{scm/define-markup-commands.scm}
3779 @tab Especificar todas las instrucciones de marcado
3780 @item @file{scm/midi.scm}
3781 @tab Ajustes predeterminados para la salida MIDI
3782 @item @file{scm/output-lib.scm}
3783 @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
3784 @item @file{scm/parser-clef.scm}
3785 @tab Definiciones de las claves contempladas
3786 @item @file{scm/script.scm}
3787 @tab Ajustes predeterminados para las articulaciones
3792 @node Avoiding tweaks with slower processing
3793 @subsection Avoiding tweaks with slower processing
3795 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
3796 procesa los archivos. Estas instrucciones consumen tiempo, pero el
3797 resultado puede necesitar menos trucos manuales para obtener un
3798 resultado aceptable. Si una inscripción de texto o parte de la letra
3799 se sale de los márgenes, estas comprobaciones comprimirán dicha línea
3800 en la medida justa como para que encaje dentro de los márgenes.
3802 Para que sean efectivos bajo cualquier circunstancia, estas
3803 comprobaciones deben habilitarse colocando las instrucciones de
3804 sobreescritura dentro del bloque @code{\with} dentro de un Score, y no
3805 en línea con la música, de la forma siguiente:
3810 % asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
3811 \override PaperColumn #'keep-inside-line = ##t
3812 \override NonMusicalPaperColumn #'keep-inside-line = ##t
3818 @node Advanced tweaks with Scheme
3819 @subsection Advanced tweaks with Scheme
3821 Aunque es posible hacer muchas cosas con las instrucciones
3822 @code{\override} y @code{\tweak} , tenemos una forma incluso más
3823 poderosa de modificar el funcionamiento de LilyPond, a través de un
3824 interface programable hacia las operaciones internas de LilyPond. Se
3825 puede incorporar código escrito en el lenguaje de programación Scheme,
3826 directamente en el mecanismo de funcionamiento de LilyPond. Por
3827 supuesto, para hacer esto se necesitan al menos unos conocimientos
3828 básicos de programación en Scheme, y damos una introducción en el
3829 @ref{Scheme tutorial}.
3831 Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
3832 dar a una propiedad un valor constante, se puede establecer al
3833 resultado de un procedimiento de Scheme que se invoca cada vez que
3834 LilyPond accede a esta propiedad. La propiedad se puede establecer
3835 dinámicamente a un valor determinado por el procedimiento en el
3836 momento en que se invoca. En este ejemplo damos a las cabezas de las
3837 notas un color que depende de su posición dentro del pentagrama.
3839 @cindex x11-color, función, ejemplo de utilización
3840 @cindex NoteHead, ejemplo de sobreescritura
3841 @cindex color, propiedad, establecer a procedimiento de Scheme
3843 @lilypond[quote,verbatim,ragged-right]
3844 #(define (color-notehead grob)
3845 "Color the notehead according to its position on the staff."
3846 (let ((mod-position (modulo (ly:grob-property grob 'staff-position) 7)))
3848 ;; Return rainbow colors
3849 ((1) (x11-color 'red )) ; for C
3850 ((2) (x11-color 'orange )) ; for D
3851 ((3) (x11-color 'yellow )) ; for E
3852 ((4) (x11-color 'green )) ; for F
3853 ((5) (x11-color 'blue )) ; for G
3854 ((6) (x11-color 'purple )) ; for A
3855 ((0) (x11-color 'violet )) ; for B
3861 % Arrange to obtain color from color-notehead procedure
3862 \override NoteHead #'color = #color-notehead
3869 Some -- where o -- ver the Rain -- bow, way up high,
3873 Se pueden encontrar ejemplos adicionales que muestran la utilización
3874 de estos interfaces programables, en @ref{Tweaking with Scheme}.