1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 7fdce4f39834cc8c83f176480cc1d20900eb09f8
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Trucar la salida
14 @chapter Trucar la salida
15 @translationof Tweaking output
17 Este capítulo trata de cómo modificar la salida. LilyPond es extremadamente
18 configurable; prácticamente todos los fragmentos de la salida se pueden cambiar.
22 * Elementos de trucaje::
23 * Manual de referencia de funcionamiento interno::
24 * Apariencia de los objetos::
25 * Colocación de los objetos::
26 * Espaciado vertical::
27 * Colisiones de objetos::
28 * Trucajes adicionales::
31 @node Elementos de trucaje
32 @section Elementos de trucaje
33 @translationof Tweaking basics
36 * Introducción al trucaje::
37 * Objetos e interfaces::
38 * Convenciones de nombres de objetos y propiedades::
39 * Métodos de trucaje::
42 @node Introducción al trucaje
43 @subsection Introducción al trucaje
44 @translationof Introduction to tweaks
46 El @q{Trucaje} es un término de LilyPond que denota los diversos
47 métodos que el usuario tiene a su disposición para modificar el
48 proceso de interpretación del archivo de entrada y cambiar la
49 apariencia de la salida impresa. Algunos trucos son muy fáciles de
50 usar; otros son más complejos. Pero en su conjunto, los métodos de
51 trucaje disponibles posibilitan conseguir casi cualquier apariencia
52 que deseemos en la música impresa.
54 En esta sección vamos a estudiar los conceptos básicos que se
55 necesitan para comprender el trucaje. Más tarde daremos un amplio
56 abanico de instrucciones listas para usar, que podrá simplemente
57 copiar para obtener el mismo efecto en sus partituras, y al mismo
58 tiempo mostraremos la forma de construir dichas instrucciones para que
59 pueda aprender cómo desarrollar sus propios trucos.
61 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
62 la sección @ref{Contextos y grabadores}, pues los Contextos, los
63 Grabadores y las Propiedades que se contienen en ellos son
64 fundamentales para comprender y construir los trucos.
66 @node Objetos e interfaces
67 @subsection Objetos e interfaces
68 @translationof Objects and interfaces
72 @cindex objeto de extensión
74 @cindex propiedades de objetos
75 @cindex objeto, propiedades de
76 @cindex layout (disposición), objeto de
77 @cindex objeto de disposición (layout)
79 El trucaje consiste en modificar el funcionamiento y estructura
80 interna del programa LilyPond, por lo que en primer lugar
81 introduciremos algunos términos que se usan para describir dichas
82 operaciones y estructuras internas.
84 El término @q{Objeto} es un término genérico que se usa para referirse
85 a la multitud de estructuras internas que LilyPond construye durante
86 el procesado de un archivo de entrada. Así, cuando se encuentra una
87 instrucción como @code{\new Staff}, se construye un objeto nuevo del
88 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
89 las propiedades asociadas con ese pentagrama en particular, por
90 ejemplo, su nombre y su armadura, además de otros detalles de los
91 grabadores que se han asignado para que operen dentro del contexto del
92 pentagrama. De forma similar, hay objetos que guardan las propiedades
93 de todos los demás contextos, como objetos de @code{Voice}, objetos de
94 @code{Score}, objetos de @code{Lyrics}, así como objetos que
95 representan todos los elementos notacionales como líneas divisorias,
96 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
97 objeto tiene su propio conjunto de valores de propiedad.
99 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
100 representan elementos de notación sobre la salida impresa como cabezas
101 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
102 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
103 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
104 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
105 mencionado, y también todos ellos tienen propiedades asociadas, como
106 su posición, tamaño, color,etc.
108 Ciertos objetos de presentación son aún más especializados. Las
109 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
110 y baja, y muchos otros objetos gráficos no están situados en un solo
111 lugar: tienen un punto de inicio, un punto de final, y quizá otras
112 propiedades relacionadas con su forma. Los objetos con una forma
113 extendida como estos, reciben el nombre de «Objetos de extensión» o
116 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
117 incluso aunque son bastante diferentes, comparten funcionalidades que
118 se deben procesar de la misma manera. Por ejemplo, todos los objetos
119 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
120 propiedades se procesan de la misma forma durante la interpretación
121 del archivo de entrada por parte de LilyPond. Para simplificar estas
122 operaciones internas, estas acciones y propiedades comunes se agrupan
123 en un objeto llamado @code{grob-interface}, interface de grob. Hay
124 muchas otras agrupaciones de propiedades comunes como ésta, y cada
125 una recibe un nombre que acaba en @code{interface}. En total hay más
126 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
127 interés y de utilidad para el usuario.
129 Estos son, en fin, los términos principales relativos a los objetos
130 que vamos a utilizar en este capítulo.
132 @node Convenciones de nombres de objetos y propiedades
133 @subsection Convenciones de nombres de objetos y propiedades
134 @translationof Naming conventions of objects and properties
136 @cindex nomenclatura, convenciones de, para objetos
137 @cindex nomenclatura, convenciones de, para propiedades
138 @cindex objetos, convenciones de nomenclatura
139 @cindex propiedades, convenciones de nomenclatura
141 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
142 sección @ref{Contextos y grabadores}. En este lugar, para más fácil
143 referencia, presentamos una lista de los tipos de objetos y
144 propiedades más comunes, junto con las convenciones según las cuales
145 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
146 utilizado una @q{A} mayúscula para denotar cualquier carácter
147 alfabético en mayúsculas, y @q{aaa} para cualquier número de
148 caracteres alfabéticos en minúscula. Otros caracteres se utilizan
149 literalmente como están.
151 @multitable @columnfractions .33 .33 .33
152 @headitem Objeto o tipo de propiedad
153 @tab Convención de nomenclatura
156 @tab Aaaa o AaaaAaaaAaaa
157 @tab Staff, GrandStaff
158 @item Objetos de presentación
159 @tab Aaaa o AaaaAaaaAaaa
162 @tab Aaaa_aaa_engraver
163 @tab Clef_engraver, Note_heads_engraver
165 @tab aaa-aaa-interface
166 @tab grob-interface, break-aligned-interface
167 @item Propiedades de contextos
168 @tab aaa o aaaAaaaAaaa
169 @tab alignAboveContext, skipBars
170 @item Propiedades de objetos de presentación
171 @tab aaa o aaa-aaa-aaa
172 @tab direction, beam-thickness
175 Como podremos ver en breve, las propiedades de distintos tipos de
176 objeto se modifican por parte de diferentes instrucciones; así pues,
177 es útil poder reconocer los tipos de objetos y propiedades
178 a partir de sus nombres.
180 @node Métodos de trucaje
181 @subsection Métodos de trucaje
182 @translationof Tweaking methods
184 @cindex trucaje, métodos de
186 @strong{La instrucción \override}
189 * La instrucción override::
190 * La instrucción revert::
192 * La instrucción overrideProperty::
193 * La instrucción tweak::
196 @node La instrucción override
197 @unnumberedsubsubsec La instrucción @code{@bs{}override}
198 @translationof The override command
200 @cindex override, instrucción
201 @cindex override (sobreescritura), sintaxis de
206 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
207 usan para cambiar las propiedades de los @strong{contextos} y para
208 quitar y poner @strong{grabadores}, en @ref{Modificar las propiedades de los contextos}
209 y @ref{Añadir y eliminar grabadores}. Ahora debemos
210 examinar algunas otras instrucciones importantes.
212 La instrucción que cambia las propiedades de los @strong{objetos de
213 presentación} es @code{\override}. Puesto que esta instrucción debe
214 modificar propiedades internas que se encuentran en un lugar profundo
215 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
216 las instrucciones que hemos usado hasta ahora. Tiene que saber
217 exactamente qué propiedad de qué objeto y en qué contexto se debe
218 modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
220 La sintaxis genérica de esta instrucción es:
223 \override @var{Contexto}.@var{ObjetoDePresentación}.@var{propiedad-de-presentación} =
228 Esto establecerá la propiedad de nombre
229 @var{propiedad-de-presentación} del objeto de presentación con el
230 nombre @var{ObjetoDePresentación}, que es miembro del contexto
231 @var{Contexto}, al valor @var{valor}.
233 El @var{contexto} se puede omitir (y normalmente así es) cuando el
234 contexto requerido se encuentra implicado sin ambigüedad y es uno de
235 los contextos del nivel más bajo, es decir: @code{Voice},
236 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
237 ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
239 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
240 valores, véase @ref{Tipos de propiedades}. Pero en esta sección
241 usaremos sólo unas cuantas propiedades y valores
242 sencillos que sean fáciles de entender, para ilustrar el formato
243 y la utilización de estas instrucciones.
245 Las expresiones principales de LilyPond son elementos musicales
246 como notas, duraciones y elementos de marcado. Las expresiones
247 más básicas como números, cadenas de caracteres y listas se
248 procesan en el @q{modo de Scheme}, que se invoca por medio del
249 prefijo @samp{#} escrito antes del valor. Aunque los valores
250 pueden tener a veces una representación válida en el modo de
251 música de LilyPond, este manual utiliza siempre @samp{#} para la
252 escritura, por coherencia. Para ver más información acerca del
253 modo de Scheme, consulte @rextend{Sintaxis del Scheme de LilyPond}.
255 @code{\override} es la
256 instrucción de uso más común dentro del trucaje, y durante la mayor
257 parte del resto de este capítulo presentaremos ejemplos de cómo se
258 usa. A continuación hay un ejemplo sencillo para cambiar el color de
261 @cindex color, propiedad, ejemplo
262 @cindex NoteHead, ejemplo de sobreescritura
264 @lilypond[quote,ragged-right,verbatim]
267 \override NoteHead.color = #red
269 \override NoteHead.color = #green
275 @node La instrucción revert
276 @unnumberedsubsubsec La instrucción @code{@bs{}revert}
277 @translationof The revert command
279 @cindex revert, instrucción
284 Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
285 se sobreescribe de nuevo o se encuentra una instrucción
286 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
287 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
288 valor predeterminado original; observe que no es a su valor previo si
289 se han utilizado varias instrucciones @code{\override}.
292 \revert @var{Contexto}.@var{ObjetoDePresentación}.@var{propiedad-de-presentación}
295 Una vez más, igual que @var{Contexto} dentro de la instrucción
296 @code{\override}, con frecuencia no es necesario especificar el
297 @var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
298 Aquí devolvemos el color de la cabeza al valor predeterminado para las
301 @cindex color, propiedad, ejemplo
302 @cindex NoteHead, ejemplo de sobreescritura
304 @lilypond[quote,ragged-right,verbatim]
307 \override NoteHead.color = #red
309 \override NoteHead.color = #green
311 \revert NoteHead.color
317 @node El prefijo once
318 @unnumberedsubsubsec El prefijo @code{@bs{}once}
319 @translationof The once prefix
324 Tanto la instrucción @code{\override} como @code{\set} se pueden
325 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
326 @code{\override} o @code{\set} sea efectiva solamente durante el
327 tiempo musical en curso y antes de que la propiedad vuelva a tener
328 otra vez su valor anterior (que puede ser distinto de su valor
329 predeterminado si aún se está aplicando otra instrucción
330 @code{\override} de sobreescritura). Utilizando el mismo ejemplo,
331 podemos cambiar el color de una sola nota de la siguiente manera:
333 @cindex color, propiedad, ejemplo
334 @cindex NoteHead, ejemplo de sobreescritura
336 @lilypond[quote,verbatim]
339 \override NoteHead.color = #red
341 \once \override NoteHead.color = #green
343 \revert NoteHead.color
348 El prefijo @code{\once} también se puede usar delante de muchas
349 instrucciones predefinidas para limitar su efecto a un solo momento
352 @lilypond[quote,verbatim,relative=1]
361 Sin embargo, las instrucciones predefinidas de la forma
362 @code{\@dots{}Neutral},
363 @code{\@dots{}Off} y @code{\un@dots{}} utilizan
364 internamente @code{\revert} en vez de @code{\override}, por lo que
365 añadir @code{\once} como prefijo aquí no tiene ningún efecto.
368 @node La instrucción overrideProperty
369 @unnumberedsubsubsec La instrucción @code{@bs{}overrideProperty}
370 @translationof The overrideProperty command
372 @cindex overrideProperty, instrucción
374 @funindex \overrideProperty
375 @funindex overrideProperty
377 Hay otra forma para la instrucción de sobreescritura,
378 @code{\overrideProperty}, que ocasionalmente es necesaria. La
379 mencionamos aquí con un propósito de exhaustividad, pero para ver más
380 detalles consulte @rextend{Trucos difíciles}.
381 @c Maybe explain in a later iteration -td
384 @node La instrucción tweak
385 @unnumberedsubsubsec La instrucción @code{@bs{}tweak}
386 @translationof The tweak command
388 @cindex tweak, instrucción
393 La última instrucción de trucaje que está disponible es @code{\tweak}.
394 Se debe utilizar cuando varios objetos tienen lugar
395 en el mismo momento musical pero solo queremos cambiar las propiedades
396 de algunos de ellos, como una sola nota dentro de un acorde.
398 @code{\override} para la sobreescritura afectaría a todas las notas
399 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
400 elemento del flujo de entrada.
402 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
403 cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
404 primer lugar, veamos lo que haría @code{\once \override}:
406 @cindex font-size, propiedad, ejemplo
407 @cindex NoteHead, ejemplo de sobreescritura
409 @lilypond[quote,ragged-right,verbatim]
412 \once \override NoteHead.font-size = #-3
418 Vemos que la sobreescritura con override afecta a @emph{todas} las
419 cabezas de las notas del acorde. Esto es así porque todas las notas
420 de un acorde ocurren en el mismo @emph{momento musical}, y la acción
421 de @code{\once} es aplicar la sobreescritura a todos los objetos de
422 presentación del tipo especificado que ocurren en el mismo momento
423 musical que la propia instrucción de sobreescritura @code{\override}.
425 La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
426 el elemento inmediatamente siguiente dentro del flujo de entrada.
427 En su forma más sencilla es efectivo solamente sobre objetos
428 que se crean directamente
429 a partir del elemento siguiente, en esencia las cabezas y las
432 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
433 se cambiaría de la siguiente forma:
435 @cindex font-size, propiedad, ejemplo
436 @cindex @code{\tweak}, ejemplo
438 @lilypond[quote,ragged-right,verbatim]
441 <c \tweak font-size #-3 e g>4
445 Observe que la sintaxis de @code{\tweak} no es igual que la de
446 @code{\override}. El contexto no se
447 debe especificar; de hecho, generaría un error hacerlo.
448 Tanto el contexto como el objeto de presentación
449 están implícitos por el siguiente elemento del flujo de entrada.
450 Observe también que no debe haber un signo igual. Así que la sintaxis
451 de la instrucción @code{\tweak} en su forma sencilla es:
454 \tweak @var{propiedad-de-presentación} #@var{valor}
457 Una instrucción @code{\tweak} también se puede usar para modificar
458 sólo una de una serie de articulaciones, como se muestra aquí:
460 @cindex color, propiedad, ejemplo
461 @cindex @code{\tweak}, ejemplo
463 @lilypond[quote,fragment,ragged-right,verbatim]
465 -\tweak color #red ^"Red"
466 -\tweak color #green _"Green"
470 Observe que la instrucción @code{\tweak} debe venir precedida de una
471 marca de articulación porque la propia expresión trucada debe aplicarse
472 como una articulación. En el caso de más de una sobreescritura de dirección
473 (@code{^} o @code{_}), gana la sobreescritura situada más a la izquierda
474 porque se aplica en último lugar.
476 @cindex @code{\tweak}, Accidental
477 @cindex @code{\tweak}, specific layout object
479 Los objetos tales como plicas y alteraciones accidentales se crean más
480 tarde, y no directamente a partir del evento que viene a continuación.
481 Aún es posible utilizar @code{\tweak} sobre tales objetos creados
482 indirectamente mediante el nombrado explícito del objeto de
483 presentación, siempre y cuando LilyPond pueda rastrear su origen hasta
486 @lilypond[quote,fragment,ragged-right,verbatim]
487 <\tweak Accidental.color #red cis''4
488 \tweak Accidental.color #green es''
492 Esta forma extensa de la instrucción @code{\tweak} se puede describir
495 \tweak @var{objeto-de-presentación}.@var{propiedad-de-presentación} @var{valor}
498 @cindex grupos especiales anidados
499 @cindex tresillos anidados
500 @cindex corchete del grupo especial
501 @cindex corchete de tresillo
502 @cindex grupo especial, corchete de
503 @cindex tresillo, corchete de
505 @funindex TupletBracket
507 La instrucción @code{\tweak} también se debe usar para cambiar la
508 apariencia de uno solo de un conjunto de grupos especiales anidados
509 que comiencen en el mismo instante musical. En el siguiente ejemplo,
510 el corchete del tresillo largo y el primero de los tres corchetes
511 cortos empiezan en el mismo momento musical, y por ello cualquier
512 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
513 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
514 @code{\tweak} especifica que el corchete del tresillo largo se debe
515 colocar por encima de las notas y el segundo especifica que el número
516 del tresillo se debe imprimir en rojo sobre el corchete del primer
519 @cindex @code{\tweak}, ejemplo
520 @cindex direction, propiedad, ejemplo
521 @cindex color, propiedad, ejemplo
523 @lilypond[quote,ragged-right,verbatim]
528 \tuplet 3/2 { c8[ c c] }
529 \tuplet 3/2 { c8[ c c] }
530 \tuplet 3/2 { c8[ c c] }
535 Si los grupos anidados no comienzan en el mismo momento, su apariencia
536 se puede modificar de la forma usual mediante instrucciones
539 @cindex text, propiedad, ejemplo
540 @cindex tuplet-number, función, ejemplo
541 @cindex transparent, propiedad, ejemplo
542 @cindex TupletNumber, ejemplo de sobreescritura
544 @lilypond[quote,ragged-right,verbatim]
546 \tuplet 3/2 { c'8[ c c] }
547 \once \override TupletNumber.text = #tuplet-number::calc-fraction-text
551 \once \override TupletNumber.transparent = ##t
552 \tuplet 3/2 { c8[ c c] }
553 \tuplet 3/2 { c8[ c c] }
560 Referencia de la notación:
561 @ruser{La instrucción tweak}.
564 @node Manual de referencia de funcionamiento interno
565 @section Manual de referencia de funcionamiento interno
566 @translationof The Internals Reference manual
568 @cindex Internals Reference
571 * Propiedades de los objetos de presentación::
572 * Propiedades de los interfaces::
573 * Tipos de propiedades::
576 @node Propiedades de los objetos de presentación
577 @subsection Propiedades de los objetos de presentación
578 @translationof Properties of layout objects
580 @cindex propiedades de los objetos de presentación
581 @cindex propiedades de los grobs
582 @cindex grobs, propiedades de
583 @cindex presentación, propiedades de los objetos de
584 @cindex Referencia de funcionamiento interno
586 Suponga que tiene una partitura con una ligadura de expresión que para
587 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
588 debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
589 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
590 piensa que una cierta instrucción de sobreescritura @code{\override}
591 será necesaria. Pero ¿existe una propiedad de grosor para las
592 ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
593 interviene el Manual de Funcionamiento Interno. Contiene toda la
594 información que puede necesitar para construir ésta y todas las demás
595 instrucciones @code{\override}, de sobreescritura.
597 Una advertencia antes de dirigir nuestra mirada a la referencia de
598 funcionamiento interno. Éste es un documento de @strong{referencia},
599 lo que significa que hay pocas o ninguna explicación en él: su
600 propósito es presentar la información de forma precisa y concisa. Por
601 tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
602 La guía y las explicaciones que presentamos aquí le permitirán extraer
603 la información de la referencia de funcionamiento interno por sí mismo
604 con tan sólo algo de práctica.
606 @cindex sobreescritura, ejemplo de
607 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
608 @cindex @code{\addlyrics}, ejemplo
610 Utilicemos un ejemplo concreto con un sencillo fragmento de música
613 @c Mozart, dúo, núm. 7 de La Flauta Mágica
615 @lilypond[quote,verbatim]
620 r4 bes'8 bes[( g]) g |
621 g8[( es]) es d[( f]) as |
625 The man who | feels love's sweet e -- | mo -- tion
630 Suponga ahora que decidimos que nos gustan las ligaduras algo más
631 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
632 presentación, así que la cuestión es @q{¿Hay una propiedad
633 perteneciente a las ligaduras de expresión que controle su grosor?}
634 Para responder a esta pregunta debemos mirar el manual de Referencia
635 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
636 (Internals Reference) en inglés}.
638 El RFI de la versión de LilyPond que está usando se puede encontrar en
639 la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
640 página de la documentación y siga el enlace Manual de Referencia de
641 Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
642 sería mejor que utilizase la versión en HTML, no la @q{en una sola
643 página} ni el PDF. Para que los siguientes párrafos tengan algún
644 sentido deberá consultarlo realmente al tiempo que lee.
646 @c Link names in English as those pages are not yet translated. FV
647 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
648 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
649 información sobre los objetos de presentación. Una vez allí, bajo el
650 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
651 objects}. La página que aparece relaciona todos los objetos de
652 presentación que se usan en su versión de LilyPond, en orden
653 alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
654 relacionadas las propiedades de las ligaduras de expresión o Slurs.
656 Una forma alternativa de encontrar esta página es a partir de la
657 Referencia de la Notación. En una de las páginas que tratan de las
658 ligaduras de expresión podrá encontrar un enlace al manual de
659 referencia del funcionamiento interno. Este enlace le llevará
660 directamente a esta página, aunque si tiene una idea del nombre del
661 objeto de presentación que pretende trucar, le resultará más fácil ir
662 directamente al RFI y buscar allí.
664 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
665 dice en primer lugar que los objetos Slur se crean por el grabador
666 Slur_engraver. A continuación relaciona los ajustes estándar.
667 Navegue por ellos buscando una propiedad que pudiera controlar
668 el grosor de las ligaduras, y encontrará
671 @code{thickness} (number)
673 Line thickness, generally measured in @code{line-thickness}
676 Esto promete ser una buena opción para cambiar el grosor. Nos dice
677 que el valor de @code{thickness} es un simple @emph{número}, que el
678 valor predeterminado es 1.2, y que las unidades están dentro de otra
679 propiedad llamada @code{line-thickness}.
681 Como dijimos con anterioridad, existen entre pocas y ninguna
682 explicación en el RFI, pero ya tenemos información suficiente para
683 probar a cambiar el grosor de la ligadura. Vemos que el nombre del
684 objeto de presentación es @code{Slur}, que el nombre de la propiedad
685 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
686 un número algo más grande que 1.2 si queremos hacer las ligaduras más
689 Ahora podemos construir la instrucción de sobreescritura
690 @code{\override} simplemente mediante la sustitución de los valores
691 que hemos encontrado para los nombres, omitiendo el contexto.
692 Usaremos un valor muy grande para el grosor al principio, para estar
693 seguros de que la instrucción está funcionando. Obtenemos lo
697 \override Slur.thickness = #5.0
700 ¡No olvide el @code{#'} antes del nombre de la propiedad y@tie{}@code{#}
701 antes del valor nuevo!
703 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
704 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
705 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
706 cerca de ella.} Hagámoslo así:
708 @cindex Slur, ejemplo de sobreescritura
709 @cindex thickness, propiedad, ejemplo
711 @lilypond[quote,verbatim]
716 % Increase thickness of all following slurs from 1.2 to 5.0
717 \override Slur.thickness = #5.0
718 r4 bes'8 bes[( g]) g |
719 g8[( es]) es d[( f]) as |
723 The man who | feels love's sweet e -- | mo -- tion
729 y podemos ver que la ligadura, es sin duda, más pesada.
731 Así pues, ésta es la forma básica de construir instrucciones
732 @code{\override} o de sobreescritura. Existen unas cuantas
733 complicaciones más con las que nos encontraremos en secciones
734 posteriores, pero ahora conoce todos los principios esenciales que
735 necesita para hacerlo por sí mismo (aunque aún necesita algo de
736 práctica). La cual vendrá proporcionada por los ejemplos que vienen a
739 @subsubsubheading Búsqueda del contexto
741 @cindex contexto, encontrar
742 @cindex contexto, buscar el, correcto
744 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
745 especificar el contexto? ¿Cuál sería? Podemos suponer que las
746 ligaduras están en el contexto de Voz, por estar claramente asociados
747 de manera estrecha con las líneas individuales de música, pero
748 ¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
749 de la página del RFI que describe las ligaduras (Slur), donde dice
750 @q{Slur objects are created by: Slur engraver} («Los objetos de
751 ligadura de expresión se crean por: el grabador Slur»). Así pues, las
752 ligaduras de expresión se crean en cualquier contexto en el que se
753 encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
754 página del grabador @code{Slur_engraver}. Al final del todo, dice que
755 el grabador @code{Slur_engraver} es parte de siete contextos de voz,
756 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
757 suposición era acertada. Y a causa de que @code{Voice} es uno de los
758 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
759 por el hecho de que estamos escribiendo notas, podemos omitirlo en
762 @subsubsubheading Sobreescritura por una sola vez
764 @cindex sobreescritura por una sola vez
765 @cindex once override
770 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
771 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
772 ligadura fuese más gruesa? Esto se consigue con la instrucción o
773 prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
774 @code{\override} ocasiona que solamente cambie la ligadura que
775 comienza en la nota @strong{inmediata siguiente}. Si la nota
776 inmediata siguiente no da inicio a una ligadura, la instrucción no
777 tiene ningún efecto en absoluto: no se recuerda hasta que se
778 encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
779 la instrucción que lleva @code{\once} se debe reposicionar de la forma
782 @cindex Slur, ejemplo de sobreescritura
783 @cindex thickness, propiedad, ejemplo
785 @lilypond[quote,verbatim]
791 % Increase thickness of immediately following slur only
792 \once \override Slur.thickness = #5.0
794 g8[( es]) es d[( f]) as |
798 The man who | feels love's sweet e -- | mo -- tion
804 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
806 La instrucción o prefijo @code{\once} también se puede usar antes de
807 la instrucción @code{\set}.
809 @subsubsubheading Recuperación del ajuste
812 @cindex predeterminadas, recuperar las propiedades
817 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
818 fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
819 una de ellas precedida por el prefijo @code{\once}, situadas
820 inmediatamente antes de cada una de las notas en que comienzan las
823 @cindex Slur, ejemplo de sobreescritura
824 @cindex thickness, propiedad, ejemplo
826 @lilypond[quote,verbatim]
832 % Increase thickness of immediately following slur only
833 \once \override Slur.thickness = #5.0
835 % Increase thickness of immediately following slur only
836 \once \override Slur.thickness = #5.0
837 g8[( es]) es d[( f]) as |
841 The man who | feels love's sweet e -- | mo -- tion
847 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
848 instrucción @code{\revert} (restablecer) para devolver la propiedad
849 del grosor, @code{thickness}, a su valor predeterminado después de la
852 @cindex Slur, ejemplo de sobreescritura
853 @cindex thickness, propiedad, ejemplo
855 @lilypond[quote,verbatim]
861 % Increase thickness of all following slurs from 1.2 to 5.0
862 \override Slur.thickness = #5.0
865 % Revert thickness of all following slurs to default of 1.2
866 \revert Slur.thickness
871 The man who | feels love's sweet e -- | mo -- tion
877 la instrucción @code{\revert} se puede utilizar para devolver
878 cualquier propiedad que se haya cambiado con @code{\override} a su
879 valor predeterminado. Puede utilizar el método que mejor se adapte a
880 aquello que quiere hacer.
882 Así finaliza nuestra introducción al manual de RFI, y el método básico
883 de trucaje. A continuación, en las últimas secciones de este capítulo
884 encontrará varios ejemplos, en parte para introducirle en algunas de
885 las posibilidades adicionales del manual RFI, y en parte para
886 proporcionarle más práctica en cómo extraer información de él. Estos
887 ejemplos irán conteniendo cada vez menos palabras de guía y
890 @node Propiedades de los interfaces
891 @subsection Propiedades de los interfaces
892 @translationof Properties found in interfaces
895 @cindex propiedades de los interfaces
896 @cindex interfaces, propiedades
898 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
899 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
900 En primer lugar miramos en la página del RFI que relaciona todos los
901 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
902 pueda controlar la letra de la canción. Encontramos @code{LyricText},
903 que parece adecuado. Al seguir este enlace se presentan las
904 propiedades ajustables para el texto de la letra. Estos incluyen
905 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
906 una forma cursiva. Esto es porque la propiedad de la forma es común a
907 todos los objetos de fuente tipográfica, y por tanto, en vez de
908 incluirlo en cada uno de los objetos de presentación, se agrupa junto
909 con otras propiedades comunes similares y se deposita en un
910 @strong{Interface}, el interface de las fuentes tipográficas
911 @code{font-interface}.
913 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
914 de los interfaces, y descubrir qué objetos usan estas propiedades de
917 Mire de nuevo la página del RFI que describe a LyricText. Al final de
918 la página hay una lista de enlaces a los interfaces que LyricText
919 contempla. La lista tiene siete elementos, entre ellos
920 @code{font-interface}. Al seguir este enlace llegamos a las
921 propiedades asociadas con este interface, que también son propiedades
922 de todos los objetos que lo llevan, entre ellos LyricText.
924 Ahora vemos todas las propiedades ajustables por el usuario que
925 controlan las tipografías, entre ellas @code{font-shape(symbol)},
926 donde @code{symbol} se puede establecer a @code{upright} (recta),
927 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
929 Observará que @code{font-series} y @code{font-size} también se
930 encuentran aquí relacionadas. Esto inmediatamente hace que surja la
931 pregunta: ¿Por qué están las propiedades comunes de tipografía
932 @code{font-series} y @code{font-size} relacionadas bajo
933 @code{LyricText} así como bajo el interface @code{font-interface} pero
934 @code{font-shape} no lo está? La respuesta es que @code{font-series}
935 y @code{font-size} se cambian a partir de sus valores predeterminados
936 globales cuando se crea un objeto @code{LyricText}, pero
937 @code{font-shape} no lo hace. Entonces los elementos de la lista
938 @code{LyricText} le dicen los valores para esas dos propiedades que
939 son de aplicación para @code{LyricText}. Otros objetos que contemplan
940 @code{font-interface} establecerán dichas propiedades de forma
941 diferente cuando se crean.
943 Veamos si ahora podemos construir la instrucción @code{\override} para
944 cambiar la letra a cursiva. El objeto es @code{LyricText}, la
945 propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
946 antes, omitiremos el contexto.
948 Como nota aparte, aunque es importante, observe que ciertas
949 propiedades toman valores que son símbolos, como @code{italic}, y
950 deben ir precedidos de un apóstrofo, @code{'}. Los símbolos se
951 leen a continuación internamente por parte de LilyPond. Tenga en
952 cuenta la diferencia con las cadenas de texto arbitrarias, que
953 aparecerían como @code{"una cadena de texto"}; para ver más
954 detalles sobre los símbolos y las cadenas, consulte
955 @rextend{Tutorial de Scheme}.
957 Así pues, la instrucción @code{\override} necesaria para imprimir la
958 letra en cursiva, es:
961 \override LyricText.font-shape = #'italic
965 Esto debe escribirse justo delante de la letra a la que debe afectar,
968 @cindex font-shape, propiedad, ejemplo
969 @cindex italic, ejemplo
970 @cindex LyricText, ejemplo de sobreescritura
971 @cindex @code{\addlyrics}, ejemplo
973 @lilypond[quote,ragged-right,verbatim]
978 r4 bes'8 bes[( g]) g |
979 g8[( es]) es d[( f]) as |
983 \override LyricText.font-shape = #'italic
984 The man who | feels love's sweet e -- | mo -- tion
990 y toda la letra se imprime en cursiva.
992 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
993 final y la llave de cierre.}
998 @rextend{Tutorial de Scheme}.
1001 @node Tipos de propiedades
1002 @subsection Tipos de propiedades
1003 @translationof Types of properties
1005 @cindex propiedades, tipos de
1007 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
1008 @code{símbolo}. Para que sea válido, el valor que se da a una
1009 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
1010 tipo. El tipo de la propiedad se muestra siempre entre paréntesis
1011 después del nombre de la propiedad en el RFI. He aquí una lista de
1012 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
1013 algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
1014 @code{#}, por supuesto, delante de estos valores cuando se introducen
1015 en la instrucción @code{\override}, incluso si el propio valor ya
1016 comienza por@tie{}@code{#}. Solamente ofrecemos aquí ejemplos para
1017 constantes; si quiere calcular un valor usando Scheme, consulte
1018 @rextend{Cálculos en Scheme}.
1020 @multitable @columnfractions .2 .45 .35
1021 @headitem Tipo de propiedad
1025 @tab Verdadero o Falso, representado por #t o #f
1026 @tab @code{#t}, @code{#f}
1027 @item Dimensión (en espacios de pentagrama)
1028 @tab Un número decimal (en unidades de espacios de pentagrama)
1029 @tab @code{2.5}, @code{0.34}
1031 @tab Una constante válida de dirección o su equivalente numérico
1032 (@code{0} o @code{CENTER} indican una dirección neutra)
1033 @tab @code{LEFT}, @code{CENTER}, @code{UP},
1034 @code{1}, @w{@code{-1}}
1036 @tab Un número entero positivo
1037 @tab @code{3}, @code{-1}
1039 @tab Una secuencia de constantes o símbolos separados por espacios,
1040 encerrado entre paréntesis
1041 y precedido de un apóstrofo o comilla simple
1042 @tab @code{'(left-edge staff-bar)}, @code{'(1)}, @code{'()},
1043 @code{'(1.0 0.25 0.5)}
1045 @tab Cualquier elemento válido de marcado de texto
1046 @tab @code{\markup @{ \italic "cresc." @}}, @code{"gaita"}
1048 @tab Una fracción de redonda construida con la función make-moment
1049 @tab @code{(ly:make-moment 1/4)},
1050 @code{(ly:make-moment 3/8)}
1052 @tab Cualquier valor positivo o negativo, posiblemente decimal
1053 @tab @code{3}, @w{@code{-2.45}}
1054 @item Pareja (de números)
1055 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
1056 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
1058 @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
1059 @tab @code{'italic}, @code{'inside}
1061 @tab Un procedimiento o @code{#f} para no producir ninguna acción
1062 @tab @code{bend::print}, @code{ly:text-interface::print},
1066 encerradas entre @code{#(}@dots{}@code{)}.
1067 @tab @code{#(#t #t #f)}
1072 Manual de Extensión:
1073 @rextend{Tutorial de Scheme}.
1076 @node Apariencia de los objetos
1077 @section Apariencia de los objetos
1078 @translationof Appearance of objects
1080 Ahora vamos a poner en práctica lo que hemos aprendido con unos
1081 cuantos ejemplos que muestran cómo se pueden usar los trucos para
1082 cambiar el aspecto de la música impresa.
1085 * Visibilidad y color de los objetos::
1086 * Tamaño de los objetos::
1087 * Longitud y grosor de los objetos::
1090 @node Visibilidad y color de los objetos
1091 @subsection Visibilidad y color de los objetos
1092 @translationof Visibility and color of objects
1094 Dentro de un uso educativo de la música, podríamos desear imprimir una
1095 partitura con ciertos elementos omitidos como ejercicio para el
1096 alumno, a quien se le pide que los complete. A la manera de ejemplo
1097 sencillo, supongamos que el ejercicio es escribir las líneas
1098 divisorias que faltan en un fragmento musical. Pero las líneas
1099 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
1102 Antes de enredarnos con esto, recordemos que las propiedades de los
1103 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
1104 @ref{Propiedades de los interfaces}). Esto es simplemente agrupar
1105 las propiedades que se pueden usar juntas para trucar un objeto
1106 gráfico: si una de ellas se necesita para un objeto, también las
1107 otras. Así, ciertos objetos usan las propiedades de algunos
1108 interfaces, otros usan las de otros interfaces. Los interfaces que
1109 contienen las propiedades que un determinado grob necesita se
1110 encuentran relacionadas en el manual RFI al final de la página que
1111 describe dicho grob, y esas propiedades se pueden ver mirando dichos
1114 Hemos explicado cómo encontrar información sobre los grobs en
1115 @ref{Propiedades de los objetos de presentación}. Usando el mismo
1116 enfoque, vamos al RFI para buscar el objeto de presentación que
1117 imprime las líneas divisorias. A través del enlace @emph{Backend} y
1118 @emph{All layout objects} encontramos que hay un objeto de
1119 presentación llamado @code{BarLine}. Entre sus propiedades se
1120 encuentran dos que controlan la visibilidad: @code{break-visibility} y
1121 @code{stencil}. Las líneas divisorias también contemplan un número de
1122 interfaces, entre ellos el @code{grob-interface}, donde podemos
1123 encontrar las propiedades @code{transparent} y @code{color}. Todas
1124 ellas pueden afectar la visibilidad de las barras de compás (y, por
1125 supuesto, por extensión, también la de muchos otros objetos de
1126 presentación). Vamos a considerar cada uno de ellos por orden.
1129 * La propiedad stencil (sello)::
1130 * La propiedad break-visibility (visibilidad en el salto)::
1131 * La propiedad transparent (transparente)::
1132 * La propiedad color::
1135 @node La propiedad stencil (sello)
1136 @unnumberedsubsubsec La propiedad @code{stencil} (sello)
1137 @translationof The stencil property
1139 @cindex stencil (sello), propiedad
1141 Esta propiedad controla la apariencia de las barras de compás mediante
1142 la especificación del símbolo (o «glifo») que se debe imprimir. Igual
1143 que como otras muchas propiedades, se puede establecer de forma que no
1144 imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
1145 antes, omitiendo el Contexto implícito, @code{Voice}:
1147 @cindex BarLine, ejemplo de sobreescritura
1148 @cindex stencil, propiedad, ejemplo
1150 @lilypond[quote,ragged-right,verbatim]
1153 \override BarLine.stencil = ##f
1154 c''4 b8 c d16 c d8 |
1155 g,8 a16 b8 c d4 e16 |
1160 Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
1161 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
1162 objeto BarLine. Al principio de la página dice @qq{Barline objects
1163 are created by: Bar_engraver} (los objetos Barline se crean por el
1164 grabador Bar_engraver). Vaya a la página del grabador
1165 @code{Bar_engraver} siguiendo el enlace. Al final da una lista de
1166 contextos en los que el grabador de líneas divisorias opera. Todos
1167 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
1168 @code{\override} no funcionara como esperábamos, es porque
1169 @code{Barline} no se encuentra en el contexto predeterminado
1170 @code{Voice}. Si el contexto no se especifica correctamente, la
1171 instrucción simplemente no funciona. No se produce ningún mensaje de
1172 error, y no se registra nada en el archivo log de registro. Vamos a
1173 intentar corregirlo escribiendo el contexto correcto:
1175 @cindex BarLine, ejemplo de sobreescritura
1176 @cindex stencil, propiedad, ejemplo
1178 @lilypond[quote,ragged-right,verbatim]
1181 \override Staff.BarLine.stencil = ##f
1182 c''4 b8 c d16 c d8 |
1183 g,8 a16 b8 c d4 e16 |
1188 Ahora las barras de compás han desaparecido. La operación de
1189 fijar la propiedad @code{stencil} al valor @code{#f} es tan
1190 frecuente que existe una abreviatura para ella, llamada
1191 @code{\omit} (omitir):
1194 @lilypond[quote,ragged-right,verbatim]
1198 c''4 b8 c d16 c d8 |
1199 g,8 a16 b8 c d4 e16 |
1204 Sin embargo, observe que el establecimiento de la propiedad
1205 @code{stencil} al valor @code{#f} produce errores cuando las se
1206 requieren las dimensiones del objeto para un procesamiento correcto.
1207 Por ejemplo, se generan errores si la propiedad @code{stencil} del
1208 objeto @code{NoteHead} se establece al valor @code{#f}. Si es el
1209 caso, podemos en vez de ello utilizar la función @code{point-stencil},
1210 que establece el sello a un objeto con tamaño nulo:
1212 @lilypond[quote,verbatim]
1215 \once \override NoteHead.stencil = #point-stencil
1220 @node La propiedad break-visibility (visibilidad en el salto)
1221 @unnumberedsubsubsec The @code{break-visibility} (visibilidad en el salto)
1222 @translationof The break-visibility property
1224 @cindex break-visibility, propiedad
1226 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI
1227 que la propiedad @code{break-visibility} requiere un vector de
1228 tres valores booleanos. Controlan respectivamente si las barras
1229 de compás se imprimen al final de una línea, en mitad de una
1230 línea, y al principio de las líneas. Para nuestro ejemplo,
1231 queremos que todas las barras de compás se supriman, por lo que el
1232 valor que necesitamos es @code{#(#f #f #f)} (disponible también
1233 bajo el nombre @code{all-invisible}, todas invisibles). Vamos a
1234 probarlo, recordando incluir el contexto de @code{Staff}. Observe
1235 también que al escribir este valor tenemos @code{##} antes del
1236 paréntesis de apertura. Se necesita un @code{#} como parte de la
1237 sintaxis de las contantes vectoriales, y el primer símbolo de
1238 almohadilla@tie{}@code{#} se necesita, como siempre, para preceder
1239 el valor en sí dentro de la instrucción @code{\override}.
1241 @cindex BarLine, ejemplo de sobreescritura
1242 @cindex break-visibility, propiedad, ejemplo
1244 @lilypond[quote,ragged-right,verbatim]
1247 \override Staff.BarLine.break-visibility = ##(#f #f #f)
1248 c''4 b8 c d16 c d8 |
1249 g,8 a16 b8 c d4 e16 |
1254 Y podemos ver que esto también quita todas las líneas divisorias.
1256 @node La propiedad transparent (transparente)
1257 @unnumberedsubsubsec La propiedad @code{transparent} (transparente)
1258 @translationof The transparent property
1260 @cindex transparent, propiedad
1261 @cindex transparencia
1263 En la relación de propiedades que se especifican en la página del
1264 @code{grob-interface} del RFI podemos ver que la propiedad
1265 @code{transparent} es un valor booleano. Esto se debe establecer a
1266 @code{#t} para hacer que el grob sea transparente. En el ejemplo
1267 siguiente vamos a hacer que la indicación de compás, y no las líneas
1268 divisorias, sea transparente. Para hacerlo tenemos que buscar el
1269 nombre del grob de la indicación de compás. Volviendo a la página
1270 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1271 presentación @code{TimeSignature}. Se produce por parte del grabador
1272 @code{Time_signature_engraver} que como puede comprobar vive dentro
1273 del contexto de @code{Staff} y también contempla el interface
1274 @code{grob-interface}. Así pues, la instrucción que hace transparente
1275 a la indicación de compás es:
1277 @cindex TimeSignature, ejemplo de sobreescritura
1278 @cindex transparent, propiedad, ejemplo
1280 @lilypond[quote,ragged-right,verbatim]
1283 \override Staff.TimeSignature.transparent = ##t
1284 c''4 b8 c d16 c d8 |
1285 g,8 a16 b8 c d4 e16 |
1291 Una vez más, el establecimiento de la propiedad @code{transparent}
1292 es una operación bastante frecuente, de modo que tenemos una
1293 abreviatura llamada @code{\hide} (ocultar):
1296 @lilypond[quote,ragged-right,verbatim]
1299 \hide Staff.TimeSignature
1300 c''4 b8 c d16 c d8 |
1301 g,8 a16 b8 c d4 e16 |
1307 En ninguno de los dos casos aparece ya la indicación de compás,
1308 pero esta instrucción deja una separación en el lugar donde antes
1309 estaba la indicación de compás. Quizá esto es lo que queremos
1310 para un ejercicio en que el alumno deba escribirlo, pero en otras
1311 circunstancias esta separación podría no ser deseable. En vez de
1312 eso, para quitarla, el stencil o «sello» de la indicación de
1313 compás se debe establecer al valor @code{#f}:
1315 @cindex TimeSignature, ejemplo de sobreescritura
1316 @cindex stencil, propiedad, ejemplo
1318 @lilypond[quote,ragged-right,verbatim]
1321 \omit Staff.TimeSignature
1322 c''4 b8 c d16 c d8 |
1323 g,8 a16 b8 c d4 e16 |
1329 y la diferencia es obvia: al establecer el sello al valor
1330 @code{#f} (posiblemente por medio de @code{\omit}) quitamos el
1331 objeto por completo; al hacer el objeto @code{transparent} (lo que
1332 puede hacerse utilizando @code{\hide}) lo dejamos donde está, pero
1333 lo hacemos invisible.
1335 @node La propiedad color
1336 @unnumberedsubsubsec La propiedad @code{color}
1337 @translationof The color property
1339 @cindex color, propiedad
1341 Para finalizar, intentemos hacer invisibles las barras de compás
1342 pintándolas de color blanco (hay un problema relacionado, que consiste
1343 en que la línea divisoria blanca puede tapar o no tapar las líneas del
1344 pentagrama a las que cruza. Podrá observar en algunos de los ejemplos
1345 que aparecen a continuación, que esto sucede de forma impredecible.
1346 Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
1347 estudian en @ruser{Pintar los objetos de blanco}; de momento estamos
1348 estudiando el color, por lo que le rogamos que acepte esta limitación
1351 El interface @code{grob-interface} especifica que la propiedad del
1352 color es una lista, pero no hay ninguna explicación sobre lo que debe
1353 ir en esa lista. La lista que requiere es realmente una lista de
1354 valores en unidades internas, pero para evitar tener que saber cuáles
1355 son, se ofrecen varias vías para la especificación de los colores. La
1356 primera forma es utilizar uno de los colores @q{normales} que están
1357 relacionados en la primera tabla de la @ruser{Lista de colores}. Para
1358 poner las líneas divisorias de color blanco, escribimos:
1360 @cindex BarLine, ejemplo de sobreescritura
1361 @cindex color, propiedad, ejemplo
1363 @lilypond[quote,ragged-right,verbatim]
1366 \override Staff.BarLine.color = #white
1367 c''4 b8 c d16 c d8 |
1368 g,8 a16 b8 c d4 e16 |
1374 y de nuevo podemos comprobar que las barras de compás no son visibles.
1375 Observe que @emph{white} no viene precedido de un apóstrofo: no es un
1376 símbolo, sino una @emph{variable}. Cuando se evalúa, proporciona la
1377 lista de valores internos que se requieren para establecer el color a
1378 blanco. Los otros colores de la lista normal también son variables.
1379 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1380 una de las otras variables de la lista.
1382 @cindex colores de X11
1383 @cindex X11, colores de
1387 La segunda forma de cambiar el color es utilizar la lista de
1388 nombres de colores de X11 que aparecen en la segunda lista de
1389 @ruser{Lista de colores}. De todas formas, se hacen corresponder
1390 a los valores reales por medio de la función @code{x11-color} que
1391 convierte los símbolos de color de X11 en la lista de valores
1392 internos como éstos:
1394 @cindex BarLine, ejemplo de sobreescritura
1395 @cindex color, propiedad, ejemplo
1397 @lilypond[quote,ragged-right,verbatim]
1400 \override Staff.BarLine.color = #(x11-color 'white)
1401 c''4 b8 c d16 c d8 |
1402 g,8 a16 b8 c d4 e16 |
1408 Observe que en este caso la función @code{x11-color} toma un
1409 símbolo como argumento, así que el símbolo debe ir precedido de un
1410 apóstrofo para evitar que resulte evaluado como si fuera una
1411 variable, y toda la llamada a la función se debe encerrar entre
1414 @cindex rgb, colores
1419 Aún existe otra función, que convierte valores RGB en colores
1420 internos: la función @code{rgb-color}. Toma tres argumentos que dan
1421 las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
1422 valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
1423 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1424 @code{(rgb-color 1 1 1)}:
1426 @cindex BarLine, ejemplo de sobreescritura
1427 @cindex color, propiedad, ejemplo
1429 @lilypond[quote,ragged-right,verbatim]
1432 \override Staff.BarLine.color = #(rgb-color 1 1 1)
1433 c''4 b8 c d16 c d8 |
1434 g,8 a16 b8 c d4 e16 |
1439 Finalmente, existe también una escala de grises como parte del
1440 conjunto de colores de X11. Varían desde el negro, @code{'grey0},
1441 hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
1442 estableciendo todos los objetos de presentación de nuestro ejemplo a
1443 varias gradaciones de gris:
1445 @cindex StaffSymbol, ejemplo de sobreescritura
1446 @cindex TimeSignature, ejemplo de sobreescritura
1447 @cindex Clef, ejemplo de sobreescritura
1448 @cindex NoteHead, ejemplo de sobreescritura
1449 @cindex Stem, ejemplo de sobreescritura
1450 @cindex BarLine, ejemplo de sobreescritura
1451 @cindex color property, ejemplo
1452 @cindex x11-color, ejemplo de utilización
1454 @lilypond[quote,ragged-right,verbatim]
1457 \override Staff.StaffSymbol.color = #(x11-color 'grey30)
1458 \override Staff.TimeSignature.color = #(x11-color 'grey60)
1459 \override Staff.Clef.color = #(x11-color 'grey60)
1460 \override Voice.NoteHead.color = #(x11-color 'grey85)
1461 \override Voice.Stem.color = #(x11-color 'grey85)
1462 \override Staff.BarLine.color = #(x11-color 'grey10)
1463 c''4 b8 c d16 c d8 |
1464 g,8 a16 b8 c d4 e16 |
1470 Observe los contextos asociados con cada uno de los objetos de
1471 presentación. Es importante que estén correctamente escritos, o las
1472 instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
1473 que se encuentra el grabador correspondiente. El contesto
1474 predeterminado para los grabadores puede encontrarse empezando por el
1475 objeto de presentación, de ahí al grabador que lo produce, y en la
1476 página del grabador del RFI aparece en qué contexto se puede encontrar
1477 normalmente el grabador.
1480 @node Tamaño de los objetos
1481 @subsection Tamaño de los objetos
1482 @translationof Size of objects
1484 @cindex cambiar el tamaño de los objetos
1485 @cindex tamaño de los objetos
1486 @cindex objetos, tamaño de
1487 @cindex objetos, cambiar el tamaño de
1489 Empezaremos examinando de nuevo un ejemplo anterior (véase
1490 @ref{Anidado de expresiones musicales}) que nos mostraba cómo
1491 introducir un pentagrama temporal, como en un @rglos{ossia}.
1493 @cindex alignAboveContext, propiedad, ejemplo
1494 @cindex @code{\with}, ejemplo
1496 @lilypond[quote,ragged-right,verbatim]
1497 \new Staff ="main" {
1504 alignAboveContext = #"main" }
1512 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1513 por lo normal se imprimen más pequeños que el pentagrama principal.
1514 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1515 el sello de cada uno de ellos a @code{#f}, como sigue:
1517 @cindex alignAboveContext, propiedad, ejemplo
1518 @cindex @code{\with}, ejemplo
1520 @cindex Clef, ejemplo de sobreescritura
1521 @cindex TimeSignature, ejemplo de sobreescritura
1523 @lilypond[quote,ragged-right,verbatim]
1524 \new Staff ="main" {
1531 alignAboveContext = #"main"
1535 \omit Staff.TimeSignature
1545 donde el par de llaves adicional después de la cláusula @code{\with}
1546 es necesario para asegurar que la sobreescritura encerrada y la música
1547 se aplican al pentagrama de ossia.
1549 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1550 usando @code{\with} y modificar los sellos de clave y de compás con
1551 \override, o en este caso
1552 @code{\omit}? La diferencia principal es que los cambios que se realizan
1553 en una cláusula @code{\with} se hacen en el momento en que se crea el
1554 contexto, y permanecen activos como valores @strong{predeterminados}
1555 durante toda la duración de dicho contexto, mientras que las
1556 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1557 música son dinámicas: hacen cambios sincronizados con un punto
1558 concreto de la música. Si los cambios se deshacen o se devuelven
1559 mediante @code{\unset} o @code{\revert} volverán a su valor
1560 predeterminado que será el establecido en la cláusula @code{\with}, o
1561 si no se ha establecido ninguno en este lugar, los valores
1562 predeterminados normales.
1564 Ciertas propiedades de contexto se pueden modificar solamente dentro
1565 de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
1566 cambiar después de que el contexto se ha creado.
1567 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1568 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1569 alineación está decidida y no tendría sentido intentar cambiarla más
1572 Los valores predeterminados de las propiedades de los objetos de
1573 presentación también se pueden establecer dentro de cláusulas
1574 @code{\with}. Simplemente utilice la instrucción @code{\override}
1575 normal dejando aparte el nombre del contexto, ya que está definido sin
1576 ambigüedad como el contexto que la cláusula @code{\with} está
1577 modificando. De hecho, se producirá un error si se especifica un
1578 contexto en este lugar.
1580 Así pues, podemos reemplazar el ejemplo anterior con
1582 @cindex alignAboveContext, propiedad, ejemplo
1583 @cindex @code{\with}, example
1584 @cindex Clef, ejemplo de sobreescritura
1585 @cindex TimeSignature, ejemplo de sobreescritura
1587 @lilypond[quote,ragged-right,verbatim]
1588 \new Staff ="main" {
1595 alignAboveContext = #"main"
1596 % Don't print clefs in this staff
1597 \override Clef.stencil = ##f
1598 % Don't print time signatures in this staff
1599 \override TimeSignature.stencil = ##f
1608 Resulta que también podemos emplear aquí las abreviaturas
1609 @code{\hide} y @code{\omit} para fijar la propiedad
1610 @code{transparent} y borrar el @code{stencil}, lo que conduce al
1611 resultado siguiente:
1613 @lilypond[quote,ragged-right,verbatim]
1614 \new Staff ="main" {
1621 alignAboveContext = #"main"
1622 % Don't print clefs in this staff
1624 % Don't print time signatures in this staff
1634 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1637 Ciertos objetos de presentación se crean como glifos sacados de una
1638 fuente tipográfica. Entre ellos se encuentran las cabezas,
1639 alteraciones, elementos de marcado, claves, indicaciones de compás,
1640 indicaciones dinámicas y la letra de las canciones. Su tamaño se
1641 cambia mediante la modificación de la propiedad @code{font-size}, como
1642 veremos en breve. Otros objetos de presentación como ligaduras de
1643 unión y de expresión (en general, objetos de extensión) se trazan
1644 individualmente, por lo que no hay un tamaño de tipografía
1645 @code{font-size} asociado a ellos. Estos objetos generalmente derivan
1646 su tamaño de los objetos a los que están adosados, y por ello
1647 normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
1648 otras propiedades como la longitud de las plicas y las barras de
1649 compás, el grosor de las barras de corchea y otras líneas, y la
1650 separación de las líneas del pentagrama se deben modificar de otras
1653 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1654 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1655 cambiar el tamaño de las tipografías de cada uno de los tipos de
1656 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1659 \override NoteHead.font-size = #-2
1662 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1663 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1664 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1671 Los dos enunciados producirían una reducción del tamaño de la
1672 tipografía en dos pasos a partir de su valor previo, donde cada paso
1673 reduce o aumenta el tamaño aproximadamente en un 12%.
1675 Vamos a probarlo en nuestro ejemplo del ossia:
1677 @cindex alignAboveContext, propiedad, ejemplo
1678 @cindex @code{\with}, ejemplo
1679 @cindex Clef, ejemplo de sobreescritura
1680 @cindex TimeSignature, ejemplo de sobreescritura
1681 @cindex fontSize, propiedad, ejemplo
1683 @lilypond[quote,ragged-right,verbatim]
1684 \new Staff ="main" {
1691 alignAboveContext = #"main"
1694 % Reduce all font sizes by ~24%
1704 Aún no está demasiado bien. Las cabezas y los corchetes de las notas
1705 son más pequeños, pero las plicas son demasiado largas en proporción,
1706 y las líneas del pentagrama están demasiado separadas entre sí. Se
1707 debe reducir su escala en proporción a la reducción de la tipografía.
1708 El siguiente apartado trata sobre cómo se hace esto.
1710 @node Longitud y grosor de los objetos
1711 @subsection Longitud y grosor de los objetos
1712 @translationof Length and thickness of objects
1718 @cindex tamaño, cambiar
1719 @cindex plica, cambiar la longitud
1720 @cindex pentagrama, cambiar la separación de las líneas
1722 Las distancias y longitudes en LilyPond se miden generalmente en
1723 espacios de pentagrama, la distancia entre líneas adyacentes de la
1724 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1725 de las propiedades de @code{thickness} (grosor) se miden en unidades
1726 de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
1727 de forma predeterminada, a las líneas de los reguladores se les da un
1728 grosor de 1 unidad de @code{line-thickness}, mientras que el
1729 @code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
1730 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1731 barras de corchea se controla por medio del valor de
1732 @code{beam-thickness}, que se mide en espacios de pentagrama.
1734 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1735 tamaño de la tipografía? Se puede hacer con la ayuda de una función
1736 especial que se llama @code{magstep}, pensada especialmente para este
1737 propósito. Toma un argumento, el cambio de tamaño de la tipografía
1738 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1739 para reducir otros objetos en la misma proporción. Se usa de la
1742 @cindex alignAboveContext, propiedad, ejemplo
1743 @cindex @code{\with}, ejemplo
1744 @cindex Clef, ejemplo de sobreescritura
1745 @cindex TimeSignature, ejemplo de sobreescritura
1746 @cindex fontSize, propiedad, ejemplo
1747 @cindex StaffSymbol, ejemplo de sobreescritura
1748 @cindex magstep, función, ejemplo de utilización
1749 @cindex staff-space, propiedad, ejemplo
1750 @cindex stencil, propiedad, ejemplo
1752 @lilypond[quote,ragged-right,verbatim]
1753 \new Staff ="main" {
1760 alignAboveContext = #"main"
1764 % Reduce stem length and line spacing to match
1765 \override StaffSymbol.staff-space = #(magstep -2)
1775 Puesto que la longitud de las plicas y muchas otras propiedades
1776 relacionadas con la longitudes calculan siempre con relación al valor
1777 de la propiedad @code{staff-space}, su longitud también ve reducida su
1778 escala automáticamente. Observe que esto afecta solamente a la escala
1779 vertical del ossia: la escala horizontal se determina por medio de la
1780 disposición de la música principal con el objeto de mantenerse en
1781 sincronía con ella, de forma que no resulte afectada por ninguno de
1782 estos cambios de tamaño. Por supuesto, si la escala de toda la música
1783 principal se cambiase de esta forma, entonces el espaciado horizontal
1784 se vería afectado. Trataremos de esto más tarde en la sección sobre
1787 Esto, en fin, completa la creación de un ossia. Los tamaños y
1788 longitudes del resto de los objetos se pueden modificar de manera
1791 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1792 grosor de las diversas líneas dibujadas como divisorias, barras de
1793 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1794 ajuste global. Si el grosor de cualquier objeto de presentación en
1795 particular necesita ajustarse, se puede hacer mejor mediante la
1796 sobreescritura de su propiedad @code{thickness}. Anteriormente
1797 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1798 @ref{Propiedades de los objetos de presentación}. El grosor de todos los objetos
1799 trazados (es decir, aquellos que no se producen a partir de una
1800 tipografía) se pueden cambiar de la misma forma.
1803 @node Colocación de los objetos
1804 @section Colocación de los objetos
1805 @translationof Placement of objects
1808 * Comportamiento automático::
1809 * Objetos interiores al pentagrama::
1810 * Objetos fuera del pentagrama::
1814 @node Comportamiento automático
1815 @subsection Comportamiento automático
1816 @translationof Automatic behavior
1818 @cindex dentro del pentagrama, objetos
1819 @cindex fuera del pentagrama, objetos
1820 @cindex objetos dentro del pentagrama
1821 @cindex objetos fuera del pentagrama
1823 Hay ciertos objetos en notación musical que pertenecen al pentagrama y
1824 otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
1825 objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
1828 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1829 pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
1830 se fijan por la propia música; se posicionan verticalmente sobre
1831 líneas específicas del pentagrama o están unidos a otros objetos
1832 posicionados de esta forma. Las colisiones entre cabezas, plicas y
1833 alteraciones en acordes de notas muy juntas, normalmente se evitan
1834 automáticamente. Hay instrucciones y sobreescrituras que pueden
1835 modificar este comportamiento automático, como veremos en breve.
1837 Entre los objetos que pertenecen al exterior de la pauta se encuentran
1838 cosas como las marcas de ensayo, las marcas de texto y las de
1839 dinámica. La regla de LilyPond para la colocación vertical de los
1840 objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
1841 como sea posible, pero no tan cerca como para que puedan chocar con
1842 algún otro objeto. LilyPond utiliza la propiedad
1843 @code{outside-staff-priority} para determinar el orden en que se deben
1844 situar los objetos, como veremos ahora.
1846 En primer lugar, LilyPond sitúa todos los objetos
1847 dentro-del-pentagrama. Después ordena los objetos
1848 fuera-del-pentagrama de acuerdo con su prioridad
1849 @code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
1850 toman de uno en uno, comenzando por el que tiene la prioridad
1851 @code{outside-staff-priority} más baja, y se sitúan de forma que no
1852 colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
1853 grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
1854 la prioridad @code{outside-staff-priority} más baja se colocará más
1855 cerca del pentagrama. Si dos objetos tienen la misma
1856 @code{outside-staff-priority}, el que se ha encontrado primero se
1857 situará más cerca de la pauta.
1859 En el siguiente ejemplo, todos los textos de marcado tienen la misma
1860 prioridad (pues no se ha establecido explícitamente). Observe que
1861 @q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
1862 acomodado por debajo de @q{Text2}.
1864 @cindex markup, ejemplo
1866 @lilypond[quote,fragment,ragged-right,verbatim]
1873 Los pentagramas también se posicionan, de forma predeterminada, tan
1874 cerca unos de otros como sea posible (sujeto a una separación mínima).
1875 Si las notas se proyectan muy lejos en dirección a un pentagrama
1876 adyacente, forzarán a alejarse a los pentagramas sólo si en caso
1877 contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
1878 siguiente muestra esta acomodación @q{nestling} de las notas sobre
1879 pentagramas adyacentes:
1881 @lilypond[quote,ragged-right,verbatim]
1884 \relative { c'4 a, }
1887 \relative { c''''4 a, }
1893 @node Objetos interiores al pentagrama
1894 @subsection Objetos interiores al pentagrama
1895 @translationof Within-staff objects
1897 Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la
1898 dirección de las ligaduras de expresión y de unión, digitaciones y
1899 todo lo demás que dependa de la dirección de las plicas (véase
1900 @ref{Voces explícitas}). Cuando se
1901 escribe música polifónica, estas instrucciones son esenciales para que
1902 puedan distinguirse varias líneas melódicas entrelazadas. Pero
1903 ocasionalmente puede ser necesario sobreescribir este comportamiento
1904 automático. Se puede hacer por secciones de música completas o
1905 incluso para una nota individual. La propiedad que controla este
1906 comportamiento es la propiedad de @code{direction} (dirección) de cada
1907 objeto de presentación. En primer lugar explicaremos qué hace esto, y
1908 luego introduciremos algunas instrucciones listas para usar que le
1909 evitarán tener que codificar sobreescrituras explícitas para las
1910 modificaciones más comunes.
1912 Algunos objetos de presentación como las ligaduras se curvan hacia
1913 arriba o hacia abajo; otros como las plicas y los corchetes también se
1914 mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
1915 hacia abajo. Esto se controla automáticamente cuando está establecida
1916 la propiedad @code{direction}.
1919 * La propiedad direction (dirección)::
1923 @node La propiedad direction (dirección)
1924 @unnumberedsubsubsec La propiedad @code{direction} (dirección)
1925 @translationof The direction property
1936 El ejemplo siguiente muestra en el compás 1 el comportamiento
1937 predeterminado de las plicas, con las de las notas agudas apuntando
1938 hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
1939 todas las plicas forzadas hacia abajo, cuatro notas con las plicas
1940 forzadas hacia arriba, y por último cuatro notas devueltas al
1941 comportamiento predeterminado.
1943 @cindex Stem, ejemplo de sobreescritura
1944 @cindex direction, propiedad, ejemplo
1946 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1948 \override Stem.direction = #DOWN
1950 \override Stem.direction = #UP
1952 \revert Stem.direction
1956 Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
1957 (arriba). Éstos tienen los valores @w{@code{-1}} y @code{+1}
1958 respectivamente, y dichos valores numéricos también se pueden usar
1959 directamente. El valor @code{0} también se puede usar en algunos
1960 casos. Se trata simplemente con el significado de @code{UP} para las
1961 plicas, pero para algunos objetos tiene el significado de
1962 @q{centrado}. Existe una constante @code{CENTER} que tiene el valor
1965 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
1966 están disponibles instrucciones predefinidas equivalentes más
1967 sencillas. Aquí podemos ver una tabla de las más comunes. Se
1968 menciona el significado de cada una allí donde no es obvio.
1970 @multitable @columnfractions .2 .2 .25 .35
1971 @headitem Abajo o Izquierda
1972 @tab Arriba o Derecha
1975 @item @code{\arpeggioArrowDown}
1976 @tab @code{\arpeggioArrowUp}
1977 @tab @code{\arpeggioNormal}
1978 @tab La flecha está abajo, arriba o no hay flecha
1979 @item @code{\dotsDown}
1981 @tab @code{\dotsNeutral}
1982 @tab Dirección del desplazamiento para evitar las líneas del pentagrama
1983 @item @code{\dynamicDown}
1984 @tab @code{\dynamicUp}
1985 @tab @code{\dynamicNeutral}
1987 @item @code{\phrasingSlurDown}
1988 @tab @code{\phrasingSlurUp}
1989 @tab @code{\phrasingSlurNeutral}
1990 @tab Nota: diferente de las instrucciones de ligaduras de expresión
1991 @item @code{\slurDown}
1993 @tab @code{\slurNeutral}
1995 @item @code{\stemDown}
1997 @tab @code{\stemNeutral}
1999 @item @code{\textSpannerDown}
2000 @tab @code{\textSpannerUp}
2001 @tab @code{\textSpannerNeutral}
2002 @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
2003 @item @code{\tieDown}
2005 @tab @code{\tieNeutral}
2007 @item @code{\tupletDown}
2008 @tab @code{\tupletUp}
2009 @tab @code{\tupletNeutral}
2010 @tab Los grupos especiales están debajo o encima de las notas
2013 Las variantes neutras o normales de estas instrucciones están
2014 implementadas usando @code{\revert} y @strong{no} pueden ir
2015 precedidas de @code{\once}. Si quiere limitar el efecto de las
2016 otras instrucciones (que están implementadas usando
2017 @code{\override}) a un solo paso de tiempo, puede precederla de
2018 @code{\once} de la misma forma en que lo haría con las
2019 sobreescrituras explícitas.
2022 @unnumberedsubsubsec Digitaciones
2023 @translationof Fingering
2025 @cindex digitación, colocación
2026 @cindex digitación de acordes
2028 La colocación de las digitaciones sobre notas sueltas también se puede
2029 controlar mediante la propiedad @code{direction}, pero los cambios
2030 sobre @code{direction} no tienen ningún efecto sobre las notas de los
2031 acordes. Como veremos, existen instrucciones especiales que permiten
2032 controlar las digitaciones de notas individuales, situando la
2033 digitación encima, debajo, a la izquierda o a la derecha de cada nota.
2035 En primer lugar, he aquí el efecto de @code{direction} sobre las
2036 digitaciones aplicadas a notas sueltas. Se muestra en el primer
2037 compás el comportamiento predeterminado, y en los dos compases
2038 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
2040 @cindex Fingering, ejemplo de sobreescritura
2041 @cindex direction, propiedad, ejemplo
2043 @lilypond[quote,verbatim]
2045 c''4-5 a-3 f-1 c'-5 |
2046 \override Fingering.direction = #DOWN
2048 \override Fingering.direction = #UP
2053 Sin embargo, la sobreescritura de la propiedad @code{direction} no es
2054 la forma más sencilla de especificar manualmente la digitación por
2055 encima o por debajo de las notas; suele ser preferible usar @code{_} o
2056 @code{^} en lugar de @code{-}, antes del número de la digitación.
2057 Este es el ejemplo anterior utilizando este método:
2059 @cindex fingering, ejemplo
2060 @cindex digitación, ejemplo
2062 @lilypond[quote,verbatim]
2064 c''4-5 a-3 f-1 c'-5 |
2070 La propiedad @code{direction} se ignora para los acordes, pero los
2071 prefijos direccionales @code{_} y @code{^} sí funcionan. De forma
2072 predeterminada, las digitaciones se colocan automáticamente encima y
2073 debajo de las notas de un acorde, como se muestra aquí:
2075 @cindex fingering, ejemplo
2076 @cindex digitación, ejemplo
2078 @lilypond[quote,verbatim]
2087 pero se puede forzar de manera que todos o algunos de los números de
2088 digitación estén por encima o por debajo:
2090 @cindex fingering, ejemplo
2091 @cindex digitación, ejemplo
2093 @lilypond[quote,verbatim]
2095 <c''-5 g-3 e-2 c-1>4
2101 Es posible ejercer un control aún mayor sobre la colocación de las
2102 digitaciones mediante la utilización de la instrucción @code{\set
2103 fingeringOrientations}. El formato de esta instrucción es:
2106 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
2110 se utiliza @code{\set} porque @code{fingeringOrientations} es una
2111 propiedad del contexto @code{Voice}, creado y usado por el grabador
2112 @code{New_fingering_engraver}.
2114 La propiedad se puede establecer al valor de una lista de entre uno y
2115 tres valores. Controla si las digitaciones se pueden colocar por
2116 encima (si @code{up} aparece en la lista), por debajo (si aparece
2117 @code{down}), a la izquierda (si aparece @code{left}) o a la derecha
2118 (si aparece @code{right}). A la inversa, si una colocación no está en
2119 la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
2120 coma estas restricciones y se trabaja la mejor colocación para la
2121 digitación de las notas de los acordes que siguen. Observe que
2122 @code{left} y @code{right} son mutuamente excluyentes: las
2123 digitaciones pueden situarse en un lado o en el otro, no en los dos.
2125 @warning{Para controlar la colocación de la digitación de una sola
2126 nota usando esta instrucción es necesario escribirla como un acorde de
2127 una sola nota encerrándola entre ángulos simples.}
2129 Aquí podemos ver algunos ejemplos:
2131 @cindex fingering, ejemplo
2132 @cindex digitación, ejemplo
2133 @cindex @code{\set}, ejemplo de utilización
2134 @cindex fingeringOrientations, propiedad, ejemplo
2136 @lilypond[quote,ragged-right,verbatim]
2138 \set fingeringOrientations = #'(left)
2141 \set fingeringOrientations = #'(left)
2143 <c-1 e-2 g-3 b-5>4 |
2144 \set fingeringOrientations = #'(up left down)
2147 \set fingeringOrientations = #'(up left)
2149 <c-1 e-2 g-3 b-5>4 |
2150 \set fingeringOrientations = #'(right)
2157 Si la digitación parece un poco superpoblada, se puede reducir el
2158 tamaño @code{font-size}. El valor predeterminado puede verse en el
2159 objeto @code{Fingering} del RFI que es @w{@code{-5}}, así que probaremos
2162 @lilypond[quote,ragged-right,verbatim]
2164 \override Fingering.font-size = #-7
2165 \set fingeringOrientations = #'(left)
2168 \set fingeringOrientations = #'(left)
2170 <c-1 e-2 g-3 b-5>4 |
2171 \set fingeringOrientations = #'(up left down)
2174 \set fingeringOrientations = #'(up left)
2176 <c-1 e-2 g-3 b-5>4 |
2177 \set fingeringOrientations = #'(right)
2184 @node Objetos fuera del pentagrama
2185 @subsection Objetos fuera del pentagrama
2186 @translationof Outside-staff objects
2188 Los objetos fuera-del-pentagrama se sitúan automáticamente para evitar
2189 las colisiones. Existen varias formas de sobreescribir la colocación
2190 automática si el posicionado no resulta óptimo.
2193 * La propiedad outside-staff-priority (prioridad fuera del pentagrama)::
2194 * La instrucción textLengthOn::
2195 * Posicionamiento de los matices dinámicos::
2196 * Escalado de un «Grob»::
2200 @node La propiedad outside-staff-priority (prioridad fuera del pentagrama)
2201 @unnumberedsubsubsec La propiedad @code{outside-staff-priority} (prioridad fuera del pentagrama)
2202 @translationof The outside-staff-priority property
2204 Los objetos fuera-del-pentagrama se colocan automáticamente para
2205 evitar las colisiones. Los objetos que tienen el valor más bajo de la
2206 propiedad @code{outside-staff-priority} se sitúan más cerca del
2207 pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
2208 tanto como sea necesario para evitar la colisión. La prioridad
2209 @code{outside-staff-priority} se defina en el @code{grob-interface} y
2210 así es una propiedad de todos los objetos de presentación. De forma
2211 predeterminada se establece a @code{#f} para todos los objetos
2212 dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
2213 fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
2214 presenta los valores numéricos predeterminados para algunos de los
2215 objetos fuera-del-pentagrama más comunes.
2217 @cindex objetos de extensión
2219 Observe los nombres algo inusuales de algunos de los objetos: los
2220 objetos de extensión se crean automáticamente para controlar el
2221 posicionamiento vertical de los grobs que (quizá) comienzan y terminan
2222 en distintos momentos musicales, de manera que cualquier modificación
2223 a la prioridad @code{outside-staff-priority} del grob subyacente no
2224 tiene ningún efecto. Por ejemplo, cambiar la
2225 @code{outside-staff-priority} del objeto de regulador @code{Hairpin}
2226 no tiene efecto sobre la posición vertical de los reguladores: en
2227 lugar de eso, tenemos que cambiar la @code{outside-staff-priority} del
2228 objeto asociado @code{DynamicLineSpanner}. Esta sobreescritura se
2229 debe escribir al comienzo del objeto de extensión, que podría incluir
2230 varios reguladores o matices dinámicos encadenados.
2232 @multitable @columnfractions .3 .3 .3
2233 @headitem Objeto de presentación
2235 @tab Controla la posición de:
2236 @item @code{RehearsalMark}
2238 @tab Letras de ensayo
2239 @item @code{MetronomeMark}
2241 @tab Indicaciones metronómicas
2242 @item @code{VoltaBracketSpanner}
2244 @tab Cajetines de primera y segunda vez
2245 @item @code{TextScript}
2247 @tab Texto en elementos de marcado
2248 @item @code{MultiMeasureRestText}
2250 @tab Texto sobre silencios de compás completo
2251 @item @code{OttavaBracket}
2253 @tab Corchetes de octava alta y baja
2254 @item @code{TextSpanner}
2256 @tab Objetos de extensión de texto
2257 @item @code{DynamicLineSpanner}
2259 @tab Todas las indicaciones dinámicas
2260 @item @code{VoltaBracketSpanner}
2262 @tab Números de compás
2263 @item @code{TrillSpanner}
2265 @tab Trinos mantenidos
2268 He aquí un ejemplo que muestra la situación predeterminada de algunos
2271 @cindex texto, extensiones de
2272 @cindex octava alta y baja, corchete de
2274 @funindex \startTextSpan
2275 @funindex startTextSpan
2276 @funindex \stopTextSpan
2277 @funindex stopTextSpan
2279 @cindex TextSpanner, ejemplo de sobreescritura
2280 @cindex bound-details, propiedad, ejemplo
2282 @lilypond[quote,fragment,ragged-right,verbatim]
2283 % Set details for later Text Spanner
2284 \override TextSpanner.bound-details.left.text
2285 = \markup { \small \bold Slower }
2286 % Place dynamics above staff
2288 % Start Ottava Bracket
2291 % Add Dynamic Text and hairpin
2297 % Add Dynamic Text and terminate hairpin
2298 c''4\ff c'' \stopTextSpan |
2299 % Stop Ottava Bracket
2304 Este ejemplo también muestra cómo crear textos con extensión (Text
2305 Spanners): textos con líneas extensoras por encima de una sección de
2306 música. El extensor abarca desde la instrucción @code{\startTextSpan}
2307 hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
2308 define por medio de la instrucción @code{\override TextSpanner}. Para
2309 ver más detalles, consulte @ruser{Extensiones de texto}.
2311 También muestra la manera de crear corchetes de octava alta y baja.
2313 @cindex trucar la situación de los números de compás
2314 @cindex números de compás, ajustar posición
2315 @cindex trucar la situación de marcas metronómicas
2316 @cindex metrónomo, situación de las indicaciones de
2317 @cindex trucar la situación de las letras de ensayo
2318 @cindex ensayo, letras, trucar la colocación
2320 Si los valores predeterminados de @code{outside-staff-priority} no le
2321 ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
2322 de cualquiera de los objetos. Suponga que quisiéramos que el corchete
2323 de octava estuviera situado por debajo del elemento extensor de texto
2324 en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
2325 prioridad de @code{OttavaBracket} en el RFI o en las tablas
2326 anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
2327 recordando que @code{OttavaBracket} se crea dentro del contexto de
2330 @cindex TextSpanner, ejemplo de sobreescritura
2331 @cindex bound-details, propiedad, ejemplo
2333 @lilypond[quote,fragment,ragged-right,verbatim]
2334 % Set details for later Text Spanner
2335 \override TextSpanner.bound-details.left.text
2336 = \markup { \small \bold Slower }
2337 % Place dynamics above staff
2339 % Place following Ottava Bracket below Text Spanners
2340 \once \override Staff.OttavaBracket.outside-staff-priority = #340
2341 % Start Ottava Bracket
2346 % Add Dynamic Line Spanner
2352 c''4\ff c'' \stopTextSpan |
2353 % Stop Ottava Bracket
2358 Observe que algunos de estos objetos, concretamente los números de
2359 compás, las indicaciones metronómicas y las letras de ensayo, se
2360 alojan de forma predeterminada dentro del contexto @code{Score}; así
2361 pues, debe asegurarse de que utiliza el contexto adecuado cuando se
2362 sobreescriben sus propiedades.
2364 @cindex ligaduras y outside-staff-priority
2365 @cindex ligaduras y articulaciones
2366 @cindex articulaciones y ligaduras
2368 De forma predeterminada, las ligaduras de expresión están clasificadas
2369 como objetos dentro-del-pentagrama, pero con frecuencia aparecen
2370 encima del pentagrama si las notas que une son muy agudas. Ello puede
2371 empujar a una posición muy elevada a los objetos fuera-del-pentagrama
2372 como las articulaciones, pues la ligadura se colocará en primer lugar.
2373 La propiedad @code{avoid-slur} de la articulación se puede establecer
2374 al valor @code{'inside} (por dentro) para llevarla al interior de la
2375 ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si
2376 la prioridad @code{outside-staff-priority} está también ajustada al
2377 valor @code{#f}. De forma alternativa, la prioridad
2378 @code{outside-staff-priority} de la ligadura se puede fijar en un
2379 valor numérico para hacer que se sitúe en línea con otros objetos
2380 fuera del pentagrama de acuerdo con este valor. He aquí un ejemplo
2381 que muestra el efecto de los dos métodos:
2383 @lilypond[quote,verbatim]
2385 c4( c^\markup { \tiny \sharp } d4.) c8 |
2387 \once \override TextScript.avoid-slur = #'inside
2388 \once \override TextScript.outside-staff-priority = ##f
2389 c4^\markup { \tiny \sharp } d4.) c8 |
2390 \once \override Slur.outside-staff-priority = #500
2391 c4( c^\markup { \tiny \sharp } d4.) c8 |
2395 Los cambios en @code{outside-staff-priority} también se pueden emplear
2396 para controlar la situación vertical de los objetos individuales,
2397 aunque los resultados pueden no siempre ser deseables. Suponga que
2398 quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
2399 bajo el epígrafe Comportamiento Automático de más arriba (véase
2400 @ref{Comportamiento automático}). Todo lo que debemos hacer es localizar la
2401 prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
2402 aumentar la prioridad de @qq{Text3} hasta un valor superior:
2404 @cindex TextScript, ejemplo de sobreescritura
2405 @cindex outside-staff-priority, propiedad, ejemplo
2407 @lilypond[quote,fragment,ragged-right,verbatim]
2410 \once \override TextScript.outside-staff-priority = #500
2415 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
2416 también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
2417 desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
2418 realmente queremos hacer es posicionar todas las anotaciones a la
2419 misma distancia por encima del pentagrama? Para hacerlo, vamos a
2420 necesitar claramente espaciar las notas en sentido horizontal para
2421 hacer sitio para el texto. Esto se hace empleando la instrucción
2422 @code{textLengthOn}.
2424 @node La instrucción textLengthOn
2425 @unnumberedsubsubsec La instrucción @code{@bs{}textLengthOn}
2426 @translationof The textLengthOn command
2428 @cindex notas, espaciar junto al texto
2430 @funindex \textLengthOn
2431 @funindex textLengthOn
2432 @funindex \textLengthOff
2433 @funindex textLengthOff
2435 De forma predeterminada, el texto producido mediante marcado no ocupa
2436 ningún espacio horizontal en cuanto se refiere a la disposición de la
2437 música. La instrucción @code{\textLengthOn} invierte este
2438 comportamiento, ocasionando que las notas resulten tan espaciadas como
2439 sea necesario para acomodar el texto:
2441 @lilypond[quote,fragment,ragged-right,verbatim]
2442 \textLengthOn % Cause notes to space out to accommodate text
2449 La instrucción para volver al comportamiento predeterminado es
2450 @code{\textLengthOff}. De forma alternativa, se puede usar
2451 @code{\once} con @code{\textLengthOn} si el efecto se ha de limitar a
2452 un solo momento musical.
2453 The corresponding spacing behavior for rehearsal marks and tempo
2454 indications is independently controlled with the commands
2455 @code{\markLengthOn} and @code{\markLengthOff}.
2457 @cindex marcado, texto de, permitir las colisiones en
2459 El texto de marcado también evita las notas que se proyectan por
2460 encima del pentagrama. Si esto no es lo que deseamos, el
2461 desplazamiento automático hacia arriba se puede desactivar mediante el
2462 establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
2463 muestra cómo el texto de marcado interactúa con tales notas.
2465 @cindex TextScript, ejemplo de sobreescritura
2466 @cindex outside-staff-priority, propiedad, ejemplo
2468 @lilypond[quote,ragged-right,verbatim]
2470 % This markup is short enough to fit without collision
2474 % This is too long to fit, so it is displaced upwards
2478 % Turn off collision avoidance
2479 \once \override TextScript.outside-staff-priority = ##f
2480 c,,2^"Long Text " c'' |
2483 % Turn off collision avoidance
2484 \once \override TextScript.outside-staff-priority = ##f
2485 \textLengthOn % and turn on textLengthOn
2486 c,,2^"Long Text " % Spaces at end are honored
2491 @node Posicionamiento de los matices dinámicos
2492 @unnumberedsubsubsec Posicionamiento de los matices dinámicos
2493 @translationof Dynamics placement
2495 @cindex trucar la colocación de los matices
2496 @cindex dinámica, trucar la colocación de las indicaciones de
2497 @cindex matices, trucar la colocación
2499 Las indicaciones de matiz dinámico normalmente se colocarán por debajo
2500 del pentagrama, pero se pueden posicionar por encima con la
2501 instrucción @code{\dynamicUp}. Se situarán verticalmente respecto a la
2502 nota a la que van adosadas, y flotarán por debajo (o por encima) de
2503 todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
2504 y números de compás. Esto puede ofrecer resultados bastante
2505 aceptables, como muestra este ejemplo:
2507 @lilypond[quote,ragged-right,verbatim]
2513 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2514 ees,2.~\)\mf ees4 r8 |
2518 Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
2519 muy cerca, la colocación automática evitará las colisiones desplazando
2520 las marcas dinámicas posteriores más lejos, aunque este puede no ser
2521 el lugar óptimo, como muestra el siguiente ejemplo más bien
2524 @lilypond[quote,ragged-right,verbatim,fragment]
2526 \relative { a'4\f b\mf a\mp b\p }
2530 Si se presentara una situación similar en música @q{real}, podría ser
2531 preferible espaciar las notas un poco más entre sí, de forma que todas
2532 las marcas dinámicas puedan caber a la misma distancia vertical desde
2533 el pentagrama. Hemos sido capaces de hacer esto para el texto de
2534 marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
2535 una instrucción equivalente para las indicaciones de matiz dinámico.
2536 Por tanto, tendremos que averiguar cómo hacerlo utilizando
2537 instrucciones @code{\override}.
2539 @node Escalado de un «Grob»
2540 @unnumberedsubsubsec Escalado de un «Grob»
2541 @translationof Grob sizing
2543 @cindex grob, cambio de tamaño de un
2544 @cindex escala de los grobs
2546 En primer lugar debemos aprender cómo se especifica el tamaño de los
2547 grobs. Todos los grobs tienen un punto de referencia definido dentro
2548 de ellos que se usa para colocarlos respecto a su objeto padre.
2549 Entonces, este punto del grob se posiciona a una distancia horizontal,
2550 @code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
2551 de su padre. La dimensión horizontal del objeto viene dada por una
2552 pareja de números, @code{X-extent}, que dice dónde están los límites
2553 izquierdo y derecho respecto del punto de referencia. La amplitud
2554 vertical se define de forma similar mediante una pareja de números,
2555 @code{Y-extent}. Éstas son propiedades de todos los grobs que
2556 contemplan el @code{grob-interface}.
2558 @cindex @code{extra-spacing-width}
2560 De forma predeterminada, los objetos fuera-del-pentagrama reciben
2561 una anchura cero, de manera que pueden solaparse en la dirección
2562 horizontal. Esto se hace mediante el truco de hacer que la
2563 dimensión más a la izquierda sea igual a infinito y que la
2564 dimensión más a la derecha sea igual a menos infinito,
2565 estableciendo el valor de @code{extra-spacing-width} a
2566 @code{'(+inf.0 . -inf.0)}. Así, para asegurar que no se
2567 superponen en la dirección horizontal tendremos que sobreescribir
2568 este valor de @code{extra-spacing-width} para darles un poco de
2569 espacio adicional. Las unidades son el espacio entre dos líneas
2570 del pentagrama, de forma que debería bastar mover el límite
2571 izquierdo media unidad a la izquierda y el límite derecho media
2572 unidad a la derecha:
2575 \override DynamicText.extra-spacing-width = #'(-0.5 . 0.5)
2579 Veamos si funciona en nuestro ejemplo anterior:
2581 @cindex DynamicText, ejemplo de sobreescritura
2582 @cindex extra-spacing-width, propiedad, ejemplo
2584 @lilypond[quote,ragged-right,verbatim,fragment]
2586 % Extend width by 1 staff space
2587 \override DynamicText.extra-spacing-width = #'(-0.5 . 0.5)
2588 \relative { a'4\f b\mf a\mp b\p }
2592 Esto tiene un mejor aspecto, pero quizá habríamos preferido que
2593 las indicaciones de dinámica estuvieran alineadas sobre la misma
2594 línea de base en lugar de ir hacia arriba y hacia abajo con las
2595 notas. La propiedad que lo hace es @code{staff-padding} (relleno
2596 de pentagrama) que se estudia en la sección dedicada a las
2597 colisiones (véase @ref{Colisiones de objetos}).
2599 @node Espaciado vertical
2600 @section Espaciado vertical
2601 @translationof Vertical spacing
2603 Por lo general, el espaciado vertical de los objetos musicales que
2604 LilyPond hace es bastante bueno. Veamos cómo se comporta con una
2605 canción sencilla, con dos voces y acompañamiento de piano:
2607 @lilypond[quote,fragment,ragged-right]
2612 \new Voice = "music" {
2618 Here are some lyrics
2621 \clef bass e'2 f e c
2636 No hay ningún problema con el espaciado vertical predeterminado.
2637 Sin embargo, supongamos que estamos trabajando con un editor que
2638 tiene ciertos requisitos específicos para el espaciado vertical de
2639 los pentagramas y la letra: quiere que la letra está más separada
2640 de las notas, que el acompañamiento de piano esté más separado de
2641 la línea vocal y que los dos pentagramas de piano estén más juntos
2642 entre sí. Comenzaremos con la letra.
2644 La letra se encuentra en el interior de un sistem, y por tanto las
2645 instrucciones para aplicarle el espaciado estarán en
2646 @ruser{Espaciado vertical flexible dentro de los sistemas}. Allí
2647 se dice que el texo son líneas del tipo @qq{no-pauta} y por tanto
2648 la instrucción para cambiar su espaciado hará referencia a la
2649 propiedad @code{nonstaff}. Para separarlas del pentagrama al que
2650 pertenecen (la pauta superior) usaremos la propiedad
2651 @code{relatedstaff}. Para separarlas de la línea inferior
2652 usaremos la propiedad @code{unrelatedstaff}. Las partes vocales
2653 pertenecen a un grupo vertical @code{VerticalAxisGroup}, por lo
2654 que tenemos que ajustar sus propiedades. Probémoslo y veamos si
2657 @lilypond[quote,fragment,ragged-right,verbatim]
2662 \new Voice = "music" {
2667 \override VerticalAxisGroup.
2668 nonstaff-relatedstaff-spacing.padding = #5
2669 \override VerticalAxisGroup.
2670 nonstaff-unrelatedstaff-spacing.padding = #5
2673 Here are some lyrics
2676 \clef bass e'2 f e c
2691 Bien: sí, funciona, pero quizá demasiado bien. Cuando
2692 establecemos el @code{padding} (relleno) a 5, LilyPond añade 5
2693 espacios de pentagrama a la distancia entre los objetos, lo que es
2694 excesivo para nosotros en este caso. Usaremos un valor de 2.
2696 A continuación, desplazaremos la música de piano para separarla de
2697 las partes vocales. La música vocal es una @code{ChoirStaff} (un
2698 contexto de sistema coral), y por tanto tenemos que aumentar el
2699 espaciado entre ese grupo de pentagramas y el sistema de piano que
2700 se encuentra debajo. Lo haremos cambiando la
2701 @code{basic-distance} (distancia básica) del @code{StaffGrouper}
2702 del @code{staffgroup-staff-spacing}.
2704 @lilypond[quote,fragment,ragged-right,verbatim]
2706 \new ChoirStaff \with {
2707 \override StaffGrouper.
2708 staffgroup-staff-spacing.basic-distance = #15
2712 \new Voice = "music" {
2717 \override VerticalAxisGroup.
2718 nonstaff-relatedstaff-spacing.padding = #2
2719 \override VerticalAxisGroup.
2720 nonstaff-unrelatedstaff-spacing.padding = #2
2723 Here are some lyrics
2726 \clef bass e'2 f e c
2741 Muy bien. Ahora, sólo nos queda el último requisito de hacer que
2742 los pentagramas de piano estén más juntos. Para conseguirlo, de
2743 nuevo alteramos las propiedades del @code{StaffGrouper}, pero esta
2744 vez vamos a reducir tanto la @code{basic-distance} (distancia
2745 básica) como el @code{padding} (relleno). Podemos hacerlo como se
2746 muestra a continuación.
2748 @lilypond[quote,fragment,ragged-right,verbatim]
2750 \new ChoirStaff \with {
2751 \override StaffGrouper.
2752 staffgroup-staff-spacing.basic-distance = #15
2756 \new Voice = "music" {
2761 \override VerticalAxisGroup.
2762 nonstaff-relatedstaff-spacing.padding = #2
2763 \override VerticalAxisGroup.
2764 nonstaff-unrelatedstaff-spacing.padding = #2
2767 Here are some lyrics
2770 \clef bass e'2 f e c
2773 \new PianoStaff \with {
2774 \override StaffGrouper.staff-staff-spacing = #'(
2775 (basic-distance . 0)
2789 Con esto los hemos colocado muy juntos entre sí (pero es lo que el
2790 editor quería). Se podrían haber separado más alterando el
2791 relleno, @code{padding}, o la distancia básica,
2792 @code{basic-distance}, si quisiéramos.
2794 Hay muchas formas de alterar el espaciado vertical. Un punto
2795 clave que debemos recordar es que el espaciado entre objetos
2796 dentro de un @code{StaffGroup} (como los grupos @code{GrandStaff}
2797 o @code{PianoStaff}) se controla con las variables de espaciado
2798 del @code{StaffGrouper}. El espaciado de los pentagramas no
2799 agrupados (como @code{Lyrics} y @code{Staff}) se controla con las
2800 variables del @code{VerticalAxisGroup}. Para ver más detalles,
2802 @ruser{Variables de espaciado de paper verticales flexibles} y
2803 @ruser{Espaciado vertical flexible dentro de los sistemas}.
2806 @node Colisiones de objetos
2807 @section Colisiones de objetos
2808 @translationof Collisions of objects
2812 * Arreglar notación con superposiciones::
2813 * Ejemplos reales de música::
2817 @subsection Mover objetos
2818 @translationof Moving objects
2820 @cindex mover objetos superpuestos
2821 @cindex mover objetos que colisionan
2822 @cindex mover grobs que colisionan
2823 @cindex objetos que colisionan, mover
2824 @cindex grobs que colisionan, mover
2826 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
2827 de notación se pueden superponer, lo que es una lástima, pero en
2828 realidad es bastante poco frecuente. Normalmente la necesidad de
2829 mover objetos es por claridad o razones estéticas: el aspecto es mejor
2830 con un poco más o un poco menos de espacio de separación.
2832 Existen tres enfoques principales que llevan a la resolución de
2833 superposiciones en la notación. Se deben considerar en el siguiente
2838 La @strong{dirección} de uno de los objetos que se superponen se puede
2839 cambiar usando las instrucciones predefinidas que están relacionadas
2840 arriba para los objetos dentro-del-pentagrama (véase @ref{Objetos interiores al pentagrama}).
2841 Se pueden recolocar fácilmente las
2842 plicas, ligaduras de expresión y de unión, barras de corchea,
2843 indicaciones dinámicas, texto y grupos de valoración especial de esta
2844 forma. La limitación es que sólo tiene la posibilidad de elegir entre
2845 dos posiciones, y podría ser que ninguna de ellas sea la adecuada.
2848 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2849 colocando los objetos de presentación, se pueden modificar usando la
2850 instrucción de sobreescritura @code{\override}. Las ventadas de hacer
2851 cambios a este tipo de propiedad son: a) que algún otro objeto se
2852 moverá automáticamente si es necesario, para dejarle sitio, y b) una
2853 única sobreescritura se puede aplicar a todas las instancias del mismo
2854 tipo de objeto. Entre tales propiedades se encuentran:
2859 @code{direction} (dirección)
2861 Ya se ha estudiado con cierto detalle: véase @ref{Objetos interiores al pentagrama}.
2864 @code{padding} (relleno),
2865 @code{right-padding} (relleno por la derecha),
2866 @code{staff-padding} (relleno de pentagrama)
2869 @cindex padding, propiedad
2870 @cindex right-padding, propiedad
2871 @cindex staff-padding, propiedad
2873 Según un objeto se está colocando, el valor de su propiedad de relleno
2874 @code{padding} especifica el espacio intermedio que se debe dejar
2875 entre él mismo y el límite más próximo del objeto contra el que se
2876 está colocando. Observe que es el valor de @code{padding} del objeto
2877 @strong{que se está colocando} el que se usa; el valor de
2878 @code{padding} del objeto que ya está colocado se ignora. Los
2879 espacios intermedios especificados mediante @code{padding} se pueden
2880 aplicar a todos los objetos que contemplan el interface
2881 @code{side-position-interface}.
2883 En lugar de con @code{padding}, la colocación de los grupos de
2884 alteraciones se controla con
2885 @code{right-padding}. Esta propiedad se encuentra en el objeto
2886 @code{AccidentalPlacement} que, observe, vive dentro del contexto de
2887 @strong{Staff}. Durante el proceso tipográfico, las cabezas de las
2888 notas se componen tipográficamente en primer lugar, y después las
2889 alteraciones, si existen, se añaden a la izquierda de las cabezas
2890 utilizando la propiedad de relleno por la derecha @code{right-padding}
2891 para determinar la separación entre la alteración y la cabeza, y
2892 de las alteraciones entre sí. Así
2893 pues, sólo la propiedad de relleno por la derecha @code{right-padding}
2894 del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
2895 de las alteraciones.
2897 La propiedad @code{staff-padding} está estrechamente relacionada con
2898 la propiedad @code{padding}: @code{padding} controla la separación
2899 mínima entre cualquier objeto que contemple el interface
2900 @code{side-position-interface} y el objeto más cercano (generalmente
2901 la nota o las líneas del pentagrama); @code{staff-padding} se aplica
2902 sólo a los objetos que siempre se sitúan fuera del pentagrama:
2903 controla la separación mínima entre dicho objeto y el pentagrama.
2904 Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
2905 que se posicionan respecto a la nota en vez de hacerlo respecto al
2906 pentagrama, incluso aunque puede ser sobreescrito sin error por tales
2907 objetos: simplemente se ignora.
2909 Para descubrir qué propiedad de relleno se necesita para el objeto que
2910 quiere recolocar, debe volver al manual de RFI y buscar las
2911 propiedades del objeto. Tenga cuidado porque las propiedades de
2912 relleno podrían no estar en el objeto más obvio, así que busque en los
2913 objetos que puedan tener alguna relación con él.
2915 Todos los valores de relleno se miden en espacios del pentagrama.
2916 Para la mayor parte de los objetos el valor se establece de forma
2917 predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
2918 Se puede sobreescribir si se necesita una separación intermedia mayor
2922 @code{self-alignment-X} (Auto-alineamiento en el eje X)
2924 @cindex self-alignment-X, propiedad
2926 Esta propiedad se puede usar para alinear el objeto a la izquierda, a
2927 la derecha, o centrarlo con respecto al punto de referencia del objeto
2928 «padre». Se puede usar con todos los objetos que contemplan el
2930 @code{self-alignment-interface}. En general son objetos que contienen
2931 texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
2932 forma alternativa se puede especificar un valor numérico entre
2933 @w{@code{-1}} y @code{+1}, donde @w{@code{-1}} es alineado por la izquierda,
2934 @code{+1} es alineado por la derecha, y los números intermedios mueven
2935 el texto progresivamente desde alineado por la izquierda hasta alineado
2936 por la derecha. Se pueden especificar valores numéricos mayores de
2937 @code{1} para mover el texto incluso más lejos hacia la izquierda, o
2938 menos de @w{@code{-1}} para alejarlo más hacia la derecha. Un cambio en
2939 @code{1} en el valor corresponde a un movimiento de la mitad de la
2940 longitud total del propio texto.
2943 @code{extra-spacing-width} (anchura de separación adicional)
2945 @cindex extra-spacing-width, propiedad
2947 Esta propiedad está disponible para todos los objetos que contemplan
2948 el interface @code{item-interface}. Toma dos números, el primero se
2949 suma al límite izquierdo y el segundo se suma al límite derecho. Los
2950 números negativos desplazan el límite a la izquierda y los positivos a
2951 la derecha, por lo que para ensanchar un objeto el primer número debe
2952 ser negativo y el segundo positivo. Observe que no todos los objetos
2953 ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
2954 (alteración) sólo toma nota del primer número (el borde izquierdo).
2957 @code{staff-position} (posición de pentagrama)
2959 @cindex staff-position, propiedad
2961 @code{staff-position} es una propiedad del interface
2962 @code{staff-symbol-referencer-interface}, que está contemplado por los
2963 objetos que se colocan con relación al pentagrama. Especifica la
2964 posición vertical del objeto con relación a la tercera línea del
2965 pentagrama en medios espacios de pentagrama. Es útil en la
2966 resolución de colisiones entre objetos de presentación como silencios
2967 multi-compás, ligaduras de unión y notas en distintas voces.
2970 @code{horizontal-shift}
2972 @cindex horizontal-shift, propiedad
2973 @cindex nota, columna de
2974 @cindex nota, colisiones
2975 @cindex colisiones de notas
2976 @cindex desplazamiento, instrucciones de
2983 @funindex \shiftOnnn
2986 Dentro de una vozm todas las notas que se producen en el mismo
2987 moemtno se agrupan en una columna de notas, y se crea un objeto
2988 @code{NoteColumn} para controlar el posicionamiento horizonal de
2989 dicho grupo de notas (véase @qq{Columnas de nota} en @ref{Voces
2990 explícitas}). Si @emph{y sólo si} dos o más columnas de nota
2991 dentro de un solo contexto de pauta, las dos con las plicas en la
2992 misma dirección, aparecen en el mismo momento musical, los valores
2993 de sus propiedades @code{horizontal-shift} se usan para asignarles
2994 una puntuación y las columnas con puntuaciones más altas se
2995 desplazan progresivamente para evitar las colisiones entre las
2996 cabezas de las notas. Esta propiedad se establece con las
2997 instrucciones @code{\voiceXXX} y se pueden sobreescribir
2998 directamente con una instrucción @code{\override} o, de forma más
2999 común con las instrucciones @code{\shiftOn}. Observe que esta
3000 propiedad se usa para @emph{calificar} las columnas de nota o para
3001 aplicar desplazamientos: no especifica la magnitud del
3002 desplazamiento, que se va incrementando progresivamente en pasos
3003 basándolse en la anchura de las cabezas de nota para cada
3004 puntuación. Los pasos son normalmente de la mitad de la anchura
3005 de una cabeza de nota, pero puede ser el ancho completo de la
3006 cabeza de una nota cuando está implicado un grupo de notas muy
3010 @code{force-hshift} (forzar desplazamiento horizontal)
3012 @cindex force-hshift, propiedad
3014 La propiedad @code{force-hshift} es una propiedad de una
3015 @code{NoteColumn} (realmente lo es del interface
3016 @code{note-column-interface}). Modificarlo permite mover una
3017 columna de notas en situaciones donde las columnas de notas se
3018 superponen. Observe que no tiene efecto sobre las columnas de
3019 nota que no se superponen. Se especifica en unidades adecuadas a
3020 una columna de notas, por ejemplo la anchura de la cabeza de la
3021 nota de la primera voz. Se debe usar en situaciones complejas
3022 donde las instrucciones @code{\shiftOn} normales (véase @ref{Voces
3023 explícitas}) no resuelven el conflicto entre las notas de forma
3024 satisfactoria. Es preferible a la propiedad @code{extra-offset}
3025 para este propósito porque no hay necesidad de averiguar la
3026 distancia en espacios de pentagrama, y mover las notas dentro o
3027 fuera de una @code{NoteColumn} afecta a otras acciones como a la
3028 fusión entre cabezas de nota.
3033 Finalmente, cuando todo lo demás falla, los objetos se pueden
3034 reposicionar manualmente con relación a la tercera línea del
3035 pentagrama verticalmente, o desplazándolas una cierta distancia a una
3036 nueva posición. Las desventajas son que los valores correctos para el
3037 reposicionamiento se deben adivinar, a menudo por ensayo y error, para
3038 cada objeto individual y, puesto que el movimiento se hace después de
3039 que LilyPond ha colocado todos los demás objetos es usuario es
3040 responsable de evitar cualquier colisión que pudiera producirse. Pero
3041 la dificultar principal con este enfoque es que los valores de
3042 reposicionado podrían tener que ser vueltos a calcular si la música se
3043 modifica más tarde. Las propiedades que se pueden usar para este tipo
3044 de posicionamiento manual son:
3047 @item extra-offset (desplazamiento adicional)
3049 @cindex extra-offset, propiedad
3051 Esta propiedad se aplica a cualquier objeto de presentación que
3052 contemple el @code{grob-interface}. Toma una pareja de números que
3053 especifican el desplazamiento adicional en las direcciones horizontal
3054 y vertical. Los números negativos mueven el objeto a la izquierda o
3055 hacia abajo. Las unidades son espacios de pentagrama. El
3056 desplazamiento adicional se hace después de que la composición
3057 tipográfica de los objetos ha terminado, así que un objeto puede ser
3058 reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
3060 @item positions (posiciones)
3062 @cindex positions, propiedad
3064 Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
3065 la altura de las barras de corchea, ligaduras de expresión y corchetes
3066 de grupos de valoración especial. Toma una pareja de números que dan
3067 la posición de los extremos izquierdo y derecho de la barra, ligadura,
3068 etc. con relación a la tercera línea del pentagrama. Las unidades son
3069 espacios de pentagrama. Observe, sin embargo, que las ligaduras de
3070 expresión y de fraseo no se pueden reposicionar en cantidades
3071 arbitrariamente grandes. LilyPond en primer lugar genera una lista de
3072 posiciones posibles para la ligadura y de forma predeterminada
3073 encuentra la ligadura que tiene @qq{mejor aspecto}. Si la propiedad
3074 @code{positions} se ha sobreescrito, la ligadura que está más cerca de
3075 las posiciones que se han solicitado, se selecciona de la lista.
3080 Un objeto en particular podría no tener todas estas propiedades. Es
3081 necesario ir al manual RFI para buscar qué propiedades se encuentran
3082 disponibles para el objeto en cuestión.
3085 Aquí presentamos una lista de los objetos que es más probable que
3086 estén implicados en colisiones, con el nombre del objeto que habría
3087 que buscar en el RFI para descubrir qué propiedades se deben usar para
3090 @multitable @columnfractions .5 .5
3091 @headitem Tipo de objeto @tab Nombre del objeto
3092 @item Articulaciones @tab @code{Script}
3093 @item Barras @tab @code{Beam}
3094 @item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
3095 @item Dinámica (horizontalmente) @tab @code{DynamicText}
3096 @item Digitaciones @tab @code{Fingering}
3097 @item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
3098 @item Ligaduras de expresión @tab @code{Slur}
3099 @item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
3100 @item Ligaduras de unión @tab @code{Tie}
3101 @item Grupos de valoración especial @tab @code{TupletBracket}
3105 @node Arreglar notación con superposiciones
3106 @subsection Arreglar notación con superposiciones
3107 @translationof Fixing overlapping notation
3109 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
3110 en la sección anterior, para resolver problemas de notación que se
3114 * La propiedad padding (relleno)::
3115 * La propiedad right-padding (relleno por la derecha)::
3116 * La propiedad staff-padding (relleno de pentagrama)::
3117 * La propiedad self-alignment-X (auto-alineación en X)::
3118 * La propiedad staff-position (posición en el pentagrama)::
3119 * La propiedad extra-offset (desplazamiento adicional)::
3120 * La propiedad positions (posiciones)::
3121 * La propiedad force-hshift (forzar desplazamiento horizontal)::
3124 @node La propiedad padding (relleno)
3125 @unnumberedsubsubsec La propiedad @code{padding} (relleno)
3126 @translationof The padding property
3129 @cindex arreglar notación que se superpone
3130 @cindex superpuesta, notación
3132 La propiedad @code{padding} se puede ajustar para aumentar (o
3133 disminuir) la distancia entre símbolos impresos encima o debajo de las
3136 @cindex Script, ejemplo de sobreescritura
3137 @cindex padding, propiedad, ejemplo
3139 @lilypond[quote,fragment,verbatim]
3141 \override Script.padding = #3
3145 @cindex MetronomeMark, ejemplo de sobreescritura
3146 @cindex padding, propiedad, ejemplo
3148 @lilypond[quote,fragment,verbatim]
3149 % This will not work, see below
3150 \override MetronomeMark.padding = #3
3154 \override Score.MetronomeMark.padding = #3
3159 Observe en el segundo ejemplo la gran importancia que tiene saber qué
3160 contexto maneja un determinado objeto. Puesto que el objeto
3161 @code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
3162 cambios de propiedades en el contexto @code{Voice} pasarán
3163 inadvertidos. Para ver más detalles, consulte @ruser{Modificar las propiedades}.
3165 Si la propiedad de relleno @code{padding} de un objeto se incrementa
3166 cuando dicho objeto se encuentra en una pila de objetos que se están
3167 colocando de acuerdo a su prioridad @code{outside-staff-priority},
3168 entonces ese objeto se moverá, y también todos los que están por fuera
3172 @node La propiedad right-padding (relleno por la derecha)
3173 @unnumberedsubsubsec La propiedad @code{right-padding} (relleno por la derecha)
3174 @translationof The right-padding property
3176 @cindex right-padding, propiedad
3178 La propiedad @code{right-padding} afecta al espaciado entre la
3179 alteración y la nota a que se aplica. Normalmente no es necesaria,
3180 pero el espaciado predeterminado puede estar mal para ciertos glifos
3181 de alteraciones o combinaciones de glifos que se usan en música
3182 microtonal. Éstos tienen que introducirse sobreescribiendo el sello
3183 de la alteración con un elemento de marcado que contenga los símbolos
3186 @cindex Accidental, ejemplo de sobreescritura
3187 @cindex text, propiedad, ejemplo
3188 @cindex stencil, propiedad, ejemplo
3189 @cindex AccidentalPlacement, ejemplo de sobreescritura
3190 @cindex right-padding, propiedad, ejemplo
3193 @lilypond[quote,ragged-right,verbatim]
3194 sesquisharp = \markup { \sesquisharp }
3197 % This prints a sesquisharp but the spacing is too small
3198 \once \override Accidental.stencil = #ly:text-interface::print
3199 \once \override Accidental.text = #sesquisharp
3201 % This improves the spacing
3202 \once \override Score.AccidentalPlacement.right-padding = #0.6
3203 \once \override Accidental.stencil = #ly:text-interface::print
3204 \once \override Accidental.text = #sesquisharp
3210 Esto utiliza necesariamente una sobreescritura para el sello de la
3211 alteración que no se estudiará hasta más adelante. El tipo de sello
3212 debe ser un procedimiento, aquí modificado para que imprima el
3213 contenido de la propiedad @code{text} del objeto @code{Accidental},
3214 que a su vez está establecido como un signo de sesquisostenido.
3215 Entonces el signo se puede separar de la cabeza de la nota
3216 sobreescribiendo @code{right-padding}.
3220 @node La propiedad staff-padding (relleno de pentagrama)
3221 @unnumberedsubsubsec La propiedad @code{staff-padding} (relleno de pentagrama)
3222 @translationof The staff-padding property
3224 @cindex alineación de objetos sobre la línea base
3225 @cindex objetos, alineación sobre la línea base
3227 @code{staff-padding} se puede usar para alinear objetos como matices
3228 dinámicos a lo largo de una línea de base a una distancia fija del
3229 pentagrama, siempre que no exista ningún otro elemento de notación
3230 que fuerce una distancia mayor al pentagrama. No es una propiedad de
3231 @code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
3232 porque la línea de base debe aplicarse por igual a @strong{todas} las
3233 dinámicas, entre ellas las que se han creado como objetos de
3234 extensión. Así que ésta es la forma de alinear las indicaciones de
3235 matiz en el ejemplo de la sección anterior:
3237 @cindex DynamicText, ejemplo de sobreescritura
3238 @cindex extra-spacing-width, propiedad, ejemplo
3239 @cindex DynamicLineSpanner, ejemplo de sobreescritura
3240 @cindex staff-padding, propiedad, ejemplo
3242 @lilypond[quote,fragment,ragged-right,verbatim]
3243 \override DynamicLineSpanner.staff-padding = #3
3244 \relative { a'4\f b\mf a\p b\mp }
3248 @node La propiedad self-alignment-X (auto-alineación en X)
3249 @unnumberedsubsubsec La propiedad @code{self-alignment-X} (auto-alineación en X)
3250 @translationof The self-alignment-X property
3252 El ejemplo siguiente muestra cómo ajustar la posición
3253 de un objeto de digitación de cuerda en relación a la plica de una nota
3254 mediante el alineamiento del límite derecho con el punto de referencia
3257 @cindex StringNumber, ejemplo de sobreescritura
3258 @cindex self-alignment-X, propiedad, ejemplo
3260 @lilypond[quote,fragment,ragged-right,verbatim]
3263 \once \override StringNumber.self-alignment-X = #RIGHT
3267 @node La propiedad staff-position (posición en el pentagrama)
3268 @unnumberedsubsubsec La propiedad @code{staff-position} (posición en el pentagrama)
3269 @translationof The staff-position property
3271 @cindex objeto, colisión dentro del pentagrama
3273 Los silencios multi-compás en una voz pueden chocar con las notas en
3274 otra voz. Puesto que estos silencios se tipografían centrados entre
3275 las barras de compás se necesitaría bastante esfuerzo para que
3276 LilyPond averiguara qué otras notas podrían chocar con él, ya que
3277 actualmente todo el manejo de colisiones entre notas y silencios se
3278 hace solamente para notas y silencios que ocurren al mismo tiempo. He
3279 aquí un ejemplo de colisión de este tipo:
3281 @lilypond[quote,verbatim,ragged-right]
3282 << \relative { c'4 c c c } \\ { R1 } >>
3285 La mejor solución aquí es mover el silencio multi-compás hacia abajo,
3286 pues el silencio está en la voz dos. El ajuste predeterminado para
3287 @code{\voiceTwo} (es decir, en la segunda voz de una construcción
3288 @code{<<@{@dots{}@} \\ @{@dots{}@}>>}) es que @code{staff-position} tenga el
3289 valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
3290 cuatro semi-espacios de pentagrama, al valor @w{@code{-8}}.
3292 @cindex MultiMeasureRest, ejemplo de sobreescritura
3293 @cindex staff-position, propiedad, ejemplo
3295 @lilypond[quote,verbatim,ragged-right]
3297 \relative { c'4 c c c }
3299 \override MultiMeasureRest.staff-position = #-8
3304 Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
3305 la línea adicional por encima del silencio se inserta automáticamente.
3307 @node La propiedad extra-offset (desplazamiento adicional)
3308 @unnumberedsubsubsec La propiedad @code{extra-offset} (desplazamiento adicional)
3309 @translationof The extra-offset property
3311 @cindex posicionar objetos
3312 @cindex posicionar grobs
3313 @cindex objetos, posicionar
3314 @cindex grobs, posicionar
3316 La propiedad @code{extra-offset} da un completo control sobre el
3317 posicionamiento de un objeto tanto vertical como horizontalmente.
3319 En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
3320 a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
3322 @cindex fingering (digitación), ejemplo de sobreescritura
3323 @cindex extra-offset, propiedad, ejemplo
3325 @lilypond[quote,fragment,relative=1,verbatim]
3328 \once \override Fingering.extra-offset = #'(-0.3 . -1.8)
3333 @node La propiedad positions (posiciones)
3334 @unnumberedsubsubsec La propiedad @code{positions} (posiciones)
3335 @translationof The positions property
3337 @cindex controlar manualmente grupos especiales, ligaduras y barras
3338 @cindex manual, control, de grupos especiales, ligaduras y barras
3339 @cindex grupos especiales, barras de, control manual
3340 @cindex ligaduras de expresión, control manual
3341 @cindex ligaduras de fraseo, control manual
3342 @cindex barras de corchea, control manual
3344 La propiedad @code{positions} permite controlar manualmente la
3345 posición vertical y de ahí también la inclinación de los tresillos,
3346 ligaduras de expresión y de fraseo, y barras de corchea.
3348 He aquí un ejemplo en el que las ligaduras de fraseo y de expresión
3351 @lilypond[quote,verbatim,ragged-right]
3352 \relative { a'8 \( ( a'16 ) a \) }
3355 @cindex PhrasingSlur, ejemplo de sobreescritura
3356 @cindex positions, propiedad, ejemplo
3359 Una posibilidad sería mover los dos extremos de la ligadura de fraseo
3360 hacia arriba. Podemos tratar de establecer el extremo izquierdo a 2.5
3361 espacios de pentagrama por encima de la tercera línea y el extremo
3362 derecho a 4.5 también hacia arriba, y LilyPond seleccionaría la
3363 ligadura de fraseo de entre las candidatas que ha encontrado con sus
3364 extremos más cercanos a éstos:
3366 @lilypond[quote,verbatim,fragment,ragged-right]
3367 \once \override PhrasingSlur.positions = #'(2.5 . 4.5)
3368 a'8 \( ( a''16 ) a'' \)
3371 Esto supone una mejora, pero ¿por qué no bajar un poco el extremo
3372 derecho de la ligadura de expresión? Si lo probamos, veremos que no
3373 se puede hacer así. Ello es a causa de que no existen ligaduras de
3374 expresión candidatas que estén más bajas que la que ya se ha
3375 seleccionado, y en este caso la propiedad @code{positions} no tiene
3376 ningún efecto. Sin embargo, las ligaduras de unión, expresión y
3377 fraseo @emph{se pueden} colocar y conformar de manera muy exacta
3378 cuando se necesita. Para aprender la manera de hacerlo, consulte
3379 @ruser{Modificación de ligaduras de unión y de expresión}.
3381 Presentamos otro ejemplo. Vemos que la barra
3382 choca con las ligaduras:
3384 @lilypond[quote,verbatim,fragment,ragged-right]
3390 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
3395 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
3401 Esto se puede resolver manualmente elevando los dos extremos de la
3402 barra desde su posición a 1.81 espacios de pentagrama bajo la línea
3403 central hasta, digamos, 1 espacio:
3405 @cindex Beam, ejemplo de sobreescritura
3406 @cindex positions, propiedad, ejemplo
3408 @lilypond[quote,verbatim,fragment,ragged-right]
3415 \override Beam.positions = #'(-1 . -1)
3416 e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g''
3422 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
3428 Observe que la sobreescritura sigue aplicándose en la primera voz del
3429 segundo compás de corcheas, pero no a ninguna de las barras de la
3432 @node La propiedad force-hshift (forzar desplazamiento horizontal)
3433 @unnumberedsubsubsec La propiedad @code{force-hshift} (forzar desplazamiento horizontal)
3434 @translationof The force-hshift property
3436 Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
3437 Chopin que presentamos al final de @ref{Oigo voces}, que
3438 dejamos con este aspecto:
3440 @lilypond[quote,verbatim,fragment,ragged-right]
3441 \new Staff \relative {
3456 Es necesario que la nota interior del primer acorde (el La bemol
3457 de la cuarta voz) no se aparte de la columna vertical de la nota
3458 aguda. Podríamos esperar corregirlo mediante el uso de
3459 @code{\shiftOff}, pero esto produce advertencias sobre columnas de
3460 notas que colisionan. En lugar de ello, ajustamos a cero el valor
3461 para esta nota de @code{force-hshift}, que es una propiedad de
3464 En el segundo acorde preferimos que el Fa esté alineado con el La
3465 bemol y que la nota grave se coloque ligeramente a la derecha para
3466 evitar una colisión de las plicas. Lo conseguimos ajustando el
3467 valor de @code{force-hshift} en la @code{NoteColumn} del Re bemol
3468 grave para moverlo a la derecha medio espacio de pentagrama, y
3469 fijando @code{force-hshift} para el Fa al vaor cero. Observe que
3470 usamos @code{\once} para evitar que los ajustes se propaguen más
3471 allá del momento musical inmediato, aunque en este pequeño ejemplo
3472 podrían omitirse el @code{\once} y el segundo @code{\override} de
3473 la cuarta voz. Ello no supondría una buena práctica.
3475 Presentamos a continuación el resultado final:
3477 @cindex NoteColumn, ejemplo de sobreescritura
3478 @cindex force-hshift, propiedad, ejemplo
3480 @lilypond[quote,verbatim,fragment,ragged-right]
3481 \new Staff \relative {
3486 { <ees, c>2 \once \override NoteColumn.force-hshift = 0.5 des }
3489 { \once \override NoteColumn.force-hshift = 0 aes'2
3490 \once \override NoteColumn.force-hshift = 0 f4 fes }
3497 @node Ejemplos reales de música
3498 @subsection Ejemplos reales de música
3499 @translationof Real music example
3501 Finalizaremos esta sección sobre los trucos mostrando los pasos que se
3502 deben tomar para tratar con un ejemplo complicado que necesita varios
3503 trucos para producir el resultado deseado. El ejemplo se ha escogido
3504 deliberadamente para ilustrar el uso de la Referencia de la Notación
3505 para resolver problemas de notación poco comunes. No es
3506 representativo del proceso de grabado más usual, por lo que ¡le
3507 recomendamos que no deje que estas dificultades le desanimen!
3508 ¡Afortunadamente, las dificultades como éstas no son muy comunes!
3510 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
3511 compases 6 al 9, la transición entre el Lento inicial y el Moderato.
3512 Presentamos en primer lugar el aspecto que queremos que tenga el
3513 resultado, pero para evitar complicar demasiado el ejemplo hemos
3514 quitado las indicaciones dinámicas, las digitaciones y el pedal.
3516 @c The following should appear as music without code
3517 @c This example should not be indexed
3518 @c line-width ensures no break
3519 @lilypond[quote,ragged-right,line-width=6\in]
3520 rhMusic = \relative {
3523 \once \override Tie.staff-position = #3.5
3527 \mergeDifferentlyHeadedOn
3528 \mergeDifferentlyDottedOn
3529 bes2.^\markup { \bold "Moderato" } r8
3535 % Reposition the c2 to the right of the merged note
3536 \once \override NoteColumn.force-hshift = #1.0
3537 % Move the c2 out of the main note column
3538 % so the merge will work
3545 % Stem on the d2 must be down to permit merging
3547 % Stem on the d2 should be invisible
3548 \tweak Stem.transparent ##t
3556 \mergeDifferentlyHeadedOff
3557 \mergeDifferentlyDottedOff
3562 lhMusic = \relative {
3564 <d g, d>1)\arpeggio |
3571 \new Staff = "RH" <<
3575 \new Staff = "LH" <<
3584 Observamos en primer lugar que la parte de la mano derecha del tercer
3585 compás requiere cuatro voces. Son las cinco corcheas unidas por una
3586 barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
3587 y el Fa sostenido negra con puntillo, que también está fundida con la
3588 corchea de su misma altura. Todo lo demás está en una sola voz, así
3589 que lo más fácil es introducir estas tres voces adicionales, en el
3590 momento en que se necesiten y de forma temporal. Si ha olvidado cómo
3591 hacerlo, lea las secciones @ref{Oigo voces} y @ref{Voces explícitas}.
3592 Aquí tomamos la decisión de utilizar voces instanciadas explícitamente
3593 para el pasaje polifónico, dado que LilyPond es más probable que pueda
3594 evitar las colisiones si todas las voces se instancian explícitamente
3597 Vamos a comenzar introduciendo las notas como dos variables y
3598 disponiendo la estructura de pentagramas en un bloque Score, y veremos
3599 qué produce LilyPond de forma predeterminada:
3601 @c line-width ensures no break
3602 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3603 rhMusic = \relative {
3609 % Start polyphonic section of four voices
3611 { c,8 d fis bes a } % continuation of main voice
3625 g2. % continuation of main voice
3629 lhMusic = \relative {
3638 \new Staff = "RH" <<
3642 \new Staff = "LH" <<
3651 Todas las notas son correctas, pero el aspecto está lejos de ser
3652 satisfactorio. La ligadura de unión choca con el cambio de compás,
3653 ciertas notas no se funden correctamente, y faltan algunos elementos de
3654 notación. En primer lugar trataremos con lo más fácil. Podemos
3655 añadir fácilmente la ligadura de expresión de la mano izquierda y la
3656 ligadura de fraseo de la mano derecha, pues todo ello se estudió en el
3657 Tutorial. Al hacerlo así obtenemos:
3659 @c line-width ensures no break
3660 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3661 rhMusic = \relative {
3667 % Start polyphonic section of four voices
3669 { c,8 d fis bes a } % continuation of main voice
3683 g2.\) % continuation of main voice
3687 lhMusic = \relative {
3696 \new Staff = "RH" <<
3700 \new Staff = "LH" <<
3709 El primer compás ahora es correcto. El segundo compás contiene un
3710 arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
3711 sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
3712 que volver e la Referencia de la Notación. Buscando la palabra
3713 @q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
3714 que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
3715 doble barra se produce por medio de la instrucción @code{\bar "||"}.
3716 Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
3717 la colisión entre la ligadura de unión y la indicación de compás.
3718 Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
3719 mover objetos anteriormente en @ref{Mover objetos}, donde dice que
3720 los objetos que están situados de forma relativa al pentagrama se
3721 pueden mover verticalmente
3722 sobreescribiendo su propiedad @code{staff-position}, que
3723 se especifica en unidades de medio espacio de pentagrama respecto de
3724 la línea central del pentagrama. Así pues, la sobreescritura
3725 siguiente colocada justo antes de la primera nota ligada subirá la
3726 ligadura 3.5 medios espacios de pentagrama por encima de la línea
3729 @code{\once \override Tie.staff-position = #3.5}
3731 Con esto se completa el compás dos, dando como resultado:
3733 @c line-width ensures no break
3734 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3735 rhMusic = \relative {
3738 \once \override Tie.staff-position = #3.5
3743 % Start polyphonic section of four voices
3745 { c,8 d fis bes a } % continuation of main voice
3759 g2.\) % continuation of main voice
3763 lhMusic = \relative {
3765 <d g, d>1)\arpeggio |
3772 \new Staff = "RH" <<
3776 \new Staff = "LH" <<
3785 Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
3786 tutorial nos enseñó cómo escribir texto en negrita mediante la
3787 instrucción @code{\markup}, por lo que añadir @qq{Moderato} en negrita
3788 es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
3789 voces? Aquí es donde debemos volver a buscar ayuda en el manual de
3790 Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
3791 el índice de la Referencia de la notación llegamos rápidamente a las
3792 instrucciones para mezclar notas con distinta cabeza y con o sin
3793 puntillo, en @ruser{Resolución de las colisiones}. En nuestro ejemplo tenemos
3794 que fusionar ambos tipos de nota en el transcurso de la sección
3795 polifónica del compás 3; por tanto, en virtud de la información que
3796 aparece en la Referencia de la Notación, escribimos
3799 \mergeDifferentlyHeadedOn
3800 \mergeDifferentlyDottedOn
3804 al principio de la sección, y
3807 \mergeDifferentlyHeadedOff
3808 \mergeDifferentlyDottedOff
3812 al final, dando como resultado:
3814 @c line-width ensures no break
3815 @lilypond[quote,ragged-right,line-width=6\in]
3816 rhMusic = \relative {
3819 \once \override Tie.staff-position = #3.5
3823 bes2.^\markup { \bold "Moderato" } r8
3824 \mergeDifferentlyHeadedOn
3825 \mergeDifferentlyDottedOn
3826 % Start polyphonic section of four voices
3828 { c,8 d fis bes a } % continuation of main voice
3842 \mergeDifferentlyHeadedOff
3843 \mergeDifferentlyDottedOff
3844 g2.\) % continuation of main voice
3848 lhMusic = \relative {
3850 <d g, d>1)\arpeggio |
3857 \new Staff = "RH" <<
3861 \new Staff = "LH" <<
3870 Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
3871 dos Re. ¿Por qué no? La respuesta está en la misma sección de la
3872 Referencia de la Notación: las notas que se fusionan deben tener las
3873 plicas en direcciones opuestas y dos notas no se pueden fusionar bien
3874 si hay una tercera nota en la misma columna. Aquí los dos Re tienen
3875 las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
3876 cambiar la dirección de la plica usando @code{\stemDown}, y la
3877 Referencia de la Notación también explica cómo mover el Do: aplicar un
3878 desplazamiento usando una de las instrucciones @code{\shift}. Pero
3879 ¿cuál? El Do está en la voz dos que tiene desactivado el
3880 desplazamiento, y los dos Re están en las voces uno y tres, que tienen
3881 el desplazamiento desactivado y activado, respectivamente. Por ello
3882 tenemos que desplazar el Do un nivel más todavía, usando
3883 @code{\shiftOnn} para evitar que interfiera con los dos Re. Al
3884 aplicar estos cambios obtenemos:
3886 @cindex Tie, ejemplo de sobreescritura
3887 @cindex staff-position, propiedad, ejemplo
3889 @c line-width ensures no break
3890 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3891 rhMusic = \relative {
3894 \once \override Tie.staff-position = #3.5
3898 bes2.^\markup { \bold "Moderato" } r8
3899 \mergeDifferentlyHeadedOn
3900 \mergeDifferentlyDottedOn
3901 % Start polyphonic section of four voices
3903 { c,8 d fis bes a } % continuation of main voice
3906 % Move the c2 out of the main note column
3907 % so the merge will work
3912 % Stem on the d2 must be down to permit merging
3920 \mergeDifferentlyHeadedOff
3921 \mergeDifferentlyDottedOff
3922 g2.\) % continuation of main voice
3926 lhMusic = \relative {
3928 <d g, d>1)\arpeggio |
3935 \new Staff = "RH" <<
3939 \new Staff = "LH" <<
3948 Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
3949 sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
3950 colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
3951 partir de trucos anteriores: hacemos la plica transparente, y movemos
3952 el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
3955 @cindex NoteColumn, ejemplo de sobreescritura
3956 @cindex force-hshift, propiedad, ejemplo
3957 @cindex Stem, ejemplo de sobreescritura
3958 @cindex transparent, propiedad, ejemplo
3960 @c line-width ensures no break
3961 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3962 rhMusic = \relative {
3965 \once \override Tie.staff-position = #3.5
3969 bes2.^\markup { \bold "Moderato" } r8
3970 \mergeDifferentlyHeadedOn
3971 \mergeDifferentlyDottedOn
3972 % Start polyphonic section of four voices
3974 { c,8 d fis bes a } % continuation of main voice
3978 % Reposition the c2 to the right of the merged note
3979 \once \override NoteColumn.force-hshift = #1.0
3980 % Move the c2 out of the main note column
3981 % so the merge will work
3988 % Stem on the d2 must be down to permit merging
3990 % Stem on the d2 should be invisible
3991 \tweak Stem.transparent ##t
3999 \mergeDifferentlyHeadedOff
4000 \mergeDifferentlyDottedOff
4001 g2.\) % continuation of main voice
4005 lhMusic = \relative {
4007 <d g, d>1)\arpeggio |
4014 \new Staff = "RH" <<
4018 \new Staff = "LH" <<
4028 @node Trucajes adicionales
4029 @section Trucajes adicionales
4030 @translationof Further tweaking
4033 * Otras aplicaciones de los trucos::
4034 * Uso de variables para los ajustes de disposición::
4036 * Otras fuentes de información::
4037 * Trucos avanzados con Scheme::
4040 @node Otras aplicaciones de los trucos
4041 @subsection Otras aplicaciones de los trucos
4042 @translationof Other uses for tweaks
4045 * Unir notas entre voces distintas::
4046 * Simulación de un calderón en el MIDI::
4049 @cindex transparent, uso de la propiedad
4050 @cindex objetos, hace invisibles
4051 @cindex eliminar objetos
4052 @cindex objetos, eliminar
4053 @cindex objetos, ocultar
4054 @cindex ocultar objetos
4055 @cindex invisibles, objetos
4056 @cindex objetos invisibles
4058 @node Unir notas entre voces distintas
4059 @unnumberedsubsubsec Unir notas entre voces distintas
4060 @translationof Tying notes across voices
4062 @cindex ligar notas entre voces distintas
4064 El ejemplo siguiente muestra cómo conectar notas que están en
4065 distintas voces utilizando ligaduras de unión. Normalmente sólo se
4066 pueden conectar mediante ligaduras de unión dos notas que estén en la
4067 misma voz. Usando dos voces, con las notas ligadas en una de ellas:
4070 << { b'8~ 8\noBeam } \\ { b'8[ g'] } >>
4074 y borrando la primera plica hacia arriba en esa voz, da la impresión
4075 de que la ligadura se cruza entre las voces:
4077 @cindex Stem, ejemplo de sobreescritura
4078 @cindex transparent, propiedad, ejemplo
4080 @lilypond[quote,fragment,relative=2,verbatim]
4083 \tweak Stem.transparent ##t
4091 Para estar seguros de que la plica que acabamos de borrar no aprieta
4092 demasiado a la ligadura, podemos alargar la plica estableciendo su
4093 valor de longitud @code{length} a @code{8},
4095 @lilypond[quote,fragment,relative=2,verbatim]
4098 \tweak Stem.transparent ##t
4099 \tweak Stem.length #8
4108 @cindex tweak, generado a partir de una sobreescritura
4109 Ahora bien, para la @emph{sobreescritura} de la transparencia de
4110 un objeto gráfico, podríamos haber usado la abreviatura
4111 @code{\hide} como se explicó anteriormente. El trucaje mediante
4112 @qq{tweak} es una operación diferente que afecta solamente a las
4113 propiedades generadas a partir de una sola expresión musical.
4114 Resulta que podemos convertir los overrides o sobreescrituras en
4115 tweaks o trucajes utilizando @code{\single}, haciendo posible
4116 volver a escribir el ejemplo anterior como
4118 @lilypond[quote,fragment,relative=2,verbatim]
4123 \tweak Stem.length #8
4131 En este caso particular, la diferencia con @code{\once \hide} no
4132 es muy apreciable. Es importante cuando existen varios objetos en
4133 el mismo punto del tiempo musical (como las notas de un acorde).
4134 En tal caso, @code{\once} afecta a todos los objetos, mientras que
4135 @code{\single} solo afecta a uno, aquél que se genera por parte de
4136 la expresión musical que le sigue inmediatamente.
4138 @node Simulación de un calderón en el MIDI
4139 @unnumberedsubsubsec Simulación de un calderón en el MIDI
4140 @translationof Simulating a fermata in MIDI
4142 @cindex sello, uso de la propiedad
4143 @cindex fermata, realización en MIDI
4145 Para los objetos fuera-del-pentagrama, normalmente es mejor
4146 sobreescribir la propiedad @code{stencil} («sello») del objeto que su
4147 propiedad @code{transparent} cuando desee quitarlos de la salida
4148 impresa. Mediante el establecimiento de la propiedad @code{stencil}
4149 de un objeto al valor @code{#f} podemos quitar el objeto por completo
4150 de la salida impresa. Esto significa que no tiene efecto sobre la
4151 colocación de otros objetos que pudieran colocarse en relación a él.
4153 Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
4154 propósito de simular un calderón en la salida MIDI, seguramente no
4155 querríamos que la indicación metronómica apareciese en la salida
4156 impresa, y no querríamos influir sobre la separación entre los dos
4157 sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
4158 pentagrama. Por lo tanto, establecer su propiedad @code{stencil} al
4159 valor @code{#f} sería la mejor manera. Mostramos aquí el efecto de
4162 @cindex MetronomeMark, ejemplo de sobreescritura
4163 @cindex transparent, propiedad, ejemplo
4165 @lilypond[quote,verbatim,ragged-right]
4168 % Visible tempo marking
4171 \once \hide Score.MetronomeMark
4172 % Invisible tempo marking to lengthen fermata in MIDI
4175 % New tempo for next section
4184 @cindex MetronomeMark, ejemplo de sobreescritura
4185 @cindex stencil, propiedad, ejemplo
4187 @lilypond[quote,verbatim,ragged-right]
4190 % Visible tempo marking
4193 \once \override Score.MetronomeMark.stencil = ##f
4194 % Invisible tempo marking to lengthen fermata in MIDI
4197 % New tempo for next section
4207 Ambos métodos quitan de la salida impresa la indicación metronómica
4208 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
4209 queríamos, pero la indicación metronómica transparente de la primera
4210 línea fuerza una colocación muy alta de la indicación de tempo que
4211 sigue, mientras que la segunda (con el sello suprimido) no lo hace.
4217 @node Uso de variables para los ajustes de disposición
4218 @subsection Uso de variables para los ajustes de disposición
4219 @translationof Using variables for layout adjustments
4221 @cindex variables, usar para sobreescrituras
4222 @cindex sobreescrituras, usar variablas para
4223 @cindex ajustes, usar variables para
4224 @cindex ajustes de disposición, usar variables para hacer
4226 Las instrucciones de sobreescritura son con frecuencia largas y
4227 tediosas de escribir, y se tienen que escribir de forma absolutamente
4228 correcta. Si las mismas sobreescrituras se van a utilizar muchas
4229 veces, podría merecer la pena definir variables para guardarlas.
4231 Supongamos que queremos realzar ciertas palabras de la letra de una
4232 canción imprimiéndolas en cursiva y negrita. Las instrucciones
4233 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
4234 canciones si están incluidas, junto con la palabra o palabras que se
4235 pretenden modificar, dentro de un @code{\markup}, lo que las hace
4236 tediosas de escribir. La necesidad de incluir las propias palabras
4237 impide que se puedan usar en variables simples. ¿Podríamos, como
4238 alternativa, utilizar las instrucciones @code{\override} y
4242 @code{\override Lyrics.LyricText.font-shape = #'italic}
4243 @code{\override Lyrics.LyricText.font-series = #'bold}
4245 @code{\revert Lyrics.LyricText.font-shape}
4246 @code{\revert Lyrics.LyricText.font-series}
4249 Estas instrucciones también serían extremadamente tediosas de escribir
4250 si hubiera muchas palabras que quisiéramos subrayar. Pero sí
4251 @emph{podemos} definirlas como dos variables y usarlas para delimitar
4252 las palabras que destacar. Otra ventaja de la utilización de
4253 variables para estas sobreescrituras es que ya no son necesarios los
4254 espacios que rodean al punto, puesto que no se interpretan
4255 directamente en el modo @code{\lyricmode}. He aquí un ejemplo de
4256 esto, aunque en la práctica quizá elegiríamos unos nombres de variable
4257 más cortos para que fueran más rápidos de teclear:
4259 @cindex LyricText, ejemplo de sobreescritura
4260 @cindex font-shape, propiedad, ejemplo
4261 @cindex font-series, propiedad, ejemplo
4263 @lilypond[quote,verbatim]
4265 \override Lyrics.LyricText.font-shape = #'italic
4266 \override Lyrics.LyricText.font-series = #'bold
4270 \revert Lyrics.LyricText.font-shape
4271 \revert Lyrics.LyricText.font-series
4274 global = { \key c \major \time 4/4 \partial 4 }
4276 SopranoMusic = \relative { c'4 | e4. e8 g4 g | a4 a g }
4277 AltoMusic = \relative { c'4 | c4. c8 e4 e | f4 f e }
4278 TenorMusic = \relative { e4 | g4. g8 c4. b8 | a8 b c d e4 }
4279 BassMusic = \relative { c4 | c4. c8 c4 c | f8 g a b c4 }
4281 VerseOne = \lyrics {
4282 E -- | ter -- nal \emphasize Fa -- ther, | \normal strong to save,
4285 VerseTwo = \lyricmode {
4286 O | \once \emphasize Christ, whose voice the | wa -- ters heard,
4289 VerseThree = \lyricmode {
4290 O | \emphasize Ho -- ly Spi -- rit, | \normal who didst brood
4293 VerseFour = \lyricmode {
4294 O | \emphasize Tri -- ni -- ty \normal of | love and pow'r
4301 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
4302 \new Voice = "Alto" { \voiceTwo \AltoMusic }
4303 \new Lyrics \lyricsto "Soprano" { \VerseOne }
4304 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
4305 \new Lyrics \lyricsto "Soprano" { \VerseThree }
4306 \new Lyrics \lyricsto "Soprano" { \VerseFour }
4310 \new Voice = "Tenor" { \voiceOne \TenorMusic }
4311 \new Voice = "Bass" { \voiceTwo \BassMusic }
4318 @node Hojas de estilo
4319 @subsection Hojas de estilo
4320 @translationof Style sheets
4322 La salida que produce LilyPond se puede modificar profundamente;
4323 consulte @ref{Trucar la salida} para leer detalles sobre este asunto.
4324 Pero ¿qué ocurre si tiene muchos archivos a los que les quiere aplicar
4325 sus propios trucos? O ¿qué ocurre si, sencillamente, quiere separar
4326 los trucos de la propia música? Todo esto es bastante fácil de
4329 Veamos un ejemplo. No se preocupe si no entiende
4330 las partes que tienen todos los @code{#()}. Esto se explicará en
4331 @ref{Trucos avanzados con Scheme}.
4333 @lilypond[quote,verbatim,ragged-right]
4335 \tweak self-alignment-X #-0.6
4336 #(make-dynamic-script
4337 #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4340 #(define-music-function
4343 #{ <>^\markup \bold \box #string #})
4347 a'4.\mpdolce d8 cis4--\glissando a |
4351 g8(\! fis)-. e( d)-. cis2 |
4355 Hagamos algo respecto a las definiciones @code{mpdolce} e
4356 @code{inst}. Éstas producen la salida que deseamos, pero quizá las
4357 querríamos utilizar en otra pieza. Podríamos simplemente copiarlas y
4358 pegarlas al principio de cada archivo, pero sería bastante molesto.
4359 También hace que se queden las definiciones a la vista dentro de
4360 nuestros archivos de música, y yo personalmente encuentro todos los
4361 @code{#()} bastante poco estéticos. Los vamos a esconder dentro de
4365 %%% guardar esto en un archivo con el nombre "definiciones.ily"
4367 \tweak self-alignment-X #-0.6
4368 #(make-dynamic-script
4369 #@{ \markup @{ \dynamic mp \normal-text \italic \bold dolce @} #@})
4372 #(define-music-function
4375 #@{ <>^\markup \bold \box #string #@})
4378 Haremos referencia a este archivo utilizando la instrucción
4379 @code{\include} al principio del archivo de música (la extensión
4380 @code{.ily} se utiliza para distinguir este archivo de inclusión --que
4381 se supone que no debe ser procesado de forma independiente-- del
4382 archivo principal). Ahora modificaremos la música (guardemos este
4383 archivo como @file{musica.ly}).
4385 @c We have to do this awkward example/lilypond-non-verbatim
4386 @c because we can't do the \include stuff in the manual.
4389 \include "definiciones.ily"
4393 a'4.\mpdolce d8 cis4--\glissando a |
4397 g8(\! fis)-. e( d)-. cis2 |
4401 @lilypond[quote,ragged-right]
4403 \tweak self-alignment-X #-0.6
4404 #(make-dynamic-script
4405 #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4408 #(define-music-function
4411 #{ <>^\markup \bold \box #string #})
4415 a'4.\mpdolce d8 cis4--\glissando a |
4419 g8(\! fis)-. e( d)-. cis2 |
4423 Eso tiene mejor aspecto, pero haremos algunos cambios más. El
4424 glissando es difícil de ver, así que lo haremos más grueso y lo
4425 acercaremos a las cabezas de las notas. Pondremos la indicación
4426 metronómica encima de la clave, en lugar de ir encima de la primera
4427 nota. Y por último, mi profesor de composición odia las indicaciones
4428 de compás @q{C}, así que la convertiremos en @q{4/4}.
4430 Sin embargo, no debemos cambiar el archivo @file{musica.ly}.
4431 Sustituyamos nuestro archivo @file{definiciones.ily} con éste:
4434 %%% definiciones.ily
4436 \tweak self-alignment-X #-0.6
4437 #(make-dynamic-script
4438 #@{ \markup @{ \dynamic mp \normal-text \italic \bold dolce @} #@})
4441 #(define-music-function
4444 #@{ <>^\markup \bold \box #string #@})
4449 \override MetronomeMark.extra-offset = #'(-5 . 0)
4450 \override MetronomeMark.padding = #'3
4454 \override TimeSignature.style = #'numbered
4458 \override Glissando.thickness = #3
4459 \override Glissando.gap = #0.1
4464 @lilypond[quote,ragged-right]
4466 \tweak self-alignment-X #-0.6
4467 #(make-dynamic-script
4468 #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4471 #(define-music-function
4474 #{ <>^\markup \bold \box #string #})
4479 \override MetronomeMark.extra-offset = #'(-5 . 0)
4480 \override MetronomeMark.padding = #'3
4484 \override TimeSignature.style = #'numbered
4488 \override Glissando.thickness = #3
4489 \override Glissando.gap = #0.1
4495 a'4.\mpdolce d8 cis4--\glissando a |
4499 g8(\! fis)-. e( d)-. cis2 |
4503 ¡Eso tiene un aspecto mucho mejor! Ahora suponga que quiere publicar
4504 esta pieza. A mi profesor de composición no le gustan las
4505 indicaciones de compás @q{C}, pero yo les tengo cierto cariño.
4506 Copiaremos el archivo actual @file{definiciones.ily} a
4507 @file{publicar-web.ily} y modificaremos éste. Como el propósito de
4508 esta música es producir un PDF que va a mostrarse en la pantalla,
4509 también vamos a aumentar el tamaño general de la salida.
4512 %%% publicar-web.ily
4514 \tweak self-alignment-X #-0.6
4515 #(make-dynamic-script
4516 #@{ \markup @{ \dynamic mp \normal-text \italic \bold dolce @} #@})
4519 #(define-music-function
4522 #@{ <>^\markup \bold \box #string #@})
4524 #(set-global-staff-size 23)
4529 \override MetronomeMark.extra-offset = #'(-5 . 0)
4530 \override MetronomeMark.padding = #'3
4537 \override Glissando.thickness = #3
4538 \override Glissando.gap = #0.1
4543 @lilypond[quote,ragged-right]
4545 \tweak self-alignment-X #-0.6
4546 #(make-dynamic-script
4547 #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4550 #(define-music-function
4553 #{ <>^\markup \bold \box #string #})
4555 #(set-global-staff-size 23)
4559 \override MetronomeMark.extra-offset = #'(-5 . 0)
4560 \override MetronomeMark.padding = #'3
4563 \override Glissando.thickness = #3
4564 \override Glissando.gap = #0.1
4570 a'4.\mpdolce d8 cis4--\glissando a |
4574 g8(\! fis)-. e( d)-. cis2 |
4578 Ahora, en la música, simplemente sustituyo @code{\include
4579 "definiciones.ily"} por @code{\include "publicar-web.ily"}. Por
4580 supuesto, podríamos hacer esto aún más práctico. Podríamos hacer un
4581 archivo @file{definiciones.ily} que contuviera solamente las
4582 definiciones de @code{mpdolce} y de @code{inst}, un archivo
4583 @file{publicar-web.ily} que contuviera solamente la sección
4584 @code{\layout} que se mostró en el ejemplo, y un archivo
4585 @file{universidad.ily} que contendría solamente los trucos para
4586 producir la salida que le gusta a mi profesor. El comienzo de
4587 @file{musica.ly} tendría entonces este aspecto:
4590 \include "definiciones.ily"
4592 %%% ¡Quitar el comentario de una sola de estas líneas!
4593 \include "publicar-web.ily"
4594 %\include "universidad.ily"
4597 Este enfoque puede ser útil incluso si va a producir sólo un conjunto
4598 de particellas. Yo utilizo media docena de archivos de @q{hojas de
4599 estilo} para mis proyectos. Comienzo todos los archivos de música con
4600 @code{\include "../global.ily"}, que contiene
4604 \version @w{"@version{}"}
4606 #(ly:set-option 'point-and-click #f)
4608 \include "../iniciar/iniciar-definiciones.ily"
4609 \include "../iniciar/iniciar-disposicion.ily"
4610 \include "../iniciar/iniciar-cabeceras.ily"
4611 \include "../iniciar/iniciar-papel.ily"
4615 @node Otras fuentes de información
4616 @subsection Otras fuentes de información
4617 @translationof Other sources of information
4619 La documentación del manual de Referencia de Funcionamiento Interno
4620 contiene montañas de información sobre LilyPond, pero se puede obtener
4621 más información aún leyendo los archivos internos de LilyPond. Para
4622 echarles un vistazo, en primer lugar debe buscar la carpeta
4623 correspondiente a su sistema. La ubicación de esta carpeta depende
4624 (a) de si consiguió el programa LilyPond descargando un binario
4625 precompilado desde el sitio web lilypond.org o si lo instaló mediante
4626 un gestor de paquetes (es decir, distribuido con GNU/Linux, o instalado
4627 bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
4628 qué sistema operativo está utilizando:
4630 @subsubsubheading Descargado de lilypond.org
4637 @file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/@/share/lilypond/current/}
4644 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/@/Resources/share/lilypond/current/}
4647 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
4648 bien manteniendo pulsada la tecla de Control y haciendo click sobre la
4649 aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
4654 Mediante el Explorador de Windows, diríjase a
4656 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/@/share/lilypond/current/}
4661 @subsubsubheading Instalado mediante un gestor de paquetes o compilado a partir de la fuente
4664 @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
4665 se encuentra determinado por su administrador de paquetes o guión
4666 @code{configure}, y @var{X.Y.Z} es el número de la versión de
4671 Dentro de esta carpeta, las dos subcarpetas interesantes son
4674 @item @file{ly/} - contiene archivos en formato LilyPond
4675 @item @file{scm/} - contiene archivos en formato Scheme
4678 Vamos a comenzar observando algunos archivos que están en @file{ly/}.
4679 Abra @file{ly/property-init.ly} con un editor de textos. El mismo que
4680 usaría normalmente para los archivos @file{.ly} servirá perfectamente.
4681 Este archivo contiene las definiciones de todas las instrucciones
4682 estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} y
4683 @code{\slurDotted}. Podrá ver que no son nada más que definiciones de
4684 variables que contienen una o varias instrucciones @code{\override}.
4685 Por ejemplo, @code{/tieDotted} está definido de tal forma que su valor
4690 \override Tie.dash-period = #0.75
4691 \override Tie.dash-fraction = #0.1
4695 Si no le gustan los valores predeterminados, estas instrucciones
4696 predefinidas se pueden redefinir con facilidad como cualquier otra
4697 variable, al principio de su archivo de código de entrada.
4699 Los siguientes son los archivos más útiles que se encuentran en
4702 @multitable @columnfractions .4 .6
4705 @item @file{ly/engraver-init.ly}
4706 @tab Definiciones de Contextos de grabadores
4707 @item @file{ly/paper-defaults-init.ly}
4708 @tab especificaciones de valores predeterminados relacionados con el papel
4709 @item @file{ly/performer-init.ly}
4710 @tab Definiciones de Contextos de interpretación
4711 @item @file{ly/property-init.ly}
4712 @tab Definiciones de todas las instrucciones predefinidas que son comunes
4713 @item @file{ly/spanner-init.ly}
4714 @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
4717 Otros ajustes (como las definiciones de las instrucciones de marcado)
4718 se almacenan como archivos @file{.scm} (de Scheme). El lenguaje de
4719 programación Scheme se utiliza para proporcionar un interfaz
4720 programable en el funcionamiento interno de LilyPond. Cualquier
4721 explicación adicional sobre estos archivos se encuentra por el momento
4722 fuera del ámbito de este manual, porque se requieren conocimientos del
4723 lenguaje Scheme. Se advierte a los usuarios que se necesita una
4724 importante cantidad de conocimientos técnicos o de tiempo para
4725 comprender el lenguaje Scheme y estos archivos (véase @rextend{Tutorial de Scheme}).
4727 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
4730 @multitable @columnfractions .4 .6
4733 @item @file{scm/auto-beam.scm}
4734 @tab Valores predeterminados de sub-barrado
4735 @item @file{scm/define-grobs.scm}
4736 @tab valores predeterminados de las propiedades de grobs
4737 @item @file{scm/define-markup-commands.scm}
4738 @tab Especificar todas las instrucciones de marcado
4739 @item @file{scm/midi.scm}
4740 @tab Ajustes predeterminados para la salida MIDI
4741 @item @file{scm/output-lib.scm}
4742 @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
4743 @item @file{scm/parser-clef.scm}
4744 @tab Definiciones de las claves contempladas
4745 @item @file{scm/script.scm}
4746 @tab Ajustes predeterminados para las articulaciones
4750 @node Trucos avanzados con Scheme
4751 @subsection Trucos avanzados con Scheme
4752 @translationof Advanced tweaks with Scheme
4754 Aunque es posible hacer muchas cosas con las instrucciones
4755 @code{\override} y @code{\tweak} , tenemos una forma incluso más
4756 poderosa de modificar el funcionamiento de LilyPond, a través de un
4757 interface programable hacia las operaciones internas de LilyPond. Se
4758 puede incorporar código escrito en el lenguaje de programación Scheme,
4759 directamente en el mecanismo de funcionamiento de LilyPond. Por
4760 supuesto, para hacer esto se necesitan al menos unos conocimientos
4761 básicos de programación en Scheme, y damos una introducción en el
4762 @rextend{Tutorial de Scheme}.
4764 Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
4765 dar a una propiedad un valor constante, se puede establecer al
4766 resultado de un procedimiento de Scheme que se invoca cada vez que
4767 LilyPond accede a esta propiedad. La propiedad se puede establecer
4768 dinámicamente a un valor determinado por el procedimiento en el
4769 momento en que se invoca. En este ejemplo damos a las cabezas de las
4770 notas un color que depende de su posición dentro del pentagrama.
4772 @cindex x11-color, función, ejemplo de utilización
4773 @cindex NoteHead, ejemplo de sobreescritura
4774 @cindex color, propiedad, establecer a procedimiento de Scheme
4776 @lilypond[quote,verbatim,ragged-right]
4777 #(define (color-notehead grob)
4778 "Color the notehead according to its position on the staff."
4779 (let ((mod-position (modulo (ly:grob-property grob 'staff-position)
4782 ;; Return rainbow colors
4783 ((1) (x11-color 'red )) ; for C
4784 ((2) (x11-color 'orange )) ; for D
4785 ((3) (x11-color 'yellow )) ; for E
4786 ((4) (x11-color 'green )) ; for F
4787 ((5) (x11-color 'blue )) ; for G
4788 ((6) (x11-color 'purple )) ; for A
4789 ((0) (x11-color 'violet )) ; for B
4793 % Arrange to obtain color from color-notehead procedure
4794 \override NoteHead.color = #color-notehead
4795 a2 b | c2 d | e2 f | g2 a |
4799 Se pueden encontrar ejemplos adicionales que muestran la utilización
4800 de estos interfaces programables, en
4801 @rextendnamed{Callback functions,Funciones de callback}.