]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/es/user/changing-defaults.itely
Doc-es: Update after Removing Trailing Spaces In English Docs.
[lilypond.git] / Documentation / es / user / changing-defaults.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
3 @ignore
4 Translation of GIT committish: 0646758d26f727fc27fc13a87df2362388909e5d
5
6     When revising a translation, copy the HEAD committish of the
7     version that you are working on.  See TRANSLATION for details.
8 @end ignore
9
10 @c \version "2.11.61"
11
12 @node Changing defaults
13 @chapter Changing defaults
14
15 El objetivo del diseño de LilyPond es proporcionar la más alta calidad
16 de los resultados, de forma predeterminada.  A pesar de ello, podría
17 tener que cambiar este resultado predeterminado.  La disposición sobre
18 el papel se controla a través de un amplio número de @q{botones e
19 interruptores} llamados en su conjunto @q{propiedades}.  En el Manual
20 de aprendizaje podemos encontrar una introducción en forma de tutorial
21 al acceso y modificación de estas propiedades, véase
22 @rlearning{Tweaking output}.  Éste debería leerse en primer lugar.
23 Este capítulo cubre un terreno similar, pero con un estilo más
24 adecuado para un manual de referencia.
25
26 @cindex Referencia de funcionamiento interno
27
28 La descripción definitiva de los controles que están dipsonibles para
29 su ajuste fino están en un documento aparte: @rinternalsnamed{Top,la
30 Referencia de funcionamiento interno}.  Dicho manual relaciona todas
31 las variables, funciones y opciones que se encuentran disponibles en
32 LilyPond.  Está escrito como un documento HTML, que se puede encontrar
33 en
34 @c leave the @uref as one long line.
35 @uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,on@/-line},
36 pero que también va incluido en el paquete de la documentación de LilyPond.
37
38 Internamente, LilyPond utiliza el lenguaje Scheme (un dialecto de
39 LISP) para aportar la infraestructura.  La sobreescritura de las
40 decisiones de disposición da acceso efectivo a las interioridades del
41 programa, lo que requiere código de Scheme como entrada.  Los
42 elementos de Scheme se inauguran dentro de un archivo @code{.ly} con
43 el símbolo de cuadradillo @code{#}.@footnote{@rlearning{Scheme
44 tutorial} contiene un breve tutorial sobre la introducción de números,
45 listas, cadenas y símbolos en Scheme.}
46
47 @menu
48 * Interpretation contexts::
49 * Explaining the Internals Reference::
50 * Modifying properties::
51 * Useful concepts and properties::
52 * Advanced tweaks::
53 @end menu
54
55
56 @node Interpretation contexts
57 @section Interpretation contexts
58
59 Esta sección explica qué son los contextos y cómo modificarlos.
60
61 @menu
62 * Contexts explained::
63 * Creating contexts::
64 * Modifying context plug-ins::
65 * Changing context default settings::
66 * Defining new contexts::
67 * Aligning contexts::
68 @end menu
69
70 @seealso
71
72 Manual de aprendizaje:
73 @rlearning{Contexts and engravers}.
74
75 Archivos de inicio:
76 @file{ly/@/engraver@/-init@/.ly},
77 @file{ly/@/performer@/-init@/.ly}.
78
79 Fragmentos de código:
80 @rlsr{Contexts and engravers}.
81
82 Referencia de funcionamiento interno:
83 @rinternals{Contexts},
84 @rinternals{Engravers and Performers}.
85
86
87 @node Contexts explained
88 @subsection Contexts explained
89
90 Los contextos se disponen de forma jerárquica:
91
92 @menu
93 * Score - the master of all contexts::
94 * Top-level contexts - staff containers::
95 * Intermediate-level contexts - staves::
96 * Bottom-level contexts - voices::
97 @end menu
98
99 @node Score - the master of all contexts
100 @unnumberedsubsubsec Score - the master of all contexts
101
102 Este es el contexto de notación del nivel más alto.  Ningún otro
103 contexto puede contener a un contexto Score.  De forma predeterminada,
104 el contexto Score maneja la administración de las indicaciones de
105 compás y se asegura de que ciertos elementos como claves, compases y
106 armaduras están siempre alineados entre los distintos pentagramas.
107
108 Se crea implícitamente una instancia del contexto Score cuando se
109 procesa un bloque @code{\score @{@dots{}@}} o @code{\layout
110 @{@dots{}@}}, o explícitamente cuando se ejecuta una instrucción
111 @code{\new Score}.
112
113 @node Top-level contexts - staff containers
114 @unnumberedsubsubsec Top-level contexts - staff containers
115
116 @strong{@emph{StaffGroup}}
117
118 Agrupa pentagramas y añade un corchete en la parte izquierda, formando
119 un grupo.  Las líneas divisorias de los pentagramas contenidos se
120 conectan verticalmente.  StaffGroup sólo consiste en una colección de
121 pentagramas, con un corchete delante y líneas divisorias de arriba a
122 abajo.
123
124 @strong{@emph{ChoirStaff}}
125
126 Idéntico a StaffGroup excepto que las barras de compás de los
127 pentagramas contenidos no se conectan verticalmente.
128
129 @strong{@emph{GrandStaff}}
130
131 Un grupo de pentagramas, con una llave en la parte izquierda que
132 abarca el grupo.  Las barras de compás de los pentagramas contenidos
133 se conectan verticalmente.
134
135 @strong{@emph{PianoStaff}}
136
137 @c TODO No longer correct?  Check.  -td
138 Igual que GrandStaff pero con una distancia fija entre los
139 pentagramas, de manera que se pueden usar ligaduras y barras que
140 cruzan de un pentagrama a otro.
141
142 @ignore
143 @strong{@emph{InnerStaffGroup}}
144
145 TODO  -td
146
147 @strong{@emph{InnerChoirStaff}}
148
149 TODO  -td
150
151 @end ignore
152
153 @node Intermediate-level contexts - staves
154 @unnumberedsubsubsec Intermediate-level contexts - staves
155
156 @strong{@emph{Staff}}
157
158 Maneja claves, barras de compás, tonalidades y alteraciones
159 accidentales.  Puede contener contextos de Voice.
160
161 @strong{@emph{RhythmicStaff}}
162
163 Como Staff, pero para imprimir ritmos.  Se ignoran las alturas de las
164 notas; las notas se imprimen sobre una línea.
165
166 @strong{@emph{TabStaff}}
167
168 Contexto para generar tablaturas.  De forma predeterminada dispone la
169 expresión musical como una tablatura de guitarra, impresa sobre seis
170 líneas.
171
172 @strong{@emph{DrumStaff}}
173
174 Maneja el tipografiado para instrumentos de percusión.  Puede contener
175 contextos DrumVoice.
176
177 @strong{@emph{VaticanaStaff}}
178
179 Iguall que Staff, excepto que está pensado para tipografiar piezas en
180 estilo gregoriano.
181
182 @strong{@emph{MensuralStaff}}
183
184 Igual que Staff, excepto que está diseñado para tipografiar piezas en
185 estilo mensural.
186
187
188 @node Bottom-level contexts - voices
189 @unnumberedsubsubsec Bottom-level contexts - voices
190
191 Los contextos del mismo nivel que Voice dan un valor inicial a ciertas
192 propiedades e inician los grabadores correspondientes.  Siendo
193 contextos del nivel más bajo, no pueden contener a otros contextos.
194
195 @strong{@emph{Voice}}
196
197 Corresponde a una voz sobre un pentagrama. este contexto maneja la
198 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
199 superíndices, ligaduras de expresión y de unión, y silencios.  Tenemos
200 que crear instancias explícitas de este contexto si necesitamos varias
201 voces en el mismo pentagrama.
202
203 @strong{@emph{VaticanaVoice}}
204
205 Lo mismo que Voice, excepto que está diseñado para tipografiar piezas
206 en estilo gregoriano.
207
208 @strong{@emph{MensuralVoice}}
209
210 Lo mismmo que Voice, con modificaciones para el tipografiado de piezas
211 en estilo mensural.
212
213 @strong{@emph{Lyrics}}
214
215 Corresponde a una voz con letra.  Maneja la impresión de una sola
216 línea de letra.
217
218 @strong{@emph{DrumVoice}}
219
220 El contexto de voz utilizado en una pauta de percusión.
221
222 @strong{@emph{FiguredBass}}
223
224 El contexto en que los objetos BassFigure se crean a partir de la
225 entrada escrita en el modo @code{\figuremode}.
226
227 @strong{@emph{TabVoice}}
228
229 El contexto de voz utilizado dentro de un contexto TabStaff.  Se suele
230 dejar que se cree implícitamente.
231
232 @strong{@emph{ChordNames}}
233
234 Tipografía nombres de acordes.
235
236
237 @node Creating contexts
238 @subsection Creating contexts
239
240 Para partituras que sólo tienen una voz y un pentagrama, los contextos
241 se crean automáticamente.  Para partituras más complejas, es necesario
242 crearlos a mano.  Existen tres instrucciones que hacen esto.
243
244 @itemize
245
246 @item
247 La instrucción más fácil es @code{\new}, y es también la más rápida de
248 escribir.  Se antepone a una expresión musical, por ejemplo
249
250 @funindex \new
251 @cindex nuevos, contextos
252 @cindex Contexto, creación de
253
254 @example
255 \new @var{tipo} @var{expresión_musical}
256 @end example
257
258 @noindent
259 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
260 @code{Voice}).  Esta instrucción crea un contexto nuevo, y empieza a
261 interpretar la @var{expresión_musical} con él.
262
263 Una aplicación práctica de @code{\new} es una partitura con muchos pentagramas.
264 Cada parte que debe ir en su propio pentagrama, va precedida de
265 @code{\new Staff}.
266
267 @lilypond[quote,verbatim,relative=2,ragged-right,fragment]
268 <<
269   \new Staff { c4 c }
270   \new Staff { d4 d }
271 >>
272 @end lilypond
273
274 La instrucción @code{\new} puede también dar nombre al contexto,
275
276 @example
277 \new @var{tipo} = @var{identificador} @var{música}
278 @end example
279 Sin embargo, este nombre especificado por el usuario sólo se utiliza
280 si no hay ya otro contexto anterior con el mismo nombre.
281
282
283 @funindex \context
284
285 @item
286 Como @code{\new}, la instrucción @code{\context} también dirige una
287 expresión musical a un objeto de contexto, pero da al contexto un
288 nombre explícito.  La sintaxis es
289
290 @example
291 \context @var{tipo} = @var{identificador} @var{música}
292 @end example
293
294 En esta forma, la instrucción buscará un contexto existente del
295 @var{tipo} especificado que tenga el nombre @var{identificador}.  Si
296 ese contexto aún no existe, se crea un contexto nuevo con el nombre
297 especificado.  Esto es útil si nos vamos a referir más tarde al
298 contexto.  Por ejemplo, cuando se escribe la letra, la melodía está
299 dentro de un contexto con nombre
300
301 @example
302 \context Voice = "@b{tenor}" @var{música}
303 @end example
304
305 @noindent
306 de forma que los textos se puedan alienar correctamente con sus notas,
307
308 @example
309 \new Lyrics \lyricsto "@b{tenor}" @var{letra}
310 @end example
311
312 @noindent
313
314 Otro uso posible de los contextos con nombre es la fusión de dos
315 expresiones musicales distintas en un solo contexto.  En el siguiente
316 ejemplo, se introducen por separado las articulaciones y las notas,
317
318 @example
319 musica = @{ c4 c4 @}
320 decoracion = @{ s4-. s4-> @}
321 @end example
322
323 se combinan enviando los dos al mismo contexto @code{Voice},
324
325 @example
326 <<
327   \new Staff \context Voice = "A" \musica
328   \context Voice = "A" \decoracion
329 >>
330 @end example
331 @lilypond[quote,ragged-right]
332 music = { c4 c4 }
333 arts = { s4-. s4-> }
334 \relative c'' <<
335   \new Staff \context Voice = "A" \music
336   \context Voice = "A" \arts
337 >>
338 @end lilypond
339
340 Con este mecanismo, es posible definir un Urtext (una edición
341 original), con la posibilidad de poner articulaciones distintas sobre
342 las mismas notas.
343
344 @cindex crear contextos
345
346 @item
347 La tercera instrucción para crear contextos es
348 @example
349 \context @var{tipo} @var{música}
350 @end example
351
352
353 @noindent
354 Esto es similar a @code{\context} con @code{= @var{identificador}},
355 pero se corresponde con cualquier contexto del tipo @var{tipo}, sin
356 importar qué nombre se le ha dado.
357
358 Esta variante se usa con expresiones musicales que se pueden
359 interpretar en varios niveles.  Por ejemplo, la instrucción
360 @code{\applyOutput} (véase @ref{Running a function on all layout
361 objects}).  Sin una instrucción @code{\context} explícita, normalmente
362 se aplicaría a @code{Voice}
363
364 @example
365 \applyOutput #'@var{contexto} #@var{función}   % aplicar al contexto Voice
366 @end example
367
368 Para que se interprete dentro de los niveles de @code{Score} o
369 @code{Staff}, utilice las siguientes formas:
370
371 @example
372 \applyOutput #'Score #@var{función}
373 \applyOutput #'Staff #@var{función}
374 @end example
375
376 @end itemize
377
378
379 @node Modifying context plug-ins
380 @subsection Modifying context plug-ins
381
382 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
383 almacenan propiedades, también contienen «plug-ins» o complementos
384 llamados @q{grabadores} que crean elementos de notación.  Por ejemplo,
385 el contexto @code{Voice} contiene un grabador
386 @code{Note_head_engraver} que crea las cabezas de nota y el contexto
387 @code{Staff} contiene un grabador @code{Key_signature_engraver} que
388 crea la indicación de compás.
389
390 Para ver una descripción completa de todos y cada uno de los
391 complementos, consulte
392 @ifhtml
393 @rinternals{Engravers and Performers}.
394 @end ifhtml
395 @ifnothtml
396 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
397 @end ifnothtml
398 Cada contexto que se describe en
399 @ifhtml
400 @rinternals{Contexts}
401 @end ifhtml
402 @ifnothtml
403 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
404 @end ifnothtml
405 relaciona los grabadores que se usan para ese contexto.
406
407
408 Puede ser de utilidad jugar un poco con estos complementos.  Se hace
409 iniciando un contexto nuevo con @code{\new} o @code{\context} y
410 modificándolo:
411
412 @funindex \with
413
414 @example
415 \new @var{contexto} \with @{
416   \consists @dots{}
417   \consists @dots{}
418   \remove @dots{}
419   \remove @dots{}
420   @emph{etc.}
421 @}
422 @{
423   @emph{..música..}
424 @}
425 @end example
426
427 @noindent
428 donde los @dots{} debe ser el nombre de un grabador.  Aquí tenemos un
429 ejemplo sencillo que suprime los grabadores
430 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
431 @code{Staff}:
432
433 @lilypond[quote,relative=1,verbatim,fragment]
434 <<
435   \new Staff {
436     f2 g
437   }
438   \new Staff \with {
439      \remove "Time_signature_engraver"
440      \remove "Clef_engraver"
441   } {
442     f2 g2
443   }
444 >>
445 @end lilypond
446
447 En el segundo pentagrama no hay indicación de compás ni clave.  Éste
448 es un método bastante rudimentario de hacer que desaparezcan los
449 objetos porque afecta a todo el pentagrama.  Este método también
450 afecta al espaciado, lo que puede ser deseable o no serlo.  Se
451 muestran métodos más sofisticados para quitar objetos en
452 @rlearning{Visibility and color of objects}.
453
454 El ejemplo siguiente muestra una aplicación práctica.  Normalmente las
455 líneas divisorias y las indicaciones de compás están sincronizadas a
456 lo largo de toda la partitura.  Lo hacen los grabadores
457 @code{Timing_translator} y @code{Default_bar_line_engraver}.  Estos
458 complementos mantienen al día la administración de las indicaciones de
459 compás, posición dentro del compás, etc.  Moviendo estos grabadores
460 desde el contexto de @code{Score} al de @code{Staff}, podemos
461 conseguir una partitura en la que cada pentagrama tiene su propio
462 compás independiente.
463
464 @cindex polimétricas, partituras
465 @cindex compases distintos al mismo tiempo
466
467 @lilypond[quote,relative=1,ragged-right,verbatim,fragment]
468 \new Score \with {
469   \remove "Timing_translator"
470   \remove "Default_bar_line_engraver"
471 } <<
472   \new Staff \with {
473     \consists "Timing_translator"
474     \consists "Default_bar_line_engraver"
475   } {
476       \time 3/4
477       c4 c c c c c
478   }
479   \new Staff \with {
480     \consists "Timing_translator"
481     \consists "Default_bar_line_engraver"
482   } {
483        \time 2/4
484        c4 c c c c c
485   }
486 >>
487 @end lilypond
488
489
490 @node Changing context default settings
491 @subsection Changing context default settings
492
493 Los ajustes de contexto que están preparados para usarse de forma
494 predeterminada en los contextos @code{Score}, @code{Staff} y
495 @code{Voice}, se pueden especificar dentro de un bloque
496 @code{\layout}, como se ilustra en el ejemplo siguiente.  El bloque
497 @code{\layout} se debe colocar dentro del bloque @code{\score} en que
498 se quiere que haga efecto, pero fuera de la música.
499
500 Observe que la propia instrucción @code{\set} y el contexto se deben
501 omitir cuando se especifican de esta manera los valores de contexto
502 predeterminados:
503
504 @lilypond[quote,verbatim]
505 \score {
506   \relative c'' {
507     a4^"Really small, thicker stems, no time signature" a a a
508     a a a a
509   }
510   \layout {
511     \context {
512       \Staff
513       fontSize = #-4
514       \override Stem #'thickness = #4.0
515       \remove "Time_signature_engraver"
516     }
517   }
518 }
519 @end lilypond
520
521 En este ejemplo, la instrucción @code{\Staff} especifica que los
522 ajustes siguientes se apliquen a todos los pentagramas dentro del
523 bloque de partitura.
524
525 Se pueden realizar de forma similar modificaciones al contexto
526 @code{Score} o a todos los contextos @code{Voice}.
527
528 @knownissues
529
530 No es posible recolectar cambios de contexto dentro de una variable y
531 aplicarlos a una definición de @code{\context} por referencia a dicha
532 variable.
533
534 La instrucción @code{\RemoveEmptyStaffContext} sobreescribe nuestros
535 ajustes en curso para @code{\Staff}.  Si queremos cambiar los valores
536 predeterminados para un pentagrama que utilice
537 @code{\RemoveEmptyStaffContext}, debe hacerlo después de llamar a
538 @code{\RemoveEmptyStaffContext}, o sea
539
540 @example
541 \layout @{
542   \context @{
543     \RemoveEmptyStaffContext
544
545     \override Stem #'thickness = #4.0
546   @}
547 @}
548 @end example
549
550
551 @node Defining new contexts
552 @subsection Defining new contexts
553
554 Los contextos específicos, como @code{Staff} y @code{Voice}, están
555 construidos a base de bloques sencillos.  Es posible crear nuevos
556 tipos de contextos con combinaciones distintas de añadidos grabadores.
557
558 El siguiente ejemplo muestra cómo construir un tipo diferente de contexto de
559 @code{Voice} partiendo de cero.  Será parecido a
560 @code{Voice}, pero imprime solamente cabezas centradas en forma de barra inclinada.  Se puede usar
561 para indicar improvisación en piezas de jazz,
562
563 @c KEEP LY
564 @lilypond[quote,ragged-right]
565 \layout { \context {
566   \name ImproVoice
567   \type "Engraver_group"
568   \consists "Note_heads_engraver"
569   \consists "Text_engraver"
570   \consists Pitch_squash_engraver
571   squashedPosition = #0
572   \override NoteHead #'style = #'slash
573   \override Stem #'transparent = ##t
574   \alias Voice
575 }
576 \context { \Staff
577   \accepts "ImproVoice"
578 }}
579
580 \relative c'' {
581   a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
582    c4 c^"desvístete" c_"mientras juegas :)" c }
583   a1
584 }
585 @end lilypond
586
587
588 Estos ajustes se definen dentro de un bloque @code{\context} que a su
589 vez está dentro de un bloque @code{\layout},
590
591 @example
592 \layout @{
593   \context @{
594     @dots{}
595   @}
596 @}
597 @end example
598
599 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
600 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
601
602 En primer lugar es necesario definir un nombre para el nuevo contexto:
603
604 @example
605 \name ImproVoice
606 @end example
607
608 Debido a que es parecido al contexto @code{Voice}, queremos órdenes
609 que funcionen sobre contextos de @code{Voice} (existentes) para que
610 siga funcionando.  Esto se consigue dando al contexto nuevo un alias
611 @code{Voice},
612
613 @example
614 \alias Voice
615 @end example
616
617 El contexto imprimirá notas y textos explicativos, por ello tenemos
618 que añadir los grabadores que aportan esta funcionalidad,
619
620 @example
621 \consists Note_heads_engraver
622 \consists Text_engraver
623 @end example
624
625 Pero sólo necesitamos esto en la línea central,
626
627 @example
628 \consists Pitch_squash_engraver
629 squashedPosition = #0
630 @end example
631
632 El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
633 nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
634 establece sus posiciones verticales al valor de
635 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.
636
637 Las notas parecen barras inclinadas y no tienen plica,
638
639 @example
640 \override NoteHead #'style = #'slash
641 \override Stem #'transparent = ##t
642 @end example
643
644 Todos estos añadidos tienen que cooperar, y esto se consigue con un
645 añadido especial, que se debe marcar con la palabra clave
646 @code{\type}.  Este será siempre @code{Engraver_group},
647
648 @example
649 \type "Engraver_group"
650 @end example
651
652 Al juntarlo todo, obtenemos
653
654 @example
655 \context @{
656   \name ImproVoice
657   \type "Engraver_group"
658   \consists "Note_heads_engraver"
659   \consists "Text_engraver"
660   \consists Pitch_squash_engraver
661   squashedPosition = #0
662   \override NoteHead #'style = #'slash
663   \override Stem #'transparent = ##t
664   \alias Voice
665 @}
666 @end example
667
668 @funindex \accepts
669 Los contextos dan lugar a jerarquías.  Queremos colgar el contexto
670 @code{ImproVoice} bajo el contexto @code{Staff}, como simples
671 @code{Voice}s normales.  Por tanto, modificamos la definición de
672 @code{Staff} con la instrucción @code{\accepts} (acepta),
673
674 @example
675 \context @{
676   \Staff
677   \accepts ImproVoice
678 @}
679 @end example
680
681 @funindex \denies
682 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
683 que a veces se necesita cuando se están reutilizando definiciones de
684 contexto existentes.
685
686 Ponemos ambos dentro de un bloque @code{\layout}, como
687
688 @example
689 \layout @{
690   \context @{
691     \name ImproVoice
692     @dots{}
693   @}
694   \context @{
695     \Staff
696     \accepts "ImproVoice"
697   @}
698 @}
699 @end example
700
701 Así pues, la salida que aparece al comienzo de esta sub-sección se
702 puede escribir como
703
704 @example
705 \relative c'' @{
706   a4 d8 bes8
707   \new ImproVoice @{
708     c4^"ad lib" c
709     c4 c^"undress"
710     c c_"while playing :)"
711   @}
712   a1
713 @}
714 @end example
715
716
717 @node Aligning contexts
718 @subsection Aligning contexts
719
720 Los contextos nuevos se pueden alinear por encima o por debajo de
721 otros contextos existentes.  Esto podría ser de utilidad al preparar
722 un pentagrama vocal (@rlearning{Vocal ensembles}) y un ossia,
723
724 @cindex ossia
725 @findex alignAboveContext
726 @findex alignBelowContext
727
728 @lilypond[quote,ragged-right]
729 ossia = { f4 f f f }
730 \score{
731   \relative c' \new Staff = "main" {
732     c4 c c c
733     <<
734       \new Staff \with {alignAboveContext=main} \ossia
735       { d8 f d f d f d f }
736     >>
737   }
738 }
739 @end lilypond
740
741 @cindex nested contexts
742 @cindex contexts, nested
743
744 @funindex \accepts
745 @funindex \denies
746
747 Los contextos como @code{PianoStaff} pueden llevar dentro otros
748 contextos anidados.  Los contextos que se pueden aceptar para su
749 anidamiento están definidos por la lista @qq{accepts} (acepta) de un
750 contexto.  Los contextos que no están en esta lista se colocan debajo
751 del contexto exterior en la partitura impresa.  Por ejemplo, el
752 contexto @code{PianoStaff} está definido para que acepte contextos
753 @code{Staff} y @code{FiguredBass} de forma predeterminada, pero no un
754 contexto @code{Lyrics}, por ejemplo.  Así pues, en la siguiente
755 estructura la letra se sitúa debajo del sistema de piano en lugar de
756 colocarse entre los dos pentagramas:
757
758 @lilypond[verbatim,quote,relative=1]
759 \new PianoStaff
760 <<
761   \new Staff { e4 d c2 }
762   \addlyrics { Three blind mice }
763   \new Staff {
764     \clef "bass"
765     { c,1 }
766   }
767 >>
768 @end lilypond
769
770 La lista @qq{accepts} de un contexto se puede modificar para que
771 incluya contextos anidados adicionales, y así si quisiéramos que la
772 letra apareciese entre los dos pentagramas podríamos usar:
773
774 @lilypond[verbatim,quote,relative=1]
775 \new PianoStaff \with { \accepts Lyrics }
776 <<
777   \new Staff { e4 d c2 }
778   \addlyrics { Three blind mice }
779   \new Staff {
780     \clef "bass"
781     { c,1 }
782   }
783 >>
784 @end lilypond
785
786 Lo contrario de @code{\accepts} (acepta) es @code{\denies} (deniega);
787 esto suprime un contexto de la lista @qq{accepts}.
788
789
790 @node Explaining the Internals Reference
791 @section Explaining the Internals Reference
792
793
794 @menu
795 * Navigating the program reference::
796 * Layout interfaces::
797 * Determining the grob property::
798 * Naming conventions::
799 @end menu
800
801
802
803 @node Navigating the program reference
804 @subsection Navigating the program reference
805
806 Supongamos que queremos mover la indicación de digitación del
807 fragmento siguiente:
808
809 @lilypond[quote,fragment,relative=2,verbatim]
810 c-2
811 \stemUp
812 f
813 @end lilypond
814
815 Si hace una visita a la documentación en busca de instrucciones de
816 digitación (en @ref{Fingering instructions}), encontrará:
817
818 @quotation
819 @strong{Véase también}
820
821 Referencia de funcionamiento interno: @rinternals{Fingering}.
822
823 @end quotation
824
825 @ifnothtml
826 La referencia del programador se encuentra disponible en forma de
827 documento HTML.  Se recomienda mucho que lo lea en la forma HTML, bien
828 en línea o bien descargando los archivos de la documentación HTML.
829 Esta sección sería mucho más difícil de entender si está utilizando el
830 manual en formato PDF.
831 @end ifnothtml
832
833 Siga el enlace que lleva a @rinternals{Fingering}.  Al principio de la
834 página, puede ver
835
836 @quotation
837 Los objetos de digitación se crean por parte de:
838 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
839 @end quotation
840
841 Siguiendo los enlaces relacionados dentro de la referencia del
842 programa, podemos seguir el flujo de información dentro del programa:
843
844 @itemize
845
846 @item @rinternals{Fingering}:
847 los objetos @rinternals{Fingering} se crean por parte de:
848 @rinternals{Fingering_engraver}
849
850 @item @rinternals{Fingering_engraver}:
851 Tipos de música aceptados: @rinternals{fingering-event}
852
853 @item @rinternals{fingering-event}:
854 El tipo de evento musical @code{fingering-event} está descrito en
855 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
856 @end itemize
857
858 Este camino se recorre en contra de la corriente de información del
859 programa: comienza por la salida y acaba en el evento de entrada.
860 También podríamos haber empezado por un evento de la entrada, y leído
861 siguiendo el flujo de información terminando en su caso en el objeto
862 (u objetos) de la salida.
863
864 La referencia del programa también se puede examinar como un documento
865 normal.  Contiene capítulos que tratan de
866 @ifhtml
867 @rinternals{Music definitions},
868 @end ifhtml
869 @ifnothtml
870 @code{Music definitions}
871 @end ifnothtml
872 de la @rinternals{Translation}, y del @rinternals{Backend}.  Cada uno
873 de los capítulos relaciona todas las definiciones utilizadas y todas
874 las propiedades que se pueden ajustar.
875
876
877 @node Layout interfaces
878 @subsection Layout interfaces
879
880 @cindex interfaz de la presentación
881 @cindex presentación, interfaz de la
882 @cindex grob
883
884 La página HTML que pudimos ver en la sección anterior describe el
885 objeto de presentación llamado @rinternals{Fingering}.  Dicho objeto
886 es un símbolo dentro de la partitura.  Tiene propiedades que guardan
887 números (como grosores y direcciones), pero también punteros a objetos
888 relacionados.  Un objeto de presentación también se llama un
889 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
890 gráfico).  Para ver más detalles acerca de los objetos gráficos o
891 Grobs, consulte @rinternals{grob-interface}.
892
893 La página dedicada a @code{Fingering} relaciona las definiciones del
894 objeto @code{Fingering}.  Por ejemplo, la página dice
895
896 @quotation
897 @code{relleno} (dimensión, en espacios de pentagrama):
898
899 @code{0.5}
900 @end quotation
901
902 @noindent
903 lo que significa que el número se mantendrá a una distancia de al
904 menos 0.5 de la cabeza de la nota.
905
906
907 Cada objeto de presentación puede tener varias funciones como elemento
908 notacional o tipográfico.  Por ejemplo, el objeto de digitación
909 Fingering tiene los siguientes aspectos
910
911 @itemize
912 @item
913 Su tamaño es independiente del espaciado horizontal, al contrario de
914 las ligaduras o las barras de las figuras.
915
916 @item
917 Es un elemento de texto.  Casi seguro que es un texto muy corto.
918
919 @item
920 este elemento de texto se tipografía con un tipo de letra, no como las
921 ligaduras o las barras de las figuras.
922
923 @item
924 Horizontalmente, el centro del símbolo se debe alinear con el centro
925 de la cabeza de la nota.
926
927 @item
928 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
929
930 @item
931 La posición vertical también está coordinada con otros símbolos de
932 superíndice y de subíndice.
933 @end itemize
934
935 Cada uno de estos aspectos se capta en lo que se llaman
936 @emph{interface}s, que se relacionan al final de la página dedicada a
937 @rinternals{Fingering}
938
939 @quotation
940 Este objeto contempla los siguientes interfaces:
941 @rinternals{item-interface},
942 @rinternals{self-alignment-interface},
943 @rinternals{side-position-interface}, @rinternals{text-interface},
944 @rinternals{text-script-interface}, @rinternals{font-interface},
945 @rinternals{finger-interface} y @rinternals{grob-interface}.
946 @end quotation
947
948 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
949 página del respectivo interfaz del objeto.  Cada interfaz tiene un
950 cierto número de propiedades.  Algunas de ellas no son para que el
951 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
952 pueden modificar.
953
954 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
955 realmente esto no significa mucho.  El archivo de inicialización
956 (véase @ref{File structure}) @file{scm/@/define@/-grobs@/.scm} muestra
957 el alma del @q{objeto},
958
959 @example
960 (Fingering
961   . ((padding . 0.5)
962      (avoid-slur . around)
963      (slur-padding . 0.2)
964      (staff-padding . 0.5)
965      (self-alignment-X . 0)
966      (self-alignment-Y . 0)
967      (script-priority . 100)
968      (stencil . ,ly:text-interface::print)
969      (direction . ,ly:script-interface::calc-direction)
970      (font-encoding . fetaNumber)
971      (font-size . -5)           ; don't overlap when next to heads.
972      (meta . ((class . Item)
973      (interfaces . (finger-interface
974                     font-interface
975                     text-script-interface
976                     text-interface
977                     side-position-interface
978                     self-alignment-interface
979                     item-interface))))))
980 @end example
981
982 @noindent
983 Como podemos ver, el objeto @code{Fingering} no es más que un montón
984 de valores de variables, y la página web de la Referencia de
985 funcionamiento interno se genera directamente a partir de esta
986 definición.
987
988
989 @node Determining the grob property
990 @subsection Determining the grob property
991
992 Recordemos que queríamos cambiar la posición del @b{2} en
993
994 @lilypond[quote,fragment,relative=2,verbatim]
995 c-2
996 \stemUp
997 f
998 @end lilypond
999
1000 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1001 tenemos que negociar con el interfaz asociado con esta colocación.
1002 Esto se hace usando @code{side-position-interface}.  La página que
1003 describe este interface dice:
1004
1005 @quotation
1006 @code{side-position-interface}
1007
1008 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1009 soporte).  La propiedad @code{direction} significa dónde poner el
1010 objeto víctima con relación al soporte (¿a la izquierda o a la
1011 derecha, encima o debajo?)
1012 @end quotation
1013
1014 @cindex relleno
1015 @noindent
1016 Debajo de esta descripción, la variable @code{padding} (relleno) se describe como
1017
1018 @quotation
1019 @table @code
1020 @item padding
1021 (dimensión, en espacios de pentagrama)
1022
1023 Añadir esta cantidad de espacio adicional entre objetos que están unos
1024 junto a otros.
1025 @end table
1026 @end quotation
1027
1028 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1029 digitación de la cabeza de la nota.  La siguiente orden inserta un
1030 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1031 digitación:
1032 @example
1033 \once \override Voice.Fingering #'padding = #3
1034 @end example
1035
1036 Al insertar esta instrucción antes de que se haya creado el objeto
1037 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1038 resultado:
1039
1040 @lilypond[quote,relative=2,fragment,verbatim]
1041 \once \override Voice.Fingering #'padding = #3
1042 c-2
1043 \stemUp
1044 f
1045 @end lilypond
1046
1047 En este caso, el contexto de este truco es @code{Voice}.  Este hecho
1048 se puede deducir también a partir de la referencia del programa, ya
1049 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1050
1051 @quotation
1052 El grabador Fingering_engraver es parte de los contextos: @dots{}
1053 @rinternals{Voice}
1054 @end quotation
1055
1056
1057
1058 @node Naming conventions
1059 @subsection Naming conventions
1060
1061 @ignore
1062 Another thing that is needed, is an overview of the various naming
1063 conventions:
1064
1065     scheme functions: lowercase-with-hyphens (incl. one-word
1066 names)
1067     scheme functions: ly:plus-scheme-style
1068     music events, music classes and music properties:
1069 as-scheme-functions
1070     Grob interfaces: scheme-style
1071     backend properties: scheme-style (but X and Y!)
1072     contexts (and MusicExpressions and grobs): Capitalized or
1073 CamelCase
1074     context properties: lowercaseFollowedByCamelCase
1075     engravers:
1076 Capitalized_followed_by_lowercase_and_with_underscores
1077
1078 Which of these are conventions and which are rules?
1079 Which are rules of the underlying language, and which are
1080 LP-specific?
1081 @end ignore
1082
1083 @node Modifying properties
1084 @section Modifying properties
1085
1086 @menu
1087 * Overview of modifying properties::
1088 * The set command::
1089 * The override command::
1090 * The tweak command::
1091 * set versus override::
1092 @end menu
1093
1094
1095 @node Overview of modifying properties
1096 @subsection Overview of modifying properties
1097
1098 Cada contexto es responsable de la creación de ciertos tipos de
1099 objetos gráficos.  Los ajustes que se usan para imprimir estos objetos
1100 también se almacenan por contexto.  Mediante la modificación de estos
1101 ajustes, se puede alterar la apariencia de los objetos.
1102
1103 La sintaxis de esto es
1104
1105 @example
1106 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1107 @end example
1108
1109 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1110 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1111 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1112 disposición}).  Este último es un símbolo, y por ello debe ir
1113 precedido de un apóstrofo.  La subsección @ref{Modifying properties}
1114 explica cómo se deben cumplimentar los conceptos @var{nombre},
1115 @var{propiedad} y @var{valor}.  Aquí sólo nos ocuparemos de la
1116 funcionalidad des esta instrucción.
1117
1118 La instrucción
1119
1120 @verbatim
1121 \override Staff.Stem #'thickness = #4.0
1122 @end verbatim
1123
1124 @noindent
1125 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1126 grosor de una línea del pentagrama como unidad).  Puesto que la
1127 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1128 pentagrama actual.  Otros pentagramas mantienen su aspecto normal.
1129 Aquí vemos la instrucción en pleno funcionamiento:
1130
1131 @lilypond[quote,verbatim,relative=2,fragment]
1132 c4
1133 \override Staff.Stem #'thickness = #4.0
1134 c4
1135 c4
1136 c4
1137 @end lilypond
1138
1139 La instrucción @code{\override} modifica la definición de la plica
1140 @code{Stem} dentro del pentagrama en curso @code{Staff}.  Después de
1141 que la instrucción se ha interpretado, todas las plicas se engrosan.
1142
1143 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1144 omitir, ocasionando que se utilice el contexto predeterminado
1145 @code{Voice}.  Al añadir @code{\once} se aplica el cambio durante un
1146 solo paso de tiempo.
1147
1148 @lilypond[quote,fragment,verbatim,relative=2]
1149 c4
1150 \once \override Stem #'thickness = #4.0
1151 c4
1152 c4
1153 @end lilypond
1154
1155 El @code{\override} se debe hacer antes de que el objeto se inicia.
1156 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1157 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1158 en el momento en que se crea el objeto.  En este ejemplo:
1159
1160 @lilypond[quote,fragment,verbatim,relative=2]
1161 \override Slur #'thickness = #3.0
1162 c8[( c
1163 \override Beam #'thickness = #0.6
1164 c8 c])
1165 @end lilypond
1166
1167 @noindent
1168 la ligadura es más gruesa pero la barra no lo es.  Esto es así porque
1169 la instrucción para @code{Beam}, la barra, va después de que la barra
1170 se ha iniciado, y por ello no tiene ningún efecto.
1171
1172 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1173 un contexto deshace una instrucción @code{\override}; como con
1174 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1175 del mismo contexto.  En otras palabras, el @code{\revert} del
1176 siguiente ejemplo no hace nada.
1177
1178 @example
1179 \override Voice.Stem #'thickness = #4.0
1180 \revert Staff.Stem #'thickness
1181 @end example
1182
1183 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1184 dentro de las propiedades normales.  Para trucarlas, utilice
1185 instrucciones de la forma
1186
1187 @c leave this as a long long
1188 @example
1189 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1190 @end example
1191
1192 @noindent
1193 tales como
1194
1195 @example
1196 \override Stem #'details #'beamed-lengths = #'(4 4 3)
1197 @end example
1198
1199
1200 @seealso
1201
1202 Referencia de funcionamiento interno:
1203 @rinternals{OverrideProperty},
1204 @rinternals{RevertProperty},
1205 @rinternals{PropertySet},
1206 @rinternals{Backend},
1207 @rinternals{All layout objects}.
1208
1209
1210 @knownissues
1211
1212 El «back-end» o motor de salida no es muy estricto en la comprobación
1213 de tipos de las propiedades de objetos.  Las referencias cíclicas en
1214 valores Scheme de propiedades pueden producir cuelgues o salidas
1215 abruptas, o las dos cosas.
1216
1217
1218 @node The set command
1219 @subsection The @code{\set} command
1220
1221 @cindex propiedades
1222 @funindex \set
1223 @cindex cambiar propiedades
1224
1225 Cada contexto puede tener distintas @emph{propiedades}, variables
1226 contenidas dentro de ese contexto.  Se pueden cambiar mientras dura el
1227 paso de interpretación.  Se consigue insertando la instrucción
1228 @code{\set} dentro de la música:
1229
1230 @example
1231 \set @var{contexto}.@var{propiedad} = #@var{valor}
1232 @end example
1233
1234 Por ejemplo:
1235 @lilypond[quote,verbatim,relative=2,fragment]
1236 R1*2
1237 \set Score.skipBars = ##t
1238 R1*2
1239 @end lilypond
1240
1241 Estas instrucción salta los compases que no tienen notas.  El
1242 resultado es que los silencios multicompás se condensan.  El valor
1243 asignado es un objeto de Scheme.  En este caso, es @code{#t}, el valor
1244 booleano True o verdadero.
1245
1246 Si se omite el argumento @var{context}, entonces se utiliza el
1247 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1248 @code{Voice} o @code{Lyrics}). En este ejemplo:
1249
1250 @lilypond[quote,verbatim,relative=2,fragment]
1251 c8 c c c
1252 \set autoBeaming = ##f
1253 c8 c c c
1254 @end lilypond
1255
1256 @noindent
1257 el argumento @var{contexto} de la instrucción @code{\set} se omite,
1258 así pues el barrado automático se desactiva en la voz actual.  Observe
1259 que el contexto de nivel más bajo no siempre contiene la propiedad que
1260 queremos cambiar (por ejemplo, no tendrá ningún efecto intentar
1261 establecer un valor para la propiedad @code{skipBars} del contexto de
1262 nivel más bajo, en este caso @code{Voice}).
1263
1264 @lilypond[quote,verbatim,relative=2,fragment]
1265 R1*2
1266 \set skipBars = ##t
1267 R1*2
1268 @end lilypond
1269
1270 Los contextos son jerárquicos, y si se ha especificado un contexto
1271 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1272 también a todos los contextos @code{Voice} dentro del pentagrama
1273 actual.  El cambio se aplica @q{al vuelo}, durante la música, de
1274 manera que el ajuste sólo afecta al segundo grupo de corcheas.
1275
1276 @funindex \unset
1277
1278 También existe una instrucción @code{\unset}:
1279 @example
1280 \unset @var{contexto}.@var{propiedad}
1281 @end example
1282
1283 @noindent
1284 que elimina la definición de @var{propiedad}.  Esta instrucción
1285 elimina la definición solamente si está establecida dentro de
1286 @var{contexto}, de manera que
1287
1288 @example
1289 \set Staff.autoBeaming = ##f
1290 @end example
1291
1292 @noindent
1293 introduce un ajuste de la propiedad en el nivel de @code{Staff}.  El
1294 ajuste también se aplica a la @code{Voice} actual.  Sin embargo:
1295
1296 @example
1297 \unset Voice.autoBeaming
1298 @end example
1299
1300 @noindent
1301 no tiene ningúun efecto.  Para cancelar este ajuste, se debe
1302 especificar el @code{\unset} en el mismo nivel que el @code{\set}
1303 original.  Dicho de otra forma, para deshacer el efecto de
1304 @code{Staff.autoBeaming = ##f} se necesita
1305 @example
1306 \unset Staff.autoBeaming
1307 @end example
1308
1309 Como @code{\set}, el argumento @var{contexto} no se tiene que
1310 especificar para un contexto del nivel más bajo, por lo que los dos
1311 enunciados
1312
1313 @example
1314 \set Voice.autoBeaming = ##t
1315 \set autoBeaming = ##t
1316 @end example
1317
1318 @noindent
1319 son equivalentes.
1320
1321
1322 @cindex \once
1323 Los ajustes que se aplican solamente a un único paso de tiempo se
1324 pueden escribir con @code{\once}, por ejemplo en
1325
1326 @lilypond[quote,verbatim,relative=2,fragment]
1327 c4
1328 \once \set fontSize = #4.7
1329 c4
1330 c4
1331 @end lilypond
1332
1333 la propiedad @code{fontSize} se deshace automáticamente después de la
1334 segunda nota.
1335
1336 En el manual de Referencia de funcionamiento interno hay una
1337 descripción completa de todas las propiedades de contexto disponibles,
1338 consulte
1339 @ifhtml
1340 @rinternals{Tunable context properties}.
1341 @end ifhtml
1342 @ifnothtml
1343 Traducción @expansion{} Propiedades de contexto modificables por el
1344 usuario.
1345 @end ifnothtml
1346
1347
1348
1349 @node The override command
1350 @subsection The @code{\override} command
1351
1352 Las instrucciones que modifican la salida tienen por lo general un
1353 aspecto como
1354
1355 @example
1356 \override Voice.Stem #'thickness = #3.0
1357 @end example
1358
1359 @noindent
1360 Para construir este truco debemos determinar los siguientes datos:
1361
1362 @itemize
1363 @item el contexto: aquí @code{Voice}.
1364 @item el objeto de presentación: aquí @code{Stem}.
1365 @item la propiedad de presentación: aquí @code{thickness}.
1366 @item un valor adecuado: aquí @code{3.0}.
1367 @end itemize
1368
1369 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
1370 en el interior de las propiedades normales.  Para modificarlas utilice
1371 instrucciones de la forma
1372
1373 @example
1374 \override Stem #'details #'beamed-lengths = #'(4 4 3)
1375 @end example
1376
1377 @cindex documentación interna
1378 @cindex buscar objetos gráficos
1379 @cindex gráficos, descripción de los objetos
1380 @cindex trucos
1381 @funindex \override
1382 @cindex interna, documentación
1383
1384 Para muchas propiedades, independientemente del tipo de datos de la
1385 propiedad, si se establece el valor de la propiedad a falso
1386 (@code{##f}) se producirá su desactivación, ocasionando que LilyPond
1387 ignore por completo dicha propiedad.  Esto es especialmente útil para
1388 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
1389 causarína problemas.
1390
1391 Mostraremos a continuación cómo localizar esta información en el
1392 manual de notación y en la referencia de funcionamiento interno.
1393
1394
1395 @node The tweak command
1396 @subsection The @code{\tweak} command
1397
1398 @funindex \tweak
1399 @cindex trucar
1400
1401 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
1402 los objetos gráficos.  Para objetos que reusultan directamente de un
1403 elemento de código de la entrada, puede usar la función @code{\tweak},
1404 por ejemplo
1405
1406 @lilypond[relative=2,verbatim]
1407 < c
1408   \tweak #'color #red
1409   d
1410   g
1411   \tweak #'duration-log #1
1412   a
1413 > 4
1414 -\tweak #'padding #8
1415 -^
1416 @end lilypond
1417
1418 @cindex chord, modifying one note in
1419
1420 Pero el uso principal de la instrucción @code{\tweak} es modificar
1421 solamente uno de varios elementos de notación que dan comienzo en el
1422 mismo momento musical, como las notas de un acorde, o corchetes de
1423 tresillo que empiezan al mismo tiempo.
1424
1425 Para ver una introducción a la sintaxis y los usos de la instrucción
1426 tweak, consulte @rlearning{Tweaking methods}.
1427
1428 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
1429 a continuación de forma directa, sin necesidad de especificar el
1430 nombre del grob o el contexto.  Para que esto funcione, es necesario
1431 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
1432 al objeto al que se aplica, después de que el archivo de entrada se ha
1433 convertido en un flujo musical.  Con frecuencia no es el caso, pues
1434 muchos elementos adicionales se insertan en la corriente musical de
1435 forma implícita.  Por ejemplo, cuando se procesa una nota que no forma
1436 parte de un acorde, LilyPond inserta implícitamente un evento
1437 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
1438 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
1439 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
1440 en el flujo musical, permaneciendo así adyacente a la nota, y con la
1441 posibilidad de modificarla.
1442
1443 Así, esto funciona:
1444
1445 @lilypond[relative=2,verbatim,quote]
1446 <\tweak #'color #red c>4
1447 @end lilypond
1448
1449 @noindent
1450 pero esto no funciona:
1451
1452 @lilypond[relative=2,verbatim,quote]
1453 \tweak #'color #red c4
1454 @end lilypond
1455
1456 Si se colocan varios elementos similares en el mismo momento musical,
1457 la instrucción @code{\override} no se puede usar para modificar uno
1458 solo de ellos: aquí es donde se debe usar la instrucción
1459 @code{\tweak}.  Entre los elementos que pueden aparecer más de una vez
1460 en el mismo momento musical están los siguientes:
1461
1462 @c TODO expand to include any further uses of \tweak
1463 @itemize
1464 @item las cabezas de las notas de un acorde
1465 @item signos de articulación sobre la misma nota
1466 @item ligaduras de unión entre notas de un acorde
1467 @item corchetes de grupos especials que comienzan en el mismo momento
1468 @end itemize
1469
1470 @c TODO add examples of these
1471
1472 @noindent
1473 y se puede usar @code{\tweak} para modificar cualquier aparición
1474 específica de estos elementos.
1475
1476 Es de resaltar que la instrucción @code{\tweak} no se puede usar para
1477 modificar plicas, barras o alteraciones accidentales, porque éstos se
1478 generan más tarde por parte de las cabezas de nota, en vez de por
1479 elementos musicales que están en el flujo de entrada.  Ni se puede
1480 usar una instrucción @code{\tweak} para modificar claves o
1481 indicaciones de compás, ya que éstos están separados de cualquier
1482 instrucción @code{\tweak} precedente en el flujo de entrada a causa de
1483 la inserción automática de elementos adicionales necesarios para
1484 especificar el contexto.
1485
1486 Pero la instrucción @code{\tweak} se puede usar como alternativa a la
1487 instrucción @code{\override} para modificar estos elementos
1488 notacionales que no producen la adición de ningún elemento notacional
1489 implícito antes de ellos mismos en el flujo musical.  Por ejemplo, las
1490 ligaduras de expresión se pueden modificar de esta forma:
1491
1492 @lilypond[verbatim,quote,relative=1]
1493 c-\tweak #'thickness #5 ( d e f)
1494 @end lilypond
1495
1496 También se pueden escribir varias instrucciones @code{\tweak} antes de
1497 un elemento notacional, y todas ellas le afectan:
1498
1499 @lilypond[verbatim,quote,relative=1]
1500 c
1501 -\tweak #'style #'dashed-line
1502 -\tweak #'dash-fraction #0.2
1503 -\tweak #'thickness #3
1504 -\tweak #'color #red
1505  \glissando
1506 f'
1507 @end lilypond
1508
1509 El flujo musical que se genera a partir de una sección de un archivo
1510 de entrada, incluido cualquier elemento insertado automáticamente,
1511 puede examinarse, véase @ref{Displaying music expressions}.  Esto
1512 puede ser de utilidad en la determinación de lo que puede modificarse
1513 por medio de una instrucción @code{\tweak}.
1514
1515 @seealso
1516
1517 Manual de aprendizaje:
1518 @rlearning{Tweaking methods}.
1519
1520 Referencia de la notación:
1521 @ref{Displaying music expressions}.
1522
1523 @knownissues
1524
1525 @cindex trucos en una variable
1526 La instrucción @code{\tweak} no se puede usar dentro de una variable.
1527
1528 @cindex trucos en la letra
1529 Las instrucciones @code{\tweak} no se pueden usar dentro del modo @code{\lyricmode}.
1530
1531 @cindex trucar puntos de control
1532 @cindex control, trucar puntos de
1533
1534 La instrucción @code{\tweak} no se puede usar para modificar los
1535 puntos de control de una única ligadura entre varias dentro de un
1536 acorde, aparte de la primera que aparece en el archivo de entrada.
1537
1538 @node set versus override
1539 @subsection @code{\set} vs. @code{\override}
1540
1541 Hemos visto dos formas de cambiar las propiedades: @code{\set} y
1542 @code{\override}.  De hecho, en realidad existen dos clases diferentes
1543 de propiedades.
1544
1545 Los contextos pueden tener propiedades, que por lo general reciben
1546 nombres en @code{mayúsculasDeCamello}.  Principalmente controlan la
1547 traducción de la música a la notación, p.ej. @code{localKeySignature}
1548 (para determinar si hay que imprimir las alteraciones accidentales),
1549 @code{measurePosition} (para determinar cuándo imprimir una línea
1550 divisoria).  Las propiedades de contexto pueden ver modificado su
1551 valor con el tiempo según se interpreta una pieza de música;
1552 @code{measurePosition} es un ejemplo obvio de esto.  Las propiedades
1553 de contexto se modifican con @code{\set}.
1554
1555 Hay un tipo especial de propiedad de contexto: la descripción del
1556 elemento.  Estas propiedades reciben nombres en
1557 @code{MayúsculasDeCamello} (comenzando en letra mayúscula).  Contienen
1558 los @q{ajustes por defecto} para dicho elemento gráfico como una lista
1559 asociativa.  Consulte @file{scm/@/define@/-grobs@/.scm} para ver qué
1560 tipos de ajustes hay.  Las descripciones de los elementos se pueden
1561 modificar con @code{\override}.
1562
1563 Realmente, @code{\override} es un atajo;
1564
1565 @example
1566 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1567 @end example
1568
1569 @noindent
1570 es más o menos equivalente a
1571
1572 @c  leave this long line -gp
1573 @example
1574 \set @var{contexto}.@var{nombre} #'@var{propiedad} = #(cons (cons '@var{propiedad} @var{valor}) <valor previo de @var{contexto})
1575 @end example
1576
1577 El valor de @code{contexto} (la lista-a) se usa para da un valor
1578 inicial a las propiedades de los objetos gráficos individuales.  Los
1579 objetos gráficos también tienen propiedades, que reciben nombres en el
1580 estilo de Scheme, con @code{palabras-con-guiones}.  Los valores de las
1581 propiedades de objetos gráficos cambian durante el proceso de
1582 formateo: el formateo básicamente consiste en calcular las propiedades
1583 utilizando funciones de callback.
1584
1585 @code{fontSize} es una propiedad especial: equivale a escribir
1586 @code{\override ... #'font-size} para todos los objetos pertinentes.
1587 Al ser éste un cambio muy común, se creó la propiedad especial
1588 (modificada con @code{\set}).
1589
1590
1591 @node Useful concepts and properties
1592 @section Useful concepts and properties
1593
1594
1595 @menu
1596 * Input modes::
1597 * Direction and placement::
1598 * Distances and measurements::
1599 * Staff symbol properties::
1600 * Spanners::
1601 * Visibility of objects::
1602 * Line styles::
1603 * Rotating objects::
1604 @end menu
1605
1606 @node Input modes
1607 @subsection Input modes
1608
1609 La forma en que se interpreta la notación conenida dentro de un
1610 archivo de entrada, está determinada por el modo de entrada en curso.
1611
1612 @strong{Modo de acordes}
1613
1614 Se activa con la instrucción @code{\chordmode} y produce que la
1615 entrada se interprete con al sintaxis de la notación de acordes, véase
1616 @ref{Chord notation}.  Los acordes se imprimen como notas sobre un
1617 pentagrama.
1618
1619 El modo de acordes se activa también con la instrucción
1620 @code{\chords}.  Esto crea también un contexto @code{ChordNames} nuevo
1621 y produce que el código que sigue se interprete conla sintaxis de la
1622 notación de acordes y se imprima como nombres de acorde dentro del
1623 contexto @code{ChordNames}, véase @ref{Printing chord names}.
1624
1625 @strong{Modo de percusión}
1626
1627 Se activa con la instrucción @code{\drummode} y produce que el código
1628 de entrada se interprete con la sintaxis de la notación de percusión,
1629 véase @ref{Basic percussion notation}.
1630
1631 El modo de percusión también se activa con la instrucción
1632 @code{\drums}.  También crea un contexto @code{DrumStaff} nuevo y hace
1633 que el código que sigue se interprete con la sintaxis de la notación
1634 de percusión y se imprima como símbolos de percusión sobre un
1635 pentagrama de percusión, véase @ref{Basic percussion notation}.
1636
1637 @strong{Modo de cifras}
1638
1639 Se activa con la instrucción @code{\figuremode} y hace que el código
1640 de entrada se interprete con la sintaxis del bajo cifrado, véase
1641 @ref{Entering figured bass}.
1642
1643 El modo de cifrase también se activa con la instrucción
1644 @code{\figures}.  También crea un contexto de @code{FiguredBass} nuevo
1645 y hace que el código que viene a continuación se interprete con la
1646 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
1647 dentro del contexto @code{FiguredBass}, véase @ref{Introduction to
1648 figured bass}.
1649
1650 @strong{Modos de traste y tablatura}
1651
1652 No existen modos de entrada especiales para introducir símibolos de
1653 trastes y de tablatura.
1654
1655 Para crear diagramas de trastes, escriba las notas o acordes en el
1656 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
1657 véase @ref{Default tablatures}.
1658
1659 Para crear diagramas de trastes encima de un pentagrama, escríbalos
1660 como elementos de marcado encima de las notas utilizando la
1661 instrucción @code{\fret-diagram}, véase @ref{Fret diagram markups}.
1662
1663 @strong{Modo de letra}
1664
1665 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
1666 se interprete como sílabas de la letra de la canción con duraciones
1667 opcionales y modificadores de letra asociados, véase @ref{Vocal
1668 music}.
1669
1670 El modo de letra también se habilita con la instrucción
1671 @code{\addlyrics}.  Esto también crea un contexto @code{Lyrics} nuevo
1672 y una instrucción @code{\lyricsto} implícita que asocia la letra que
1673 viene a continuación con la música precedente.
1674
1675 @strong{Modo de marcado}
1676
1677 Se activa con la instrucción @code{\markup}, y hace que la entrada se
1678 interprete con la sintaxis del marcado, véase @ref{Text markup
1679 commands}.
1680
1681 @c silly work-around for texinfo broken-ness
1682 @c (@strong{Note...} causes a spurious cross-reference in Info)
1683 @b{Modo de notas}
1684
1685 Es el modo predeterminado o se puede activar con la instrucción
1686 @code{\notemode}.  La entrada se interpreta como alturas, duraciones,
1687 marcado, etc. y se imprime como notación musical sobre un pentagrama.
1688
1689 Normalmente no es necesario especificar el modo de notas de forma
1690 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
1691 ejemplo si estamos en el modo de letra, en el modo de acordes o en
1692 otro modo y queremos insertar algo que solamente se puede hacer con la
1693 sintaxis del modo de notas.
1694
1695 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
1696 una pieza coral es necesario entrar en el modo de notas para poder
1697 interpretar dichas indicaciones:
1698
1699 @lilypond[verbatim,relative=2,quote]
1700 { c4 c4 c4 c4 }
1701 \addlyrics {
1702   \notemode{\set stanza = \markup{ \dynamic f 1. } }
1703   To be sung loudly
1704 }
1705 \addlyrics {
1706   \notemode{\set stanza = \markup{ \dynamic p 2. } }
1707   To be sung quietly
1708 }
1709 @end lilypond
1710
1711
1712
1713 @node Direction and placement
1714 @subsection Direction and placement
1715
1716 Al tipografiar música, la dirección y colocación de muchos elementos
1717 es cuestión de elección.  Por ejemplo, las plicas de las notas se
1718 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
1719 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
1720 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
1721 o centrado; etc.  La mayoría de estas elecciones pueden dejarse que
1722 LilyPond las determine automáticamente, pero en ciertos casos puede
1723 ser deseable forzar una dirección o colocación concreta.
1724
1725 @strong{Acciones predeterminadas}
1726
1727 De forma predeterminada algunas direcciones siempre son hacia arriba o
1728 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
1729 otras cosas pueden alternar entre arriba y abajo en función de la
1730 dirección de las plicas (como las ligaduras o los acentos).
1731
1732 @c TODO Add table showing these
1733
1734 @strong{Disposición de contexto}
1735
1736 Los contextos se colocan dentro de un sistema de arriba a abajo en el
1737 orden en que se encuentran.  Sin embargo, observe que se crea un
1738 contexto implícitamente si se encuentra una instrucción cuando no está
1739 disponible un contexto apropiado para contenerla.
1740
1741 @c TODO Add example ?
1742
1743 Se pude cambiar el orden predeterminado en que los contextos se
1744 presentan, véase @ref{Aligning contexts}
1745
1746 @strong{Indicadores de dirección de las articulaciones}
1747
1748 Al añadir articulaciones a notas se puede omitir normalmente el
1749 indicador de dirección, @code{^} (que significa @qq{arriba}), @code{_}
1750 (que significa @qq{abajo}) o @code{-} (que significa @qq{usar la
1751 dirección predeterminada}), en cuyo caso se supone el perdeterminado
1752 @code{-}.  Pero se necesita un indicador de dirección @strong{always}
1753 antes de:
1754
1755 @itemize
1756 @item las instrucciones @code{\tweak}
1757 @item las instrucciones @code{\markup}
1758 @item las instrucciones @code{\tag}
1759 @item los marcados de cadena, p.ej. -"cadena"
1760 @item las instrucciones de digitación, p.ej. @code{-1}
1761 @item las abreviaturas de articulación, p.ej. @code{-.}, @code{->}, @code{--}
1762 @end itemize
1763
1764 @strong{La propiedad de dirección}
1765
1766 La posición o dirección de muchos objetos de presentación está
1767 controlada por la propiedad @code{direction}.
1768
1769 El valor de la propiedad @code{direction} se puede establecer al valor
1770 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
1771 @code{-1}, con el significado de @qq{hacia abajo} o @qq{debajo}.  Se
1772 pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
1773 @code{1} y @code{-1} respectivamente.  La dirección predeterminada se
1774 puede especificar estableciendo @code{direction} a @code{0} ó a
1775 @code{CENTER}.  De forma alternativa, en muchos casos existen
1776 instrucciones predefinidas para especificar la dirección.  Todas ellas
1777 son de la forma:
1778
1779 @noindent
1780 @code{\xxxUp}, @code{xxxDown}, @code{xxxNeutral}
1781
1782 @noindent
1783 donde @code{xxxNeutral} significa @qq{utilizar la dirección
1784 predeterminada}.  Véase @rlearning{Within-staff objects}.
1785
1786 En alguna que otra ocasión, con el único ejemplo usual del arpegio, el
1787 valor de la propiedad @code{direction} especifica si el objeto se debe
1788 colocar a la izquierda o a la derecha del objeto padre.  En este caso
1789 @code{-1} ó @code{LEFT} significan @qq{a la izquierda} y @code{1} ó
1790 @code{RIGHT} significan @qq{a la derecha}.  @code{0} ó @code{CENTER}
1791 significan @qq{utilizar la dirección predeterminada}, como antes.
1792
1793
1794 @node Distances and measurements
1795 @subsection Distances and measurements
1796
1797 @cindex distances, absolute
1798 @cindex distances, scaled
1799
1800 @funindex \mm
1801 @funindex \cm
1802 @funindex \in
1803 @funindex \pt
1804
1805 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
1806
1807 Las distancias absolutas se usan para especificar márgenes, sangrados
1808 y otros detalles de diseño de página, y de forma predeterminada se
1809 especifican en milímetros.  Las distancias se pueden especificar en
1810 otras unidades escribiendo después de la cifra indicativa de la
1811 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
1812 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas).  Las distancias de diseño
1813 de página se pueden especificar también en unidades escalables (véase
1814 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
1815 La disposición de página se describe en detalle en @ref{Page
1816 formatting}.
1817
1818 Las distancias escaladas siempre se especifican en unidades de un
1819 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
1820 El espacio de pentagrama es la distancia entre dos líneas del
1821 pentagrama adyacentes.  El valor predeterminado se puede cambiar
1822 globalmente fijando el tamaño global del pentagrama, o se puede
1823 sobreescribir localmente cambiando la propiedad @code{staff-space} del
1824 objeto @code{StaffSymbol}.  Las distancias escaladas se escalan
1825 automáticamente con cualquier cambio al tamaño global del pentagrama o
1826 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
1827 las fuentes tipográficas se escalan solamente con los cambios
1828 efectuados al tamaño global del pentagrama.  Así, el tamaño global del
1829 pentagrama posibilita la fácil variación del tamaño general de una
1830 partitura impresa.  Para ver los métodos de establecimiento del tamaño
1831 global del pentagrama, véase @ref{Setting the staff size}.
1832
1833 @funindex magstep
1834
1835 Si se necesita dibujar sólo una sección de una partitura a una escala
1836 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
1837 simplemente cambiar el tamaño global del pentagrama porque esto
1838 afectaría a toda la partitura.  En tales casos, el cambio de tamaño se
1839 hace sobreescribiendo tanto la propiedad @code{staff-space} de
1840 @code{StaffSymbol} como el tamaño de las fuentes tipográficas.  Está a
1841 nuestra disposición una función de Scheme, @code{magstep}, para
1842 convertir de un cambio en el tamaño de la fuente al cambio equivalente
1843 en @code{staff-space}.  Para ver una explicación y un ejemplo de su
1844 utilización, consulte @rlearning{Length and thickness of objects}.
1845
1846 @seealso
1847
1848 Manual de aprendizaje:
1849 @rlearning{Length and thickness of objects}.
1850
1851 Referencia de la notación:
1852 @ref{Page formatting},
1853 @ref{Setting the staff size}.
1854
1855
1856 @node Staff symbol properties
1857 @subsection Staff symbol properties
1858
1859 @cindex ajuste del símbolo del pentagrama
1860 @cindex dibujar el símbolo del pentagrama
1861 @cindex pentagrama, establecer el símbolo del
1862
1863 @c TODO Extend or remove this section.  See also NR 1.6.2 Staff symbol
1864 @c      Need to think of uses for these properties.  Eg 'line-positions
1865 @c      is used in a snippet to thicken centre line.
1866 @c      If retained, add @ref to here in 1.6.2  -td
1867
1868 Se puede definir al mismo tiempo la posición vertical de las líneas de
1869 la pauta y el número de líneas de la misma.  Como muestra el siguiente
1870 ejemplo, las posiciones de las notas no están influidas por las
1871 posiciones de las líneas de la pauta.
1872
1873 @warning{La propiedad @code{'line-positions} sobreescribe a la
1874 propiedad @code{'line-count}.  El número de líneas de la pauta está
1875 definido implícitamente por el número de elementos de la lista de
1876 valores de @code{'line-positions}.}
1877
1878 @lilypond[verbatim,quote,relative=1]
1879 \new Staff \with {
1880   \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
1881 }
1882 { a4 e' f b | d1 }
1883 @end lilypond
1884
1885 Se puede modificar la anchura de la pauta.  Las unidades son espacios
1886 de pentagrama.  El espaciado de los objetos dentro del pentagrama no
1887 resulta afectado por este ajuste.
1888
1889 @lilypond[verbatim,quote,relative=1]
1890 \new Staff \with {
1891   \override StaffSymbol #'width = #23
1892 }
1893 { a4 e' f b | d1 }
1894 @end lilypond
1895
1896
1897 @node Spanners
1898 @subsection Spanners
1899
1900 Muchos objetos de notación musical abarcan varias notas o incluso
1901 varios compases.  Son ejemplos los crescendi, trinos, corchetes de
1902 grupo especial y corchetes de primera y segunda vez.  Estos objetos se
1903 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
1904 especiales para controlar su apariencia y comportamiento.  Algunas de
1905 estas propiedades son comunes a todos los objetos de extensión; otras
1906 se limitan a un subconjunto de los extensores.
1907
1908 Todos los objetos de extensión contemplan el interface
1909 @code{spanner-interface}.  Algunos, básicamente aquellos que trazan
1910 una línea recta entre los dos objetos, contemplan también el interface
1911 @code{line-spanner-interface}.
1912
1913 @unnumberedsubsubsec Using the @code{spanner-interface}
1914
1915 Este interface proporciona dos propiedades que se aplican a varios
1916 extensores.
1917
1918 @strong{@i{La propiedad @code{minimum-length}}}
1919
1920 La longitud mínima del objeto de extensión se pesoecifica a través de
1921 la propiedad @code{minimum-length}.  Su aumento suele producir el
1922 efecto necesario de aumentar el espaciado de las notas entre los dos
1923 puntos extremos.  Sin embargo, esta sobreescritura no tiene ningún
1924 efecto sobre muchos extensores, pues su longitud está determinada por
1925 otras consideraciones.  Más abajo se muestran algunos ejemplos de
1926 dónde es efectiva.
1927
1928 @ignore
1929 Works for:
1930   Tie
1931   MultiMeasureRest
1932   Hairpin
1933   Slur
1934   PhrasingSlur
1935
1936 Works as long as callback is made:
1937   Glissando
1938   Beam
1939
1940 Works not at all for:
1941   LyricSpace
1942   LyricHyphen
1943   LyricExtender
1944   TextSpanner
1945   System
1946
1947 @end ignore
1948
1949 @lilypond[verbatim,quote,relative=2]
1950 a~a
1951 a
1952 % increase the length of the tie
1953 -\tweak #'minimum-length #5
1954 ~a
1955 @end lilypond
1956
1957 @lilypond[verbatim,quote,relative=2]
1958 a1
1959 \compressFullBarRests
1960 R1*23
1961 % increase the length of the rest bar
1962 \once \override MultiMeasureRest #'minimum-length = #20
1963 R1*23
1964 a1
1965 @end lilypond
1966
1967 @lilypond[verbatim,quote,relative=2]
1968 a \< a a a \!
1969 % increase the length of the hairpin
1970 \override Hairpin #'minimum-length = #20
1971 a \< a a a \!
1972 @end lilypond
1973
1974 Esta sobreescritura se puede usar también para aumentar la longitud de
1975 las ligaduras de expresión y de fraseo:
1976
1977 @lilypond[verbatim,quote,relative=2]
1978 a( a)
1979 a
1980 -\tweak #'minimum-length #5
1981 ( a)
1982
1983 a\( a\)
1984 a
1985 -\tweak #'minimum-length #5
1986 \( a\)
1987 @end lilypond
1988
1989 Para algunos objetos de preesentación, la propiedad
1990 @code{minimum-length} es efectiva sólo si se llama explícitamente al
1991 procedimiento @code{set-spacing-rods}.  Para hacerlo, se debe fijar la
1992 propiedad @code{springs-and-rods} al valor
1993 @code{ly:spanner::set-spacing-rods}.  Por ejemplo, la longitud mínima
1994 de un glissando no tiene efecto a no ser que se establezca la
1995 propiedad @code{springs-and-rods}:
1996
1997 @lilypond[verbatim,quote,relative=1]
1998 % default
1999 e \glissando c'
2000
2001 % not effective alone
2002 \once \override Glissando #'minimum-length = #20
2003 e, \glissando c'
2004
2005 % effective only when both overrides are present
2006 \once \override Glissando #'minimum-length = #20
2007 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
2008 e, \glissando c'
2009 @end lilypond
2010
2011 Lo mismo se puede decir del objeto @code{Beam}:
2012
2013 @lilypond[verbatim,quote,relative=1]
2014 % not effective alone
2015 \once \override Beam #'minimum-length = #20
2016 e8 e e e
2017
2018 % effective only when both overrides are present
2019 \once \override Beam #'minimum-length = #20
2020 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2021 e8 e e e
2022 @end lilypond
2023
2024 @strong{@i{The @code{to-barline} property}}
2025
2026 La segunda propiedad útil del @code{spanner-interface} es
2027 @code{to-barline}.  De forma predeterminada tiene el valor cierto,
2028 haciendo que los reguladores y otros objetos de extensión que terminan
2029 sobre la primera nota de un compás, en vez de eso terminen en la línea
2030 divisoria inmediatamente precedente.  Si se establece al valor falso,
2031 el extensor llegará más allá de la barra de compás y terminará
2032 excatamente sobre la nota:
2033
2034 @lilypond[verbatim,quote,relative=2]
2035 a \< a a a a \! a a a \break
2036 \override Hairpin #'to-barline = ##f
2037 a \< a a a a \! a a a
2038 @end lilypond
2039
2040 Esta propiedad no es efectiva para todos los extensores.  Por ejemplo,
2041 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2042 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2043 que terminar en la barra de compás no tendría ningún significado.
2044
2045 @unnumberedsubsubsec Using the @code{line-spanner-interface}
2046
2047 Entre los objetos que contemplan el interface
2048 @code{line-spanner-interface} se encuentran
2049
2050 @itemize
2051 @item @code{DynamicTextSpanner}
2052 @item @code{Glissando}
2053 @item @code{TextSpanner}
2054 @item @code{TrillSpanner}
2055 @item @code{VoiceFollower}
2056 @end itemize
2057
2058 La rutina responsable de dibujar los sellos de estos extensores es
2059 @code{ly:line-interface::print}.  esta rutina determina la
2060 localización exacta de los dos puntos extremos y traza una línea entre
2061 ellos, en el estilo solicitado.  Las posiciones de los dos puntos
2062 extremos del extensor se calculan al vuelo, pero es posible
2063 sobreescribir sus coordenadas Y.  Las propiedades que se deben
2064 especificar están anidadas a dos niveles de profundidad en la
2065 jerarquía de propiedades, pero la sintaxis de la instrucción
2066 @code{\override} es bastante sencilla:
2067
2068 @lilypond[relative=2,quote,verbatim]
2069 e2 \glissando b
2070 \once \override Glissando #'bound-details #'left #'Y = #3
2071 \once \override Glissando #'bound-details #'right #'Y = #-2
2072 e2 \glissando b
2073 @end lilypond
2074
2075 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2076 siendo el punto del cero la línea central del pentagrama.  Para el
2077 glissando, esto es el valor de @code{Y} en la coordenada X que
2078 corresponde al punto central de cada cabeza de nota si nos imaginamos
2079 que la línea se extiende hasta allí.
2080
2081 Si no está fijado @code{Y}, su valor se calcula a partir de la
2082 posición vertical del punto de anclaje correspondiente del extensor.
2083
2084 En caso de salto de línea, los valores para los puntos extremos se
2085 especifican por las sub-listas @code{left-broken} y
2086 @code{right-broken} de @code{bound-details}.  Por ejemplo:
2087
2088 @lilypond[relative=2,ragged-right,verbatim,fragment]
2089 \override Glissando #'breakable = ##t
2090 \override Glissando #'bound-details #'right-broken #'Y = #-3
2091 c1 \glissando \break
2092 f1
2093 @end lilypond
2094
2095 Un número de propiedades adicionales de las sub-listas @code{left} y
2096 @code{right} de la propiedad @code{bound-details} se pueden
2097 especificar de la misma forma que @code{Y}:
2098
2099 @table @code
2100 @item Y
2101 Establece la coordenada Y del punto extremo, en desplazamientos de
2102 @code{staff-space}s desde la línea central del pentagrama.  De forma
2103 predeterminada es el centro del objeto ancla, y así un glissando
2104 apunta al centro vertical de la cabeza de la nota.
2105
2106 Para extensores horizontales como los extensores de texto y los
2107 trinos, está inamoviblemente codificado como 0.
2108
2109 @item attach-dir (dirección de anclaje)
2110 Determina dónde comienza y termina la línea en la dirección X, con
2111 relación al objeto ancla.  Sí, un valor de @code{-1} (o @code{LEFT},
2112 izquierda) hace que la línea comienze o termine en el lado izquierdo
2113 de la cabeza de la nota a la que está anclado.
2114
2115 @item X
2116 Es la coordenada X absoluta del punto extremo.  Se suele calcular al
2117 vuelo, y su sobreescritura no tiene un efecto útil.
2118
2119 @item stencil (sello)
2120 Los extensores de línea pueden tener símbolos al comienzo o al final,
2121 lo que está contenido en esta sub-propiedad.  Esto es para uso
2122 interno; se recomienda en su lugar el uso de @code{text}.
2123
2124 @item text (texto)
2125 Es un elemento de marcado que se evalúa para dar lugar al sello.  Se
2126 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2127 de extensión horizontales.
2128
2129 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2130 \override TextSpanner #'bound-details #'left #'text
2131    = \markup { \small \bold Slower }
2132 c2\startTextSpan b c a\stopTextSpan
2133 @end lilypond
2134
2135 @item stencil-align-dir-y (alineación del sello en y)
2136 @item stencil-offset (desplazamiento del sello)
2137 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2138 punto extremo, centrado sobrer la línea, como viene definido por las
2139 subpropiedades @code{X} e @code{Y}.  Si se fijan
2140 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2141 símbolo del borde verticalmente con relación al extremo de la línea:
2142
2143 @lilypond[relative=1,fragment,verbatim]
2144 \override TextSpanner #'bound-details
2145   #'left #'stencil-align-dir-y = #-2
2146 \override TextSpanner #'bound-details
2147   #'right #'stencil-align-dir-y = #UP
2148
2149 \override TextSpanner #'bound-details
2150   #'left #'text = #"ggg"
2151 \override TextSpanner #'bound-details
2152   #'right #'text = #"hhh"
2153 c4^\startTextSpan c c c \stopTextSpan
2154 @end lilypond
2155
2156 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2157 al contrario de lo que podríoa esperarse, pues el valor de @code{-1} o
2158 @code{DOWN} (abajo) significa alinear el bborde @emph{inferior} del
2159 texto con la línea de extensión.  Un valor de @code{1} o @code{UP}
2160 (arriba) alinea el borde superior del texto con la línea extensora.
2161
2162 @item arrow (flecha)
2163 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
2164 flecha en el extremo de la línea.
2165
2166 @item padding (relleno)
2167 Esta sub-propiedad controla el espacio entre el punto extremo
2168 especificado de la línea y el extremo real.  Sin relleno, un glissando
2169 empezaría y terminaría en el centro de la cabeza de las notas.
2170
2171 @end table
2172
2173 La función musical @code{\endSpanners} finaliza de forma prematura el
2174 extensor que comienza sobre la nota que sigue inmediatamente a
2175 continuación.  Se termina después de una nota exactamente, o en la
2176 siguiente barra de compás si @code{to-barline} es verdadero y se
2177 produce una divisoria antes de la siguiente nota.
2178
2179 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
2180 \endSpanners
2181 c2 \startTextSpan c2 c2
2182 \endSpanners
2183 c2 \< c2 c2
2184 @end lilypond
2185
2186 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
2187 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
2188
2189 @seealso
2190
2191 Referencia de funcionamiento interno:
2192 @rinternals{TextSpanner},
2193 @rinternals{Glissando},
2194 @rinternals{VoiceFollower},
2195 @rinternals{TrillSpanner},
2196 @rinternals{line-spanner-interface}.
2197
2198
2199 @node Visibility of objects
2200 @subsection Visibility of objects
2201
2202 @cindex objetos, visibilidad de
2203 @cindex grobs, visibilidad de
2204 @cindex visibilidad de los objetos
2205
2206 Hay cuatro formas principales en que se puede controlar la visibilidad
2207 de los objetos de presentación: se puede eliminar su sello, se pueden
2208 volver transparentes, se pueden pintar de blanco, o se puede
2209 sobreescribir su propiedad @code{break-visibility}.  Las tres primeras
2210 se aplican a todos los objetos de presentación; la última sólo a unos
2211 pocos: los objetos @emph{divisibles}.  El Manual de aprendizaje
2212 introduce estas cuatro técnicas, véase @rlearning{Visibility and color
2213 of objects}.
2214
2215 Hay también algunas otras técnicas que son específicas de ciertos
2216 objetos de presentación.  Se estudian bajo Consideraciones especiales.
2217
2218 @menu
2219 * Removing the stencil::
2220 * Making objects transparent::
2221 * Painting objects white::
2222 * Using break-visibility::
2223 * Special considerations::
2224 @end menu
2225
2226
2227 @node Removing the stencil
2228 @unnumberedsubsubsec Removing the stencil
2229
2230 @cindex sello, eliminar
2231
2232 Todo objeto de presentación tiene una propiedad stencil (sello).  De
2233 forma predeterminada está establecida a la función específica que
2234 dibuja ese objeto.  Se se sobreescribe eesta propiedad a @code{#f} no
2235 se llama a ninguna función y el objeto no se dibuja.  La acción
2236 predeterminada se puede recuperar con @code{\revert}.
2237
2238 @lilypond[quote,verbatim,relative=1]
2239 a1 a
2240 \override Score.BarLine #'stencil = ##f
2241 a a
2242 \revert Score.BarLine #'stencil
2243 a a a
2244 @end lilypond
2245
2246 @node Making objects transparent
2247 @unnumberedsubsubsec Making objects transparent
2248
2249 @cindex transparentes, hacer los objetos
2250
2251 Todo objeto de presentación tiene una propiedad transparent
2252 (transparente) que de forma predeterminada está establecida a
2253 @code{#f}.  Si se fija a @code{#t} el objeto aún ocupa espacio pero es
2254 invisible.
2255
2256 @lilypond[quote,verbatim,relative=2]
2257 a4 a
2258 \once \override NoteHead #'transparent = ##t
2259 a a
2260 @end lilypond
2261
2262 @node Painting objects white
2263 @unnumberedsubsubsec Painting objects white
2264
2265 @cindex objetos, coloreado de
2266 @cindex coloreado de objetos
2267 @cindex capas
2268 @cindex impresión, orden de
2269 @cindex sobreescritura de objetos
2270 @cindex objetos, sobreescritura de
2271 @cindex grobs, sobreescritura de
2272
2273 Todo objeto de presentación tiene una propiedad de color que de forma
2274 predeterminada está establecida a @code{black} (negro).  Si se
2275 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
2276 fondo blanco.  Sin embargo, si el objeto cruza a otros objetos, el
2277 color de los puntos de cruce queda determinado por el orden en que se
2278 dibujan estos objetos, lo que puede dejar una imagen fantasma del
2279 objeto blanco, como puede verse aquí:
2280
2281 @lilypond[quote,verbatim,relative=2]
2282 \override Staff.Clef #'color = #white
2283 a1
2284 @end lilypond
2285
2286 Se puede evitar esto cambiando el orden de impresión de los objetos.
2287 Todos los objetos de presentación tienen una propiedad @code{layer}
2288 (capa) que se debe establecer a un valor entero.  Los objetos con el
2289 valor de @code{layer} más bajo se dibujan primero, después se dibujan
2290 los objetos con valores progresivamente mayores, y así los objetos con
2291 valores más altos se dibujan encima de los que tienen valores más
2292 bajos.  De forma predeterminada, casi todos los objetos tienen
2293 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
2294 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
2295 y @code{BarLine}, tienen asignado un calor de @code{0}.  El orden de
2296 impresión de los objetos con el mismo valor de @code{layer} es
2297 indeterminado.
2298
2299 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
2300 predeterminado de @code{1}, se dibuja después de las líneas del
2301 pentragrama (valor @code{layer} predeterminado de @code{0}),
2302 sobreimpresionándolas.  Para cambiarlo, se debe dar al objeto
2303 @code{Clef} un valor de @code{layer} más bajo, digamos @code{-1}, para
2304 que se dibuje antes:
2305
2306 @lilypond[quote,verbatim,relative=2]
2307 \override Staff.Clef #'color = #white
2308 \override Staff.Clef #'layer = #-1
2309 a1
2310 @end lilypond
2311
2312 @node Using break-visibility
2313 @unnumberedsubsubsec Using break-visibility
2314
2315 @c TODO Add making other objects breakable
2316
2317 @cindex break-visibility
2318
2319 Casi todos los objetos de presentación se imprimen una sola vez, pero
2320 algunos como las líneas divisorias, claves, indicaciones de compás y
2321 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
2322 se produce un salto de línea : una vez al final de la línea y otra al
2323 comienzo de la siguiente.  Estos objetos reciben el nombre de
2324 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
2325 (visibilidad en el salto), para controlar su visibilidad en las tres
2326 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
2327 la línea si se produce un cambio, y al final de la línea si el cambio
2328 se produce en ese lugar.
2329
2330 Por ejemplo, la indicación de compás se imprime de forma
2331 predeterminada al comienzo de la primera línea y en ningún otro lugar
2332 a no ser que cambie, en cuyo caso se imprime en el punto en que se
2333 produce el cambio.  Si este cambio se produce al final de una línea,
2334 la nueva indicación de compás se imprime al principio de la línea
2335 siguiente y también al final de la línea anterior como indicación de
2336 precaución.
2337
2338 Este comportamiento se controla por medio de la propiedad
2339 @code{break-visibility}, que se explica en
2340 @c Leave this ref on a newline - formats incorrectly otherwise -td
2341 @rlearning{Visibility and color of objects}.  Esta propiedad toma un
2342 vector de tres valores booleanos que, por orden, determinan si el
2343 objeto se imprime al final, dentro, o al principio de la línea.  O,
2344 para ser más exactos: antes del salto de línea, si no hay salto, o
2345 después del salto.
2346
2347 Como alternativa se puede especificar cualquiera de las ocho
2348 combinaciones mediante funciones predefinidas cuya definición está en
2349 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
2350 los objetos de presentación serán visibles en las posiciones que se
2351 muestran en el encabezamiento de cada columna:
2352
2353 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {yes} {yes} {yes}
2354 @headitem Forma                   @tab Forma                  @tab Antes del @tab Si no hay    @tab Después del
2355 @headitem de función              @tab de vector              @tab salto     @tab salto        @tab salto
2356
2357 @item @code{all-visible}             @tab @code{'#(#t #t #t)}     @tab sí     @tab sí       @tab sí
2358 @item @code{begin-of-line-visible}   @tab @code{'#(#f #f #t)}     @tab no     @tab no       @tab sí
2359 @item @code{center-visible}          @tab @code{'#(#f #t #f)}     @tab no     @tab sí       @tab no
2360 @item @code{end-of-line-visible}     @tab @code{'#(#t #f #f)}     @tab sí     @tab no       @tab no
2361 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)}     @tab sí     @tab sí       @tab no
2362 @item @code{center-invisible}        @tab @code{'#(#t #f #t)}     @tab sí     @tab no       @tab sí
2363 @item @code{end-of-line-invisible}   @tab @code{'#(#f #t #t)}     @tab no     @tab sí       @tab sí
2364 @item @code{all-invisible}           @tab @code{'#(#f #f #f)}     @tab no     @tab no       @tab no
2365 @end multitable
2366
2367 Los ajustes predeterminados de @code{break-visibility} dependen del
2368 objeto de presentación.  La tabla siguiente muestra todos los objetos
2369 de presentación de interés que resultan afectados por
2370 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
2371
2372 @multitable @columnfractions .3 .3 .4
2373
2374 @headitem Objeto   @tab Contexto usual  @tab Valor predet.
2375
2376 @c omit Ambitus as it appears not to be affected by break-visibility -td
2377 @c @item @code{Ambitus}          @tab as specified   @tab @code{begin-of-line-visible}
2378 @item @code{BarLine}             @tab @code{Score}          @tab calculado
2379 @item @code{BarNumber}           @tab @code{Score}          @tab @code{begin-of-line-visible}
2380 @c omit the following item until it can be explained -td
2381 @c @item @code{BreakAlignGroup}  @tab @code{Score}          @tab calculated
2382 @item @code{BreathingSign}       @tab @code{Voice}          @tab @code{begin-of-line-invisible}
2383 @item @code{Clef}                @tab @code{Staff}          @tab @code{begin-of-line-visible}
2384 @item @code{Custos}              @tab @code{Staff}          @tab @code{end-of-line-visible}
2385 @item @code{DoublePercentRepeat} @tab @code{Voice}          @tab @code{begin-of-line-invisible}
2386 @c omit KeyCancellation until it can be explained -td
2387 @c @item @code{KeyCancellation}  @tab ??             @tab @code{begin-of-line-invisible}
2388 @item @code{KeySignature}        @tab @code{Staff}          @tab @code{begin-of-line-visible}
2389 @c omit LeftEdge until it can be explained -td
2390 @c @item @code{LeftEdge}         @tab @code{Score}          @tab @code{center-invisible}
2391 @item @code{OctavateEight}       @tab @code{Staff}          @tab @code{begin-of-line-visible}
2392 @item @code{RehearsalMark}       @tab @code{Score}          @tab @code{end-of-line-invisible}
2393 @item @code{TimeSignature}       @tab @code{Staff}          @tab @code{all-visible}
2394
2395 @end multitable
2396
2397 El ejemplo de abajo muestra el uso de la forma de vector para
2398 controlar la visibilidad de las líneas divisorias:
2399
2400 @lilypond[quote,verbatim,relative=1,ragged-right]
2401 f4 g a b
2402 f4 g a b
2403 % Remove bar line at the end of the current line
2404 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
2405 \break
2406 f4 g a b
2407 f4 g a b
2408 @end lilypond
2409
2410 Aunque los tres componentes del vector utilizado para sobreescribir
2411 @code{break-visibility} deben estar presentes, no todos son efectivos
2412 para todos los objetos de presentación, y algunas combinaciones pueden
2413 incluso dar errores.  Son de aplicación las siguientes limitaciones:
2414
2415 @itemize @bullet
2416 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
2417 @item No se puede imprimir el número de compás al principio de la primera
2418 línea a no ser que su valor establecido sea distinto de 1.
2419 @item Clave: véase más abajo
2420 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
2421 se suprimen por completo.  Utilice begin-of line-invisible para
2422 imprimirlas y all-invisible para suprimirlas.
2423 @item Armadura: véase más abajo
2424 @item OctavateEight: véase más abajo
2425 @end itemize
2426
2427 @node Special considerations
2428 @unnumberedsubsubsec Special considerations
2429
2430 @strong{@emph{Visibilidad después de un cambio explícito}}
2431
2432 @cindex armadura, visibilidad después de un cambio explícito
2433 @cindex explicitKeySignatureVisibility
2434 @cindex clave, visibilidad después de un cambio explícito
2435 @cindex explicitClefVisibility
2436
2437 La propiedad @code{break-visibility} controla la visibilidad de las
2438 armaduras y cambios de clave sólo al principio de las líneas, es
2439 decir, después de un salto.  No tiene ningún efecto sobre la
2440 visibilidad de la armadura o la clave después de un cambio explícito
2441 de tonalidad o de clave dentro o al final de una línea.  En el ejemplo
2442 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
2443 bemol mayor es visible incluso con @code{all-invisible} establecido.
2444
2445 @lilypond[quote,verbatim,relative=1,ragged-right]
2446 \key g \major
2447 f4 g a b
2448 % Try to remove all key signatures
2449 \override Staff.KeySignature #'break-visibility = #all-invisible
2450 \key bes \major
2451 f4 g a b
2452 \break
2453 f4 g a b
2454 f4 g a b
2455 @end lilypond
2456
2457 La visibilidad de estos cambios explícitos de tonalidad y de clave se
2458 controla por medio de las propiedades
2459 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
2460 Son los equivalentes de la propiedad @code{break-visibility} y las dos
2461 toman un vector de tres valores booleanos o las funciones predefinidas
2462 relacionadas anteriormente, exactamente igual que
2463 @code{break-visibility}.  Las dos son propiedades del contexto Staff,
2464 no de los propios objetos de presentación, y por tanto se establecen
2465 utilizando la instrucción @code{\set}.  Las dos están establecidas de
2466 forma predeterminada al valor @code{all-visible}.  Estas propiedades
2467 controlan sólo la visibilidad de las armaduras y las claves que
2468 resultan de los cambios explícitos y no afectan a las armaduras y
2469 tonalidades que están al principio de las líneas; para quitarlas, aún
2470 se debe sobreescribir la propiedad @code{break-visibility} en el
2471 objeto correspondiente.
2472
2473 @lilypond[quote,verbatim,relative=1,ragged-right]
2474 \key g \major
2475 f4 g a b
2476 \set Staff.explicitKeySignatureVisibility = #all-invisible
2477 \override Staff.KeySignature #'break-visibility = #all-invisible
2478 \key bes \major
2479 f4 g a b \break
2480 f4 g a b
2481 f4 g a b
2482 @end lilypond
2483
2484 @strong{@emph{Visibilidad de las alteraciones de precaución}}
2485
2486 Para eliminar las alteraciones de precaución que se imprimen en un
2487 cambio de tonalidad explícito, establezca la propiedad
2488 @code{printKeyCancellation} del contexto Staff a @code{#f}:
2489
2490 @lilypond[quote,verbatim,relative=1,ragged-right]
2491 \key g \major
2492 f4 g a b
2493 \set Staff.explicitKeySignatureVisibility = #all-invisible
2494 \set Staff.printKeyCancellation = ##f
2495 \override Staff.KeySignature #'break-visibility = #all-invisible
2496 \key bes \major
2497 f4 g a b \break
2498 f4 g a b
2499 f4 g a b
2500 @end lilypond
2501
2502 Con estas sobreescrituras solamente permanecen las alteraciones
2503 accidentales delante de las notas para indicar el cambio de tonalidad.
2504
2505 @c TODO Add visibility of cautionary accidentals before notes
2506
2507 @strong{@emph{Automatic bars}}
2508
2509 @cindex automaticBars
2510 @cindex líneas divisorias, eliminación
2511
2512 Como caso especial, la impresión de las líneas divisorias también se
2513 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
2514 el contexto Score.  Si se fija a @code{#f}, las barras de compás no se
2515 imprimen automáticamente; se deben crear explícitamente con una
2516 instrucción @code{\bar}.  A diferencia de la instrucción predefinida
2517 @code{\cadenzaOn}, los compases se siguen contando.  La generación de
2518 compases continúa de acuerdo a esta cuenta si esta propiedad se
2519 establece posteriormente a @code{#t}.  Si se fija al valor @code{#f},
2520 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
2521 explícitas.
2522
2523 @c TODO Add example
2524
2525 @strong{@emph{Octavated clefs}}
2526
2527 @cindex octavadas, visibilidad de las claves
2528 @cindex visibilidad de las claves octavadas
2529 @cindex claves, visibilidad de la octavación
2530
2531 El pequeño símbolo de octava sobre las claves en octava alta o baja se
2532 produce por parte del objeto @code{OctavateEight}.  Su visibilidad se
2533 controla independientemente de la del objeto @code{Clef}, así que es
2534 necesario aplicar las sobreescrituras correspondientes
2535 @code{break-visibility} tanto a los objetos @code{Clef} como
2536 @code{OctavateEight} para suprimir completamente estos símbolos de
2537 clave al comienzo de cada línea.
2538
2539 Para los cambios de clave explícitos, la propiedad
2540 @code{explicitClefVisibility} controla tanto el símbolo de clave como
2541 el símbolo de octava asociado.
2542
2543 @seealso
2544
2545 Manual de aprendizaje:
2546 @rlearning{Visibility and color of objects}
2547
2548
2549 @node Line styles
2550 @subsection Line styles
2551
2552 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
2553 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
2554 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
2555
2556 Todos ellos usan las mismas rutinas que el glissando para dibujar los
2557 textos y las líneas, y por ello el ajuste fino de su comportamiento se
2558 hace de la misma manera. Se hace con un spanner (un objeto de
2559 extensión), y la rutina responsable de dibujar los objetos de
2560 extensión es @code{ly:line-interface::print}. Esta rutina determina la
2561 colocación exacta de los dos @i{extremos del objeto de extensión} y
2562 dibuja una línea entre ellos, en el estilo solicitado.
2563
2564 He aquí un ejemplo de los distintos estilos de línea disponibles, y
2565 cómo aplicarles ajustes finos.
2566
2567 @lilypond[relative=2,ragged-right,verbatim,fragment]
2568 d2 \glissando d'2
2569 \once \override Glissando #'style = #'dashed-line
2570 d,2 \glissando d'2
2571 \override Glissando #'style = #'dotted-line
2572 d,2 \glissando d'2
2573 \override Glissando #'style = #'zigzag
2574 d,2 \glissando d'2
2575 \override Glissando #'style = #'trill
2576 d,2 \glissando d'2
2577 @end lilypond
2578
2579 Las posiciones de los puntos extremos del objeto de extensión se
2580 computan al vuelo para cada uno de los objetos gráficos, pero es
2581 posible sobreescribirlos:
2582
2583 @lilypond[relative=2,ragged-right,verbatim,fragment]
2584 e2 \glissando f
2585 \once \override Glissando #'bound-details #'right #'Y = #-2
2586 e2 \glissando f
2587 @end lilypond
2588
2589 El valor de @code{Y} está establecido a @code{-2} para el extremo
2590 derecho.  El lado izquierdo se puede ajustar de forma similar
2591 especificando @code{left} en vez de @code{right}.
2592
2593 Si no está establecido @code{Y}, el valor se computa a partir de la
2594 posición vertical de los puntos de anclaje izquierdo y derecho del
2595 extensor.
2596
2597 Son posibles otros ajustes de los extensores, para ver más detalles
2598 consulte @ref{Spanners}.
2599
2600
2601 @node Rotating objects
2602 @subsection Rotating objects
2603
2604 Tanto los objetos de presentación como los elementos de texto de
2605 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
2606 pero difiere el método de hacerlo.
2607
2608 @menu
2609 * Rotating layout objects::
2610 * Rotating markup::
2611 @end menu
2612
2613 @node Rotating layout objects
2614 @unnumberedsubsubsec Rotating layout objects
2615
2616 @cindex rotating objects
2617 @cindex objects, rotating
2618
2619 Todos los objetos de presentación que contemplan el interface
2620 @code{grob-interface} se pueden rotar estableciendo su propiedad
2621 @code{rotation}.  Acepta una lista de tres elementos: el ángulo de la
2622 rotación en sentido antihorario, y las coordenadas x e y del punto con
2623 relación al punto de referencia del objeto, alrededor del que se va a
2624 realizar la rotación.  El ángulo de rotación se pespecifica en grados
2625 y las coordenadas en espacios de pentagrama.
2626
2627 El ángulo de rotación y las coordenadas del punto de rotación se deben
2628 determinar por ensayo y error.
2629
2630 @cindex reguladores en ángulo
2631 @cindex ángulo, reguladores en
2632
2633 Solamente en ciertas ocasiones es útil la rotación de objetos de
2634 presentación; el ejemplo siguiente muestra una situación en que puede
2635 serlo:
2636
2637 @lilypond[quote,verbatim,relative=1]
2638 g4\< e' d' f\!
2639 \override Hairpin #'rotation = #'(20 -1 0)
2640 g,,4\< e' d' f\!
2641 @end lilypond
2642
2643 @node Rotating markup
2644 @unnumberedsubsubsec Rotating markup
2645
2646 Todos los textos de marcado se pueden rotar para que se dispongan en
2647 cualquier ángulo predeciéndolos de la instrucción @code{\rotate}.  La
2648 instrucción acepta dos argumentos: el ángulo de rotación en grados en
2649 sentido antihorario, y el texto que rotar.  Los límites que ocupa el
2650 texto no se rotan: toman su valor a partir de los extremos de las
2651 coordenadas x e y del texto rotado.  En el ejemplo siguiente la
2652 propiedad @code{outside-staff-priority} del texto se establece a
2653 @code{#f} para desactivar la evitación automática de colisiones, lo
2654 que empuja al texto a una posición muy alta.
2655
2656 @lilypond[quote,verbatim,relative=1]
2657 \override TextScript #'outside-staff-priority = ##f
2658 g4^\markup { \rotate #30 "a G" }
2659 b^\markup { \rotate #30 "a B" }
2660 des^\markup { \rotate #30 "a D-Flat" }
2661 fis^\markup { \rotate #30 "an F-Sharp" }
2662 @end lilypond
2663
2664 @node Advanced tweaks
2665 @section Advanced tweaks
2666
2667 Esta sección trata sobre distintos enfoques en la realización de
2668 ajustes finos a la apariencia de la partitura impresa.
2669
2670 @menu
2671 * Aligning objects::
2672 * Vertical grouping of grobs::
2673 * Modifying stencils::
2674 * Modifying shapes::
2675 @end menu
2676
2677 @seealso
2678
2679 Manual de aprendizaje:
2680 @rlearning{Tweaking output},
2681 @rlearning{Other sources of information}.
2682
2683 Referencia de la notación:
2684 @ref{Explaining the Internals Reference},
2685 @ref{Modifying properties},
2686 @ref{Interfaces for programmers}.
2687
2688 Archivos de inicio:
2689 @file{scm/@/define@/-grobs@/.scm}.
2690
2691 Fragmentos de código:
2692 @rlsr{Tweaks and overrides}.
2693
2694 Referencia de funcionamiento interno:
2695 @rinternals{All layout objects}.
2696
2697
2698 @node Aligning objects
2699 @subsection Aligning objects
2700
2701 Los objetos gráficos que soportan el interface
2702 @code{self-alignment-interface} y/o el @code{side-position-interface}
2703 se pueden alinear contra un objeto colocado previamente, de diversas
2704 maneras.  Para ver una lista de estos objetos, consulte
2705 @rinternals{self-alignment-interface} y
2706 @rinternals{side-position-interface}.
2707
2708 Todos los objetos gráficos tienen un punto de referencia, una
2709 extensión horizontal y una extensión vertical.  La extensión
2710 horizontal es una pareja de números que dan los desplazamientos a
2711 partir del punto de referencia de los bordes izquierdo y derecho,
2712 siendo negativos los desplazamientos hacia la izquierda.  La extensión
2713 vertical es una pareja de números que dan el desplazamiento a partir
2714 del punto de referencia hasta los bordes inferior y superior, siendo
2715 negativos los deplazamientos hacia abajo.
2716
2717 La posición de un objeto sobre el pentagrama viene dada por los
2718 valores de las propiedades @code{X-offset} e @code{Y-offset}.  El
2719 valor de @code{X-offset} da el desplazamiento desde la coordenada x
2720 del punto de referencia del objeto padre, y el valor de
2721 @code{Y-offset} da el desplazamiento a partir de la línea central del
2722 pentagrama.  Los valores de @code{X-offset} y @code{Y-offset} se
2723 pueden establecer directamente o se puede dejar que se calculen por
2724 parte de procedimientos para conseguir una alineación con el objeto
2725 padre de distintas maneras.
2726
2727 @warning{Muchos objetos tienen consideraciones de posicionamiento
2728 especiales que hacen que se ignore o se modifique cualquier ajuste
2729 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
2730 objeto contemple el interface @code{self-alignment-interface}.}
2731
2732 Por ejemplo, una alteración accidental se puede reposicionar
2733 verticalmente estableciendo @code{Y-offset} pero los cambios a
2734 @code{X-offset} no tienen ningún efecto.
2735
2736 Las letras de ensayo se pueden alinear con objetos divisibles como
2737 líneas divisorias, claves, armaduras e indicaciones de compás.  Hay
2738 propiedades especiales que se encuentran en
2739 @code{break-aligned-interface} para el posicionamiento de las letras
2740 de ensayo sobre dichos objetos.
2741
2742 @menu
2743 * Setting @code{X-offset} and @code{Y-offset} directly::
2744 * Using the @code{side-position-interface}::
2745 * Using the @code{self-alignment-interface}::
2746 * Using the @code{break-aligned-interface}::
2747 @end menu
2748
2749 @node Setting @code{X-offset} and @code{Y-offset} directly
2750 @unnumberedsubsubsec Setting @code{X-offset} and @code{Y-offset} directly
2751
2752 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
2753 @code{Y-offset} de muchos objetos.  El ejemplo siguiente muestra tres
2754 notas con una digitación en su posición predeterminada y con los
2755 valores @code{X-offset} y @code{Y-offset} modificados.
2756
2757 @lilypond[verbatim,quote,relative=2]
2758 a-3
2759 a
2760 -\tweak #'X-offset #0
2761 -\tweak #'Y-offset #0
2762 -3
2763 a
2764 -\tweak #'X-offset #-1
2765 -\tweak #'Y-offset #1
2766 -3
2767 @end lilypond
2768
2769 @c TODO write more
2770
2771 @node Using the @code{side-position-interface}
2772 @unnumberedsubsubsec Using the @code{side-position-interface}
2773
2774 Un objeto que contempla el @code{side-position-interface} se puede
2775 colocar junto a su objeto padre de forma que los bordes especificados
2776 de los dos objetos se toquen.  El objeto se puede situar encima,
2777 debajo, a la derecha o a la izquierda del objeto padre.  El padre no
2778 se puede especificar; ciene determinado por el orden de los elementos
2779 en el flujo de entrada.  Casi todos los objetos tienen la cabeza de la
2780 nota asociada como padre.
2781
2782 Los valores de las propiedades @code{side-axis} y @code{direction}
2783 determinan dónde colocar el objeto, como sigue:
2784
2785 @c TODO add an example of each to the table
2786
2787 @multitable @columnfractions .3 .3 .3
2788 @headitem @code{side-axis}  @tab @code{direction}  @tab
2789 @headitem propiedad         @tab propiedad         @tab colocación
2790
2791 @item     @code{0}          @tab @code{-1}         @tab izquierda
2792 @item     @code{0}          @tab @code{1}          @tab derecha
2793 @item     @code{1}          @tab @code{-1}         @tab debajo
2794 @item     @code{1}          @tab @code{1}          @tab encima
2795
2796 @end multitable
2797
2798 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
2799 procedimiento @code{ly:side-position-interface::x-aligned-side}.  Este
2800 procedimiento devuelve el calor correcto de @code{X-offset} para
2801 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
2802 el valor de @code{direction}.
2803
2804 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
2805 procedimiento @code{ly:side-position-interface::y-aligned-side}.  Este
2806 procedimiento devuelve el valor correcto de @code{Y-offset} para
2807 situar el objeto encima o debajo del padre de acuerdo con el valor de
2808 @code{direction}.
2809
2810 @c TODO Add examples
2811
2812 @node Using the @code{self-alignment-interface}
2813 @unnumberedsubsubsec Using the @code{self-alignment-interface}
2814
2815 @emph{Auto-alineación horizontal de los objetos}
2816
2817 La alineación horizontal de un objeto que contempla el interface
2818 @code{self-alignment-interface} está controlada por el valor de la
2819 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
2820 @code{X-offset} de este objeto esté establecida a
2821 @code{ly:self-alignment-interface::x-aligned-on-self}.  Se le puede
2822 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
2823 mitad de la extensión X total del objeto.  Los valores negativos
2824 mueven el objeto a la derecha, los positivos hacia la izquierda.  Un
2825 valor de @code{0} centra el objeto sobre el punto de referencia de su
2826 padre, un valor de @code{-1} alinea el borde izquierdo del objeto
2827 sobre el punto de referencia de su padre, y un valor de @code{1}
2828 alinea el borde derecho del objeto sobre el punto de referencia de su
2829 padre.  Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
2830 @code{RIGHT} en sustitución de los valores @code{-1, 0, 1},
2831 respectivamente.
2832
2833 Normalmente se usaría la instrucción @code{\override} para modificar
2834 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
2835 @code{\tweak} para alinear varias anotaciones por separado sobre una
2836 sola nota:
2837
2838 @lilypond[quote,verbatim,relative=1]
2839 a'
2840 -\tweak #'self-alignment-X #-1
2841 ^"left-aligned"
2842 -\tweak #'self-alignment-X #0
2843 ^"center-aligned"
2844 -\tweak #'self-alignment-X #RIGHT
2845 ^"right-aligned"
2846 -\tweak #'self-alignment-X #-2.5
2847 ^"aligned further to the right"
2848 @end lilypond
2849
2850 @emph{Auto-alineación vertical de los objetos}
2851
2852 Los objetos se pueden alinear verticalmente en una forma análoga a la
2853 alineación horizontal si la propiedad @code{Y-offset} está establecida
2854 a @code{ly:self-alignment-interface::y-aligned-on-self}.  Sin embargo,
2855 a menudo se encuentran implicados otros mecanismos en la alineación
2856 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
2857 tiene en cuenta.  Esto puede hacer que ajustar el valor de ciertos
2858 objetos sea una tarea dificultosa.  Las unidades son sólo la mitad de
2859 las dimensiones verticales del objeto, que suele ser bastante pequeño,
2860 por lo que pueden requerirse números bastante grandes.  Un valor de
2861 @code{-1} alinea el borde inferior del objeto con el punto de
2862 referencia del objeto padre, un valor de @code{0} alinea el centro del
2863 objeto con el punto de referencia del padre, y un valor de @code{1}
2864 alinea el borde superior del objeto con el punto de referencia del
2865 padre.  Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
2866 @code{UP} en sustitución de @code{-1, 0, 1} respectivamente.
2867
2868 @emph{Auto-alineación de objetos en las dos direcciones}
2869
2870 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
2871 alinear un objeto en las dos direcciones simultáneamente.
2872
2873 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
2874 se acerque a la cabeza de la nota.
2875
2876 @lilypond[quote,verbatim,relative=2]
2877 a
2878 -\tweak #'self-alignment-X #0.5  % move horizontally left
2879 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
2880 -\tweak #'self-alignment-Y #-1  % move vertically up
2881 -3  % third finger
2882 @end lilypond
2883
2884 @ignore
2885 @unnumberedsubsubsec Using the @code{aligned-on-parent} procedures
2886
2887 @c Cannot document as they do not seem to operate consistently on all objects -td
2888 @c TODO investigate further
2889
2890 The @code{aligned-on-parent} procedures are used in the same way
2891 as the @code{aligned-on-self} procedures, they difference being
2892 that they permit an object to be aligned with the @emph{edges} of
2893 the parent rather than the parent's reference point.  The following
2894 example shows the difference:
2895
2896 @c TODO Add example
2897
2898 @lilypond[verbatim,quote]
2899 @end lilypond
2900
2901 @end ignore
2902
2903 @ignore
2904 @unnumberedsubsubsec Using the @code{centered-on-parent} procedures
2905
2906 @c Cannot document as they do not seem to operate consistently on all objects -td
2907 @c TODO investigate further
2908
2909 @end ignore
2910
2911 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
2912
2913
2914 @node Using the @code{break-aligned-interface}
2915 @unnumberedsubsubsec Using the @code{break-aligned-interface}
2916
2917 Las letras de ensayo se pueden alinear con objetos de notación
2918 distintos a las barras de compás.  Estos objetos son @code{ambitus},
2919 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
2920 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
2921 @code{time-signature}.
2922
2923 De forma predeterminada, las letras de ensayo se centran
2924 horizontalmente sobre el objeto:
2925
2926 @lilypond[verbatim,quote,relative=1]
2927 e1
2928 % the RehearsalMark will be centered above the Clef
2929 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
2930 \key a \major
2931 \clef treble
2932 \mark "↓"
2933 e
2934 % the RehearsalMark will be centered above the TimeSignature
2935 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
2936 \key a \major
2937 \clef treble
2938 \time 3/4
2939 \mark "↓"
2940 e2.
2941 @end lilypond
2942
2943 La alineación de la letra de enzayo con relación al objeto de notación
2944 se puede cambiar, como se ve en el ejemplo siguiente.  En una
2945 partitura con varios pentagramas, este ajuste se debe hacer para todos
2946 los pentagramas.
2947
2948 @lilypond[verbatim,quote,relative=1]
2949 % The RehearsalMark will be centered above the KeySignature
2950 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
2951 \key a \major
2952 \clef treble
2953 \time 4/4
2954 \mark "↓"
2955 e1
2956 % The RehearsalMark will be aligned with the left edge of the KeySignature
2957 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
2958 \mark "↓"
2959 \key a \major
2960 e
2961 % The RehearsalMark will be aligned with the right edge of the KeySignature
2962 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
2963 \key a \major
2964 \mark "↓"
2965 e
2966 @end lilypond
2967
2968 La letra de ensayo también se puede desplazar al borde derecho o
2969 izquierdo en una medida arbitraria.  Las unidades son espacios de
2970 pentagrama:
2971
2972 @lilypond[verbatim,quote,relative=1]
2973 % The RehearsalMark will be aligned with the left edge of the KeySignature
2974 % and then shifted right by 3.5 staff-spaces
2975 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
2976 \once \override Score.KeySignature #'break-align-anchor = #3.5
2977 \key a \major
2978 \mark "↓"
2979 e
2980 % The RehearsalMark will be aligned with the left edge of the KeySignature
2981 % and then shifted left by 2 staff-spaces
2982 \once \override Score.KeySignature #'break-align-anchor = #-2
2983 \key a \major
2984 \mark "↓"
2985 e
2986 @end lilypond
2987
2988
2989 @node Vertical grouping of grobs
2990 @subsection Vertical grouping of grobs
2991
2992 Los grobs (objetos gráficos) @code{VerticalAlignment} y
2993 @code{VerticalAxisGroup} trabajan de manera coordinada.
2994 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
2995 @code{Lyrics}, etc.  Después, @code{VerticalAlignment} alinea los
2996 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
2997 Normalmente sólo existe un @code{VerticalAlignment} por cada
2998 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
2999 @code{VerticalAxisGroup}.
3000
3001
3002 @node Modifying stencils
3003 @subsection Modifying stencils
3004
3005 Todos los objetos de presentación tienen una propiedad @code{stencil}
3006 que es parte del @code{grob-interface}.  De forma predeterminada, esta
3007 propiedad suele estar establecida a una función específica del objeto
3008 que está hecha a medida para disponer el símbolo que lo representa en
3009 la salida.  Por ejemplo, el ajuste estándar para la propiedad
3010 @code{stencil} del objeto @code{MultiMeasureRest} es
3011 @code{ly:multi-measure-rest::print}.
3012
3013 El símbolo estándar de cualquier objeto se puede sustituir modificando
3014 la propiedad @code{stencil} para que haga referencia a un
3015 procedimiento diferente escrito especialmente.  Esto requiere un alto
3016 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3017 una forma más fácil que a menudo puede dar resultados adecuados.
3018
3019 El procedimiento es establecer la propiedad @code{stencil} al
3020 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3021 añadir una propiedad @code{text} al objeto ajustada para que contenga
3022 el texto de marcado que produce el símbolo requerido.  Debido a la
3023 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3024 particular, consulte @ref{Graphic notation inside markup}.
3025
3026 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3027 la nota a unas aspas dentro de una circunferencia.
3028
3029 @lilypond[verbatim,quote]
3030 XinO = {
3031   \once \override NoteHead  #'stencil = #ly:text-interface::print
3032   \once \override NoteHead #'text = \markup {
3033     \combine
3034       \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3035       \musicglyph #"noteheads.s2cross"
3036   }
3037 }
3038 \relative c'' {
3039   a a \XinO a a
3040 }
3041 @end lilypond
3042
3043 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3044 a la instrucción de marcado @code{\musicglyph}: véase @ref{The Feta
3045 font}.
3046
3047 @c TODO Add inserting eps files or ref to later
3048
3049 @c TODO Add inserting Postscript or ref to later
3050
3051 @seealso
3052
3053 Referencia de la notación:
3054 @ref{Graphic notation inside markup},
3055 @ref{Formatting text},
3056 @ref{Text markup commands},
3057 @ref{The Feta font}.
3058
3059
3060 @node Modifying shapes
3061 @subsection Modifying shapes
3062
3063 @menu
3064 * Modifying ties and slurs::
3065 @end menu
3066
3067 @node Modifying ties and slurs
3068 @unnumberedsubsubsec Modifying ties and slurs
3069
3070 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
3071 de Bézier de tercer orden.  Si la forma de la ligadura calculada
3072 automáticamente no resulta óptima, se puede modificar su forma
3073 manualmente mediante la especificación explícita de los cuatro puntos
3074 de control necesarios para definir una curva de Bézier de tercer
3075 orden.
3076
3077 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
3078 puntos de control.  El primer y cuarto puntos de control son
3079 exactamente los puntos extremos de comienzo y de final de la curva.
3080 Los dos puntos de contros intermedios definen la forma.  Se pueden
3081 encontrar en la web animaciones que muestran cómo se traza la curva,
3082 pero la descripción siguiente puede ser de ayuda.  La curva comienza a
3083 partir del primer punto de control dirigiéndose directamente hacia el
3084 segundo, curvándose progresivamente para dirigirse hacia el tercero y
3085 continuando la curva hacia el cuarto, llegando a éste en viaje directo
3086 desde el tercer punto de control.  La curva está contenida enteramente
3087 dentro del cuadrilátero definido por los cuatro puntos de control.
3088
3089 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
3090 @code{\tieDown} no sirve de ayuda.
3091
3092 @lilypond[verbatim,quote,relative=1]
3093 <<
3094   { e1 ~ e }
3095 \\
3096   { r4 <g c,> <g c,> <g c,> }
3097 >>
3098 @end lilypond
3099
3100 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
3101 de control como sigue.
3102
3103 Las coordenadas de los puntos de control de Bézier se especifican en
3104 unidades de espacios de pentagrama.  La coordenada@tie{}X está en
3105 relación con el punto de referencia de la nota a la que está unida la
3106 ligadura, y la coordenada@tie{}Y está en relación con la línea central
3107 del pentagrama.  Las coordenadas se introducen como una lista de
3108 cuatro parejas de números decimales (reales).  Un enfoque es estimar
3109 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
3110 los dos puntos intermedios.  Los valores óptimos se encuentran por
3111 ensayo y error.
3112
3113 Es útil recordar que una curva simétrica necesita puntos de contros
3114 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
3115 las transformaciones de la curva tales como la traslación, rotación y
3116 escalado se pueden obtener aplicando la misma transformación a los
3117 puntos de control de la curva.
3118
3119 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
3120 satisfactoria:
3121
3122 @lilypond[verbatim,quote,relative=1]
3123 <<
3124   \once \override Tie
3125     #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
3126   { e1 ~ e1 }
3127 \\
3128   { r4 <g c,> <g c,> <g c,>4  }
3129 >>
3130 @end lilypond
3131
3132 @knownissues
3133
3134 No es posible modificar la forma de las ligaduras de unión o de
3135 expresión cambiando la propiedad @code{control-points} si hay más de
3136 una en el mismo mom ento musical, ni siquiera usando la instrucción
3137 @code{\tweak}.
3138