1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 30f7edc4605e38b5735676d2874fc7be6f325267
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. Se ignoran las alturas
212 de las notas; las notas se imprimen sobre una línea.
214 @strong{@emph{TabStaff}}
216 Contexto para generar tablaturas. De forma predeterminada dispone la
217 expresión musical como una tablatura de guitarra, impresa sobre seis
220 @strong{@emph{DrumStaff}}
222 Maneja el tipografiado para instrumentos de percusión. Puede contener
223 contextos @code{DrumVoice}.
225 @strong{@emph{VaticanaStaff}}
227 Igual que @code{Staff}, excepto que está pensado para tipografiar
228 piezas en estilo gregoriano.
230 @strong{@emph{MensuralStaff}}
232 Igual que @code{Staff}, excepto que está diseñado para tipografiar
233 piezas en estilo mensural.
236 @node Contextos del nivel más bajo. Voces
237 @unnumberedsubsubsec Contextos del nivel más bajo. Voces
238 @translationof Bottom-level contexts - voices
240 Los contextos del mismo nivel que Voice dan un valor inicial a
241 ciertas propiedades e inician los grabadores correspondientes. Un
242 contexto del nivel más bajo es aquel que no tiene un contexto
243 descendiente predeterminado @code{defaultchild}. Aunque es
244 posible hacer que pueda aceptar o contener subcontextos, éstos
245 solo se pueden crear e introducir de forma explícita.
247 @strong{@emph{Voice}}
249 Corresponde a una voz sobre un pentagrama. este contexto maneja la
250 conversión de las indicaciones dinámicas, plicas, barras, subíndices y
251 superíndices, ligaduras de expresión y de unión, y silencios. Tenemos
252 que crear instancias explícitas de este contexto si necesitamos varias
253 voces en el mismo pentagrama.
255 @strong{@emph{VaticanaVoice}}
257 Lo mismo que @code{Voice}, excepto que está diseñado para tipografiar
258 piezas en estilo gregoriano.
260 @strong{@emph{MensuralVoice}}
262 Lo mismo que @code{Voice}, con modificaciones para el tipografiado de
263 piezas en estilo mensural.
265 @strong{@emph{Lyrics}}
267 Corresponde a una voz con letra. Maneja la impresión de una sola
270 @strong{@emph{DrumVoice}}
272 El contexto de voz utilizado en una pauta de percusión.
274 @strong{@emph{FiguredBass}}
276 El contexto en que los objetos @code{BassFigure} se crean a partir de
277 la entrada escrita en el modo @code{\figuremode}.
279 @strong{@emph{TabVoice}}
281 El contexto de voz utilizado dentro de un contexto @code{TabStaff}.
282 Se suele dejar que se cree implícitamente.
284 @strong{@emph{CueVoice}}
286 El contexto de voz que se utiliza para dibujar notas de tamaño
287 reducido, con el principal objetivo de añadir notas guía de un
288 pentagrama a otro, véase @ref{Formateo de las notas guía}.
289 Normalmente se deja que se cree implícitamente.
291 @strong{@emph{ChordNames}}
293 Tipografía nombres de acordes.
296 @node Crear y referenciar contextos
297 @subsection Crear y referenciar contextos
298 @translationof Creating and referencing contexts
302 @cindex nuevos contextos
303 @cindex contextos, creación y referenciación de
304 @cindex referenciar contextos
306 LilyPond crea automáticamente contextos de nifel inferior si se
307 encuentra una expresión musical antes de que exista un contexto
308 adecuado, pero normalmente esto sólo funciona bien para partituras
309 sencillas o fragmentos musicales como los que aparecen en la
310 documentación. Para partituras más complejas, se recomienda
311 especificar explícitamente todos los contextos con las
312 instrucciones @code{\new} o @code{\context}. La sintaxis de estas
313 dos instrucciones es muy similar:
316 [\new | \context] @var{Contexto} [ = @var{nombre}] [@var{expresión_musical}]
320 donde se puede especificar @code{\new} o @code{\context}.
321 @var{Contexto} es el tipo de contexto que se desea crear,
322 @var{nombre} es un nombre opcional que se da al contexto concreto
323 que se está creando, y @var{expresión_musical} es una sola
324 expresión musical que será interpretada por los complementos
325 grabadores y reproductores dentro de este contexto.
327 El prefijo @code{\new} sin ningún nombre se usa con frecuencia
328 para crear partituras con muchos pentagramas:
330 @lilypond[quote,verbatim,relative=2]
333 % leave the Voice context to be created implicitly
343 y para introducir varias voces dentro de un solo pentagrama:
345 @lilypond[quote,verbatim,relative=2]
361 @code{\new} debería usarse siempre para especificar contextos sin
364 La diferencia entre @code{\new} y @code{\context} se encuentra en
365 la acción que se realiza:
369 @code{\new} con un nombre o sin él, siempre crea un contexto nuevo
370 y distinto, incluso si ya existe un contexto con el mismo nombre:
372 @lilypond[quote,verbatim,relative=2]
388 @code{\context} con un nombre especificado, crea un contexto nuevo
389 solamente si no existe ya un contexto del mismo tipo y con el
390 mismo nombre, dentro de la misma jerarquía de contextos. En caso
391 contrario, se toma como referencia a dicho contexto creado
392 previamente, y su expresión musical se pasa a este contexto para
395 Una aplicación de los contextos con nombre es la separación entre
396 la disposición de la partitura y el contenido musical. Son
397 válidas culaquiera de las dos formas siguientes:
399 @lilypond[quote,verbatim]
413 \context Voice = "one" {
418 \context Voice = "two" {
427 @lilypond[quote,verbatim]
432 \context Voice = "one" {
435 \context Voice = "two" {
441 \context Voice = "one" {
446 \context Voice = "two" {
456 De manera alternativa, se pueden utilizar variables con un efecto
457 similar. Véase @rlearning{Organizar las piezas mediante variables}.
460 @code{\context} sin ningún nombre corresponderá con el primer
461 contexto que se encuentre entre los creados previamente que sean
462 del mismo tipo dentro de la misma jerarquía de contextos, incluso
463 si tiene nombre, y su expresión musical se pasará a dicho contexto
464 para su interpretación. Esta forma rara vez es útil. Sin
465 embargo, @code{\context} sin nombre y sin expresión musical se usa
466 para establecer el contexto en que se ejecuta un procedimiento de
467 Scheme especificado con @code{\applyContext}:
470 \new Staff \relative c' @{
473 \applyContext #(lambda (ctx)
475 (display (ly:context-current-moment ctx)))
482 Un contexto debe tener un nombre si se va a hacer referencia a él
483 más tarde, por ejemplo cuando se asocia la letra con la música:
486 \new Voice = "tenor" @var{música}
488 \new Lyrics \lyricsto "tenor" @var{letra}
492 Para ver más detalles sobre la asociación de letra y música,
493 consulte @ref{Duración automática de las sílabas}.
495 Las propiedades de todos los contextos de un tipo en particular se
496 pueden modificar dentro de un bloque @code{\layout} (con una
497 sintaxis diferente), véase @ref{Cambiar todos los contextos del mismo tipo}.
499 Esta construcción también ofrece una forma de mantener las
500 instrucciones de disposición separadas del contenido musical. Si
501 se va a modificar un solo contexto, debe usarse un bloque
502 @code{\with}, véase @ref{Cambiar solamente un contexto determinado}.
505 Manual de aprendizaje:
506 @rlearning{Organizar las piezas mediante variables}.
508 Referencia de la notación:
509 @ref{Cambiar solamente un contexto determinado},
510 @ref{Duración automática de las sílabas}.
513 @node Mantener vivos los contextos
514 @subsection Mantener vivos los contextos
515 @translationof Keeping contexts alive
517 @cindex contextos, mantener vivos
518 @cindex contextos, tiempo de vida
520 Normalmente los contextos finalizan en el primer momento musical en
521 que no tienen nada que hacer. Así, los contextos de @code{Voice}
522 mueren tan pronto como ya no contienen ningún evento; los contextos de
523 @code{Staff} mueren tan pronto como todos los contextos de
524 @code{Voice} que contenían ya no contengan ningún evento; etc. Esto
525 puede ocasionar dificultades si se tiene que hacer referencia a
526 contextos anteriores que ya han muerto, por ejemplo, al cambiar de
527 pentagramas con instrucciones @code{\change}, asociar letra con una
528 voz mediante instrucciones @code{\lyricsto}, o cuando se añaden
529 eventos musicales adicionales a un contexto anterior.
531 Existe una excepción a esta regla general: precisamente uno de los
532 contextos de @code{Voice} que están dentro de un contexto de
533 @code{Staff} o de una construcción @code{<<@dots{}>>} persiste siempre
534 hasta el final de, contexto de @code{Staff} circundante o la
535 construcción @code{<<@dots{}>>}, incluso aunque puede haber períodos en
536 que no tiene nada que hacer. El contexto que persiste de esta forma
537 será el primero que se encuentre en la primera construcción encerrada
538 entre llaves @code{@{@dots{}@}}, ignorando cualquiera que se encuentre
539 dentro de construcciones encerradas por ángulos dobles @code{<<@dots{}>>}.
541 Cualquier contexto se puede mantener vivo si nos aseguramos de que
542 tiene algo que hacer en cualquier momento musical dado. Los
543 contextos de @code{Staff} se mantienen con vida si nos aseguramos de
544 que una de sus voces se mantiene viva. Una manera de hacerlo es
545 añadir silencios de separación a una voz en paralelo con la música
546 real. Éstos deben añadirse a todos y cada uno de los contextos de
547 @code{Voice} que se hayan de mantener vivos. Si se van a usar
548 esporádicamente varias voces, es más seguro mantenerlas todas vivas en
549 lugar de tratar de confiar en las excepciones que hemos mencionado
552 En el ejemplo siguiente, tanto la voz A como la voz B se mantienen
553 vivas de esta manera durante la duración de la pieza:
555 @lilypond[quote,verbatim]
556 musicA = \relative c'' { d4 d d d }
557 musicB = \relative c'' { g4 g g g }
560 \new Voice = "A" { s1*5 } % Keep Voice "A" alive for 5 bars
561 \new Voice = "B" { s1*5 } % Keep Voice "B" alive for 5 bars
566 \context Voice = "A" {
570 \context Voice = "B" {
574 \context Voice = "A" { \musicA }
575 \context Voice = "B" { \musicB }
576 \context Voice = "A" { \musicA }
587 @cindex letra, alineación con melodía esporádica
589 El ejemplo siguiente muestra cómo se puede escribir una línea melódica
590 esporádica con letra utilizando este enfoque. Por supuesto, en una
591 situación real la melodía y el acompañamiento consistirían en varias
592 secciones diferentes.
594 @lilypond[quote,verbatim]
595 melody = \relative c'' { a4 a a a }
596 accompaniment = \relative c' { d4 d d d }
597 words = \lyricmode { These words fol -- low the mel -- o -- dy }
600 \new Staff = "music" {
602 \new Voice = "melody" {
604 s1*4 % Keep Voice "melody" alive for 4 bars
607 \new Voice = "accompaniment" {
612 \context Voice = "melody" { \melody }
613 \context Voice = "accompaniment" { \accompaniment }
615 \context Voice = "accompaniment" { \accompaniment }
617 \context Voice = "melody" { \melody }
618 \context Voice = "accompaniment" { \accompaniment }
623 \new Lyrics \with { alignAboveContext = #"music" }
624 \lyricsto "melody" { \words }
629 Una forma alternativa, que podría resultar mejor en muchas
630 situaciones, es mantener con vida la línea melódica simplemente
631 incluyendo notas espaciadoras para alinearla correctamente con el
634 @lilypond[quote,verbatim]
635 melody = \relative c'' {
641 accompaniment = \relative c' {
647 words = \lyricmode { These words fol -- low the mel -- o -- dy }
651 \new Staff = "music" {
653 \new Voice = "melody" {
657 \new Voice = "accompaniment" {
663 \new Lyrics \with { alignAboveContext = #"music" }
664 \lyricsto "melody" { \words }
670 @node Modificar los complementos (plug-ins) de contexto
671 @subsection Modificar los complementos (plug-ins) de contexto
672 @translationof Modifying context plug-ins
674 @c TODO Should this be Modifying engravers or Modifying contexts?
676 Los contextos de notación (como @code{Score} y @code{Staff}) no sólo
677 almacenan propiedades, también contienen «plug-ins» o complementos
678 llamados @q{grabadores} que crean elementos de notación. Por ejemplo,
679 el contexto @code{Voice} contiene un grabador
680 @code{Note_heads_engraver} que crea las cabezas de nota y el contexto
681 @code{Staff} contiene un grabador @code{Key_engraver} que
684 Para ver una descripción completa de todos y cada uno de los
685 complementos, consulte
687 @rinternals{Engravers and Performers}.
690 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Grabadores.
692 Cada contexto que se describe en
694 @rinternals{Contexts}
697 Referencia de funcionamiento interno @expansion{} Traducción @expansion{} Contexto.
699 relaciona los grabadores que se usan para ese contexto.
702 Puede ser de utilidad jugar un poco con estos complementos. Se hace
703 iniciando un contexto nuevo con @code{\new} o @code{\context} y
709 \new @var{contexto} \with @{
717 @emph{@dots{}música@dots{}}
722 donde los @dots{} deben ser el nombre de un grabador. Aquí tenemos un
723 ejemplo sencillo que suprime los grabadores
724 @code{Time_signature_engraver} y @code{Clef_engraver} de un contexto
727 @lilypond[quote,relative=1,verbatim]
733 \remove "Time_signature_engraver"
734 \remove "Clef_engraver"
741 En el segundo pentagrama no hay indicación de compás ni clave. Éste
742 es un método bastante rudimentario de hacer que desaparezcan los
743 objetos porque afecta a todo el pentagrama. Este método también
744 afecta al espaciado, lo que puede ser deseable o no serlo. Se
745 muestran métodos más sofisticados para quitar objetos en
746 @rlearning{Visibilidad y color de los objetos}.
748 El ejemplo siguiente muestra una aplicación práctica. Normalmente las
749 líneas divisorias y las indicaciones de compás están sincronizadas a
750 lo largo de toda la partitura. Lo hacen los grabadores
751 @code{Timing_translator} y @code{Default_bar_line_engraver}. Estos
752 complementos mantienen al día la administración de las indicaciones de
753 compás, posición dentro del compás, etc. Moviendo estos grabadores
754 desde el contexto de @code{Score} al de @code{Staff}, podemos
755 conseguir una partitura en la que cada pentagrama tiene su propio
756 compás independiente.
758 @cindex polimétricas, partituras
759 @cindex compases distintos al mismo tiempo
761 @lilypond[quote,verbatim]
765 \consists "Timing_translator"
766 \consists "Default_bar_line_engraver"
773 \consists "Timing_translator"
774 \consists "Default_bar_line_engraver"
784 \remove "Timing_translator"
785 \remove "Default_bar_line_engraver"
793 El orden en que los grabadores se especifican es el orden en que se
794 llaman para realizar su tarea de procesamiento. Normalmente, el orden
795 en que se especifican los grabadores no tiene importancia, pero en
796 algunos casos especiales sí la tiene, por ejemplo donde un grabador
797 escribe una propiedad y otro la lee, o donde un grabador crea un groby
798 otro debe procesarlo.
800 Las siguientes ordenaciones son importantes:
804 el grabador de compases @code{Bar_engraver} debe ir normalmente en
808 el grabador de digitaciones @code{New_fingering_engraver} debe ir
809 antes del grabador @code{Script_column_engraver} de columnas de
813 el @code{Timing_translator} debe ir antes del grabador de números de
814 compás @code{Bar_number_engraver}.
820 @file{ly/engraver-init.ly}.
823 @node Cambiar los valores por omisión de los contextos
824 @subsection Cambiar los valores por omisión de los contextos
825 @translationof Changing context default settings
827 @cindex predeterminadas, cambio de propiedades de contexto
828 @cindex contexto, cambiar propiedades predeterminadas de
830 Se pueden cambiar las propiedades de contexto y de grob con las
831 instrucciones @code{\set} y @code{\override}, tal y como se describe
832 en @ref{Modificar las propiedades}. Estas instrucciones crean eventos
833 musicales, haciendo que los cambios tengan efecto en el punto temporal
834 en que la música se está procesando.
836 Por contra, esta sección explica la forma de cambiarlos valores
837 @emph{predeterminados} de las propiedades de contexto y de grob en el
838 momento en que se crea el contexto. Existen dos formas de hacerlo.
839 Una modifica los valores predeterminados en todos los contextos de un
840 tipo dado, y el otro modifica los valores predeterminados solamente en
841 una instancia concreta de un contexto.
844 * Cambiar todos los contextos del mismo tipo::
845 * Cambiar solamente un contexto determinado::
846 * Orden de precedencia::
849 @node Cambiar todos los contextos del mismo tipo
850 @unnumberedsubsubsec Cambiar todos los contextos del mismo tipo
851 @translationof Changing all contexts of the same type
853 @cindex \context dentro de un bloque \layout
857 Los ajustes de contexto predeterminados que se han de usar para la composición
858 tipográfica dentro de @code{Score}, @code{Staff}, @code{Voice} y otros contextos
859 se pueden especificar en un bloque @code{\context} dentro de cualquier
860 bloque @code{\layout}.
862 Los ajustes para la salida MIDI, al contrario que para la
863 composición tipográfica, se tendrán que especificar aparte en
864 bloques @code{\midi} (véase
865 @ref{Definiciones de salida - estructura de los contextos}).
867 El bloque @code{\layout} se debe colocar
868 dentro del bloque @code{\score} al que se aplica, después de la
875 [ajustes de contexto para todos los contextos Voice]
879 [ajustes de contexto para todos los contextos Staff]
884 Se pueden especificar los siguientes tipos de ajustes:
888 Una instrucción @code{\override}, pero omitiendo el nombre del contexto
890 @lilypond[quote,verbatim]
893 a4^"Thicker stems" a a a
899 \override Stem.thickness = #4.0
906 Estableciendo una propiedad de contexto directamente
908 @lilypond[quote,verbatim]
911 a4^"Smaller font" a a a
924 Una instrucción predefinida tal como @code{\dynamicUp} o una expresión
925 musical como @code{\accidentalStyle dodecaphonic}
927 @lilypond[quote,verbatim]
930 a4^"Dynamics above" a a a
940 \accidentalStyle dodecaphonic
947 Una variable definida por el usuario que contenga un bloque
948 @code{\with}; para ver detalles acerca del bloque @code{\with},
949 consulte @ref{Cambiar solamente un contexto determinado}.
951 @lilypond[quote,verbatim]
952 StaffDefaults = \with {
959 a4^"Smaller font" a a a
974 Las instrucciones de ajuste de propiedades se pueden disponer dentro
975 de un bloque @code{\layout} sin que estén encerradas en un bloque
976 @code{\context}. Tales ajustes son equivalentes a incluir las mismas
977 instrucciones de ajuste de propiedades al comienzo de cada uno de los
978 contextos del tipo especificado. Si no se especifica ningún contexto,
979 @emph{todos y cada uno} de los contextos del nivel inferior quedan
980 afectados, véase @ref{Contextos del nivel más bajo. Voces}. La
981 sintaxis de una instrucción de ajuste de propiedades dentro de un
982 bloque @code{\layout} es la misma que si la misma instrucción
983 estuviera escrita en el propio flujo musical.
985 @lilypond[quote,verbatim]
989 a4^"Smaller font" a a a
994 \accidentalStyle dodecaphonic
996 \override Voice.Stem.thickness = #4.0
1002 @node Cambiar solamente un contexto determinado
1003 @unnumberedsubsubsec Cambiar solamente un contexto determinado
1004 @translationof Changing just one specific context
1009 Las propiedades de contexto de una única instancia de contexto pueden
1010 cambiarse dentro de un bloque @code{\with}. Todas las demás
1011 instancias de contexto del mismo tipo retienen los ajustes
1012 predeterminados que LilyPond tiene programados y que se modifican por
1013 parte de cualquier bloque @code{\layout} que se encuentre dentro del
1014 ámbito. El bloque @code{\with} se debe situar inmediatamente después
1015 de las instrucciones @code{\new} @var{context-type}:
1018 \new Staff \with @{ [ajustes de contexto para esta instancia de contexto solamente] @}
1024 Dado que dicha @q{modificación de contexto} está especificada
1025 dentro de la música, afectará a @emph{todas} las salidas
1026 (tipografía @emph{y también} el MIDI), a diferencia de los cambios
1027 que se hacen dentro de una definición de salida.
1029 Se pueden especificar los siguientes tipos de ajustes:
1033 Una instrucción @code{\override}, pero omitiendo el nombre del
1036 @lilypond[quote,verbatim]
1039 \new Voice \with { \override Stem.thickness = #4.0 }
1042 a4^"Thick stems" a a a
1051 Estableciendo una propiedad de contexto directamente
1053 @lilypond[quote,verbatim]
1058 a4^"Default font" a a a
1062 \new Staff \with { fontSize = #-4 }
1065 a4^"Smaller font" a a a
1074 Una instrucción predefinida tal como @code{\dynamicUp}
1076 @lilypond[quote,verbatim]
1082 a4^"Dynamics below" a a a
1087 \new Staff \with { \accidentalStyle dodecaphonic }
1089 \new Voice \with { \dynamicUp }
1092 a4^"Dynamics above" a a a
1103 @node Orden de precedencia
1104 @unnumberedsubsubsec Orden de precedencia
1105 @translationof Order of precedence
1107 El valor de una propiedad que se aplica en un momento determinado se
1108 determina de la siguiente forma:
1112 si está en efecto una instrucción @code{\override} o @code{\set}
1113 dentro del flujo musical, se usa dicho valor,
1116 de lo contrario, se usa el valor predeterminado tomado de un enunciado
1117 @code{\with} en las instrucciones de inicio del contexto,
1120 de lo contrario, se usa el valor tomado del bloque @code{\context} más
1121 reciente que corresponda dentro de los bloques @code{\layout} o @code{\midi},
1124 de lo contrario se usa el valor predeterminado que LilyPond lleva
1129 Manual de aprendizaje:
1130 @rlearning{Modificar las propiedades de los contextos}.
1132 Referencia de la notación:
1133 @ref{Explicación de los contextos},
1134 @ref{Contextos del nivel más bajo. Voces},
1135 @ref{La instrucción set},
1136 @ref{La instrucción override},
1137 @ref{El bloque \layout}.
1140 @node Definir contextos nuevos
1141 @subsection Definir contextos nuevos
1142 @translationof Defining new contexts
1144 @cindex contextos, definición de nuevos
1145 @cindex grabadores, incluir en contextos
1160 Los contextos específicos, como @code{Staff} y @code{Voice}, están
1161 construidos a partir de bloques sencillos. Es posible crear nuevos
1162 tipos de contextos con combinaciones distintas de añadidos grabadores.
1164 El siguiente ejemplo muestra cómo construir un tipo diferente de
1165 contexto de @code{Voice} partiendo de cero. Será parecido a
1166 @code{Voice}, pero imprime solamente cabezas centradas en forma de
1167 barra inclinada. Se puede usar para indicar improvisación en piezas
1170 @lilypond[quote,ragged-right]
1171 \layout { \context {
1173 \type "Engraver_group"
1174 \consists "Note_heads_engraver"
1175 \consists "Rhythmic_column_engraver"
1176 \consists "Text_engraver"
1177 \consists "Pitch_squash_engraver"
1178 squashedPosition = #0
1179 \override NoteHead.style = #'slash
1180 \override Stem.transparent = ##t
1184 \accepts "ImproVoice"
1188 a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
1189 c4 c^"undress" c_"while playing :)" c }
1195 Estos ajustes se definen dentro de un bloque @code{\context} que a su
1196 vez está dentro de un bloque @code{\layout},
1206 En el siguiente análisis, la entrada de ejemplo que se muestra debe ir
1207 en el lugar de los puntos suspensivos @dots{} del fragmento anterior.
1209 En primer lugar es necesario definir un nombre para el nuevo contexto:
1215 Debido a que es parecido al contexto @code{Voice}, queremos
1216 órdenes que funcionen dentro de los contextos @code{Voice}
1217 (existentes) para que siga funcionando. Esto se consigue dando al
1218 contexto nuevo un alias de @code{Voice},
1224 El contexto imprimirá notas y textos explicativos, por ello
1225 tenemos que añadir los grabadores que aportan esta funcionalidad,
1226 y además el grabador que agrupa las notas, plicas y silencios que
1227 están en el mismo momento musical en forma de columnas,
1230 \consists "Note_heads_engraver"
1231 \consists "Text_engraver"
1232 \consists "Rhythmic_column_engraver"
1235 Las cabezas de todas las notas se deben situar sobre la línea
1239 \consists "Pitch_squash_engraver"
1240 squashedPosition = #0
1243 El grabador @code{Pitch_squash_engraver} modifica las cabezas de
1244 nota (creadas por el grabador @code{Note_heads_engraver}) y
1245 establece sus posiciones verticales al valor de
1246 @code{squashedPosition}, en este caso@tie{}@code{0}, la línea
1249 Las notas parecen barras inclinadas y no tienen plica:
1252 \override NoteHead.style = #'slash
1253 \override Stem.transparent = ##t
1256 Todos estos complementos o plug-ins tienen que comunicarse bajo el
1257 control del contexto. Los mecanismos con el que se comunican los
1258 contextos se establecen mediante la declaración del @code{\type}
1259 (tipo) del contexto. Dentro de un bloque @code{\layout}, casi
1260 todos los contextos serán del tipo @code{Engraver_group}. Algunos
1261 contextos especiales y los contextos de los bloques @code{\midi}
1262 usan otros tipos. La copia y la modificación de una definición de
1263 contexto existente también cumplimentan el tipo. Como este
1264 ejemplo crea una definición partiendo de cero, tiene que ser
1265 especificada explícitamente.
1268 \type "Engraver_group"
1271 Al juntarlo todo, obtenemos
1276 \type "Engraver_group"
1277 \consists "Note_heads_engraver"
1278 \consists "Text_engraver"
1279 \consists "Rhythmic_column_engraver"
1280 \consists "Pitch_squash_engraver"
1281 squashedPosition = #0
1282 \override NoteHead.style = #'slash
1283 \override Stem.transparent = ##t
1289 Los contextos dan lugar a jerarquías. Queremos poner el contexto
1290 @code{ImproVoice} dentro del contexto @code{Staff}, igual que los contextos
1291 de voz normales. Por tanto, modificamos la definición de
1292 @code{Staff} con la instrucción @code{\accepts} (acepta),
1302 Lo opuesto a @code{\accepts} (acepta) es @code{\denies} (deniega), lo
1303 que a veces se necesita cuando se están reutilizando definiciones de
1304 contexto existentes.
1306 Ponemos ambos dentro de un bloque @code{\layout}, como
1316 \accepts "ImproVoice"
1321 Así pues, la salida que aparece al comienzo de esta sub-sección se
1330 c c_"mientras tocas :)"
1336 Para completar el ejemplo, los cambios que afectan a la jerarquía
1337 de contextos se deben repetir dentro de un bloque @code{\midi} de
1338 manera que la salida MIDI dependa de las mismas relaciones de
1343 Referencia de funcionamiento interno:
1344 @rinternals{Engraver_group},
1345 @rinternals{Note_heads_engraver},
1346 @rinternals{Text_engraver},
1347 @rinternals{Rhythmic_column_engraver},
1348 @rinternals{Pitch_squash_engraver}.
1351 @node Orden de disposición de los contextos
1352 @subsection Orden de disposición de los contextos
1353 @translationof Context layout order
1355 @cindex contextos, orden de disposición
1359 Los contextos se disponen en un sistema normalmente desde arriba hacia
1360 abajo en el orden en que se encuentran en el archivo de entrada.
1361 Cuando los contextos se anidan unos dentro de otros, el contexto
1362 exterior incluye a los contextos anidados tal y como se especifica en
1363 el archivo de entrada, siempre y cuando los contextos interiores estén
1364 incluidos en la lista @qq{accepts} del contexto externo. Los
1365 contextos anidados que no está nincluidos en la lista @qq{accepts} del
1366 contexto externo se recolocan debajo del contexto externo en lugar de
1367 anidarse dentro de él.
1369 La lista @qq{accepts} de un contexto se puede cambiar con las
1370 instrucciones @code{\accepts} (acepta) y @code{\denies} (niega).
1371 @code{\accepts} añade un contexto a la lista @qq{accepts} y
1372 @code{\denies} elimina un contexto de la lista. Por ejemplo,
1373 normalmente no sería deseable que los acordes de cifrado americano
1374 estuvieran anidados dentro de un contexto @code{Staff}, por lo que el
1375 contexto @code{ChordNames} no se incluye de forma predeterminada
1376 dentro de la lista @qq{accepts} del contexto @code{Staff}, pero podría
1377 hacerse si fuera necesario:
1379 @lilypond[verbatim,quote]
1383 \chords { d1:m7 b1:min7.5- }
1388 @lilypond[verbatim,quote]
1392 \chords { d1:m7 b1:min7.5- }
1397 \accepts "ChordNames"
1403 @code{\denies} se usa principalmente cuando un contexto nuevo se está
1404 basando en otro, pero los anidamientos requeridos difieren. Por
1405 ejemplo, el contexto @code{VaticanaStaff} está basado en el contexto
1406 @code{Staff}, pero con el contexto @code{VaticanaVoice} sustituido por
1407 el contexto @code{Voice} en la lista @qq{accepts}.
1410 @cindex contextos implícitos
1411 @cindex implícitos, contextos
1412 @funindex \defaultchild
1414 Observe que discretamente se crea un contexto de forma implícita
1415 si se encuentra una instrucción donde no hay un contexto apropiado
1418 Dentro de una definición de contexto, el tipo de un subcontexto
1419 que se va a crear implícitamente se especifica usando
1420 @code{\defaultchild} (hijo predeterminado). Algunos eventos
1421 musicales requieren un contexto @samp{Bottom} (inferior): cuando
1422 se encuentra este evento, se crean subcontextos de forma recursiva
1423 hasta que se alcanza un contexto que no tiene establecido el
1424 @samp{defaultchild}.
1426 La creación implícita de contextos puede dar lugar a pentagramas o
1427 partituras nuevos no esperados. La utilización de @code{\new}
1428 para crear contextos explícitamente evita esos problemas.
1430 @cindex alignAboveContext
1431 @cindex alignBelowContext
1432 @funindex alignAboveContext
1433 @funindex alignBelowContext
1435 En ocasiones se necesita que un contexto exista durante un breve
1436 intervalo de tiempo, siendo un buen ejemplo el contexto de
1437 pentagrama de un ossia. Esto se consigue normalmente mediante la
1438 introducción de la definición del contexto en el lugar apropiado
1439 en paralelo con la sección correspondiente de la música principal.
1440 De forma predeterminada, el contexto tempral se coloca debajo de
1441 todos los contextos existentes. Para reposicionarlo por encima
1442 del contexto que tenga el nombre @qq{principal}, debería definirse
1446 @code{\new Staff \with @{ alignAboveContext = #"principal" @} }
1449 Se presenta una situación similar cuando se posiciona un contexto
1450 temporal de letra de una canción dentro de una disposición de varios
1451 pentagramas tal como @code{ChoirStaff}, por ejemplo, cuando se añade
1452 una segunda estrofa a una sección que se repite. De forma
1453 predeterminada, el contexto temporal de letra se coloca debajo de los
1454 pentagramas inferiores. Mediante la definición del contexto temporal
1455 de letra con @code{alignBelowContext} se puede posicionar
1456 correctamente debajo del contexto de letra con nombre que contiene el
1457 texto de la primera estrofa.
1459 En diversos lugares pueden verse ejemplos que muestran esta
1460 recolocación de contextos temporales: véase
1461 @rlearning{Anidado de expresiones musicales},
1462 @ref{Modificación de pentagramas sueltos} y
1463 @ref{Técnicas específicas para la letra}.
1466 Manual de aprendizaje:
1467 @rlearning{Anidado de expresiones musicales}.
1469 Referencia de la notación:
1470 @ref{Modificación de pentagramas sueltos},
1471 @ref{Técnicas específicas para la letra}.
1473 Manual de utilización del programa:
1474 @rprogram{Aparece un pentagrama de más}.
1476 Archivos instalados:
1477 @file{ly/engraver-init.ly}.
1480 @node Explicación del Manual de referencia de funcionamiento interno
1481 @section Explicación del Manual de referencia de funcionamiento interno
1482 @translationof Explaining the Internals Reference
1485 * Navegar por la referencia del programa::
1486 * Interfaces de la presentación::
1487 * Determinar la propiedad del grob::
1488 * Convenciones de nombres::
1493 @node Navegar por la referencia del programa
1494 @subsection Navegar por la referencia del programa
1495 @translationof Navigating the program reference
1497 Supongamos que queremos mover la indicación de digitación del
1498 fragmento siguiente:
1500 @lilypond[quote,relative=2,verbatim]
1506 Si hace una visita a la documentación en busca de instrucciones de
1507 digitación (en @ref{Indicaciones de digitación}), encontrará:
1510 @strong{Véase también}
1512 Referencia de funcionamiento interno: @rinternals{Fingering}.
1517 La referencia del programador se encuentra disponible en forma de
1518 documento HTML. Se recomienda mucho que lo lea en la forma HTML, bien
1519 en línea o bien descargando los archivos de la documentación HTML.
1520 Esta sección sería mucho más difícil de entender si está utilizando el
1521 manual en formato PDF.
1524 Siga el enlace que lleva a @rinternals{Fingering}. Al principio de la
1528 Los objetos de digitación se crean por parte de:
1529 @rinternals{Fingering_engraver} y @rinternals{New_fingering_engraver}.
1532 Siguiendo los enlaces relacionados dentro de la referencia del
1533 programa, podemos seguir el flujo de información dentro del programa:
1537 @item @rinternals{Fingering}:
1538 los objetos @rinternals{Fingering} se crean por parte de:
1539 @rinternals{Fingering_engraver}
1541 @item @rinternals{Fingering_engraver}:
1542 Tipos de música aceptados: @rinternals{fingering-event}
1544 @item @rinternals{fingering-event}:
1545 El tipo de evento musical @code{fingering-event} está descrito en
1546 Expresiones musicales con el nombre de @rinternals{FingeringEvent}
1549 Este camino se recorre en contra de la corriente de información del
1550 programa: comienza por la salida y acaba en el evento de entrada.
1551 También podríamos haber empezado por un evento de la entrada, y leído
1552 siguiendo el flujo de información terminando en su caso en el objeto
1553 (u objetos) de la salida.
1555 La referencia del programa también se puede examinar como un documento
1556 normal. Contiene capítulos que tratan de
1558 @rinternals{Music definitions},
1561 @code{Music definitions}
1563 de la @rinternals{Translation}, y del @rinternals{Backend}. Cada uno
1564 de los capítulos relaciona todas las definiciones utilizadas y todas
1565 las propiedades que se pueden ajustar.
1568 @node Interfaces de la presentación
1569 @subsection Interfaces de la presentación
1570 @translationof Layout interfaces
1572 @cindex interfaz de la presentación
1573 @cindex presentación, interfaz de la
1576 La página HTML que pudimos ver en la sección anterior describe el
1577 objeto de presentación llamado @rinternals{Fingering}. Dicho objeto
1578 es un símbolo dentro de la partitura. Tiene propiedades que guardan
1579 números (como grosores y direcciones), pero también punteros a objetos
1580 relacionados. Un objeto de presentación también se llama un
1581 @emph{Grob}, que es una abreviatura de Graphical Object (objeto
1582 gráfico). Para ver más detalles acerca de los objetos gráficos o
1583 Grobs, consulte @rinternals{grob-interface}.
1585 La página dedicada a @code{Fingering} relaciona las definiciones del
1586 objeto @code{Fingering}. Por ejemplo, la página dice
1589 @code{padding} (dimensión, en espacios de pentagrama):
1595 lo que significa que el número se mantendrá a una distancia de al
1596 menos 0.5 de la cabeza de la nota.
1599 Cada objeto de presentación puede tener varias funciones como elemento
1600 notacional o tipográfico. Por ejemplo, el objeto de digitación
1601 Fingering tiene los siguientes aspectos
1605 Su tamaño es independiente del espaciado horizontal, al contrario de
1606 las ligaduras o las barras de las figuras.
1609 Es un elemento de texto. Casi seguro que es un texto muy corto.
1612 este elemento de texto se tipografía con un tipo de letra, no como las
1613 ligaduras o las barras de las figuras.
1616 Horizontalmente, el centro del símbolo se debe alinear con el centro
1617 de la cabeza de la nota.
1620 Verticalmente, el símbolo se coloca cerca de la nota y del pentagrama.
1623 La posición vertical también está coordinada con otros símbolos de
1624 superíndice y de subíndice.
1627 Cada uno de estos aspectos se capta en lo que se llaman
1628 @emph{interface}s, que se relacionan al final de la página dedicada a
1629 @rinternals{Fingering}
1632 Este objeto contempla los siguientes interfaces:
1633 @rinternals{item-interface},
1634 @rinternals{self-alignment-interface},
1635 @rinternals{side-position-interface}, @rinternals{text-interface},
1636 @rinternals{text-script-interface}, @rinternals{font-interface},
1637 @rinternals{finger-interface} y @rinternals{grob-interface}.
1640 Al pulsar sobre cualquiera de los enlaces nos desplazaremos a la
1641 página del respectivo interfaz del objeto. Cada interfaz tiene un
1642 cierto número de propiedades. Algunas de ellas no son para que el
1643 usuario las pueda ajustar (@q{Propiedades internas}), pero otras sí se
1646 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero
1647 realmente esto no significa mucho. El archivo de inicialización
1648 (véase @rlearning{Otras fuentes de información})
1649 @file{scm/define-grobs.scm} muestra el alma del @q{objeto},
1654 (avoid-slur . around)
1655 (slur-padding . 0.2)
1656 (staff-padding . 0.5)
1657 (self-alignment-X . 0)
1658 (self-alignment-Y . 0)
1659 (script-priority . 100)
1660 (stencil . ,ly:text-interface::print)
1661 (direction . ,ly:script-interface::calc-direction)
1662 (font-encoding . fetaText)
1663 (font-size . -5) ; don't overlap when next to heads.
1664 (meta . ((class . Item)
1665 (interfaces . (finger-interface
1667 text-script-interface
1669 side-position-interface
1670 self-alignment-interface
1671 item-interface))))))
1675 Como podemos ver, el objeto @code{Fingering} no es más que un montón
1676 de valores de variables, y la página web de la Referencia de
1677 funcionamiento interno se genera directamente a partir de esta
1681 @node Determinar la propiedad del grob
1682 @subsection Determinar la propiedad del grob
1683 @translationof Determining the grob property
1685 Recordemos que queríamos cambiar la posición del @b{2} en
1687 @lilypond[quote,relative=2,verbatim]
1693 Puesto que el @b{2} se encuentra colocado verticalmente sobre su nota,
1694 tenemos que negociar con el interfaz asociado con esta colocación.
1695 Esto se hace usando @code{side-position-interface}. La página que
1696 describe este interface dice:
1699 @code{side-position-interface}
1701 Colocar un objeto víctima (este mismo) junto a otros objetos (el
1702 soporte). La propiedad @code{direction} significa dónde poner el
1703 objeto víctima con relación al soporte (¿a la izquierda o a la
1704 derecha, encima o debajo?)
1708 @cindex padding (relleno)
1710 Debajo de esta descripción, la variable @code{padding} (relleno) se
1716 (dimensión, en espacios de pentagrama)
1718 Añadir esta cantidad de espacio adicional entre objetos que están unos
1723 Aumentando el valor de @code{padding}, podemos alejar la cifra de
1724 digitación de la cabeza de la nota. La siguiente orden inserta un
1725 espacio en blanco de 3 espacios de pentagrama entre la nota y la
1728 \once \override Voice.Fingering.padding = #3
1731 Al insertar esta instrucción antes de que se haya creado el objeto
1732 Fingering, es decir, antes del @code{c2}, llegamos al siguiente
1735 @lilypond[quote,relative=2,verbatim]
1736 \once \override Voice.Fingering.padding = #3
1742 En este caso, el contexto de este truco es @code{Voice}. Este hecho
1743 se puede deducir también a partir de la referencia del programa, ya
1744 que la página dedicada al añadido @rinternals{Fingering_engraver} dice
1747 El grabador Fingering_engraver es parte de los contextos: @dots{}
1752 @node Convenciones de nombres
1753 @subsection Convenciones de nombres
1754 @translationof Naming conventions
1756 Se hace necesario presentar una panorámica de las diversas
1757 convenciones de nomenclatura:
1760 @item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
1761 @item funciones de Scheme: ly:más-estilo-de-scheme
1762 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
1763 @item interfaces de Grobs: estilo-scheme
1764 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
1765 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
1766 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
1767 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
1771 Preguntas aún sin respuesta
1773 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
1774 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
1779 @node Modificar las propiedades
1780 @section Modificar las propiedades
1781 @translationof Modifying properties
1784 * Panorámica de la modificación de las propiedades::
1785 * La instrucción set::
1786 * La instrucción override::
1787 * La instrucción tweak::
1788 * set frente a override::
1789 * Modificación de las listas-A::
1793 @node Panorámica de la modificación de las propiedades
1794 @subsection Panorámica de la modificación de las propiedades
1795 @translationof Overview of modifying properties
1797 Cada contexto es responsable de la creación de ciertos tipos de
1798 objetos gráficos. Los ajustes que se usan para imprimir estos objetos
1799 también se almacenan por contexto. Mediante la modificación de estos
1800 ajustes, se puede alterar la apariencia de los objetos.
1802 Existen dos tipos diferentes de propiedades almacenadas en los
1803 contextos: las propiedades de contexto y las propiedades de grob. Las
1804 propiedades de contexto son propiedades que se aplican al contexto
1805 como un todo y controlan la forma en que el propio contexto se
1806 imprime. Por contra, las propiedades de grob se aplican a los tipos
1807 de grob específicos que se imprimirán dentro del contexto.
1809 Las instrucciones @code{\set} y @code{\unset} se usan para cambiar los
1810 valores de las propiedades de contexto. Las instrucciones
1811 @code{\override} y @code{\revert} se usan para cambiar los valores de
1812 las propiedades de grob.
1815 La sintaxis de esto es
1818 \override @var{contexto}.@var{nombre} #'@var{propiedad} = #@var{valor}
1821 Aquí @var{nombre} es el nombre de un objeto gráfico, como @code{Stem}
1822 o @code{NoteHead}, y @var{propiedad} es una variable interna del
1823 sistema de formateo (@q{propiedad del grob} o @q{propiedad de
1824 disposición}). Este último es un símbolo, y por ello debe ir
1825 precedido de un apóstrofo. La subsección @ref{Modificar las propiedades}
1826 explica cómo se deben cumplimentar los conceptos @var{nombre},
1827 @var{propiedad} y @var{valor}. Aquí sólo nos ocuparemos de la
1828 funcionalidad des esta instrucción.
1833 \override Staff.Stem.thickness = #4.0
1837 hace más gruesas las plicas (el valor predeterminado es 1.3, con el
1838 grosor de una línea del pentagrama como unidad). Puesto que la
1839 instrucción especifica como contexto a @code{Staff}, sólo se aplica al
1840 pentagrama actual. Otros pentagramas mantienen su aspecto normal.
1841 Aquí vemos la instrucción en pleno funcionamiento:
1843 @lilypond[quote,verbatim,relative=2]
1845 \override Staff.Stem.thickness = #4.0
1851 La instrucción @code{\override} modifica la definición de la plica
1852 @code{Stem} dentro del pentagrama en curso @code{Staff}. Después de
1853 que la instrucción se ha interpretado, todas las plicas se engrosan.
1855 De manera análoga a @code{\set}, el argumento @var{contexto} se puede
1856 omitir, ocasionando que se utilice el contexto predeterminado
1857 @code{Voice}. Al añadir @code{\once} se aplica el cambio durante un
1858 solo paso de tiempo.
1860 @lilypond[quote,verbatim,relative=2]
1862 \once \override Stem.thickness = #4.0
1867 El @code{\override} se debe hacer antes de que el objeto se inicia.
1868 Por tanto, al alterar objetos @emph{Spanner} «de extensión» como
1869 ligaduras o barras, la instrucción @code{\override} se debe ejecutar
1870 en el momento en que se crea el objeto. En este ejemplo:
1872 @lilypond[quote,verbatim,relative=2]
1873 \override Slur.thickness = #3.0
1875 \override Beam.beam-thickness = #0.6
1880 la ligadura es más gruesa pero la barra no lo es. Esto es así porque
1881 la instrucción para @code{Beam}, la barra, va después de que la barra
1882 se ha iniciado, y por ello no tiene ningún efecto.
1884 De forma análoga a @code{\unset}, la instrucción @code{\revert} para
1885 un contexto deshace una instrucción @code{\override}; como con
1886 @code{\unset}, solamente afecta a los ajustes que se hicieron dentro
1887 del mismo contexto. En otras palabras, el @code{\revert} del
1888 siguiente ejemplo no hace nada.
1891 \override Voice.Stem.thickness = #4.0
1892 \revert Staff.Stem.thickness
1895 Algunas opciones «trucables» se llaman @q{subpropiedades} y residen
1896 dentro de las propiedades normales. Para trucarlas, utilice
1897 instrucciones de la forma
1899 @c leave this as a long long
1901 \override @var{context}.@var{name} #'@var{property} #'@var{subproperty} = #@var{value}
1908 \override Stem.details.beamed-lengths = #'(4 4 3)
1914 Referencia de funcionamiento interno:
1915 @rinternals{Backend},
1916 @rinternals{All layout objects},
1917 @rinternals{OverrideProperty},
1918 @rinternals{RevertProperty},
1919 @rinternals{PropertySet}.
1922 El «back-end» o motor de salida no es muy estricto en la comprobación
1923 de tipos de las propiedades de objetos. Las referencias cíclicas en
1924 valores Scheme de propiedades pueden producir cuelgues o salidas
1925 abruptas, o las dos cosas.
1928 @node La instrucción set
1929 @subsection La instrucción @code{@bs{}set}
1930 @translationof The set command
1934 @cindex cambiar propiedades
1936 Cada contexto puede tener distintas @emph{propiedades}, variables
1937 contenidas dentro de ese contexto. Se pueden cambiar mientras dura el
1938 paso de interpretación. Se consigue insertando la instrucción
1939 @code{\set} dentro de la música:
1942 \set @var{contexto}.@var{propiedad} = #@var{valor}
1945 @var{valor} es un objeto de Scheme, razón por la que va precedido del
1946 carácter almohadilla,@tie{}@code{#}.
1948 El nombre de las propiedades de contexto suele ir en minúsculas con
1949 mayúscula en medio. Controlan sobre todo la traducción de la música a
1950 la notación, p.ej. @code{localKeySignature} (para determinar si hay
1951 que impriir alteraciones o no), o @code{measurePosition} (para
1952 determinar cuándo hay que imprimir una línea divisoria). El valor de
1953 las propiedades de contexto puede modifcarse con el tiempo durante la
1954 interpretación de la música; un ejemplo obvio es
1955 @code{measurePosition}. Las propiedades de contexto se modifican
1956 mediante la instrucción @code{\set}.
1958 Por ejemplo, los silencios multicompás se combinan en un solo compás
1959 si el valor de la propiedad de contexto @code{skipBars} se establece a
1960 @code{#t} (verdadero):
1962 @lilypond[quote,verbatim,relative=2]
1964 \set Score.skipBars = ##t
1968 Si se omite el argumento @var{context}, entonces se utiliza el
1969 contexto actual de nivel más bajo (normalmente @code{ChordNames},
1970 @code{Voice} o @code{Lyrics}). En este ejemplo:
1972 @lilypond[quote,verbatim,relative=2]
1973 \set Score.autoBeaming = ##f
1977 \set autoBeaming = ##t
1985 El cambio se aplica @q{al vuelo}, mientras dura la música, de forma
1986 que el ajuste sólo afecta al segundo grupo de corcheas.
1988 Observe que el contexto del nivel más bajo no siempre contiene la
1989 propiedad que querríamos modificar: por ejemplo, intentar ajustar el
1990 valor de la propiedad @code{skipBars} del contexto predeterminado del
1991 nivel más bajo, que en este caso es @code{Voice}, no tendrá ningún
1992 efecto, porque skipBars es una propiedad del contexto @code{Score}.
1994 @lilypond[quote,verbatim,relative=2]
2000 Los contextos son jerárquicos, y si se ha especificado un contexto
2001 mayor, por ejemplo @code{Staff}, entonces el cambio se aplicaría
2002 también a todos los contextos @code{Voice} dentro del pentagrama
2007 También existe una instrucción @code{\unset}:
2009 \unset @var{contexto}.@var{propiedad}
2013 que elimina la definición de @var{propiedad}. Esta instrucción
2014 elimina la definición solamente si está establecida dentro de
2015 @var{contexto}. Properties that have been set in enclosing contexts will
2016 not be altered by an unset in an enclosed context:
2018 @lilypond[quote,verbatim,relative=2]
2019 \set Score.autoBeaming = ##t
2024 \unset Score.autoBeaming
2032 Como @code{\set}, el argumento @var{contexto} no se tiene que
2033 especificar para un contexto del nivel más bajo, por lo que los dos
2037 \set Voice.autoBeaming = ##t
2038 \set autoBeaming = ##t
2042 son equivalentes si el contexto inferior en curso es @code{Voice}.
2046 Los ajustes que se aplican solamente a un único paso de tiempo se
2047 pueden escribir con @code{\once}, por ejemplo en
2049 @lilypond[quote,verbatim,relative=2]
2051 \once \set fontSize = #4.7
2056 En el manual de Referencia de funcionamiento interno hay una
2057 descripción completa de todas las propiedades de contexto disponibles,
2060 @rinternals{Tunable context properties}.
2063 Traducción @expansion{} Propiedades de contexto modificables por el
2068 Referencia de funcionamiento interno:
2069 @rinternals{Tunable context properties}.
2071 @node La instrucción override
2072 @subsection La instrucción @code{\override}
2073 @translationof The override command
2075 @cindex grob, propiedades de
2076 @cindex propiedades de grob
2079 Existe un tipo especial de propiedad de contexto: la descripción de
2080 los grobs. Las decscripciones de los grobs reciben un nombre en
2081 @code{MayúsculasDeCamello} (empezando en mayúscula). Contienen los
2082 @q{ajustes predeterminados} para un tipo particular de grob, en forma
2083 de lista asociativa. Consulte @file{scm/define-grobs.scm} para
2084 ver los ajustes de cada descripción de grob. Las descripciones de
2085 grob se modifican con @code{\override}.
2087 La sintaxis de la instrucción @code{\override} es
2090 \override [@var{contexto}.]@var{NombreDelGrob}.@var{propiedad} = #@var{valor}
2093 Por ejemplo, podemos aumentar el grosor de la plica de una figura
2094 sobreescribiendo la propiedad @code{thickness} (grosor) del objeto
2095 @code{Stem} (plica):
2097 @lilypond[quote,verbatim,relative=2]
2099 \override Voice.Stem.thickness = #3.0
2103 Si no se ha especificado ningún contexto en la instrucción
2104 @code{\override}, se utiliza el contexto del nivel inferior:
2106 @lilypond[quote,verbatim,relative=2]
2107 { \override Staff.Stem.thickness = #3.0
2111 \override Stem.thickness = #0.5
2120 Algunas opciones susceptibles de trucaje, se llaman
2121 @q{subpropiedades} y residen dentro de las propiedades. Para
2122 efectura trujajes sobre ellas, utilice instrucciones de la forma
2125 \override Stem.details.beamed-lengths = #'(4 4 3)
2128 o para modificar los extremos de los objetos extensos, utilice una
2129 forma como las siguientes:
2132 \override TextSpanner.bound-details.left.text = #"left text"
2133 \override TextSpanner.bound-details.right.text = #"right text"
2137 @cindex reversión de sobreescrituras
2138 @cindex sobreescrituras, reversión de
2140 El efecto de una instrucción de sobreescritura @code{\override} se
2141 puede deshacer con @code{\revert}.
2143 La sintaxis de la instrucción @code{\revert} es
2146 \revert [@var{Contexto}.]@var{NombreDelGrob}.@var{propiedad}
2151 @lilypond[quote,verbatim,relative=2]
2153 \override Voice.Stem.thickness = #3.0
2155 \revert Voice.Stem.thickness
2159 Los efectos de @code{\override} y @code{\revert} se aplican a todos
2160 los grobs del contexto afectado partiendo del momento actual y hacia
2163 @lilypond[quote,verbatim,relative=2]
2168 \override Staff.Stem.thickness = #3.0
2172 \revert Staff.Stem.thickness
2180 @cindex sobreescritura para un solo momento
2182 Se puede usar @code{\once} con @code{\override} para afectar solamente
2183 al instante de tiempo actual:
2185 @lilypond[quote,verbatim,relative=2]
2189 \override Stem.thickness = #3.0
2193 \once \override Stem.thickness = #3.0
2202 Las instrucciones que modifican la salida tienen por lo general un
2206 \override Voice.Stem.thickness = #3.0
2210 Para construir este truco debemos determinar los siguientes datos:
2213 @item el contexto: aquí @code{Voice}.
2214 @item el objeto de presentación: aquí @code{Stem}.
2215 @item la propiedad de presentación: aquí @code{thickness}.
2216 @item un valor adecuado: aquí @code{3.0}.
2219 @cindex documentación interna
2220 @cindex buscar objetos gráficos
2221 @cindex gráficos, descripción de los objetos
2224 @cindex interna, documentación
2226 Para muchas propiedades, independientemente del tipo de datos de la
2227 propiedad, si se establece el valor de la propiedad a falso
2228 (@code{#f}) se producirá su desactivación, ocasionando que LilyPond
2229 ignore por completo dicha propiedad. Esto es especialmente útil para
2230 «apagar» propiedades de grobs (objetos gráficos) que de otra manera
2231 causarían problemas.
2233 Mostraremos a continuación cómo localizar esta información en el
2234 manual de notación y en la referencia de funcionamiento interno.
2238 Referencia de funcionamiento interno:
2239 @rinternals{Backend}
2242 @node La instrucción tweak
2243 @subsection La instrucción @code{\tweak}
2244 @translationof The tweak command
2249 El cambio de las propiedades de grob mediante @code{\override} produce
2250 la aplicación del cambio a todos los grobs dados en el contexto en el
2251 momento en que se aplica dicho cambio. Sin embargo, en ocasiones
2252 podemos desear que los cambios se apliquen a un solo grob en lugar de
2253 a todos los grobs del contexto afectado. Esto se consigue con la
2254 instrucción @code{\tweak}, que tiene la sintaxis siguiente:
2257 \tweak [@var{objeto-de-presentación}.]@var{propiedad-del-grob} @var{valor}
2260 Es opcional especificar el @var{objeto-de-presentación}. La
2261 instrucción @code{\tweak} se aplica al objeto musical que viene
2262 inmediatamente después de @var{valor} dentro del flujo musical.
2265 En ocasiones es posible tomar un atajo para realizar el ajuste fino de
2266 los objetos gráficos. Para objetos que resultan directamente de un
2267 elemento de código de la entrada, puede usar la función @code{\tweak},
2270 @lilypond[relative=2,verbatim,quote]
2275 \tweak duration-log #1
2284 El uso principal de la instrucción @code{\tweak} es modificar
2285 solamente uno de varios elementos de notación que dan comienzo en el
2286 mismo momento musical, como las notas de un acorde, o corchetes de
2287 tresillo que empiezan al mismo tiempo.
2289 La instrucción @code{\tweak} fija una propiedad en el objeto que viene
2290 a continuación de forma directa, sin necesidad de especificar el
2291 nombre del grob o el contexto. Para que esto funcione, es necesario
2292 que la instrucción @code{\tweak} permanezca inmediatamente adyacente
2293 al objeto al que se aplica, después de que el archivo de entrada se ha
2294 convertido en un flujo musical. Con frecuencia no es el caso, pues
2295 muchos elementos adicionales se insertan en la corriente musical de
2296 forma implícita. Por ejemplo, cuando se procesa una nota que no forma
2297 parte de un acorde, LilyPond inserta implícitamente un evento
2298 @code{ChordEvent} antes de la nota, separando así el truco de la nota.
2299 Sin embargo, si los símbolos de acorde se sitúan cerca del truco y la
2300 nota, la instrucción @code{\tweak} viene después del @code{ChordEvent}
2301 en el flujo musical, permaneciendo así adyacente a la nota, y con la
2302 posibilidad de modificarla.
2306 @lilypond[relative=2,verbatim,quote]
2307 <\tweak color #red c>4
2311 pero esto no funciona:
2313 @lilypond[relative=2,verbatim,quote]
2314 \tweak color #red c4
2319 Para ver una introducción a la sintaxis y los usos de la instrucción tweak,
2320 consulte @rlearning{Métodos de trucaje}.
2322 Si se colocan varios elementos similares en el mismo momento musical,
2323 la instrucción @code{\override} no se puede usar para modificar uno
2324 solo de ellos: aquí es donde se debe usar la instrucción
2325 @code{\tweak}. Entre los elementos que pueden aparecer más de una vez
2326 en el mismo momento musical están los siguientes:
2328 @c TODO expand to include any further uses of \tweak
2330 @item las cabezas de las notas de un acorde
2331 @item signos de articulación sobre la misma nota
2332 @item ligaduras de unión entre notas de un acorde
2333 @item corchetes de grupos especials que comienzan en el mismo momento
2336 @c TODO add examples of these
2338 @cindex acorde, modificación de una nota
2340 En este ejemplo se modifican el color de una cabeza y el tipo de otra,
2341 dentro del mismo acorde:
2343 @lilypond[relative=2,verbatim,quote]
2348 \tweak duration-log #1
2353 @code{\tweak} se puede usar para modificar ligaduras de expresión:
2355 @lilypond[verbatim,quote,relative=1]
2356 c-\tweak thickness #5 ( d e f)
2360 Para que funcione la instrucción @code{\tweak}, debe permanecer
2361 adyacente al objeto al que se ha de aplicar después de que el código
2362 de entrada se ha convertido a un flujo musical. El trucaje de un
2363 acorde completo no hace nada porque su evento musical actúa solamente
2364 como un contenedor, y todos los objetos de presentación se crean a
2365 partir de eventos dentro del @code{EventChord}:
2367 @lilypond[relative=2,verbatim,quote]
2368 \tweak color #red c4
2369 \tweak color #red <c e>4
2370 <\tweak color #red c e>4
2373 La instrucción @code{\tweak} sencilla no se puede usar para modificar
2374 ningún objeto que no se haya creado directamente a partir de la entrada.
2375 Concretamente, no afecta a las plicas, barras automáticas ni
2376 alteraciones, porque éstos se generan posteriormente por
2377 parte de objetos de presentación @code{NoteHead}
2378 más que por elementos musicales del
2381 Tales objetos de presentación creados indirectamente se pueden trucar
2382 usando la forma de la instrucción @code{\tweak} en que el nombre
2383 del grob se especifica de forma explícita:
2385 @lilypond[relative=2,verbatim,quote]
2386 \tweak Stem.color #red
2387 \tweak Beam.color #green c8 e
2388 <c e \tweak Accidental.font-size #-3 ges>4
2391 No se puede usar @code{\tweak} para modificar las claves o las
2392 indicaciones de compás, porque éstos se separan de cualquier
2393 instrucción @code{\tweak} precedente dentro del flujo de entrada
2394 merced a la inserción automática de elementos adicionales que se
2395 requieren para especificar el contexto.
2397 Se pueden colocar varias instrucciones @code{\tweak} antes de un
2398 elemento de notación; todos le afectan:
2400 @lilypond[verbatim,quote,relative=1]
2402 -\tweak style #'dashed-line
2403 -\tweak dash-fraction #0.2
2404 -\tweak thickness #3
2410 El flujo musical que se genera a partir de una sección de un archivo
2411 de entrada (incluido cualquier elemento insertado automáticamente)
2412 puede examinarse, véase @rextend{Presentación de las expresiones musicales}.
2413 Esto puede ser de utilidad en la determinación de lo que
2414 puede modificarse por medio de una instrucción @code{\tweak}.
2417 Manual de aprendizaje:
2418 @rlearning{Métodos de trucaje}.
2420 Manual de extensión:
2421 @rextend{Presentación de las expresiones musicales}.
2425 @cindex trucar puntos de control
2426 @cindex control, trucar puntos de
2428 No se puede usar la instrucción @code{\tweak} para modificar los
2429 puntos de control de una sola de varias ligaduras de unión dentro de
2430 un acorde, aparte de la primera que se encuentre en el código de
2434 @node set frente a override
2435 @subsection @code{\set} frente a @code{\override}
2436 @translationof set versus override
2438 @c HACER: probablemente esta sección es innecesaria.
2441 We have seen two methods of changing properties: @code{\set} and
2442 @code{\override}. There are actually two different kinds of
2445 @code{fontSize} is a special property: it is equivalent to
2446 entering @code{\override @dots{} #'font-size} for all pertinent
2447 objects. Since this is a common change, the special
2448 property (modified with @code{\set}) was created.
2453 @node Modificación de las listas-A
2454 @subsection Modificación de las listas-A
2455 @translationof Modifying alists
2457 Ciertas propiedades configurables por parte del usuario se representan
2458 internamente como @emph{listas-A} (listas asociativas), que almacenan
2459 duplas de @emph{claves} y @emph{valores}. La estructura de una
2460 lista-A es la siguiente:
2463 '((@var{clave1} . @var{valor1})
2464 (@var{clave2} . @var{valor2})
2465 (@var{clave3} . @var{valor3})
2469 Si una lista-A es una propiedad de un grob o una variable de
2470 @code{\paper}, sus claves se pueden modificar individualmente sin que
2471 afecte a las otras claves.
2473 Por ejemplo, para reducir el espacio entre pentagramas adyacentes
2474 dentro de un grupo, use la propiedad @code{staff-staff-spacing}
2475 del grob @code{StaffGrouper}. La propiedad es una lista-A con cuatro
2476 claves: @code{basic-distance} (distancia básica),
2477 @code{minimum-distance} (distancia mínima), @code{padding} (relleno)
2478 y @code{stretchability} (ampliabilidad).
2479 Los ajustes estándar para esta propiedad
2480 se relacionan en la sección
2481 @qq{Backend} de la Referencia de Funcionamiento Interno
2482 (véase @rinternals{StaffGrouper}):
2485 '((basic-distance . 9)
2486 (minimum-distance . 7)
2488 (stretchability . 5))
2491 Una forma de acercar los pentagramas entre sí es reducir el valor de
2492 la clave @code{basic-distance} (@code{9}) para que se corresponda con
2493 el valor de @code{minimum-distance} (@code{7}). Para modificar una
2494 única clave de forma individual, utilice una @emph{declaración
2497 @lilypond[quote,verbatim]
2498 % default space between staves
2500 \new Staff { \clef treble c''1 }
2501 \new Staff { \clef bass c1 }
2504 % reduced space between staves
2505 \new PianoStaff \with {
2506 % this is the nested declaration
2507 \override StaffGrouper.staff-staff-spacing.basic-distance = #7
2509 \new Staff { \clef treble c''1 }
2510 \new Staff { \clef bass c1 }
2514 La utilización de una declaración anidada actualiza la clave
2515 especificada (como @code{basic-distance} en el ejemplo anterior)
2517 de las otras claves que ya se habían establecido para la misma
2520 Ahora, supongamos que deseamos que los pentagramas estén tan próximos
2521 como sea posible sin que se superpongan. La manera más sencilla de
2522 hacerlo es establecer las cuatro claves de la lista-A a cero. Sin
2523 embargo, no es necesario escribir cuatro declaraciones anidadas, una
2524 por cada clave. En lugar de eso, se puede redefinir completamente la
2525 propiedad con una sola declaración, como una lista-A:
2527 @lilypond[quote,verbatim]
2528 \new PianoStaff \with {
2529 \override StaffGrouper.staff-staff-spacing =
2530 #'((basic-distance . 0)
2531 (minimum-distance . 0)
2533 (stretchability . 0))
2535 \new Staff { \clef treble c''1 }
2536 \new Staff { \clef bass c1 }
2540 Observe que cualquier clave que no haya sido relacionada
2541 explícitamente en la definición de la lista-A, será reiniciada a sus
2542 valores @emph{predeterminados si no se han fijado}. En el caso de
2543 @code{staff-staff-spacing}, el valor de cualquier clave no fijada se
2544 reiniciaría a cero (excepto @code{stretchability}, que toma el valor
2545 de @code{basic-distance} si no se fija). Así, las dos declaraciones
2546 siguientes son equivalentes:
2549 \override StaffGrouper.staff-staff-spacing =
2550 #'((basic-distance . 7))
2552 \override StaffGrouper.staff-staff-spacing =
2553 #'((basic-distance . 7)
2554 (minimum-distance . 0)
2556 (stretchability . 7))
2559 Una consecuencia de esto (posiblemente no intencionada) es la
2560 eliminación de cualquier valor estándar que se establezca en un
2561 archivo de inicio y que se carga cada vez que se compila un archivo de
2562 entrada. En el ejemplo anterior, los ajustes estándar para
2563 @code{padding} y @code{minimum-distance} (definidos en
2564 @file{scm/define-grobs.scm}) se reinician a sus valores
2565 predeterminados si no se han fijado (cero para las dos claves). La
2566 definición de una propiedad o variable como una lista-A (de cualquier
2567 tamaño) siempre reinicia todos los valores de clave no establecidos a
2568 sus valores predeterminados si no se han fijado. Ano ser que este sea
2569 el resultado deseado, es más seguro actualizar los valores de clave
2570 individualmente con una declaración anidada.
2572 @warning{Las declaraciones anidadas no funcionan para las listas-A de
2573 propiedades de contexto (como @code{beamExceptions},
2574 @code{keySignature}, @code{timeSignatureSettings}, etc.). Estas
2575 propiedades sólo se pueden modificar redefiniéndolas completamente
2579 @node Conceptos y propiedades útiles
2580 @section Conceptos y propiedades útiles
2581 @translationof Useful concepts and properties
2585 * Modos de entrada::
2586 * Dirección y posición::
2587 * Distancias y medidas::
2588 * Propiedades del símbolo del pentagrama::
2589 * Objetos de extensión::
2590 * Visibilidad de los objetos::
2591 * Estilos de línea::
2592 * Rotación de objetos::
2596 @node Modos de entrada
2597 @subsection Modos de entrada
2598 @translationof Input modes
2600 La forma en que se interpreta la notación contenida dentro de un
2601 archivo de entrada, está determinada por el modo de entrada en curso.
2603 @strong{Modo de acordes}
2605 Se activa con la instrucción @code{\chordmode} y produce que la
2606 entrada se interprete con al sintaxis de la notación de acordes, véase
2607 @ref{Notación de acordes}. Los acordes se imprimen como notas sobre un
2610 El modo de acordes se activa también con la instrucción
2611 @code{\chords}. Esto crea también un contexto @code{ChordNames} nuevo
2612 y produce que el código que sigue se interprete con la sintaxis de la
2613 notación de acordes y se imprima como nombres de acorde dentro del
2614 contexto @code{ChordNames}, véase @ref{Impresión de los nombres de acorde}.
2616 @strong{Modo de percusión}
2618 Se activa con la instrucción @code{\drummode} y produce que el código
2619 de entrada se interprete con la sintaxis de la notación de percusión,
2620 véase @ref{Notación básica de percusión}.
2622 El modo de percusión también se activa con la instrucción
2623 @code{\drums}. También crea un contexto @code{DrumStaff} nuevo y hace
2624 que el código que sigue se interprete con la sintaxis de la notación
2625 de percusión y se imprima como símbolos de percusión sobre un
2626 pentagrama de percusión, véase @ref{Notación básica de percusión}.
2628 @strong{Modo de cifras}
2630 Se activa con la instrucción @code{\figuremode} y hace que el código
2631 de entrada se interprete con la sintaxis del bajo cifrado, véase
2632 @ref{Introducir el bajo cifrado}.
2634 El modo de cifras también se activa con la instrucción
2635 @code{\figures}. También crea un contexto de @code{FiguredBass}
2636 nuevo y hace que el código que viene a continuación se interprete
2637 con la sintaxis del bajo cifrado y se imprima como símbolos de
2638 bajo cifrado dentro del contexto @code{FiguredBass}, véase
2639 @ref{Introducción al bajo cifrado}.
2641 @strong{Modos de traste y tablatura}
2643 No existen modos de entrada especiales para introducir símbolos de
2644 trastes y de tablatura.
2646 Para crear diagramas de trastes, escriba las notas o acordes en el
2647 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
2648 véase @ref{Tablaturas predeterminadas}.
2650 Para crear diagramas de trastes encima de un pentagrama, escríbalos
2651 como elementos de marcado encima de las notas utilizando la
2652 instrucción @code{\fret-diagram}, véase @ref{Marcas de diagramas de trastes}.
2654 @strong{Modo de letra}
2656 Se activa con la instrucción @code{\lyricmode}, y hace que la entrada
2657 se interprete como sílabas de la letra de la canción con duraciones
2658 opcionales y modificadores de letra asociados, véase @ref{Música vocal}.
2660 El modo de letra también se habilita con la instrucción
2661 @code{\addlyrics}. Esto también crea un contexto @code{Lyrics} nuevo
2662 y una instrucción @code{\lyricsto} implícita que asocia la letra que
2663 viene a continuación con la música precedente.
2665 @strong{Modo de marcado}
2667 Se activa con la instrucción @code{\markup}, y hace que la entrada se
2668 interprete con la sintaxis del marcado, véase @ref{Text markup commands}.
2670 @c silly work-around for texinfo broken-ness
2671 @c (@strong{Note...} causes a spurious cross-reference in Info)
2674 Es el modo predeterminado o se puede activar con la instrucción
2675 @code{\notemode}. La entrada se interpreta como alturas, duraciones,
2676 marcado, etc. y se imprime como notación musical sobre un pentagrama.
2678 Normalmente no es necesario especificar el modo de notas de forma
2679 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
2680 ejemplo si estamos en el modo de letra, en el modo de acordes o en
2681 otro modo y queremos insertar algo que solamente se puede hacer con la
2682 sintaxis del modo de notas.
2684 Por ejemplo, para insertar indicaciones dinámicas para las estrofas de
2685 una pieza coral es necesario entrar en el modo de notas para poder
2686 interpretar dichas indicaciones:
2688 @lilypond[verbatim,relative=2,quote]
2691 \notemode{\set stanza = \markup{ \dynamic f 1. } }
2695 \notemode{\set stanza = \markup{ \dynamic p 2. } }
2701 @node Dirección y posición
2702 @subsection Dirección y posición
2703 @translationof Direction and placement
2705 Al tipografiar música, la dirección y colocación de muchos elementos
2706 es cuestión de elección. Por ejemplo, las plicas de las notas se
2707 pueden dirigir hacia arriba o hacia abajo; la letra, las indicaciones
2708 dinámicas y otras marcas expresivas se pueden colocar encima o debajo
2709 del pentagrama; el texto se pude alinear a la izquierda, a la derecha
2710 o centrado; etc. La mayoría de estas elecciones pueden dejarse que
2711 LilyPond las determine automáticamente, pero en ciertos casos puede
2712 ser deseable forzar una dirección o colocación concreta.
2715 * Indicadores de dirección de las articulaciones::
2716 * La propiedad de dirección::
2719 @node Indicadores de dirección de las articulaciones
2720 @unnumberedsubsubsec Indicadores de dirección de las articulaciones
2721 @translationof Articulation direction indicators
2723 De forma predeterminada algunas direcciones siempre son hacia arriba o
2724 siempre hacia abajo (p. ej. los matices o el calderón), mientras que
2725 otras cosas pueden alternar entre arriba y abajo en función de la
2726 dirección de las plicas (como las ligaduras o los acentos).
2728 @c TODO Add table showing these
2730 Se puede sobreescribir la acción predeterminada mediante el prefijado
2731 de la articulación por un @emph{indicacor de dirección}. Están
2732 disponibles tres indicadores de dirección: @code{^} (que significa
2733 @qq{arriba}), @code{_} (que significa @qq{abajo}) o @code{-} (que
2734 significa @qq{usar la dirección predeterminada}). El indicador de
2735 dirección se puede normalmente omitir, en cuyo caso se supone el
2736 indicador predeterminado @code{-}, pero se necesita un indicador de
2737 dirección @strong{siempre} antes de:
2740 @item las instrucciones @code{\tweak}
2741 @item las instrucciones @code{\markup}
2742 @item las instrucciones @code{\tag}
2743 @item los marcados de cadena, p.ej. -"cadena"
2744 @item las instrucciones de digitación, p.ej. @w{@code{-1}}
2745 @item las abreviaturas de articulación, p.ej. @w{@code{-.}}, @w{@code{->}}, @w{@code{--}}
2748 Estas indicaciones afectan sólo a la nota siguiente.
2750 @lilypond[verbatim,quote,relative=2]
2757 @node La propiedad de dirección
2758 @unnumberedsubsubsec La propiedad de dirección
2759 @translationof The direction property
2761 La posición o dirección de muchos objetos de presentación está
2762 controlada por la propiedad @code{direction}.
2764 El valor de la propiedad @code{direction} se puede establecer al valor
2765 @code{1}, con el significado de @qq{hacia arriba} o @qq{encima}, o a
2766 @w{@code{-1}}, con el significado de @qq{hacia abajo} o @qq{debajo}.
2767 Se pueden usar los símbolos @code{UP} y @code{DOWN} en sustitución de
2768 @code{1} y @w{@code{-1}} respectivamente. La dirección predeterminada
2769 se puede especificar estableciendo @code{direction} a @code{0} ó a
2770 @code{CENTER}. De forma alternativa, en muchos casos existen
2771 instrucciones predefinidas para especificar la dirección. Todas ellas
2775 @code{\xxxUp}, @code{\xxxDown} o @code{\xxxNeutral}
2779 donde @code{\xxxNeutral} significa @qq{utilizar la dirección
2780 predeterminada}. Véase @rlearning{Objetos interiores al pentagrama}.
2782 En alguna que otra ocasión como en el arpegio, el
2783 valor de la propiedad @code{direction} puede especificar si el objeto se debe
2784 colocar a la izquierda o a la derecha del objeto padre. En este caso
2785 @w{@code{-1}} ó @code{LEFT} significan @qq{a la izquierda} y @code{1}
2786 ó @code{RIGHT} significan @qq{a la derecha}. @code{0} ó @code{CENTER}
2787 significan @qq{utilizar la dirección predeterminada}.
2789 Estas indicaciones afectan a todas las notas hasta que son canceladas.
2791 @lilypond[verbatim,quote,relative=2]
2800 En música polifónica, en general es mejor especificar una voz explícita
2801 que cambiar la dirección de un objeto. Para ver más información,
2802 véase @ref{Varias voces}.
2805 Manual de aprendizaje:
2806 @rlearning{Objetos interiores al pentagrama}.
2808 Referencia de la notación:
2812 @node Distancias y medidas
2813 @subsection Distancias y medidas
2814 @translationof Distances and measurements
2816 @cindex distancias absolutas
2817 @cindex distancias escaladas
2824 Las distancias en LilyPond son de dos tipos: absolutas y escaladas.
2826 Las distancias absolutas se usan para especificar márgenes, sangrados
2827 y otros detalles de diseño de página, y de forma predeterminada se
2828 especifican en milímetros. Las distancias se pueden especificar en
2829 otras unidades escribiendo después de la cifra indicativa de la
2830 cantidad, @code{\mm}, @code{\cm}, @code{\in}@tie{}(pulgadas), o
2831 @code{\pt}@tie{}(puntos, 1/72.27 pulgadas). Las distancias de diseño
2832 de página se pueden especificar también en unidades escalables (véase
2833 el párrafo siguiente) adjuntando @code{\staff-space} a la cantidad.
2834 La disposición de página se describe en detalle en
2835 @ref{Disposición de la página}.
2837 Las distancias escaladas siempre se especifican en unidades de un
2838 espacio del pentagrama o, más raramente, medio espacio del pentagrama.
2839 El espacio de pentagrama es la distancia entre dos líneas del
2840 pentagrama adyacentes. El valor predeterminado se puede cambiar
2841 globalmente fijando el tamaño global del pentagrama, o se puede
2842 sobreescribir localmente cambiando la propiedad @code{staff-space} del
2843 objeto @code{StaffSymbol}. Las distancias escaladas se escalan
2844 automáticamente con cualquier cambio al tamaño global del pentagrama o
2845 a la propiedad @code{staff-space} del objeto @code{StaffSymbol}, pero
2846 las fuentes tipográficas se escalan solamente con los cambios
2847 efectuados al tamaño global del pentagrama. Así, el tamaño global del
2848 pentagrama posibilita la fácil variación del tamaño general de una
2849 partitura impresa. Para ver los métodos de establecimiento del tamaño
2850 global del pentagrama, véase @ref{Establecer el tamaño del pentagrama}.
2854 Si se necesita dibujar sólo una sección de una partitura a una escala
2855 distinta, por ejemplo una sección ossia o una nota al pie, no se puede
2856 simplemente cambiar el tamaño global del pentagrama porque esto
2857 afectaría a toda la partitura. En tales casos, el cambio de tamaño se
2858 hace sobreescribiendo tanto la propiedad @code{staff-space} de
2859 @code{StaffSymbol} como el tamaño de las fuentes tipográficas. Está a
2860 nuestra disposición una función de Scheme, @code{magstep}, para
2861 convertir de un cambio en el tamaño de la fuente al cambio equivalente
2862 en @code{staff-space}. Para ver una explicación y un ejemplo de su
2863 utilización, consulte @rlearning{Longitud y grosor de los objetos}.
2866 Manual de aprendizaje:
2867 @rlearning{Longitud y grosor de los objetos}.
2869 Referencia de la notación:
2870 @ref{Disposición de la página},
2871 @ref{Establecer el tamaño del pentagrama}.
2874 @node Propiedades del símbolo del pentagrama
2875 @subsection Propiedades del símbolo del pentagrama
2876 @translationof Staff symbol properties
2878 @cindex ajuste del símbolo del pentagrama
2879 @cindex dibujar el símbolo del pentagrama
2880 @cindex pentagrama, establecer el símbolo del
2882 @c TODO Extend or remove this section. See also NR 1.6.2 Staff symbol
2883 @c Need to think of uses for these properties. Eg 'line-positions
2884 @c is used in a snippet to thicken centre line.
2885 @c If retained, add @ref to here in 1.6.2 -td
2887 Se puede definir al mismo tiempo la posición vertical de las líneas de
2888 la pauta y el número de líneas de la misma. Como muestra el siguiente
2889 ejemplo, las posiciones de las notas no están influidas por las
2890 posiciones de las líneas de la pauta.
2892 @warning{La propiedad @code{'line-positions} sobreescribe a la
2893 propiedad @code{'line-count}. El número de líneas de la pauta está
2894 definido implícitamente por el número de elementos de la lista de
2895 valores de @code{'line-positions}.}
2897 @lilypond[verbatim,quote,relative=1]
2899 \override StaffSymbol.line-positions = #'(7 3 0 -4 -6 -7)
2904 Se puede modificar la anchura de la pauta. Las unidades son espacios
2905 de pentagrama. El espaciado de los objetos dentro del pentagrama no
2906 resulta afectado por este ajuste.
2908 @lilypond[verbatim,quote,relative=1]
2910 \override StaffSymbol.width = #23
2916 @node Objetos de extensión
2917 @subsection Objetos de extensión
2918 @translationof Spanners
2920 Muchos objetos de notación musical abarcan varias notas o incluso
2921 varios compases. Son ejemplos los crescendi, trinos, corchetes de
2922 grupo especial y corchetes de primera y segunda vez. Estos objetos se
2923 llaman @qq{spanners} u «objetos de extensión», y tienen propiedades
2924 especiales para controlar su apariencia y comportamiento. Algunas de
2925 estas propiedades son comunes a todos los objetos de extensión; otras
2926 se limitan a un subconjunto de los extensores.
2928 Todos los objetos de extensión contemplan el interface
2929 @code{spanner-interface}. Algunos, básicamente aquellos que trazan
2930 una línea recta entre los dos objetos, contemplan también el interface
2931 @code{line-spanner-interface}.
2934 * Uso del spanner-interface::
2935 * Uso del line-spanner-interface::
2938 @node Uso del spanner-interface
2939 @unnumberedsubsubsec Uso del @code{spanner-interface}
2940 @translationof Using the spanner-interface
2942 Este interface proporciona dos propiedades que se aplican a varios
2945 @subsubsubheading La propiedad @code{minimum-length} (longitud mínima)
2947 La longitud mínima del objeto de extensión se especifica a través
2948 de la propiedad @code{minimum-length}. Su aumento suele producir
2949 el efecto necesario de aumentar el espaciado de las notas entre
2950 los dos puntos extremos. Sin embargo, esta sobreescritura no
2951 tiene ningún efecto sobre muchos extensores, pues su longitud está
2952 determinada por otras consideraciones. Más abajo se muestran
2953 algunos ejemplos de dónde es efectiva.
2963 Works as long as callback is made:
2967 Works not at all for:
2976 @lilypond[verbatim,quote,relative=2]
2979 % increase the length of the tie
2980 -\tweak minimum-length #5
2984 @lilypond[verbatim,quote,relative=2]
2986 \compressFullBarRests
2988 % increase the length of the rest bar
2989 \once \override MultiMeasureRest.minimum-length = #20
2994 @lilypond[verbatim,quote,relative=2]
2996 % increase the length of the hairpin
2997 \override Hairpin.minimum-length = #20
3001 Esta sobreescritura se puede usar también para aumentar la longitud de
3002 las ligaduras de expresión y de fraseo:
3004 @lilypond[verbatim,quote,relative=2]
3007 -\tweak minimum-length #5
3012 -\tweak minimum-length #5
3016 Para algunos objetos de presentación, la propiedad
3017 @code{minimum-length} es efectiva sólo si se llama explícitamente al
3018 procedimiento @code{set-spacing-rods}. Para hacerlo, se debe fijar la
3019 propiedad @code{springs-and-rods} al valor
3020 @code{ly:spanner::set-spacing-rods}. Por ejemplo, la longitud mínima
3021 de un glissando no tiene efecto a no ser que se establezca la
3022 propiedad @code{springs-and-rods}:
3024 @lilypond[verbatim,quote,relative=1]
3028 % not effective alone
3029 \once \override Glissando.minimum-length = #20
3032 % effective only when both overrides are present
3033 \once \override Glissando.minimum-length = #20
3034 \once \override Glissando.springs-and-rods = #ly:spanner::set-spacing-rods
3038 Lo mismo se puede decir del objeto @code{Beam}:
3040 @lilypond[verbatim,quote,relative=1]
3041 % not effective alone
3042 \once \override Beam.minimum-length = #20
3045 % effective only when both overrides are present
3046 \once \override Beam.minimum-length = #20
3047 \once \override Beam.springs-and-rods = #ly:spanner::set-spacing-rods
3051 @subsubsubheading La propiedad @code{to-barline}
3053 La segunda propiedad útil del @code{spanner-interface} es
3054 @code{to-barline}. De forma predeterminada tiene el valor cierto,
3055 haciendo que los reguladores y otros objetos de extensión que terminan
3056 sobre la primera nota de un compás, en vez de eso terminen en la línea
3057 divisoria inmediatamente precedente. Si se establece al valor falso,
3058 el extensor llegará más allá de la barra de compás y terminará
3059 exactamente sobre la nota:
3061 @lilypond[verbatim,quote,relative=2]
3062 a \< a a a a \! a a a \break
3063 \override Hairpin.to-barline = ##f
3064 a \< a a a a \! a a a
3067 Esta propiedad no es efectiva para todos los extensores. Por ejemplo,
3068 su establecimiento a @code{#t} no tienen ningún efecto sobre las
3069 ligaduras de expresión o de fraseo, o sobre otros extensores para los
3070 que terminar en la barra de compás no tendría ningún significado.
3072 @node Uso del line-spanner-interface
3073 @unnumberedsubsubsec Uso del @code{line-spanner-interface}
3074 @translationof Using the line-spanner-interface
3076 Entre los objetos que contemplan el interface
3077 @code{line-spanner-interface} se encuentran
3080 @item @code{DynamicTextSpanner}
3081 @item @code{Glissando}
3082 @item @code{TextSpanner}
3083 @item @code{TrillSpanner}
3084 @item @code{VoiceFollower}
3087 La rutina responsable de dibujar los sellos de estos extensores es
3088 @code{ly:line-interface::print}. esta rutina determina la
3089 localización exacta de los dos puntos extremos y traza una línea entre
3090 ellos, en el estilo solicitado. Las posiciones de los dos puntos
3091 extremos del extensor se calculan al vuelo, pero es posible
3092 sobreescribir sus coordenadas Y. Las propiedades que se deben
3093 especificar están anidadas a dos niveles de profundidad en la
3094 jerarquía de propiedades, pero la sintaxis de la instrucción
3095 @code{\override} es bastante sencilla:
3097 @lilypond[relative=2,quote,verbatim]
3099 \once \override Glissando.bound-details.left.Y = #3
3100 \once \override Glissando.bound-details.right.Y = #-2
3104 Las unidades para la propiedad @code{Y} son @code{staff-space}s,
3105 siendo el punto del cero la línea central del pentagrama. Para el
3106 glissando, esto es el valor de @code{Y} en la coordenada X que
3107 corresponde al punto central de cada cabeza de nota si nos imaginamos
3108 que la línea se extiende hasta allí.
3110 Si no está fijado @code{Y}, su valor se calcula a partir de la
3111 posición vertical del punto de anclaje correspondiente del extensor.
3113 En caso de salto de línea, los valores para los puntos extremos se
3114 especifican por las sub-listas @code{left-broken} y
3115 @code{right-broken} de @code{bound-details}. Por ejemplo:
3117 @lilypond[relative=2,ragged-right,verbatim,quote]
3118 \override Glissando.breakable = ##t
3119 \override Glissando.bound-details.right-broken.Y = #-3
3120 c1 \glissando \break
3124 Un número de propiedades adicionales de las sub-listas @code{left} y
3125 @code{right} de la propiedad @code{bound-details} se pueden
3126 especificar de la misma forma que @code{Y}:
3130 Establece la coordenada Y del punto extremo, en desplazamientos de
3131 @code{staff-space}s desde la línea central del pentagrama. De forma
3132 predeterminada es el centro del objeto ancla, y así un glissando
3133 apunta al centro vertical de la cabeza de la nota.
3135 Para extensores horizontales como los extensores de texto y los
3136 trinos, está inamoviblemente codificado como 0.
3138 @item attach-dir (dirección de anclaje)
3139 Determina dónde comienza y termina la línea en la dirección X, con
3140 relación al objeto ancla. Sí, un valor de @w{@code{-1}} (o @code{LEFT},
3141 izquierda) hace que la línea comience o termine en el lado izquierdo
3142 de la cabeza de la nota a la que está anclado.
3145 Es la coordenada X absoluta del punto extremo. Se suele calcular al
3146 vuelo, y su sobreescritura no tiene un efecto útil.
3148 @item stencil (sello)
3149 Los extensores de línea pueden tener símbolos al comienzo o al final,
3150 lo que está contenido en esta sub-propiedad. Esto es para uso
3151 interno; se recomienda en su lugar el uso de @code{text}.
3154 Es un elemento de marcado que se evalúa para dar lugar al sello. Se
3155 usa para escribir @i{cresc.}, @i{tr} y otros textos sobre los objetos
3156 de extensión horizontales.
3158 @lilypond[quote,ragged-right,relative=2,verbatim]
3159 \override TextSpanner.bound-details.left.text
3160 = \markup { \small \bold Slower }
3161 c2\startTextSpan b c a\stopTextSpan
3164 @item stencil-align-dir-y (alineación del sello en y)
3165 @item stencil-offset (desplazamiento del sello)
3166 Si no se modifican uno u otro, el sello se coloca sencillamente en el
3167 punto extremo, centrado sobre la línea, como viene definido por las
3168 subpropiedades @code{X} e @code{Y}. Si se fijan
3169 @code{stencil-align-dir-y} o @code{stencil-offset} se moverá el
3170 símbolo del borde verticalmente con relación al extremo de la línea:
3172 @lilypond[relative=1,quote,verbatim]
3173 \override TextSpanner.bound-details.left.stencil-align-dir-y = #-2
3174 \override TextSpanner.bound-details.right.stencil-align-dir-y = #UP
3176 \override TextSpanner.bound-details.left.text = #"ggg"
3177 \override TextSpanner.bound-details.right.text = #"hhh"
3178 c4^\startTextSpan c c c \stopTextSpan
3181 Observe que los valores negativos mueven el texto @emph{hacia arriba},
3182 al contrario de lo que podría esperarse, pues el valor de @w{@code{-1}} o
3183 @code{DOWN} (abajo) significa alinear el borde @emph{inferior} del
3184 texto con la línea de extensión. Un valor de @code{1} o @code{UP}
3185 (arriba) alinea el borde superior del texto con la línea extensora.
3187 @item arrow (flecha)
3188 Al establecer esta sub-propiedad a @code{#t} se produce una punta de
3189 flecha en el extremo de la línea.
3191 @item padding (relleno)
3192 Esta sub-propiedad controla el espacio entre el punto extremo
3193 especificado de la línea y el extremo real. Sin relleno, un glissando
3194 empezaría y terminaría en el centro de la cabeza de las notas.
3198 La función musical @code{\endSpanners} finaliza de forma prematura el
3199 extensor que comienza sobre la nota que sigue inmediatamente a
3200 continuación. Se termina después de una nota exactamente, o en la
3201 siguiente barra de compás si @code{to-barline} es verdadero y se
3202 produce una divisoria antes de la siguiente nota.
3204 @lilypond[verbatim,quote,ragged-right,relative=2]
3206 c2 \startTextSpan c2 c2
3211 Si se usa @code{\endSpanners} no es necesario cerrar \startTextSpan
3212 con \stopTextSpan, ni cerrar los reguladores con @code{\!}.
3215 Referencia de funcionamiento interno:
3216 @rinternals{TextSpanner},
3217 @rinternals{Glissando},
3218 @rinternals{VoiceFollower},
3219 @rinternals{TrillSpanner},
3220 @rinternals{line-spanner-interface}.
3223 @node Visibilidad de los objetos
3224 @subsection Visibilidad de los objetos
3225 @translationof Visibility of objects
3227 @cindex objetos, visibilidad de
3228 @cindex grobs, visibilidad de
3229 @cindex visibilidad de los objetos
3231 Hay cuatro formas principales en que se puede controlar la visibilidad
3232 de los objetos de presentación: se puede eliminar su sello, se pueden
3233 volver transparentes, se pueden pintar de blanco, o se puede
3234 sobreescribir su propiedad @code{break-visibility}. Las tres primeras
3235 se aplican a todos los objetos de presentación; la última sólo a unos
3236 pocos: los objetos @emph{divisibles}. El Manual de aprendizaje
3237 introduce estas cuatro técnicas,
3238 véase @rlearning{Visibilidad y color de los objetos}.
3240 Hay también algunas otras técnicas que son específicas de ciertos
3241 objetos de presentación. Se estudian bajo Consideraciones especiales.
3244 * Eliminar el sello::
3245 * Hacer transparentes los objetos::
3246 * Pintar los objetos de blanco::
3247 * Uso de break-visibility (visibilidad en el salto)::
3248 * Consideraciones especiales::
3252 @node Eliminar el sello
3253 @unnumberedsubsubsec Eliminar el sello
3254 @translationof Removing the stencil
3256 @cindex sello, eliminar
3258 Todo objeto de presentación tiene una propiedad stencil (sello). De
3259 forma predeterminada está establecida a la función específica que
3260 dibuja ese objeto. Si se sobreescribe esta propiedad a @code{#f} no
3261 se llama a ninguna función y el objeto no se dibuja. La acción
3262 predeterminada se puede recuperar con @code{\revert}.
3264 @lilypond[quote,verbatim,relative=1]
3266 \override Score.BarLine.stencil = ##f
3268 \revert Score.BarLine.stencil
3273 @node Hacer transparentes los objetos
3274 @unnumberedsubsubsec Hacer transparentes los objetos
3275 @translationof Making objects transparent
3277 @cindex transparentes, hacer los objetos
3279 Todo objeto de presentación tiene una propiedad transparent
3280 (transparente) que de forma predeterminada está establecida a
3281 @code{#f}. Si se fija a @code{#t} el objeto aún ocupa espacio pero es
3284 @lilypond[quote,verbatim,relative=2]
3286 \once \override NoteHead.transparent = ##t
3291 @node Pintar los objetos de blanco
3292 @unnumberedsubsubsec Pintar los objetos de blanco
3293 @translationof Painting objects white
3295 @cindex objetos, coloreado de
3296 @cindex coloreado de objetos
3298 @cindex impresión, orden de
3299 @cindex sobreescritura de objetos
3300 @cindex objetos, sobreescritura de
3301 @cindex grobs, sobreescritura de
3303 Todo objeto de presentación tiene una propiedad de color que de forma
3304 predeterminada está establecida a @code{black} (negro). Si se
3305 sobreescribe a @code{white} (blanco) el objeto será indistinguible del
3306 fondo blanco. Sin embargo, si el objeto cruza a otros objetos, el
3307 color de los puntos de cruce queda determinado por el orden en que se
3308 dibujan estos objetos, lo que puede dejar una imagen fantasma del
3309 objeto blanco, como puede verse aquí:
3311 @lilypond[quote,verbatim,relative=2]
3312 \override Staff.Clef.color = #white
3316 Se puede evitar esto cambiando el orden de impresión de los objetos.
3317 Todos los objetos de presentación tienen una propiedad @code{layer}
3318 (capa) que se debe establecer a un valor entero. Los objetos con el
3319 valor de @code{layer} más bajo se dibujan primero, después se dibujan
3320 los objetos con valores progresivamente mayores, y así los objetos con
3321 valores más altos se dibujan encima de los que tienen valores más
3322 bajos. De forma predeterminada, casi todos los objetos tienen
3323 asignado un valor @code{layer} de @code{1}, aunque algunos objetos,
3324 entre ellos el pentagrama y las líneas divisorias, @code{StaffSymbol}
3325 y @code{BarLine}, tienen asignado un calor de @code{0}. El orden de
3326 impresión de los objetos con el mismo valor de @code{layer} es
3329 En el ejemplo de arriba, la clave blanca, con un valor @code{layer}
3330 predeterminado de @code{1}, se dibuja después de las líneas del
3331 pentagrama (valor @code{layer} predeterminado de @code{0}),
3332 sobreimpresionándolas. Para cambiarlo, se debe dar al objeto
3333 @code{Clef} un valor de @code{layer} más bajo, digamos @w{@code{-1}},
3334 para que se dibuje antes:
3336 @lilypond[quote,verbatim,relative=2]
3337 \override Staff.Clef.color = #white
3338 \override Staff.Clef.layer = #-1
3343 @node Uso de break-visibility (visibilidad en el salto)
3344 @unnumberedsubsubsec Uso de break-visibility (visibilidad en el salto)
3345 @translationof Using break-visibility
3347 @c TODO Add making other objects breakable
3349 @cindex break-visibility
3351 Casi todos los objetos de presentación se imprimen una sola vez, pero
3352 algunos como las líneas divisorias, claves, indicaciones de compás y
3353 armaduras de tonalidad, se pueden tener que imprimir dos veces cuando
3354 se produce un salto de línea : una vez al final de la línea y otra al
3355 comienzo de la siguiente. Estos objetos reciben el nombre de
3356 @emph{divisibles}, y tienen una propiedad, @code{break-visibility}
3357 (visibilidad en el salto), para controlar su visibilidad en las tres
3358 posiciones en que pueden aparecer: al comienzo de una línea, dentro de
3359 la línea si se produce un cambio, y al final de la línea si el cambio
3360 se produce en ese lugar.
3362 Por ejemplo, la indicación de compás se imprime de forma
3363 predeterminada al comienzo de la primera línea y en ningún otro lugar
3364 a no ser que cambie, en cuyo caso se imprime en el punto en que se
3365 produce el cambio. Si este cambio se produce al final de una línea,
3366 la nueva indicación de compás se imprime al principio de la línea
3367 siguiente y también al final de la línea anterior como indicación de
3370 Este comportamiento se controla por medio de la propiedad
3371 @code{break-visibility}, que se explica en
3372 @c Leave this ref on a newline - formats incorrectly otherwise -td
3373 @rlearning{Visibilidad y color de los objetos}. Esta propiedad toma un
3374 vector de tres valores booleanos que, por orden, determinan si el
3375 objeto se imprime al final, dentro, o al principio de la línea. O,
3376 para ser más exactos: antes del salto de línea, si no hay salto, o
3379 Como alternativa se puede especificar cualquiera de las ocho
3380 combinaciones mediante funciones predefinidas cuya definición está en
3381 @file{scm/output-lib.scm}, donde las tres últimas columnas indican si
3382 los objetos de presentación serán visibles en las posiciones que se
3383 muestran en el encabezamiento de cada columna:
3385 @multitable {@code{begin-of-line-invisible}} {@code{'#(#t #t #t)}} {Antes del} {Si no hay} {Después del}
3386 @headitem Forma @tab Forma @tab Antes del @tab Si no hay @tab Después del
3387 @headitem de función @tab de vector @tab salto @tab salto @tab salto
3389 @item @code{all-visible} @tab @code{'#(#t #t #t)} @tab sí @tab sí @tab sí
3390 @item @code{begin-of-line-visible} @tab @code{'#(#f #f #t)} @tab no @tab no @tab sí
3391 @item @code{center-visible} @tab @code{'#(#f #t #f)} @tab no @tab sí @tab no
3392 @item @code{end-of-line-visible} @tab @code{'#(#t #f #f)} @tab sí @tab no @tab no
3393 @item @code{begin-of-line-invisible} @tab @code{'#(#t #t #f)} @tab sí @tab sí @tab no
3394 @item @code{center-invisible} @tab @code{'#(#t #f #t)} @tab sí @tab no @tab sí
3395 @item @code{end-of-line-invisible} @tab @code{'#(#f #t #t)} @tab no @tab sí @tab sí
3396 @item @code{all-invisible} @tab @code{'#(#f #f #f)} @tab no @tab no @tab no
3399 Los ajustes predeterminados de @code{break-visibility} dependen del
3400 objeto de presentación. La tabla siguiente muestra todos los objetos
3401 de presentación de interés que resultan afectados por
3402 @code{break-visibility} y el ajuste predeterminado de esta propiedad:
3404 @multitable @columnfractions .3 .3 .4
3406 @headitem Objeto @tab Contexto usual @tab Valor predet.
3408 @c omit Ambitus as it appears not to be affected by break-visibility -td
3409 @c @item @code{Ambitus} @tab as specified @tab @code{begin-of-line-visible}
3410 @item @code{BarLine} @tab @code{Score} @tab calculado
3411 @item @code{BarNumber} @tab @code{Score} @tab @code{begin-of-line-visible}
3412 @c omit the following item until it can be explained -td
3413 @c @item @code{BreakAlignGroup} @tab @code{Score} @tab calculado
3414 @item @code{BreathingSign} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3415 @item @code{Clef} @tab @code{Staff} @tab @code{begin-of-line-visible}
3416 @item @code{Custos} @tab @code{Staff} @tab @code{end-of-line-visible}
3417 @item @code{DoublePercentRepeat} @tab @code{Voice} @tab @code{begin-of-line-invisible}
3418 @item @code{KeyCancellation} @tab @code{Staff} @tab @code{begin-of-line-invisible}
3419 @item @code{KeySignature} @tab @code{Staff} @tab @code{begin-of-line-visible}
3420 @c omit LeftEdge until it can be explained -td
3421 @c @item @code{LeftEdge} @tab @code{Score} @tab @code{center-invisible}
3422 @item @code{ClefModifier} @tab @code{Staff} @tab @code{begin-of-line-visible}
3423 @item @code{RehearsalMark} @tab @code{Score} @tab @code{end-of-line-invisible}
3424 @item @code{TimeSignature} @tab @code{Staff} @tab @code{all-visible}
3428 El ejemplo de abajo muestra el uso de la forma de vector para
3429 controlar la visibilidad de las líneas divisorias:
3431 @lilypond[quote,verbatim,relative=1,ragged-right]
3434 % Remove bar line at the end of the current line
3435 \once \override Score.BarLine.break-visibility = ##(#f #t #t)
3441 Aunque los tres componentes del vector utilizado para sobreescribir
3442 @code{break-visibility} deben estar presentes, no todos son efectivos
3443 para todos los objetos de presentación, y algunas combinaciones pueden
3444 incluso dar errores. Son de aplicación las siguientes limitaciones:
3447 @item Las líneas divisorias no se pueden imprimir al principio de la línea.
3448 @item No se puede imprimir el número de compás al principio de la primera
3449 línea a no ser que su valor establecido sea distinto de 1.
3450 @item Clave: véase más abajo
3451 @item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
3452 se suprimen por completo. Utilice begin-of line-invisible para
3453 imprimirlas y all-invisible para suprimirlas.
3454 @item Armadura: véase más abajo
3455 @item ClefModifier: véase más abajo
3459 @node Consideraciones especiales
3460 @unnumberedsubsubsec Consideraciones especiales
3461 @translationof Special considerations
3463 @subsubsubheading Visibilidad después de un cambio explícito
3465 @cindex armadura, visibilidad después de un cambio explícito
3466 @cindex explicitKeySignatureVisibility
3467 @cindex clave, visibilidad después de un cambio explícito
3468 @cindex explicitClefVisibility
3470 La propiedad @code{break-visibility} controla la visibilidad de las
3471 armaduras y cambios de clave sólo al principio de las líneas, es
3472 decir, después de un salto. No tiene ningún efecto sobre la
3473 visibilidad de la armadura o la clave después de un cambio explícito
3474 de tonalidad o de clave dentro o al final de una línea. En el ejemplo
3475 siguiente la armadura que sigue al cambio explícito de tonalidad a Si
3476 bemol mayor es visible incluso con @code{all-invisible} establecido.
3478 @lilypond[quote,verbatim,relative=1,ragged-right]
3481 % Try to remove all key signatures
3482 \override Staff.KeySignature.break-visibility = #all-invisible
3490 La visibilidad de estos cambios explícitos de tonalidad y de clave se
3491 controla por medio de las propiedades
3492 @code{explicitKeySignatureVisibility} y @code{explicitClefVisibility}.
3493 Son los equivalentes de la propiedad @code{break-visibility} y las dos
3494 toman un vector de tres valores booleanos o las funciones predefinidas
3495 relacionadas anteriormente, exactamente igual que
3496 @code{break-visibility}. Las dos son propiedades del contexto Staff,
3497 no de los propios objetos de presentación, y por tanto se establecen
3498 utilizando la instrucción @code{\set}. Las dos están establecidas de
3499 forma predeterminada al valor @code{all-visible}. Estas propiedades
3500 controlan sólo la visibilidad de las armaduras y las claves que
3501 resultan de los cambios explícitos y no afectan a las armaduras y
3502 tonalidades que están al principio de las líneas; para quitarlas, aún
3503 se debe sobreescribir la propiedad @code{break-visibility} en el
3504 objeto correspondiente.
3506 @lilypond[quote,verbatim,relative=1,ragged-right]
3509 \set Staff.explicitKeySignatureVisibility = #all-invisible
3510 \override Staff.KeySignature.break-visibility = #all-invisible
3517 @subsubsubheading Visibilidad de las alteraciones de precaución
3519 Para eliminar las alteraciones de cancelación que se imprimen en un
3520 cambio de tonalidad explícito, establezca la propiedad
3521 @code{printKeyCancellation} del contexto Staff a @code{#f}:
3523 @lilypond[quote,verbatim,relative=1,ragged-right]
3526 \set Staff.explicitKeySignatureVisibility = #all-invisible
3527 \set Staff.printKeyCancellation = ##f
3528 \override Staff.KeySignature.break-visibility = #all-invisible
3535 Con estas sobreescrituras solamente permanecen las alteraciones
3536 accidentales delante de las notas para indicar el cambio de tonalidad.
3538 Observe que al modificar la tonalidad a Do@tie{}mayor o
3539 La@tie{}menor, las alteraciones de cancelación serían @emph{la
3540 única} indicación del cambio de armadura. En este caso, el
3541 establecimiento de @code{printKeyCancellation} al valor @code{#f}
3542 no tiene ningún efecto:
3544 @lilypond[quote,verbatim,relative=1,ragged-right]
3547 \set Staff.explicitKeySignatureVisibility = #all-invisible
3548 \set Staff.printKeyCancellation = ##f
3555 En lugar de ello, para suprimir las alteraciones de cancelación
3556 aún cuando la armadura cambia a Do@tie{}mayor o a La@tie{}menor,
3557 sobreescriba la visibilidad del grob @code{KeyCancellation}:
3559 @lilypond[quote,verbatim,relative=1,ragged-right]
3562 \set Staff.explicitKeySignatureVisibility = #all-invisible
3563 \override Staff.KeyCancellation.break-visibility = #all-invisible
3570 @c TODO Add visibility of cautionary accidentals before notes
3572 @subsubsubheading Líneas divisorias automáticas
3574 @cindex automaticBars
3575 @cindex líneas divisorias, eliminación
3577 Como caso especial, la impresión de las líneas divisorias también se
3578 puede inhabilitar estableciendo la propiedad @code{automaticBars} en
3579 el contexto Score. Si se fija a @code{#f}, las barras de compás no se
3580 imprimen automáticamente; se deben crear explícitamente con una
3581 instrucción @code{\bar}. A diferencia de la instrucción predefinida
3582 @code{\cadenzaOn}, los compases se siguen contando. La generación de
3583 compases continúa de acuerdo a esta cuenta si esta propiedad se
3584 establece posteriormente a @code{#t}. Si se fija al valor @code{#f},
3585 sólo pueden producirse saltos de línea en instrucciones @code{\bar}
3590 @subsubsubheading Claves transportadas
3592 @cindex transportadas, visibilidad de las claves
3593 @cindex visibilidad de las claves transportadas
3594 @cindex claves, visibilidad de la transposición
3596 El pequeño símbolo de transposición sobre una clave se produce por
3597 parte del objeto @code{ClefModifier}. Su visibilidad se hereda
3598 automáticamente de la del objeto @code{Clef}, así que no es
3599 necesario aplicar las sobreescrituras correspondientes
3600 @code{break-visibility} a los objetos @code{ClefModifier} para
3601 suprimir los símbolos de transposición u octavación para las
3604 Para los cambios de clave explícitos, la propiedad
3605 @code{explicitClefVisibility} controla tanto el símbolo de clave
3606 como el símbolo de transposición o de octava asociado.
3609 Manual de aprendizaje:
3610 @rlearning{Visibilidad y color de los objetos}
3613 @node Estilos de línea
3614 @subsection Estilos de línea
3615 @translationof Line styles
3617 Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
3618 @i{accelerando} y los @i{trinos} se escriben como texto y se extienden
3619 sobre muchos compases mediante líneas, a veces punteadas u onduladas.
3621 Todos ellos usan las mismas rutinas que el glissando para dibujar los
3622 textos y las líneas, y por ello el ajuste fino de su comportamiento se
3623 hace de la misma manera. Se hace con un spanner (un objeto de
3624 extensión), y la rutina responsable de dibujar los objetos de
3625 extensión es @code{ly:line-interface::print}. Esta rutina determina la
3626 colocación exacta de los dos @i{extremos del objeto de extensión} y
3627 dibuja una línea entre ellos, en el estilo solicitado.
3629 He aquí un ejemplo de los distintos estilos de línea disponibles, y
3630 cómo aplicarles ajustes finos.
3632 @lilypond[relative=2,ragged-right,verbatim,quote]
3634 \once \override Glissando.style = #'dashed-line
3636 \override Glissando.style = #'dotted-line
3638 \override Glissando.style = #'zigzag
3640 \override Glissando.style = #'trill
3644 Las posiciones de los puntos extremos del objeto de extensión se
3645 computan al vuelo para cada uno de los objetos gráficos, pero es
3646 posible sobreescribirlos:
3649 @lilypond[relative=2,ragged-right,verbatim,quote]
3651 \once \override Glissando.bound-details.right.Y = #-2
3655 El valor de @code{Y} está establecido a @w{@code{-2}} para el extremo
3656 derecho. El lado izquierdo se puede ajustar de forma similar
3657 especificando @code{left} en vez de @code{right}.
3659 Si no está establecido @code{Y}, el valor se computa a partir de la
3660 posición vertical de los puntos de anclaje izquierdo y derecho del
3663 Son posibles otros ajustes de los extensores, para ver más detalles
3664 consulte @ref{Objetos de extensión}.
3667 @node Rotación de objetos
3668 @subsection Rotación de objetos
3669 @translationof Rotating objects
3671 Tanto los objetos de presentación como los elementos de texto de
3672 marcado se pueden girar cualquier ángulo respecto a cualquier punto,
3673 pero difiere el método de hacerlo.
3676 * Rotación de objetos de presentación::
3677 * Rotación de elementos de marcado::
3680 @node Rotación de objetos de presentación
3681 @unnumberedsubsubsec Rotación de objetos de presentación
3682 @translationof Rotating layout objects
3684 @cindex rotating objects
3685 @cindex objects, rotating
3687 Todos los objetos de presentación que contemplan el interface
3688 @code{grob-interface} se pueden rotar estableciendo su propiedad
3689 @code{rotation}. Acepta una lista de tres elementos: el ángulo de la
3690 rotación en sentido antihorario, y las coordenadas x e y del punto con
3691 relación al punto de referencia del objeto, alrededor del que se va a
3692 realizar la rotación. El ángulo de rotación se especifica en grados
3693 y las coordenadas en espacios de pentagrama.
3695 El ángulo de rotación y las coordenadas del punto de rotación se deben
3696 determinar por ensayo y error.
3698 @cindex reguladores en ángulo
3699 @cindex ángulo, reguladores en
3701 Solamente en ciertas ocasiones es útil la rotación de objetos de
3702 presentación; el ejemplo siguiente muestra una situación en que puede
3705 @lilypond[quote,verbatim,relative=1]
3707 \override Hairpin.rotation = #'(20 -1 0)
3712 @node Rotación de elementos de marcado
3713 @unnumberedsubsubsec Rotación de elementos de marcado
3714 @translationof Rotating markup
3716 Todos los textos de marcado se pueden rotar para que se dispongan en
3717 cualquier ángulo precediéndolos de la instrucción @code{\rotate}. La
3718 instrucción acepta dos argumentos: el ángulo de rotación en grados en
3719 sentido antihorario, y el texto que rotar. Los límites que ocupa el
3720 texto no se rotan: toman su valor a partir de los extremos de las
3721 coordenadas x e y del texto rotado. En el ejemplo siguiente la
3722 propiedad @code{outside-staff-priority} del texto se establece a
3723 @code{#f} para desactivar la evitación automática de colisiones, lo
3724 que empuja al texto a una posición muy alta.
3726 @lilypond[quote,verbatim,relative=1]
3727 \override TextScript.outside-staff-priority = ##f
3728 g4^\markup { \rotate #30 "a G" }
3729 b^\markup { \rotate #30 "a B" }
3730 des^\markup { \rotate #30 "a D-Flat" }
3731 fis^\markup { \rotate #30 "an F-Sharp" }
3735 @node Trucos avanzados
3736 @section Trucos avanzados
3737 @translationof Advanced tweaks
3739 Esta sección trata sobre distintos enfoques en la realización de
3740 ajustes finos a la apariencia de la partitura impresa.
3743 * Alineación de objetos::
3744 * Agrupación vertical de objetos gráficos::
3745 * Modificación de los sellos::
3746 * Modificación de las formas::
3747 * Contenedores unpure-pure::
3751 Manual de aprendizaje:
3752 @rlearning{Trucar la salida},
3753 @rlearning{Otras fuentes de información}.
3755 Referencia de la notación:
3756 @ref{Explicación del Manual de referencia de funcionamiento interno},
3757 @ref{Modificar las propiedades}.
3759 Manual de extensión:
3760 @rextend{Interfaces para programadores}.
3763 @file{scm/define-grobs.scm}.
3765 Fragmentos de código:
3766 @rlsr{Tweaks and overrides}.
3768 Referencia de funcionamiento interno:
3769 @rinternals{All layout objects}.
3772 @node Alineación de objetos
3773 @subsection Alineación de objetos
3774 @translationof Aligning objects
3776 Los objetos gráficos que soportan el interface
3777 @code{self-alignment-interface} y/o el @code{side-position-interface}
3778 se pueden alinear contra un objeto colocado previamente, de diversas
3779 maneras. Para ver una lista de estos objetos, consulte
3780 @rinternals{self-alignment-interface} y
3781 @rinternals{side-position-interface}.
3783 Todos los objetos gráficos tienen un punto de referencia, una
3784 extensión horizontal y una extensión vertical. La extensión
3785 horizontal es una pareja de números que dan los desplazamientos a
3786 partir del punto de referencia de los bordes izquierdo y derecho,
3787 siendo negativos los desplazamientos hacia la izquierda. La extensión
3788 vertical es una pareja de números que dan el desplazamiento a partir
3789 del punto de referencia hasta los bordes inferior y superior, siendo
3790 negativos los desplazamientos hacia abajo.
3792 La posición de un objeto sobre el pentagrama viene dada por los
3793 valores de las propiedades @code{X-offset} e @code{Y-offset}. El
3794 valor de @code{X-offset} da el desplazamiento desde la coordenada X
3795 del punto de referencia del objeto padre, y el valor de
3796 @code{Y-offset} da el desplazamiento a partir de la línea central del
3797 pentagrama. Los valores de @code{X-offset} y @code{Y-offset} se
3798 pueden establecer directamente o se puede dejar que se calculen por
3799 parte de procedimientos para conseguir una alineación con el objeto
3802 @warning{Muchos objetos tienen consideraciones de posicionamiento
3803 especiales que hacen que se ignore o se modifique cualquier ajuste
3804 realizado a @code{X-offset} o a @code{Y-offset}, a pesar de que el
3805 objeto contemple el interface @code{self-alignment-interface}. La
3806 sobreescritura de las propiedades @code{X-offset} ó @code{Y-offset} a
3807 un valor fijo hace que se descarte la respectiva propiedad
3808 @code{self-alignment}.}
3810 Por ejemplo, una alteración accidental se puede reposicionar
3811 verticalmente estableciendo @code{Y-offset} pero los cambios a
3812 @code{X-offset} no tienen ningún efecto.
3814 Las letras de ensayo se pueden alinear con objetos divisibles como
3815 líneas divisorias, claves, armaduras e indicaciones de compás. Hay
3816 propiedades especiales que se encuentran en
3817 @code{break-aligned-interface} para el posicionamiento de las letras
3818 de ensayo sobre dichos objetos.
3821 Referencia de la notación:
3822 @ref{Uso del break-alignable-interface}.
3824 Manual de extensión:
3825 @rextend{Funciones de callback}.
3828 * Establecer directamente X-offset e Y-offset::
3829 * Uso del side-position-interface::
3830 * Uso del self-alignment-interface::
3831 * Uso del break-alignable-interface::
3835 @node Establecer directamente X-offset e Y-offset
3836 @unnumberedsubsubsec Establecer directamente @code{X-offset} y @code{Y-offset}
3837 @translationof Setting X-offset and Y-offset directly
3839 Se pueden dar valores numéricos a las propiedades @code{X-offset} y
3840 @code{Y-offset} de muchos objetos. El ejemplo siguiente muestra tres
3841 notas con una digitación en su posición predeterminada y con los
3842 valores @code{X-offset} y @code{Y-offset} modificados.
3844 @lilypond[verbatim,quote,relative=2]
3851 -\tweak X-offset #-1
3859 @node Uso del side-position-interface
3860 @unnumberedsubsubsec Uso del @code{side-position-interface}
3861 @translationof Using the side-position-interface
3863 Un objeto que contempla el @code{side-position-interface} se puede
3864 colocar junto a su objeto padre de forma que los bordes especificados
3865 de los dos objetos se toquen. El objeto se puede situar encima,
3866 debajo, a la derecha o a la izquierda del objeto padre. El padre no
3867 se puede especificar; viene determinado por el orden de los elementos
3868 en el flujo de entrada. Casi todos los objetos tienen la cabeza de la
3869 nota asociada como padre.
3871 Los valores de las propiedades @code{side-axis} y @code{direction}
3872 determinan dónde colocar el objeto, como sigue:
3874 @c TODO add an example of each to the table
3876 @multitable @columnfractions .3 .3 .3
3877 @headitem @code{side-axis} @tab @code{direction} @tab
3878 @headitem propiedad @tab propiedad @tab colocación
3880 @item @code{0} @tab @w{@code{-1}} @tab izquierda
3881 @item @code{0} @tab @code{1} @tab derecha
3882 @item @code{1} @tab @w{@code{-1}} @tab debajo
3883 @item @code{1} @tab @code{1} @tab encima
3887 Si @code{side-axis} es @code{0}, @code{X-offset} se debe establecer al
3888 procedimiento @code{ly:side-position-interface::x-aligned-side}. Este
3889 procedimiento devuelve el calor correcto de @code{X-offset} para
3890 situar el objeto al lado izquierdo o derecho del padre de acuerdo con
3891 el valor de @code{direction}.
3893 Si @code{side-axis} es @code{1}, @code{Y-offset} se debe establecer al
3894 procedimiento @code{ly:side-position-interface::y-aligned-side}. Este
3895 procedimiento devuelve el valor correcto de @code{Y-offset} para
3896 situar el objeto encima o debajo del padre de acuerdo con el valor de
3899 @c TODO Add examples
3902 @node Uso del self-alignment-interface
3903 @unnumberedsubsubsec Uso del @code{self-alignment-interface}
3904 @translationof Using the self-alignment-interface
3906 @subsubsubheading Auto-alineación horizontal de los objetos
3908 La alineación horizontal de un objeto que contempla el interface
3909 @code{self-alignment-interface} está controlada por el valor de la
3910 propiedad @code{self-alignment-X}, siempre y cuando la propiedad
3911 @code{X-offset} de este objeto esté establecida a
3912 @code{ly:self-alignment-interface::x-aligned-on-self}. Se le puede
3913 dar a @code{self-alignment-X} cualquier valor real, en unidades de la
3914 mitad de la extensión X total del objeto. Los valores negativos
3915 mueven el objeto a la derecha, los positivos hacia la izquierda. Un
3916 valor de @code{0} centra el objeto sobre el punto de referencia de su
3917 padre, un valor de @w{@code{-1}} alinea el borde izquierdo del objeto
3918 sobre el punto de referencia de su padre, y un valor de @code{1}
3919 alinea el borde derecho del objeto sobre el punto de referencia de su
3920 padre. Se pueden usar los símbolos @code{LEFT}, @code{CENTER} y
3921 @code{RIGHT} en sustitución de los valores @w{@code{-1}}, @code{0} y @code{1},
3924 Normalmente se usaría la instrucción @code{\override} para modificar
3925 el valor de @code{self-alignment-X}, pero se puede usar la instrucción
3926 @code{\tweak} para alinear varias anotaciones por separado sobre una
3929 @lilypond[quote,verbatim,relative=1]
3931 -\tweak self-alignment-X #-1
3933 -\tweak self-alignment-X #0
3935 -\tweak self-alignment-X #RIGHT
3937 -\tweak self-alignment-X #-2.5
3938 ^"aligned further to the right"
3941 @subsubsubheading Auto-alineación vertical de los objetos
3943 Los objetos se pueden alinear verticalmente en una forma análoga a la
3944 alineación horizontal si la propiedad @code{Y-offset} está establecida
3945 a @code{ly:self-alignment-interface::y-aligned-on-self}. Sin embargo,
3946 a menudo se encuentran implicados otros mecanismos en la alineación
3947 vertical: el valor de @code{Y-offset} es tan sólo una variable que se
3948 tiene en cuenta. Esto puede hacer que ajustar el valor de ciertos
3949 objetos sea una tarea dificultosa. Las unidades son sólo la mitad de
3950 las dimensiones verticales del objeto, que suele ser bastante pequeño,
3951 por lo que pueden requerirse números bastante grandes. Un valor de
3952 @w{@code{-1}} alinea el borde inferior del objeto con el punto de
3953 referencia del objeto padre, un valor de @code{0} alinea el centro del
3954 objeto con el punto de referencia del padre, y un valor de @code{1}
3955 alinea el borde superior del objeto con el punto de referencia del
3956 padre. Se pueden usar los símbolos @code{DOWN}, @code{CENTER},
3957 @code{UP} en sustitución de @w{@code{-1}},
3958 @code{0} y @code{1}, respectivamente.
3960 @emph{Auto-alineación de objetos en las dos direcciones}
3962 Estableciendo tanto @code{X-offset} como @code{Y-offset}, se puede
3963 alinear un objeto en las dos direcciones simultáneamente.
3965 El ejemplo siguiente muestra cómo ajustar una digitación de forma que
3966 se acerque a la cabeza de la nota.
3968 @lilypond[quote,verbatim,relative=2]
3970 -\tweak self-alignment-X #0.5 % move horizontally left
3971 -\tweak Y-offset #ly:self-alignment-interface::y-aligned-on-self
3972 -\tweak self-alignment-Y #-1 % move vertically up
3977 @unnumberedsubsubsec Uso de los procedimientos @code{aligned-on-parent}
3979 @c Cannot document as they do not seem to operate consistently on all objects -td
3980 @c TODO investigate further
3982 The @code{aligned-on-parent} procedures are used in the same way
3983 as the @code{aligned-on-self} procedures, they difference being
3984 that they permit an object to be aligned with the @emph{edges} of
3985 the parent rather than the parent's reference point. The following
3986 example shows the difference:
3990 @lilypond[verbatim,quote]
3996 @unnumberedsubsubsec Uso de los procedimientos @code{centered-on-parent}
3998 @c Cannot document as they do not seem to operate consistently on all objects -td
3999 @c TODO investigate further
4003 @c TODO The align-interface, BassFigureAlignment and VerticalAlignment
4006 @node Uso del break-alignable-interface
4007 @unnumberedsubsubsec Uso del @code{break-alignable-interface}
4008 @translationof Using the break-alignable-interface
4010 @cindex alineación a objetos
4011 @cindex break-align-symbols
4013 Las letras de ensayo se pueden alinear con objetos de notación
4014 distintos a las barras de compás. Estos objetos son @code{ambitus},
4015 @code{breathing-sign}, @code{clef}, @code{custos}, @code{staff-bar},
4016 @code{left-edge}, @code{key-cancellation}, @code{key-signature} y
4017 @code{time-signature}.
4019 Cada tipo de objeto tiene su propio punto de referencia
4020 predeterminado, con el que se alinean las marcas de ensayo:
4022 @lilypond[verbatim,quote,relative=1]
4023 % The rehearsal mark will be aligned to right edge of the Clef
4024 \override Score.RehearsalMark.break-align-symbols = #'(clef)
4029 % The rehearsal mark will be centered above the Time Signature
4030 \override Score.RehearsalMark.break-align-symbols = #'(time-signature)
4036 % The rehearsal mark will be centered above the Breath Mark
4037 \override Score.RehearsalMark.break-align-symbols = #'(breathing-sign)
4046 Se puede especificar una lista de posibles objetos para la alineación.
4047 Si algunos de los objetos son invisibles en ese punto debido al valor
4048 de @code{break-visibility} o a valores de visibilidad explícitos para
4049 las armaduras y las claves, la letra de ensayo o número de compás se
4050 alinean con el primer objeto de la lista que sea visible. Si ningún
4051 objeto de la lista es visible, el objeto se alinea con la línea
4052 divisoria. Si la línea divisoria es invisible, el objeto se alinea
4053 con el punto en el que se encontraría la línea divisoria.
4055 @lilypond[verbatim,quote,relative=1]
4056 % The rehearsal mark will be aligned to the right edge of the Key Signature
4057 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4062 % The rehearsal mark will be aligned to the right edge of the Clef
4063 \set Staff.explicitKeySignatureVisibility = #all-invisible
4064 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4069 % The rehearsal mark will be centered above the Bar Line
4070 \set Staff.explicitKeySignatureVisibility = #all-invisible
4071 \set Staff.explicitClefVisibility = #all-invisible
4072 \override Score.RehearsalMark.break-align-symbols = #'(key-signature clef)
4079 La alineación de la letra de ensayo con relación al objeto de notación
4080 se puede cambiar, como se ve en el ejemplo siguiente. En una
4081 partitura con varios pentagramas, este ajuste se debe hacer para todos
4084 @lilypond[verbatim,quote,relative=1]
4085 % The RehearsalMark will be aligned with the right edge of the Key Signature
4086 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4092 % The RehearsalMark will be centered above the Key Signature
4093 \once \override Score.KeySignature.break-align-anchor-alignment = #CENTER
4097 % The RehearsalMark will be aligned with the left edge of the Key Signature
4098 \once \override Score.KeySignature.break-align-anchor-alignment = #LEFT
4104 La letra de ensayo también se puede desplazar al borde derecho o
4105 izquierdo en una medida arbitraria. Las unidades son espacios de
4108 @lilypond[verbatim,quote,relative=1]
4109 % The RehearsalMark will be aligned with the left edge of the Key Signature
4110 % and then shifted right by 3.5 staff-spaces
4111 \override Score.RehearsalMark.break-align-symbols = #'(key-signature)
4112 \once \override Score.KeySignature.break-align-anchor = #3.5
4116 % The RehearsalMark will be aligned with the left edge of the Key Signature
4117 % and then shifted left by 2 staff-spaces
4118 \once \override Score.KeySignature.break-align-anchor = #-2
4125 @node Agrupación vertical de objetos gráficos
4126 @subsection Agrupación vertical de objetos gráficos
4127 @translationof Vertical grouping of grobs
4129 @c TODO Expand this section
4131 Los grobs (objetos gráficos) @code{VerticalAlignment} y
4132 @code{VerticalAxisGroup} trabajan de manera coordinada.
4133 @code{VerticalAxisGroup} agrupa distintos grobs como @code{Staff},
4134 @code{Lyrics}, etc. Después, @code{VerticalAlignment} alinea los
4135 distintos grobs agrupados previamente por @code{VerticalAxisGroup}.
4136 Normalmente sólo existe un @code{VerticalAlignment} por cada
4137 partitura, pero cada @code{Staff}, @code{Lyrics}, etc. tiene su propio
4138 @code{VerticalAxisGroup}.
4141 @node Modificación de los sellos
4142 @subsection Modificación de los sellos
4143 @translationof Modifying stencils
4145 Todos los objetos de presentación tienen una propiedad @code{stencil}
4146 que es parte del @code{grob-interface}. De forma predeterminada, esta
4147 propiedad suele estar establecida a una función específica del objeto
4148 que está hecha a medida para disponer el símbolo que lo representa en
4149 la salida. Por ejemplo, el ajuste estándar para la propiedad
4150 @code{stencil} del objeto @code{MultiMeasureRest} es
4151 @code{ly:multi-measure-rest::print}.
4153 El símbolo estándar de cualquier objeto se puede sustituir modificando
4154 la propiedad @code{stencil} para que haga referencia a un
4155 procedimiento diferente escrito especialmente. Esto requiere un alto
4156 nivel de conocimiento del funcionamiento interno de LilyPond, pero hay
4157 una forma más fácil que a menudo puede dar resultados adecuados.
4159 El procedimiento es establecer la propiedad @code{stencil} al
4160 procedimiento que imprime texto (@code{ly:text-interface::print}) y
4161 añadir una propiedad @code{text} al objeto ajustada para que contenga
4162 el texto de marcado que produce el símbolo requerido. Debido a la
4163 flexibilidad del marcado, se pueden conseguir muchas cosas; en
4164 particular, consulte @ref{Notación gráfica dentro de elementos de marcado}.
4166 El ejemplo siguiente muestra esto cambiando el símbolo de la cabeza de
4167 la nota a unas aspas dentro de una circunferencia.
4169 @lilypond[verbatim,quote]
4171 \once \override NoteHead.stencil = #ly:text-interface::print
4172 \once \override NoteHead.text = \markup {
4174 \halign #-0.7 \draw-circle #0.85 #0.2 ##f
4175 \musicglyph #"noteheads.s2cross"
4183 Cualquiera de los glifos de la fuente tipográfica Feta se puede pasar
4184 a la instrucción de marcado @code{\musicglyph}: véase @ref{La tipografía Feta}.
4186 @c TODO Add inserting eps files or ref to later
4188 @c TODO Add inserting Postscript or ref to later
4191 Referencia de la notación:
4192 @ref{Notación gráfica dentro de elementos de marcado},
4193 @ref{Formatear el texto},
4194 @ref{Text markup commands},
4195 @ref{La tipografía Feta}.
4198 @node Modificación de las formas
4199 @subsection Modificación de las formas
4200 @translationof Modifying shapes
4203 * Modificación de ligaduras de unión y de expresión::
4207 @node Modificación de ligaduras de unión y de expresión
4208 @unnumberedsubsubsec Modificación de ligaduras de unión y de expresión
4209 @translationof Modifying ties and slurs
4211 @cindex ligaduras de expresión, modificar
4212 @cindex ligaduras de unión, modificar
4213 @cindex Bézier, curvas de, puntos de control
4214 @cindex puntos de control en curvas de Bézier
4216 Las ligaduras de unión (@code{Tie}s), de expresión (@code{Slur}s),
4217 de fraseo (@code{PhrasingSlur}s), de dejar vibrar
4218 (@code{LaissezVibrerTie}s) y de repetición (@code{RepeatTie}s) se
4219 trazan como curvas de Bézier de tercer orden. Si la forma de la
4220 ligadura calculada automáticamente no resulta óptima, se puede
4221 modificar su forma manualmente de dos formas:
4225 mediante la especificación de los desplazamientos que se quieren
4226 realizar sobre los puntos de control de la curva de Bézier
4227 calculada automáticamente, o bien
4230 mediante la especificación explícita de las posiciones de los
4231 cuatro puntos de control que se requieren para definir la curva
4235 A continuación se explican ambos métodos. El primer método es más
4236 adecuado cuando solo se requieren ligeros ajustes de la curva; el
4237 segundo puede ser mejor para crear curvas que tienen relación con
4240 @subsubsubheading Curvas de Bézier cúbicas
4242 Las curvas Bézier de tercer orden o cúbicas están definidas por
4243 cuatro puntos de control. El primer y cuarto puntos de control
4244 son exactamente los puntos extremos de comienzo y de final de la
4245 curva. Los dos puntos de control intermedios definen la forma.
4246 Se pueden encontrar en la web animaciones que muestran cómo se
4247 traza la curva, pero la descripción siguiente puede ser de ayuda.
4248 La curva comienza a partir del primer punto de control
4249 dirigiéndose directamente hacia el segundo, curvándose
4250 progresivamente para dirigirse hacia el tercero y continuando la
4251 curva hacia el cuarto, llegando a éste en viaje directo desde el
4252 tercer punto de control. La curva está contenida enteramente
4253 dentro del cuadrilátero definido por los cuatro puntos de control.
4254 Todas las traslaciones, rotaciones y escalado de los puntos de
4255 control producen exactamente las mismas operaciones sobre la
4258 @subsubsubheading Especificar desplazamientos a partir de los puntos de control actuales
4260 @cindex conformar ligaduras
4263 En este ejemplo, la colocación automática de la ligadura no
4264 resulta óptima, y @code{\tieDown} no es la solución.
4266 @lilypond[verbatim,quote,relative=1]
4270 { r4 <g c,> <g c,> <g c,> }
4274 El ajuste de los puntos de control de la ligadura mediante la
4275 instrucción @code{\shape} permite evitar las colisiones.
4277 La sintaxis de @code{\shape} es:
4280 [-]@code{\shape} @var{desplazamientos} @var{elemento}
4283 Esta instrucción recoloca los puntos de control de @var{elemento}
4284 en las cantidades dadas por @var{desplazamientos}. El argumento
4285 @var{desplazamientos} es una lista de parejas de números o una
4286 lista de tales listas. Cada elemento de una pareja representa el
4287 desplazamiento de una de las coordenadas de un punto de control.
4288 Si el @var{elemento} es una cadena de caracteres, el resultado es
4289 @code{\once\override} para el tipo de grob especificado. Si
4290 @var{elemento} es una expresión musical, el resultado es la misma
4291 expresión musical con la consiguiente modificación aplicada.
4293 En otras palabras, la función @code{\shape} puede actuar como una
4294 instrucción @code{\once\override} o como una instrucción
4295 @code{\tweak} dependiendo de si el argumento @var{elemento} es el
4296 nombre de un grob, como @qq{Slur}, o una expresión musical, como
4297 @qq{(}. El argumento @var{desplazamientos} especifica los
4298 desplazamientos de los cuatro puntos de control como una lista de
4299 cuatro parejas de valores (dx . dy) en unidades de espacios de
4300 pentagrama (o una lista de tales listas si la curva tiene más de
4303 El guión precedente se exige si, y sólo si, se usa la forma
4306 Así, usando el mismo ejemplo de arriba y la forma
4307 @code{\once\override} de la instrucción @code{\shape}, lo
4308 siguiente tiene el efecto de elevar la ligadura de unión en la
4309 mitad de un espacio de pentagrama:
4311 @lilypond[verbatim,quote,relative=1]
4314 \shape #'((0 . 0.5) (0 . 0.5) (0 . 0.5) (0 . 0.5)) Tie
4318 { r4 <g c,> <g c,> <g c,> }
4322 Este posicionamiento de la ligadura de unión es mejor, pero quizá
4323 debería elevarse más en la parte central. El ejemplo siguiente
4324 hace esto, esta vez usando la forma alternativa @code{\tweak}:
4326 @lilypond[verbatim,quote,relative=1]
4329 e1-\shape #'((0 . 0.5) (0 . 1) (0 . 1) (0 . 0.5)) ~ e
4332 { r4 <g c,> <g c,> <g c,> }
4336 Los cambios en las posiciones horizontales de los puntos de
4337 control se pueden hacer de la misma forma, y dos curvas distintas
4338 que dan comienzo en el mismo momento musical se pueden conformar
4341 @lilypond[verbatim,quote,ragged-right,relative=2]
4343 \shape #'((0.7 . -0.4) (0.5 . -0.4) (0.3 . -0.3) (0 . -0.2)) Slur
4344 \shape #'((0 . 0) (0 . 0.5) (0 . 0.5) (0 . 0)) PhrasingSlur
4348 La función @code{\shape} también puede desplazar los puntos de
4349 control de las curvas que se extienden atravesando saltos de
4350 línea. Cada pieza de la curva dividida puede recibir su propia
4351 lista de desplazamientos. Si no se necesita hacer cambios a uno
4352 de los segmentos en particular, se puede usar una lista vacía como
4353 contenedor. En este ejemplo, el salto de línea hace que la única
4354 ligadura de expresión aparezca como si fueran dos:
4356 @lilypond[verbatim,quote,ragged-right,relative=1]
4362 Los cambios en la forma de las dos mitades de la ligadura de
4363 expresión deja más claro que la ligadura continúa más allá del
4366 @lilypond[verbatim,quote,ragged-right,relative=1]
4367 % () may be used as a shorthand for ((0 . 0) (0 . 0) (0 . 0) (0 . 0))
4368 % if any of the segments does not need to be changed
4370 (( 0 . 0) (0 . 0) (0 . 0) (0 . 1))
4371 ((0.5 . 1.5) (1 . 0) (0 . 0) (0 . -1.5))
4378 En una curva en forma de «S» siempre es necesario ajustar
4379 manualmente los puntos de control: LilyPond nunca escoge tales
4380 formas automáticamente.
4382 @lilypond[verbatim,quote,relative=2]
4383 c8( e b-> f d' a e-> g)
4384 \shape #'((0 . -1) (5.5 . -0.5) (-5.5 . -10.5) (0 . -5.5)) PhrasingSlur
4385 c8\( e b-> f d' a e-> g\)
4388 @subsubsubheading Especificar los puntos de control explícitamente
4390 Las coordenadas de los puntos de contro de Bézier se especifican
4391 en unidades de espacios de pentagrama. La coordenada@tie{}X es
4392 relativa al punto de referencia al que se adjunta la ligadura, y
4393 la coordenada@tie{}Y es relativa a la línea central del
4394 pentagrama. Las coordenadas se especifican como una lista de
4395 cuatro parejas de números decimales (reales). Un enfoque consiste
4396 en estimar las coordenadas de los dos extremos, y después adivinar
4397 los dos puntos intermedios. Los valores óptimos se encuentran
4398 después por ensayo y error. Tenga en cuenta que estos valores
4399 podrían requerir un ajuste manual si se hace posteriormente
4400 cualquier cambio manual a la música o a la disposición.
4402 Una situación en la que es preferible especificar los puntos de
4403 control explícitamente a especificar los desplazamientos es cuando
4404 se necesita especificarlos de forma relativa a una nota única. A
4405 continuación presentamos un ejemplo de esto. Muestra una forma de
4406 indicar una ligadura que se extiende hacia el interior de las
4407 casillas de primera y segunda vez de una repetición.
4409 @lilypond[verbatim,quote,relative=2]
4411 \repeat volta 3 { c4 d( e f }
4416 % create a slur and move it to a new position
4417 % the <> is just an empty chord to carry the slur termination
4418 -\tweak control-points #'((-2 . 3.8) (-1 . 3.9) (0 . 4) (1 . 3.4)) ( <> )
4423 % create a slur and move it to a new position
4424 -\tweak control-points #'((-2 . 3) (-1 . 3.1) (0 . 3.2) (1 . 2.4)) ( <> )
4431 No es posible modificar la forma de las ligaduras de unión o de
4432 expresión cambiando la propiedad @code{control-points} si hay más
4433 de una en el mismo momento musical, ni siquiera usando la
4434 instrucción @code{\tweak}. Sin embargo, se puede sobreescribir la
4435 propiedad @code{tie-configuration} de @code{TieColumn} para fijar
4436 la línea de inicio y la dirección según se requiera.
4439 Referencia de funcionamiento interno:
4440 @rinternals{TieColumn}.
4443 @node Contenedores unpure-pure
4444 @subsection Contenedores unpure-pure
4445 @translationof Unpure-pure containers
4447 @cindex Scheme, contenedores puros
4448 @cindex Scheme, contenedores no-puros
4449 @cindex puros, contenedores de Scheme
4450 @cindex no-puros: contenedores de Scheme
4451 @cindex horizontal, sobreescribir el espaciado
4453 Los contenedores @q{unpure-pure} (pura y no pura) son útiles para la
4454 sobreescritura de los cálculos del espaciado en el @emph{eje Y}
4455 (concretamente @code{Y-offset} e @code{Y-extent}) con una función de
4456 Scheme en lugar de un literal, es decir, un número o una pareja de
4459 Para ciertos objetos gráficos, las dimensiones @code{Y-extent} están
4460 basadas en la propiedad @code{stencil}, la sobreescritura de la
4461 propiedad de sello de éstos requiere una sobreescritura adicional de
4462 @code{Y-extent} con un contenedor unpure-pure. Cuando una función
4463 sobreescribe una dimensión @code{Y-offset} y/o @code{Y-extent} se
4464 supone que esto dispara los cálculos de los saltos de línea
4465 prematuramente durante la compilación. Así pues, la función no se
4466 evalúa en absoluto (devolviendo por lo general un valor de @samp{0} o
4467 @samp{'(0 . 0)}) lo que puede dar lugar a colisiones. Una función
4468 @q{pura} no afecta a las propiedades, objetos o suicidios de grobs, y
4469 por ello siempre ven sus valores relacionados con el eje Y evaluados
4472 Actualmente hay unas treinta funciones que ya se consideran @q{puras}
4473 y los contenedores Unpure-pure son una manera de establecer funciones
4474 que no están en esta lista como @q{puras}. La función @q{pura} se
4475 evalúa @emph{antes} de cualquier salto de línea y así el espaciado
4476 horizontal se puede ajustar @q{a tiempo}. La función @q{impura} se
4477 evalúa entonces @emph{después} del salto de línea.
4479 @warning{Dado que es difícil saber siempre qué funciones están en esta
4480 lista, recomendamos que cualquier función @q{pura} que estemos creando
4481 no utilice los grobs @code{Beam} o @code{VerticalAlignment}.}
4483 Un contenedor @q{unpure-pure} se contruye de la manera siguiente:
4485 @code{(ly:make-unpure-pure-container f0 f1)}
4487 donde @code{f0} es una función que toma @var{n} argumentos (@var{n >=
4488 1}) y el primer argumento siempre debe ser el grob. Ésta es la
4489 función que da el resultado real. @var{f1} es la función que se
4490 etiqueta como @q{pura} que toma @var{n + 2} argumentos. De nuevo, el
4491 primer argumento debe ser siempre el grob pero los argumentos segundo
4492 y tercero son argumentos de @q{inicio} y de @q{final}.
4494 @var{inicio} y @var{final} son, a todos los efectos, valores mudos que
4495 sólo tienen importancia para los @code{objetos de extensión} (o sea:
4496 @code{Hairpin}, regulador, o @code{Beam}, barra), que pueden devolver
4497 distintas estimaciones de altura basadas en una columna de inicio y
4500 El resto son los otros argumentos para la primera función (que puede
4501 no ser ninguno si @var{n = 1}).
4503 El resultado de la segunda función se usa como una aproximación del
4504 valor necesario, que se usa entonces por la primera función para
4505 obtener el valor real que se usa a continuación para el ajuste de
4506 precisión mucho más tardío durante el proceso de espaciado.
4508 @lilypond[verbatim,quote,ragged-right]
4509 #(define (square-line-circle-space grob)
4510 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
4511 (notename (ly:pitch-notename pitch)))
4512 (if (= 0 (modulo notename 2))
4513 (make-circle-stencil 0.5 0.0 #t)
4514 (make-filled-box-stencil '(0 . 1.0)
4517 squareLineCircleSpace = {
4518 \override NoteHead.stencil = #square-line-circle-space
4521 smartSquareLineCircleSpace = {
4522 \squareLineCircleSpace
4523 \override NoteHead.Y-extent =
4524 #(ly:make-unpure-pure-container
4525 ly:grob::stencil-height
4526 (lambda (grob start end) (ly:grob::stencil-height grob)))
4529 \new Voice \with { \remove "Stem_engraver" }
4531 \squareLineCircleSpace
4533 \smartSquareLineCircleSpace
4538 En el primer compás, sin el contenedor @emph{unpure-pure}, el motor de
4539 espaciado no conoce la anchura de la cabeza de la nota y permite que
4540 colisione con las alteraciones accidentales. En el segundo compás, el
4541 motor de espaciado conoce la anchura de las cabezas de las notas y
4542 evita la colisión mediante el alargamiento de la línea en la medida
4545 Normalmente, para cálculos simples se pueden usar funciones casi
4546 idénticas tanto para las partes @q{no pura} y @q{pura}, simplemente
4547 cambiando el número de argumentos que se pasan a, y el ámbito de, la
4550 @warning{Si una función está caracterizada como @q{pura} y resulta que
4551 no lo es, el resultado puede ser inesperado.}
4554 @node Uso de las funciones musicales
4555 @section Uso de las funciones musicales
4556 @translationof Using music functions
4558 @c TODO -- add @seealso, etc. to these subsections
4560 Dondequiera que se necesite reutilizar trucos con distintas
4561 expresiones musicales, con frecuencia conviene hacer que el truco
4562 forme parte de una @emph{función musical}. En esta sección
4563 estudiaremos solamente las funciones de @emph{sustitución}, en las que
4564 el objeto es sustituir una variable dentro de un fragmento de código
4565 de entrada de LilyPond. Se describen otras funciones más complejas en
4566 @rextend{Funciones musicales}.
4569 * Sintaxis de las funciones de sustitución::
4570 * Ejemplos de funciones de sustitución::
4574 @node Sintaxis de las funciones de sustitución
4575 @subsection Sintaxis de las funciones de sustitución
4576 @translationof Substitution function syntax
4578 Es fácil hacer una función que sustituya una variable dentro de código
4579 de LilyPond. La forma general de estas funciones es
4583 #(define-music-function
4584 (parser location @var{arg1} @var{arg2} @dots{})
4585 (@var{type1?} @var{type2?} @dots{})
4587 @var{@dots{}música@dots{}}
4594 @multitable @columnfractions .33 .66
4595 @item @code{@var{argN}}
4596 @tab @var{n}-ésimo argumento
4598 @item @code{@var{typeN?}}
4599 @tab @emph{predicado de tipo} de Scheme para el que @code{@var{argN}}
4600 debe devolver @code{#t}.
4602 @item @code{@var{@dots{}música@dots{}}}
4603 @tab código de entrada normal de LilyPond, que utiliza @code{$} (en los
4604 lugares en que sólo se permiten construcciones de Lilypond) o @code{#}
4605 (para usarlo como un valor de Scheme o un argumento de función musical
4606 o música dentro de listas de música) para referenciar argumentos
4607 (p.ej. @samp{#arg1}).
4610 Los argumentos @code{parser} y @code{location} son necesarios, y se
4611 utilizan en algunas situaciones avanzadas como se encuentra descrito
4612 en @rextend{Sintaxis de las funciones musicales}. Para las funciones
4613 de sustitución, tan sólo hemos de asegurarnos de incluirlos.
4615 También es necesaria la lista de predicados de tipo. Algunos de los
4616 predicados de tipo más comunes que se utilizan en las funciones
4621 cheap-list? @emph{(utilizar en lugar de }@q{list?}@emph{ para un procesado más rápido)}
4633 Para ver una lista de los predicados de tipo disponibles, consulte
4634 @ref{Predicados de tipo predefinidos}. También se permiten los
4635 predicados de tipo definidos por el usuario.
4638 Referencia de la notación:
4639 @ref{Predicados de tipo predefinidos}.
4641 Expansión de LilyPond:
4642 @rextend{Sintaxis de las funciones musicales}.
4644 Archivos instalados:
4645 @file{lily/music-scheme.cc},
4647 @file{scm/lily.scm}.
4650 @node Ejemplos de funciones de sustitución
4651 @subsection Ejemplos de funciones de sustitución
4652 @translationof Substitution function examples
4654 Esta sección presenta algunos ejemplos de funciones de sustitución.
4655 No pretenden ser exhaustivas, sino demostrar algunas de las
4656 posibilidades de las funciones de sustitución sencillas.
4658 En el primer ejemplo se define una función que simplifica el ajuste
4659 del relleno de un elemento de inscripción de texto TextScript:
4661 @lilypond[quote,verbatim,ragged-right]
4663 #(define-music-function
4664 (parser location padding)
4667 \once \override TextScript.padding = #padding
4671 c4^"piu mosso" b a b
4673 c4^"piu mosso" b a b
4675 c4^"piu mosso" b a b
4679 Además de números, podemos usar expresiones musicales, como notas,
4680 para los argumentos de las funciones musicales:
4682 @lilypond[quote,verbatim,ragged-right]
4684 #(define-music-function
4685 (parser location note)
4688 \tweak NoteHead.stencil #ly:text-interface::print
4689 \tweak NoteHead.text
4690 \markup \musicglyph #"custodes.mensural.u0"
4691 \tweak Stem.stencil ##f
4695 \relative c' { c4 d e f \custosNote g }
4698 Se pueden definir funciones de sustitución con más de un argumento:
4700 @lilypond[quote,verbatim,ragged-right]
4702 #(define-music-function
4703 (parser location padding tempotext)
4706 \once \override Score.MetronomeMark.padding = #padding
4707 \tempo \markup { \bold #tempotext }
4711 \tempo \markup { "Low tempo" }
4713 \tempoPadded #4.0 "High tempo"
4718 @c TODO: add appropriate @@ref's here.