1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 5ae5c88bdb1a478263ed874cb823ec58dafc93f9
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
18 extremadamente configurable; prácticamente todos los fragmentos de
19 la salida se pueden cambiar.
23 * Elementos de trucaje::
24 * Manual de referencia de funcionamiento interno::
25 * Apariencia de los objetos::
26 * Colocación de los objetos::
27 * Espaciado vertical::
28 * Colisiones de objetos::
29 * Trucajes adicionales::
32 @node Elementos de trucaje
33 @section Elementos de trucaje
34 @translationof Tweaking basics
37 * Introducción al trucaje::
38 * Objetos e interfaces::
39 * Convenciones de nombres de objetos y propiedades::
40 * Métodos de trucaje::
43 @node Introducción al trucaje
44 @subsection Introducción al trucaje
45 @translationof Introduction to tweaks
47 El @q{Trucaje} es un término de LilyPond que denota los diversos
48 métodos que el usuario tiene a su disposición para modificar el
49 proceso de interpretación del archivo de entrada y cambiar la
50 apariencia de la salida impresa. Algunos trucos son muy fáciles
51 de usar; otros son más complejos. Pero en su conjunto, los
52 métodos de trucaje disponibles posibilitan conseguir casi
53 cualquier apariencia que deseemos en la música impresa.
55 En esta sección vamos a estudiar los conceptos básicos que se
56 necesitan para comprender el trucaje. Más tarde daremos un amplio
57 abanico de instrucciones listas para usar, que podrá simplemente
58 copiar para obtener el mismo efecto en sus partituras, y al mismo
59 tiempo mostraremos la forma de construir dichas instrucciones para
60 que pueda aprender cómo desarrollar sus propios trucos.
62 Antes de comenzar con este capítulo, quizá quiera echar un vistazo
63 a la sección @ref{Contextos y grabadores}, pues los Contextos, los
64 Grabadores y las Propiedades que se contienen en ellos son
65 fundamentales para comprender y construir los trucos.
67 @node Objetos e interfaces
68 @subsection Objetos e interfaces
69 @translationof Objects and interfaces
73 @cindex objeto de extensión
75 @cindex propiedades de objetos
76 @cindex objeto, propiedades de
77 @cindex layout (disposición), objeto de
78 @cindex objeto de disposición (layout)
80 El trucaje consiste en modificar el funcionamiento y estructura
81 interna del programa LilyPond, por lo que en primer lugar
82 introduciremos algunos términos que se usan para describir dichas
83 operaciones y estructuras internas.
85 El término @q{Objeto} es un término genérico que se usa para
86 referirse a la multitud de estructuras internas que LilyPond
87 construye durante el procesado de un archivo de entrada. Así,
88 cuando se encuentra una instrucción como @code{\new Staff}, se
89 construye un objeto nuevo del tipo @code{Staff}. Entonces, este
90 objeto @code{Staff} contiene todas las propiedades asociadas con
91 ese pentagrama en particular, por ejemplo, su nombre y su
92 armadura, además de otros detalles de los grabadores que se han
93 asignado para que operen dentro del contexto del pentagrama. De
94 forma similar, hay objetos que guardan las propiedades de todos
95 los demás contextos, como objetos de @code{Voice}, objetos de
96 @code{Score}, objetos de @code{Lyrics}, así como objetos que
97 representan todos los elementos notacionales como líneas
98 divisorias, cabezas de las notas, ligaduras, indicaciones
99 dinámicas, etc. Cada objeto tiene su propio conjunto de valores
102 Ciertos tipos de objetos reciben nombres especiales. Los objetos
103 que representan elementos de notación sobre la salida impresa como
104 cabezas de notas, plicas, ligaduras de expresión y de unión,
105 digitaciones, claves, etc. reciben el nombre de @q{Objetos de
106 presentación}, a menudo conocidos como @q{Objetos gráficos}, o
107 abreviadamente @q{Grobs}. Aún son objetos en el sentido genérico
108 que hemos mencionado, y también todos ellos tienen propiedades
109 asociadas, como su posición, tamaño, color,etc.
111 Ciertos objetos de presentación son aún más especializados. Las
112 ligaduras de fraseo, los reguladores, las indicaciones de octava
113 alta y baja, y muchos otros objetos gráficos no están situados en
114 un solo lugar: tienen un punto de inicio, un punto de final, y
115 quizá otras propiedades relacionadas con su forma. Los objetos
116 con una forma extendida como estos, reciben el nombre de «Objetos
117 de extensión» o @q{Spanners}.
119 Los «spanners» no se pueden trucar después de haberse creado.
120 Ello incluye tanto a @code{StaffSymbol} como a
121 @code{LedgerLineSpanner}, que continúan a lo largo de toda la
122 partitura (excepto si se les da fin con la instrucción
123 @code{\stopStaff} y se vuelven a crear con la instrucción
126 Es más, existen objetos gráficos @q{abstractos} que no impriman
127 nada por sí mismos, sino que más bien recopilan, posicionan y
128 gestionan a otros objetos gráficos. Los ejemplos usuales son
129 @code{DynamicLineSpanner}, @code{BreakAlignment},
130 @code{NoteColumn}, @code{VerticalAxisGroup},
131 @code{NonMusicalPaperColumn} y similares. Más tarde veremos cómo
132 se usan algunos de ellos.
134 Aún falta por explicar qué son los @q{Interfaces}. Muchos
135 objetos, incluso aunque son bastante diferentes, comparten
136 funcionalidades que se deben procesar de la misma manera. Por
137 ejemplo, todos los objetos gráficos tienen un color, un tamaño,
138 una posición, etc., y todas estas propiedades se procesan de la
139 misma forma durante la interpretación del archivo de entrada por
140 parte de LilyPond. Para simplificar estas operaciones internas,
141 estas acciones y propiedades comunes se agrupan en un objeto
142 llamado @code{grob-interface}, interface de grob. Hay muchas
143 otras agrupaciones de propiedades comunes como ésta, y cada una
144 recibe un nombre que acaba en @code{interface}. En total hay más
145 de 100 interfaces de éstos. Veremos más adelante porqué esto es
146 del interés y de utilidad para el usuario.
148 Estos son, en fin, los términos principales relativos a los
149 objetos que vamos a utilizar en este capítulo.
151 @node Convenciones de nombres de objetos y propiedades
152 @subsection Convenciones de nombres de objetos y propiedades
153 @translationof Naming conventions of objects and properties
155 @cindex nomenclatura, convenciones de, para objetos
156 @cindex nomenclatura, convenciones de, para propiedades
157 @cindex objetos, convenciones de nomenclatura
158 @cindex propiedades, convenciones de nomenclatura
160 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
161 sección @ref{Contextos y grabadores}. En este lugar, para más fácil
162 referencia, presentamos una lista de los tipos de objetos y
163 propiedades más comunes, junto con las convenciones según las cuales
164 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
165 utilizado una @q{A} mayúscula para denotar cualquier carácter
166 alfabético en mayúsculas, y @q{aaa} para cualquier número de
167 caracteres alfabéticos en minúscula. Otros caracteres se utilizan
168 literalmente como están.
170 @multitable @columnfractions .33 .33 .33
171 @headitem Objeto o tipo de propiedad
172 @tab Convención de nomenclatura
175 @tab Aaaa o AaaaAaaaAaaa
176 @tab Staff, GrandStaff
177 @item Objetos de presentación
178 @tab Aaaa o AaaaAaaaAaaa
181 @tab Aaaa_aaa_engraver
182 @tab Clef_engraver, Note_heads_engraver
184 @tab aaa-aaa-interface
185 @tab grob-interface, break-aligned-interface
186 @item Propiedades de contextos
187 @tab aaa o aaaAaaaAaaa
188 @tab alignAboveContext, skipBars
189 @item Propiedades de objetos de presentación
190 @tab aaa o aaa-aaa-aaa
191 @tab direction, beam-thickness
194 Como podremos ver en breve, las propiedades de distintos tipos de
195 objeto se modifican por parte de diferentes instrucciones; así pues,
196 es útil poder reconocer los tipos de objetos y propiedades
197 a partir de sus nombres.
200 Referencia de la notación:
201 @ruser{Modificar las propiedades}.
204 @node Métodos de trucaje
205 @subsection Métodos de trucaje
206 @translationof Tweaking methods
208 @cindex trucaje, métodos de
210 @strong{La instrucción \override}
213 * La instrucción override::
214 * La instrucción revert::
216 * La instrucción overrideProperty::
217 * La instrucción tweak::
220 @node La instrucción override
221 @unnumberedsubsubsec La instrucción @code{@bs{}override}
222 @translationof The override command
224 @cindex override, instrucción
225 @cindex override (sobreescritura), sintaxis de
230 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que
231 se usan para cambiar las propiedades de los @strong{contextos} y
232 para quitar y poner @strong{grabadores}, en
233 @ref{Modificar las propiedades de los contextos} y
234 @ref{Añadir y eliminar grabadores}. Ahora debemos examinar
235 algunas otras instrucciones importantes.
237 La instrucción que cambia las propiedades de los @strong{objetos
238 de presentación} es @code{\override}. Puesto que esta instrucción
239 debe modificar propiedades internas que se encuentran en un lugar
240 profundo dentro de LilyPond, su sintaxis no es tan simple como la
241 del resto de las instrucciones que hemos usado hasta ahora. Tiene
242 que saber exactamente qué propiedad de qué objeto y en qué
243 contexto se debe modificar, y cuál debe ser su nuevo valor.
246 La sintaxis genérica de esta instrucción es:
249 \override @var{Contexto}.@var{ObjetoDePresentación}.@var{propiedad-de-presentación} =
254 Esto establecerá la propiedad de nombre
255 @var{propiedad-de-presentación} del objeto de presentación con el
256 nombre @var{ObjetoDePresentación}, que es miembro del contexto
257 @var{Contexto}, al valor @var{valor}.
259 El @var{contexto} se puede omitir (y normalmente así es) cuando el
260 contexto requerido se encuentra implicado sin ambigüedad y es uno
261 de los contextos del nivel más bajo, es decir: @code{Voice},
262 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de
263 los ejemplos siguientes. Veremos más tarde cuándo se debe
266 Las últimas secciones tratan de forma exhaustiva las propiedades y
267 sus valores, véase @ref{Tipos de propiedades}. Pero en esta
268 sección usaremos sólo unas cuantas propiedades y valores sencillos
269 que sean fáciles de entender, para ilustrar el formato y la
270 utilización de estas instrucciones.
272 Las expresiones principales de LilyPond son elementos musicales
273 como notas, duraciones y elementos de marcado. Las expresiones
274 más básicas como números, cadenas de caracteres y listas se
275 procesan en el @q{modo de Scheme}, que se invoca por medio del
276 prefijo @samp{#} escrito antes del valor. Aunque los valores
277 pueden tener a veces una representación válida en el modo de
278 música de LilyPond, este manual utiliza siempre @samp{#} para la
279 escritura, por coherencia. Para ver más información acerca del
280 modo de Scheme, consulte @rextend{Sintaxis del Scheme de LilyPond}.
282 @code{\override} es la instrucción de uso más común dentro del
283 trucaje, y durante la mayor parte del resto de este capítulo
284 presentaremos ejemplos de cómo se usa. A continuación hay un
285 ejemplo sencillo para cambiar el color de una cabeza:
287 @cindex color, propiedad, ejemplo
288 @cindex NoteHead, ejemplo de sobreescritura
290 @lilypond[quote,ragged-right,verbatim]
293 \override NoteHead.color = #red
295 \override NoteHead.color = #green
301 @node La instrucción revert
302 @unnumberedsubsubsec La instrucción @code{@bs{}revert}
303 @translationof The revert command
305 @cindex revert, instrucción
310 Una vez sobreescrita, la propiedad retiene su nuevo valor hasta
311 que se sobreescribe de nuevo o se encuentra una instrucción
312 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
313 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
314 valor predeterminado original; observe que no es a su valor previo
315 si se han utilizado varias instrucciones @code{\override}.
318 \revert @var{Contexto}.@var{ObjetoDePresentación}.@var{propiedad-de-presentación}
321 Una vez más, igual que @var{Contexto} dentro de la instrucción
322 @code{\override}, con frecuencia no es necesario especificar el
323 @var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
324 Aquí devolvemos el color de la cabeza al valor predeterminado para
325 las dos últimas notas:
327 @cindex color, propiedad, ejemplo
328 @cindex NoteHead, ejemplo de sobreescritura
330 @lilypond[quote,ragged-right,verbatim]
333 \override NoteHead.color = #red
335 \override NoteHead.color = #green
337 \revert NoteHead.color
343 @node El prefijo once
344 @unnumberedsubsubsec El prefijo @code{@bs{}once}
345 @translationof The once prefix
350 @code{\override}, @code{\revert}, @code{\set} y @code{\unset} se
351 pueden hacer preceder por @code{\once}. Esto hace que la
352 instrucción sea efectiva solamente durante el tiempo musical en
353 curso y antes de que la propiedad vuelva a tener otra vez su valor
354 anterior (que puede ser distinto de su valor predeterminado si aún
355 se está aplicando otra instrucción @code{\override} de
356 sobreescritura). Utilizando el mismo ejemplo, podemos cambiar el
357 color de una sola nota de la siguiente manera:
359 @cindex color, propiedad, ejemplo
360 @cindex NoteHead, ejemplo de sobreescritura
362 @lilypond[quote,verbatim]
365 \override NoteHead.color = #red
367 \once \override NoteHead.color = #green
369 \once \revert NoteHead.color
371 \revert NoteHead.color
376 El prefijo @code{\once} también se puede usar delante de muchas
377 instrucciones predefinidas para limitar su efecto a un solo
380 @lilypond[quote,verbatim]
391 @node La instrucción overrideProperty
392 @unnumberedsubsubsec La instrucción @code{@bs{}overrideProperty}
393 @translationof The overrideProperty command
395 @cindex overrideProperty, instrucción
397 @funindex \overrideProperty
398 @funindex overrideProperty
400 Hay otra forma para la instrucción de sobreescritura,
401 @code{\overrideProperty}, que ocasionalmente es necesaria. La
402 mencionamos aquí con un propósito de exhaustividad, pero para ver
403 más detalles consulte @rextend{Trucos difíciles}.
404 @c Maybe explain in a later iteration -td
407 @node La instrucción tweak
408 @unnumberedsubsubsec La instrucción @code{@bs{}tweak}
409 @translationof The tweak command
411 @cindex tweak, instrucción
416 La última instrucción de trucaje que está disponible es
417 @code{\tweak}. Se debe utilizar cuando varios objetos tienen
418 lugar en el mismo momento musical pero solo queremos cambiar las
419 propiedades de algunos de ellos, como una sola nota dentro de un
420 acorde. El uso de @code{\override} para la sobreescritura
421 afectaría a todas las notas del acorde, mientras que @code{\tweak}
422 afecta solamente al siguiente elemento del flujo de entrada.
424 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
425 cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
426 primer lugar, veamos lo que haría @code{\once \override}:
428 @cindex font-size, propiedad, ejemplo
429 @cindex NoteHead, ejemplo de sobreescritura
431 @lilypond[quote,ragged-right,verbatim]
434 \once \override NoteHead.font-size = #-3
440 Vemos que la sobreescritura con override afecta a @emph{todas} las
441 cabezas de las notas del acorde. Esto es así porque todas las
442 notas de un acorde ocurren en el mismo @emph{momento musical}, y
443 la acción de @code{\once} es aplicar la sobreescritura a todos los
444 objetos de presentación del tipo especificado que ocurren en el
445 mismo momento musical que la propia instrucción de sobreescritura
448 La instrucción @code{\tweak} opera de una forma distinta. Actúa
449 sobre el elemento inmediatamente siguiente dentro del flujo de
450 entrada. En su forma más sencilla es efectivo solamente sobre
451 objetos que se crean directamente a partir del elemento siguiente,
452 en esencia las cabezas y las articulaciones.
454 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota
455 intermedia se cambiaría de la siguiente forma:
457 @cindex font-size, propiedad, ejemplo
458 @cindex @code{\tweak}, ejemplo
460 @lilypond[quote,ragged-right,verbatim]
463 <c \tweak font-size #-3 e g>4
467 Observe que la sintaxis de @code{\tweak} no es igual que la de
468 @code{\override}. El contexto no se debe especificar; de hecho,
469 generaría un error hacerlo. Tanto el contexto como el objeto de
470 presentación están implícitos por el siguiente elemento del flujo
471 de entrada. Observe también que no debe haber un signo igual. Así
472 que la sintaxis de la instrucción @code{\tweak} en su forma
476 \tweak @var{propiedad-de-presentación} #@var{valor}
479 Una instrucción @code{\tweak} también se puede usar para modificar
480 sólo una de una serie de articulaciones, como se muestra aquí:
482 @cindex color, propiedad, ejemplo
483 @cindex @code{\tweak}, ejemplo
485 @lilypond[quote,fragment,ragged-right,verbatim]
487 -\tweak color #red ^"Red"
488 -\tweak color #green _"Green"
492 Observe que la instrucción @code{\tweak} debe venir precedida de
493 una marca de articulación porque la propia expresión trucada debe
494 aplicarse como una articulación. En el caso de más de una
495 sobreescritura de dirección (@code{^} o @code{_}), gana la
496 sobreescritura situada más a la izquierda porque se aplica en
499 @cindex @code{\tweak}, Accidental
500 @cindex @code{\tweak}, specific layout object
502 Los objetos tales como plicas y alteraciones accidentales se crean
503 más tarde, y no directamente a partir del evento que viene a
504 continuación. Aún es posible utilizar @code{\tweak} sobre tales
505 objetos creados indirectamente mediante el nombrado explícito del
506 objeto de presentación, siempre y cuando LilyPond pueda rastrear
507 su origen hasta el evento original:
509 @lilypond[quote,fragment,ragged-right,verbatim]
510 <\tweak Accidental.color #red cis''4
511 \tweak Accidental.color #green es''
515 Esta forma extensa de la instrucción @code{\tweak} se puede describir
518 \tweak @var{LayoutObject}.@var{layout-property} #@var{value}
519 "ANTES" \tweak @var{objeto-de-presentación}.@var{propiedad-de-presentación} @var{valor}
522 @cindex grupos especiales anidados
523 @cindex tresillos anidados
524 @cindex corchete del grupo especial
525 @cindex corchete de tresillo
526 @cindex grupo especial, corchete de
527 @cindex tresillo, corchete de
529 @funindex TupletBracket
531 La instrucción @code{\tweak} también se debe usar para cambiar la
532 apariencia de uno solo de un conjunto de grupos especiales
533 anidados que comiencen en el mismo instante musical. En el
534 siguiente ejemplo, el corchete del tresillo largo y el primero de
535 los tres corchetes cortos empiezan en el mismo momento musical, y
536 por ello cualquier instrucción @code{\override} se aplicaría a los
537 dos. En el ejemplo se usa @code{\tweak} para distinguir entre
538 ellos. La primera instrucción @code{\tweak} especifica que el
539 corchete del tresillo largo se debe colocar por encima de las
540 notas y el segundo especifica que el número del tresillo se debe
541 imprimir en rojo sobre el corchete del primer tresillo corto.
543 @cindex @code{\tweak}, ejemplo
544 @cindex direction, propiedad, ejemplo
545 @cindex color, propiedad, ejemplo
547 @lilypond[quote,ragged-right,verbatim]
552 \tuplet 3/2 { c8[ c c] }
553 \tuplet 3/2 { c8[ c c] }
554 \tuplet 3/2 { c8[ c c] }
559 Si los grupos anidados no comienzan en el mismo momento, su
560 apariencia se puede modificar de la forma usual mediante
561 instrucciones @code{\override}:
563 @cindex text, propiedad, ejemplo
564 @cindex tuplet-number, función, ejemplo
565 @cindex transparent, propiedad, ejemplo
566 @cindex TupletNumber, ejemplo de sobreescritura
568 @lilypond[quote,ragged-right,verbatim]
570 \tuplet 3/2 { c'8[ c c] }
571 \once \override TupletNumber.text = #tuplet-number::calc-fraction-text
575 \once \override TupletNumber.transparent = ##t
576 \tuplet 3/2 { c8[ c c] }
577 \tuplet 3/2 { c8[ c c] }
584 Referencia de la notación:
585 @ruser{La instrucción tweak}.
587 @node El prefijo single
588 @unnumberedsubsubsec El prefijo @code{@bs{}single}
589 @translationof The single prefix
592 @cindex truco, generado a partir de una sobreescritura
594 Supongamos que queremos enfatizar la cabeza de algunas notas
595 trazándolas de color e incrementando su tamaño, y supongamos
596 también hemos programado una función para hacer la tarea más
599 @lilypond[quote,verbatim]
601 \override NoteHead.color = #red
602 \override NoteHead.font-size = 2
605 c''4 a \once \emphNoteHead f d |
609 El prefijo @code{\once} funciona perfectamente para enfatizar
610 notas únicas o acordes completos, pero no se puede usar para
611 enfatizar una sola nota @emph{dentro} de un acorde. Anteriormente
612 vimos cómo se puede usar la instrucción @code{\tweak} para
613 hacerlo, véase @ref{La instrucción tweak,,La instrucción
614 @code{@bs{}tweak}}. Pero @code{\tweak} no se puede usar con una
615 función; ahí es donde entra la instrucción @code{\single}:
617 @lilypond[quote,verbatim]
619 \override NoteHead.color = #red
620 \override NoteHead.font-size = 2
623 <c'' a \single \emphNoteHead f d>4
627 En resumen, @code{\single} convierte las sobreescrituras hechas
628 con@code{\override} en trucos hechos con @code{\tweak} de tal
629 manera que cuando hay varios objetos en el mismo instante de
630 tiempo musical (como las notas de un acorde), @code{\single}
631 afecta a una única nota, la que se genera por la expresión que
632 sigue inmediatamente, a diferencia de @code{\once} que afecta a
635 El uso de @code{\single} de esta forma con una función cualquiera
636 que contenga solamente sobreescrituras, puede aplicarse a las
637 notas individuales de un acorde. Sin embargo, @code{\single} no
638 convierte @code{\revert}, @code{\set} ni @code{\unset} en trucos
642 Manual de aprendizaje:
643 @ref{La instrucción tweak,,La instrucción @code{@bs{}tweak}},
644 @ref{Uso de variables para los ajustes de disposición}.
647 @node Manual de referencia de funcionamiento interno
648 @section Manual de referencia de funcionamiento interno
649 @translationof The Internals Reference manual
651 @cindex Referencia de funcionamiento interno
654 * Propiedades de los objetos de presentación::
655 * Propiedades de los interfaces::
656 * Tipos de propiedades::
659 @node Propiedades de los objetos de presentación
660 @subsection Propiedades de los objetos de presentación
661 @translationof Properties of layout objects
663 @cindex propiedades de los objetos de presentación
664 @cindex propiedades de los grobs
665 @cindex grobs, propiedades de
666 @cindex presentación, propiedades de los objetos de
667 @cindex Referencia de funcionamiento interno
669 Suponga que tiene una partitura con una ligadura de expresión que
670 para su gusto es demasiado fina y quiere trazarla un poco más
671 gruesa. ¿Cómo debe proceder? Ya sabe, por las afirmaciones
672 anteriores acerca de la flexibilidad de LilyPond, que tal
673 posibilidad existe, y seguramente piensa que una cierta
674 instrucción de sobreescritura @code{\override} será necesaria.
675 Pero ¿existe una propiedad de grosor para las ligaduras? y, si la
676 hay, ¿cómo se puede modificar? Aquí es donde interviene el Manual
677 de Funcionamiento Interno. Contiene toda la información que puede
678 necesitar para construir ésta y todas las demás instrucciones
679 @code{\override}, de sobreescritura.
681 Una advertencia antes de dirigir nuestra mirada a la referencia de
682 funcionamiento interno. Éste es un documento de
683 @strong{referencia}, lo que significa que hay pocas o ninguna
684 explicación en él: su propósito es presentar la información de
685 forma precisa y concisa. Por tanto, podrá parecerle desalentador
686 a primera vista. ¡No se preocupe! La guía y las explicaciones
687 que presentamos aquí le permitirán extraer la información de la
688 referencia de funcionamiento interno por sí mismo con tan sólo
691 @cindex sobreescritura, ejemplo de
692 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
693 @cindex @code{\addlyrics}, ejemplo
695 Utilicemos un ejemplo concreto con un sencillo fragmento de música
698 @c Mozart, dúo, núm. 7 de La Flauta Mágica
700 @lilypond[quote,verbatim]
705 r4 bes'8 bes[( g]) g |
706 g8[( es]) es d[( f]) as |
710 The man who | feels love's sweet e -- | mo -- tion
715 Suponga ahora que decidimos que nos gustan las ligaduras algo más
716 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
717 presentación, así que la cuestión es @q{¿Hay una propiedad
718 perteneciente a las ligaduras de expresión que controle su
719 grosor?} Para responder a esta pregunta debemos mirar el manual
720 de Referencia de Funcionamiento Interno, abreviadamente
721 RFI@footnote{@strong{IR} (Internals Reference) en inglés}.
723 El RFI de la versión de LilyPond que está usando se puede
724 encontrar en la página web de LilyPond en
725 @uref{http://lilypond.org}. Vaya a la página de la documentación
726 y siga el enlace Manual de Referencia de Funcionamiento Interno
727 (RFI). Para nuestros propósitos pedagógicos sería mejor que
728 utilizase la versión en HTML, no la @q{en una sola página} ni el
729 PDF. Para que los siguientes párrafos tengan algún sentido deberá
730 consultarlo realmente al tiempo que lee.
732 @c Link names in English as those pages are not yet translated. FV
733 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
734 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
735 información sobre los objetos de presentación. Una vez allí, bajo
736 el encabezamiento @strong{Backend}, siga el enlace @emph{All
737 layout objects}. La página que aparece relaciona todos los
738 objetos de presentación que se usan en su versión de LilyPond, en
739 orden alfabético. Siga el enlace Slur (ligadura de expresión), y
740 aparecerán relacionadas las propiedades de las ligaduras de
743 Una forma alternativa de encontrar esta página es a partir de la
744 Referencia de la Notación. En una de las páginas que tratan de
745 las ligaduras de expresión podrá encontrar un enlace al manual de
746 referencia del funcionamiento interno. Este enlace le llevará
747 directamente a esta página, aunque si tiene una idea del nombre
748 del objeto de presentación que pretende trucar, le resultará más
749 fácil ir directamente al RFI y buscar allí.
751 Esta página sobre las ligaduras de expresión dentro del manual RFI
752 nos dice en primer lugar que los objetos Slur se crean por el
753 grabador Slur_engraver. A continuación relaciona los ajustes
754 estándar. Navegue por ellos buscando una propiedad que pudiera
755 controlar el grosor de las ligaduras, y encontrará
758 @code{thickness} (number)
760 Line thickness, generally measured in @code{line-thickness}
763 Esto promete ser una buena opción para cambiar el grosor. Nos
764 dice que el valor de @code{thickness} es un simple @emph{número},
765 que el valor predeterminado es 1.2, y que las unidades están
766 dentro de otra propiedad llamada @code{line-thickness}.
768 Como dijimos con anterioridad, existen entre pocas y ninguna
769 explicación en el RFI, pero ya tenemos información suficiente para
770 probar a cambiar el grosor de la ligadura. Vemos que el nombre
771 del objeto de presentación es @code{Slur}, que el nombre de la
772 propiedad que debemos cambiar es @code{thickness} y que el nuevo
773 valor debe ser un número algo más grande que 1.2 si queremos hacer
774 las ligaduras más gruesas.
776 Ahora podemos construir la instrucción de sobreescritura
777 @code{\override} simplemente mediante la sustitución de los
778 valores que hemos encontrado para los nombres, omitiendo el
779 contexto. Usaremos un valor muy grande para el grosor al
780 principio, para estar seguros de que la instrucción está
781 funcionando. Obtenemos lo siguiente:
784 \override Slur.thickness = #5.0
787 ¡No olvide el @code{#'} antes del nombre de la propiedad
788 y@tie{}@code{#} antes del valor nuevo!
790 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
791 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
792 respuesta es: @q{Dentro de la música, antes de la primera ligadura
793 y cerca de ella.} Hagámoslo así:
795 @cindex Slur, ejemplo de sobreescritura
796 @cindex thickness, propiedad, ejemplo
798 @lilypond[quote,verbatim]
803 % Increase thickness of all following slurs from 1.2 to 5.0
804 \override Slur.thickness = #5.0
805 r4 bes'8 bes[( g]) g |
806 g8[( es]) es d[( f]) as |
810 The man who | feels love's sweet e -- | mo -- tion
816 y podemos ver que la ligadura, es sin duda, más pesada.
818 Así pues, ésta es la forma básica de construir instrucciones
819 @code{\override} o de sobreescritura. Existen unas cuantas
820 complicaciones más con las que nos encontraremos en secciones
821 posteriores, pero ahora conoce todos los principios esenciales que
822 necesita para hacerlo por sí mismo (aunque aún necesita algo de
823 práctica). La cual vendrá proporcionada por los ejemplos que
824 vienen a continuación.
826 @subsubsubheading Búsqueda del contexto
828 @cindex contexto, encontrar
829 @cindex contexto, buscar el, correcto
831 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
832 especificar el contexto? ¿Cuál sería? Podemos suponer que las
833 ligaduras están en el contexto de Voz, por estar claramente
834 asociados de manera estrecha con las líneas individuales de
835 música, pero ¿podemos estar seguros? Para averiguarlo, vayamos de
836 nuevo al inicio de la página del RFI que describe las ligaduras
837 (Slur), donde dice @q{Slur objects are created by: Slur engraver}
838 («Los objetos de ligadura de expresión se crean por: el grabador
839 Slur»). Así pues, las ligaduras de expresión se crean en
840 cualquier contexto en el que se encuentre el grabador
841 @code{Slur_engraver}. Siga el enlace a la página del grabador
842 @code{Slur_engraver}. Al final del todo, dice que el grabador
843 @code{Slur_engraver} es parte de siete contextos de voz, incluido
844 el contexto de voz estándar, @code{Voice}, por lo que nuestra
845 suposición era acertada. Y a causa de que @code{Voice} es uno de
846 los contextos de más bajo nivel que se encuentra implícito sin
847 ambigüedad por el hecho de que estamos escribiendo notas, podemos
848 omitirlo en este lugar concreto.
850 @subsubsubheading Sobreescritura por una sola vez
852 @cindex sobreescritura por una sola vez
853 @cindex once override
858 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
859 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
860 ligadura fuese más gruesa? Esto se consigue con la instrucción o
861 prefijo @code{\once}. Colocado inmediatamente antes de la
862 instrucción @code{\override} ocasiona que solamente cambie la
863 ligadura que comienza en la nota @strong{inmediata siguiente}. Si
864 la nota inmediata siguiente no da inicio a una ligadura, la
865 instrucción no tiene ningún efecto en absoluto: no se recuerda
866 hasta que se encuentre alguna ligadura, sino que simplemente se
867 ignora. Así pues, la instrucción que lleva @code{\once} se debe
868 reposicionar de la forma siguiente:
870 @cindex Slur, ejemplo de sobreescritura
871 @cindex thickness, propiedad, ejemplo
873 @lilypond[quote,verbatim]
879 % Increase thickness of immediately following slur only
880 \once \override Slur.thickness = #5.0
882 g8[( es]) es d[( f]) as |
886 The man who | feels love's sweet e -- | mo -- tion
892 Hemos hecho que ahora solamente la primera ligadura sea más
895 La instrucción o prefijo @code{\once} también se puede usar antes
896 de la instrucción @code{\set}.
898 @subsubsubheading Recuperación del ajuste
901 @cindex predeterminadas, recuperar las propiedades
906 Finalmente ¿y si quisiéramos que solamente las dos primeras
907 ligaduras fuesen más gruesas? En fin; podríamos usar dos
908 instrucciones, cada una de ellas precedida por el prefijo
909 @code{\once}, situadas inmediatamente antes de cada una de las
910 notas en que comienzan las ligaduras:
912 @cindex Slur, ejemplo de sobreescritura
913 @cindex thickness, propiedad, ejemplo
915 @lilypond[quote,verbatim]
921 % Increase thickness of immediately following slur only
922 \once \override Slur.thickness = #5.0
924 % Increase thickness of immediately following slur only
925 \once \override Slur.thickness = #5.0
926 g8[( es]) es d[( f]) as |
930 The man who | feels love's sweet e -- | mo -- tion
936 o podríamos omitir la instrucción prefija @code{\once} y utilizar
937 la instrucción @code{\revert} (restablecer) para devolver la
938 propiedad del grosor, @code{thickness}, a su valor predeterminado
939 después de la segunda ligadura:
941 @cindex Slur, ejemplo de sobreescritura
942 @cindex thickness, propiedad, ejemplo
944 @lilypond[quote,verbatim]
950 % Increase thickness of all following slurs from 1.2 to 5.0
951 \override Slur.thickness = #5.0
954 % Revert thickness of all following slurs to default of 1.2
955 \revert Slur.thickness
960 The man who | feels love's sweet e -- | mo -- tion
966 la instrucción @code{\revert} se puede utilizar para devolver
967 cualquier propiedad que se haya cambiado con @code{\override} a su
968 valor predeterminado. Puede utilizar el método que mejor se
969 adapte a aquello que quiere hacer.
971 Así finaliza nuestra introducción al manual de RFI, y el método
972 básico de trucaje. A continuación, en las últimas secciones de
973 este capítulo encontrará varios ejemplos, en parte para
974 introducirle en algunas de las posibilidades adicionales del
975 manual RFI, y en parte para proporcionarle más práctica en cómo
976 extraer información de él. Estos ejemplos irán conteniendo cada
977 vez menos palabras de guía y explicación.
979 @node Propiedades de los interfaces
980 @subsection Propiedades de los interfaces
981 @translationof Properties found in interfaces
984 @cindex propiedades de los interfaces
985 @cindex interfaces, propiedades
987 Suponga ahora que queremos imprimir la letra de la canción en
988 cursiva. ¿Qué forma de instrucción @code{\override} necesitamos
989 para hacerlo? En primer lugar miramos en la página del RFI que
990 relaciona todos los objetos, @q{All layout objects}, como antes, y
991 buscamos un objeto que pueda controlar la letra de la canción.
992 Encontramos @code{LyricText}, que parece adecuado. Al seguir este
993 enlace se presentan las propiedades ajustables para el texto de la
994 letra. Estos incluyen @code{font-series} y @code{font-size}, pero
995 nada que pudiera aplicar una forma cursiva. Esto es porque la
996 propiedad de la forma es común a todos los objetos de fuente
997 tipográfica, y por tanto, en vez de incluirlo en cada uno de los
998 objetos de presentación, se agrupa junto con otras propiedades
999 comunes similares y se deposita en un @strong{Interface}, el
1000 interface de las fuentes tipográficas @code{font-interface}.
1002 Por tanto, ahora necesitamos aprender cómo encontrar las
1003 propiedades de los interfaces, y descubrir qué objetos usan estas
1004 propiedades de interface.
1006 Mire de nuevo la página del RFI que describe a LyricText. Al
1007 final de la página hay una lista de enlaces a los interfaces que
1008 LyricText contempla. La lista tiene siete elementos, entre ellos
1009 @code{font-interface}. Al seguir este enlace llegamos a las
1010 propiedades asociadas con este interface, que también son
1011 propiedades de todos los objetos que lo llevan, entre ellos
1014 Ahora vemos todas las propiedades ajustables por el usuario que
1015 controlan las tipografías, entre ellas @code{font-shape(symbol)},
1016 donde @code{symbol} se puede establecer a @code{upright} (recta),
1017 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
1019 Observará que @code{font-series} y @code{font-size} también se
1020 encuentran aquí relacionadas. Esto inmediatamente hace que surja
1021 la pregunta: ¿Por qué están las propiedades comunes de tipografía
1022 @code{font-series} y @code{font-size} relacionadas bajo
1023 @code{LyricText} así como bajo el interface @code{font-interface}
1024 pero @code{font-shape} no lo está? La respuesta es que
1025 @code{font-series} y @code{font-size} se cambian a partir de sus
1026 valores predeterminados globales cuando se crea un objeto
1027 @code{LyricText}, pero @code{font-shape} no lo hace. Entonces los
1028 elementos de la lista @code{LyricText} le dicen los valores para
1029 esas dos propiedades que son de aplicación para @code{LyricText}.
1030 Otros objetos que contemplan @code{font-interface} establecerán
1031 dichas propiedades de forma diferente cuando se crean.
1033 Veamos si ahora podemos construir la instrucción @code{\override}
1034 para cambiar la letra a cursiva. El objeto es @code{LyricText},
1035 la propiedad es @code{font-shape} y el valor es @code{italic}.
1036 Igual que antes, omitiremos el contexto.
1038 Como nota aparte, aunque es importante, observe que ciertas
1039 propiedades toman valores que son símbolos, como @code{italic}, y
1040 deben ir precedidos de un apóstrofo, @code{'}. Los símbolos se
1041 leen a continuación internamente por parte de LilyPond. Tenga en
1042 cuenta la diferencia con las cadenas de texto arbitrarias, que
1043 aparecerían como @code{"una cadena de texto"}; para ver más
1044 detalles sobre los símbolos y las cadenas, consulte
1045 @rextend{Tutorial de Scheme}.
1047 Así pues, la instrucción @code{\override} necesaria para imprimir
1048 la letra en cursiva, es:
1051 \override LyricText.font-shape = #'italic
1055 Esto debe escribirse justo delante de la letra a la que debe
1056 afectar, de esta forma:
1058 @cindex font-shape, propiedad, ejemplo
1059 @cindex italic, ejemplo
1060 @cindex LyricText, ejemplo de sobreescritura
1061 @cindex @code{\addlyrics}, ejemplo
1063 @lilypond[quote,ragged-right,verbatim]
1068 r4 bes'8 bes[( g]) g |
1069 g8[( es]) es d[( f]) as |
1073 \override LyricText.font-shape = #'italic
1074 The man who | feels love's sweet e -- | mo -- tion
1080 y toda la letra se imprime en cursiva.
1082 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
1083 final y la llave de cierre.}
1087 Manual de Extensión:
1088 @rextend{Tutorial de Scheme}.
1091 @node Tipos de propiedades
1092 @subsection Tipos de propiedades
1093 @translationof Types of properties
1095 @cindex propiedades, tipos de
1097 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
1098 @code{símbolo}. Para que sea válido, el valor que se da a una
1099 propiedad debe ser del tipo correcto y obedecer las reglas de
1100 dicho tipo. El tipo de la propiedad se muestra siempre entre
1101 paréntesis después del nombre de la propiedad en el RFI. He aquí
1102 una lista de los tipos que podrá necesitar, junto con las reglas
1103 de dicho tipo, y algunos ejemplos. Debe escribir siempre un
1104 símbolo de almohadilla, @code{#}, por supuesto, delante de estos
1105 valores cuando se introducen en la instrucción @code{\override},
1106 incluso si el propio valor ya comienza por@tie{}@code{#}.
1107 Solamente ofrecemos aquí ejemplos para constantes; si quiere
1108 calcular un valor usando Scheme, consulte @rextend{Cálculos en
1111 @multitable @columnfractions .2 .45 .35
1112 @headitem Tipo de propiedad
1116 @tab Verdadero o Falso, representado por #t o #f
1117 @tab @code{#t}, @code{#f}
1118 @item Dimensión (en espacios de pentagrama)
1119 @tab Un número decimal (en unidades de espacios de pentagrama)
1120 @tab @code{2.5}, @code{0.34}
1122 @tab Una constante válida de dirección o su equivalente numérico
1123 (@code{0} o @code{CENTER} indican una dirección neutra)
1124 @tab @code{LEFT}, @code{CENTER}, @code{UP},
1125 @code{1}, @w{@code{-1}}
1127 @tab Un número entero positivo
1128 @tab @code{3}, @code{-1}
1130 @tab Una secuencia de constantes o símbolos separados por espacios,
1131 encerrado entre paréntesis
1132 y precedido de un apóstrofo o comilla simple
1133 @tab @code{'(left-edge staff-bar)}, @code{'(1)}, @code{'()},
1134 @code{'(1.0 0.25 0.5)}
1136 @tab Cualquier elemento válido de marcado de texto
1137 @tab @code{\markup @{ \italic "cresc." @}}, @code{"gaita"}
1139 @tab Una fracción de redonda construida con la función make-moment
1140 @tab @code{(ly:make-moment 1/4)},
1141 @code{(ly:make-moment 3/8)}
1143 @tab Cualquier valor positivo o negativo, posiblemente decimal
1144 @tab @code{3}, @w{@code{-2.45}}
1145 @item Pareja (de números)
1146 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
1147 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
1149 @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
1150 @tab @code{'italic}, @code{'inside}
1152 @tab Un procedimiento o @code{#f} para no producir ninguna acción
1153 @tab @code{bend::print}, @code{ly:text-interface::print},
1157 encerradas entre @code{#(}@dots{}@code{)}.
1158 @tab @code{#(#t #t #f)}
1163 Manual de Extensión:
1164 @rextend{Tutorial de Scheme}.
1167 @node Apariencia de los objetos
1168 @section Apariencia de los objetos
1169 @translationof Appearance of objects
1171 Ahora vamos a poner en práctica lo que hemos aprendido con unos
1172 cuantos ejemplos que muestran cómo se pueden usar los trucos para
1173 cambiar el aspecto de la música impresa.
1176 * Visibilidad y color de los objetos::
1177 * Tamaño de los objetos::
1178 * Longitud y grosor de los objetos::
1181 @node Visibilidad y color de los objetos
1182 @subsection Visibilidad y color de los objetos
1183 @translationof Visibility and color of objects
1185 Dentro de un uso educativo de la música, podríamos desear imprimir
1186 una partitura con ciertos elementos omitidos como ejercicio para
1187 el alumno, a quien se le pide que los complete. A la manera de
1188 ejemplo sencillo, supongamos que el ejercicio es escribir las
1189 líneas divisorias que faltan en un fragmento musical. Pero las
1190 líneas divisorias normalmente se insertan automáticamente. ¿Cómo
1191 hacemos para que no se impriman?
1193 Antes de enredarnos con esto, recordemos que las propiedades de
1194 los objetos se agrupan en lo que hemos llamado @emph{interfaces}
1195 (véase @ref{Propiedades de los interfaces}). Esto es simplemente
1196 agrupar las propiedades que se pueden usar juntas para trucar un
1197 objeto gráfico: si una de ellas se necesita para un objeto,
1198 también las otras. Así, ciertos objetos usan las propiedades de
1199 algunos interfaces, otros usan las de otros interfaces. Los
1200 interfaces que contienen las propiedades que un determinado grob
1201 necesita se encuentran relacionadas en el manual RFI al final de
1202 la página que describe dicho grob, y esas propiedades se pueden
1203 ver mirando dichos interfaces.
1205 Hemos explicado cómo encontrar información sobre los grobs en
1206 @ref{Propiedades de los objetos de presentación}. Usando el mismo
1207 enfoque, vamos al RFI para buscar el objeto de presentación que
1208 imprime las líneas divisorias. A través del enlace @emph{Backend}
1209 y @emph{All layout objects} encontramos que hay un objeto de
1210 presentación llamado @code{BarLine}. Entre sus propiedades se
1211 encuentran dos que controlan la visibilidad:
1212 @code{break-visibility} y @code{stencil}. Las líneas divisorias
1213 también contemplan un número de interfaces, entre ellos el
1214 @code{grob-interface}, donde podemos encontrar las propiedades
1215 @code{transparent} y @code{color}. Todas ellas pueden afectar la
1216 visibilidad de las barras de compás (y, por supuesto, por
1217 extensión, también la de muchos otros objetos de presentación).
1218 Vamos a considerar cada uno de ellos por orden.
1221 * La propiedad stencil (sello)::
1222 * La propiedad break-visibility (visibilidad en el salto)::
1223 * La propiedad transparent (transparente)::
1224 * La propiedad color::
1227 @node La propiedad stencil (sello)
1228 @unnumberedsubsubsec La propiedad @code{stencil} (sello)
1229 @translationof The stencil property
1231 @cindex stencil (sello), propiedad
1233 Esta propiedad controla la apariencia de las barras de compás
1234 mediante la especificación del símbolo (o «glifo») que se debe
1235 imprimir. Igual que como otras muchas propiedades, se puede
1236 establecer de forma que no imprima nada ajustando su valor a
1237 @code{#f}. Vamos a probarlo, como antes, omitiendo el Contexto
1238 implícito, @code{Voice}:
1240 @cindex BarLine, ejemplo de sobreescritura
1241 @cindex stencil, propiedad, ejemplo
1243 @lilypond[quote,ragged-right,verbatim]
1246 \override BarLine.stencil = ##f
1247 c''4 b8 c d16 c d8 |
1248 g,8 a16 b8 c d4 e16 |
1253 Las barras de compás todavía se imprimen. ¿Qué es lo que está
1254 mal? Vuelva al RFI y mire de nuevo la página que ofrece las
1255 propiedades del objeto BarLine. Al principio de la página dice
1256 @qq{Barline objects are created by: Bar_engraver} (los objetos
1257 Barline se crean por el grabador Bar_engraver). Vaya a la página
1258 del grabador @code{Bar_engraver} siguiendo el enlace. Al final da
1259 una lista de contextos en los que el grabador de líneas divisorias
1260 opera. Todos ellos son del tipo @code{Staff}, y así la razón de
1261 que la instrucción @code{\override} no funcionara como
1262 esperábamos, es porque @code{Barline} no se encuentra en el
1263 contexto predeterminado @code{Voice}. Si el contexto no se
1264 especifica correctamente, la instrucción simplemente no funciona.
1265 No se produce ningún mensaje de error, y no se registra nada en el
1266 archivo log de registro. Vamos a intentar corregirlo escribiendo
1267 el contexto correcto:
1269 @cindex BarLine, ejemplo de sobreescritura
1270 @cindex stencil, propiedad, ejemplo
1272 @lilypond[quote,ragged-right,verbatim]
1275 \override Staff.BarLine.stencil = ##f
1276 c''4 b8 c d16 c d8 |
1277 g,8 a16 b8 c d4 e16 |
1282 Ahora las barras de compás han desaparecido. La operación de
1283 fijar la propiedad @code{stencil} al valor @code{#f} es tan
1284 frecuente que existe una abreviatura para ella, llamada
1285 @code{\omit} (omitir):
1288 @lilypond[quote,ragged-right,verbatim]
1292 c''4 b8 c d16 c d8 |
1293 g,8 a16 b8 c d4 e16 |
1298 Sin embargo, observe que el establecimiento de la propiedad
1299 @code{stencil} al valor @code{#f} produce errores cuando las se
1300 requieren las dimensiones del objeto para un procesamiento
1301 correcto. Por ejemplo, se generan errores si la propiedad
1302 @code{stencil} del objeto @code{NoteHead} se establece al valor
1303 @code{#f}. Si es el caso, podemos en vez de ello utilizar la
1304 función @code{point-stencil}, que establece el sello a un objeto
1307 @lilypond[quote,verbatim]
1310 \once \override NoteHead.stencil = #point-stencil
1315 @node La propiedad break-visibility (visibilidad en el salto)
1316 @unnumberedsubsubsec The @code{break-visibility} (visibilidad en el salto)
1317 @translationof The break-visibility property
1319 @cindex break-visibility, propiedad
1321 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI
1322 que la propiedad @code{break-visibility} requiere un vector de
1323 tres valores booleanos. Controlan respectivamente si las barras
1324 de compás se imprimen al final de una línea, en mitad de una
1325 línea, y al principio de las líneas. Para nuestro ejemplo,
1326 queremos que todas las barras de compás se supriman, por lo que el
1327 valor que necesitamos es @code{#(#f #f #f)} (disponible también
1328 bajo el nombre @code{all-invisible}, todas invisibles). Vamos a
1329 probarlo, recordando incluir el contexto de @code{Staff}. Observe
1330 también que al escribir este valor tenemos @code{##} antes del
1331 paréntesis de apertura. Se necesita un @code{#} como parte de la
1332 sintaxis de las contantes vectoriales, y el primer símbolo de
1333 almohadilla@tie{}@code{#} se necesita, como siempre, para preceder
1334 el valor en sí dentro de la instrucción @code{\override}.
1336 @cindex BarLine, ejemplo de sobreescritura
1337 @cindex break-visibility, propiedad, ejemplo
1339 @lilypond[quote,ragged-right,verbatim]
1342 \override Staff.BarLine.break-visibility = ##(#f #f #f)
1343 c''4 b8 c d16 c d8 |
1344 g,8 a16 b8 c d4 e16 |
1349 Y podemos ver que esto también quita todas las líneas divisorias.
1351 @node La propiedad transparent (transparente)
1352 @unnumberedsubsubsec La propiedad @code{transparent} (transparente)
1353 @translationof The transparent property
1355 @cindex transparent, propiedad
1356 @cindex transparencia
1358 En la relación de propiedades que se especifican en la página del
1359 @code{grob-interface} del RFI podemos ver que la propiedad
1360 @code{transparent} es un valor booleano. Esto se debe establecer
1361 a @code{#t} para hacer que el grob sea transparente. En el
1362 ejemplo siguiente vamos a hacer que la indicación de compás, y no
1363 las líneas divisorias, sea transparente. Para hacerlo tenemos que
1364 buscar el nombre del grob de la indicación de compás. Volviendo a
1365 la página @q{All layout objects} del RFI, buscamos las propiedades
1366 del objeto de presentación @code{TimeSignature}. Se produce por
1367 parte del grabador @code{Time_signature_engraver} que como puede
1368 comprobar vive dentro del contexto de @code{Staff} y también
1369 contempla el interface @code{grob-interface}. Así pues, la
1370 instrucción que hace transparente a la indicación de compás es:
1372 @cindex TimeSignature, ejemplo de sobreescritura
1373 @cindex transparent, propiedad, ejemplo
1375 @lilypond[quote,ragged-right,verbatim]
1378 \override Staff.TimeSignature.transparent = ##t
1379 c''4 b8 c d16 c d8 |
1380 g,8 a16 b8 c d4 e16 |
1386 Una vez más, el establecimiento de la propiedad @code{transparent}
1387 es una operación bastante frecuente, de modo que tenemos una
1388 abreviatura llamada @code{\hide} (ocultar):
1391 @lilypond[quote,ragged-right,verbatim]
1394 \hide Staff.TimeSignature
1395 c''4 b8 c d16 c d8 |
1396 g,8 a16 b8 c d4 e16 |
1402 En ninguno de los dos casos aparece ya la indicación de compás,
1403 pero esta instrucción deja una separación en el lugar donde antes
1404 estaba la indicación de compás. Quizá esto es lo que queremos
1405 para un ejercicio en que el alumno deba escribirlo, pero en otras
1406 circunstancias esta separación podría no ser deseable. En vez de
1407 eso, para quitarla, el stencil o «sello» de la indicación de
1408 compás se debe establecer al valor @code{#f}:
1410 @cindex TimeSignature, ejemplo de sobreescritura
1411 @cindex stencil, propiedad, ejemplo
1413 @lilypond[quote,ragged-right,verbatim]
1416 \omit Staff.TimeSignature
1417 c''4 b8 c d16 c d8 |
1418 g,8 a16 b8 c d4 e16 |
1424 y la diferencia es obvia: al establecer el sello al valor
1425 @code{#f} (posiblemente por medio de @code{\omit}) quitamos el
1426 objeto por completo; al hacer el objeto @code{transparent} (lo que
1427 puede hacerse utilizando @code{\hide}) lo dejamos donde está, pero
1428 lo hacemos invisible.
1430 @node La propiedad color
1431 @unnumberedsubsubsec La propiedad @code{color}
1432 @translationof The color property
1434 @cindex color, propiedad
1436 Para finalizar, intentemos hacer invisibles las barras de compás
1437 pintándolas de color blanco (hay un problema relacionado, que
1438 consiste en que la línea divisoria blanca puede tapar o no tapar
1439 las líneas del pentagrama a las que cruza. Podrá observar en
1440 algunos de los ejemplos que aparecen a continuación, que esto
1441 sucede de forma impredecible. Los detalles sobre por qué esto
1442 ocurre así, y cómo controlarlo, se estudian en @ruser{Pintar los
1443 objetos de blanco}; de momento estamos estudiando el color, por lo
1444 que le rogamos que acepte esta limitación por ahora).
1446 El interface @code{grob-interface} especifica que la propiedad del
1447 color es una lista, pero no hay ninguna explicación sobre lo que
1448 debe ir en esa lista. La lista que requiere es realmente una
1449 lista de valores en unidades internas, pero para evitar tener que
1450 saber cuáles son, se ofrecen varias vías para la especificación de
1451 los colores. La primera forma es utilizar uno de los colores
1452 @q{normales} que están relacionados en la primera tabla de la
1453 @ruser{Lista de colores}. Para poner las líneas divisorias de
1454 color blanco, escribimos:
1456 @cindex BarLine, ejemplo de sobreescritura
1457 @cindex color, propiedad, ejemplo
1459 @lilypond[quote,ragged-right,verbatim]
1462 \override Staff.BarLine.color = #white
1463 c''4 b8 c d16 c d8 |
1464 g,8 a16 b8 c d4 e16 |
1470 y de nuevo podemos comprobar que las barras de compás no son
1471 visibles. Observe que @emph{white} no viene precedido de un
1472 apóstrofo: no es un símbolo, sino una @emph{variable}. Cuando se
1473 evalúa, proporciona la lista de valores internos que se requieren
1474 para establecer el color a blanco. Los otros colores de la lista
1475 normal también son variables. Para convencerse de que esto
1476 funciona, quizá quiera cambiar el color a una de las otras
1477 variables de la lista.
1479 @cindex colores de X11
1480 @cindex X11, colores de
1484 La segunda forma de cambiar el color es utilizar la lista de
1485 nombres de colores de X11 que aparecen en la segunda lista de
1486 @ruser{Lista de colores}. De todas formas, se hacen corresponder
1487 a los valores reales por medio de la función @code{x11-color} que
1488 convierte los símbolos de color de X11 en la lista de valores
1489 internos como éstos:
1491 @cindex BarLine, ejemplo de sobreescritura
1492 @cindex color, propiedad, ejemplo
1494 @lilypond[quote,ragged-right,verbatim]
1497 \override Staff.BarLine.color = #(x11-color 'white)
1498 c''4 b8 c d16 c d8 |
1499 g,8 a16 b8 c d4 e16 |
1505 Observe que en este caso la función @code{x11-color} toma un
1506 símbolo como argumento, así que el símbolo debe ir precedido de un
1507 apóstrofo para evitar que resulte evaluado como si fuera una
1508 variable, y toda la llamada a la función se debe encerrar entre
1511 @cindex rgb, colores
1516 Aún existe otra función, que convierte valores RGB en colores
1517 internos: la función @code{rgb-color}. Toma tres argumentos que
1518 dan las intensidades de rojo, verde y azul. Cada uno de ellos
1519 puede tomar valores entre 0 y 1. Por lo tanto, para establecer el
1520 color a rojo el valor debe ser @code{(rgb-color 1 0 0)} y para
1521 blanco debe ser @code{(rgb-color 1 1 1)}:
1523 @cindex BarLine, ejemplo de sobreescritura
1524 @cindex color, propiedad, ejemplo
1526 @lilypond[quote,ragged-right,verbatim]
1529 \override Staff.BarLine.color = #(rgb-color 1 1 1)
1530 c''4 b8 c d16 c d8 |
1531 g,8 a16 b8 c d4 e16 |
1536 Finalmente, existe también una escala de grises como parte del
1537 conjunto de colores de X11. Varían desde el negro, @code{'grey0},
1538 hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar
1539 esto estableciendo todos los objetos de presentación de nuestro
1540 ejemplo a varias gradaciones de gris:
1542 @cindex StaffSymbol, ejemplo de sobreescritura
1543 @cindex TimeSignature, ejemplo de sobreescritura
1544 @cindex Clef, ejemplo de sobreescritura
1545 @cindex NoteHead, ejemplo de sobreescritura
1546 @cindex Stem, ejemplo de sobreescritura
1547 @cindex BarLine, ejemplo de sobreescritura
1548 @cindex color property, ejemplo
1549 @cindex x11-color, ejemplo de utilización
1551 @lilypond[quote,ragged-right,verbatim]
1554 \override Staff.StaffSymbol.color = #(x11-color 'grey30)
1555 \override Staff.TimeSignature.color = #(x11-color 'grey60)
1556 \override Staff.Clef.color = #(x11-color 'grey60)
1557 \override Voice.NoteHead.color = #(x11-color 'grey85)
1558 \override Voice.Stem.color = #(x11-color 'grey85)
1559 \override Staff.BarLine.color = #(x11-color 'grey10)
1560 c''4 b8 c d16 c d8 |
1561 g,8 a16 b8 c d4 e16 |
1567 Observe los contextos asociados con cada uno de los objetos de
1568 presentación. Es importante que estén correctamente escritos, o
1569 las instrucciones ¡no funcionarán! Recuerde que el contexto es
1570 aquel en que se encuentra el grabador correspondiente. El
1571 contesto predeterminado para los grabadores puede encontrarse
1572 empezando por el objeto de presentación, de ahí al grabador que lo
1573 produce, y en la página del grabador del RFI aparece en qué
1574 contexto se puede encontrar normalmente el grabador.
1577 @node Tamaño de los objetos
1578 @subsection Tamaño de los objetos
1579 @translationof Size of objects
1581 @cindex cambiar el tamaño de los objetos
1582 @cindex tamaño de los objetos
1583 @cindex objetos, tamaño de
1584 @cindex objetos, cambiar el tamaño de
1586 Empezaremos examinando de nuevo un ejemplo anterior (véase
1587 @ref{Anidado de expresiones musicales}) que nos mostraba cómo
1588 introducir un pentagrama temporal, como en un @rglos{ossia}.
1590 @cindex alignAboveContext, propiedad, ejemplo
1591 @cindex @code{\with}, ejemplo
1593 @lilypond[quote,ragged-right,verbatim]
1594 \new Staff ="main" {
1601 alignAboveContext = #"main" }
1609 Los fragmentos de Ossia se escriben normalmente sin clave ni
1610 compás, y por lo normal se imprimen más pequeños que el pentagrama
1611 principal. Ya sabemos cómo quitar la clave y el compás:
1612 simplemente establecemos el sello de cada uno de ellos a
1613 @code{#f}, como sigue:
1615 @cindex alignAboveContext, propiedad, ejemplo
1616 @cindex @code{\with}, ejemplo
1618 @cindex Clef, ejemplo de sobreescritura
1619 @cindex TimeSignature, ejemplo de sobreescritura
1621 @lilypond[quote,ragged-right,verbatim]
1622 \new Staff ="main" {
1629 alignAboveContext = #"main"
1633 \omit Staff.TimeSignature
1643 donde el par de llaves adicional después de la cláusula
1644 @code{\with} es necesario para asegurar que la sobreescritura
1645 encerrada y la música se aplican al pentagrama de ossia.
1647 Pero ¿cuál es la diferencia entre modificar el contexto de
1648 pentagrama usando @code{\with} y modificar los sellos de clave y
1649 de compás con \override, o en este caso @code{\omit}? La
1650 diferencia principal es que los cambios que se realizan en una
1651 cláusula @code{\with} se hacen en el momento en que se crea el
1652 contexto, y permanecen activos como valores
1653 @strong{predeterminados} durante toda la duración de dicho
1654 contexto, mientras que las instrucciones @code{\set} o
1655 @code{\override} incluidas dentro de la música son dinámicas:
1656 hacen cambios sincronizados con un punto concreto de la música.
1657 Si los cambios se deshacen o se devuelven mediante @code{\unset} o
1658 @code{\revert} volverán a su valor predeterminado que será el
1659 establecido en la cláusula @code{\with}, o si no se ha establecido
1660 ninguno en este lugar, los valores predeterminados normales.
1662 Ciertas propiedades de contexto se pueden modificar solamente
1663 dentro de cláusulas @code{\with}. Son aquellas propiedades que no
1664 se pueden cambiar después de que el contexto se ha creado.
1665 @code{alignAboveContext} y su compañero, @code{alignBelowContext},
1666 son dos de tales propiedades: una vez que el pentagrama se ha
1667 creado, su alineación está decidida y no tendría sentido intentar
1668 cambiarla más tarde.
1670 Los valores predeterminados de las propiedades de los objetos de
1671 presentación también se pueden establecer dentro de cláusulas
1672 @code{\with}. Simplemente utilice la instrucción @code{\override}
1673 normal dejando aparte el nombre del contexto, ya que está definido
1674 sin ambigüedad como el contexto que la cláusula @code{\with} está
1675 modificando. De hecho, se producirá un error si se especifica un
1676 contexto en este lugar.
1678 Así pues, podemos reemplazar el ejemplo anterior con
1680 @cindex alignAboveContext, propiedad, ejemplo
1681 @cindex @code{\with}, example
1682 @cindex Clef, ejemplo de sobreescritura
1683 @cindex TimeSignature, ejemplo de sobreescritura
1685 @lilypond[quote,ragged-right,verbatim]
1686 \new Staff ="main" {
1693 alignAboveContext = #"main"
1694 % Don't print clefs in this staff
1695 \override Clef.stencil = ##f
1696 % Don't print time signatures in this staff
1697 \override TimeSignature.stencil = ##f
1706 Resulta que también podemos emplear aquí las abreviaturas
1707 @code{\hide} y @code{\omit} para fijar la propiedad
1708 @code{transparent} y borrar el @code{stencil}, lo que conduce al
1709 resultado siguiente:
1711 @lilypond[quote,ragged-right,verbatim]
1712 \new Staff ="main" {
1719 alignAboveContext = #"main"
1720 % Don't print clefs in this staff
1722 % Don't print time signatures in this staff
1732 Finalmente llegamos a la forma de cambiar el tamaño de los objetos
1735 Ciertos objetos de presentación se crean como glifos sacados de
1736 una fuente tipográfica. Entre ellos se encuentran las cabezas,
1737 alteraciones, elementos de marcado, claves, indicaciones de
1738 compás, indicaciones dinámicas y la letra de las canciones. Su
1739 tamaño se cambia mediante la modificación de la propiedad
1740 @code{font-size}, como veremos en breve. Otros objetos de
1741 presentación como ligaduras de unión y de expresión (en general,
1742 objetos de extensión) se trazan individualmente, por lo que no hay
1743 un tamaño de tipografía @code{font-size} asociado a ellos. Estos
1744 objetos generalmente derivan su tamaño de los objetos a los que
1745 están adosados, y por ello normalmente no hay necesidad de
1746 cambiarles el tamaño manualmente. Aún otras propiedades como la
1747 longitud de las plicas y las barras de compás, el grosor de las
1748 barras de corchea y otras líneas, y la separación de las líneas
1749 del pentagrama se deben modificar de otras formas especiales.
1751 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1752 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1753 cambiar el tamaño de las tipografías de cada uno de los tipos de
1754 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1757 \override NoteHead.font-size = #-2
1760 o podemos cambiar el tamaño de todas las tipografías estableciendo
1761 una propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1762 mediante su inclusión dentro de una cláusula @code{\with} (pero
1763 sin el @code{\set}).
1769 Los dos enunciados producirían una reducción del tamaño de la
1770 tipografía en dos pasos a partir de su valor previo, donde cada
1771 paso reduce o aumenta el tamaño aproximadamente en un 12%.
1773 Vamos a probarlo en nuestro ejemplo del ossia:
1775 @cindex alignAboveContext, propiedad, ejemplo
1776 @cindex @code{\with}, ejemplo
1777 @cindex Clef, ejemplo de sobreescritura
1778 @cindex TimeSignature, ejemplo de sobreescritura
1779 @cindex fontSize, propiedad, ejemplo
1781 @lilypond[quote,ragged-right,verbatim]
1782 \new Staff ="main" {
1789 alignAboveContext = #"main"
1792 % Reduce all font sizes by ~24%
1802 Aún no está demasiado bien. Las cabezas y los corchetes de las
1803 notas son más pequeños, pero las plicas son demasiado largas en
1804 proporción, y las líneas del pentagrama están demasiado separadas
1805 entre sí. Se debe reducir su escala en proporción a la reducción
1806 de la tipografía. El siguiente apartado trata sobre cómo se hace
1809 @node Longitud y grosor de los objetos
1810 @subsection Longitud y grosor de los objetos
1811 @translationof Length and thickness of objects
1817 @cindex tamaño, cambiar
1818 @cindex plica, cambiar la longitud
1819 @cindex pentagrama, cambiar la separación de las líneas
1821 Las distancias y longitudes en LilyPond se miden generalmente en
1822 espacios de pentagrama, la distancia entre líneas adyacentes de la
1823 pauta (o de manera ocasional medios espacios), mientras que la
1824 mayoría de las propiedades de @code{thickness} (grosor) se miden
1825 en unidades de una propiedad interna llamada
1826 @code{line-thickness.} Por ejemplo, de forma predeterminada, a
1827 las líneas de los reguladores se les da un grosor de 1 unidad de
1828 @code{line-thickness}, mientras que el @code{thickness} de una
1829 plica es 1.3. Observe sin embargo que ciertas propiedades de
1830 grosor son diferentes; por ejemplo, el grosor de las barras de
1831 corchea se controla por medio del valor de @code{beam-thickness},
1832 que se mide en espacios de pentagrama.
1834 Entonces ¿cómo se tienen que escalar las longitudes en proporción
1835 al tamaño de la tipografía? Se puede hacer con la ayuda de una
1836 función especial que se llama @code{magstep}, pensada
1837 especialmente para este propósito. Toma un argumento, el cambio
1838 de tamaño de la tipografía (#-2 en nuestro ejemplo) y devuelve un
1839 factor de escalado adecuado para reducir otros objetos en la misma
1840 proporción. Se usa de la siguiente forma:
1842 @cindex alignAboveContext, propiedad, ejemplo
1843 @cindex @code{\with}, ejemplo
1844 @cindex Clef, ejemplo de sobreescritura
1845 @cindex TimeSignature, ejemplo de sobreescritura
1846 @cindex fontSize, propiedad, ejemplo
1847 @cindex StaffSymbol, ejemplo de sobreescritura
1848 @cindex magstep, función, ejemplo de utilización
1849 @cindex staff-space, propiedad, ejemplo
1850 @cindex stencil, propiedad, ejemplo
1852 @lilypond[quote,ragged-right,verbatim]
1853 \new Staff ="main" {
1860 alignAboveContext = #"main"
1864 % Reduce stem length and line spacing to match
1865 \override StaffSymbol.staff-space = #(magstep -2)
1875 Puesto que la longitud de las plicas y muchas otras propiedades
1876 relacionadas con la longitudes calculan siempre con relación al
1877 valor de la propiedad @code{staff-space}, su longitud también ve
1878 reducida su escala automáticamente. Observe que esto afecta
1879 solamente a la escala vertical del ossia: la escala horizontal se
1880 determina por medio de la disposición de la música principal con
1881 el objeto de mantenerse en sincronía con ella, de forma que no
1882 resulte afectada por ninguno de estos cambios de tamaño. Por
1883 supuesto, si la escala de toda la música principal se cambiase de
1884 esta forma, entonces el espaciado horizontal se vería afectado.
1885 Trataremos de esto más tarde en la sección sobre la disposición.
1887 Esto, en fin, completa la creación de un ossia. Los tamaños y
1888 longitudes del resto de los objetos se pueden modificar de manera
1891 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1892 grosor de las diversas líneas dibujadas como divisorias, barras de
1893 corchea, reguladores, ligaduras, etc, no requieren normalmente
1894 ningún ajuste global. Si el grosor de cualquier objeto de
1895 presentación en particular necesita ajustarse, se puede hacer
1896 mejor mediante la sobreescritura de su propiedad @code{thickness}.
1897 Anteriormente mostramos un ejemplo de cambio de grosor en las
1898 ligaduras, en @ref{Propiedades de los objetos de presentación}.
1899 El grosor de todos los objetos trazados (es decir, aquellos que no
1900 se producen a partir de una tipografía) se pueden cambiar de la
1904 @node Colocación de los objetos
1905 @section Colocación de los objetos
1906 @translationof Placement of objects
1909 * Comportamiento automático::
1910 * Objetos interiores al pentagrama::
1911 * Objetos fuera del pentagrama::
1915 @node Comportamiento automático
1916 @subsection Comportamiento automático
1917 @translationof Automatic behavior
1919 @cindex dentro del pentagrama, objetos
1920 @cindex fuera del pentagrama, objetos
1921 @cindex objetos dentro del pentagrama
1922 @cindex objetos fuera del pentagrama
1924 Hay ciertos objetos en notación musical que pertenecen al
1925 pentagrama y otros cuyo lugar se sitúa fuera del pentagrama.
1926 Reciben el nombre de objetos dentro-del-pentagrama y objetos
1927 fuera-del-pentagrama, respectivamente.
1929 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1930 pauta: cabezas, plicas, alteraciones, etc. Sus posiciones
1931 normalmente se fijan por la propia música; se posicionan
1932 verticalmente sobre líneas específicas del pentagrama o están
1933 unidos a otros objetos posicionados de esta forma. Las colisiones
1934 entre cabezas, plicas y alteraciones en acordes de notas muy
1935 juntas, normalmente se evitan automáticamente. Hay instrucciones
1936 y sobreescrituras que pueden modificar este comportamiento
1937 automático, como veremos en breve.
1939 Entre los objetos que pertenecen al exterior de la pauta se
1940 encuentran cosas como las marcas de ensayo, las marcas de texto y
1941 las de dinámica. La regla de LilyPond para la colocación vertical
1942 de los objetos fuera-de-pentagrama es colocarlos tan cerca del
1943 pentagrama como sea posible, pero no tan cerca como para que
1944 puedan chocar con algún otro objeto. LilyPond utiliza la
1945 propiedad @code{outside-staff-priority} para determinar el orden
1946 en que se deben situar los objetos, como veremos ahora.
1948 En primer lugar, LilyPond sitúa todos los objetos
1949 dentro-del-pentagrama. Después ordena los objetos
1950 fuera-del-pentagrama de acuerdo con su prioridad
1951 @code{outside-staff-priority}. Los objetos fuera-del-pentagrama
1952 se toman de uno en uno, comenzando por el que tiene la prioridad
1953 @code{outside-staff-priority} más baja, y se sitúan de forma que
1954 no colisionen con ningún objeto que se haya colocado ya. Esto es,
1955 si dos grobs fuera-del-pentagrama compiten por el mismo espacio,
1956 el que tiene la prioridad @code{outside-staff-priority} más baja
1957 se colocará más cerca del pentagrama. Si dos objetos tienen la
1958 misma @code{outside-staff-priority}, el que se ha encontrado
1959 primero se situará más cerca de la pauta.
1961 En el siguiente ejemplo, todos los textos de marcado tienen la
1962 misma prioridad (pues no se ha establecido explícitamente).
1963 Observe que @q{Text3} se posiciona de nuevo automáticamente cerca
1964 del pentagrama, acomodado por debajo de @q{Text2}.
1966 @cindex markup, ejemplo
1968 @lilypond[quote,fragment,ragged-right,verbatim]
1975 Los pentagramas también se posicionan, de forma predeterminada,
1976 tan cerca unos de otros como sea posible (sujeto a una separación
1977 mínima). Si las notas se proyectan muy lejos en dirección a un
1978 pentagrama adyacente, forzarán a alejarse a los pentagramas sólo
1979 si en caso contrario fuese a ocurrir un solapamiento de la
1980 notación. El ejemplo siguiente muestra esta acomodación
1981 @q{nestling} de las notas sobre pentagramas adyacentes:
1983 @lilypond[quote,ragged-right,verbatim]
1986 \relative { c'4 a, }
1989 \relative { c''''4 a, }
1995 @node Objetos interiores al pentagrama
1996 @subsection Objetos interiores al pentagrama
1997 @translationof Within-staff objects
1999 Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a
2000 la dirección de las ligaduras de expresión y de unión,
2001 digitaciones y todo lo demás que dependa de la dirección de las
2002 plicas (véase @ref{Voces explícitas}). Cuando se escribe música
2003 polifónica, estas instrucciones son esenciales para que puedan
2004 distinguirse varias líneas melódicas entrelazadas. Pero
2005 ocasionalmente puede ser necesario sobreescribir este
2006 comportamiento automático. Se puede hacer por secciones de música
2007 completas o incluso para una nota individual. La propiedad que
2008 controla este comportamiento es la propiedad de @code{direction}
2009 (dirección) de cada objeto de presentación. En primer lugar
2010 explicaremos qué hace esto, y luego introduciremos algunas
2011 instrucciones listas para usar que le evitarán tener que codificar
2012 sobreescrituras explícitas para las modificaciones más comunes.
2014 Algunos objetos de presentación como las ligaduras se curvan hacia
2015 arriba o hacia abajo; otros como las plicas y los corchetes
2016 también se mueven a la derecha o a la izquierda cuando apuntan
2017 hacia arriba o hacia abajo. Esto se controla automáticamente
2018 cuando está establecida la propiedad @code{direction}.
2021 * La propiedad direction (dirección)::
2025 @node La propiedad direction (dirección)
2026 @unnumberedsubsubsec La propiedad @code{direction} (dirección)
2027 @translationof The direction property
2038 El ejemplo siguiente muestra en el primer compás la colocación
2039 predeterminada de las ligaduras de expresión, estando por encima
2040 las que comienzan en notas agudas y por debajo las que comienzan
2041 en notas graves, seguido de un compás con ambas ligaduras forzadas
2042 hacia abajo, otro compás con las dos forzadas hacia arriba y por
2043 último un compás con las ligaduras devueltas a su comportamiento
2046 @cindex Slur, ejemplo de sobreescritura
2047 @cindex direction, propiedad, ejemplo
2049 @lilypond[quote,fragment,verbatim]
2051 \override Slur.direction = #DOWN
2053 \override Slur.direction = #UP
2055 \revert Slur.direction
2059 Aquí hemos usado las constantes @code{DOWN} (abajo) y @code{UP}
2060 (arriba). Éstos tienen los valores @w{@code{-1}} y @code{+1}
2061 respectivamente, y dichos valores numéricos también se pueden usar
2062 directamente. El valor @code{0} también se puede usar en algunos
2063 casos. Se trata simplemente con el significado de @code{UP} para
2064 las ligaduras de expresión, pero para algunos objetos tiene el
2065 significado de @q{centrado}. Existe una constante @code{CENTER}
2066 que tiene el valor @code{0}.
2068 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
2069 están disponibles instrucciones predefinidas equivalentes más
2070 sencillas. Aquí podemos ver una tabla de las más comunes. Se
2071 menciona el significado de cada una allí donde no es obvio.
2073 @multitable @columnfractions .2 .2 .25 .35
2074 @headitem Abajo o Izquierda
2075 @tab Arriba o Derecha
2078 @item @code{\arpeggioArrowDown}
2079 @tab @code{\arpeggioArrowUp}
2080 @tab @code{\arpeggioNormal}
2081 @tab La flecha está abajo, arriba o no hay flecha
2082 @item @code{\dotsDown}
2084 @tab @code{\dotsNeutral}
2085 @tab Dirección del desplazamiento para evitar las líneas del pentagrama
2086 @item @code{\dynamicDown}
2087 @tab @code{\dynamicUp}
2088 @tab @code{\dynamicNeutral}
2090 @item @code{\phrasingSlurDown}
2091 @tab @code{\phrasingSlurUp}
2092 @tab @code{\phrasingSlurNeutral}
2093 @tab Nota: diferente de las instrucciones de ligaduras de expresión
2094 @item @code{\slurDown}
2096 @tab @code{\slurNeutral}
2098 @item @code{\stemDown}
2100 @tab @code{\stemNeutral}
2102 @item @code{\textSpannerDown}
2103 @tab @code{\textSpannerUp}
2104 @tab @code{\textSpannerNeutral}
2105 @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
2106 @item @code{\tieDown}
2108 @tab @code{\tieNeutral}
2110 @item @code{\tupletDown}
2111 @tab @code{\tupletUp}
2112 @tab @code{\tupletNeutral}
2113 @tab Los grupos especiales están debajo o encima de las notas
2116 Las variantes neutras o normales de estas instrucciones están
2117 implementadas usando @code{\revert} y éstas @strong{no} pueden ir
2118 precedidas de @code{\once}. Si quiere limitar el efecto de las
2119 otras instrucciones (que están implementadas usando
2120 @code{\override}) a un solo paso de tiempo, puede precederla de
2121 @code{\once} de la misma forma en que lo haría con las
2122 sobreescrituras explícitas.
2124 O bien, si un único objeto de presentación necesita forzarse hacia
2125 arriba o hacia abajo, pueden usarse los indicadores de dirección,
2126 @code{^} o @code{_}:
2128 @lilypond[quote,fragment,verbatim]
2130 a'4^( g') c''_( a') |
2134 @unnumberedsubsubsec Digitaciones
2135 @translationof Fingering
2137 @cindex digitación, colocación
2138 @cindex digitación de acordes
2140 La colocación de las digitaciones sobre notas sueltas también se
2141 puede controlar mediante la propiedad @code{direction}, pero los
2142 cambios sobre @code{direction} no tienen ningún efecto sobre las
2143 notas de los acordes. Como veremos, existen instrucciones
2144 especiales que permiten controlar las digitaciones de notas
2145 individuales, situando la digitación encima, debajo, a la
2146 izquierda o a la derecha de cada nota.
2148 En primer lugar, he aquí el efecto de @code{direction} sobre las
2149 digitaciones aplicadas a notas sueltas. Se muestra en el primer
2150 compás el comportamiento predeterminado, y en los dos compases
2151 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
2153 @cindex Fingering, ejemplo de sobreescritura
2154 @cindex direction, propiedad, ejemplo
2156 @lilypond[quote,verbatim]
2158 c''4-5 a-3 f-1 c'-5 |
2159 \override Fingering.direction = #DOWN
2161 \override Fingering.direction = #UP
2166 Sin embargo, la sobreescritura de la propiedad @code{direction} no
2167 es la forma más sencilla de especificar manualmente la digitación
2168 por encima o por debajo de las notas; suele ser preferible usar
2169 @code{_} o @code{^} en lugar de @code{-}, antes del número de la
2170 digitación. Este es el ejemplo anterior utilizando este método:
2172 @cindex fingering, ejemplo
2173 @cindex digitación, ejemplo
2175 @lilypond[quote,verbatim]
2177 c''4-5 a-3 f-1 c'-5 |
2183 La propiedad @code{direction} se ignora para los acordes, pero los
2184 prefijos direccionales @code{_} y @code{^} sí funcionan. De forma
2185 predeterminada, las digitaciones se colocan automáticamente encima
2186 y debajo de las notas de un acorde, como se muestra aquí:
2188 @cindex fingering, ejemplo
2189 @cindex digitación, ejemplo
2191 @lilypond[quote,verbatim]
2200 pero se puede forzar de manera que todos o algunos de los números
2201 de digitación estén por encima o por debajo:
2203 @cindex fingering, ejemplo
2204 @cindex digitación, ejemplo
2206 @lilypond[quote,verbatim]
2208 <c''-5 g-3 e-2 c-1>4
2214 Es posible ejercer un control aún mayor sobre la colocación de las
2215 digitaciones mediante la utilización de la instrucción @code{\set
2216 fingeringOrientations}. El formato de esta instrucción es:
2219 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
2223 se utiliza @code{\set} porque @code{fingeringOrientations} es una
2224 propiedad del contexto @code{Voice}, creado y usado por el
2225 grabador @code{New_fingering_engraver}.
2227 La propiedad se puede establecer al valor de una lista de entre
2228 uno y tres valores. Controla si las digitaciones se pueden
2229 colocar por encima (si @code{up} aparece en la lista), por debajo
2230 (si aparece @code{down}), a la izquierda (si aparece @code{left})
2231 o a la derecha (si aparece @code{right}). A la inversa, si una
2232 colocación no está en la lista, no se sitúa ninguna digitación en
2233 dicho lugar. LilyPond coma estas restricciones y se trabaja la
2234 mejor colocación para la digitación de las notas de los acordes
2235 que siguen. Observe que @code{left} y @code{right} son mutuamente
2236 excluyentes: las digitaciones pueden situarse en un lado o en el
2237 otro, no en los dos.
2239 @warning{Para controlar la colocación de la digitación de una sola
2240 nota usando esta instrucción es necesario escribirla como un
2241 acorde de una sola nota encerrándola entre ángulos simples.}
2243 Aquí podemos ver algunos ejemplos:
2245 @cindex fingering, ejemplo
2246 @cindex digitación, ejemplo
2247 @cindex @code{\set}, ejemplo de utilización
2248 @cindex fingeringOrientations, propiedad, ejemplo
2250 @lilypond[quote,ragged-right,verbatim]
2252 \set fingeringOrientations = #'(left)
2255 \set fingeringOrientations = #'(left)
2257 <c-1 e-2 g-3 b-5>4 |
2258 \set fingeringOrientations = #'(up left down)
2261 \set fingeringOrientations = #'(up left)
2263 <c-1 e-2 g-3 b-5>4 |
2264 \set fingeringOrientations = #'(right)
2271 Si la digitación parece un poco superpoblada, se puede reducir el
2272 tamaño @code{font-size}. El valor predeterminado puede verse en
2273 el objeto @code{Fingering} del RFI que es @w{@code{-5}}, así que
2274 probaremos @w{@code{-7}}:
2276 @lilypond[quote,ragged-right,verbatim]
2278 \override Fingering.font-size = #-7
2279 \set fingeringOrientations = #'(left)
2282 \set fingeringOrientations = #'(left)
2284 <c-1 e-2 g-3 b-5>4 |
2285 \set fingeringOrientations = #'(up left down)
2288 \set fingeringOrientations = #'(up left)
2290 <c-1 e-2 g-3 b-5>4 |
2291 \set fingeringOrientations = #'(right)
2298 @node Objetos fuera del pentagrama
2299 @subsection Objetos fuera del pentagrama
2300 @translationof Outside-staff objects
2302 Los objetos fuera-del-pentagrama se sitúan automáticamente para
2303 evitar las colisiones. Existen varias formas de sobreescribir la
2304 colocación automática si el posicionado no resulta óptimo.
2307 * La propiedad outside-staff-priority (prioridad fuera del pentagrama)::
2308 * La instrucción textLengthOn::
2309 * Posicionamiento de los matices dinámicos::
2310 * Escalado de un «Grob»::
2314 @node La propiedad outside-staff-priority (prioridad fuera del pentagrama)
2315 @unnumberedsubsubsec La propiedad @code{outside-staff-priority} (prioridad fuera del pentagrama)
2316 @translationof The outside-staff-priority property
2318 Los objetos fuera-del-pentagrama se colocan automáticamente para
2319 evitar las colisiones. Los objetos que tienen el valor más bajo
2320 de la propiedad @code{outside-staff-priority} se sitúan más cerca
2321 del pentagrama, y entonces otros objetos fuera-del-pentagrama se
2322 elevan tanto como sea necesario para evitar la colisión. La
2323 prioridad @code{outside-staff-priority} se defina en el
2324 @code{grob-interface} y así es una propiedad de todos los objetos
2325 de presentación. De forma predeterminada se establece a @code{#f}
2326 para todos los objetos dentro-del-pentagrama, y a un valor
2327 numérico adecuado a cada objeto fuera-del-pentagrama cuando se
2328 crea el objeto. La tabla siguiente presenta los valores numéricos
2329 predeterminados para algunos de los objetos fuera-del-pentagrama
2332 @cindex objetos de extensión
2334 Observe los nombres algo inusuales de algunos de los objetos: los
2335 objetos de extensión se crean automáticamente para controlar el
2336 posicionamiento vertical de los grobs que (quizá) comienzan y
2337 terminan en distintos momentos musicales, de manera que cualquier
2338 modificación a la prioridad @code{outside-staff-priority} del grob
2339 subyacente no tiene ningún efecto. Por ejemplo, cambiar la
2340 @code{outside-staff-priority} del objeto de regulador
2341 @code{Hairpin} no tiene efecto sobre la posición vertical de los
2342 reguladores: en lugar de eso, tenemos que cambiar la
2343 @code{outside-staff-priority} del objeto asociado
2344 @code{DynamicLineSpanner}. Esta sobreescritura se debe escribir
2345 al comienzo del objeto de extensión, que podría incluir varios
2346 reguladores o matices dinámicos encadenados.
2348 @multitable @columnfractions .3 .3 .3
2349 @headitem Objeto de presentación
2351 @tab Controla la posición de:
2352 @item @code{RehearsalMark}
2354 @tab Letras de ensayo
2355 @item @code{MetronomeMark}
2357 @tab Indicaciones metronómicas
2358 @item @code{VoltaBracketSpanner}
2360 @tab Cajetines de primera y segunda vez
2361 @item @code{TextScript}
2363 @tab Texto en elementos de marcado
2364 @item @code{MultiMeasureRestText}
2366 @tab Texto sobre silencios de compás completo
2367 @item @code{OttavaBracket}
2369 @tab Corchetes de octava alta y baja
2370 @item @code{TextSpanner}
2372 @tab Objetos de extensión de texto
2373 @item @code{DynamicLineSpanner}
2375 @tab Todas las indicaciones dinámicas
2376 @item @code{VoltaBracketSpanner}
2378 @tab Números de compás
2379 @item @code{TrillSpanner}
2381 @tab Trinos mantenidos
2384 He aquí un ejemplo que muestra la situación predeterminada de
2387 @cindex texto, extensiones de
2388 @cindex octava alta y baja, corchete de
2390 @funindex \startTextSpan
2391 @funindex startTextSpan
2392 @funindex \stopTextSpan
2393 @funindex stopTextSpan
2395 @cindex TextSpanner, ejemplo de sobreescritura
2396 @cindex bound-details, propiedad, ejemplo
2398 @lilypond[quote,fragment,ragged-right,verbatim]
2399 % Set details for later Text Spanner
2400 \override TextSpanner.bound-details.left.text
2401 = \markup { \small \bold Slower }
2402 % Place dynamics above staff
2404 % Start Ottava Bracket
2407 % Add Dynamic Text and hairpin
2413 % Add Dynamic Text and terminate hairpin
2414 c''4\ff c'' \stopTextSpan |
2415 % Stop Ottava Bracket
2420 Este ejemplo también muestra cómo crear textos con extensión (Text
2421 Spanners): textos con líneas extensoras por encima de una sección
2422 de música. El extensor abarca desde la instrucción
2423 @code{\startTextSpan} hasta la instrucción @code{\stopTextSpan}, y
2424 el formado del texto se define por medio de la instrucción
2425 @code{\override TextSpanner}. Para ver más detalles, consulte
2426 @ruser{Extensiones de texto}.
2428 También muestra la manera de crear corchetes de octava alta y
2431 @cindex trucar la situación de los números de compás
2432 @cindex números de compás, ajustar posición
2433 @cindex trucar la situación de marcas metronómicas
2434 @cindex metrónomo, situación de las indicaciones de
2435 @cindex trucar la situación de las letras de ensayo
2436 @cindex ensayo, letras, trucar la colocación
2438 Si los valores predeterminados de @code{outside-staff-priority} no
2439 le ofrecen las colocaciones deseadas se puede sobreescribir la
2440 prioridad de cualquiera de los objetos. Suponga que quisiéramos
2441 que el corchete de octava estuviera situado por debajo del
2442 elemento extensor de texto en el ejemplo de arriba. Todo lo que
2443 debemos hacer es localizar la prioridad de @code{OttavaBracket} en
2444 el RFI o en las tablas anteriores, y reducirlo a un valor inferior
2445 al de @code{TextSpanner}, recordando que @code{OttavaBracket} se
2446 crea dentro del contexto de @code{Staff}:
2448 @cindex TextSpanner, ejemplo de sobreescritura
2449 @cindex bound-details, propiedad, ejemplo
2451 @lilypond[quote,fragment,ragged-right,verbatim]
2452 % Set details for later Text Spanner
2453 \override TextSpanner.bound-details.left.text
2454 = \markup { \small \bold Slower }
2455 % Place dynamics above staff
2457 % Place following Ottava Bracket below Text Spanners
2458 \once \override Staff.OttavaBracket.outside-staff-priority = #340
2459 % Start Ottava Bracket
2464 % Add Dynamic Line Spanner
2470 c''4\ff c'' \stopTextSpan |
2471 % Stop Ottava Bracket
2476 Observe que algunos de estos objetos, concretamente los números de
2477 compás, las indicaciones metronómicas y las letras de ensayo, se
2478 alojan de forma predeterminada dentro del contexto @code{Score};
2479 así pues, debe asegurarse de que utiliza el contexto adecuado
2480 cuando se sobreescriben sus propiedades.
2482 @cindex ligaduras y outside-staff-priority
2483 @cindex ligaduras y articulaciones
2484 @cindex articulaciones y ligaduras
2486 De forma predeterminada, las ligaduras de expresión están
2487 clasificadas como objetos dentro-del-pentagrama, pero con
2488 frecuencia aparecen encima del pentagrama si las notas que une son
2489 muy agudas. Ello puede empujar a una posición muy elevada a los
2490 objetos fuera-del-pentagrama como las articulaciones, pues la
2491 ligadura se colocará en primer lugar. La propiedad
2492 @code{avoid-slur} de la articulación se puede establecer al valor
2493 @code{'inside} (por dentro) para llevarla al interior de la
2494 ligadura, pero la propiedad @code{avoid-slur} es efectiva
2495 solamente si la prioridad @code{outside-staff-priority} está
2496 también ajustada al valor @code{#f}. De forma alternativa, la
2497 prioridad @code{outside-staff-priority} de la ligadura se puede
2498 fijar en un valor numérico para hacer que se sitúe en línea con
2499 otros objetos fuera del pentagrama de acuerdo con este valor. He
2500 aquí un ejemplo que muestra el efecto de los dos métodos:
2502 @lilypond[quote,verbatim]
2504 c4( c^\markup { \tiny \sharp } d4.) c8 |
2506 \once \override TextScript.avoid-slur = #'inside
2507 \once \override TextScript.outside-staff-priority = ##f
2508 c4^\markup { \tiny \sharp } d4.) c8 |
2509 \once \override Slur.outside-staff-priority = #500
2510 c4( c^\markup { \tiny \sharp } d4.) c8 |
2514 Los cambios en @code{outside-staff-priority} también se pueden
2515 emplear para controlar la situación vertical de los objetos
2516 individuales, aunque los resultados pueden no siempre ser
2517 deseables. Suponga que quiere que @qq{Text3} se sitúe por encima
2518 de @qq{Text4} en el ejemplo bajo el epígrafe Comportamiento
2519 Automático de más arriba (véase @ref{Comportamiento automático}).
2520 Todo lo que debemos hacer es localizar la prioridad de
2521 @code{TextScript} en el RFI o en las tablas de arriba, y aumentar
2522 la prioridad de @qq{Text3} hasta un valor superior:
2524 @cindex TextScript, ejemplo de sobreescritura
2525 @cindex outside-staff-priority, propiedad, ejemplo
2527 @lilypond[quote,fragment,ragged-right,verbatim]
2530 \once \override TextScript.outside-staff-priority = #500
2535 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4}
2536 pero también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora
2537 se desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo
2538 que realmente queremos hacer es posicionar todas las anotaciones a
2539 la misma distancia por encima del pentagrama? Para hacerlo, vamos
2540 a necesitar claramente espaciar las notas en sentido horizontal
2541 para hacer sitio para el texto. Esto se hace empleando la
2542 instrucción @code{textLengthOn}.
2544 @node La instrucción textLengthOn
2545 @unnumberedsubsubsec La instrucción @code{@bs{}textLengthOn}
2546 @translationof The textLengthOn command
2548 @cindex notas, espaciar junto al texto
2550 @funindex \textLengthOn
2551 @funindex textLengthOn
2552 @funindex \textLengthOff
2553 @funindex textLengthOff
2555 De forma predeterminada, el texto producido mediante marcado no
2556 ocupa ningún espacio horizontal en cuanto se refiere a la
2557 disposición de la música. La instrucción @code{\textLengthOn}
2558 invierte este comportamiento, ocasionando que las notas resulten
2559 tan espaciadas como sea necesario para acomodar el texto:
2561 @lilypond[quote,fragment,ragged-right,verbatim]
2562 \textLengthOn % Cause notes to space out to accommodate text
2569 La instrucción para volver al comportamiento predeterminado es
2570 @code{\textLengthOff}. De forma alternativa, se puede usar
2571 @code{\once} con @code{\textLengthOn} si el efecto se ha de
2572 limitar a un solo momento musical. El comportamiento de espaciado
2573 correspondiente para las llamadas de ensayo y las indicaciones de
2574 tempo se controla independientemente con las instrucciones
2575 @code{\markLengthOn} y @code{\markLengthOff}.
2577 @cindex marcado, texto de, permitir las colisiones en
2579 El texto de marcado también evita las notas que se proyectan por
2580 encima del pentagrama. Si esto no es lo que deseamos, el
2581 desplazamiento automático hacia arriba se puede desactivar
2582 mediante el establecimiento de la prioridad a @code{#f}. He aquí
2583 un ejemplo que muestra cómo el texto de marcado interactúa con
2586 @cindex TextScript, ejemplo de sobreescritura
2587 @cindex outside-staff-priority, propiedad, ejemplo
2589 @lilypond[quote,ragged-right,verbatim]
2591 % This markup is short enough to fit without collision
2595 % This is too long to fit, so it is displaced upwards
2599 % Turn off collision avoidance
2600 \once \override TextScript.outside-staff-priority = ##f
2601 c,,2^"Long Text " c'' |
2604 % Turn off collision avoidance
2605 \once \override TextScript.outside-staff-priority = ##f
2606 \textLengthOn % and turn on textLengthOn
2607 c,,2^"Long Text " % Spaces at end are honored
2612 @node Posicionamiento de los matices dinámicos
2613 @unnumberedsubsubsec Posicionamiento de los matices dinámicos
2614 @translationof Dynamics placement
2616 @cindex trucar la colocación de los matices
2617 @cindex dinámica, trucar la colocación de las indicaciones de
2618 @cindex matices, trucar la colocación
2620 Las indicaciones de matiz dinámico normalmente se colocarán por
2621 debajo del pentagrama, pero se pueden posicionar por encima con la
2622 instrucción @code{\dynamicUp}. Se situarán verticalmente respecto
2623 a la nota a la que van adosadas, y flotarán por debajo (o por
2624 encima) de todos los objetos dentro-del-pentagrama tales como
2625 ligaduras de fraseo y números de compás. Esto puede ofrecer
2626 resultados bastante aceptables, como muestra este ejemplo:
2628 @lilypond[quote,ragged-right,verbatim]
2634 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2635 ees,2.~\)\mf ees4 r8 |
2639 Sin embargo, si las notas y sus indicaciones dinámicas adosadas
2640 están muy cerca, la colocación automática evitará las colisiones
2641 desplazando las marcas dinámicas posteriores más lejos, aunque
2642 este puede no ser el lugar óptimo, como muestra el siguiente
2643 ejemplo más bien artificial:
2645 @lilypond[quote,ragged-right,verbatim,fragment]
2647 \relative { a'4\f b\mf a\mp b\p }
2651 Si se presentara una situación similar en música @q{real}, podría
2652 ser preferible espaciar las notas un poco más entre sí, de forma
2653 que todas las marcas dinámicas puedan caber a la misma distancia
2654 vertical desde el pentagrama. Hemos sido capaces de hacer esto
2655 para el texto de marcado utilizando la instrucción
2656 @code{\textLengthOn}, pero no existe una instrucción equivalente
2657 para las indicaciones de matiz dinámico. Por tanto, tendremos que
2658 averiguar cómo hacerlo utilizando instrucciones @code{\override}.
2660 @node Escalado de un «Grob»
2661 @unnumberedsubsubsec Escalado de un «Grob»
2662 @translationof Grob sizing
2664 @cindex grob, cambio de tamaño de un
2665 @cindex escala de los grobs
2667 En primer lugar debemos aprender cómo se especifica el tamaño de
2668 los grobs. Todos los grobs tienen un punto de referencia definido
2669 dentro de ellos que se usa para colocarlos respecto a su objeto
2670 padre. Entonces, este punto del grob se posiciona a una distancia
2671 horizontal, @code{X-offset}, y una distancia vertical,
2672 @code{Y-offset}, a partir de su padre. La dimensión horizontal
2673 del objeto viene dada por una pareja de números, @code{X-extent},
2674 que dice dónde están los límites izquierdo y derecho respecto del
2675 punto de referencia. La amplitud vertical se define de forma
2676 similar mediante una pareja de números, @code{Y-extent}. Éstas
2677 son propiedades de todos los grobs que contemplan el
2678 @code{grob-interface}.
2680 @cindex @code{extra-spacing-width}
2682 De forma predeterminada, los objetos fuera-del-pentagrama reciben
2683 una anchura cero, de manera que pueden solaparse en la dirección
2684 horizontal. Esto se hace mediante el truco de hacer que la
2685 dimensión más a la izquierda sea igual a infinito y que la
2686 dimensión más a la derecha sea igual a menos infinito,
2687 estableciendo el valor de @code{extra-spacing-width} a
2688 @code{'(+inf.0 . -inf.0)}. Así, para asegurar que no se
2689 superponen en la dirección horizontal tendremos que sobreescribir
2690 este valor de @code{extra-spacing-width} para darles un poco de
2691 espacio adicional. Las unidades son el espacio entre dos líneas
2692 del pentagrama, de forma que debería bastar mover el límite
2693 izquierdo media unidad a la izquierda y el límite derecho media
2694 unidad a la derecha:
2697 \override DynamicText.extra-spacing-width = #'(-0.5 . 0.5)
2701 Veamos si funciona en nuestro ejemplo anterior:
2703 @cindex DynamicText, ejemplo de sobreescritura
2704 @cindex extra-spacing-width, propiedad, ejemplo
2706 @lilypond[quote,ragged-right,verbatim,fragment]
2708 % Extend width by 1 staff space
2709 \override DynamicText.extra-spacing-width = #'(-0.5 . 0.5)
2710 \relative { a'4\f b\mf a\mp b\p }
2714 Esto tiene un mejor aspecto, pero quizá habríamos preferido que
2715 las indicaciones de dinámica estuvieran alineadas sobre la misma
2716 línea de base en lugar de ir hacia arriba y hacia abajo con las
2717 notas. La propiedad que lo hace es @code{staff-padding} (relleno
2718 de pentagrama) que se estudia en la sección dedicada a las
2719 colisiones (véase @ref{Colisiones de objetos}).
2721 @node Espaciado vertical
2722 @section Espaciado vertical
2723 @translationof Vertical spacing
2725 Por lo general, el espaciado vertical de los objetos musicales que
2726 LilyPond hace es bastante bueno. Veamos cómo se comporta con una
2727 canción sencilla, con dos voces y acompañamiento de piano:
2729 @lilypond[quote,fragment,ragged-right]
2734 \new Voice = "music" {
2740 Here are some lyrics
2743 \clef bass e'2 f e c
2758 No hay ningún problema con el espaciado vertical predeterminado.
2759 Sin embargo, supongamos que estamos trabajando con un editor que
2760 tiene ciertos requisitos específicos para el espaciado vertical de
2761 los pentagramas y la letra: quiere que la letra está más separada
2762 de las notas, que el acompañamiento de piano esté más separado de
2763 la línea vocal y que los dos pentagramas de piano estén más juntos
2764 entre sí. Comenzaremos con la letra.
2766 La letra se encuentra en el interior de un sistem, y por tanto las
2767 instrucciones para aplicarle el espaciado estarán en
2768 @ruser{Espaciado vertical flexible dentro de los sistemas}. Allí
2769 se dice que el texo son líneas del tipo @qq{no-pauta} y por tanto
2770 la instrucción para cambiar su espaciado hará referencia a la
2771 propiedad @code{nonstaff}. Para separarlas del pentagrama al que
2772 pertenecen (la pauta superior) usaremos la propiedad
2773 @code{relatedstaff}. Para separarlas de la línea inferior
2774 usaremos la propiedad @code{unrelatedstaff}. Las partes vocales
2775 pertenecen a un grupo vertical @code{VerticalAxisGroup}, por lo
2776 que tenemos que ajustar sus propiedades. Probémoslo y veamos si
2779 @lilypond[quote,fragment,ragged-right,verbatim]
2784 \new Voice = "music" {
2789 \override VerticalAxisGroup.
2790 nonstaff-relatedstaff-spacing.padding = #5
2791 \override VerticalAxisGroup.
2792 nonstaff-unrelatedstaff-spacing.padding = #5
2795 Here are some lyrics
2798 \clef bass e'2 f e c
2813 Bien: sí, funciona, pero quizá demasiado bien. Cuando
2814 establecemos el @code{padding} (relleno) a 5, LilyPond añade 5
2815 espacios de pentagrama a la distancia entre los objetos, lo que es
2816 excesivo para nosotros en este caso. Usaremos un valor de 2.
2818 A continuación, desplazaremos la música de piano para separarla de
2819 las partes vocales. La música vocal es una @code{ChoirStaff} (un
2820 contexto de sistema coral), y por tanto tenemos que aumentar el
2821 espaciado entre ese grupo de pentagramas y el sistema de piano que
2822 se encuentra debajo. Lo haremos cambiando la
2823 @code{basic-distance} (distancia básica) del @code{StaffGrouper}
2824 del @code{staffgroup-staff-spacing}.
2826 @lilypond[quote,fragment,ragged-right,verbatim]
2828 \new ChoirStaff \with {
2829 \override StaffGrouper.
2830 staffgroup-staff-spacing.basic-distance = #15
2834 \new Voice = "music" {
2839 \override VerticalAxisGroup.
2840 nonstaff-relatedstaff-spacing.padding = #2
2841 \override VerticalAxisGroup.
2842 nonstaff-unrelatedstaff-spacing.padding = #2
2845 Here are some lyrics
2848 \clef bass e'2 f e c
2863 Muy bien. Ahora, sólo nos queda el último requisito de hacer que
2864 los pentagramas de piano estén más juntos. Para conseguirlo, de
2865 nuevo alteramos las propiedades del @code{StaffGrouper}, pero esta
2866 vez vamos a reducir tanto la @code{basic-distance} (distancia
2867 básica) como el @code{padding} (relleno). Podemos hacerlo como se
2868 muestra a continuación.
2870 @lilypond[quote,fragment,ragged-right,verbatim]
2872 \new ChoirStaff \with {
2873 \override StaffGrouper.
2874 staffgroup-staff-spacing.basic-distance = #15
2878 \new Voice = "music" {
2883 \override VerticalAxisGroup.
2884 nonstaff-relatedstaff-spacing.padding = #2
2885 \override VerticalAxisGroup.
2886 nonstaff-unrelatedstaff-spacing.padding = #2
2889 Here are some lyrics
2892 \clef bass e'2 f e c
2895 \new PianoStaff \with {
2896 \override StaffGrouper.staff-staff-spacing = #'(
2897 (basic-distance . 0)
2911 Con esto los hemos colocado muy juntos entre sí (pero es lo que el
2912 editor quería). Se podrían haber separado más alterando el
2913 relleno, @code{padding}, o la distancia básica,
2914 @code{basic-distance}, si quisiéramos.
2916 Hay muchas formas de alterar el espaciado vertical. Un punto
2917 clave que debemos recordar es que el espaciado entre objetos
2918 dentro de un @code{StaffGroup} (como los grupos @code{GrandStaff}
2919 o @code{PianoStaff}) se controla con las variables de espaciado
2920 del @code{StaffGrouper}. El espaciado de los pentagramas no
2921 agrupados (como @code{Lyrics} y @code{Staff}) se controla con las
2922 variables del @code{VerticalAxisGroup}. Para ver más detalles,
2924 @ruser{Variables de espaciado de paper verticales flexibles} y
2925 @ruser{Espaciado vertical flexible dentro de los sistemas}.
2928 @node Colisiones de objetos
2929 @section Colisiones de objetos
2930 @translationof Collisions of objects
2934 * Arreglar notación con superposiciones::
2935 * Ejemplos reales de música::
2939 @subsection Mover objetos
2940 @translationof Moving objects
2942 @cindex mover objetos superpuestos
2943 @cindex mover objetos que colisionan
2944 @cindex mover grobs que colisionan
2945 @cindex objetos que colisionan, mover
2946 @cindex grobs que colisionan, mover
2948 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos
2949 elementos de notación se pueden superponer, lo que es una lástima,
2950 pero en realidad es bastante poco frecuente. Normalmente la
2951 necesidad de mover objetos es por claridad o razones estéticas: el
2952 aspecto es mejor con un poco más o un poco menos de espacio de
2955 Existen tres enfoques principales que llevan a la resolución de
2956 superposiciones en la notación. Se deben considerar en el
2961 La @strong{dirección} de uno de los objetos que se superponen se
2962 puede cambiar usando las instrucciones predefinidas que están
2963 relacionadas arriba para los objetos dentro-del-pentagrama (véase
2964 @ref{Objetos interiores al pentagrama}). Se pueden recolocar
2965 fácilmente las plicas, ligaduras de expresión y de unión, barras
2966 de corchea, indicaciones dinámicas, texto y grupos de valoración
2967 especial de esta forma. La limitación es que sólo tiene la
2968 posibilidad de elegir entre dos posiciones, y podría ser que
2969 ninguna de ellas sea la adecuada.
2972 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2973 colocando los objetos de presentación, se pueden modificar usando
2974 la instrucción de sobreescritura @code{\override}. Las ventadas
2975 de hacer cambios a este tipo de propiedad son: a) que algún otro
2976 objeto se moverá automáticamente si es necesario, para dejarle
2977 sitio, y b) una única sobreescritura se puede aplicar a todas las
2978 instancias del mismo tipo de objeto. Entre tales propiedades se
2984 @code{direction} (dirección)
2986 Ya se ha estudiado con cierto detalle: véase @ref{Objetos interiores al pentagrama}.
2989 @code{padding} (relleno),
2990 @code{right-padding} (relleno por la derecha),
2991 @code{staff-padding} (relleno de pentagrama)
2994 @cindex padding, propiedad
2995 @cindex right-padding, propiedad
2996 @cindex staff-padding, propiedad
2998 Según un objeto se está colocando, el valor de su propiedad de
2999 relleno @code{padding} especifica el espacio intermedio que se
3000 debe dejar entre él mismo y el límite más próximo del objeto
3001 contra el que se está colocando. Observe que es el valor de
3002 @code{padding} del objeto @strong{que se está colocando} el que se
3003 usa; el valor de @code{padding} del objeto que ya está colocado se
3004 ignora. Los espacios intermedios especificados mediante
3005 @code{padding} se pueden aplicar a todos los objetos que
3006 contemplan el interface @code{side-position-interface}.
3008 En lugar de con @code{padding}, la colocación de los grupos de
3009 alteraciones se controla con @code{right-padding}. Esta propiedad
3010 se encuentra en el objeto @code{AccidentalPlacement} que, observe,
3011 vive dentro del contexto de @strong{Staff}. Durante el proceso
3012 tipográfico, las cabezas de las notas se componen tipográficamente
3013 en primer lugar, y después las alteraciones, si existen, se añaden
3014 a la izquierda de las cabezas utilizando la propiedad de relleno
3015 por la derecha @code{right-padding} para determinar la separación
3016 entre la alteración y la cabeza, y de las alteraciones entre sí.
3017 Así pues, sólo la propiedad de relleno por la derecha
3018 @code{right-padding} del objeto @code{AccidentalPlacement} tiene
3019 efecto sobre la colocación de las alteraciones.
3021 La propiedad @code{staff-padding} está estrechamente relacionada
3022 con la propiedad @code{padding}: @code{padding} controla la
3023 separación mínima entre cualquier objeto que contemple el
3024 interface @code{side-position-interface} y el objeto más cercano
3025 (generalmente la nota o las líneas del pentagrama);
3026 @code{staff-padding} se aplica sólo a los objetos que siempre se
3027 sitúan fuera del pentagrama: controla la separación mínima entre
3028 dicho objeto y el pentagrama. Observe que @code{staff-padding} no
3029 tiene ningún efecto sobre objetos que se posicionan respecto a la
3030 nota en vez de hacerlo respecto al pentagrama, incluso aunque
3031 puede ser sobreescrito sin error por tales objetos: simplemente se
3034 Para descubrir qué propiedad de relleno se necesita para el objeto
3035 que quiere recolocar, debe volver al manual de RFI y buscar las
3036 propiedades del objeto. Tenga cuidado porque las propiedades de
3037 relleno podrían no estar en el objeto más obvio, así que busque en
3038 los objetos que puedan tener alguna relación con él.
3040 Todos los valores de relleno se miden en espacios del pentagrama.
3041 Para la mayor parte de los objetos el valor se establece de forma
3042 predeterminada en aproximadamente 1.0 o menos (varía con cada
3043 objeto). Se puede sobreescribir si se necesita una separación
3044 intermedia mayor (o menor).
3047 @code{self-alignment-X} (Auto-alineamiento en el eje X)
3049 @cindex self-alignment-X, propiedad
3051 Esta propiedad se puede usar para alinear el objeto a la
3052 izquierda, a la derecha, o centrarlo con respecto al punto de
3053 referencia del objeto «padre». Se puede usar con todos los
3054 objetos que contemplan el interface
3055 @code{self-alignment-interface}. En general son objetos que
3056 contienen texto. Los valores son @code{LEFT}, @code{RIGHT} o
3057 @code{CENTER}. De forma alternativa se puede especificar un valor
3058 numérico entre @w{@code{-1}} y @code{+1}, donde @w{@code{-1}} es
3059 alineado por la izquierda, @code{+1} es alineado por la derecha, y
3060 los números intermedios mueven el texto progresivamente desde
3061 alineado por la izquierda hasta alineado por la derecha. Se
3062 pueden especificar valores numéricos mayores de @code{1} para
3063 mover el texto incluso más lejos hacia la izquierda, o menos de
3064 @w{@code{-1}} para alejarlo más hacia la derecha. Un cambio en
3065 @code{1} en el valor corresponde a un movimiento de la mitad de la
3066 longitud total del propio texto.
3069 @code{extra-spacing-width} (anchura de separación adicional)
3071 @cindex extra-spacing-width, propiedad
3073 Esta propiedad está disponible para todos los objetos que
3074 contemplan el interface @code{item-interface}. Toma dos números,
3075 el primero se suma al límite izquierdo y el segundo se suma al
3076 límite derecho. Los números negativos desplazan el límite a la
3077 izquierda y los positivos a la derecha, por lo que para ensanchar
3078 un objeto el primer número debe ser negativo y el segundo
3079 positivo. Observe que no todos los objetos ostentan los dos
3080 números. Por ejemplo, el objeto @code{Accidental} (alteración)
3081 sólo toma nota del primer número (el borde izquierdo).
3084 @code{staff-position} (posición de pentagrama)
3086 @cindex staff-position, propiedad
3088 @code{staff-position} es una propiedad del interface
3089 @code{staff-symbol-referencer-interface}, que está contemplado por
3090 los objetos que se colocan con relación al pentagrama. Especifica
3091 la posición vertical del objeto con relación a la tercera línea
3092 del pentagrama en medios espacios de pentagrama. Es útil en la
3093 resolución de colisiones entre objetos de presentación como
3094 silencios multi-compás, ligaduras de unión y notas en distintas
3098 @code{horizontal-shift}
3100 @cindex horizontal-shift, propiedad
3101 @cindex nota, columna de
3102 @cindex nota, colisiones
3103 @cindex colisiones de notas
3104 @cindex desplazamiento, instrucciones de
3111 @funindex \shiftOnnn
3114 Dentro de una voz, todas las notas que se producen en el mismo
3115 moemtno se agrupan en una columna de notas, y se crea un objeto
3116 @code{NoteColumn} para controlar el posicionamiento horizonal de
3117 dicho grupo de notas (véase @qq{Columnas de nota} en @ref{Voces
3118 explícitas}). Si @emph{y sólo si} dos o más columnas de nota
3119 dentro de un solo contexto de pauta, las dos con las plicas en la
3120 misma dirección, aparecen en el mismo momento musical, los valores
3121 de sus propiedades @code{horizontal-shift} se usan para asignarles
3122 una puntuación y las columnas con puntuaciones más altas se
3123 desplazan progresivamente para evitar las colisiones entre las
3124 cabezas de las notas. Esta propiedad se establece con las
3125 instrucciones @code{\voiceXXX} y se pueden sobreescribir
3126 directamente con una instrucción @code{\override} o, de forma más
3127 común con las instrucciones @code{\shiftOn}. Observe que esta
3128 propiedad se usa para @emph{calificar} las columnas de nota o para
3129 aplicar desplazamientos: no especifica la magnitud del
3130 desplazamiento, que se va incrementando progresivamente en pasos
3131 basándolse en la anchura de las cabezas de nota para cada
3132 puntuación. Los pasos son normalmente de la mitad de la anchura
3133 de una cabeza de nota, pero puede ser el ancho completo de la
3134 cabeza de una nota cuando está implicado un grupo de notas muy
3138 @code{force-hshift} (forzar desplazamiento horizontal)
3140 @cindex force-hshift, propiedad
3142 La propiedad @code{force-hshift} es una propiedad de una
3143 @code{NoteColumn} (realmente lo es del interface
3144 @code{note-column-interface}). Modificarlo permite mover una
3145 columna de notas en situaciones donde las columnas de notas se
3146 superponen. Observe que no tiene efecto sobre las columnas de
3147 nota que no se superponen. Se especifica en unidades adecuadas a
3148 una columna de notas, por ejemplo la anchura de la cabeza de la
3149 nota de la primera voz. Se debe usar en situaciones complejas
3150 donde las instrucciones @code{\shiftOn} normales (véase @ref{Voces
3151 explícitas}) no resuelven el conflicto entre las notas de forma
3152 satisfactoria. Es preferible a la propiedad @code{extra-offset}
3153 para este propósito porque no hay necesidad de averiguar la
3154 distancia en espacios de pentagrama, y mover las notas dentro o
3155 fuera de una @code{NoteColumn} afecta a otras acciones como a la
3156 fusión entre cabezas de nota.
3161 Finalmente, cuando todo lo demás falla, los objetos se pueden
3162 reposicionar manualmente con relación a la tercera línea del
3163 pentagrama verticalmente, o desplazándolas una cierta distancia a
3164 una nueva posición. Las desventajas son que los valores correctos
3165 para el reposicionamiento se deben adivinar, a menudo por ensayo y
3166 error, para cada objeto individual y, puesto que el movimiento se
3167 hace después de que LilyPond ha colocado todos los demás objetos
3168 es usuario es responsable de evitar cualquier colisión que pudiera
3169 producirse. Pero la dificultar principal con este enfoque es que
3170 los valores de reposicionado podrían tener que ser vueltos a
3171 calcular si la música se modifica más tarde. Las propiedades que
3172 se pueden usar para este tipo de posicionamiento manual son:
3175 @item extra-offset (desplazamiento adicional)
3177 @cindex extra-offset, propiedad
3179 Esta propiedad se aplica a cualquier objeto de presentación que
3180 contemple el @code{grob-interface}. Toma una pareja de números
3181 que especifican el desplazamiento adicional en las direcciones
3182 horizontal y vertical. Los números negativos mueven el objeto a
3183 la izquierda o hacia abajo. Las unidades son espacios de
3184 pentagrama. El desplazamiento adicional se hace después de que la
3185 composición tipográfica de los objetos ha terminado, así que un
3186 objeto puede ser reposicionado a cualquier lugar sin afectar a
3189 @item positions (posiciones)
3191 @cindex positions, propiedad
3193 Ésta es de la mayor utilidad para ajustar manualmente la
3194 inclinación y la altura de las barras de corchea, ligaduras de
3195 expresión y corchetes de grupos de valoración especial. Toma una
3196 pareja de números que dan la posición de los extremos izquierdo y
3197 derecho de la barra, ligadura, etc. con relación a la tercera
3198 línea del pentagrama. Las unidades son espacios de pentagrama.
3199 Observe, sin embargo, que las ligaduras de expresión y de fraseo
3200 no se pueden reposicionar en cantidades arbitrariamente grandes.
3201 LilyPond en primer lugar genera una lista de posiciones posibles
3202 para la ligadura y de forma predeterminada encuentra la ligadura
3203 que tiene @qq{mejor aspecto}. Si la propiedad @code{positions} se
3204 ha sobreescrito, la ligadura que está más cerca de las posiciones
3205 que se han solicitado, se selecciona de la lista.
3210 Un objeto en particular podría no tener todas estas propiedades.
3211 Es necesario ir al manual RFI para buscar qué propiedades se
3212 encuentran disponibles para el objeto en cuestión.
3215 Aquí presentamos una lista de los objetos que es más probable que
3216 estén implicados en colisiones, con el nombre del objeto que
3217 habría que buscar en el RFI para descubrir qué propiedades se
3218 deben usar para moverlos.
3220 @multitable @columnfractions .5 .5
3221 @headitem Tipo de objeto @tab Nombre del objeto
3222 @item Articulaciones @tab @code{Script}
3223 @item Barras @tab @code{Beam}
3224 @item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
3225 @item Dinámica (horizontalmente) @tab @code{DynamicText}
3226 @item Digitaciones @tab @code{Fingering}
3227 @item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
3228 @item Ligaduras de expresión @tab @code{Slur}
3229 @item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
3230 @item Ligaduras de unión @tab @code{Tie}
3231 @item Grupos de valoración especial @tab @code{TupletBracket}
3235 @node Arreglar notación con superposiciones
3236 @subsection Arreglar notación con superposiciones
3237 @translationof Fixing overlapping notation
3239 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos
3240 visto en la sección anterior, para resolver problemas de notación
3244 * La propiedad padding (relleno)::
3245 * La propiedad right-padding (relleno por la derecha)::
3246 * La propiedad staff-padding (relleno de pentagrama)::
3247 * La propiedad self-alignment-X (auto-alineación en X)::
3248 * La propiedad staff-position (posición en el pentagrama)::
3249 * La propiedad extra-offset (desplazamiento adicional)::
3250 * La propiedad positions (posiciones)::
3251 * La propiedad force-hshift (forzar desplazamiento horizontal)::
3254 @node La propiedad padding (relleno)
3255 @unnumberedsubsubsec La propiedad @code{padding} (relleno)
3256 @translationof The padding property
3259 @cindex arreglar notación que se superpone
3260 @cindex superpuesta, notación
3262 La propiedad @code{padding} se puede ajustar para aumentar (o
3263 disminuir) la distancia entre símbolos impresos encima o debajo de
3266 @cindex Script, ejemplo de sobreescritura
3267 @cindex padding, propiedad, ejemplo
3269 @lilypond[quote,fragment,verbatim]
3271 \override Script.padding = #3
3275 @cindex MetronomeMark, ejemplo de sobreescritura
3276 @cindex padding, propiedad, ejemplo
3278 @lilypond[quote,fragment,verbatim]
3279 % This will not work, see below
3280 \override MetronomeMark.padding = #3
3284 \override Score.MetronomeMark.padding = #3
3289 Observe en el segundo ejemplo la gran importancia que tiene saber
3290 qué contexto maneja un determinado objeto. Puesto que el objeto
3291 @code{MetronomeMark} se maneja dentro del contexto @code{Score},
3292 los cambios de propiedades en el contexto @code{Voice} pasarán
3294 Para ver más detalles, consulte @ruser{Modificar las propiedades}.
3296 Si la propiedad de relleno @code{padding} de un objeto se
3297 incrementa cuando dicho objeto se encuentra en una pila de objetos
3298 que se están colocando de acuerdo a su prioridad
3299 @code{outside-staff-priority}, entonces ese objeto se moverá, y
3300 también todos los que están por fuera de él.
3303 @node La propiedad right-padding (relleno por la derecha)
3304 @unnumberedsubsubsec La propiedad @code{right-padding} (relleno por la derecha)
3305 @translationof The right-padding property
3307 @cindex right-padding, propiedad
3309 La propiedad @code{right-padding} afecta al espaciado entre la
3310 alteración y la nota a que se aplica. Normalmente no es
3311 necesaria, pero el espaciado predeterminado puede estar mal para
3312 ciertos glifos de alteraciones o combinaciones de glifos que se
3313 usan en música microtonal. Éstos tienen que introducirse
3314 sobreescribiendo el sello de la alteración con un elemento de
3315 marcado que contenga los símbolos deseados, así:
3317 @cindex Accidental, ejemplo de sobreescritura
3318 @cindex text, propiedad, ejemplo
3319 @cindex stencil, propiedad, ejemplo
3320 @cindex AccidentalPlacement, ejemplo de sobreescritura
3321 @cindex right-padding, propiedad, ejemplo
3324 @lilypond[quote,ragged-right,verbatim]
3325 sesquisharp = \markup { \sesquisharp }
3328 % This prints a sesquisharp but the spacing is too small
3329 \once \override Accidental.stencil = #ly:text-interface::print
3330 \once \override Accidental.text = #sesquisharp
3332 % This improves the spacing
3333 \once \override Score.AccidentalPlacement.right-padding = #0.6
3334 \once \override Accidental.stencil = #ly:text-interface::print
3335 \once \override Accidental.text = #sesquisharp
3341 Esto utiliza necesariamente una sobreescritura para el sello de la
3342 alteración que no se estudiará hasta más adelante. El tipo de
3343 sello debe ser un procedimiento, aquí modificado para que imprima
3344 el contenido de la propiedad @code{text} del objeto
3345 @code{Accidental}, que a su vez está establecido como un signo de
3346 sesquisostenido. Entonces el signo se puede separar de la cabeza
3347 de la nota sobreescribiendo @code{right-padding}.
3351 @node La propiedad staff-padding (relleno de pentagrama)
3352 @unnumberedsubsubsec La propiedad @code{staff-padding} (relleno de pentagrama)
3353 @translationof The staff-padding property
3355 @cindex alineación de objetos sobre la línea base
3356 @cindex objetos, alineación sobre la línea base
3358 @code{staff-padding} se puede usar para alinear objetos como
3359 matices dinámicos a lo largo de una línea de base a una distancia
3360 fija del pentagrama, siempre que no exista ningún otro elemento de
3361 notación que fuerce una distancia mayor al pentagrama. No es una
3362 propiedad de @code{DynamicText} sino de @code{DynamicLineSpanner}.
3363 Esto es así porque la línea de base debe aplicarse por igual a
3364 @strong{todas} las dinámicas, entre ellas las que se han creado
3365 como objetos de extensión. Así que ésta es la forma de alinear
3366 las indicaciones de matiz en el ejemplo de la sección anterior:
3368 @cindex DynamicText, ejemplo de sobreescritura
3369 @cindex extra-spacing-width, propiedad, ejemplo
3370 @cindex DynamicLineSpanner, ejemplo de sobreescritura
3371 @cindex staff-padding, propiedad, ejemplo
3373 @lilypond[quote,fragment,ragged-right,verbatim]
3374 \override DynamicLineSpanner.staff-padding = #3
3375 \relative { a'4\f b\mf a\p b\mp }
3379 @node La propiedad self-alignment-X (auto-alineación en X)
3380 @unnumberedsubsubsec La propiedad @code{self-alignment-X} (auto-alineación en X)
3381 @translationof The self-alignment-X property
3383 El ejemplo siguiente muestra cómo ajustar la posición de un objeto
3384 de digitación de cuerda en relación a la plica de una nota
3385 mediante el alineamiento del límite derecho con el punto de
3386 referencia de la nota «padre»:
3388 @cindex StringNumber, ejemplo de sobreescritura
3389 @cindex self-alignment-X, propiedad, ejemplo
3391 @lilypond[quote,fragment,ragged-right,verbatim]
3394 \once \override StringNumber.self-alignment-X = #RIGHT
3398 @node La propiedad staff-position (posición en el pentagrama)
3399 @unnumberedsubsubsec La propiedad @code{staff-position} (posición en el pentagrama)
3400 @translationof The staff-position property
3402 @cindex objeto, colisión dentro del pentagrama
3404 Los silencios multi-compás en una voz pueden chocar con las notas
3405 en otra voz. Puesto que estos silencios se tipografían centrados
3406 entre las barras de compás se necesitaría bastante esfuerzo para
3407 que LilyPond averiguara qué otras notas podrían chocar con él, ya
3408 que actualmente todo el manejo de colisiones entre notas y
3409 silencios se hace solamente para notas y silencios que ocurren al
3410 mismo tiempo. He aquí un ejemplo de colisión de este tipo:
3412 @lilypond[quote,verbatim,ragged-right]
3413 << \relative { c'4 c c c } \\ { R1 } >>
3416 La mejor solución aquí es mover el silencio multi-compás hacia
3417 abajo, pues el silencio está en la voz dos. El ajuste
3418 predeterminado para @code{\voiceTwo} (es decir, en la segunda voz
3419 de una construcción @code{<<@{@dots{}@} \\ @{@dots{}@}>>}) es que
3420 @code{staff-position} tenga el valor -4 para MultiMeasureRest, así
3421 que tenemos que bajarlo, digamos, cuatro semi-espacios de
3422 pentagrama, al valor @w{@code{-8}}.
3424 @cindex MultiMeasureRest, ejemplo de sobreescritura
3425 @cindex staff-position, propiedad, ejemplo
3427 @lilypond[quote,verbatim,ragged-right]
3429 \relative { c'4 c c c }
3431 \override MultiMeasureRest.staff-position = #-8
3436 Esto es mejor que utilizar, por ejemplo, @code{extra-offset},
3437 porque la línea adicional por encima del silencio se inserta
3440 @node La propiedad extra-offset (desplazamiento adicional)
3441 @unnumberedsubsubsec La propiedad @code{extra-offset} (desplazamiento adicional)
3442 @translationof The extra-offset property
3444 @cindex posicionar objetos
3445 @cindex posicionar grobs
3446 @cindex objetos, posicionar
3447 @cindex grobs, posicionar
3449 La propiedad @code{extra-offset} da un completo control sobre el
3450 posicionamiento de un objeto tanto vertical como horizontalmente.
3452 En el ejemplo siguiente, la segunda digitación se desplaza
3453 ligeramente a la izquierda, y 1.8 espacios de pentagrama hacia
3456 @cindex fingering (digitación), ejemplo de sobreescritura
3457 @cindex extra-offset, propiedad, ejemplo
3459 @lilypond[quote,fragment,verbatim]
3461 \once \override Fingering.extra-offset = #'(-0.3 . -1.8)
3466 @node La propiedad positions (posiciones)
3467 @unnumberedsubsubsec La propiedad @code{positions} (posiciones)
3468 @translationof The positions property
3470 @cindex controlar manualmente grupos especiales, ligaduras y barras
3471 @cindex manual, control, de grupos especiales, ligaduras y barras
3472 @cindex grupos especiales, barras de, control manual
3473 @cindex ligaduras de expresión, control manual
3474 @cindex ligaduras de fraseo, control manual
3475 @cindex barras de corchea, control manual
3477 La propiedad @code{positions} permite controlar manualmente la
3478 posición vertical y de ahí también la inclinación de los
3479 tresillos, ligaduras de expresión y de fraseo, y barras de
3482 He aquí un ejemplo en el que las ligaduras de fraseo y de
3483 expresión chocan entre sí:
3485 @lilypond[quote,verbatim,ragged-right]
3486 \relative { a'8 \( ( a'16 ) a \) }
3489 @cindex PhrasingSlur, ejemplo de sobreescritura
3490 @cindex positions, propiedad, ejemplo
3493 Una posibilidad sería mover los dos extremos de la ligadura de
3494 fraseo hacia arriba. Podemos tratar de establecer el extremo
3495 izquierdo a 2.5 espacios de pentagrama por encima de la tercera
3496 línea y el extremo derecho a 4.5 también hacia arriba, y LilyPond
3497 seleccionaría la ligadura de fraseo de entre las candidatas que ha
3498 encontrado con sus extremos más cercanos a éstos:
3500 @lilypond[quote,verbatim,fragment,ragged-right]
3501 \once \override PhrasingSlur.positions = #'(2.5 . 4.5)
3502 a'8 \( ( a''16 ) a'' \)
3505 Esto supone una mejora, pero ¿por qué no bajar un poco el extremo
3506 derecho de la ligadura de expresión? Si lo probamos, veremos que
3507 no se puede hacer así. Ello es a causa de que no existen
3508 ligaduras de expresión candidatas que estén más bajas que la que
3509 ya se ha seleccionado, y en este caso la propiedad
3510 @code{positions} no tiene ningún efecto. Sin embargo, las
3511 ligaduras de unión, expresión y fraseo @emph{se pueden} colocar y
3512 conformar de manera muy exacta cuando se necesita. Para aprender
3513 la manera de hacerlo, consulte @ruser{Modificación de ligaduras de
3514 unión y de expresión}.
3516 Presentamos otro ejemplo. Vemos que la barra choca con las
3519 @lilypond[quote,verbatim,ragged-right]
3523 \relative { c'1~ 2. e8 f }
3532 \relative { c'1~ 2. e8 f }
3544 Esto se puede resolver manualmente elevando los dos extremos de la
3545 barra desde su posición a 1.81 espacios de pentagrama bajo la
3546 línea central hasta, digamos, 1 espacio:
3548 @cindex Beam, ejemplo de sobreescritura
3549 @cindex positions, propiedad, ejemplo
3551 @lilypond[quote,verbatim,ragged-right]
3555 \relative { c'1~ 2. e8 f }
3558 \override Beam.positions = #'(-1 . -1)
3565 \relative { c'1~ 2. e8 f }
3571 \revert Beam.positions
3578 Observe que la sobreescritura sigue aplicándose en la segunda voz
3579 del segundo compás de corcheas, pero no a ninguna de las barras de
3580 la primera voz, ni siquiera a las que están en el segundo compás,
3581 que es posterior. Tan pronto como la sobreescritura no pueda
3582 tener ningún efecto, debería ser revertida como se muestra.
3584 @node La propiedad force-hshift (forzar desplazamiento horizontal)
3585 @unnumberedsubsubsec La propiedad @code{force-hshift} (forzar desplazamiento horizontal)
3586 @translationof The force-hshift property
3588 Ahora podremos ver cómo aplicar las correcciones finales al
3589 ejemplo de Chopin que presentamos al final de @ref{Oigo voces},
3590 que dejamos con este aspecto:
3592 @lilypond[quote,verbatim,fragment,ragged-right]
3593 \new Staff \relative {
3608 Es necesario que la nota interior del primer acorde (el La bemol
3609 de la cuarta voz) no se aparte de la columna vertical de la nota
3610 aguda, por lo que usamos @code{\shiftOff}.
3612 En el segundo acorde preferimos que el Fa esté alineado con el La
3613 bemol y que la nota grave se coloque ligeramente a la derecha para
3614 evitar una colisión de las plicas. Lo conseguimos ajustando el
3615 valor de @code{force-hshift} en la @code{NoteColumn} del Re bemol
3616 grave para moverlo a la derecha medio espacio de pentagrama, y
3617 fijando @code{force-hshift} para el Fa al vaor cero. Observe que
3618 usamos @code{\once} para evitar que los ajustes se propaguen más
3619 allá del momento musical inmediato, aunque en este pequeño ejemplo
3620 podrían omitirse el @code{\once} y el segundo @code{\override} de
3621 la cuarta voz. Ello no supondría una buena práctica.
3623 Presentamos a continuación el resultado final:
3625 @cindex NoteColumn, ejemplo de sobreescritura
3626 @cindex force-hshift, propiedad, ejemplo
3628 @lilypond[quote,verbatim,fragment,ragged-right]
3629 \new Staff \relative {
3634 { <ees, c>2 \once \override NoteColumn.force-hshift = 0.5 des }
3637 { \once \shiftOff aes'2 \once \shiftOff f4 fes }
3644 @node Ejemplos reales de música
3645 @subsection Ejemplos reales de música
3646 @translationof Real music example
3648 Finalizaremos esta sección sobre los trucos mostrando los pasos
3649 que se deben tomar para tratar con un ejemplo complicado que
3650 necesita varios trucos para producir el resultado deseado. El
3651 ejemplo se ha escogido deliberadamente para ilustrar el uso de la
3652 Referencia de la Notación para resolver problemas de notación poco
3653 comunes. No es representativo del proceso de grabado más usual,
3654 por lo que ¡le recomendamos que no deje que estas dificultades le
3655 desanimen! ¡Afortunadamente, las dificultades como éstas no son
3658 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
3659 compases 6 al 9, la transición entre el Lento inicial y el
3660 Moderato. Presentamos en primer lugar el aspecto que queremos que
3661 tenga el resultado, pero para evitar complicar demasiado el
3662 ejemplo hemos quitado las indicaciones dinámicas, las digitaciones
3665 @c The following should appear as music without code
3666 @c This example should not be indexed
3667 @c line-width ensures no break
3668 @lilypond[quote,ragged-right,line-width=6\in]
3669 rhMusic = \relative {
3672 \once \override Tie.staff-position = #3.5
3676 \mergeDifferentlyHeadedOn
3677 \mergeDifferentlyDottedOn
3678 bes2.\tempo "Moderato" r8
3684 % Reposition the c2 to the right of the merged note
3685 \once \override NoteColumn.force-hshift = #1.0
3686 % Move the c2 out of the main note column
3687 % so the merge will work
3694 % Stem on the d2 must be down to permit merging
3696 % Stem on the d2 should be invisible
3697 \tweak Stem.transparent ##t
3705 \mergeDifferentlyHeadedOff
3706 \mergeDifferentlyDottedOff
3711 lhMusic = \relative {
3713 <d g, d>1)\arpeggio |
3720 \new Staff = "RH" <<
3724 \new Staff = "LH" <<
3733 Observamos en primer lugar que la parte de la mano derecha del
3734 tercer compás requiere cuatro voces. Son las cinco corcheas
3735 unidas por una barra, la nota Do ligada, el Re blanca que se funde
3736 con el Re corchea, y el Fa sostenido negra con puntillo, que
3737 también está fundida con la corchea de su misma altura. Todo lo
3738 demás está en una sola voz, así que lo más fácil es introducir
3739 estas tres voces adicionales, en el momento en que se necesiten y
3740 de forma temporal. Si ha olvidado cómo hacerlo, lea las secciones
3741 @ref{Oigo voces} y @ref{Voces explícitas}. Aquí tomamos la
3742 decisión de utilizar voces instanciadas explícitamente para el
3743 pasaje polifónico, dado que LilyPond es más probable que pueda
3744 evitar las colisiones si todas las voces se instancian
3745 explícitamente de esta forma.
3747 Vamos a comenzar introduciendo las notas como dos variables y
3748 disponiendo la estructura de pentagramas en un bloque Score, y
3749 veremos qué produce LilyPond de forma predeterminada:
3751 @c line-width ensures no break
3752 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3753 rhMusic = \relative {
3759 % Start polyphonic section of four voices
3761 { c,8 d fis bes a } % continuation of main voice
3775 g2. % continuation of main voice
3779 lhMusic = \relative {
3788 \new Staff = "RH" <<
3792 \new Staff = "LH" <<
3801 Todas las notas son correctas, pero el aspecto está lejos de ser
3802 satisfactorio. La ligadura de unión choca con el cambio de
3803 compás, ciertas notas no se funden correctamente, y faltan algunos
3804 elementos de notación. En primer lugar trataremos con lo más
3805 fácil. Podemos añadir fácilmente la ligadura de expresión de la
3806 mano izquierda y la ligadura de fraseo de la mano derecha, pues
3807 todo ello se estudió en el Tutorial. Al hacerlo así obtenemos:
3809 @c line-width ensures no break
3810 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3811 rhMusic = \relative {
3817 % Start polyphonic section of four voices
3819 { c,8 d fis bes a } % continuation of main voice
3833 g2.\) % continuation of main voice
3837 lhMusic = \relative {
3846 \new Staff = "RH" <<
3850 \new Staff = "LH" <<
3859 El primer compás ahora es correcto. El segundo compás contiene un
3860 arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no
3861 han sido mencionados en este Manual de Aprendizaje? Aquí es donde
3862 tenemos que volver e la Referencia de la Notación. Buscando la
3863 palabra @q{arpegio} y @q{línea divisoria} en el índice nos muestra
3864 rápidamente que un arpegio se hace añadiendo @code{\arpeggio} a un
3865 acorde, y la doble barra se produce por medio de la instrucción
3866 @code{\bar "||"}. Esto podemos hacerlo fácilmente. A
3867 continuación tenemos que corregir la colisión entre la ligadura de
3868 unión y la indicación de compás. Esto se hace mejor moviendo la
3869 ligadura hacia arriba. Estudiamos cómo mover objetos
3870 anteriormente en @ref{Mover objetos}, donde dice que los objetos
3871 que están situados de forma relativa al pentagrama se pueden mover
3872 verticalmente sobreescribiendo su propiedad @code{staff-position},
3873 que se especifica en unidades de medio espacio de pentagrama
3874 respecto de la línea central del pentagrama. Así pues, la
3875 sobreescritura siguiente colocada justo antes de la primera nota
3876 ligada subirá la ligadura 3.5 medios espacios de pentagrama por
3877 encima de la línea central:
3879 @code{\once \override Tie.staff-position = #3.5}
3881 Con esto se completa el compás dos, dando como resultado:
3883 @c line-width ensures no break
3884 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3885 rhMusic = \relative {
3888 \once \override Tie.staff-position = #3.5
3893 % Start polyphonic section of four voices
3895 { c,8 d fis bes a } % continuation of main voice
3909 g2.\) % continuation of main voice
3913 lhMusic = \relative {
3915 <d g, d>1)\arpeggio |
3922 \new Staff = "RH" <<
3926 \new Staff = "LH" <<
3935 Vayamos ahora al tercer compás y comienzo de la sección Moderato.
3936 El tutorial nos enseñó cómo escribir una indicación de tempo
3937 mediante la instrucción @code{\tempo}, por lo que añadir
3938 @qq{Moderato} es fácil. Pero ahora ¿cómo fundimos notas que están
3939 en distintas voces? Aquí es donde debemos volver a buscar ayuda
3940 en el manual de Referencia de la notación. Al buscar la palabra
3941 @qq{merge} (mezcla) en el índice de la Referencia de la notación
3942 llegamos rápidamente a las instrucciones para mezclar notas con
3943 distinta cabeza y con o sin puntillo, en @ruser{Resolución de las
3944 colisiones}. En nuestro ejemplo tenemos que fusionar ambos tipos
3945 de nota en el transcurso de la sección polifónica del compás 3;
3946 por tanto, en virtud de la información que aparece en la
3947 Referencia de la Notación, escribimos
3950 \mergeDifferentlyHeadedOn
3951 \mergeDifferentlyDottedOn
3955 al principio de la sección, y
3958 \mergeDifferentlyHeadedOff
3959 \mergeDifferentlyDottedOff
3963 al final, dando como resultado:
3965 @c line-width ensures no break
3966 @lilypond[quote,ragged-right,line-width=6\in]
3967 rhMusic = \relative {
3970 \once \override Tie.staff-position = #3.5
3974 bes2.\tempo "Moderato" r8
3975 \mergeDifferentlyHeadedOn
3976 \mergeDifferentlyDottedOn
3977 % Start polyphonic section of four voices
3979 { c,8 d fis bes a } % continuation of main voice
3993 \mergeDifferentlyHeadedOff
3994 \mergeDifferentlyDottedOff
3995 g2.\) % continuation of main voice
3999 lhMusic = \relative {
4001 <d g, d>1)\arpeggio |
4008 \new Staff = "RH" <<
4012 \new Staff = "LH" <<
4021 Estas sobreescrituras han fundido los dos Fa sostenido, pero no
4022 los dos Re. ¿Por qué no? La respuesta está en la misma sección
4023 de la Referencia de la Notación: las notas que se fusionan deben
4024 tener las plicas en direcciones opuestas y dos notas no se pueden
4025 fusionar bien si hay una tercera nota en la misma columna. Aquí
4026 los dos Re tienen las plicas hacia arriba y hay una tercera nota:
4027 el Do. Sabemos cómo cambiar la dirección de la plica usando
4028 @code{\stemDown}, y la Referencia de la Notación también explica
4029 cómo mover el Do: aplicar un desplazamiento usando una de las
4030 instrucciones @code{\shift}. Pero ¿cuál? El Do está en la voz
4031 dos que tiene desactivado el desplazamiento, y los dos Re están en
4032 las voces uno y tres, que tienen el desplazamiento desactivado y
4033 activado, respectivamente. Por ello tenemos que desplazar el Do
4034 un nivel más todavía, usando @code{\shiftOnn} para evitar que
4035 interfiera con los dos Re. Al aplicar estos cambios obtenemos:
4037 @cindex Tie, ejemplo de sobreescritura
4038 @cindex staff-position, propiedad, ejemplo
4040 @c line-width ensures no break
4041 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
4042 rhMusic = \relative {
4045 \once \override Tie.staff-position = #3.5
4049 bes2.\tempo "Moderato" r8
4050 \mergeDifferentlyHeadedOn
4051 \mergeDifferentlyDottedOn
4052 % Start polyphonic section of four voices
4054 { c,8 d fis bes a } % continuation of main voice
4057 % Move the c2 out of the main note column
4058 % so the merge will work
4063 % Stem on the d2 must be down to permit merging
4071 \mergeDifferentlyHeadedOff
4072 \mergeDifferentlyDottedOff
4073 g2.\) % continuation of main voice
4077 lhMusic = \relative {
4079 <d g, d>1)\arpeggio |
4086 \new Staff = "RH" <<
4090 \new Staff = "LH" <<
4099 Ya casi está. Solamente quedan dos problemas: la plica hacia
4100 abajo sobre el Re fusionado no tendría que estar ahí, y el Do
4101 estaría mejor colocado a la derecha de los Re. Sabemos cómo hacer
4102 las dos cosas a partir de trucos anteriores: hacemos la plica
4103 transparente, y movemos el Do con la propiedad
4104 @code{force-hshift}. Aquí tenemos el resultado final:
4106 @cindex NoteColumn, ejemplo de sobreescritura
4107 @cindex force-hshift, propiedad, ejemplo
4108 @cindex Stem, ejemplo de sobreescritura
4109 @cindex transparent, propiedad, ejemplo
4111 @c line-width ensures no break
4112 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
4113 rhMusic = \relative {
4116 \once \override Tie.staff-position = #3.5
4120 bes2.\tempo "Moderato" r8
4121 \mergeDifferentlyHeadedOn
4122 \mergeDifferentlyDottedOn
4123 % Start polyphonic section of four voices
4125 { c,8 d fis bes a } % continuation of main voice
4129 % Reposition the c2 to the right of the merged note
4130 \once \override NoteColumn.force-hshift = #1.0
4131 % Move the c2 out of the main note column
4132 % so the merge will work
4139 % Stem on the d2 must be down to permit merging
4141 % Stem on the d2 should be invisible
4142 \tweak Stem.transparent ##t
4150 \mergeDifferentlyHeadedOff
4151 \mergeDifferentlyDottedOff
4152 g2.\) % continuation of main voice
4156 lhMusic = \relative {
4158 <d g, d>1)\arpeggio |
4165 \new Staff = "RH" <<
4169 \new Staff = "LH" <<
4179 @node Trucajes adicionales
4180 @section Trucajes adicionales
4181 @translationof Further tweaking
4184 * Otras aplicaciones de los trucos::
4185 * Uso de variables para los ajustes de disposición::
4187 * Otras fuentes de información::
4188 * Trucos avanzados con Scheme::
4191 @node Otras aplicaciones de los trucos
4192 @subsection Otras aplicaciones de los trucos
4193 @translationof Other uses for tweaks
4196 * Unir notas entre voces distintas::
4197 * Simulación de un calderón en el MIDI::
4200 @cindex eliminar objetos
4201 @cindex objetos, eliminar
4203 @node Unir notas entre voces distintas
4204 @unnumberedsubsubsec Unir notas entre voces distintas
4205 @translationof Tying notes across voices
4207 @cindex ligar notas entre voces distintas
4209 El ejemplo siguiente muestra cómo conectar notas que están en
4210 distintas voces utilizando ligaduras de unión. Normalmente sólo
4211 se pueden conectar mediante ligaduras de unión notas que estén en
4212 la misma voz. Usando dos voces, con las notas ligadas en una de
4216 << { b'8~ 8\noBeam } \\ { b'8[ g'] } >>
4220 y borrando la primera plica (con su corchete) hacia arriba en esa
4221 voz, da la impresión de que la ligadura se cruza entre las voces:
4224 @cindex Stem, example of removing
4225 @cindex Flag, example of removing
4226 @cindex @code{\omit}, example
4227 @cindex example of @code{\omit}
4229 @lilypond[quote,verbatim]
4242 Manual de aprendizaje
4243 @ref{El prefijo once,,El prefijo @code{@bs{}once}},
4244 @ref{La propiedad stencil (sello)}.
4247 @node Simulación de un calderón en el MIDI
4248 @unnumberedsubsubsec Simulación de un calderón en el MIDI
4249 @translationof Simulating a fermata in MIDI
4251 @cindex sello, uso de la propiedad
4252 @cindex fermata, realización en MIDI
4254 Para los objetos fuera-del-pentagrama, normalmente es mejor
4255 sobreescribir la propiedad @code{stencil} («sello») del objeto que
4256 su propiedad @code{transparent} cuando desee quitarlos de la
4257 salida impresa. Mediante el establecimiento de la propiedad
4258 @code{stencil} de un objeto al valor @code{#f} podemos quitar el
4259 objeto por completo de la salida impresa. Esto significa que no
4260 tiene efecto sobre la colocación de otros objetos que pudieran
4261 colocarse en relación a él.
4263 Por ejemplo, si quisiéramos cambiar la indicación metronómica con
4264 el propósito de simular un calderón en la salida MIDI, seguramente
4265 no querríamos que la indicación metronómica apareciese en la
4266 salida impresa, y no querríamos influir sobre la separación entre
4267 los dos sistemas ni sobre la colocación de las anotaciones
4268 adyacentes sobre el pentagrama. Por lo tanto, establecer su
4269 propiedad @code{stencil} al valor @code{#f} sería la mejor manera.
4270 Mostramos aquí el efecto de los dos métodos:
4272 @cindex MetronomeMark, ejemplo de sobreescritura
4273 @cindex transparent, propiedad, ejemplo
4275 @lilypond[quote,verbatim,ragged-right]
4278 % Visible tempo marking
4281 \once \hide Score.MetronomeMark
4282 % Invisible tempo marking to lengthen fermata in MIDI
4285 % New tempo for next section
4294 @cindex MetronomeMark, ejemplo de sobreescritura
4295 @cindex stencil, propiedad, ejemplo
4297 @lilypond[quote,verbatim,ragged-right]
4300 % Visible tempo marking
4303 \once \omit Score.MetronomeMark
4304 % Invisible tempo marking to lengthen fermata in MIDI
4307 % New tempo for next section
4317 Ambos métodos quitan de la salida impresa la indicación
4318 metronómica que alarga el calderón, y los dos afectan al tempo del
4319 MIDI tal y como queríamos, pero la indicación metronómica
4320 transparente de la primera línea fuerza una colocación muy alta de
4321 la indicación de tempo que sigue, mientras que la segunda (con el
4322 sello suprimido) no lo hace.
4328 @node Uso de variables para los ajustes de disposición
4329 @subsection Uso de variables para los ajustes de disposición
4330 @translationof Using variables for layout adjustments
4332 @cindex variables, usar para sobreescrituras
4333 @cindex sobreescrituras, usar variablas para
4334 @cindex ajustes, usar variables para
4335 @cindex ajustes de disposición, usar variables para hacer
4337 Las instrucciones de sobreescritura son con frecuencia largas y
4338 tediosas de escribir, y se tienen que escribir de forma
4339 absolutamente correcta. Si las mismas sobreescrituras se van a
4340 utilizar muchas veces, podría merecer la pena definir variables
4343 Supongamos que queremos realzar ciertas palabras de la letra de
4344 una canción imprimiéndolas en cursiva y negrita. Las
4345 instrucciones @code{\italic} y @code{\bold} sólo funcionan dentro
4346 de la letra de las canciones si están incluidas, junto con la
4347 palabra o palabras que se pretenden modificar, dentro de un
4348 @code{\markup}, lo que las hace tediosas de escribir. La necesidad
4349 de incluir las propias palabras impide que se puedan usar en
4350 variables simples. ¿Podríamos, como alternativa, utilizar las
4351 instrucciones @code{\override} y @code{\revert}?
4354 @code{\override Lyrics.LyricText.font-shape = #'italic}
4355 @code{\override Lyrics.LyricText.font-series = #'bold}
4357 @code{\revert Lyrics.LyricText.font-shape}
4358 @code{\revert Lyrics.LyricText.font-series}
4361 Estas instrucciones también serían extremadamente tediosas de
4362 escribir si hubiera muchas palabras que quisiéramos subrayar.
4363 Pero sí @emph{podemos} definirlas como dos variables y usarlas
4364 para delimitar las palabras que destacar. Otra ventaja de la
4365 utilización de variables para estas sobreescrituras es que ya no
4366 son necesarios los espacios que rodean al punto, puesto que no se
4367 interpretan directamente en el modo @code{\lyricmode}. He aquí un
4368 ejemplo de esto, aunque en la práctica quizá elegiríamos unos
4369 nombres de variable más cortos para que fueran más rápidos de
4372 @cindex LyricText, ejemplo de sobreescritura
4373 @cindex font-shape, propiedad, ejemplo
4374 @cindex font-series, propiedad, ejemplo
4376 @lilypond[quote,verbatim]
4378 \override Lyrics.LyricText.font-shape = #'italic
4379 \override Lyrics.LyricText.font-series = #'bold
4383 \revert Lyrics.LyricText.font-shape
4384 \revert Lyrics.LyricText.font-series
4387 global = { \key c \major \time 4/4 \partial 4 }
4389 SopranoMusic = \relative { c'4 | e4. e8 g4 g | a4 a g }
4390 AltoMusic = \relative { c'4 | c4. c8 e4 e | f4 f e }
4391 TenorMusic = \relative { e4 | g4. g8 c4. b8 | a8 b c d e4 }
4392 BassMusic = \relative { c4 | c4. c8 c4 c | f8 g a b c4 }
4394 VerseOne = \lyrics {
4395 E -- | ter -- nal \emphasize Fa -- ther, | \normal strong to save,
4398 VerseTwo = \lyricmode {
4399 O | \once \emphasize Christ, whose voice the | wa -- ters heard,
4402 VerseThree = \lyricmode {
4403 O | \emphasize Ho -- ly Spi -- rit, | \normal who didst brood
4406 VerseFour = \lyricmode {
4407 O | \emphasize Tri -- ni -- ty \normal of | love and pow'r
4414 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
4415 \new Voice = "Alto" { \voiceTwo \AltoMusic }
4416 \new Lyrics \lyricsto "Soprano" { \VerseOne }
4417 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
4418 \new Lyrics \lyricsto "Soprano" { \VerseThree }
4419 \new Lyrics \lyricsto "Soprano" { \VerseFour }
4423 \new Voice = "Tenor" { \voiceOne \TenorMusic }
4424 \new Voice = "Bass" { \voiceTwo \BassMusic }
4431 @node Hojas de estilo
4432 @subsection Hojas de estilo
4433 @translationof Style sheets
4435 La salida que produce LilyPond se puede modificar profundamente;
4436 consulte @ref{Trucar la salida} para leer detalles sobre este
4437 asunto. Pero ¿qué ocurre si tiene muchos archivos a los que les
4438 quiere aplicar sus propios trucos? O ¿qué ocurre si,
4439 sencillamente, quiere separar los trucos de la propia música?
4440 Todo esto es bastante fácil de conseguir.
4442 Veamos un ejemplo. No se preocupe si no entiende las partes que
4443 tienen todos los @code{#()}. Esto se explicará en @ref{Trucos
4444 avanzados con Scheme}.
4446 @lilypond[quote,verbatim,ragged-right]
4448 \tweak self-alignment-X #-0.6
4449 #(make-dynamic-script
4450 #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4453 #(define-music-function
4456 #{ <>^\markup \bold \box #string #})
4460 a'4.\mpdolce d8 cis4--\glissando a |
4464 g8(\! fis)-. e( d)-. cis2 |
4468 Hagamos algo respecto a las definiciones @code{mpdolce} e
4469 @code{inst}. Éstas producen la salida que deseamos, pero quizá
4470 las querríamos utilizar en otra pieza. Podríamos simplemente
4471 copiarlas y pegarlas al principio de cada archivo, pero sería
4472 bastante molesto. También hace que se queden las definiciones a
4473 la vista dentro de nuestros archivos de música, y yo personalmente
4474 encuentro todos los @code{#()} bastante poco estéticos. Los vamos
4475 a esconder dentro de otro archivo:
4478 %%% guardar esto en un archivo con el nombre "definiciones.ily"
4480 \tweak self-alignment-X #-0.6
4481 #(make-dynamic-script
4482 #@{ \markup @{ \dynamic mp \normal-text \italic \bold dolce @} #@})
4485 #(define-music-function
4488 #@{ <>^\markup \bold \box #string #@})
4491 Haremos referencia a este archivo utilizando la instrucción
4492 @code{\include} al principio del archivo de música (la extensión
4493 @code{.ily} se utiliza para distinguir este archivo de inclusión
4494 --que se supone que no debe ser procesado de forma independiente--
4495 del archivo principal). Ahora modificaremos la música (guardemos
4496 este archivo como @file{musica.ly}).
4498 @c We have to do this awkward example/lilypond-non-verbatim
4499 @c because we can't do the \include stuff in the manual.
4502 \include "definiciones.ily"
4506 a'4.\mpdolce d8 cis4--\glissando a |
4510 g8(\! fis)-. e( d)-. cis2 |
4514 @lilypond[quote,ragged-right]
4516 \tweak self-alignment-X #-0.6
4517 #(make-dynamic-script
4518 #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4521 #(define-music-function
4524 #{ <>^\markup \bold \box #string #})
4528 a'4.\mpdolce d8 cis4--\glissando a |
4532 g8(\! fis)-. e( d)-. cis2 |
4536 Eso tiene mejor aspecto, pero haremos algunos cambios más. El
4537 glissando es difícil de ver, así que lo haremos más grueso y lo
4538 acercaremos a las cabezas de las notas. Pondremos la indicación
4539 metronómica encima de la clave, en lugar de ir encima de la
4540 primera nota. Y por último, mi profesor de composición odia las
4541 indicaciones de compás @q{C}, así que la convertiremos en @q{4/4}.
4543 Sin embargo, no debemos cambiar el archivo @file{musica.ly}.
4544 Sustituyamos nuestro archivo @file{definiciones.ily} con éste:
4547 %%% definiciones.ily
4549 \tweak self-alignment-X #-0.6
4550 #(make-dynamic-script
4551 #@{ \markup @{ \dynamic mp \normal-text \italic \bold dolce @} #@})
4554 #(define-music-function
4557 #@{ <>^\markup \bold \box #string #@})
4562 \override MetronomeMark.extra-offset = #'(-5 . 0)
4563 \override MetronomeMark.padding = #'3
4567 \override TimeSignature.style = #'numbered
4571 \override Glissando.thickness = #3
4572 \override Glissando.gap = #0.1
4577 @lilypond[quote,ragged-right]
4579 \tweak self-alignment-X #-0.6
4580 #(make-dynamic-script
4581 #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4584 #(define-music-function
4587 #{ <>^\markup \bold \box #string #})
4592 \override MetronomeMark.extra-offset = #'(-5 . 0)
4593 \override MetronomeMark.padding = #'3
4597 \override TimeSignature.style = #'numbered
4601 \override Glissando.thickness = #3
4602 \override Glissando.gap = #0.1
4608 a'4.\mpdolce d8 cis4--\glissando a |
4612 g8(\! fis)-. e( d)-. cis2 |
4616 ¡Eso tiene un aspecto mucho mejor! Ahora suponga que quiere
4617 publicar esta pieza. A mi profesor de composición no le gustan
4618 las indicaciones de compás @q{C}, pero yo les tengo cierto cariño.
4619 Copiaremos el archivo actual @file{definiciones.ily} a
4620 @file{publicar-web.ily} y modificaremos éste. Como el propósito
4621 de esta música es producir un PDF que va a mostrarse en la
4622 pantalla, también vamos a aumentar el tamaño general de la salida.
4625 %%% publicar-web.ily
4627 \tweak self-alignment-X #-0.6
4628 #(make-dynamic-script
4629 #@{ \markup @{ \dynamic mp \normal-text \italic \bold dolce @} #@})
4632 #(define-music-function
4635 #@{ <>^\markup \bold \box #string #@})
4637 #(set-global-staff-size 23)
4642 \override MetronomeMark.extra-offset = #'(-5 . 0)
4643 \override MetronomeMark.padding = #'3
4650 \override Glissando.thickness = #3
4651 \override Glissando.gap = #0.1
4656 @lilypond[quote,ragged-right]
4658 \tweak self-alignment-X #-0.6
4659 #(make-dynamic-script
4660 #{ \markup { \dynamic mp \normal-text \italic \bold dolce } #})
4663 #(define-music-function
4666 #{ <>^\markup \bold \box #string #})
4668 #(set-global-staff-size 23)
4672 \override MetronomeMark.extra-offset = #'(-5 . 0)
4673 \override MetronomeMark.padding = #'3
4676 \override Glissando.thickness = #3
4677 \override Glissando.gap = #0.1
4683 a'4.\mpdolce d8 cis4--\glissando a |
4687 g8(\! fis)-. e( d)-. cis2 |
4691 Ahora, en la música, simplemente sustituyo @code{\include
4692 "definiciones.ily"} por @code{\include "publicar-web.ily"}. Por
4693 supuesto, podríamos hacer esto aún más práctico. Podríamos hacer
4694 un archivo @file{definiciones.ily} que contuviera solamente las
4695 definiciones de @code{mpdolce} y de @code{inst}, un archivo
4696 @file{publicar-web.ily} que contuviera solamente la sección
4697 @code{\layout} que se mostró en el ejemplo, y un archivo
4698 @file{universidad.ily} que contendría solamente los trucos para
4699 producir la salida que le gusta a mi profesor. El comienzo de
4700 @file{musica.ly} tendría entonces este aspecto:
4703 \include "definiciones.ily"
4705 %%% ¡Quitar el comentario de una sola de estas líneas!
4706 \include "publicar-web.ily"
4707 %\include "universidad.ily"
4710 Este enfoque puede ser útil incluso si va a producir sólo un
4711 conjunto de particellas. Yo utilizo media docena de archivos de
4712 @q{hojas de estilo} para mis proyectos. Comienzo todos los
4713 archivos de música con @code{\include "../global.ily"}, que
4718 \version @w{"@version{}"}
4720 #(ly:set-option 'point-and-click #f)
4722 \include "../iniciar/iniciar-definiciones.ily"
4723 \include "../iniciar/iniciar-disposicion.ily"
4724 \include "../iniciar/iniciar-cabeceras.ily"
4725 \include "../iniciar/iniciar-papel.ily"
4729 @node Otras fuentes de información
4730 @subsection Otras fuentes de información
4731 @translationof Other sources of information
4733 La documentación del manual de Referencia de Funcionamiento
4734 Interno contiene montañas de información sobre LilyPond, pero se
4735 puede obtener más información aún leyendo los archivos internos de
4736 LilyPond. Para echarles un vistazo, en primer lugar debe buscar
4737 la carpeta correspondiente a su sistema. La ubicación de esta
4738 carpeta depende (a) de si consiguió el programa LilyPond
4739 descargando un binario precompilado desde el sitio web
4740 lilypond.org o si lo instaló mediante un gestor de paquetes (es
4741 decir, distribuido con GNU/Linux, o instalado bajo fink o cygwin)
4742 o fue compilado a partir de la fuente, y (b) de qué sistema
4743 operativo está utilizando:
4745 @subsubsubheading Descargado de lilypond.org
4752 @file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/@/share/lilypond/current/}
4759 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/@/Resources/share/lilypond/current/}
4762 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
4763 bien manteniendo pulsada la tecla de Control y haciendo click
4764 sobre la aplicación de LilyPond, y allí eligiendo @q{Mostrar el
4765 contenido del paquete}.
4769 Mediante el Explorador de Windows, diríjase a
4771 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/@/share/lilypond/current/}
4776 @subsubsubheading Instalado mediante un gestor de paquetes o compilado a partir de la fuente
4778 Diríjase a @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde
4779 @var{PREFIJO} se encuentra determinado por su administrador de
4780 paquetes o guión @code{configure}, y @var{X.Y.Z} es el número de
4781 la versión de LilyPond.
4785 Dentro de esta carpeta, las dos subcarpetas interesantes son
4788 @item @file{ly/} - contiene archivos en formato LilyPond
4789 @item @file{scm/} - contiene archivos en formato Scheme
4792 Vamos a comenzar observando algunos archivos que están en
4793 @file{ly/}. Abra @file{ly/property-init.ly} con un editor de
4794 textos. El mismo que usaría normalmente para los archivos
4795 @file{.ly} servirá perfectamente. Este archivo contiene las
4796 definiciones de todas las instrucciones estándar predefinidas de
4797 LilyPond, como por ejemplo @code{\tieUp} y @code{\slurDotted}.
4798 Podrá ver que no son nada más que definiciones de variables que
4799 contienen una o varias instrucciones @code{\override}. Por
4800 ejemplo, @code{\tieDotted} está definido de tal forma que su valor
4805 \override Tie.dash-period = #0.75
4806 \override Tie.dash-fraction = #0.1
4810 Si no le gustan los valores predeterminados, estas instrucciones
4811 predefinidas se pueden redefinir con facilidad como cualquier otra
4812 variable, al principio de su archivo de código de entrada.
4814 Los siguientes son los archivos más útiles que se encuentran en
4817 @multitable @columnfractions .4 .6
4820 @item @file{ly/engraver-init.ly}
4821 @tab Definiciones de Contextos de grabadores
4822 @item @file{ly/paper-defaults-init.ly}
4823 @tab especificaciones de valores predeterminados relacionados con el papel
4824 @item @file{ly/performer-init.ly}
4825 @tab Definiciones de Contextos de interpretación
4826 @item @file{ly/property-init.ly}
4827 @tab Definiciones de todas las instrucciones predefinidas que son comunes
4828 @item @file{ly/spanner-init.ly}
4829 @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
4832 Otros ajustes (como las definiciones de las instrucciones de
4833 marcado) se almacenan como archivos @file{.scm} (de Scheme). El
4834 lenguaje de programación Scheme se utiliza para proporcionar un
4835 interfaz programable en el funcionamiento interno de LilyPond.
4836 Cualquier explicación adicional sobre estos archivos se encuentra
4837 por el momento fuera del ámbito de este manual, porque se
4838 requieren conocimientos del lenguaje Scheme. Se advierte a los
4839 usuarios que se necesita una importante cantidad de conocimientos
4840 técnicos o de tiempo para comprender el lenguaje Scheme y estos
4841 archivos (véase @rextend{Tutorial de Scheme}).
4843 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
4846 @multitable @columnfractions .4 .6
4849 @item @file{scm/auto-beam.scm}
4850 @tab Valores predeterminados de sub-barrado
4851 @item @file{scm/define-grobs.scm}
4852 @tab valores predeterminados de las propiedades de grobs
4853 @item @file{scm/define-markup-commands.scm}
4854 @tab Especificar todas las instrucciones de marcado
4855 @item @file{scm/midi.scm}
4856 @tab Ajustes predeterminados para la salida MIDI
4857 @item @file{scm/output-lib.scm}
4858 @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
4859 @item @file{scm/parser-clef.scm}
4860 @tab Definiciones de las claves contempladas
4861 @item @file{scm/script.scm}
4862 @tab Ajustes predeterminados para las articulaciones
4866 @node Trucos avanzados con Scheme
4867 @subsection Trucos avanzados con Scheme
4868 @translationof Advanced tweaks with Scheme
4870 Aunque es posible hacer muchas cosas con las instrucciones
4871 @code{\override} y @code{\tweak} , tenemos una forma incluso más
4872 poderosa de modificar el funcionamiento de LilyPond, a través de
4873 un interface programable hacia las operaciones internas de
4874 LilyPond. Se puede incorporar código escrito en el lenguaje de
4875 programación Scheme, directamente en el mecanismo de
4876 funcionamiento de LilyPond. Por supuesto, para hacer esto se
4877 necesitan al menos unos conocimientos básicos de programación en
4878 Scheme, y damos una introducción en el @rextend{Tutorial de
4881 Como ejemplo que ilustra una de las muchas posibilidades, en lugar
4882 de dar a una propiedad un valor constante, se puede establecer al
4883 resultado de un procedimiento de Scheme que se invoca cada vez que
4884 LilyPond accede a esta propiedad. La propiedad se puede
4885 establecer dinámicamente a un valor determinado por el
4886 procedimiento en el momento en que se invoca. En este ejemplo
4887 damos a las cabezas de las notas un color que depende de su
4888 posición dentro del pentagrama.
4890 @cindex x11-color, función, ejemplo de utilización
4891 @cindex NoteHead, ejemplo de sobreescritura
4892 @cindex color, propiedad, establecer a procedimiento de Scheme
4894 @lilypond[quote,verbatim,ragged-right]
4895 #(define (color-notehead grob)
4896 "Color the notehead according to its position on the staff."
4897 (let ((mod-position (modulo (ly:grob-property grob 'staff-position)
4900 ;; Return rainbow colors
4901 ((1) (x11-color 'red )) ; for C
4902 ((2) (x11-color 'orange )) ; for D
4903 ((3) (x11-color 'yellow )) ; for E
4904 ((4) (x11-color 'green )) ; for F
4905 ((5) (x11-color 'blue )) ; for G
4906 ((6) (x11-color 'purple )) ; for A
4907 ((0) (x11-color 'violet )) ; for B
4911 % Arrange to obtain color from color-notehead procedure
4912 \override NoteHead.color = #color-notehead
4913 a2 b | c2 d | e2 f | g2 a |
4917 Se pueden encontrar ejemplos adicionales que muestran la
4918 utilización de estos interfaces programables, en
4919 @rextendnamed{Callback functions,Funciones de callback}.