]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/es/learning/tweaks.itely
Merge branch 'master' into lilypond/translation
[lilypond.git] / Documentation / es / learning / tweaks.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2
3 @ignore
4     Translation of GIT committish: ba9298b3ea614367f3f463134bf49ba2cbd8c1fb
5
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..
9 @end ignore
10
11 @c \version "2.12.0"
12
13 @node Trucar la salida
14 @chapter Trucar la salida
15 @translationof Tweaking output
16
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.
19
20
21 @menu
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::
28 @end menu
29
30 @node Elementos de trucaje
31 @section Elementos de trucaje
32 @translationof Tweaking basics
33
34 @menu
35 * Introducción al trucaje::
36 * Objetos e interfaces::
37 * Convenciones de nombres de objetos y propiedades::
38 * Métodos de trucaje::
39 @end menu
40
41 @node Introducción al trucaje
42 @subsection Introducción al trucaje
43 @translationof Introduction to tweaks
44
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.
52
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.
59
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.
64
65 @node Objetos e interfaces
66 @subsection Objetos e interfaces
67 @translationof Objects and interfaces
68
69 @cindex objeto
70 @cindex grob
71 @cindex objeto de extensión
72 @cindex interfaz
73 @cindex propiedades de objetos
74 @cindex objeto, propiedades de
75 @cindex layout (disposición), objeto de
76 @cindex objeto de disposición (layout)
77
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.
82
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.
97
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.
106
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
113 @q{Spanners}.
114
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.
127
128 Estos son, en fin, los términos principales relativos a los objetos
129 que vamos a utilizar en este capítulo.
130
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
134
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
139
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.
149
150 @multitable @columnfractions .33 .33 .33
151 @headitem Objeto o tipo de propiedad
152   @tab Convención de nomenclatura
153   @tab Ejemplos
154 @item Contextos
155   @tab Aaaa o AaaaAaaaAaaa
156   @tab Staff, GrandStaff
157 @item Objetos de presentación
158   @tab Aaaa o AaaaAaaaAaaa
159   @tab Slur, NoteHead
160 @item Grabadores
161   @tab Aaaa_aaa_engraver
162   @tab Clef_engraver, Note_heads_engraver
163 @item Interfaces
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
172 @end multitable
173
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
177 propiedad.
178
179 @node Métodos de trucaje
180 @subsection Métodos de trucaje
181 @translationof Tweaking methods
182
183 @cindex trucaje, métodos de
184
185 @strong{La instrucción \override}
186
187 @cindex override, instrucción
188 @cindex override (sobreescritura), sintaxis de
189
190 @funindex \override
191 @funindex override
192
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} y @ref{Añadir y eliminar grabadores}.  Ahora debemos
196 examinar algunas otras instrucciones importantes.
197
198 La instrucción que cambia las propiedades de los @strong{objetos de
199 presentación} es @code{\override}.  Puesto que esta instrucción debe
200 modificar propiedades internas que se encuentran en un lugar profundo
201 dentro de LilyPond, su sintaxis no es tan simple como la del resto de
202 las instrucciones que hemos usado hasta ahora.  Tiene que saber
203 exactamente qué propiedad de qué objeto y en qué contexto se debe
204 modificar, y cuál debe ser su nuevo valor.  Veamos cómo se hace.
205
206 La sintaxis genérica de esta instrucción es:
207
208 @example
209 \override @var{Contexto}.@var{ObjetoDePresentación}  #'@var{propiedad-de-presentación} =
210 #@var{valor}
211 @end example
212
213 @noindent
214 Esto establecerá la propiedad de nombre
215 @var{propiedad-de-presentación} del objeto de presentación con el
216 nombre @var{ObjetoDePresentación}, que es miembro del contexto
217 @var{Contexto}, al valor @var{valor}.
218
219 El @var{contexto} se puede omitir (y normalmente así es) cuando el
220 contexto requerido se encuentra implicado sin ambigüedad y es uno de
221 los contextos del nivel más bajo, es decir: @code{Voice},
222 @code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
223 ejemplos siguientes.  Veremos más tarde cuándo se debe especificar.
224
225 Las últimas secciones tratan de forma exhaustiva las propiedades y sus
226 valores, pero para ilustrar el formato y utilización de estas
227 instrucciones usaremos sólo unas cuantas propiedades y valores
228 sencillos que sean fáciles de entender.
229
230 Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
231 propiedad de presentación, y el @code{#}, que debe preceder al valor.
232 Deben estar presentes siempre y de esa forma exacta.  Es la
233 instrucción de uso más común dentro del trucaje, y durante la mayor
234 parte del resto de este capítulo presentaremos ejemplos de cómo se
235 usa.  A continuación hay un ejemplo sencillo para cambiar el color de
236 una cabeza:
237
238 @cindex color, propiedad, ejemplo
239 @cindex NoteHead, ejemplo de sobreescritura
240
241 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
242 c d
243 \override NoteHead #'color = #red
244 e f g
245 \override NoteHead #'color = #green
246 a b c
247 @end lilypond
248
249 @strong{La instrucción \revert}
250
251 @cindex revert, instrucción
252
253 @funindex \revert
254 @funindex revert
255
256 Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
257 se sobreescribe de nuevo o se encuentra una instrucción
258 @code{\revert}.  La instrucción @code{\revert} tiene la siguiente
259 sintaxis y ocasiona que el valor de la propiedad se devuelva a su
260 valor predeterminado original; observe que no es a su valor previo si
261 se han utilizado varias instrucciones @code{\override}.
262
263 @example
264 \revert @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación}
265 @end example
266
267 Una vez más, igual que @var{Contexto} dentro de la instrucción
268 @code{\override}, con frecuencia no es necesario especificar el
269 @var{Contexto}.  Se omitirá en muchos de los ejemplos siguientes.
270 Aquí devolvemos el color de la cabeza al valor predeterminado para las
271 dos últimas notas:
272
273 @cindex color, propiedad, ejemplo
274 @cindex NoteHead, ejemplo de sobreescritura
275
276 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
277 c d
278 \override NoteHead #'color = #red
279 e f g
280 \override NoteHead #'color = #green
281 a
282 \revert NoteHead #'color
283 b c
284 @end lilypond
285
286 @strong{El prefijo \once}
287
288 @funindex \once
289 @funindex once
290
291 Tanto la instrucción @code{\override} como @code{\set} se pueden
292 preceder por @code{\once}.  Esto ocasiona que la siguiente instrucción
293 @code{\override} o @code{\set} sea efectiva solamente durante el
294 tiempo musical en curso y antes de que la propiedad vuelva a tener
295 otra vez su valor predeterminado.  Utilizando el mismo ejemplo,
296 podemos cambiar el color de una sola nota de la siguiente manera:
297
298 @cindex color, propiedad, ejemplo
299 @cindex NoteHead, ejemplo de sobreescritura
300
301 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
302 c d
303 \once \override NoteHead #'color = #red
304 e f g
305 \once \override NoteHead #'color = #green
306 a b c
307 @end lilypond
308
309 @strong{La instrucción \overrideProperty}
310
311 @cindex overrideProperty, instrucción
312
313 @funindex \overrideProperty
314 @funindex overrideProperty
315
316 Hay otra forma para la instrucción de sobreescritura,
317 @code{\overrideProperty}, que ocasionalmente es necesaria.  La
318 mencionamos aquí con un propósito de exhaustividad, pero para ver más
319 detalles consulte @rextend{Trucos difíciles}.
320 @c Maybe explain in a later iteration  -td
321
322 @strong{La instrucción \tweak}
323
324 @cindex tweak, instrucción
325
326 @funindex \tweak
327 @funindex tweak
328
329 La última instrucción de trucaje que está disponible es @code{\tweak}.
330 Se debe utilizar para cambiar las propiedades de objetos que suceden
331 en el mismo momento musical, como las notas de un acorde.  El uso de
332 @code{\override} para la sobreescritura afectaría a todas las notas
333 del acorde, mientras que @code{\tweak} afecta solamente al siguiente
334 elemento del flujo de entrada.
335
336 He aquí un ejemplo.  Suponga que queremos cambiar el tamaño de la
337 cabeza de la nota intermedia (el Mi) en un acorde de Do mayor.  En
338 primer lugar, veamos lo que haría @code{\once \override}:
339
340 @cindex font-size, propiedad, ejemplo
341 @cindex NoteHead, ejemplo de sobreescritura
342
343 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
344   <c e g>4
345   \once \override NoteHead #'font-size = #-3
346   <c e g>
347   <c e g>
348 @end lilypond
349
350 Vemos que la sobreescritura con override afecta a @emph{todas} las
351 cabezas de las notas del acorde.  Esto es así porque todas las notas
352 de un acorde ocurren en el mismo @emph{momento musical}, y la acción
353 de @code{\once} es aplicar la sobreescritura a todos los objetos de
354 presentación del tipo especificado que ocurren en el mismo momento
355 musical que la propia instrucción de sobreescritura @code{\override}.
356
357 La instrucción @code{\tweak} opera de una forma distinta.  Actúa sobre
358 el elemento inmediatamente siguiente dentro del flujo de entrada.  Sin
359 embargo, es efectivo solamente sobre objetos que se crean directamente
360 a partir del flujo de entrada, en esencia las cabezas y las
361 articulaciones; los objetos como las plicas y las alteraciones se
362 crean con posterioridad y no se pueden trucar de esta forma.  Es más,
363 cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
364 dentro de un acorde, es decir, dentro de ángulos simples, así que para
365 trucar una sola nota la instrucción @code{\tweak} se debe colocar
366 dentro de ángulos simples junto con la nota.
367
368 Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
369 se cambiaría de la siguiente forma:
370
371 @cindex font-size, propiedad, ejemplo
372 @cindex @code{\tweak}, ejemplo
373
374 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
375   <c e g>4
376   <c \tweak #'font-size #-3 e g>4
377 @end lilypond
378
379 Observe que la sintaxis de @code{\tweak} no es igual que la de
380 @code{\override}.  Ni el contexto ni el objeto de presentación se
381 deben especificar; de hecho, generaría un error hacerlo.  Los dos
382 están implícitos por el siguiente elemento del flujo de entrada.
383 Observe también que no debe haber un signo igual. Así que la sintaxis
384 genérica de la instrucción @code{\tweak} es, simplemente,
385
386 @example
387 \tweak #'@var{propiedad-de-presentación} #@var{valor}
388 @end example
389
390 Una instrucción @code{\tweak} también se puede usar para modificar
391 sólo una de una serie de articulaciones, como se muestra aquí:
392
393 @cindex color, propiedad, ejemplo
394 @cindex @code{\tweak}, ejemplo
395
396 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
397 a ^Black
398   -\tweak #'color #red ^Red
399   -\tweak #'color #green _Green
400 @end lilypond
401
402 @noindent
403 Observe que la instrucción @code{\tweak} debe venir precedida de una
404 marca de articulación como si ella misma fuera una articulación.
405
406 @cindex grupos especiales anidados
407 @cindex tresillos anidados
408 @cindex corchete del grupo especial
409 @cindex corchete de tresillo
410 @cindex grupo especial, corchete de
411 @cindex tresillo, corchete de
412
413 @funindex TupletBracket
414
415 La instrucción @code{\tweak} también se debe usar para cambiar la
416 apariencia de uno solo de un conjunto de grupos especiales anidados
417 que comiencen en el mismo instante musical.  En el siguiente ejemplo,
418 el corchete del tresillo largo y el primero de los tres corchetes
419 cortos empiezan en el mismo momento musical, y por ello cualquier
420 instrucción @code{\override} se aplicaría a los dos.  En el ejemplo se
421 usa @code{\tweak} para distinguir entre ellos.  La primera instrucción
422 @code{\tweak} especifica que el corchete del tresillo largo se debe
423 colocar por encima de las notas y el segundo especifica que el número
424 del tresillo se debe imprimir en rojo sobre el corchete del primer
425 tresillo corto.
426
427 @cindex @code{\tweak}, ejemplo
428 @cindex direction, propiedad, ejemplo
429 @cindex color, propiedad, ejemplo
430
431 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
432 \tweak #'direction #up
433 \times 4/3 {
434   \tweak #'color #red
435   \times 2/3 { c8[ c8 c8] }
436   \times 2/3 { c8[ c8 c8] }
437   \times 2/3 { c8[ c8 c8] }
438 }
439 @end lilypond
440
441 Si los grupos anidados no comienzan en el mismo momento, su apariencia
442 se puede modificar de la forma usual mediante instrucciones
443 @code{\override}:
444
445 @cindex text, propiedad, ejemplo
446 @cindex tuplet-number, función, ejemplo
447 @cindex transparent, propiedad, ejemplo
448 @cindex TupletNumber, ejemplo de sobreescritura
449
450 @c NOTE Tuplet brackets collide if notes are high on staff
451 @c See issue 509
452 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
453 \times 2/3 { c8[ c c] }
454 \once \override TupletNumber
455   #'text = #tuplet-number::calc-fraction-text
456 \times 2/3 {
457   c[ c]
458   c[ c]
459   \once \override TupletNumber #'transparent = ##t
460   \times 2/3 { c8[ c c] }
461   \times 2/3 { c8[ c c] }
462 }
463 @end lilypond
464
465
466 @seealso
467 Referencia de la notación:
468 @ruser{La instrucción tweak}.
469
470
471 @node Manual de referencia de funcionamiento interno
472 @section Manual de referencia de funcionamiento interno
473 @translationof The Internals Reference manual
474
475 @cindex Internals Reference
476
477 @menu
478 * Propiedades de los objetos de presentación::
479 * Propiedades de los interfaces::
480 * Tipos de propiedades::
481 @end menu
482
483 @node Propiedades de los objetos de presentación
484 @subsection Propiedades de los objetos de presentación
485 @translationof Properties of layout objects
486
487 @cindex propiedades de los objetos de presentación
488 @cindex propiedades de los grobs
489 @cindex grobs, propiedades de
490 @cindex presentación, propiedades de los objetos de
491 @cindex Referencia de funcionamiento interno
492
493 Suponga que tiene una partitura con una ligadura de expresión que para
494 su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
495 debe proceder?  Ya sabe, por las afirmaciones anteriores acerca de la
496 flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
497 piensa que una cierta instrucción de sobreescritura @code{\override}
498 será necesaria.  Pero ¿existe una propiedad de grosor para las
499 ligaduras? y, si la hay, ¿cómo se puede modificar?  Aquí es donde
500 interviene el Manual de Funcionamiento Interno.  Contiene toda la
501 información que puede necesitar para construir ésta y todas las demás
502 instrucciones @code{\override}, de sobreescritura.
503
504 Una advertencia antes de dirigir nuestra mirada a la referencia de
505 funcionamiento interno.  Éste es un documento de @strong{referencia},
506 lo que significa que hay pocas o ninguna explicación en él: su
507 propósito es presentar la información de forma precisa y concisa.  Por
508 tanto, podrá parecerle desalentador a primera vista.  ¡No se preocupe!
509 La guía y las explicaciones que presentamos aquí le permitirán extraer
510 la información de la referencia de funcionamiento interno por sí mismo
511 con tan sólo algo de práctica.
512
513 @cindex sobreescritura, ejemplo de
514 @cindex Referencia de Funcionamiento Interno, ejemplo de utilización
515 @cindex @code{\addlyrics}, ejemplo
516
517
518 Utilicemos un ejemplo concreto con un sencillo fragmento de música
519 real:
520
521 @lilypond[quote,verbatim,relative=2]
522 {
523   \time 6/8
524   {
525     r4 b8 b[( g]) g
526     g4[( e]) e d[( f]) a
527     a4 g
528   }
529   \addlyrics {
530     The man who feels love's sweet e -- mo -- tion
531   }
532 }
533 @end lilypond
534
535 Suponga ahora que decidimos que nos gustan las ligaduras algo más
536 gruesas.  ¿Es posible?  La ligadura es, ciertamente, un objeto de
537 presentación, así que la cuestión es @q{¿Hay una propiedad
538 perteneciente a las ligaduras de expresión que controle su grosor?}
539 Para responder a esta pregunta debemos mirar el manual de Referencia
540 de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
541 (Internals Reference) en inglés}.
542
543 El RFI de la versión de LilyPond que está usando se puede encontrar en
544 la página web de LilyPond en @uref{http://lilypond.org}.  Vaya a la
545 página de la documentación y siga el enlace Manual de Referencia de
546 Funcionamiento Interno (RFI).  Para nuestros propósitos pedagógicos
547 sería mejor que utilizase la versión en HTML, no la @q{en una sola
548 página} ni el PDF.  Para que los siguientes párrafos tengan algún
549 sentido deberá consultarlo realmente al tiempo que lee.
550
551 @c Link names in English as those pages are not yet translated. FV
552 Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
553 Seleccione el enlace @emph{Backend}, que es donde se encuentra la
554 información sobre los objetos de presentación.  Una vez allí, bajo el
555 encabezamiento @strong{Backend}, siga el enlace @emph{All layout
556 objects}.  La página que aparece relaciona todos los objetos de
557 presentación que se usan en su versión de LilyPond, en orden
558 alfabético.  Siga el enlace Slur (ligadura de expresión), y aparecerán
559 relacionadas las propiedades de las ligaduras de expresión o Slurs.
560
561 Una forma alternativa de encontrar esta página es a partir de la
562 Referencia de la Notación.  En una de las páginas que tratan de las
563 ligaduras de expresión podrá encontrar un enlace al manual de
564 referencia del funcionamiento interno.  Este enlace le llevará
565 directamente a esta página, aunque si tiene una idea del nombre del
566 objeto de presentación que pretende trucar, le resultará más fácil ir
567 directamente al RFI y buscar allí.
568
569 Esta página sobre las ligaduras de expresión dentro del manual RFI nos
570 dice en primer lugar que los objetos Slur se crean por el grabador
571 Slur_engraver.  A continuación relaciona los ajustes estándar.
572 Observe que @strong{no} están en orden alfabético.  Navegue hacia
573 abajo buscando una propiedad que pudiera controlar el grosor de las
574 ligaduras, y encontrará
575
576 @example
577 @code{thickness} (number)
578      @code{1.2}
579      Line thickness, generally measured in @code{line-thickness}
580 @end example
581
582 Esto promete ser una buena opción para cambiar el grosor.  Nos dice
583 que el valor de @code{thickness} es un simple @emph{número}, que el
584 valor predeterminado es 1.2, y que las unidades están dentro de otra
585 propiedad llamada @code{line-thickness}.
586
587 Como dijimos con anterioridad, existen entre pocas y ninguna
588 explicación en el RFI, pero ya tenemos información suficiente para
589 probar a cambiar el grosor de la ligadura.  Vemos que el nombre del
590 objeto de presentación es @code{Slur}, que el nombre de la propiedad
591 que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
592 un número algo más grande que 1.2 si queremos hacer las ligaduras más
593 gruesas.
594
595 Ahora podemos construir la instrucción de sobreescritura
596 @code{\override} simplemente mediante la sustitución de los valores
597 que hemos encontrado para los nombres, omitiendo el contexto.
598 Usaremos un valor muy grande para el grosor al principio, para estar
599 seguros de que la instrucción está funcionando.  Obtenemos lo
600 siguiente:
601
602 @example
603 \override Slur #'thickness = #5.0
604 @end example
605
606 ¡No olvide el @code{#'} antes del nombre de la propiedad y @code{#}
607 antes del valor nuevo!
608
609 La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
610 Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
611 respuesta es: @q{Dentro de la música, antes de la primera ligadura y
612 cerca de ella.}  Hagámoslo así:
613
614 @cindex Slur, ejemplo de sobreescritura
615 @cindex thickness, propiedad, ejemplo
616
617 @lilypond[quote,verbatim,relative=2]
618 {
619   \time 6/8
620   {
621     % Increase thickness of all following slurs from 1.2 to 5.0
622     \override Slur #'thickness = #5.0
623     r4 b8 b[( g]) g
624     g4[( e]) e d[( f]) a
625     a4 g
626   }
627   \addlyrics {
628     The man who feels love's sweet e -- mo -- tion
629   }
630 }
631 @end lilypond
632
633 @noindent
634 y podemos ver que la ligadura, es sin duda, más pesada.
635
636 Así pues, ésta es la forma básica de construir instrucciones
637 @code{\override} o de sobreescritura.  Existen unas cuantas
638 complicaciones más con las que nos encontraremos en secciones
639 posteriores, pero ahora conoce todos los principios esenciales que
640 necesita para hacerlo por sí mismo (aunque aún necesita algo de
641 práctica).  La cual vendrá proporcionada por los ejemplos que vienen a
642 continuación.
643
644 @subheading Búsqueda del contexto
645
646 @cindex contexto, encontrar
647 @cindex contexto, buscar el, correcto
648
649 Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
650 especificar el contexto? ¿Cuál sería?  Podemos suponer que las
651 ligaduras están en el contexto de Voz, por estar claramente asociados
652 de manera estrecha con las líneas individuales de música, pero
653 ¿podemos estar seguros?  Para averiguarlo, vayamos de nuevo al inicio
654 de la página del RFI que describe las ligaduras (Slur), donde dice
655 @q{Slur objects are created by: Slur engraver} («Los objetos de
656 ligadura de expresión se crean por: el grabador Slur»).  Así pues, las
657 ligaduras de expresión se crean en cualquier contexto en el que se
658 encuentre el grabador @code{Slur_engraver}.  Siga el enlace a la
659 página del grabador @code{Slur_engraver}.  Al final del todo, dice que
660 el grabador @code{Slur_engraver} es parte de cinco contextos de voz,
661 incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
662 suposición era acertada.  Y a causa de que @code{Voice} es uno de los
663 contextos de más bajo nivel que se encuentra implícito sin ambigüedad
664 por el hecho de que estamos escribiendo notas, podemos omitirlo en
665 este lugar concreto.
666
667 @subheading Sobreescritura por una sola vez
668
669 @cindex sobreescritura por una sola vez
670 @cindex once override
671
672 @funindex \once
673 @funindex once
674
675 Como puede ver, @emph{todas} las ligaduras son más gruesas en el
676 último ejemplo.  Pero ¿y si quisiéramos que solamente la primera
677 ligadura fuese más gruesa?  Esto se consigue con la instrucción o
678 prefijo @code{\once}.  Colocado inmediatamente antes de la instrucción
679 @code{\override} ocasiona que solamente cambie la ligadura que
680 comienza en la nota @strong{inmediata siguiente}.  Si la nota
681 inmediata siguiente no da inicio a una ligadura, la instrucción no
682 tiene ningún efecto en absoluto: no se recuerda hasta que se
683 encuentre alguna ligadura, sino que simplemente se ignora.  Así pues,
684 la instrucción que lleva @code{\once} se debe reposicionar de la forma
685 siguiente:
686
687 @cindex Slur, ejemplo de sobreescritura
688 @cindex thickness, propiedad, ejemplo
689
690 @lilypond[quote,verbatim,relative=2]
691 {
692   \time 6/8
693   {
694     r4 b8
695     % Increase thickness of immediately following slur only
696     \once \override Slur #'thickness = #5.0
697     b4[( g]) g
698     g4[( e]) e d[( f]) a
699     a4 g
700   }
701   \addlyrics {
702     The man who feels love's sweet e -- mo -- tion
703   }
704 }
705 @end lilypond
706
707 @noindent
708 Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
709
710 La instrucción o prefijo @code{\once} también se puede usar antes de
711 la instrucción @code{\set}.
712
713 @subheading Recuperación del ajuste
714
715 @cindex revertir
716 @cindex predeterminadas, recuperar las propiedades
717
718 @funindex \revert
719 @funindex revert
720
721 Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
722 fuesen más gruesas?  En fin; podríamos usar dos instrucciones, cada
723 una de ellas precedida por el prefijo @code{\once}, situadas
724 inmediatamente antes de cada una de las notas en que comienzan las
725 ligaduras:
726
727 @cindex Slur, ejemplo de sobreescritura
728 @cindex thickness, propiedad, ejemplo
729
730 @lilypond[quote,verbatim,relative=2]
731 {
732   \time 6/8
733   {
734     r4 b8
735     % Increase thickness of immediately following slur only
736     \once \override Slur #'thickness = #5.0
737     b4[( g]) g
738     % Increase thickness of immediately following slur only
739     \once \override Slur #'thickness = #5.0
740     g4[( e]) e d[( f]) a
741     a4 g
742   }
743   \addlyrics {
744     The man who feels love's sweet e -- mo -- tion
745   }
746 }
747 @end lilypond
748
749 @noindent
750 o podríamos omitir la instrucción prefija @code{\once} y utilizar la
751 instrucción @code{\revert} (restablecer) para devolver la propiedad
752 del grosor, @code{thickness}, a su valor predeterminado después de la
753 segunda ligadura:
754
755 @cindex Slur, ejemplo de sobreescritura
756 @cindex thickness, propiedad, ejemplo
757
758 @lilypond[quote,verbatim,relative=2]
759 {
760   \time 6/8
761   {
762     r4 b8
763     % Increase thickness of all following slurs from 1.2 to 5.0
764     \override Slur #'thickness = #5.0
765     b4[( g]) g
766     g4[( e])
767     % Revert thickness of all following slurs to default of 1.2
768     \revert Slur #'thickness
769     e4 d[( f]) a
770     a4 g
771   }
772   \addlyrics {
773     The man who feels love's sweet e -- mo -- tion
774   }
775 }
776 @end lilypond
777
778 @noindent
779 la instrucción @code{\revert} se puede utilizar para devolver
780 cualquier propiedad que se haya cambiado con @code{\override} a su
781 valor predeterminado.  Puede utilizar el método que mejor se adapte a
782 aquello que quiere hacer.
783
784 Así finaliza nuestra introducción al manual de RFI, y el método básico
785 de trucaje.  A continuación, en las últimas secciones de este capítulo
786 encontrará varios ejemplos, en parte para introducirle en algunas de
787 las posibilidades adicionales del manual RFI, y en parte para
788 proporcionarle más práctica en cómo extraer información de él.  Estos
789 ejemplos irán conteniendo cada vez menos palabras de guía y
790 explicación.
791
792 @node Propiedades de los interfaces
793 @subsection Propiedades de los interfaces
794 @translationof Properties found in interfaces
795
796 @cindex interface
797 @cindex propiedades de los interfaces
798 @cindex interfaces, propiedades
799
800 Suponga ahora que queremos imprimir la letra de la canción en cursiva.
801 ¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
802 En primer lugar miramos en la página del RFI que relaciona todos los
803 objetos, @q{All layout objects}, como antes, y buscamos un objeto que
804 pueda controlar la letra de la canción.  Encontramos @code{LyricText},
805 que parece adecuado.  Al seguir este enlace se presentan las
806 propiedades ajustables para el texto de la letra.  Estos incluyen
807 @code{font-series} y @code{font-size}, pero nada que pudiera aplicar
808 una forma cursiva.  Esto es porque la propiedad de la forma es común a
809 todos los objetos de fuente tipográfica, y por tanto, en vez de
810 incluirlo en cada uno de los objetos de presentación, se agrupa junto
811 con otras propiedades comunes similares y se deposita en un
812 @strong{Interface}, el interface de las fuentes tipográficas
813 @code{font-interface}.
814
815 Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
816 de los interfaces, y descubrir qué objetos usan estas propiedades de
817 interface.
818
819 Mire de nuevo la página del RFI que describe a LyricText.  Al final de
820 la página hay una lista de enlaces a los interfaces que LyricText
821 contempla.  La lista tiene siete elementos, entre ellos
822 @code{font-interface}.  Al seguir este enlace llegamos a las
823 propiedades asociadas con este interface, que también son propiedades
824 de todos los objetos que lo llevan, entre ellos LyricText.
825
826 Ahora vemos todas las propiedades ajustables por el usuario que
827 controlan las tipografías, entre ellas @code{font-shape(symbol)},
828 donde @code{symbol} se puede establecer a @code{upright} (recta),
829 @code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
830
831 Observará que @code{font-series} y @code{font-size} también se
832 encuentran aquí relacionadas.  Esto inmediatamente hace que surja la
833 pregunta: ¿Por qué están las propiedades comunes de tipografía
834 @code{font-series} y @code{font-size} relacionadas bajo
835 @code{LyricText} así como bajo el interface @code{font-interface} pero
836 @code{font-shape} no lo está?  La respuesta es que @code{font-series}
837 y @code{font-size} se cambian a partir de sus valores predeterminados
838 globales cuando se crea un objeto @code{LyricText}, pero
839 @code{font-shape} no lo hace.  Entonces los elementos de la lista
840 @code{LyricText} le dicen los valores para esas dos propiedades que
841 son de aplicación para @code{LyricText}.  Otros objetos que contemplan
842 @code{font-interface} establecerán dichas propiedades de forma
843 diferente cuando se crean.
844
845 Veamos si ahora podemos construir la instrucción @code{\override} para
846 cambiar la letra a cursiva.  El objeto es @code{LyricText}, la
847 propiedad es @code{font-shape} y el valor es @code{italic}.  Igual que
848 antes, omitiremos el contexto.
849
850 Como nota aparte, aunque una nota importante, observe que a causa de
851 que los valores de @code{font-shape} son símbolos, deben ir precedidos
852 de un apóstrofo, @code{'}.  Esa es la razón por la que se necesitan
853 apóstrofos antes de @code{thickness} en el ejemplo anterior y en
854 @code{font-shape}.  Los dos son también símbolos.  Los símbolos son
855 nombres especiales que son conocidos por LilyPond internamente.
856 Algunos de ellos son nombres de propiedades, como @code{thickness} o
857 @code{font-shape}, otros se utilizan como valores que se les puede dar
858 a las propiedades, como @code{italic}.  Observe la distinción entre
859 esto y las cadenas de texto arbitrarias, que aparecerían
860 entrecomilladas como @code{"a text string"}.  Para ver más detalles
861 relacionados con los símbolos y las cadenas, consulte
862 @rextend{Tutorial de Scheme}.
863
864 Así pues, la instrucción @code{\override} necesaria para imprimir la
865 letra en cursiva, es:
866
867 @example
868 \override LyricText #'font-shape = #'italic
869 @end example
870
871 @noindent
872 Esto debe escribirse justo delante de la letra a la que debe afectar,
873 de esta forma:
874
875 @cindex font-shape, propiedad, ejemplo
876 @cindex italic, ejemplo
877 @cindex LyricText, ejemplo de sobreescritura
878 @cindex @code{\addlyrics}, ejemplo
879
880 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
881 {
882   \time 6/8
883   {
884     r4 b8 b[( g]) g
885     g4[( e]) e d[( f]) a
886     a4 g
887   }
888   \addlyrics {
889     \override LyricText #'font-shape = #'italic
890     The man who feels love's sweet e -- mo -- tion
891   }
892 }
893 @end lilypond
894
895 @noindent
896 y toda la letra se imprime en cursiva.
897
898 @subheading Especificación del contexto en modo letra
899
900 @cindex contexto, especificación en modo letra
901 @cindex letra, modo, especificar el contexto en
902
903 En el caso de la letra, si intenta especificar el contexto en el
904 formato que acabamos de dar, la instrucción no funcionará.  Una
905 sílaba escrita en el modo letra, «lyricmode» termina en un espacio, un
906 salto de línea o un dígito.  Cualquier otro carácter se incluye como
907 parte de la sílaba.  Por esta razón, un espacio o salto de línea debe
908 aparecer antes del último símbolo @code{@}} para evitar que se incluya
909 como parte de la sílaba final.  De forma similar, se deben insertar
910 espacios antes y después del punto, @q{.}, separando el nombre del
911 contexto del nombre del objeto, pues en caso contrario los dos nombres
912 se juntarán y el intérprete no podrá reconocerlos.  Así pues, la
913 instrucción será:
914
915 @example
916 \override Lyrics . LyricText #'font-shape = #'italic
917 @end example
918
919 @warning{Dentro de la letra, deje siempre espacios entre la sílaba
920 final y la llave de cierre.}
921
922 @warning{En las sobreescrituras con override dentro de la letra,
923 escriba siempre espacios antes y después del punto que separa el
924 nombre del contexto y el nombre del objeto.}
925
926
927 @seealso
928 Manual de Extensión:
929 @rextend{Tutorial de Scheme}.
930
931
932 @node Tipos de propiedades
933 @subsection Tipos de propiedades
934 @translationof Types of properties
935
936 @cindex propiedades, tipos de
937
938 Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
939 @code{símbolo}.  Para que sea válido, el valor que se da a una
940 propiedad debe ser del tipo correcto y obedecer las reglas de dicho
941 tipo.  El tipo de la propiedad se muestra siempre entre paréntesis
942 después del nombre de la propiedad en el RFI.  He aquí una lista de
943 los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
944 algunos ejemplos.  Debe escribir siempre un símbolo de almohadilla,
945 @code{#}, por supuesto, delante de estos valores cuando se introducen
946 en la instrucción @code{\override}.
947
948 @multitable @columnfractions .2 .45 .35
949 @headitem Tipo de propiedad
950   @tab Reglas
951   @tab Ejemplos
952 @item Booleano
953   @tab Verdadero o Falso, representado por #t o #f
954   @tab @code{#t}, @code{#f}
955 @item Dimensión (en espacios de pentagrama)
956   @tab Un número decimal positivo (en unidades de espacios de pentagrama)
957   @tab @code{2.5}, @code{0.34}
958 @item Dirección
959   @tab Una constante válida de dirección o su equivalente numérico (se permiten valores decimales entre -1 y 1)
960   @tab @code{LEFT}, @code{CENTER}, @code{UP},
961        @code{1}, @code{-1}
962 @item Entero
963   @tab Un número entero positivo
964   @tab @code{3}, @code{1}
965 @item Lista
966   @tab Un conjunto de valores separados por espacios, encerrado entre paréntesis y precedido de un apóstrofo
967   @tab @code{'(left-edge staff-bar)}, @code{'(1)},
968        @code{'(1.0 0.25 0.5)}
969 @item Marcado
970   @tab Cualquier elemento válido de marcado de texto
971   @tab @code{\markup @{ \italic "cresc." @}}
972 @item Momento
973   @tab Una fracción de redonda construida con la función make-moment
974   @tab @code{(ly:make-moment 1 4)},
975        @code{(ly:make-moment 3 8)}
976 @item Número
977   @tab Cualquier valor decimal positivo o negativo
978   @tab @code{3.5}, @code{-2.45}
979 @item Pareja (de números)
980   @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
981   @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
982 @item Símbolo
983   @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
984   @tab @code{'italic}, @code{'inside}
985 @item Desconocido
986   @tab Un procedimiento o @code{#f} para no producir ninguna acción
987   @tab @code{bend::print}, @code{ly:text-interface::print},
988        @code{#f}
989 @item Vector
990   @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofo-almohadilla, @code{'#}.
991   @tab @code{'#(#t #t #f)}
992 @end multitable
993
994
995 @seealso
996 Manual de Extensión:
997 @rextend{Tutorial de Scheme}.
998
999
1000 @node Apariencia de los objetos
1001 @section Apariencia de los objetos
1002 @translationof Appearance of objects
1003
1004 Ahora vamos a poner en práctica lo que hemos aprendido con unos
1005 cuantos ejemplos que muestran cómo se pueden usar los trucos para
1006 cambiar el aspecto de la música impresa.
1007
1008 @menu
1009 * Visibilidad y color de los objetos::
1010 * Tamaño de los objetos::
1011 * Longitud y grosor de los objetos::
1012 @end menu
1013
1014 @node Visibilidad y color de los objetos
1015 @subsection Visibilidad y color de los objetos
1016 @translationof Visibility and color of objects
1017
1018 Dentro de un uso educativo de la música, podríamos desear imprimir una
1019 partitura con ciertos elementos omitidos como ejercicio para el
1020 alumno, a quien se le pide que los complete.  A la manera de ejemplo
1021 sencillo, supongamos que el ejercicio es escribir las líneas
1022 divisorias que faltan en un fragmento musical.  Pero las líneas
1023 divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
1024 que no se impriman?
1025
1026 Antes de enredarnos con esto, recordemos que las propiedades de los
1027 objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
1028 @ref{Propiedades de los interfaces}).  Esto es simplemente agrupar
1029 las propiedades que se pueden usar juntas para trucar un objeto
1030 gráfico: si una de ellas se necesita para un objeto, también las
1031 otras.  Así, ciertos objetos usan las propiedades de algunos
1032 interfaces, otros usan las de otros interfaces.  Los interfaces que
1033 contienen las propiedades que un determinado grob necesita se
1034 encuentran relacionadas en el manual RFI al final de la página que
1035 describe dicho grob, y esas propiedades se pueden ver mirando dichos
1036 interfaces.
1037
1038 Hemos explicado cómo encontrar información sobre los grobs en
1039 @ref{Propiedades de los objetos de presentación}.  Usando el mismo enfoque, vamos al
1040 RFI para buscar el objeto de presentación que imprime las líneas
1041 divisorias.  A través del enlace @emph{Backend} y @emph{All layout
1042 objects} encontramos que hay un objeto de presentación llamado
1043 @code{BarLine}.  Entre sus propiedades se encuentran dos que controlan
1044 la visibilidad: @code{break-visibility} y @code{stencil}.  Las líneas
1045 divisorias también contemplan un número de interfaces, entre ellos el
1046 @code{grob-interface}, donde podemos encontrar las propiedades
1047 @code{transparent} y @code{color}.  Todas ellas pueden afectar la
1048 visibilidad de las barras de compás (y, por supuesto, por extensión,
1049 también la de muchos otros objetos de presentación).  Vamos a
1050 considerar cada uno de ellos por orden.
1051
1052 @subheading stencil (sello)
1053
1054 @cindex stencil (sello), propiedad
1055
1056 Esta propiedad controla la apariencia de las barras de compás mediante
1057 la especificación del símbolo (o «glifo») que se debe imprimir.  Igual
1058 que como otras muchas propiedades, se puede establecer de forma que no
1059 imprima nada ajustando su valor a @code{#f}.  Vamos a probarlo, como
1060 antes, omitiendo el Contexto implícito, @code{Voice}:
1061
1062 @cindex BarLine, ejemplo de sobreescritura
1063 @cindex stencil, propiedad, ejemplo
1064
1065 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1066 {
1067   \time 12/16
1068   \override BarLine #'stencil = ##f
1069   c4 b8 c d16 c d8
1070   g,8 a16 b8 c d4 e16
1071   e8
1072 }
1073 @end lilypond
1074
1075 Las barras de compás todavía se imprimen.  ¿Qué es lo que está mal?
1076 Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
1077 objeto BarLine.  Al principio de la página dice @qq{Barline objects
1078 are created by: Bar_engraver} (los objetos Barline se crean por el
1079 grabador Bar_engraver).  Vaya a la página del grabador
1080 @code{Bar_engraver} siguiendo el enlace.  Al final da una lista de
1081 contextos en los que el grabador de líneas divisorias opera.  Todos
1082 ellos son del tipo @code{Staff}, y así la razón de que la instrucción
1083 @code{\override} no funcionara como esperábamos, es porque
1084 @code{Barline} no se encuentra en el contexto predeterminado
1085 @code{Voice}.  Si el contexto no se especifica correctamente, la
1086 instrucción simplemente no funciona.  No se produce ningún mensaje de
1087 error, y no se registra nada en el archivo log de registro.  Vamos a
1088 intentar corregirlo escribiendo el contexto correcto:
1089
1090 @cindex BarLine, ejemplo de sobreescritura
1091 @cindex stencil, propiedad, ejemplo
1092
1093 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1094 {
1095   \time 12/16
1096   \override Staff.BarLine #'stencil = ##f
1097   c4 b8 c d16 c d8
1098   g,8 a16 b8 c d4 e16
1099   e8
1100 }
1101 @end lilypond
1102
1103 Ahora las barras de compás han desaparecido.
1104
1105 Sin embargo, observe que el establecimiento de la propiedad
1106 @code{stencil} al valor @code{#f} produce errores cuando las se
1107 requieren las dimensiones del objeto para un procesamiento correcto.
1108 Por ejemplo, se generan errores si la propiedad @code{stencil} del
1109 objeto @code{NoteHead} se establece al valor @code{#f}.  Si es el
1110 caso, podemos en vez de ello utilizar la función @code{point-stencil},
1111 que establece el sello a un objeto con tamaño nulo:
1112
1113 @lilypond[quote,verbatim,relative=2]
1114 {
1115   c c
1116   \once \override NoteHead #'stencil = #point-stencil
1117   c c
1118 }
1119 @end lilypond
1120
1121 @subheading break-visibility (visibilidad en el salto)
1122
1123 @cindex break-visibility, propiedad
1124
1125 Vemos en las propiedades de @code{BarLine} que aparecen en el RFI que
1126 la propiedad @code{break-visibility} requiere un vector de tres
1127 valores booleanos.  Controlan respectivamente si las barras de compás
1128 se imprimen al final de una línea, en mitad de una línea, y al
1129 principio de las líneas.  Para nuestro ejemplo, queremos que todas las
1130 barras de compás se supriman, por lo que el valor que necesitamos es
1131 @code{'#(#f #f #f)}.  Vamos a probarlo, recordando incluir el contexto
1132 de @code{Staff}.  Observe también que al escribir este valor tenemos
1133 @code{#'#} antes del paréntesis de apertura.  Se necesita @code{'#}
1134 como parte del valor para introducir un vector, y el primer símbolo de
1135 almohadilla @code{#} se necesita, como siempre, para preceder el valor
1136 en sí dentro de la instrucción @code{\override}.
1137
1138 @cindex BarLine, ejemplo de sobreescritura
1139 @cindex break-visibility, propiedad, ejemplo
1140
1141 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1142 {
1143   \time 12/16
1144   \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
1145   c4 b8 c d16 c d8
1146   g,8 a16 b8 c d4 e16
1147   e8
1148 }
1149 @end lilypond
1150
1151 Y podemos ver que esto también quita todas las líneas divisorias.
1152
1153 @subheading transparent (transparente)
1154
1155 @cindex transparent, propiedad
1156 @cindex transparencia
1157
1158 En la relación de propiedades que se especifican en la página del
1159 @code{grob-interface} del RFI podemos ver que la propiedad
1160 @code{transparent} es un valor booleano.  Esto se debe establecer a
1161 @code{#t} para hacer que el grob sea transparente.  En el ejemplo
1162 siguiente vamos a hacer que la indicación de compás, y no las líneas
1163 divisorias, sea transparente.  Para hacerlo tenemos que buscar el
1164 nombre del grob de la indicación de compás.  Volviendo a la página
1165 @q{All layout objects} del RFI, buscamos las propiedades del objeto de
1166 presentación @code{TimeSignature}.  Se produce por parte del grabador
1167 @code{Time_signature_engraver} que como puede comprobar vive dentro
1168 del contexto de @code{Staff} y también contempla el interface
1169 @code{grob-interface}.  Así pues, la instrucción que hace transparente
1170 a la indicación de compás es:
1171
1172 @cindex TimeSignature, ejemplo de sobreescritura
1173 @cindex transparent, propiedad, ejemplo
1174
1175 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1176 {
1177   \time 12/16
1178   \override Staff.TimeSignature #'transparent = ##t
1179   c4 b8 c d16 c d8
1180   g,8 a16 b8 c d4 e16
1181   e8
1182 }
1183 @end lilypond
1184
1185 @noindent
1186 El compás ya no está, pero esta instrucción deja una separación en el
1187 lugar donde antes estaba la indicación de compás.  Quizá esto es lo
1188 que queremos para un ejercicio en que el alumno deba escribirlo, pero
1189 en otras circunstancias esta separación podría no ser deseable.  En
1190 vez de eso, para quitarla, el stencil o «sello» de la indicación de
1191 compás se debe establecer al valor @code{#f}:
1192
1193 @cindex TimeSignature, ejemplo de sobreescritura
1194 @cindex stencil, propiedad, ejemplo
1195
1196 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1197 {
1198   \time 12/16
1199   \override Staff.TimeSignature #'stencil = ##f
1200   c4 b8 c d16 c d8
1201   g,8 a16 b8 c d4 e16
1202   e8
1203 }
1204 @end lilypond
1205
1206 @noindent
1207 y la diferencia es obvia: al establecer el sello al valor @code{#f}
1208 quitamos el objeto por completo; al hacer el objeto @code{transparent}
1209 lo dejamos donde está, pero lo hacemos invisible.
1210
1211 @subheading color
1212
1213 @cindex color, propiedad
1214
1215 Para finalizar, intentemos hacer invisibles las barras de compás
1216 pintándolas de color blanco (hay un problema relacionado, que consiste
1217 en que la línea divisoria blanca puede tapar o no tapar las líneas del
1218 pentagrama a las que cruza.  Podrá observar en algunos de los ejemplos
1219 que aparecen a continuación, que esto sucede de forma impredecible.
1220 Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
1221 estudian en @ruser{Pintar los objetos de blanco}; de momento estamos
1222 estudiando el color, por lo que le rogamos que acepte esta limitación
1223 por ahora).
1224
1225 El interface @code{grob-interface} especifica que la propiedad del
1226 color es una lista, pero no hay ninguna explicación sobre lo que debe
1227 ir en esa lista.  La lista que requiere es realmente una lista de
1228 valores en unidades internas, pero para evitar tener que saber cuáles
1229 son, se ofrecen varias vías para la especificación de los colores.  La
1230 primera forma es utilizar uno de los colores @q{normales} que están
1231 relacionados en la primera tabla de la @ruser{Lista de colores}.  Para
1232 poner las líneas divisorias de color blanco, escribimos:
1233
1234 @cindex BarLine, ejemplo de sobreescritura
1235 @cindex color, propiedad, ejemplo
1236
1237 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1238 {
1239   \time 12/16
1240   \override Staff.BarLine #'color = #white
1241   c4 b8 c d16 c d8
1242   g,8 a16 b8 c d4 e16
1243   e8
1244 }
1245 @end lilypond
1246
1247 @noindent
1248 y de nuevo podemos comprobar que las barras de compás no son visibles.
1249 Observe que @emph{white} no viene precedido de un apóstrofo: no es un
1250 símbolo, sino una @emph{función}.  Cuando se invoca, proporciona la
1251 lista de valores internos que se requieren para establecer el color a
1252 blanco.  Los otros colores de la lista normal también son funciones.
1253 Para convencerse de que esto funciona, quizá quiera cambiar el color a
1254 una de las otras funciones de la lista.
1255
1256 @cindex colores de X11
1257 @cindex X11, colores de
1258
1259 @funindex x11-color
1260
1261 La segunda forma de cambiar el color es utilizar la lista de nombres
1262 de colores de X11 que aparecen en la segunda lista de @ruser{Lista de colores}.  Sin embargo, éstos deben ir precedidos de otra función, que
1263 convierte los nombres de colores de X11 en la lista de valores
1264 internos, @code{x11-color}, de la siguiente manera:
1265
1266 @cindex BarLine, ejemplo de sobreescritura
1267 @cindex color, propiedad, ejemplo
1268
1269 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1270 {
1271   \time 12/16
1272   \override Staff.BarLine #'color = #(x11-color 'white)
1273   c4 b8 c d16 c d8
1274   g,8 a16 b8 c d4 e16
1275   e8
1276 }
1277 @end lilypond
1278
1279 @noindent
1280 Observe que en este caso la función @code{x11-color} toma un símbolo
1281 como argumento, así que el símbolo debe ir precedido de un apóstrofo y
1282 los dos deben ir entre paréntesis.
1283
1284 @cindex rgb, colores
1285 @cindex color, rgb
1286
1287 @funindex rgb-color
1288
1289 Aún hay una tercera función, que convierte valores RGB en colores
1290 internos: la función @code{rgb-color}.  Toma tres argumentos que dan
1291 las intensidades de rojo, verde y azul.  Cada uno de ellos puede tomar
1292 valores entre 0 y 1.  Por lo tanto, para establecer el color a rojo el
1293 valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
1294 @code{(rgb-color 1 1 1)}:
1295
1296 @cindex BarLine, ejemplo de sobreescritura
1297 @cindex color, propiedad, ejemplo
1298
1299 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1300 {
1301   \time 12/16
1302   \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1303   c4 b8 c d16 c d8
1304   g,8 a16 b8 c d4 e16
1305   e8
1306 }
1307 @end lilypond
1308
1309 Finalmente, existe también una escala de grises como parte del
1310 conjunto de colores de X11.  Varían desde el negro, @code{'grey0'},
1311 hasta el blanco, @code{'grey100}, en pasos de 1.  Vamos a ilustrar esto
1312 estableciendo todos los objetos de presentación de nuestro ejemplo a
1313 varias gradaciones de gris:
1314
1315 @cindex StaffSymbol, ejemplo de sobreescritura
1316 @cindex TimeSignature, ejemplo de sobreescritura
1317 @cindex Clef, ejemplo de sobreescritura
1318 @cindex NoteHead, ejemplo de sobreescritura
1319 @cindex Stem, ejemplo de sobreescritura
1320 @cindex BarLine, ejemplo de sobreescritura
1321 @cindex color property, ejemplo
1322 @cindex x11-color, ejemplo de utilización
1323
1324 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1325 {
1326   \time 12/16
1327   \override Staff.StaffSymbol   #'color = #(x11-color 'grey30)
1328   \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1329   \override Staff.Clef          #'color = #(x11-color 'grey60)
1330   \override Voice.NoteHead      #'color = #(x11-color 'grey85)
1331   \override Voice.Stem          #'color = #(x11-color 'grey85)
1332   \override Staff.BarLine       #'color = #(x11-color 'grey10)
1333   c4 b8 c d16 c d8 |
1334   g, a16 b8 c d4 e16 |
1335   e8
1336 }
1337 @end lilypond
1338
1339 @noindent
1340 Observe los contextos asociados con cada uno de los objetos de
1341 presentación.  Es importante que estén correctamente escritos, o las
1342 instrucciones ¡no funcionarán!  Recuerde que el contexto es aquel en
1343 que se encuentra el grabador correspondiente.  El contesto
1344 predeterminado para los grabadores puede encontrarse empezando por el
1345 objeto de presentación, de ahí al grabador que lo produce, y en la
1346 página del grabador del RFI aparece en qué contexto se puede encontrar
1347 normalmente el grabador.
1348
1349
1350 @node Tamaño de los objetos
1351 @subsection Tamaño de los objetos
1352 @translationof Size of objects
1353
1354 @cindex cambiar el tamaño de los objetos
1355 @cindex tamaño de los objetos
1356 @cindex objetos, tamaño de
1357 @cindex objetos, cambiar el tamaño de
1358
1359 Empezaremos examinando de nuevo un ejemplo anterior (véase
1360 @ref{Anidado de expresiones musicales}) que nos mostraba cómo introducir un
1361 pentagrama temporal, como en un @rglos{ossia}.
1362
1363 @cindex alignAboveContext, propiedad, ejemplo
1364 @cindex @code{\with}, ejemplo
1365
1366 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1367 \new Staff ="main" {
1368   \relative g' {
1369     r4 g8 g c4 c8 d
1370     e4 r8
1371     <<
1372       { f8 c c }
1373       \new Staff \with {
1374         alignAboveContext = #"main" }
1375       { f8 f c }
1376     >>
1377     r4
1378   }
1379 }
1380 @end lilypond
1381
1382 Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
1383 por lo normal se imprimen más pequeños que el pentagrama principal.
1384 Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
1385 el sello de cada uno de ellos a @code{#f}, como sigue:
1386
1387 @cindex alignAboveContext, propiedad, ejemplo
1388 @cindex @code{\with}, ejemplo
1389 @cindex stencil, propiedad, ejemplo
1390 @cindex Clef, ejemplo de sobreescritura
1391 @cindex TimeSignature, ejemplo de sobreescritura
1392
1393 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1394 \new Staff ="main" {
1395   \relative g' {
1396     r4 g8 g c4 c8 d
1397     e4 r8
1398     <<
1399       { f8 c c }
1400       \new Staff \with {
1401         alignAboveContext = #"main"
1402       }
1403       {
1404         \override Staff.Clef #'stencil = ##f
1405         \override Staff.TimeSignature #'stencil = ##f
1406         { f8 f c }
1407       }
1408     >>
1409     r4
1410   }
1411 }
1412 @end lilypond
1413
1414 @noindent
1415 donde el par de llaves adicional después de la cláusula @code{\with}
1416 es necesario para asegurar que la sobreescritura encerrada y la música
1417 se aplican al pentagrama de ossia.
1418
1419 Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
1420 usando @code{\with} y modificar los sellos de clave y de compás con
1421 \override?  La diferencia principal es que los cambios que se realizan
1422 en una cláusula @code{\with} se hacen en el momento en que se crea el
1423 contexto, y permanecen activos como valores @strong{predeterminados}
1424 durante toda la duración de dicho contexto, mientras que las
1425 instrucciones @code{\set} o @code{\override} incluidas dentro de la
1426 música son dinámicas: hacen cambios sincronizados con un punto
1427 concreto de la música.  Si los cambios se deshacen o se devuelven
1428 mediante @code{\unset} o @code{\revert} volverán a su valor
1429 predeterminado que será el establecido en la cláusula @code{\with}, o
1430 si no se ha establecido ninguno en este lugar, los valores
1431 predeterminados normales.
1432
1433 Ciertas propiedades de contexto se pueden modificar solamente dentro
1434 de cláusulas @code{\with}.  Son aquellas propiedades que no se pueden
1435 cambiar después de que el contexto se ha creado.
1436 @code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
1437 dos de tales propiedades: una vez que el pentagrama se ha creado, su
1438 alineación está decidida y no tendría sentido intentar cambiarla más
1439 tarde.
1440
1441 Los valores predeterminados de las propiedades de los objetos de
1442 presentación también se pueden establecer dentro de cláusulas
1443 @code{\with}.  Simplemente utilice la instrucción @code{\override}
1444 normal dejando aparte el nombre del contexto, ya que está definido sin
1445 ambigüedad como el contexto que la cláusula @code{\with} está
1446 modificando.  De hecho, se producirá un error si se especifica un
1447 contexto en este lugar.
1448
1449 Así pues, podemos reemplazar el ejemplo anterior con
1450
1451 @cindex alignAboveContext, propiedad, ejemplo
1452 @cindex @code{\with}, example
1453 @cindex Clef, ejemplo de sobreescritura
1454 @cindex TimeSignature, ejemplo de sobreescritura
1455
1456 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1457 \new Staff ="main" {
1458   \relative g' {
1459     r4 g8 g c4 c8 d
1460     e4 r8
1461     <<
1462       { f8 c c }
1463       \new Staff \with {
1464         alignAboveContext = #"main"
1465         % Don't print clefs in this staff
1466         \override Clef #'stencil = ##f
1467         % Don't print time signatures in this staff
1468         \override TimeSignature #'stencil = ##f
1469       }
1470       { f8 f c }
1471     >>
1472     r4
1473   }
1474 }
1475 @end lilypond
1476
1477 Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
1478 presentación.
1479
1480 Ciertos objetos de presentación se crean como glifos sacados de una
1481 fuente tipográfica.  Entre ellos se encuentran las cabezas,
1482 alteraciones, elementos de marcado, claves, indicaciones de compás,
1483 indicaciones dinámicas y la letra de las canciones.  Su tamaño se
1484 cambia mediante la modificación de la propiedad @code{font-size}, como
1485 veremos en breve.  Otros objetos de presentación como ligaduras de
1486 unión y de expresión (en general, objetos de extensión) se trazan
1487 individualmente, por lo que no hay un tamaño de tipografía
1488 @code{font-size} asociado a ellos.  Estos objetos generalmente derivan
1489 su tamaño de los objetos a los que están adosados, y por ello
1490 normalmente no hay necesidad de cambiarles el tamaño manualmente.  Aún
1491 otras propiedades como la longitud de las plicas y las barras de
1492 compás, el grosor de las barras de corchea y otras líneas, y la
1493 separación de las líneas del pentagrama se deben modificar de otras
1494 formas especiales.
1495
1496 Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
1497 tamaño de la tipografía.  Podemos hacerlo de dos formas.  Podemos
1498 cambiar el tamaño de las tipografías de cada uno de los tipos de
1499 objeto como las cabezas (@code{NoteHead}s) con instrucciones como
1500
1501 @example
1502 \override NoteHead #'font-size = #-2
1503 @end example
1504
1505 o podemos cambiar el tamaño de todas las tipografías estableciendo una
1506 propiedad especial, @code{fontSize}, utilizando @code{\set}, o
1507 mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
1508 @code{\set}).
1509
1510 @example
1511 \set fontSize = #-2
1512 @end example
1513
1514 Los dos enunciados producirían una reducción del tamaño de la
1515 tipografía en dos pasos a partir de su valor previo, donde cada paso
1516 reduce o aumenta el tamaño aproximadamente en un 12%.
1517
1518 Vamos a probarlo en nuestro ejemplo del ossia:
1519
1520 @cindex alignAboveContext, propiedad, ejemplo
1521 @cindex @code{\with}, ejemplo
1522 @cindex Clef, ejemplo de sobreescritura
1523 @cindex TimeSignature, ejemplo de sobreescritura
1524 @cindex fontSize, propiedad, ejemplo
1525
1526 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1527 \new Staff ="main" {
1528   \relative g' {
1529     r4 g8 g c4 c8 d
1530     e4 r8
1531     <<
1532       { f8 c c }
1533       \new Staff \with {
1534         alignAboveContext = #"main"
1535         \override Clef #'stencil = ##f
1536         \override TimeSignature #'stencil = ##f
1537         % Reduce all font sizes by ~24%
1538         fontSize = #-2
1539       }
1540       { f8 f c }
1541     >>
1542     r4
1543   }
1544 }
1545 @end lilypond
1546
1547 Aún no está demasiado bien.  Las cabezas y los corchetes de las notas
1548 son más pequeños, pero las plicas son demasiado largas en proporción,
1549 y las líneas del pentagrama están demasiado separadas entre sí.  Se
1550 debe reducir su escala en proporción a la reducción de la tipografía.
1551 El siguiente apartado trata sobre cómo se hace esto.
1552
1553 @node Longitud y grosor de los objetos
1554 @subsection Longitud y grosor de los objetos
1555 @translationof Length and thickness of objects
1556
1557 @cindex distancias
1558 @cindex grosor
1559 @cindex longitud
1560 @cindex magstep
1561 @cindex tamaño, cambiar
1562 @cindex plica, cambiar la longitud
1563 @cindex pentagrama, cambiar la separación de las líneas
1564
1565 Las distancias y longitudes en LilyPond se miden generalmente en
1566 espacios de pentagrama, la distancia entre líneas adyacentes de la
1567 pauta (o de manera ocasional medios espacios), mientras que la mayoría
1568 de las propiedades de @code{thickness} (grosor) se miden en unidades
1569 de una propiedad interna llamada @code{line-thickness.}  Por ejemplo,
1570 de forma predeterminada, a las líneas de los reguladores se les da un
1571 grosor de 1 unidad de @code{line-thickness}, mientras que el
1572 @code{thickness} de una plica es 1.3.  Observe sin embargo que ciertas
1573 propiedades de grosor son diferentes; por ejemplo, el grosor de las
1574 barras de corchea se controla por medio del valor de
1575 @code{beam-thickness}, que se mide en espacios de pentagrama.
1576
1577 Entonces ¿cómo se tienen que escalar las longitudes en proporción al
1578 tamaño de la tipografía?  Se puede hacer con la ayuda de una función
1579 especial que se llama @code{magstep}, pensada especialmente para este
1580 propósito.  Toma un argumento, el cambio de tamaño de la tipografía
1581 (#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
1582 para reducir otros objetos en la misma proporción.  Se usa de la
1583 siguiente forma:
1584
1585 @cindex alignAboveContext, propiedad, ejemplo
1586 @cindex @code{\with}, ejemplo
1587 @cindex Clef, ejemplo de sobreescritura
1588 @cindex TimeSignature, ejemplo de sobreescritura
1589 @cindex fontSize, propiedad, ejemplo
1590 @cindex StaffSymbol, ejemplo de sobreescritura
1591 @cindex magstep, función, ejemplo de utilización
1592 @cindex staff-space, propiedad, ejemplo
1593 @cindex stencil, propiedad, ejemplo
1594
1595 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1596 \new Staff ="main" {
1597   \relative g' {
1598     r4 g8 g c4 c8 d
1599     e4 r8
1600     <<
1601       { f8 c c }
1602       \new Staff \with {
1603         alignAboveContext = #"main"
1604         \override Clef #'stencil = ##f
1605         \override TimeSignature #'stencil = ##f
1606         fontSize = #-2
1607         % Reduce stem length and line spacing to match
1608         \override StaffSymbol #'staff-space = #(magstep -2)
1609       }
1610       { f8 f c }
1611     >>
1612     r4
1613   }
1614 }
1615 @end lilypond
1616
1617 @noindent
1618 Puesto que la longitud de las plicas y muchas otras propiedades
1619 relacionadas con la longitudes calculan siempre con relación al valor
1620 de la propiedad @code{staff-space}, su longitud también ve reducida su
1621 escala automáticamente.  Observe que esto afecta solamente a la escala
1622 vertical del ossia: la escala horizontal se determina por medio de la
1623 disposición de la música principal con el objeto de mantenerse en
1624 sincronía con ella, de forma que no resulte afectada por ninguno de
1625 estos cambios de tamaño.  Por supuesto, si la escala de toda la música
1626 principal se cambiase de esta forma, entonces el espaciado horizontal
1627 se vería afectado.  Trataremos de esto más tarde en la sección sobre
1628 la disposición.
1629
1630 Esto, en fin, completa la creación de un ossia.  Los tamaños y
1631 longitudes del resto de los objetos se pueden modificar de manera
1632 análoga.
1633
1634 Para cambios de escala pequeños, como en el ejemplo de arriba, el
1635 grosor de las diversas líneas dibujadas como divisorias, barras de
1636 corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
1637 ajuste global.  Si el grosor de cualquier objeto de presentación en
1638 particular necesita ajustarse, se puede hacer mejor mediante la
1639 sobreescritura de su propiedad @code{thickness}.  Anteriormente
1640 mostramos un ejemplo de cambio de grosor en las ligaduras, en
1641 @ref{Propiedades de los objetos de presentación}.  El grosor de todos los objetos
1642 trazados (es decir, aquellos que no se producen a partir de una
1643 tipografía) se pueden cambiar de la misma forma.
1644
1645
1646 @node Colocación de los objetos
1647 @section Colocación de los objetos
1648 @translationof Placement of objects
1649
1650 @menu
1651 * Comportamiento automático::
1652 * Objetos interiores al pentagrama::
1653 * Objetos fuera del pentagrama::
1654 @end menu
1655
1656
1657 @node Comportamiento automático
1658 @subsection Comportamiento automático
1659 @translationof Automatic behaviour
1660
1661 @cindex dentro del pentagrama, objetos
1662 @cindex fuera del pentagrama, objetos
1663 @cindex objetos dentro del pentagrama
1664 @cindex objetos fuera del pentagrama
1665
1666 Hay ciertos objetos en notación musical que pertenecen al pentagrama y
1667 otros cuyo lugar se sitúa fuera del pentagrama.  Reciben el nombre de
1668 objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
1669 respectivamente.
1670
1671 Los objetos dentro-del-pentagrama son los que se sitúan sobre la
1672 pauta: cabezas, plicas, alteraciones, etc.  Sus posiciones normalmente
1673 se fijan por la propia música; se posicionan verticalmente sobre
1674 líneas específicas del pentagrama o están unidos a otros objetos
1675 posicionados de esta forma.  Las colisiones entre cabezas, plicas y
1676 alteraciones en acordes de notas muy juntas, normalmente se evitan
1677 automáticamente.  Hay instrucciones y sobreescrituras que pueden
1678 modificar este comportamiento automático, como veremos en breve.
1679
1680 Entre los objetos que pertenecen al exterior de la pauta se encuentran
1681 cosas como las marcas de ensayo, las marcas de texto y las de
1682 dinámica.  La regla de LilyPond para la colocación vertical de los
1683 objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
1684 como sea posible, pero no tan cerca como para que puedan chocar con
1685 algún otro objeto.  LilyPond utiliza la propiedad
1686 @code{outside-staff-priority} para determinar el orden en que se deben
1687 situar los objetos, como veremos ahora.
1688
1689 En primer lugar, LilyPond sitúa todos los objetos
1690 dentro-del-pentagrama.  Después ordena los objetos
1691 fuera-del-pentagrama de acuerdo con su prioridad
1692 @code{outside-staff-priority}.  Los objetos fuera-del-pentagrama se
1693 toman de uno en uno, comenzando por el que tiene la prioridad
1694 @code{outside-staff-priority} más baja, y se sitúan de forma que no
1695 colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
1696 grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
1697 la prioridad @code{outside-staff-priority} más baja se colocará más
1698 cerca del pentagrama.  Si dos objetos tienen la misma
1699 @code{outside-staff-priority}, el que se ha encontrado primero se
1700 situará más cerca de la pauta.
1701
1702 En el siguiente ejemplo, todos los textos de marcado tienen la misma
1703 prioridad (pues no se ha establecido explícitamente).  Observe que
1704 @q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
1705 acomodado por debajo de @q{Text2}.
1706
1707 @cindex markup, ejemplo
1708
1709 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1710 c2^"Text1"
1711 c2^"Text2"
1712 c2^"Text3"
1713 c2^"Text4"
1714 @end lilypond
1715
1716 Los pentagramas también se posicionan, de forma predeterminada, tan
1717 cerca unos de otros como sea posible (sujeto a una separación mínima).
1718 Si las notas se proyectan muy lejos en dirección a un pentagrama
1719 adyacente, forzarán a alejarse a los pentagramas sólo si en caso
1720 contrario fuese a ocurrir un solapamiento de la notación.  El ejemplo
1721 siguiente muestra esta acomodación @q{nestling} de las notas sobre
1722 pentagramas adyacentes:
1723
1724 @lilypond[quote,ragged-right,verbatim]
1725 <<
1726   \new Staff {
1727     \relative c' { c4 a, }
1728   }
1729   \new Staff {
1730     \relative c'''' { c4 a, }
1731   }
1732 >>
1733 @end lilypond
1734
1735
1736 @node Objetos interiores al pentagrama
1737 @subsection Objetos interiores al pentagrama
1738 @translationof Within-staff objects
1739
1740 Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la
1741 dirección de las ligaduras de expresión y de unión, digitaciones y
1742 todo lo demás que dependa de la dirección de las plicas.  Cuando se
1743 escribe música polifónica, estas instrucciones son esenciales para que
1744 puedan distinguirse varias líneas melódicas entrelazadas.  Pero
1745 ocasionalmente puede ser necesario sobreescribir este comportamiento
1746 automático.  Se puede hacer por secciones de música completas o
1747 incluso para una nota individual.  La propiedad que controla este
1748 comportamiento es la propiedad de @code{direction} (dirección) de cada
1749 objeto de presentación.  En primer lugar explicaremos qué hace esto, y
1750 luego introduciremos algunas instrucciones listas para usar que le
1751 evitarán tener que codificar sobreescrituras explícitas para las
1752 modificaciones más comunes.
1753
1754 Algunos objetos de presentación como las ligaduras se curvan hacia
1755 arriba o hacia abajo; otros como las plicas y los corchetes también se
1756 mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
1757 hacia abajo.  Esto se controla automáticamente cuando está establecida
1758 la propiedad @code{direction}.
1759
1760 @cindex abajo
1761 @cindex arriba
1762 @cindex centro
1763 @cindex neutro
1764 @cindex down
1765 @cindex up
1766 @cindex center
1767 @cindex neutral
1768
1769 El ejemplo siguiente muestra en el compás 1 el comportamiento
1770 predeterminado de las plicas, con las de las notas agudas apuntando
1771 hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
1772 todas las plicas forzadas hacia abajo, cuatro notas con las plicas
1773 forzadas hacia arriba, y por último cuatro notas devueltas al
1774 comportamiento predeterminado.
1775
1776 @cindex Stem, ejemplo de sobreescritura
1777 @cindex direction, propiedad, ejemplo
1778
1779 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1780 a4 g c a
1781 \override Stem #'direction = #DOWN
1782 a4 g c a
1783 \override Stem #'direction = #UP
1784 a4 g c a
1785 \revert Stem #'direction
1786 a4 g c a
1787 @end lilypond
1788
1789 Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
1790 (arriba).  Éstos tienen los valores @code{-1} y @code{+1}
1791 respectivamente, y dichos valores numéricos también se pueden usar
1792 directamente.  El valor @code{0} también se puede usar en algunos
1793 casos.  Se trata simplemente con el significado de @code{UP} para las
1794 plicas, pero para algunos objetos tiene el significado de
1795 @q{centrado}.  Existe una constante @code{CENTER} que tiene el valor
1796 @code{0}.
1797
1798 Sin embargo, estas sobreescrituras no se usan muy a menudo porque
1799 están disponibles instrucciones predefinidas equivalentes más
1800 sencillas.  Aquí podemos ver una tabla de las más comunes.  Se
1801 menciona el significado de cada una allí donde no es obvio.
1802
1803 @multitable @columnfractions .2 .2 .25 .35
1804 @headitem Abajo o Izquierda
1805   @tab Arriba o Derecha
1806   @tab Anular
1807   @tab Efecto
1808 @item @code{\arpeggioArrowDown}
1809   @tab @code{\arpeggioArrowUp}
1810   @tab @code{\arpeggioNormal}
1811   @tab La flecha está abajo, arriba o no hay flecha
1812 @item @code{\dotsDown}
1813   @tab @code{\dotsUp}
1814   @tab @code{\dotsNeutral}
1815   @tab Dirección del desplazamiento para evitar las líneas del pentagrama
1816 @item @code{\dynamicDown}
1817   @tab @code{\dynamicUp}
1818   @tab @code{\dynamicNeutral}
1819   @tab
1820 @item @code{\phrasingSlurDown}
1821   @tab @code{\phrasingSlurUp}
1822   @tab @code{\phrasingSlurNeutral}
1823   @tab Nota: diferente de las instrucciones de ligaduras de expresión
1824 @item @code{\slurDown}
1825   @tab @code{\slurUp}
1826   @tab @code{\slurNeutral}
1827   @tab
1828 @item @code{\stemDown}
1829   @tab @code{\stemUp}
1830   @tab @code{\stemNeutral}
1831   @tab
1832 @item @code{\textSpannerDown}
1833   @tab @code{\textSpannerUp}
1834   @tab @code{\textSpannerNeutral}
1835   @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
1836 @item @code{\tieDown}
1837   @tab @code{\tieUp}
1838   @tab @code{\tieNeutral}
1839   @tab
1840 @item @code{\tupletDown}
1841   @tab @code{\tupletUp}
1842   @tab @code{\tupletNeutral}
1843   @tab Los grupos especiales están debajo o encima de las notas
1844 @end multitable
1845
1846 Observe que estas instrucciones predefinidas @strong{no} pueden ir
1847 precedidas de @code{\once}.  Si quiere limitar el efecto a una sola
1848 nota, deberá elegir entre usar la instrucción @code{\once \override}
1849 equivalente, o usar la instrucción predefinida, seguida después de la
1850 nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
1851
1852 @unnumberedsubsubsec Digitaciones
1853
1854 @cindex digitación, colocación
1855 @cindex digitación de acordes
1856
1857 La colocación de las digitaciones sobre notas sueltas también se puede
1858 controlar mediante la propiedad @code{direction}, pero los cambios
1859 sobre @code{direction} no tienen ningún efecto sobre las notas de los
1860 acordes.  Como veremos, existen instrucciones especiales que permiten
1861 controlar las digitaciones de notas individuales, situando la
1862 digitación encima, debajo, a la izquierda o a la derecha de cada nota.
1863
1864 En primer lugar, he aquí el efecto de @code{direction} sobre las
1865 digitaciones aplicadas a notas sueltas.  Se muestra en el primer
1866 compás el comportamiento predeterminado, y en los dos compases
1867 siguiente el efecto de especificar @code{DOWN} y @code{UP}:
1868
1869 @cindex Fingering, ejemplo de sobreescritura
1870 @cindex direction, propiedad, ejemplo
1871
1872 @lilypond[quote,verbatim,relative=2]
1873 c-5 a-3 f-1 c'-5
1874 \override Fingering #'direction = #DOWN
1875 c-5 a-3 f-1 c'-5
1876 \override Fingering #'direction = #UP
1877 c-5 a-3 f-1 c'-5
1878 @end lilypond
1879
1880 Sin embargo, la sobreescritura de la propiedad @code{direction} no es
1881 la forma más sencilla de especificar manualmente la digitación por
1882 encima o por debajo de las notas; suele ser preferible usar @code{_} o
1883 @code{^} en lugar de @code{-}, antes del número de la digitación.
1884 Este es el ejemplo anterior utilizando este método:
1885
1886 @cindex fingering, ejemplo
1887 @cindex digitación, ejemplo
1888
1889 @lilypond[quote,verbatim,relative=2]
1890 c-5 a-3 f-1 c'-5
1891 c_5 a_3 f_1 c'_5
1892 c^5 a^3 f^1 c'^5
1893 @end lilypond
1894
1895 La propiedad @code{direction} se ignora para los acordes, pero los
1896 prefijos direccionales @code{_} y @code{^} sí funcionan.  De forma
1897 predeterminada, las digitaciones se colocan automáticamente encima y
1898 debajo de las notas de un acorde, como se muestra aquí:
1899
1900 @cindex fingering, ejemplo
1901 @cindex digitación, ejemplo
1902
1903 @lilypond[quote,verbatim,relative=2]
1904 <c-5 g-3>
1905 <c-5 g-3 e-2>
1906 <c-5 g-3 e-2 c-1>
1907 @end lilypond
1908
1909 @noindent
1910 pero se puede forzar de manera que todos o algunos de los números de
1911 digitación estén por encima o por debajo:
1912
1913 @cindex fingering, ejemplo
1914 @cindex digitación, ejemplo
1915
1916 @lilypond[quote,verbatim,relative=2]
1917 <c-5 g-3 e-2 c-1>
1918 <c^5 g_3 e_2 c_1>
1919 <c^5 g^3 e^2 c_1>
1920 @end lilypond
1921
1922 Es posible ejercer un control aún mayor sobre la colocación de las
1923 digitaciones mediante la utilización de la instrucción @code{\set
1924 fingeringOrientations}.  El formato de esta instrucción es:
1925
1926 @example
1927 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
1928 @end example
1929
1930 @noindent
1931 se utiliza @code{\set} porque @code{fingeringOrientations} es una
1932 propiedad del contexto @code{Voice}, creado y usado por el grabador
1933 @code{New_fingering_engraver}.
1934
1935 La propiedad se puede establecer al valor de una lista de entre uno y
1936 tres valores.  Controla si las digitaciones se pueden colocar por
1937 encima (si @code{up} aparece en la lista), por debajo (si aparece
1938 @code{down}), a la izquierda (si aparece @code{left}) o a la derecha
1939 (si aparece @code{right}).  A la inversa, si una colocación no está en
1940 la lista, no se sitúa ninguna digitación en dicho lugar.  LilyPond
1941 coma estas restricciones y se trabaja la mejor colocación para la
1942 digitación de las notas de los acordes que siguen.  Observe que
1943 @code{left} y @code{right} son mutuamente excluyentes: las
1944 digitaciones pueden situarse en un lado o en el otro, no en los dos.
1945
1946 @warning{Para controlar la colocación de la digitación de una sola
1947 nota usando esta instrucción es necesario escribirla como un acorde de
1948 una sola nota encerrándola entre ángulos simples.}
1949
1950 Aquí podemos ver algunos ejemplos:
1951
1952 @cindex fingering, ejemplo
1953 @cindex digitación, ejemplo
1954 @cindex @code{\set}, ejemplo de utilización
1955 @cindex fingeringOrientations, propiedad, ejemplo
1956
1957 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1958 \set fingeringOrientations = #'(left)
1959 <f-2>
1960 <c-1 e-2 g-3 b-5>4
1961 \set fingeringOrientations = #'(left)
1962 <f-2>
1963 <c-1 e-2 g-3 b-5>4
1964 \set fingeringOrientations = #'(up left down)
1965 <f-2>
1966 <c-1 e-2 g-3 b-5>4
1967 \set fingeringOrientations = #'(up left)
1968 <f-2>
1969 <c-1 e-2 g-3 b-5>4
1970 \set fingeringOrientations = #'(right)
1971 <f-2>
1972 <c-1 e-2 g-3 b-5>4
1973 @end lilypond
1974
1975 @noindent
1976 Si la digitación parece un poco superpoblada, se puede reducir el
1977 tamaño @code{font-size}.  El valor predeterminado puede verse en el
1978 objeto @code{Fingering} del RFI que es @code{-5}, así que probaremos
1979 @code{-7}:
1980
1981 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
1982 \override Fingering #'font-size = #-7
1983 \set fingeringOrientations = #'(left)
1984 <f-2>
1985 <c-1 e-2 g-3 b-5>4
1986 \set fingeringOrientations = #'(left)
1987 <f-2>
1988 <c-1 e-2 g-3 b-5>4
1989 \set fingeringOrientations = #'(up left down)
1990 <f-2>
1991 <c-1 e-2 g-3 b-5>4
1992 \set fingeringOrientations = #'(up left)
1993 <f-2>
1994 <c-1 e-2 g-3 b-5>4
1995 \set fingeringOrientations = #'(right)
1996 <f-2>
1997 <c-1 e-2 g-3 b-5>4
1998 @end lilypond
1999
2000
2001 @node Objetos fuera del pentagrama
2002 @subsection Objetos fuera del pentagrama
2003 @translationof Outside-staff objects
2004
2005 Los objetos fuera-del-pentagrama se colocan automáticamente para
2006 evitar las colisiones.  Los objetos que tienen el valor más bajo de la
2007 propiedad @code{outside-staff-priority} se sitúan más cerca del
2008 pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
2009 tanto como sea necesario para evitar la colisión.  La prioridad
2010 @code{outside-staff-priority} se defina en el @code{grob-interface} y
2011 así es una propiedad de todos los objetos de presentación.  De forma
2012 predeterminada se establece a @code{#f} para todos los objetos
2013 dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
2014 fuera-del-pentagrama cuando se crea el objeto.  La tabla siguiente
2015 presenta los valores numéricos predeterminados para algunos de los
2016 objetos fuera-del-pentagrama que están inicialmente dentro de los
2017 contextos @code{Staff} o @code{Voice}.
2018
2019 @cindex objetos de extensión
2020
2021 Observe los nombres algo inusuales de algunos de los objetos: los
2022 objetos de extensión se cearn automáticamente para controlar el
2023 posicionamiento vertical de los grobs que (quizá) comienzan y terminan
2024 en distintos momentos musicales, de manera que cualquier modificación
2025 a la prioridad @code{outside-staff-priority} del grob subyacente no
2026 tiene ningún efecto.  Por ejemplo, cambiar la
2027 @code{outside-staff-priority} del objeto de regulador @code{Hairpin}
2028 no tiene efecto sobre la posición vertical de los reguladores: en
2029 lugar de eso, tenemos que cambar la @code{outside-staff-priority} del
2030 objeto asociado @code{DynamicLineSpanner}.  Esta sobreeascritura se
2031 debe escribir al comienzo del objeto de extensión, que podría incluir
2032 varios reguladores o matices dinámicos encadenados.
2033
2034 @multitable @columnfractions .3 .3 .3
2035 @headitem Objeto de presentación
2036   @tab Prioridad
2037   @tab Controla la posición de:
2038 @item @code{MultiMeasureRestText}
2039   @tab @code{450}
2040   @tab Texto sobre silencios de compás completo
2041 @item @code{TextScript}
2042   @tab @code{450}
2043   @tab Elementos de marcado de texto
2044 @item @code{OttavaBracket}
2045   @tab @code{400}
2046   @tab Corchetes de octava alta y baja
2047 @item @code{TextSpanner}
2048   @tab @code{350}
2049   @tab Objetos de extensión de texto
2050 @item @code{DynamicLineSpanner}
2051   @tab @code{250}
2052   @tab Todas las indicaciones dinámicas
2053 @item @code{VoltaBracketSpanner}
2054   @tab @code{100}
2055   @tab Corchetes de primera y segunda vez
2056 @item @code{TrillSpanner}
2057   @tab @code{50}
2058   @tab Trinos mantenidos
2059 @end multitable
2060
2061 He aquí un ejemplo que muestra la situación predeterminada de algunos
2062 de ellos.
2063
2064 @cindex texto, extensiones de
2065 @cindex octava alta y baja, corchete de
2066
2067 @funindex \startTextSpan
2068 @funindex startTextSpan
2069 @funindex \stopTextSpan
2070 @funindex stopTextSpan
2071
2072 @cindex TextSpanner, ejemplo de sobreescritura
2073 @cindex bound-details, propiedad, ejemplo
2074
2075 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2076 % Set details for later Text Spanner
2077 \override TextSpanner #'(bound-details left text)
2078     = \markup { \small \bold Slower }
2079 % Place dynamics above staff
2080 \dynamicUp
2081 % Start Ottava Bracket
2082 \ottava #1
2083 c'4 \startTextSpan
2084 % Add Dynamic Text and hairpin
2085 c4\pp\<
2086 c4
2087 % Add Text Script
2088 c4^Text
2089 c4 c
2090 % Add Dynamic Text and terminate hairpin
2091 c4\ff c \stopTextSpan
2092 % Stop Ottava Bracket
2093 \ottava #0
2094 c,4 c c c
2095 @end lilypond
2096
2097 Este ejemplo también muestra cómo crear textos con extensión (Text
2098 Spanners): textos con líneas extensoras por encima de una sección de
2099 música.  El extensor abarca desde la instrucción @code{\startTextSpan}
2100 hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
2101 define por medio de la instrucción @code{\override TextSpanner}.  Para
2102 ver más detalles, consulte @ruser{Extensiones de texto}.
2103
2104 También muestra la manera de crear corchetes de octava alta y baja.
2105
2106 @cindex trucar la situación de los números de compás
2107 @cindex números de compás, ajustar posición
2108 @cindex trucar la situación de marcas metronómicas
2109 @cindex metrónomo, situación de las indicaciones de
2110 @cindex trucar la situación de las letras de ensayo
2111 @cindex ensayo, letras, trucar la colocación
2112
2113 Observe que los números de compás, las indicaciones metronómicas y las
2114 mercas de ensayo no se muestran. De forma predeterminada, se crean
2115 dentro del contexto @code{Score} y su prioridad
2116 @code{outside-staff-priority} se ignora con relación a los objetos de
2117 presentación que se crean dentro del contexto @code{Staff}.  Si quiere
2118 colocar los números de compás, indicaciones metronómicas o llamadas de
2119 ensayo en concordancia con el valor de su
2120 @code{outside-staff-priority}, los grabadores
2121 @code{Bar_number_engraver}, @code{Metronome_mark_engraver} o
2122 @code{Mark_engraver} respectivamente se deben eliminar del contexto
2123 @code{Score} y colocarlos en el contexto @code{Staff} del nivel
2124 superior.  Si se hace así, estas marcas obtendrán los siguientes
2125 valores predeterminados de @code{outside-staff-priority}:
2126
2127 @multitable @columnfractions .3 .3
2128 @headitem Objeto de presentación           @tab Prioridad
2129 @item @code{RehearsalMark}        @tab @code{1500}
2130 @item @code{MetronomeMark}        @tab @code{1000}
2131 @item @code{BarNumber}            @tab @code{ 100}
2132 @end multitable
2133
2134 Si los valores predeterminados de @code{outside-staff-priority} no le
2135 ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
2136 de cualquiera de los objetos.  Suponga que quisiéramos que el corchete
2137 de octava estuviera situado por debajo del elemento extensor de texto
2138 en el ejemplo de arriba.  Todo lo que debemos hacer es localizar la
2139 prioridad de @code{OttavaBracket} en el RFI o en las tablas
2140 anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
2141 recordando que @code{OttavaBracket} se crea dentro del contexto de
2142 @code{Staff}:
2143
2144 @cindex TextSpanner, ejemplo de sobreescritura
2145 @cindex bound-details, propiedad, ejemplo
2146
2147 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2148 % Set details for later Text Spanner
2149 \override TextSpanner #'(bound-details left text)
2150     = \markup { \small \bold Slower }
2151 % Place dynamics above staff
2152 \dynamicUp
2153 %Place following Ottava Bracket below Text Spanners
2154 \once \override Staff.OttavaBracket #'outside-staff-priority = #340
2155 % Start Ottava Bracket
2156 \ottava #1
2157 c'4 \startTextSpan
2158 % Add Dynamic Text
2159 c4\pp
2160 % Add Dynamic Line Spanner
2161 c4\<
2162 % Add Text Script
2163 c4^Text
2164 c4 c
2165 % Add Dynamic Text
2166 c4\ff c \stopTextSpan
2167 % Stop Ottava Bracket
2168 \ottava #0
2169 c,4 c c c
2170 @end lilypond
2171
2172 @cindex ligaduras y outside-staff-priority
2173 @cindex ligaduras y articulaciones
2174 @cindex articulaciones y ligaduras
2175
2176 De forma predeterminada, las ligaduras de expresión están clasificadas
2177 como objetos dentro-del-pentagrama, pero con frecuencia aparecen
2178 encima del pentagrama si las notas que une son muy agudas.  Ello puede
2179 empujar a una posición muy elevada a los objetos fuera-del-pentagrama
2180 como las articulaciones, pues la ligadura se colocará en primer lugar.
2181 La propiedad @code{avoid-slur} de la articulación se puede establecer
2182 al valor @code{'inside} (por dentro) para llevarla al interior de la
2183 ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si
2184 la prioridad @code{outside-staff-priority} está también ajustada al
2185 valor @code{#f}.  De forma alternativa, la prioridad
2186 @code{outside-staff-priority} de la ligadura se puede fijar en un
2187 valor numérico para hacer que se sitúe en línea con otros objetos
2188 fuera del pentagrama de acuerdo con este valor.  He aquí un ejemplo
2189 que muestra el efecto de los dos métodos:
2190
2191 @lilypond[quote,verbatim,relative=2]
2192 c4( c^\markup { \tiny \sharp } d4.) c8
2193 c4(
2194 \once \override TextScript #'avoid-slur = #'inside
2195 \once \override TextScript #'outside-staff-priority = ##f
2196 c4^\markup \tiny \sharp d4.) c8
2197 \once \override Slur #'outside-staff-priority = #500
2198 c4( c^\markup { \tiny \sharp } d4.) c8
2199 @end lilypond
2200
2201 Los cambios en @code{outside-staff-priority} también se pueden emplear
2202 para controlar la situación vertical de los objetos individuales,
2203 aunque los resultados pueden no siempre ser deseables.  Suponga que
2204 quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
2205 bajo el epígrafe Comportamiento Automático de más arriba (véase
2206 @ref{Comportamiento automático}).  Todo lo que debemos hacer es localizar la
2207 prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
2208 aumentar la prioridad de @qq{Text3} hasta un valor superior:
2209
2210 @cindex TextScript, ejemplo de sobreescritura
2211 @cindex outside-staff-priority, propiedad, ejemplo
2212
2213 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2214 c2^"Text1"
2215 c2^"Text2"
2216 \once \override TextScript #'outside-staff-priority = #500
2217 c2^"Text3"
2218 c2^"Text4"
2219 @end lilypond
2220
2221 Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
2222 también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
2223 desploma hacia abajo.  Quizá no sea tan buena idea.  ¿Y si lo que
2224 realmente queremos hacer es posicionar todas las anotaciones a la
2225 misma distancia por encima del pentagrama?  Para hacerlo, vamos a
2226 necesitar claramente espaciar las notas en sentido horizontal para
2227 hacer sitio para el texto.  Esto se hace empleando la instrucción
2228 @code{textLengthOn}.
2229
2230 @subheading \textLengthOn
2231
2232 @cindex notas, espaciar junto al texto
2233
2234 @funindex \textLengthOn
2235 @funindex textLengthOn
2236 @funindex \textLengthOff
2237 @funindex textLengthOff
2238
2239 De forma predeterminada, el texto producido mediante marcado no ocupa
2240 ningún espacio horizontal en cuanto se refiere a la disposición de la
2241 música.  La instrucción @code{\textLengthOn} invierte este
2242 comportamiento, ocasionando que las notas resulten tan espaciadas como
2243 sea necesario para acomodar el texto:
2244
2245 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2246 \textLengthOn  % Cause notes to space out to accommodate text
2247 c2^"Text1"
2248 c2^"Text2"
2249 c2^"Text3"
2250 c2^"Text4"
2251 @end lilypond
2252
2253 La instrucción para volver al comportamiento predeterminado es
2254 @code{\textLengthOff}.  Recuerde que @code{\once} funciona solamente
2255 con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
2256 que no se puede usar con @code{\textLengthOn}.
2257
2258 @cindex marcado, texto de, permitir las colisiones en
2259
2260 El texto de marcado también evita las notas que se proyectan por
2261 encima del pentagrama.  Si esto no es lo que deseamos, el
2262 desplazamiento automático hacia arriba se puede desactivar mediante el
2263 establecimiento de la prioridad a @code{#f}.  He aquí un ejemplo que
2264 muestra cómo el texto de marcado interactúa con tales notas.
2265
2266 @cindex TextScript, ejemplo de sobreescritura
2267 @cindex outside-staff-priority, propiedad, ejemplo
2268
2269 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2270 % This markup is short enough to fit without collision
2271 c2^"Tex"
2272 c''2
2273 R1
2274 % This is too long to fit, so it is displaced upwards
2275 c,,2^"Text"
2276 c''2
2277 R1
2278 % Turn off collision avoidance
2279 \once \override TextScript #'outside-staff-priority = ##f
2280 c,,2^"Long Text   "
2281 c''2
2282 R1
2283 % Turn off collision avoidance
2284 \once \override TextScript #'outside-staff-priority = ##f
2285 \textLengthOn  % and turn on textLengthOn
2286 c,,2^"Long Text   "  % Spaces at end are honored
2287 c''2
2288 @end lilypond
2289
2290
2291 @subheading Matices dinámicos
2292
2293 @cindex trucar la colocación de los matices
2294 @cindex dinámica, trucar la colocación de las indicaciones de
2295 @cindex matices, trucar la colocación
2296
2297 Las indicaciones de matiz dinámico normalmente se colocarán por debajo
2298 del pentagrama, pero se pueden posicionar por encima con la
2299 instrucción @code{dynamicUp}.  Se situarán verticalmente respecto a la
2300 nota a la que van adosadas, y flotarán por debajo (o por encima) de
2301 todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
2302 y números de compás.  Esto puede ofrecer resultados bastante
2303 aceptables, como muestra este ejemplo:
2304
2305 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2306 \clef "bass"
2307 \key aes \major
2308 \time 9/8
2309 \dynamicUp
2310 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\!
2311 ees,2.~\)\mf ees4 r8
2312 @end lilypond
2313
2314 Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
2315 muy cerca, la colocación automática evitará las colisiones desplazando
2316 las marcas dinámicas posteriores más lejos, aunque este puede no ser
2317 el lugar óptimo, como muestra el siguiente ejemplo más bien
2318 artificial:
2319
2320 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2321 \dynamicUp
2322 a4\f b\mf c\mp b\p
2323 @end lilypond
2324
2325 @noindent
2326 Si se presentara una situación similar en música @q{real}, podría ser
2327 preferible espaciar las notas un poco más entre sí, de forma que todas
2328 las marcas dinámicas puedan caber a la misma distancia vertical desde
2329 el pentagrama.  Hemos sido capaces de hacer esto para el texto de
2330 marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
2331 una instrucción equivalente para las indicaciones de matiz dinámico.
2332 Por tanto, tendremos que averiguar cómo hacerlo utilizando
2333 instrucciones @code{\override}.
2334
2335 @subheading Escalado de un «Grob»
2336
2337 @cindex grob, cambio de tamaño de un
2338 @cindex escala de los grobs
2339
2340 En primer lugar debemos aprender cómo se especifica el tamaño de los
2341 grobs.  Todos los grobs tienen un punto de referencia definido dentro
2342 de ellos que se usa para colocarlos respecto a su objeto padre.
2343 Entonces, este punto del grob se posiciona a una distancia horizontal,
2344 @code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
2345 de su padre.  La dimensión horizontal del objeto viene dada por una
2346 pareja de números, @code{X-extent}, que dice dónde están los límites
2347 izquierdo y derecho respecto del punto de referencia.  La amplitud
2348 vertical se define de forma similar mediante una pareja de números,
2349 @code{Y-extent}.  Éstas son propiedades de todos los grobs que
2350 contemplan el @code{grob-interface}.
2351
2352 @cindex @code{extra-spacing-width}
2353
2354 De forma predeterminada, los objetos fuera-del-pentagrama reciben una
2355 anchura cero, de manera que pueden solaparse en la dirección
2356 horizontal.  Esto se hace mediante el truco de añadir una cantidad
2357 infinita a la dimensión más a la izquierda y menos infinito a la
2358 dimensión más a la derecha estableciendo el valor de
2359 @code{extra-spacing-width} a @code{'(+inf.0 . -inf.0)}.  Así, para
2360 asegurar que no se superponen en la dirección horizontal tendremos que
2361 sobreescribir este valor de @code{extra-spacing-width} a @code{'(0
2362 . 0)} de forma que el verdadero ancho se presente.  Esta es la
2363 instrucción que lo hace para las indicaciones dinámicas:
2364
2365 @example
2366 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2367 @end example
2368
2369 @noindent
2370 Veamos si funciona en nuestro ejemplo anterior:
2371
2372 @cindex DynamicText, ejemplo de sobreescritura
2373 @cindex extra-spacing-width, propiedad, ejemplo
2374
2375 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2376 \dynamicUp
2377 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2378 a4\f b\mf c\mp b\p
2379 @end lilypond
2380
2381 @noindent
2382 Bueno, ciertamente ha hecho que las marcas dinámicas ya no estén
2383 desplazadas, pero aún quedan dos problemas.  Las marcas tendrían que
2384 separarse un poco más entre sí, y sería mejor si todas estuvieran a la
2385 misma distancia del pentagrama.  Podemos resolver el primer problema
2386 fácilmente.  En vez de hacer cero la anchura
2387 @code{extra-spacing-width}, podemos añadirle algo más.  Las unidades
2388 son el espacio entre dos líneas de pentagrama, así que al mover el
2389 límite izquierdo media unidad a la izquierda y el límite derecho media
2390 unidad hacia la derecha, deberíamos conseguirlo:
2391
2392 @cindex DynamicText, ejemplo de sobreescritura
2393 @cindex extra-spacing-width, propiedad, ejemplo
2394
2395 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2396 \dynamicUp
2397 % Extend width by 1 staff space
2398 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2399 a4\f b\mf c\mp b\p
2400 @end lilypond
2401
2402 @noindent
2403 Esto tiene un mejor aspecto, pero quizá habríamos preferido que las
2404 indicaciones de dinámica estuvieran alineadas sobre la misma línea de
2405 base en lugar de ir hacia arriba y hacia abajo con las notas.  La
2406 propiedad que lo hace es @code{staff-padding} (relleno de pentagrama)
2407 que se estudia en la sección siguiente.
2408
2409
2410 @node Colisiones de objetos
2411 @section Colisiones de objetos
2412 @translationof Collisions of objects
2413
2414 @menu
2415 * Mover objetos::
2416 * Arreglar notación con superposiciones::
2417 * Ejemplos reales de música::
2418 @end menu
2419
2420 @node Mover objetos
2421 @subsection Mover objetos
2422 @translationof Moving objects
2423
2424 @cindex mover objetos superpuestos
2425 @cindex mover objetos que colisionan
2426 @cindex mover grobs que colisionan
2427 @cindex objetos que colisionan, mover
2428 @cindex grobs que colisionan, mover
2429
2430 Aunque pueda sorprenderle, LilyPond no es perfecto.  Ciertos elementos
2431 de notación se pueden superponer, lo que es una lástima, pero en
2432 realidad es bastante poco frecuente.  Normalmente la necesidad de
2433 mover objetos es por claridad o razones estéticas: el aspecto es mejor
2434 con un poco más o un poco menos de espacio de separación.
2435
2436 Existen tres enfoques principales que llevan a la resolución de
2437 superposiciones en la notación.  Se deben considerar en el siguiente
2438 orden:
2439
2440 @enumerate
2441 @item
2442 La @strong{dirección} de uno de los objetos que se superponen se puede
2443 cambiar usando las instrucciones predefinidas que están relacionadas
2444 arriba para los objetos dentro-del-pentagrama (véase @ref{Objetos interiores al pentagrama}).  Se pueden recolocar fácilmente las plicas, ligaduras de
2445 expresión y de unión, barras de corchea, indicaciones dinámicas, texto
2446 y grupos de valoración especial de esta forma.  La limitación es que
2447 sólo tiene la posibilidad de elegir entre dos posiciones, y podría ser
2448 que ninguna de ellas sea la adecuada.
2449
2450 @item
2451 Las @strong{propiedades del objeto}, que LilyPond usa cuando está
2452 colocando los objetos de presentación, se pueden modificar usando la
2453 instrucción de sobreescritura @code{\override}.  Las ventadas de hacer
2454 cambios a este tipo de propiedad son: a) que algún otro objeto se
2455 moverá automáticamente si es necesario, para dejarle sitio, y b) una
2456 única sobreescritura se puede aplicar a todas las instancias del mismo
2457 tipo de objeto.  Entre tales propiedades se encuentran:
2458
2459 @itemize
2460
2461 @item
2462 @code{direction} (dirección)
2463
2464 Ya se ha estudiado con cierto detalle: véase @ref{Objetos interiores al pentagrama}.
2465
2466 @item
2467 @code{padding} (relleno), @code{left-padding} (relleno por la
2468 izquierda), @code{right-padding} (relleno por la derecha),
2469 @code{staff-padding} (relleno de pentagrama)
2470
2471 @cindex relleno
2472 @cindex left-padding, propiedad
2473 @cindex padding, propiedad
2474 @cindex right-padding, propiedad
2475 @cindex staff-padding, propiedad
2476
2477 Según un objeto se está colocando, el valor de su propiedad de relleno
2478 @code{padding} especifica el espacio intermedio que se debe dejar
2479 entre él mismo y el límite más próximo del objeto contra el que se
2480 está colocando.  Observe que es el valor de @code{padding} del objeto
2481 @strong{que se está colocando} el que se usa; el valor de
2482 @code{padding} del objeto que ya está colocado se ignora.  Los
2483 espacios intermedios especificados mediante @code{padding} se pueden
2484 aplicar a todos los objetos que contemplan el interface
2485 @code{side-position-interface}.
2486
2487 En lugar de con @code{padding}, la colocación de los grupos de
2488 alteraciones se controla con @code{left-padding} y
2489 @code{right-padding}.  Estas propiedades se encontrarán en el objeto
2490 @code{AccidentalPlacement} que, observe, vive dentro del contexto de
2491 @strong{staff}.  Durante el proceso tipográfico, las cabezas de las
2492 notas se componen tipográficamente en primer lugar, y después las
2493 alteraciones, si existen, se añaden a la izquierda de las cabezas
2494 utilizando la propiedad de relleno por la derecha @code{right-padding}
2495 para determinar la separación entre la alteración y la cabeza.  así
2496 pues, sólo la propiedad de relleno por la derecha @code{right-padding}
2497 del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
2498 de las alteraciones.
2499
2500 La propiedad @code{staff-padding} está estrechamente relacionada con
2501 la propiedad @code{padding}: @code{padding} controla la separación
2502 mínima entre cualquier objeto que contemple el interface
2503 @code{side-position-interface} y el objeto más cercano (generalmente
2504 la nota o las líneas del pentagrama); @code{staff-padding} se aplica
2505 sólo a los objetos que siempre se sitúan fuera del pentagrama:
2506 controla la separación mínima entre dicho objeto y el pentagrama.
2507 Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
2508 que se posicionan respecto a la nota en vez de hacerlo respecto al
2509 pentagrama, incluso aunque puede ser sobreescrito sin error por tales
2510 objetos: simplemente se ignora.
2511
2512 Para descubrir qué propiedad de relleno se necesita para el objeto que
2513 quiere recolocar, debe volver al manual de RFI y buscar las
2514 propiedades del objeto.  Tenga cuidado porque las propiedades de
2515 relleno podrían no estar en el objeto más obvio, así que busque en los
2516 objetos que puedan tener alguna relación con él.
2517
2518 Todos los valores de relleno se miden en espacios del pentagrama.
2519 Para la mayor parte de los objetos el valor se establece de forma
2520 predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
2521 Se puede sobreescribir si se necesita una separación intermedia mayor
2522 (o menor).
2523
2524 @item
2525 @code{self-alignment-X} (Auto-alineamiento en el eje X)
2526
2527 @cindex self-alignment-X, propiedad
2528
2529 Esta propiedad se puede usar para alinear el objeto a la izquierda, a
2530 la derecha, o centrarlo con respecto al punto de referencia del objeto
2531 «padre».  Se puede usar con todos los objetos que contemplan el
2532 interface
2533 @code{self-alignment-interface}.  En general son objetos que contienen
2534 texto.  Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}.  De
2535 forma alternativa se puede especificar un valor numérico entre
2536 @code{-1} y @code{+1}, donde @code{-1} es alineado por la izquierda,
2537 @code{+1} es alineado por la derecha, y los números intermedios mueven
2538 el texto progresivamente desde alineado por la izquierda hasta alineado
2539 por la derecha.  Se pueden especificar valores numéricos mayores de
2540 @code{1} para mover el texto incluso más lejos hacia la izquierda, o
2541 menos de @code{-1} para alejarlo más hacia la derecha.  Un cambio en
2542 @code{1} en el valor corresponde a un movimiento de la mitad de la
2543 longitud total del propio texto.
2544
2545 @item
2546 @code{extra-spacing-width} (anchura de separación adicional)
2547
2548 @cindex extra-spacing-width, propiedad
2549
2550 Esta propiedad está disponible para todos los objetos que contemplan
2551 el interface @code{item-interface}.  Toma dos números, el primero se
2552 suma al límite izquierdo y el segundo se suma al límite derecho.  Los
2553 números negativos desplazan el límite a la izquierda y los positivos a
2554 la derecha, por lo que para ensanchar un objeto el primer número debe
2555 ser negativo y el segundo positivo.  Observe que no todos los objetos
2556 ostentan los dos números.  Por ejemplo, el objeto @code{Accidental}
2557 (alteración) sólo toma nota del primer número (el borde izquierdo).
2558
2559 @item
2560 @code{staff-position} (posición de pentagrama)
2561
2562 @cindex staff-position, propiedad
2563
2564 @code{staff-position} es una propiedad del interface
2565 @code{staff-symbol-referencer-interface}, que está contemplado por los
2566 objetos que se colocan con relación al pentagrama.  Especifica la
2567 posición vertical del objeto con relación a la tercera línea del
2568 pentagrama en medios espacios de pentagrama.  Es útil en la
2569 resolución de colisiones entre objetos de presentación como silencios
2570 multi-compás, ligaduras de unión y notas en distintas voces.
2571
2572 @item
2573 @code{force-hshift} (forzar desplazamiento horizontal)
2574
2575 @cindex force-hshift, propiedad
2576
2577 Las notas muy juntas de un acorde, o aquellas que ocurren al mismo
2578 tiempo en voces distintas, se disponen en dos (y ocasionalmente más)
2579 columnas para evitar la superposición de las cabezas.  Éstas reciben
2580 el nombre de columnas de notas, y se crea un objeto llamado
2581 @code{NoteColumn} para disponer las notas en dicha columna.
2582
2583 La propiedad @code{force-hshift} es una propiedad de una
2584 @code{NoteColumn} (realmente lo es del interface
2585 @code{note-column-interface}).  Modificarlo permite mover una columna
2586 de notas en unidades adecuadas a una columna de notas, por ejemplo la
2587 anchura de la cabeza de la nota de la primera voz.  Se debe usar en
2588 situaciones complejas donde las instrucciones @code{\shiftOn} normales
2589 (véase @ref{Voces explícitas}) no resuelven el
2590 conflicto entre las notas.  Es preferible a la propiedad
2591 @code{extra-offset} para este propósito porque no hay necesidad de
2592 averiguar la distancia en espacios de pentagrama, y mover las notas
2593 dentro o fuera de una @code{NoteColumn} afecta a otras acciones como a
2594 la fusión entre cabezas de nota.
2595
2596 @end itemize
2597
2598 @item
2599 Finalmente, cuando todo lo demás falla, los objetos se pueden
2600 reposicionar manualmente con relación a la tercera línea del
2601 pentagrama verticalmente, o desplazándolas una cierta distancia a una
2602 nueva posición.  Las desventajas son que los valores correctos para el
2603 reposicionamiento se deben adivinar, a menudo por ensayo y error, para
2604 cada objeto individual y, puesto que el movimiento se hace después de
2605 que LilyPond ha colocado todos los demás objetos es usuario es
2606 responsable de evitar cualquier colisión que pudiera producirse.  Pero
2607 la dificultar principal con este enfoque es que los valores de
2608 reposicionado podrían tener que ser vueltos a calcular si la música se
2609 modifica más tarde.  Las propiedades que se pueden usar para este tipo
2610 de posicionamiento manual son:
2611
2612 @table @code
2613 @item extra-offset (desplazamiento adicional)
2614
2615 @cindex extra-offset, propiedad
2616
2617 Esta propiedad se aplica a cualquier objeto de presentación que
2618 contemple el @code{grob-interface}.  Toma una pareja de números que
2619 especifican el desplazamiento adicional en las direcciones horizontal
2620 y vertical.  Los números negativos mueven el objeto a la izquierda o
2621 hacia abajo.  Las unidades son espacios de pentagrama.  El
2622 desplazamiento adicional se hace después de que la composición
2623 tipográfica de los objetos ha terminado, así que un objeto puede ser
2624 reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
2625
2626 @item positions (posiciones)
2627
2628 @cindex positions, propiedad
2629
2630 Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
2631 la altura de las barras de corchea, ligaduras de expresión y corchetes
2632 de grupos de valoración especial.  Toma una pareja de números que dan
2633 la posición de los extremos izquierdo y derecho de la barra, ligadura,
2634 etc. con relación a la tercera línea del pentagrama.  Las unidades son
2635 espacios de pentagrama.  Observe, sin embargo, que las ligaduras de
2636 expresión y de fraseo no se pueden reposicionar en cantidades
2637 arbitrariamente grandes.  LilyPond en primer lugar genera una lista de
2638 posiciones posibles para la ligadura y de forma predeterminada
2639 encuentra la ligadura que tiene @qq{mejor aspecto}.  Si la propiedad
2640 @code{positions} se ha sobreescrito, la ligadura que está más cerca de
2641 las posiciones que se han solicitado, se selecciona de la lista.
2642 @end table
2643
2644 @end enumerate
2645
2646 Un objeto en particular podría no tener todas estas propiedades.  Es
2647 necesario ir al manual RFI para buscar qué propiedades se encuentran
2648 disponibles para el objeto en cuestión.
2649
2650
2651 Aquí presentamos una lista de los objetos que es más probable que
2652 estén implicados en colisiones, con el nombre del objeto que habría
2653 que buscar en el RFI para descubrir qué propiedades se deben usar para
2654 moverlos.
2655
2656 @multitable @columnfractions .5 .5
2657 @headitem Tipo de objeto           @tab Nombre del objeto
2658 @item Articulaciones            @tab @code{Script}
2659 @item Barras                    @tab @code{Beam}
2660 @item Dinámica (verticalmente)  @tab @code{DynamicLineSpanner}
2661 @item Dinámica (horizontalmente)   @tab @code{DynamicText}
2662 @item Digitaciones                @tab @code{Fingering}
2663 @item Llamadas de ensayo y textuales   @tab @code{RehearsalMark}
2664 @item Ligaduras de expresión    @tab @code{Slur}
2665 @item Texto, por ejemplo @code{^"texto"}  @tab @code{TextScript}
2666 @item Ligaduras de unión        @tab @code{Tie}
2667 @item Grupos de valoración especial @tab @code{TupletBracket}
2668 @end multitable
2669
2670
2671 @node Arreglar notación con superposiciones
2672 @subsection Arreglar notación con superposiciones
2673 @translationof Fixing overlapping notation
2674
2675 Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
2676 en la sección anterior, para resolver problemas de notación que se
2677 superpone.
2678
2679 @subheading la propiedad padding (relleno)
2680
2681 @cindex relleno
2682 @cindex arreglar notación que se superpone
2683 @cindex superpuesta, notación
2684
2685 La propiedad @code{padding} se puede ajustar para aumentar (o
2686 disminuir) la distancia entre símbolos impresos encima o debajo de las
2687 notas.
2688
2689 @cindex Script, ejemplo de sobreescritura
2690 @cindex padding, propiedad, ejemplo
2691
2692 @lilypond[quote,fragment,relative=1,verbatim]
2693 c2\fermata
2694 \override Script #'padding = #3
2695 b2\fermata
2696 @end lilypond
2697
2698 @cindex MetronomeMark, ejemplo de sobreescritura
2699 @cindex padding, propiedad, ejemplo
2700
2701 @lilypond[quote,fragment,relative=1,verbatim]
2702 % This will not work, see below
2703 \override MetronomeMark #'padding = #3
2704 \tempo 4=120
2705 c1
2706 % This works
2707 \override Score.MetronomeMark #'padding = #3
2708 \tempo 4=80
2709 d1
2710 @end lilypond
2711
2712 Observe en el segundo ejemplo la gran importancia que tiene saber qué
2713 contexto maneja un determinado objeto.  Puesto que el objeto
2714 @code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
2715 cambios de propiedades en el contexto @code{Voice} pasarán
2716 inadvertidos.  Para ver más detalles, consulte @ruser{Modificar las propiedades}.
2717
2718 Si la propiedad de relleno @code{padding} de un objeto se incrementa
2719 cuando dicho objeto se encuentra en una pila de objetos que se están
2720 colocando de acuerdo a su prioridad @code{outside-staff-priority},
2721 entonces ese objeto se moverá, y también todos los que están por fuera
2722 de él.
2723
2724
2725 @subheading left-padding y right-padding (relleno por la izquierda y por la derecha)
2726
2727 @cindex left-padding, propiedad
2728 @cindex right-padding, propiedad
2729
2730 La propiedad @code{right-padding} afecta al espaciado entre la
2731 alteración y la nota a que se aplica.  Normalmente no es necesaria,
2732 pero el espaciado predeterminado puede estar mal para ciertos glifos
2733 de alteraciones o combinaciones de glifos que se usan en música
2734 microtonal.  Éstos tienen que introducirse sobreescribiendo el sello
2735 de la alteración con un elemento de marcado que contenga los símbolos
2736 deseados, así:
2737
2738 @cindex Accidental, ejemplo de sobreescritura
2739 @cindex text, propiedad, ejemplo
2740 @cindex stencil, propiedad, ejemplo
2741 @cindex AccidentalPlacement, ejemplo de sobreescritura
2742 @cindex right-padding, propiedad, ejemplo
2743
2744
2745 @lilypond[quote,ragged-right,verbatim]
2746 sesquisharp = \markup { \sesquisharp }
2747 \relative c'' {
2748   c4
2749   % This prints a sesquisharp but the spacing is too small
2750   \once \override Accidental
2751     #'stencil = #ly:text-interface::print
2752   \once \override Accidental #'text = #sesquisharp
2753   cis4 c
2754   % This improves the spacing
2755   \once \override Score.AccidentalPlacement #'right-padding = #0.6
2756   \once \override Accidental
2757     #'stencil = #ly:text-interface::print
2758   \once \override Accidental #'text = #sesquisharp
2759   cis4
2760 }
2761 @end lilypond
2762
2763 @noindent
2764 Esto utiliza necesariamente una sobreescritura para el sello de la
2765 alteración que no se estudiará hasta más adelante.  El tipo de sello
2766 debe ser un procedimiento, aquí modificado para que imprima el
2767 contenido de la propiedad @code{text} del objeto @code{Accidental},
2768 que a su vez está establecido como un signo de sesquisostenido.
2769 Entonces el signo se puede separar de la cabeza de la nota
2770 sobreescribiendo @code{right-padding}.
2771
2772 @noindent
2773
2774 @subheading la propiedad staff-padding (relleno de pentagrama)
2775
2776 @cindex alineación de objetos sobre la línea base
2777 @cindex objetos, alineación sobre la línea base
2778
2779 @code{staff-padding} se puede usar para alinear objetos como matices
2780 dinámicos a lo largo de una línea de base a una altura fija sobre el
2781 pentagrama, en lugar de hacerlo a una altura que dependa de la
2782 posición de la nota a la que están adosados.  No es una propiedad de
2783 @code{DynamicText} sino de @code{DynamicLineSpanner}.  Esto es así
2784 porque la línea de base debe aplicarse por igual a @strong{todas} las
2785 dinámicas, entre ellas las que se han creado como objetos de
2786 extensión.  Así que ésta es la forma de alinear las indicaciones de
2787 matiz en el ejemplo de la sección anterior:
2788
2789 @cindex DynamicText, ejemplo de sobreescritura
2790 @cindex extra-spacing-width, propiedad, ejemplo
2791 @cindex DynamicLineSpanner, ejemplo de sobreescritura
2792 @cindex staff-padding, propiedad, ejemplo
2793
2794 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2795 \dynamicUp
2796 % Extend width by 1 unit
2797 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2798 % Align dynamics to a base line 2 units above staff
2799 \override DynamicLineSpanner #'staff-padding = #2
2800 a4\f b\mf c\mp b\p
2801 @end lilypond
2802
2803
2804 @subheading la propiedad self-alignment-X (auto-alineación en X)
2805
2806 El ejemplo siguiente muestra cómo esto puede resolver la colisión
2807 entre un objeto de digitación de cuerda y la plica de una nota
2808 mediante el alineamiento del límite derecho con el punto de referencia
2809 de la nota «padre»:
2810
2811 @cindex StringNumber, ejemplo de sobreescritura
2812 @cindex self-alignment-X, propiedad, ejemplo
2813
2814 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
2815 \voiceOne
2816 < a\2 >
2817 \once \override StringNumber #'self-alignment-X = #RIGHT
2818 < a\2 >
2819 @end lilypond
2820
2821 @subheading la propiedad staff-position (posición en el pentagrama)
2822
2823 @cindex objeto, colisión dentro del pentagrama
2824
2825 Los silencios multi-compás en una voz pueden chocar con las notas en
2826 otra voz.  Puesto que estos silencios se tipografían centrados entre
2827 las barras de compás se necesitaría bastante esfuerzo para que
2828 LilyPond averiguara qué otras notas podrían chocar con él, ya que
2829 actualmente todo el manejo de colisiones entre notas y silencios se
2830 hace solamente para notas y silencios que ocurren al mismo tiempo.  He
2831 aquí un ejemplo de colisión de este tipo:
2832
2833 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2834 << { c4 c c c } \\ { R1 } >>
2835 @end lilypond
2836
2837 La mejor solución aquí es mover el silencio multi-compás hacia abajo,
2838 pues el silencio está en la voz dos.  El ajuste predeterminado para
2839 @code{\voiceTwo} (es decir, en la segunda voz de una construcción
2840 @code{<<@{...@} \\ @{...@}>>}) es que @code{staff-position} tenga el
2841 valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
2842 cuatro semi-espacios de pentagrama, al valor @code{-8}.
2843
2844 @cindex MultiMeasureRest, ejemplo de sobreescritura
2845 @cindex staff-position, propiedad, ejemplo
2846
2847 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2848 <<
2849   { c4 c c c }
2850   \\
2851   \override MultiMeasureRest #'staff-position = #-8
2852   { R1 }
2853 >>
2854 @end lilypond
2855
2856 Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
2857 la línea adicional por encima del silencio se inserta automáticamente.
2858
2859 @subheading la propiedad extra-offset (desplazamiento adicional)
2860
2861 @cindex posicionar objetos
2862 @cindex posicionar grobs
2863 @cindex objetos, posicionar
2864 @cindex grobs, posicionar
2865
2866 La propiedad @code{extra-offset} da un completo control sobre el
2867 posicionamiento de un objeto tanto vertical como horizontalmente.
2868
2869 En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
2870 a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
2871
2872 @cindex Fingering, ejemplo de sobreescritura
2873 @cindex extra-offset, propiedad, ejemplo
2874
2875 @lilypond[quote,fragment,relative=1,verbatim]
2876 \stemUp
2877 f4-5
2878 \once \override Fingering #'extra-offset = #'(-0.3 . -1.8)
2879 f4-5
2880 @end lilypond
2881
2882
2883 @subheading la propiedad positions (posiciones)
2884
2885 @cindex controlar manualmente grupos especiales, ligaduras y barras
2886 @cindex manual, control, de grupos especiales, ligaduras y barras
2887 @cindex grupos especiales, barras de, control manual
2888 @cindex ligaduras de expresión, control manual
2889 @cindex ligaduras de fraseo, control manual
2890 @cindex barras de corchea, control manual
2891
2892 La propiedad @code{positions} permite controlar manualmente la
2893 posición e inclinación de los tresillos, ligaduras de expresión y de
2894 fraseo, y barras de corchea.  He aquí un ejemplo que tiene una fea
2895 ligadura de fraseo debido a que intenta evitar la ligadura de
2896 expresión que está sobre la acciaccatura.
2897
2898 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2899 r4 \acciaccatura e8\( d8 c~ c d c d\)
2900 @end lilypond
2901
2902 @noindent
2903 Simplemente podemos mover la ligadura de fraseo por encima de las
2904 notas, y de hecho ésta será la solución preferida:
2905
2906 @cindex PhrasingSlur, ejemplo de sobreescritura
2907 @cindex positions, propiedad, ejemplo
2908
2909 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2910 r4
2911 \phrasingSlurUp
2912 \acciaccatura e8\( d8 c~ c d c d\)
2913 @end lilypond
2914
2915 @noindent
2916 Pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
2917 sería mover el extremo izquierdo de la ligadura de fraseo un poco
2918 hacia abajo usando la propiedad @code{positions}.  Esto también
2919 resuelve la forma algo indecente de la ligadura.
2920
2921 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
2922 r4
2923 \once \override PhrasingSlur #'positions = #'(-4 . -3)
2924 \acciaccatura
2925 e8\( d8 c~ c d c d\)
2926 @end lilypond
2927
2928 Presentamos un ejemplo más extraído del comienzo del pentagrama de la
2929 mano izquierda del preludio de Chopin Op 28 No. 2.  vemos que la barra
2930 choca con las notas superiores:
2931
2932 @lilypond[quote,verbatim,fragment,ragged-right]
2933 {
2934   \clef "bass"
2935   << { b,8 ais, b, g, } \\ { e, g e, g } >>
2936   << { b,8 ais, b, g, } \\ { e, g e, g } >>
2937 }
2938 @end lilypond
2939
2940 @noindent
2941 Esto se puede resolver manualmente elevando los dos extremos de la
2942 barra desde su posición a dos espacios de pentagrama sobre la línea
2943 central hasta, digamos, 3 espacios:
2944
2945 @cindex Beam, ejemplo de sobreescritura
2946 @cindex positions, propiedad, ejemplo
2947
2948 @lilypond[quote,verbatim,fragment,ragged-right]
2949 {
2950   \clef "bass"
2951   <<
2952     \override Beam #'positions = #'(3 . 3)
2953     { b,8 ais, b, g, }
2954   \\
2955     { e,8 g e, g }
2956   >>
2957   << { b,8 ais, b, g, } \\ { e, g e, g } >>
2958 }
2959 @end lilypond
2960
2961 @noindent
2962 Observe que la sobreescritura sigue aplicándose en la primera voz del
2963 segundo bloque de corcheas, pero no a ninguna de las barras de la
2964 segunda voz.
2965
2966 @subheading la propiedad force-hshift (forzar desplazamiento horizontal)
2967
2968 Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
2969 Chopin que presentamos al final de @ref{Oigo voces}, que
2970 dejamos con este aspecto:
2971
2972 @lilypond[quote,verbatim,fragment,ragged-right]
2973 \new Staff \relative c'' {
2974   \key aes \major
2975   <<
2976     { c2 aes4. bes8 } \\
2977     { aes2 f4 fes } \\
2978     { \voiceFour
2979       <ees c>2
2980       des2
2981     }
2982   >>
2983   <c ees aes c>1
2984 }
2985 @end lilypond
2986
2987 @noindent
2988 Las dos notas inferiores del primer acorde (es decir, las que están en
2989 al tercera voz) no deberían separarse de la columna de notas de las dos
2990 notas agudas.  Para corregir esto, establecemos el valor de
2991 @code{force-hshift} (que es una propiedad de @code{NoteColumn}) de
2992 esas notas a cero.  La nota más grave del segundo acorde se sitúa
2993 mejor justo a la derecha de las más agudas.  Lo conseguimos
2994 estableciendo el valor de @code{force-hshift} de esta nota a 0.5, o
2995 sea, la anchura de media cabeza de nota a la derecha de la columna de
2996 las notas agudas.
2997
2998 Presentamos a continuación el resultado final:
2999
3000 @cindex NoteColumn, ejemplo de sobreescritura
3001 @cindex force-hshift, propiedad, ejemplo
3002
3003 @lilypond[quote,verbatim,fragment,ragged-right]
3004 \new Staff \relative c'' {
3005   \key aes \major
3006   <<
3007     { c2 aes4. bes8 } \\
3008     { aes2 f4 fes } \\
3009     { \voiceFour
3010       \once \override NoteColumn #'force-hshift = #0
3011       <ees c>2
3012       \once \override NoteColumn #'force-hshift = #0.5
3013       des2
3014     }
3015   >>
3016   <c ees aes c>1
3017 }
3018 @end lilypond
3019
3020
3021 @node Ejemplos reales de música
3022 @subsection Ejemplos reales de música
3023 @translationof Real music example
3024
3025 Finalizaremos esta sección sobre los trucos mostrando los pasos que se
3026 deben tomar para tratar con un ejemplo complicado que necesita varios
3027 trucos para producir el resultado deseado.  El ejemplo se ha escogido
3028 deliberadamente para ilustrar el uso de la Referencia de la Notación
3029 para resolver problemas de notación poco comunes.  No es
3030 representativo de un proceso de grabado más usual, por lo que ¡le
3031 recomendamos que no deje que estas dificultades le desanimen!
3032 ¡Afortunadamente, las dificultades como éstas no son muy comunes!
3033
3034 El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
3035 compases 6 al 9, la transición entre el Lento inicial y el Moderato.
3036 Presentamos en primer lugar el aspecto que queremos que tenga el
3037 resultado, pero para evitar complicar demasiado el ejemplo hemos
3038 quitado las indicaciones dinámicas, las digitaciones y el pedal.
3039
3040 @c The following should appear as music without code
3041 @c This example should not be indexed
3042 @c line-width ensures no break
3043 @lilypond[quote,ragged-right,line-width=5.5\in]
3044 rhMusic = \relative c'' {
3045   r2
3046   c4.\( g8
3047   \once \override Tie #'staff-position = #3.5
3048   bes1~
3049   \bar "||"
3050   \time 6/4
3051   \mergeDifferentlyHeadedOn
3052   \mergeDifferentlyDottedOn
3053   bes2.^\markup { \bold "Moderato" } r8
3054   <<
3055     { c,8 d fis bes a }
3056   \\
3057     % Reposition the c2 to the right of the merged note
3058     { c,8~ \once \override NoteColumn #'force-hshift = #1.0
3059     % Move the c2 out of the main note column so the merge will work
3060     \shiftOnn c2 }
3061   \\
3062     % Stem on the d2 must be down to permit merging
3063     { s8 \stemDown
3064       \once \override Stem #'transparent = ##t
3065       d2
3066     }
3067   \\
3068     { s4 fis4. }
3069   >>
3070   \mergeDifferentlyHeadedOff
3071   \mergeDifferentlyDottedOff
3072   g2.\)
3073 }
3074
3075 lhMusic = \relative c' {
3076   r2 <c g ees>2(
3077   <d g, d>1)\arpeggio
3078   r2. d,,4 r4 r
3079   r4
3080 }
3081
3082 \score {
3083   \new PianoStaff <<
3084     \new Staff = "RH"  <<
3085       \key g \minor
3086       \rhMusic
3087     >>
3088     \new Staff = "LH" <<
3089       \key g \minor
3090       \clef "bass"
3091       \lhMusic
3092     >>
3093   >>
3094 }
3095 @end lilypond
3096
3097 Observamos en primer lugar que la parte de la mano derecha del tercer
3098 compás requiere cuatro voces.  Son las cinco corcheas unidas por una
3099 barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
3100 y el Fa sostenido negra con puntillo, que también está fundida con la
3101 corchea de su misma altura.  Todo lo demás está en una sola voz, así
3102 que lo más fácil es introducir estas cuatro voces temporalmente en el
3103 momento en que se necesiten.  Si ha olvidado cómo hacerlo, lea
3104 @ref{Oigo voces}.  Vamos a comenzar introduciendo las notas
3105 como dos variables y disponiendo la estructura de pentagramas en un
3106 bloque Score, y veremos qué produce LilyPond de forma predeterminada:
3107
3108 @c line-width ensures no break
3109 @lilypond[quote,verbatim,ragged-right,line-width=5.5\in]
3110 rhMusic = \relative c'' {
3111   r2 c4. g8
3112   bes1~
3113   \time 6/4
3114   bes2. r8
3115   % Start polyphonic section of four voices
3116   <<
3117     { c,8 d fis bes a }
3118   \\
3119     { c,8~ c2 }
3120   \\
3121     { s8 d2 }
3122   \\
3123     { s4 fis4. }
3124   >>
3125   g2.
3126 }
3127
3128 lhMusic = \relative c' {
3129   r2 <c g ees>2
3130   <d g, d>1
3131   r2. d,,4 r4 r
3132   r4
3133 }
3134
3135 \score {
3136   \new PianoStaff <<
3137     \new Staff = "RH"  <<
3138       \key g \minor
3139       \rhMusic
3140     >>
3141     \new Staff = "LH" <<
3142       \key g \minor
3143       \clef "bass"
3144       \lhMusic
3145     >>
3146   >>
3147 }
3148 @end lilypond
3149
3150 Todas las notas son correctas, pero el aspecto está lejos de ser
3151 satisfactorio.  La ligadura de unión choca con el cambio de compás,
3152 las notas no se funden correctamente, y faltan algunos elementos de
3153 notación.  En primer lugar trataremos con lo más fácil.  Podemos
3154 añadir fácilmente la ligadura de expresión de la mano izquierda y la
3155 ligadura de fraseo de la mano derecha, pues todo ello se estudió en el
3156 Tutorial.  Al hacerlo así obtenemos:
3157
3158 @c line-width ensures no break
3159 @lilypond[quote,verbatim,ragged-right,line-width=5.5\in]
3160 rhMusic = \relative c'' {
3161   r2 c4.\( g8
3162   bes1~
3163   \time 6/4
3164   bes2. r8
3165   % Start polyphonic section of four voices
3166   <<
3167     { c,8 d fis bes a }
3168   \\
3169     { c,8~ c2 }
3170   \\
3171     { s8 d2 }
3172   \\
3173     { s4 fis4. }
3174   >>
3175   g2.\)
3176 }
3177
3178 lhMusic = \relative c' {
3179   r2 <c g ees>2(
3180   <d g, d>1)
3181   r2. d,,4 r4 r
3182   r4
3183 }
3184
3185 \score {
3186   \new PianoStaff <<
3187     \new Staff = "RH"  <<
3188       \key g \minor
3189       \rhMusic
3190     >>
3191     \new Staff = "LH" <<
3192       \key g \minor
3193       \clef "bass"
3194       \lhMusic
3195     >>
3196   >>
3197 }
3198 @end lilypond
3199
3200 El primer compás ahora es correcto.  El segundo compás contiene un
3201 arpegio y acaba en una doble barra.  ¿Cómo los hacemos, pues no han
3202 sido mencionados en este Manual de Aprendizaje?  Aquí es donde tenemos
3203 que volver e la Referencia de la Notación.  Buscando la palabra
3204 @q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
3205 que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
3206 doble barra se produce por medio de la instrucción @code{\bar "||"}.
3207 Esto podemos hacerlo fácilmente.  A continuación tenemos que corregir
3208 la colisión entre la ligadura de unión y la indicación de compás.
3209 Esto se hace mejor moviendo la ligadura hacia arriba.  Estudiamos cómo
3210 mover objetos anteriormente en @ref{Mover objetos}, donde dice que
3211 los objetos que están situados de forma relativa al pentagrama se
3212 pueden mover sobreescribiendo su propiedad @code{staff-position}, que
3213 se especifica en unidades de medio espacio de pentagrama respecto de
3214 la línea central del pentagrama.  Así pues, la sobreescritura
3215 siguiente colocada justo antes de la primera nota ligada subirá la
3216 ligadura 3.5 medios espacios de pentagrama por encima de la línea
3217 central:
3218
3219 @code{\once \override Tie #'staff-position = #3.5}
3220
3221 Con esto se completa el compás dos, dando como resultado:
3222
3223 @c line-width ensures no break
3224 @lilypond[quote,verbatim,ragged-right,line-width=5.5\in]
3225 rhMusic = \relative c'' {
3226   r2 c4.\( g8
3227   \once \override Tie #'staff-position = #3.5
3228   bes1~
3229   \bar "||"
3230   \time 6/4
3231   bes2. r8
3232   % Start polyphonic section of four voices
3233   <<
3234     { c,8 d fis bes a }
3235   \\
3236     { c,8~ c2 }
3237   \\
3238     { s8 d2 }
3239   \\
3240     { s4 fis4. }
3241   >>
3242   g2.\)
3243 }
3244
3245 lhMusic = \relative c' {
3246   r2 <c g ees>2(
3247   <d g, d>1)\arpeggio
3248   r2. d,,4 r4 r
3249   r4
3250 }
3251
3252 \score {
3253   \new PianoStaff <<
3254     \new Staff = "RH"  <<
3255       \key g \minor
3256       \rhMusic
3257     >>
3258     \new Staff = "LH" <<
3259       \key g \minor
3260       \clef "bass"
3261       \lhMusic
3262     >>
3263   >>
3264 }
3265 @end lilypond
3266
3267 Vayamos ahora al tercer compás y comienzo de la sección Moderato.  El
3268 tutorial nos enseñó cómo escribir texto en negrita mediante la
3269 instrucción @code{\markup}, por lo que añadir @q{Moderato} en negrita
3270 es fácil.  Pero ahora ¿cómo fundimos notas que están en distintas
3271 voces?  Aquí es donde debemos volver a buscar ayuda en el manual de
3272 Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
3273 el índice de la Referencia de la notación llegamos rápidamente a las
3274 instrucciones para mezclar notas con distinta cabeza y con o sin
3275 puntillo, en @ruser{Resolución de las colisiones}.  En nuestro ejemplo tenemos
3276 que fusionar ambos tipos de nota en el transcurso de la sección
3277 polifónica del compás 3; por tanto, en virtud de la información que
3278 aparece en la Referencia de la Notación, escribimos
3279
3280 @example
3281 \mergeDifferentlyHeadedOn
3282 \mergeDifferentlyDottedOn
3283 @end example
3284
3285 @noindent
3286 al principio de la sección, y
3287
3288 @example
3289 \mergeDifferentlyHeadedOff
3290 \mergeDifferentlyDottedOff
3291 @end example
3292
3293 @noindent
3294 al final, dando como resultado:
3295
3296 @c line-width ensures no break
3297 @lilypond[quote,ragged-right,line-width=5.5\in]
3298 rhMusic = \relative c'' {
3299   r2 c4.\( g8
3300   \once \override Tie #'staff-position = #3.5
3301   bes1~
3302   \bar "||"
3303   \time 6/4
3304   bes2.^\markup { \bold "Moderato" } r8
3305   \mergeDifferentlyHeadedOn
3306   \mergeDifferentlyDottedOn
3307   % Start polyphonic section of four voices
3308   <<
3309     { c,8 d fis bes a }
3310   \\
3311     { c,8~ c2 }
3312   \\
3313     { s8 d2 }
3314   \\
3315     { s4 fis4. }
3316   >>
3317   \mergeDifferentlyHeadedOff
3318   \mergeDifferentlyDottedOff
3319   g2.\)
3320 }
3321
3322 lhMusic = \relative c' {
3323   r2 <c g ees>2(
3324   <d g, d>1)\arpeggio
3325   r2. d,,4 r4 r
3326   r4
3327 }
3328
3329 \score {
3330   \new PianoStaff <<
3331     \new Staff = "RH"  <<
3332       \key g \minor
3333       \rhMusic
3334     >>
3335     \new Staff = "LH" <<
3336       \key g \minor
3337       \clef "bass"
3338       \lhMusic
3339     >>
3340   >>
3341 }
3342 @end lilypond
3343
3344 Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
3345 dos Re.  ¿Por qué no?  La respuesta está en la misma sección de la
3346 Referencia de la Notación: las notas que se fusionan deben tener las
3347 plicas en direcciones opuestas y dos notas no se pueden fusionar bien
3348 si hay una tercera nota en la misma columna.  Aquí los dos Re tienen
3349 las plicas hacia arriba y hay una tercera nota: el Do.  Sabemos cómo
3350 cambiar la dirección de la plica usando @code{\stemDown}, y la
3351 Referencia de la Notación también explica cómo mover el Do: aplicar un
3352 desplazamiento usando una de las instrucciones @code{\shift}.  Pero
3353 ¿cuál?  El Do está en la voz dos que tiene desactivado el
3354 desplazamiento, y los dos Re están en las voces uno y tres, que tienen
3355 el desplazamiento desactivado y activado, respectivamente.  Por ello
3356 tenemos que desplazar el Do un nivel más todavía, usando
3357 @code{\shiftOnn} para evitar que interfiera con los dos Re.  Al
3358 aplicar estos cambios obtenemos:
3359
3360 @cindex Tie, ejemplo de sobreescritura
3361 @cindex staff-position, propiedad, ejemplo
3362
3363 @c line-width ensures no break
3364 @lilypond[quote,verbatim,ragged-right,line-width=5.5\in]
3365 rhMusic = \relative c'' {
3366   r2 c4.\( g8
3367   \once \override Tie #'staff-position = #3.5
3368   bes1~
3369   \bar "||"
3370   \time 6/4
3371   bes2.^\markup { \bold "Moderato" } r8
3372   \mergeDifferentlyHeadedOn
3373   \mergeDifferentlyDottedOn
3374   % Start polyphonic section of four voices
3375   <<
3376     { c,8 d fis bes a }
3377   \\
3378     % Move the c2 out of the main note column so the merge will work
3379     { c,8~ \shiftOnn c2 }
3380   \\
3381     % Stem on the d2 must be down to permit merging
3382     { s8 \stemDown d2 }
3383   \\
3384     { s4 fis4. }
3385   >>
3386   \mergeDifferentlyHeadedOff
3387   \mergeDifferentlyDottedOff
3388   g2.\)
3389 }
3390
3391 lhMusic = \relative c' {
3392   r2 <c g ees>2(
3393   <d g, d>1)\arpeggio
3394   r2. d,,4 r4 r
3395   r4
3396 }
3397
3398 \score {
3399   \new PianoStaff <<
3400     \new Staff = "RH"  <<
3401       \key g \minor
3402       \rhMusic
3403     >>
3404     \new Staff = "LH" <<
3405       \key g \minor
3406       \clef "bass"
3407       \lhMusic
3408     >>
3409   >>
3410 }
3411 @end lilypond
3412
3413 Ya casi está.  Solamente quedan dos problemas: la plica hacia abajo
3414 sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
3415 colocado a la derecha de los Re.  Sabemos cómo hacer las dos cosas a
3416 partir de trucos anteriores: hacemos la plica transparente, y movemos
3417 el Do con la propiedad @code{force-hshift}.  Aquí tenemos el resultado
3418 final:
3419
3420 @cindex NoteColumn, ejemplo de sobreescritura
3421 @cindex force-hshift, propiedad, ejemplo
3422 @cindex Stem, ejemplo de sobreescritura
3423 @cindex transparent, propiedad, ejemplo
3424
3425 @c line-width ensures no break
3426 @lilypond[quote,verbatim,ragged-right,line-width=5.5\in]
3427 rhMusic = \relative c'' {
3428   r2
3429   c4.\( g8
3430   \once \override Tie #'staff-position = #3.5
3431   bes1~
3432   \bar "||"
3433   \time 6/4
3434   bes2.^\markup { \bold "Moderato" } r8
3435   \mergeDifferentlyHeadedOn
3436   \mergeDifferentlyDottedOn
3437   <<
3438     { c,8 d fis bes a }
3439   \\
3440     % Reposition the c2 to the right of the merged note
3441     { c,8~ \once \override NoteColumn #'force-hshift = #1.0
3442     % Move the c2 out of the main note column so the merge will work
3443     \shiftOnn c2 }
3444   \\
3445     % Stem on the d2 must be down to permit merging
3446     { s8 \stemDown
3447       \once \override Stem #'transparent = ##t
3448       d2
3449     }
3450   \\
3451     { s4 fis4. }
3452   >>
3453   \mergeDifferentlyHeadedOff
3454   \mergeDifferentlyDottedOff
3455   g2.\)
3456 }
3457
3458 lhMusic = \relative c' {
3459   r2 <c g ees>2(
3460   <d g, d>1)\arpeggio
3461   r2. d,,4 r4 r
3462   r4
3463 }
3464
3465 \score {
3466   \new PianoStaff <<
3467     \new Staff = "RH"  <<
3468       \key g \minor
3469       \rhMusic
3470     >>
3471     \new Staff = "LH" <<
3472       \key g \minor
3473       \clef "bass"
3474       \lhMusic
3475     >>
3476   >>
3477 }
3478 @end lilypond
3479
3480
3481 @node Trucajes adicionales
3482 @section Trucajes adicionales
3483 @translationof Further tweaking
3484
3485 @menu
3486 * Otras aplicaciones de los trucos::
3487 * Uso de variables para los trucos::
3488 * Hojas de estilo::
3489 * Otras fuentes de información::
3490 * Evitar los trucos con un proceso ralentizado::
3491 * Trucos avanzados con Scheme::
3492 @end menu
3493
3494 @node Otras aplicaciones de los trucos
3495 @subsection Otras aplicaciones de los trucos
3496 @translationof Other uses for tweaks
3497
3498 @cindex transparent, uso de la propiedad
3499 @cindex objetos, hace invisibles
3500 @cindex eliminar objetos
3501 @cindex objetos, eliminar
3502 @cindex objetos, ocultar
3503 @cindex ocultar objetos
3504 @cindex invisibles, objetos
3505 @cindex objetos invisibles
3506 @cindex ligar notas entre voces distintas
3507
3508 @subheading Ligar notas entre voces distintas
3509
3510 El ejemplo siguiente muestra cómo conectar notas que están en
3511 distintas voces utilizando ligaduras de unión.  Normalmente sólo se
3512 pueden conectar mediante ligaduras de unión dos notas que estén en la
3513 misma voz.  Usando dos voces, con las notas ligadas en una de ellas:
3514
3515 @lilypond[quote,fragment,relative=2]
3516 << { b8~ b8\noBeam }
3517 \\ { b[ g8] }
3518 >>
3519 @end lilypond
3520
3521 @noindent
3522 y borrando la primera plica hacia arriba en esa voz, da la impresión
3523 de que la ligadura se cruza entre las voces:
3524
3525 @cindex Stem, ejemplo de sobreescritura
3526 @cindex transparent, propiedad, ejemplo
3527
3528 @lilypond[quote,fragment,relative=2,verbatim]
3529 <<
3530   {
3531     \once \override Stem #'transparent = ##t
3532     b8~ b8\noBeam
3533   }
3534 \\
3535   { b[ g8] }
3536 >>
3537 @end lilypond
3538
3539 Para estar seguros de que la plica que acabamos de borrar no aprieta
3540 demasiado a la ligadura, podemos alargar la plica estableciendo su
3541 valor de longitud @code{length} a @code{8},
3542
3543 @lilypond[quote,fragment,relative=2,verbatim]
3544 <<
3545   {
3546     \once \override Stem #'transparent = ##t
3547     \once \override Stem #'length = #8
3548     b8~ b8\noBeam
3549   }
3550 \\
3551   { b[ g8] }
3552 >>
3553 @end lilypond
3554
3555 @subheading Simulación de un calderón en el MIDI
3556
3557 @cindex sello, uso de la propiedad
3558 @cindex fermata, realización en MIDI
3559
3560 Para los objetos fuera-del-pentagrama, normalmente es mejor
3561 sobreescribir la propiedad @code{stencil} («sello») del objeto que su
3562 propiedad @code{transparent} cuando desee quitarlos de la salida
3563 impresa.  Mediante el establecimiento de la propiedad @code{stencil}
3564 de un objeto al valor @code{#f} podemos quitar el objeto por completo
3565 de la salida impresa.  Esto significa que no tiene efecto sobre la
3566 colocación de otros objetos que pudieran colocarse en relación a él.
3567
3568 Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
3569 propósito de simular un calderón en la salida MIDI, seguramente no
3570 querríamos que la indicación metronómica apareciese en la salida
3571 impresa, y no querríamos influir sobre la separación entre los dos
3572 sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
3573 pentagrama.  Por lo tanto, establecer su propiedad @code{stencil} al
3574 valor @code{#f} sería la mejor manera.  Mostramos aquí el efecto de
3575 los dos métodos:
3576
3577 @cindex MetronomeMark, ejemplo de sobreescritura
3578 @cindex transparent, propiedad, ejemplo
3579
3580 @lilypond[quote,verbatim,ragged-right]
3581 \score {
3582   \relative c'' {
3583     % Visible tempo marking
3584     \tempo 4=120
3585     a4 a a
3586     \once \override Score.MetronomeMark #'transparent = ##t
3587     % Invisible tempo marking to lengthen fermata in MIDI
3588     \tempo 4=80
3589     a4\fermata
3590     % New tempo for next section
3591     \tempo 4=100
3592     a4 a a a
3593   }
3594   \layout { }
3595   \midi { }
3596 }
3597 @end lilypond
3598
3599 @cindex MetronomeMark, ejemplo de sobreescritura
3600 @cindex stencil, propiedad, ejemplo
3601
3602 @lilypond[quote,verbatim,ragged-right]
3603 \score {
3604   \relative c'' {
3605     % Visible tempo marking
3606     \tempo 4=120
3607     a4 a a
3608     \once \override Score.MetronomeMark #'stencil = ##f
3609     % Invisible tempo marking to lengthen fermata in MIDI
3610     \tempo 4=80
3611     a4\fermata
3612     % New tempo for next section
3613     \tempo 4=100
3614     a4 a a a
3615   }
3616   \layout { }
3617   \midi { }
3618 }
3619 @end lilypond
3620
3621 @noindent
3622 Ambos métodos quitan de la salida impresa la indicación metronómica
3623 que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
3624 queríamos, pero la indicación metronómica transparente de la primera
3625 línea fuerza una colocación muy alta de la indicación de tempo que
3626 sigue, mientras que la segunda (con el sello suprimido) no lo hace.
3627
3628 @node Uso de variables para los trucos
3629 @subsection Uso de variables para los trucos
3630 @translationof Using variables for tweaks
3631
3632 @cindex variables, uso de, para trucos
3633 @cindex usar variables para hacer trucos
3634 @cindex trucos, usar variables para hacer
3635
3636 Las instrucciones de sobreescritura son con frecuencia largas y
3637 tediosas de escribir, y se tienen que escribir de forma absolutamente
3638 correcta.  Si las mismas sobreescrituras se van a utilizar muchas
3639 veces, podría merecer la pena definir variables para guardarlas.
3640
3641 Supongamos que queremos realzar ciertas palabras de la letra de una
3642 canción imprimiéndolas en cursiva y negrita.  Las instrucciones
3643 @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
3644 canciones si están incluidas, junto con la palabra o palabras que se
3645 pretenden modificar, dentro de un @code{\markup}, lo que las hace
3646 tediosas de escribir. La necesidad de incluir las propias palabras
3647 impide que se puedan usar en variables simples. ¿Podríamos, como
3648 alternativa, utilizar las instrucciones @code{\override} y
3649 @code{\revert}?
3650
3651 @example
3652 @code{\override Lyrics . LyricText #'font-shape = #'italic}
3653 @code{\override Lyrics . LyricText #'font-series = #'bold}
3654
3655 @code{\revert Lyrics . LyricText #'font-shape}
3656 @code{\revert Lyrics . LyricText #'font-series}
3657 @end example
3658
3659 Estas instrucciones también serían extremadamente tediosas de escribir
3660 si hubiera muchas palabras que quisiéramos subrayar.  Pero sí
3661 @emph{podemos} definirlas como dos variables y usarlas para delimitar
3662 las palabras que destacar.  Otra ventaja de la utilización de
3663 variables para estas sobreescrituras es que ya no son necesarios los
3664 espacios que rodean al punto, puesto que no se interpretan
3665 directamente en el modo @code{\lyricmode}.  He aquí un ejemplo de
3666 esto, aunque en la práctica quizá elegiríamos unos nombres de variable
3667 más cortos para que fueran más rápidos de teclear:
3668
3669 @cindex LyricText, ejemplo de sobreescritura
3670 @cindex font-shape, propiedad, ejemplo
3671 @cindex font-series, propiedad, ejemplo
3672
3673 @lilypond[quote,verbatim]
3674 emphasize = {
3675   \override Lyrics.LyricText #'font-shape = #'italic
3676   \override Lyrics.LyricText #'font-series = #'bold
3677 }
3678 normal = {
3679   \revert Lyrics.LyricText #'font-shape
3680   \revert Lyrics.LyricText #'font-series
3681 }
3682
3683 global = { \time 4/4 \partial 4 \key c \major}
3684 SopranoMusic   = \relative c' { c4 | e4. e8 g4  g  | a a g }
3685 AltoMusic  = \relative c' { c4 | c4. c8 e4  e  | f f e }
3686 TenorMusic = \relative c  { e4 | g4. g8 c4. b8 | a8 b c d e4 }
3687 BassMusic  = \relative c  { c4 | c4. c8 c4  c  | f8 g a b c4 }
3688 VerseOne   = \lyrics { E -- | ter -- nal \emphasize Fa -- ther, \normal | strong to save, }
3689 VerseTwo   = \lyricmode { O | \emphasize Christ, \normal whose voice the | wa -- ters heard, }
3690 VerseThree = \lyricmode { O | \emphasize Ho -- ly Spi -- rit, \normal | who didst brood }
3691 VerseFour  = \lyricmode { O | \emphasize Tri -- ni -- ty \normal of | love and pow'r }
3692
3693 \score {
3694   \new ChoirStaff <<
3695     \new Staff <<
3696       \clef "treble"
3697       \new Voice = "Soprano"  { \voiceOne \global \SopranoMusic }
3698       \new Voice = "Alto" { \voiceTwo \AltoMusic }
3699       \new Lyrics \lyricsto "Soprano" { \VerseOne }
3700       \new Lyrics \lyricsto "Soprano" { \VerseTwo }
3701       \new Lyrics \lyricsto "Soprano" { \VerseThree }
3702       \new Lyrics \lyricsto "Soprano" { \VerseFour }
3703     >>
3704     \new Staff <<
3705       \clef "bass"
3706       \new Voice = "Tenor" { \voiceOne \TenorMusic }
3707       \new Voice = "Bass"  { \voiceTwo \BassMusic }
3708     >>
3709   >>
3710 }
3711 @end lilypond
3712
3713
3714 @node Hojas de estilo
3715 @subsection Hojas de estilo
3716 @translationof Style sheets
3717
3718 La salida que produce LilyPond se puede modificar profundamente;
3719 consulte @ref{Trucar la salida} para leer detalles sobre este asunto.
3720 Pero ¿qué ocurre si tiene muchos archivos a los que les quiere aplicar
3721 sus propios trucos?  O ¿qué ocurre si, sencillamente, quiere separar
3722 los trucos de la propia música?  Todo esto es bastante fácil de
3723 conseguir.
3724
3725 Veamos un ejemplo.  No se preocupe si no entiende
3726 las partes que tienen todos los @code{#()}.  Esto se explicará en
3727 @ref{Trucos avanzados con Scheme}.
3728
3729 @lilypond[quote,verbatim,ragged-right]
3730 mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
3731   #:line(#:dynamic "mp" #:text #:italic "dolce" )))
3732
3733 inst = #(define-music-function (parser location string) (string?)
3734   (make-music
3735     'TextScriptEvent
3736     'direction UP
3737     'text (markup #:bold (#:box string))))
3738
3739 \relative c'' {
3740   \tempo 4=50
3741   a4.\mpdolce d8 cis4--\glissando a
3742   b4 bes a2
3743   \inst "Clarinet"
3744   cis4.\< d8 e4 fis
3745   g8(\! fis)-. e( d)-. cis2
3746 }
3747 @end lilypond
3748
3749 Existen varios problemas con la salida que se superpone; los
3750 arreglaremos utilizando las técnicas descritas en @ref{Mover objetos}.  Pero también haremos algo respecto a las definiciones
3751 @code{mpdolce} e @code{inst}.  Éstas producen la salida que deseamos,
3752 pero quizá las querríamos utilizar en otra pieza.  Podríamos
3753 simplemente copiarlas y pegarlas al principio de cada archivo, pero
3754 sería bastante molesto.  También hace que se queden las definiciones a
3755 la vista dentro de nuestros archivos de música, y yo personalmente
3756 encuentro todos los @code{#()} bastante poco estéticos.  Los vamos a
3757 esconder dentro de otro archivo:
3758
3759 @example
3760 %%% guardar esto en un archivo de nombre "definiciones.ily"
3761 mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
3762   #:line(#:dynamic "mp" #:text #:italic "dolce" )))
3763
3764 inst = #(define-music-function (parser location string) (string?)
3765   (make-music
3766     'TextScriptEvent
3767     'direction UP
3768     'text (markup #:bold (#:box string))))
3769 @end example
3770
3771 Haremos referencia a este archivo utilizando la instrucción
3772 @code{\include} al principio del archivo de música (la extensión
3773 @code{.ily} se utiliza para distinguir este archivo de inclusión --que
3774 se supone que no debe ser procesado de forma independiente-- del
3775 archivo principal).  Ahora modificaremos la música (guardemos este
3776 archivo como @file{"musica.ly"}).
3777
3778 @c  We have to do this awkward example/lilypond-non-verbatim
3779 @c  because we can't do the \include stuff in the manual.
3780
3781 @example
3782 \include "definiciones.ily"
3783
3784 \relative c'' @{
3785   \tempo 4=50
3786   a4.\mpdolce d8 cis4--\glissando a
3787   b4 bes a2
3788   \inst "Clarinete"
3789   cis4.\< d8 e4 fis
3790   g8(\! fis)-. e( d)-. cis2
3791 @}
3792 @end example
3793
3794 @lilypond[quote,ragged-right]
3795 mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
3796   #:line(#:dynamic "mp" #:text #:italic "dolce" )))
3797
3798 inst = #(define-music-function (parser location string) (string?)
3799   (make-music
3800     'TextScriptEvent
3801     'direction UP
3802     'text (markup #:bold (#:box string))))
3803
3804 \relative c'' {
3805   \tempo 4=50
3806   a4.\mpdolce d8 cis4--\glissando a
3807   b4 bes a2
3808   \inst "Clarinet"
3809   cis4.\< d8 e4 fis
3810   g8(\! fis)-. e( d)-. cis2
3811 }
3812 @end lilypond
3813
3814
3815
3816 Eso tiene mejor aspecto, pero haremos algunos cambios más.  El glissando es difícil
3817 de ver, así que lo haremos más grueso y lo acercaremos a las cabezas de las notas.  Pondremos
3818 la indicación metronómica encima de la clave, en lugar de ir encima de la primera
3819 nota.  Y por último, mi profesor de composición odia las indicaciones de compás @q{C},
3820 así que la convertiremos en @q{4/4}.
3821
3822 Sin embargo, no debemos cambiar el archivo @file{musica.ly}.
3823 Sustituyamos nuestro archivo @file{definiciones.ily} con éste:
3824
3825 @example
3826 %%%  definiciones.ily
3827 mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
3828   #:line( #:dynamic "mp" #:text #:italic "dolce" )))
3829
3830 inst = #(define-music-function (parser location string) (string?)
3831   (make-music
3832     'TextScriptEvent
3833     'direction UP
3834     'text (markup #:bold (#:box string))))
3835
3836 \layout@{
3837   \context @{ \Score
3838     \override MetronomeMark #'extra-offset = #'(-9 . 0)
3839     \override MetronomeMark #'padding = #'3
3840   @}
3841   \context @{ \Staff
3842     \override TimeSignature #'style = #'numbered
3843   @}
3844   \context @{ \Voice
3845     \override Glissando #'thickness = #3
3846     \override Glissando #'gap = #0.1
3847   @}
3848 @}
3849 @end example
3850
3851 @lilypond[quote,ragged-right]
3852 mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
3853   #:line( #:dynamic "mp" #:text #:italic "dolce" )))
3854
3855 inst = #(define-music-function (parser location string) (string?)
3856   (make-music
3857     'TextScriptEvent
3858     'direction UP
3859     'text (markup #:bold (#:box string))))
3860
3861 \layout{
3862   \context { \Score
3863     \override MetronomeMark #'extra-offset = #'(-9 . 0)
3864     \override MetronomeMark #'padding = #'3
3865   }
3866   \context { \Staff
3867     \override TimeSignature #'style = #'numbered
3868   }
3869   \context { \Voice
3870     \override Glissando #'thickness = #3
3871     \override Glissando #'gap = #0.1
3872   }
3873 }
3874
3875 \relative c'' {
3876   \tempo 4=50
3877   a4.\mpdolce d8 cis4--\glissando a
3878   b4 bes a2
3879   \inst "Clarinet"
3880   cis4.\< d8 e4 fis
3881   g8(\! fis)-. e( d)-. cis2
3882 }
3883 @end lilypond
3884
3885 ¡Eso tiene un aspecto mucho mejor!  Ahora suponga que quiere publicar esta
3886 pieza.  A mi profesor de composición no le gustan las indicaciones de compás @q{C},
3887 pero yo les tengo cierto cariño.  Copiaremos el archivo
3888 actual @file{definiciones.ily} a @file{publicar-web.ily} y modificaremos
3889 éste.  Como el propósito de esta música es producir un PDF que va a mostrarse
3890 en la pantalla, también vamos a aumentar el
3891 tamaño general de la salida.
3892
3893 @example
3894 %%%  definiciones.ily
3895 mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
3896   #:line( #:dynamic "mp" #:text #:italic "dolce" )))
3897
3898 inst = #(define-music-function (parser location string) (string?)
3899   (make-music
3900     'TextScriptEvent
3901     'direction UP
3902     'text (markup #:bold (#:box string))))
3903
3904 #(set-global-staff-size 23)
3905 \layout@{
3906   \context @{ \Score
3907     \override MetronomeMark #'extra-offset = #'(-9 . 0)
3908     \override MetronomeMark #'padding = #'3
3909   @}
3910   \context @{ \Staff
3911   @}
3912   \context @{ \Voice
3913     \override Glissando #'thickness = #3
3914     \override Glissando #'gap = #0.1
3915   @}
3916 @}
3917 @end example
3918
3919 @lilypond[quote,ragged-right]
3920 mpdolce = #(make-dynamic-script (markup #:hspace 0 #:translate '(5 . 0)
3921   #:line( #:dynamic "mp" #:text #:italic "dolce" )))
3922
3923 inst = #(define-music-function (parser location string) (string?)
3924   (make-music
3925     'TextScriptEvent
3926     'direction UP
3927     'text (markup #:bold (#:box string))))
3928
3929 #(set-global-staff-size 23)
3930 \layout{
3931   \context { \Score
3932     \override MetronomeMark #'extra-offset = #'(-9 . 0)
3933     \override MetronomeMark #'padding = #'3
3934   }
3935   \context { \Voice
3936     \override Glissando #'thickness = #3
3937     \override Glissando #'gap = #0.1
3938   }
3939 }
3940
3941 \relative c'' {
3942   \tempo 4=50
3943   a4.\mpdolce d8 cis4--\glissando a
3944   b4 bes a2
3945   \inst "Clarinet"
3946   cis4.\< d8 e4 fis
3947   g8(\! fis)-. e( d)-. cis2
3948 }
3949 @end lilypond
3950
3951 Ahora, en la música, simplemente sustituyo @code{\include
3952 "definiciones.ily"} por @code{\include "publicar-web.ily"}.  Por
3953 supuesto, podríamos hacer esto aún más práctico.  Podríamos hacer un
3954 archivo @file{definiciones.ily} que contuviera solamente las
3955 definiciones de @code{mpdolce} y de @code{inst}, un archivo
3956 @file{publicar-web.ily} que contuviera solamente la sección
3957 @code{\layout} que se mostró en el ejemplo, y un archivo
3958 @file{universidad.ily} que contendría solamente los trucos para
3959 producir la salida que le gusta a mi profesor.  El comienzo de
3960 @file{musica.ly} tendría entonces este aspecto:
3961
3962 @example
3963 \include "definiciones.ily"
3964
3965 %%%  ¡Quitar el comentario de una sola de estas líneas!
3966 \include "publicar-web.ily"
3967 %\include "universidad.ily"
3968 @end example
3969
3970 Este enfoque puede ser útil incluso si va a producir sólo un conjunto
3971 de particellas.  Yo utilizo media docena de archivos de @q{hojas de
3972 estilo} para mis proyectos.  Comienzo todos los archivos de música con
3973 @code{\include "../global.ily"}, que contiene
3974
3975 @example
3976 %%%   global.ily
3977 \version @w{"@version{}"}
3978 #(ly:set-option 'point-and-click #f)
3979 \include "../iniciar/iniciar-definiciones.ily"
3980 \include "../iniciar/iniciar-disposicion.ily"
3981 \include "../iniciar/iniciar-cabeceras.ily"
3982 \include "../iniciar/iniciar-papel.ily"
3983 @end example
3984
3985
3986 @node Otras fuentes de información
3987 @subsection Otras fuentes de información
3988 @translationof Other sources of information
3989
3990 La documentación del manual de Referencia de Funcionamiento Interno
3991 contiene montañas de información sobre LilyPond, pero se puede obtener
3992 más información aún leyendo los archivos internos de LilyPond.  Para
3993 echarles un vistazo, en primer lugar debe buscar la carpeta
3994 correspondiente a su sistema.  La ubicación de esta carpeta depende
3995 (a) de si consiguió el programa LilyPond descargando un binario
3996 precompilado desde el sitio web lilypond.org o si lo instaló mediante
3997 un gestor de paquetes (es decir, distribuido con Linux, o instalado
3998 bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
3999 qué sistema operativo está utilizando:
4000
4001
4002 @strong{Descargado de lilypond.org}
4003
4004 @itemize @bullet
4005 @item Linux
4006
4007 Diríjase a
4008 @file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/share/lilypond/current/}
4009
4010 @item MacOS X
4011
4012 Diríjase a
4013 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/Resources/share/lilypond/current/}
4014 bien haciendo @code{cd} hacia este directorio desde el Terminal, o
4015 bien manteniendo pulsada la tecla de Control y haciendo click sobre la
4016 aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
4017 paquete}.
4018
4019 @item Windows
4020
4021 Mediante el Explorador de Windows, diríjase a
4022 @file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/share/lilypond/current/}
4023
4024 @end itemize
4025
4026 @strong{Instalado mediante un gestor de paquetes o compilado a partir de la fuente}
4027
4028 Diríjase a
4029 @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
4030 se encuentra determinado por su administrador de paquetes o guión
4031 @code{configure}, y @var{X.Y.Z} es el número de la versión de
4032 LilyPond.
4033
4034 @smallspace
4035
4036 Dentro de esta carpeta, las dos subcarpetas interesantes son
4037
4038 @itemize
4039 @item @file{ly/} - contiene archivos en formato LilyPond
4040 @item @file{scm/} - contiene archivos en formato Scheme
4041 @end itemize
4042
4043 Vamos a comenzar observando algunos archivos que están en @file{ly/}.
4044 Abra @file{ly/property-init.ly} con un editor de textos.  El mismo que
4045 usaría normalmente para los archivos @code{.ly} servirá perfectamente.
4046 Este archivo contiene las definiciones de todas las instrucciones
4047 estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} y
4048 @code{\slurDotted}.  Podrá ver que no son nada más que definiciones de
4049 variables que contienen una o varias instrucciones @code{\override}.
4050 Por ejemplo, @code{/tieDotted} está definido de tal forma que su valor
4051 es:
4052
4053 @example
4054 tieDotted = @{
4055   \override Tie #'dash-period = #0.75
4056   \override Tie #'dash-fraction = #0.1
4057 @}
4058 @end example
4059
4060 Si no le gustan los valores predeterminados, estas instrucciones
4061 predefinidas se pueden redefinir con facilidad como cualquier otra
4062 variable, al principio de su archivo de código de entrada.
4063
4064 Los siguientes son los archivos más útiles que se encuentran en
4065 @file{ly/}:
4066
4067 @multitable @columnfractions .4 .6
4068 @headitem Archivo
4069   @tab Contenido
4070 @item @file{ly/engraver-init.ly}
4071   @tab Definiciones de Contextos de grabadores
4072 @item @file{ly/paper-defaults-init.ly}
4073   @tab especificaciones de valores predeterminados relacionados con el papel
4074 @item @file{ly/performer-init.ly}
4075   @tab Definiciones de Contextos de interpretación
4076 @item @file{ly/property-init.ly}
4077   @tab Definiciones de todas las instrucciones predefinidas que son comunes
4078 @item @file{ly/spanner-init.ly}
4079   @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
4080 @end multitable
4081
4082 Otros ajustes (como las definiciones de las instrucciones de marcado)
4083 se almacenan como archivos @code{.scm} (de Scheme).  El lenguaje de
4084 programación Scheme se utiliza para proporcionar un interfaz
4085 programable en el funcionamiento interno de LilyPond.  Cualquier
4086 explicación adicional sobre estos archivos se encuentra por el momento
4087 fuera del ámbito de este manual, porque se requieren conocimientos del
4088 lenguaje Scheme.  Se advierte a los usuarios que se necesita una
4089 importante cantidad de conocimientos técnicos o de tiempo para
4090 comprender el lenguaje Scheme y estos archivos (véase @rextend{Tutorial de Scheme}).
4091
4092 Si ya tiene estos conocimientos, los archivos de Scheme que pueden
4093 interesarle son:
4094
4095 @multitable @columnfractions .4 .6
4096 @headitem Archivo
4097   @tab Contenido
4098 @item @file{scm/auto-beam.scm}
4099   @tab Valores predeterminados de sub-barrado
4100 @item @file{scm/define-grobs.scm}
4101   @tab valores predeterminados de las propiedades de grobs
4102 @item @file{scm/define-markup-commands.scm}
4103   @tab Especificar todas las instrucciones de marcado
4104 @item @file{scm/midi.scm}
4105   @tab Ajustes predeterminados para la salida MIDI
4106 @item @file{scm/output-lib.scm}
4107   @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
4108 @item @file{scm/parser-clef.scm}
4109   @tab Definiciones de las claves contempladas
4110 @item @file{scm/script.scm}
4111   @tab Ajustes predeterminados para las articulaciones
4112 @end multitable
4113
4114
4115
4116 @node Evitar los trucos con un proceso ralentizado
4117 @subsection Evitar los trucos con un proceso ralentizado
4118 @translationof Avoiding tweaks with slower processing
4119
4120 LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
4121 procesa los archivos.  Estas instrucciones consumen tiempo, pero el
4122 resultado puede necesitar menos trucos manuales para obtener un
4123 resultado aceptable.  Si una inscripción de texto o parte de la letra
4124 se sale de los márgenes, estas comprobaciones comprimirán dicha línea
4125 en la medida justa como para que encaje dentro de los márgenes.
4126
4127 Para que sean efectivos bajo cualquier circunstancia, estas
4128 comprobaciones deben habilitarse colocando las instrucciones de
4129 sobreescritura dentro del bloque @code{\with} dentro de un Score, y no
4130 en línea con la música, de la forma siguiente:
4131
4132
4133 @example
4134 \new Score \with @{
4135   %  asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
4136   \override PaperColumn #'keep-inside-line = ##t
4137   \override NonMusicalPaperColumn #'keep-inside-line = ##t
4138 @} @{
4139    ..
4140 @}
4141 @end example
4142
4143 Sin embargo, @code{keep-inside-line} es costoso en términos de
4144 computación y la recomendación es no activarlo, para permitir un
4145 procesado más rápido, hasta el momento de crear una versión
4146 definitiva.  De esta forma, no tiene que añadir instrucciones
4147 @code{\break} manualmente para evitar que el texto se salga por la
4148 parte derecha de la página.
4149
4150 @node Trucos avanzados con Scheme
4151 @subsection Trucos avanzados con Scheme
4152 @translationof Advanced tweaks with Scheme
4153
4154 Aunque es posible hacer muchas cosas con las instrucciones
4155 @code{\override} y @code{\tweak} , tenemos una forma incluso más
4156 poderosa de modificar el funcionamiento de LilyPond, a través de un
4157 interface programable hacia las operaciones internas de LilyPond.  Se
4158 puede incorporar código escrito en el lenguaje de programación Scheme,
4159 directamente en el mecanismo de funcionamiento de LilyPond.  Por
4160 supuesto, para hacer esto se necesitan al menos unos conocimientos
4161 básicos de programación en Scheme, y damos una introducción en el
4162 @rextend{Tutorial de Scheme}.
4163
4164 Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
4165 dar a una propiedad un valor constante, se puede establecer al
4166 resultado de un procedimiento de Scheme que se invoca cada vez que
4167 LilyPond accede a esta propiedad.  La propiedad se puede establecer
4168 dinámicamente a un valor determinado por el procedimiento en el
4169 momento en que se invoca.  En este ejemplo damos a las cabezas de las
4170 notas un color que depende de su posición dentro del pentagrama.
4171
4172 @cindex x11-color, función, ejemplo de utilización
4173 @cindex NoteHead, ejemplo de sobreescritura
4174 @cindex color, propiedad, establecer a procedimiento de Scheme
4175
4176 @lilypond[quote,verbatim,ragged-right]
4177 #(define (color-notehead grob)
4178   "Color the notehead according to its position on the staff."
4179   (let ((mod-position (modulo (ly:grob-property grob 'staff-position) 7)))
4180     (case mod-position
4181       ;;   Return rainbow colors
4182       ((1) (x11-color 'red    ))  ; for C
4183       ((2) (x11-color 'orange ))  ; for D
4184       ((3) (x11-color 'yellow ))  ; for E
4185       ((4) (x11-color 'green  ))  ; for F
4186       ((5) (x11-color 'blue   ))  ; for G
4187       ((6) (x11-color 'purple ))  ; for A
4188       ((0) (x11-color 'violet ))  ; for B
4189     )
4190   )
4191 )
4192
4193 \relative c' {
4194   % Arrange to obtain color from color-notehead procedure
4195   \override NoteHead #'color = #color-notehead
4196   a2 b
4197   c2 d
4198   e2 f
4199   g2 a
4200 }
4201 @end lilypond
4202
4203 Se pueden encontrar ejemplos adicionales que muestran la utilización
4204 de estos interfaces programables, en @rextendnamed{Callback
4205 functions,Funciones de callback}.