1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 4e7839892d676e4863e07e11ea4968cffe34f97f
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/@/internals/,en@tie{}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::
67 * Crear y referenciar 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 * Orden de disposición de los contextos::
76 Manual de aprendizaje:
77 @rlearning{Contextos y grabadores}.
80 @file{ly/engraver-init.ly},
81 @file{ly/performer-init.ly}.
84 @rlsr{Contexts and engravers}.
86 Referencia de funcionamiento interno:
87 @rinternals{Contexts},
88 @rinternals{Engravers and Performers}.
91 @node Explicación de los contextos
92 @subsection Explicación de los contextos
93 @translationof Contexts explained
95 Los contextos se disponen de forma jerárquica:
98 * Score. El contexto maestro::
99 * Contextos del nivel superior. Contenedores de pentagramas::
100 * Contextos de nivel intermedio. Pentagramas::
101 * 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
120 @node Contextos del nivel superior. Contenedores de pentagramas
121 @unnumberedsubsubsec Contextos del nivel superior: contenedores de pentagramas
122 @translationof Top-level contexts - staff containers
124 @strong{@emph{StaffGroup}}
126 Agrupa pentagramas y añade un corchete en la parte izquierda, formando
127 un grupo. Las líneas divisorias de los pentagramas contenidos se
128 conectan verticalmente. @code{StaffGroup} sólo consiste en una
129 colección de pentagramas, con un corchete delante y líneas divisorias
132 @strong{@emph{ChoirStaff}}
134 Idéntico a @code{StaffGroup} excepto que las barras de compás de los
135 pentagramas contenidos no se conectan verticalmente.
137 @strong{@emph{GrandStaff}}
139 Un grupo de pentagramas, con una llave en la parte izquierda que
140 abarca el grupo. Las barras de compás de los pentagramas contenidos
141 se conectan verticalmente.
143 @strong{@emph{PianoStaff}}
145 Igual que @code{GrandStaff}, pero contempla la posibilidad de poner el
146 nombre del instrumento a la izquierda del sistema.
149 @node Contextos de nivel intermedio. Pentagramas
150 @unnumberedsubsubsec Contextos de nivel intermedio. Pentagramas
151 @translationof Intermediate-level contexts - staves
153 @strong{@emph{Staff}}
155 Maneja claves, barras de compás, tonalidades y alteraciones
156 accidentales. Puede contener contextos de @code{Voice}.
158 @strong{@emph{RhythmicStaff}}
160 Como @code{Staff}, pero para imprimir ritmos. Se ignoran las alturas
161 de las notas; las notas se imprimen sobre una línea.
163 @strong{@emph{TabStaff}}
165 Contexto para generar tablaturas. De forma predeterminada dispone la
166 expresión musical como una tablatura de guitarra, impresa sobre seis
169 @strong{@emph{DrumStaff}}
171 Maneja el tipografiado para instrumentos de percusión. Puede contener
172 contextos @code{DrumVoice}.
174 @strong{@emph{VaticanaStaff}}
176 Igual que @code{Staff}, excepto que está pensado para tipografiar
177 piezas en estilo gregoriano.
179 @strong{@emph{MensuralStaff}}
181 Igual que @code{Staff}, excepto que está diseñado para tipografiar
182 piezas en estilo mensural.
185 @node Contextos del nivel más bajo. Voces
186 @unnumberedsubsubsec Contextos del nivel más bajo. Voces
187 @translationof Bottom-level contexts - voices
189 Los contextos del mismo nivel que Voice dan un valor inicial a
190 ciertas propiedades e inician los grabadores correspondientes. Un
191 contexto del nivel más bajo es aquel que no tiene un contexto
192 descendiente predeterminado @code{defaultchild}. Aunque es
193 posible hacer que pueda aceptar o contener subcontextos, éstos
194 solo se pueden crear e introducir de forma explícita.
196 @strong{@emph{Voice}}
198 Corresponde a una voz sobre un pentagrama. este contexto maneja la
199 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
200 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
201 que crear instancias explícitas de este contexto si necesitamos varias
202 voces en el mismo pentagrama.
204 @strong{@emph{VaticanaVoice}}
206 Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
207 piezas en estilo gregoriano.
209 @strong{@emph{MensuralVoice}}
211 Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
212 piezas en estilo mensural.
214 @strong{@emph{Lyrics}}
216 Corresponde a una voz con letra. Maneja la impresión de una sola
219 @strong{@emph{DrumVoice}}
221 El contexto de voz utilizado en una pauta de percusión.
223 @strong{@emph{FiguredBass}}
225 El contexto en que los objetos @code{BassFigure} se crean a partir de
226 la entrada escrita en el modo @code{\figuremode}.
228 @strong{@emph{TabVoice}}
230 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
231 Se suele dejar que se cree implícitamente.
233 @strong{@emph{CueVoice}}
235 El contexto de voz que se utiliza para dibujar notas de tamaño
236 reducido, con el principal objetivo de añadir notas guía de un
237 pentagrama a otro, véase @ref{Formateo de las notas guía}.
238 Normalmente se deja que se cree implícitamente.
240 @strong{@emph{ChordNames}}
242 Tipografía nombres de acordes.
245 @node Crear y referenciar contextos
246 @subsection Crear y referenciar contextos
247 @translationof Creating and referencing contexts
251 @cindex nuevos contextos
252 @cindex contextos, creación y referenciación de
253 @cindex referenciar contextos
255 LilyPond crea automáticamente contextos de nifel inferior si se
256 encuentra una expresión musical antes de que exista un contexto
257 adecuado, pero normalmente esto sólo funciona bien para partituras
258 sencillas o fragmentos musicales como los que aparecen en la
259 documentación. Para partituras más complejas, se recomienda
260 especificar explícitamente todos los contextos con las
261 instrucciones @code{\new} o @code{\context}. La sintaxis de estas
262 dos instrucciones es muy similar:
265 [\new | \context] @var{Contexto} [ = @var{nombre}] [@var{expresión_musical}]
269 donde se puede especificar @code{\new} o @code{\context}.
270 @var{Contexto} es el tipo de contexto que se desea crear,
271 @var{nombre} es un nombre opcional que se da al contexto concreto
272 que se está creando, y @var{expresión_musical} es una sola
273 expresión musical que será interpretada por los complementos
274 grabadores y reproductores dentro de este contexto.
276 El prefijo @code{\new} sin ningún nombre se usa con frecuencia
277 para crear partituras con muchos pentagramas:
279 @lilypond[quote,verbatim,relative=2]
282 % leave the Voice context to be created implicitly
292 y para introducir varias voces dentro de un solo pentagrama:
294 @lilypond[quote,verbatim,relative=2]
310 @code{\new} debería usarse siempre para especificar contextos sin
313 La diferencia entre @code{\new} y @code{\context} se encuentra en
314 la acción que se realiza:
318 @code{\new} con un nombre o sin él, siempre crea un contexto nuevo
319 y distinto, incluso si ya existe un contexto con el mismo nombre:
321 @lilypond[quote,verbatim,relative=2]
337 @code{\context} con un nombre especificado, crea un contexto nuevo
338 solamente si no existe ya un contexto del mismo tipo y con el
339 mismo nombre, dentro de la misma jerarquía de contextos. En caso
340 contrario, se toma como referencia a dicho contexto creado
341 previamente, y su expresión musical se pasa a este contexto para
344 Una aplicación de los contextos con nombre es la separación entre
345 la disposición de la partitura y el contenido musical. Son
346 válidas culaquiera de las dos formas siguientes:
348 @lilypond[quote,verbatim]
362 \context Voice = "one" {
367 \context Voice = "two" {
376 @lilypond[quote,verbatim]
381 \context Voice = "one" {
384 \context Voice = "two" {
390 \context Voice = "one" {
395 \context Voice = "two" {
405 De manera alternativa, se pueden utilizar variables con un efecto
406 similar. Véase @rlearning{Organizar las piezas mediante variables}.
410 @code{\context} sin ningún nombre corresponderá con el primer
411 contexto que se encuentre entre los creados previamente que sean
412 del mismo tipo dentro de la misma jerarquía de contextos, incluso
413 si tiene nombre, y su expresión musical se pasará a dicho contexto
414 para su interpretación. Esta forma rara vez es útil. Sin
415 embargo, @code{\context} sin nombre y sin expresión musical se usa
416 para establecer el contexto en que se ejecuta un procedimiento de
417 Scheme especificado con @code{\applyContext}:
420 \new Staff \relative c' @{
423 \applyContext #(lambda (ctx)
425 (display (ly:context-current-moment ctx)))
432 Un contexto debe tener un nombre si se va a hacer referencia a él
433 más tarde, por ejemplo cuando se asocia la letra con la música:
436 \new Voice = "tenor" @var{música}
438 \new Lyrics \lyricsto "tenor" @var{letra}
442 Para ver más detalles sobre la asociación de letra y música,
443 consulte @ref{Duración automática de las sílabas}.
445 Las propiedades de todos los contextos de un tipo en particular se
446 pueden modificar dentro de un bloque @code{\layout} (con una
447 sintaxis diferente), véase @ref{Cambiar todos los contextos del mismo tipo}.
449 Esta construcción también ofrece una forma de mantener las
450 instrucciones de disposición separadas del contenido musical. Si
451 se va a modificar un solo contexto, debe usarse un bloque
452 @code{\with}, véase @ref{Cambiar solamente un contexto determinado}.
456 Manual de aprendizaje:
457 @rlearning{Organizar las piezas mediante variables}.
459 Referencia de la notación:
460 @ref{Cambiar solamente un contexto determinado},
461 @ref{Duración automática de las sílabas}.
464 @node Mantener vivos los contextos
465 @subsection Mantener vivos los contextos
466 @translationof Keeping contexts alive
468 @cindex contextos, mantener vivos
469 @cindex contextos, tiempo de vida
471 Normalmente los contextos finalizan en el primer momento musical en
472 que no tienen nada que hacer. Así, los contextos de @code{Voice}
473 mueren tan pronto como ya no contienen ningún evento; los contextos de
474 @code{Staff} mueren tan pronto como todos los contextos de
475 @code{Voice} que contenían ya no contengan ningún evento; etc. Esto
476 puede ocasionar dificultades si se tiene que hacer referencia a
477 contextos anteriores que ya han muerto, por ejemplo, al cambiar de
478 pentagramas con instrucciones @code{\change}, asociar letra con una
479 voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
480 eventos musicales adicionales a un contexto anterior.
482 Existe una excepción a esta regla general: precisamente uno de los
483 contextos de @code{Voice} que están dentro de un contexto de
484 @code{Staff} o de una construcción @code{<<@dots{}>>} persiste siempre
485 hasta el final de, contexto de @code{Staff} circundante o la
486 construcción @code{<<@dots{}>>}, incluso aunque puede haber períodos en
487 que no tiene nada que hacer. El contexto que persiste de esta forma
488 será el primero que se encuentre en la primera construcción encerrada
489 entre llaves @code{@{@dots{}@}}, ignorando cualquiera que se encuentre
490 dentro de construcciones encerradas por ángulos dobles @code{<<@dots{}>>}.
492 Cualquier contexto se puede mantener vivo si nos aseguramos de que
493 tiene algo que hacer en cualquier momento musical dado. Los
494 contextos de @code{Staff} se mantienen con vida si nos aseguramos de
495 que una de sus voces se mantiene viva. Una manera de hacerlo es
496 añadir silencios de separación a una voz en paralelo con la música
497 real. Éstos deben añadirse a todos y cada uno de los contextos de
498 @code{Voice} que se hayan de mantener vivos. Si se van a usar
499 esporádicamente varias voces, es más seguro mantenerlas todas vivas en
500 lugar de tratar de confiar en las excepciones que hemos mencionado
503 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
504 vivas de esta manera durante la duración de la pieza:
506 @lilypond[quote,verbatim]
507 musicA = \relative c'' { d4 d d d }
508 musicB = \relative c'' { g4 g g g }
511 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
512 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
517 \context Voice = "A" {
521 \context Voice = "B" {
525 \context Voice = "A" { \musicA }
526 \context Voice = "B" { \musicB }
527 \context Voice = "A" { \musicA }
538 @cindex letra, alineación con melodía esporádica
540 El ejemplo siguiente muestra cómo se puede escribir una línea melódica
541 esporádica con letra utilizando este enfoque. Por supuesto, en una
542 situación real la melodía y el acompañamiento consistirían en varias
543 secciones diferentes.
545 @lilypond[quote,verbatim]
546 melody = \relative c'' { a4 a a a }
547 accompaniment = \relative c' { d4 d d d }
548 words = \lyricmode { These words fol -- low the mel -- o -- dy }
551 \new Staff = "music" {
553 \new Voice = "melody" {
555 s1*4 % Keep Voice "melody" alive for 4 bars
558 \new Voice = "accompaniment" {
563 \context Voice = "melody" { \melody }
564 \context Voice = "accompaniment" { \accompaniment }
566 \context Voice = "accompaniment" { \accompaniment }
568 \context Voice = "melody" { \melody }
569 \context Voice = "accompaniment" { \accompaniment }
574 \new Lyrics \with { alignAboveContext = #"music" }
575 \lyricsto "melody" { \words }
580 Una forma alternativa, que podría resultar mejor en muchas
581 situaciones, es mantener con vida la línea melódica simplemente
582 incluyendo notas espaciadoras para alinearla correctamente con el
585 @lilypond[quote,verbatim]
586 melody = \relative c'' {
592 accompaniment = \relative c' {
598 words = \lyricmode { These words fol -- low the mel -- o -- dy }
602 \new Staff = "music" {
604 \new Voice = "melody" {
608 \new Voice = "accompaniment" {
614 \new Lyrics \with { alignAboveContext = #"music" }
615 \lyricsto "melody" { \words }
621 @node Modificar los complementos (plug-ins) de contexto
622 @subsection Modificar los complementos (plug-ins) de contexto
623 @translationof Modifying context plug-ins
625 @c TODO Should this be Modifying engravers or Modifying contexts?
627 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
628 almacenan propiedades, también contienen «plug-ins» o complementos
629 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
630 el contexto @code{Voice} contiene un grabador
631 @code{Note_heads_engraver} que crea las cabezas de nota y el contexto
632 @code{Staff} contiene un grabador @code{Key_engraver} que
635 Para ver una descripción completa de todos y cada uno de los
636 complementos, consulte
638 @rinternals{Engravers and Performers}.
641 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
643 Cada contexto que se describe en
645 @rinternals{Contexts}
648 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
650 relaciona los grabadores que se usan para ese contexto.
653 Puede ser de utilidad jugar un poco con estos complementos. Se hace
654 iniciando un contexto nuevo con @code{\new} o @code{\context} y
660 \new @var{contexto} \with @{
668 @emph{@dots{}música@dots{}}
673 donde los @dots{} deben ser el nombre de un grabador. Aquí tenemos un
674 ejemplo sencillo que suprime los grabadores
675 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
678 @lilypond[quote,relative=1,verbatim]
684 \remove "Time_signature_engraver"
685 \remove "Clef_engraver"
692 En el segundo pentagrama no hay indicación de compás ni clave. Éste
693 es un método bastante rudimentario de hacer que desaparezcan los
694 objetos porque afecta a todo el pentagrama. Este método también
695 afecta al espaciado, lo que puede ser deseable o no serlo. Se
696 muestran métodos más sofisticados para quitar objetos en
697 @rlearning{Visibilidad y color de los objetos}.
699 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
700 líneas divisorias y las indicaciones de compás están sincronizadas a
701 lo largo de toda la partitura. Lo hacen los grabadores
702 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
703 complementos mantienen al día la administración de las indicaciones de
704 compás, posición dentro del compás, etc. Moviendo estos grabadores
705 desde el contexto de @code{Score} al de @code{Staff}, podemos
706 conseguir una partitura en la que cada pentagrama tiene su propio
707 compás independiente.
709 @cindex polimétricas, partituras
710 @cindex compases distintos al mismo tiempo
712 @lilypond[quote,verbatim]
716 \consists "Timing_translator"
717 \consists "Default_bar_line_engraver"
723 \consists "Timing_translator"
724 \consists "Default_bar_line_engraver"
733 \remove "Timing_translator"
734 \remove "Default_bar_line_engraver"
742 El orden en que los grabadores se especifican es el orden en que se
743 llaman para realizar su tarea de procesamiento. Normalmente, el orden
744 en que se especifican los grabadores no tiene importancia, pero en
745 algunos casos especiales sí la tiene, por ejemplo donde un grabador
746 escribe una propiedad y otro la lee, o donde un grabador crea un groby
747 otro debe procesarlo.
749 Las siguientes ordenaciones son importantes:
753 el grabador de compases @code{Bar_engraver} debe ir normalmente en
757 el grabador de digitaciones @code{New_fingering_engraver} debe ir
758 antes del grabador @code{Script_column_engraver} de columnas de
762 el @code{Timing_translator} debe ir antes del grabador de números de
763 compás @code{Bar_number_engraver}.
769 @file{ly/engraver-init.ly}.
772 @node Cambiar los valores por omisión de los contextos
773 @subsection Cambiar los valores por omisión de los contextos
774 @translationof Changing context default settings
776 @cindex predeterminadas, cambio de propiedades de contexto
777 @cindex contexto, cambiar propiedades predeterminadas de
779 Se pueden cambiar las propiedades de contexto y de grob con las
780 instrucciones @code{\set} y @code{\override}, tal y como se describe
781 en @ref{Modificar las propiedades}. Estas instrucciones crean eventos
782 musicales, haciendo que los cambios tengan efecto en el punto temporal
783 en que la música se está procesando.
785 Por contra, esta sección explica la forma de cambiarlos valores
786 @emph{predeterminados} de las propiedades de contexto y de grob en el
787 momento en que se crea el contexto. Existen dos formas de hacerlo.
788 Una modifica los valores predeterminados en todos los contextos de un
789 tipo dado, y el otro modifica los valores predeterminados solamente en
790 una instancia concreta de un contexto.
793 * Cambiar todos los contextos del mismo tipo::
794 * Cambiar solamente un contexto determinado::
795 * Orden de precedencia::
798 @node Cambiar todos los contextos del mismo tipo
799 @unnumberedsubsubsec Cambiar todos los contextos del mismo tipo
800 @translationof Changing all contexts of the same type
802 @cindex \context dentro de un bloque \layout
806 Los ajustes de contexto que se han de usar de forma predeterminada
807 dentro de @code{Score}, @code{Staff}, @code{Voice} y otros contextos
808 se pueden especificar en un bloque @code{\context} dentro de cualquier
809 bloque @code{\layout}. El bloque @code{\layout} se debe colocar
810 dentro del bloque @code{\score} al que se aplica, después de la
817 [ajustes de contexto para todos los contextos Voice]
821 [ajustes de contexto para todos los contextos Staff]
826 Se pueden especificar los siguientes tipos de ajustes:
830 Una instrucción @code{\override}, pero omitiendo el nombre del contexto
832 @lilypond[quote,verbatim]
835 a4^"Thicker stems" a a a
841 \override Stem.thickness = #4.0
848 Estableciendo una propiedad de contexto directamente
850 @lilypond[quote,verbatim]
853 a4^"Smaller font" a a a
866 Una instrucción predefinida tal como @code{\dynamicUp} o una expresión
867 musical como @code{\accidentalStyle dodecaphonic}
869 @lilypond[quote,verbatim]
872 a4^"Dynamics above" a a a
882 \accidentalStyle dodecaphonic
889 Una variable definida por el usuario que contenga un bloque
890 @code{\with}; para ver detalles acerca del bloque @code{\with},
891 consulte @ref{Cambiar solamente un contexto determinado}.
893 @lilypond[quote,verbatim]
894 StaffDefaults = \with {
901 a4^"Smaller font" a a a
916 Las instrucciones de ajuste de propiedades se pueden disponer dentro
917 de un bloque @code{\layout} sin que estén encerradas en un bloque
918 @code{\context}. Tales ajustes son equivalentes a incluir las mismas
919 instrucciones de ajuste de propiedades al comienzo de cada uno de los
920 contextos del tipo especificado. Si no se especifica ningún contexto,
921 @emph{todos y cada uno} de los contextos del nivel inferior quedan
922 afectados, véase @ref{Contextos del nivel más bajo. Voces}. La
923 sintaxis de una instrucción de ajuste de propiedades dentro de un
924 bloque @code{\layout} es la misma que si la misma instrucción
925 estuviera escrita en el propio flujo musical.
927 @lilypond[quote,verbatim]
931 a4^"Smaller font" a a a
936 \accidentalStyle dodecaphonic
938 \override Voice.Stem.thickness = #4.0
944 @node Cambiar solamente un contexto determinado
945 @unnumberedsubsubsec Cambiar solamente un contexto determinado
946 @translationof Changing just one specific context
951 Las propiedades de contexto de una única instancia de contexto pueden
952 cambiarse dentro de un bloque @code{\with}. Todas las demás
953 instancias de contexto del mismo tipo retienen los ajustes
954 predeterminados que LilyPond tiene programados y que se modifican por
955 parte de cualquier bloque @code{\layout} que se encuentre dentro del
956 ámbito. El bloque @code{\with} se debe situar inmediatamente después
957 de las instrucciones @code{\new} @var{context-type}:
962 [ajustes de contexto para esta única instancia de contexto]
968 Se pueden especificar los siguientes tipos de ajustes:
972 Una instrucción @code{\override}, pero omitiendo el nombre del
975 @lilypond[quote,verbatim]
980 \override Stem.thickness = #4.0
984 a4^"Thick stems" a a a
993 Estableciendo una propiedad de contexto directamente
995 @lilypond[quote,verbatim]
1000 a4^"Default font" a a a
1009 a4^"Smaller font" a a a
1018 Una instrucción predefinida tal como @code{\dynamicUp}
1020 @lilypond[quote,verbatim]
1026 a4^"Dynamics below" a a a
1032 \with { \accidentalStyle dodecaphonic }
1035 \with { \dynamicUp }
1038 a4^"Dynamics above" a a a
1049 @node Orden de precedencia
1050 @unnumberedsubsubsec Orden de precedencia
1051 @translationof Order of precedence
1053 El valor de una propiedad que se aplica en un momento determinado se
1054 determina de la siguiente forma:
1058 si está en efecto una instrucción @code{\override} o @code{\set}
1059 dentro del flujo musical, se usa dicho valor,
1062 de lo contrario, se usa el valor predeterminado tomado de un enunciado
1063 @code{\with} en las instrucciones de inicio del contexto,
1066 de lo contrario, se usa el valor tomado del bloque @code{\context} más
1067 reciente que corresponda dentro de los bloques @code{\layout},
1070 de lo contrario se usa el valor predeterminado que LilyPond lleva
1075 Manual de aprendizaje:
1076 @rlearning{Modificar las propiedades de los contextos}.
1078 Referencia de la notación:
1079 @ref{Explicación de los contextos},
1080 @ref{Contextos del nivel más bajo. Voces},
1081 @ref{La instrucción set},
1082 @ref{La instrucción override},
1083 @ref{El bloque \layout}.
1086 @node Definir contextos nuevos
1087 @subsection Definir contextos nuevos
1088 @translationof Defining new contexts
1090 @cindex contextos, definición de nuevos
1091 @cindex grabadores, incluir en contextos
1106 Los contextos específicos, como @code{Staff} y @code{Voice}, están
1107 construidos a partir de bloques sencillos. Es posible crear nuevos
1108 tipos de contextos con combinaciones distintas de añadidos grabadores.
1110 El siguiente ejemplo muestra cómo construir un tipo diferente de
1111 contexto de @code{Voice} partiendo de cero. Será parecido a
1112 @code{Voice}, pero imprime solamente cabezas centradas en forma de
1113 barra inclinada. Se puede usar para indicar improvisación en piezas
1116 @lilypond[quote,ragged-right]
1117 \layout { \context {
1119 \type "Engraver_group"
1120 \consists "Note_heads_engraver"
1121 \consists "Rhythmic_column_engraver"
1122 \consists "Text_engraver"
1123 \consists "Pitch_squash_engraver"
1124 squashedPosition = #0
1125 \override NoteHead.style = #'slash
1126 \override Stem.transparent = ##t
1130 \accepts "ImproVoice"
1134 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
1135 c4 c^"undress" c_"while playing :)" c }
1141 Estos ajustes se definen dentro de un bloque @code{\context} que a su
1142 vez está dentro de un bloque @code{\layout},
1152 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
1153 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
1155 En primer lugar es necesario definir un nombre para el nuevo contexto:
1161 Debido a que es parecido al contexto @code{Voice}, queremos
1162 órdenes que funcionen dentro de los contextos @code{Voice}
1163 (existentes) para que siga funcionando. Esto se consigue dando al
1164 contexto nuevo un alias de @code{Voice},
1170 El contexto imprimirá notas y textos explicativos, por ello
1171 tenemos que añadir los grabadores que aportan esta funcionalidad,
1172 y además el grabador que agrupa las notas, plicas y silencios que
1173 están en el mismo momento musical en forma de columnas,
1176 \consists "Note_heads_engraver"
1177 \consists "Text_engraver"
1178 \consists "Rhythmic_column_engraver"
1181 Las cabezas de todas las notas se deben situar sobre la línea
1185 \consists "Pitch_squash_engraver"
1186 squashedPosition = #0
1189 El grabador @code{Pitch_squash_engraver} modifica las cabezas de
1190 nota (creadas por el grabador @code{Note_heads_engraver}) y
1191 establece sus posiciones verticales al valor de
1192 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea
1195 Las notas parecen barras inclinadas y no tienen plica:
1198 \override NoteHead.style = #'slash
1199 \override Stem.transparent = ##t
1202 Todos estos añadidos tienen que cooperar, y esto se consigue con un
1203 añadido especial, que se debe marcar con la palabra clave
1204 @code{\type}. Este será siempre @code{Engraver_group},
1207 \type "Engraver_group"
1210 Al juntarlo todo, obtenemos
1215 \type "Engraver_group"
1216 \consists "Note_heads_engraver"
1217 \consists "Text_engraver"
1218 \consists "Rhythmic_column_engraver"
1219 \consists "Pitch_squash_engraver"
1220 squashedPosition = #0
1221 \override NoteHead.style = #'slash
1222 \override Stem.transparent = ##t
1228 Los contextos dan lugar a jerarquías. Queremos poner el contexto
1229 @code{ImproVoice} dentro del contexto @code{Staff}, igual que los contextos
1230 de voz normales. Por tanto, modificamos la definición de
1231 @code{Staff} con la instrucción @code{\accepts} (acepta),
1241 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
1242 que a veces se necesita cuando se están reutilizando definiciones de
1243 contexto existentes.
1245 Ponemos ambos dentro de un bloque @code{\layout}, como
1255 \accepts "ImproVoice"
1260 Así pues, la salida que aparece al comienzo de esta sub-sección se
1269 c c_"mientras tocas :)"
1277 Referencia de funcionamiento interno:
1278 @rinternals{Engraver_group},
1279 @rinternals{Note_heads_engraver},
1280 @rinternals{Text_engraver},
1281 @rinternals{Rhythmic_column_engraver},
1282 @rinternals{Pitch_squash_engraver}.
1285 @node Orden de disposición de los contextos
1286 @subsection Orden de disposición de los contextos
1287 @translationof Context layout order
1289 @cindex contextos, orden de disposición
1293 Los contextos se disponen en un sistema normalmente desde arriba hacia
1294 abajo en el orden en que se encuentran en el archivo de entrada.
1295 Cuando los contextos se anidan unos dentro de otros, el contexto
1296 exterior incluye a los contextos anidados tal y como se especifica en
1297 el archivo de entrada, siempre y cuando los contextos interiores estén
1298 incluidos en la lista @qq{accepts} del contexto externo. Los
1299 contextos anidados que no está nincluidos en la lista @qq{accepts} del
1300 contexto externo se recolocan debajo del contexto externo en lugar de
1301 anidarse dentro de él.
1303 La lista @qq{accepts} de un contexto se puede cambiar con las
1304 instrucciones @code{\accepts} (acepta) y @code{\denies} (niega).
1305 @code{\accepts} añade un contexto a la lista @qq{accepts} y
1306 @code{\denies} elimina un contexto de la lista. Por ejemplo,
1307 normalmente no sería deseable que los acordes de cifrado americano
1308 estuvieran anidados dentro de un contexto @code{Staff}, por lo que el
1309 contexto @code{ChordNames} no se incluye de forma predeterminada
1310 dentro de la lista @qq{accepts} del contexto @code{Staff}, pero podría
1311 hacerse si fuera necesario:
1313 @lilypond[verbatim,quote]
1317 \chords { d1:m7 b1:min7.5- }
1322 @lilypond[verbatim,quote]
1326 \chords { d1:m7 b1:min7.5- }
1331 \accepts "ChordNames"
1337 @code{\denies} se usa principalmente cuando un contexto nuevo se está
1338 basando en otro, pero los anidamientos requeridos difieren. Por
1339 ejemplo, el contexto @code{VaticanaStaff} está basado en el contexto
1340 @code{Staff}, pero con el contexto @code{VaticanaVoice} sustituido por
1341 el contexto @code{Voice} en la lista @qq{accepts}.
1344 @cindex contextos implícitos
1345 @cindex implícitos, contextos
1346 @funindex \defaultchild
1348 Observe que discretamente se crea un contexto de forma implícita
1349 si se encuentra una instrucción donde no hay un contexto apropiado
1352 Dentro de una definición de contexto, el tipo de un subcontexto
1353 que se va a crear implícitamente se especifica usando
1354 @code{\defaultchild} (hijo predeterminado). Algunos eventos
1355 musicales requieren un contexto @samp{Bottom} (inferior): cuando
1356 se encuentra este evento, se crean subcontextos de forma recursiva
1357 hasta que se alcanza un contexto que no tiene establecido el
1358 @samp{defaultchild}.
1360 La creación implícita de contextos puede dar lugar a pentagramas o
1361 partituras nuevos no esperados. La utilización de @code{\new}
1362 para crear contextos explícitamente evita esos problemas.
1364 @cindex alignAboveContext
1365 @cindex alignBelowContext
1366 @funindex alignAboveContext
1367 @funindex alignBelowContext
1369 En ocasiones se necesita que un contexto exista durante un breve
1370 intervalo de tiempo, siendo un buen ejemplo el contexto de
1371 pentagrama de un ossia. Esto se consigue normalmente mediante la
1372 introducción de la definición del contexto en el lugar apropiado
1373 en paralelo con la sección correspondiente de la música principal.
1374 De forma predeterminada, el contexto tempral se coloca debajo de
1375 todos los contextos existentes. Para reposicionarlo por encima
1376 del contexto que tenga el nombre @qq{principal}, debería definirse
1380 @code{\new Staff \with @{ alignAboveContext = #"principal" @} }
1383 Se presenta una situación similar cuando se posiciona un contexto
1384 temporal de letra de una canción dentro de una disposición de varios
1385 pentagramas tal como @code{ChoirStaff}, por ejemplo, cuando se añade
1386 una segunda estrofa a una sección que se repite. De forma
1387 predeterminada, el contexto temporal de letra se coloca debajo de los
1388 pentagramas inferiores. Mediante la definición del contexto temporal
1389 de letra con @code{alignBelowContext} se puede posicionar
1390 correctamente debajo del contexto de letra con nombre que contiene el
1391 texto de la primera estrofa.
1393 En diversos lugares pueden verse ejemplos que muestran esta
1394 recolocación de contextos temporales: véase
1395 @rlearning{Anidado de expresiones musicales},
1396 @ref{Modificación de pentagramas sueltos} y
1397 @ref{Técnicas específicas para la letra}.
1400 Manual de aprendizaje:
1401 @rlearning{Anidado de expresiones musicales}.
1403 Referencia de la notación:
1404 @ref{Modificación de pentagramas sueltos},
1405 @ref{Técnicas específicas para la letra}.
1407 Manual de utilización del programa:
1408 @rprogram{Aparece un pentagrama de más}.
1410 Archivos instalados:
1411 @file{ly/engraver-init.ly}.
1414 @node Explicación del Manual de referencia de funcionamiento interno
1415 @section Explicación del Manual de referencia de funcionamiento interno
1416 @translationof Explaining the Internals Reference
1419 * Navegar por la referencia del programa::
1420 * Interfaces de la presentación::
1421 * Determinar la propiedad del grob::
1422 * Convenciones de nombres::
1427 @node Navegar por la referencia del programa
1428 @subsection Navegar por la referencia del programa
1429 @translationof Navigating the program reference
1431 Supongamos que queremos mover la indicación de digitación del
1432 fragmento siguiente:
1434 @lilypond[quote,relative=2,verbatim]
1440 Si hace una visita a la documentación en busca de instrucciones de
1441 digitación (en @ref{Indicaciones de digitación}), encontrará:
1444 @strong{Véase también}
1446 Referencia de funcionamiento interno: @rinternals{Fingering}.
1451 La referencia del programador se encuentra disponible en forma de
1452 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
1453 en línea o bien descargando los archivos de la documentación HTML.
1454 Esta sección sería mucho más difícil de entender si está utilizando el
1455 manual en formato PDF.
1458 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
1462 Los objetos de digitación se crean por parte de:
1463 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1466 Siguiendo los enlaces relacionados dentro de la referencia del
1467 programa, podemos seguir el flujo de información dentro del programa:
1471 @item @rinternals{Fingering}:
1472 los objetos @rinternals{Fingering} se crean por parte de:
1473 @rinternals{Fingering_engraver}
1475 @item @rinternals{Fingering_engraver}:
1476 Tipos de música aceptados: @rinternals{fingering-event}
1478 @item @rinternals{fingering-event}:
1479 El tipo de evento musical @code{fingering-event} está descrito en
1480 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1483 Este camino se recorre en contra de la corriente de información del
1484 programa: comienza por la salida y acaba en el evento de entrada.
1485 También podríamos haber empezado por un evento de la entrada, y leído
1486 siguiendo el flujo de información terminando en su caso en el objeto
1487 (u objetos) de la salida.
1489 La referencia del programa también se puede examinar como un documento
1490 normal. Contiene capítulos que tratan de
1492 @rinternals{Music definitions},
1495 @code{Music definitions}
1497 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1498 de los capítulos relaciona todas las definiciones utilizadas y todas
1499 las propiedades que se pueden ajustar.
1502 @node Interfaces de la presentación
1503 @subsection Interfaces de la presentación
1504 @translationof Layout interfaces
1506 @cindex interfaz de la presentación
1507 @cindex presentación, interfaz de la
1510 La página HTML que pudimos ver en la sección anterior describe el
1511 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1512 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1513 números (como grosores y direcciones), pero también punteros a objetos
1514 relacionados. Un objeto de presentación también se llama un
1515 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1516 gráfico). Para ver más detalles acerca de los objetos gráficos o
1517 Grobs, consulte @rinternals{grob-interface}.
1519 La página dedicada a @code{Fingering} relaciona las definiciones del
1520 objeto @code{Fingering}. Por ejemplo, la página dice
1523 @code{padding} (dimensión, en espacios de pentagrama):
1529 lo que significa que el número se mantendrá a una distancia de al
1530 menos 0.5 de la cabeza de la nota.
1533 Cada objeto de presentación puede tener varias funciones como elemento
1534 notacional o tipográfico. Por ejemplo, el objeto de digitación
1535 Fingering tiene los siguientes aspectos
1539 Su tamaño es independiente del espaciado horizontal, al contrario de
1540 las ligaduras o las barras de las figuras.
1543 Es un elemento de texto. Casi seguro que es un texto muy corto.
1546 este elemento de texto se tipografía con un tipo de letra, no como las
1547 ligaduras o las barras de las figuras.
1550 Horizontalmente, el centro del símbolo se debe alinear con el centro
1551 de la cabeza de la nota.
1554 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1557 La posición vertical también está coordinada con otros símbolos de
1558 superíndice y de subíndice.
1561 Cada uno de estos aspectos se capta en lo que se llaman
1562 @emph{interface}s, que se relacionan al final de la página dedicada a
1563 @rinternals{Fingering}
1566 Este objeto contempla los siguientes interfaces:
1567 @rinternals{item-interface},
1568 @rinternals{self-alignment-interface},
1569 @rinternals{side-position-interface}, @rinternals{text-interface},
1570 @rinternals{text-script-interface}, @rinternals{font-interface},
1571 @rinternals{finger-interface} y @rinternals{grob-interface}.
1574 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1575 página del respectivo interfaz del objeto. Cada interfaz tiene un
1576 cierto número de propiedades. Algunas de ellas no son para que el
1577 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1580 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1581 realmente esto no significa mucho. El archivo de inicialización
1582 (véase @rlearning{Otras fuentes de información})
1583 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1588 (avoid-slur . around)
1589 (slur-padding . 0.2)
1590 (staff-padding . 0.5)
1591 (self-alignment-X . 0)
1592 (self-alignment-Y . 0)
1593 (script-priority . 100)
1594 (stencil . ,ly:text-interface::print)
1595 (direction . ,ly:script-interface::calc-direction)
1596 (font-encoding . fetaText)
1597 (font-size . -5) ; don't overlap when next to heads.
1598 (meta . ((class . Item)
1599 (interfaces . (finger-interface
1601 text-script-interface
1603 side-position-interface
1604 self-alignment-interface
1605 item-interface))))))
1609 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1610 de valores de variables, y la página web de la Referencia de
1611 funcionamiento interno se genera directamente a partir de esta
1615 @node Determinar la propiedad del grob
1616 @subsection Determinar la propiedad del grob
1617 @translationof Determining the grob property
1619 Recordemos que queríamos cambiar la posición del @b{2} en
1621 @lilypond[quote,relative=2,verbatim]
1627 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1628 tenemos que negociar con el interfaz asociado con esta colocación.
1629 Esto se hace usando @code{side-position-interface}. La página que
1630 describe este interface dice:
1633 @code{side-position-interface}
1635 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1636 soporte). La propiedad @code{direction} significa dónde poner el
1637 objeto víctima con relación al soporte (¿a la izquierda o a la
1638 derecha, encima o debajo?)
1642 @cindex padding (relleno)
1644 Debajo de esta descripción, la variable @code{padding} (relleno) se
1650 (dimensión, en espacios de pentagrama)
1652 Añadir esta cantidad de espacio adicional entre objetos que están unos
1657 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1658 digitación de la cabeza de la nota. La siguiente orden inserta un
1659 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1662 \once \override Voice.Fingering.padding = #3
1665 Al insertar esta instrucción antes de que se haya creado el objeto
1666 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1669 @lilypond[quote,relative=2,verbatim]
1670 \once \override Voice.Fingering.padding = #3
1676 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1677 se puede deducir también a partir de la referencia del programa, ya
1678 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1681 El grabador Fingering_engraver es parte de los contextos: @dots{}
1686 @node Convenciones de nombres
1687 @subsection Convenciones de nombres
1688 @translationof Naming conventions
1690 Se hace necesario presentar una panorámica de las diversas
1691 convenciones de nomenclatura:
1694 @item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
1695 @item funciones de Scheme: ly:más-estilo-de-scheme
1696 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1697 @item interfaces de Grobs: estilo-scheme
1698 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1699 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1700 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1701 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1705 Preguntas aún sin respuesta
1707 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1708 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1713 @node Modificar las propiedades
1714 @section Modificar las propiedades
1715 @translationof Modifying properties
1718 * Panorámica de la modificación de las propiedades::
1719 * La instrucción set::
1720 * La instrucción override::
1721 * La instrucción tweak::
1722 * set frente a override::
1723 * Modificación de las listas-A::
1727 @node Panorámica de la modificación de las propiedades
1728 @subsection Panorámica de la modificación de las propiedades
1729 @translationof Overview of modifying properties
1731 Cada contexto es responsable de la creación de ciertos tipos de
1732 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1733 también se almacenan por contexto. Mediante la modificación de estos
1734 ajustes, se puede alterar la apariencia de los objetos.
1736 Existen dos tipos diferentes de propiedades almacenadas en los
1737 contextos: las propiedades de contexto y las propiedades de grob. Las
1738 propiedades de contexto son propiedades que se aplican al contexto
1739 como un todo y controlan la forma en que el propio contexto se
1740 imprime. Por contra, las propiedades de grob se aplican a los tipos
1741 de grob específicos que se imprimirán dentro del contexto.
1743 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar los
1744 valores de las propiedades de contexto. Las instrucciones
1745 @code{\override} y @code{\revert} se usan para cambiar los valores de
1746 las propiedades de grob.
1749 La sintaxis de esto es
1752 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1755 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1756 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1757 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1758 disposición}). Este último es un símbolo, y por ello debe ir
1759 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1760 explica cómo se deben cumplimentar los conceptos @var{nombre},
1761 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1762 funcionalidad des esta instrucción.
1767 \override Staff.Stem.thickness = #4.0
1771 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1772 grosor de una línea del pentagrama como unidad). Puesto que la
1773 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1774 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1775 Aquí vemos la instrucción en pleno funcionamiento:
1777 @lilypond[quote,verbatim,relative=2]
1779 \override Staff.Stem.thickness = #4.0
1785 La instrucción @code{\override} modifica la definición de la plica
1786 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1787 que la instrucción se ha interpretado, todas las plicas se engrosan.
1789 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1790 omitir, ocasionando que se utilice el contexto predeterminado
1791 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1792 solo paso de tiempo.
1794 @lilypond[quote,verbatim,relative=2]
1796 \once \override Stem.thickness = #4.0
1801 El @code{\override} se debe hacer antes de que el objeto se inicia.
1802 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1803 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1804 en el momento en que se crea el objeto. En este ejemplo:
1806 @lilypond[quote,verbatim,relative=2]
1807 \override Slur.thickness = #3.0
1809 \override Beam.beam-thickness = #0.6
1814 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1815 la instrucción para @code{Beam}, la barra, va después de que la barra
1816 se ha iniciado, y por ello no tiene ningún efecto.
1818 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1819 un contexto deshace una instrucción @code{\override}; como con
1820 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1821 del mismo contexto. En otras palabras, el @code{\revert} del
1822 siguiente ejemplo no hace nada.
1825 \override Voice.Stem.thickness = #4.0
1826 \revert Staff.Stem.thickness
1829 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1830 dentro de las propiedades normales. Para trucarlas, utilice
1831 instrucciones de la forma
1833 @c leave this as a long long
1835 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1842 \override Stem.details.beamed-lengths = #'(4 4 3)
1848 Referencia de funcionamiento interno:
1849 @rinternals{Backend},
1850 @rinternals{All layout objects},
1851 @rinternals{OverrideProperty},
1852 @rinternals{RevertProperty},
1853 @rinternals{PropertySet}.
1856 El «back-end» o motor de salida no es muy estricto en la comprobación
1857 de tipos de las propiedades de objetos. Las referencias cíclicas en
1858 valores Scheme de propiedades pueden producir cuelgues o salidas
1859 abruptas, o las dos cosas.
1862 @node La instrucción set
1863 @subsection La instrucción @code{@bs{}set}
1864 @translationof The set command
1868 @cindex cambiar propiedades
1870 Cada contexto puede tener distintas @emph{propiedades}, variables
1871 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1872 paso de interpretación. Se consigue insertando la instrucción
1873 @code{\set} dentro de la música:
1876 \set @var{contexto}.@var{propiedad} = #@var{valor}
1879 @var{valor} es un objeto de Scheme, razón por la que va precedido del
1880 carácter almohadilla,@tie{}@code{#}.
1882 El nombre de las propiedades de contexto suele ir en minúsculas con
1883 mayúscula en medio. Controlan sobre todo la traducción de la música a
1884 la notación, p.ej. @code{localKeySignature} (para determinar si hay
1885 que impriir alteraciones o no), o @code{measurePosition} (para
1886 determinar cuándo hay que imprimir una línea divisoria). El valor de
1887 las propiedades de contexto puede modifcarse con el tiempo durante la
1888 interpretación de la música; un ejemplo obvio es
1889 @code{measurePosition}. Las propiedades de contexto se modifican
1890 mediante la instrucción @code{\set}.
1892 Por ejemplo, los silencios multicompás se combinan en un solo compás
1893 si el valor de la propiedad de contexto @code{skipBars} se establece a
1894 @code{#t} (verdadero):
1896 @lilypond[quote,verbatim,relative=2]
1898 \set Score.skipBars = ##t
1902 Si se omite el argumento @var{context}, entonces se utiliza el
1903 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1904 @code{Voice} o @code{Lyrics}). En este ejemplo:
1906 @lilypond[quote,verbatim,relative=2]
1907 \set Score.autoBeaming = ##f
1911 \set autoBeaming = ##t
1919 El cambio se aplica @q{al vuelo}, mientras dura la música, de forma
1920 que el ajuste sólo afecta al segundo grupo de corcheas.
1922 Observe que el contexto del nivel más bajo no siempre contiene la
1923 propiedad que querríamos modificar: por ejemplo, intentar ajustar el
1924 valor de la propiedad @code{skipBars} del contexto predeterminado del
1925 nivel más bajo, que en este caso es @code{Voice}, no tendrá ningún
1926 efecto, porque skipBars es una propiedad del contexto @code{Score}.
1928 @lilypond[quote,verbatim,relative=2]
1934 Los contextos son jerárquicos, y si se ha especificado un contexto
1935 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
1936 también a todos los contextos @code{Voice} dentro del pentagrama
1941 También existe una instrucción @code{\unset}:
1943 \unset @var{contexto}.@var{propiedad}
1947 que elimina la definición de @var{propiedad}. Esta instrucción
1948 elimina la definición solamente si está establecida dentro de
1949 @var{contexto}. Properties that have been set in enclosing contexts will
1950 not be altered by an unset in an enclosed context:
1952 @lilypond[quote,verbatim,relative=2]
1953 \set Score.autoBeaming = ##t
1958 \unset Score.autoBeaming
1966 Como @code{\set}, el argumento @var{contexto} no se tiene que
1967 especificar para un contexto del nivel más bajo, por lo que los dos
1971 \set Voice.autoBeaming = ##t
1972 \set autoBeaming = ##t
1976 son equivalentes si el contexto inferior en curso es @code{Voice}.
1980 Los ajustes que se aplican solamente a un único paso de tiempo se
1981 pueden escribir con @code{\once}, por ejemplo en
1983 @lilypond[quote,verbatim,relative=2]
1985 \once \set fontSize = #4.7
1990 En el manual de Referencia de funcionamiento interno hay una
1991 descripción completa de todas las propiedades de contexto disponibles,
1994 @rinternals{Tunable context properties}.
1997 Traducción @expansion{} Propiedades de contexto modificables por el
2002 Referencia de funcionamiento interno:
2003 @rinternals{Tunable context properties}.
2005 @node La instrucción override
2006 @subsection La instrucción @code{\override}
2007 @translationof The override command
2009 @cindex grob, propiedades de
2010 @cindex propiedades de grob
2013 Existe un tipo especial de propiedad de contexto: la descripción de
2014 los grobs. Las decscripciones de los grobs reciben un nombre en
2015 @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen los
2016 @q{ajustes predeterminados} para un tipo particular de grob, en forma
2017 de lista asociativa. Consulte @file{scm/define-grobs.scm} para
2018 ver los ajustes de cada descripción de grob. Las descripciones de
2019 grob se modifican con @code{\override}.
2021 La sintaxis de la instrucción @code{\override} es
2024 \override [@var{contexto}.]@var{NombreDelGrob}.@var{propiedad} = #@var{valor}
2027 Por ejemplo, podemos aumentar el grosor de la plica de una figura
2028 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
2029 @code{Stem} (plica):
2031 @lilypond[quote,verbatim,relative=2]
2033 \override Voice.Stem.thickness = #3.0
2037 Si no se ha especificado ningún contexto en la instrucción
2038 @code{\override}, se utiliza el contexto del nivel inferior:
2040 @lilypond[quote,verbatim,relative=2]
2041 { \override Staff.Stem.thickness = #3.0
2045 \override Stem.thickness = #0.5
2054 Algunas opciones susceptibles de trucaje, se llaman
2055 @q{subpropiedades} y residen dentro de las propiedades. Para
2056 efectura trujajes sobre ellas, utilice instrucciones de la forma
2059 \override Stem.details.beamed-lengths = #'(4 4 3)
2062 o para modificar los extremos de los objetos extensos, utilice una
2063 forma como las siguientes:
2066 \override TextSpanner.bound-details.left.text = #"left text"
2067 \override TextSpanner.bound-details.right.text = #"right text"
2071 @cindex reversión de sobreescrituras
2072 @cindex sobreescrituras, reversión de
2074 El efecto de una instrucción de sobreescritura @code{\override} se
2075 puede deshacer con @code{\revert}.
2077 La sintaxis de la instrucción @code{\revert} es
2080 \revert [@var{Contexto}.]@var{NombreDelGrob}.@var{propiedad}
2085 @lilypond[quote,verbatim,relative=2]
2087 \override Voice.Stem.thickness = #3.0
2089 \revert Voice.Stem.thickness
2093 Los efectos de @code{\override} y @code{\revert} se aplican a todos
2094 los grobs del contexto afectado partiendo del momento actual y hacia
2097 @lilypond[quote,verbatim,relative=2]
2102 \override Staff.Stem.thickness = #3.0
2106 \revert Staff.Stem.thickness
2114 @cindex sobreescritura para un solo momento
2116 Se puede usar @code{\once} con @code{\override} para afectar solamente
2117 al instante de tiempo actual:
2119 @lilypond[quote,verbatim,relative=2]
2123 \override Stem.thickness = #3.0
2127 \once \override Stem.thickness = #3.0
2136 Las instrucciones que modifican la salida tienen por lo general un
2140 \override Voice.Stem.thickness = #3.0
2144 Para construir este truco debemos determinar los siguientes datos:
2147 @item el contexto: aquí @code{Voice}.
2148 @item el objeto de presentación: aquí @code{Stem}.
2149 @item la propiedad de presentación: aquí @code{thickness}.
2150 @item un valor adecuado: aquí @code{3.0}.
2153 @cindex documentación interna
2154 @cindex buscar objetos gráficos
2155 @cindex gráficos, descripción de los objetos
2158 @cindex interna, documentación
2160 Para muchas propiedades, independientemente del tipo de datos de la
2161 propiedad, si se establece el valor de la propiedad a falso
2162 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
2163 ignore por completo dicha propiedad. Esto es especialmente útil para
2164 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
2165 causarían problemas.
2167 Mostraremos a continuación cómo localizar esta información en el
2168 manual de notación y en la referencia de funcionamiento interno.
2172 Referencia de funcionamiento interno:
2173 @rinternals{Backend}
2176 @node La instrucción tweak
2177 @subsection La instrucción @code{\tweak}
2178 @translationof The tweak command
2183 El cambio de las propiedades de grob mediante @code{\override} produce
2184 la aplicación del cambio a todos los grobs dados en el contexto en el
2185 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
2186 podemos desear que los cambios se apliquen a un solo grob en lugar de
2187 a todos los grobs del contexto afectado. Esto se consigue con la
2188 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
2191 \tweak [@var{objeto-de-presentación}.]@var{propiedad-del-grob} @var{valor}
2194 Es opcional especificar el @var{objeto-de-presentación}. La
2195 instrucción @code{\tweak} se aplica al objeto musical que viene
2196 inmediatamente después de @var{valor} dentro del flujo musical.
2199 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
2200 los objetos gráficos. Para objetos que resultan directamente de un
2201 elemento de código de la entrada, puede usar la función @code{\tweak},
2204 @lilypond[relative=2,verbatim,quote]
2209 \tweak duration-log #1
2218 El uso principal de la instrucción @code{\tweak} es modificar
2219 solamente uno de varios elementos de notación que dan comienzo en el
2220 mismo momento musical, como las notas de un acorde, o corchetes de
2221 tresillo que empiezan al mismo tiempo.
2223 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
2224 a continuación de forma directa, sin necesidad de especificar el
2225 nombre del grob o el contexto. Para que esto funcione, es necesario
2226 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
2227 al objeto al que se aplica, después de que el archivo de entrada se ha
2228 convertido en un flujo musical. Con frecuencia no es el caso, pues
2229 muchos elementos adicionales se insertan en la corriente musical de
2230 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
2231 parte de un acorde, LilyPond inserta implícitamente un evento
2232 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
2233 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
2234 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
2235 en el flujo musical, permaneciendo así adyacente a la nota, y con la
2236 posibilidad de modificarla.
2240 @lilypond[relative=2,verbatim,quote]
2241 <\tweak color #red c>4
2245 pero esto no funciona:
2247 @lilypond[relative=2,verbatim,quote]
2248 \tweak color #red c4
2253 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
2254 consulte @rlearning{Métodos de trucaje}.
2256 Si se colocan varios elementos similares en el mismo momento musical,
2257 la instrucción @code{\override} no se puede usar para modificar uno
2258 solo de ellos: aquí es donde se debe usar la instrucción
2259 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
2260 en el mismo momento musical están los siguientes:
2262 @c TODO expand to include any further uses of \tweak
2264 @item las cabezas de las notas de un acorde
2265 @item signos de articulación sobre la misma nota
2266 @item ligaduras de unión entre notas de un acorde
2267 @item corchetes de grupos especials que comienzan en el mismo momento
2270 @c TODO add examples of these
2272 @cindex acorde, modificación de una nota
2274 En este ejemplo se modifican el color de una cabeza y el tipo de otra,
2275 dentro del mismo acorde:
2277 @lilypond[relative=2,verbatim,quote]
2282 \tweak duration-log #1
2287 @code{\tweak} se puede usar para modificar ligaduras de expresión:
2289 @lilypond[verbatim,quote,relative=1]
2290 c-\tweak thickness #5 ( d e f)
2294 Para que funcione la instrucción @code{\tweak}, debe permanecer
2295 adyacente al objeto al que se ha de aplicar después de que el código
2296 de entrada se ha convertido a un flujo musical. El trucaje de un
2297 acorde completo no hace nada porque su evento musical actúa solamente
2298 como un contenedor, y todos los objetos de presentación se crean a
2299 partir de eventos dentro del @code{EventChord}:
2301 @lilypond[relative=2,verbatim,quote]
2302 \tweak color #red c4
2303 \tweak color #red <c e>4
2304 <\tweak color #red c e>4
2307 La instrucción @code{\tweak} sencilla no se puede usar para modificar
2308 ningún objeto que no se haya creado directamente a partir de la entrada.
2309 Concretamente, no afecta a las plicas, barras automáticas ni
2310 alteraciones, porque éstos se generan posteriormente por
2311 parte de objetos de presentación @code{NoteHead}
2312 más que por elementos musicales del
2315 Tales objetos de presentación creados indirectamente se pueden trucar
2316 usando la forma de la instrucción @code{\tweak} en que el nombre
2317 del grob se especifica de forma explícita:
2319 @lilypond[relative=2,verbatim,quote]
2320 \tweak Stem.color #red
2321 \tweak Beam.color #green c8 e
2322 <c e \tweak Accidental.font-size #-3 ges>4
2325 No se puede usar @code{\tweak} para modificar las claves o las
2326 indicaciones de compás, porque éstos se separan de cualquier
2327 instrucción @code{\tweak} precedente dentro del flujo de entrada
2328 merced a la inserción automática de elementos adicionales que se
2329 requieren para especificar el contexto.
2331 Se pueden colocar varias instrucciones @code{\tweak} antes de un
2332 elemento de notación; todos le afectan:
2334 @lilypond[verbatim,quote,relative=1]
2336 -\tweak style #'dashed-line
2337 -\tweak dash-fraction #0.2
2338 -\tweak thickness #3
2344 El flujo musical que se genera a partir de una sección de un archivo
2345 de entrada (incluido cualquier elemento insertado automáticamente)
2346 puede examinarse, véase @rextend{Presentación de las expresiones musicales}.
2347 Esto puede ser de utilidad en la determinación de lo que
2348 puede modificarse por medio de una instrucción @code{\tweak}.
2351 Manual de aprendizaje:
2352 @rlearning{Métodos de trucaje}.
2354 Manual de extensión:
2355 @rextend{Presentación de las expresiones musicales}.
2359 @cindex trucar puntos de control
2360 @cindex control, trucar puntos de
2362 No se puede usar la instrucción @code{\tweak} para modificar los
2363 puntos de control de una sola de varias ligaduras de unión dentro de
2364 un acorde, aparte de la primera que se encuentre en el código de
2368 @node set frente a override
2369 @subsection @code{\set} frente a @code{\override}
2370 @translationof set versus override
2372 @c HACER: probablemente esta sección es innecesaria.
2375 We have seen two methods of changing properties: @code{\set} and
2376 @code{\override}. There are actually two different kinds of
2379 @code{fontSize} is a special property: it is equivalent to
2380 entering @code{\override @dots{} #'font-size} for all pertinent
2381 objects. Since this is a common change, the special
2382 property (modified with @code{\set}) was created.
2387 @node Modificación de las listas-A
2388 @subsection Modificación de las listas-A
2389 @translationof Modifying alists
2391 Ciertas propiedades configurables por parte del usuario se representan
2392 internamente como @emph{listas-A} (listas asociativas), que almacenan
2393 duplas de @emph{claves} y @emph{valores}. La estructura de una
2394 lista-A es la siguiente:
2397 '((@var{clave1} . @var{valor1})
2398 (@var{clave2} . @var{valor2})
2399 (@var{clave3} . @var{valor3})
2403 Si una lista-A es una propiedad de un grob o una variable de
2404 @code{\paper}, sus claves se pueden modificar individualmente sin que
2405 afecte a las otras claves.
2407 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2408 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2409 del grob @code{StaffGrouper}. La propiedad es una lista-A con cuatro
2410 claves: @code{basic-distance} (distancia básica),
2411 @code{minimum-distance} (distancia mínima), @code{padding} (relleno)
2412 y @code{stretchability} (ampliabilidad).
2413 Los ajustes estándar para esta propiedad
2414 se relacionan en la sección
2415 @qq{Backend} de la Referencia de Funcionamiento Interno
2416 (véase @rinternals{StaffGrouper}):
2419 '((basic-distance . 9)
2420 (minimum-distance . 7)
2422 (stretchability . 5))
2425 Una forma de acercar los pentagramas entre sí es reducir el valor de
2426 la clave @code{basic-distance} (@code{9}) para que se corresponda con
2427 el valor de @code{minimum-distance} (@code{7}). Para modificar una
2428 única clave de forma individual, utilice una @emph{declaración
2431 @lilypond[quote,verbatim]
2432 % default space between staves
2434 \new Staff { \clef treble c''1 }
2435 \new Staff { \clef bass c1 }
2438 % reduced space between staves
2439 \new PianoStaff \with {
2440 % this is the nested declaration
2441 \override StaffGrouper.staff-staff-spacing.basic-distance = #7
2443 \new Staff { \clef treble c''1 }
2444 \new Staff { \clef bass c1 }
2448 La utilización de una declaración anidada actualiza la clave
2449 especificada (como @code{basic-distance} en el ejemplo anterior)
2451 de las otras claves que ya se habían establecido para la misma
2454 Ahora, supongamos que deseamos que los pentagramas estén tan próximos
2455 como sea posible sin que se superpongan. La manera más sencilla de
2456 hacerlo es establecer las cuatro claves de la lista-A a cero. Sin
2457 embargo, no es necesario escribir cuatro declaraciones anidadas, una
2458 por cada clave. En lugar de eso, se puede redefinir completamente la
2459 propiedad con una sola declaración, como una lista-A:
2461 @lilypond[quote,verbatim]
2462 \new PianoStaff \with {
2463 \override StaffGrouper.staff-staff-spacing =
2464 #'((basic-distance . 0)
2465 (minimum-distance . 0)
2467 (stretchability . 0))
2469 \new Staff { \clef treble c''1 }
2470 \new Staff { \clef bass c1 }
2474 Observe que cualquier clave que no haya sido relacionada
2475 explícitamente en la definición de la lista-A, será reiniciada a sus
2476 valores @emph{predeterminados si no se han fijado}. En el caso de
2477 @code{staff-staff-spacing}, el valor de cualquier clave no fijada se
2478 reiniciaría a cero (excepto @code{stretchability}, que toma el valor
2479 de @code{basic-distance} si no se fija). Así, las dos declaraciones
2480 siguientes son equivalentes:
2483 \override StaffGrouper.staff-staff-spacing =
2484 #'((basic-distance . 7))
2486 \override StaffGrouper.staff-staff-spacing =
2487 #'((basic-distance . 7)
2488 (minimum-distance . 0)
2490 (stretchability . 7))
2493 Una consecuencia de esto (posiblemente no intencionada) es la
2494 eliminación de cualquier valor estándar que se establezca en un
2495 archivo de inicio y que se carga cada vez que se compila un archivo de
2496 entrada. En el ejemplo anterior, los ajustes estándar para
2497 @code{padding} y @code{minimum-distance} (definidos en
2498 @file{scm/define-grobs.scm}) se reinician a sus valores
2499 predeterminados si no se han fijado (cero para las dos claves). La
2500 definición de una propiedad o variable como una lista-A (de cualquier
2501 tamaño) siempre reinicia todos los valores de clave no establecidos a
2502 sus valores predeterminados si no se han fijado. Ano ser que este sea
2503 el resultado deseado, es más seguro actualizar los valores de clave
2504 individualmente con una declaración anidada.
2506 @warning{Las declaraciones anidadas no funcionan para las listas-A de
2507 propiedades de contexto (como @code{beamExceptions},
2508 @code{keySignature}, @code{timeSignatureSettings}, etc.). Estas
2509 propiedades sólo se pueden modificar redefiniéndolas completamente
2513 @node Conceptos y propiedades útiles
2514 @section Conceptos y propiedades útiles
2515 @translationof Useful concepts and properties
2519 * Modos de entrada::
2520 * Dirección y posición::
2521 * Distancias y medidas::
2522 * Propiedades del símbolo del pentagrama::
2523 * Objetos de extensión::
2524 * Visibilidad de los objetos::
2525 * Estilos de línea::
2526 * Rotación de objetos::
2530 @node Modos de entrada
2531 @subsection Modos de entrada
2532 @translationof Input modes
2534 La forma en que se interpreta la notación contenida dentro de un
2535 archivo de entrada, está determinada por el modo de entrada en curso.
2537 @strong{Modo de acordes}
2539 Se activa con la instrucción @code{\chordmode} y produce que la
2540 entrada se interprete con al sintaxis de la notación de acordes, véase
2541 @ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
2544 El modo de acordes se activa también con la instrucción
2545 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
2546 y produce que el código que sigue se interprete con la sintaxis de la
2547 notación de acordes y se imprima como nombres de acorde dentro del
2548 contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
2550 @strong{Modo de percusión}
2552 Se activa con la instrucción @code{\drummode} y produce que el código
2553 de entrada se interprete con la sintaxis de la notación de percusión,
2554 véase @ref{Notación básica de percusión}.
2556 El modo de percusión también se activa con la instrucción
2557 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
2558 que el código que sigue se interprete con la sintaxis de la notación
2559 de percusión y se imprima como símbolos de percusión sobre un
2560 pentagrama de percusión, véase @ref{Notación básica de percusión}.
2562 @strong{Modo de cifras}
2564 Se activa con la instrucción @code{\figuremode} y hace que el código
2565 de entrada se interprete con la sintaxis del bajo cifrado, véase
2566 @ref{Introducir el bajo cifrado}.
2568 El modo de cifras también se activa con la instrucción
2569 @code{\figures}. También crea un contexto de @code{FiguredBass}
2570 nuevo y hace que el código que viene a continuación se interprete
2571 con la sintaxis del bajo cifrado y se imprima como símbolos de
2572 bajo cifrado dentro del contexto @code{FiguredBass}, véase
2573 @ref{Introducción al bajo cifrado}.
2575 @strong{Modos de traste y tablatura}
2577 No existen modos de entrada especiales para introducir símbolos de
2578 trastes y de tablatura.
2580 Para crear diagramas de trastes, escriba las notas o acordes en el
2581 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2582 véase @ref{Tablaturas predeterminadas}.
2584 Para crear diagramas de trastes encima de un pentagrama, escríbalos
2585 como elementos de marcado encima de las notas utilizando la
2586 instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
2588 @strong{Modo de letra}
2590 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
2591 se interprete como sílabas de la letra de la canción con duraciones
2592 opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
2594 El modo de letra también se habilita con la instrucción
2595 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
2596 y una instrucción @code{\lyricsto} implícita que asocia la letra que
2597 viene a continuación con la música precedente.
2599 @strong{Modo de marcado}
2601 Se activa con la instrucción @code{\markup}, y hace que la entrada se
2602 interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
2604 @c silly work-around for texinfo broken-ness
2605 @c (@strong{Note...} causes a spurious cross-reference in Info)
2608 Es el modo predeterminado o se puede activar con la instrucción
2609 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
2610 marcado, etc. y se imprime como notación musical sobre un pentagrama.
2612 Normalmente no es necesario especificar el modo de notas de forma
2613 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2614 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2615 otro modo y queremos insertar algo que solamente se puede hacer con la
2616 sintaxis del modo de notas.
2618 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
2619 una pieza coral es necesario entrar en el modo de notas para poder
2620 interpretar dichas indicaciones:
2622 @lilypond[verbatim,relative=2,quote]
2625 \notemode{\set stanza = \markup{ \dynamic f 1. } }
2629 \notemode{\set stanza = \markup{ \dynamic p 2. } }
2635 @node Dirección y posición
2636 @subsection Dirección y posición
2637 @translationof Direction and placement
2639 Al tipografiar música, la dirección y colocación de muchos elementos
2640 es cuestión de elección. Por ejemplo, las plicas de las notas se
2641 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
2642 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
2643 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
2644 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
2645 LilyPond las determine automáticamente, pero en ciertos casos puede
2646 ser deseable forzar una dirección o colocación concreta.
2649 * Indicadores de dirección de las articulaciones::
2650 * La propiedad de dirección::
2653 @node Indicadores de dirección de las articulaciones
2654 @unnumberedsubsubsec Indicadores de dirección de las articulaciones
2655 @translationof Articulation direction indicators
2657 De forma predeterminada algunas direcciones siempre son hacia arriba o
2658 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
2659 otras cosas pueden alternar entre arriba y abajo en función de la
2660 dirección de las plicas (como las ligaduras o los acentos).
2662 @c TODO Add table showing these
2664 Se puede sobreescribir la acción predeterminada mediante el prefijado
2665 de la articulación por un @emph{indicacor de dirección}. Están
2666 disponibles tres indicadores de dirección: @code{^} (que significa
2667 @qq{arriba}), @code{_} (que significa @qq{abajo}) o @code{-} (que
2668 significa @qq{usar la dirección predeterminada}). El indicador de
2669 dirección se puede normalmente omitir, en cuyo caso se supone el
2670 indicador predeterminado @code{-}, pero se necesita un indicador de
2671 dirección @strong{siempre} antes de:
2674 @item las instrucciones @code{\tweak}
2675 @item las instrucciones @code{\markup}
2676 @item las instrucciones @code{\tag}
2677 @item los marcados de cadena, p.ej. -"cadena"
2678 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2679 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2682 Estas indicaciones afectan sólo a la nota siguiente.
2684 @lilypond[verbatim,quote,relative=2]
2691 @node La propiedad de dirección
2692 @unnumberedsubsubsec La propiedad de dirección
2693 @translationof The direction property
2695 La posición o dirección de muchos objetos de presentación está
2696 controlada por la propiedad @code{direction}.
2698 El valor de la propiedad @code{direction} se puede establecer al valor
2699 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
2700 @w{@code{-1}}, con el significado de @qq{hacia abajo} o @qq{debajo}.
2701 Se pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
2702 @code{1} y @w{@code{-1}} respectivamente. La dirección predeterminada
2703 se puede especificar estableciendo @code{direction} a @code{0} ó a
2704 @code{CENTER}. De forma alternativa, en muchos casos existen
2705 instrucciones predefinidas para especificar la dirección. Todas ellas
2709 @code{\xxxUp}, @code{\xxxDown} o @code{\xxxNeutral}
2713 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
2714 predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
2716 En alguna que otra ocasión como en el arpegio, el
2717 valor de la propiedad @code{direction} puede especificar si el objeto se debe
2718 colocar a la izquierda o a la derecha del objeto padre. En este caso
2719 @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y @code{1}
2720 ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
2721 significan @qq{utilizar la dirección predeterminada}.
2723 Estas indicaciones afectan a todas las notas hasta que son canceladas.
2725 @lilypond[verbatim,quote,relative=2]
2734 En música polifónica, en general es mejor especificar una voz explícita
2735 que cambiar la dirección de un objeto. Para ver más información,
2736 véase @ref{Varias voces}.
2739 Manual de aprendizaje:
2740 @rlearning{Objetos interiores al pentagrama}.
2742 Referencia de la notación:
2746 @node Distancias y medidas
2747 @subsection Distancias y medidas
2748 @translationof Distances and measurements
2750 @cindex distancias absolutas
2751 @cindex distancias escaladas
2758 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
2760 Las distancias absolutas se usan para especificar márgenes, sangrados
2761 y otros detalles de diseño de página, y de forma predeterminada se
2762 especifican en milímetros. Las distancias se pueden especificar en
2763 otras unidades escribiendo después de la cifra indicativa de la
2764 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
2765 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
2766 de página se pueden especificar también en unidades escalables (véase
2767 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
2768 La disposición de página se describe en detalle en
2769 @ref{Disposición de la página}.
2771 Las distancias escaladas siempre se especifican en unidades de un
2772 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
2773 El espacio de pentagrama es la distancia entre dos líneas del
2774 pentagrama adyacentes. El valor predeterminado se puede cambiar
2775 globalmente fijando el tamaño global del pentagrama, o se puede
2776 sobreescribir localmente cambiando la propiedad @code{staff-space} del
2777 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
2778 automáticamente con cualquier cambio al tamaño global del pentagrama o
2779 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
2780 las fuentes tipográficas se escalan solamente con los cambios
2781 efectuados al tamaño global del pentagrama. Así, el tamaño global del
2782 pentagrama posibilita la fácil variación del tamaño general de una
2783 partitura impresa. Para ver los métodos de establecimiento del tamaño
2784 global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2788 Si se necesita dibujar sólo una sección de una partitura a una escala
2789 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2790 simplemente cambiar el tamaño global del pentagrama porque esto
2791 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2792 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2793 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2794 nuestra disposición una función de Scheme, @code{magstep}, para
2795 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2796 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2797 utilización, consulte @rlearning{Longitud y grosor de los objetos}.
2800 Manual de aprendizaje:
2801 @rlearning{Longitud y grosor de los objetos}.
2803 Referencia de la notación:
2804 @ref{Disposición de la página},
2805 @ref{Establecer el tamaño del pentagrama}.
2808 @node Propiedades del símbolo del pentagrama
2809 @subsection Propiedades del símbolo del pentagrama
2810 @translationof Staff symbol properties
2812 @cindex ajuste del símbolo del pentagrama
2813 @cindex dibujar el símbolo del pentagrama
2814 @cindex pentagrama, establecer el símbolo del
2816 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2817 @c Need to think of uses for these properties. Eg 'line-positions
2818 @c is used in a snippet to thicken centre line.
2819 @c If retained, add @ref to here in 1.6.2 -td
2821 Se puede definir al mismo tiempo la posición vertical de las líneas de
2822 la pauta y el número de líneas de la misma. Como muestra el siguiente
2823 ejemplo, las posiciones de las notas no están influidas por las
2824 posiciones de las líneas de la pauta.
2826 @warning{La propiedad @code{'line-positions} sobreescribe a la
2827 propiedad @code{'line-count}. El número de líneas de la pauta está
2828 definido implícitamente por el número de elementos de la lista de
2829 valores de @code{'line-positions}.}
2831 @lilypond[verbatim,quote,relative=1]
2833 \override StaffSymbol.line-positions = #'(7 3 0 -4 -6 -7)
2838 Se puede modificar la anchura de la pauta. Las unidades son espacios
2839 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2840 resulta afectado por este ajuste.
2842 @lilypond[verbatim,quote,relative=1]
2844 \override StaffSymbol.width = #23
2850 @node Objetos de extensión
2851 @subsection Objetos de extensión
2852 @translationof Spanners
2854 Muchos objetos de notación musical abarcan varias notas o incluso
2855 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2856 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2857 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2858 especiales para controlar su apariencia y comportamiento. Algunas de
2859 estas propiedades son comunes a todos los objetos de extensión; otras
2860 se limitan a un subconjunto de los extensores.
2862 Todos los objetos de extensión contemplan el interface
2863 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2864 una línea recta entre los dos objetos, contemplan también el interface
2865 @code{line-spanner-interface}.
2868 * Uso del spanner-interface::
2869 * Uso del line-spanner-interface::
2872 @node Uso del spanner-interface
2873 @unnumberedsubsubsec Uso del @code{spanner-interface}
2874 @translationof Using the spanner-interface
2876 Este interface proporciona dos propiedades que se aplican a varios
2879 @subsubsubheading La propiedad @code{minimum-length} (longitud mínima)
2881 La longitud mínima del objeto de extensión se especifica a través
2882 de la propiedad @code{minimum-length}. Su aumento suele producir
2883 el efecto necesario de aumentar el espaciado de las notas entre
2884 los dos puntos extremos. Sin embargo, esta sobreescritura no
2885 tiene ningún efecto sobre muchos extensores, pues su longitud está
2886 determinada por otras consideraciones. Más abajo se muestran
2887 algunos ejemplos de dónde es efectiva.
2897 Works as long as callback is made:
2901 Works not at all for:
2910 @lilypond[verbatim,quote,relative=2]
2913 % increase the length of the tie
2914 -\tweak minimum-length #5
2918 @lilypond[verbatim,quote,relative=2]
2920 \compressFullBarRests
2922 % increase the length of the rest bar
2923 \once \override MultiMeasureRest.minimum-length = #20
2928 @lilypond[verbatim,quote,relative=2]
2930 % increase the length of the hairpin
2931 \override Hairpin.minimum-length = #20
2935 Esta sobreescritura se puede usar también para aumentar la longitud de
2936 las ligaduras de expresión y de fraseo:
2938 @lilypond[verbatim,quote,relative=2]
2941 -\tweak minimum-length #5
2946 -\tweak minimum-length #5
2950 Para algunos objetos de presentación, la propiedad
2951 @code{minimum-length} es efectiva sólo si se llama explícitamente al
2952 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
2953 propiedad @code{springs-and-rods} al valor
2954 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
2955 de un glissando no tiene efecto a no ser que se establezca la
2956 propiedad @code{springs-and-rods}:
2958 @lilypond[verbatim,quote,relative=1]
2962 % not effective alone
2963 \once \override Glissando.minimum-length = #20
2966 % effective only when both overrides are present
2967 \once \override Glissando.minimum-length = #20
2968 \once \override Glissando.springs-and-rods = #ly:spanner::set-spacing-rods
2972 Lo mismo se puede decir del objeto @code{Beam}:
2974 @lilypond[verbatim,quote,relative=1]
2975 % not effective alone
2976 \once \override Beam.minimum-length = #20
2979 % effective only when both overrides are present
2980 \once \override Beam.minimum-length = #20
2981 \once \override Beam.springs-and-rods = #ly:spanner::set-spacing-rods
2985 @subsubsubheading La propiedad @code{to-barline}
2987 La segunda propiedad útil del @code{spanner-interface} es
2988 @code{to-barline}. De forma predeterminada tiene el valor cierto,
2989 haciendo que los reguladores y otros objetos de extensión que terminan
2990 sobre la primera nota de un compás, en vez de eso terminen en la línea
2991 divisoria inmediatamente precedente. Si se establece al valor falso,
2992 el extensor llegará más allá de la barra de compás y terminará
2993 exactamente sobre la nota:
2995 @lilypond[verbatim,quote,relative=2]
2996 a \< a a a a \! a a a \break
2997 \override Hairpin.to-barline = ##f
2998 a \< a a a a \! a a a
3001 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
3002 su establecimiento a @code{#t} no tienen ningún efecto sobre las
3003 ligaduras de expresión o de fraseo, o sobre otros extensores para los
3004 que terminar en la barra de compás no tendría ningún significado.
3006 @node Uso del line-spanner-interface
3007 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
3008 @translationof Using the line-spanner-interface
3010 Entre los objetos que contemplan el interface
3011 @code{line-spanner-interface} se encuentran
3014 @item @code{DynamicTextSpanner}
3015 @item @code{Glissando}
3016 @item @code{TextSpanner}
3017 @item @code{TrillSpanner}
3018 @item @code{VoiceFollower}
3021 La rutina responsable de dibujar los sellos de estos extensores es
3022 @code{ly:line-interface::print}. esta rutina determina la
3023 localización exacta de los dos puntos extremos y traza una línea entre
3024 ellos, en el estilo solicitado. Las posiciones de los dos puntos
3025 extremos del extensor se calculan al vuelo, pero es posible
3026 sobreescribir sus coordenadas Y. Las propiedades que se deben
3027 especificar están anidadas a dos niveles de profundidad en la
3028 jerarquía de propiedades, pero la sintaxis de la instrucción
3029 @code{\override} es bastante sencilla:
3031 @lilypond[relative=2,quote,verbatim]
3033 \once \override Glissando.bound-details.left.Y = #3
3034 \once \override Glissando.bound-details.right.Y = #-2
3038 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
3039 siendo el punto del cero la línea central del pentagrama. Para el
3040 glissando, esto es el valor de @code{Y} en la coordenada X que
3041 corresponde al punto central de cada cabeza de nota si nos imaginamos
3042 que la línea se extiende hasta allí.
3044 Si no está fijado @code{Y}, su valor se calcula a partir de la
3045 posición vertical del punto de anclaje correspondiente del extensor.
3047 En caso de salto de línea, los valores para los puntos extremos se
3048 especifican por las sub-listas @code{left-broken} y
3049 @code{right-broken} de @code{bound-details}. Por ejemplo:
3051 @lilypond[relative=2,ragged-right,verbatim,quote]
3052 \override Glissando.breakable = ##t
3053 \override Glissando.bound-details.right-broken.Y = #-3
3054 c1 \glissando \break
3058 Un número de propiedades adicionales de las sub-listas @code{left} y
3059 @code{right} de la propiedad @code{bound-details} se pueden
3060 especificar de la misma forma que @code{Y}:
3064 Establece la coordenada Y del punto extremo, en desplazamientos de
3065 @code{staff-space}s desde la línea central del pentagrama. De forma
3066 predeterminada es el centro del objeto ancla, y así un glissando
3067 apunta al centro vertical de la cabeza de la nota.
3069 Para extensores horizontales como los extensores de texto y los
3070 trinos, está inamoviblemente codificado como 0.
3072 @item attach-dir (dirección de anclaje)
3073 Determina dónde comienza y termina la línea en la dirección X, con
3074 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o @code{LEFT},
3075 izquierda) hace que la línea comience o termine en el lado izquierdo
3076 de la cabeza de la nota a la que está anclado.
3079 Es la coordenada X absoluta del punto extremo. Se suele calcular al
3080 vuelo, y su sobreescritura no tiene un efecto útil.
3082 @item stencil (sello)
3083 Los extensores de línea pueden tener símbolos al comienzo o al final,
3084 lo que está contenido en esta sub-propiedad. Esto es para uso
3085 interno; se recomienda en su lugar el uso de @code{text}.
3088 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
3089 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
3090 de extensión horizontales.
3092 @lilypond[quote,ragged-right,relative=2,verbatim]
3093 \override TextSpanner.bound-details.left.text
3094 = \markup { \small \bold Slower }
3095 c2\startTextSpan b c a\stopTextSpan
3098 @item stencil-align-dir-y (alineación del sello en y)
3099 @item stencil-offset (desplazamiento del sello)
3100 Si no se modifican uno u otro, el sello se coloca sencillamente en el
3101 punto extremo, centrado sobre la línea, como viene definido por las
3102 subpropiedades @code{X} e @code{Y}. Si se fijan
3103 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
3104 símbolo del borde verticalmente con relación al extremo de la línea:
3106 @lilypond[relative=1,quote,verbatim]
3107 \override TextSpanner.bound-details.left.stencil-align-dir-y = #-2
3108 \override TextSpanner.bound-details.right.stencil-align-dir-y = #UP
3110 \override TextSpanner.bound-details.left.text = #"ggg"
3111 \override TextSpanner.bound-details.right.text = #"hhh"
3112 c4^\startTextSpan c c c \stopTextSpan
3115 Observe que los valores negativos mueven el texto @emph{hacia arriba},
3116 al contrario de lo que podría esperarse, pues el valor de @w{@code{-1}} o
3117 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
3118 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
3119 (arriba) alinea el borde superior del texto con la línea extensora.
3121 @item arrow (flecha)
3122 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
3123 flecha en el extremo de la línea.
3125 @item padding (relleno)
3126 Esta sub-propiedad controla el espacio entre el punto extremo
3127 especificado de la línea y el extremo real. Sin relleno, un glissando
3128 empezaría y terminaría en el centro de la cabeza de las notas.
3132 La función musical @code{\endSpanners} finaliza de forma prematura el
3133 extensor que comienza sobre la nota que sigue inmediatamente a
3134 continuación. Se termina después de una nota exactamente, o en la
3135 siguiente barra de compás si @code{to-barline} es verdadero y se
3136 produce una divisoria antes de la siguiente nota.
3138 @lilypond[verbatim,quote,ragged-right,relative=2]
3140 c2 \startTextSpan c2 c2
3145 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
3146 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
3149 Referencia de funcionamiento interno:
3150 @rinternals{TextSpanner},
3151 @rinternals{Glissando},
3152 @rinternals{VoiceFollower},
3153 @rinternals{TrillSpanner},
3154 @rinternals{line-spanner-interface}.
3157 @node Visibilidad de los objetos
3158 @subsection Visibilidad de los objetos
3159 @translationof Visibility of objects
3161 @cindex objetos, visibilidad de
3162 @cindex grobs, visibilidad de
3163 @cindex visibilidad de los objetos
3165 Hay cuatro formas principales en que se puede controlar la visibilidad
3166 de los objetos de presentación: se puede eliminar su sello, se pueden
3167 volver transparentes, se pueden pintar de blanco, o se puede
3168 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
3169 se aplican a todos los objetos de presentación; la última sólo a unos
3170 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
3171 introduce estas cuatro técnicas,
3172 véase @rlearning{Visibilidad y color de los objetos}.
3174 Hay también algunas otras técnicas que son específicas de ciertos
3175 objetos de presentación. Se estudian bajo Consideraciones especiales.
3178 * Eliminar el sello::
3179 * Hacer transparentes los objetos::
3180 * Pintar los objetos de blanco::
3181 * Uso de break-visibility (visibilidad en el salto)::
3182 * Consideraciones especiales::
3186 @node Eliminar el sello
3187 @unnumberedsubsubsec Eliminar el sello
3188 @translationof Removing the stencil
3190 @cindex sello, eliminar
3192 Todo objeto de presentación tiene una propiedad stencil (sello). De
3193 forma predeterminada está establecida a la función específica que
3194 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
3195 se llama a ninguna función y el objeto no se dibuja. La acción
3196 predeterminada se puede recuperar con @code{\revert}.
3198 @lilypond[quote,verbatim,relative=1]
3200 \override Score.BarLine.stencil = ##f
3202 \revert Score.BarLine.stencil
3207 @node Hacer transparentes los objetos
3208 @unnumberedsubsubsec Hacer transparentes los objetos
3209 @translationof Making objects transparent
3211 @cindex transparentes, hacer los objetos
3213 Todo objeto de presentación tiene una propiedad transparent
3214 (transparente) que de forma predeterminada está establecida a
3215 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
3218 @lilypond[quote,verbatim,relative=2]
3220 \once \override NoteHead.transparent = ##t
3225 @node Pintar los objetos de blanco
3226 @unnumberedsubsubsec Pintar los objetos de blanco
3227 @translationof Painting objects white
3229 @cindex objetos, coloreado de
3230 @cindex coloreado de objetos
3232 @cindex impresión, orden de
3233 @cindex sobreescritura de objetos
3234 @cindex objetos, sobreescritura de
3235 @cindex grobs, sobreescritura de
3237 Todo objeto de presentación tiene una propiedad de color que de forma
3238 predeterminada está establecida a @code{black} (negro). Si se
3239 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
3240 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
3241 color de los puntos de cruce queda determinado por el orden en que se
3242 dibujan estos objetos, lo que puede dejar una imagen fantasma del
3243 objeto blanco, como puede verse aquí:
3245 @lilypond[quote,verbatim,relative=2]
3246 \override Staff.Clef.color = #white
3250 Se puede evitar esto cambiando el orden de impresión de los objetos.
3251 Todos los objetos de presentación tienen una propiedad @code{layer}
3252 (capa) que se debe establecer a un valor entero. Los objetos con el
3253 valor de @code{layer} más bajo se dibujan primero, después se dibujan
3254 los objetos con valores progresivamente mayores, y así los objetos con
3255 valores más altos se dibujan encima de los que tienen valores más
3256 bajos. De forma predeterminada, casi todos los objetos tienen
3257 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
3258 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
3259 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
3260 impresión de los objetos con el mismo valor de @code{layer} es
3263 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
3264 predeterminado de @code{1}, se dibuja después de las líneas del
3265 pentagrama (valor @code{layer} predeterminado de @code{0}),
3266 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
3267 @code{Clef} un valor de @code{layer} más bajo, digamos @w{@code{-1}},
3268 para que se dibuje antes:
3270 @lilypond[quote,verbatim,relative=2]
3271 \override Staff.Clef.color = #white
3272 \override Staff.Clef.layer = #-1
3277 @node Uso de break-visibility (visibilidad en el salto)
3278 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
3279 @translationof Using break-visibility
3281 @c TODO Add making other objects breakable
3283 @cindex break-visibility
3285 Casi todos los objetos de presentación se imprimen una sola vez, pero
3286 algunos como las líneas divisorias, claves, indicaciones de compás y
3287 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
3288 se produce un salto de línea : una vez al final de la línea y otra al
3289 comienzo de la siguiente. Estos objetos reciben el nombre de
3290 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
3291 (visibilidad en el salto), para controlar su visibilidad en las tres
3292 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
3293 la línea si se produce un cambio, y al final de la línea si el cambio
3294 se produce en ese lugar.
3296 Por ejemplo, la indicación de compás se imprime de forma
3297 predeterminada al comienzo de la primera línea y en ningún otro lugar
3298 a no ser que cambie, en cuyo caso se imprime en el punto en que se
3299 produce el cambio. Si este cambio se produce al final de una línea,
3300 la nueva indicación de compás se imprime al principio de la línea
3301 siguiente y también al final de la línea anterior como indicación de
3304 Este comportamiento se controla por medio de la propiedad
3305 @code{break-visibility}, que se explica en
3306 @c Leave this ref on a newline - formats incorrectly otherwise -td
3307 @rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
3308 vector de tres valores booleanos que, por orden, determinan si el
3309 objeto se imprime al final, dentro, o al principio de la línea. O,
3310 para ser más exactos: antes del salto de línea, si no hay salto, o
3313 Como alternativa se puede especificar cualquiera de las ocho
3314 combinaciones mediante funciones predefinidas cuya definición está en
3315 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
3316 los objetos de presentación serán visibles en las posiciones que se
3317 muestran en el encabezamiento de cada columna:
3319 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
3320 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
3321 @headitem de función @tab de vector @tab salto @tab salto @tab salto
3323 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
3324 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
3325 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
3326 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
3327 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
3328 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
3329 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
3330 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
3333 Los ajustes predeterminados de @code{break-visibility} dependen del
3334 objeto de presentación. La tabla siguiente muestra todos los objetos
3335 de presentación de interés que resultan afectados por
3336 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
3338 @multitable @columnfractions .3 .3 .4
3340 @headitem Objeto @tab Contexto usual @tab Valor predet.
3342 @c omit Ambitus as it appears not to be affected by break-visibility -td
3343 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
3344 @item @code{BarLine} @tab @code{Score} @tab calculado
3345 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
3346 @c omit the following item until it can be explained -td
3347 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
3348 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3349 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
3350 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
3351 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3352 @item @code{KeyCancellation} @tab @code{Staff} @tab @code{begin-of-line-invisible}
3353 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
3354 @c omit LeftEdge until it can be explained -td
3355 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
3356 @item @code{ClefModifier} @tab @code{Staff} @tab @code{begin-of-line-visible}
3357 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
3358 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
3362 El ejemplo de abajo muestra el uso de la forma de vector para
3363 controlar la visibilidad de las líneas divisorias:
3365 @lilypond[quote,verbatim,relative=1,ragged-right]
3368 % Remove bar line at the end of the current line
3369 \once \override Score.BarLine.break-visibility = ##(#f #t #t)
3375 Aunque los tres componentes del vector utilizado para sobreescribir
3376 @code{break-visibility} deben estar presentes, no todos son efectivos
3377 para todos los objetos de presentación, y algunas combinaciones pueden
3378 incluso dar errores. Son de aplicación las siguientes limitaciones:
3381 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
3382 @item No se puede imprimir el número de compás al principio de la primera
3383 línea a no ser que su valor establecido sea distinto de 1.
3384 @item Clave: véase más abajo
3385 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
3386 se suprimen por completo. Utilice begin-of line-invisible para
3387 imprimirlas y all-invisible para suprimirlas.
3388 @item Armadura: véase más abajo
3389 @item ClefModifier: véase más abajo
3393 @node Consideraciones especiales
3394 @unnumberedsubsubsec Consideraciones especiales
3395 @translationof Special considerations
3397 @subsubsubheading Visibilidad después de un cambio explícito
3399 @cindex armadura, visibilidad después de un cambio explícito
3400 @cindex explicitKeySignatureVisibility
3401 @cindex clave, visibilidad después de un cambio explícito
3402 @cindex explicitClefVisibility
3404 La propiedad @code{break-visibility} controla la visibilidad de las
3405 armaduras y cambios de clave sólo al principio de las líneas, es
3406 decir, después de un salto. No tiene ningún efecto sobre la
3407 visibilidad de la armadura o la clave después de un cambio explícito
3408 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
3409 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
3410 bemol mayor es visible incluso con @code{all-invisible} establecido.
3412 @lilypond[quote,verbatim,relative=1,ragged-right]
3415 % Try to remove all key signatures
3416 \override Staff.KeySignature.break-visibility = #all-invisible
3424 La visibilidad de estos cambios explícitos de tonalidad y de clave se
3425 controla por medio de las propiedades
3426 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
3427 Son los equivalentes de la propiedad @code{break-visibility} y las dos
3428 toman un vector de tres valores booleanos o las funciones predefinidas
3429 relacionadas anteriormente, exactamente igual que
3430 @code{break-visibility}. Las dos son propiedades del contexto Staff,
3431 no de los propios objetos de presentación, y por tanto se establecen
3432 utilizando la instrucción @code{\set}. Las dos están establecidas de
3433 forma predeterminada al valor @code{all-visible}. Estas propiedades
3434 controlan sólo la visibilidad de las armaduras y las claves que
3435 resultan de los cambios explícitos y no afectan a las armaduras y
3436 tonalidades que están al principio de las líneas; para quitarlas, aún
3437 se debe sobreescribir la propiedad @code{break-visibility} en el
3438 objeto correspondiente.
3440 @lilypond[quote,verbatim,relative=1,ragged-right]
3443 \set Staff.explicitKeySignatureVisibility = #all-invisible
3444 \override Staff.KeySignature.break-visibility = #all-invisible
3451 @subsubsubheading Visibilidad de las alteraciones de precaución
3453 Para eliminar las alteraciones de cancelación que se imprimen en un
3454 cambio de tonalidad explícito, establezca la propiedad
3455 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3457 @lilypond[quote,verbatim,relative=1,ragged-right]
3460 \set Staff.explicitKeySignatureVisibility = #all-invisible
3461 \set Staff.printKeyCancellation = ##f
3462 \override Staff.KeySignature.break-visibility = #all-invisible
3469 Con estas sobreescrituras solamente permanecen las alteraciones
3470 accidentales delante de las notas para indicar el cambio de tonalidad.
3472 Observe que al modificar la tonalidad a Do@tie{}mayor o
3473 La@tie{}menor, las alteraciones de cancelación serían @emph{la
3474 única} indicación del cambio de armadura. En este caso, el
3475 establecimiento de @code{printKeyCancellation} al valor @code{#f}
3476 no tiene ningún efecto:
3478 @lilypond[quote,verbatim,relative=1,ragged-right]
3481 \set Staff.explicitKeySignatureVisibility = #all-invisible
3482 \set Staff.printKeyCancellation = ##f
3489 En lugar de ello, para suprimir las alteraciones de cancelación
3490 aún cuando la armadura cambia a Do@tie{}mayor o a La@tie{}menor,
3491 sobreescriba la visibilidad del grob @code{KeyCancellation}:
3493 @lilypond[quote,verbatim,relative=1,ragged-right]
3496 \set Staff.explicitKeySignatureVisibility = #all-invisible
3497 \override Staff.KeyCancellation.break-visibility = #all-invisible
3504 @c TODO Add visibility of cautionary accidentals before notes
3506 @subsubsubheading Líneas divisorias automáticas
3508 @cindex automaticBars
3509 @cindex líneas divisorias, eliminación
3511 Como caso especial, la impresión de las líneas divisorias también se
3512 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
3513 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
3514 imprimen automáticamente; se deben crear explícitamente con una
3515 instrucción @code{\bar}. A diferencia de la instrucción predefinida
3516 @code{\cadenzaOn}, los compases se siguen contando. La generación de
3517 compases continúa de acuerdo a esta cuenta si esta propiedad se
3518 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
3519 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
3524 @subsubsubheading Claves transportadas
3526 @cindex transportadas, visibilidad de las claves
3527 @cindex visibilidad de las claves transportadas
3528 @cindex claves, visibilidad de la transposición
3530 El pequeño símbolo de transposición sobre una clave se produce por
3531 parte del objeto @code{ClefModifier}. Su visibilidad se hereda
3532 automáticamente de la del objeto @code{Clef}, así que no es
3533 necesario aplicar las sobreescrituras correspondientes
3534 @code{break-visibility} a los objetos @code{ClefModifier} para
3535 suprimir los símbolos de transposición u octavación para las
3538 Para los cambios de clave explícitos, la propiedad
3539 @code{explicitClefVisibility} controla tanto el símbolo de clave
3540 como el símbolo de transposición o de octava asociado.
3543 Manual de aprendizaje:
3544 @rlearning{Visibilidad y color de los objetos}
3547 @node Estilos de línea
3548 @subsection Estilos de línea
3549 @translationof Line styles
3551 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3552 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
3553 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
3555 Todos ellos usan las mismas rutinas que el glissando para dibujar los
3556 textos y las líneas, y por ello el ajuste fino de su comportamiento se
3557 hace de la misma manera. Se hace con un spanner (un objeto de
3558 extensión), y la rutina responsable de dibujar los objetos de
3559 extensión es @code{ly:line-interface::print}. Esta rutina determina la
3560 colocación exacta de los dos @i{extremos del objeto de extensión} y
3561 dibuja una línea entre ellos, en el estilo solicitado.
3563 He aquí un ejemplo de los distintos estilos de línea disponibles, y
3564 cómo aplicarles ajustes finos.
3566 @lilypond[relative=2,ragged-right,verbatim,quote]
3568 \once \override Glissando.style = #'dashed-line
3570 \override Glissando.style = #'dotted-line
3572 \override Glissando.style = #'zigzag
3574 \override Glissando.style = #'trill
3578 Las posiciones de los puntos extremos del objeto de extensión se
3579 computan al vuelo para cada uno de los objetos gráficos, pero es
3580 posible sobreescribirlos:
3583 @lilypond[relative=2,ragged-right,verbatim,quote]
3585 \once \override Glissando.bound-details.right.Y = #-2
3589 El valor de @code{Y} está establecido a @w{@code{-2}} para el extremo
3590 derecho. El lado izquierdo se puede ajustar de forma similar
3591 especificando @code{left} en vez de @code{right}.
3593 Si no está establecido @code{Y}, el valor se computa a partir de la
3594 posición vertical de los puntos de anclaje izquierdo y derecho del
3597 Son posibles otros ajustes de los extensores, para ver más detalles
3598 consulte @ref{Objetos de extensión}.
3601 @node Rotación de objetos
3602 @subsection Rotación de objetos
3603 @translationof Rotating objects
3605 Tanto los objetos de presentación como los elementos de texto de
3606 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
3607 pero difiere el método de hacerlo.
3610 * Rotación de objetos de presentación::
3611 * Rotación de elementos de marcado::
3614 @node Rotación de objetos de presentación
3615 @unnumberedsubsubsec Rotación de objetos de presentación
3616 @translationof Rotating layout objects
3618 @cindex rotating objects
3619 @cindex objects, rotating
3621 Todos los objetos de presentación que contemplan el interface
3622 @code{grob-interface} se pueden rotar estableciendo su propiedad
3623 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
3624 rotación en sentido antihorario, y las coordenadas x e y del punto con
3625 relación al punto de referencia del objeto, alrededor del que se va a
3626 realizar la rotación. El ángulo de rotación se especifica en grados
3627 y las coordenadas en espacios de pentagrama.
3629 El ángulo de rotación y las coordenadas del punto de rotación se deben
3630 determinar por ensayo y error.
3632 @cindex reguladores en ángulo
3633 @cindex ángulo, reguladores en
3635 Solamente en ciertas ocasiones es útil la rotación de objetos de
3636 presentación; el ejemplo siguiente muestra una situación en que puede
3639 @lilypond[quote,verbatim,relative=1]
3641 \override Hairpin.rotation = #'(20 -1 0)
3646 @node Rotación de elementos de marcado
3647 @unnumberedsubsubsec Rotación de elementos de marcado
3648 @translationof Rotating markup
3650 Todos los textos de marcado se pueden rotar para que se dispongan en
3651 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
3652 instrucción acepta dos argumentos: el ángulo de rotación en grados en
3653 sentido antihorario, y el texto que rotar. Los límites que ocupa el
3654 texto no se rotan: toman su valor a partir de los extremos de las
3655 coordenadas x e y del texto rotado. En el ejemplo siguiente la
3656 propiedad @code{outside-staff-priority} del texto se establece a
3657 @code{#f} para desactivar la evitación automática de colisiones, lo
3658 que empuja al texto a una posición muy alta.
3660 @lilypond[quote,verbatim,relative=1]
3661 \override TextScript.outside-staff-priority = ##f
3662 g4^\markup { \rotate #30 "a G" }
3663 b^\markup { \rotate #30 "a B" }
3664 des^\markup { \rotate #30 "a D-Flat" }
3665 fis^\markup { \rotate #30 "an F-Sharp" }
3669 @node Trucos avanzados
3670 @section Trucos avanzados
3671 @translationof Advanced tweaks
3673 Esta sección trata sobre distintos enfoques en la realización de
3674 ajustes finos a la apariencia de la partitura impresa.
3677 * Alineación de objetos::
3678 * Agrupación vertical de objetos gráficos::
3679 * Modificación de los sellos::
3680 * Modificación de las formas::
3681 * Contenedores unpure-pure::
3685 Manual de aprendizaje:
3686 @rlearning{Trucar la salida},
3687 @rlearning{Otras fuentes de información}.
3689 Referencia de la notación:
3690 @ref{Explicación del Manual de referencia de funcionamiento interno},
3691 @ref{Modificar las propiedades}.
3693 Manual de extensión:
3694 @rextend{Interfaces para programadores}.
3697 @file{scm/define-grobs.scm}.
3699 Fragmentos de código:
3700 @rlsr{Tweaks and overrides}.
3702 Referencia de funcionamiento interno:
3703 @rinternals{All layout objects}.
3706 @node Alineación de objetos
3707 @subsection Alineación de objetos
3708 @translationof Aligning objects
3710 Los objetos gráficos que soportan el interface
3711 @code{self-alignment-interface} y/o el @code{side-position-interface}
3712 se pueden alinear contra un objeto colocado previamente, de diversas
3713 maneras. Para ver una lista de estos objetos, consulte
3714 @rinternals{self-alignment-interface} y
3715 @rinternals{side-position-interface}.
3717 Todos los objetos gráficos tienen un punto de referencia, una
3718 extensión horizontal y una extensión vertical. La extensión
3719 horizontal es una pareja de números que dan los desplazamientos a
3720 partir del punto de referencia de los bordes izquierdo y derecho,
3721 siendo negativos los desplazamientos hacia la izquierda. La extensión
3722 vertical es una pareja de números que dan el desplazamiento a partir
3723 del punto de referencia hasta los bordes inferior y superior, siendo
3724 negativos los desplazamientos hacia abajo.
3726 La posición de un objeto sobre el pentagrama viene dada por los
3727 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
3728 valor de @code{X-offset} da el desplazamiento desde la coordenada X
3729 del punto de referencia del objeto padre, y el valor de
3730 @code{Y-offset} da el desplazamiento a partir de la línea central del
3731 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
3732 pueden establecer directamente o se puede dejar que se calculen por
3733 parte de procedimientos para conseguir una alineación con el objeto
3736 @warning{Muchos objetos tienen consideraciones de posicionamiento
3737 especiales que hacen que se ignore o se modifique cualquier ajuste
3738 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
3739 objeto contemple el interface @code{self-alignment-interface}. La
3740 sobreescritura de las propiedades @code{X-offset} ó @code{Y-offset} a
3741 un valor fijo hace que se descarte la respectiva propiedad
3742 @code{self-alignment}.}
3744 Por ejemplo, una alteración accidental se puede reposicionar
3745 verticalmente estableciendo @code{Y-offset} pero los cambios a
3746 @code{X-offset} no tienen ningún efecto.
3748 Las letras de ensayo se pueden alinear con objetos divisibles como
3749 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
3750 propiedades especiales que se encuentran en
3751 @code{break-aligned-interface} para el posicionamiento de las letras
3752 de ensayo sobre dichos objetos.
3755 Referencia de la notación:
3756 @ref{Uso del break-alignable-interface}.
3758 Manual de extensión:
3759 @rextend{Funciones de callback}.
3762 * Establecer directamente X-offset e Y-offset::
3763 * Uso del side-position-interface::
3764 * Uso del self-alignment-interface::
3765 * Uso del break-alignable-interface::
3769 @node Establecer directamente X-offset e Y-offset
3770 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
3771 @translationof Setting X-offset and Y-offset directly
3773 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
3774 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
3775 notas con una digitación en su posición predeterminada y con los
3776 valores @code{X-offset} y @code{Y-offset} modificados.
3778 @lilypond[verbatim,quote,relative=2]
3785 -\tweak X-offset #-1
3793 @node Uso del side-position-interface
3794 @unnumberedsubsubsec Uso del @code{side-position-interface}
3795 @translationof Using the side-position-interface
3797 Un objeto que contempla el @code{side-position-interface} se puede
3798 colocar junto a su objeto padre de forma que los bordes especificados
3799 de los dos objetos se toquen. El objeto se puede situar encima,
3800 debajo, a la derecha o a la izquierda del objeto padre. El padre no
3801 se puede especificar; viene determinado por el orden de los elementos
3802 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
3803 nota asociada como padre.
3805 Los valores de las propiedades @code{side-axis} y @code{direction}
3806 determinan dónde colocar el objeto, como sigue:
3808 @c TODO add an example of each to the table
3810 @multitable @columnfractions .3 .3 .3
3811 @headitem @code{side-axis} @tab @code{direction} @tab
3812 @headitem propiedad @tab propiedad @tab colocación
3814 @item @code{0} @tab @w{@code{-1}} @tab izquierda
3815 @item @code{0} @tab @code{1} @tab derecha
3816 @item @code{1} @tab @w{@code{-1}} @tab debajo
3817 @item @code{1} @tab @code{1} @tab encima
3821 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
3822 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
3823 procedimiento devuelve el calor correcto de @code{X-offset} para
3824 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
3825 el valor de @code{direction}.
3827 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
3828 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
3829 procedimiento devuelve el valor correcto de @code{Y-offset} para
3830 situar el objeto encima o debajo del padre de acuerdo con el valor de
3833 @c TODO Add examples
3836 @node Uso del self-alignment-interface
3837 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
3838 @translationof Using the self-alignment-interface
3840 @subsubsubheading Auto-alineación horizontal de los objetos
3842 La alineación horizontal de un objeto que contempla el interface
3843 @code{self-alignment-interface} está controlada por el valor de la
3844 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
3845 @code{X-offset} de este objeto esté establecida a
3846 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
3847 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
3848 mitad de la extensión X total del objeto. Los valores negativos
3849 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
3850 valor de @code{0} centra el objeto sobre el punto de referencia de su
3851 padre, un valor de @w{@code{-1}} alinea el borde izquierdo del objeto
3852 sobre el punto de referencia de su padre, y un valor de @code{1}
3853 alinea el borde derecho del objeto sobre el punto de referencia de su
3854 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
3855 @code{RIGHT} en sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
3858 Normalmente se usaría la instrucción @code{\override} para modificar
3859 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
3860 @code{\tweak} para alinear varias anotaciones por separado sobre una
3863 @lilypond[quote,verbatim,relative=1]
3865 -\tweak self-alignment-X #-1
3867 -\tweak self-alignment-X #0
3869 -\tweak self-alignment-X #RIGHT
3871 -\tweak self-alignment-X #-2.5
3872 ^"aligned further to the right"
3875 @subsubsubheading Auto-alineación vertical de los objetos
3877 Los objetos se pueden alinear verticalmente en una forma análoga a la
3878 alineación horizontal si la propiedad @code{Y-offset} está establecida
3879 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
3880 a menudo se encuentran implicados otros mecanismos en la alineación
3881 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
3882 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
3883 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
3884 las dimensiones verticales del objeto, que suele ser bastante pequeño,
3885 por lo que pueden requerirse números bastante grandes. Un valor de
3886 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
3887 referencia del objeto padre, un valor de @code{0} alinea el centro del
3888 objeto con el punto de referencia del padre, y un valor de @code{1}
3889 alinea el borde superior del objeto con el punto de referencia del
3890 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
3891 @code{UP} en sustitución de @w{@code{-1}},
3892 @code{0} y @code{1}, respectivamente.
3894 @emph{Auto-alineación de objetos en las dos direcciones}
3896 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
3897 alinear un objeto en las dos direcciones simultáneamente.
3899 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
3900 se acerque a la cabeza de la nota.
3902 @lilypond[quote,verbatim,relative=2]
3904 -\tweak self-alignment-X #0.5 % move horizontally left
3905 -\tweak Y-offset #ly:self-alignment-interface::y-aligned-on-self
3906 -\tweak self-alignment-Y #-1 % move vertically up
3911 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
3913 @c Cannot document as they do not seem to operate consistently on all objects -td
3914 @c TODO investigate further
3916 The @code{aligned-on-parent} procedures are used in the same way
3917 as the @code{aligned-on-self} procedures, they difference being
3918 that they permit an object to be aligned with the @emph{edges} of
3919 the parent rather than the parent's reference point. The following
3920 example shows the difference:
3924 @lilypond[verbatim,quote]
3930 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
3932 @c Cannot document as they do not seem to operate consistently on all objects -td
3933 @c TODO investigate further
3937 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
3940 @node Uso del break-alignable-interface
3941 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
3942 @translationof Using the break-alignable-interface
3944 @cindex alineación a objetos
3945 @cindex break-align-symbols
3947 Las letras de ensayo se pueden alinear con objetos de notación
3948 distintos a las barras de compás. Estos objetos son @code{ambitus},
3949 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
3950 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
3951 @code{time-signature}.
3953 Cada tipo de objeto tiene su propio punto de referencia
3954 predeterminado, con el que se alinean las marcas de ensayo:
3956 @lilypond[verbatim,quote,relative=1]
3957 % The rehearsal mark will be aligned to right edge of the Clef
3958 \override Score.RehearsalMark.break-align-symbols = #'(clef)
3963 % The rehearsal mark will be centered above the Time Signature
3964 \override Score.RehearsalMark.break-align-symbols = #'(time-signature)
3970 % The rehearsal mark will be centered above the Breath Mark
3971 \override Score.RehearsalMark.break-align-symbols = #'(breathing-sign)
3980 Se puede especificar una lista de posibles objetos para la alineación.
3981 Si algunos de los objetos son invisibles en ese punto debido al valor
3982 de @code{break-visibility} o a valores de visibilidad explícitos para
3983 las armaduras y las claves, la letra de ensayo o número de compás se
3984 alinean con el primer objeto de la lista que sea visible. Si ningún
3985 objeto de la lista es visible, el objeto se alinea con la línea
3986 divisoria. Si la línea divisoria es invisible, el objeto se alinea
3987 con el punto en el que se encontraría la línea divisoria.
3989 @lilypond[verbatim,quote,relative=1]
3990 % The rehearsal mark will be aligned to the right edge of the Key Signature
3991 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
3996 % The rehearsal mark will be aligned to the right edge of the Clef
3997 \set Staff.explicitKeySignatureVisibility = #all-invisible
3998 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4003 % The rehearsal mark will be centered above the Bar Line
4004 \set Staff.explicitKeySignatureVisibility = #all-invisible
4005 \set Staff.explicitClefVisibility = #all-invisible
4006 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4013 La alineación de la letra de ensayo con relación al objeto de notación
4014 se puede cambiar, como se ve en el ejemplo siguiente. En una
4015 partitura con varios pentagramas, este ajuste se debe hacer para todos
4018 @lilypond[verbatim,quote,relative=1]
4019 % The RehearsalMark will be aligned with the right edge of the Key Signature
4020 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4026 % The RehearsalMark will be centered above the Key Signature
4027 \once \override Score.KeySignature.break-align-anchor-alignment = #CENTER
4031 % The RehearsalMark will be aligned with the left edge of the Key Signature
4032 \once \override Score.KeySignature.break-align-anchor-alignment = #LEFT
4038 La letra de ensayo también se puede desplazar al borde derecho o
4039 izquierdo en una medida arbitraria. Las unidades son espacios de
4042 @lilypond[verbatim,quote,relative=1]
4043 % The RehearsalMark will be aligned with the left edge of the Key Signature
4044 % and then shifted right by 3.5 staff-spaces
4045 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4046 \once \override Score.KeySignature.break-align-anchor = #3.5
4050 % The RehearsalMark will be aligned with the left edge of the Key Signature
4051 % and then shifted left by 2 staff-spaces
4052 \once \override Score.KeySignature.break-align-anchor = #-2
4059 @node Agrupación vertical de objetos gráficos
4060 @subsection Agrupación vertical de objetos gráficos
4061 @translationof Vertical grouping of grobs
4063 @c TODO Expand this section
4065 Los grobs (objetos gráficos) @code{VerticalAlignment} y
4066 @code{VerticalAxisGroup} trabajan de manera coordinada.
4067 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
4068 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
4069 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
4070 Normalmente sólo existe un @code{VerticalAlignment} por cada
4071 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
4072 @code{VerticalAxisGroup}.
4075 @node Modificación de los sellos
4076 @subsection Modificación de los sellos
4077 @translationof Modifying stencils
4079 Todos los objetos de presentación tienen una propiedad @code{stencil}
4080 que es parte del @code{grob-interface}. De forma predeterminada, esta
4081 propiedad suele estar establecida a una función específica del objeto
4082 que está hecha a medida para disponer el símbolo que lo representa en
4083 la salida. Por ejemplo, el ajuste estándar para la propiedad
4084 @code{stencil} del objeto @code{MultiMeasureRest} es
4085 @code{ly:multi-measure-rest::print}.
4087 El símbolo estándar de cualquier objeto se puede sustituir modificando
4088 la propiedad @code{stencil} para que haga referencia a un
4089 procedimiento diferente escrito especialmente. Esto requiere un alto
4090 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
4091 una forma más fácil que a menudo puede dar resultados adecuados.
4093 El procedimiento es establecer la propiedad @code{stencil} al
4094 procedimiento que imprime texto (@code{ly:text-interface::print}) y
4095 añadir una propiedad @code{text} al objeto ajustada para que contenga
4096 el texto de marcado que produce el símbolo requerido. Debido a la
4097 flexibilidad del marcado, se pueden conseguir muchas cosas; en
4098 particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
4100 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
4101 la nota a unas aspas dentro de una circunferencia.
4103 @lilypond[verbatim,quote]
4105 \once \override NoteHead.stencil = #ly:text-interface::print
4106 \once \override NoteHead.text = \markup {
4108 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
4109 \musicglyph #"noteheads.s2cross"
4117 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
4118 a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
4120 @c TODO Add inserting eps files or ref to later
4122 @c TODO Add inserting Postscript or ref to later
4125 Referencia de la notación:
4126 @ref{Notación gráfica dentro de elementos de marcado},
4127 @ref{Formatear el texto},
4128 @ref{Text markup commands},
4129 @ref{La tipografía Feta}.
4132 @node Modificación de las formas
4133 @subsection Modificación de las formas
4134 @translationof Modifying shapes
4137 * Modificación de ligaduras de unión y de expresión::
4141 @node Modificación de ligaduras de unión y de expresión
4142 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
4143 @translationof Modifying ties and slurs
4145 @cindex ligaduras de expresión, modificar
4146 @cindex ligaduras de unión, modificar
4147 @cindex Bézier, curvas de, puntos de control
4148 @cindex puntos de control en curvas de Bézier
4150 Las ligaduras de unión (@code{Tie}s), de expresión (@code{Slur}s),
4151 de fraseo (@code{PhrasingSlur}s), de dejar vibrar
4152 (@code{LaissezVibrerTie}s) y de repetición (@code{RepeatTie}s) se
4153 trazan como curvas de Bézier de tercer orden. Si la forma de la
4154 ligadura calculada automáticamente no resulta óptima, se puede
4155 modificar su forma manualmente de dos formas:
4159 mediante la especificación de los desplazamientos que se quieren
4160 realizar sobre los puntos de control de la curva de Bézier
4161 calculada automáticamente, o bien
4164 mediante la especificación explícita de las posiciones de los
4165 cuatro puntos de control que se requieren para definir la curva
4169 A continuación se explican ambos métodos. El primer método es más
4170 adecuado cuando solo se requieren ligeros ajustes de la curva; el
4171 segundo puede ser mejor para crear curvas que tienen relación con
4174 @subsubsubheading Curvas de Bézier cúbicas
4176 Las curvas Bézier de tercer orden o cúbicas están definidas por
4177 cuatro puntos de control. El primer y cuarto puntos de control
4178 son exactamente los puntos extremos de comienzo y de final de la
4179 curva. Los dos puntos de control intermedios definen la forma.
4180 Se pueden encontrar en la web animaciones que muestran cómo se
4181 traza la curva, pero la descripción siguiente puede ser de ayuda.
4182 La curva comienza a partir del primer punto de control
4183 dirigiéndose directamente hacia el segundo, curvándose
4184 progresivamente para dirigirse hacia el tercero y continuando la
4185 curva hacia el cuarto, llegando a éste en viaje directo desde el
4186 tercer punto de control. La curva está contenida enteramente
4187 dentro del cuadrilátero definido por los cuatro puntos de control.
4188 Todas las traslaciones, rotaciones y escalado de los puntos de
4189 control producen exactamente las mismas operaciones sobre la
4192 @subsubsubheading Especificar desplazamientos a partir de los puntos de control actuales
4194 @cindex conformar ligaduras
4197 En este ejemplo, la colocación automática de la ligadura no
4198 resulta óptima, y @code{\tieDown} no es la solución.
4200 @lilypond[verbatim,quote,relative=1]
4204 { r4 <g c,> <g c,> <g c,> }
4208 El ajuste de los puntos de control de la ligadura mediante la
4209 instrucción @code{\shape} permite evitar las colisiones.
4211 La sintaxis de @code{\shape} es:
4214 [-]@code{\shape} @var{desplazamientos} @var{elemento}
4217 Esta instrucción recoloca los puntos de control de @var{elemento}
4218 en las cantidades dadas por @var{desplazamientos}. El argumento
4219 @var{desplazamientos} es una lista de parejas de números o una
4220 lista de tales listas. Cada elemento de una pareja representa el
4221 desplazamiento de una de las coordenadas de un punto de control.
4222 Si el @var{elemento} es una cadena de caracteres, el resultado es
4223 @code{\once\override} para el tipo de grob especificado. Si
4224 @var{elemento} es una expresión musical, el resultado es la misma
4225 expresión musical con la consiguiente modificación aplicada.
4227 En otras palabras, la función @code{\shape} puede actuar como una
4228 instrucción @code{\once\override} o como una instrucción
4229 @code{\tweak} dependiendo de si el argumento @var{elemento} es el
4230 nombre de un grob, como @qq{Slur}, o una expresión musical, como
4231 @qq{(}. El argumento @var{desplazamientos} especifica los
4232 desplazamientos de los cuatro puntos de control como una lista de
4233 cuatro parejas de valores (dx . dy) en unidades de espacios de
4234 pentagrama (o una lista de tales listas si la curva tiene más de
4237 El guión precedente se exige si, y sólo si, se usa la forma
4240 Así, usando el mismo ejemplo de arriba y la forma
4241 @code{\once\override} de la instrucción @code{\shape}, lo
4242 siguiente tiene el efecto de elevar la ligadura de unión en la
4243 mitad de un espacio de pentagrama:
4245 @lilypond[verbatim,quote,relative=1]
4248 \shape #'((0 . 0.5) (0 . 0.5) (0 . 0.5) (0 . 0.5)) Tie
4252 { r4 <g c,> <g c,> <g c,> }
4256 Este posicionamiento de la ligadura de unión es mejor, pero quizá
4257 debería elevarse más en la parte central. El ejemplo siguiente
4258 hace esto, esta vez usando la forma alternativa @code{\tweak}:
4260 @lilypond[verbatim,quote,relative=1]
4263 e1-\shape #'((0 . 0.5) (0 . 1) (0 . 1) (0 . 0.5)) ~ e
4266 { r4 <g c,> <g c,> <g c,> }
4270 Los cambios en las posiciones horizontales de los puntos de
4271 control se pueden hacer de la misma forma, y dos curvas distintas
4272 que dan comienzo en el mismo momento musical se pueden conformar
4275 @lilypond[verbatim,quote,ragged-right,relative=2]
4277 \shape #'((0.7 . -0.4) (0.5 . -0.4) (0.3 . -0.3) (0 . -0.2)) Slur
4278 \shape #'((0 . 0) (0 . 0.5) (0 . 0.5) (0 . 0)) PhrasingSlur
4282 La función @code{\shape} también puede desplazar los puntos de
4283 control de las curvas que se extienden atravesando saltos de
4284 línea. Cada pieza de la curva dividida puede recibir su propia
4285 lista de desplazamientos. Si no se necesita hacer cambios a uno
4286 de los segmentos en particular, se puede usar una lista vacía como
4287 contenedor. En este ejemplo, el salto de línea hace que la única
4288 ligadura de expresión aparezca como si fueran dos:
4290 @lilypond[verbatim,quote,ragged-right,relative=1]
4296 Los cambios en la forma de las dos mitades de la ligadura de
4297 expresión deja más claro que la ligadura continúa más allá del
4300 @lilypond[verbatim,quote,ragged-right,relative=1]
4301 % () may be used as a shorthand for ((0 . 0) (0 . 0) (0 . 0) (0 . 0))
4302 % if any of the segments does not need to be changed
4304 (( 0 . 0) (0 . 0) (0 . 0) (0 . 1))
4305 ((0.5 . 1.5) (1 . 0) (0 . 0) (0 . -1.5))
4312 En una curva en forma de «S» siempre es necesario ajustar
4313 manualmente los puntos de control: LilyPond nunca escoge tales
4314 formas automáticamente.
4316 @lilypond[verbatim,quote,relative=2]
4317 c8( e b-> f d' a e-> g)
4318 \shape #'((0 . -1) (5.5 . -0.5) (-5.5 . -10.5) (0 . -5.5)) PhrasingSlur
4319 c8\( e b-> f d' a e-> g\)
4322 @subsubsubheading Especificar los puntos de control explícitamente
4324 Las coordenadas de los puntos de contro de Bézier se especifican
4325 en unidades de espacios de pentagrama. La coordenada@tie{}X es
4326 relativa al punto de referencia al que se adjunta la ligadura, y
4327 la coordenada@tie{}Y es relativa a la línea central del
4328 pentagrama. Las coordenadas se especifican como una lista de
4329 cuatro parejas de números decimales (reales). Un enfoque consiste
4330 en estimar las coordenadas de los dos extremos, y después adivinar
4331 los dos puntos intermedios. Los valores óptimos se encuentran
4332 después por ensayo y error. Tenga en cuenta que estos valores
4333 podrían requerir un ajuste manual si se hace posteriormente
4334 cualquier cambio manual a la música o a la disposición.
4336 Una situación en la que es preferible especificar los puntos de
4337 control explícitamente a especificar los desplazamientos es cuando
4338 se necesita especificarlos de forma relativa a una nota única. A
4339 continuación presentamos un ejemplo de esto. Muestra una forma de
4340 indicar una ligadura que se extiende hacia el interior de las
4341 casillas de primera y segunda vez de una repetición.
4343 @lilypond[verbatim,quote,relative=2]
4345 \repeat volta 3 { c4 d( e f }
4350 % create a slur and move it to a new position
4351 % the <> is just an empty chord to carry the slur termination
4352 -\tweak control-points #'((-2 . 3.8) (-1 . 3.9) (0 . 4) (1 . 3.4)) ( <> )
4357 % create a slur and move it to a new position
4358 -\tweak control-points #'((-2 . 3) (-1 . 3.1) (0 . 3.2) (1 . 2.4)) ( <> )
4365 No es posible modificar la forma de las ligaduras de unión o de
4366 expresión cambiando la propiedad @code{control-points} si hay más
4367 de una en el mismo momento musical, ni siquiera usando la
4368 instrucción @code{\tweak}. Sin embargo, se puede sobreescribir la
4369 propiedad @code{tie-configuration} de @code{TieColumn} para fijar
4370 la línea de inicio y la dirección según se requiera.
4373 Referencia de funcionamiento interno:
4374 @rinternals{TieColumn}.
4377 @node Contenedores unpure-pure
4378 @subsection Contenedores unpure-pure
4379 @translationof Unpure-pure containers
4381 @cindex Scheme, contenedores puros
4382 @cindex Scheme, contenedores no-puros
4383 @cindex puros, contenedores de Scheme
4384 @cindex no-puros: contenedores de Scheme
4385 @cindex horizontal, sobreescribir el espaciado
4387 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para la
4388 sobreescritura de los cálculos del espaciado en el @emph{eje Y}
4389 (concretamente @code{Y-offset} e @code{Y-extent}) con una función de
4390 Scheme en lugar de un literal, es decir, un número o una pareja de
4393 Para ciertos objetos gráficos, las dimensiones @code{Y-extent} están
4394 basadas en la propiedad @code{stencil}, la sobreescritura de la
4395 propiedad de sello de éstos requiere una sobreescritura adicional de
4396 @code{Y-extent} con un contenedor unpure-pure. Cuando una función
4397 sobreescribe una dimensión @code{Y-offset} y/o @code{Y-extent} se
4398 supone que esto dispara los cálculos de los saltos de línea
4399 prematuramente durante la compilación. Así pues, la función no se
4400 evalúa en absoluto (devolviendo por lo general un valor de @samp{0} o
4401 @samp{'(0 . 0)}) lo que puede dar lugar a colisiones. Una función
4402 @q{pura} no afecta a las propiedades, objetos o suicidios de grobs, y
4403 por ello siempre ven sus valores relacionados con el eje Y evaluados
4406 Actualmente hay unas treinta funciones que ya se consideran @q{puras}
4407 y los contenedores Unpure-pure son una manera de establecer funciones
4408 que no están en esta lista como @q{puras}. La función @q{pura} se
4409 evalúa @emph{antes} de cualquier salto de línea y así el espaciado
4410 horizontal se puede ajustar @q{a tiempo}. La función @q{impura} se
4411 evalúa entonces @emph{después} del salto de línea.
4413 @warning{Dado que es difícil saber siempre qué funciones están en esta
4414 lista, recomendamos que cualquier función @q{pura} que estemos creando
4415 no utilice los grobs @code{Beam} o @code{VerticalAlignment}.}
4417 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
4419 @code{(ly:make-unpure-pure-container f0 f1)}
4421 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
4422 1}) y el primer argumento siempre debe ser el grob. Ésta es la
4423 función que da el resultado real. @var{f1} es la función que se
4424 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
4425 primer argumento debe ser siempre el grob pero los argumentos segundo
4426 y tercero son argumentos de @q{inicio} y de @q{final}.
4428 @var{inicio} y @var{final} son, a todos los efectos, valores mudos que
4429 sólo tienen importancia para los @code{objetos de extensión} (o sea:
4430 @code{Hairpin}, regulador, o @code{Beam}, barra), que pueden devolver
4431 distintas estimaciones de altura basadas en una columna de inicio y
4434 El resto son los otros argumentos para la primera función (que puede
4435 no ser ninguno si @var{n = 1}).
4437 El resultado de la segunda función se usa como una aproximación del
4438 valor necesario, que se usa entonces por la primera función para
4439 obtener el valor real que se usa a continuación para el ajuste de
4440 precisión mucho más tardío durante el proceso de espaciado.
4442 @lilypond[verbatim,quote,ragged-right]
4443 #(define (square-line-circle-space grob)
4444 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
4445 (notename (ly:pitch-notename pitch)))
4446 (if (= 0 (modulo notename 2))
4447 (make-circle-stencil 0.5 0.0 #t)
4448 (make-filled-box-stencil '(0 . 1.0)
4451 squareLineCircleSpace = {
4452 \override NoteHead.stencil = #square-line-circle-space
4455 smartSquareLineCircleSpace = {
4456 \squareLineCircleSpace
4457 \override NoteHead.Y-extent =
4458 #(ly:make-unpure-pure-container
4459 ly:grob::stencil-height
4460 (lambda (grob start end) (ly:grob::stencil-height grob)))
4463 \new Voice \with { \remove "Stem_engraver" }
4465 \squareLineCircleSpace
4467 \smartSquareLineCircleSpace
4472 En el primer compás, sin el contenedor @emph{unpure-pure}, el motor de
4473 espaciado no conoce la anchura de la cabeza de la nota y permite que
4474 colisione con las alteraciones accidentales. En el segundo compás, el
4475 motor de espaciado conoce la anchura de las cabezas de las notas y
4476 evita la colisión mediante el alargamiento de la línea en la medida
4479 Normalmente, para cálculos simples se pueden usar funciones casi
4480 idénticas tanto para las partes @q{no pura} y @q{pura}, simplemente
4481 cambiando el número de argumentos que se pasan a, y el ámbito de, la
4484 @warning{Si una función está caracterizada como @q{pura} y resulta que
4485 no lo es, el resultado puede ser inesperado.}
4488 @node Uso de las funciones musicales
4489 @section Uso de las funciones musicales
4490 @translationof Using music functions
4492 @c TODO -- add @seealso, etc. to these subsections
4494 Dondequiera que se necesite reutilizar trucos con distintas
4495 expresiones musicales, con frecuencia conviene hacer que el truco
4496 forme parte de una @emph{función musical}. En esta sección
4497 estudiaremos solamente las funciones de @emph{sustitución}, en las que
4498 el objeto es sustituir una variable dentro de un fragmento de código
4499 de entrada de LilyPond. Se describen otras funciones más complejas en
4500 @rextend{Funciones musicales}.
4503 * Sintaxis de las funciones de sustitución::
4504 * Ejemplos de funciones de sustitución::
4508 @node Sintaxis de las funciones de sustitución
4509 @subsection Sintaxis de las funciones de sustitución
4510 @translationof Substitution function syntax
4512 Es fácil hacer una función que sustituya una variable dentro de código
4513 de LilyPond. La forma general de estas funciones es
4517 #(define-music-function
4518 (parser location @var{arg1} @var{arg2} @dots{})
4519 (@var{type1?} @var{type2?} @dots{})
4521 @var{@dots{}música@dots{}}
4528 @multitable @columnfractions .33 .66
4529 @item @code{@var{argN}}
4530 @tab @var{n}-ésimo argumento
4532 @item @code{@var{typeN?}}
4533 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
4534 debe devolver @code{#t}.
4536 @item @code{@var{@dots{}música@dots{}}}
4537 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
4538 lugares en que sólo se permiten construcciones de Lilypond) o @code{#}
4539 (para usarlo como un valor de Scheme o un argumento de función musical
4540 o música dentro de listas de música) para referenciar argumentos
4541 (p.ej. @samp{#arg1}).
4544 Los argumentos @code{parser} y @code{location} son necesarios, y se
4545 utilizan en algunas situaciones avanzadas como se encuentra descrito
4546 en @rextend{Sintaxis de las funciones musicales}. Para las funciones
4547 de sustitución, tan sólo hemos de asegurarnos de incluirlos.
4549 También es necesaria la lista de predicados de tipo. Algunos de los
4550 predicados de tipo más comunes que se utilizan en las funciones
4555 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
4567 Para ver una lista de los predicados de tipo disponibles, consulte
4568 @ref{Predicados de tipo predefinidos}. También se permiten los
4569 predicados de tipo definidos por el usuario.
4572 Referencia de la notación:
4573 @ref{Predicados de tipo predefinidos}.
4575 Expansión de LilyPond:
4576 @rextend{Sintaxis de las funciones musicales}.
4578 Archivos instalados:
4579 @file{lily/music-scheme.cc},
4581 @file{scm/lily.scm}.
4584 @node Ejemplos de funciones de sustitución
4585 @subsection Ejemplos de funciones de sustitución
4586 @translationof Substitution function examples
4588 Esta sección presenta algunos ejemplos de funciones de sustitución.
4589 No pretenden ser exhaustivas, sino demostrar algunas de las
4590 posibilidades de las funciones de sustitución sencillas.
4592 En el primer ejemplo se define una función que simplifica el ajuste
4593 del relleno de un elemento de inscripción de texto TextScript:
4595 @lilypond[quote,verbatim,ragged-right]
4597 #(define-music-function
4598 (parser location padding)
4601 \once \override TextScript.padding = #padding
4605 c4^"piu mosso" b a b
4607 c4^"piu mosso" d e f
4609 c4^"piu mosso" fis a g
4613 Además de números, podemos usar expresiones musicales, como notas,
4614 para los argumentos de las funciones musicales:
4616 @lilypond[quote,verbatim,ragged-right]
4618 #(define-music-function
4619 (parser location note)
4622 \tweak NoteHead.stencil #ly:text-interface::print
4623 \tweak NoteHead.text
4624 \markup \musicglyph #"custodes.mensural.u0"
4625 \tweak Stem.stencil ##f
4629 \relative c' { c4 d e f \custosNote g }
4632 Se pueden definir funciones de sustitución con más de un argumento:
4634 @lilypond[quote,verbatim,ragged-right]
4636 #(define-music-function
4637 (parser location padding tempotext)
4640 \once \override Score.MetronomeMark.padding = #padding
4641 \tempo \markup { \bold #tempotext }
4645 \tempo \markup { "Low tempo" }
4647 \tempoPadded #4.0 "High tempo"
4652 @c TODO: add appropriate @@ref's here.