1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: f0978ed121192fee9bdf2453a325d98693148acf
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Cambiar los valores por omisión
14 @chapter Cambiar los valores por omisión
15 @translationof Changing defaults
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.
28 @cindex Referencia de funcionamiento interno
30 La descripción definitiva de los controles que están disponibles para
31 su ajuste fino están en un documento aparte: la
32 @rinternalsnamed{Top,Referencia de funcionamiento interno}.
33 Dicho manual relaciona todas
34 las variables, funciones y opciones que se encuentran disponibles en
35 LilyPond. Está escrito como un documento HTML, que se puede encontrar
36 @c leave the @uref as one long line.
37 @uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,en línea},
38 pero que también va incluido en el paquete de la documentación de LilyPond.
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 @file{.ly} con
45 el símbolo de cuadradillo@tie{}@code{#}.@footnote{@rextend{Tutorial de Scheme}
46 contiene un breve tutorial sobre la introducción de números,
47 listas, cadenas y símbolos en Scheme.}
50 * Contextos de interpretación::
51 * Explicación del Manual de referencia de funcionamiento interno::
52 * Modificar las propiedades::
53 * Conceptos y propiedades útiles::
55 * Uso de las funciones musicales::
59 @node Contextos de interpretación
60 @section Contextos de interpretación
61 @translationof Interpretation contexts
63 Esta sección explica qué son los contextos y cómo modificarlos.
66 * Explicación de los contextos::
68 * Mantener vivos los contextos::
69 * Modificar los complementos (plug-ins) de contexto::
70 * Cambiar los valores por omisión de los contextos::
71 * Definir contextos nuevos::
72 * Alinear los contextos::
77 Manual de aprendizaje:
78 @rlearning{Contextos y grabadores}.
81 @file{ly/engraver-init.ly},
82 @file{ly/performer-init.ly}.
85 @rlsr{Contexts and engravers}.
87 Referencia de funcionamiento interno:
88 @rinternals{Contexts},
89 @rinternals{Engravers and Performers}.
92 @node Explicación de los contextos
93 @subsection Explicación de los contextos
94 @translationof Contexts explained
96 Los contextos se disponen de forma jerárquica:
99 * Score. El contexto maestro::
100 * Contextos del nivel superior. Contenedores de pentagramas::
101 * Contextos de nivel intermedio. Pentagramas::
102 * Contextos del nivel más bajo. Voces::
105 @node Score. El contexto maestro
106 @unnumberedsubsubsec Score. El contexto maestro
107 @translationof Score - the master of all contexts
109 Este es el contexto de notación del nivel más alto. Ningún otro
110 contexto puede contener a un contexto Score. De forma predeterminada,
111 el contexto Score maneja la administración de las indicaciones de
112 compás y se asegura de que ciertos elementos como claves, compases y
113 armaduras están siempre alineados entre los distintos pentagramas.
115 Se crea implícitamente una instancia del contexto Score cuando se
116 procesa un bloque @code{\score @{@dots{}@}} o @code{\layout
119 @node Contextos del nivel superior. Contenedores de pentagramas
120 @unnumberedsubsubsec Contextos del nivel superior: contenedores de pentagramas
121 @translationof Top-level contexts - staff containers
123 @strong{@emph{StaffGroup}}
125 Agrupa pentagramas y añade un corchete en la parte izquierda, formando
126 un grupo. Las líneas divisorias de los pentagramas contenidos se
127 conectan verticalmente. @code{StaffGroup} sólo consiste en una
128 colección de pentagramas, con un corchete delante y líneas divisorias
131 @strong{@emph{ChoirStaff}}
133 Idéntico a @code{StaffGroup} excepto que las barras de compás de los
134 pentagramas contenidos no se conectan verticalmente.
136 @strong{@emph{GrandStaff}}
138 Un grupo de pentagramas, con una llave en la parte izquierda que
139 abarca el grupo. Las barras de compás de los pentagramas contenidos
140 se conectan verticalmente.
142 @strong{@emph{PianoStaff}}
144 Igual que @code{GrandStaff}, pero contempla la posibilidad de poner el
145 nombre del instrumento a la izquierda del sistema.
147 @node Contextos de nivel intermedio. Pentagramas
148 @unnumberedsubsubsec Contextos de nivel intermedio. Pentagramas
149 @translationof Intermediate-level contexts - staves
151 @strong{@emph{Staff}}
153 Maneja claves, barras de compás, tonalidades y alteraciones
154 accidentales. Puede contener contextos de @code{Voice}.
156 @strong{@emph{RhythmicStaff}}
158 Como @code{Staff}, pero para imprimir ritmos. Se ignoran las alturas
159 de las notas; las notas se imprimen sobre una línea.
161 @strong{@emph{TabStaff}}
163 Contexto para generar tablaturas. De forma predeterminada dispone la
164 expresión musical como una tablatura de guitarra, impresa sobre seis
167 @strong{@emph{DrumStaff}}
169 Maneja el tipografiado para instrumentos de percusión. Puede contener
170 contextos @code{DrumVoice}.
172 @strong{@emph{VaticanaStaff}}
174 Igual que @code{Staff}, excepto que está pensado para tipografiar
175 piezas en estilo gregoriano.
177 @strong{@emph{MensuralStaff}}
179 Igual que @code{Staff}, excepto que está diseñado para tipografiar
180 piezas en estilo mensural.
183 @node Contextos del nivel más bajo. Voces
184 @unnumberedsubsubsec Contextos del nivel más bajo. Voces
185 @translationof Bottom-level contexts - voices
187 Los contextos del mismo nivel que Voice dan un valor inicial a ciertas
188 propiedades e inician los grabadores correspondientes. Siendo
189 contextos del nivel más bajo, no pueden contener a otros contextos.
191 @strong{@emph{Voice}}
193 Corresponde a una voz sobre un pentagrama. este contexto maneja la
194 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
195 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
196 que crear instancias explícitas de este contexto si necesitamos varias
197 voces en el mismo pentagrama.
199 @strong{@emph{VaticanaVoice}}
201 Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
202 piezas en estilo gregoriano.
204 @strong{@emph{MensuralVoice}}
206 Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
207 piezas en estilo mensural.
209 @strong{@emph{Lyrics}}
211 Corresponde a una voz con letra. Maneja la impresión de una sola
214 @strong{@emph{DrumVoice}}
216 El contexto de voz utilizado en una pauta de percusión.
218 @strong{@emph{FiguredBass}}
220 El contexto en que los objetos @code{BassFigure} se crean a partir de
221 la entrada escrita en el modo @code{\figuremode}.
223 @strong{@emph{TabVoice}}
225 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
226 Se suele dejar que se cree implícitamente.
228 @strong{@emph{CueVoice}}
230 El contexto de voz que se utiliza para dibujar notas de tamaño
231 reducido, con el principal objetivo de añadir notas guía de un
232 pentagrama a otro, véase @ref{Formateo de las notas guía}.
233 Normalmente se deja que se cree implícitamente.
235 @strong{@emph{ChordNames}}
237 Tipografía nombres de acordes.
240 @node Crear contextos
241 @subsection Crear contextos
242 @translationof Creating contexts
244 @c TODO more complete descriptions rather than learning style
246 Para partituras que sólo tienen una voz y un pentagrama, los contextos
247 se crean automáticamente. Para partituras más complejas, es necesario
248 crearlos a mano. Existen tres instrucciones que hacen esto.
253 La instrucción más fácil es @code{\new}, y es también la más rápida de
254 escribir. Se antepone a una expresión musical, por ejemplo
257 @cindex nuevos, contextos
258 @cindex Contexto, creación de
261 \new @var{tipo} @var{expresión_musical}
265 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
266 @code{Voice}). Esta instrucción crea un contexto nuevo, y empieza a
267 interpretar la @var{expresión_musical} con él.
269 Una aplicación práctica de @code{\new} es una partitura con muchos
270 pentagramas. Cada parte que debe ir en su propio pentagrama, va
271 precedida de @code{\new Staff}.
273 @lilypond[quote,verbatim,relative=2,ragged-right]
280 La instrucción @code{\new} puede también dar nombre al contexto,
283 \new @var{tipo} = @var{identificador} @var{música}
285 Sin embargo, este nombre especificado por el usuario sólo se utiliza
286 si no hay ya otro contexto anterior con el mismo nombre.
292 Como @code{\new}, la instrucción @code{\context} también dirige una
293 expresión musical a un objeto de contexto, pero da al contexto un
294 nombre explícito. La sintaxis es
297 \context @var{tipo} = @var{identificador} @var{música}
300 En esta forma, la instrucción buscará un contexto existente del
301 @var{tipo} especificado que tenga el nombre @var{identificador}. Si
302 ese contexto aún no existe, se crea un contexto nuevo con el nombre
303 especificado. Esto es útil si nos vamos a referir más tarde al
304 contexto. Por ejemplo, cuando se escribe la letra, la melodía está
305 dentro de un contexto con nombre
308 \context Voice = "@b{tenor}" @var{música}
312 de forma que los textos se puedan alinear correctamente con sus notas,
315 \new Lyrics \lyricsto "@b{tenor}" @var{letra}
320 Otro uso posible de los contextos con nombre es la fusión de dos
321 expresiones musicales distintas en un solo contexto. En el siguiente
322 ejemplo, se introducen por separado las articulaciones y las notas:
326 decoracion = @{ s4-. s4-> @}
329 se combinan enviando los dos al mismo contexto @code{Voice},
333 \new Staff \context Voice = "A" \musica
334 \context Voice = "A" \decoracion
337 @lilypond[quote,ragged-right]
341 \new Staff \context Voice = "A" \music
342 \context Voice = "A" \arts
346 Con este mecanismo, es posible definir un @qq{urtext} (una edición
347 original), con la posibilidad de poner articulaciones distintas sobre
350 @cindex crear contextos
353 La tercera instrucción para crear contextos es
355 \context @var{tipo} @var{música}
360 Esto es similar a @code{\context} con @code{= @var{identificador}},
361 pero se corresponde con cualquier contexto del tipo @var{tipo}, sin
362 importar qué nombre se le ha dado.
364 Esta variante se usa con expresiones musicales que se pueden
365 interpretar en varios niveles. Por ejemplo, la instrucción
366 @code{\applyOutput} (véase
367 @rextend{Ejecutar una función sobre todos los objetos de la presentación}).
368 Sin una instrucción @code{\context}
369 explícita, normalmente se aplicaría a @code{Voice}
372 \applyOutput #'@var{contexto} #@var{función} % aplicar al contexto Voice
375 Para que se interprete dentro de los niveles de @code{Score} o
376 @code{Staff}, utilice las siguientes formas:
379 \applyOutput #'Score #@var{función}
380 \applyOutput #'Staff #@var{función}
385 @node Mantener vivos los contextos
386 @subsection Mantener vivos los contextos
387 @translationof Keeping contexts alive
389 @cindex contextos, mantener vivos
390 @cindex contextos, tiempo de vida
392 Normalmente los contextos finalizan en el primer momento musical en
393 que no tienen nada que hacer. Así, los contextos de @code{Voice}
394 mueren tan pronto como ya no contienen ningún evento; los contextos de
395 @code{Staff} mueren tan pronto como todos los contextos de
396 @code{Voice} que contenían ya no contengan ningún evento; etc. Esto
397 puede ocasionar dificultades si se tiene que hacer referencia a
398 contextos anteriores que ya han muerto, por ejemplo, al cambiar de
399 pentagramas con instrucciones @code{\change}, asociar letra con una
400 voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
401 eventos musicales adicionales a un contexto anterior.
403 Existe una excepción a esta regla general: precisamente uno de los
404 contextos de @code{Voice} que están dentro de un contexto de
405 @code{Staff} o de una construcción @code{<<...>>} persiste siempre
406 hasta el final de, contexto de @code{Staff} circundante o la
407 construcción @code{<<...>>}, incluso aunque puede haber períodos en
408 que no tiene nada que hacer. El contexto que persiste de esta forma
409 será el primero que se encuentre en la primera construcción encerrada
410 entre llaves @code{@{...@}}, ignorando cualquiera que se encuentre
411 dentro de construcciones encerradas por ángulos dobles @code{<<...>>}.
413 Cualquier contexto se puede mantener vivo si nos aseguramos de que
414 tiene algo que hacer en cualquier momento musical dado. Los
415 contextos de @code{Staff} se mantienen con vida si nos aseguramos de
416 que una de sus voces se mantiene viva. Una manera de hacerlo es
417 añadir silencios de separación a una voz en paralelo con la música
418 real. Éstos deben añadirse a todos y cada uno de los contextos de
419 @code{Voice} que se hayan de mantener vivos. Si se van a usar
420 esporádicamente varias voces, es más seguro mantenerlas todas vivas en
421 lugar de tratar de confiar en las excepciones que hemos mencionado
424 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
425 vivas de esta manera durante la duración de la pieza:
427 @lilypond[quote,verbatim]
428 musicA = \relative c'' { d4 d d d }
429 musicB = \relative c'' { g4 g g g }
432 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
433 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
438 \context Voice = "A" {
442 \context Voice = "B" {
446 \context Voice = "A" { \musicA }
447 \context Voice = "B" { \musicB }
448 \context Voice = "A" { \musicA }
459 @cindex letra, alineación con melodía esporádica
461 El ejemplo siguiente muestra cómo se puede escribir una línea melódica
462 esporádica con letra utilizando este enfoque. Por supuesto, en una
463 situación real la melodía y el acompañamiento consistirían en varias
464 secciones diferentes.
466 @lilypond[quote,verbatim]
467 melody = \relative c'' { a4 a a a }
468 accompaniment = \relative c' { d4 d d d }
469 words = \lyricmode { These words fol -- low the mel -- o -- dy }
472 \new Staff = "music" {
474 \new Voice = "melody" {
476 s1*4 % Keep Voice "melody" alive for 4 bars
479 \new Voice = "accompaniment" {
484 \context Voice = "melody" { \melody }
485 \context Voice = "accompaniment" { \accompaniment }
487 \context Voice = "accompaniment" { \accompaniment }
489 \context Voice = "melody" { \melody }
490 \context Voice = "accompaniment" { \accompaniment }
495 \new Lyrics \with { alignAboveContext = #"music" }
496 \lyricsto "melody" { \words }
501 Una forma alternativa, que podría resultar mejor en muchas
502 situaciones, es mantener con vida la línea melódica simplemente
503 incluyendo notas espaciadoras para alinearla correctamente con el
506 @lilypond[quote,verbatim]
507 melody = \relative c'' {
513 accompaniment = \relative c' {
519 words = \lyricmode { These words fol -- low the mel -- o -- dy }
523 \new Staff = "music" {
525 \new Voice = "melody" {
529 \new Voice = "accompaniment" {
535 \new Lyrics \with { alignAboveContext = #"music" }
536 \lyricsto "melody" { \words }
542 @node Modificar los complementos (plug-ins) de contexto
543 @subsection Modificar los complementos (plug-ins) de contexto
544 @translationof Modifying context plug-ins
546 @c TODO Should this be Modifying engravers or Modifying contexts?
548 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
549 almacenan propiedades, también contienen «plug-ins» o complementos
550 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
551 el contexto @code{Voice} contiene un grabador
552 @code{Note_heads_engraver} que crea las cabezas de nota y el contexto
553 @code{Staff} contiene un grabador @code{Key_signature_engraver} que
554 crea la indicación de compás.
556 Para ver una descripción completa de todos y cada uno de los
557 complementos, consulte
559 @rinternals{Engravers and Performers}.
562 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
564 Cada contexto que se describe en
566 @rinternals{Contexts}
569 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
571 relaciona los grabadores que se usan para ese contexto.
574 Puede ser de utilidad jugar un poco con estos complementos. Se hace
575 iniciando un contexto nuevo con @code{\new} o @code{\context} y
581 \new @var{contexto} \with @{
594 donde los @dots{} deben ser el nombre de un grabador. Aquí tenemos un
595 ejemplo sencillo que suprime los grabadores
596 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
599 @lilypond[quote,relative=1,verbatim]
605 \remove "Time_signature_engraver"
606 \remove "Clef_engraver"
613 En el segundo pentagrama no hay indicación de compás ni clave. Éste
614 es un método bastante rudimentario de hacer que desaparezcan los
615 objetos porque afecta a todo el pentagrama. Este método también
616 afecta al espaciado, lo que puede ser deseable o no serlo. Se
617 muestran métodos más sofisticados para quitar objetos en
618 @rlearning{Visibilidad y color de los objetos}.
620 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
621 líneas divisorias y las indicaciones de compás están sincronizadas a
622 lo largo de toda la partitura. Lo hacen los grabadores
623 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
624 complementos mantienen al día la administración de las indicaciones de
625 compás, posición dentro del compás, etc. Moviendo estos grabadores
626 desde el contexto de @code{Score} al de @code{Staff}, podemos
627 conseguir una partitura en la que cada pentagrama tiene su propio
628 compás independiente.
630 @cindex polimétricas, partituras
631 @cindex compases distintos al mismo tiempo
633 @lilypond[quote,verbatim]
637 \consists "Timing_translator"
638 \consists "Default_bar_line_engraver"
644 \consists "Timing_translator"
645 \consists "Default_bar_line_engraver"
654 \remove "Timing_translator"
655 \remove "Default_bar_line_engraver"
663 Normalmente, el orden en que se especifican los grabadores no tiene
664 importancia, pero en algunos casos especiales sí la tiene, por ejemplo
665 donde un grabador escribe una propiedad y otro la lee, o donde un
666 grabador crea un groby otro debe procesarlo. El orden en que los
667 grabadores se especifican es el orden en que se llaman para realizar
668 su tarea de procesamiento.
670 Las siguientes ordenaciones son importantes: el grabador de compases
671 @code{Bar_engraver} debe ir normalmente en primer lugar, y el grabador
672 de digitaciones @code{New_fingering_engraver} debe ir antes del
673 grabador @code{Script_column_engraver} de columnas de inscripciones.
674 Podría haber otros que tengan dependencias de ordenación.
676 @node Cambiar los valores por omisión de los contextos
677 @subsection Cambiar los valores por omisión de los contextos
678 @translationof Changing context default settings
680 Los ajustes de contexto que están preparados para usarse de forma
681 predeterminada en los contextos @code{Score}, @code{Staff} y
682 @code{Voice}, se pueden especificar dentro de un bloque
683 @code{\layout}, como se ilustra en el ejemplo siguiente. El bloque
684 @code{\layout} se debe colocar dentro del bloque @code{\score} en que
685 se quiere que haga efecto, pero fuera de la música.
687 Observe que la propia instrucción @code{\set} y el contexto se deben
688 omitir cuando se especifican de esta manera los valores de contexto
691 @lilypond[quote,verbatim]
694 a4^"Really small, thicker stems, no time signature" a a a
701 \override Stem #'thickness = #4.0
702 \remove "Time_signature_engraver"
708 En este ejemplo, la instrucción @code{\Staff} especifica que los
709 ajustes siguientes se apliquen a todos los pentagramas dentro del
712 Se pueden realizar de forma similar modificaciones al contexto
713 @code{Score} o a todos los contextos @code{Voice}.
717 No es posible recolectar cambios de contexto dentro de una variable y
718 aplicarlos a una definición de @code{\context} por referencia a dicha
721 La instrucción @code{\RemoveEmptyStaves} sobreescribe nuestros ajustes
722 en curso para el contexto @code{\Staff}. Si queremos cambiar los
723 valores predeterminados para un pentagrama que utilice
724 @code{\RemoveEmptyStaves}, debemos hacerlo después de llamar a
725 @code{\RemoveEmptyStaves}, o sea
730 \Staff \RemoveEmptyStaves
732 \override Stem #'thickness = #4.0
737 @c TODO: add \with in here.
741 @node Definir contextos nuevos
742 @subsection Definir contextos nuevos
743 @translationof Defining new contexts
745 @cindex contextos, definición de nuevos
746 @cindex grabadores, incluir en contextos
761 Los contextos específicos, como @code{Staff} y @code{Voice}, están
762 construidos a base de bloques sencillos. Es posible crear nuevos
763 tipos de contextos con combinaciones distintas de añadidos grabadores.
765 El siguiente ejemplo muestra cómo construir un tipo diferente de
766 contexto de @code{Voice} partiendo de cero. Será parecido a
767 @code{Voice}, pero imprime solamente cabezas centradas en forma de
768 barra inclinada. Se puede usar para indicar improvisación en piezas
772 @lilypond[quote,ragged-right]
775 \type "Engraver_group"
776 \consists "Note_heads_engraver"
777 \consists "Rhythmic_column_engraver"
778 \consists "Text_engraver"
779 \consists Pitch_squash_engraver
780 squashedPosition = #0
781 \override NoteHead #'style = #'slash
782 \override Stem #'transparent = ##t
783 \override Flag #'transparent = ##t
787 \accepts "ImproVoice"
791 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
792 c4 c^"desvístete" c_"mientras tocas :)" c }
798 Estos ajustes se definen dentro de un bloque @code{\context} que a su
799 vez está dentro de un bloque @code{\layout},
809 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
810 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
812 En primer lugar es necesario definir un nombre para el nuevo contexto:
818 Debido a que es parecido al contexto @code{Voice}, queremos órdenes
819 que funcionen sobre contextos de @code{Voice} (existentes) para que
820 siga funcionando. Esto se consigue dando al contexto nuevo un alias
827 El contexto imprimirá notas y textos explicativos, por ello tenemos
828 que añadir los grabadores que aportan esta funcionalidad:
831 \consists Note_heads_engraver
832 \consists Text_engraver
835 pero sólo necesitamos esto en la línea central:
838 \consists Pitch_squash_engraver
839 squashedPosition = #0
842 El grabador @rinternals{Pitch_squash_engraver} modifica las cabezas de
843 nota (creadas por el grabador @rinternals{Note_heads_engraver}) y
844 establece sus posiciones verticales al valor de
845 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea central.
847 Las notas parecen barras inclinadas y no tienen plica:
850 \override NoteHead #'style = #'slash
851 \override Stem #'transparent = ##t
852 \override Flag #'transparent = ##t
855 Todos estos añadidos tienen que cooperar, y esto se consigue con un
856 añadido especial, que se debe marcar con la palabra clave
857 @code{\type}. Este será siempre @code{Engraver_group},
860 \type "Engraver_group"
863 Al juntarlo todo, obtenemos
868 \type "Engraver_group"
869 \consists "Note_heads_engraver"
870 \consists "Text_engraver"
871 \consists Pitch_squash_engraver
872 squashedPosition = #0
873 \override NoteHead #'style = #'slash
874 \override Stem #'transparent = ##t
875 \override Flag #'transparent = ##t
881 Los contextos dan lugar a jerarquías. Queremos colgar el contexto
882 @code{ImproVoice} bajo el contexto @code{Staff}, como simples
883 @code{Voice}s normales. Por tanto, modificamos la definición de
884 @code{Staff} con la instrucción @code{\accepts} (acepta),
894 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
895 que a veces se necesita cuando se están reutilizando definiciones de
898 Ponemos ambos dentro de un bloque @code{\layout}, como
908 \accepts "ImproVoice"
913 Así pues, la salida que aparece al comienzo de esta sub-sección se
922 c c_"mientras tocas :)"
929 @node Alinear los contextos
930 @subsection Alinear los contextos
931 @translationof Aligning contexts
933 Los contextos nuevos se pueden alinear por encima o por debajo de
934 otros contextos existentes. Esto podría ser de utilidad al preparar
935 un pentagrama vocal (@rlearning{Conjuntos vocales}) y en el ossia,
938 @funindex alignAboveContext
939 @funindex alignBelowContext
941 @lilypond[quote,ragged-right]
944 \relative c' \new Staff = "main" {
947 \new Staff \with { alignAboveContext = #"main" } \ossia
954 @cindex nested contexts
955 @cindex contexts, nested
960 Los contextos como @code{PianoStaff} pueden llevar dentro otros
961 contextos anidados. Los contextos que se pueden aceptar para su
962 anidamiento están definidos por la lista @qq{accepts} (acepta) de un
963 contexto. Los contextos que no están en esta lista se colocan debajo
964 del contexto exterior en la partitura impresa. Por ejemplo, el
965 contexto @code{PianoStaff} está definido para que acepte contextos
966 @code{Staff} y @code{FiguredBass} de forma predeterminada, pero no un
967 contexto @code{Lyrics}, por ejemplo. Así pues, en la siguiente
968 estructura la letra se sitúa debajo del sistema de piano en lugar de
969 colocarse entre los dos pentagramas:
971 @lilypond[verbatim,quote,relative=1]
974 \new Staff { e4 d c2 }
975 \addlyrics { Three blind mice }
983 La lista @qq{accepts} de un contexto se puede modificar para que
984 incluya contextos anidados adicionales, y así si quisiéramos que la
985 letra apareciese entre los dos pentagramas podríamos usar:
987 @lilypond[verbatim,quote,relative=1]
988 \new PianoStaff \with { \accepts Lyrics }
990 \new Staff { e4 d c2 }
991 \addlyrics { Three blind mice }
999 Lo contrario de @code{\accepts} (acepta) es @code{\denies} (deniega);
1000 esto suprime un contexto de la lista @qq{accepts}.
1003 @node Explicación del Manual de referencia de funcionamiento interno
1004 @section Explicación del Manual de referencia de funcionamiento interno
1005 @translationof Explaining the Internals Reference
1009 * Navegar por la referencia del programa::
1010 * Interfaces de la presentación::
1011 * Determinar la propiedad del grob::
1012 * Convenciones de nombres::
1017 @node Navegar por la referencia del programa
1018 @subsection Navegar por la referencia del programa
1019 @translationof Navigating the program reference
1021 Supongamos que queremos mover la indicación de digitación del
1022 fragmento siguiente:
1024 @lilypond[quote,relative=2,verbatim]
1030 Si hace una visita a la documentación en busca de instrucciones de
1031 digitación (en @ref{Indicaciones de digitación}), encontrará:
1034 @strong{Véase también}
1036 Referencia de funcionamiento interno: @rinternals{Fingering}.
1041 La referencia del programador se encuentra disponible en forma de
1042 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
1043 en línea o bien descargando los archivos de la documentación HTML.
1044 Esta sección sería mucho más difícil de entender si está utilizando el
1045 manual en formato PDF.
1048 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
1052 Los objetos de digitación se crean por parte de:
1053 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1056 Siguiendo los enlaces relacionados dentro de la referencia del
1057 programa, podemos seguir el flujo de información dentro del programa:
1061 @item @rinternals{Fingering}:
1062 los objetos @rinternals{Fingering} se crean por parte de:
1063 @rinternals{Fingering_engraver}
1065 @item @rinternals{Fingering_engraver}:
1066 Tipos de música aceptados: @rinternals{fingering-event}
1068 @item @rinternals{fingering-event}:
1069 El tipo de evento musical @code{fingering-event} está descrito en
1070 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1073 Este camino se recorre en contra de la corriente de información del
1074 programa: comienza por la salida y acaba en el evento de entrada.
1075 También podríamos haber empezado por un evento de la entrada, y leído
1076 siguiendo el flujo de información terminando en su caso en el objeto
1077 (u objetos) de la salida.
1079 La referencia del programa también se puede examinar como un documento
1080 normal. Contiene capítulos que tratan de
1082 @rinternals{Music definitions},
1085 @code{Music definitions}
1087 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1088 de los capítulos relaciona todas las definiciones utilizadas y todas
1089 las propiedades que se pueden ajustar.
1092 @node Interfaces de la presentación
1093 @subsection Interfaces de la presentación
1094 @translationof Layout interfaces
1096 @cindex interfaz de la presentación
1097 @cindex presentación, interfaz de la
1100 La página HTML que pudimos ver en la sección anterior describe el
1101 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1102 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1103 números (como grosores y direcciones), pero también punteros a objetos
1104 relacionados. Un objeto de presentación también se llama un
1105 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1106 gráfico). Para ver más detalles acerca de los objetos gráficos o
1107 Grobs, consulte @rinternals{grob-interface}.
1109 La página dedicada a @code{Fingering} relaciona las definiciones del
1110 objeto @code{Fingering}. Por ejemplo, la página dice
1113 @code{padding} (dimensión, en espacios de pentagrama):
1119 lo que significa que el número se mantendrá a una distancia de al
1120 menos 0.5 de la cabeza de la nota.
1123 Cada objeto de presentación puede tener varias funciones como elemento
1124 notacional o tipográfico. Por ejemplo, el objeto de digitación
1125 Fingering tiene los siguientes aspectos
1129 Su tamaño es independiente del espaciado horizontal, al contrario de
1130 las ligaduras o las barras de las figuras.
1133 Es un elemento de texto. Casi seguro que es un texto muy corto.
1136 este elemento de texto se tipografía con un tipo de letra, no como las
1137 ligaduras o las barras de las figuras.
1140 Horizontalmente, el centro del símbolo se debe alinear con el centro
1141 de la cabeza de la nota.
1144 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1147 La posición vertical también está coordinada con otros símbolos de
1148 superíndice y de subíndice.
1151 Cada uno de estos aspectos se capta en lo que se llaman
1152 @emph{interface}s, que se relacionan al final de la página dedicada a
1153 @rinternals{Fingering}
1156 Este objeto contempla los siguientes interfaces:
1157 @rinternals{item-interface},
1158 @rinternals{self-alignment-interface},
1159 @rinternals{side-position-interface}, @rinternals{text-interface},
1160 @rinternals{text-script-interface}, @rinternals{font-interface},
1161 @rinternals{finger-interface} y @rinternals{grob-interface}.
1164 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1165 página del respectivo interfaz del objeto. Cada interfaz tiene un
1166 cierto número de propiedades. Algunas de ellas no son para que el
1167 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1170 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1171 realmente esto no significa mucho. El archivo de inicialización
1172 (véase @rlearning{Otras fuentes de información})
1173 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1178 (avoid-slur . around)
1179 (slur-padding . 0.2)
1180 (staff-padding . 0.5)
1181 (self-alignment-X . 0)
1182 (self-alignment-Y . 0)
1183 (script-priority . 100)
1184 (stencil . ,ly:text-interface::print)
1185 (direction . ,ly:script-interface::calc-direction)
1186 (font-encoding . fetaText)
1187 (font-size . -5) ; don't overlap when next to heads.
1188 (meta . ((class . Item)
1189 (interfaces . (finger-interface
1191 text-script-interface
1193 side-position-interface
1194 self-alignment-interface
1195 item-interface))))))
1199 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1200 de valores de variables, y la página web de la Referencia de
1201 funcionamiento interno se genera directamente a partir de esta
1205 @node Determinar la propiedad del grob
1206 @subsection Determinar la propiedad del grob
1207 @translationof Determining the grob property
1209 Recordemos que queríamos cambiar la posición del @b{2} en
1211 @lilypond[quote,relative=2,verbatim]
1217 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1218 tenemos que negociar con el interfaz asociado con esta colocación.
1219 Esto se hace usando @code{side-position-interface}. La página que
1220 describe este interface dice:
1223 @code{side-position-interface}
1225 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1226 soporte). La propiedad @code{direction} significa dónde poner el
1227 objeto víctima con relación al soporte (¿a la izquierda o a la
1228 derecha, encima o debajo?)
1232 @cindex padding (relleno)
1234 Debajo de esta descripción, la variable @code{padding} (relleno) se
1240 (dimensión, en espacios de pentagrama)
1242 Añadir esta cantidad de espacio adicional entre objetos que están unos
1247 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1248 digitación de la cabeza de la nota. La siguiente orden inserta un
1249 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1252 \once \override Voice.Fingering #'padding = #3
1255 Al insertar esta instrucción antes de que se haya creado el objeto
1256 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1259 @lilypond[quote,relative=2,verbatim]
1260 \once \override Voice.Fingering #'padding = #3
1266 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1267 se puede deducir también a partir de la referencia del programa, ya
1268 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1271 El grabador Fingering_engraver es parte de los contextos: @dots{}
1276 @node Convenciones de nombres
1277 @subsection Convenciones de nombres
1278 @translationof Naming conventions
1280 Se hace necesario presentar una panorámica de las diversas
1281 convenciones de nomenclatura:
1284 @item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
1285 @item funciones de Scheme: ly:más-estilo-de-scheme
1286 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1287 @item interfaces de Grobs: estilo-scheme
1288 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1289 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1290 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1291 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1295 Preguntas aún sin respuesta
1297 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1298 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1302 @node Modificar las propiedades
1303 @section Modificar las propiedades
1304 @translationof Modifying properties
1307 * Panorámica de la modificación de las propiedades::
1308 * La instrucción set::
1309 * La instrucción override::
1310 * La instrucción tweak::
1311 * set frente a override::
1312 * Modificación de las listas-A::
1316 @node Panorámica de la modificación de las propiedades
1317 @subsection Panorámica de la modificación de las propiedades
1318 @translationof Overview of modifying properties
1320 Cada contexto es responsable de la creación de ciertos tipos de
1321 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1322 también se almacenan por contexto. Mediante la modificación de estos
1323 ajustes, se puede alterar la apariencia de los objetos.
1325 Existen dos tipos diferentes de propiedades almacenadas en los
1326 contextos: las propiedades de contexto y las propiedades de grob. Las
1327 prpopiedades de contexto son propiedades que se aplican al contexto
1328 como un todo y controlan la forma en que el propio contexto se
1329 imprime. Por contra, las propiedades de grob se aplican a los tipos
1330 de grob específicos que se imprimirán dentro del contexto.
1332 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar los
1333 valores de las propiedades de contexto. Las instrucciones
1334 @code{\override} y @code{\revert} se usan para cambiar los valores de
1335 las propiedades de grob.
1338 La sintaxis de esto es
1341 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1344 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1345 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1346 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1347 disposición}). Este último es un símbolo, y por ello debe ir
1348 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1349 explica cómo se deben cumplimentar los conceptos @var{nombre},
1350 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1351 funcionalidad des esta instrucción.
1356 \override Staff.Stem #'thickness = #4.0
1360 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1361 grosor de una línea del pentagrama como unidad). Puesto que la
1362 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1363 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1364 Aquí vemos la instrucción en pleno funcionamiento:
1366 @lilypond[quote,verbatim,relative=2]
1368 \override Staff.Stem #'thickness = #4.0
1374 La instrucción @code{\override} modifica la definición de la plica
1375 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1376 que la instrucción se ha interpretado, todas las plicas se engrosan.
1378 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1379 omitir, ocasionando que se utilice el contexto predeterminado
1380 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1381 solo paso de tiempo.
1383 @lilypond[quote,verbatim,relative=2]
1385 \once \override Stem #'thickness = #4.0
1390 El @code{\override} se debe hacer antes de que el objeto se inicia.
1391 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1392 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1393 en el momento en que se crea el objeto. En este ejemplo:
1395 @lilypond[quote,verbatim,relative=2]
1396 \override Slur #'thickness = #3.0
1398 \override Beam #'beam-thickness = #0.6
1403 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1404 la instrucción para @code{Beam}, la barra, va después de que la barra
1405 se ha iniciado, y por ello no tiene ningún efecto.
1407 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1408 un contexto deshace una instrucción @code{\override}; como con
1409 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1410 del mismo contexto. En otras palabras, el @code{\revert} del
1411 siguiente ejemplo no hace nada.
1414 \override Voice.Stem #'thickness = #4.0
1415 \revert Staff.Stem #'thickness
1418 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1419 dentro de las propiedades normales. Para trucarlas, utilice
1420 instrucciones de la forma
1422 @c leave this as a long long
1424 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1431 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1437 Referencia de funcionamiento interno:
1438 @rinternals{Backend},
1439 @rinternals{All layout objects},
1440 @rinternals{OverrideProperty},
1441 @rinternals{RevertProperty},
1442 @rinternals{PropertySet}.
1447 El «back-end» o motor de salida no es muy estricto en la comprobación
1448 de tipos de las propiedades de objetos. Las referencias cíclicas en
1449 valores Scheme de propiedades pueden producir cuelgues o salidas
1450 abruptas, o las dos cosas.
1453 @node La instrucción set
1454 @subsection La instrucción @code{@bs{}set}
1455 @translationof The set command
1459 @cindex cambiar propiedades
1461 Cada contexto puede tener distintas @emph{propiedades}, variables
1462 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1463 paso de interpretación. Se consigue insertando la instrucción
1464 @code{\set} dentro de la música:
1467 \set @var{contexto}.@var{propiedad} = #@var{valor}
1470 @var{valor} es un objeto de Scheme, razón por la que va precedido del
1471 carácter almohadilla,@tie{}@code{#}.
1473 El nombre de las propiedades de contexto suele ir en minúsculas con
1474 mayúscula en medio. Controlan sobre todo la traducción de la música a
1475 la notación, p.ej. @code{localKeySignature} (para determinar si hay
1476 que impriir alteraciones o no), o @code{measurePosition} (para
1477 determinar cuándo hay que imprimir una línea divisoria). El valor de
1478 las propiedades de contexto puede modifcarse con el tiempo durante la
1479 interpretación de la música; un ejemplo obvio es
1480 @code{measurePosition}. Las propiedades de contexto se modifican
1481 mediante la instrucción @code{\set}.
1483 Por ejemplo, los silencios multicompás se combinan en un solo compás
1484 si el valor de la propiedad de contexto @code{skipBars} se establece a
1485 @code{#t} (verdadero):
1487 @lilypond[quote,verbatim,relative=2]
1489 \set Score.skipBars = ##t
1493 Si se omite el argumento @var{context}, entonces se utiliza el
1494 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1495 @code{Voice} o @code{Lyrics}). En este ejemplo:
1497 @lilypond[quote,verbatim,relative=2]
1498 \set Score.autoBeaming = ##f
1502 \set autoBeaming = ##t
1510 El cambio se aplica @q{al vuelo}, mientras dura la música, de forma
1511 que el ajuste sólo afecta al segundo grupo de corcheas.
1513 Observe que el contexto del nivel más bajo no siempre contiene la
1514 propiedad que querríamos modificar: por ejemplo, intentar ajustar el
1515 valor de la propiedad @code{skipBars} del contexto predeterminado del
1516 nivel más bajo, que en este caso es @code{Voice}, no tendrá ningún
1517 efecto, porque skipBars es una propiedad del contexto @code{Score}.
1519 @lilypond[quote,verbatim,relative=2]
1525 Los contextos son jerárquicos, y si se ha especificado un contexto
1526 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1527 también a todos los contextos @code{Voice} dentro del pentagrama
1532 También existe una instrucción @code{\unset}:
1534 \unset @var{contexto}.@var{propiedad}
1538 que elimina la definición de @var{propiedad}. Esta instrucción
1539 elimina la definición solamente si está establecida dentro de
1540 @var{contexto}. Properties that have been set in enclosing contexts will
1541 not be altered by an unset in an enclosed context:
1543 @lilypond[quote,verbatim,relative=2]
1544 \set Score.autoBeaming = ##t
1549 \unset Score.autoBeaming
1557 Como @code{\set}, el argumento @var{contexto} no se tiene que
1558 especificar para un contexto del nivel más bajo, por lo que los dos
1562 \set Voice.autoBeaming = ##t
1563 \set autoBeaming = ##t
1567 son equivalentes si el contexto inferior en curso es @code{Voice}.
1571 Los ajustes que se aplican solamente a un único paso de tiempo se
1572 pueden escribir con @code{\once}, por ejemplo en
1574 @lilypond[quote,verbatim,relative=2]
1576 \once \set fontSize = #4.7
1581 En el manual de Referencia de funcionamiento interno hay una
1582 descripción completa de todas las propiedades de contexto disponibles,
1585 @rinternals{Tunable context properties}.
1588 Traducción @expansion{} Propiedades de contexto modificables por el
1594 Referencia de funcionamiento interno:
1595 @rinternals{Tunable context properties}.
1598 @cindex grob, propiedades de
1599 @cindex propiedades de grob
1602 @node La instrucción override
1603 @subsection La instrucción @code{\override}
1604 @translationof The override command
1606 Existe un tipo especial de propiedad de contexto: la descripción de
1607 los grobs. Las decscripciones de los grobs reciben un nombre en
1608 @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen los
1609 @q{ajustes predeterminados} para un tipo particular de grob, en forma
1610 de lista asociativa. Consulte @file{scm/define-grobs.scm} para
1611 ver los ajustes de cada descripción de grob. Las descripciones de
1612 grob se modifican con @code{\override}.
1614 @code{\override} es en realidad una forma abreviada;
1617 \override @var{contexto}.@var{NombreDelGrob} #'@var{propiedad} = #@var{valor}
1621 equivale más o menos a
1623 @c leave this long line -gp
1625 \set @var{contexto}.@var{NombreDelGrob} =
1626 #(cons (cons '@var{propiedad} @var{valor})
1627 <valor anterior de @var{contexto}.@var{NombreDelGrob}>)
1630 El valor de @code{contexto}.@code{NombreDelGrob} (la lista-A) se
1631 utiliza para inicializar las propiedades de los grobs individuales.
1632 Los grobs tienen propiedades, denominadas en el estilo de Scheme, con
1633 @code{palabras-con-guiones}. Los valores de las propiedades de grob
1634 cambian durante el proceso de formateo: éste se realiza básicamente
1635 calculando las propiedades utilizando funciones de @q{callback}
1636 (pasadas como parámetro).
1638 Por ejemplo, podemos aumentar el grosor de la plica de una figura
1639 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
1640 @code{Stem} (plica):
1642 @lilypond[quote,verbatim,relative=2]
1644 \override Voice.Stem #'thickness = #3.0
1648 Si no se ha especificado ningún contexto en la instrucción
1649 @code{\override}, se utiliza el contexto del nivel inferior:
1651 @lilypond[quote,verbatim,relative=2]
1652 { \override Staff.Stem #'thickness = #3.0
1656 \override Stem #'thickness = #0.5
1666 @cindex reversión de sobreescrituras
1667 @cindex sobreescrituras, reversión de
1669 El efecto de una instrucción de sobreescritura @code{\override} se
1670 puede deshacer con @code{\revert}:
1672 @lilypond[quote,verbatim,relative=2]
1674 \override Voice.Stem #'thickness = #3.0
1676 \revert Voice.Stem #'thickness
1680 Los efectos de @code{\override} y @code{\revert} se aplican a todos
1681 los grobs del contexto afectado partiendo del momento actual y hacia
1684 @lilypond[quote,verbatim,relative=2]
1689 \override Staff.Stem #'thickness = #3.0
1693 \revert Staff.Stem #'thickness
1701 @cindex sobreescritura para un solo momento
1703 Se puede usar @code{\once} con @code{\override} para afectar solamente
1704 al instante de tiempo actual:
1706 @lilypond[quote,verbatim,relative=2]
1710 \override Stem #'thickness = #3.0
1714 \once \override Stem #'thickness = #3.0
1723 Las instrucciones que modifican la salida tienen por lo general un
1727 \override Voice.Stem #'thickness = #3.0
1731 Para construir este truco debemos determinar los siguientes datos:
1734 @item el contexto: aquí @code{Voice}.
1735 @item el objeto de presentación: aquí @code{Stem}.
1736 @item la propiedad de presentación: aquí @code{thickness}.
1737 @item un valor adecuado: aquí @code{3.0}.
1740 Ciertas opciones ajustables se denominan @q{subpropiedades} y residen
1741 en el interior de las propiedades normales. Para modificarlas utilice
1742 instrucciones de la forma
1745 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1748 @cindex documentación interna
1749 @cindex buscar objetos gráficos
1750 @cindex gráficos, descripción de los objetos
1753 @cindex interna, documentación
1755 Para muchas propiedades, independientemente del tipo de datos de la
1756 propiedad, si se establece el valor de la propiedad a falso
1757 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
1758 ignore por completo dicha propiedad. Esto es especialmente útil para
1759 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
1760 causarían problemas.
1762 Mostraremos a continuación cómo localizar esta información en el
1763 manual de notación y en la referencia de funcionamiento interno.
1768 Referencia de funcionamiento interno:
1769 @rinternals{Backend}
1771 @node La instrucción tweak
1772 @subsection La instrucción @code{\tweak}
1773 @translationof The tweak command
1778 El cambio de las propiedades de grob mediante @code{\override} produce
1779 la aplicación del cambio a todos los grobs dados en el contexto en el
1780 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
1781 podemos desear que los cambios se apliquen a un solo grob en lugar de
1782 a todos los grobs del contexto afectado. Esto se consigue con la
1783 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
1786 \tweak #'@code{propiedad-del-grob} #@code{valor}
1789 La instrucción @code{\tweak} se aplica al objeto que viene
1790 inmediatamente después de @code{valor} dentro del flujo musical.
1793 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
1794 los objetos gráficos. Para objetos que resultan directamente de un
1795 elemento de código de la entrada, puede usar la función @code{\tweak},
1798 @lilypond[relative=2,verbatim,quote]
1803 \tweak #'duration-log #1
1806 -\tweak #'padding #8
1812 Pero el uso principal de la instrucción @code{\tweak} es modificar
1813 solamente uno de varios elementos de notación que dan comienzo en el
1814 mismo momento musical, como las notas de un acorde, o corchetes de
1815 tresillo que empiezan al mismo tiempo.
1817 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
1818 a continuación de forma directa, sin necesidad de especificar el
1819 nombre del grob o el contexto. Para que esto funcione, es necesario
1820 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
1821 al objeto al que se aplica, después de que el archivo de entrada se ha
1822 convertido en un flujo musical. Con frecuencia no es el caso, pues
1823 muchos elementos adicionales se insertan en la corriente musical de
1824 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
1825 parte de un acorde, LilyPond inserta implícitamente un evento
1826 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
1827 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
1828 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
1829 en el flujo musical, permaneciendo así adyacente a la nota, y con la
1830 posibilidad de modificarla.
1834 @lilypond[relative=2,verbatim,quote]
1835 <\tweak #'color #red c>4
1839 pero esto no funciona:
1841 @lilypond[relative=2,verbatim,quote]
1842 \tweak #'color #red c4
1847 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
1848 consulte @rlearning{Métodos de trucaje}.
1850 Si se colocan varios elementos similares en el mismo momento musical,
1851 la instrucción @code{\override} no se puede usar para modificar uno
1852 solo de ellos: aquí es donde se debe usar la instrucción
1853 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
1854 en el mismo momento musical están los siguientes:
1856 @c TODO expand to include any further uses of \tweak
1858 @item las cabezas de las notas de un acorde
1859 @item signos de articulación sobre la misma nota
1860 @item ligaduras de unión entre notas de un acorde
1861 @item corchetes de grupos especials que comienzan en el mismo momento
1864 @c TODO add examples of these
1866 @cindex acorde, modificación de una nota
1868 En este ejemplo se modifican el color de una cabeza y el tipo de otra,
1869 dentro del mismo acorde:
1871 @lilypond[relative=2,verbatim,quote]
1876 \tweak #'duration-log #1
1881 @code{\tweak} se puede usar para modificar ligaduras de expresión:
1883 @lilypond[verbatim,quote,relative=1]
1884 c-\tweak #'thickness #5 ( d e f)
1888 Para que funcione la instrucción @code{\tweak}, debe permanecer
1889 adyacente al objeto al que se ha de aplicar después de que el código
1890 de entrada se ha convertido a un flujo musical. A veces, LilyPond
1891 puede insertar elementos adicionales dentro del flujo de música
1892 durante el proceso de análisis sintáctico. Por ejemplo, cuando una
1893 nota que no es parte explícita de un acorde se coloca dentro de un
1894 acorde por parte de LilyPond de manera que las notas que se pretenden
1895 modificar con @code{\tweak} se deben poner dentro de una construcción
1898 @lilypond[relative=2,verbatim,quote]
1899 \tweak #'color #red c4
1900 <\tweak #'color #red c>4
1903 La instrucción @code{\tweak} no se puede usar para modificar ningún
1904 elemento que no aparezca explícitamente en el código de entrada.
1905 Concretamente, no se puede usar para modificar plicas, barras o
1906 alteraciones directamente, porque éstos se generan posteriormente por
1907 parte de las cabezas de las notas, más que por elementos musicales del
1908 flujo de entrada. Tampoco se puede usar @code{\tweak} para modificar
1909 las claves ni las indicaciones de compás, porque se separarán de
1910 cualquier instrucción @code{\tweak} que aparezca en el flujo de
1911 entrada debido a la inserción automática de los elementos adicionales
1912 que se requieren para especificar el contexto.
1914 También se pueden escribir varias instrucciones @code{\tweak} antes de
1915 un elemento notacional, y todas ellas le afectan:
1917 @lilypond[verbatim,quote,relative=1]
1919 -\tweak #'style #'dashed-line
1920 -\tweak #'dash-fraction #0.2
1921 -\tweak #'thickness #3
1922 -\tweak #'color #red
1927 El flujo musical que se genera a partir de una sección de un archivo
1928 de entrada (incluido cualquier elemento insertado automáticamente)
1929 puede examinarse, véase @rextend{Presentación de las expresiones musicales}.
1930 Esto puede ser de utilidad en la determinación de lo que
1931 puede modificarse por medio de una instrucción @code{\tweak}.
1935 Manual de aprendizaje:
1936 @rlearning{Métodos de trucaje}.
1938 Manual de extensión:
1939 @rextend{Presentación de las expresiones musicales}.
1944 @cindex trucos en una variable
1945 La instrucción @code{\tweak} no se puede usar dentro de una variable.
1947 @cindex trucos en la letra
1948 Las instrucciones @code{\tweak} no se pueden usar dentro del modo
1951 @cindex trucar puntos de control
1952 @cindex control, trucar puntos de
1954 La instrucción @code{\tweak} solamente se aplica a la primera de
1955 varias ligaduras generadas dentro de un acorde.
1957 @node set frente a override
1958 @subsection @code{\set} frente a @code{\override}
1959 @translationof set versus override
1961 @c HACER: probablemente esta sección es innecesaria.
1964 We have seen two methods of changing properties: @code{\set} and
1965 @code{\override}. There are actually two different kinds of
1968 @code{fontSize} is a special property: it is equivalent to
1969 entering @code{\override ... #'font-size} for all pertinent
1970 objects. Since this is a common change, the special
1971 property (modified with @code{\set}) was created.
1976 @node Modificación de las listas-A
1977 @subsection Modificación de las listas-A
1978 @translationof Modifying alists
1980 Ciertas propiedades configurables por parte del usuario se representan
1981 internamente como @emph{listas-A} (listas asociativas), que almacenan
1982 duplas de @emph{claves} y @emph{valores}. La estructura de una
1983 lista-A es la siguiente:
1986 '((@var{clave1} . @var{valor1})
1987 (@var{clave2} . @var{valor2})
1988 (@var{clave3} . @var{valor3})
1992 Si una lista-A es una propiedad de un grob o una variable de
1993 @code{\paper}, sus claves se pueden modificar individualmente sin que
1994 afecte a las otras claves.
1996 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
1997 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
1998 del grob @code{StaffGrouper}. La propiedad es una lista-A con cuatro
1999 claves: @code{basic-distance} (distancia básica),
2000 @code{minimum-distance} (distancia mínima), @code{padding} (relleno)
2001 y @code{stretchability} (ampliabilidad).
2002 Los ajustes estándar para esta propiedad
2003 se relacionan en la sección
2004 @qq{Backend} de la Referencia de Funcionamiento Interno
2005 (véase @rinternals{StaffGrouper}):
2008 '((basic-distance . 9)
2009 (minimum-distance . 7)
2011 (stretchability . 5))
2014 Una forma de acercar los pentagramas entre sí es reducir el valor de
2015 la clave @code{basic-distance} (@code{9}) para que se corresponda con el valor
2016 de @code{minimum-distance} (@code{7}). Para modificar una única clave
2017 de forma individual, utilice una @emph{declaración anidada}:
2019 @lilypond[quote,verbatim]
2020 % default space between staves
2022 \new Staff { \clef treble c''1 }
2023 \new Staff { \clef bass c1 }
2026 % reduced space between staves
2027 \new PianoStaff \with {
2028 % this is the nested declaration
2029 \override StaffGrouper #'staff-staff-spacing #'basic-distance = #7
2031 \new Staff { \clef treble c''1 }
2032 \new Staff { \clef bass c1 }
2036 La utilización de una declaración anidada actualiza la clave
2037 especificada (como @code{basic-distance} en el ejemplo anterior)
2039 de las otras claves que ya se habían establecido para la misma
2042 Ahora, supongamos que deseamos que los pentagramas estén tan próximos
2043 como sea posible sin que se superpongan. La manera más sencilla de
2044 hacerlo es establecer las cuatro claves de la lista-A a cero. Sin
2045 embargo, no es necesario escribir cuatro declaraciones anidadas,
2046 una por cada clave. En lugar de eso, se puede redefinir
2047 completamente la propiedad con una sola declaración, como una lista-A:
2049 @lilypond[quote,verbatim]
2050 \new PianoStaff \with {
2051 \override StaffGrouper #'staff-staff-spacing =
2052 #'((basic-distance . 0)
2053 (minimum-distance . 0)
2055 (stretchability . 0))
2057 \new Staff { \clef treble c''1 }
2058 \new Staff { \clef bass c1 }
2062 Observe que cualquier clave que no haya sido relacionada
2063 explícitamente en la definición de la lista-A, será reiniciada a sus
2064 valores @emph{predeterminados si no se han fijado}. En el caso de
2065 @code{staff-staff-spacing}, el valor de cualquier clave no fijada se
2066 reiniciaría a cero (excepto @code{stretchability}, que toma el valor
2067 de @code{basic-distance} si no se fija). Así, las dos declaraciones siguientes
2071 \override StaffGrouper #'staff-staff-spacing =
2072 #'((basic-distance . 7))
2074 \override StaffGrouper #'staff-staff-spacing =
2075 #'((basic-distance . 7)
2076 (minimum-distance . 0)
2078 (stretchability . 7))
2081 Una consecuencia de esto (posiblemente no intencionada) es la
2082 eliminación de cualquier valor estándar que
2083 se establezca en un archivo de inicio y que se carga cada vez que se
2084 compila un archivo de entrada. En el ejemplo anterior, los ajustes
2085 estándar para @code{padding} y
2086 @code{minimum-distance} (definidos en @file{scm/define-grobs.scm}) se
2087 reinician a sus valores predeterminados si no se han fijado (cero para
2088 las dos claves). La definición de una propiedad o variable como una
2089 lista-A (de cualquier tamaño) siempre reinicia todos los valores de
2090 clave no establecidos a sus valores predeterminados si no se han
2091 fijado. Ano ser que este sea el resultado deseado, es más seguro
2092 actualizar los valores de clave individualmente con una declaración
2095 @warning{Las declaraciones anidadas no funcionan para las listas-A de
2096 propiedades de contexto (como @code{beamExceptions},
2097 @code{keySignature}, @code{timeSignatureSettings}, etc.). Estas
2098 propiedades sólo se pueden modificar redefiniéndolas completamente
2102 @node Conceptos y propiedades útiles
2103 @section Conceptos y propiedades útiles
2104 @translationof Useful concepts and properties
2108 * Modos de entrada::
2109 * Dirección y posición::
2110 * Orden de disposición de los contextos::
2111 * Distancias y medidas::
2112 * Propiedades del símbolo del pentagrama::
2113 * Objetos de extensión::
2114 * Visibilidad de los objetos::
2115 * Estilos de línea::
2116 * Rotación de objetos::
2119 @node Modos de entrada
2120 @subsection Modos de entrada
2121 @translationof Input modes
2123 La forma en que se interpreta la notación contenida dentro de un
2124 archivo de entrada, está determinada por el modo de entrada en curso.
2126 @strong{Modo de acordes}
2128 Se activa con la instrucción @code{\chordmode} y produce que la
2129 entrada se interprete con al sintaxis de la notación de acordes, véase
2130 @ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
2133 El modo de acordes se activa también con la instrucción
2134 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
2135 y produce que el código que sigue se interprete con la sintaxis de la
2136 notación de acordes y se imprima como nombres de acorde dentro del
2137 contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
2139 @strong{Modo de percusión}
2141 Se activa con la instrucción @code{\drummode} y produce que el código
2142 de entrada se interprete con la sintaxis de la notación de percusión,
2143 véase @ref{Notación básica de percusión}.
2145 El modo de percusión también se activa con la instrucción
2146 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
2147 que el código que sigue se interprete con la sintaxis de la notación
2148 de percusión y se imprima como símbolos de percusión sobre un
2149 pentagrama de percusión, véase @ref{Notación básica de percusión}.
2151 @strong{Modo de cifras}
2153 Se activa con la instrucción @code{\figuremode} y hace que el código
2154 de entrada se interprete con la sintaxis del bajo cifrado, véase
2155 @ref{Introducir el bajo cifrado}.
2157 El modo de cifrase también se activa con la instrucción
2158 @code{\figures}. También crea un contexto de @code{FiguredBass} nuevo
2159 y hace que el código que viene a continuación se interprete con la
2160 sintaxis del bajo cifrado y se imprima como símbolos de bajo cifrado
2161 dentro del contexto @code{FiguredBass}, véase @ref{Introducción al bajo cifrado}.
2163 @strong{Modos de traste y tablatura}
2165 No existen modos de entrada especiales para introducir símbolos de
2166 trastes y de tablatura.
2168 Para crear diagramas de trastes, escriba las notas o acordes en el
2169 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2170 véase @ref{Tablaturas predeterminadas}.
2172 Para crear diagramas de trastes encima de un pentagrama, escríbalos
2173 como elementos de marcado encima de las notas utilizando la
2174 instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
2176 @strong{Modo de letra}
2178 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
2179 se interprete como sílabas de la letra de la canción con duraciones
2180 opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
2182 El modo de letra también se habilita con la instrucción
2183 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
2184 y una instrucción @code{\lyricsto} implícita que asocia la letra que
2185 viene a continuación con la música precedente.
2187 @strong{Modo de marcado}
2189 Se activa con la instrucción @code{\markup}, y hace que la entrada se
2190 interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
2192 @c silly work-around for texinfo broken-ness
2193 @c (@strong{Note...} causes a spurious cross-reference in Info)
2196 Es el modo predeterminado o se puede activar con la instrucción
2197 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
2198 marcado, etc. y se imprime como notación musical sobre un pentagrama.
2200 Normalmente no es necesario especificar el modo de notas de forma
2201 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2202 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2203 otro modo y queremos insertar algo que solamente se puede hacer con la
2204 sintaxis del modo de notas.
2206 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
2207 una pieza coral es necesario entrar en el modo de notas para poder
2208 interpretar dichas indicaciones:
2210 @lilypond[verbatim,relative=2,quote]
2213 \notemode{\set stanza = \markup{ \dynamic f 1. } }
2217 \notemode{\set stanza = \markup{ \dynamic p 2. } }
2224 @node Dirección y posición
2225 @subsection Dirección y posición
2226 @translationof Direction and placement
2228 Al tipografiar música, la dirección y colocación de muchos elementos
2229 es cuestión de elección. Por ejemplo, las plicas de las notas se
2230 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
2231 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
2232 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
2233 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
2234 LilyPond las determine automáticamente, pero en ciertos casos puede
2235 ser deseable forzar una dirección o colocación concreta.
2237 @strong{Acciones predeterminadas}
2239 De forma predeterminada algunas direcciones siempre son hacia arriba o
2240 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
2241 otras cosas pueden alternar entre arriba y abajo en función de la
2242 dirección de las plicas (como las ligaduras o los acentos).
2244 @c TODO Add table showing these
2246 Se puede sobreescribir la acción predeterminada mediante el prefijado
2247 de la articulación por un @emph{indicacor de dirección}. Están disponibles
2248 tres indicadores de dirección: @code{^} (que significa @qq{arriba}), @code{_}
2249 (que significa @qq{abajo}) o @code{-} (que significa @qq{usar la
2250 dirección predeterminada}). El indicador de dirección se puede normalmente
2251 omitir, en cuyo caso se supone el indicador predeterminado
2252 @code{-}, pero se necesita un indicador de dirección @strong{siempre}
2256 @item las instrucciones @code{\tweak}
2257 @item las instrucciones @code{\markup}
2258 @item las instrucciones @code{\tag}
2259 @item los marcados de cadena, p.ej. -"cadena"
2260 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2261 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2264 Estas indicaciones afectan sólo a la nota siguiente.
2266 @lilypond[verbatim,quote,relative=2]
2273 @strong{La propiedad de dirección}
2275 La posición o dirección de muchos objetos de presentación está
2276 controlada por la propiedad @code{direction}.
2278 El valor de la propiedad @code{direction} se puede establecer al valor
2279 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
2280 @w{@code{-1}}, con el significado de @qq{hacia abajo} o @qq{debajo}. Se
2281 pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
2282 @code{1} y @w{@code{-1}} respectivamente. La dirección predeterminada se
2283 puede especificar estableciendo @code{direction} a @code{0} ó a
2284 @code{CENTER}. De forma alternativa, en muchos casos existen
2285 instrucciones predefinidas para especificar la dirección. Todas ellas
2289 @code{\xxxUp}, @code{xxxDown}, @code{xxxNeutral}
2292 donde @code{xxxNeutral} significa @qq{utilizar la dirección
2293 predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
2295 En alguna que otra ocasión, con el único ejemplo usual del arpegio, el
2296 valor de la propiedad @code{direction} especifica si el objeto se debe
2297 colocar a la izquierda o a la derecha del objeto padre. En este caso
2298 @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y @code{1} ó
2299 @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
2300 significan @qq{utilizar la dirección predeterminada}, como antes.
2302 Estas indicaciones afectan a todas las notas hasta que son canceladas.
2304 @lilypond[verbatim,quote,relative=2]
2314 @node Orden de disposición de los contextos
2315 @subsection Orden de disposición de los contextos
2316 @translationof Context layout order
2318 @cindex contextos, orden de disposición
2320 Los contextos se disponen en un sistema normalmente desde arriba hacia
2321 abajo en el orden en que se encuentran en el archivo de entrada.
2322 Cuando los contextos se anidan unos dentro de otros, el contexto
2323 exterior incluye a los contextos anidados tal y como se especifica en
2324 el archivo de entrada, siempre y cuando los contextos interiores estén
2325 incluidos en la lista @qq{accepts} del contexto externo. Los
2326 contextos anidados que no está nincluidos en la lista @qq{accepts} del
2327 contexto externo se recolocan debajo del contexto externo en lugar de
2328 anidarse dentro de él.
2330 Observe que discretamente se crea un contexto de forma implícita si se
2331 encuentra una instrucción donde no hay un contexto apropiado para
2332 contenerlo. Esto puede dar lugar a pentagramas o partituras nuevos no
2335 El orden predeterminado en que los contextos se disponen, así como la
2336 lista @qq{accepts}, pueden cambiarse; véase @ref{Alinear los
2340 Manual de utilización del programa:
2341 @rprogram{Aparece un pentagrama de más}.
2343 @node Distancias y medidas
2344 @subsection Distancias y medidas
2345 @translationof Distances and measurements
2347 @cindex distancias absolutas
2348 @cindex distancias escaladas
2355 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
2357 Las distancias absolutas se usan para especificar márgenes, sangrados
2358 y otros detalles de diseño de página, y de forma predeterminada se
2359 especifican en milímetros. Las distancias se pueden especificar en
2360 otras unidades escribiendo después de la cifra indicativa de la
2361 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
2362 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
2363 de página se pueden especificar también en unidades escalables (véase
2364 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
2365 La disposición de página se describe en detalle en
2366 @ref{Disposición de la página}.
2368 Las distancias escaladas siempre se especifican en unidades de un
2369 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
2370 El espacio de pentagrama es la distancia entre dos líneas del
2371 pentagrama adyacentes. El valor predeterminado se puede cambiar
2372 globalmente fijando el tamaño global del pentagrama, o se puede
2373 sobreescribir localmente cambiando la propiedad @code{staff-space} del
2374 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
2375 automáticamente con cualquier cambio al tamaño global del pentagrama o
2376 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
2377 las fuentes tipográficas se escalan solamente con los cambios
2378 efectuados al tamaño global del pentagrama. Así, el tamaño global del
2379 pentagrama posibilita la fácil variación del tamaño general de una
2380 partitura impresa. Para ver los métodos de establecimiento del tamaño
2381 global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2385 Si se necesita dibujar sólo una sección de una partitura a una escala
2386 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2387 simplemente cambiar el tamaño global del pentagrama porque esto
2388 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2389 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2390 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2391 nuestra disposición una función de Scheme, @code{magstep}, para
2392 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2393 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2394 utilización, consulte @rlearning{Longitud y grosor de los objetos}.
2398 Manual de aprendizaje:
2399 @rlearning{Longitud y grosor de los objetos}.
2401 Referencia de la notación:
2402 @ref{Disposición de la página},
2403 @ref{Establecer el tamaño del pentagrama}.
2406 @node Propiedades del símbolo del pentagrama
2407 @subsection Propiedades del símbolo del pentagrama
2408 @translationof Staff symbol properties
2410 @cindex ajuste del símbolo del pentagrama
2411 @cindex dibujar el símbolo del pentagrama
2412 @cindex pentagrama, establecer el símbolo del
2414 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2415 @c Need to think of uses for these properties. Eg 'line-positions
2416 @c is used in a snippet to thicken centre line.
2417 @c If retained, add @ref to here in 1.6.2 -td
2419 Se puede definir al mismo tiempo la posición vertical de las líneas de
2420 la pauta y el número de líneas de la misma. Como muestra el siguiente
2421 ejemplo, las posiciones de las notas no están influidas por las
2422 posiciones de las líneas de la pauta.
2424 @warning{La propiedad @code{'line-positions} sobreescribe a la
2425 propiedad @code{'line-count}. El número de líneas de la pauta está
2426 definido implícitamente por el número de elementos de la lista de
2427 valores de @code{'line-positions}.}
2429 @lilypond[verbatim,quote,relative=1]
2431 \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
2436 Se puede modificar la anchura de la pauta. Las unidades son espacios
2437 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2438 resulta afectado por este ajuste.
2440 @lilypond[verbatim,quote,relative=1]
2442 \override StaffSymbol #'width = #23
2448 @node Objetos de extensión
2449 @subsection Objetos de extensión
2450 @translationof Spanners
2452 Muchos objetos de notación musical abarcan varias notas o incluso
2453 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2454 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2455 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2456 especiales para controlar su apariencia y comportamiento. Algunas de
2457 estas propiedades son comunes a todos los objetos de extensión; otras
2458 se limitan a un subconjunto de los extensores.
2460 Todos los objetos de extensión contemplan el interface
2461 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2462 una línea recta entre los dos objetos, contemplan también el interface
2463 @code{line-spanner-interface}.
2465 @unnumberedsubsubsec Uso del @code{spanner-interface}
2467 Este interface proporciona dos propiedades que se aplican a varios
2470 @strong{@i{La propiedad @code{minimum-length}}}
2472 La longitud mínima del objeto de extensión se especifica a través de
2473 la propiedad @code{minimum-length}. Su aumento suele producir el
2474 efecto necesario de aumentar el espaciado de las notas entre los dos
2475 puntos extremos. Sin embargo, esta sobreescritura no tiene ningún
2476 efecto sobre muchos extensores, pues su longitud está determinada por
2477 otras consideraciones. Más abajo se muestran algunos ejemplos de
2488 Works as long as callback is made:
2492 Works not at all for:
2501 @lilypond[verbatim,quote,relative=2]
2504 % increase the length of the tie
2505 -\tweak #'minimum-length #5
2509 @lilypond[verbatim,quote,relative=2]
2511 \compressFullBarRests
2513 % increase the length of the rest bar
2514 \once \override MultiMeasureRest #'minimum-length = #20
2519 @lilypond[verbatim,quote,relative=2]
2521 % increase the length of the hairpin
2522 \override Hairpin #'minimum-length = #20
2526 Esta sobreescritura se puede usar también para aumentar la longitud de
2527 las ligaduras de expresión y de fraseo:
2529 @lilypond[verbatim,quote,relative=2]
2532 -\tweak #'minimum-length #5
2537 -\tweak #'minimum-length #5
2541 Para algunos objetos de presentación, la propiedad
2542 @code{minimum-length} es efectiva sólo si se llama explícitamente al
2543 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
2544 propiedad @code{springs-and-rods} al valor
2545 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
2546 de un glissando no tiene efecto a no ser que se establezca la
2547 propiedad @code{springs-and-rods}:
2549 @lilypond[verbatim,quote,relative=1]
2553 % not effective alone
2554 \once \override Glissando #'minimum-length = #20
2557 % effective only when both overrides are present
2558 \once \override Glissando #'minimum-length = #20
2559 \once \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
2563 Lo mismo se puede decir del objeto @code{Beam}:
2565 @lilypond[verbatim,quote,relative=1]
2566 % not effective alone
2567 \once \override Beam #'minimum-length = #20
2570 % effective only when both overrides are present
2571 \once \override Beam #'minimum-length = #20
2572 \once \override Beam #'springs-and-rods = #ly:spanner::set-spacing-rods
2576 @strong{@i{The @code{to-barline} property}}
2578 La segunda propiedad útil del @code{spanner-interface} es
2579 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2580 haciendo que los reguladores y otros objetos de extensión que terminan
2581 sobre la primera nota de un compás, en vez de eso terminen en la línea
2582 divisoria inmediatamente precedente. Si se establece al valor falso,
2583 el extensor llegará más allá de la barra de compás y terminará
2584 exactamente sobre la nota:
2586 @lilypond[verbatim,quote,relative=2]
2587 a \< a a a a \! a a a \break
2588 \override Hairpin #'to-barline = ##f
2589 a \< a a a a \! a a a
2592 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
2593 su establecimiento a @code{#t} no tienen ningún efecto sobre las
2594 ligaduras de expresión o de fraseo, o sobre otros extensores para los
2595 que terminar en la barra de compás no tendría ningún significado.
2597 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
2599 Entre los objetos que contemplan el interface
2600 @code{line-spanner-interface} se encuentran
2603 @item @code{DynamicTextSpanner}
2604 @item @code{Glissando}
2605 @item @code{TextSpanner}
2606 @item @code{TrillSpanner}
2607 @item @code{VoiceFollower}
2610 La rutina responsable de dibujar los sellos de estos extensores es
2611 @code{ly:line-interface::print}. esta rutina determina la
2612 localización exacta de los dos puntos extremos y traza una línea entre
2613 ellos, en el estilo solicitado. Las posiciones de los dos puntos
2614 extremos del extensor se calculan al vuelo, pero es posible
2615 sobreescribir sus coordenadas Y. Las propiedades que se deben
2616 especificar están anidadas a dos niveles de profundidad en la
2617 jerarquía de propiedades, pero la sintaxis de la instrucción
2618 @code{\override} es bastante sencilla:
2620 @lilypond[relative=2,quote,verbatim]
2622 \once \override Glissando #'(bound-details left Y) = #3
2623 \once \override Glissando #'(bound-details right Y) = #-2
2627 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
2628 siendo el punto del cero la línea central del pentagrama. Para el
2629 glissando, esto es el valor de @code{Y} en la coordenada X que
2630 corresponde al punto central de cada cabeza de nota si nos imaginamos
2631 que la línea se extiende hasta allí.
2633 Si no está fijado @code{Y}, su valor se calcula a partir de la
2634 posición vertical del punto de anclaje correspondiente del extensor.
2636 En caso de salto de línea, los valores para los puntos extremos se
2637 especifican por las sub-listas @code{left-broken} y
2638 @code{right-broken} de @code{bound-details}. Por ejemplo:
2640 @lilypond[relative=2,ragged-right,verbatim,quote]
2641 \override Glissando #'breakable = ##t
2642 \override Glissando #'(bound-details right-broken Y) = #-3
2643 c1 \glissando \break
2647 Un número de propiedades adicionales de las sub-listas @code{left} y
2648 @code{right} de la propiedad @code{bound-details} se pueden
2649 especificar de la misma forma que @code{Y}:
2653 Establece la coordenada Y del punto extremo, en desplazamientos de
2654 @code{staff-space}s desde la línea central del pentagrama. De forma
2655 predeterminada es el centro del objeto ancla, y así un glissando
2656 apunta al centro vertical de la cabeza de la nota.
2658 Para extensores horizontales como los extensores de texto y los
2659 trinos, está inamoviblemente codificado como 0.
2661 @item attach-dir (dirección de anclaje)
2662 Determina dónde comienza y termina la línea en la dirección X, con
2663 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o @code{LEFT},
2664 izquierda) hace que la línea comience o termine en el lado izquierdo
2665 de la cabeza de la nota a la que está anclado.
2668 Es la coordenada X absoluta del punto extremo. Se suele calcular al
2669 vuelo, y su sobreescritura no tiene un efecto útil.
2671 @item stencil (sello)
2672 Los extensores de línea pueden tener símbolos al comienzo o al final,
2673 lo que está contenido en esta sub-propiedad. Esto es para uso
2674 interno; se recomienda en su lugar el uso de @code{text}.
2677 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
2678 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
2679 de extensión horizontales.
2681 @lilypond[quote,ragged-right,relative=2,verbatim]
2682 \override TextSpanner #'(bound-details left text)
2683 = \markup { \small \bold Slower }
2684 c2\startTextSpan b c a\stopTextSpan
2687 @item stencil-align-dir-y (alineación del sello en y)
2688 @item stencil-offset (desplazamiento del sello)
2689 Si no se modifican uno u otro, el sello se coloca sencillamente en el
2690 punto extremo, centrado sobre la línea, como viene definido por las
2691 subpropiedades @code{X} e @code{Y}. Si se fijan
2692 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
2693 símbolo del borde verticalmente con relación al extremo de la línea:
2695 @lilypond[relative=1,quote,verbatim]
2696 \override TextSpanner
2697 #'(bound-details left stencil-align-dir-y) = #-2
2698 \override TextSpanner
2699 #'(bound-details right stencil-align-dir-y) = #UP
2701 \override TextSpanner
2702 #'(bound-details left text) = #"ggg"
2703 \override TextSpanner
2704 #'(bound-details right text) = #"hhh"
2705 c4^\startTextSpan c c c \stopTextSpan
2708 Observe que los valores negativos mueven el texto @emph{hacia arriba},
2709 al contrario de lo que podría esperarse, pues el valor de @w{@code{-1}} o
2710 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
2711 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
2712 (arriba) alinea el borde superior del texto con la línea extensora.
2714 @item arrow (flecha)
2715 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
2716 flecha en el extremo de la línea.
2718 @item padding (relleno)
2719 Esta sub-propiedad controla el espacio entre el punto extremo
2720 especificado de la línea y el extremo real. Sin relleno, un glissando
2721 empezaría y terminaría en el centro de la cabeza de las notas.
2725 La función musical @code{\endSpanners} finaliza de forma prematura el
2726 extensor que comienza sobre la nota que sigue inmediatamente a
2727 continuación. Se termina después de una nota exactamente, o en la
2728 siguiente barra de compás si @code{to-barline} es verdadero y se
2729 produce una divisoria antes de la siguiente nota.
2731 @lilypond[verbatim,quote,ragged-right,relative=2]
2733 c2 \startTextSpan c2 c2
2738 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
2739 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
2743 Referencia de funcionamiento interno:
2744 @rinternals{TextSpanner},
2745 @rinternals{Glissando},
2746 @rinternals{VoiceFollower},
2747 @rinternals{TrillSpanner},
2748 @rinternals{line-spanner-interface}.
2751 @node Visibilidad de los objetos
2752 @subsection Visibilidad de los objetos
2753 @translationof Visibility of objects
2755 @cindex objetos, visibilidad de
2756 @cindex grobs, visibilidad de
2757 @cindex visibilidad de los objetos
2759 Hay cuatro formas principales en que se puede controlar la visibilidad
2760 de los objetos de presentación: se puede eliminar su sello, se pueden
2761 volver transparentes, se pueden pintar de blanco, o se puede
2762 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
2763 se aplican a todos los objetos de presentación; la última sólo a unos
2764 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
2765 introduce estas cuatro técnicas, véase @rlearning{Visibilidad y color de los objetos}.
2767 Hay también algunas otras técnicas que son específicas de ciertos
2768 objetos de presentación. Se estudian bajo Consideraciones especiales.
2771 * Eliminar el sello::
2772 * Hacer transparentes los objetos::
2773 * Pintar los objetos de blanco::
2774 * Uso de break-visibility (visibilidad en el salto)::
2775 * Consideraciones especiales::
2779 @node Eliminar el sello
2780 @unnumberedsubsubsec Eliminar el sello
2781 @translationof Removing the stencil
2783 @cindex sello, eliminar
2785 Todo objeto de presentación tiene una propiedad stencil (sello). De
2786 forma predeterminada está establecida a la función específica que
2787 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
2788 se llama a ninguna función y el objeto no se dibuja. La acción
2789 predeterminada se puede recuperar con @code{\revert}.
2791 @lilypond[quote,verbatim,relative=1]
2793 \override Score.BarLine #'stencil = ##f
2795 \revert Score.BarLine #'stencil
2799 @node Hacer transparentes los objetos
2800 @unnumberedsubsubsec Hacer transparentes los objetos
2801 @translationof Making objects transparent
2803 @cindex transparentes, hacer los objetos
2805 Todo objeto de presentación tiene una propiedad transparent
2806 (transparente) que de forma predeterminada está establecida a
2807 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
2810 @lilypond[quote,verbatim,relative=2]
2812 \once \override NoteHead #'transparent = ##t
2816 @node Pintar los objetos de blanco
2817 @unnumberedsubsubsec Pintar los objetos de blanco
2818 @translationof Painting objects white
2820 @cindex objetos, coloreado de
2821 @cindex coloreado de objetos
2823 @cindex impresión, orden de
2824 @cindex sobreescritura de objetos
2825 @cindex objetos, sobreescritura de
2826 @cindex grobs, sobreescritura de
2828 Todo objeto de presentación tiene una propiedad de color que de forma
2829 predeterminada está establecida a @code{black} (negro). Si se
2830 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
2831 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
2832 color de los puntos de cruce queda determinado por el orden en que se
2833 dibujan estos objetos, lo que puede dejar una imagen fantasma del
2834 objeto blanco, como puede verse aquí:
2836 @lilypond[quote,verbatim,relative=2]
2837 \override Staff.Clef #'color = #white
2841 Se puede evitar esto cambiando el orden de impresión de los objetos.
2842 Todos los objetos de presentación tienen una propiedad @code{layer}
2843 (capa) que se debe establecer a un valor entero. Los objetos con el
2844 valor de @code{layer} más bajo se dibujan primero, después se dibujan
2845 los objetos con valores progresivamente mayores, y así los objetos con
2846 valores más altos se dibujan encima de los que tienen valores más
2847 bajos. De forma predeterminada, casi todos los objetos tienen
2848 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
2849 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
2850 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
2851 impresión de los objetos con el mismo valor de @code{layer} es
2854 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
2855 predeterminado de @code{1}, se dibuja después de las líneas del
2856 pentagrama (valor @code{layer} predeterminado de @code{0}),
2857 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
2858 @code{Clef} un valor de @code{layer} más bajo, digamos @w{@code{-1}}, para
2859 que se dibuje antes:
2861 @lilypond[quote,verbatim,relative=2]
2862 \override Staff.Clef #'color = #white
2863 \override Staff.Clef #'layer = #-1
2867 @node Uso de break-visibility (visibilidad en el salto)
2868 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
2869 @translationof Using break-visibility
2871 @c TODO Add making other objects breakable
2873 @cindex break-visibility
2875 Casi todos los objetos de presentación se imprimen una sola vez, pero
2876 algunos como las líneas divisorias, claves, indicaciones de compás y
2877 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
2878 se produce un salto de línea : una vez al final de la línea y otra al
2879 comienzo de la siguiente. Estos objetos reciben el nombre de
2880 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
2881 (visibilidad en el salto), para controlar su visibilidad en las tres
2882 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
2883 la línea si se produce un cambio, y al final de la línea si el cambio
2884 se produce en ese lugar.
2886 Por ejemplo, la indicación de compás se imprime de forma
2887 predeterminada al comienzo de la primera línea y en ningún otro lugar
2888 a no ser que cambie, en cuyo caso se imprime en el punto en que se
2889 produce el cambio. Si este cambio se produce al final de una línea,
2890 la nueva indicación de compás se imprime al principio de la línea
2891 siguiente y también al final de la línea anterior como indicación de
2894 Este comportamiento se controla por medio de la propiedad
2895 @code{break-visibility}, que se explica en
2896 @c Leave this ref on a newline - formats incorrectly otherwise -td
2897 @rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
2898 vector de tres valores booleanos que, por orden, determinan si el
2899 objeto se imprime al final, dentro, o al principio de la línea. O,
2900 para ser más exactos: antes del salto de línea, si no hay salto, o
2903 Como alternativa se puede especificar cualquiera de las ocho
2904 combinaciones mediante funciones predefinidas cuya definición está en
2905 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
2906 los objetos de presentación serán visibles en las posiciones que se
2907 muestran en el encabezamiento de cada columna:
2909 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {yes} {yes} {yes}
2910 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
2911 @headitem de función @tab de vector @tab salto @tab salto @tab salto
2913 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
2914 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
2915 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
2916 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
2917 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
2918 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
2919 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
2920 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
2923 Los ajustes predeterminados de @code{break-visibility} dependen del
2924 objeto de presentación. La tabla siguiente muestra todos los objetos
2925 de presentación de interés que resultan afectados por
2926 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
2928 @multitable @columnfractions .3 .3 .4
2930 @headitem Objeto @tab Contexto usual @tab Valor predet.
2932 @c omit Ambitus as it appears not to be affected by break-visibility -td
2933 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
2934 @item @code{BarLine} @tab @code{Score} @tab calculado
2935 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
2936 @c omit the following item until it can be explained -td
2937 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
2938 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2939 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
2940 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
2941 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
2942 @c omit KeyCancellation until it can be explained -td
2943 @c @item @code{KeyCancellation} @tab ?? @tab @code{begin-of-line-invisible}
2944 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
2945 @c omit LeftEdge until it can be explained -td
2946 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
2947 @item @code{OctavateEight} @tab @code{Staff} @tab @code{begin-of-line-visible}
2948 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
2949 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
2953 El ejemplo de abajo muestra el uso de la forma de vector para
2954 controlar la visibilidad de las líneas divisorias:
2956 @lilypond[quote,verbatim,relative=1,ragged-right]
2959 % Remove bar line at the end of the current line
2960 \once \override Score.BarLine #'break-visibility = #'#(#f #t #t)
2966 Aunque los tres componentes del vector utilizado para sobreescribir
2967 @code{break-visibility} deben estar presentes, no todos son efectivos
2968 para todos los objetos de presentación, y algunas combinaciones pueden
2969 incluso dar errores. Son de aplicación las siguientes limitaciones:
2972 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
2973 @item No se puede imprimir el número de compás al principio de la primera
2974 línea a no ser que su valor establecido sea distinto de 1.
2975 @item Clave: véase más abajo
2976 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
2977 se suprimen por completo. Utilice begin-of line-invisible para
2978 imprimirlas y all-invisible para suprimirlas.
2979 @item Armadura: véase más abajo
2980 @item OctavateEight: véase más abajo
2983 @node Consideraciones especiales
2984 @unnumberedsubsubsec Consideraciones especiales
2985 @translationof Special considerations
2987 @strong{@emph{Visibilidad después de un cambio explícito}}
2989 @cindex armadura, visibilidad después de un cambio explícito
2990 @cindex explicitKeySignatureVisibility
2991 @cindex clave, visibilidad después de un cambio explícito
2992 @cindex explicitClefVisibility
2994 La propiedad @code{break-visibility} controla la visibilidad de las
2995 armaduras y cambios de clave sólo al principio de las líneas, es
2996 decir, después de un salto. No tiene ningún efecto sobre la
2997 visibilidad de la armadura o la clave después de un cambio explícito
2998 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
2999 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
3000 bemol mayor es visible incluso con @code{all-invisible} establecido.
3002 @lilypond[quote,verbatim,relative=1,ragged-right]
3005 % Try to remove all key signatures
3006 \override Staff.KeySignature #'break-visibility = #all-invisible
3014 La visibilidad de estos cambios explícitos de tonalidad y de clave se
3015 controla por medio de las propiedades
3016 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
3017 Son los equivalentes de la propiedad @code{break-visibility} y las dos
3018 toman un vector de tres valores booleanos o las funciones predefinidas
3019 relacionadas anteriormente, exactamente igual que
3020 @code{break-visibility}. Las dos son propiedades del contexto Staff,
3021 no de los propios objetos de presentación, y por tanto se establecen
3022 utilizando la instrucción @code{\set}. Las dos están establecidas de
3023 forma predeterminada al valor @code{all-visible}. Estas propiedades
3024 controlan sólo la visibilidad de las armaduras y las claves que
3025 resultan de los cambios explícitos y no afectan a las armaduras y
3026 tonalidades que están al principio de las líneas; para quitarlas, aún
3027 se debe sobreescribir la propiedad @code{break-visibility} en el
3028 objeto correspondiente.
3030 @lilypond[quote,verbatim,relative=1,ragged-right]
3033 \set Staff.explicitKeySignatureVisibility = #all-invisible
3034 \override Staff.KeySignature #'break-visibility = #all-invisible
3041 @strong{@emph{Visibilidad de las alteraciones de precaución}}
3043 Para eliminar las alteraciones de precaución que se imprimen en un
3044 cambio de tonalidad explícito, establezca la propiedad
3045 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3047 @lilypond[quote,verbatim,relative=1,ragged-right]
3050 \set Staff.explicitKeySignatureVisibility = #all-invisible
3051 \set Staff.printKeyCancellation = ##f
3052 \override Staff.KeySignature #'break-visibility = #all-invisible
3059 Con estas sobreescrituras solamente permanecen las alteraciones
3060 accidentales delante de las notas para indicar el cambio de tonalidad.
3062 @c TODO Add visibility of cautionary accidentals before notes
3064 @strong{@emph{Automatic bars}}
3066 @cindex automaticBars
3067 @cindex líneas divisorias, eliminación
3069 Como caso especial, la impresión de las líneas divisorias también se
3070 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
3071 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
3072 imprimen automáticamente; se deben crear explícitamente con una
3073 instrucción @code{\bar}. A diferencia de la instrucción predefinida
3074 @code{\cadenzaOn}, los compases se siguen contando. La generación de
3075 compases continúa de acuerdo a esta cuenta si esta propiedad se
3076 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
3077 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
3082 @strong{@emph{Octavated clefs}}
3084 @cindex octavadas, visibilidad de las claves
3085 @cindex visibilidad de las claves octavadas
3086 @cindex claves, visibilidad de la octavación
3088 El pequeño símbolo de octava sobre las claves en octava alta o baja se
3089 produce por parte del objeto @code{OctavateEight}. Su visibilidad se
3090 hereda automáticamente de la del objeto @code{Clef}, así que no es
3091 necesario aplicar las sobreescrituras correspondientes
3092 @code{break-visibility} a los objetos
3093 @code{OctavateEight} para suprimir los símbolos de octavación
3094 para las claves invisibles.
3096 Para los cambios de clave explícitos, la propiedad
3097 @code{explicitClefVisibility} controla tanto el símbolo de clave como
3098 el símbolo de octava asociado.
3102 Manual de aprendizaje:
3103 @rlearning{Visibilidad y color de los objetos}
3106 @node Estilos de línea
3107 @subsection Estilos de línea
3108 @translationof Line styles
3110 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3111 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
3112 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
3114 Todos ellos usan las mismas rutinas que el glissando para dibujar los
3115 textos y las líneas, y por ello el ajuste fino de su comportamiento se
3116 hace de la misma manera. Se hace con un spanner (un objeto de
3117 extensión), y la rutina responsable de dibujar los objetos de
3118 extensión es @code{ly:line-interface::print}. Esta rutina determina la
3119 colocación exacta de los dos @i{extremos del objeto de extensión} y
3120 dibuja una línea entre ellos, en el estilo solicitado.
3122 He aquí un ejemplo de los distintos estilos de línea disponibles, y
3123 cómo aplicarles ajustes finos.
3125 @lilypond[relative=2,ragged-right,verbatim,quote]
3127 \once \override Glissando #'style = #'dashed-line
3129 \override Glissando #'style = #'dotted-line
3131 \override Glissando #'style = #'zigzag
3133 \override Glissando #'style = #'trill
3137 Las posiciones de los puntos extremos del objeto de extensión se
3138 computan al vuelo para cada uno de los objetos gráficos, pero es
3139 posible sobreescribirlos:
3142 @lilypond[relative=2,ragged-right,verbatim,quote]
3144 \once \override Glissando #'(bound-details right Y) = #-2
3148 El valor de @code{Y} está establecido a @w{@code{-2}} para el extremo
3149 derecho. El lado izquierdo se puede ajustar de forma similar
3150 especificando @code{left} en vez de @code{right}.
3152 Si no está establecido @code{Y}, el valor se computa a partir de la
3153 posición vertical de los puntos de anclaje izquierdo y derecho del
3156 Son posibles otros ajustes de los extensores, para ver más detalles
3157 consulte @ref{Objetos de extensión}.
3160 @node Rotación de objetos
3161 @subsection Rotación de objetos
3162 @translationof Rotating objects
3164 Tanto los objetos de presentación como los elementos de texto de
3165 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
3166 pero difiere el método de hacerlo.
3169 * Rotación de objetos de presentación::
3170 * Rotación de elementos de marcado::
3173 @node Rotación de objetos de presentación
3174 @unnumberedsubsubsec Rotación de objetos de presentación
3175 @translationof Rotating layout objects
3177 @cindex rotating objects
3178 @cindex objects, rotating
3180 Todos los objetos de presentación que contemplan el interface
3181 @code{grob-interface} se pueden rotar estableciendo su propiedad
3182 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
3183 rotación en sentido antihorario, y las coordenadas x e y del punto con
3184 relación al punto de referencia del objeto, alrededor del que se va a
3185 realizar la rotación. El ángulo de rotación se especifica en grados
3186 y las coordenadas en espacios de pentagrama.
3188 El ángulo de rotación y las coordenadas del punto de rotación se deben
3189 determinar por ensayo y error.
3191 @cindex reguladores en ángulo
3192 @cindex ángulo, reguladores en
3194 Solamente en ciertas ocasiones es útil la rotación de objetos de
3195 presentación; el ejemplo siguiente muestra una situación en que puede
3198 @lilypond[quote,verbatim,relative=1]
3200 \override Hairpin #'rotation = #'(20 -1 0)
3204 @node Rotación de elementos de marcado
3205 @unnumberedsubsubsec Rotación de elementos de marcado
3206 @translationof Rotating markup
3208 Todos los textos de marcado se pueden rotar para que se dispongan en
3209 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
3210 instrucción acepta dos argumentos: el ángulo de rotación en grados en
3211 sentido antihorario, y el texto que rotar. Los límites que ocupa el
3212 texto no se rotan: toman su valor a partir de los extremos de las
3213 coordenadas x e y del texto rotado. En el ejemplo siguiente la
3214 propiedad @code{outside-staff-priority} del texto se establece a
3215 @code{#f} para desactivar la evitación automática de colisiones, lo
3216 que empuja al texto a una posición muy alta.
3218 @lilypond[quote,verbatim,relative=1]
3219 \override TextScript #'outside-staff-priority = ##f
3220 g4^\markup { \rotate #30 "a G" }
3221 b^\markup { \rotate #30 "a B" }
3222 des^\markup { \rotate #30 "a D-Flat" }
3223 fis^\markup { \rotate #30 "an F-Sharp" }
3226 @node Trucos avanzados
3227 @section Trucos avanzados
3228 @translationof Advanced tweaks
3230 Esta sección trata sobre distintos enfoques en la realización de
3231 ajustes finos a la apariencia de la partitura impresa.
3234 * Alineación de objetos::
3235 * Agrupación vertical de objetos gráficos::
3236 * Modificación de los sellos::
3237 * Modificación de las formas::
3242 Manual de aprendizaje:
3243 @rlearning{Trucar la salida},
3244 @rlearning{Otras fuentes de información}.
3246 Referencia de la notación:
3247 @ref{Explicación del Manual de referencia de funcionamiento interno},
3248 @ref{Modificar las propiedades}.
3252 @file{scm/define-grobs.scm}.
3254 Fragmentos de código:
3255 @rlsr{Tweaks and overrides}.
3258 @rextend{Interfaces para programadores}.
3260 Referencia de funcionamiento interno:
3261 @rinternals{All layout objects}.
3264 @node Alineación de objetos
3265 @subsection Alineación de objetos
3266 @translationof Aligning objects
3268 Los objetos gráficos que soportan el interface
3269 @code{self-alignment-interface} y/o el @code{side-position-interface}
3270 se pueden alinear contra un objeto colocado previamente, de diversas
3271 maneras. Para ver una lista de estos objetos, consulte
3272 @rinternals{self-alignment-interface} y
3273 @rinternals{side-position-interface}.
3275 Todos los objetos gráficos tienen un punto de referencia, una
3276 extensión horizontal y una extensión vertical. La extensión
3277 horizontal es una pareja de números que dan los desplazamientos a
3278 partir del punto de referencia de los bordes izquierdo y derecho,
3279 siendo negativos los desplazamientos hacia la izquierda. La extensión
3280 vertical es una pareja de números que dan el desplazamiento a partir
3281 del punto de referencia hasta los bordes inferior y superior, siendo
3282 negativos los desplazamientos hacia abajo.
3284 La posición de un objeto sobre el pentagrama viene dada por los
3285 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
3286 valor de @code{X-offset} da el desplazamiento desde la coordenada X
3287 del punto de referencia del objeto padre, y el valor de
3288 @code{Y-offset} da el desplazamiento a partir de la línea central del
3289 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
3290 pueden establecer directamente o se puede dejar que se calculen por
3291 parte de procedimientos para conseguir una alineación con el objeto
3294 @warning{Muchos objetos tienen consideraciones de posicionamiento
3295 especiales que hacen que se ignore o se modifique cualquier ajuste
3296 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
3297 objeto contemple el interface @code{self-alignment-interface}. La
3298 sobreescritura de las propiedades @code{X-offset} ó @code{Y-offset} a
3299 un valor fijo hace que se descarte la respectiva propiedad
3300 @code{self-alignment}.}
3302 Por ejemplo, una alteración accidental se puede reposicionar
3303 verticalmente estableciendo @code{Y-offset} pero los cambios a
3304 @code{X-offset} no tienen ningún efecto.
3306 Las letras de ensayo se pueden alinear con objetos divisibles como
3307 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
3308 propiedades especiales que se encuentran en
3309 @code{break-aligned-interface} para el posicionamiento de las letras
3310 de ensayo sobre dichos objetos.
3313 @ref{Uso del break-alignable-interface},
3314 @rextend{Funciones de callback}.
3317 * Establecer directamente X-offset e Y-offset::
3318 * Uso del side-position-interface::
3319 * Uso del self-alignment-interface::
3320 * Uso del break-alignable-interface::
3323 @node Establecer directamente X-offset e Y-offset
3324 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
3325 @translationof Setting X-offset and Y-offset directly
3327 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
3328 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
3329 notas con una digitación en su posición predeterminada y con los
3330 valores @code{X-offset} y @code{Y-offset} modificados.
3332 @lilypond[verbatim,quote,relative=2]
3335 -\tweak #'X-offset #0
3336 -\tweak #'Y-offset #0
3339 -\tweak #'X-offset #-1
3340 -\tweak #'Y-offset #1
3346 @node Uso del side-position-interface
3347 @unnumberedsubsubsec Uso del @code{side-position-interface}
3348 @translationof Using the side-position-interface
3350 Un objeto que contempla el @code{side-position-interface} se puede
3351 colocar junto a su objeto padre de forma que los bordes especificados
3352 de los dos objetos se toquen. El objeto se puede situar encima,
3353 debajo, a la derecha o a la izquierda del objeto padre. El padre no
3354 se puede especificar; viene determinado por el orden de los elementos
3355 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
3356 nota asociada como padre.
3358 Los valores de las propiedades @code{side-axis} y @code{direction}
3359 determinan dónde colocar el objeto, como sigue:
3361 @c TODO add an example of each to the table
3363 @multitable @columnfractions .3 .3 .3
3364 @headitem @code{side-axis} @tab @code{direction} @tab
3365 @headitem propiedad @tab propiedad @tab colocación
3367 @item @code{0} @tab @w{@code{-1}} @tab izquierda
3368 @item @code{0} @tab @code{1} @tab derecha
3369 @item @code{1} @tab @w{@code{-1}} @tab debajo
3370 @item @code{1} @tab @code{1} @tab encima
3374 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
3375 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
3376 procedimiento devuelve el calor correcto de @code{X-offset} para
3377 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
3378 el valor de @code{direction}.
3380 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
3381 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
3382 procedimiento devuelve el valor correcto de @code{Y-offset} para
3383 situar el objeto encima o debajo del padre de acuerdo con el valor de
3386 @c TODO Add examples
3388 @node Uso del self-alignment-interface
3389 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
3390 @translationof Using the self-alignment-interface
3392 @emph{Auto-alineación horizontal de los objetos}
3394 La alineación horizontal de un objeto que contempla el interface
3395 @code{self-alignment-interface} está controlada por el valor de la
3396 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
3397 @code{X-offset} de este objeto esté establecida a
3398 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
3399 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
3400 mitad de la extensión X total del objeto. Los valores negativos
3401 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
3402 valor de @code{0} centra el objeto sobre el punto de referencia de su
3403 padre, un valor de @w{@code{-1}} alinea el borde izquierdo del objeto
3404 sobre el punto de referencia de su padre, y un valor de @code{1}
3405 alinea el borde derecho del objeto sobre el punto de referencia de su
3406 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
3407 @code{RIGHT} en sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
3410 Normalmente se usaría la instrucción @code{\override} para modificar
3411 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
3412 @code{\tweak} para alinear varias anotaciones por separado sobre una
3415 @lilypond[quote,verbatim,relative=1]
3417 -\tweak #'self-alignment-X #-1
3419 -\tweak #'self-alignment-X #0
3421 -\tweak #'self-alignment-X #RIGHT
3423 -\tweak #'self-alignment-X #-2.5
3424 ^"aligned further to the right"
3427 @emph{Auto-alineación vertical de los objetos}
3429 Los objetos se pueden alinear verticalmente en una forma análoga a la
3430 alineación horizontal si la propiedad @code{Y-offset} está establecida
3431 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
3432 a menudo se encuentran implicados otros mecanismos en la alineación
3433 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
3434 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
3435 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
3436 las dimensiones verticales del objeto, que suele ser bastante pequeño,
3437 por lo que pueden requerirse números bastante grandes. Un valor de
3438 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
3439 referencia del objeto padre, un valor de @code{0} alinea el centro del
3440 objeto con el punto de referencia del padre, y un valor de @code{1}
3441 alinea el borde superior del objeto con el punto de referencia del
3442 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
3443 @code{UP} en sustitución de @w{@code{-1}},
3444 @code{0} y @code{1}, respectivamente.
3446 @emph{Auto-alineación de objetos en las dos direcciones}
3448 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
3449 alinear un objeto en las dos direcciones simultáneamente.
3451 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
3452 se acerque a la cabeza de la nota.
3454 @lilypond[quote,verbatim,relative=2]
3456 -\tweak #'self-alignment-X #0.5 % move horizontally left
3457 -\tweak #'Y-offset #ly:self-alignment-interface::y-aligned-on-self
3458 -\tweak #'self-alignment-Y #-1 % move vertically up
3463 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
3465 @c Cannot document as they do not seem to operate consistently on all objects -td
3466 @c TODO investigate further
3468 The @code{aligned-on-parent} procedures are used in the same way
3469 as the @code{aligned-on-self} procedures, they difference being
3470 that they permit an object to be aligned with the @emph{edges} of
3471 the parent rather than the parent's reference point. The following
3472 example shows the difference:
3476 @lilypond[verbatim,quote]
3482 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
3484 @c Cannot document as they do not seem to operate consistently on all objects -td
3485 @c TODO investigate further
3489 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
3492 @node Uso del break-alignable-interface
3493 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
3494 @translationof Using the break-alignable-interface
3496 @cindex alineación a objetos
3497 @cindex break-align-symbols
3499 Las letras de ensayo se pueden alinear con objetos de notación
3500 distintos a las barras de compás. Estos objetos son @code{ambitus},
3501 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
3502 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
3503 @code{time-signature}.
3505 De forma predeterminada, las letras de ensayo y los números de compás
3506 se centran horizontalmente sobre el objeto:
3508 @lilypond[verbatim,quote,relative=1]
3509 % The rehearsal mark will be centered above the Clef
3510 \override Score.RehearsalMark #'break-align-symbols = #'(clef)
3515 % The rehearsal mark will be centered above the Time Signature
3516 \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
3522 % The rehearsal mark will be centered above the Breath Mark
3523 \override Score.RehearsalMark #'break-align-symbols = #'(breathing-sign)
3532 Se puede especificar una lista de posibles objetos para la alineación.
3533 Si algunos de los objetos son invisibles en ese punto debido al valor
3534 de @code{break-visibility} o a valores de visibilidad explícitos para
3535 las armaduras y las claves, la letra de ensayo o número de compás se
3536 alinean con el primer objeto de la lista que sea visible. Si ningún
3537 objeto de la lista es visible, el objeto se alinea con la línea
3538 divisoria. Si la línea divisoria es invisible, el objeto se alinea
3539 con el punto en el que se encontraría la línea divisoria.
3541 @lilypond[verbatim,quote,relative=1]
3542 % The rehearsal mark will be centered above the Key Signature
3543 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3548 % The rehearsal mark will be centered above the Clef
3549 \set Staff.explicitKeySignatureVisibility = #all-invisible
3550 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3555 % The rehearsal mark will be centered above the Bar Line
3556 \set Staff.explicitKeySignatureVisibility = #all-invisible
3557 \set Staff.explicitClefVisibility = #all-invisible
3558 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature clef)
3565 La alineación de la letra de ensayo con relación al objeto de notación
3566 se puede cambiar, como se ve en el ejemplo siguiente. En una
3567 partitura con varios pentagramas, este ajuste se debe hacer para todos
3570 @lilypond[verbatim,quote,relative=1]
3571 % The RehearsalMark will be centered above the Key Signature
3572 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3578 % The RehearsalMark will be aligned with the left edge of the Key Signature
3579 \once \override Score.KeySignature #'break-align-anchor-alignment = #LEFT
3583 % The RehearsalMark will be aligned with the right edge of the Key Signature
3584 \once \override Score.KeySignature #'break-align-anchor-alignment = #RIGHT
3590 La letra de ensayo también se puede desplazar al borde derecho o
3591 izquierdo en una medida arbitraria. Las unidades son espacios de
3594 @lilypond[verbatim,quote,relative=1]
3595 % The RehearsalMark will be aligned with the left edge of the Key Signature
3596 % and then shifted right by 3.5 staff-spaces
3597 \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
3598 \once \override Score.KeySignature #'break-align-anchor = #3.5
3602 % The RehearsalMark will be aligned with the left edge of the Key Signature
3603 % and then shifted left by 2 staff-spaces
3604 \once \override Score.KeySignature #'break-align-anchor = #-2
3611 @node Agrupación vertical de objetos gráficos
3612 @subsection Agrupación vertical de objetos gráficos
3613 @translationof Vertical grouping of grobs
3615 Los grobs (objetos gráficos) @code{VerticalAlignment} y
3616 @code{VerticalAxisGroup} trabajan de manera coordinada.
3617 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
3618 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
3619 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
3620 Normalmente sólo existe un @code{VerticalAlignment} por cada
3621 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
3622 @code{VerticalAxisGroup}.
3625 @node Modificación de los sellos
3626 @subsection Modificación de los sellos
3627 @translationof Modifying stencils
3629 Todos los objetos de presentación tienen una propiedad @code{stencil}
3630 que es parte del @code{grob-interface}. De forma predeterminada, esta
3631 propiedad suele estar establecida a una función específica del objeto
3632 que está hecha a medida para disponer el símbolo que lo representa en
3633 la salida. Por ejemplo, el ajuste estándar para la propiedad
3634 @code{stencil} del objeto @code{MultiMeasureRest} es
3635 @code{ly:multi-measure-rest::print}.
3637 El símbolo estándar de cualquier objeto se puede sustituir modificando
3638 la propiedad @code{stencil} para que haga referencia a un
3639 procedimiento diferente escrito especialmente. Esto requiere un alto
3640 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
3641 una forma más fácil que a menudo puede dar resultados adecuados.
3643 El procedimiento es establecer la propiedad @code{stencil} al
3644 procedimiento que imprime texto (@code{ly:text-interface::print}) y
3645 añadir una propiedad @code{text} al objeto ajustada para que contenga
3646 el texto de marcado que produce el símbolo requerido. Debido a la
3647 flexibilidad del marcado, se pueden conseguir muchas cosas; en
3648 particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
3650 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
3651 la nota a unas aspas dentro de una circunferencia.
3653 @lilypond[verbatim,quote]
3655 \once \override NoteHead #'stencil = #ly:text-interface::print
3656 \once \override NoteHead #'text = \markup {
3658 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
3659 \musicglyph #"noteheads.s2cross"
3667 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
3668 a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
3670 @c TODO Add inserting eps files or ref to later
3672 @c TODO Add inserting Postscript or ref to later
3676 Referencia de la notación:
3677 @ref{Notación gráfica dentro de elementos de marcado},
3678 @ref{Formatear el texto},
3679 @ref{Text markup commands},
3680 @ref{La tipografía Feta}.
3683 @node Modificación de las formas
3684 @subsection Modificación de las formas
3685 @translationof Modifying shapes
3688 * Modificación de ligaduras de unión y de expresión::
3691 @node Modificación de ligaduras de unión y de expresión
3692 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
3693 @translationof Modifying ties and slurs
3695 @cindex ligaduras de expresión, modificar
3696 @cindex ligaduras de unión, modificar
3697 @cindex Bézier, curvas de, puntos de control
3698 @cindex puntos de control en curvas de Bézier
3700 Las ligaduras de unión, de expresión y de fraseo se trazan como curvas
3701 de Bézier de tercer orden. Si la forma de la ligadura calculada
3702 automáticamente no resulta óptima, se puede modificar su forma
3703 manualmente mediante la especificación explícita de los cuatro puntos
3704 de control necesarios para definir una curva de Bézier de tercer
3707 Las curvas Bézier de tercer orden o cúbicas están definidas por cuatro
3708 puntos de control. El primer y cuarto puntos de control son
3709 exactamente los puntos extremos de comienzo y de final de la curva.
3710 Los dos puntos de control intermedios definen la forma. Se pueden
3711 encontrar en la web animaciones que muestran cómo se traza la curva,
3712 pero la descripción siguiente puede ser de ayuda. La curva comienza a
3713 partir del primer punto de control dirigiéndose directamente hacia el
3714 segundo, curvándose progresivamente para dirigirse hacia el tercero y
3715 continuando la curva hacia el cuarto, llegando a éste en viaje directo
3716 desde el tercer punto de control. La curva está contenida enteramente
3717 dentro del cuadrilátero definido por los cuatro puntos de control.
3719 He aquí un ejemplo de un caso en que la ligadura no es óptima, y donde
3720 @code{\tieDown} no sirve de ayuda.
3722 @lilypond[verbatim,quote,relative=1]
3726 { r4 <g c,> <g c,> <g c,> }
3730 Una forma de mejorar esta ligadura es modificar manualmente sus puntos
3731 de control como sigue.
3733 Las coordenadas de los puntos de control de Bézier se especifican en
3734 unidades de espacios de pentagrama. La coordenada@tie{}X está en
3735 relación con el punto de referencia de la nota a la que está unida la
3736 ligadura, y la coordenada@tie{}Y está en relación con la línea central
3737 del pentagrama. Las coordenadas se introducen como una lista de
3738 cuatro parejas de números decimales (reales). Un enfoque es estimar
3739 las coordenadas de los dos puntos extremos, y luego tratar de adivinar
3740 los dos puntos intermedios. Los valores óptimos se encuentran por
3743 Es útil recordar que una curva simétrica necesita puntos de control
3744 simétricos, y que las curvas de Bézier tienen la útil propiedad de que
3745 las transformaciones de la curva tales como la traslación, rotación y
3746 escalado se pueden obtener aplicando la misma transformación a los
3747 puntos de control de la curva.
3749 Para el ejemplo anterior, la sobreescritura siguiente da una ligadura
3750 satisfactoria. Observe la colocación: debe ir inmediatamente antes de
3751 la nota a la que se asigna el comienzo de la ligadura de expresión o
3754 @lilypond[verbatim,quote,relative=1]
3758 #'control-points = #'((1 . -1) (3 . 0.6) (12.5 . 0.6) (14.5 . -1))
3762 { r4 <g c,> <g c,> <g c,> }
3767 No es posible modificar la forma de las ligaduras de unión o de
3768 expresión cambiando la propiedad @code{control-points} si hay más de
3769 una en el mismo momento musical, ni siquiera usando la instrucción
3770 @code{\tweak}. Sin embargo, se puede sobreescribir la propiedad @code{tie-configuration} de
3771 @code{TieColumn} para fijar la línea de inicio y la dirección según se requiera.
3774 Referencia de funcionamiento interno:
3775 @rinternals{TieColumn}.
3778 @node Uso de las funciones musicales
3779 @section Uso de las funciones musicales
3780 @translationof Using music functions
3782 @c TODO -- add @seealso, etc. to these subsections
3784 Dondequiera que se necesite reutilizar trucos con distintas
3785 expresiones musicales, con frecuencia conviene hacer que el truco
3786 forme parte de una @emph{función musical}. En esta sección
3787 estudiaremos solamente las funciones de @emph{sustitución}, en las que
3788 el objeto es sustituir una variable dentro de un fragmento de código
3789 de entrada de LilyPond. Se describen otras funciones más complejas en
3790 @rextend{Funciones musicales}.
3793 * Sintaxis de las funciones de sustitución::
3794 * Ejemplos de funciones de sustitución::
3797 @node Sintaxis de las funciones de sustitución
3798 @subsection Sintaxis de las funciones de sustitución
3799 @translationof Substitution function syntax
3801 Es fácil hacer una función que sustituya una variable dentro de código
3802 de LilyPond. La forma general de estas funciones es
3806 #(define-music-function
3807 (parser location @var{arg1} @var{arg2} @dots{})
3808 (@var{type1?} @var{type2?} @dots{})
3810 @var{@dots{}música@dots{}}
3817 @multitable @columnfractions .33 .66
3818 @item @code{@var{argN}}
3819 @tab @var{n}-ésimo argumento
3821 @item @code{@var{typeN?}}
3822 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
3823 debe devolver @code{#t}.
3825 @item @code{@var{@dots{}música@dots{}}}
3826 @tab entrada de LilyPond normal, que utiliza @code{$} para
3827 referenciar argumentos (p.ej. @samp{$arg1}).
3831 Los argumentos @code{parser} y @code{location} son necesarios, y se
3832 utilizan en algunas situaciones avanzadas como se encuentra descrito
3833 en @rextend{Sintaxis de las funciones musicales}. Para las funciones
3834 de sustitución, tan sólo hemos de asegurarnos de incluirlos.
3836 También es necesaria la lista de predicados de tipo. Algunos de los
3837 predicados de tipo más comunes que se utilizan en las funciones
3842 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
3852 Para ver una lista de los predicados de tipo disponibles, consulte
3853 @ref{Predicados de tipo predefinidos}. También se permiten los
3854 predicados de tipo definidos por el usuario.
3859 Referencia de la notación:
3860 @ref{Predicados de tipo predefinidos}.
3862 Expansión de LilyPond:
3863 @rextend{Sintaxis de las funciones musicales}.
3865 Archivos instalados:
3866 @file{lily/music-scheme.cc},
3868 @file{scm/lily.scm}.
3871 @node Ejemplos de funciones de sustitución
3872 @subsection Ejemplos de funciones de sustitución
3873 @translationof Substitution function examples
3875 Esta sección presenta algunos ejemplos de funciones de sustitución.
3876 No pretenden ser exhaustivas, sino demostrar algunas de las
3877 posibilidades de las funciones de sustitución sencillas.
3879 En el primer ejemplo se define una función que simplifica el ajuste
3880 del relleno de un elemento de inscripción de texto TextScript:
3882 @lilypond[quote,verbatim,ragged-right]
3884 #(define-music-function
3885 (parser location padding)
3888 \once \override TextScript #'padding = $padding
3892 c4^"piu mosso" b a b
3894 c4^"piu mosso" d e f
3896 c4^"piu mosso" fis a g
3900 Además de números, podemos usar expresiones musicales, como notas,
3901 para los argumentos de las funciones musicales:
3903 @c TODO: use a better example (the music argument is redundant).
3905 @lilypond[quote,verbatim,ragged-right]
3907 #(define-music-function
3908 (parser location note)
3911 \once \override Voice.NoteHead #'stencil =
3912 #ly:text-interface::print
3913 \once \override Voice.NoteHead #'text =
3914 \markup \musicglyph #"custodes.mensural.u0"
3915 \once \override Voice.Stem #'stencil = ##f
3919 \relative c' { c4 d e f \custosNote g }
3922 Se pueden definir funciones de sustitución con más de un argumento:
3924 @lilypond[quote,verbatim,ragged-right]
3926 #(define-music-function
3927 (parser location padding tempotext)
3930 \once \override Score.MetronomeMark #'padding = $padding
3931 \tempo \markup { \bold $tempotext }
3935 \tempo \markup { "Low tempo" }
3937 \tempoPadded #4.0 #"High tempo"
3942 @c TODO: add appropriate @@ref's here.