1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 2936a7a6c5bca895dfd5725ab2422ad1c6b3ff11
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Trucar la salida
14 @chapter Trucar la salida
15 @translationof Tweaking output
17 Este capítulo trata de cómo modificar la salida. LilyPond es extremadamente
18 configurable; prácticamente todos los fragmentos de la salida se pueden cambiar.
22 * Elementos de trucaje::
23 * Manual de referencia de funcionamiento interno::
24 * Apariencia de los objetos::
25 * Colocación de los objetos::
26 * Colisiones de objetos::
27 * Trucajes adicionales::
30 @node Elementos de trucaje
31 @section Elementos de trucaje
32 @translationof Tweaking basics
35 * Introducción al trucaje::
36 * Objetos e interfaces::
37 * Convenciones de nombres de objetos y propiedades::
38 * Métodos de trucaje::
41 @node Introducción al trucaje
42 @subsection Introducción al trucaje
43 @translationof Introduction to tweaks
45 El @q{Trucaje} es un término de LilyPond que denota los diversos
46 métodos que el usuario tiene a su disposición para modificar el
47 proceso de interpretación del archivo de entrada y cambiar la
48 apariencia de la salida impresa. Algunos trucos son muy fáciles de
49 usar; otros son más complejos. Pero en su conjunto, los métodos de
50 trucaje disponibles posibilitan conseguir casi cualquier apariencia
51 que deseemos en la música impresa.
53 En esta sección vamos a estudiar los conceptos básicos que se
54 necesitan para comprender el trucaje. Más tarde daremos un amplio
55 abanico de instrucciones listas para usar, que podrá simplemente
56 copiar para obtener el mismo efecto en sus partituras, y al mismo
57 tiempo mostraremos la forma de construir dichas instrucciones para que
58 pueda aprender cómo desarrollar sus propios trucos.
60 Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
61 la sección @ref{Contextos y grabadores}, pues los Contextos, los
62 Grabadores y las Propiedades que se contienen en ellos son
63 fundamentales para comprender y construir los trucos.
65 @node Objetos e interfaces
66 @subsection Objetos e interfaces
67 @translationof Objects and interfaces
71 @cindex objeto de extensión
73 @cindex propiedades de objetos
74 @cindex objeto, propiedades de
75 @cindex layout (disposición), objeto de
76 @cindex objeto de disposición (layout)
78 El trucaje consiste en modificar el funcionamiento y estructura
79 interna del programa LilyPond, por lo que en primer lugar
80 introduciremos algunos términos que se usan para describir dichas
81 operaciones y estructuras internas.
83 El término @q{Objeto} es un término genérico que se usa para referirse
84 a la multitud de estructuras internas que LilyPond construye durante
85 el procesado de un archivo de entrada. Así, cuando se encuentra una
86 instrucción como @code{\new Staff}, se construye un objeto nuevo del
87 tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
88 las propiedades asociadas con ese pentagrama en particular, por
89 ejemplo, su nombre y su armadura, además de otros detalles de los
90 grabadores que se han asignado para que operen dentro del contexto del
91 pentagrama. De forma similar, hay objetos que guardan las propiedades
92 de todos los demás contextos, como objetos de @code{Voice}, objetos de
93 @code{Score}, objetos de @code{Lyrics}, así como objetos que
94 representan todos los elementos notacionales como líneas divisorias,
95 cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
96 objeto tiene su propio conjunto de valores de propiedad.
98 Ciertos tipos de objetos reciben nombres especiales. Los objetos que
99 representan elementos de notación sobre la salida impresa como cabezas
100 de notas, plicas, ligaduras de expresión y de unión, digitaciones,
101 claves, etc. reciben el nombre de @q{Objetos de presentación}, a
102 menudo conocidos como @q{Objetos gráficos}, o abreviadamente
103 @q{Grobs}. Aún son objetos en el sentido genérico que hemos
104 mencionado, y también todos ellos tienen propiedades asociadas, como
105 su posición, tamaño, color,etc.
107 Ciertos objetos de presentación son aún más especializados. Las
108 ligaduras de fraseo, los reguladores, las indicaciones de octava alta
109 y baja, y muchos otros objetos gráficos no están situados en un solo
110 lugar: tienen un punto de inicio, un punto de final, y quizá otras
111 propiedades relacionadas con su forma. Los objetos con una forma
112 extendida como estos, reciben el nombre de «Objetos de extensión» o
115 Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
116 incluso aunque son bastante diferentes, comparten funcionalidades que
117 se deben procesar de la misma manera. Por ejemplo, todos los objetos
118 gráficos tienen un color, un tamaño, una posición, etc., y todas estas
119 propiedades se procesan de la misma forma durante la interpretación
120 del archivo de entrada por parte de LilyPond. Para simplificar estas
121 operaciones internas, estas acciones y propiedades comunes se agrupan
122 en un objeto llamado @code{grob-interface}, interface de grob. Hay
123 muchas otras agrupaciones de propiedades comunes como ésta, y cada
124 una recibe un nombre que acaba en @code{interface}. En total hay más
125 de 100 interfaces de éstos. Veremos más adelante porqué esto es del
126 interés y de utilidad para el usuario.
128 Estos son, en fin, los términos principales relativos a los objetos
129 que vamos a utilizar en este capítulo.
131 @node Convenciones de nombres de objetos y propiedades
132 @subsection Convenciones de nombres de objetos y propiedades
133 @translationof Naming conventions of objects and properties
135 @cindex nomenclatura, convenciones de, para objetos
136 @cindex nomenclatura, convenciones de, para propiedades
137 @cindex objetos, convenciones de nomenclatura
138 @cindex propiedades, convenciones de nomenclatura
140 Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
141 sección @ref{Contextos y grabadores}. En este lugar, para más fácil
142 referencia, presentamos una lista de los tipos de objetos y
143 propiedades más comunes, junto con las convenciones según las cuales
144 reciben su nombre, y un par de ejemplos de nombres reales. Hemos
145 utilizado una @q{A} mayúscula para denotar cualquier carácter
146 alfabético en mayúsculas, y @q{aaa} para cualquier número de
147 caracteres alfabéticos en minúscula. Otros caracteres se utilizan
148 literalmente como están.
150 @multitable @columnfractions .33 .33 .33
151 @headitem Objeto o tipo de propiedad
152 @tab Convención de nomenclatura
155 @tab Aaaa o AaaaAaaaAaaa
156 @tab Staff, GrandStaff
157 @item Objetos de presentación
158 @tab Aaaa o AaaaAaaaAaaa
161 @tab Aaaa_aaa_engraver
162 @tab Clef_engraver, Note_heads_engraver
164 @tab aaa-aaa-interface
165 @tab grob-interface, break-aligned-interface
166 @item Propiedades de contextos
167 @tab aaa o aaaAaaaAaaa
168 @tab alignAboveContext, skipBars
169 @item Propiedades de objetos de presentación
170 @tab aaa o aaa-aaa-aaa
171 @tab direction, beam-thickness
174 Como podremos ver en breve, las propiedades de distintos tipos de
175 objeto se modifican por parte de diferentes instrucciones; así pues,
176 es útil poder reconocer el tipo de objeto a partir de sus nombres de
179 @node Métodos de trucaje
180 @subsection Métodos de trucaje
181 @translationof Tweaking methods
183 @cindex trucaje, métodos de
185 @strong{La instrucción \override}
187 @cindex override, instrucción
188 @cindex override (sobreescritura), sintaxis de
193 Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
194 usan para cambiar las propiedades de los @strong{contextos} y para
195 quitar y poner @strong{grabadores}, en @ref{Modificar las propiedades de los contextos}
196 y @ref{Añadir y eliminar grabadores}. Ahora debemos
197 examinar algunas otras instrucciones importantes.
199 La instrucción que cambia las propiedades de los @strong{objetos de
200 presentación} es @code{\override}. Puesto que esta instrucción debe
201 modificar propiedades internas que se encuentran en un lugar profundo
202 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
203 las instrucciones que hemos usado hasta ahora. Tiene que saber
204 exactamente qué propiedad de qué objeto y en qué contexto se debe
205 modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
207 La sintaxis genérica de esta instrucción es:
210 \override @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación} =
215 Esto establecerá la propiedad de nombre
216 @var{propiedad-de-presentación} del objeto de presentación con el
217 nombre @var{ObjetoDePresentación}, que es miembro del contexto
218 @var{Contexto}, al valor @var{valor}.
220 El @var{contexto} se puede omitir (y normalmente así es) cuando el
221 contexto requerido se encuentra implicado sin ambigüedad y es uno de
222 los contextos del nivel más bajo, es decir: @code{Voice},
223 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
224 ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
226 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
227 valores, véase @ref{Tipos de propiedades}. Pero en esta sección
228 usaremos sólo unas cuantas propiedades y valores
229 sencillos que sean fáciles de entender, para ilustrar el formato
230 y la utilización de estas instrucciones.
232 Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
233 propiedad de presentación, y el@tie{}@code{#}, que debe preceder al valor.
234 Deben estar presentes siempre y de esa forma exacta. Es la
235 instrucción de uso más común dentro del trucaje, y durante la mayor
236 parte del resto de este capítulo presentaremos ejemplos de cómo se
237 usa. A continuación hay un ejemplo sencillo para cambiar el color de
240 @cindex color, propiedad, ejemplo
241 @cindex NoteHead, ejemplo de sobreescritura
243 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
245 \override NoteHead #'color = #red
247 \override NoteHead #'color = #green
251 @strong{La instrucción \revert}
253 @cindex revert, instrucción
258 Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
259 se sobreescribe de nuevo o se encuentra una instrucción
260 @code{\revert}. La instrucción @code{\revert} tiene la siguiente
261 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
262 valor predeterminado original; observe que no es a su valor previo si
263 se han utilizado varias instrucciones @code{\override}.
266 \revert @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación}
269 Una vez más, igual que @var{Contexto} dentro de la instrucción
270 @code{\override}, con frecuencia no es necesario especificar el
271 @var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
272 Aquí devolvemos el color de la cabeza al valor predeterminado para las
275 @cindex color, propiedad, ejemplo
276 @cindex NoteHead, ejemplo de sobreescritura
278 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
280 \override NoteHead #'color = #red
282 \override NoteHead #'color = #green
284 \revert NoteHead #'color
288 @strong{El prefijo \once}
293 Tanto la instrucción @code{\override} como @code{\set} se pueden
294 preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
295 @code{\override} o @code{\set} sea efectiva solamente durante el
296 tiempo musical en curso y antes de que la propiedad vuelva a tener
297 otra vez su valor anterior (que puede ser distinto de su valor
298 predeterminado si aún se está aplicando otra instrucción
299 @code{\override} de sobreescritura). Utilizando el mismo ejemplo,
300 podemos cambiar el color de una sola nota de la siguiente manera:
302 @cindex color, propiedad, ejemplo
303 @cindex NoteHead, ejemplo de sobreescritura
305 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
307 \override NoteHead #'color = #red
309 \once \override NoteHead #'color = #green
311 \revert NoteHead #'color
315 @strong{La instrucción \overrideProperty}
317 @cindex overrideProperty, instrucción
319 @funindex \overrideProperty
320 @funindex overrideProperty
322 Hay otra forma para la instrucción de sobreescritura,
323 @code{\overrideProperty}, que ocasionalmente es necesaria. La
324 mencionamos aquí con un propósito de exhaustividad, pero para ver más
325 detalles consulte @rextend{Trucos difíciles}.
326 @c Maybe explain in a later iteration -td
328 @strong{La instrucción \tweak}
330 @cindex tweak, instrucción
335 La última instrucción de trucaje que está disponible es @code{\tweak}.
336 Se debe utilizar cuando varios objetos tienen lugar
337 en el mismo momento musical pero solo queremos cambiar las propiedades
338 de algunos de ellos, como una sola nota dentro de un acorde.
340 @code{\override} para la sobreescritura afectaría a todas las notas
341 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
342 elemento del flujo de entrada.
344 He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
345 cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
346 primer lugar, veamos lo que haría @code{\once \override}:
348 @cindex font-size, propiedad, ejemplo
349 @cindex NoteHead, ejemplo de sobreescritura
351 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
353 \once \override NoteHead #'font-size = #-3
358 Vemos que la sobreescritura con override afecta a @emph{todas} las
359 cabezas de las notas del acorde. Esto es así porque todas las notas
360 de un acorde ocurren en el mismo @emph{momento musical}, y la acción
361 de @code{\once} es aplicar la sobreescritura a todos los objetos de
362 presentación del tipo especificado que ocurren en el mismo momento
363 musical que la propia instrucción de sobreescritura @code{\override}.
365 La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
366 el elemento inmediatamente siguiente dentro del flujo de entrada.
367 En su forma más sencilla es efectivo solamente sobre objetos
368 que se crean directamente
369 a partir del elemento siguiente, en esencia las cabezas y las
372 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
373 se cambiaría de la siguiente forma:
375 @cindex font-size, propiedad, ejemplo
376 @cindex @code{\tweak}, ejemplo
378 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
380 <c \tweak #'font-size #-3 e g>4
383 Observe que la sintaxis de @code{\tweak} no es igual que la de
384 @code{\override}. El contexto no se
385 debe especificar; de hecho, generaría un error hacerlo.
386 Tanto el contexto como el objeto de presentación
387 están implícitos por el siguiente elemento del flujo de entrada.
388 Observe también que no debe haber un signo igual. Así que la sintaxis
389 de la instrucción @code{\tweak} en su forma sencilla es:
392 \tweak #'@var{propiedad-de-presentación} #@var{valor}
395 Una instrucción @code{\tweak} también se puede usar para modificar
396 sólo una de una serie de articulaciones, como se muestra aquí:
398 @cindex color, propiedad, ejemplo
399 @cindex @code{\tweak}, ejemplo
401 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
403 -\tweak #'color #red ^"Red"
404 -\tweak #'color #green _"Green"
408 Observe que la instrucción @code{\tweak} debe venir precedida de una
409 marca de articulación porque la propia expresión trucada debe aplicarse
410 como una articulación. En el caso de más de una sobreescritura de dirección
411 (@code{^} o @code{_}), gana la sobreescritura situada más a la izquierda
412 porque se aplica en último lugar.
414 @cindex @code{\tweak}, Accidental
415 @cindex @code{\tweak}, specific layout object
417 Los objetos tales como plicas y alteraciones accidentales se crean más
418 tarde, y no directamente a partir del evento que viene a continuación.
419 Aún es posible utilizar @code{\tweak} sobre tales objetos creados
420 indirectamente mediante el nombrado explícito del objeto de
421 presentación, siempre y cuando LilyPond pueda rastrear su origen hasta
424 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
425 <\tweak Accidental #'color #red cis4
426 \tweak Accidental #'color #green es
430 Esta forma extensa de la instrucción @code{\tweak} se puede describir
433 \tweak @var{layout-object} #'@var{layout-property} @var{value}
436 @cindex grupos especiales anidados
437 @cindex tresillos anidados
438 @cindex corchete del grupo especial
439 @cindex corchete de tresillo
440 @cindex grupo especial, corchete de
441 @cindex tresillo, corchete de
443 @funindex TupletBracket
445 La instrucción @code{\tweak} también se debe usar para cambiar la
446 apariencia de uno solo de un conjunto de grupos especiales anidados
447 que comiencen en el mismo instante musical. En el siguiente ejemplo,
448 el corchete del tresillo largo y el primero de los tres corchetes
449 cortos empiezan en el mismo momento musical, y por ello cualquier
450 instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
451 usa @code{\tweak} para distinguir entre ellos. La primera instrucción
452 @code{\tweak} especifica que el corchete del tresillo largo se debe
453 colocar por encima de las notas y el segundo especifica que el número
454 del tresillo se debe imprimir en rojo sobre el corchete del primer
457 @cindex @code{\tweak}, ejemplo
458 @cindex direction, propiedad, ejemplo
459 @cindex color, propiedad, ejemplo
461 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
462 \tweak #'direction #up
465 \times 2/3 { c8[ c c] }
466 \times 2/3 { c8[ c c] }
467 \times 2/3 { c8[ c c] }
471 Si los grupos anidados no comienzan en el mismo momento, su apariencia
472 se puede modificar de la forma usual mediante instrucciones
475 @cindex text, propiedad, ejemplo
476 @cindex tuplet-number, función, ejemplo
477 @cindex transparent, propiedad, ejemplo
478 @cindex TupletNumber, ejemplo de sobreescritura
480 @c NOTE Tuplet brackets collide if notes are high on staff
482 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
483 \times 2/3 { c8[ c c] }
484 \once \override TupletNumber
485 #'text = #tuplet-number::calc-fraction-text
489 \once \override TupletNumber #'transparent = ##t
490 \times 2/3 { c8[ c c] }
491 \times 2/3 { c8[ c c] }
497 Referencia de la notación:
498 @ruser{La instrucción tweak}.
501 @node Manual de referencia de funcionamiento interno
502 @section Manual de referencia de funcionamiento interno
503 @translationof The Internals Reference manual
505 @cindex Internals Reference
508 * Propiedades de los objetos de presentación::
509 * Propiedades de los interfaces::
510 * Tipos de propiedades::
513 @node Propiedades de los objetos de presentación
514 @subsection Propiedades de los objetos de presentación
515 @translationof Properties of layout objects
517 @cindex propiedades de los objetos de presentación
518 @cindex propiedades de los grobs
519 @cindex grobs, propiedades de
520 @cindex presentación, propiedades de los objetos de
521 @cindex Referencia de funcionamiento interno
523 Suponga que tiene una partitura con una ligadura de expresión que para
524 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
525 debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
526 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
527 piensa que una cierta instrucción de sobreescritura @code{\override}
528 será necesaria. Pero ¿existe una propiedad de grosor para las
529 ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
530 interviene el Manual de Funcionamiento Interno. Contiene toda la
531 información que puede necesitar para construir ésta y todas las demás
532 instrucciones @code{\override}, de sobreescritura.
534 Una advertencia antes de dirigir nuestra mirada a la referencia de
535 funcionamiento interno. Éste es un documento de @strong{referencia},
536 lo que significa que hay pocas o ninguna explicación en él: su
537 propósito es presentar la información de forma precisa y concisa. Por
538 tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
539 La guía y las explicaciones que presentamos aquí le permitirán extraer
540 la información de la referencia de funcionamiento interno por sí mismo
541 con tan sólo algo de práctica.
543 @cindex sobreescritura, ejemplo de
544 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
545 @cindex @code{\addlyrics}, ejemplo
548 Utilicemos un ejemplo concreto con un sencillo fragmento de música
551 @c Mozart, dúo, núm. 7 de La Flauta Mágica
553 @lilypond[quote,verbatim,relative=2]
558 r4 bes8 bes[( g]) g |
559 g8[( es]) es d[( f]) as |
563 The man who | feels love's sweet e -- | mo -- tion
568 Suponga ahora que decidimos que nos gustan las ligaduras algo más
569 gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
570 presentación, así que la cuestión es @q{¿Hay una propiedad
571 perteneciente a las ligaduras de expresión que controle su grosor?}
572 Para responder a esta pregunta debemos mirar el manual de Referencia
573 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
574 (Internals Reference) en inglés}.
576 El RFI de la versión de LilyPond que está usando se puede encontrar en
577 la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
578 página de la documentación y siga el enlace Manual de Referencia de
579 Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
580 sería mejor que utilizase la versión en HTML, no la @q{en una sola
581 página} ni el PDF. Para que los siguientes párrafos tengan algún
582 sentido deberá consultarlo realmente al tiempo que lee.
584 @c Link names in English as those pages are not yet translated. FV
585 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
586 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
587 información sobre los objetos de presentación. Una vez allí, bajo el
588 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
589 objects}. La página que aparece relaciona todos los objetos de
590 presentación que se usan en su versión de LilyPond, en orden
591 alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
592 relacionadas las propiedades de las ligaduras de expresión o Slurs.
594 Una forma alternativa de encontrar esta página es a partir de la
595 Referencia de la Notación. En una de las páginas que tratan de las
596 ligaduras de expresión podrá encontrar un enlace al manual de
597 referencia del funcionamiento interno. Este enlace le llevará
598 directamente a esta página, aunque si tiene una idea del nombre del
599 objeto de presentación que pretende trucar, le resultará más fácil ir
600 directamente al RFI y buscar allí.
602 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
603 dice en primer lugar que los objetos Slur se crean por el grabador
604 Slur_engraver. A continuación relaciona los ajustes estándar.
605 Observe que @strong{no} están en orden alfabético. Navegue hacia
606 abajo buscando una propiedad que pudiera controlar el grosor de las
607 ligaduras, y encontrará
610 @code{thickness} (number)
612 Line thickness, generally measured in @code{line-thickness}
615 Esto promete ser una buena opción para cambiar el grosor. Nos dice
616 que el valor de @code{thickness} es un simple @emph{número}, que el
617 valor predeterminado es 1.2, y que las unidades están dentro de otra
618 propiedad llamada @code{line-thickness}.
620 Como dijimos con anterioridad, existen entre pocas y ninguna
621 explicación en el RFI, pero ya tenemos información suficiente para
622 probar a cambiar el grosor de la ligadura. Vemos que el nombre del
623 objeto de presentación es @code{Slur}, que el nombre de la propiedad
624 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
625 un número algo más grande que 1.2 si queremos hacer las ligaduras más
628 Ahora podemos construir la instrucción de sobreescritura
629 @code{\override} simplemente mediante la sustitución de los valores
630 que hemos encontrado para los nombres, omitiendo el contexto.
631 Usaremos un valor muy grande para el grosor al principio, para estar
632 seguros de que la instrucción está funcionando. Obtenemos lo
636 \override Slur #'thickness = #5.0
639 ¡No olvide el @code{#'} antes del nombre de la propiedad y@tie{}@code{#}
640 antes del valor nuevo!
642 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
643 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
644 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
645 cerca de ella.} Hagámoslo así:
647 @cindex Slur, ejemplo de sobreescritura
648 @cindex thickness, propiedad, ejemplo
650 @lilypond[quote,verbatim,relative=2]
655 % Increase thickness of all following slurs from 1.2 to 5.0
656 \override Slur #'thickness = #5.0
657 r4 bes8 bes[( g]) g |
658 g8[( es]) es d[( f]) as |
662 The man who | feels love's sweet e -- | mo -- tion
668 y podemos ver que la ligadura, es sin duda, más pesada.
670 Así pues, ésta es la forma básica de construir instrucciones
671 @code{\override} o de sobreescritura. Existen unas cuantas
672 complicaciones más con las que nos encontraremos en secciones
673 posteriores, pero ahora conoce todos los principios esenciales que
674 necesita para hacerlo por sí mismo (aunque aún necesita algo de
675 práctica). La cual vendrá proporcionada por los ejemplos que vienen a
678 @subheading Búsqueda del contexto
680 @cindex contexto, encontrar
681 @cindex contexto, buscar el, correcto
683 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
684 especificar el contexto? ¿Cuál sería? Podemos suponer que las
685 ligaduras están en el contexto de Voz, por estar claramente asociados
686 de manera estrecha con las líneas individuales de música, pero
687 ¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
688 de la página del RFI que describe las ligaduras (Slur), donde dice
689 @q{Slur objects are created by: Slur engraver} («Los objetos de
690 ligadura de expresión se crean por: el grabador Slur»). Así pues, las
691 ligaduras de expresión se crean en cualquier contexto en el que se
692 encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
693 página del grabador @code{Slur_engraver}. Al final del todo, dice que
694 el grabador @code{Slur_engraver} es parte de cinco contextos de voz,
695 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
696 suposición era acertada. Y a causa de que @code{Voice} es uno de los
697 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
698 por el hecho de que estamos escribiendo notas, podemos omitirlo en
701 @subheading Sobreescritura por una sola vez
703 @cindex sobreescritura por una sola vez
704 @cindex once override
709 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
710 último ejemplo. Pero ¿y si quisiéramos que solamente la primera
711 ligadura fuese más gruesa? Esto se consigue con la instrucción o
712 prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
713 @code{\override} ocasiona que solamente cambie la ligadura que
714 comienza en la nota @strong{inmediata siguiente}. Si la nota
715 inmediata siguiente no da inicio a una ligadura, la instrucción no
716 tiene ningún efecto en absoluto: no se recuerda hasta que se
717 encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
718 la instrucción que lleva @code{\once} se debe reposicionar de la forma
721 @cindex Slur, ejemplo de sobreescritura
722 @cindex thickness, propiedad, ejemplo
724 @lilypond[quote,verbatim,relative=2]
730 % Increase thickness of immediately following slur only
731 \once \override Slur #'thickness = #5.0
733 g8[( es]) es d[( f]) as |
737 The man who | feels love's sweet e -- | mo -- tion
743 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
745 La instrucción o prefijo @code{\once} también se puede usar antes de
746 la instrucción @code{\set}.
748 @subheading Recuperación del ajuste
751 @cindex predeterminadas, recuperar las propiedades
756 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
757 fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
758 una de ellas precedida por el prefijo @code{\once}, situadas
759 inmediatamente antes de cada una de las notas en que comienzan las
762 @cindex Slur, ejemplo de sobreescritura
763 @cindex thickness, propiedad, ejemplo
765 @lilypond[quote,verbatim,relative=2]
771 % Increase thickness of immediately following slur only
772 \once \override Slur #'thickness = #5.0
774 % Increase thickness of immediately following slur only
775 \once \override Slur #'thickness = #5.0
776 g8[( es]) es d[( f]) as |
780 The man who | feels love's sweet e -- | mo -- tion
786 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
787 instrucción @code{\revert} (restablecer) para devolver la propiedad
788 del grosor, @code{thickness}, a su valor predeterminado después de la
791 @cindex Slur, ejemplo de sobreescritura
792 @cindex thickness, propiedad, ejemplo
794 @lilypond[quote,verbatim,relative=2]
800 % Increase thickness of all following slurs from 1.2 to 5.0
801 \override Slur #'thickness = #5.0
804 % Revert thickness of all following slurs to default of 1.2
805 \revert Slur #'thickness
810 The man who | feels love's sweet e -- | mo -- tion
816 la instrucción @code{\revert} se puede utilizar para devolver
817 cualquier propiedad que se haya cambiado con @code{\override} a su
818 valor predeterminado. Puede utilizar el método que mejor se adapte a
819 aquello que quiere hacer.
821 Así finaliza nuestra introducción al manual de RFI, y el método básico
822 de trucaje. A continuación, en las últimas secciones de este capítulo
823 encontrará varios ejemplos, en parte para introducirle en algunas de
824 las posibilidades adicionales del manual RFI, y en parte para
825 proporcionarle más práctica en cómo extraer información de él. Estos
826 ejemplos irán conteniendo cada vez menos palabras de guía y
829 @node Propiedades de los interfaces
830 @subsection Propiedades de los interfaces
831 @translationof Properties found in interfaces
834 @cindex propiedades de los interfaces
835 @cindex interfaces, propiedades
837 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
838 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
839 En primer lugar miramos en la página del RFI que relaciona todos los
840 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
841 pueda controlar la letra de la canción. Encontramos @code{LyricText},
842 que parece adecuado. Al seguir este enlace se presentan las
843 propiedades ajustables para el texto de la letra. Estos incluyen
844 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
845 una forma cursiva. Esto es porque la propiedad de la forma es común a
846 todos los objetos de fuente tipográfica, y por tanto, en vez de
847 incluirlo en cada uno de los objetos de presentación, se agrupa junto
848 con otras propiedades comunes similares y se deposita en un
849 @strong{Interface}, el interface de las fuentes tipográficas
850 @code{font-interface}.
852 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
853 de los interfaces, y descubrir qué objetos usan estas propiedades de
856 Mire de nuevo la página del RFI que describe a LyricText. Al final de
857 la página hay una lista de enlaces a los interfaces que LyricText
858 contempla. La lista tiene siete elementos, entre ellos
859 @code{font-interface}. Al seguir este enlace llegamos a las
860 propiedades asociadas con este interface, que también son propiedades
861 de todos los objetos que lo llevan, entre ellos LyricText.
863 Ahora vemos todas las propiedades ajustables por el usuario que
864 controlan las tipografías, entre ellas @code{font-shape(symbol)},
865 donde @code{symbol} se puede establecer a @code{upright} (recta),
866 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
868 Observará que @code{font-series} y @code{font-size} también se
869 encuentran aquí relacionadas. Esto inmediatamente hace que surja la
870 pregunta: ¿Por qué están las propiedades comunes de tipografía
871 @code{font-series} y @code{font-size} relacionadas bajo
872 @code{LyricText} así como bajo el interface @code{font-interface} pero
873 @code{font-shape} no lo está? La respuesta es que @code{font-series}
874 y @code{font-size} se cambian a partir de sus valores predeterminados
875 globales cuando se crea un objeto @code{LyricText}, pero
876 @code{font-shape} no lo hace. Entonces los elementos de la lista
877 @code{LyricText} le dicen los valores para esas dos propiedades que
878 son de aplicación para @code{LyricText}. Otros objetos que contemplan
879 @code{font-interface} establecerán dichas propiedades de forma
880 diferente cuando se crean.
882 Veamos si ahora podemos construir la instrucción @code{\override} para
883 cambiar la letra a cursiva. El objeto es @code{LyricText}, la
884 propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
885 antes, omitiremos el contexto.
887 Como nota aparte, aunque una nota importante, observe que a causa de
888 que los valores de @code{font-shape} son símbolos, deben ir precedidos
889 de un apóstrofo, @code{'}. Esa es la razón por la que se necesitan
890 apóstrofos antes de @code{thickness} en el ejemplo anterior y en
891 @code{font-shape}. Los dos son también símbolos. Los símbolos son
892 nombres especiales que son conocidos por LilyPond internamente.
893 Algunos de ellos son nombres de propiedades, como @code{thickness} o
894 @code{font-shape}, otros se utilizan como valores que se les puede dar
895 a las propiedades, como @code{italic}. Observe la distinción entre
896 esto y las cadenas de texto arbitrarias, que aparecerían
897 entrecomilladas como @code{"a text string"}. Para ver más detalles
898 relacionados con los símbolos y las cadenas, consulte
899 @rextend{Tutorial de Scheme}.
901 Así pues, la instrucción @code{\override} necesaria para imprimir la
902 letra en cursiva, es:
905 \override LyricText #'font-shape = #'italic
909 Esto debe escribirse justo delante de la letra a la que debe afectar,
912 @cindex font-shape, propiedad, ejemplo
913 @cindex italic, ejemplo
914 @cindex LyricText, ejemplo de sobreescritura
915 @cindex @code{\addlyrics}, ejemplo
917 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
922 r4 bes8 bes[( g]) g |
923 g8[( es]) es d[( f]) as |
927 \override LyricText #'font-shape = #'italic
928 The man who | feels love's sweet e -- | mo -- tion
934 y toda la letra se imprime en cursiva.
936 @subheading Especificación del contexto en modo letra
938 @cindex contexto, especificación en modo letra
939 @cindex letra, modo, especificar el contexto en
941 En el caso de la letra, si intenta especificar el contexto en el
942 formato que acabamos de dar, la instrucción no funcionará. Una
943 sílaba escrita en el modo letra, «lyricmode» termina en un espacio, un
944 salto de línea o un dígito. Cualquier otro carácter se incluye como
945 parte de la sílaba. Por esta razón, un espacio o salto de línea debe
946 aparecer antes del último símbolo @code{@}} para evitar que se incluya
947 como parte de la sílaba final. De forma similar, se deben insertar
948 espacios antes y después del punto, @q{.}, separando el nombre del
949 contexto del nombre del objeto, pues en caso contrario los dos nombres
950 se juntarán y el intérprete no podrá reconocerlos. Así pues, la
954 \override Lyrics . LyricText #'font-shape = #'italic
957 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
958 final y la llave de cierre.}
960 @warning{En las sobreescrituras con override dentro de la letra,
961 escriba siempre espacios antes y después del punto que separa el
962 nombre del contexto y el nombre del objeto.}
967 @rextend{Tutorial de Scheme}.
970 @node Tipos de propiedades
971 @subsection Tipos de propiedades
972 @translationof Types of properties
974 @cindex propiedades, tipos de
976 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
977 @code{símbolo}. Para que sea válido, el valor que se da a una
978 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
979 tipo. El tipo de la propiedad se muestra siempre entre paréntesis
980 después del nombre de la propiedad en el RFI. He aquí una lista de
981 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
982 algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
983 @code{#}, por supuesto, delante de estos valores cuando se introducen
984 en la instrucción @code{\override}.
986 @multitable @columnfractions .2 .45 .35
987 @headitem Tipo de propiedad
991 @tab Verdadero o Falso, representado por #t o #f
992 @tab @code{#t}, @code{#f}
993 @item Dimensión (en espacios de pentagrama)
994 @tab Un número decimal positivo (en unidades de espacios de pentagrama)
995 @tab @code{2.5}, @code{0.34}
997 @tab Una constante válida de dirección o su equivalente numérico (se permiten valores decimales entre -1 y 1)
998 @tab @code{LEFT}, @code{CENTER}, @code{UP},
999 @code{1}, @w{@code{-1}}
1001 @tab Un número entero positivo
1002 @tab @code{3}, @code{1}
1004 @tab Un conjunto de valores separados por espacios, encerrado entre paréntesis y precedido de un apóstrofo
1005 @tab @code{'(left-edge staff-bar)}, @code{'(1)},
1006 @code{'(1.0 0.25 0.5)}
1008 @tab Cualquier elemento válido de marcado de texto
1009 @tab @code{\markup @{ \italic "cresc." @}}
1011 @tab Una fracción de redonda construida con la función make-moment
1012 @tab @code{(ly:make-moment 1 4)},
1013 @code{(ly:make-moment 3 8)}
1015 @tab Cualquier valor decimal positivo o negativo
1016 @tab @code{3.5}, @w{@code{-2.45}}
1017 @item Pareja (de números)
1018 @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
1019 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
1021 @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
1022 @tab @code{'italic}, @code{'inside}
1024 @tab Un procedimiento o @code{#f} para no producir ninguna acción
1025 @tab @code{bend::print}, @code{ly:text-interface::print},
1028 @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofo-almohadilla, @code{'#}.
1029 @tab @code{'#(#t #t #f)}
1034 Manual de Extensión:
1035 @rextend{Tutorial de Scheme}.
1038 @node Apariencia de los objetos
1039 @section Apariencia de los objetos
1040 @translationof Appearance of objects
1042 Ahora vamos a poner en práctica lo que hemos aprendido con unos
1043 cuantos ejemplos que muestran cómo se pueden usar los trucos para
1044 cambiar el aspecto de la música impresa.
1047 * Visibilidad y color de los objetos::
1048 * Tamaño de los objetos::
1049 * Longitud y grosor de los objetos::
1052 @node Visibilidad y color de los objetos
1053 @subsection Visibilidad y color de los objetos
1054 @translationof Visibility and color of objects
1056 Dentro de un uso educativo de la música, podríamos desear imprimir una
1057 partitura con ciertos elementos omitidos como ejercicio para el
1058 alumno, a quien se le pide que los complete. A la manera de ejemplo
1059 sencillo, supongamos que el ejercicio es escribir las líneas
1060 divisorias que faltan en un fragmento musical. Pero las líneas
1061 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
1064 Antes de enredarnos con esto, recordemos que las propiedades de los
1065 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
1066 @ref{Propiedades de los interfaces}). Esto es simplemente agrupar
1067 las propiedades que se pueden usar juntas para trucar un objeto
1068 gráfico: si una de ellas se necesita para un objeto, también las
1069 otras. Así, ciertos objetos usan las propiedades de algunos
1070 interfaces, otros usan las de otros interfaces. Los interfaces que
1071 contienen las propiedades que un determinado grob necesita se
1072 encuentran relacionadas en el manual RFI al final de la página que
1073 describe dicho grob, y esas propiedades se pueden ver mirando dichos
1076 Hemos explicado cómo encontrar información sobre los grobs en
1077 @ref{Propiedades de los objetos de presentación}. Usando el mismo
1078 enfoque, vamos al RFI para buscar el objeto de presentación que
1079 imprime las líneas divisorias. A través del enlace @emph{Backend} y
1080 @emph{All layout objects} encontramos que hay un objeto de
1081 presentación llamado @code{BarLine}. Entre sus propiedades se
1082 encuentran dos que controlan la visibilidad: @code{break-visibility} y
1083 @code{stencil}. Las líneas divisorias también contemplan un número de
1084 interfaces, entre ellos el @code{grob-interface}, donde podemos
1085 encontrar las propiedades @code{transparent} y @code{color}. Todas
1086 ellas pueden afectar la visibilidad de las barras de compás (y, por
1087 supuesto, por extensión, también la de muchos otros objetos de
1088 presentación). Vamos a considerar cada uno de ellos por orden.
1090 @subheading stencil (sello)
1092 @cindex stencil (sello), propiedad
1094 Esta propiedad controla la apariencia de las barras de compás mediante
1095 la especificación del símbolo (o «glifo») que se debe imprimir. Igual
1096 que como otras muchas propiedades, se puede establecer de forma que no
1097 imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
1098 antes, omitiendo el Contexto implícito, @code{Voice}:
1100 @cindex BarLine, ejemplo de sobreescritura
1101 @cindex stencil, propiedad, ejemplo
1103 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1106 \override BarLine #'stencil = ##f
1108 g,8 a16 b8 c d4 e16 |
1113 Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
1114 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
1115 objeto BarLine. Al principio de la página dice @qq{Barline objects
1116 are created by: Bar_engraver} (los objetos Barline se crean por el
1117 grabador Bar_engraver). Vaya a la página del grabador
1118 @code{Bar_engraver} siguiendo el enlace. Al final da una lista de
1119 contextos en los que el grabador de líneas divisorias opera. Todos
1120 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
1121 @code{\override} no funcionara como esperábamos, es porque
1122 @code{Barline} no se encuentra en el contexto predeterminado
1123 @code{Voice}. Si el contexto no se especifica correctamente, la
1124 instrucción simplemente no funciona. No se produce ningún mensaje de
1125 error, y no se registra nada en el archivo log de registro. Vamos a
1126 intentar corregirlo escribiendo el contexto correcto:
1128 @cindex BarLine, ejemplo de sobreescritura
1129 @cindex stencil, propiedad, ejemplo
1131 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1134 \override Staff.BarLine #'stencil = ##f
1136 g,8 a16 b8 c d4 e16 |
1141 Ahora las barras de compás han desaparecido.
1143 Sin embargo, observe que el establecimiento de la propiedad
1144 @code{stencil} al valor @code{#f} produce errores cuando las se
1145 requieren las dimensiones del objeto para un procesamiento correcto.
1146 Por ejemplo, se generan errores si la propiedad @code{stencil} del
1147 objeto @code{NoteHead} se establece al valor @code{#f}. Si es el
1148 caso, podemos en vez de ello utilizar la función @code{point-stencil},
1149 que establece el sello a un objeto con tamaño nulo:
1151 @lilypond[quote,verbatim,relative=2]
1154 \once \override NoteHead #'stencil = #point-stencil
1159 @subheading break-visibility (visibilidad en el salto)
1161 @cindex break-visibility, propiedad
1163 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI que
1164 la propiedad @code{break-visibility} requiere un vector de tres
1165 valores booleanos. Controlan respectivamente si las barras de compás
1166 se imprimen al final de una línea, en mitad de una línea, y al
1167 principio de las líneas. Para nuestro ejemplo, queremos que todas las
1168 barras de compás se supriman, por lo que el valor que necesitamos es
1169 @code{'#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
1170 de @code{Staff}. Observe también que al escribir este valor tenemos
1171 @code{#'#} antes del paréntesis de apertura. Se necesita @code{'#}
1172 como parte del valor para introducir un vector, y el primer símbolo de
1173 almohadilla@tie{}@code{#} se necesita, como siempre, para preceder el valor
1174 en sí dentro de la instrucción @code{\override}.
1176 @cindex BarLine, ejemplo de sobreescritura
1177 @cindex break-visibility, propiedad, ejemplo
1179 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1182 \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
1184 g,8 a16 b8 c d4 e16 |
1189 Y podemos ver que esto también quita todas las líneas divisorias.
1191 @subheading transparent (transparente)
1193 @cindex transparent, propiedad
1194 @cindex transparencia
1196 En la relación de propiedades que se especifican en la página del
1197 @code{grob-interface} del RFI podemos ver que la propiedad
1198 @code{transparent} es un valor booleano. Esto se debe establecer a
1199 @code{#t} para hacer que el grob sea transparente. En el ejemplo
1200 siguiente vamos a hacer que la indicación de compás, y no las líneas
1201 divisorias, sea transparente. Para hacerlo tenemos que buscar el
1202 nombre del grob de la indicación de compás. Volviendo a la página
1203 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1204 presentación @code{TimeSignature}. Se produce por parte del grabador
1205 @code{Time_signature_engraver} que como puede comprobar vive dentro
1206 del contexto de @code{Staff} y también contempla el interface
1207 @code{grob-interface}. Así pues, la instrucción que hace transparente
1208 a la indicación de compás es:
1210 @cindex TimeSignature, ejemplo de sobreescritura
1211 @cindex transparent, propiedad, ejemplo
1213 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1216 \override Staff.TimeSignature #'transparent = ##t
1218 g,8 a16 b8 c d4 e16 |
1224 El compás ya no está, pero esta instrucción deja una separación en el
1225 lugar donde antes estaba la indicación de compás. Quizá esto es lo
1226 que queremos para un ejercicio en que el alumno deba escribirlo, pero
1227 en otras circunstancias esta separación podría no ser deseable. En
1228 vez de eso, para quitarla, el stencil o «sello» de la indicación de
1229 compás se debe establecer al valor @code{#f}:
1231 @cindex TimeSignature, ejemplo de sobreescritura
1232 @cindex stencil, propiedad, ejemplo
1234 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1237 \override Staff.TimeSignature #'stencil = ##f
1239 g,8 a16 b8 c d4 e16 |
1245 y la diferencia es obvia: al establecer el sello al valor @code{#f}
1246 quitamos el objeto por completo; al hacer el objeto @code{transparent}
1247 lo dejamos donde está, pero lo hacemos invisible.
1251 @cindex color, propiedad
1253 Para finalizar, intentemos hacer invisibles las barras de compás
1254 pintándolas de color blanco (hay un problema relacionado, que consiste
1255 en que la línea divisoria blanca puede tapar o no tapar las líneas del
1256 pentagrama a las que cruza. Podrá observar en algunos de los ejemplos
1257 que aparecen a continuación, que esto sucede de forma impredecible.
1258 Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
1259 estudian en @ruser{Pintar los objetos de blanco}; de momento estamos
1260 estudiando el color, por lo que le rogamos que acepte esta limitación
1263 El interface @code{grob-interface} especifica que la propiedad del
1264 color es una lista, pero no hay ninguna explicación sobre lo que debe
1265 ir en esa lista. La lista que requiere es realmente una lista de
1266 valores en unidades internas, pero para evitar tener que saber cuáles
1267 son, se ofrecen varias vías para la especificación de los colores. La
1268 primera forma es utilizar uno de los colores @q{normales} que están
1269 relacionados en la primera tabla de la @ruser{Lista de colores}. Para
1270 poner las líneas divisorias de color blanco, escribimos:
1272 @cindex BarLine, ejemplo de sobreescritura
1273 @cindex color, propiedad, ejemplo
1275 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1278 \override Staff.BarLine #'color = #white
1280 g,8 a16 b8 c d4 e16 |
1286 y de nuevo podemos comprobar que las barras de compás no son visibles.
1287 Observe que @emph{white} no viene precedido de un apóstrofo: no es un
1288 símbolo, sino una @emph{función}. Cuando se invoca, proporciona la
1289 lista de valores internos que se requieren para establecer el color a
1290 blanco. Los otros colores de la lista normal también son funciones.
1291 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1292 una de las otras funciones de la lista.
1294 @cindex colores de X11
1295 @cindex X11, colores de
1299 La segunda forma de cambiar el color es utilizar la lista de nombres
1300 de colores de X11 que aparecen en la segunda lista de @ruser{Lista de
1301 colores}. Sin embargo, éstos deben ir precedidos de otra función, que
1302 convierte los nombres de colores de X11 en la lista de valores
1303 internos, @code{x11-color}, de la siguiente manera:
1305 @cindex BarLine, ejemplo de sobreescritura
1306 @cindex color, propiedad, ejemplo
1308 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1311 \override Staff.BarLine #'color = #(x11-color 'white)
1313 g,8 a16 b8 c d4 e16 |
1319 Observe que en este caso la función @code{x11-color} toma un símbolo
1320 como argumento, así que el símbolo debe ir precedido de un apóstrofo y
1321 los dos deben ir entre paréntesis.
1323 @cindex rgb, colores
1328 Aún hay una tercera función, que convierte valores RGB en colores
1329 internos: la función @code{rgb-color}. Toma tres argumentos que dan
1330 las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
1331 valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
1332 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1333 @code{(rgb-color 1 1 1)}:
1335 @cindex BarLine, ejemplo de sobreescritura
1336 @cindex color, propiedad, ejemplo
1338 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1341 \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1343 g,8 a16 b8 c d4 e16 |
1348 Finalmente, existe también una escala de grises como parte del
1349 conjunto de colores de X11. Varían desde el negro, @code{'grey0'},
1350 hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
1351 estableciendo todos los objetos de presentación de nuestro ejemplo a
1352 varias gradaciones de gris:
1354 @cindex StaffSymbol, ejemplo de sobreescritura
1355 @cindex TimeSignature, ejemplo de sobreescritura
1356 @cindex Clef, ejemplo de sobreescritura
1357 @cindex NoteHead, ejemplo de sobreescritura
1358 @cindex Stem, ejemplo de sobreescritura
1359 @cindex BarLine, ejemplo de sobreescritura
1360 @cindex color property, ejemplo
1361 @cindex x11-color, ejemplo de utilización
1363 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1366 \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
1367 \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1368 \override Staff.Clef #'color = #(x11-color 'grey60)
1369 \override Voice.NoteHead #'color = #(x11-color 'grey85)
1370 \override Voice.Stem #'color = #(x11-color 'grey85)
1371 \override Staff.BarLine #'color = #(x11-color 'grey10)
1373 g,8 a16 b8 c d4 e16 |
1379 Observe los contextos asociados con cada uno de los objetos de
1380 presentación. Es importante que estén correctamente escritos, o las
1381 instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
1382 que se encuentra el grabador correspondiente. El contesto
1383 predeterminado para los grabadores puede encontrarse empezando por el
1384 objeto de presentación, de ahí al grabador que lo produce, y en la
1385 página del grabador del RFI aparece en qué contexto se puede encontrar
1386 normalmente el grabador.
1389 @node Tamaño de los objetos
1390 @subsection Tamaño de los objetos
1391 @translationof Size of objects
1393 @cindex cambiar el tamaño de los objetos
1394 @cindex tamaño de los objetos
1395 @cindex objetos, tamaño de
1396 @cindex objetos, cambiar el tamaño de
1398 Empezaremos examinando de nuevo un ejemplo anterior (véase
1399 @ref{Anidado de expresiones musicales}) que nos mostraba cómo introducir un
1400 pentagrama temporal, como en un @rglos{ossia}.
1402 @cindex alignAboveContext, propiedad, ejemplo
1403 @cindex @code{\with}, ejemplo
1405 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1406 \new Staff ="main" {
1413 alignAboveContext = #"main" }
1421 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1422 por lo normal se imprimen más pequeños que el pentagrama principal.
1423 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1424 el sello de cada uno de ellos a @code{#f}, como sigue:
1426 @cindex alignAboveContext, propiedad, ejemplo
1427 @cindex @code{\with}, ejemplo
1428 @cindex stencil, propiedad, ejemplo
1429 @cindex Clef, ejemplo de sobreescritura
1430 @cindex TimeSignature, ejemplo de sobreescritura
1432 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1433 \new Staff ="main" {
1440 alignAboveContext = #"main"
1443 \override Staff.Clef #'stencil = ##f
1444 \override Staff.TimeSignature #'stencil = ##f
1454 donde el par de llaves adicional después de la cláusula @code{\with}
1455 es necesario para asegurar que la sobreescritura encerrada y la música
1456 se aplican al pentagrama de ossia.
1458 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1459 usando @code{\with} y modificar los sellos de clave y de compás con
1460 \override? La diferencia principal es que los cambios que se realizan
1461 en una cláusula @code{\with} se hacen en el momento en que se crea el
1462 contexto, y permanecen activos como valores @strong{predeterminados}
1463 durante toda la duración de dicho contexto, mientras que las
1464 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1465 música son dinámicas: hacen cambios sincronizados con un punto
1466 concreto de la música. Si los cambios se deshacen o se devuelven
1467 mediante @code{\unset} o @code{\revert} volverán a su valor
1468 predeterminado que será el establecido en la cláusula @code{\with}, o
1469 si no se ha establecido ninguno en este lugar, los valores
1470 predeterminados normales.
1472 Ciertas propiedades de contexto se pueden modificar solamente dentro
1473 de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
1474 cambiar después de que el contexto se ha creado.
1475 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1476 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1477 alineación está decidida y no tendría sentido intentar cambiarla más
1480 Los valores predeterminados de las propiedades de los objetos de
1481 presentación también se pueden establecer dentro de cláusulas
1482 @code{\with}. Simplemente utilice la instrucción @code{\override}
1483 normal dejando aparte el nombre del contexto, ya que está definido sin
1484 ambigüedad como el contexto que la cláusula @code{\with} está
1485 modificando. De hecho, se producirá un error si se especifica un
1486 contexto en este lugar.
1488 Así pues, podemos reemplazar el ejemplo anterior con
1490 @cindex alignAboveContext, propiedad, ejemplo
1491 @cindex @code{\with}, example
1492 @cindex Clef, ejemplo de sobreescritura
1493 @cindex TimeSignature, ejemplo de sobreescritura
1495 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1496 \new Staff ="main" {
1503 alignAboveContext = #"main"
1504 % Don't print clefs in this staff
1505 \override Clef #'stencil = ##f
1506 % Don't print time signatures in this staff
1507 \override TimeSignature #'stencil = ##f
1516 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1519 Ciertos objetos de presentación se crean como glifos sacados de una
1520 fuente tipográfica. Entre ellos se encuentran las cabezas,
1521 alteraciones, elementos de marcado, claves, indicaciones de compás,
1522 indicaciones dinámicas y la letra de las canciones. Su tamaño se
1523 cambia mediante la modificación de la propiedad @code{font-size}, como
1524 veremos en breve. Otros objetos de presentación como ligaduras de
1525 unión y de expresión (en general, objetos de extensión) se trazan
1526 individualmente, por lo que no hay un tamaño de tipografía
1527 @code{font-size} asociado a ellos. Estos objetos generalmente derivan
1528 su tamaño de los objetos a los que están adosados, y por ello
1529 normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
1530 otras propiedades como la longitud de las plicas y las barras de
1531 compás, el grosor de las barras de corchea y otras líneas, y la
1532 separación de las líneas del pentagrama se deben modificar de otras
1535 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1536 tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
1537 cambiar el tamaño de las tipografías de cada uno de los tipos de
1538 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1541 \override NoteHead #'font-size = #-2
1544 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1545 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1546 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1553 Los dos enunciados producirían una reducción del tamaño de la
1554 tipografía en dos pasos a partir de su valor previo, donde cada paso
1555 reduce o aumenta el tamaño aproximadamente en un 12%.
1557 Vamos a probarlo en nuestro ejemplo del ossia:
1559 @cindex alignAboveContext, propiedad, ejemplo
1560 @cindex @code{\with}, ejemplo
1561 @cindex Clef, ejemplo de sobreescritura
1562 @cindex TimeSignature, ejemplo de sobreescritura
1563 @cindex fontSize, propiedad, ejemplo
1565 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1566 \new Staff ="main" {
1573 alignAboveContext = #"main"
1574 \override Clef #'stencil = ##f
1575 \override TimeSignature #'stencil = ##f
1576 % Reduce all font sizes by ~24%
1586 Aún no está demasiado bien. Las cabezas y los corchetes de las notas
1587 son más pequeños, pero las plicas son demasiado largas en proporción,
1588 y las líneas del pentagrama están demasiado separadas entre sí. Se
1589 debe reducir su escala en proporción a la reducción de la tipografía.
1590 El siguiente apartado trata sobre cómo se hace esto.
1592 @node Longitud y grosor de los objetos
1593 @subsection Longitud y grosor de los objetos
1594 @translationof Length and thickness of objects
1600 @cindex tamaño, cambiar
1601 @cindex plica, cambiar la longitud
1602 @cindex pentagrama, cambiar la separación de las líneas
1604 Las distancias y longitudes en LilyPond se miden generalmente en
1605 espacios de pentagrama, la distancia entre líneas adyacentes de la
1606 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1607 de las propiedades de @code{thickness} (grosor) se miden en unidades
1608 de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
1609 de forma predeterminada, a las líneas de los reguladores se les da un
1610 grosor de 1 unidad de @code{line-thickness}, mientras que el
1611 @code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
1612 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1613 barras de corchea se controla por medio del valor de
1614 @code{beam-thickness}, que se mide en espacios de pentagrama.
1616 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1617 tamaño de la tipografía? Se puede hacer con la ayuda de una función
1618 especial que se llama @code{magstep}, pensada especialmente para este
1619 propósito. Toma un argumento, el cambio de tamaño de la tipografía
1620 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1621 para reducir otros objetos en la misma proporción. Se usa de la
1624 @cindex alignAboveContext, propiedad, ejemplo
1625 @cindex @code{\with}, ejemplo
1626 @cindex Clef, ejemplo de sobreescritura
1627 @cindex TimeSignature, ejemplo de sobreescritura
1628 @cindex fontSize, propiedad, ejemplo
1629 @cindex StaffSymbol, ejemplo de sobreescritura
1630 @cindex magstep, función, ejemplo de utilización
1631 @cindex staff-space, propiedad, ejemplo
1632 @cindex stencil, propiedad, ejemplo
1634 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1635 \new Staff ="main" {
1642 alignAboveContext = #"main"
1643 \override Clef #'stencil = ##f
1644 \override TimeSignature #'stencil = ##f
1646 % Reduce stem length and line spacing to match
1647 \override StaffSymbol #'staff-space = #(magstep -2)
1657 Puesto que la longitud de las plicas y muchas otras propiedades
1658 relacionadas con la longitudes calculan siempre con relación al valor
1659 de la propiedad @code{staff-space}, su longitud también ve reducida su
1660 escala automáticamente. Observe que esto afecta solamente a la escala
1661 vertical del ossia: la escala horizontal se determina por medio de la
1662 disposición de la música principal con el objeto de mantenerse en
1663 sincronía con ella, de forma que no resulte afectada por ninguno de
1664 estos cambios de tamaño. Por supuesto, si la escala de toda la música
1665 principal se cambiase de esta forma, entonces el espaciado horizontal
1666 se vería afectado. Trataremos de esto más tarde en la sección sobre
1669 Esto, en fin, completa la creación de un ossia. Los tamaños y
1670 longitudes del resto de los objetos se pueden modificar de manera
1673 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1674 grosor de las diversas líneas dibujadas como divisorias, barras de
1675 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1676 ajuste global. Si el grosor de cualquier objeto de presentación en
1677 particular necesita ajustarse, se puede hacer mejor mediante la
1678 sobreescritura de su propiedad @code{thickness}. Anteriormente
1679 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1680 @ref{Propiedades de los objetos de presentación}. El grosor de todos los objetos
1681 trazados (es decir, aquellos que no se producen a partir de una
1682 tipografía) se pueden cambiar de la misma forma.
1685 @node Colocación de los objetos
1686 @section Colocación de los objetos
1687 @translationof Placement of objects
1690 * Comportamiento automático::
1691 * Objetos interiores al pentagrama::
1692 * Objetos fuera del pentagrama::
1696 @node Comportamiento automático
1697 @subsection Comportamiento automático
1698 @translationof Automatic behavior
1700 @cindex dentro del pentagrama, objetos
1701 @cindex fuera del pentagrama, objetos
1702 @cindex objetos dentro del pentagrama
1703 @cindex objetos fuera del pentagrama
1705 Hay ciertos objetos en notación musical que pertenecen al pentagrama y
1706 otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
1707 objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
1710 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1711 pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
1712 se fijan por la propia música; se posicionan verticalmente sobre
1713 líneas específicas del pentagrama o están unidos a otros objetos
1714 posicionados de esta forma. Las colisiones entre cabezas, plicas y
1715 alteraciones en acordes de notas muy juntas, normalmente se evitan
1716 automáticamente. Hay instrucciones y sobreescrituras que pueden
1717 modificar este comportamiento automático, como veremos en breve.
1719 Entre los objetos que pertenecen al exterior de la pauta se encuentran
1720 cosas como las marcas de ensayo, las marcas de texto y las de
1721 dinámica. La regla de LilyPond para la colocación vertical de los
1722 objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
1723 como sea posible, pero no tan cerca como para que puedan chocar con
1724 algún otro objeto. LilyPond utiliza la propiedad
1725 @code{outside-staff-priority} para determinar el orden en que se deben
1726 situar los objetos, como veremos ahora.
1728 En primer lugar, LilyPond sitúa todos los objetos
1729 dentro-del-pentagrama. Después ordena los objetos
1730 fuera-del-pentagrama de acuerdo con su prioridad
1731 @code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
1732 toman de uno en uno, comenzando por el que tiene la prioridad
1733 @code{outside-staff-priority} más baja, y se sitúan de forma que no
1734 colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
1735 grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
1736 la prioridad @code{outside-staff-priority} más baja se colocará más
1737 cerca del pentagrama. Si dos objetos tienen la misma
1738 @code{outside-staff-priority}, el que se ha encontrado primero se
1739 situará más cerca de la pauta.
1741 En el siguiente ejemplo, todos los textos de marcado tienen la misma
1742 prioridad (pues no se ha establecido explícitamente). Observe que
1743 @q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
1744 acomodado por debajo de @q{Text2}.
1746 @cindex markup, ejemplo
1748 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1755 Los pentagramas también se posicionan, de forma predeterminada, tan
1756 cerca unos de otros como sea posible (sujeto a una separación mínima).
1757 Si las notas se proyectan muy lejos en dirección a un pentagrama
1758 adyacente, forzarán a alejarse a los pentagramas sólo si en caso
1759 contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
1760 siguiente muestra esta acomodación @q{nestling} de las notas sobre
1761 pentagramas adyacentes:
1763 @lilypond[quote,ragged-right,verbatim]
1766 \relative c' { c4 a, }
1769 \relative c'''' { c4 a, }
1775 @node Objetos interiores al pentagrama
1776 @subsection Objetos interiores al pentagrama
1777 @translationof Within-staff objects
1779 Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la
1780 dirección de las ligaduras de expresión y de unión, digitaciones y
1781 todo lo demás que dependa de la dirección de las plicas. Cuando se
1782 escribe música polifónica, estas instrucciones son esenciales para que
1783 puedan distinguirse varias líneas melódicas entrelazadas. Pero
1784 ocasionalmente puede ser necesario sobreescribir este comportamiento
1785 automático. Se puede hacer por secciones de música completas o
1786 incluso para una nota individual. La propiedad que controla este
1787 comportamiento es la propiedad de @code{direction} (dirección) de cada
1788 objeto de presentación. En primer lugar explicaremos qué hace esto, y
1789 luego introduciremos algunas instrucciones listas para usar que le
1790 evitarán tener que codificar sobreescrituras explícitas para las
1791 modificaciones más comunes.
1793 Algunos objetos de presentación como las ligaduras se curvan hacia
1794 arriba o hacia abajo; otros como las plicas y los corchetes también se
1795 mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
1796 hacia abajo. Esto se controla automáticamente cuando está establecida
1797 la propiedad @code{direction}.
1808 El ejemplo siguiente muestra en el compás 1 el comportamiento
1809 predeterminado de las plicas, con las de las notas agudas apuntando
1810 hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
1811 todas las plicas forzadas hacia abajo, cuatro notas con las plicas
1812 forzadas hacia arriba, y por último cuatro notas devueltas al
1813 comportamiento predeterminado.
1815 @cindex Stem, ejemplo de sobreescritura
1816 @cindex direction, propiedad, ejemplo
1818 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1820 \override Stem #'direction = #DOWN
1822 \override Stem #'direction = #UP
1824 \revert Stem #'direction
1828 Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
1829 (arriba). Éstos tienen los valores @w{@code{-1}} y @code{+1}
1830 respectivamente, y dichos valores numéricos también se pueden usar
1831 directamente. El valor @code{0} también se puede usar en algunos
1832 casos. Se trata simplemente con el significado de @code{UP} para las
1833 plicas, pero para algunos objetos tiene el significado de
1834 @q{centrado}. Existe una constante @code{CENTER} que tiene el valor
1837 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
1838 están disponibles instrucciones predefinidas equivalentes más
1839 sencillas. Aquí podemos ver una tabla de las más comunes. Se
1840 menciona el significado de cada una allí donde no es obvio.
1842 @multitable @columnfractions .2 .2 .25 .35
1843 @headitem Abajo o Izquierda
1844 @tab Arriba o Derecha
1847 @item @code{\arpeggioArrowDown}
1848 @tab @code{\arpeggioArrowUp}
1849 @tab @code{\arpeggioNormal}
1850 @tab La flecha está abajo, arriba o no hay flecha
1851 @item @code{\dotsDown}
1853 @tab @code{\dotsNeutral}
1854 @tab Dirección del desplazamiento para evitar las líneas del pentagrama
1855 @item @code{\dynamicDown}
1856 @tab @code{\dynamicUp}
1857 @tab @code{\dynamicNeutral}
1859 @item @code{\phrasingSlurDown}
1860 @tab @code{\phrasingSlurUp}
1861 @tab @code{\phrasingSlurNeutral}
1862 @tab Nota: diferente de las instrucciones de ligaduras de expresión
1863 @item @code{\slurDown}
1865 @tab @code{\slurNeutral}
1867 @item @code{\stemDown}
1869 @tab @code{\stemNeutral}
1871 @item @code{\textSpannerDown}
1872 @tab @code{\textSpannerUp}
1873 @tab @code{\textSpannerNeutral}
1874 @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
1875 @item @code{\tieDown}
1877 @tab @code{\tieNeutral}
1879 @item @code{\tupletDown}
1880 @tab @code{\tupletUp}
1881 @tab @code{\tupletNeutral}
1882 @tab Los grupos especiales están debajo o encima de las notas
1885 Observe que estas instrucciones predefinidas @strong{no} pueden ir
1886 precedidas de @code{\once}. Si quiere limitar el efecto a una sola
1887 nota, deberá elegir entre usar la instrucción @code{\once \override}
1888 equivalente, o usar la instrucción predefinida, seguida después de la
1889 nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
1891 @unnumberedsubsubsec Digitaciones
1893 @cindex digitación, colocación
1894 @cindex digitación de acordes
1896 La colocación de las digitaciones sobre notas sueltas también se puede
1897 controlar mediante la propiedad @code{direction}, pero los cambios
1898 sobre @code{direction} no tienen ningún efecto sobre las notas de los
1899 acordes. Como veremos, existen instrucciones especiales que permiten
1900 controlar las digitaciones de notas individuales, situando la
1901 digitación encima, debajo, a la izquierda o a la derecha de cada nota.
1903 En primer lugar, he aquí el efecto de @code{direction} sobre las
1904 digitaciones aplicadas a notas sueltas. Se muestra en el primer
1905 compás el comportamiento predeterminado, y en los dos compases
1906 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
1908 @cindex Fingering, ejemplo de sobreescritura
1909 @cindex direction, propiedad, ejemplo
1911 @lilypond[quote,verbatim,relative=2]
1913 \override Fingering #'direction = #DOWN
1915 \override Fingering #'direction = #UP
1919 Sin embargo, la sobreescritura de la propiedad @code{direction} no es
1920 la forma más sencilla de especificar manualmente la digitación por
1921 encima o por debajo de las notas; suele ser preferible usar @code{_} o
1922 @code{^} en lugar de @code{-}, antes del número de la digitación.
1923 Este es el ejemplo anterior utilizando este método:
1925 @cindex fingering, ejemplo
1926 @cindex digitación, ejemplo
1928 @lilypond[quote,verbatim,relative=2]
1934 La propiedad @code{direction} se ignora para los acordes, pero los
1935 prefijos direccionales @code{_} y @code{^} sí funcionan. De forma
1936 predeterminada, las digitaciones se colocan automáticamente encima y
1937 debajo de las notas de un acorde, como se muestra aquí:
1939 @cindex fingering, ejemplo
1940 @cindex digitación, ejemplo
1942 @lilypond[quote,verbatim,relative=2]
1949 pero se puede forzar de manera que todos o algunos de los números de
1950 digitación estén por encima o por debajo:
1952 @cindex fingering, ejemplo
1953 @cindex digitación, ejemplo
1955 @lilypond[quote,verbatim,relative=2]
1961 Es posible ejercer un control aún mayor sobre la colocación de las
1962 digitaciones mediante la utilización de la instrucción @code{\set
1963 fingeringOrientations}. El formato de esta instrucción es:
1966 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
1970 se utiliza @code{\set} porque @code{fingeringOrientations} es una
1971 propiedad del contexto @code{Voice}, creado y usado por el grabador
1972 @code{New_fingering_engraver}.
1974 La propiedad se puede establecer al valor de una lista de entre uno y
1975 tres valores. Controla si las digitaciones se pueden colocar por
1976 encima (si @code{up} aparece en la lista), por debajo (si aparece
1977 @code{down}), a la izquierda (si aparece @code{left}) o a la derecha
1978 (si aparece @code{right}). A la inversa, si una colocación no está en
1979 la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
1980 coma estas restricciones y se trabaja la mejor colocación para la
1981 digitación de las notas de los acordes que siguen. Observe que
1982 @code{left} y @code{right} son mutuamente excluyentes: las
1983 digitaciones pueden situarse en un lado o en el otro, no en los dos.
1985 @warning{Para controlar la colocación de la digitación de una sola
1986 nota usando esta instrucción es necesario escribirla como un acorde de
1987 una sola nota encerrándola entre ángulos simples.}
1989 Aquí podemos ver algunos ejemplos:
1991 @cindex fingering, ejemplo
1992 @cindex digitación, ejemplo
1993 @cindex @code{\set}, ejemplo de utilización
1994 @cindex fingeringOrientations, propiedad, ejemplo
1996 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1997 \set fingeringOrientations = #'(left)
2000 \set fingeringOrientations = #'(left)
2002 <c-1 e-2 g-3 b-5>4 |
2003 \set fingeringOrientations = #'(up left down)
2006 \set fingeringOrientations = #'(up left)
2008 <c-1 e-2 g-3 b-5>4 |
2009 \set fingeringOrientations = #'(right)
2015 Si la digitación parece un poco superpoblada, se puede reducir el
2016 tamaño @code{font-size}. El valor predeterminado puede verse en el
2017 objeto @code{Fingering} del RFI que es @w{@code{-5}}, así que probaremos
2020 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2021 \override Fingering #'font-size = #-7
2022 \set fingeringOrientations = #'(left)
2025 \set fingeringOrientations = #'(left)
2027 <c-1 e-2 g-3 b-5>4 |
2028 \set fingeringOrientations = #'(up left down)
2031 \set fingeringOrientations = #'(up left)
2033 <c-1 e-2 g-3 b-5>4 |
2034 \set fingeringOrientations = #'(right)
2040 @node Objetos fuera del pentagrama
2041 @subsection Objetos fuera del pentagrama
2042 @translationof Outside-staff objects
2044 Los objetos fuera-del-pentagrama se colocan automáticamente para
2045 evitar las colisiones. Los objetos que tienen el valor más bajo de la
2046 propiedad @code{outside-staff-priority} se sitúan más cerca del
2047 pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
2048 tanto como sea necesario para evitar la colisión. La prioridad
2049 @code{outside-staff-priority} se defina en el @code{grob-interface} y
2050 así es una propiedad de todos los objetos de presentación. De forma
2051 predeterminada se establece a @code{#f} para todos los objetos
2052 dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
2053 fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
2054 presenta los valores numéricos predeterminados para algunos de los
2055 objetos fuera-del-pentagrama más comunes.
2057 @cindex objetos de extensión
2059 Observe los nombres algo inusuales de algunos de los objetos: los
2060 objetos de extensión se cearn automáticamente para controlar el
2061 posicionamiento vertical de los grobs que (quizá) comienzan y terminan
2062 en distintos momentos musicales, de manera que cualquier modificación
2063 a la prioridad @code{outside-staff-priority} del grob subyacente no
2064 tiene ningún efecto. Por ejemplo, cambiar la
2065 @code{outside-staff-priority} del objeto de regulador @code{Hairpin}
2066 no tiene efecto sobre la posición vertical de los reguladores: en
2067 lugar de eso, tenemos que cambar la @code{outside-staff-priority} del
2068 objeto asociado @code{DynamicLineSpanner}. Esta sobreescritura se
2069 debe escribir al comienzo del objeto de extensión, que podría incluir
2070 varios reguladores o matices dinámicos encadenados.
2072 @multitable @columnfractions .3 .3 .3
2073 @headitem Objeto de presentación
2075 @tab Controla la posición de:
2076 @item @code{RehearsalMark}
2078 @tab Letras de ensayo
2079 @item @code{MetronomeMark}
2081 @tab Indicaciones metronómicas
2082 @item @code{VoltaBracketSpanner}
2084 @tab Cajetines de primera y segunda vez
2085 @item @code{TextScript}
2087 @tab Texto en elementos de marcado
2088 @item @code{MultiMeasureRestText}
2090 @tab Texto sobre silencios de compás completo
2091 @item @code{OttavaBracket}
2093 @tab Corchetes de octava alta y baja
2094 @item @code{TextSpanner}
2096 @tab Objetos de extensión de texto
2097 @item @code{DynamicLineSpanner}
2099 @tab Todas las indicaciones dinámicas
2100 @item @code{VoltaBracketSpanner}
2102 @tab Números de compás
2103 @item @code{TrillSpanner}
2105 @tab Trinos mantenidos
2108 He aquí un ejemplo que muestra la situación predeterminada de algunos
2111 @cindex texto, extensiones de
2112 @cindex octava alta y baja, corchete de
2114 @funindex \startTextSpan
2115 @funindex startTextSpan
2116 @funindex \stopTextSpan
2117 @funindex stopTextSpan
2119 @cindex TextSpanner, ejemplo de sobreescritura
2120 @cindex bound-details, propiedad, ejemplo
2122 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2123 % Set details for later Text Spanner
2124 \override TextSpanner #'(bound-details left text)
2125 = \markup { \small \bold Slower }
2126 % Place dynamics above staff
2128 % Start Ottava Bracket
2131 % Add Dynamic Text and hairpin
2137 % Add Dynamic Text and terminate hairpin
2138 c4\ff c \stopTextSpan |
2139 % Stop Ottava Bracket
2144 Este ejemplo también muestra cómo crear textos con extensión (Text
2145 Spanners): textos con líneas extensoras por encima de una sección de
2146 música. El extensor abarca desde la instrucción @code{\startTextSpan}
2147 hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
2148 define por medio de la instrucción @code{\override TextSpanner}. Para
2149 ver más detalles, consulte @ruser{Extensiones de texto}.
2151 También muestra la manera de crear corchetes de octava alta y baja.
2153 @cindex trucar la situación de los números de compás
2154 @cindex números de compás, ajustar posición
2155 @cindex trucar la situación de marcas metronómicas
2156 @cindex metrónomo, situación de las indicaciones de
2157 @cindex trucar la situación de las letras de ensayo
2158 @cindex ensayo, letras, trucar la colocación
2160 Si los valores predeterminados de @code{outside-staff-priority} no le
2161 ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
2162 de cualquiera de los objetos. Suponga que quisiéramos que el corchete
2163 de octava estuviera situado por debajo del elemento extensor de texto
2164 en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
2165 prioridad de @code{OttavaBracket} en el RFI o en las tablas
2166 anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
2167 recordando que @code{OttavaBracket} se crea dentro del contexto de
2170 @cindex TextSpanner, ejemplo de sobreescritura
2171 @cindex bound-details, propiedad, ejemplo
2173 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2174 % Set details for later Text Spanner
2175 \override TextSpanner #'(bound-details left text)
2176 = \markup { \small \bold Slower }
2177 % Place dynamics above staff
2179 % Place following Ottava Bracket below Text Spanners
2180 \once \override Staff.OttavaBracket #'outside-staff-priority = #340
2181 % Start Ottava Bracket
2186 % Add Dynamic Line Spanner
2192 c4\ff c \stopTextSpan |
2193 % Stop Ottava Bracket
2198 Observe que algunos de estos objetos, concretamente los números de
2199 compás, las indicaciones metronómicas y las letras de ensayo, se
2200 alojan de forma predeterminada dentro del contexto @code{Score}; así
2201 pues, debe asegurarse de que utiliza el contexto adecuado cuando se
2202 sobreescriben sus propiedades.
2204 @cindex ligaduras y outside-staff-priority
2205 @cindex ligaduras y articulaciones
2206 @cindex articulaciones y ligaduras
2208 De forma predeterminada, las ligaduras de expresión están clasificadas
2209 como objetos dentro-del-pentagrama, pero con frecuencia aparecen
2210 encima del pentagrama si las notas que une son muy agudas. Ello puede
2211 empujar a una posición muy elevada a los objetos fuera-del-pentagrama
2212 como las articulaciones, pues la ligadura se colocará en primer lugar.
2213 La propiedad @code{avoid-slur} de la articulación se puede establecer
2214 al valor @code{'inside} (por dentro) para llevarla al interior de la
2215 ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si
2216 la prioridad @code{outside-staff-priority} está también ajustada al
2217 valor @code{#f}. De forma alternativa, la prioridad
2218 @code{outside-staff-priority} de la ligadura se puede fijar en un
2219 valor numérico para hacer que se sitúe en línea con otros objetos
2220 fuera del pentagrama de acuerdo con este valor. He aquí un ejemplo
2221 que muestra el efecto de los dos métodos:
2223 @lilypond[quote,verbatim,relative=2]
2224 c4( c^\markup { \tiny \sharp } d4.) c8 |
2226 \once \override TextScript #'avoid-slur = #'inside
2227 \once \override TextScript #'outside-staff-priority = ##f
2228 c4^\markup { \tiny \sharp } d4.) c8 |
2229 \once \override Slur #'outside-staff-priority = #500
2230 c4( c^\markup { \tiny \sharp } d4.) c8 |
2233 Los cambios en @code{outside-staff-priority} también se pueden emplear
2234 para controlar la situación vertical de los objetos individuales,
2235 aunque los resultados pueden no siempre ser deseables. Suponga que
2236 quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
2237 bajo el epígrafe Comportamiento Automático de más arriba (véase
2238 @ref{Comportamiento automático}). Todo lo que debemos hacer es localizar la
2239 prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
2240 aumentar la prioridad de @qq{Text3} hasta un valor superior:
2242 @cindex TextScript, ejemplo de sobreescritura
2243 @cindex outside-staff-priority, propiedad, ejemplo
2245 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2248 \once \override TextScript #'outside-staff-priority = #500
2253 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
2254 también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
2255 desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
2256 realmente queremos hacer es posicionar todas las anotaciones a la
2257 misma distancia por encima del pentagrama? Para hacerlo, vamos a
2258 necesitar claramente espaciar las notas en sentido horizontal para
2259 hacer sitio para el texto. Esto se hace empleando la instrucción
2260 @code{textLengthOn}.
2262 @subheading \textLengthOn
2264 @cindex notas, espaciar junto al texto
2266 @funindex \textLengthOn
2267 @funindex textLengthOn
2268 @funindex \textLengthOff
2269 @funindex textLengthOff
2271 De forma predeterminada, el texto producido mediante marcado no ocupa
2272 ningún espacio horizontal en cuanto se refiere a la disposición de la
2273 música. La instrucción @code{\textLengthOn} invierte este
2274 comportamiento, ocasionando que las notas resulten tan espaciadas como
2275 sea necesario para acomodar el texto:
2277 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2278 \textLengthOn % Cause notes to space out to accommodate text
2285 La instrucción para volver al comportamiento predeterminado es
2286 @code{\textLengthOff}. Recuerde que @code{\once} funciona solamente
2287 con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
2288 que no se puede usar con @code{\textLengthOn}.
2290 @cindex marcado, texto de, permitir las colisiones en
2292 El texto de marcado también evita las notas que se proyectan por
2293 encima del pentagrama. Si esto no es lo que deseamos, el
2294 desplazamiento automático hacia arriba se puede desactivar mediante el
2295 establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
2296 muestra cómo el texto de marcado interactúa con tales notas.
2298 @cindex TextScript, ejemplo de sobreescritura
2299 @cindex outside-staff-priority, propiedad, ejemplo
2301 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2302 % This markup is short enough to fit without collision
2306 % This is too long to fit, so it is displaced upwards
2310 % Turn off collision avoidance
2311 \once \override TextScript #'outside-staff-priority = ##f
2312 c,,2^"Long Text " c'' |
2315 % Turn off collision avoidance
2316 \once \override TextScript #'outside-staff-priority = ##f
2317 \textLengthOn % and turn on textLengthOn
2318 c,,2^"Long Text " % Spaces at end are honored
2323 @subheading Matices dinámicos
2325 @cindex trucar la colocación de los matices
2326 @cindex dinámica, trucar la colocación de las indicaciones de
2327 @cindex matices, trucar la colocación
2329 Las indicaciones de matiz dinámico normalmente se colocarán por debajo
2330 del pentagrama, pero se pueden posicionar por encima con la
2331 instrucción @code{dynamicUp}. Se situarán verticalmente respecto a la
2332 nota a la que van adosadas, y flotarán por debajo (o por encima) de
2333 todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
2334 y números de compás. Esto puede ofrecer resultados bastante
2335 aceptables, como muestra este ejemplo:
2337 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2342 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2343 ees,2.~\)\mf ees4 r8 |
2346 Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
2347 muy cerca, la colocación automática evitará las colisiones desplazando
2348 las marcas dinámicas posteriores más lejos, aunque este puede no ser
2349 el lugar óptimo, como muestra el siguiente ejemplo más bien
2352 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2358 Si se presentara una situación similar en música @q{real}, podría ser
2359 preferible espaciar las notas un poco más entre sí, de forma que todas
2360 las marcas dinámicas puedan caber a la misma distancia vertical desde
2361 el pentagrama. Hemos sido capaces de hacer esto para el texto de
2362 marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
2363 una instrucción equivalente para las indicaciones de matiz dinámico.
2364 Por tanto, tendremos que averiguar cómo hacerlo utilizando
2365 instrucciones @code{\override}.
2367 @subheading Escalado de un «Grob»
2369 @cindex grob, cambio de tamaño de un
2370 @cindex escala de los grobs
2372 En primer lugar debemos aprender cómo se especifica el tamaño de los
2373 grobs. Todos los grobs tienen un punto de referencia definido dentro
2374 de ellos que se usa para colocarlos respecto a su objeto padre.
2375 Entonces, este punto del grob se posiciona a una distancia horizontal,
2376 @code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
2377 de su padre. La dimensión horizontal del objeto viene dada por una
2378 pareja de números, @code{X-extent}, que dice dónde están los límites
2379 izquierdo y derecho respecto del punto de referencia. La amplitud
2380 vertical se define de forma similar mediante una pareja de números,
2381 @code{Y-extent}. Éstas son propiedades de todos los grobs que
2382 contemplan el @code{grob-interface}.
2384 @cindex @code{extra-spacing-width}
2386 De forma predeterminada, los objetos fuera-del-pentagrama reciben una
2387 anchura cero, de manera que pueden solaparse en la dirección
2388 horizontal. Esto se hace mediante el truco de añadir una cantidad
2389 infinita a la dimensión más a la izquierda y menos infinito a la
2390 dimensión más a la derecha estableciendo el valor de
2391 @code{extra-spacing-width} a @code{'(+inf.0 . -inf.0)}. Así, para
2392 asegurar que no se superponen en la dirección horizontal tendremos que
2393 sobreescribir este valor de @code{extra-spacing-width} a @code{'(0
2394 . 0)} de forma que el verdadero ancho se presente. Esta es la
2395 instrucción que lo hace para las indicaciones dinámicas:
2398 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2402 Veamos si funciona en nuestro ejemplo anterior:
2404 @cindex DynamicText, ejemplo de sobreescritura
2405 @cindex extra-spacing-width, propiedad, ejemplo
2407 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2409 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2410 a4\f b\mf c\mp b\p |
2414 Bueno, ciertamente ha hecho que las marcas dinámicas ya no estén
2415 desplazadas, pero aún quedan dos problemas. Las marcas tendrían que
2416 separarse un poco más entre sí, y sería mejor si todas estuvieran a la
2417 misma distancia del pentagrama. Podemos resolver el primer problema
2418 fácilmente. En vez de hacer cero la anchura
2419 @code{extra-spacing-width}, podemos añadirle algo más. Las unidades
2420 son el espacio entre dos líneas de pentagrama, así que al mover el
2421 límite izquierdo media unidad a la izquierda y el límite derecho media
2422 unidad hacia la derecha, deberíamos conseguirlo:
2424 @cindex DynamicText, ejemplo de sobreescritura
2425 @cindex extra-spacing-width, propiedad, ejemplo
2427 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2429 % Extend width by 1 staff space
2430 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2435 Esto tiene un mejor aspecto, pero quizá habríamos preferido que las
2436 indicaciones de dinámica estuvieran alineadas sobre la misma línea de
2437 base en lugar de ir hacia arriba y hacia abajo con las notas. La
2438 propiedad que lo hace es @code{staff-padding} (relleno de pentagrama)
2439 que se estudia en la sección siguiente.
2442 @node Colisiones de objetos
2443 @section Colisiones de objetos
2444 @translationof Collisions of objects
2448 * Arreglar notación con superposiciones::
2449 * Ejemplos reales de música::
2453 @subsection Mover objetos
2454 @translationof Moving objects
2456 @cindex mover objetos superpuestos
2457 @cindex mover objetos que colisionan
2458 @cindex mover grobs que colisionan
2459 @cindex objetos que colisionan, mover
2460 @cindex grobs que colisionan, mover
2462 Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
2463 de notación se pueden superponer, lo que es una lástima, pero en
2464 realidad es bastante poco frecuente. Normalmente la necesidad de
2465 mover objetos es por claridad o razones estéticas: el aspecto es mejor
2466 con un poco más o un poco menos de espacio de separación.
2468 Existen tres enfoques principales que llevan a la resolución de
2469 superposiciones en la notación. Se deben considerar en el siguiente
2474 La @strong{dirección} de uno de los objetos que se superponen se puede
2475 cambiar usando las instrucciones predefinidas que están relacionadas
2476 arriba para los objetos dentro-del-pentagrama (véase @ref{Objetos interiores al pentagrama}).
2477 Se pueden recolocar fácilmente las
2478 plicas, ligaduras de expresión y de unión, barras de corchea,
2479 indicaciones dinámicas, texto y grupos de valoración especial de esta
2480 forma. La limitación es que sólo tiene la posibilidad de elegir entre
2481 dos posiciones, y podría ser que ninguna de ellas sea la adecuada.
2484 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2485 colocando los objetos de presentación, se pueden modificar usando la
2486 instrucción de sobreescritura @code{\override}. Las ventadas de hacer
2487 cambios a este tipo de propiedad son: a) que algún otro objeto se
2488 moverá automáticamente si es necesario, para dejarle sitio, y b) una
2489 única sobreescritura se puede aplicar a todas las instancias del mismo
2490 tipo de objeto. Entre tales propiedades se encuentran:
2495 @code{direction} (dirección)
2497 Ya se ha estudiado con cierto detalle: véase @ref{Objetos interiores al pentagrama}.
2500 @code{padding} (relleno),
2501 @code{right-padding} (relleno por la derecha),
2502 @code{staff-padding} (relleno de pentagrama)
2505 @cindex padding, propiedad
2506 @cindex right-padding, propiedad
2507 @cindex staff-padding, propiedad
2509 Según un objeto se está colocando, el valor de su propiedad de relleno
2510 @code{padding} especifica el espacio intermedio que se debe dejar
2511 entre él mismo y el límite más próximo del objeto contra el que se
2512 está colocando. Observe que es el valor de @code{padding} del objeto
2513 @strong{que se está colocando} el que se usa; el valor de
2514 @code{padding} del objeto que ya está colocado se ignora. Los
2515 espacios intermedios especificados mediante @code{padding} se pueden
2516 aplicar a todos los objetos que contemplan el interface
2517 @code{side-position-interface}.
2519 En lugar de con @code{padding}, la colocación de los grupos de
2520 alteraciones se controla con
2521 @code{right-padding}. Esta propiedad se encuentra en el objeto
2522 @code{AccidentalPlacement} que, observe, vive dentro del contexto de
2523 @strong{Staff}. Durante el proceso tipográfico, las cabezas de las
2524 notas se componen tipográficamente en primer lugar, y después las
2525 alteraciones, si existen, se añaden a la izquierda de las cabezas
2526 utilizando la propiedad de relleno por la derecha @code{right-padding}
2527 para determinar la separación entre la alteración y la cabeza, y
2528 de las alteraciones entre sí. Así
2529 pues, sólo la propiedad de relleno por la derecha @code{right-padding}
2530 del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
2531 de las alteraciones.
2533 La propiedad @code{staff-padding} está estrechamente relacionada con
2534 la propiedad @code{padding}: @code{padding} controla la separación
2535 mínima entre cualquier objeto que contemple el interface
2536 @code{side-position-interface} y el objeto más cercano (generalmente
2537 la nota o las líneas del pentagrama); @code{staff-padding} se aplica
2538 sólo a los objetos que siempre se sitúan fuera del pentagrama:
2539 controla la separación mínima entre dicho objeto y el pentagrama.
2540 Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
2541 que se posicionan respecto a la nota en vez de hacerlo respecto al
2542 pentagrama, incluso aunque puede ser sobreescrito sin error por tales
2543 objetos: simplemente se ignora.
2545 Para descubrir qué propiedad de relleno se necesita para el objeto que
2546 quiere recolocar, debe volver al manual de RFI y buscar las
2547 propiedades del objeto. Tenga cuidado porque las propiedades de
2548 relleno podrían no estar en el objeto más obvio, así que busque en los
2549 objetos que puedan tener alguna relación con él.
2551 Todos los valores de relleno se miden en espacios del pentagrama.
2552 Para la mayor parte de los objetos el valor se establece de forma
2553 predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
2554 Se puede sobreescribir si se necesita una separación intermedia mayor
2558 @code{self-alignment-X} (Auto-alineamiento en el eje X)
2560 @cindex self-alignment-X, propiedad
2562 Esta propiedad se puede usar para alinear el objeto a la izquierda, a
2563 la derecha, o centrarlo con respecto al punto de referencia del objeto
2564 «padre». Se puede usar con todos los objetos que contemplan el
2566 @code{self-alignment-interface}. En general son objetos que contienen
2567 texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
2568 forma alternativa se puede especificar un valor numérico entre
2569 @w{@code{-1}} y @code{+1}, donde @w{@code{-1}} es alineado por la izquierda,
2570 @code{+1} es alineado por la derecha, y los números intermedios mueven
2571 el texto progresivamente desde alineado por la izquierda hasta alineado
2572 por la derecha. Se pueden especificar valores numéricos mayores de
2573 @code{1} para mover el texto incluso más lejos hacia la izquierda, o
2574 menos de @w{@code{-1}} para alejarlo más hacia la derecha. Un cambio en
2575 @code{1} en el valor corresponde a un movimiento de la mitad de la
2576 longitud total del propio texto.
2579 @code{extra-spacing-width} (anchura de separación adicional)
2581 @cindex extra-spacing-width, propiedad
2583 Esta propiedad está disponible para todos los objetos que contemplan
2584 el interface @code{item-interface}. Toma dos números, el primero se
2585 suma al límite izquierdo y el segundo se suma al límite derecho. Los
2586 números negativos desplazan el límite a la izquierda y los positivos a
2587 la derecha, por lo que para ensanchar un objeto el primer número debe
2588 ser negativo y el segundo positivo. Observe que no todos los objetos
2589 ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
2590 (alteración) sólo toma nota del primer número (el borde izquierdo).
2593 @code{staff-position} (posición de pentagrama)
2595 @cindex staff-position, propiedad
2597 @code{staff-position} es una propiedad del interface
2598 @code{staff-symbol-referencer-interface}, que está contemplado por los
2599 objetos que se colocan con relación al pentagrama. Especifica la
2600 posición vertical del objeto con relación a la tercera línea del
2601 pentagrama en medios espacios de pentagrama. Es útil en la
2602 resolución de colisiones entre objetos de presentación como silencios
2603 multi-compás, ligaduras de unión y notas en distintas voces.
2606 @code{force-hshift} (forzar desplazamiento horizontal)
2608 @cindex force-hshift, propiedad
2610 Las notas muy juntas de un acorde, o aquellas que ocurren al mismo
2611 tiempo en voces distintas, se disponen en dos (y ocasionalmente más)
2612 columnas para evitar la superposición de las cabezas. Éstas reciben
2613 el nombre de columnas de notas, y se crea un objeto llamado
2614 @code{NoteColumn} para disponer las notas en dicha columna.
2616 La propiedad @code{force-hshift} es una propiedad de una
2617 @code{NoteColumn} (realmente lo es del interface
2618 @code{note-column-interface}). Modificarlo permite mover una columna
2619 de notas en unidades adecuadas a una columna de notas, por ejemplo la
2620 anchura de la cabeza de la nota de la primera voz. Se debe usar en
2621 situaciones complejas donde las instrucciones @code{\shiftOn} normales
2622 (véase @ref{Voces explícitas}) no resuelven el
2623 conflicto entre las notas. Es preferible a la propiedad
2624 @code{extra-offset} para este propósito porque no hay necesidad de
2625 averiguar la distancia en espacios de pentagrama, y mover las notas
2626 dentro o fuera de una @code{NoteColumn} afecta a otras acciones como a
2627 la fusión entre cabezas de nota.
2632 Finalmente, cuando todo lo demás falla, los objetos se pueden
2633 reposicionar manualmente con relación a la tercera línea del
2634 pentagrama verticalmente, o desplazándolas una cierta distancia a una
2635 nueva posición. Las desventajas son que los valores correctos para el
2636 reposicionamiento se deben adivinar, a menudo por ensayo y error, para
2637 cada objeto individual y, puesto que el movimiento se hace después de
2638 que LilyPond ha colocado todos los demás objetos es usuario es
2639 responsable de evitar cualquier colisión que pudiera producirse. Pero
2640 la dificultar principal con este enfoque es que los valores de
2641 reposicionado podrían tener que ser vueltos a calcular si la música se
2642 modifica más tarde. Las propiedades que se pueden usar para este tipo
2643 de posicionamiento manual son:
2646 @item extra-offset (desplazamiento adicional)
2648 @cindex extra-offset, propiedad
2650 Esta propiedad se aplica a cualquier objeto de presentación que
2651 contemple el @code{grob-interface}. Toma una pareja de números que
2652 especifican el desplazamiento adicional en las direcciones horizontal
2653 y vertical. Los números negativos mueven el objeto a la izquierda o
2654 hacia abajo. Las unidades son espacios de pentagrama. El
2655 desplazamiento adicional se hace después de que la composición
2656 tipográfica de los objetos ha terminado, así que un objeto puede ser
2657 reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
2659 @item positions (posiciones)
2661 @cindex positions, propiedad
2663 Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
2664 la altura de las barras de corchea, ligaduras de expresión y corchetes
2665 de grupos de valoración especial. Toma una pareja de números que dan
2666 la posición de los extremos izquierdo y derecho de la barra, ligadura,
2667 etc. con relación a la tercera línea del pentagrama. Las unidades son
2668 espacios de pentagrama. Observe, sin embargo, que las ligaduras de
2669 expresión y de fraseo no se pueden reposicionar en cantidades
2670 arbitrariamente grandes. LilyPond en primer lugar genera una lista de
2671 posiciones posibles para la ligadura y de forma predeterminada
2672 encuentra la ligadura que tiene @qq{mejor aspecto}. Si la propiedad
2673 @code{positions} se ha sobreescrito, la ligadura que está más cerca de
2674 las posiciones que se han solicitado, se selecciona de la lista.
2679 Un objeto en particular podría no tener todas estas propiedades. Es
2680 necesario ir al manual RFI para buscar qué propiedades se encuentran
2681 disponibles para el objeto en cuestión.
2684 Aquí presentamos una lista de los objetos que es más probable que
2685 estén implicados en colisiones, con el nombre del objeto que habría
2686 que buscar en el RFI para descubrir qué propiedades se deben usar para
2689 @multitable @columnfractions .5 .5
2690 @headitem Tipo de objeto @tab Nombre del objeto
2691 @item Articulaciones @tab @code{Script}
2692 @item Barras @tab @code{Beam}
2693 @item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
2694 @item Dinámica (horizontalmente) @tab @code{DynamicText}
2695 @item Digitaciones @tab @code{Fingering}
2696 @item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
2697 @item Ligaduras de expresión @tab @code{Slur}
2698 @item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
2699 @item Ligaduras de unión @tab @code{Tie}
2700 @item Grupos de valoración especial @tab @code{TupletBracket}
2704 @node Arreglar notación con superposiciones
2705 @subsection Arreglar notación con superposiciones
2706 @translationof Fixing overlapping notation
2708 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
2709 en la sección anterior, para resolver problemas de notación que se
2712 @subheading la propiedad padding (relleno)
2715 @cindex arreglar notación que se superpone
2716 @cindex superpuesta, notación
2718 La propiedad @code{padding} se puede ajustar para aumentar (o
2719 disminuir) la distancia entre símbolos impresos encima o debajo de las
2722 @cindex Script, ejemplo de sobreescritura
2723 @cindex padding, propiedad, ejemplo
2725 @lilypond[quote,fragment,relative=1,verbatim]
2727 \override Script #'padding = #3
2731 @cindex MetronomeMark, ejemplo de sobreescritura
2732 @cindex padding, propiedad, ejemplo
2734 @lilypond[quote,fragment,relative=1,verbatim]
2735 % This will not work, see below
2736 \override MetronomeMark #'padding = #3
2740 \override Score.MetronomeMark #'padding = #3
2745 Observe en el segundo ejemplo la gran importancia que tiene saber qué
2746 contexto maneja un determinado objeto. Puesto que el objeto
2747 @code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
2748 cambios de propiedades en el contexto @code{Voice} pasarán
2749 inadvertidos. Para ver más detalles, consulte @ruser{Modificar las propiedades}.
2751 Si la propiedad de relleno @code{padding} de un objeto se incrementa
2752 cuando dicho objeto se encuentra en una pila de objetos que se están
2753 colocando de acuerdo a su prioridad @code{outside-staff-priority},
2754 entonces ese objeto se moverá, y también todos los que están por fuera
2758 @subheading right-padding (relleno por la derecha)
2760 @cindex right-padding, propiedad
2762 La propiedad @code{right-padding} afecta al espaciado entre la
2763 alteración y la nota a que se aplica. Normalmente no es necesaria,
2764 pero el espaciado predeterminado puede estar mal para ciertos glifos
2765 de alteraciones o combinaciones de glifos que se usan en música
2766 microtonal. Éstos tienen que introducirse sobreescribiendo el sello
2767 de la alteración con un elemento de marcado que contenga los símbolos
2770 @cindex Accidental, ejemplo de sobreescritura
2771 @cindex text, propiedad, ejemplo
2772 @cindex stencil, propiedad, ejemplo
2773 @cindex AccidentalPlacement, ejemplo de sobreescritura
2774 @cindex right-padding, propiedad, ejemplo
2777 @lilypond[quote,ragged-right,verbatim]
2778 sesquisharp = \markup { \sesquisharp }
2781 % This prints a sesquisharp but the spacing is too small
2782 \once \override Accidental
2783 #'stencil = #ly:text-interface::print
2784 \once \override Accidental #'text = #sesquisharp
2786 % This improves the spacing
2787 \once \override Score.AccidentalPlacement #'right-padding = #0.6
2788 \once \override Accidental
2789 #'stencil = #ly:text-interface::print
2790 \once \override Accidental #'text = #sesquisharp
2796 Esto utiliza necesariamente una sobreescritura para el sello de la
2797 alteración que no se estudiará hasta más adelante. El tipo de sello
2798 debe ser un procedimiento, aquí modificado para que imprima el
2799 contenido de la propiedad @code{text} del objeto @code{Accidental},
2800 que a su vez está establecido como un signo de sesquisostenido.
2801 Entonces el signo se puede separar de la cabeza de la nota
2802 sobreescribiendo @code{right-padding}.
2806 @subheading la propiedad staff-padding (relleno de pentagrama)
2808 @cindex alineación de objetos sobre la línea base
2809 @cindex objetos, alineación sobre la línea base
2811 @code{staff-padding} se puede usar para alinear objetos como matices
2812 dinámicos a lo largo de una línea de base a una altura fija sobre el
2813 pentagrama, en lugar de hacerlo a una altura que dependa de la
2814 posición de la nota a la que están adosados. No es una propiedad de
2815 @code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
2816 porque la línea de base debe aplicarse por igual a @strong{todas} las
2817 dinámicas, entre ellas las que se han creado como objetos de
2818 extensión. Así que ésta es la forma de alinear las indicaciones de
2819 matiz en el ejemplo de la sección anterior:
2821 @cindex DynamicText, ejemplo de sobreescritura
2822 @cindex extra-spacing-width, propiedad, ejemplo
2823 @cindex DynamicLineSpanner, ejemplo de sobreescritura
2824 @cindex staff-padding, propiedad, ejemplo
2826 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2828 % Extend width by 1 unit
2829 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2830 % Align dynamics to a base line 2 units above staff
2831 \override DynamicLineSpanner #'staff-padding = #2
2836 @subheading la propiedad self-alignment-X (auto-alineación en X)
2838 El ejemplo siguiente muestra cómo esto puede resolver la colisión
2839 entre un objeto de digitación de cuerda y la plica de una nota
2840 mediante el alineamiento del límite derecho con el punto de referencia
2843 @cindex StringNumber, ejemplo de sobreescritura
2844 @cindex self-alignment-X, propiedad, ejemplo
2846 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
2849 \once \override StringNumber #'self-alignment-X = #RIGHT
2853 @subheading la propiedad staff-position (posición en el pentagrama)
2855 @cindex objeto, colisión dentro del pentagrama
2857 Los silencios multi-compás en una voz pueden chocar con las notas en
2858 otra voz. Puesto que estos silencios se tipografían centrados entre
2859 las barras de compás se necesitaría bastante esfuerzo para que
2860 LilyPond averiguara qué otras notas podrían chocar con él, ya que
2861 actualmente todo el manejo de colisiones entre notas y silencios se
2862 hace solamente para notas y silencios que ocurren al mismo tiempo. He
2863 aquí un ejemplo de colisión de este tipo:
2865 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2866 << { c4 c c c } \\ { R1 } >>
2869 La mejor solución aquí es mover el silencio multi-compás hacia abajo,
2870 pues el silencio está en la voz dos. El ajuste predeterminado para
2871 @code{\voiceTwo} (es decir, en la segunda voz de una construcción
2872 @code{<<@{...@} \\ @{...@}>>}) es que @code{staff-position} tenga el
2873 valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
2874 cuatro semi-espacios de pentagrama, al valor @w{@code{-8}}.
2876 @cindex MultiMeasureRest, ejemplo de sobreescritura
2877 @cindex staff-position, propiedad, ejemplo
2879 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2883 \override MultiMeasureRest #'staff-position = #-8
2888 Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
2889 la línea adicional por encima del silencio se inserta automáticamente.
2891 @subheading la propiedad extra-offset (desplazamiento adicional)
2893 @cindex posicionar objetos
2894 @cindex posicionar grobs
2895 @cindex objetos, posicionar
2896 @cindex grobs, posicionar
2898 La propiedad @code{extra-offset} da un completo control sobre el
2899 posicionamiento de un objeto tanto vertical como horizontalmente.
2901 En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
2902 a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
2904 @cindex Fingering, ejemplo de sobreescritura
2905 @cindex extra-offset, propiedad, ejemplo
2907 @lilypond[quote,fragment,relative=1,verbatim]
2910 \once \override Fingering #'extra-offset = #'(-0.3 . -1.8)
2915 @subheading la propiedad positions (posiciones)
2917 @cindex controlar manualmente grupos especiales, ligaduras y barras
2918 @cindex manual, control, de grupos especiales, ligaduras y barras
2919 @cindex grupos especiales, barras de, control manual
2920 @cindex ligaduras de expresión, control manual
2921 @cindex ligaduras de fraseo, control manual
2922 @cindex barras de corchea, control manual
2924 La propiedad @code{positions} permite controlar manualmente la
2925 posición e inclinación de los tresillos, ligaduras de expresión y de
2926 fraseo, y barras de corchea. He aquí un ejemplo que tiene una fea
2927 ligadura de fraseo debido a que intenta evitar la ligadura de
2928 expresión que está sobre la acciaccatura.
2930 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2931 r4 \acciaccatura e8\( d8 c~ c d c d\)
2935 Simplemente podemos mover la ligadura de fraseo por encima de las
2936 notas, y de hecho ésta será la solución preferida:
2938 @cindex PhrasingSlur, ejemplo de sobreescritura
2939 @cindex positions, propiedad, ejemplo
2941 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2944 \acciaccatura e8\( d8 c~ c d c d\)
2948 Pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
2949 sería mover el extremo izquierdo de la ligadura de fraseo un poco
2950 hacia abajo usando la propiedad @code{positions}. Esto también
2951 resuelve la forma algo indecente de la ligadura.
2953 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2955 \once \override PhrasingSlur #'positions = #'(-4 . -3)
2956 \acciaccatura e8\( d8 c~ c d c d\)
2959 Presentamos otro ejemplo. Vemos que la barra
2960 choca con las ligaduras:
2962 @lilypond[quote,verbatim,fragment,ragged-right]
2966 { c'1 ~ c'2. e'8 f' }
2968 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
2971 { c'1 ~ c'2. e'8 f' }
2973 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
2979 Esto se puede resolver manualmente elevando los dos extremos de la
2980 barra desde su posición a 1.81 espacios de pentagrama bajo la línea
2981 central hasta, digamos, 1 espacio:
2983 @cindex Beam, ejemplo de sobreescritura
2984 @cindex positions, propiedad, ejemplo
2986 @lilypond[quote,verbatim,fragment,ragged-right]
2990 { c'1 ~ c'2. e'8 f' }
2993 \override Beam #'positions = #'(-1 . -1)
2994 e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g''
2998 { c'1 ~ c'2. e'8 f' }
3000 { e''8 e'' e'' e'' e'' e'' e'' e'' f''2 g'' }
3006 Observe que la sobreescritura sigue aplicándose en la primera voz del
3007 segundo compás de corcheas, pero no a ninguna de las barras de la
3010 @subheading la propiedad force-hshift (forzar desplazamiento horizontal)
3012 Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
3013 Chopin que presentamos al final de @ref{Oigo voces}, que
3014 dejamos con este aspecto:
3016 @lilypond[quote,verbatim,fragment,ragged-right]
3017 \new Staff \relative c'' {
3032 Es necesario que la nota interior del primer acorde (el La bemol de la
3033 cuarta voz) no se aparte de la columna vertical de la nota aguda.
3034 Para corregirlo, ajustamos a cero el valor para esta nota de
3035 @code{force-hshift}, que es una propiedad de @code{NoteColumn}.
3037 En el segundo acorde preferimos que el Fa esté alineado con el La y
3038 que la nota grave se coloque ligeramente a la derecha para evitar una
3039 colisión de las plicas. Lo conseguimos ajustando el valor de
3040 @code{force-hshift} en la @code{NoteColumn} del Re bemol grave para
3041 moverlo a la derecha medio espacio de pentagrama.
3043 Presentamos a continuación el resultado final:
3045 @cindex NoteColumn, ejemplo de sobreescritura
3046 @cindex force-hshift, propiedad, ejemplo
3048 @lilypond[quote,verbatim,fragment,ragged-right]
3049 \new Staff \relative c'' {
3056 \once \override NoteColumn #'force-hshift = #0.5
3062 \override NoteColumn #'force-hshift = #0
3071 @node Ejemplos reales de música
3072 @subsection Ejemplos reales de música
3073 @translationof Real music example
3075 Finalizaremos esta sección sobre los trucos mostrando los pasos que se
3076 deben tomar para tratar con un ejemplo complicado que necesita varios
3077 trucos para producir el resultado deseado. El ejemplo se ha escogido
3078 deliberadamente para ilustrar el uso de la Referencia de la Notación
3079 para resolver problemas de notación poco comunes. No es
3080 representativo del proceso de grabado más usual, por lo que ¡le
3081 recomendamos que no deje que estas dificultades le desanimen!
3082 ¡Afortunadamente, las dificultades como éstas no son muy comunes!
3084 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
3085 compases 6 al 9, la transición entre el Lento inicial y el Moderato.
3086 Presentamos en primer lugar el aspecto que queremos que tenga el
3087 resultado, pero para evitar complicar demasiado el ejemplo hemos
3088 quitado las indicaciones dinámicas, las digitaciones y el pedal.
3090 @c The following should appear as music without code
3091 @c This example should not be indexed
3092 @c line-width ensures no break
3093 @lilypond[quote,ragged-right,line-width=6\in]
3094 rhMusic = \relative c'' {
3097 \once \override Tie #'staff-position = #3.5
3101 \mergeDifferentlyHeadedOn
3102 \mergeDifferentlyDottedOn
3103 bes2.^\markup { \bold "Moderato" } r8
3109 % Reposition the c2 to the right of the merged note
3110 \once \override NoteColumn #'force-hshift = #1.0
3111 % Move the c2 out of the main note column
3112 % so the merge will work
3119 % Stem on the d2 must be down to permit merging
3121 % Stem on the d2 should be invisible
3122 \tweak Stem #'transparent ##t
3123 \tweak Flag #'transparent ##t
3131 \mergeDifferentlyHeadedOff
3132 \mergeDifferentlyDottedOff
3137 lhMusic = \relative c' {
3139 <d g, d>1)\arpeggio |
3146 \new Staff = "RH" <<
3150 \new Staff = "LH" <<
3159 Observamos en primer lugar que la parte de la mano derecha del tercer
3160 compás requiere cuatro voces. Son las cinco corcheas unidas por una
3161 barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
3162 y el Fa sostenido negra con puntillo, que también está fundida con la
3163 corchea de su misma altura. Todo lo demás está en una sola voz, así
3164 que lo más fácil es introducir estas tres voces adicionales, en el
3165 momento en que se necesiten y de forma temporal. Si ha olvidado cómo
3166 hacerlo, lea las secciones @ref{Oigo voces} y @ref{Voces explícitas}.
3167 Aquí tomamos la decisión de utilizar voces instanciadas explícitamente
3168 para el pasaje polifónico, dado que LilyPond es más probable que pueda
3169 evitar las colisiones si todas las voces se instancian explícitamente
3172 Vamos a comenzar introduciendo las notas como dos variables y
3173 disponiendo la estructura de pentagramas en un bloque Score, y veremos
3174 qué produce LilyPond de forma predeterminada:
3176 @c line-width ensures no break
3177 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3178 rhMusic = \relative c'' {
3184 % Start polyphonic section of four voices
3186 { c,8 d fis bes a } % continuation of main voice
3200 g2. % continuation of main voice
3204 lhMusic = \relative c' {
3213 \new Staff = "RH" <<
3217 \new Staff = "LH" <<
3226 Todas las notas son correctas, pero el aspecto está lejos de ser
3227 satisfactorio. La ligadura de unión choca con el cambio de compás,
3228 ciertas notas no se funden correctamente, y faltan algunos elementos de
3229 notación. En primer lugar trataremos con lo más fácil. Podemos
3230 añadir fácilmente la ligadura de expresión de la mano izquierda y la
3231 ligadura de fraseo de la mano derecha, pues todo ello se estudió en el
3232 Tutorial. Al hacerlo así obtenemos:
3234 @c line-width ensures no break
3235 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3236 rhMusic = \relative c'' {
3242 % Start polyphonic section of four voices
3244 { c,8 d fis bes a } % continuation of main voice
3258 g2.\) % continuation of main voice
3262 lhMusic = \relative c' {
3271 \new Staff = "RH" <<
3275 \new Staff = "LH" <<
3284 El primer compás ahora es correcto. El segundo compás contiene un
3285 arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
3286 sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
3287 que volver e la Referencia de la Notación. Buscando la palabra
3288 @q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
3289 que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
3290 doble barra se produce por medio de la instrucción @code{\bar "||"}.
3291 Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
3292 la colisión entre la ligadura de unión y la indicación de compás.
3293 Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
3294 mover objetos anteriormente en @ref{Mover objetos}, donde dice que
3295 los objetos que están situados de forma relativa al pentagrama se
3296 pueden mover verticalmente
3297 sobreescribiendo su propiedad @code{staff-position}, que
3298 se especifica en unidades de medio espacio de pentagrama respecto de
3299 la línea central del pentagrama. Así pues, la sobreescritura
3300 siguiente colocada justo antes de la primera nota ligada subirá la
3301 ligadura 3.5 medios espacios de pentagrama por encima de la línea
3304 @code{\once \override Tie #'staff-position = #3.5}
3306 Con esto se completa el compás dos, dando como resultado:
3308 @c line-width ensures no break
3309 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3310 rhMusic = \relative c'' {
3313 \once \override Tie #'staff-position = #3.5
3318 % Start polyphonic section of four voices
3320 { c,8 d fis bes a } % continuation of main voice
3334 g2.\) % continuation of main voice
3338 lhMusic = \relative c' {
3340 <d g, d>1)\arpeggio |
3347 \new Staff = "RH" <<
3351 \new Staff = "LH" <<
3360 Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
3361 tutorial nos enseñó cómo escribir texto en negrita mediante la
3362 instrucción @code{\markup}, por lo que añadir @qq{Moderato} en negrita
3363 es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
3364 voces? Aquí es donde debemos volver a buscar ayuda en el manual de
3365 Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
3366 el índice de la Referencia de la notación llegamos rápidamente a las
3367 instrucciones para mezclar notas con distinta cabeza y con o sin
3368 puntillo, en @ruser{Resolución de las colisiones}. En nuestro ejemplo tenemos
3369 que fusionar ambos tipos de nota en el transcurso de la sección
3370 polifónica del compás 3; por tanto, en virtud de la información que
3371 aparece en la Referencia de la Notación, escribimos
3374 \mergeDifferentlyHeadedOn
3375 \mergeDifferentlyDottedOn
3379 al principio de la sección, y
3382 \mergeDifferentlyHeadedOff
3383 \mergeDifferentlyDottedOff
3387 al final, dando como resultado:
3389 @c line-width ensures no break
3390 @lilypond[quote,ragged-right,line-width=6\in]
3391 rhMusic = \relative c'' {
3394 \once \override Tie #'staff-position = #3.5
3398 bes2.^\markup { \bold "Moderato" } r8
3399 \mergeDifferentlyHeadedOn
3400 \mergeDifferentlyDottedOn
3401 % Start polyphonic section of four voices
3403 { c,8 d fis bes a } % continuation of main voice
3417 \mergeDifferentlyHeadedOff
3418 \mergeDifferentlyDottedOff
3419 g2.\) % continuation of main voice
3423 lhMusic = \relative c' {
3425 <d g, d>1)\arpeggio |
3432 \new Staff = "RH" <<
3436 \new Staff = "LH" <<
3445 Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
3446 dos Re. ¿Por qué no? La respuesta está en la misma sección de la
3447 Referencia de la Notación: las notas que se fusionan deben tener las
3448 plicas en direcciones opuestas y dos notas no se pueden fusionar bien
3449 si hay una tercera nota en la misma columna. Aquí los dos Re tienen
3450 las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
3451 cambiar la dirección de la plica usando @code{\stemDown}, y la
3452 Referencia de la Notación también explica cómo mover el Do: aplicar un
3453 desplazamiento usando una de las instrucciones @code{\shift}. Pero
3454 ¿cuál? El Do está en la voz dos que tiene desactivado el
3455 desplazamiento, y los dos Re están en las voces uno y tres, que tienen
3456 el desplazamiento desactivado y activado, respectivamente. Por ello
3457 tenemos que desplazar el Do un nivel más todavía, usando
3458 @code{\shiftOnn} para evitar que interfiera con los dos Re. Al
3459 aplicar estos cambios obtenemos:
3461 @cindex Tie, ejemplo de sobreescritura
3462 @cindex staff-position, propiedad, ejemplo
3464 @c line-width ensures no break
3465 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3466 rhMusic = \relative c'' {
3469 \once \override Tie #'staff-position = #3.5
3473 bes2.^\markup { \bold "Moderato" } r8
3474 \mergeDifferentlyHeadedOn
3475 \mergeDifferentlyDottedOn
3476 % Start polyphonic section of four voices
3478 { c,8 d fis bes a } % continuation of main voice
3481 % Move the c2 out of the main note column
3482 % so the merge will work
3487 % Stem on the d2 must be down to permit merging
3495 \mergeDifferentlyHeadedOff
3496 \mergeDifferentlyDottedOff
3497 g2.\) % continuation of main voice
3501 lhMusic = \relative c' {
3503 <d g, d>1)\arpeggio |
3510 \new Staff = "RH" <<
3514 \new Staff = "LH" <<
3523 Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
3524 sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
3525 colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
3526 partir de trucos anteriores: hacemos la plica transparente, y movemos
3527 el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
3530 @cindex NoteColumn, ejemplo de sobreescritura
3531 @cindex force-hshift, propiedad, ejemplo
3532 @cindex Stem, ejemplo de sobreescritura
3533 @cindex transparent, propiedad, ejemplo
3535 @c line-width ensures no break
3536 @lilypond[quote,verbatim,ragged-right,line-width=6\in]
3537 rhMusic = \relative c'' {
3540 \once \override Tie #'staff-position = #3.5
3544 bes2.^\markup { \bold "Moderato" } r8
3545 \mergeDifferentlyHeadedOn
3546 \mergeDifferentlyDottedOn
3547 % Start polyphonic section of four voices
3549 { c,8 d fis bes a } % continuation of main voice
3553 % Reposition the c2 to the right of the merged note
3554 \once \override NoteColumn #'force-hshift = #1.0
3555 % Move the c2 out of the main note column
3556 % so the merge will work
3563 % Stem on the d2 must be down to permit merging
3565 % Stem on the d2 should be invisible
3566 \tweak Stem #'transparent ##t
3567 \tweak Flag #'transparent ##t
3575 \mergeDifferentlyHeadedOff
3576 \mergeDifferentlyDottedOff
3577 g2.\) % continuation of main voice
3581 lhMusic = \relative c' {
3583 <d g, d>1)\arpeggio |
3590 \new Staff = "RH" <<
3594 \new Staff = "LH" <<
3604 @node Trucajes adicionales
3605 @section Trucajes adicionales
3606 @translationof Further tweaking
3609 * Otras aplicaciones de los trucos::
3610 * Uso de variables para los trucos::
3612 * Otras fuentes de información::
3613 * Trucos avanzados con Scheme::
3616 @node Otras aplicaciones de los trucos
3617 @subsection Otras aplicaciones de los trucos
3618 @translationof Other uses for tweaks
3620 @cindex transparent, uso de la propiedad
3621 @cindex objetos, hace invisibles
3622 @cindex eliminar objetos
3623 @cindex objetos, eliminar
3624 @cindex objetos, ocultar
3625 @cindex ocultar objetos
3626 @cindex invisibles, objetos
3627 @cindex objetos invisibles
3628 @cindex ligar notas entre voces distintas
3630 @subheading Ligar notas entre voces distintas
3632 El ejemplo siguiente muestra cómo conectar notas que están en
3633 distintas voces utilizando ligaduras de unión. Normalmente sólo se
3634 pueden conectar mediante ligaduras de unión dos notas que estén en la
3635 misma voz. Usando dos voces, con las notas ligadas en una de ellas:
3637 @lilypond[quote,fragment,relative=2]
3638 << { b8~ b\noBeam } \\ { b8[ g] } >>
3642 y borrando la primera plica hacia arriba en esa voz, da la impresión
3643 de que la ligadura se cruza entre las voces:
3645 @cindex Stem, ejemplo de sobreescritura
3646 @cindex transparent, propiedad, ejemplo
3648 @lilypond[quote,fragment,relative=2,verbatim]
3651 \tweak Stem #'transparent ##t
3652 \tweak Flag #'transparent ##t
3660 Para estar seguros de que la plica que acabamos de borrar no aprieta
3661 demasiado a la ligadura, podemos alargar la plica estableciendo su
3662 valor de longitud @code{length} a @code{8},
3664 @lilypond[quote,fragment,relative=2,verbatim]
3667 \tweak Stem #'transparent ##t
3668 \tweak Flag #'transparent ##t
3669 \tweak Stem #'length #8
3677 @subheading Simulación de un calderón en el MIDI
3679 @cindex sello, uso de la propiedad
3680 @cindex fermata, realización en MIDI
3682 Para los objetos fuera-del-pentagrama, normalmente es mejor
3683 sobreescribir la propiedad @code{stencil} («sello») del objeto que su
3684 propiedad @code{transparent} cuando desee quitarlos de la salida
3685 impresa. Mediante el establecimiento de la propiedad @code{stencil}
3686 de un objeto al valor @code{#f} podemos quitar el objeto por completo
3687 de la salida impresa. Esto significa que no tiene efecto sobre la
3688 colocación de otros objetos que pudieran colocarse en relación a él.
3690 Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
3691 propósito de simular un calderón en la salida MIDI, seguramente no
3692 querríamos que la indicación metronómica apareciese en la salida
3693 impresa, y no querríamos influir sobre la separación entre los dos
3694 sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
3695 pentagrama. Por lo tanto, establecer su propiedad @code{stencil} al
3696 valor @code{#f} sería la mejor manera. Mostramos aquí el efecto de
3699 @cindex MetronomeMark, ejemplo de sobreescritura
3700 @cindex transparent, propiedad, ejemplo
3702 @lilypond[quote,verbatim,ragged-right]
3705 % Visible tempo marking
3708 \once \override Score.MetronomeMark #'transparent = ##t
3709 % Invisible tempo marking to lengthen fermata in MIDI
3712 % New tempo for next section
3721 @cindex MetronomeMark, ejemplo de sobreescritura
3722 @cindex stencil, propiedad, ejemplo
3724 @lilypond[quote,verbatim,ragged-right]
3727 % Visible tempo marking
3730 \once \override Score.MetronomeMark #'stencil = ##f
3731 % Invisible tempo marking to lengthen fermata in MIDI
3734 % New tempo for next section
3744 Ambos métodos quitan de la salida impresa la indicación metronómica
3745 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
3746 queríamos, pero la indicación metronómica transparente de la primera
3747 línea fuerza una colocación muy alta de la indicación de tempo que
3748 sigue, mientras que la segunda (con el sello suprimido) no lo hace.
3755 @node Uso de variables para los trucos
3756 @subsection Uso de variables para los trucos
3757 @translationof Using variables for tweaks
3759 @cindex variables, uso de, para trucos
3760 @cindex usar variables para hacer trucos
3761 @cindex trucos, usar variables para hacer
3763 Las instrucciones de sobreescritura son con frecuencia largas y
3764 tediosas de escribir, y se tienen que escribir de forma absolutamente
3765 correcta. Si las mismas sobreescrituras se van a utilizar muchas
3766 veces, podría merecer la pena definir variables para guardarlas.
3768 Supongamos que queremos realzar ciertas palabras de la letra de una
3769 canción imprimiéndolas en cursiva y negrita. Las instrucciones
3770 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
3771 canciones si están incluidas, junto con la palabra o palabras que se
3772 pretenden modificar, dentro de un @code{\markup}, lo que las hace
3773 tediosas de escribir. La necesidad de incluir las propias palabras
3774 impide que se puedan usar en variables simples. ¿Podríamos, como
3775 alternativa, utilizar las instrucciones @code{\override} y
3779 @code{\override Lyrics . LyricText #'font-shape = #'italic}
3780 @code{\override Lyrics . LyricText #'font-series = #'bold}
3782 @code{\revert Lyrics . LyricText #'font-shape}
3783 @code{\revert Lyrics . LyricText #'font-series}
3786 Estas instrucciones también serían extremadamente tediosas de escribir
3787 si hubiera muchas palabras que quisiéramos subrayar. Pero sí
3788 @emph{podemos} definirlas como dos variables y usarlas para delimitar
3789 las palabras que destacar. Otra ventaja de la utilización de
3790 variables para estas sobreescrituras es que ya no son necesarios los
3791 espacios que rodean al punto, puesto que no se interpretan
3792 directamente en el modo @code{\lyricmode}. He aquí un ejemplo de
3793 esto, aunque en la práctica quizá elegiríamos unos nombres de variable
3794 más cortos para que fueran más rápidos de teclear:
3796 @cindex LyricText, ejemplo de sobreescritura
3797 @cindex font-shape, propiedad, ejemplo
3798 @cindex font-series, propiedad, ejemplo
3800 @lilypond[quote,verbatim]
3802 \override Lyrics.LyricText #'font-shape = #'italic
3803 \override Lyrics.LyricText #'font-series = #'bold
3807 \revert Lyrics.LyricText #'font-shape
3808 \revert Lyrics.LyricText #'font-series
3811 global = { \key c \major \time 4/4 \partial 4 }
3813 SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a4 a g }
3814 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f4 f e }
3815 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
3816 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
3818 VerseOne = \lyrics {
3819 E -- | ter -- nal \emphasize Fa -- ther, | \normal strong to save,
3822 VerseTwo = \lyricmode {
3823 O | \once \emphasize Christ, whose voice the | wa -- ters heard,
3826 VerseThree = \lyricmode {
3827 O | \emphasize Ho -- ly Spi -- rit, | \normal who didst brood
3830 VerseFour = \lyricmode {
3831 O | \emphasize Tri -- ni -- ty \normal of | love and pow'r
3838 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
3839 \new Voice = "Alto" { \voiceTwo \AltoMusic }
3840 \new Lyrics \lyricsto "Soprano" { \VerseOne }
3841 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
3842 \new Lyrics \lyricsto "Soprano" { \VerseThree }
3843 \new Lyrics \lyricsto "Soprano" { \VerseFour }
3847 \new Voice = "Tenor" { \voiceOne \TenorMusic }
3848 \new Voice = "Bass" { \voiceTwo \BassMusic }
3855 @node Hojas de estilo
3856 @subsection Hojas de estilo
3857 @translationof Style sheets
3859 La salida que produce LilyPond se puede modificar profundamente;
3860 consulte @ref{Trucar la salida} para leer detalles sobre este asunto.
3861 Pero ¿qué ocurre si tiene muchos archivos a los que les quiere aplicar
3862 sus propios trucos? O ¿qué ocurre si, sencillamente, quiere separar
3863 los trucos de la propia música? Todo esto es bastante fácil de
3866 Veamos un ejemplo. No se preocupe si no entiende
3867 las partes que tienen todos los @code{#()}. Esto se explicará en
3868 @ref{Trucos avanzados con Scheme}.
3870 @lilypond[quote,verbatim,ragged-right]
3872 #(make-dynamic-script
3873 #{ \markup { \hspace #0
3874 \translate #'(5 . 0)
3875 \line { \dynamic "mp"
3876 \text \italic "dolce" } }
3880 #(define-music-function
3881 (parser location string)
3883 #{ ^\markup \bold \box #string #})
3887 a4.\mpdolce d8 cis4--\glissando a |
3891 g8(\! fis)-. e( d)-. cis2 |
3895 Hagamos algo respecto a las definiciones @code{mpdolce} e
3896 @code{inst}. Éstas producen la salida que deseamos, pero quizá las
3897 querríamos utilizar en otra pieza. Podríamos simplemente copiarlas y
3898 pegarlas al principio de cada archivo, pero sería bastante molesto.
3899 También hace que se queden las definiciones a la vista dentro de
3900 nuestros archivos de música, y yo personalmente encuentro todos los
3901 @code{#()} bastante poco estéticos. Los vamos a esconder dentro de
3905 %%% guardar esto en un archivo de nombre "definiciones.ily"
3907 #(make-dynamic-script
3908 #@{ \markup @{ \hspace #0
3909 \translate #'(5 . 0)
3910 \line @{ \dynamic "mp"
3911 \text \italic "dolce" @} @}
3915 #(define-music-function
3916 (parser location string)
3918 #@{ ^\markup \bold \box #string #@})
3921 Haremos referencia a este archivo utilizando la instrucción
3922 @code{\include} al principio del archivo de música (la extensión
3923 @code{.ily} se utiliza para distinguir este archivo de inclusión --que
3924 se supone que no debe ser procesado de forma independiente-- del
3925 archivo principal). Ahora modificaremos la música (guardemos este
3926 archivo como @file{musica.ly}).
3928 @c We have to do this awkward example/lilypond-non-verbatim
3929 @c because we can't do the \include stuff in the manual.
3932 \include "definiciones.ily"
3936 a4.\mpdolce d8 cis4--\glissando a |
3940 g8(\! fis)-. e( d)-. cis2 |
3944 @lilypond[quote,ragged-right]
3946 #(make-dynamic-script
3947 #{ \markup { \hspace #0
3948 \translate #'(5 . 0)
3949 \line { \dynamic "mp"
3950 \text \italic "dolce" } }
3954 #(define-music-function
3955 (parser location string)
3957 #{ ^\markup \bold \box #string #})
3961 a4.\mpdolce d8 cis4--\glissando a |
3965 g8(\! fis)-. e( d)-. cis2 |
3969 Eso tiene mejor aspecto, pero haremos algunos cambios más. El
3970 glissando es difícil de ver, así que lo haremos más grueso y lo
3971 acercaremos a las cabezas de las notas. Pondremos la indicación
3972 metronómica encima de la clave, en lugar de ir encima de la primera
3973 nota. Y por último, mi profesor de composición odia las indicaciones
3974 de compás @q{C}, así que la convertiremos en @q{4/4}.
3976 Sin embargo, no debemos cambiar el archivo @file{musica.ly}.
3977 Sustituyamos nuestro archivo @file{definiciones.ily} con éste:
3980 %%% definiciones.ily
3982 #(make-dynamic-script
3983 #@{ \markup @{ \hspace #0
3984 \translate #'(5 . 0)
3985 \line @{ \dynamic "mp"
3986 \text \italic "dolce" @} @}
3990 #(define-music-function
3991 (parser location string)
3993 #@{ ^\markup \bold \box #string #@})
3998 \override MetronomeMark #'extra-offset = #'(-9 . 0)
3999 \override MetronomeMark #'padding = #'3
4003 \override TimeSignature #'style = #'numbered
4007 \override Glissando #'thickness = #3
4008 \override Glissando #'gap = #0.1
4013 @lilypond[quote,ragged-right]
4015 #(make-dynamic-script
4016 #{ \markup { \hspace #0
4017 \translate #'(5 . 0)
4018 \line { \dynamic "mp"
4019 \text \italic "dolce" } }
4023 #(define-music-function
4024 (parser location string)
4026 #{ ^\markup \bold \box #string #})
4031 \override MetronomeMark #'extra-offset = #'(-9 . 0)
4032 \override MetronomeMark #'padding = #'3
4036 \override TimeSignature #'style = #'numbered
4040 \override Glissando #'thickness = #3
4041 \override Glissando #'gap = #0.1
4047 a4.\mpdolce d8 cis4--\glissando a |
4051 g8(\! fis)-. e( d)-. cis2 |
4055 ¡Eso tiene un aspecto mucho mejor! Ahora suponga que quiere publicar
4056 esta pieza. A mi profesor de composición no le gustan las
4057 indicaciones de compás @q{C}, pero yo les tengo cierto cariño.
4058 Copiaremos el archivo actual @file{definiciones.ily} a
4059 @file{publicar-web.ily} y modificaremos éste. Como el propósito de
4060 esta música es producir un PDF que va a mostrarse en la pantalla,
4061 también vamos a aumentar el tamaño general de la salida.
4064 %%% definiciones.ily
4066 #(make-dynamic-script
4067 #@{ \markup @{ \hspace #0
4068 \translate #'(5 . 0)
4069 \line @{ \dynamic "mp"
4070 \text \italic "dolce" @} @}
4074 #(define-music-function
4075 (parser location string)
4077 #@{ ^\markup \bold \box #string #@})
4079 #(set-global-staff-size 23)
4084 \override MetronomeMark #'extra-offset = #'(-9 . 0)
4085 \override MetronomeMark #'padding = #'3
4092 \override Glissando #'thickness = #3
4093 \override Glissando #'gap = #0.1
4098 @lilypond[quote,ragged-right]
4100 #(make-dynamic-script
4101 #{ \markup { \hspace #0
4102 \translate #'(5 . 0)
4103 \line { \dynamic "mp"
4104 \text \italic "dolce" } }
4108 #(define-music-function
4109 (parser location string)
4111 #{ ^\markup \bold \box #string #})
4113 #(set-global-staff-size 23)
4117 \override MetronomeMark #'extra-offset = #'(-9 . 0)
4118 \override MetronomeMark #'padding = #'3
4121 \override Glissando #'thickness = #3
4122 \override Glissando #'gap = #0.1
4128 a4.\mpdolce d8 cis4--\glissando a |
4132 g8(\! fis)-. e( d)-. cis2 |
4136 Ahora, en la música, simplemente sustituyo @code{\include
4137 "definiciones.ily"} por @code{\include "publicar-web.ily"}. Por
4138 supuesto, podríamos hacer esto aún más práctico. Podríamos hacer un
4139 archivo @file{definiciones.ily} que contuviera solamente las
4140 definiciones de @code{mpdolce} y de @code{inst}, un archivo
4141 @file{publicar-web.ily} que contuviera solamente la sección
4142 @code{\layout} que se mostró en el ejemplo, y un archivo
4143 @file{universidad.ily} que contendría solamente los trucos para
4144 producir la salida que le gusta a mi profesor. El comienzo de
4145 @file{musica.ly} tendría entonces este aspecto:
4148 \include "definiciones.ily"
4150 %%% ¡Quitar el comentario de una sola de estas líneas!
4151 \include "publicar-web.ily"
4152 %\include "universidad.ily"
4155 Este enfoque puede ser útil incluso si va a producir sólo un conjunto
4156 de particellas. Yo utilizo media docena de archivos de @q{hojas de
4157 estilo} para mis proyectos. Comienzo todos los archivos de música con
4158 @code{\include "../global.ily"}, que contiene
4162 \version @w{"@version{}"}
4164 #(ly:set-option 'point-and-click #f)
4166 \include "../iniciar/iniciar-definiciones.ily"
4167 \include "../iniciar/iniciar-disposicion.ily"
4168 \include "../iniciar/iniciar-cabeceras.ily"
4169 \include "../iniciar/iniciar-papel.ily"
4173 @node Otras fuentes de información
4174 @subsection Otras fuentes de información
4175 @translationof Other sources of information
4177 La documentación del manual de Referencia de Funcionamiento Interno
4178 contiene montañas de información sobre LilyPond, pero se puede obtener
4179 más información aún leyendo los archivos internos de LilyPond. Para
4180 echarles un vistazo, en primer lugar debe buscar la carpeta
4181 correspondiente a su sistema. La ubicación de esta carpeta depende
4182 (a) de si consiguió el programa LilyPond descargando un binario
4183 precompilado desde el sitio web lilypond.org o si lo instaló mediante
4184 un gestor de paquetes (es decir, distribuido con GNU/Linux, o instalado
4185 bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
4186 qué sistema operativo está utilizando:
4189 @strong{Descargado de lilypond.org}
4196 @file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/@/share/lilypond/current/}
4203 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/@/Resources/share/lilypond/current/}
4206 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
4207 bien manteniendo pulsada la tecla de Control y haciendo click sobre la
4208 aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
4213 Mediante el Explorador de Windows, diríjase a
4215 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/@/share/lilypond/current/}
4220 @strong{Instalado mediante un gestor de paquetes o compilado a partir de la fuente}
4223 @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
4224 se encuentra determinado por su administrador de paquetes o guión
4225 @code{configure}, y @var{X.Y.Z} es el número de la versión de
4230 Dentro de esta carpeta, las dos subcarpetas interesantes son
4233 @item @file{ly/} - contiene archivos en formato LilyPond
4234 @item @file{scm/} - contiene archivos en formato Scheme
4237 Vamos a comenzar observando algunos archivos que están en @file{ly/}.
4238 Abra @file{ly/property-init.ly} con un editor de textos. El mismo que
4239 usaría normalmente para los archivos @file{.ly} servirá perfectamente.
4240 Este archivo contiene las definiciones de todas las instrucciones
4241 estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} y
4242 @code{\slurDotted}. Podrá ver que no son nada más que definiciones de
4243 variables que contienen una o varias instrucciones @code{\override}.
4244 Por ejemplo, @code{/tieDotted} está definido de tal forma que su valor
4249 \override Tie #'dash-period = #0.75
4250 \override Tie #'dash-fraction = #0.1
4254 Si no le gustan los valores predeterminados, estas instrucciones
4255 predefinidas se pueden redefinir con facilidad como cualquier otra
4256 variable, al principio de su archivo de código de entrada.
4258 Los siguientes son los archivos más útiles que se encuentran en
4261 @multitable @columnfractions .4 .6
4264 @item @file{ly/engraver-init.ly}
4265 @tab Definiciones de Contextos de grabadores
4266 @item @file{ly/paper-defaults-init.ly}
4267 @tab especificaciones de valores predeterminados relacionados con el papel
4268 @item @file{ly/performer-init.ly}
4269 @tab Definiciones de Contextos de interpretación
4270 @item @file{ly/property-init.ly}
4271 @tab Definiciones de todas las instrucciones predefinidas que son comunes
4272 @item @file{ly/spanner-init.ly}
4273 @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
4276 Otros ajustes (como las definiciones de las instrucciones de marcado)
4277 se almacenan como archivos @file{.scm} (de Scheme). El lenguaje de
4278 programación Scheme se utiliza para proporcionar un interfaz
4279 programable en el funcionamiento interno de LilyPond. Cualquier
4280 explicación adicional sobre estos archivos se encuentra por el momento
4281 fuera del ámbito de este manual, porque se requieren conocimientos del
4282 lenguaje Scheme. Se advierte a los usuarios que se necesita una
4283 importante cantidad de conocimientos técnicos o de tiempo para
4284 comprender el lenguaje Scheme y estos archivos (véase @rextend{Tutorial de Scheme}).
4286 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
4289 @multitable @columnfractions .4 .6
4292 @item @file{scm/auto-beam.scm}
4293 @tab Valores predeterminados de sub-barrado
4294 @item @file{scm/define-grobs.scm}
4295 @tab valores predeterminados de las propiedades de grobs
4296 @item @file{scm/define-markup-commands.scm}
4297 @tab Especificar todas las instrucciones de marcado
4298 @item @file{scm/midi.scm}
4299 @tab Ajustes predeterminados para la salida MIDI
4300 @item @file{scm/output-lib.scm}
4301 @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
4302 @item @file{scm/parser-clef.scm}
4303 @tab Definiciones de las claves contempladas
4304 @item @file{scm/script.scm}
4305 @tab Ajustes predeterminados para las articulaciones
4309 @node Trucos avanzados con Scheme
4310 @subsection Trucos avanzados con Scheme
4311 @translationof Advanced tweaks with Scheme
4313 Aunque es posible hacer muchas cosas con las instrucciones
4314 @code{\override} y @code{\tweak} , tenemos una forma incluso más
4315 poderosa de modificar el funcionamiento de LilyPond, a través de un
4316 interface programable hacia las operaciones internas de LilyPond. Se
4317 puede incorporar código escrito en el lenguaje de programación Scheme,
4318 directamente en el mecanismo de funcionamiento de LilyPond. Por
4319 supuesto, para hacer esto se necesitan al menos unos conocimientos
4320 básicos de programación en Scheme, y damos una introducción en el
4321 @rextend{Tutorial de Scheme}.
4323 Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
4324 dar a una propiedad un valor constante, se puede establecer al
4325 resultado de un procedimiento de Scheme que se invoca cada vez que
4326 LilyPond accede a esta propiedad. La propiedad se puede establecer
4327 dinámicamente a un valor determinado por el procedimiento en el
4328 momento en que se invoca. En este ejemplo damos a las cabezas de las
4329 notas un color que depende de su posición dentro del pentagrama.
4331 @cindex x11-color, función, ejemplo de utilización
4332 @cindex NoteHead, ejemplo de sobreescritura
4333 @cindex color, propiedad, establecer a procedimiento de Scheme
4335 @lilypond[quote,verbatim,ragged-right]
4336 #(define (color-notehead grob)
4337 "Color the notehead according to its position on the staff."
4338 (let ((mod-position (modulo (ly:grob-property grob 'staff-position)
4341 ;; Return rainbow colors
4342 ((1) (x11-color 'red )) ; for C
4343 ((2) (x11-color 'orange )) ; for D
4344 ((3) (x11-color 'yellow )) ; for E
4345 ((4) (x11-color 'green )) ; for F
4346 ((5) (x11-color 'blue )) ; for G
4347 ((6) (x11-color 'purple )) ; for A
4348 ((0) (x11-color 'violet )) ; for B
4352 % Arrange to obtain color from color-notehead procedure
4353 \override NoteHead #'color = #color-notehead
4354 a2 b | c2 d | e2 f | g2 a |
4358 Se pueden encontrar ejemplos adicionales que muestran la utilización
4359 de estos interfaces programables, en
4360 @rextendnamed{Callback functions,Funciones de callback}.