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