1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: f3e8b5f9b68cab4579873749f4648ba63bc92ac7
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 * The \tweak command::
196 @node La instrucción \override
197 @unnumberedsubsubsec La instrucción @code{\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,fragment,ragged-right,verbatim,relative=1]
266 \override NoteHead.color = #red
268 \override NoteHead.color = #green
273 @node La instrucción \revert
274 @unnumberedsubsubsec La instrucción @code{\revert}
275 @translationof The \revert command
277 @cindex revert, instrucción
282 Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
283 se sobreescribe de nuevo o se encuentra una instrucción
284 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
285 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
286 valor predeterminado original; observe que no es a su valor previo si
287 se han utilizado varias instrucciones @code{\override}.
290 \revert @var{Contexto}.@var{ObjetoDePresentación}.@var{propiedad-de-presentación}
293 Una vez más, igual que @var{Contexto} dentro de la instrucción
294 @code{\override}, con frecuencia no es necesario especificar el
295 @var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
296 Aquí devolvemos el color de la cabeza al valor predeterminado para las
299 @cindex color, propiedad, ejemplo
300 @cindex NoteHead, ejemplo de sobreescritura
302 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
304 \override NoteHead.color = #red
306 \override NoteHead.color = #green
308 \revert NoteHead.color
313 @node El prefijo \once
314 @unnumberedsubsubsec El prefijo @code{\once}
315 @translationof The \once prefix
320 Tanto la instrucción @code{\override} como @code{\set} se pueden
321 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
322 @code{\override} o @code{\set} sea efectiva solamente durante el
323 tiempo musical en curso y antes de que la propiedad vuelva a tener
324 otra vez su valor anterior (que puede ser distinto de su valor
325 predeterminado si aún se está aplicando otra instrucción
326 @code{\override} de sobreescritura). Utilizando el mismo ejemplo,
327 podemos cambiar el color de una sola nota de la siguiente manera:
329 @cindex color, propiedad, ejemplo
330 @cindex NoteHead, ejemplo de sobreescritura
332 @lilypond[quote,verbatim,relative=1]
334 \override NoteHead.color = #red
336 \once \override NoteHead.color = #green
338 \revert NoteHead.color
342 El prefijo @code{\once} también se puede usar delante de muchas
343 instrucciones predefinidas para limitar su efecto a un solo momento
346 @lilypond[quote,verbatim,relative=1]
355 Sin embargo, las instrucciones predefinidas de la forma
356 @code{\@dots{}Neutral},
357 @code{\@dots{}Off} y @code{\un@dots{}} utilizan
358 internamente @code{\revert} en vez de @code{\override}, por lo que
359 añadir @code{\once} como prefijo aquí no tiene ningún efecto.
362 @node La instrucción \overrideProperty
363 @unnumberedsubsubsec La instrucción @code{\overrideProperty}
364 @translationof The \overrideProperty command
366 @cindex overrideProperty, instrucción
368 @funindex \overrideProperty
369 @funindex overrideProperty
371 Hay otra forma para la instrucción de sobreescritura,
372 @code{\overrideProperty}, que ocasionalmente es necesaria. La
373 mencionamos aquí con un propósito de exhaustividad, pero para ver más
374 detalles consulte @rextend{Trucos difíciles}.
375 @c Maybe explain in a later iteration -td
378 @node The \tweak command
379 @unnumberedsubsubsec The @code{\tweak} command
381 @cindex tweak, instrucción
386 La última instrucción de trucaje que está disponible es @code{\tweak}.
387 Se debe utilizar cuando varios objetos tienen lugar
388 en el mismo momento musical pero solo queremos cambiar las propiedades
389 de algunos de ellos, como una sola nota dentro de un acorde.
391 @code{\override} para la sobreescritura afectaría a todas las notas
392 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
393 elemento del flujo de entrada.
395 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
396 cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
397 primer lugar, veamos lo que haría @code{\once \override}:
399 @cindex font-size, propiedad, ejemplo
400 @cindex NoteHead, ejemplo de sobreescritura
402 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
404 \once \override NoteHead.font-size = #-3
409 Vemos que la sobreescritura con override afecta a @emph{todas} las
410 cabezas de las notas del acorde. Esto es así porque todas las notas
411 de un acorde ocurren en el mismo @emph{momento musical}, y la acción
412 de @code{\once} es aplicar la sobreescritura a todos los objetos de
413 presentación del tipo especificado que ocurren en el mismo momento
414 musical que la propia instrucción de sobreescritura @code{\override}.
416 La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
417 el elemento inmediatamente siguiente dentro del flujo de entrada.
418 En su forma más sencilla es efectivo solamente sobre objetos
419 que se crean directamente
420 a partir del elemento siguiente, en esencia las cabezas y las
423 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
424 se cambiaría de la siguiente forma:
426 @cindex font-size, propiedad, ejemplo
427 @cindex @code{\tweak}, ejemplo
429 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
431 <c \tweak font-size #-3 e g>4
434 Observe que la sintaxis de @code{\tweak} no es igual que la de
435 @code{\override}. El contexto no se
436 debe especificar; de hecho, generaría un error hacerlo.
437 Tanto el contexto como el objeto de presentación
438 están implícitos por el siguiente elemento del flujo de entrada.
439 Observe también que no debe haber un signo igual. Así que la sintaxis
440 de la instrucción @code{\tweak} en su forma sencilla es:
443 \tweak @var{propiedad-de-presentación} #@var{valor}
446 Una instrucción @code{\tweak} también se puede usar para modificar
447 sólo una de una serie de articulaciones, como se muestra aquí:
449 @cindex color, propiedad, ejemplo
450 @cindex @code{\tweak}, ejemplo
452 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
454 -\tweak color #red ^"Red"
455 -\tweak color #green _"Green"
459 Observe que la instrucción @code{\tweak} debe venir precedida de una
460 marca de articulación porque la propia expresión trucada debe aplicarse
461 como una articulación. En el caso de más de una sobreescritura de dirección
462 (@code{^} o @code{_}), gana la sobreescritura situada más a la izquierda
463 porque se aplica en último lugar.
465 @cindex @code{\tweak}, Accidental
466 @cindex @code{\tweak}, specific layout object
468 Los objetos tales como plicas y alteraciones accidentales se crean más
469 tarde, y no directamente a partir del evento que viene a continuación.
470 Aún es posible utilizar @code{\tweak} sobre tales objetos creados
471 indirectamente mediante el nombrado explícito del objeto de
472 presentación, siempre y cuando LilyPond pueda rastrear su origen hasta
475 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
476 <\tweak Accidental.color #red cis4
477 \tweak Accidental.color #green es
481 Esta forma extensa de la instrucción @code{\tweak} se puede describir
484 \tweak @var{objeto-de-presentación}.@var{propiedad-de-presentación} @var{valor}
487 @cindex grupos especiales anidados
488 @cindex tresillos anidados
489 @cindex corchete del grupo especial
490 @cindex corchete de tresillo
491 @cindex grupo especial, corchete de
492 @cindex tresillo, corchete de
494 @funindex TupletBracket
496 La instrucción @code{\tweak} también se debe usar para cambiar la
497 apariencia de uno solo de un conjunto de grupos especiales anidados
498 que comiencen en el mismo instante musical. En el siguiente ejemplo,
499 el corchete del tresillo largo y el primero de los tres corchetes
500 cortos empiezan en el mismo momento musical, y por ello cualquier
501 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
502 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
503 @code{\tweak} especifica que el corchete del tresillo largo se debe
504 colocar por encima de las notas y el segundo especifica que el número
505 del tresillo se debe imprimir en rojo sobre el corchete del primer
508 @cindex @code{\tweak}, ejemplo
509 @cindex direction, propiedad, ejemplo
510 @cindex color, propiedad, ejemplo
512 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
516 \tuplet 3/2 { c8[ c c] }
517 \tuplet 3/2 { c8[ c c] }
518 \tuplet 3/2 { c8[ c c] }
522 Si los grupos anidados no comienzan en el mismo momento, su apariencia
523 se puede modificar de la forma usual mediante instrucciones
526 @cindex text, propiedad, ejemplo
527 @cindex tuplet-number, función, ejemplo
528 @cindex transparent, propiedad, ejemplo
529 @cindex TupletNumber, ejemplo de sobreescritura
531 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
532 \tuplet 3/2 { c8[ c c] }
533 \once \override TupletNumber.text = #tuplet-number::calc-fraction-text
537 \once \override TupletNumber.transparent = ##t
538 \tuplet 3/2 { c8[ c c] }
539 \tuplet 3/2 { c8[ c c] }
545 Referencia de la notación:
546 @ruser{La instrucción tweak}.
549 @node Manual de referencia de funcionamiento interno
550 @section Manual de referencia de funcionamiento interno
551 @translationof The Internals Reference manual
553 @cindex Internals Reference
556 * Propiedades de los objetos de presentación::
557 * Propiedades de los interfaces::
558 * Tipos de propiedades::
561 @node Propiedades de los objetos de presentación
562 @subsection Propiedades de los objetos de presentación
563 @translationof Properties of layout objects
565 @cindex propiedades de los objetos de presentación
566 @cindex propiedades de los grobs
567 @cindex grobs, propiedades de
568 @cindex presentación, propiedades de los objetos de
569 @cindex Referencia de funcionamiento interno
571 Suponga que tiene una partitura con una ligadura de expresión que para
572 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
573 debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
574 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
575 piensa que una cierta instrucción de sobreescritura @code{\override}
576 será necesaria. Pero ¿existe una propiedad de grosor para las
577 ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
578 interviene el Manual de Funcionamiento Interno. Contiene toda la
579 información que puede necesitar para construir ésta y todas las demás
580 instrucciones @code{\override}, de sobreescritura.
582 Una advertencia antes de dirigir nuestra mirada a la referencia de
583 funcionamiento interno. Éste es un documento de @strong{referencia},
584 lo que significa que hay pocas o ninguna explicación en él: su
585 propósito es presentar la información de forma precisa y concisa. Por
586 tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
587 La guía y las explicaciones que presentamos aquí le permitirán extraer
588 la información de la referencia de funcionamiento interno por sí mismo
589 con tan sólo algo de práctica.
591 @cindex sobreescritura, ejemplo de
592 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
593 @cindex @code{\addlyrics}, ejemplo
595 Utilicemos un ejemplo concreto con un sencillo fragmento de música
598 @c Mozart, dúo, núm. 7 de La Flauta Mágica
600 @lilypond[quote,verbatim,relative=2]
605 r4 bes8 bes[( g]) g |
606 g8[( es]) es d[( f]) as |
610 The man who | feels love's sweet e -- | mo -- tion
615 Suponga ahora que decidimos que nos gustan las ligaduras algo más
616 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
617 presentación, así que la cuestión es @q{¿Hay una propiedad
618 perteneciente a las ligaduras de expresión que controle su grosor?}
619 Para responder a esta pregunta debemos mirar el manual de Referencia
620 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
621 (Internals Reference) en inglés}.
623 El RFI de la versión de LilyPond que está usando se puede encontrar en
624 la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
625 página de la documentación y siga el enlace Manual de Referencia de
626 Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
627 sería mejor que utilizase la versión en HTML, no la @q{en una sola
628 página} ni el PDF. Para que los siguientes párrafos tengan algún
629 sentido deberá consultarlo realmente al tiempo que lee.
631 @c Link names in English as those pages are not yet translated. FV
632 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
633 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
634 información sobre los objetos de presentación. Una vez allí, bajo el
635 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
636 objects}. La página que aparece relaciona todos los objetos de
637 presentación que se usan en su versión de LilyPond, en orden
638 alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
639 relacionadas las propiedades de las ligaduras de expresión o Slurs.
641 Una forma alternativa de encontrar esta página es a partir de la
642 Referencia de la Notación. En una de las páginas que tratan de las
643 ligaduras de expresión podrá encontrar un enlace al manual de
644 referencia del funcionamiento interno. Este enlace le llevará
645 directamente a esta página, aunque si tiene una idea del nombre del
646 objeto de presentación que pretende trucar, le resultará más fácil ir
647 directamente al RFI y buscar allí.
649 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
650 dice en primer lugar que los objetos Slur se crean por el grabador
651 Slur_engraver. A continuación relaciona los ajustes estándar.
652 Navegue por ellos buscando una propiedad que pudiera controlar
653 el grosor de las ligaduras, y encontrará
656 @code{thickness} (number)
658 Line thickness, generally measured in @code{line-thickness}
661 Esto promete ser una buena opción para cambiar el grosor. Nos dice
662 que el valor de @code{thickness} es un simple @emph{número}, que el
663 valor predeterminado es 1.2, y que las unidades están dentro de otra
664 propiedad llamada @code{line-thickness}.
666 Como dijimos con anterioridad, existen entre pocas y ninguna
667 explicación en el RFI, pero ya tenemos información suficiente para
668 probar a cambiar el grosor de la ligadura. Vemos que el nombre del
669 objeto de presentación es @code{Slur}, que el nombre de la propiedad
670 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
671 un número algo más grande que 1.2 si queremos hacer las ligaduras más
674 Ahora podemos construir la instrucción de sobreescritura
675 @code{\override} simplemente mediante la sustitución de los valores
676 que hemos encontrado para los nombres, omitiendo el contexto.
677 Usaremos un valor muy grande para el grosor al principio, para estar
678 seguros de que la instrucción está funcionando. Obtenemos lo
682 \override Slur.thickness = #5.0
685 ¡No olvide el @code{#'} antes del nombre de la propiedad y@tie{}@code{#}
686 antes del valor nuevo!
688 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
689 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
690 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
691 cerca de ella.} Hagámoslo así:
693 @cindex Slur, ejemplo de sobreescritura
694 @cindex thickness, propiedad, ejemplo
696 @lilypond[quote,verbatim,relative=2]
701 % Increase thickness of all following slurs from 1.2 to 5.0
702 \override Slur.thickness = #5.0
703 r4 bes8 bes[( g]) g |
704 g8[( es]) es d[( f]) as |
708 The man who | feels love's sweet e -- | mo -- tion
714 y podemos ver que la ligadura, es sin duda, más pesada.
716 Así pues, ésta es la forma básica de construir instrucciones
717 @code{\override} o de sobreescritura. Existen unas cuantas
718 complicaciones más con las que nos encontraremos en secciones
719 posteriores, pero ahora conoce todos los principios esenciales que
720 necesita para hacerlo por sí mismo (aunque aún necesita algo de
721 práctica). La cual vendrá proporcionada por los ejemplos que vienen a
724 @subsubsubheading Búsqueda del contexto
726 @cindex contexto, encontrar
727 @cindex contexto, buscar el, correcto
729 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
730 especificar el contexto? ¿Cuál sería? Podemos suponer que las
731 ligaduras están en el contexto de Voz, por estar claramente asociados
732 de manera estrecha con las líneas individuales de música, pero
733 ¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
734 de la página del RFI que describe las ligaduras (Slur), donde dice
735 @q{Slur objects are created by: Slur engraver} («Los objetos de
736 ligadura de expresión se crean por: el grabador Slur»). Así pues, las
737 ligaduras de expresión se crean en cualquier contexto en el que se
738 encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
739 página del grabador @code{Slur_engraver}. Al final del todo, dice que
740 el grabador @code{Slur_engraver} es parte de siete contextos de voz,
741 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
742 suposición era acertada. Y a causa de que @code{Voice} es uno de los
743 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
744 por el hecho de que estamos escribiendo notas, podemos omitirlo en
747 @subsubsubheading Sobreescritura por una sola vez
749 @cindex sobreescritura por una sola vez
750 @cindex once override
755 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
756 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
757 ligadura fuese más gruesa? Esto se consigue con la instrucción o
758 prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
759 @code{\override} ocasiona que solamente cambie la ligadura que
760 comienza en la nota @strong{inmediata siguiente}. Si la nota
761 inmediata siguiente no da inicio a una ligadura, la instrucción no
762 tiene ningún efecto en absoluto: no se recuerda hasta que se
763 encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
764 la instrucción que lleva @code{\once} se debe reposicionar de la forma
767 @cindex Slur, ejemplo de sobreescritura
768 @cindex thickness, propiedad, ejemplo
770 @lilypond[quote,verbatim,relative=2]
776 % Increase thickness of immediately following slur only
777 \once \override Slur.thickness = #5.0
779 g8[( es]) es d[( f]) as |
783 The man who | feels love's sweet e -- | mo -- tion
789 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
791 La instrucción o prefijo @code{\once} también se puede usar antes de
792 la instrucción @code{\set}.
794 @subsubsubheading Recuperación del ajuste
797 @cindex predeterminadas, recuperar las propiedades
802 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
803 fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
804 una de ellas precedida por el prefijo @code{\once}, situadas
805 inmediatamente antes de cada una de las notas en que comienzan las
808 @cindex Slur, ejemplo de sobreescritura
809 @cindex thickness, propiedad, ejemplo
811 @lilypond[quote,verbatim,relative=2]
817 % Increase thickness of immediately following slur only
818 \once \override Slur.thickness = #5.0
820 % Increase thickness of immediately following slur only
821 \once \override Slur.thickness = #5.0
822 g8[( es]) es d[( f]) as |
826 The man who | feels love's sweet e -- | mo -- tion
832 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
833 instrucción @code{\revert} (restablecer) para devolver la propiedad
834 del grosor, @code{thickness}, a su valor predeterminado después de la
837 @cindex Slur, ejemplo de sobreescritura
838 @cindex thickness, propiedad, ejemplo
840 @lilypond[quote,verbatim,relative=2]
846 % Increase thickness of all following slurs from 1.2 to 5.0
847 \override Slur.thickness = #5.0
850 % Revert thickness of all following slurs to default of 1.2
851 \revert Slur.thickness
856 The man who | feels love's sweet e -- | mo -- tion
862 la instrucción @code{\revert} se puede utilizar para devolver
863 cualquier propiedad que se haya cambiado con @code{\override} a su
864 valor predeterminado. Puede utilizar el método que mejor se adapte a
865 aquello que quiere hacer.
867 Así finaliza nuestra introducción al manual de RFI, y el método básico
868 de trucaje. A continuación, en las últimas secciones de este capítulo
869 encontrará varios ejemplos, en parte para introducirle en algunas de
870 las posibilidades adicionales del manual RFI, y en parte para
871 proporcionarle más práctica en cómo extraer información de él. Estos
872 ejemplos irán conteniendo cada vez menos palabras de guía y
875 @node Propiedades de los interfaces
876 @subsection Propiedades de los interfaces
877 @translationof Properties found in interfaces
880 @cindex propiedades de los interfaces
881 @cindex interfaces, propiedades
883 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
884 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
885 En primer lugar miramos en la página del RFI que relaciona todos los
886 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
887 pueda controlar la letra de la canción. Encontramos @code{LyricText},
888 que parece adecuado. Al seguir este enlace se presentan las
889 propiedades ajustables para el texto de la letra. Estos incluyen
890 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
891 una forma cursiva. Esto es porque la propiedad de la forma es común a
892 todos los objetos de fuente tipográfica, y por tanto, en vez de
893 incluirlo en cada uno de los objetos de presentación, se agrupa junto
894 con otras propiedades comunes similares y se deposita en un
895 @strong{Interface}, el interface de las fuentes tipográficas
896 @code{font-interface}.
898 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
899 de los interfaces, y descubrir qué objetos usan estas propiedades de
902 Mire de nuevo la página del RFI que describe a LyricText. Al final de
903 la página hay una lista de enlaces a los interfaces que LyricText
904 contempla. La lista tiene siete elementos, entre ellos
905 @code{font-interface}. Al seguir este enlace llegamos a las
906 propiedades asociadas con este interface, que también son propiedades
907 de todos los objetos que lo llevan, entre ellos LyricText.
909 Ahora vemos todas las propiedades ajustables por el usuario que
910 controlan las tipografías, entre ellas @code{font-shape(symbol)},
911 donde @code{symbol} se puede establecer a @code{upright} (recta),
912 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
914 Observará que @code{font-series} y @code{font-size} también se
915 encuentran aquí relacionadas. Esto inmediatamente hace que surja la
916 pregunta: ¿Por qué están las propiedades comunes de tipografía
917 @code{font-series} y @code{font-size} relacionadas bajo
918 @code{LyricText} así como bajo el interface @code{font-interface} pero
919 @code{font-shape} no lo está? La respuesta es que @code{font-series}
920 y @code{font-size} se cambian a partir de sus valores predeterminados
921 globales cuando se crea un objeto @code{LyricText}, pero
922 @code{font-shape} no lo hace. Entonces los elementos de la lista
923 @code{LyricText} le dicen los valores para esas dos propiedades que
924 son de aplicación para @code{LyricText}. Otros objetos que contemplan
925 @code{font-interface} establecerán dichas propiedades de forma
926 diferente cuando se crean.
928 Veamos si ahora podemos construir la instrucción @code{\override} para
929 cambiar la letra a cursiva. El objeto es @code{LyricText}, la
930 propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
931 antes, omitiremos el contexto.
933 Como nota aparte, aunque es importante, observe que ciertas
934 propiedades toman valores que son símbolos, como @code{italic}, y
935 deben ir precedidos de un apóstrofo, @code{'}. Los símbolos se
936 leen a continuación internamente por parte de LilyPond. Tenga en
937 cuenta la diferencia con las cadenas de texto arbitrarias, que
938 aparecerían como @code{"una cadena de texto"}; para ver más
939 detalles sobre los símbolos y las cadenas, consulte
940 @rextend{Tutorial de Scheme}.
942 Así pues, la instrucción @code{\override} necesaria para imprimir la
943 letra en cursiva, es:
946 \override LyricText.font-shape = #'italic
950 Esto debe escribirse justo delante de la letra a la que debe afectar,
953 @cindex font-shape, propiedad, ejemplo
954 @cindex italic, ejemplo
955 @cindex LyricText, ejemplo de sobreescritura
956 @cindex @code{\addlyrics}, ejemplo
958 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
963 r4 bes8 bes[( g]) g |
964 g8[( es]) es d[( f]) as |
968 \override LyricText.font-shape = #'italic
969 The man who | feels love's sweet e -- | mo -- tion
975 y toda la letra se imprime en cursiva.
977 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
978 final y la llave de cierre.}
983 @rextend{Tutorial de Scheme}.
986 @node Tipos de propiedades
987 @subsection Tipos de propiedades
988 @translationof Types of properties
990 @cindex propiedades, tipos de
992 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
993 @code{símbolo}. Para que sea válido, el valor que se da a una
994 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
995 tipo. El tipo de la propiedad se muestra siempre entre paréntesis
996 después del nombre de la propiedad en el RFI. He aquí una lista de
997 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
998 algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
999 @code{#}, por supuesto, delante de estos valores cuando se introducen
1000 en la instrucción @code{\override}, incluso si el propio valor ya
1001 comienza por@tie{}@code{#}. Solamente ofrecemos aquí ejemplos para
1002 constantes; si quiere calcular un valor usando Scheme, consulte
1003 @rextend{Cálculos en Scheme}.
1005 @multitable @columnfractions .2 .45 .35
1006 @headitem Tipo de propiedad
1010 @tab Verdadero o Falso, representado por #t o #f
1011 @tab @code{#t}, @code{#f}
1012 @item Dimensión (en espacios de pentagrama)
1013 @tab Un número decimal (en unidades de espacios de pentagrama)
1014 @tab @code{2.5}, @code{0.34}
1016 @tab Una constante válida de dirección o su equivalente numérico
1017 (@code{0} o @code{CENTER} indican una dirección neutra)
1018 @tab @code{LEFT}, @code{CENTER}, @code{UP},
1019 @code{1}, @w{@code{-1}}
1021 @tab Un número entero positivo
1022 @tab @code{3}, @code{-1}
1024 @tab Una secuencia de constantes o símbolos separados por espacios,
1025 encerrado entre paréntesis
1026 y precedido de un apóstrofo o comilla simple
1027 @tab @code{'(left-edge staff-bar)}, @code{'(1)}, @code{'()},
1028 @code{'(1.0 0.25 0.5)}
1030 @tab Cualquier elemento válido de marcado de texto
1031 @tab @code{\markup @{ \italic "cresc." @}}, @code{"gaita"}
1033 @tab Una fracción de redonda construida con la función make-moment
1034 @tab @code{(ly:make-moment 1/4)},
1035 @code{(ly:make-moment 3/8)}
1037 @tab Cualquier valor positivo o negativo, posiblemente decimal
1038 @tab @code{3}, @w{@code{-2.45}}
1039 @item Pareja (de números)
1040 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
1041 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
1043 @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
1044 @tab @code{'italic}, @code{'inside}
1046 @tab Un procedimiento o @code{#f} para no producir ninguna acción
1047 @tab @code{bend::print}, @code{ly:text-interface::print},
1051 encerradas entre @code{#(}@dots{}@code{)}.
1052 @tab @code{#(#t #t #f)}
1057 Manual de Extensión:
1058 @rextend{Tutorial de Scheme}.
1061 @node Apariencia de los objetos
1062 @section Apariencia de los objetos
1063 @translationof Appearance of objects
1065 Ahora vamos a poner en práctica lo que hemos aprendido con unos
1066 cuantos ejemplos que muestran cómo se pueden usar los trucos para
1067 cambiar el aspecto de la música impresa.
1070 * Visibilidad y color de los objetos::
1071 * Tamaño de los objetos::
1072 * Longitud y grosor de los objetos::
1075 @node Visibilidad y color de los objetos
1076 @subsection Visibilidad y color de los objetos
1077 @translationof Visibility and color of objects
1079 Dentro de un uso educativo de la música, podríamos desear imprimir una
1080 partitura con ciertos elementos omitidos como ejercicio para el
1081 alumno, a quien se le pide que los complete. A la manera de ejemplo
1082 sencillo, supongamos que el ejercicio es escribir las líneas
1083 divisorias que faltan en un fragmento musical. Pero las líneas
1084 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
1087 Antes de enredarnos con esto, recordemos que las propiedades de los
1088 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
1089 @ref{Propiedades de los interfaces}). Esto es simplemente agrupar
1090 las propiedades que se pueden usar juntas para trucar un objeto
1091 gráfico: si una de ellas se necesita para un objeto, también las
1092 otras. Así, ciertos objetos usan las propiedades de algunos
1093 interfaces, otros usan las de otros interfaces. Los interfaces que
1094 contienen las propiedades que un determinado grob necesita se
1095 encuentran relacionadas en el manual RFI al final de la página que
1096 describe dicho grob, y esas propiedades se pueden ver mirando dichos
1099 Hemos explicado cómo encontrar información sobre los grobs en
1100 @ref{Propiedades de los objetos de presentación}. Usando el mismo
1101 enfoque, vamos al RFI para buscar el objeto de presentación que
1102 imprime las líneas divisorias. A través del enlace @emph{Backend} y
1103 @emph{All layout objects} encontramos que hay un objeto de
1104 presentación llamado @code{BarLine}. Entre sus propiedades se
1105 encuentran dos que controlan la visibilidad: @code{break-visibility} y
1106 @code{stencil}. Las líneas divisorias también contemplan un número de
1107 interfaces, entre ellos el @code{grob-interface}, donde podemos
1108 encontrar las propiedades @code{transparent} y @code{color}. Todas
1109 ellas pueden afectar la visibilidad de las barras de compás (y, por
1110 supuesto, por extensión, también la de muchos otros objetos de
1111 presentación). Vamos a considerar cada uno de ellos por orden.
1114 * La propiedad stencil (sello)::
1115 * La propiedad break-visibility (visibilidad en el salto)::
1116 * La propiedad transparent (transparente)::
1117 * La propiedad color::
1120 @node La propiedad stencil (sello)
1121 @unnumberedsubsubsec La propiedad @code{stencil} (sello)
1122 @translationof The stencil property
1124 @cindex stencil (sello), propiedad
1126 Esta propiedad controla la apariencia de las barras de compás mediante
1127 la especificación del símbolo (o «glifo») que se debe imprimir. Igual
1128 que como otras muchas propiedades, se puede establecer de forma que no
1129 imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
1130 antes, omitiendo el Contexto implícito, @code{Voice}:
1132 @cindex BarLine, ejemplo de sobreescritura
1133 @cindex stencil, propiedad, ejemplo
1135 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1138 \override BarLine.stencil = ##f
1140 g,8 a16 b8 c d4 e16 |
1145 Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
1146 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
1147 objeto BarLine. Al principio de la página dice @qq{Barline objects
1148 are created by: Bar_engraver} (los objetos Barline se crean por el
1149 grabador Bar_engraver). Vaya a la página del grabador
1150 @code{Bar_engraver} siguiendo el enlace. Al final da una lista de
1151 contextos en los que el grabador de líneas divisorias opera. Todos
1152 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
1153 @code{\override} no funcionara como esperábamos, es porque
1154 @code{Barline} no se encuentra en el contexto predeterminado
1155 @code{Voice}. Si el contexto no se especifica correctamente, la
1156 instrucción simplemente no funciona. No se produce ningún mensaje de
1157 error, y no se registra nada en el archivo log de registro. Vamos a
1158 intentar corregirlo escribiendo el contexto correcto:
1160 @cindex BarLine, ejemplo de sobreescritura
1161 @cindex stencil, propiedad, ejemplo
1163 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1166 \override Staff.BarLine.stencil = ##f
1168 g,8 a16 b8 c d4 e16 |
1173 Ahora las barras de compás han desaparecido. La operación de
1174 fijar la propiedad @code{stencil} al valor @code{#f} es tan
1175 frecuente que existe una abreviatura para ella, llamada
1176 @code{\omit} (omitir):
1179 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1184 g,8 a16 b8 c d4 e16 |
1189 Sin embargo, observe que el establecimiento de la propiedad
1190 @code{stencil} al valor @code{#f} produce errores cuando las se
1191 requieren las dimensiones del objeto para un procesamiento correcto.
1192 Por ejemplo, se generan errores si la propiedad @code{stencil} del
1193 objeto @code{NoteHead} se establece al valor @code{#f}. Si es el
1194 caso, podemos en vez de ello utilizar la función @code{point-stencil},
1195 que establece el sello a un objeto con tamaño nulo:
1197 @lilypond[quote,verbatim,relative=2]
1200 \once \override NoteHead.stencil = #point-stencil
1205 @node La propiedad break-visibility (visibilidad en el salto)
1206 @unnumberedsubsubsec The @code{break-visibility} (visibilidad en el salto)
1207 @translationof The break-visibility property
1209 @cindex break-visibility, propiedad
1211 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI
1212 que la propiedad @code{break-visibility} requiere un vector de
1213 tres valores booleanos. Controlan respectivamente si las barras
1214 de compás se imprimen al final de una línea, en mitad de una
1215 línea, y al principio de las líneas. Para nuestro ejemplo,
1216 queremos que todas las barras de compás se supriman, por lo que el
1217 valor que necesitamos es @code{#(#f #f #f)} (disponible también
1218 bajo el nombre @code{all-invisible}, todas invisibles). Vamos a
1219 probarlo, recordando incluir el contexto de @code{Staff}. Observe
1220 también que al escribir este valor tenemos @code{##} antes del
1221 paréntesis de apertura. Se necesita un @code{#} como parte de la
1222 sintaxis de las contantes vectoriales, y el primer símbolo de
1223 almohadilla@tie{}@code{#} se necesita, como siempre, para preceder
1224 el valor en sí dentro de la instrucción @code{\override}.
1226 @cindex BarLine, ejemplo de sobreescritura
1227 @cindex break-visibility, propiedad, ejemplo
1229 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1232 \override Staff.BarLine.break-visibility = ##(#f #f #f)
1234 g,8 a16 b8 c d4 e16 |
1239 Y podemos ver que esto también quita todas las líneas divisorias.
1241 @node La propiedad transparent (transparente)
1242 @unnumberedsubsubsec La propiedad @code{transparent} (transparente)
1243 @translationof The transparent property
1245 @cindex transparent, propiedad
1246 @cindex transparencia
1248 En la relación de propiedades que se especifican en la página del
1249 @code{grob-interface} del RFI podemos ver que la propiedad
1250 @code{transparent} es un valor booleano. Esto se debe establecer a
1251 @code{#t} para hacer que el grob sea transparente. En el ejemplo
1252 siguiente vamos a hacer que la indicación de compás, y no las líneas
1253 divisorias, sea transparente. Para hacerlo tenemos que buscar el
1254 nombre del grob de la indicación de compás. Volviendo a la página
1255 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1256 presentación @code{TimeSignature}. Se produce por parte del grabador
1257 @code{Time_signature_engraver} que como puede comprobar vive dentro
1258 del contexto de @code{Staff} y también contempla el interface
1259 @code{grob-interface}. Así pues, la instrucción que hace transparente
1260 a la indicación de compás es:
1262 @cindex TimeSignature, ejemplo de sobreescritura
1263 @cindex transparent, propiedad, ejemplo
1265 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1268 \override Staff.TimeSignature.transparent = ##t
1270 g,8 a16 b8 c d4 e16 |
1276 Una vez más, el establecimiento de la propiedad @code{transparent}
1277 es una operación bastante frecuente, de modo que tenemos una
1278 abreviatura llamada @code{\hide} (ocultar):
1281 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1284 \hide Staff.TimeSignature
1286 g,8 a16 b8 c d4 e16 |
1292 En ninguno de los dos casos aparece ya la indicación de compás,
1293 pero esta instrucción deja una separación en el lugar donde antes
1294 estaba la indicación de compás. Quizá esto es lo que queremos
1295 para un ejercicio en que el alumno deba escribirlo, pero en otras
1296 circunstancias esta separación podría no ser deseable. En vez de
1297 eso, para quitarla, el stencil o «sello» de la indicación de
1298 compás se debe establecer al valor @code{#f}:
1300 @cindex TimeSignature, ejemplo de sobreescritura
1301 @cindex stencil, propiedad, ejemplo
1303 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1306 \omit Staff.TimeSignature
1308 g,8 a16 b8 c d4 e16 |
1314 y la diferencia es obvia: al establecer el sello al valor
1315 @code{#f} (posiblemente por medio de @code{\omit}) quitamos el
1316 objeto por completo; al hacer el objeto @code{transparent} (lo que
1317 puede hacerse utilizando @code{\hide}) lo dejamos donde está, pero
1318 lo hacemos invisible.
1320 @node La propiedad color
1321 @unnumberedsubsubsec La propiedad @code{color}
1322 @translationof The color property
1324 @cindex color, propiedad
1326 Para finalizar, intentemos hacer invisibles las barras de compás
1327 pintándolas de color blanco (hay un problema relacionado, que consiste
1328 en que la línea divisoria blanca puede tapar o no tapar las líneas del
1329 pentagrama a las que cruza. Podrá observar en algunos de los ejemplos
1330 que aparecen a continuación, que esto sucede de forma impredecible.
1331 Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
1332 estudian en @ruser{Pintar los objetos de blanco}; de momento estamos
1333 estudiando el color, por lo que le rogamos que acepte esta limitación
1336 El interface @code{grob-interface} especifica que la propiedad del
1337 color es una lista, pero no hay ninguna explicación sobre lo que debe
1338 ir en esa lista. La lista que requiere es realmente una lista de
1339 valores en unidades internas, pero para evitar tener que saber cuáles
1340 son, se ofrecen varias vías para la especificación de los colores. La
1341 primera forma es utilizar uno de los colores @q{normales} que están
1342 relacionados en la primera tabla de la @ruser{Lista de colores}. Para
1343 poner las líneas divisorias de color blanco, escribimos:
1345 @cindex BarLine, ejemplo de sobreescritura
1346 @cindex color, propiedad, ejemplo
1348 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1351 \override Staff.BarLine.color = #white
1353 g,8 a16 b8 c d4 e16 |
1359 y de nuevo podemos comprobar que las barras de compás no son visibles.
1360 Observe que @emph{white} no viene precedido de un apóstrofo: no es un
1361 símbolo, sino una @emph{variable}. Cuando se evalúa, proporciona la
1362 lista de valores internos que se requieren para establecer el color a
1363 blanco. Los otros colores de la lista normal también son variables.
1364 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1365 una de las otras variables de la lista.
1367 @cindex colores de X11
1368 @cindex X11, colores de
1372 La segunda forma de cambiar el color es utilizar la lista de
1373 nombres de colores de X11 que aparecen en la segunda lista de
1374 @ruser{Lista de colores}. De todas formas, se hacen corresponder
1375 a los valores reales por medio de la función @code{x11-color} que
1376 convierte los símbolos de color de X11 en la lista de valores
1377 internos como éstos:
1379 @cindex BarLine, ejemplo de sobreescritura
1380 @cindex color, propiedad, ejemplo
1382 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1385 \override Staff.BarLine.color = #(x11-color 'white)
1387 g,8 a16 b8 c d4 e16 |
1393 Observe que en este caso la función @code{x11-color} toma un
1394 símbolo como argumento, así que el símbolo debe ir precedido de un
1395 apóstrofo para evitar que resulte evaluado como si fuera una
1396 variable, y toda la llamada a la función se debe encerrar entre
1399 @cindex rgb, colores
1404 Aún existe otra función, que convierte valores RGB en colores
1405 internos: la función @code{rgb-color}. Toma tres argumentos que dan
1406 las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
1407 valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
1408 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1409 @code{(rgb-color 1 1 1)}:
1411 @cindex BarLine, ejemplo de sobreescritura
1412 @cindex color, propiedad, ejemplo
1414 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1417 \override Staff.BarLine.color = #(rgb-color 1 1 1)
1419 g,8 a16 b8 c d4 e16 |
1424 Finalmente, existe también una escala de grises como parte del
1425 conjunto de colores de X11. Varían desde el negro, @code{'grey0},
1426 hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
1427 estableciendo todos los objetos de presentación de nuestro ejemplo a
1428 varias gradaciones de gris:
1430 @cindex StaffSymbol, ejemplo de sobreescritura
1431 @cindex TimeSignature, ejemplo de sobreescritura
1432 @cindex Clef, ejemplo de sobreescritura
1433 @cindex NoteHead, ejemplo de sobreescritura
1434 @cindex Stem, ejemplo de sobreescritura
1435 @cindex BarLine, ejemplo de sobreescritura
1436 @cindex color property, ejemplo
1437 @cindex x11-color, ejemplo de utilización
1439 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1442 \override Staff.StaffSymbol.color = #(x11-color 'grey30)
1443 \override Staff.TimeSignature.color = #(x11-color 'grey60)
1444 \override Staff.Clef.color = #(x11-color 'grey60)
1445 \override Voice.NoteHead.color = #(x11-color 'grey85)
1446 \override Voice.Stem.color = #(x11-color 'grey85)
1447 \override Staff.BarLine.color = #(x11-color 'grey10)
1449 g,8 a16 b8 c d4 e16 |
1455 Observe los contextos asociados con cada uno de los objetos de
1456 presentación. Es importante que estén correctamente escritos, o las
1457 instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
1458 que se encuentra el grabador correspondiente. El contesto
1459 predeterminado para los grabadores puede encontrarse empezando por el
1460 objeto de presentación, de ahí al grabador que lo produce, y en la
1461 página del grabador del RFI aparece en qué contexto se puede encontrar
1462 normalmente el grabador.
1465 @node Tamaño de los objetos
1466 @subsection Tamaño de los objetos
1467 @translationof Size of objects
1469 @cindex cambiar el tamaño de los objetos
1470 @cindex tamaño de los objetos
1471 @cindex objetos, tamaño de
1472 @cindex objetos, cambiar el tamaño de
1474 Empezaremos examinando de nuevo un ejemplo anterior (véase
1475 @ref{Anidado de expresiones musicales}) que nos mostraba cómo
1476 introducir un pentagrama temporal, como en un @rglos{ossia}.
1478 @cindex alignAboveContext, propiedad, ejemplo
1479 @cindex @code{\with}, ejemplo
1481 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1482 \new Staff ="main" {
1489 alignAboveContext = #"main" }
1497 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1498 por lo normal se imprimen más pequeños que el pentagrama principal.
1499 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1500 el sello de cada uno de ellos a @code{#f}, como sigue:
1502 @cindex alignAboveContext, propiedad, ejemplo
1503 @cindex @code{\with}, ejemplo
1505 @cindex Clef, ejemplo de sobreescritura
1506 @cindex TimeSignature, ejemplo de sobreescritura
1508 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1509 \new Staff ="main" {
1516 alignAboveContext = #"main"
1520 \omit Staff.TimeSignature
1530 donde el par de llaves adicional después de la cláusula @code{\with}
1531 es necesario para asegurar que la sobreescritura encerrada y la música
1532 se aplican al pentagrama de ossia.
1534 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1535 usando @code{\with} y modificar los sellos de clave y de compás con
1536 \override, o en este caso
1537 @code{\omit}? La diferencia principal es que los cambios que se realizan
1538 en una cláusula @code{\with} se hacen en el momento en que se crea el
1539 contexto, y permanecen activos como valores @strong{predeterminados}
1540 durante toda la duración de dicho contexto, mientras que las
1541 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1542 música son dinámicas: hacen cambios sincronizados con un punto
1543 concreto de la música. Si los cambios se deshacen o se devuelven
1544 mediante @code{\unset} o @code{\revert} volverán a su valor
1545 predeterminado que será el establecido en la cláusula @code{\with}, o
1546 si no se ha establecido ninguno en este lugar, los valores
1547 predeterminados normales.
1549 Ciertas propiedades de contexto se pueden modificar solamente dentro
1550 de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
1551 cambiar después de que el contexto se ha creado.
1552 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1553 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1554 alineación está decidida y no tendría sentido intentar cambiarla más
1557 Los valores predeterminados de las propiedades de los objetos de
1558 presentación también se pueden establecer dentro de cláusulas
1559 @code{\with}. Simplemente utilice la instrucción @code{\override}
1560 normal dejando aparte el nombre del contexto, ya que está definido sin
1561 ambigüedad como el contexto que la cláusula @code{\with} está
1562 modificando. De hecho, se producirá un error si se especifica un
1563 contexto en este lugar.
1565 Así pues, podemos reemplazar el ejemplo anterior con
1567 @cindex alignAboveContext, propiedad, ejemplo
1568 @cindex @code{\with}, example
1569 @cindex Clef, ejemplo de sobreescritura
1570 @cindex TimeSignature, ejemplo de sobreescritura
1572 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1573 \new Staff ="main" {
1580 alignAboveContext = #"main"
1581 % Don't print clefs in this staff
1582 \override Clef.stencil = ##f
1583 % Don't print time signatures in this staff
1584 \override TimeSignature.stencil = ##f
1593 Resulta que también podemos emplear aquí las abreviaturas
1594 @code{\hide} y @code{\omit} para fijar la propiedad
1595 @code{transparent} y borrar el @code{stencil}, lo que conduce al
1596 resultado siguiente:
1598 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1599 \new Staff ="main" {
1606 alignAboveContext = #"main"
1607 % Don't print clefs in this staff
1609 % Don't print time signatures in this staff
1619 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1622 Ciertos objetos de presentación se crean como glifos sacados de una
1623 fuente tipográfica. Entre ellos se encuentran las cabezas,
1624 alteraciones, elementos de marcado, claves, indicaciones de compás,
1625 indicaciones dinámicas y la letra de las canciones. Su tamaño se
1626 cambia mediante la modificación de la propiedad @code{font-size}, como
1627 veremos en breve. Otros objetos de presentación como ligaduras de
1628 unión y de expresión (en general, objetos de extensión) se trazan
1629 individualmente, por lo que no hay un tamaño de tipografía
1630 @code{font-size} asociado a ellos. Estos objetos generalmente derivan
1631 su tamaño de los objetos a los que están adosados, y por ello
1632 normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
1633 otras propiedades como la longitud de las plicas y las barras de
1634 compás, el grosor de las barras de corchea y otras líneas, y la
1635 separación de las líneas del pentagrama se deben modificar de otras
1638 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1639 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1640 cambiar el tamaño de las tipografías de cada uno de los tipos de
1641 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1644 \override NoteHead.font-size = #-2
1647 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1648 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1649 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1656 Los dos enunciados producirían una reducción del tamaño de la
1657 tipografía en dos pasos a partir de su valor previo, donde cada paso
1658 reduce o aumenta el tamaño aproximadamente en un 12%.
1660 Vamos a probarlo en nuestro ejemplo del ossia:
1662 @cindex alignAboveContext, propiedad, ejemplo
1663 @cindex @code{\with}, ejemplo
1664 @cindex Clef, ejemplo de sobreescritura
1665 @cindex TimeSignature, ejemplo de sobreescritura
1666 @cindex fontSize, propiedad, ejemplo
1668 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1669 \new Staff ="main" {
1676 alignAboveContext = #"main"
1679 % Reduce all font sizes by ~24%
1689 Aún no está demasiado bien. Las cabezas y los corchetes de las notas
1690 son más pequeños, pero las plicas son demasiado largas en proporción,
1691 y las líneas del pentagrama están demasiado separadas entre sí. Se
1692 debe reducir su escala en proporción a la reducción de la tipografía.
1693 El siguiente apartado trata sobre cómo se hace esto.
1695 @node Longitud y grosor de los objetos
1696 @subsection Longitud y grosor de los objetos
1697 @translationof Length and thickness of objects
1703 @cindex tamaño, cambiar
1704 @cindex plica, cambiar la longitud
1705 @cindex pentagrama, cambiar la separación de las líneas
1707 Las distancias y longitudes en LilyPond se miden generalmente en
1708 espacios de pentagrama, la distancia entre líneas adyacentes de la
1709 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1710 de las propiedades de @code{thickness} (grosor) se miden en unidades
1711 de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
1712 de forma predeterminada, a las líneas de los reguladores se les da un
1713 grosor de 1 unidad de @code{line-thickness}, mientras que el
1714 @code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
1715 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1716 barras de corchea se controla por medio del valor de
1717 @code{beam-thickness}, que se mide en espacios de pentagrama.
1719 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1720 tamaño de la tipografía? Se puede hacer con la ayuda de una función
1721 especial que se llama @code{magstep}, pensada especialmente para este
1722 propósito. Toma un argumento, el cambio de tamaño de la tipografía
1723 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1724 para reducir otros objetos en la misma proporción. Se usa de la
1727 @cindex alignAboveContext, propiedad, ejemplo
1728 @cindex @code{\with}, ejemplo
1729 @cindex Clef, ejemplo de sobreescritura
1730 @cindex TimeSignature, ejemplo de sobreescritura
1731 @cindex fontSize, propiedad, ejemplo
1732 @cindex StaffSymbol, ejemplo de sobreescritura
1733 @cindex magstep, función, ejemplo de utilización
1734 @cindex staff-space, propiedad, ejemplo
1735 @cindex stencil, propiedad, ejemplo
1737 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1738 \new Staff ="main" {
1745 alignAboveContext = #"main"
1749 % Reduce stem length and line spacing to match
1750 \override StaffSymbol.staff-space = #(magstep -2)
1760 Puesto que la longitud de las plicas y muchas otras propiedades
1761 relacionadas con la longitudes calculan siempre con relación al valor
1762 de la propiedad @code{staff-space}, su longitud también ve reducida su
1763 escala automáticamente. Observe que esto afecta solamente a la escala
1764 vertical del ossia: la escala horizontal se determina por medio de la
1765 disposición de la música principal con el objeto de mantenerse en
1766 sincronía con ella, de forma que no resulte afectada por ninguno de
1767 estos cambios de tamaño. Por supuesto, si la escala de toda la música
1768 principal se cambiase de esta forma, entonces el espaciado horizontal
1769 se vería afectado. Trataremos de esto más tarde en la sección sobre
1772 Esto, en fin, completa la creación de un ossia. Los tamaños y
1773 longitudes del resto de los objetos se pueden modificar de manera
1776 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1777 grosor de las diversas líneas dibujadas como divisorias, barras de
1778 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1779 ajuste global. Si el grosor de cualquier objeto de presentación en
1780 particular necesita ajustarse, se puede hacer mejor mediante la
1781 sobreescritura de su propiedad @code{thickness}. Anteriormente
1782 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1783 @ref{Propiedades de los objetos de presentación}. El grosor de todos los objetos
1784 trazados (es decir, aquellos que no se producen a partir de una
1785 tipografía) se pueden cambiar de la misma forma.
1788 @node Colocación de los objetos
1789 @section Colocación de los objetos
1790 @translationof Placement of objects
1793 * Comportamiento automático::
1794 * Objetos interiores al pentagrama::
1795 * Objetos fuera del pentagrama::
1799 @node Comportamiento automático
1800 @subsection Comportamiento automático
1801 @translationof Automatic behavior
1803 @cindex dentro del pentagrama, objetos
1804 @cindex fuera del pentagrama, objetos
1805 @cindex objetos dentro del pentagrama
1806 @cindex objetos fuera del pentagrama
1808 Hay ciertos objetos en notación musical que pertenecen al pentagrama y
1809 otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
1810 objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
1813 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1814 pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
1815 se fijan por la propia música; se posicionan verticalmente sobre
1816 líneas específicas del pentagrama o están unidos a otros objetos
1817 posicionados de esta forma. Las colisiones entre cabezas, plicas y
1818 alteraciones en acordes de notas muy juntas, normalmente se evitan
1819 automáticamente. Hay instrucciones y sobreescrituras que pueden
1820 modificar este comportamiento automático, como veremos en breve.
1822 Entre los objetos que pertenecen al exterior de la pauta se encuentran
1823 cosas como las marcas de ensayo, las marcas de texto y las de
1824 dinámica. La regla de LilyPond para la colocación vertical de los
1825 objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
1826 como sea posible, pero no tan cerca como para que puedan chocar con
1827 algún otro objeto. LilyPond utiliza la propiedad
1828 @code{outside-staff-priority} para determinar el orden en que se deben
1829 situar los objetos, como veremos ahora.
1831 En primer lugar, LilyPond sitúa todos los objetos
1832 dentro-del-pentagrama. Después ordena los objetos
1833 fuera-del-pentagrama de acuerdo con su prioridad
1834 @code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
1835 toman de uno en uno, comenzando por el que tiene la prioridad
1836 @code{outside-staff-priority} más baja, y se sitúan de forma que no
1837 colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
1838 grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
1839 la prioridad @code{outside-staff-priority} más baja se colocará más
1840 cerca del pentagrama. Si dos objetos tienen la misma
1841 @code{outside-staff-priority}, el que se ha encontrado primero se
1842 situará más cerca de la pauta.
1844 En el siguiente ejemplo, todos los textos de marcado tienen la misma
1845 prioridad (pues no se ha establecido explícitamente). Observe que
1846 @q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
1847 acomodado por debajo de @q{Text2}.
1849 @cindex markup, ejemplo
1851 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1858 Los pentagramas también se posicionan, de forma predeterminada, tan
1859 cerca unos de otros como sea posible (sujeto a una separación mínima).
1860 Si las notas se proyectan muy lejos en dirección a un pentagrama
1861 adyacente, forzarán a alejarse a los pentagramas sólo si en caso
1862 contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
1863 siguiente muestra esta acomodación @q{nestling} de las notas sobre
1864 pentagramas adyacentes:
1866 @lilypond[quote,ragged-right,verbatim]
1869 \relative c' { c4 a, }
1872 \relative c'''' { c4 a, }
1878 @node Objetos interiores al pentagrama
1879 @subsection Objetos interiores al pentagrama
1880 @translationof Within-staff objects
1882 Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la
1883 dirección de las ligaduras de expresión y de unión, digitaciones y
1884 todo lo demás que dependa de la dirección de las plicas (véase
1885 @ref{Voces explícitas}). Cuando se
1886 escribe música polifónica, estas instrucciones son esenciales para que
1887 puedan distinguirse varias líneas melódicas entrelazadas. Pero
1888 ocasionalmente puede ser necesario sobreescribir este comportamiento
1889 automático. Se puede hacer por secciones de música completas o
1890 incluso para una nota individual. La propiedad que controla este
1891 comportamiento es la propiedad de @code{direction} (dirección) de cada
1892 objeto de presentación. En primer lugar explicaremos qué hace esto, y
1893 luego introduciremos algunas instrucciones listas para usar que le
1894 evitarán tener que codificar sobreescrituras explícitas para las
1895 modificaciones más comunes.
1897 Algunos objetos de presentación como las ligaduras se curvan hacia
1898 arriba o hacia abajo; otros como las plicas y los corchetes también se
1899 mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
1900 hacia abajo. Esto se controla automáticamente cuando está establecida
1901 la propiedad @code{direction}.
1904 * La propiedad direction (dirección)::
1908 @node La propiedad direction (dirección)
1909 @unnumberedsubsubsec La propiedad @code{direction} (dirección)
1910 @translationof The direction property
1921 El ejemplo siguiente muestra en el compás 1 el comportamiento
1922 predeterminado de las plicas, con las de las notas agudas apuntando
1923 hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
1924 todas las plicas forzadas hacia abajo, cuatro notas con las plicas
1925 forzadas hacia arriba, y por último cuatro notas devueltas al
1926 comportamiento predeterminado.
1928 @cindex Stem, ejemplo de sobreescritura
1929 @cindex direction, propiedad, ejemplo
1931 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1933 \override Stem.direction = #DOWN
1935 \override Stem.direction = #UP
1937 \revert Stem.direction
1941 Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
1942 (arriba). Éstos tienen los valores @w{@code{-1}} y @code{+1}
1943 respectivamente, y dichos valores numéricos también se pueden usar
1944 directamente. El valor @code{0} también se puede usar en algunos
1945 casos. Se trata simplemente con el significado de @code{UP} para las
1946 plicas, pero para algunos objetos tiene el significado de
1947 @q{centrado}. Existe una constante @code{CENTER} que tiene el valor
1950 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
1951 están disponibles instrucciones predefinidas equivalentes más
1952 sencillas. Aquí podemos ver una tabla de las más comunes. Se
1953 menciona el significado de cada una allí donde no es obvio.
1955 @multitable @columnfractions .2 .2 .25 .35
1956 @headitem Abajo o Izquierda
1957 @tab Arriba o Derecha
1960 @item @code{\arpeggioArrowDown}
1961 @tab @code{\arpeggioArrowUp}
1962 @tab @code{\arpeggioNormal}
1963 @tab La flecha está abajo, arriba o no hay flecha
1964 @item @code{\dotsDown}
1966 @tab @code{\dotsNeutral}
1967 @tab Dirección del desplazamiento para evitar las líneas del pentagrama
1968 @item @code{\dynamicDown}
1969 @tab @code{\dynamicUp}
1970 @tab @code{\dynamicNeutral}
1972 @item @code{\phrasingSlurDown}
1973 @tab @code{\phrasingSlurUp}
1974 @tab @code{\phrasingSlurNeutral}
1975 @tab Nota: diferente de las instrucciones de ligaduras de expresión
1976 @item @code{\slurDown}
1978 @tab @code{\slurNeutral}
1980 @item @code{\stemDown}
1982 @tab @code{\stemNeutral}
1984 @item @code{\textSpannerDown}
1985 @tab @code{\textSpannerUp}
1986 @tab @code{\textSpannerNeutral}
1987 @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
1988 @item @code{\tieDown}
1990 @tab @code{\tieNeutral}
1992 @item @code{\tupletDown}
1993 @tab @code{\tupletUp}
1994 @tab @code{\tupletNeutral}
1995 @tab Los grupos especiales están debajo o encima de las notas
1998 Las variantes neutras o normales de estas instrucciones están
1999 implementadas usando @code{\revert} y @strong{no} pueden ir
2000 precedidas de @code{\once}. Si quiere limitar el efecto de las
2001 otras instrucciones (que están implementadas usando
2002 @code{\override}) a un solo paso de tiempo, puede precederla de
2003 @code{\once} de la misma forma en que lo haría con las
2004 sobreescrituras explícitas.
2007 @unnumberedsubsubsec Digitaciones
2008 @translationof Fingering
2010 @cindex digitación, colocación
2011 @cindex digitación de acordes
2013 La colocación de las digitaciones sobre notas sueltas también se puede
2014 controlar mediante la propiedad @code{direction}, pero los cambios
2015 sobre @code{direction} no tienen ningún efecto sobre las notas de los
2016 acordes. Como veremos, existen instrucciones especiales que permiten
2017 controlar las digitaciones de notas individuales, situando la
2018 digitación encima, debajo, a la izquierda o a la derecha de cada nota.
2020 En primer lugar, he aquí el efecto de @code{direction} sobre las
2021 digitaciones aplicadas a notas sueltas. Se muestra en el primer
2022 compás el comportamiento predeterminado, y en los dos compases
2023 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
2025 @cindex Fingering, ejemplo de sobreescritura
2026 @cindex direction, propiedad, ejemplo
2028 @lilypond[quote,verbatim,relative=2]
2030 \override Fingering.direction = #DOWN
2032 \override Fingering.direction = #UP
2036 Sin embargo, la sobreescritura de la propiedad @code{direction} no es
2037 la forma más sencilla de especificar manualmente la digitación por
2038 encima o por debajo de las notas; suele ser preferible usar @code{_} o
2039 @code{^} en lugar de @code{-}, antes del número de la digitación.
2040 Este es el ejemplo anterior utilizando este método:
2042 @cindex fingering, ejemplo
2043 @cindex digitación, ejemplo
2045 @lilypond[quote,verbatim,relative=2]
2051 La propiedad @code{direction} se ignora para los acordes, pero los
2052 prefijos direccionales @code{_} y @code{^} sí funcionan. De forma
2053 predeterminada, las digitaciones se colocan automáticamente encima y
2054 debajo de las notas de un acorde, como se muestra aquí:
2056 @cindex fingering, ejemplo
2057 @cindex digitación, ejemplo
2059 @lilypond[quote,verbatim,relative=2]
2066 pero se puede forzar de manera que todos o algunos de los números de
2067 digitación estén por encima o por debajo:
2069 @cindex fingering, ejemplo
2070 @cindex digitación, ejemplo
2072 @lilypond[quote,verbatim,relative=2]
2078 Es posible ejercer un control aún mayor sobre la colocación de las
2079 digitaciones mediante la utilización de la instrucción @code{\set
2080 fingeringOrientations}. El formato de esta instrucción es:
2083 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
2087 se utiliza @code{\set} porque @code{fingeringOrientations} es una
2088 propiedad del contexto @code{Voice}, creado y usado por el grabador
2089 @code{New_fingering_engraver}.
2091 La propiedad se puede establecer al valor de una lista de entre uno y
2092 tres valores. Controla si las digitaciones se pueden colocar por
2093 encima (si @code{up} aparece en la lista), por debajo (si aparece
2094 @code{down}), a la izquierda (si aparece @code{left}) o a la derecha
2095 (si aparece @code{right}). A la inversa, si una colocación no está en
2096 la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
2097 coma estas restricciones y se trabaja la mejor colocación para la
2098 digitación de las notas de los acordes que siguen. Observe que
2099 @code{left} y @code{right} son mutuamente excluyentes: las
2100 digitaciones pueden situarse en un lado o en el otro, no en los dos.
2102 @warning{Para controlar la colocación de la digitación de una sola
2103 nota usando esta instrucción es necesario escribirla como un acorde de
2104 una sola nota encerrándola entre ángulos simples.}
2106 Aquí podemos ver algunos ejemplos:
2108 @cindex fingering, ejemplo
2109 @cindex digitación, ejemplo
2110 @cindex @code{\set}, ejemplo de utilización
2111 @cindex fingeringOrientations, propiedad, ejemplo
2113 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2114 \set fingeringOrientations = #'(left)
2117 \set fingeringOrientations = #'(left)
2119 <c-1 e-2 g-3 b-5>4 |
2120 \set fingeringOrientations = #'(up left down)
2123 \set fingeringOrientations = #'(up left)
2125 <c-1 e-2 g-3 b-5>4 |
2126 \set fingeringOrientations = #'(right)
2132 Si la digitación parece un poco superpoblada, se puede reducir el
2133 tamaño @code{font-size}. El valor predeterminado puede verse en el
2134 objeto @code{Fingering} del RFI que es @w{@code{-5}}, así que probaremos
2137 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2138 \override Fingering.font-size = #-7
2139 \set fingeringOrientations = #'(left)
2142 \set fingeringOrientations = #'(left)
2144 <c-1 e-2 g-3 b-5>4 |
2145 \set fingeringOrientations = #'(up left down)
2148 \set fingeringOrientations = #'(up left)
2150 <c-1 e-2 g-3 b-5>4 |
2151 \set fingeringOrientations = #'(right)
2157 @node Objetos fuera del pentagrama
2158 @subsection Objetos fuera del pentagrama
2159 @translationof Outside-staff objects
2161 Los objetos fuera-del-pentagrama se sitúan automáticamente para evitar
2162 las colisiones. Existen varias formas de sobreescribir la colocación
2163 automática si el posicionado no resulta óptimo.
2166 * La propiedad outside-staff-priority (prioridad fuera del pentagrama)::
2167 * La instrucción \textLengthOn::
2168 * Posicionamiento de los matices dinámicos::
2169 * Escalado de un «Grob»::
2173 @node La propiedad outside-staff-priority (prioridad fuera del pentagrama)
2174 @unnumberedsubsubsec La propiedad @code{outside-staff-priority} (prioridad fuera del pentagrama)
2175 @translationof The outside-staff-priority property
2177 Los objetos fuera-del-pentagrama se colocan automáticamente para
2178 evitar las colisiones. Los objetos que tienen el valor más bajo de la
2179 propiedad @code{outside-staff-priority} se sitúan más cerca del
2180 pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
2181 tanto como sea necesario para evitar la colisión. La prioridad
2182 @code{outside-staff-priority} se defina en el @code{grob-interface} y
2183 así es una propiedad de todos los objetos de presentación. De forma
2184 predeterminada se establece a @code{#f} para todos los objetos
2185 dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
2186 fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
2187 presenta los valores numéricos predeterminados para algunos de los
2188 objetos fuera-del-pentagrama más comunes.
2190 @cindex objetos de extensión
2192 Observe los nombres algo inusuales de algunos de los objetos: los
2193 objetos de extensión se crean automáticamente para controlar el
2194 posicionamiento vertical de los grobs que (quizá) comienzan y terminan
2195 en distintos momentos musicales, de manera que cualquier modificación
2196 a la prioridad @code{outside-staff-priority} del grob subyacente no
2197 tiene ningún efecto. Por ejemplo, cambiar la
2198 @code{outside-staff-priority} del objeto de regulador @code{Hairpin}
2199 no tiene efecto sobre la posición vertical de los reguladores: en
2200 lugar de eso, tenemos que cambiar la @code{outside-staff-priority} del
2201 objeto asociado @code{DynamicLineSpanner}. Esta sobreescritura se
2202 debe escribir al comienzo del objeto de extensión, que podría incluir
2203 varios reguladores o matices dinámicos encadenados.
2205 @multitable @columnfractions .3 .3 .3
2206 @headitem Objeto de presentación
2208 @tab Controla la posición de:
2209 @item @code{RehearsalMark}
2211 @tab Letras de ensayo
2212 @item @code{MetronomeMark}
2214 @tab Indicaciones metronómicas
2215 @item @code{VoltaBracketSpanner}
2217 @tab Cajetines de primera y segunda vez
2218 @item @code{TextScript}
2220 @tab Texto en elementos de marcado
2221 @item @code{MultiMeasureRestText}
2223 @tab Texto sobre silencios de compás completo
2224 @item @code{OttavaBracket}
2226 @tab Corchetes de octava alta y baja
2227 @item @code{TextSpanner}
2229 @tab Objetos de extensión de texto
2230 @item @code{DynamicLineSpanner}
2232 @tab Todas las indicaciones dinámicas
2233 @item @code{VoltaBracketSpanner}
2235 @tab Números de compás
2236 @item @code{TrillSpanner}
2238 @tab Trinos mantenidos
2241 He aquí un ejemplo que muestra la situación predeterminada de algunos
2244 @cindex texto, extensiones de
2245 @cindex octava alta y baja, corchete de
2247 @funindex \startTextSpan
2248 @funindex startTextSpan
2249 @funindex \stopTextSpan
2250 @funindex stopTextSpan
2252 @cindex TextSpanner, ejemplo de sobreescritura
2253 @cindex bound-details, propiedad, ejemplo
2255 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2256 % Set details for later Text Spanner
2257 \override TextSpanner.bound-details.left.text
2258 = \markup { \small \bold Slower }
2259 % Place dynamics above staff
2261 % Start Ottava Bracket
2264 % Add Dynamic Text and hairpin
2270 % Add Dynamic Text and terminate hairpin
2271 c4\ff c \stopTextSpan |
2272 % Stop Ottava Bracket
2277 Este ejemplo también muestra cómo crear textos con extensión (Text
2278 Spanners): textos con líneas extensoras por encima de una sección de
2279 música. El extensor abarca desde la instrucción @code{\startTextSpan}
2280 hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
2281 define por medio de la instrucción @code{\override TextSpanner}. Para
2282 ver más detalles, consulte @ruser{Extensiones de texto}.
2284 También muestra la manera de crear corchetes de octava alta y baja.
2286 @cindex trucar la situación de los números de compás
2287 @cindex números de compás, ajustar posición
2288 @cindex trucar la situación de marcas metronómicas
2289 @cindex metrónomo, situación de las indicaciones de
2290 @cindex trucar la situación de las letras de ensayo
2291 @cindex ensayo, letras, trucar la colocación
2293 Si los valores predeterminados de @code{outside-staff-priority} no le
2294 ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
2295 de cualquiera de los objetos. Suponga que quisiéramos que el corchete
2296 de octava estuviera situado por debajo del elemento extensor de texto
2297 en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
2298 prioridad de @code{OttavaBracket} en el RFI o en las tablas
2299 anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
2300 recordando que @code{OttavaBracket} se crea dentro del contexto de
2303 @cindex TextSpanner, ejemplo de sobreescritura
2304 @cindex bound-details, propiedad, ejemplo
2306 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2307 % Set details for later Text Spanner
2308 \override TextSpanner.bound-details.left.text
2309 = \markup { \small \bold Slower }
2310 % Place dynamics above staff
2312 % Place following Ottava Bracket below Text Spanners
2313 \once \override Staff.OttavaBracket.outside-staff-priority = #340
2314 % Start Ottava Bracket
2319 % Add Dynamic Line Spanner
2325 c4\ff c \stopTextSpan |
2326 % Stop Ottava Bracket
2331 Observe que algunos de estos objetos, concretamente los números de
2332 compás, las indicaciones metronómicas y las letras de ensayo, se
2333 alojan de forma predeterminada dentro del contexto @code{Score}; así
2334 pues, debe asegurarse de que utiliza el contexto adecuado cuando se
2335 sobreescriben sus propiedades.
2337 @cindex ligaduras y outside-staff-priority
2338 @cindex ligaduras y articulaciones
2339 @cindex articulaciones y ligaduras
2341 De forma predeterminada, las ligaduras de expresión están clasificadas
2342 como objetos dentro-del-pentagrama, pero con frecuencia aparecen
2343 encima del pentagrama si las notas que une son muy agudas. Ello puede
2344 empujar a una posición muy elevada a los objetos fuera-del-pentagrama
2345 como las articulaciones, pues la ligadura se colocará en primer lugar.
2346 La propiedad @code{avoid-slur} de la articulación se puede establecer
2347 al valor @code{'inside} (por dentro) para llevarla al interior de la
2348 ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si
2349 la prioridad @code{outside-staff-priority} está también ajustada al
2350 valor @code{#f}. De forma alternativa, la prioridad
2351 @code{outside-staff-priority} de la ligadura se puede fijar en un
2352 valor numérico para hacer que se sitúe en línea con otros objetos
2353 fuera del pentagrama de acuerdo con este valor. He aquí un ejemplo
2354 que muestra el efecto de los dos métodos:
2356 @lilypond[quote,verbatim,relative=2]
2357 c4( c^\markup { \tiny \sharp } d4.) c8 |
2359 \once \override TextScript.avoid-slur = #'inside
2360 \once \override TextScript.outside-staff-priority = ##f
2361 c4^\markup { \tiny \sharp } d4.) c8 |
2362 \once \override Slur.outside-staff-priority = #500
2363 c4( c^\markup { \tiny \sharp } d4.) c8 |
2366 Los cambios en @code{outside-staff-priority} también se pueden emplear
2367 para controlar la situación vertical de los objetos individuales,
2368 aunque los resultados pueden no siempre ser deseables. Suponga que
2369 quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
2370 bajo el epígrafe Comportamiento Automático de más arriba (véase
2371 @ref{Comportamiento automático}). Todo lo que debemos hacer es localizar la
2372 prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
2373 aumentar la prioridad de @qq{Text3} hasta un valor superior:
2375 @cindex TextScript, ejemplo de sobreescritura
2376 @cindex outside-staff-priority, propiedad, ejemplo
2378 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2381 \once \override TextScript.outside-staff-priority = #500
2386 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
2387 también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
2388 desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
2389 realmente queremos hacer es posicionar todas las anotaciones a la
2390 misma distancia por encima del pentagrama? Para hacerlo, vamos a
2391 necesitar claramente espaciar las notas en sentido horizontal para
2392 hacer sitio para el texto. Esto se hace empleando la instrucción
2393 @code{textLengthOn}.
2395 @node La instrucción \textLengthOn
2396 @unnumberedsubsubsec La instrucción @code{\textLengthOn}
2397 @translationof The \textLengthOn command
2399 @cindex notas, espaciar junto al texto
2401 @funindex \textLengthOn
2402 @funindex textLengthOn
2403 @funindex \textLengthOff
2404 @funindex textLengthOff
2406 De forma predeterminada, el texto producido mediante marcado no ocupa
2407 ningún espacio horizontal en cuanto se refiere a la disposición de la
2408 música. La instrucción @code{\textLengthOn} invierte este
2409 comportamiento, ocasionando que las notas resulten tan espaciadas como
2410 sea necesario para acomodar el texto:
2412 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2413 \textLengthOn % Cause notes to space out to accommodate text
2420 La instrucción para volver al comportamiento predeterminado es
2421 @code{\textLengthOff}. De forma alternativa, se puede usar
2422 @code{\once} con @code{\textLengthOn} si el efecto se ha de limitar a
2423 un solo momento musical.
2424 The corresponding spacing behavior for rehearsal marks and tempo
2425 indications is independently controlled with the commands
2426 @code{\markLengthOn} and @code{\markLengthOff}.
2428 @cindex marcado, texto de, permitir las colisiones en
2430 El texto de marcado también evita las notas que se proyectan por
2431 encima del pentagrama. Si esto no es lo que deseamos, el
2432 desplazamiento automático hacia arriba se puede desactivar mediante el
2433 establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
2434 muestra cómo el texto de marcado interactúa con tales notas.
2436 @cindex TextScript, ejemplo de sobreescritura
2437 @cindex outside-staff-priority, propiedad, ejemplo
2439 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2440 % This markup is short enough to fit without collision
2444 % This is too long to fit, so it is displaced upwards
2448 % Turn off collision avoidance
2449 \once \override TextScript.outside-staff-priority = ##f
2450 c,,2^"Long Text " c'' |
2453 % Turn off collision avoidance
2454 \once \override TextScript.outside-staff-priority = ##f
2455 \textLengthOn % and turn on textLengthOn
2456 c,,2^"Long Text " % Spaces at end are honored
2460 @node Posicionamiento de los matices dinámicos
2461 @unnumberedsubsubsec Posicionamiento de los matices dinámicos
2462 @translationof Dynamics placement
2464 @cindex trucar la colocación de los matices
2465 @cindex dinámica, trucar la colocación de las indicaciones de
2466 @cindex matices, trucar la colocación
2468 Las indicaciones de matiz dinámico normalmente se colocarán por debajo
2469 del pentagrama, pero se pueden posicionar por encima con la
2470 instrucción @code{\dynamicUp}. Se situarán verticalmente respecto a la
2471 nota a la que van adosadas, y flotarán por debajo (o por encima) de
2472 todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
2473 y números de compás. Esto puede ofrecer resultados bastante
2474 aceptables, como muestra este ejemplo:
2476 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2481 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2482 ees,2.~\)\mf ees4 r8 |
2485 Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
2486 muy cerca, la colocación automática evitará las colisiones desplazando
2487 las marcas dinámicas posteriores más lejos, aunque este puede no ser
2488 el lugar óptimo, como muestra el siguiente ejemplo más bien
2491 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2497 Si se presentara una situación similar en música @q{real}, podría ser
2498 preferible espaciar las notas un poco más entre sí, de forma que todas
2499 las marcas dinámicas puedan caber a la misma distancia vertical desde
2500 el pentagrama. Hemos sido capaces de hacer esto para el texto de
2501 marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
2502 una instrucción equivalente para las indicaciones de matiz dinámico.
2503 Por tanto, tendremos que averiguar cómo hacerlo utilizando
2504 instrucciones @code{\override}.
2506 @node Escalado de un «Grob»
2507 @unnumberedsubsubsec Escalado de un «Grob»
2508 @translationof Grob sizing
2510 @cindex grob, cambio de tamaño de un
2511 @cindex escala de los grobs
2513 En primer lugar debemos aprender cómo se especifica el tamaño de los
2514 grobs. Todos los grobs tienen un punto de referencia definido dentro
2515 de ellos que se usa para colocarlos respecto a su objeto padre.
2516 Entonces, este punto del grob se posiciona a una distancia horizontal,
2517 @code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
2518 de su padre. La dimensión horizontal del objeto viene dada por una
2519 pareja de números, @code{X-extent}, que dice dónde están los límites
2520 izquierdo y derecho respecto del punto de referencia. La amplitud
2521 vertical se define de forma similar mediante una pareja de números,
2522 @code{Y-extent}. Éstas son propiedades de todos los grobs que
2523 contemplan el @code{grob-interface}.
2525 @cindex @code{extra-spacing-width}
2527 De forma predeterminada, los objetos fuera-del-pentagrama reciben
2528 una anchura cero, de manera que pueden solaparse en la dirección
2529 horizontal. Esto se hace mediante el truco de hacer que la
2530 dimensión más a la izquierda sea igual a infinito y que la
2531 dimensión más a la derecha sea igual a menos infinito,
2532 estableciendo el valor de @code{extra-spacing-width} a
2533 @code{'(+inf.0 . -inf.0)}. Así, para asegurar que no se
2534 superponen en la dirección horizontal tendremos que sobreescribir
2535 este valor de @code{extra-spacing-width} para darles un poco de
2536 espacio adicional. Las unidades son el espacio entre dos líneas
2537 del pentagrama, de forma que debería bastar mover el límite
2538 izquierdo media unidad a la izquierda y el límite derecho media
2539 unidad a la derecha:
2542 \override DynamicText.extra-spacing-width = #'(-0.5 . 0.5)
2546 Veamos si funciona en nuestro ejemplo anterior:
2548 @cindex DynamicText, ejemplo de sobreescritura
2549 @cindex extra-spacing-width, propiedad, ejemplo
2551 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2553 % Extend width by 1 staff space
2554 \override DynamicText.extra-spacing-width = #'(-0.5 . 0.5)
2559 Esto tiene un mejor aspecto, pero quizá habríamos preferido que
2560 las indicaciones de dinámica estuvieran alineadas sobre la misma
2561 línea de base en lugar de ir hacia arriba y hacia abajo con las
2562 notas. La propiedad que lo hace es @code{staff-padding} (relleno
2563 de pentagrama) que se estudia en la sección dedicada a las
2564 colisiones (véase @ref{Colisiones de objetos}).
2566 @node Espaciado vertical
2567 @section Espaciado vertical
2568 @translationof Vertical spacing
2570 Por lo general, el espaciado vertical de los objetos musicales que
2571 LilyPond hace es bastante bueno. Veamos cómo se comporta con una
2572 canción sencilla, con dos voces y acompañamiento de piano:
2574 @lilypond[quote,fragment,ragged-right]
2579 \new Voice = "music" {
2585 Here are some lyrics
2588 \clef bass e'2 f e c
2603 No hay ningún problema con el espaciado vertical predeterminado.
2604 Sin embargo, supongamos que estamos trabajando con un editor que
2605 tiene ciertos requisitos específicos para el espaciado vertical de
2606 los pentagramas y la letra: quiere que la letra está más separada
2607 de las notas, que el acompañamiento de piano esté más separado de
2608 la línea vocal y que los dos pentagramas de piano estén más juntos
2609 entre sí. Comenzaremos con la letra.
2611 La letra se encuentra en el interior de un sistem, y por tanto las
2612 instrucciones para aplicarle el espaciado estarán en
2613 @ruser{Espaciado vertical flexible dentro de los sistemas}. Allí
2614 se dice que el texo son líneas del tipo @qq{no-pauta} y por tanto
2615 la instrucción para cambiar su espaciado hará referencia a la
2616 propiedad @code{nonstaff}. Para separarlas del pentagrama al que
2617 pertenecen (la pauta superior) usaremos la propiedad
2618 @code{relatedstaff}. Para separarlas de la línea inferior
2619 usaremos la propiedad @code{unrelatedstaff}. Las partes vocales
2620 pertenecen a un grupo vertical @code{VerticalAxisGroup}, por lo
2621 que tenemos que ajustar sus propiedades. Probémoslo y veamos si
2624 @lilypond[quote,fragment,ragged-right,verbatim]
2629 \new Voice = "music" {
2634 \override VerticalAxisGroup.
2635 nonstaff-relatedstaff-spacing.padding = #5
2636 \override VerticalAxisGroup.
2637 nonstaff-unrelatedstaff-spacing.padding = #5
2640 Here are some lyrics
2643 \clef bass e'2 f e c
2658 Bien: sí, funciona, pero quizá demasiado bien. Cuando
2659 establecemos el @code{padding} (relleno) a 5, LilyPond añade 5
2660 espacios de pentagrama a la distancia entre los objetos, lo que es
2661 excesivo para nosotros en este caso. Usaremos un valor de 2.
2663 A continuación, desplazaremos la música de piano para separarla de
2664 las partes vocales. La música vocal es una @code{ChoirStaff} (un
2665 contexto de sistema coral), y por tanto tenemos que aumentar el
2666 espaciado entre ese grupo de pentagramas y el sistema de piano que
2667 se encuentra debajo. Lo haremos cambiando la
2668 @code{basic-distance} (distancia básica) del @code{StaffGrouper}
2669 del @code{staffgroup-staff-spacing}.
2671 @lilypond[quote,fragment,ragged-right,verbatim]
2673 \new ChoirStaff \with {
2674 \override StaffGrouper.
2675 staffgroup-staff-spacing.basic-distance = #15
2679 \new Voice = "music" {
2684 \override VerticalAxisGroup.
2685 nonstaff-relatedstaff-spacing.padding = #2
2686 \override VerticalAxisGroup.
2687 nonstaff-unrelatedstaff-spacing.padding = #2
2690 Here are some lyrics
2693 \clef bass e'2 f e c
2708 Muy bien. Ahora, sólo nos queda el último requisito de hacer que
2709 los pentagramas de piano estén más juntos. Para conseguirlo, de
2710 nuevo alteramos las propiedades del @code{StaffGrouper}, pero esta
2711 vez vamos a reducir tanto la @code{basic-distance} (distancia
2712 básica) como el @code{padding} (relleno). Podemos hacerlo como se
2713 muestra a continuación.
2715 @lilypond[quote,fragment,ragged-right,verbatim]
2717 \new ChoirStaff \with {
2718 \override StaffGrouper.
2719 staffgroup-staff-spacing.basic-distance = #15
2723 \new Voice = "music" {
2728 \override VerticalAxisGroup.
2729 nonstaff-relatedstaff-spacing.padding = #2
2730 \override VerticalAxisGroup.
2731 nonstaff-unrelatedstaff-spacing.padding = #2
2734 Here are some lyrics
2737 \clef bass e'2 f e c
2740 \new PianoStaff \with {
2741 \override StaffGrouper.staff-staff-spacing = #'(
2742 (basic-distance . 0)
2756 Con esto los hemos colocado muy juntos entre sí (pero es lo que el
2757 editor quería). Se podrían haber separado más alterando el
2758 relleno, @code{padding}, o la distancia básica,
2759 @code{basic-distance}, si quisiéramos.
2761 Hay muchas formas de alterar el espaciado vertical. Un punto
2762 clave que debemos recordar es que el espaciado entre objetos
2763 dentro de un @code{StaffGroup} (como los grupos @code{GrandStaff}
2764 o @code{PianoStaff}) se controla con las variables de espaciado
2765 del @code{StaffGrouper}. El espaciado de los pentagramas no
2766 agrupados (como @code{Lyrics} y @code{Staff}) se controla con las
2767 variables del @code{VerticalAxisGroup}. Para ver más detalles,
2769 @ruser{Variables de espaciado de \paper verticales flexibles} y
2770 @ruser{Espaciado vertical flexible dentro de los sistemas}.
2773 @node Colisiones de objetos
2774 @section Colisiones de objetos
2775 @translationof Collisions of objects
2779 * Arreglar notación con superposiciones::
2780 * Ejemplos reales de música::
2784 @subsection Mover objetos
2785 @translationof Moving objects
2787 @cindex mover objetos superpuestos
2788 @cindex mover objetos que colisionan
2789 @cindex mover grobs que colisionan
2790 @cindex objetos que colisionan, mover
2791 @cindex grobs que colisionan, mover
2793 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
2794 de notación se pueden superponer, lo que es una lástima, pero en
2795 realidad es bastante poco frecuente. Normalmente la necesidad de
2796 mover objetos es por claridad o razones estéticas: el aspecto es mejor
2797 con un poco más o un poco menos de espacio de separación.
2799 Existen tres enfoques principales que llevan a la resolución de
2800 superposiciones en la notación. Se deben considerar en el siguiente
2805 La @strong{dirección} de uno de los objetos que se superponen se puede
2806 cambiar usando las instrucciones predefinidas que están relacionadas
2807 arriba para los objetos dentro-del-pentagrama (véase @ref{Objetos interiores al pentagrama}).
2808 Se pueden recolocar fácilmente las
2809 plicas, ligaduras de expresión y de unión, barras de corchea,
2810 indicaciones dinámicas, texto y grupos de valoración especial de esta
2811 forma. La limitación es que sólo tiene la posibilidad de elegir entre
2812 dos posiciones, y podría ser que ninguna de ellas sea la adecuada.
2815 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2816 colocando los objetos de presentación, se pueden modificar usando la
2817 instrucción de sobreescritura @code{\override}. Las ventadas de hacer
2818 cambios a este tipo de propiedad son: a) que algún otro objeto se
2819 moverá automáticamente si es necesario, para dejarle sitio, y b) una
2820 única sobreescritura se puede aplicar a todas las instancias del mismo
2821 tipo de objeto. Entre tales propiedades se encuentran:
2826 @code{direction} (dirección)
2828 Ya se ha estudiado con cierto detalle: véase @ref{Objetos interiores al pentagrama}.
2831 @code{padding} (relleno),
2832 @code{right-padding} (relleno por la derecha),
2833 @code{staff-padding} (relleno de pentagrama)
2836 @cindex padding, propiedad
2837 @cindex right-padding, propiedad
2838 @cindex staff-padding, propiedad
2840 Según un objeto se está colocando, el valor de su propiedad de relleno
2841 @code{padding} especifica el espacio intermedio que se debe dejar
2842 entre él mismo y el límite más próximo del objeto contra el que se
2843 está colocando. Observe que es el valor de @code{padding} del objeto
2844 @strong{que se está colocando} el que se usa; el valor de
2845 @code{padding} del objeto que ya está colocado se ignora. Los
2846 espacios intermedios especificados mediante @code{padding} se pueden
2847 aplicar a todos los objetos que contemplan el interface
2848 @code{side-position-interface}.
2850 En lugar de con @code{padding}, la colocación de los grupos de
2851 alteraciones se controla con
2852 @code{right-padding}. Esta propiedad se encuentra en el objeto
2853 @code{AccidentalPlacement} que, observe, vive dentro del contexto de
2854 @strong{Staff}. Durante el proceso tipográfico, las cabezas de las
2855 notas se componen tipográficamente en primer lugar, y después las
2856 alteraciones, si existen, se añaden a la izquierda de las cabezas
2857 utilizando la propiedad de relleno por la derecha @code{right-padding}
2858 para determinar la separación entre la alteración y la cabeza, y
2859 de las alteraciones entre sí. Así
2860 pues, sólo la propiedad de relleno por la derecha @code{right-padding}
2861 del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
2862 de las alteraciones.
2864 La propiedad @code{staff-padding} está estrechamente relacionada con
2865 la propiedad @code{padding}: @code{padding} controla la separación
2866 mínima entre cualquier objeto que contemple el interface
2867 @code{side-position-interface} y el objeto más cercano (generalmente
2868 la nota o las líneas del pentagrama); @code{staff-padding} se aplica
2869 sólo a los objetos que siempre se sitúan fuera del pentagrama:
2870 controla la separación mínima entre dicho objeto y el pentagrama.
2871 Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
2872 que se posicionan respecto a la nota en vez de hacerlo respecto al
2873 pentagrama, incluso aunque puede ser sobreescrito sin error por tales
2874 objetos: simplemente se ignora.
2876 Para descubrir qué propiedad de relleno se necesita para el objeto que
2877 quiere recolocar, debe volver al manual de RFI y buscar las
2878 propiedades del objeto. Tenga cuidado porque las propiedades de
2879 relleno podrían no estar en el objeto más obvio, así que busque en los
2880 objetos que puedan tener alguna relación con él.
2882 Todos los valores de relleno se miden en espacios del pentagrama.
2883 Para la mayor parte de los objetos el valor se establece de forma
2884 predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
2885 Se puede sobreescribir si se necesita una separación intermedia mayor
2889 @code{self-alignment-X} (Auto-alineamiento en el eje X)
2891 @cindex self-alignment-X, propiedad
2893 Esta propiedad se puede usar para alinear el objeto a la izquierda, a
2894 la derecha, o centrarlo con respecto al punto de referencia del objeto
2895 «padre». Se puede usar con todos los objetos que contemplan el
2897 @code{self-alignment-interface}. En general son objetos que contienen
2898 texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
2899 forma alternativa se puede especificar un valor numérico entre
2900 @w{@code{-1}} y @code{+1}, donde @w{@code{-1}} es alineado por la izquierda,
2901 @code{+1} es alineado por la derecha, y los números intermedios mueven
2902 el texto progresivamente desde alineado por la izquierda hasta alineado
2903 por la derecha. Se pueden especificar valores numéricos mayores de
2904 @code{1} para mover el texto incluso más lejos hacia la izquierda, o
2905 menos de @w{@code{-1}} para alejarlo más hacia la derecha. Un cambio en
2906 @code{1} en el valor corresponde a un movimiento de la mitad de la
2907 longitud total del propio texto.
2910 @code{extra-spacing-width} (anchura de separación adicional)
2912 @cindex extra-spacing-width, propiedad
2914 Esta propiedad está disponible para todos los objetos que contemplan
2915 el interface @code{item-interface}. Toma dos números, el primero se
2916 suma al límite izquierdo y el segundo se suma al límite derecho. Los
2917 números negativos desplazan el límite a la izquierda y los positivos a
2918 la derecha, por lo que para ensanchar un objeto el primer número debe
2919 ser negativo y el segundo positivo. Observe que no todos los objetos
2920 ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
2921 (alteración) sólo toma nota del primer número (el borde izquierdo).
2924 @code{staff-position} (posición de pentagrama)
2926 @cindex staff-position, propiedad
2928 @code{staff-position} es una propiedad del interface
2929 @code{staff-symbol-referencer-interface}, que está contemplado por los
2930 objetos que se colocan con relación al pentagrama. Especifica la
2931 posición vertical del objeto con relación a la tercera línea del
2932 pentagrama en medios espacios de pentagrama. Es útil en la
2933 resolución de colisiones entre objetos de presentación como silencios
2934 multi-compás, ligaduras de unión y notas en distintas voces.
2937 @code{force-hshift} (forzar desplazamiento horizontal)
2939 @cindex force-hshift, propiedad
2941 Las notas muy juntas de un acorde, o aquellas que ocurren al mismo
2942 tiempo en voces distintas, se disponen en dos (y ocasionalmente más)
2943 columnas para evitar la superposición de las cabezas. Éstas reciben
2944 el nombre de columnas de notas, y se crea un objeto llamado
2945 @code{NoteColumn} para disponer las notas en dicha columna.
2947 La propiedad @code{force-hshift} es una propiedad de una
2948 @code{NoteColumn} (realmente lo es del interface
2949 @code{note-column-interface}). Modificarlo permite mover una columna
2950 de notas en unidades adecuadas a una columna de notas, por ejemplo la
2951 anchura de la cabeza de la nota de la primera voz. Se debe usar en
2952 situaciones complejas donde las instrucciones @code{\shiftOn} normales
2953 (véase @ref{Voces explícitas}) no resuelven el
2954 conflicto entre las notas. Es preferible a la propiedad
2955 @code{extra-offset} para este propósito porque no hay necesidad de
2956 averiguar la distancia en espacios de pentagrama, y mover las notas
2957 dentro o fuera de una @code{NoteColumn} afecta a otras acciones como a
2958 la fusión entre cabezas de nota.
2963 Finalmente, cuando todo lo demás falla, los objetos se pueden
2964 reposicionar manualmente con relación a la tercera línea del
2965 pentagrama verticalmente, o desplazándolas una cierta distancia a una
2966 nueva posición. Las desventajas son que los valores correctos para el
2967 reposicionamiento se deben adivinar, a menudo por ensayo y error, para
2968 cada objeto individual y, puesto que el movimiento se hace después de
2969 que LilyPond ha colocado todos los demás objetos es usuario es
2970 responsable de evitar cualquier colisión que pudiera producirse. Pero
2971 la dificultar principal con este enfoque es que los valores de
2972 reposicionado podrían tener que ser vueltos a calcular si la música se
2973 modifica más tarde. Las propiedades que se pueden usar para este tipo
2974 de posicionamiento manual son:
2977 @item extra-offset (desplazamiento adicional)
2979 @cindex extra-offset, propiedad
2981 Esta propiedad se aplica a cualquier objeto de presentación que
2982 contemple el @code{grob-interface}. Toma una pareja de números que
2983 especifican el desplazamiento adicional en las direcciones horizontal
2984 y vertical. Los números negativos mueven el objeto a la izquierda o
2985 hacia abajo. Las unidades son espacios de pentagrama. El
2986 desplazamiento adicional se hace después de que la composición
2987 tipográfica de los objetos ha terminado, así que un objeto puede ser
2988 reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
2990 @item positions (posiciones)
2992 @cindex positions, propiedad
2994 Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
2995 la altura de las barras de corchea, ligaduras de expresión y corchetes
2996 de grupos de valoración especial. Toma una pareja de números que dan
2997 la posición de los extremos izquierdo y derecho de la barra, ligadura,
2998 etc. con relación a la tercera línea del pentagrama. Las unidades son
2999 espacios de pentagrama. Observe, sin embargo, que las ligaduras de
3000 expresión y de fraseo no se pueden reposicionar en cantidades
3001 arbitrariamente grandes. LilyPond en primer lugar genera una lista de
3002 posiciones posibles para la ligadura y de forma predeterminada
3003 encuentra la ligadura que tiene @qq{mejor aspecto}. Si la propiedad
3004 @code{positions} se ha sobreescrito, la ligadura que está más cerca de
3005 las posiciones que se han solicitado, se selecciona de la lista.
3010 Un objeto en particular podría no tener todas estas propiedades. Es
3011 necesario ir al manual RFI para buscar qué propiedades se encuentran
3012 disponibles para el objeto en cuestión.
3015 Aquí presentamos una lista de los objetos que es más probable que
3016 estén implicados en colisiones, con el nombre del objeto que habría
3017 que buscar en el RFI para descubrir qué propiedades se deben usar para
3020 @multitable @columnfractions .5 .5
3021 @headitem Tipo de objeto @tab Nombre del objeto
3022 @item Articulaciones @tab @code{Script}
3023 @item Barras @tab @code{Beam}
3024 @item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
3025 @item Dinámica (horizontalmente) @tab @code{DynamicText}
3026 @item Digitaciones @tab @code{Fingering}
3027 @item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
3028 @item Ligaduras de expresión @tab @code{Slur}
3029 @item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
3030 @item Ligaduras de unión @tab @code{Tie}
3031 @item Grupos de valoración especial @tab @code{TupletBracket}
3035 @node Arreglar notación con superposiciones
3036 @subsection Arreglar notación con superposiciones
3037 @translationof Fixing overlapping notation
3039 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
3040 en la sección anterior, para resolver problemas de notación que se
3044 * La propiedad padding (relleno)::
3045 * La propiedadhe right-padding (relleno por la derecha)::
3046 * La propiedad staff-padding (relleno de pentagrama)::
3047 * La propiedad self-alignment-X (auto-alineación en X)::
3048 * La propiedad staff-position (posición en el pentagrama)::
3049 * La propiedad extra-offset (desplazamiento adicional)::
3050 * La propiedad positions (posiciones)::
3051 * La propiedad force-hshift (forzar desplazamiento horizontal)::
3054 @node La propiedad padding (relleno)
3055 @unnumberedsubsubsec La propiedad @code{padding} (relleno)
3056 @translationof The padding property
3059 @cindex arreglar notación que se superpone
3060 @cindex superpuesta, notación
3062 La propiedad @code{padding} se puede ajustar para aumentar (o
3063 disminuir) la distancia entre símbolos impresos encima o debajo de las
3066 @cindex Script, ejemplo de sobreescritura
3067 @cindex padding, propiedad, ejemplo
3069 @lilypond[quote,fragment,relative=1,verbatim]
3071 \override Script.padding = #3
3075 @cindex MetronomeMark, ejemplo de sobreescritura
3076 @cindex padding, propiedad, ejemplo
3078 @lilypond[quote,fragment,relative=1,verbatim]
3079 % This will not work, see below
3080 \override MetronomeMark.padding = #3
3084 \override Score.MetronomeMark.padding = #3
3089 Observe en el segundo ejemplo la gran importancia que tiene saber qué
3090 contexto maneja un determinado objeto. Puesto que el objeto
3091 @code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
3092 cambios de propiedades en el contexto @code{Voice} pasarán
3093 inadvertidos. Para ver más detalles, consulte @ruser{Modificar las propiedades}.
3095 Si la propiedad de relleno @code{padding} de un objeto se incrementa
3096 cuando dicho objeto se encuentra en una pila de objetos que se están
3097 colocando de acuerdo a su prioridad @code{outside-staff-priority},
3098 entonces ese objeto se moverá, y también todos los que están por fuera
3102 @node La propiedadhe right-padding (relleno por la derecha)
3103 @unnumberedsubsubsec La propiedad @code{right-padding} (relleno por la derecha)
3104 @translationof The right-padding property
3106 @cindex right-padding, propiedad
3108 La propiedad @code{right-padding} afecta al espaciado entre la
3109 alteración y la nota a que se aplica. Normalmente no es necesaria,
3110 pero el espaciado predeterminado puede estar mal para ciertos glifos
3111 de alteraciones o combinaciones de glifos que se usan en música
3112 microtonal. Éstos tienen que introducirse sobreescribiendo el sello
3113 de la alteración con un elemento de marcado que contenga los símbolos
3116 @cindex Accidental, ejemplo de sobreescritura
3117 @cindex text, propiedad, ejemplo
3118 @cindex stencil, propiedad, ejemplo
3119 @cindex AccidentalPlacement, ejemplo de sobreescritura
3120 @cindex right-padding, propiedad, ejemplo
3123 @lilypond[quote,ragged-right,verbatim]
3124 sesquisharp = \markup { \sesquisharp }
3127 % This prints a sesquisharp but the spacing is too small
3128 \once \override Accidental.stencil = #ly:text-interface::print
3129 \once \override Accidental.text = #sesquisharp
3131 % This improves the spacing
3132 \once \override Score.AccidentalPlacement.right-padding = #0.6
3133 \once \override Accidental.stencil = #ly:text-interface::print
3134 \once \override Accidental.text = #sesquisharp
3140 Esto utiliza necesariamente una sobreescritura para el sello de la
3141 alteración que no se estudiará hasta más adelante. El tipo de sello
3142 debe ser un procedimiento, aquí modificado para que imprima el
3143 contenido de la propiedad @code{text} del objeto @code{Accidental},
3144 que a su vez está establecido como un signo de sesquisostenido.
3145 Entonces el signo se puede separar de la cabeza de la nota
3146 sobreescribiendo @code{right-padding}.
3150 @node La propiedad staff-padding (relleno de pentagrama)
3151 @unnumberedsubsubsec La propiedad @code{staff-padding} (relleno de pentagrama)
3152 @translationof The staff-padding property
3154 @cindex alineación de objetos sobre la línea base
3155 @cindex objetos, alineación sobre la línea base
3157 @code{staff-padding} se puede usar para alinear objetos como matices
3158 dinámicos a lo largo de una línea de base a una altura fija sobre el
3159 pentagrama, en lugar de hacerlo a una altura que dependa de la
3160 posición de la nota a la que están adosados. No es una propiedad de
3161 @code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
3162 porque la línea de base debe aplicarse por igual a @strong{todas} las
3163 dinámicas, entre ellas las que se han creado como objetos de
3164 extensión. Así que ésta es la forma de alinear las indicaciones de
3165 matiz en el ejemplo de la sección anterior:
3167 @cindex DynamicText, ejemplo de sobreescritura
3168 @cindex extra-spacing-width, propiedad, ejemplo
3169 @cindex DynamicLineSpanner, ejemplo de sobreescritura
3170 @cindex staff-padding, propiedad, ejemplo
3172 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
3174 % Extend width by 1 unit
3175 \override DynamicText.extra-spacing-width = #'(-0.5 . 0.5)
3176 % Align dynamics to a base line 2 units above staff
3177 \override DynamicLineSpanner.staff-padding = #2
3182 @node La propiedad self-alignment-X (auto-alineación en X)
3183 @unnumberedsubsubsec La propiedad @code{self-alignment-X} (auto-alineación en X)
3184 @translationof The self-alignment-X property
3186 El ejemplo siguiente muestra cómo ajustar la posición
3187 de un objeto de digitación de cuerda en relación a la plica de una nota
3188 mediante el alineamiento del límite derecho con el punto de referencia
3191 @cindex StringNumber, ejemplo de sobreescritura
3192 @cindex self-alignment-X, propiedad, ejemplo
3194 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
3197 \once \override StringNumber.self-alignment-X = #RIGHT
3201 @node La propiedad staff-position (posición en el pentagrama)
3202 @unnumberedsubsubsec La propiedad @code{staff-position} (posición en el pentagrama)
3203 @translationof The staff-position property
3205 @cindex objeto, colisión dentro del pentagrama
3207 Los silencios multi-compás en una voz pueden chocar con las notas en
3208 otra voz. Puesto que estos silencios se tipografían centrados entre
3209 las barras de compás se necesitaría bastante esfuerzo para que
3210 LilyPond averiguara qué otras notas podrían chocar con él, ya que
3211 actualmente todo el manejo de colisiones entre notas y silencios se
3212 hace solamente para notas y silencios que ocurren al mismo tiempo. He
3213 aquí un ejemplo de colisión de este tipo:
3215 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
3216 << { c4 c c c } \\ { R1 } >>
3219 La mejor solución aquí es mover el silencio multi-compás hacia abajo,
3220 pues el silencio está en la voz dos. El ajuste predeterminado para
3221 @code{\voiceTwo} (es decir, en la segunda voz de una construcción
3222 @code{<<@{@dots{}@} \\ @{@dots{}@}>>}) es que @code{staff-position} tenga el
3223 valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
3224 cuatro semi-espacios de pentagrama, al valor @w{@code{-8}}.
3226 @cindex MultiMeasureRest, ejemplo de sobreescritura
3227 @cindex staff-position, propiedad, ejemplo
3229 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
3233 \override MultiMeasureRest.staff-position = #-8
3238 Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
3239 la línea adicional por encima del silencio se inserta automáticamente.
3241 @node La propiedad extra-offset (desplazamiento adicional)
3242 @unnumberedsubsubsec La propiedad @code{extra-offset} (desplazamiento adicional)
3243 @translationof The extra-offset property
3245 @cindex posicionar objetos
3246 @cindex posicionar grobs
3247 @cindex objetos, posicionar
3248 @cindex grobs, posicionar
3250 La propiedad @code{extra-offset} da un completo control sobre el
3251 posicionamiento de un objeto tanto vertical como horizontalmente.
3253 En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
3254 a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
3256 @cindex fingering (digitación), ejemplo de sobreescritura
3257 @cindex extra-offset, propiedad, ejemplo
3259 @lilypond[quote,fragment,relative=1,verbatim]
3262 \once \override Fingering.extra-offset = #'(-0.3 . -1.8)
3267 @node La propiedad positions (posiciones)
3268 @unnumberedsubsubsec La propiedad @code{positions} (posiciones)
3269 @translationof The positions property
3271 @cindex controlar manualmente grupos especiales, ligaduras y barras
3272 @cindex manual, control, de grupos especiales, ligaduras y barras
3273 @cindex grupos especiales, barras de, control manual
3274 @cindex ligaduras de expresión, control manual
3275 @cindex ligaduras de fraseo, control manual
3276 @cindex barras de corchea, control manual
3278 La propiedad @code{positions} permite controlar manualmente la
3279 posición vertical y de ahí también la inclinación de los tresillos,
3280 ligaduras de expresión y de fraseo, y barras de corchea.
3282 He aquí un ejemplo en el que las ligaduras de fraseo y de expresión
3285 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
3289 @cindex PhrasingSlur, ejemplo de sobreescritura
3290 @cindex positions, propiedad, ejemplo
3293 Una posibilidad sería mover los dos extremos de la ligadura de fraseo
3294 hacia arriba. Podemos tratar de establecer el extremo izquierdo a 2.5
3295 espacios de pentagrama por encima de la tercera línea y el extremo
3296 derecho a 4.5 también hacia arriba, y LilyPond seleccionaría la
3297 ligadura de fraseo de entre las candidatas que ha encontrado con sus
3298 extremos más cercanos a éstos:
3300 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
3301 \once \override PhrasingSlur.positions = #'(2.5 . 4.5)
3305 Esto supone una mejora, pero ¿por qué no bajar un poco el extremo
3306 derecho de la ligadura de expresión? Si lo probamos, veremos que no
3307 se puede hacer así. Ello es a causa de que no existen ligaduras de
3308 expresión candidatas que estén más bajas que la que ya se ha
3309 seleccionado, y en este caso la propiedad @code{positions} no tiene
3310 ningún efecto. Sin embargo, las ligaduras de unión, expresión y
3311 fraseo @emph{se pueden} colocar y conformar de manera muy exacta
3312 cuando se necesita. Para aprender la manera de hacerlo, consulte
3313 @ruser{Modificación de ligaduras de unión y de expresión}.
3315 Presentamos otro ejemplo. Vemos que la barra
3316 choca con las ligaduras:
3318 @lilypond[quote,verbatim,fragment,ragged-right]
3322 { c'1 ~ c'2. e'8 f' }
3324 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
3327 { c'1 ~ c'2. e'8 f' }
3329 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
3335 Esto se puede resolver manualmente elevando los dos extremos de la
3336 barra desde su posición a 1.81 espacios de pentagrama bajo la línea
3337 central hasta, digamos, 1 espacio:
3339 @cindex Beam, ejemplo de sobreescritura
3340 @cindex positions, propiedad, ejemplo
3342 @lilypond[quote,verbatim,fragment,ragged-right]
3346 { c'1 ~ c'2. e'8 f' }
3349 \override Beam.positions = #'(-1 . -1)
3350 e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g''
3354 { c'1 ~ c'2. e'8 f' }
3356 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
3362 Observe que la sobreescritura sigue aplicándose en la primera voz del
3363 segundo compás de corcheas, pero no a ninguna de las barras de la
3366 @node La propiedad force-hshift (forzar desplazamiento horizontal)
3367 @unnumberedsubsubsec La propiedad @code{force-hshift} (forzar desplazamiento horizontal)
3368 @translationof The force-hshift property
3370 Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
3371 Chopin que presentamos al final de @ref{Oigo voces}, que
3372 dejamos con este aspecto:
3374 @lilypond[quote,verbatim,fragment,ragged-right]
3375 \new Staff \relative c'' {
3390 Es necesario que la nota interior del primer acorde (el La bemol de la
3391 cuarta voz) no se aparte de la columna vertical de la nota aguda.
3392 Para corregirlo, ajustamos a cero el valor para esta nota de
3393 @code{force-hshift}, que es una propiedad de @code{NoteColumn}.
3395 En el segundo acorde preferimos que el Fa esté alineado con el La bemol
3396 y que la nota grave se coloque ligeramente a la derecha para evitar una
3397 colisión de las plicas. Lo conseguimos ajustando el valor de
3398 @code{force-hshift} en la @code{NoteColumn} del Re bemol grave para
3399 moverlo a la derecha medio espacio de pentagrama.
3401 Presentamos a continuación el resultado final:
3403 @cindex NoteColumn, ejemplo de sobreescritura
3404 @cindex force-hshift, propiedad, ejemplo
3406 @lilypond[quote,verbatim,fragment,ragged-right]
3407 \new Staff \relative c'' {
3414 \once \override NoteColumn.force-hshift = #0.5
3420 \override NoteColumn.force-hshift = #0
3429 @node Ejemplos reales de música
3430 @subsection Ejemplos reales de música
3431 @translationof Real music example
3433 Finalizaremos esta sección sobre los trucos mostrando los pasos que se
3434 deben tomar para tratar con un ejemplo complicado que necesita varios
3435 trucos para producir el resultado deseado. El ejemplo se ha escogido
3436 deliberadamente para ilustrar el uso de la Referencia de la Notación
3437 para resolver problemas de notación poco comunes. No es
3438 representativo del proceso de grabado más usual, por lo que ¡le
3439 recomendamos que no deje que estas dificultades le desanimen!
3440 ¡Afortunadamente, las dificultades como éstas no son muy comunes!
3442 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
3443 compases 6 al 9, la transición entre el Lento inicial y el Moderato.
3444 Presentamos en primer lugar el aspecto que queremos que tenga el
3445 resultado, pero para evitar complicar demasiado el ejemplo hemos
3446 quitado las indicaciones dinámicas, las digitaciones y el pedal.
3448 @c The following should appear as music without code
3449 @c This example should not be indexed
3450 @c line-width ensures no break
3451 @lilypond[quote,ragged-right,line-width=6\in]
3452 rhMusic = \relative c'' {
3455 \once \override Tie.staff-position = #3.5
3459 \mergeDifferentlyHeadedOn
3460 \mergeDifferentlyDottedOn
3461 bes2.^\markup { \bold "Moderato" } r8
3467 % Reposition the c2 to the right of the merged note
3468 \once \override NoteColumn.force-hshift = #1.0
3469 % Move the c2 out of the main note column
3470 % so the merge will work
3477 % Stem on the d2 must be down to permit merging
3479 % Stem on the d2 should be invisible
3480 \tweak Stem.transparent ##t
3488 \mergeDifferentlyHeadedOff
3489 \mergeDifferentlyDottedOff
3494 lhMusic = \relative c' {
3496 <d g, d>1)\arpeggio |
3503 \new Staff = "RH" <<
3507 \new Staff = "LH" <<
3516 Observamos en primer lugar que la parte de la mano derecha del tercer
3517 compás requiere cuatro voces. Son las cinco corcheas unidas por una
3518 barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
3519 y el Fa sostenido negra con puntillo, que también está fundida con la
3520 corchea de su misma altura. Todo lo demás está en una sola voz, así
3521 que lo más fácil es introducir estas tres voces adicionales, en el
3522 momento en que se necesiten y de forma temporal. Si ha olvidado cómo
3523 hacerlo, lea las secciones @ref{Oigo voces} y @ref{Voces explícitas}.
3524 Aquí tomamos la decisión de utilizar voces instanciadas explícitamente
3525 para el pasaje polifónico, dado que LilyPond es más probable que pueda
3526 evitar las colisiones si todas las voces se instancian explícitamente
3529 Vamos a comenzar introduciendo las notas como dos variables y
3530 disponiendo la estructura de pentagramas en un bloque Score, y veremos
3531 qué produce LilyPond de forma predeterminada:
3533 @c line-width ensures no break
3534 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3535 rhMusic = \relative c'' {
3541 % Start polyphonic section of four voices
3543 { c,8 d fis bes a } % continuation of main voice
3557 g2. % continuation of main voice
3561 lhMusic = \relative c' {
3570 \new Staff = "RH" <<
3574 \new Staff = "LH" <<
3583 Todas las notas son correctas, pero el aspecto está lejos de ser
3584 satisfactorio. La ligadura de unión choca con el cambio de compás,
3585 ciertas notas no se funden correctamente, y faltan algunos elementos de
3586 notación. En primer lugar trataremos con lo más fácil. Podemos
3587 añadir fácilmente la ligadura de expresión de la mano izquierda y la
3588 ligadura de fraseo de la mano derecha, pues todo ello se estudió en el
3589 Tutorial. Al hacerlo así obtenemos:
3591 @c line-width ensures no break
3592 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3593 rhMusic = \relative c'' {
3599 % Start polyphonic section of four voices
3601 { c,8 d fis bes a } % continuation of main voice
3615 g2.\) % continuation of main voice
3619 lhMusic = \relative c' {
3628 \new Staff = "RH" <<
3632 \new Staff = "LH" <<
3641 El primer compás ahora es correcto. El segundo compás contiene un
3642 arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
3643 sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
3644 que volver e la Referencia de la Notación. Buscando la palabra
3645 @q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
3646 que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
3647 doble barra se produce por medio de la instrucción @code{\bar "||"}.
3648 Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
3649 la colisión entre la ligadura de unión y la indicación de compás.
3650 Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
3651 mover objetos anteriormente en @ref{Mover objetos}, donde dice que
3652 los objetos que están situados de forma relativa al pentagrama se
3653 pueden mover verticalmente
3654 sobreescribiendo su propiedad @code{staff-position}, que
3655 se especifica en unidades de medio espacio de pentagrama respecto de
3656 la línea central del pentagrama. Así pues, la sobreescritura
3657 siguiente colocada justo antes de la primera nota ligada subirá la
3658 ligadura 3.5 medios espacios de pentagrama por encima de la línea
3661 @code{\once \override Tie.staff-position = #3.5}
3663 Con esto se completa el compás dos, dando como resultado:
3665 @c line-width ensures no break
3666 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3667 rhMusic = \relative c'' {
3670 \once \override Tie.staff-position = #3.5
3675 % Start polyphonic section of four voices
3677 { c,8 d fis bes a } % continuation of main voice
3691 g2.\) % continuation of main voice
3695 lhMusic = \relative c' {
3697 <d g, d>1)\arpeggio |
3704 \new Staff = "RH" <<
3708 \new Staff = "LH" <<
3717 Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
3718 tutorial nos enseñó cómo escribir texto en negrita mediante la
3719 instrucción @code{\markup}, por lo que añadir @qq{Moderato} en negrita
3720 es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
3721 voces? Aquí es donde debemos volver a buscar ayuda en el manual de
3722 Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
3723 el índice de la Referencia de la notación llegamos rápidamente a las
3724 instrucciones para mezclar notas con distinta cabeza y con o sin
3725 puntillo, en @ruser{Resolución de las colisiones}. En nuestro ejemplo tenemos
3726 que fusionar ambos tipos de nota en el transcurso de la sección
3727 polifónica del compás 3; por tanto, en virtud de la información que
3728 aparece en la Referencia de la Notación, escribimos
3731 \mergeDifferentlyHeadedOn
3732 \mergeDifferentlyDottedOn
3736 al principio de la sección, y
3739 \mergeDifferentlyHeadedOff
3740 \mergeDifferentlyDottedOff
3744 al final, dando como resultado:
3746 @c line-width ensures no break
3747 @lilypond[quote,ragged-right,line-width=6\in]
3748 rhMusic = \relative c'' {
3751 \once \override Tie.staff-position = #3.5
3755 bes2.^\markup { \bold "Moderato" } r8
3756 \mergeDifferentlyHeadedOn
3757 \mergeDifferentlyDottedOn
3758 % Start polyphonic section of four voices
3760 { c,8 d fis bes a } % continuation of main voice
3774 \mergeDifferentlyHeadedOff
3775 \mergeDifferentlyDottedOff
3776 g2.\) % continuation of main voice
3780 lhMusic = \relative c' {
3782 <d g, d>1)\arpeggio |
3789 \new Staff = "RH" <<
3793 \new Staff = "LH" <<
3802 Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
3803 dos Re. ¿Por qué no? La respuesta está en la misma sección de la
3804 Referencia de la Notación: las notas que se fusionan deben tener las
3805 plicas en direcciones opuestas y dos notas no se pueden fusionar bien
3806 si hay una tercera nota en la misma columna. Aquí los dos Re tienen
3807 las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
3808 cambiar la dirección de la plica usando @code{\stemDown}, y la
3809 Referencia de la Notación también explica cómo mover el Do: aplicar un
3810 desplazamiento usando una de las instrucciones @code{\shift}. Pero
3811 ¿cuál? El Do está en la voz dos que tiene desactivado el
3812 desplazamiento, y los dos Re están en las voces uno y tres, que tienen
3813 el desplazamiento desactivado y activado, respectivamente. Por ello
3814 tenemos que desplazar el Do un nivel más todavía, usando
3815 @code{\shiftOnn} para evitar que interfiera con los dos Re. Al
3816 aplicar estos cambios obtenemos:
3818 @cindex Tie, ejemplo de sobreescritura
3819 @cindex staff-position, propiedad, ejemplo
3821 @c line-width ensures no break
3822 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3823 rhMusic = \relative c'' {
3826 \once \override Tie.staff-position = #3.5
3830 bes2.^\markup { \bold "Moderato" } r8
3831 \mergeDifferentlyHeadedOn
3832 \mergeDifferentlyDottedOn
3833 % Start polyphonic section of four voices
3835 { c,8 d fis bes a } % continuation of main voice
3838 % Move the c2 out of the main note column
3839 % so the merge will work
3844 % Stem on the d2 must be down to permit merging
3852 \mergeDifferentlyHeadedOff
3853 \mergeDifferentlyDottedOff
3854 g2.\) % continuation of main voice
3858 lhMusic = \relative c' {
3860 <d g, d>1)\arpeggio |
3867 \new Staff = "RH" <<
3871 \new Staff = "LH" <<
3880 Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
3881 sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
3882 colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
3883 partir de trucos anteriores: hacemos la plica transparente, y movemos
3884 el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
3887 @cindex NoteColumn, ejemplo de sobreescritura
3888 @cindex force-hshift, propiedad, ejemplo
3889 @cindex Stem, ejemplo de sobreescritura
3890 @cindex transparent, propiedad, ejemplo
3892 @c line-width ensures no break
3893 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3894 rhMusic = \relative c'' {
3897 \once \override Tie.staff-position = #3.5
3901 bes2.^\markup { \bold "Moderato" } r8
3902 \mergeDifferentlyHeadedOn
3903 \mergeDifferentlyDottedOn
3904 % Start polyphonic section of four voices
3906 { c,8 d fis bes a } % continuation of main voice
3910 % Reposition the c2 to the right of the merged note
3911 \once \override NoteColumn.force-hshift = #1.0
3912 % Move the c2 out of the main note column
3913 % so the merge will work
3920 % Stem on the d2 must be down to permit merging
3922 % Stem on the d2 should be invisible
3923 \tweak Stem.transparent ##t
3931 \mergeDifferentlyHeadedOff
3932 \mergeDifferentlyDottedOff
3933 g2.\) % continuation of main voice
3937 lhMusic = \relative c' {
3939 <d g, d>1)\arpeggio |
3946 \new Staff = "RH" <<
3950 \new Staff = "LH" <<
3960 @node Trucajes adicionales
3961 @section Trucajes adicionales
3962 @translationof Further tweaking
3965 * Otras aplicaciones de los trucos::
3966 * Uso de variables para los ajustes de disposición::
3968 * Otras fuentes de información::
3969 * Trucos avanzados con Scheme::
3972 @node Otras aplicaciones de los trucos
3973 @subsection Otras aplicaciones de los trucos
3974 @translationof Other uses for tweaks
3977 * Unir notas entre voces distintas::
3978 * Simulación de un calderón en el MIDI::
3981 @cindex transparent, uso de la propiedad
3982 @cindex objetos, hace invisibles
3983 @cindex eliminar objetos
3984 @cindex objetos, eliminar
3985 @cindex objetos, ocultar
3986 @cindex ocultar objetos
3987 @cindex invisibles, objetos
3988 @cindex objetos invisibles
3990 @node Unir notas entre voces distintas
3991 @unnumberedsubsubsec Unir notas entre voces distintas
3992 @translationof Tying notes across voices
3994 @cindex ligar notas entre voces distintas
3996 El ejemplo siguiente muestra cómo conectar notas que están en
3997 distintas voces utilizando ligaduras de unión. Normalmente sólo se
3998 pueden conectar mediante ligaduras de unión dos notas que estén en la
3999 misma voz. Usando dos voces, con las notas ligadas en una de ellas:
4001 @lilypond[quote,fragment,relative=2]
4002 << { b8~ b\noBeam } \\ { b8[ g] } >>
4006 y borrando la primera plica hacia arriba en esa voz, da la impresión
4007 de que la ligadura se cruza entre las voces:
4009 @cindex Stem, ejemplo de sobreescritura
4010 @cindex transparent, propiedad, ejemplo
4012 @lilypond[quote,fragment,relative=2,verbatim]
4015 \tweak Stem.transparent ##t
4023 Para estar seguros de que la plica que acabamos de borrar no aprieta
4024 demasiado a la ligadura, podemos alargar la plica estableciendo su
4025 valor de longitud @code{length} a @code{8},
4027 @lilypond[quote,fragment,relative=2,verbatim]
4030 \tweak Stem.transparent ##t
4031 \tweak Stem.length #8
4040 @cindex tweak, generado a partir de una sobreescritura
4041 Ahora bien, para la @emph{sobreescritura} de la transparencia de
4042 un objeto gráfico, podríamos haber usado la abreviatura
4043 @code{\hide} como se explicó anteriormente. El trucaje mediante
4044 @qq{tweak} es una operación diferente que afecta solamente a las
4045 propiedades generadas a partir de una sola expresión musical.
4046 Resulta que podemos convertir los overrides o sobreescrituras en
4047 tweaks o trucajes utilizando @code{\single}, haciendo posible
4048 volver a escribir el ejemplo anterior como
4050 @lilypond[quote,fragment,relative=2,verbatim]
4055 \tweak Stem.length #8
4063 En este caso particular, la diferencia con @code{\once \hide} no
4064 es muy apreciable. Es importante cuando existen varios objetos en
4065 el mismo punto del tiempo musical (como las notas de un acorde).
4066 En tal caso, @code{\once} afecta a todos los objetos, mientras que
4067 @code{\single} solo afecta a uno, aquél que se genera por parte de
4068 la expresión musical que le sigue inmediatamente.
4070 @node Simulación de un calderón en el MIDI
4071 @unnumberedsubsubsec Simulación de un calderón en el MIDI
4072 @translationof Simulating a fermata in MIDI
4074 @cindex sello, uso de la propiedad
4075 @cindex fermata, realización en MIDI
4077 Para los objetos fuera-del-pentagrama, normalmente es mejor
4078 sobreescribir la propiedad @code{stencil} («sello») del objeto que su
4079 propiedad @code{transparent} cuando desee quitarlos de la salida
4080 impresa. Mediante el establecimiento de la propiedad @code{stencil}
4081 de un objeto al valor @code{#f} podemos quitar el objeto por completo
4082 de la salida impresa. Esto significa que no tiene efecto sobre la
4083 colocación de otros objetos que pudieran colocarse en relación a él.
4085 Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
4086 propósito de simular un calderón en la salida MIDI, seguramente no
4087 querríamos que la indicación metronómica apareciese en la salida
4088 impresa, y no querríamos influir sobre la separación entre los dos
4089 sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
4090 pentagrama. Por lo tanto, establecer su propiedad @code{stencil} al
4091 valor @code{#f} sería la mejor manera. Mostramos aquí el efecto de
4094 @cindex MetronomeMark, ejemplo de sobreescritura
4095 @cindex transparent, propiedad, ejemplo
4097 @lilypond[quote,verbatim,ragged-right]
4100 % Visible tempo marking
4103 \once \hide Score.MetronomeMark
4104 % Invisible tempo marking to lengthen fermata in MIDI
4107 % New tempo for next section
4116 @cindex MetronomeMark, ejemplo de sobreescritura
4117 @cindex stencil, propiedad, ejemplo
4119 @lilypond[quote,verbatim,ragged-right]
4122 % Visible tempo marking
4125 \once \override Score.MetronomeMark.stencil = ##f
4126 % Invisible tempo marking to lengthen fermata in MIDI
4129 % New tempo for next section
4139 Ambos métodos quitan de la salida impresa la indicación metronómica
4140 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
4141 queríamos, pero la indicación metronómica transparente de la primera
4142 línea fuerza una colocación muy alta de la indicación de tempo que
4143 sigue, mientras que la segunda (con el sello suprimido) no lo hace.
4149 @node Uso de variables para los ajustes de disposición
4150 @subsection Uso de variables para los ajustes de disposición
4151 @translationof Using variables for layout adjustments
4153 @cindex variables, usar para sobreescrituras
4154 @cindex sobreescrituras, usar variablas para
4155 @cindex ajustes, usar variables para
4156 @cindex ajustes de disposición, usar variables para hacer
4158 Las instrucciones de sobreescritura son con frecuencia largas y
4159 tediosas de escribir, y se tienen que escribir de forma absolutamente
4160 correcta. Si las mismas sobreescrituras se van a utilizar muchas
4161 veces, podría merecer la pena definir variables para guardarlas.
4163 Supongamos que queremos realzar ciertas palabras de la letra de una
4164 canción imprimiéndolas en cursiva y negrita. Las instrucciones
4165 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
4166 canciones si están incluidas, junto con la palabra o palabras que se
4167 pretenden modificar, dentro de un @code{\markup}, lo que las hace
4168 tediosas de escribir. La necesidad de incluir las propias palabras
4169 impide que se puedan usar en variables simples. ¿Podríamos, como
4170 alternativa, utilizar las instrucciones @code{\override} y
4174 @code{\override Lyrics.LyricText.font-shape = #'italic}
4175 @code{\override Lyrics.LyricText.font-series = #'bold}
4177 @code{\revert Lyrics.LyricText.font-shape}
4178 @code{\revert Lyrics.LyricText.font-series}
4181 Estas instrucciones también serían extremadamente tediosas de escribir
4182 si hubiera muchas palabras que quisiéramos subrayar. Pero sí
4183 @emph{podemos} definirlas como dos variables y usarlas para delimitar
4184 las palabras que destacar. Otra ventaja de la utilización de
4185 variables para estas sobreescrituras es que ya no son necesarios los
4186 espacios que rodean al punto, puesto que no se interpretan
4187 directamente en el modo @code{\lyricmode}. He aquí un ejemplo de
4188 esto, aunque en la práctica quizá elegiríamos unos nombres de variable
4189 más cortos para que fueran más rápidos de teclear:
4191 @cindex LyricText, ejemplo de sobreescritura
4192 @cindex font-shape, propiedad, ejemplo
4193 @cindex font-series, propiedad, ejemplo
4195 @lilypond[quote,verbatim]
4197 \override Lyrics.LyricText.font-shape = #'italic
4198 \override Lyrics.LyricText.font-series = #'bold
4202 \revert Lyrics.LyricText.font-shape
4203 \revert Lyrics.LyricText.font-series
4206 global = { \key c \major \time 4/4 \partial 4 }
4208 SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a4 a g }
4209 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f4 f e }
4210 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
4211 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
4213 VerseOne = \lyrics {
4214 E -- | ter -- nal \emphasize Fa -- ther, | \normal strong to save,
4217 VerseTwo = \lyricmode {
4218 O | \once \emphasize Christ, whose voice the | wa -- ters heard,
4221 VerseThree = \lyricmode {
4222 O | \emphasize Ho -- ly Spi -- rit, | \normal who didst brood
4225 VerseFour = \lyricmode {
4226 O | \emphasize Tri -- ni -- ty \normal of | love and pow'r
4233 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
4234 \new Voice = "Alto" { \voiceTwo \AltoMusic }
4235 \new Lyrics \lyricsto "Soprano" { \VerseOne }
4236 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
4237 \new Lyrics \lyricsto "Soprano" { \VerseThree }
4238 \new Lyrics \lyricsto "Soprano" { \VerseFour }
4242 \new Voice = "Tenor" { \voiceOne \TenorMusic }
4243 \new Voice = "Bass" { \voiceTwo \BassMusic }
4250 @node Hojas de estilo
4251 @subsection Hojas de estilo
4252 @translationof Style sheets
4254 La salida que produce LilyPond se puede modificar profundamente;
4255 consulte @ref{Trucar la salida} para leer detalles sobre este asunto.
4256 Pero ¿qué ocurre si tiene muchos archivos a los que les quiere aplicar
4257 sus propios trucos? O ¿qué ocurre si, sencillamente, quiere separar
4258 los trucos de la propia música? Todo esto es bastante fácil de
4261 Veamos un ejemplo. No se preocupe si no entiende
4262 las partes que tienen todos los @code{#()}. Esto se explicará en
4263 @ref{Trucos avanzados con Scheme}.
4265 @lilypond[quote,verbatim,ragged-right]
4266 mpdolce = -\tweak #'self-alignment-X #-0.6 #
4267 (make-dynamic-script
4268 (markup #:dynamic "mp"
4269 #:normal-text #:italic "dolce" ))
4272 #(define-music-function
4273 (parser location string)
4275 #{ <>^\markup \bold \box #string #})
4279 a4.\mpdolce d8 cis4--\glissando a |
4283 g8(\! fis)-. e( d)-. cis2 |
4287 Hagamos algo respecto a las definiciones @code{mpdolce} e
4288 @code{inst}. Éstas producen la salida que deseamos, pero quizá las
4289 querríamos utilizar en otra pieza. Podríamos simplemente copiarlas y
4290 pegarlas al principio de cada archivo, pero sería bastante molesto.
4291 También hace que se queden las definiciones a la vista dentro de
4292 nuestros archivos de música, y yo personalmente encuentro todos los
4293 @code{#()} bastante poco estéticos. Los vamos a esconder dentro de
4297 %%% guardar esto en un archivo de nombre "definiciones.ily"
4298 mpdolce = -\tweak #'self-alignment-X #-0.6 #
4299 (make-dynamic-script
4300 (markup #:dynamic "mp"
4301 #:normal-text #:italic "dolce" ))
4304 #(define-music-function
4305 (parser location string)
4307 #@{ <>^\markup \bold \box #string #@})
4310 Haremos referencia a este archivo utilizando la instrucción
4311 @code{\include} al principio del archivo de música (la extensión
4312 @code{.ily} se utiliza para distinguir este archivo de inclusión --que
4313 se supone que no debe ser procesado de forma independiente-- del
4314 archivo principal). Ahora modificaremos la música (guardemos este
4315 archivo como @file{musica.ly}).
4317 @c We have to do this awkward example/lilypond-non-verbatim
4318 @c because we can't do the \include stuff in the manual.
4321 \include "definiciones.ily"
4325 a4.\mpdolce d8 cis4--\glissando a |
4329 g8(\! fis)-. e( d)-. cis2 |
4333 @lilypond[quote,ragged-right]
4334 mpdolce = -\tweak #'self-alignment-X #-0.6 #
4335 (make-dynamic-script
4336 (markup #:dynamic "mp"
4337 #:normal-text #:italic "dolce" ))
4340 #(define-music-function
4341 (parser location string)
4343 #{ <>^\markup \bold \box #string #})
4347 a4.\mpdolce d8 cis4--\glissando a |
4351 g8(\! fis)-. e( d)-. cis2 |
4355 Eso tiene mejor aspecto, pero haremos algunos cambios más. El
4356 glissando es difícil de ver, así que lo haremos más grueso y lo
4357 acercaremos a las cabezas de las notas. Pondremos la indicación
4358 metronómica encima de la clave, en lugar de ir encima de la primera
4359 nota. Y por último, mi profesor de composición odia las indicaciones
4360 de compás @q{C}, así que la convertiremos en @q{4/4}.
4362 Sin embargo, no debemos cambiar el archivo @file{musica.ly}.
4363 Sustituyamos nuestro archivo @file{definiciones.ily} con éste:
4366 %%% definiciones.ily
4367 mpdolce = -\tweak #'self-alignment-X #-0.6 #
4368 (make-dynamic-script
4369 (markup #:dynamic "mp"
4370 #:normal-text #:italic "dolce" ))
4373 #(define-music-function
4374 (parser location string)
4376 #@{ <>^\markup \bold \box #string #@})
4381 \override MetronomeMark.extra-offset = #'(-5 . 0)
4382 \override MetronomeMark.padding = #'3
4386 \override TimeSignature.style = #'numbered
4390 \override Glissando.thickness = #3
4391 \override Glissando.gap = #0.1
4396 @lilypond[quote,ragged-right]
4397 mpdolce = -\tweak #'self-alignment-X #-0.6 #
4398 (make-dynamic-script
4399 (markup #:dynamic "mp"
4400 #:normal-text #:italic "dolce" ))
4403 #(define-music-function
4404 (parser location string)
4406 #{ <>^\markup \bold \box #string #})
4411 \override MetronomeMark.extra-offset = #'(-5 . 0)
4412 \override MetronomeMark.padding = #'3
4416 \override TimeSignature.style = #'numbered
4420 \override Glissando.thickness = #3
4421 \override Glissando.gap = #0.1
4427 a4.\mpdolce d8 cis4--\glissando a |
4431 g8(\! fis)-. e( d)-. cis2 |
4435 ¡Eso tiene un aspecto mucho mejor! Ahora suponga que quiere publicar
4436 esta pieza. A mi profesor de composición no le gustan las
4437 indicaciones de compás @q{C}, pero yo les tengo cierto cariño.
4438 Copiaremos el archivo actual @file{definiciones.ily} a
4439 @file{publicar-web.ily} y modificaremos éste. Como el propósito de
4440 esta música es producir un PDF que va a mostrarse en la pantalla,
4441 también vamos a aumentar el tamaño general de la salida.
4444 %%% publicar-web.ily
4445 mpdolce = -\tweak #'self-alignment-X #-0.6 #
4446 (make-dynamic-script
4447 (markup #:dynamic "mp"
4448 #:normal-text #:italic "dolce" ))
4451 #(define-music-function
4452 (parser location string)
4454 #@{ <>^\markup \bold \box #string #@})
4456 #(set-global-staff-size 23)
4461 \override MetronomeMark.extra-offset = #'(-5 . 0)
4462 \override MetronomeMark.padding = #'3
4469 \override Glissando.thickness = #3
4470 \override Glissando.gap = #0.1
4475 @lilypond[quote,ragged-right]
4476 mpdolce = -\tweak #'self-alignment-X #-0.6 #
4477 (make-dynamic-script
4478 (markup #:dynamic "mp"
4479 #:normal-text #:italic "dolce" ))
4482 #(define-music-function
4483 (parser location string)
4485 #{ <>^\markup \bold \box #string #})
4487 #(set-global-staff-size 23)
4491 \override MetronomeMark.extra-offset = #'(-5 . 0)
4492 \override MetronomeMark.padding = #'3
4495 \override Glissando.thickness = #3
4496 \override Glissando.gap = #0.1
4502 a4.\mpdolce d8 cis4--\glissando a |
4506 g8(\! fis)-. e( d)-. cis2 |
4510 Ahora, en la música, simplemente sustituyo @code{\include
4511 "definiciones.ily"} por @code{\include "publicar-web.ily"}. Por
4512 supuesto, podríamos hacer esto aún más práctico. Podríamos hacer un
4513 archivo @file{definiciones.ily} que contuviera solamente las
4514 definiciones de @code{mpdolce} y de @code{inst}, un archivo
4515 @file{publicar-web.ily} que contuviera solamente la sección
4516 @code{\layout} que se mostró en el ejemplo, y un archivo
4517 @file{universidad.ily} que contendría solamente los trucos para
4518 producir la salida que le gusta a mi profesor. El comienzo de
4519 @file{musica.ly} tendría entonces este aspecto:
4522 \include "definiciones.ily"
4524 %%% ¡Quitar el comentario de una sola de estas líneas!
4525 \include "publicar-web.ily"
4526 %\include "universidad.ily"
4529 Este enfoque puede ser útil incluso si va a producir sólo un conjunto
4530 de particellas. Yo utilizo media docena de archivos de @q{hojas de
4531 estilo} para mis proyectos. Comienzo todos los archivos de música con
4532 @code{\include "../global.ily"}, que contiene
4536 \version @w{"@version{}"}
4538 #(ly:set-option 'point-and-click #f)
4540 \include "../iniciar/iniciar-definiciones.ily"
4541 \include "../iniciar/iniciar-disposicion.ily"
4542 \include "../iniciar/iniciar-cabeceras.ily"
4543 \include "../iniciar/iniciar-papel.ily"
4547 @node Otras fuentes de información
4548 @subsection Otras fuentes de información
4549 @translationof Other sources of information
4551 La documentación del manual de Referencia de Funcionamiento Interno
4552 contiene montañas de información sobre LilyPond, pero se puede obtener
4553 más información aún leyendo los archivos internos de LilyPond. Para
4554 echarles un vistazo, en primer lugar debe buscar la carpeta
4555 correspondiente a su sistema. La ubicación de esta carpeta depende
4556 (a) de si consiguió el programa LilyPond descargando un binario
4557 precompilado desde el sitio web lilypond.org o si lo instaló mediante
4558 un gestor de paquetes (es decir, distribuido con GNU/Linux, o instalado
4559 bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
4560 qué sistema operativo está utilizando:
4562 @subsubsubheading Descargado de lilypond.org
4569 @file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/@/share/lilypond/current/}
4576 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/@/Resources/share/lilypond/current/}
4579 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
4580 bien manteniendo pulsada la tecla de Control y haciendo click sobre la
4581 aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
4586 Mediante el Explorador de Windows, diríjase a
4588 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/@/share/lilypond/current/}
4593 @subsubsubheading Instalado mediante un gestor de paquetes o compilado a partir de la fuente
4596 @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
4597 se encuentra determinado por su administrador de paquetes o guión
4598 @code{configure}, y @var{X.Y.Z} es el número de la versión de
4603 Dentro de esta carpeta, las dos subcarpetas interesantes son
4606 @item @file{ly/} - contiene archivos en formato LilyPond
4607 @item @file{scm/} - contiene archivos en formato Scheme
4610 Vamos a comenzar observando algunos archivos que están en @file{ly/}.
4611 Abra @file{ly/property-init.ly} con un editor de textos. El mismo que
4612 usaría normalmente para los archivos @file{.ly} servirá perfectamente.
4613 Este archivo contiene las definiciones de todas las instrucciones
4614 estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} y
4615 @code{\slurDotted}. Podrá ver que no son nada más que definiciones de
4616 variables que contienen una o varias instrucciones @code{\override}.
4617 Por ejemplo, @code{/tieDotted} está definido de tal forma que su valor
4622 \override Tie.dash-period = #0.75
4623 \override Tie.dash-fraction = #0.1
4627 Si no le gustan los valores predeterminados, estas instrucciones
4628 predefinidas se pueden redefinir con facilidad como cualquier otra
4629 variable, al principio de su archivo de código de entrada.
4631 Los siguientes son los archivos más útiles que se encuentran en
4634 @multitable @columnfractions .4 .6
4637 @item @file{ly/engraver-init.ly}
4638 @tab Definiciones de Contextos de grabadores
4639 @item @file{ly/paper-defaults-init.ly}
4640 @tab especificaciones de valores predeterminados relacionados con el papel
4641 @item @file{ly/performer-init.ly}
4642 @tab Definiciones de Contextos de interpretación
4643 @item @file{ly/property-init.ly}
4644 @tab Definiciones de todas las instrucciones predefinidas que son comunes
4645 @item @file{ly/spanner-init.ly}
4646 @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
4649 Otros ajustes (como las definiciones de las instrucciones de marcado)
4650 se almacenan como archivos @file{.scm} (de Scheme). El lenguaje de
4651 programación Scheme se utiliza para proporcionar un interfaz
4652 programable en el funcionamiento interno de LilyPond. Cualquier
4653 explicación adicional sobre estos archivos se encuentra por el momento
4654 fuera del ámbito de este manual, porque se requieren conocimientos del
4655 lenguaje Scheme. Se advierte a los usuarios que se necesita una
4656 importante cantidad de conocimientos técnicos o de tiempo para
4657 comprender el lenguaje Scheme y estos archivos (véase @rextend{Tutorial de Scheme}).
4659 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
4662 @multitable @columnfractions .4 .6
4665 @item @file{scm/auto-beam.scm}
4666 @tab Valores predeterminados de sub-barrado
4667 @item @file{scm/define-grobs.scm}
4668 @tab valores predeterminados de las propiedades de grobs
4669 @item @file{scm/define-markup-commands.scm}
4670 @tab Especificar todas las instrucciones de marcado
4671 @item @file{scm/midi.scm}
4672 @tab Ajustes predeterminados para la salida MIDI
4673 @item @file{scm/output-lib.scm}
4674 @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
4675 @item @file{scm/parser-clef.scm}
4676 @tab Definiciones de las claves contempladas
4677 @item @file{scm/script.scm}
4678 @tab Ajustes predeterminados para las articulaciones
4682 @node Trucos avanzados con Scheme
4683 @subsection Trucos avanzados con Scheme
4684 @translationof Advanced tweaks with Scheme
4686 Aunque es posible hacer muchas cosas con las instrucciones
4687 @code{\override} y @code{\tweak} , tenemos una forma incluso más
4688 poderosa de modificar el funcionamiento de LilyPond, a través de un
4689 interface programable hacia las operaciones internas de LilyPond. Se
4690 puede incorporar código escrito en el lenguaje de programación Scheme,
4691 directamente en el mecanismo de funcionamiento de LilyPond. Por
4692 supuesto, para hacer esto se necesitan al menos unos conocimientos
4693 básicos de programación en Scheme, y damos una introducción en el
4694 @rextend{Tutorial de Scheme}.
4696 Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
4697 dar a una propiedad un valor constante, se puede establecer al
4698 resultado de un procedimiento de Scheme que se invoca cada vez que
4699 LilyPond accede a esta propiedad. La propiedad se puede establecer
4700 dinámicamente a un valor determinado por el procedimiento en el
4701 momento en que se invoca. En este ejemplo damos a las cabezas de las
4702 notas un color que depende de su posición dentro del pentagrama.
4704 @cindex x11-color, función, ejemplo de utilización
4705 @cindex NoteHead, ejemplo de sobreescritura
4706 @cindex color, propiedad, establecer a procedimiento de Scheme
4708 @lilypond[quote,verbatim,ragged-right]
4709 #(define (color-notehead grob)
4710 "Color the notehead according to its position on the staff."
4711 (let ((mod-position (modulo (ly:grob-property grob 'staff-position)
4714 ;; Return rainbow colors
4715 ((1) (x11-color 'red )) ; for C
4716 ((2) (x11-color 'orange )) ; for D
4717 ((3) (x11-color 'yellow )) ; for E
4718 ((4) (x11-color 'green )) ; for F
4719 ((5) (x11-color 'blue )) ; for G
4720 ((6) (x11-color 'purple )) ; for A
4721 ((0) (x11-color 'violet )) ; for B
4725 % Arrange to obtain color from color-notehead procedure
4726 \override NoteHead.color = #color-notehead
4727 a2 b | c2 d | e2 f | g2 a |
4731 Se pueden encontrar ejemplos adicionales que muestran la utilización
4732 de estos interfaces programables, en
4733 @rextendnamed{Callback functions,Funciones de callback}.