1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: a43fe59b0205af99f84532935b103d0c064b4526
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 * Definiciones de salida - estructura de los contextos::
99 * Score. El contexto maestro::
100 * Contextos del nivel superior. Contenedores de pentagramas::
101 * Contextos de nivel intermedio. Pentagramas::
102 * Contextos del nivel más bajo. Voces::
105 @node Definiciones de salida - estructura de los contextos
106 @unnumberedsubsubsec Definiciones de salida - estructura de los contextos
107 @translationof Output definitions - blueprints for contexts
109 Esta sección explica la relevancia de las definiciones de salida
110 cuando se trabaja con los contextos. Más adelante ofrecemos
111 ejemplos de definiciones de salida reales (véase
112 @ref{Cambiar todos los contextos del mismo tipo}).
114 @cindex salida, definiciones de
116 Aunque la música escrita en un archivo haga referencia a tipos y
117 nombres de contexto, los contextos se crean solamente cuando la
118 música se está realmente interpretando. LilyPond interpreta la
119 música bajo el control de una @q{definición de salida} y puede
120 hacerlo así para varias definiciones de salida distintas, dando
121 como resultado distintas salidas también. La definicion de salida
122 que corresponde a la impresión de la música se especifica mediante
126 Una definición de salida mucho más sencilla que se usa para la
127 producción de MIDI se especifica mediante @code{\midi}.
128 Internamente, LilyPond utiliza varias otras definiciones de
129 salida, como cuando se usa el combinador de particellas
130 (@ref{Combinación automática de las partes}) o se crean fragmentos
131 de notas guía citadas (@ref{Citar otras voces}).
133 Las definiciones de salida establecen la relación entre los
134 contextos así como sus respectivos valores predeterminados.
135 Aunque la mayor parte de los cambios se suelen hacer dentro de un
136 bloque @code{\layout}, los ajustes de valores relacionados con el
137 MIDI solamente tienen efecto cuando se hacen dentro de un bloque
140 @funindex autoBeaming
141 Algunos ajustes afectan a varias salidas: por ejemplo, si se
142 desactiva el barrado automático, @code{autoBeaming}, dentro de
143 algún contexto, las barras cuentan como melismas en lo que
144 respecta a la correspondencia entre la música y la letra, como se
145 describe en @ref{Duración automática de las sílabas}. Esta
146 correspondencia se hace tanto para la salida impresa como para el
147 MIDI. Si los cambios hechos sobre el @code{autoBeaming} dentro de
148 la definición de contexto de un bloque @code{\layout} no se
149 repiten dentro del correspondiente bloque @code{\midi}, la letra y
150 la música dejarán de estar sincronizadas dentro del MIDI.
154 @file{ly/engraver-init.ly}.
155 @file{ly/performer-init.ly}.
157 @node Score. El contexto maestro
158 @unnumberedsubsubsec Score. El contexto maestro
159 @translationof Score - the master of all contexts
161 Este es el contexto de notación del nivel más alto. Ningún otro
162 contexto puede contener a un contexto Score. De forma predeterminada,
163 el contexto Score maneja la administración de las indicaciones de
164 compás y se asegura de que ciertos elementos como claves, compases y
165 armaduras están siempre alineados entre los distintos pentagramas.
167 Se crea implícitamente una instancia del contexto Score cuando se
168 procesa un bloque @code{\score @{@dots{}@}}.
171 @node Contextos del nivel superior. Contenedores de pentagramas
172 @unnumberedsubsubsec Contextos del nivel superior: contenedores de pentagramas
173 @translationof Top-level contexts - staff containers
175 @strong{@emph{StaffGroup}}
177 Agrupa pentagramas y añade un corchete en la parte izquierda, formando
178 un grupo. Las líneas divisorias de los pentagramas contenidos se
179 conectan verticalmente. @code{StaffGroup} sólo consiste en una
180 colección de pentagramas, con un corchete delante y líneas divisorias
183 @strong{@emph{ChoirStaff}}
185 Idéntico a @code{StaffGroup} excepto que las barras de compás de los
186 pentagramas contenidos no se conectan verticalmente.
188 @strong{@emph{GrandStaff}}
190 Un grupo de pentagramas, con una llave en la parte izquierda que
191 abarca el grupo. Las barras de compás de los pentagramas contenidos
192 se conectan verticalmente.
194 @strong{@emph{PianoStaff}}
196 Igual que @code{GrandStaff}, pero contempla la posibilidad de poner el
197 nombre del instrumento a la izquierda del sistema.
200 @node Contextos de nivel intermedio. Pentagramas
201 @unnumberedsubsubsec Contextos de nivel intermedio. Pentagramas
202 @translationof Intermediate-level contexts - staves
204 @strong{@emph{Staff}}
206 Maneja claves, barras de compás, tonalidades y alteraciones
207 accidentales. Puede contener contextos de @code{Voice}.
209 @strong{@emph{RhythmicStaff}}
211 Como @code{Staff}, pero para imprimir ritmos. Al imprimir
212 se ignoran las alturas de las notas; las notas se imprimen
213 sobre una línea. La salida de MIDI conserva las alturas
216 @strong{@emph{TabStaff}}
218 Contexto para generar tablaturas. De forma predeterminada dispone la
219 expresión musical como una tablatura de guitarra, impresa sobre seis
222 @strong{@emph{DrumStaff}}
224 Maneja el tipografiado para instrumentos de percusión. Puede contener
225 contextos @code{DrumVoice}.
227 @strong{@emph{VaticanaStaff}}
229 Igual que @code{Staff}, excepto que está pensado para tipografiar
230 piezas en estilo gregoriano.
232 @strong{@emph{MensuralStaff}}
234 Igual que @code{Staff}, excepto que está diseñado para tipografiar
235 piezas en estilo mensural.
238 @node Contextos del nivel más bajo. Voces
239 @unnumberedsubsubsec Contextos del nivel más bajo. Voces
240 @translationof Bottom-level contexts - voices
242 Los contextos del mismo nivel que Voice dan un valor inicial a
243 ciertas propiedades e inician los grabadores correspondientes. Un
244 contexto del nivel más bajo es aquel que no tiene un contexto
245 descendiente predeterminado @code{defaultchild}. Aunque es
246 posible hacer que pueda aceptar o contener subcontextos, éstos
247 solo se pueden crear e introducir de forma explícita.
249 @strong{@emph{Voice}}
251 Corresponde a una voz sobre un pentagrama. este contexto maneja la
252 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
253 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
254 que crear instancias explícitas de este contexto si necesitamos varias
255 voces en el mismo pentagrama.
257 @strong{@emph{VaticanaVoice}}
259 Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
260 piezas en estilo gregoriano.
262 @strong{@emph{MensuralVoice}}
264 Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
265 piezas en estilo mensural.
267 @strong{@emph{Lyrics}}
269 Corresponde a una voz con letra. Maneja la impresión de una sola
272 @strong{@emph{DrumVoice}}
274 El contexto de voz utilizado en una pauta de percusión.
276 @strong{@emph{FiguredBass}}
278 El contexto en que los objetos @code{BassFigure} se crean a partir de
279 la entrada escrita en el modo @code{\figuremode}.
281 @strong{@emph{TabVoice}}
283 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
284 Se suele dejar que se cree implícitamente.
286 @strong{@emph{CueVoice}}
288 El contexto de voz que se utiliza para dibujar notas de tamaño
289 reducido, con el principal objetivo de añadir notas guía de un
290 pentagrama a otro, véase @ref{Formateo de las notas guía}.
291 Normalmente se deja que se cree implícitamente.
293 @strong{@emph{ChordNames}}
295 Tipografía nombres de acordes.
298 @node Crear y referenciar contextos
299 @subsection Crear y referenciar contextos
300 @translationof Creating and referencing contexts
304 @cindex nuevos contextos
305 @cindex contextos, creación y referenciación de
306 @cindex referenciar contextos
308 LilyPond crea automáticamente contextos de nifel inferior si se
309 encuentra una expresión musical antes de que exista un contexto
310 adecuado, pero normalmente esto sólo funciona bien para partituras
311 sencillas o fragmentos musicales como los que aparecen en la
312 documentación. Para partituras más complejas, se recomienda
313 especificar explícitamente todos los contextos con las
314 instrucciones @code{\new} o @code{\context}. La sintaxis de estas
315 dos instrucciones es muy similar:
318 [\new | \context] @var{Contexto} [ = @var{nombre}] [@var{expresión_musical}]
322 donde se puede especificar @code{\new} o @code{\context}.
323 @var{Contexto} es el tipo de contexto que se desea crear,
324 @var{nombre} es un nombre opcional que se da al contexto concreto
325 que se está creando, y @var{expresión_musical} es una sola
326 expresión musical que será interpretada por los complementos
327 grabadores y reproductores dentro de este contexto.
329 El prefijo @code{\new} sin ningún nombre se usa con frecuencia
330 para crear partituras con muchos pentagramas:
332 @lilypond[quote,verbatim,relative=2]
335 % leave the Voice context to be created implicitly
345 y para introducir varias voces dentro de un solo pentagrama:
347 @lilypond[quote,verbatim,relative=2]
363 @code{\new} debería usarse siempre para especificar contextos sin
366 La diferencia entre @code{\new} y @code{\context} se encuentra en
367 la acción que se realiza:
371 @code{\new} con un nombre o sin él, siempre crea un contexto nuevo
372 y distinto, incluso si ya existe un contexto con el mismo nombre:
374 @lilypond[quote,verbatim,relative=2]
390 @code{\context} con un nombre especificado, crea un contexto nuevo
391 solamente si no existe ya un contexto del mismo tipo y con el
392 mismo nombre, dentro de la misma jerarquía de contextos. En caso
393 contrario, se toma como referencia a dicho contexto creado
394 previamente, y su expresión musical se pasa a este contexto para
397 Una aplicación de los contextos con nombre es la separación entre
398 la disposición de la partitura y el contenido musical. Son
399 válidas culaquiera de las dos formas siguientes:
401 @lilypond[quote,verbatim]
415 \context Voice = "one" {
420 \context Voice = "two" {
429 @lilypond[quote,verbatim]
434 \context Voice = "one" {
437 \context Voice = "two" {
443 \context Voice = "one" {
448 \context Voice = "two" {
458 De manera alternativa, se pueden utilizar variables con un efecto
459 similar. Véase @rlearning{Organizar las piezas mediante variables}.
462 @code{\context} sin ningún nombre corresponderá con el primer
463 contexto que se encuentre entre los creados previamente que sean
464 del mismo tipo dentro de la misma jerarquía de contextos, incluso
465 si tiene nombre, y su expresión musical se pasará a dicho contexto
466 para su interpretación. Esta forma rara vez es útil. Sin
467 embargo, @code{\context} sin nombre y sin expresión musical se usa
468 para establecer el contexto en que se ejecuta un procedimiento de
469 Scheme especificado con @code{\applyContext}:
472 \new Staff \relative c' @{
475 \applyContext #(lambda (ctx)
477 (display (ly:context-current-moment ctx)))
484 Un contexto debe tener un nombre si se va a hacer referencia a él
485 más tarde, por ejemplo cuando se asocia la letra con la música:
488 \new Voice = "tenor" @var{música}
490 \new Lyrics \lyricsto "tenor" @var{letra}
494 Para ver más detalles sobre la asociación de letra y música,
495 consulte @ref{Duración automática de las sílabas}.
497 Las propiedades de todos los contextos de un tipo en particular se
498 pueden modificar dentro de un bloque @code{\layout} (con una
499 sintaxis diferente), véase @ref{Cambiar todos los contextos del mismo tipo}.
501 Esta construcción también ofrece una forma de mantener las
502 instrucciones de disposición separadas del contenido musical. Si
503 se va a modificar un solo contexto, debe usarse un bloque
504 @code{\with}, véase @ref{Cambiar solamente un contexto determinado}.
507 Manual de aprendizaje:
508 @rlearning{Organizar las piezas mediante variables}.
510 Referencia de la notación:
511 @ref{Cambiar solamente un contexto determinado},
512 @ref{Duración automática de las sílabas}.
515 @node Mantener vivos los contextos
516 @subsection Mantener vivos los contextos
517 @translationof Keeping contexts alive
519 @cindex contextos, mantener vivos
520 @cindex contextos, tiempo de vida
522 Normalmente los contextos finalizan en el primer momento musical en
523 que no tienen nada que hacer. Así, los contextos de @code{Voice}
524 mueren tan pronto como ya no contienen ningún evento; los contextos de
525 @code{Staff} mueren tan pronto como todos los contextos de
526 @code{Voice} que contenían ya no contengan ningún evento; etc. Esto
527 puede ocasionar dificultades si se tiene que hacer referencia a
528 contextos anteriores que ya han muerto, por ejemplo, al cambiar de
529 pentagramas con instrucciones @code{\change}, asociar letra con una
530 voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
531 eventos musicales adicionales a un contexto anterior.
533 Existe una excepción a esta regla general: precisamente uno de los
534 contextos de @code{Voice} que están dentro de un contexto de
535 @code{Staff} o de una construcción @code{<<@dots{}>>} persiste siempre
536 hasta el final de, contexto de @code{Staff} circundante o la
537 construcción @code{<<@dots{}>>}, incluso aunque puede haber períodos en
538 que no tiene nada que hacer. El contexto que persiste de esta forma
539 será el primero que se encuentre en la primera construcción encerrada
540 entre llaves @code{@{@dots{}@}}, ignorando cualquiera que se encuentre
541 dentro de construcciones encerradas por ángulos dobles @code{<<@dots{}>>}.
543 Cualquier contexto se puede mantener vivo si nos aseguramos de que
544 tiene algo que hacer en cualquier momento musical dado. Los
545 contextos de @code{Staff} se mantienen con vida si nos aseguramos de
546 que una de sus voces se mantiene viva. Una manera de hacerlo es
547 añadir silencios de separación a una voz en paralelo con la música
548 real. Éstos deben añadirse a todos y cada uno de los contextos de
549 @code{Voice} que se hayan de mantener vivos. Si se van a usar
550 esporádicamente varias voces, es más seguro mantenerlas todas vivas en
551 lugar de tratar de confiar en las excepciones que hemos mencionado
554 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
555 vivas de esta manera durante la duración de la pieza:
557 @lilypond[quote,verbatim]
558 musicA = \relative c'' { d4 d d d }
559 musicB = \relative c'' { g4 g g g }
562 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
563 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
568 \context Voice = "A" {
572 \context Voice = "B" {
576 \context Voice = "A" { \musicA }
577 \context Voice = "B" { \musicB }
578 \context Voice = "A" { \musicA }
589 @cindex letra, alineación con melodía esporádica
591 El ejemplo siguiente muestra cómo se puede escribir una línea melódica
592 esporádica con letra utilizando este enfoque. Por supuesto, en una
593 situación real la melodía y el acompañamiento consistirían en varias
594 secciones diferentes.
596 @lilypond[quote,verbatim]
597 melody = \relative c'' { a4 a a a }
598 accompaniment = \relative c' { d4 d d d }
599 words = \lyricmode { These words fol -- low the mel -- o -- dy }
602 \new Staff = "music" {
604 \new Voice = "melody" {
606 s1*4 % Keep Voice "melody" alive for 4 bars
609 \new Voice = "accompaniment" {
614 \context Voice = "melody" { \melody }
615 \context Voice = "accompaniment" { \accompaniment }
617 \context Voice = "accompaniment" { \accompaniment }
619 \context Voice = "melody" { \melody }
620 \context Voice = "accompaniment" { \accompaniment }
625 \new Lyrics \with { alignAboveContext = #"music" }
626 \lyricsto "melody" { \words }
631 Una forma alternativa, que podría resultar mejor en muchas
632 situaciones, es mantener con vida la línea melódica simplemente
633 incluyendo notas espaciadoras para alinearla correctamente con el
636 @lilypond[quote,verbatim]
637 melody = \relative c'' {
643 accompaniment = \relative c' {
649 words = \lyricmode { These words fol -- low the mel -- o -- dy }
653 \new Staff = "music" {
655 \new Voice = "melody" {
659 \new Voice = "accompaniment" {
665 \new Lyrics \with { alignAboveContext = #"music" }
666 \lyricsto "melody" { \words }
672 @node Modificar los complementos (plug-ins) de contexto
673 @subsection Modificar los complementos (plug-ins) de contexto
674 @translationof Modifying context plug-ins
676 @c TODO Should this be Modifying engravers or Modifying contexts?
678 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
679 almacenan propiedades, también contienen «plug-ins» o complementos
680 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
681 el contexto @code{Voice} contiene un grabador
682 @code{Note_heads_engraver} que crea las cabezas de nota y el contexto
683 @code{Staff} contiene un grabador @code{Key_engraver} que
686 Para ver una descripción completa de todos y cada uno de los
687 complementos, consulte
689 @rinternals{Engravers and Performers}.
692 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
694 Cada contexto que se describe en
696 @rinternals{Contexts}
699 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
701 relaciona los grabadores que se usan para ese contexto.
704 Puede ser de utilidad jugar un poco con estos complementos. Se hace
705 iniciando un contexto nuevo con @code{\new} o @code{\context} y
711 \new @var{contexto} \with @{
719 @emph{@dots{}música@dots{}}
724 donde los @dots{} deben ser el nombre de un grabador. Aquí tenemos un
725 ejemplo sencillo que suprime los grabadores
726 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
729 @lilypond[quote,relative=1,verbatim]
735 \remove "Time_signature_engraver"
736 \remove "Clef_engraver"
743 En el segundo pentagrama no hay indicación de compás ni clave. Éste
744 es un método bastante rudimentario de hacer que desaparezcan los
745 objetos porque afecta a todo el pentagrama. Este método también
746 afecta al espaciado, lo que puede ser deseable o no serlo. Se
747 muestran métodos más sofisticados para quitar objetos en
748 @rlearning{Visibilidad y color de los objetos}.
750 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
751 líneas divisorias y las indicaciones de compás están sincronizadas a
752 lo largo de toda la partitura. Lo hacen los grabadores
753 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
754 complementos mantienen al día la administración de las indicaciones de
755 compás, posición dentro del compás, etc. Moviendo estos grabadores
756 desde el contexto de @code{Score} al de @code{Staff}, podemos
757 conseguir una partitura en la que cada pentagrama tiene su propio
758 compás independiente.
760 @cindex polimétricas, partituras
761 @cindex compases distintos al mismo tiempo
763 @lilypond[quote,verbatim]
767 \consists "Timing_translator"
768 \consists "Default_bar_line_engraver"
775 \consists "Timing_translator"
776 \consists "Default_bar_line_engraver"
786 \remove "Timing_translator"
787 \remove "Default_bar_line_engraver"
795 El orden en que los grabadores se especifican es el orden en que se
796 llaman para realizar su tarea de procesamiento. Normalmente, el orden
797 en que se especifican los grabadores no tiene importancia, pero en
798 algunos casos especiales sí la tiene, por ejemplo donde un grabador
799 escribe una propiedad y otro la lee, o donde un grabador crea un groby
800 otro debe procesarlo.
802 Las siguientes ordenaciones son importantes:
806 el grabador de compases @code{Bar_engraver} debe ir normalmente en
810 el grabador de digitaciones @code{New_fingering_engraver} debe ir
811 antes del grabador @code{Script_column_engraver} de columnas de
815 el @code{Timing_translator} debe ir antes del grabador de números de
816 compás @code{Bar_number_engraver}.
822 @file{ly/engraver-init.ly}.
825 @node Cambiar los valores por omisión de los contextos
826 @subsection Cambiar los valores por omisión de los contextos
827 @translationof Changing context default settings
829 @cindex predeterminadas, cambio de propiedades de contexto
830 @cindex contexto, cambiar propiedades predeterminadas de
832 Se pueden cambiar las propiedades de contexto y de grob con las
833 instrucciones @code{\set} y @code{\override}, tal y como se describe
834 en @ref{Modificar las propiedades}. Estas instrucciones crean eventos
835 musicales, haciendo que los cambios tengan efecto en el punto temporal
836 en que la música se está procesando.
838 Por contra, esta sección explica la forma de cambiarlos valores
839 @emph{predeterminados} de las propiedades de contexto y de grob en el
840 momento en que se crea el contexto. Existen dos formas de hacerlo.
841 Una modifica los valores predeterminados en todos los contextos de un
842 tipo dado, y el otro modifica los valores predeterminados solamente en
843 una instancia concreta de un contexto.
846 * Cambiar todos los contextos del mismo tipo::
847 * Cambiar solamente un contexto determinado::
848 * Orden de precedencia::
851 @node Cambiar todos los contextos del mismo tipo
852 @unnumberedsubsubsec Cambiar todos los contextos del mismo tipo
853 @translationof Changing all contexts of the same type
855 @cindex \context dentro de un bloque \layout
859 Los ajustes de contexto predeterminados que se han de usar para la composición
860 tipográfica dentro de @code{Score}, @code{Staff}, @code{Voice} y otros contextos
861 se pueden especificar en un bloque @code{\context} dentro de cualquier
862 bloque @code{\layout}.
864 Los ajustes para la salida MIDI, al contrario que para la
865 composición tipográfica, se tendrán que especificar aparte en
866 bloques @code{\midi} (véase
867 @ref{Definiciones de salida - estructura de los contextos}).
869 El bloque @code{\layout} se debe colocar
870 dentro del bloque @code{\score} al que se aplica, después de la
877 [ajustes de contexto para todos los contextos Voice]
881 [ajustes de contexto para todos los contextos Staff]
886 Se pueden especificar los siguientes tipos de ajustes:
890 Una instrucción @code{\override}, pero omitiendo el nombre del contexto
892 @lilypond[quote,verbatim]
895 a4^"Thicker stems" a a a
901 \override Stem.thickness = #4.0
908 Estableciendo una propiedad de contexto directamente
910 @lilypond[quote,verbatim]
913 a4^"Smaller font" a a a
926 Una instrucción predefinida tal como @code{\dynamicUp} o una expresión
927 musical como @code{\accidentalStyle dodecaphonic}
929 @lilypond[quote,verbatim]
932 a4^"Dynamics above" a a a
942 \accidentalStyle dodecaphonic
949 Una variable definida por el usuario que contenga un bloque
950 @code{\with}; para ver detalles acerca del bloque @code{\with},
951 consulte @ref{Cambiar solamente un contexto determinado}.
953 @lilypond[quote,verbatim]
954 StaffDefaults = \with {
961 a4^"Smaller font" a a a
976 Las instrucciones de ajuste de propiedades se pueden disponer dentro
977 de un bloque @code{\layout} sin que estén encerradas en un bloque
978 @code{\context}. Tales ajustes son equivalentes a incluir las mismas
979 instrucciones de ajuste de propiedades al comienzo de cada uno de los
980 contextos del tipo especificado. Si no se especifica ningún contexto,
981 @emph{todos y cada uno} de los contextos del nivel inferior quedan
982 afectados, véase @ref{Contextos del nivel más bajo. Voces}. La
983 sintaxis de una instrucción de ajuste de propiedades dentro de un
984 bloque @code{\layout} es la misma que si la misma instrucción
985 estuviera escrita en el propio flujo musical.
987 @lilypond[quote,verbatim]
991 a4^"Smaller font" a a a
996 \accidentalStyle dodecaphonic
998 \override Voice.Stem.thickness = #4.0
1004 @node Cambiar solamente un contexto determinado
1005 @unnumberedsubsubsec Cambiar solamente un contexto determinado
1006 @translationof Changing just one specific context
1011 Las propiedades de contexto de una única instancia de contexto pueden
1012 cambiarse dentro de un bloque @code{\with}. Todas las demás
1013 instancias de contexto del mismo tipo retienen los ajustes
1014 predeterminados que LilyPond tiene programados y que se modifican por
1015 parte de cualquier bloque @code{\layout} que se encuentre dentro del
1016 ámbito. El bloque @code{\with} se debe situar inmediatamente después
1017 de las instrucciones @code{\new} @var{context-type}:
1020 \new Staff \with @{ [ajustes de contexto para esta instancia de contexto solamente] @}
1026 Dado que dicha @q{modificación de contexto} está especificada
1027 dentro de la música, afectará a @emph{todas} las salidas
1028 (tipografía @emph{y también} el MIDI), a diferencia de los cambios
1029 que se hacen dentro de una definición de salida.
1031 Se pueden especificar los siguientes tipos de ajustes:
1035 Una instrucción @code{\override}, pero omitiendo el nombre del
1038 @lilypond[quote,verbatim]
1041 \new Voice \with { \override Stem.thickness = #4.0 }
1044 a4^"Thick stems" a a a
1053 Estableciendo una propiedad de contexto directamente
1055 @lilypond[quote,verbatim]
1060 a4^"Default font" a a a
1064 \new Staff \with { fontSize = #-4 }
1067 a4^"Smaller font" a a a
1076 Una instrucción predefinida tal como @code{\dynamicUp}
1078 @lilypond[quote,verbatim]
1084 a4^"Dynamics below" a a a
1089 \new Staff \with { \accidentalStyle dodecaphonic }
1091 \new Voice \with { \dynamicUp }
1094 a4^"Dynamics above" a a a
1105 @node Orden de precedencia
1106 @unnumberedsubsubsec Orden de precedencia
1107 @translationof Order of precedence
1109 El valor de una propiedad que se aplica en un momento determinado se
1110 determina de la siguiente forma:
1114 si está en efecto una instrucción @code{\override} o @code{\set}
1115 dentro del flujo musical, se usa dicho valor,
1118 de lo contrario, se usa el valor predeterminado tomado de un enunciado
1119 @code{\with} en las instrucciones de inicio del contexto,
1122 de lo contrario, se usa el valor tomado del bloque @code{\context} más
1123 reciente que corresponda dentro de los bloques @code{\layout} o @code{\midi},
1126 de lo contrario se usa el valor predeterminado que LilyPond lleva
1131 Manual de aprendizaje:
1132 @rlearning{Modificar las propiedades de los contextos}.
1134 Referencia de la notación:
1135 @ref{Explicación de los contextos},
1136 @ref{Contextos del nivel más bajo. Voces},
1137 @ref{La instrucción set},
1138 @ref{La instrucción override},
1139 @ref{El bloque layout,,El bloque @code{@bs{}layout}}.
1142 @node Definir contextos nuevos
1143 @subsection Definir contextos nuevos
1144 @translationof Defining new contexts
1146 @cindex contextos, definición de nuevos
1147 @cindex grabadores, incluir en contextos
1162 Los contextos específicos, como @code{Staff} y @code{Voice}, están
1163 construidos a partir de bloques sencillos. Es posible crear nuevos
1164 tipos de contextos con combinaciones distintas de añadidos grabadores.
1166 El siguiente ejemplo muestra cómo construir un tipo diferente de
1167 contexto de @code{Voice} partiendo de cero. Será parecido a
1168 @code{Voice}, pero imprime solamente cabezas centradas en forma de
1169 barra inclinada. Se puede usar para indicar improvisación en piezas
1172 @lilypond[quote,ragged-right]
1173 \layout { \context {
1175 \type "Engraver_group"
1176 \consists "Note_heads_engraver"
1177 \consists "Rhythmic_column_engraver"
1178 \consists "Text_engraver"
1179 \consists "Pitch_squash_engraver"
1180 squashedPosition = #0
1181 \override NoteHead.style = #'slash
1186 \accepts "ImproVoice"
1190 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
1191 c4 c^"undress" c_"while playing :)" c }
1197 Estos ajustes se definen dentro de un bloque @code{\context} que a su
1198 vez está dentro de un bloque @code{\layout},
1208 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
1209 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
1211 En primer lugar es necesario definir un nombre para el nuevo contexto:
1217 Debido a que es parecido al contexto @code{Voice}, queremos
1218 órdenes que funcionen dentro de los contextos @code{Voice}
1219 (existentes) para que siga funcionando. Esto se consigue dando al
1220 contexto nuevo un alias de @code{Voice},
1226 El contexto imprimirá notas y textos explicativos, por ello
1227 tenemos que añadir los grabadores que aportan esta funcionalidad,
1228 y además el grabador que agrupa las notas, plicas y silencios que
1229 están en el mismo momento musical en forma de columnas,
1232 \consists "Note_heads_engraver"
1233 \consists "Text_engraver"
1234 \consists "Rhythmic_column_engraver"
1237 Las cabezas de todas las notas se deben situar sobre la línea
1241 \consists "Pitch_squash_engraver"
1242 squashedPosition = #0
1245 El grabador @code{Pitch_squash_engraver} modifica las cabezas de
1246 nota (creadas por el grabador @code{Note_heads_engraver}) y
1247 establece sus posiciones verticales al valor de
1248 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea
1251 Las notas parecen barras inclinadas y no tienen plica:
1254 \override NoteHead.style = #'slash
1258 Todos estos complementos o plug-ins tienen que comunicarse bajo el
1259 control del contexto. Los mecanismos con el que se comunican los
1260 contextos se establecen mediante la declaración del @code{\type}
1261 (tipo) del contexto. Dentro de un bloque @code{\layout}, casi
1262 todos los contextos serán del tipo @code{Engraver_group}. Algunos
1263 contextos especiales y los contextos de los bloques @code{\midi}
1264 usan otros tipos. La copia y la modificación de una definición de
1265 contexto existente también cumplimentan el tipo. Como este
1266 ejemplo crea una definición partiendo de cero, tiene que ser
1267 especificada explícitamente.
1270 \type "Engraver_group"
1273 Al juntarlo todo, obtenemos
1278 \type "Engraver_group"
1279 \consists "Note_heads_engraver"
1280 \consists "Text_engraver"
1281 \consists "Rhythmic_column_engraver"
1282 \consists "Pitch_squash_engraver"
1283 squashedPosition = #0
1284 \override NoteHead.style = #'slash
1291 Los contextos dan lugar a jerarquías. Queremos poner el contexto
1292 @code{ImproVoice} dentro del contexto @code{Staff}, igual que los contextos
1293 de voz normales. Por tanto, modificamos la definición de
1294 @code{Staff} con la instrucción @code{\accepts} (acepta),
1304 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
1305 que a veces se necesita cuando se están reutilizando definiciones de
1306 contexto existentes.
1308 Ponemos ambos dentro de un bloque @code{\layout}, como
1318 \accepts "ImproVoice"
1323 Así pues, la salida que aparece al comienzo de esta sub-sección se
1332 c c_"mientras tocas :)"
1338 Para completar el ejemplo, los cambios que afectan a la jerarquía
1339 de contextos se deben repetir dentro de un bloque @code{\midi} de
1340 manera que la salida MIDI dependa de las mismas relaciones de
1345 Referencia de funcionamiento interno:
1346 @rinternals{Engraver_group},
1347 @rinternals{Note_heads_engraver},
1348 @rinternals{Text_engraver},
1349 @rinternals{Rhythmic_column_engraver},
1350 @rinternals{Pitch_squash_engraver}.
1353 @node Orden de disposición de los contextos
1354 @subsection Orden de disposición de los contextos
1355 @translationof Context layout order
1357 @cindex contextos, orden de disposición
1361 Los contextos se disponen en un sistema normalmente desde arriba hacia
1362 abajo en el orden en que se encuentran en el archivo de entrada.
1363 Cuando los contextos se anidan unos dentro de otros, el contexto
1364 exterior incluye a los contextos anidados tal y como se especifica en
1365 el archivo de entrada, siempre y cuando los contextos interiores estén
1366 incluidos en la lista @qq{accepts} del contexto externo. Los
1367 contextos anidados que no está nincluidos en la lista @qq{accepts} del
1368 contexto externo se recolocan debajo del contexto externo en lugar de
1369 anidarse dentro de él.
1371 La lista @qq{accepts} de un contexto se puede cambiar con las
1372 instrucciones @code{\accepts} (acepta) o @code{\denies} (niega).
1373 @code{\accepts} añade un contexto a la lista @qq{accepts} y
1374 @code{\denies} elimina un contexto de la lista.
1376 Por ejemplo, un grupo de pentagramas con un corchete cuadrado no
1377 se encuentra normalmente en el interior de un pentagrama con llave
1378 curva que tenga conectadas las líneas divisorias, y un
1379 @code{GrandStaff} para piano no acepta un @code{StaffGroup} dentro
1380 de él, de forma predeterminada.
1382 @lilypond[verbatim,quote]
1389 \new Staff { \set Staff.instrumentName = bottom f'1 }
1394 Sin embargo, usando la instrucción @code{\accepts}, se puede
1395 añadir un @code{StaffGroup} al contexto @code{GrandStaff}:
1397 @lilypond[verbatim,quote]
1404 \new Staff { \set Staff.instrumentName = bottom f'1 }
1409 \accepts "StaffGroup"
1415 @code{\denies} se usa principalmente cuando un contexto nuevo se está
1416 basando en otro, pero los anidamientos requeridos difieren. Por
1417 ejemplo, el contexto @code{VaticanaStaff} está basado en el contexto
1418 @code{Staff}, pero con el contexto @code{VaticanaVoice} sustituido por
1419 el contexto @code{Voice} en la lista @qq{accepts}.
1422 @cindex contextos implícitos
1423 @cindex implícitos, contextos
1424 @funindex \defaultchild
1426 Observe que discretamente se crea un contexto de forma implícita
1427 si se encuentra una instrucción donde no hay un contexto apropiado
1430 Dentro de una definición de contexto, el tipo de un subcontexto
1431 que se va a crear implícitamente se especifica usando
1432 @code{\defaultchild} (hijo predeterminado). Algunos eventos
1433 musicales requieren un contexto @samp{Bottom} (inferior): cuando
1434 se encuentra este evento, se crean subcontextos de forma recursiva
1435 hasta que se alcanza un contexto que no tiene establecido el
1436 @samp{defaultchild}.
1438 La creación implícita de contextos puede dar lugar a pentagramas o
1439 partituras nuevos no esperados. La utilización de @code{\new}
1440 para crear contextos explícitamente evita esos problemas.
1442 @cindex alignAboveContext
1443 @cindex alignBelowContext
1444 @funindex alignAboveContext
1445 @funindex alignBelowContext
1447 En ocasiones se necesita que un contexto exista durante un breve
1448 intervalo de tiempo, siendo un buen ejemplo el contexto de
1449 pentagrama de un ossia. Esto se consigue normalmente mediante la
1450 introducción de la definición del contexto en el lugar apropiado
1451 en paralelo con la sección correspondiente de la música principal.
1452 De forma predeterminada, el contexto tempral se coloca debajo de
1453 todos los contextos existentes. Para reposicionarlo por encima
1454 del contexto que tenga el nombre @qq{principal}, debería definirse
1458 @code{\new Staff \with @{ alignAboveContext = #"principal" @} }
1461 Se presenta una situación similar cuando se posiciona un contexto
1462 temporal de letra de una canción dentro de una disposición de varios
1463 pentagramas tal como @code{ChoirStaff}, por ejemplo, cuando se añade
1464 una segunda estrofa a una sección que se repite. De forma
1465 predeterminada, el contexto temporal de letra se coloca debajo de los
1466 pentagramas inferiores. Mediante la definición del contexto temporal
1467 de letra con @code{alignBelowContext} se puede posicionar
1468 correctamente debajo del contexto de letra con nombre que contiene el
1469 texto de la primera estrofa.
1471 En diversos lugares pueden verse ejemplos que muestran esta
1472 recolocación de contextos temporales: véase
1473 @rlearning{Anidado de expresiones musicales},
1474 @ref{Modificación de pentagramas sueltos} y
1475 @ref{Técnicas específicas para la letra}.
1478 Manual de aprendizaje:
1479 @rlearning{Anidado de expresiones musicales}.
1481 Referencia de la notación:
1482 @ref{Modificación de pentagramas sueltos},
1483 @ref{Técnicas específicas para la letra}.
1485 Manual de utilización del programa:
1486 @rprogram{Aparece un pentagrama de más}.
1488 Archivos instalados:
1489 @file{ly/engraver-init.ly}.
1492 @node Explicación del Manual de referencia de funcionamiento interno
1493 @section Explicación del Manual de referencia de funcionamiento interno
1494 @translationof Explaining the Internals Reference
1497 * Navegar por la referencia del programa::
1498 * Interfaces de la presentación::
1499 * Determinar la propiedad del grob::
1500 * Convenciones de nombres::
1505 @node Navegar por la referencia del programa
1506 @subsection Navegar por la referencia del programa
1507 @translationof Navigating the program reference
1509 Supongamos que queremos mover la indicación de digitación del
1510 fragmento siguiente:
1512 @lilypond[quote,relative=2,verbatim]
1518 Si hace una visita a la documentación en busca de instrucciones de
1519 digitación (en @ref{Indicaciones de digitación}), encontrará:
1522 @strong{Véase también}
1524 Referencia de funcionamiento interno: @rinternals{Fingering}.
1529 La referencia del programador se encuentra disponible en forma de
1530 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
1531 en línea o bien descargando los archivos de la documentación HTML.
1532 Esta sección sería mucho más difícil de entender si está utilizando el
1533 manual en formato PDF.
1536 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
1540 Los objetos de digitación se crean por parte de:
1541 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1544 Siguiendo los enlaces relacionados dentro de la referencia del
1545 programa, podemos seguir el flujo de información dentro del programa:
1549 @item @rinternals{Fingering}:
1550 los objetos @rinternals{Fingering} se crean por parte de:
1551 @rinternals{Fingering_engraver}
1553 @item @rinternals{Fingering_engraver}:
1554 Tipos de música aceptados: @rinternals{fingering-event}
1556 @item @rinternals{fingering-event}:
1557 El tipo de evento musical @code{fingering-event} está descrito en
1558 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1561 Este camino se recorre en contra de la corriente de información del
1562 programa: comienza por la salida y acaba en el evento de entrada.
1563 También podríamos haber empezado por un evento de la entrada, y leído
1564 siguiendo el flujo de información terminando en su caso en el objeto
1565 (u objetos) de la salida.
1567 La referencia del programa también se puede examinar como un documento
1568 normal. Contiene capítulos que tratan de
1570 @rinternals{Music definitions},
1573 @code{Music definitions}
1575 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1576 de los capítulos relaciona todas las definiciones utilizadas y todas
1577 las propiedades que se pueden ajustar.
1580 @node Interfaces de la presentación
1581 @subsection Interfaces de la presentación
1582 @translationof Layout interfaces
1584 @cindex interfaz de la presentación
1585 @cindex presentación, interfaz de la
1588 La página HTML que pudimos ver en la sección anterior describe el
1589 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1590 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1591 números (como grosores y direcciones), pero también punteros a objetos
1592 relacionados. Un objeto de presentación también se llama un
1593 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1594 gráfico). Para ver más detalles acerca de los objetos gráficos o
1595 Grobs, consulte @rinternals{grob-interface}.
1597 La página dedicada a @code{Fingering} relaciona las definiciones del
1598 objeto @code{Fingering}. Por ejemplo, la página dice
1601 @code{padding} (dimensión, en espacios de pentagrama):
1607 lo que significa que el número se mantendrá a una distancia de al
1608 menos 0.5 de la cabeza de la nota.
1611 Cada objeto de presentación puede tener varias funciones como elemento
1612 notacional o tipográfico. Por ejemplo, el objeto de digitación
1613 Fingering tiene los siguientes aspectos
1617 Su tamaño es independiente del espaciado horizontal, al contrario de
1618 las ligaduras o las barras de las figuras.
1621 Es un elemento de texto. Casi seguro que es un texto muy corto.
1624 este elemento de texto se tipografía con un tipo de letra, no como las
1625 ligaduras o las barras de las figuras.
1628 Horizontalmente, el centro del símbolo se debe alinear con el centro
1629 de la cabeza de la nota.
1632 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1635 La posición vertical también está coordinada con otros símbolos de
1636 superíndice y de subíndice.
1639 Cada uno de estos aspectos se capta en lo que se llaman
1640 @emph{interface}s, que se relacionan al final de la página dedicada a
1641 @rinternals{Fingering}
1644 Este objeto contempla los siguientes interfaces:
1645 @rinternals{item-interface},
1646 @rinternals{self-alignment-interface},
1647 @rinternals{side-position-interface}, @rinternals{text-interface},
1648 @rinternals{text-script-interface}, @rinternals{font-interface},
1649 @rinternals{finger-interface} y @rinternals{grob-interface}.
1652 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1653 página del respectivo interfaz del objeto. Cada interfaz tiene un
1654 cierto número de propiedades. Algunas de ellas no son para que el
1655 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1658 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1659 realmente esto no significa mucho. El archivo de inicialización
1660 (véase @rlearning{Otras fuentes de información})
1661 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1666 (avoid-slur . around)
1667 (slur-padding . 0.2)
1668 (staff-padding . 0.5)
1669 (self-alignment-X . 0)
1670 (self-alignment-Y . 0)
1671 (script-priority . 100)
1672 (stencil . ,ly:text-interface::print)
1673 (direction . ,ly:script-interface::calc-direction)
1674 (font-encoding . fetaText)
1675 (font-size . -5) ; don't overlap when next to heads.
1676 (meta . ((class . Item)
1677 (interfaces . (finger-interface
1679 text-script-interface
1681 side-position-interface
1682 self-alignment-interface
1683 item-interface))))))
1687 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1688 de valores de variables, y la página web de la Referencia de
1689 funcionamiento interno se genera directamente a partir de esta
1693 @node Determinar la propiedad del grob
1694 @subsection Determinar la propiedad del grob
1695 @translationof Determining the grob property
1697 Recordemos que queríamos cambiar la posición del @b{2} en
1699 @lilypond[quote,relative=2,verbatim]
1705 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1706 tenemos que negociar con el interfaz asociado con esta colocación.
1707 Esto se hace usando @code{side-position-interface}. La página que
1708 describe este interface dice:
1711 @code{side-position-interface}
1713 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1714 soporte). La propiedad @code{direction} significa dónde poner el
1715 objeto víctima con relación al soporte (¿a la izquierda o a la
1716 derecha, encima o debajo?)
1720 @cindex padding (relleno)
1722 Debajo de esta descripción, la variable @code{padding} (relleno) se
1728 (dimensión, en espacios de pentagrama)
1730 Añadir esta cantidad de espacio adicional entre objetos que están unos
1735 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1736 digitación de la cabeza de la nota. La siguiente orden inserta un
1737 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1740 \once \override Voice.Fingering.padding = #3
1743 Al insertar esta instrucción antes de que se haya creado el objeto
1744 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1747 @lilypond[quote,relative=2,verbatim]
1748 \once \override Voice.Fingering.padding = #3
1754 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1755 se puede deducir también a partir de la referencia del programa, ya
1756 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1759 El grabador Fingering_engraver es parte de los contextos: @dots{}
1764 @node Convenciones de nombres
1765 @subsection Convenciones de nombres
1766 @translationof Naming conventions
1768 Se hace necesario presentar una panorámica de las diversas
1769 convenciones de nomenclatura:
1772 @item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
1773 @item funciones de Scheme: ly:más-estilo-de-scheme
1774 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1775 @item interfaces de Grobs: estilo-scheme
1776 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1777 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1778 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1779 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1783 Preguntas aún sin respuesta
1785 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1786 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1791 @node Modificar las propiedades
1792 @section Modificar las propiedades
1793 @translationof Modifying properties
1796 * Panorámica de la modificación de las propiedades::
1797 * La instrucción set::
1798 * La instrucción override::
1799 * La instrucción tweak::
1800 * set frente a override::
1801 * Modificación de las listas-A::
1805 @node Panorámica de la modificación de las propiedades
1806 @subsection Panorámica de la modificación de las propiedades
1807 @translationof Overview of modifying properties
1809 Cada contexto es responsable de la creación de ciertos tipos de
1810 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1811 también se almacenan por contexto. Mediante la modificación de estos
1812 ajustes, se puede alterar la apariencia de los objetos.
1814 Existen dos tipos diferentes de propiedades almacenadas en los
1815 contextos: las propiedades de contexto y las propiedades de grob. Las
1816 propiedades de contexto son propiedades que se aplican al contexto
1817 como un todo y controlan la forma en que el propio contexto se
1818 imprime. Por contra, las propiedades de grob se aplican a los tipos
1819 de grob específicos que se imprimirán dentro del contexto.
1821 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar los
1822 valores de las propiedades de contexto. Las instrucciones
1823 @code{\override} y @code{\revert} se usan para cambiar los valores de
1824 las propiedades de grob.
1827 La sintaxis de esto es
1830 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1833 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1834 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1835 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1836 disposición}). Este último es un símbolo, y por ello debe ir
1837 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1838 explica cómo se deben cumplimentar los conceptos @var{nombre},
1839 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1840 funcionalidad des esta instrucción.
1845 \override Staff.Stem.thickness = #4.0
1849 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1850 grosor de una línea del pentagrama como unidad). Puesto que la
1851 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1852 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1853 Aquí vemos la instrucción en pleno funcionamiento:
1855 @lilypond[quote,verbatim,relative=2]
1857 \override Staff.Stem.thickness = #4.0
1863 La instrucción @code{\override} modifica la definición de la plica
1864 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1865 que la instrucción se ha interpretado, todas las plicas se engrosan.
1867 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1868 omitir, ocasionando que se utilice el contexto predeterminado
1869 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1870 solo paso de tiempo.
1872 @lilypond[quote,verbatim,relative=2]
1874 \once \override Stem.thickness = #4.0
1879 El @code{\override} se debe hacer antes de que el objeto se inicia.
1880 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1881 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1882 en el momento en que se crea el objeto. En este ejemplo:
1884 @lilypond[quote,verbatim,relative=2]
1885 \override Slur.thickness = #3.0
1887 \override Beam.beam-thickness = #0.6
1892 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1893 la instrucción para @code{Beam}, la barra, va después de que la barra
1894 se ha iniciado, y por ello no tiene ningún efecto.
1896 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1897 un contexto deshace una instrucción @code{\override}; como con
1898 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1899 del mismo contexto. En otras palabras, el @code{\revert} del
1900 siguiente ejemplo no hace nada.
1903 \override Voice.Stem.thickness = #4.0
1904 \revert Staff.Stem.thickness
1907 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1908 dentro de las propiedades normales. Para trucarlas, utilice
1909 instrucciones de la forma
1911 @c leave this as a long long
1913 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1920 \override Stem.details.beamed-lengths = #'(4 4 3)
1926 Referencia de funcionamiento interno:
1927 @rinternals{Backend},
1928 @rinternals{All layout objects},
1929 @rinternals{OverrideProperty},
1930 @rinternals{RevertProperty},
1931 @rinternals{PropertySet}.
1934 El «back-end» o motor de salida no es muy estricto en la comprobación
1935 de tipos de las propiedades de objetos. Las referencias cíclicas en
1936 valores Scheme de propiedades pueden producir cuelgues o salidas
1937 abruptas, o las dos cosas.
1940 @node La instrucción set
1941 @subsection La instrucción @code{@bs{}set}
1942 @translationof The set command
1946 @cindex cambiar propiedades
1948 Cada contexto puede tener distintas @emph{propiedades}, variables
1949 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1950 paso de interpretación. Se consigue insertando la instrucción
1951 @code{\set} dentro de la música:
1954 \set @var{contexto}.@var{propiedad} = #@var{valor}
1957 @var{valor} es un objeto de Scheme, razón por la que va precedido del
1958 carácter almohadilla,@tie{}@code{#}.
1960 El nombre de las propiedades de contexto suele ir en minúsculas con
1961 mayúscula en medio. Controlan sobre todo la traducción de la música a
1962 la notación, p.ej. @code{localAlterations} (para determinar si hay
1963 que impriir alteraciones o no), o @code{measurePosition} (para
1964 determinar cuándo hay que imprimir una línea divisoria). El valor de
1965 las propiedades de contexto puede modifcarse con el tiempo durante la
1966 interpretación de la música; un ejemplo obvio es
1967 @code{measurePosition}. Las propiedades de contexto se modifican
1968 mediante la instrucción @code{\set}.
1970 Por ejemplo, los silencios multicompás se combinan en un solo compás
1971 si el valor de la propiedad de contexto @code{skipBars} se establece a
1972 @code{#t} (verdadero):
1974 @lilypond[quote,verbatim,relative=2]
1976 \set Score.skipBars = ##t
1980 Si se omite el argumento @var{context}, entonces se utiliza el
1981 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1982 @code{Voice} o @code{Lyrics}). En este ejemplo:
1984 @lilypond[quote,verbatim,relative=2]
1985 \set Score.autoBeaming = ##f
1989 \set autoBeaming = ##t
1997 El cambio se aplica @q{al vuelo}, mientras dura la música, de forma
1998 que el ajuste sólo afecta al segundo grupo de corcheas.
2000 Observe que el contexto del nivel más bajo no siempre contiene la
2001 propiedad que querríamos modificar: por ejemplo, intentar ajustar el
2002 valor de la propiedad @code{skipBars} del contexto predeterminado del
2003 nivel más bajo, que en este caso es @code{Voice}, no tendrá ningún
2004 efecto, porque skipBars es una propiedad del contexto @code{Score}.
2006 @lilypond[quote,verbatim,relative=2]
2012 Los contextos son jerárquicos, y si se ha especificado un contexto
2013 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
2014 también a todos los contextos @code{Voice} dentro del pentagrama
2019 También existe una instrucción @code{\unset}:
2021 \unset @var{contexto}.@var{propiedad}
2025 que elimina la definición de @var{propiedad}. Esta instrucción
2026 elimina la definición solamente si está establecida dentro de
2027 @var{contexto}. Properties that have been set in enclosing contexts will
2028 not be altered by an unset in an enclosed context:
2030 @lilypond[quote,verbatim,relative=2]
2031 \set Score.autoBeaming = ##t
2036 \unset Score.autoBeaming
2044 Como @code{\set}, el argumento @var{contexto} no se tiene que
2045 especificar para un contexto del nivel más bajo, por lo que los dos
2049 \set Voice.autoBeaming = ##t
2050 \set autoBeaming = ##t
2054 son equivalentes si el contexto inferior en curso es @code{Voice}.
2058 Los ajustes que se aplican solamente a un único paso de tiempo se
2059 pueden escribir con @code{\once}, por ejemplo en
2061 @lilypond[quote,verbatim,relative=2]
2063 \once \set fontSize = #4.7
2068 En el manual de Referencia de funcionamiento interno hay una
2069 descripción completa de todas las propiedades de contexto disponibles,
2072 @rinternals{Tunable context properties}.
2075 Traducción @expansion{} Propiedades de contexto modificables por el
2080 Referencia de funcionamiento interno:
2081 @rinternals{Tunable context properties}.
2083 @node La instrucción override
2084 @subsection La instrucción @code{\override}
2085 @translationof The override command
2087 @cindex grob, propiedades de
2088 @cindex propiedades de grob
2091 Existe un tipo especial de propiedad de contexto: la descripción de
2092 los grobs. Las decscripciones de los grobs reciben un nombre en
2093 @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen los
2094 @q{ajustes predeterminados} para un tipo particular de grob, en forma
2095 de lista asociativa. Consulte @file{scm/define-grobs.scm} para
2096 ver los ajustes de cada descripción de grob. Las descripciones de
2097 grob se modifican con @code{\override}.
2099 La sintaxis de la instrucción @code{\override} es
2102 \override [@var{contexto}.]@var{NombreDelGrob}.@var{propiedad} = #@var{valor}
2105 Por ejemplo, podemos aumentar el grosor de la plica de una figura
2106 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
2107 @code{Stem} (plica):
2109 @lilypond[quote,verbatim,relative=2]
2111 \override Voice.Stem.thickness = #3.0
2115 Si no se ha especificado ningún contexto en la instrucción
2116 @code{\override}, se utiliza el contexto del nivel inferior:
2118 @lilypond[quote,verbatim,relative=2]
2119 { \override Staff.Stem.thickness = #3.0
2123 \override Stem.thickness = #0.5
2132 Algunas opciones susceptibles de trucaje, se llaman
2133 @q{subpropiedades} y residen dentro de las propiedades. Para
2134 efectura trujajes sobre ellas, utilice instrucciones de la forma
2137 \override Stem.details.beamed-lengths = #'(4 4 3)
2140 o para modificar los extremos de los objetos extensos, utilice una
2141 forma como las siguientes:
2144 \override TextSpanner.bound-details.left.text = #"left text"
2145 \override TextSpanner.bound-details.right.text = #"right text"
2149 @cindex reversión de sobreescrituras
2150 @cindex sobreescrituras, reversión de
2152 El efecto de una instrucción de sobreescritura @code{\override} se
2153 puede deshacer con @code{\revert}.
2155 La sintaxis de la instrucción @code{\revert} es
2158 \revert [@var{Contexto}.]@var{NombreDelGrob}.@var{propiedad}
2163 @lilypond[quote,verbatim,relative=2]
2165 \override Voice.Stem.thickness = #3.0
2167 \revert Voice.Stem.thickness
2171 Los efectos de @code{\override} y @code{\revert} se aplican a todos
2172 los grobs del contexto afectado partiendo del momento actual y hacia
2175 @lilypond[quote,verbatim,relative=2]
2180 \override Staff.Stem.thickness = #3.0
2184 \revert Staff.Stem.thickness
2192 @cindex sobreescritura para un solo momento
2194 Se puede usar @code{\once} con @code{\override} para afectar solamente
2195 al instante de tiempo actual:
2197 @lilypond[quote,verbatim,relative=2]
2201 \override Stem.thickness = #3.0
2205 \once \override Stem.thickness = #3.0
2214 Las instrucciones que modifican la salida tienen por lo general un
2218 \override Voice.Stem.thickness = #3.0
2222 Para construir este truco debemos determinar los siguientes datos:
2225 @item el contexto: aquí @code{Voice}.
2226 @item el objeto de presentación: aquí @code{Stem}.
2227 @item la propiedad de presentación: aquí @code{thickness}.
2228 @item un valor adecuado: aquí @code{3.0}.
2231 @cindex documentación interna
2232 @cindex buscar objetos gráficos
2233 @cindex gráficos, descripción de los objetos
2236 @cindex interna, documentación
2238 Para muchas propiedades, independientemente del tipo de datos de la
2239 propiedad, si se establece el valor de la propiedad a falso
2240 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
2241 ignore por completo dicha propiedad. Esto es especialmente útil para
2242 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
2243 causarían problemas.
2245 Mostraremos a continuación cómo localizar esta información en el
2246 manual de notación y en la referencia de funcionamiento interno.
2250 Referencia de funcionamiento interno:
2251 @rinternals{Backend}
2254 @node La instrucción tweak
2255 @subsection La instrucción @code{\tweak}
2256 @translationof The tweak command
2261 El cambio de las propiedades de grob mediante @code{\override} produce
2262 la aplicación del cambio a todos los grobs dados en el contexto en el
2263 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
2264 podemos desear que los cambios se apliquen a un solo grob en lugar de
2265 a todos los grobs del contexto afectado. Esto se consigue con la
2266 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
2269 \tweak [@var{objeto-de-presentación}.]@var{propiedad-del-grob} @var{valor}
2272 Es opcional especificar el @var{objeto-de-presentación}. La
2273 instrucción @code{\tweak} se aplica al objeto musical que viene
2274 inmediatamente después de @var{valor} dentro del flujo musical.
2277 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
2278 los objetos gráficos. Para objetos que resultan directamente de un
2279 elemento de código de la entrada, puede usar la función @code{\tweak},
2282 @lilypond[relative=2,verbatim,quote]
2287 \tweak duration-log #1
2296 El uso principal de la instrucción @code{\tweak} es modificar
2297 solamente uno de varios elementos de notación que dan comienzo en el
2298 mismo momento musical, como las notas de un acorde, o corchetes de
2299 tresillo que empiezan al mismo tiempo.
2301 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
2302 a continuación de forma directa, sin necesidad de especificar el
2303 nombre del grob o el contexto. Para que esto funcione, es necesario
2304 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
2305 al objeto al que se aplica, después de que el archivo de entrada se ha
2306 convertido en un flujo musical. Con frecuencia no es el caso, pues
2307 muchos elementos adicionales se insertan en la corriente musical de
2308 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
2309 parte de un acorde, LilyPond inserta implícitamente un evento
2310 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
2311 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
2312 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
2313 en el flujo musical, permaneciendo así adyacente a la nota, y con la
2314 posibilidad de modificarla.
2318 @lilypond[relative=2,verbatim,quote]
2319 <\tweak color #red c>4
2323 pero esto no funciona:
2325 @lilypond[relative=2,verbatim,quote]
2326 \tweak color #red c4
2331 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
2332 consulte @rlearning{Métodos de trucaje}.
2334 Si se colocan varios elementos similares en el mismo momento musical,
2335 la instrucción @code{\override} no se puede usar para modificar uno
2336 solo de ellos: aquí es donde se debe usar la instrucción
2337 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
2338 en el mismo momento musical están los siguientes:
2340 @c TODO expand to include any further uses of \tweak
2342 @item las cabezas de las notas de un acorde
2343 @item signos de articulación sobre la misma nota
2344 @item ligaduras de unión entre notas de un acorde
2345 @item corchetes de grupos especials que comienzan en el mismo momento
2348 @c TODO add examples of these
2350 @cindex acorde, modificación de una nota
2352 En este ejemplo se modifican el color de una cabeza y el tipo de otra,
2353 dentro del mismo acorde:
2355 @lilypond[relative=2,verbatim,quote]
2360 \tweak duration-log #1
2365 @code{\tweak} se puede usar para modificar ligaduras de expresión:
2367 @lilypond[verbatim,quote,relative=1]
2368 c-\tweak thickness #5 ( d e f)
2372 Para que funcione la instrucción @code{\tweak}, debe permanecer
2373 adyacente al objeto al que se ha de aplicar después de que el código
2374 de entrada se ha convertido a un flujo musical. El trucaje de un
2375 acorde completo no hace nada porque su evento musical actúa solamente
2376 como un contenedor, y todos los objetos de presentación se crean a
2377 partir de eventos dentro del @code{EventChord}:
2379 @lilypond[relative=2,verbatim,quote]
2380 \tweak color #red c4
2381 \tweak color #red <c e>4
2382 <\tweak color #red c e>4
2385 La instrucción @code{\tweak} sencilla no se puede usar para modificar
2386 ningún objeto que no se haya creado directamente a partir de la entrada.
2387 Concretamente, no afecta a las plicas, barras automáticas ni
2388 alteraciones, porque éstos se generan posteriormente por
2389 parte de objetos de presentación @code{NoteHead}
2390 más que por elementos musicales del
2393 Tales objetos de presentación creados indirectamente se pueden trucar
2394 usando la forma de la instrucción @code{\tweak} en que el nombre
2395 del grob se especifica de forma explícita:
2397 @lilypond[relative=2,verbatim,quote]
2398 \tweak Stem.color #red
2399 \tweak Beam.color #green c8 e
2400 <c e \tweak Accidental.font-size #-3 ges>4
2403 No se puede usar @code{\tweak} para modificar las claves o las
2404 indicaciones de compás, porque éstos se separan de cualquier
2405 instrucción @code{\tweak} precedente dentro del flujo de entrada
2406 merced a la inserción automática de elementos adicionales que se
2407 requieren para especificar el contexto.
2409 Se pueden colocar varias instrucciones @code{\tweak} antes de un
2410 elemento de notación; todos le afectan:
2412 @lilypond[verbatim,quote,relative=1]
2414 -\tweak style #'dashed-line
2415 -\tweak dash-fraction #0.2
2416 -\tweak thickness #3
2422 El flujo musical que se genera a partir de una sección de un archivo
2423 de entrada (incluido cualquier elemento insertado automáticamente)
2424 puede examinarse, véase @rextend{Presentación de las expresiones musicales}.
2425 Esto puede ser de utilidad en la determinación de lo que
2426 puede modificarse por medio de una instrucción @code{\tweak}.
2429 Manual de aprendizaje:
2430 @rlearning{Métodos de trucaje}.
2432 Manual de extensión:
2433 @rextend{Presentación de las expresiones musicales}.
2437 @cindex trucar puntos de control
2438 @cindex control, trucar puntos de
2440 No se puede usar la instrucción @code{\tweak} para modificar los
2441 puntos de control de una sola de varias ligaduras de unión dentro de
2442 un acorde, aparte de la primera que se encuentre en el código de
2446 @node set frente a override
2447 @subsection @code{\set} frente a @code{\override}
2448 @translationof set versus override
2450 @c TODO Should't a bunch of that be explained earlier?
2454 Tanto @code{\set} como @code{\override} manipulan propiedades
2455 asociadas a contextos. En ambos casos las propiedades tienen en
2456 cuenta la jerarquía de contextos: las propiedades no establecidas en
2457 el propio contexto presentan los valores del contexto padre
2460 El valor y la duración en el tiempo de las propiedades de contexto son
2461 dinámicos y están disponibles solamente cuando la música se está
2462 interpretando o @q{iterando}. En el momento de la creación del
2463 contexto, se inicializan las propiedades a partir de la definición de
2464 contexto correspondiente y las posibles modificaciones de contexto.
2465 Después de esto, cualquier cambio se obtiene a través de instrucciones
2466 de establecimiento de propiedades dentro de la propia música.
2468 Ahora bien, las definiciones de grob (objetos gráficos) son una clase
2469 especial de propiedades de contexto. Dado que su estructura,
2470 mantenimiento y utilización es distinta de las propiedades de contexto
2471 ordinarias, se accede a ellas con un conjunto de instrucciones
2472 diferente, y se estudian por separado dentro de la documentación.
2474 A diferencia de las propiedades de contexto normales, las definiciones
2475 de grob están subdivididas en propiedades de grob. Un @qq{grob}
2476 (objeto gráfico) se crea normalmente por parte de un grabador en el
2477 momento de la interpretación de una expresión musical y recibe sus
2478 propiedades iniciales de la definición de grob en curso del contexto
2479 del grabador. El grabador (u otras partes del @q{backend} de
2480 LilyPond) pueden después añadir o modificar propiedades del grob, pero
2481 ello no afecta a la definición de grob del contexto.
2483 Lo que conocemos como @q{propiedades de grob} en el contexto del
2484 trucaje a nivel de usuario son en realidad las propiedades de la
2485 definición de grob de un contexto. A diferencia de las propiedades de
2486 contexto normales, las definiciones de grob mantienen la contabilidad
2487 necesaria para seguir la pista de sus partes, las propiedades de grob
2488 individuales (e incluso subpropiedades de éstos), de forma separada,
2489 de forma que es posible definir dichas partes dentro de contextos
2490 diferentes y hacer que la definición de grob en su conjunto, en el
2491 momento de la creación del grob, se monte a partir de las piezas
2492 proporcionadas en diferentes contextos entre el contexto actual y sus
2495 Las definiciones de grob se manipulan usando @code{\override} y
2496 @code{\revert} y tienen un nombre que empieza con una letra mayúscula
2497 (como @samp{NoteHead}) mientras que las propiedades de contexto
2498 ordinarias se manipulan utilizando @code{\set} y @code{\unset} y se
2499 nombran empezando en letra minúscula.
2501 @cindex tweak, relación con @code{\override}
2503 @funindex \overrideProperty
2504 Las instrucciones especiales @code{\tweak} y @code{\overrideProperty}
2505 cambian las propiedades de grob pasando por encima de las propiedades
2506 de contexto completamente. En su lugar, atrapan a los grobs tan
2507 pronto se crean, y después establecen propiedades sobre ellos
2508 directamente cuando se originan a partir de un evento musical trucado
2509 o son de un tipo en particular, respectivamente.
2511 @node Modificación de las listas-A
2512 @subsection Modificación de las listas-A
2513 @translationof Modifying alists
2515 Ciertas propiedades configurables por parte del usuario se representan
2516 internamente como @emph{listas-A} (listas asociativas), que almacenan
2517 duplas de @emph{claves} y @emph{valores}. La estructura de una
2518 lista-A es la siguiente:
2521 '((@var{clave1} . @var{valor1})
2522 (@var{clave2} . @var{valor2})
2523 (@var{clave3} . @var{valor3})
2527 Si una lista-A es una propiedad de un grob o una variable de
2528 @code{\paper}, sus claves se pueden modificar individualmente sin que
2529 afecte a las otras claves.
2531 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2532 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2533 del grob @code{StaffGrouper}. La propiedad es una lista-A con cuatro
2534 claves: @code{basic-distance} (distancia básica),
2535 @code{minimum-distance} (distancia mínima), @code{padding} (relleno)
2536 y @code{stretchability} (ampliabilidad).
2537 Los ajustes estándar para esta propiedad
2538 se relacionan en la sección
2539 @qq{Backend} de la Referencia de Funcionamiento Interno
2540 (véase @rinternals{StaffGrouper}):
2543 '((basic-distance . 9)
2544 (minimum-distance . 7)
2546 (stretchability . 5))
2549 Una forma de acercar los pentagramas entre sí es reducir el valor de
2550 la clave @code{basic-distance} (@code{9}) para que se corresponda con
2551 el valor de @code{minimum-distance} (@code{7}). Para modificar una
2552 única clave de forma individual, utilice una @emph{declaración
2555 @lilypond[quote,verbatim]
2556 % default space between staves
2558 \new Staff { \clef treble c''1 }
2559 \new Staff { \clef bass c1 }
2562 % reduced space between staves
2563 \new PianoStaff \with {
2564 % this is the nested declaration
2565 \override StaffGrouper.staff-staff-spacing.basic-distance = #7
2567 \new Staff { \clef treble c''1 }
2568 \new Staff { \clef bass c1 }
2572 La utilización de una declaración anidada actualiza la clave
2573 especificada (como @code{basic-distance} en el ejemplo anterior)
2575 de las otras claves que ya se habían establecido para la misma
2578 Ahora, supongamos que deseamos que los pentagramas estén tan próximos
2579 como sea posible sin que se superpongan. La manera más sencilla de
2580 hacerlo es establecer las cuatro claves de la lista-A a cero. Sin
2581 embargo, no es necesario escribir cuatro declaraciones anidadas, una
2582 por cada clave. En lugar de eso, se puede redefinir completamente la
2583 propiedad con una sola declaración, como una lista-A:
2585 @lilypond[quote,verbatim]
2586 \new PianoStaff \with {
2587 \override StaffGrouper.staff-staff-spacing =
2588 #'((basic-distance . 0)
2589 (minimum-distance . 0)
2591 (stretchability . 0))
2593 \new Staff { \clef treble c''1 }
2594 \new Staff { \clef bass c1 }
2598 Observe que cualquier clave que no haya sido relacionada
2599 explícitamente en la definición de la lista-A, será reiniciada a sus
2600 valores @emph{predeterminados si no se han fijado}. En el caso de
2601 @code{staff-staff-spacing}, el valor de cualquier clave no fijada se
2602 reiniciaría a cero (excepto @code{stretchability}, que toma el valor
2603 de @code{basic-distance} si no se fija). Así, las dos declaraciones
2604 siguientes son equivalentes:
2607 \override StaffGrouper.staff-staff-spacing =
2608 #'((basic-distance . 7))
2610 \override StaffGrouper.staff-staff-spacing =
2611 #'((basic-distance . 7)
2612 (minimum-distance . 0)
2614 (stretchability . 7))
2617 Una consecuencia de esto (posiblemente no intencionada) es la
2618 eliminación de cualquier valor estándar que se establezca en un
2619 archivo de inicio y que se carga cada vez que se compila un archivo de
2620 entrada. En el ejemplo anterior, los ajustes estándar para
2621 @code{padding} y @code{minimum-distance} (definidos en
2622 @file{scm/define-grobs.scm}) se reinician a sus valores
2623 predeterminados si no se han fijado (cero para las dos claves). La
2624 definición de una propiedad o variable como una lista-A (de cualquier
2625 tamaño) siempre reinicia todos los valores de clave no establecidos a
2626 sus valores predeterminados si no se han fijado. Ano ser que este sea
2627 el resultado deseado, es más seguro actualizar los valores de clave
2628 individualmente con una declaración anidada.
2630 @warning{Las declaraciones anidadas no funcionan para las listas-A de
2631 propiedades de contexto (como @code{beamExceptions},
2632 @code{keyAlterations}, @code{timeSignatureSettings}, etc.). Estas
2633 propiedades sólo se pueden modificar redefiniéndolas completamente
2637 @node Conceptos y propiedades útiles
2638 @section Conceptos y propiedades útiles
2639 @translationof Useful concepts and properties
2643 * Modos de entrada::
2644 * Dirección y posición::
2645 * Distancias y medidas::
2646 * Propiedades del símbolo del pentagrama::
2647 * Objetos de extensión::
2648 * Visibilidad de los objetos::
2649 * Estilos de línea::
2650 * Rotación de objetos::
2654 @node Modos de entrada
2655 @subsection Modos de entrada
2656 @translationof Input modes
2658 La forma en que se interpreta la notación contenida dentro de un
2659 archivo de entrada, está determinada por el modo de entrada en curso.
2661 @strong{Modo de acordes}
2663 Se activa con la instrucción @code{\chordmode} y produce que la
2664 entrada se interprete con al sintaxis de la notación de acordes, véase
2665 @ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
2668 El modo de acordes se activa también con la instrucción
2669 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
2670 y produce que el código que sigue se interprete con la sintaxis de la
2671 notación de acordes y se imprima como nombres de acorde dentro del
2672 contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
2674 @strong{Modo de percusión}
2676 Se activa con la instrucción @code{\drummode} y produce que el código
2677 de entrada se interprete con la sintaxis de la notación de percusión,
2678 véase @ref{Notación básica de percusión}.
2680 El modo de percusión también se activa con la instrucción
2681 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
2682 que el código que sigue se interprete con la sintaxis de la notación
2683 de percusión y se imprima como símbolos de percusión sobre un
2684 pentagrama de percusión, véase @ref{Notación básica de percusión}.
2686 @strong{Modo de cifras}
2688 Se activa con la instrucción @code{\figuremode} y hace que el código
2689 de entrada se interprete con la sintaxis del bajo cifrado, véase
2690 @ref{Introducir el bajo cifrado}.
2692 El modo de cifras también se activa con la instrucción
2693 @code{\figures}. También crea un contexto de @code{FiguredBass}
2694 nuevo y hace que el código que viene a continuación se interprete
2695 con la sintaxis del bajo cifrado y se imprima como símbolos de
2696 bajo cifrado dentro del contexto @code{FiguredBass}, véase
2697 @ref{Introducción al bajo cifrado}.
2699 @strong{Modos de traste y tablatura}
2701 No existen modos de entrada especiales para introducir símbolos de
2702 trastes y de tablatura.
2704 Para crear diagramas de trastes, escriba las notas o acordes en el
2705 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2706 véase @ref{Tablaturas predeterminadas}.
2708 Para crear diagramas de trastes encima de un pentagrama, escríbalos
2709 como elementos de marcado encima de las notas utilizando la
2710 instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
2712 @strong{Modo de letra}
2714 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
2715 se interprete como sílabas de la letra de la canción con duraciones
2716 opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
2718 El modo de letra también se habilita con la instrucción
2719 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
2720 y una instrucción @code{\lyricsto} implícita que asocia la letra que
2721 viene a continuación con la música precedente.
2723 @strong{Modo de marcado}
2725 Se activa con la instrucción @code{\markup}, y hace que la entrada se
2726 interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
2728 @c silly work-around for texinfo broken-ness
2729 @c (@strong{Note...} causes a spurious cross-reference in Info)
2732 Es el modo predeterminado o se puede activar con la instrucción
2733 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
2734 marcado, etc. y se imprime como notación musical sobre un pentagrama.
2736 Normalmente no es necesario especificar el modo de notas de forma
2737 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2738 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2739 otro modo y queremos insertar algo que solamente se puede hacer con la
2740 sintaxis del modo de notas.
2742 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
2743 una pieza coral es necesario entrar en el modo de notas para poder
2744 interpretar dichas indicaciones:
2746 @lilypond[verbatim,relative=2,quote]
2749 \notemode{\set stanza = \markup{ \dynamic f 1. } }
2753 \notemode{\set stanza = \markup{ \dynamic p 2. } }
2759 @node Dirección y posición
2760 @subsection Dirección y posición
2761 @translationof Direction and placement
2763 Al tipografiar música, la dirección y colocación de muchos elementos
2764 es cuestión de elección. Por ejemplo, las plicas de las notas se
2765 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
2766 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
2767 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
2768 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
2769 LilyPond las determine automáticamente, pero en ciertos casos puede
2770 ser deseable forzar una dirección o colocación concreta.
2773 * Indicadores de dirección de las articulaciones::
2774 * La propiedad de dirección::
2777 @node Indicadores de dirección de las articulaciones
2778 @unnumberedsubsubsec Indicadores de dirección de las articulaciones
2779 @translationof Articulation direction indicators
2781 De forma predeterminada algunas direcciones siempre son hacia arriba o
2782 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
2783 otras cosas pueden alternar entre arriba y abajo en función de la
2784 dirección de las plicas (como las ligaduras o los acentos).
2786 @c TODO Add table showing these
2788 Se puede sobreescribir la acción predeterminada mediante el prefijado
2789 de la articulación por un @emph{indicacor de dirección}. Están
2790 disponibles tres indicadores de dirección: @code{^} (que significa
2791 @qq{arriba}), @code{_} (que significa @qq{abajo}) o @code{-} (que
2792 significa @qq{usar la dirección predeterminada}). El indicador de
2793 dirección se puede normalmente omitir, en cuyo caso se supone el
2794 indicador predeterminado @code{-}, pero se necesita un indicador de
2795 dirección @strong{siempre} antes de:
2798 @item las instrucciones @code{\tweak}
2799 @item las instrucciones @code{\markup}
2800 @item las instrucciones @code{\tag}
2801 @item los marcados de cadena, p.ej. -"cadena"
2802 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2803 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2806 Estas indicaciones afectan sólo a la nota siguiente.
2808 @lilypond[verbatim,quote,relative=2]
2815 @node La propiedad de dirección
2816 @unnumberedsubsubsec La propiedad de dirección
2817 @translationof The direction property
2819 La posición o dirección de muchos objetos de presentación está
2820 controlada por la propiedad @code{direction}.
2822 El valor de la propiedad @code{direction} se puede establecer al valor
2823 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
2824 @w{@code{-1}}, con el significado de @qq{hacia abajo} o @qq{debajo}.
2825 Se pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
2826 @code{1} y @w{@code{-1}} respectivamente. La dirección predeterminada
2827 se puede especificar estableciendo @code{direction} a @code{0} ó a
2828 @code{CENTER}. De forma alternativa, en muchos casos existen
2829 instrucciones predefinidas para especificar la dirección. Todas ellas
2833 @code{\xxxUp}, @code{\xxxDown} o @code{\xxxNeutral}
2837 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
2838 predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
2840 En alguna que otra ocasión como en el arpegio, el
2841 valor de la propiedad @code{direction} puede especificar si el objeto se debe
2842 colocar a la izquierda o a la derecha del objeto padre. En este caso
2843 @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y @code{1}
2844 ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
2845 significan @qq{utilizar la dirección predeterminada}.
2847 Estas indicaciones afectan a todas las notas hasta que son canceladas.
2849 @lilypond[verbatim,quote,relative=2]
2858 En música polifónica, en general es mejor especificar una voz explícita
2859 que cambiar la dirección de un objeto. Para ver más información,
2860 véase @ref{Varias voces}.
2863 Manual de aprendizaje:
2864 @rlearning{Objetos interiores al pentagrama}.
2866 Referencia de la notación:
2870 @node Distancias y medidas
2871 @subsection Distancias y medidas
2872 @translationof Distances and measurements
2874 @cindex distancias absolutas
2875 @cindex distancias escaladas
2882 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
2884 Las distancias absolutas se usan para especificar márgenes, sangrados
2885 y otros detalles de diseño de página, y de forma predeterminada se
2886 especifican en milímetros. Las distancias se pueden especificar en
2887 otras unidades escribiendo después de la cifra indicativa de la
2888 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
2889 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
2890 de página se pueden especificar también en unidades escalables (véase
2891 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
2892 La disposición de página se describe en detalle en
2893 @ref{Disposición de la página}.
2895 Las distancias escaladas siempre se especifican en unidades de un
2896 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
2897 El espacio de pentagrama es la distancia entre dos líneas del
2898 pentagrama adyacentes. El valor predeterminado se puede cambiar
2899 globalmente fijando el tamaño global del pentagrama, o se puede
2900 sobreescribir localmente cambiando la propiedad @code{staff-space} del
2901 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
2902 automáticamente con cualquier cambio al tamaño global del pentagrama o
2903 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
2904 las fuentes tipográficas se escalan solamente con los cambios
2905 efectuados al tamaño global del pentagrama. Así, el tamaño global del
2906 pentagrama posibilita la fácil variación del tamaño general de una
2907 partitura impresa. Para ver los métodos de establecimiento del tamaño
2908 global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2912 Si se necesita dibujar sólo una sección de una partitura a una escala
2913 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2914 simplemente cambiar el tamaño global del pentagrama porque esto
2915 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2916 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2917 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2918 nuestra disposición una función de Scheme, @code{magstep}, para
2919 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2920 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2921 utilización, consulte @rlearning{Longitud y grosor de los objetos}.
2924 Manual de aprendizaje:
2925 @rlearning{Longitud y grosor de los objetos}.
2927 Referencia de la notación:
2928 @ref{Disposición de la página},
2929 @ref{Establecer el tamaño del pentagrama}.
2932 @node Propiedades del símbolo del pentagrama
2933 @subsection Propiedades del símbolo del pentagrama
2934 @translationof Staff symbol properties
2936 @cindex ajuste del símbolo del pentagrama
2937 @cindex dibujar el símbolo del pentagrama
2938 @cindex pentagrama, establecer el símbolo del
2940 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2941 @c Need to think of uses for these properties. Eg 'line-positions
2942 @c is used in a snippet to thicken centre line.
2943 @c If retained, add @ref to here in 1.6.2 -td
2945 Se puede definir al mismo tiempo la posición vertical de las líneas de
2946 la pauta y el número de líneas de la misma. Como muestra el siguiente
2947 ejemplo, las posiciones de las notas no están influidas por las
2948 posiciones de las líneas de la pauta.
2950 @warning{La propiedad @code{'line-positions} sobreescribe a la
2951 propiedad @code{'line-count}. El número de líneas de la pauta está
2952 definido implícitamente por el número de elementos de la lista de
2953 valores de @code{'line-positions}.}
2955 @lilypond[verbatim,quote,relative=1]
2957 \override StaffSymbol.line-positions = #'(7 3 0 -4 -6 -7)
2962 Se puede modificar la anchura de la pauta. Las unidades son espacios
2963 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2964 resulta afectado por este ajuste.
2966 @lilypond[verbatim,quote,relative=1]
2968 \override StaffSymbol.width = #23
2974 @node Objetos de extensión
2975 @subsection Objetos de extensión
2976 @translationof Spanners
2978 Muchos objetos de notación musical abarcan varias notas o incluso
2979 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2980 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2981 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2982 especiales para controlar su apariencia y comportamiento. Algunas de
2983 estas propiedades son comunes a todos los objetos de extensión; otras
2984 se limitan a un subconjunto de los extensores.
2986 Todos los objetos de extensión contemplan el interface
2987 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2988 una línea recta entre los dos objetos, contemplan también el interface
2989 @code{line-spanner-interface}.
2992 * Uso del spanner-interface::
2993 * Uso del line-spanner-interface::
2996 @node Uso del spanner-interface
2997 @unnumberedsubsubsec Uso del @code{spanner-interface}
2998 @translationof Using the spanner-interface
3000 Este interface proporciona dos propiedades que se aplican a varios
3003 @subsubsubheading La propiedad @code{minimum-length} (longitud mínima)
3005 La longitud mínima del objeto de extensión se especifica a través
3006 de la propiedad @code{minimum-length}. Su aumento suele producir
3007 el efecto necesario de aumentar el espaciado de las notas entre
3008 los dos puntos extremos. Sin embargo, esta sobreescritura no
3009 tiene ningún efecto sobre muchos extensores, pues su longitud está
3010 determinada por otras consideraciones. Más abajo se muestran
3011 algunos ejemplos de dónde es efectiva.
3021 Works as long as callback is made:
3025 Works not at all for:
3034 @lilypond[verbatim,quote,relative=2]
3037 % increase the length of the tie
3038 -\tweak minimum-length #5
3042 @lilypond[verbatim,quote,relative=2]
3044 \compressFullBarRests
3046 % increase the length of the rest bar
3047 \once \override MultiMeasureRest.minimum-length = #20
3052 @lilypond[verbatim,quote,relative=2]
3054 % increase the length of the hairpin
3055 \override Hairpin.minimum-length = #20
3059 Esta sobreescritura se puede usar también para aumentar la longitud de
3060 las ligaduras de expresión y de fraseo:
3062 @lilypond[verbatim,quote,relative=2]
3065 -\tweak minimum-length #5
3070 -\tweak minimum-length #5
3074 Para algunos objetos de presentación, la propiedad
3075 @code{minimum-length} es efectiva sólo si se llama explícitamente al
3076 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
3077 propiedad @code{springs-and-rods} al valor
3078 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
3079 de un glissando no tiene efecto a no ser que se establezca la
3080 propiedad @code{springs-and-rods}:
3082 @lilypond[verbatim,quote,relative=1]
3086 % not effective alone
3087 \once \override Glissando.minimum-length = #20
3090 % effective only when both overrides are present
3091 \once \override Glissando.minimum-length = #20
3092 \once \override Glissando.springs-and-rods = #ly:spanner::set-spacing-rods
3096 Lo mismo se puede decir del objeto @code{Beam}:
3098 @lilypond[verbatim,quote,relative=1]
3099 % not effective alone
3100 \once \override Beam.minimum-length = #20
3103 % effective only when both overrides are present
3104 \once \override Beam.minimum-length = #20
3105 \once \override Beam.springs-and-rods = #ly:spanner::set-spacing-rods
3109 @subsubsubheading La propiedad @code{to-barline}
3111 La segunda propiedad útil del @code{spanner-interface} es
3112 @code{to-barline}. De forma predeterminada tiene el valor cierto,
3113 haciendo que los reguladores y otros objetos de extensión que terminan
3114 sobre la primera nota de un compás, en vez de eso terminen en la línea
3115 divisoria inmediatamente precedente. Si se establece al valor falso,
3116 el extensor llegará más allá de la barra de compás y terminará
3117 exactamente sobre la nota:
3119 @lilypond[verbatim,quote,relative=2]
3120 a \< a a a a \! a a a \break
3121 \override Hairpin.to-barline = ##f
3122 a \< a a a a \! a a a
3125 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
3126 su establecimiento a @code{#t} no tienen ningún efecto sobre las
3127 ligaduras de expresión o de fraseo, o sobre otros extensores para los
3128 que terminar en la barra de compás no tendría ningún significado.
3130 @node Uso del line-spanner-interface
3131 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
3132 @translationof Using the line-spanner-interface
3134 Entre los objetos que contemplan el interface
3135 @code{line-spanner-interface} se encuentran
3138 @item @code{DynamicTextSpanner}
3139 @item @code{Glissando}
3140 @item @code{TextSpanner}
3141 @item @code{TrillSpanner}
3142 @item @code{VoiceFollower}
3145 La rutina responsable de dibujar los sellos de estos extensores es
3146 @code{ly:line-interface::print}. esta rutina determina la
3147 localización exacta de los dos puntos extremos y traza una línea entre
3148 ellos, en el estilo solicitado. Las posiciones de los dos puntos
3149 extremos del extensor se calculan al vuelo, pero es posible
3150 sobreescribir sus coordenadas Y. Las propiedades que se deben
3151 especificar están anidadas a dos niveles de profundidad en la
3152 jerarquía de propiedades, pero la sintaxis de la instrucción
3153 @code{\override} es bastante sencilla:
3155 @lilypond[relative=2,quote,verbatim]
3157 \once \override Glissando.bound-details.left.Y = #3
3158 \once \override Glissando.bound-details.right.Y = #-2
3162 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
3163 siendo el punto del cero la línea central del pentagrama. Para el
3164 glissando, esto es el valor de @code{Y} en la coordenada X que
3165 corresponde al punto central de cada cabeza de nota si nos imaginamos
3166 que la línea se extiende hasta allí.
3168 Si no está fijado @code{Y}, su valor se calcula a partir de la
3169 posición vertical del punto de anclaje correspondiente del extensor.
3171 En caso de salto de línea, los valores para los puntos extremos se
3172 especifican por las sub-listas @code{left-broken} y
3173 @code{right-broken} de @code{bound-details}. Por ejemplo:
3175 @lilypond[relative=2,ragged-right,verbatim,quote]
3176 \override Glissando.breakable = ##t
3177 \override Glissando.bound-details.right-broken.Y = #-3
3178 c1 \glissando \break
3182 Un número de propiedades adicionales de las sub-listas @code{left} y
3183 @code{right} de la propiedad @code{bound-details} se pueden
3184 especificar de la misma forma que @code{Y}:
3188 Establece la coordenada Y del punto extremo, en desplazamientos de
3189 @code{staff-space}s desde la línea central del pentagrama. De forma
3190 predeterminada es el centro del objeto ancla, y así un glissando
3191 apunta al centro vertical de la cabeza de la nota.
3193 Para extensores horizontales como los extensores de texto y los
3194 trinos, está inamoviblemente codificado como 0.
3196 @item attach-dir (dirección de anclaje)
3197 Determina dónde comienza y termina la línea en la dirección X, con
3198 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o @code{LEFT},
3199 izquierda) hace que la línea comience o termine en el lado izquierdo
3200 de la cabeza de la nota a la que está anclado.
3203 Es la coordenada X absoluta del punto extremo. Se suele calcular al
3204 vuelo, y su sobreescritura no tiene un efecto útil.
3206 @item stencil (sello)
3207 Los extensores de línea pueden tener símbolos al comienzo o al final,
3208 lo que está contenido en esta sub-propiedad. Esto es para uso
3209 interno; se recomienda en su lugar el uso de @code{text}.
3212 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
3213 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
3214 de extensión horizontales.
3216 @lilypond[quote,ragged-right,relative=2,verbatim]
3217 \override TextSpanner.bound-details.left.text
3218 = \markup { \small \bold Slower }
3219 c2\startTextSpan b c a\stopTextSpan
3222 @item stencil-align-dir-y (alineación del sello en y)
3223 @item stencil-offset (desplazamiento del sello)
3224 Si no se modifican uno u otro, el sello se coloca sencillamente en el
3225 punto extremo, centrado sobre la línea, como viene definido por las
3226 subpropiedades @code{X} e @code{Y}. Si se fijan
3227 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
3228 símbolo del borde verticalmente con relación al extremo de la línea:
3230 @lilypond[relative=1,quote,verbatim]
3231 \override TextSpanner.bound-details.left.stencil-align-dir-y = #-2
3232 \override TextSpanner.bound-details.right.stencil-align-dir-y = #UP
3234 \override TextSpanner.bound-details.left.text = #"ggg"
3235 \override TextSpanner.bound-details.right.text = #"hhh"
3236 c4^\startTextSpan c c c \stopTextSpan
3239 Observe que los valores negativos mueven el texto @emph{hacia arriba},
3240 al contrario de lo que podría esperarse, pues el valor de @w{@code{-1}} o
3241 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
3242 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
3243 (arriba) alinea el borde superior del texto con la línea extensora.
3245 @item arrow (flecha)
3246 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
3247 flecha en el extremo de la línea.
3249 @item padding (relleno)
3250 Esta sub-propiedad controla el espacio entre el punto extremo
3251 especificado de la línea y el extremo real. Sin relleno, un glissando
3252 empezaría y terminaría en el centro de la cabeza de las notas.
3256 La función musical @code{\endSpanners} finaliza de forma prematura el
3257 extensor que comienza sobre la nota que sigue inmediatamente a
3258 continuación. Se termina después de una nota exactamente, o en la
3259 siguiente barra de compás si @code{to-barline} es verdadero y se
3260 produce una divisoria antes de la siguiente nota.
3262 @lilypond[verbatim,quote,ragged-right,relative=2]
3264 c2 \startTextSpan c2 c2
3269 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
3270 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
3273 Referencia de funcionamiento interno:
3274 @rinternals{TextSpanner},
3275 @rinternals{Glissando},
3276 @rinternals{VoiceFollower},
3277 @rinternals{TrillSpanner},
3278 @rinternals{line-spanner-interface}.
3281 @node Visibilidad de los objetos
3282 @subsection Visibilidad de los objetos
3283 @translationof Visibility of objects
3285 @cindex objetos, visibilidad de
3286 @cindex grobs, visibilidad de
3287 @cindex visibilidad de los objetos
3289 Hay cuatro formas principales en que se puede controlar la visibilidad
3290 de los objetos de presentación: se puede eliminar su sello, se pueden
3291 volver transparentes, se pueden pintar de blanco, o se puede
3292 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
3293 se aplican a todos los objetos de presentación; la última sólo a unos
3294 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
3295 introduce estas cuatro técnicas,
3296 véase @rlearning{Visibilidad y color de los objetos}.
3298 Hay también algunas otras técnicas que son específicas de ciertos
3299 objetos de presentación. Se estudian bajo Consideraciones especiales.
3302 * Eliminar el sello::
3303 * Hacer transparentes los objetos::
3304 * Pintar los objetos de blanco::
3305 * Uso de break-visibility (visibilidad en el salto)::
3306 * Consideraciones especiales::
3310 @node Eliminar el sello
3311 @unnumberedsubsubsec Eliminar el sello
3312 @translationof Removing the stencil
3314 @cindex sello, eliminar
3317 Todo objeto de presentación tiene una propiedad stencil (sello). De
3318 forma predeterminada está establecida a la función específica que
3319 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
3320 se llama a ninguna función y el objeto no se dibuja. La acción
3321 predeterminada se puede recuperar con @code{\revert}.
3323 @lilypond[quote,verbatim,relative=1]
3325 \override Score.BarLine.stencil = ##f
3327 \revert Score.BarLine.stencil
3331 Esta operación, bastante común, tiene la forma abreviada @code{\omit}
3334 @lilypond[quote,verbatim,relative=1]
3338 \undo \omit Score.BarLine
3343 @node Hacer transparentes los objetos
3344 @unnumberedsubsubsec Hacer transparentes los objetos
3345 @translationof Making objects transparent
3347 @cindex transparentes, hacer los objetos
3350 Todo objeto de presentación tiene una propiedad transparent
3351 (transparente) que de forma predeterminada está establecida a
3352 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
3355 @lilypond[quote,verbatim,relative=2]
3357 \once \override NoteHead.transparent = ##t
3361 Esta operación, bastante común, tiene la forma abreviada @code{\hide}
3364 @lilypond[quote,verbatim,relative=2]
3366 \once \hide NoteHead
3371 @node Pintar los objetos de blanco
3372 @unnumberedsubsubsec Pintar los objetos de blanco
3373 @translationof Painting objects white
3375 @cindex objetos, coloreado de
3376 @cindex coloreado de objetos
3378 @cindex impresión, orden de
3379 @cindex sobreescritura de objetos
3380 @cindex objetos, sobreescritura de
3381 @cindex grobs, sobreescritura de
3383 Todo objeto de presentación tiene una propiedad de color que de forma
3384 predeterminada está establecida a @code{black} (negro). Si se
3385 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
3386 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
3387 color de los puntos de cruce queda determinado por el orden en que se
3388 dibujan estos objetos, lo que puede dejar una imagen fantasma del
3389 objeto blanco, como puede verse aquí:
3391 @lilypond[quote,verbatim,relative=2]
3392 \override Staff.Clef.color = #white
3396 Se puede evitar esto cambiando el orden de impresión de los objetos.
3397 Todos los objetos de presentación tienen una propiedad @code{layer}
3398 (capa) que se debe establecer a un valor entero. Los objetos con el
3399 valor de @code{layer} más bajo se dibujan primero, después se dibujan
3400 los objetos con valores progresivamente mayores, y así los objetos con
3401 valores más altos se dibujan encima de los que tienen valores más
3402 bajos. De forma predeterminada, casi todos los objetos tienen
3403 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
3404 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
3405 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
3406 impresión de los objetos con el mismo valor de @code{layer} es
3409 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
3410 predeterminado de @code{1}, se dibuja después de las líneas del
3411 pentagrama (valor @code{layer} predeterminado de @code{0}),
3412 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
3413 @code{Clef} un valor de @code{layer} más bajo, digamos @w{@code{-1}},
3414 para que se dibuje antes:
3416 @lilypond[quote,verbatim,relative=2]
3417 \override Staff.Clef.color = #white
3418 \override Staff.Clef.layer = #-1
3423 @node Uso de break-visibility (visibilidad en el salto)
3424 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
3425 @translationof Using break-visibility
3427 @c TODO Add making other objects breakable
3429 @cindex break-visibility
3431 Casi todos los objetos de presentación se imprimen una sola vez, pero
3432 algunos como las líneas divisorias, claves, indicaciones de compás y
3433 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
3434 se produce un salto de línea : una vez al final de la línea y otra al
3435 comienzo de la siguiente. Estos objetos reciben el nombre de
3436 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
3437 (visibilidad en el salto), para controlar su visibilidad en las tres
3438 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
3439 la línea si se produce un cambio, y al final de la línea si el cambio
3440 se produce en ese lugar.
3442 Por ejemplo, la indicación de compás se imprime de forma
3443 predeterminada al comienzo de la primera línea y en ningún otro lugar
3444 a no ser que cambie, en cuyo caso se imprime en el punto en que se
3445 produce el cambio. Si este cambio se produce al final de una línea,
3446 la nueva indicación de compás se imprime al principio de la línea
3447 siguiente y también al final de la línea anterior como indicación de
3450 Este comportamiento se controla por medio de la propiedad
3451 @code{break-visibility}, que se explica en
3452 @c Leave this ref on a newline - formats incorrectly otherwise -td
3453 @rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
3454 vector de tres valores booleanos que, por orden, determinan si el
3455 objeto se imprime al final, dentro, o al principio de la línea. O,
3456 para ser más exactos: antes del salto de línea, si no hay salto, o
3459 Como alternativa se puede especificar cualquiera de las ocho
3460 combinaciones mediante funciones predefinidas cuya definición está en
3461 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
3462 los objetos de presentación serán visibles en las posiciones que se
3463 muestran en el encabezamiento de cada columna:
3465 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
3466 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
3467 @headitem de función @tab de vector @tab salto @tab salto @tab salto
3469 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
3470 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
3471 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
3472 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
3473 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
3474 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
3475 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
3476 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
3479 Los ajustes predeterminados de @code{break-visibility} dependen del
3480 objeto de presentación. La tabla siguiente muestra todos los objetos
3481 de presentación de interés que resultan afectados por
3482 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
3484 @multitable @columnfractions .3 .3 .4
3486 @headitem Objeto @tab Contexto usual @tab Valor predet.
3488 @c omit Ambitus as it appears not to be affected by break-visibility -td
3489 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
3490 @item @code{BarLine} @tab @code{Score} @tab calculado
3491 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
3492 @c omit the following item until it can be explained -td
3493 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
3494 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3495 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
3496 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
3497 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3498 @item @code{KeyCancellation} @tab @code{Staff} @tab @code{begin-of-line-invisible}
3499 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
3500 @c omit LeftEdge until it can be explained -td
3501 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
3502 @item @code{ClefModifier} @tab @code{Staff} @tab @code{begin-of-line-visible}
3503 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
3504 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
3508 El ejemplo de abajo muestra el uso de la forma de vector para
3509 controlar la visibilidad de las líneas divisorias:
3511 @lilypond[quote,verbatim,relative=1,ragged-right]
3514 % Remove bar line at the end of the current line
3515 \once \override Score.BarLine.break-visibility = ##(#f #t #t)
3521 Aunque los tres componentes del vector utilizado para sobreescribir
3522 @code{break-visibility} deben estar presentes, no todos son efectivos
3523 para todos los objetos de presentación, y algunas combinaciones pueden
3524 incluso dar errores. Son de aplicación las siguientes limitaciones:
3527 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
3528 @item No se puede imprimir el número de compás al principio de la primera
3529 línea a no ser que su valor establecido sea distinto de 1.
3530 @item Clave: véase más abajo
3531 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
3532 se suprimen por completo. Utilice begin-of line-invisible para
3533 imprimirlas y all-invisible para suprimirlas.
3534 @item Armadura: véase más abajo
3535 @item ClefModifier: véase más abajo
3539 @node Consideraciones especiales
3540 @unnumberedsubsubsec Consideraciones especiales
3541 @translationof Special considerations
3543 @subsubsubheading Visibilidad después de un cambio explícito
3545 @cindex armadura, visibilidad después de un cambio explícito
3546 @cindex explicitKeySignatureVisibility
3547 @cindex clave, visibilidad después de un cambio explícito
3548 @cindex explicitClefVisibility
3550 La propiedad @code{break-visibility} controla la visibilidad de las
3551 armaduras y cambios de clave sólo al principio de las líneas, es
3552 decir, después de un salto. No tiene ningún efecto sobre la
3553 visibilidad de la armadura o la clave después de un cambio explícito
3554 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
3555 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
3556 bemol mayor es visible incluso con @code{all-invisible} establecido.
3558 @lilypond[quote,verbatim,relative=1,ragged-right]
3561 % Try to remove all key signatures
3562 \override Staff.KeySignature.break-visibility = #all-invisible
3570 La visibilidad de estos cambios explícitos de tonalidad y de clave se
3571 controla por medio de las propiedades
3572 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
3573 Son los equivalentes de la propiedad @code{break-visibility} y las dos
3574 toman un vector de tres valores booleanos o las funciones predefinidas
3575 relacionadas anteriormente, exactamente igual que
3576 @code{break-visibility}. Las dos son propiedades del contexto Staff,
3577 no de los propios objetos de presentación, y por tanto se establecen
3578 utilizando la instrucción @code{\set}. Las dos están establecidas de
3579 forma predeterminada al valor @code{all-visible}. Estas propiedades
3580 controlan sólo la visibilidad de las armaduras y las claves que
3581 resultan de los cambios explícitos y no afectan a las armaduras y
3582 tonalidades que están al principio de las líneas; para quitarlas, aún
3583 se debe sobreescribir la propiedad @code{break-visibility} en el
3584 objeto correspondiente.
3586 @lilypond[quote,verbatim,relative=1,ragged-right]
3589 \set Staff.explicitKeySignatureVisibility = #all-invisible
3590 \override Staff.KeySignature.break-visibility = #all-invisible
3597 @subsubsubheading Visibilidad de las alteraciones de precaución
3599 Para eliminar las alteraciones de cancelación que se imprimen en un
3600 cambio de tonalidad explícito, establezca la propiedad
3601 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3603 @lilypond[quote,verbatim,relative=1,ragged-right]
3606 \set Staff.explicitKeySignatureVisibility = #all-invisible
3607 \set Staff.printKeyCancellation = ##f
3608 \override Staff.KeySignature.break-visibility = #all-invisible
3615 Con estas sobreescrituras solamente permanecen las alteraciones
3616 accidentales delante de las notas para indicar el cambio de tonalidad.
3618 Observe que al modificar la tonalidad a Do@tie{}mayor o
3619 La@tie{}menor, las alteraciones de cancelación serían @emph{la
3620 única} indicación del cambio de armadura. En este caso, el
3621 establecimiento de @code{printKeyCancellation} al valor @code{#f}
3622 no tiene ningún efecto:
3624 @lilypond[quote,verbatim,relative=1,ragged-right]
3627 \set Staff.explicitKeySignatureVisibility = #all-invisible
3628 \set Staff.printKeyCancellation = ##f
3635 En lugar de ello, para suprimir las alteraciones de cancelación
3636 aún cuando la armadura cambia a Do@tie{}mayor o a La@tie{}menor,
3637 sobreescriba la visibilidad del grob @code{KeyCancellation}:
3639 @lilypond[quote,verbatim,relative=1,ragged-right]
3642 \set Staff.explicitKeySignatureVisibility = #all-invisible
3643 \override Staff.KeyCancellation.break-visibility = #all-invisible
3650 @c TODO Add visibility of cautionary accidentals before notes
3652 @subsubsubheading Líneas divisorias automáticas
3654 @cindex automaticBars
3655 @cindex líneas divisorias, eliminación
3657 Como caso especial, la impresión de las líneas divisorias también se
3658 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
3659 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
3660 imprimen automáticamente; se deben crear explícitamente con una
3661 instrucción @code{\bar}. A diferencia de la instrucción predefinida
3662 @code{\cadenzaOn}, los compases se siguen contando. La generación de
3663 compases continúa de acuerdo a esta cuenta si esta propiedad se
3664 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
3665 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
3670 @subsubsubheading Claves transportadas
3672 @cindex transportadas, visibilidad de las claves
3673 @cindex visibilidad de las claves transportadas
3674 @cindex claves, visibilidad de la transposición
3676 El pequeño símbolo de transposición sobre una clave se produce por
3677 parte del objeto @code{ClefModifier}. Su visibilidad se hereda
3678 automáticamente de la del objeto @code{Clef}, así que no es
3679 necesario aplicar las sobreescrituras correspondientes
3680 @code{break-visibility} a los objetos @code{ClefModifier} para
3681 suprimir los símbolos de transposición u octavación para las
3684 Para los cambios de clave explícitos, la propiedad
3685 @code{explicitClefVisibility} controla tanto el símbolo de clave
3686 como el símbolo de transposición o de octava asociado.
3689 Manual de aprendizaje:
3690 @rlearning{Visibilidad y color de los objetos}
3693 @node Estilos de línea
3694 @subsection Estilos de línea
3695 @translationof Line styles
3697 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3698 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
3699 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
3701 Todos ellos usan las mismas rutinas que el glissando para dibujar los
3702 textos y las líneas, y por ello el ajuste fino de su comportamiento se
3703 hace de la misma manera. Se hace con un spanner (un objeto de
3704 extensión), y la rutina responsable de dibujar los objetos de
3705 extensión es @code{ly:line-interface::print}. Esta rutina determina la
3706 colocación exacta de los dos @i{extremos del objeto de extensión} y
3707 dibuja una línea entre ellos, en el estilo solicitado.
3709 He aquí un ejemplo de los distintos estilos de línea disponibles, y
3710 cómo aplicarles ajustes finos.
3712 @lilypond[relative=2,ragged-right,verbatim,quote]
3714 \once \override Glissando.style = #'dashed-line
3716 \override Glissando.style = #'dotted-line
3718 \override Glissando.style = #'zigzag
3720 \override Glissando.style = #'trill
3724 Las posiciones de los puntos extremos del objeto de extensión se
3725 computan al vuelo para cada uno de los objetos gráficos, pero es
3726 posible sobreescribirlos:
3729 @lilypond[relative=2,ragged-right,verbatim,quote]
3731 \once \override Glissando.bound-details.right.Y = #-2
3735 El valor de @code{Y} está establecido a @w{@code{-2}} para el extremo
3736 derecho. El lado izquierdo se puede ajustar de forma similar
3737 especificando @code{left} en vez de @code{right}.
3739 Si no está establecido @code{Y}, el valor se computa a partir de la
3740 posición vertical de los puntos de anclaje izquierdo y derecho del
3743 Son posibles otros ajustes de los extensores, para ver más detalles
3744 consulte @ref{Objetos de extensión}.
3747 @node Rotación de objetos
3748 @subsection Rotación de objetos
3749 @translationof Rotating objects
3751 Tanto los objetos de presentación como los elementos de texto de
3752 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
3753 pero difiere el método de hacerlo.
3756 * Rotación de objetos de presentación::
3757 * Rotación de elementos de marcado::
3760 @node Rotación de objetos de presentación
3761 @unnumberedsubsubsec Rotación de objetos de presentación
3762 @translationof Rotating layout objects
3764 @cindex rotating objects
3765 @cindex objects, rotating
3767 Todos los objetos de presentación que contemplan el interface
3768 @code{grob-interface} se pueden rotar estableciendo su propiedad
3769 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
3770 rotación en sentido antihorario, y las coordenadas x e y del punto con
3771 relación al punto de referencia del objeto, alrededor del que se va a
3772 realizar la rotación. El ángulo de rotación se especifica en grados
3773 y las coordenadas en espacios de pentagrama.
3775 El ángulo de rotación y las coordenadas del punto de rotación se deben
3776 determinar por ensayo y error.
3778 @cindex reguladores en ángulo
3779 @cindex ángulo, reguladores en
3781 Solamente en ciertas ocasiones es útil la rotación de objetos de
3782 presentación; el ejemplo siguiente muestra una situación en que puede
3785 @lilypond[quote,verbatim,relative=1]
3787 \override Hairpin.rotation = #'(20 -1 0)
3792 @node Rotación de elementos de marcado
3793 @unnumberedsubsubsec Rotación de elementos de marcado
3794 @translationof Rotating markup
3796 Todos los textos de marcado se pueden rotar para que se dispongan en
3797 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
3798 instrucción acepta dos argumentos: el ángulo de rotación en grados en
3799 sentido antihorario, y el texto que rotar. Los límites que ocupa el
3800 texto no se rotan: toman su valor a partir de los extremos de las
3801 coordenadas x e y del texto rotado. En el ejemplo siguiente la
3802 propiedad @code{outside-staff-priority} del texto se establece a
3803 @code{#f} para desactivar la evitación automática de colisiones, lo
3804 que empuja al texto a una posición muy alta.
3806 @lilypond[quote,verbatim,relative=1]
3807 \override TextScript.outside-staff-priority = ##f
3808 g4^\markup { \rotate #30 "a G" }
3809 b^\markup { \rotate #30 "a B" }
3810 des^\markup { \rotate #30 "a D-Flat" }
3811 fis^\markup { \rotate #30 "an F-Sharp" }
3815 @node Trucos avanzados
3816 @section Trucos avanzados
3817 @translationof Advanced tweaks
3819 Esta sección trata sobre distintos enfoques en la realización de
3820 ajustes finos a la apariencia de la partitura impresa.
3823 * Alineación de objetos::
3824 * Agrupación vertical de objetos gráficos::
3825 * Modificación de los sellos::
3826 * Modificación de las formas::
3827 * Modificación de objetos de extensión divididos::
3828 * Contenedores unpure-pure::
3832 Manual de aprendizaje:
3833 @rlearning{Trucar la salida},
3834 @rlearning{Otras fuentes de información}.
3836 Referencia de la notación:
3837 @ref{Explicación del Manual de referencia de funcionamiento interno},
3838 @ref{Modificar las propiedades}.
3840 Manual de extensión:
3841 @rextend{Interfaces para programadores}.
3844 @file{scm/define-grobs.scm}.
3846 Fragmentos de código:
3847 @rlsr{Tweaks and overrides}.
3849 Referencia de funcionamiento interno:
3850 @rinternals{All layout objects}.
3853 @node Alineación de objetos
3854 @subsection Alineación de objetos
3855 @translationof Aligning objects
3857 Los objetos gráficos que soportan el interface
3858 @code{self-alignment-interface} y/o el @code{side-position-interface}
3859 se pueden alinear contra un objeto colocado previamente, de diversas
3860 maneras. Para ver una lista de estos objetos, consulte
3861 @rinternals{self-alignment-interface} y
3862 @rinternals{side-position-interface}.
3864 Todos los objetos gráficos tienen un punto de referencia, una
3865 extensión horizontal y una extensión vertical. La extensión
3866 horizontal es una pareja de números que dan los desplazamientos a
3867 partir del punto de referencia de los bordes izquierdo y derecho,
3868 siendo negativos los desplazamientos hacia la izquierda. La extensión
3869 vertical es una pareja de números que dan el desplazamiento a partir
3870 del punto de referencia hasta los bordes inferior y superior, siendo
3871 negativos los desplazamientos hacia abajo.
3873 La posición de un objeto sobre el pentagrama viene dada por los
3874 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
3875 valor de @code{X-offset} da el desplazamiento desde la coordenada X
3876 del punto de referencia del objeto padre, y el valor de
3877 @code{Y-offset} da el desplazamiento a partir de la línea central del
3878 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
3879 pueden establecer directamente o se puede dejar que se calculen por
3880 parte de procedimientos para conseguir una alineación con el objeto
3883 @warning{Muchos objetos tienen consideraciones de posicionamiento
3884 especiales que hacen que se ignore o se modifique cualquier ajuste
3885 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
3886 objeto contemple el interface @code{self-alignment-interface}. La
3887 sobreescritura de las propiedades @code{X-offset} ó @code{Y-offset} a
3888 un valor fijo hace que se descarte la respectiva propiedad
3889 @code{self-alignment}.}
3891 Por ejemplo, una alteración accidental se puede reposicionar
3892 verticalmente estableciendo @code{Y-offset} pero los cambios a
3893 @code{X-offset} no tienen ningún efecto.
3895 Las letras de ensayo se pueden alinear con objetos divisibles como
3896 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
3897 propiedades especiales que se encuentran en
3898 @code{break-aligned-interface} para el posicionamiento de las letras
3899 de ensayo sobre dichos objetos.
3902 Referencia de la notación:
3903 @ref{Uso del break-alignable-interface}.
3905 Manual de extensión:
3906 @rextend{Funciones de callback}.
3909 * Establecer directamente X-offset e Y-offset::
3910 * Uso del side-position-interface::
3911 * Uso del self-alignment-interface::
3912 * Uso del break-alignable-interface::
3916 @node Establecer directamente X-offset e Y-offset
3917 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
3918 @translationof Setting X-offset and Y-offset directly
3920 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
3921 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
3922 notas con una digitación en su posición predeterminada y con los
3923 valores @code{X-offset} y @code{Y-offset} modificados.
3925 @lilypond[verbatim,quote,relative=2]
3932 -\tweak X-offset #-1
3940 @node Uso del side-position-interface
3941 @unnumberedsubsubsec Uso del @code{side-position-interface}
3942 @translationof Using the side-position-interface
3944 Un objeto que contempla el @code{side-position-interface} se puede
3945 colocar junto a su objeto padre de forma que los bordes especificados
3946 de los dos objetos se toquen. El objeto se puede situar encima,
3947 debajo, a la derecha o a la izquierda del objeto padre. El padre no
3948 se puede especificar; viene determinado por el orden de los elementos
3949 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
3950 nota asociada como padre.
3952 Los valores de las propiedades @code{side-axis} y @code{direction}
3953 determinan dónde colocar el objeto, como sigue:
3955 @c TODO add an example of each to the table
3957 @multitable @columnfractions .3 .3 .3
3958 @headitem @code{side-axis} @tab @code{direction} @tab
3959 @headitem propiedad @tab propiedad @tab colocación
3961 @item @code{0} @tab @w{@code{-1}} @tab izquierda
3962 @item @code{0} @tab @code{1} @tab derecha
3963 @item @code{1} @tab @w{@code{-1}} @tab debajo
3964 @item @code{1} @tab @code{1} @tab encima
3968 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
3969 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
3970 procedimiento devuelve el calor correcto de @code{X-offset} para
3971 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
3972 el valor de @code{direction}.
3974 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
3975 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
3976 procedimiento devuelve el valor correcto de @code{Y-offset} para
3977 situar el objeto encima o debajo del padre de acuerdo con el valor de
3980 @c TODO Add examples
3983 @node Uso del self-alignment-interface
3984 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
3985 @translationof Using the self-alignment-interface
3987 @subsubsubheading Auto-alineación horizontal de los objetos
3989 La alineación horizontal de un objeto que contempla el interface
3990 @code{self-alignment-interface} está controlada por el valor de la
3991 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
3992 @code{X-offset} de este objeto esté establecida a
3993 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
3994 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
3995 mitad de la extensión X total del objeto. Los valores negativos
3996 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
3997 valor de @code{0} centra el objeto sobre el punto de referencia de su
3998 padre, un valor de @w{@code{-1}} alinea el borde izquierdo del objeto
3999 sobre el punto de referencia de su padre, y un valor de @code{1}
4000 alinea el borde derecho del objeto sobre el punto de referencia de su
4001 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
4002 @code{RIGHT} en sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
4005 Normalmente se usaría la instrucción @code{\override} para modificar
4006 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
4007 @code{\tweak} para alinear varias anotaciones por separado sobre una
4010 @lilypond[quote,verbatim,relative=1]
4012 -\tweak self-alignment-X #-1
4014 -\tweak self-alignment-X #0
4016 -\tweak self-alignment-X #RIGHT
4018 -\tweak self-alignment-X #-2.5
4019 ^"aligned further to the right"
4022 @subsubsubheading Auto-alineación vertical de los objetos
4024 Los objetos se pueden alinear verticalmente en una forma análoga a la
4025 alineación horizontal si la propiedad @code{Y-offset} está establecida
4026 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
4027 a menudo se encuentran implicados otros mecanismos en la alineación
4028 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
4029 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
4030 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
4031 las dimensiones verticales del objeto, que suele ser bastante pequeño,
4032 por lo que pueden requerirse números bastante grandes. Un valor de
4033 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
4034 referencia del objeto padre, un valor de @code{0} alinea el centro del
4035 objeto con el punto de referencia del padre, y un valor de @code{1}
4036 alinea el borde superior del objeto con el punto de referencia del
4037 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
4038 @code{UP} en sustitución de @w{@code{-1}},
4039 @code{0} y @code{1}, respectivamente.
4041 @emph{Auto-alineación de objetos en las dos direcciones}
4043 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
4044 alinear un objeto en las dos direcciones simultáneamente.
4046 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
4047 se acerque a la cabeza de la nota.
4049 @lilypond[quote,verbatim,relative=2]
4051 -\tweak self-alignment-X #0.5 % move horizontally left
4052 -\tweak Y-offset #ly:self-alignment-interface::y-aligned-on-self
4053 -\tweak self-alignment-Y #-1 % move vertically up
4058 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
4060 @c Cannot document as they do not seem to operate consistently on all objects -td
4061 @c TODO investigate further
4063 The @code{aligned-on-parent} procedures are used in the same way
4064 as the @code{aligned-on-self} procedures, they difference being
4065 that they permit an object to be aligned with the @emph{edges} of
4066 the parent rather than the parent's reference point. The following
4067 example shows the difference:
4071 @lilypond[verbatim,quote]
4077 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
4079 @c Cannot document as they do not seem to operate consistently on all objects -td
4080 @c TODO investigate further
4084 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
4087 @node Uso del break-alignable-interface
4088 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
4089 @translationof Using the break-alignable-interface
4091 @cindex alineación a objetos
4092 @cindex break-align-symbols
4094 Las letras de ensayo se pueden alinear con objetos de notación
4095 distintos a las barras de compás. Estos objetos son @code{ambitus},
4096 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
4097 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
4098 @code{time-signature}.
4100 Cada tipo de objeto tiene su propio punto de referencia
4101 predeterminado, con el que se alinean las marcas de ensayo:
4103 @lilypond[verbatim,quote,relative=1]
4104 % The rehearsal mark will be aligned to the right edge of the Clef
4105 \override Score.RehearsalMark.break-align-symbols = #'(clef)
4110 % The rehearsal mark will be aligned to the left edge of the Time Signature
4111 \override Score.RehearsalMark.break-align-symbols = #'(time-signature)
4117 % The rehearsal mark will be centered above the Breath Mark
4118 \override Score.RehearsalMark.break-align-symbols = #'(breathing-sign)
4127 Se puede especificar una lista de posibles objetos para la alineación.
4128 Si algunos de los objetos son invisibles en ese punto debido al valor
4129 de @code{break-visibility} o a valores de visibilidad explícitos para
4130 las armaduras y las claves, la letra de ensayo o número de compás se
4131 alinean con el primer objeto de la lista que sea visible. Si ningún
4132 objeto de la lista es visible, el objeto se alinea con la línea
4133 divisoria. Si la línea divisoria es invisible, el objeto se alinea
4134 con el punto en el que se encontraría la línea divisoria.
4136 @lilypond[verbatim,quote,relative=1]
4137 % The rehearsal mark will be aligned to the right edge of the Key Signature
4138 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4143 % The rehearsal mark will be aligned to the right edge of the Clef
4144 \set Staff.explicitKeySignatureVisibility = #all-invisible
4145 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4150 % The rehearsal mark will be centered above the Bar Line
4151 \set Staff.explicitKeySignatureVisibility = #all-invisible
4152 \set Staff.explicitClefVisibility = #all-invisible
4153 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4160 La alineación de la letra de ensayo con relación al objeto de notación
4161 se puede cambiar, como se ve en el ejemplo siguiente. En una
4162 partitura con varios pentagramas, este ajuste se debe hacer para todos
4165 @lilypond[verbatim,quote,relative=1]
4166 % The RehearsalMark will be aligned with the right edge of the Key Signature
4167 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4173 % The RehearsalMark will be centered above the Key Signature
4174 \once \override Score.KeySignature.break-align-anchor-alignment = #CENTER
4178 % The RehearsalMark will be aligned with the left edge of the Key Signature
4179 \once \override Score.KeySignature.break-align-anchor-alignment = #LEFT
4185 La letra de ensayo también se puede desplazar al borde derecho o
4186 izquierdo en una medida arbitraria. Las unidades son espacios de
4189 @lilypond[verbatim,quote,relative=1]
4190 % The RehearsalMark will be aligned with the left edge of the Key Signature
4191 % and then shifted right by 3.5 staff-spaces
4192 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4193 \once \override Score.KeySignature.break-align-anchor = #3.5
4197 % The RehearsalMark will be aligned with the left edge of the Key Signature
4198 % and then shifted left by 2 staff-spaces
4199 \once \override Score.KeySignature.break-align-anchor = #-2
4206 @node Agrupación vertical de objetos gráficos
4207 @subsection Agrupación vertical de objetos gráficos
4208 @translationof Vertical grouping of grobs
4210 @c TODO Expand this section
4212 Los grobs (objetos gráficos) @code{VerticalAlignment} y
4213 @code{VerticalAxisGroup} trabajan de manera coordinada.
4214 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
4215 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
4216 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
4217 Normalmente sólo existe un @code{VerticalAlignment} por cada
4218 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
4219 @code{VerticalAxisGroup}.
4222 @node Modificación de los sellos
4223 @subsection Modificación de los sellos
4224 @translationof Modifying stencils
4226 Todos los objetos de presentación tienen una propiedad @code{stencil}
4227 que es parte del @code{grob-interface}. De forma predeterminada, esta
4228 propiedad suele estar establecida a una función específica del objeto
4229 que está hecha a medida para disponer el símbolo que lo representa en
4230 la salida. Por ejemplo, el ajuste estándar para la propiedad
4231 @code{stencil} del objeto @code{MultiMeasureRest} es
4232 @code{ly:multi-measure-rest::print}.
4234 El símbolo estándar de cualquier objeto se puede sustituir modificando
4235 la propiedad @code{stencil} para que haga referencia a un
4236 procedimiento diferente escrito especialmente. Esto requiere un alto
4237 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
4238 una forma más fácil que a menudo puede dar resultados adecuados.
4240 El procedimiento es establecer la propiedad @code{stencil} al
4241 procedimiento que imprime texto (@code{ly:text-interface::print}) y
4242 añadir una propiedad @code{text} al objeto ajustada para que contenga
4243 el texto de marcado que produce el símbolo requerido. Debido a la
4244 flexibilidad del marcado, se pueden conseguir muchas cosas; en
4245 particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
4247 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
4248 la nota a unas aspas dentro de una circunferencia.
4250 @lilypond[verbatim,quote]
4252 \once \override NoteHead.stencil = #ly:text-interface::print
4253 \once \override NoteHead.text = \markup {
4255 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
4256 \musicglyph #"noteheads.s2cross"
4264 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
4265 a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
4267 @c TODO Add inserting eps files or ref to later
4269 @c TODO Add inserting Postscript or ref to later
4272 Referencia de la notación:
4273 @ref{Notación gráfica dentro de elementos de marcado},
4274 @ref{Formatear el texto},
4275 @ref{Text markup commands},
4276 @ref{La tipografía Feta}.
4279 @node Modificación de las formas
4280 @subsection Modificación de las formas
4281 @translationof Modifying shapes
4284 * Modificación de ligaduras de unión y de expresión::
4288 @node Modificación de ligaduras de unión y de expresión
4289 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
4290 @translationof Modifying ties and slurs
4292 @cindex ligaduras de expresión, modificar
4293 @cindex ligaduras de unión, modificar
4294 @cindex Bézier, curvas de, puntos de control
4295 @cindex puntos de control en curvas de Bézier
4297 Las ligaduras de unión (@code{Tie}s), de expresión (@code{Slur}s),
4298 de fraseo (@code{PhrasingSlur}s), de dejar vibrar
4299 (@code{LaissezVibrerTie}s) y de repetición (@code{RepeatTie}s) se
4300 trazan como curvas de Bézier de tercer orden. Si la forma de la
4301 ligadura calculada automáticamente no resulta óptima, se puede
4302 modificar su forma manualmente de dos formas:
4306 mediante la especificación de los desplazamientos que se quieren
4307 realizar sobre los puntos de control de la curva de Bézier
4308 calculada automáticamente, o bien
4311 mediante la especificación explícita de las posiciones de los
4312 cuatro puntos de control que se requieren para definir la curva
4316 A continuación se explican ambos métodos. El primer método es más
4317 adecuado cuando solo se requieren ligeros ajustes de la curva; el
4318 segundo puede ser mejor para crear curvas que tienen relación con
4321 @subsubsubheading Curvas de Bézier cúbicas
4323 Las curvas Bézier de tercer orden o cúbicas están definidas por
4324 cuatro puntos de control. El primer y cuarto puntos de control
4325 son exactamente los puntos extremos de comienzo y de final de la
4326 curva. Los dos puntos de control intermedios definen la forma.
4327 Se pueden encontrar en la web animaciones que muestran cómo se
4328 traza la curva, pero la descripción siguiente puede ser de ayuda.
4329 La curva comienza a partir del primer punto de control
4330 dirigiéndose directamente hacia el segundo, curvándose
4331 progresivamente para dirigirse hacia el tercero y continuando la
4332 curva hacia el cuarto, llegando a éste en viaje directo desde el
4333 tercer punto de control. La curva está contenida enteramente
4334 dentro del cuadrilátero definido por los cuatro puntos de control.
4335 Todas las traslaciones, rotaciones y escalado de los puntos de
4336 control producen exactamente las mismas operaciones sobre la
4339 @subsubsubheading Especificar desplazamientos a partir de los puntos de control actuales
4341 @cindex conformar ligaduras
4344 En este ejemplo, la colocación automática de la ligadura no
4345 resulta óptima, y @code{\tieDown} no es la solución.
4347 @lilypond[verbatim,quote,relative=1]
4351 { r4 <g c,> <g c,> <g c,> }
4355 El ajuste de los puntos de control de la ligadura mediante la
4356 instrucción @code{\shape} permite evitar las colisiones.
4358 La sintaxis de @code{\shape} es:
4361 [-]@code{\shape} @var{desplazamientos} @var{elemento}
4364 Esta instrucción recoloca los puntos de control de @var{elemento}
4365 en las cantidades dadas por @var{desplazamientos}. El argumento
4366 @var{desplazamientos} es una lista de parejas de números o una
4367 lista de tales listas. Cada elemento de una pareja representa el
4368 desplazamiento de una de las coordenadas de un punto de control.
4369 Si el @var{elemento} es una cadena de caracteres, el resultado es
4370 @code{\once\override} para el tipo de grob especificado. Si
4371 @var{elemento} es una expresión musical, el resultado es la misma
4372 expresión musical con la consiguiente modificación aplicada.
4374 En otras palabras, la función @code{\shape} puede actuar como una
4375 instrucción @code{\once\override} o como una instrucción
4376 @code{\tweak} dependiendo de si el argumento @var{elemento} es el
4377 nombre de un grob, como @qq{Slur}, o una expresión musical, como
4378 @qq{(}. El argumento @var{desplazamientos} especifica los
4379 desplazamientos de los cuatro puntos de control como una lista de
4380 cuatro parejas de valores (dx . dy) en unidades de espacios de
4381 pentagrama (o una lista de tales listas si la curva tiene más de
4384 El guión precedente se exige si, y sólo si, se usa la forma
4387 Así, usando el mismo ejemplo de arriba y la forma
4388 @code{\once\override} de la instrucción @code{\shape}, lo
4389 siguiente tiene el efecto de elevar la ligadura de unión en la
4390 mitad de un espacio de pentagrama:
4392 @lilypond[verbatim,quote,relative=1]
4395 \shape #'((0 . 0.5) (0 . 0.5) (0 . 0.5) (0 . 0.5)) Tie
4399 { r4 <g c,> <g c,> <g c,> }
4403 Este posicionamiento de la ligadura de unión es mejor, pero quizá
4404 debería elevarse más en la parte central. El ejemplo siguiente
4405 hace esto, esta vez usando la forma alternativa @code{\tweak}:
4407 @lilypond[verbatim,quote,relative=1]
4410 e1-\shape #'((0 . 0.5) (0 . 1) (0 . 1) (0 . 0.5)) ~ e
4413 { r4 <g c,> <g c,> <g c,> }
4417 Los cambios en las posiciones horizontales de los puntos de
4418 control se pueden hacer de la misma forma, y dos curvas distintas
4419 que dan comienzo en el mismo momento musical se pueden conformar
4422 @lilypond[verbatim,quote,ragged-right,relative=2]
4424 \shape #'((0.7 . -0.4) (0.5 . -0.4) (0.3 . -0.3) (0 . -0.2)) Slur
4425 \shape #'((0 . 0) (0 . 0.5) (0 . 0.5) (0 . 0)) PhrasingSlur
4429 La función @code{\shape} también puede desplazar los puntos de
4430 control de las curvas que se extienden atravesando saltos de
4431 línea. Cada pieza de la curva dividida puede recibir su propia
4432 lista de desplazamientos. Si no se necesita hacer cambios a uno
4433 de los segmentos en particular, se puede usar una lista vacía como
4434 contenedor. En este ejemplo, el salto de línea hace que la única
4435 ligadura de expresión aparezca como si fueran dos:
4437 @lilypond[verbatim,quote,ragged-right,relative=1]
4443 Los cambios en la forma de las dos mitades de la ligadura de
4444 expresión deja más claro que la ligadura continúa más allá del
4447 @lilypond[verbatim,quote,ragged-right,relative=1]
4448 % () may be used as a shorthand for ((0 . 0) (0 . 0) (0 . 0) (0 . 0))
4449 % if any of the segments does not need to be changed
4451 (( 0 . 0) (0 . 0) (0 . 0) (0 . 1))
4452 ((0.5 . 1.5) (1 . 0) (0 . 0) (0 . -1.5))
4459 En una curva en forma de «S» siempre es necesario ajustar
4460 manualmente los puntos de control: LilyPond nunca escoge tales
4461 formas automáticamente.
4463 @lilypond[verbatim,quote,relative=2]
4464 c8( e b-> f d' a e-> g)
4465 \shape #'((0 . -1) (5.5 . -0.5) (-5.5 . -10.5) (0 . -5.5)) PhrasingSlur
4466 c8\( e b-> f d' a e-> g\)
4469 @subsubsubheading Especificar los puntos de control explícitamente
4471 Las coordenadas de los puntos de contro de Bézier se especifican
4472 en unidades de espacios de pentagrama. La coordenada@tie{}X es
4473 relativa al punto de referencia al que se adjunta la ligadura, y
4474 la coordenada@tie{}Y es relativa a la línea central del
4475 pentagrama. Las coordenadas se especifican como una lista de
4476 cuatro parejas de números decimales (reales). Un enfoque consiste
4477 en estimar las coordenadas de los dos extremos, y después adivinar
4478 los dos puntos intermedios. Los valores óptimos se encuentran
4479 después por ensayo y error. Tenga en cuenta que estos valores
4480 podrían requerir un ajuste manual si se hace posteriormente
4481 cualquier cambio manual a la música o a la disposición.
4483 Una situación en la que es preferible especificar los puntos de
4484 control explícitamente a especificar los desplazamientos es cuando
4485 se necesita especificarlos de forma relativa a una nota única. A
4486 continuación presentamos un ejemplo de esto. Muestra una forma de
4487 indicar una ligadura que se extiende hacia el interior de las
4488 casillas de primera y segunda vez de una repetición.
4490 @lilypond[verbatim,quote,relative=2]
4492 \repeat volta 3 { c4 d( e f }
4497 % create a slur and move it to a new position
4498 % the <> is just an empty chord to carry the slur termination
4499 -\tweak control-points #'((-2 . 3.8) (-1 . 3.9) (0 . 4) (1 . 3.4)) ( <> )
4504 % create a slur and move it to a new position
4505 -\tweak control-points #'((-2 . 3) (-1 . 3.1) (0 . 3.2) (1 . 2.4)) ( <> )
4512 No es posible modificar la forma de las ligaduras de unión o de
4513 expresión cambiando la propiedad @code{control-points} si hay más
4514 de una en el mismo momento musical, ni siquiera usando la
4515 instrucción @code{\tweak}. Sin embargo, se puede sobreescribir la
4516 propiedad @code{tie-configuration} de @code{TieColumn} para fijar
4517 la línea de inicio y la dirección según se requiera.
4520 Referencia de funcionamiento interno:
4521 @rinternals{TieColumn}.
4524 @node Modificación de objetos de extensión divididos
4525 @subsection Modificación de objetos de extensión divididos
4526 @translationof Modifying broken spanners
4529 * Uso de alterBroken::
4532 @node Uso de alterBroken
4533 @unnumberedsubsubsec Uso de @code{\alterBroken}
4534 @translationof Using alterBroken
4536 @cindex extensión, modificación de objetos de
4537 @cindex divididos, modificación de objetos de extensión
4538 @funindex \alterBroken
4540 Cuando un @qq{spanner} u objeto extenso atraviesa uno o varios saltos
4541 de línea, cada fragmento hereda los atributos del objeto de extensión
4542 original. Así, el trucado ordinario de un objeto dividido aplica las
4543 mismas modificaciones a todos y cada uno de sus segmentos. En el
4544 ejemplo que aparece a continuación, la sobreescritura de
4545 @code{thickness} (grosor) afecta a la ligadura a ambos lados del salto
4548 @lilypond[verbatim,quote,ragged-right,relative=2]
4550 \once\override Slur.thickness = 10
4556 Es posible modificar de forma independiente el aspecto de los
4557 fragmentos individuales de un objeto de extensión dividido, con la
4558 instrucción @code{\alterBroken}. Esta instrucción puede producir un
4559 @code{\override} o bien un @code{\tweak} de una propiedad del objeto
4562 La sintaxis de @code{\alterBroken} es
4565 [-]@code{\alterBroken} @var{propiedad} @var{valores} @var{elemento}
4568 El argumento @var{valores} es una lista de valores, uno por cada
4569 fragmento. Si @var{elemento} el el nombre de un grob como @code{Slur}
4570 o @code{Staff.PianoPedalBracket}, el resultado es una instrucción de
4571 sobreescritura @code{\override} del tipo de grob especificado. Si
4572 @var{elemento} es una expresión musical como @qq{(} o @qq{[} el
4573 resultado es la misma expresión musical con el correspondiente truco
4576 El guión inicial se debe utilizar con la forma de trucaje,
4577 @code{\tweak}. No lo escriba cuando utilice @code{\alterBroken} como
4578 una operación de sobreescritura, @code{\override}.
4580 En su uso como @code{\override}, @code{\alterBroken} puede ir
4581 precedido de @code{\once} o @code{\temporary} y ser revertido con
4582 @code{\revert} con el argumento @var{propiedad}.
4584 EL código siguiente aplica un @code{\override} independiente a cada
4585 uno de los fragmentos de la ligadura del ejemplo anterior:
4587 @lilypond[verbatim,quote,ragged-right,relative=2]
4589 \alterBroken thickness #'(10 1) Slur
4595 La instrucción @code{\alterBroken} se puede usar con cualquier objeto
4596 de extensión, incluidos @code{Tie}, @code{PhrasingSlur}, @code{Beam} y
4597 @code{TextSpanner}. Por ejemplo, un editor que está preparando una
4598 edición académica podría desear indicar la ausencia de parte de una
4599 ligadura de fraseo en una fuente haciendo discontinuo solamente el
4600 segmento que se ha añadido. El siguiente ejemplo ilustra de qué
4601 manera se puede hacer esto, en este caso usando la forma @code{\tweak}
4604 @lilypond[verbatim,quote,ragged-right,relative=2]
4605 % The empty list is conveniently used below, because it is the
4606 % default setting of dash-definition, resulting in a solid curve.
4607 c2-\alterBroken dash-definition #'(() ((0 1.0 0.4 0.75))) \(e
4612 Es importante comprender que @code{\alterBroken} fija cada pieza del
4613 objeto fragmentado al valor correspondiente dentro del argumento
4614 @var{valores}. Cuando hay menos valores que piezas, cualquier
4615 fragmento adicional recibe la asignación de la lista vacía. Esto
4616 puede conllevar resultados no deseados si la propiedad de disposición
4617 no está establecida a la lista vacía de forma predeterminada. En
4618 estos casos, se debe asignar a cada segmento un valor adecuado.
4621 Los saltos de línea pueden ocurrir en distintos lugares según cambia
4622 la disposición de la música. Los ajustes elegidos para
4623 @code{\alterBroken} podrían no ser adecuados para un objeto de
4624 extensión que ya no está dividido o que se fragmenta en más piezas que
4625 antes. El uso explícito (manual) de saltos de línea mediante
4626 @code{\break} puede prevenir situaciones como ésta.
4628 La instrucción @code{\alterBroken} no es efectiva para propiedades de
4629 los objetos extensos accedidas antes del salto de línea, como
4634 @rextend{Trucos difíciles}.
4637 @node Contenedores unpure-pure
4638 @subsection Contenedores unpure-pure
4639 @translationof Unpure-pure containers
4641 @cindex Scheme, contenedores puros
4642 @cindex Scheme, contenedores no-puros
4643 @cindex puros, contenedores de Scheme
4644 @cindex no-puros: contenedores de Scheme
4645 @cindex horizontal, sobreescribir el espaciado
4647 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para la
4648 sobreescritura de los cálculos del espaciado en el @emph{eje Y}
4649 (concretamente @code{Y-offset} e @code{Y-extent}) con una función de
4650 Scheme en lugar de un literal, es decir, un número o una pareja de
4653 Para ciertos objetos gráficos, las dimensiones @code{Y-extent} están
4654 basadas en la propiedad @code{stencil}, la sobreescritura de la
4655 propiedad de sello de éstos requiere una sobreescritura adicional de
4656 @code{Y-extent} con un contenedor unpure-pure. Cuando una función
4657 sobreescribe una dimensión @code{Y-offset} y/o @code{Y-extent} se
4658 supone que esto dispara los cálculos de los saltos de línea
4659 prematuramente durante la compilación. Así pues, la función no se
4660 evalúa en absoluto (devolviendo por lo general un valor de @samp{0} o
4661 @samp{'(0 . 0)}) lo que puede dar lugar a colisiones. Una función
4662 @q{pura} no afecta a las propiedades, objetos o suicidios de grobs, y
4663 por ello siempre ven sus valores relacionados con el eje Y evaluados
4666 Actualmente hay unas treinta funciones que ya se consideran @q{puras}
4667 y los contenedores Unpure-pure son una manera de establecer funciones
4668 que no están en esta lista como @q{puras}. La función @q{pura} se
4669 evalúa @emph{antes} de cualquier salto de línea y así el espaciado
4670 horizontal se puede ajustar @q{a tiempo}. La función @q{impura} se
4671 evalúa entonces @emph{después} del salto de línea.
4673 @warning{Dado que es difícil saber siempre qué funciones están en esta
4674 lista, recomendamos que cualquier función @q{pura} que estemos creando
4675 no utilice los grobs @code{Beam} o @code{VerticalAlignment}.}
4677 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
4679 @code{(ly:make-unpure-pure-container f0 f1)}
4681 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
4682 1}) y el primer argumento siempre debe ser el grob. Ésta es la
4683 función que da el resultado real. @var{f1} es la función que se
4684 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
4685 primer argumento debe ser siempre el grob pero los argumentos segundo
4686 y tercero son argumentos de @q{inicio} y de @q{final}.
4688 @var{inicio} y @var{final} son, a todos los efectos, valores mudos que
4689 sólo tienen importancia para los @code{objetos de extensión} (o sea:
4690 @code{Hairpin}, regulador, o @code{Beam}, barra), que pueden devolver
4691 distintas estimaciones de altura basadas en una columna de inicio y
4694 El resto son los otros argumentos para la primera función (que puede
4695 no ser ninguno si @var{n = 1}).
4697 El resultado de la segunda función se usa como una aproximación del
4698 valor necesario, que se usa entonces por la primera función para
4699 obtener el valor real que se usa a continuación para el ajuste de
4700 precisión mucho más tardío durante el proceso de espaciado.
4702 @lilypond[verbatim,quote,ragged-right]
4703 #(define (square-line-circle-space grob)
4704 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
4705 (notename (ly:pitch-notename pitch)))
4706 (if (= 0 (modulo notename 2))
4707 (make-circle-stencil 0.5 0.0 #t)
4708 (make-filled-box-stencil '(0 . 1.0)
4711 squareLineCircleSpace = {
4712 \override NoteHead.stencil = #square-line-circle-space
4715 smartSquareLineCircleSpace = {
4716 \squareLineCircleSpace
4717 \override NoteHead.Y-extent =
4718 #(ly:make-unpure-pure-container
4719 ly:grob::stencil-height
4720 (lambda (grob start end) (ly:grob::stencil-height grob)))
4723 \new Voice \with { \remove "Stem_engraver" }
4725 \squareLineCircleSpace
4727 \smartSquareLineCircleSpace
4732 En el primer compás, sin el contenedor @emph{unpure-pure}, el motor de
4733 espaciado no conoce la anchura de la cabeza de la nota y permite que
4734 colisione con las alteraciones accidentales. En el segundo compás, el
4735 motor de espaciado conoce la anchura de las cabezas de las notas y
4736 evita la colisión mediante el alargamiento de la línea en la medida
4739 Normalmente, para cálculos simples se pueden usar funciones casi
4740 idénticas tanto para las partes @q{no pura} y @q{pura}, simplemente
4741 cambiando el número de argumentos que se pasan a, y el ámbito de, la
4744 @warning{Si una función está caracterizada como @q{pura} y resulta que
4745 no lo es, el resultado puede ser inesperado.}
4748 @node Uso de las funciones musicales
4749 @section Uso de las funciones musicales
4750 @translationof Using music functions
4752 @c TODO -- add @seealso, etc. to these subsections
4754 Dondequiera que se necesite reutilizar trucos con distintas
4755 expresiones musicales, con frecuencia conviene hacer que el truco
4756 forme parte de una @emph{función musical}. En esta sección
4757 estudiaremos solamente las funciones de @emph{sustitución}, en las que
4758 el objeto es sustituir una variable dentro de un fragmento de código
4759 de entrada de LilyPond. Se describen otras funciones más complejas en
4760 @rextend{Funciones musicales}.
4763 * Sintaxis de las funciones de sustitución::
4764 * Ejemplos de funciones de sustitución::
4768 @node Sintaxis de las funciones de sustitución
4769 @subsection Sintaxis de las funciones de sustitución
4770 @translationof Substitution function syntax
4772 Es fácil hacer una función que sustituya una variable dentro de código
4773 de LilyPond. La forma general de estas funciones es
4777 #(define-music-function
4778 (parser location @var{arg1} @var{arg2} @dots{})
4779 (@var{type1?} @var{type2?} @dots{})
4781 @var{@dots{}música@dots{}}
4788 @multitable @columnfractions .33 .66
4789 @item @code{@var{argN}}
4790 @tab @var{n}-ésimo argumento
4792 @item @code{@var{typeN?}}
4793 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
4794 debe devolver @code{#t}.
4796 @item @code{@var{@dots{}música@dots{}}}
4797 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
4798 lugares en que sólo se permiten construcciones de Lilypond) o @code{#}
4799 (para usarlo como un valor de Scheme o un argumento de función musical
4800 o música dentro de listas de música) para referenciar argumentos
4801 (p.ej. @samp{#arg1}).
4804 Los argumentos @code{parser} y @code{location} son necesarios, y se
4805 utilizan en algunas situaciones avanzadas como se encuentra descrito
4806 en @rextend{Sintaxis de las funciones musicales}. Para las funciones
4807 de sustitución, tan sólo hemos de asegurarnos de incluirlos.
4809 También es necesaria la lista de predicados de tipo. Algunos de los
4810 predicados de tipo más comunes que se utilizan en las funciones
4815 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
4827 Para ver una lista de los predicados de tipo disponibles, consulte
4828 @ref{Predicados de tipo predefinidos}. También se permiten los
4829 predicados de tipo definidos por el usuario.
4832 Referencia de la notación:
4833 @ref{Predicados de tipo predefinidos}.
4835 Expansión de LilyPond:
4836 @rextend{Sintaxis de las funciones musicales}.
4838 Archivos instalados:
4839 @file{lily/music-scheme.cc},
4841 @file{scm/lily.scm}.
4844 @node Ejemplos de funciones de sustitución
4845 @subsection Ejemplos de funciones de sustitución
4846 @translationof Substitution function examples
4848 Esta sección presenta algunos ejemplos de funciones de sustitución.
4849 No pretenden ser exhaustivas, sino demostrar algunas de las
4850 posibilidades de las funciones de sustitución sencillas.
4852 En el primer ejemplo se define una función que simplifica el ajuste
4853 del relleno de un elemento de inscripción de texto TextScript:
4855 @lilypond[quote,verbatim,ragged-right]
4857 #(define-music-function
4858 (parser location padding)
4861 \once \override TextScript.padding = #padding
4865 c4^"piu mosso" b a b
4867 c4^"piu mosso" b a b
4869 c4^"piu mosso" b a b
4873 Además de números, podemos usar expresiones musicales, como notas,
4874 para los argumentos de las funciones musicales:
4876 @lilypond[quote,verbatim,ragged-right]
4878 #(define-music-function
4879 (parser location note)
4882 \tweak NoteHead.stencil #ly:text-interface::print
4883 \tweak NoteHead.text
4884 \markup \musicglyph #"custodes.mensural.u0"
4885 \tweak Stem.stencil ##f
4889 \relative c' { c4 d e f \custosNote g }
4892 Se pueden definir funciones de sustitución con más de un argumento:
4894 @lilypond[quote,verbatim,ragged-right]
4896 #(define-music-function
4897 (parser location padding tempotext)
4900 \once \override Score.MetronomeMark.padding = #padding
4901 \tempo \markup { \bold #tempotext }
4905 \tempo \markup { "Low tempo" }
4907 \tempoPadded #4.0 "High tempo"
4912 @c TODO: add appropriate @@ref's here.