1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond-learning.tely
4 Translation of GIT committish: 17d84cfa9ddb152b05d1e17ab72109fb4eefa684
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
13 @node Fundamental concepts
14 @chapter Fundamental concepts
16 Ha podido ver en el tutorial cómo producir música bellamente impresa a
17 partir de un simple archivo de texto. Esta sección presenta los
18 conceptos y técnicas que se requieren para producir partituras
19 igualmente bellas pero más complejas.
22 * How LilyPond input files work::
23 * Voices contain music::
24 * Contexts and engravers::
25 * Extending the templates::
29 @node How LilyPond input files work
30 @section How LilyPond input files work
32 El formato de entrada de LilyPond es bastante libre en su forma y
33 concede a los usuarios con experiencia mucha flexibilidad para
34 estructurar sus archivos de la forma que deseen. Sin embargo, toda
35 esta flexibilidad puede hacer que las cosas se vuelvan confusas para
36 los nuevos usuarios. Esta sección le va a explicar parte de esta
37 estructura, pero puede obviar ciertos detalles en aras de la
38 simplicidad. Para ver una descripción completa del formato de
39 entrada, consulte @ruser{File structure}.
43 * Introduction to the LilyPond file structure::
44 * Score is a (single) compound musical expression::
45 * Nesting music expressions::
46 * On the un-nestedness of brackets and ties::
49 @node Introduction to the LilyPond file structure
50 @subsection Introduction to the LilyPond file structure
52 @cindex entrada, formato de la
53 @cindex archivo, estructura del
55 Un ejemplo básico de archivo de entrada de LilyPond es el siguiente:
58 \version @w{"@version{}"}
61 @var{...expresión musical compuesta...} % toda la música viene aquí
68 Existen muchas variaciones de este esquema básico, pero el ejemplo
69 constituye un útil punto de partida.
76 @cindex score (partitura)
80 Hasta el momento, ninguno de los ejemplos que ha podido ver utiliza la
81 instrucción @code{\score@{@}}. Esto es así a causa de que LilyPond
82 añade automáticamente las órdenes adicionales que se requieren cuando
83 le proporcionamos una entrada sencilla. LilyPond trata una entrada
93 como una abreviatura de esta otra:
110 En otras palabras, si la entrada consta de una única expresión
111 musical, LilyPond interpreta el archivo como si la expresción musical
112 estuviera rodeada por un envoltorio hecho por las instrucciones que
115 @cindex contextos implícitos
116 @cindex implícitos, contextos
118 @strong{¡Advertencia!} Muchos de los ejemplos que aparecen en la
119 documentación de LilyPond omiten las instrucciones @code{\new Staff} y
120 @code{\new Voice}, dejando que se creen de forma implícita. Esto
121 funciona bien para ejemplos sencillos, pero para ejemplos más
122 complicados, especialmente cuando se usan instrucciones adicionales,
123 la creación implícita de los contextos puede dar lugar a resultados
124 inesperados, incluso en ocasiones crear pentagramas no deseados. La
125 forma de crear contextos de forma explícita se explica en
126 @ref{Contexts and engravers}.
128 @warning{Cuando se escriben más de unas pocas líneas de música, se
129 recomienda crear siempre los pentagramas y las voces de forma
132 De todas formas, por ahora vamos a volver al primer ejemplo para
133 examinar la instrucción @code{\score}, dejando las demás en su forma
136 Un bloque @code{\score} siempre debe contener una expresión musical
137 única, que debe aparecer inmediatamente después de la instrucción
138 @code{\score}. Recuerde que una expresión musical podía ser cualquier
139 cosa entre una sola nota hasta una enorme expresión compuesta como
144 @var{...inserte aquí la partitura completa de una ópera de Wagner...}
150 Puesto que todo se encuentra dentro de @code{@{ ... @}}, cuenta como
151 una expresión musical.
153 Como vimos anteriormente, el bloque @code{\score} puede contener otras
178 Observe que estas tres instrucciones (@code{\header}, @code{\layout} y
179 @code{\midi}) son especiales: a diferencia del resto de las
180 instrucciones que comienzan con una barra invertida (@code{\}),
181 @emph{no} son expresiones musicales y no forman parte de ninguna
182 expresión musical. Por tanto, se pueden situar dentro de un bloque
183 @code{\score} o fuera de él. De hecho, estas instrucciones se sitúan
184 por lo general fuera del bloque @code{\score} (por ejemplo,
185 @code{\header} se suele colocar antes de la instrucción @code{\score},
186 como muestra el ejemplo que aparece al principio de la sección.
188 Dos instrucciones más que no hemos visto aún son @code{\layout @{ @}}
189 y @code{\midi @{ @}}. Si aparecen tal y como se muestran aquí, hacen
190 que LilyPond produzca una salida impresa y una salida MIDI,
191 respectivamente. Se describen con todo detalle en el manual de
192 Referencia de la notación, en @ruser{Score layout} y en
193 @ruser{Creating MIDI files}.
195 @cindex partituras, varias
196 @cindex book, bloque implícito
197 @cindex implícito, bloque book
201 Podemos escribir varios bloques @code{\score}. Cada uno de ellos
202 recibirá el mismo tratamiento que una partitura independiente, pero se
203 combinarán todos juntos en un archivo de salida único. No se necesita
204 ninguna instrucción @code{\book}, se creará una implícitamente. Sin
205 embargo, si quiere archivos de salida separados a partir de un único
206 archivo @code{.ly}, entonces es necesario utilizar la instrucción
207 @code{\book} para separar las distintas secciones: cada bloque
208 @code{\book} produce un archivo de salida distinto.
212 Cada bloque @code{\book} crea un archivo de salida distinto (por
213 ejemplo, un archivo PDF). Si no hemos escrito uno de forma explícita,
214 LilyPond envuelve todo nuestro código de entrada dentro de un bloque
215 @code{\book} de forma implícita.
217 Cada bloque @code{\score} es un trozo de música separado dentro de un
220 @cindex layout, efecto de la situación del bloque
222 Cada bloque @code{\layout} afecta al bloque @code{\score} o
223 @code{\book} dentro del cual aparece (es decir, un bloque
224 @code{\layout} dentro de un bloque @code{\score} afecta solamente a
225 ese bloque @code{\score}, pero un bloque @code{\layout} fuera de un
226 bloque @code{\score} (que por ello está dentro de un bloque
227 @code{\book}, ya sea explícita o implícitamente) afecta a los bloques
228 @code{\score} que están dentro de ese @code{\book}.
230 Para ver más detalles, consulte @ruser{Multiple scores in a book}.
234 Otro atajo genial es la posibilidad de definir variables. Todas las
235 plantillas emplean lo siguiente:
238 melodia = \relative c' @{
247 Cuando LilyPond examina este archivo, toma el valor de @code{melodia}
248 (todo lo que está después del signo igual) y lo inserta dondequiera
249 que ve @code{\melodia}. No se requiere un cuidado especial con los
250 nombres (puede ser @code{melodia}, @code{global},
251 @code{CompasArmadura}, @code{manoderechadelpiano} o
252 @code{fulanomengano}). Para ver más detalles, consulte @ref{Saving
253 typing with variables and functions}. Recuerde que puede usar casi
254 cualquier nombre que se le ocurra, en la medida en que contenga
255 solamente caracteres alfabéticos y sea diferente de cualquiera de los
256 nombres de instrucción de LilyPond. Las limitaciones exactas que
257 afectan a los nombres de variable se detallan en @ruser{File
262 Para ver una definición completa del formato del código de entrada,
263 consulte @ruser{File structure}.
266 @node Score is a (single) compound musical expression
267 @subsection Score is a (single) compound musical expression
271 @cindex contenido del bloque score
272 @cindex score, contenido del bloque
273 @cindex compuesta, expresión musical
274 @cindex musical, expresión, compuesta
275 @cindex expresión musical compuesta
279 En la sección anterior, @ref{Introduction to the LilyPond file
280 structure}, hemos podido ver la organización general de los archivos
281 de entrada de LilyPond. Pero parece que nos saltamos la parte más
282 importante: ¿cómo averiguamos qué escribir después de @code{\score}?
284 No nos hemos saltado nada en absoluto. El gran misterio es, sencillamente,
285 que no hay @emph{ningún} misterio. La siguiente línea lo explica
289 @emph{Un bloque @code{\score} debe comenzar con una expresión musical
294 Para comprender lo que se entiende por expresión musical y expresión
295 musical compuesta, quizá encuentre útil dar un repaso al tutorial,
296 @ref{Music expressions explained}. En esta sección vimos cómo
297 elaborar grandes expresiones musicales a partir de pequeñas piezas
298 (comenzábamos con notas, luego acordes, etc.). Ahora partiremos de
299 una gran expresión musical y recorreremos el camino inverso hacia
304 @{ % esta llave da inicio a toda la expresión musical compuesta
306 @var{...introduzca aquí la partitura completa de una ópera de Wagner...}
308 @} % esta llave da por terminada toda expresión musical completa
313 Una ópera de Wagner completa puede ser fácilmente el doble de larga
314 que este manual, por tanto vamos a hacer sólo un cantante y un piano.
315 No necesitamos un @code{GrandStaff} para este conjunto, así que lo
316 retiramos. Sin embargo, sí que @emph{necesitamos} un cantante y un
322 \new Staff = "cantante" <<
324 \new PianoStaff = "piano" <<
331 Recuerde que usamos @code{<<} y @code{>>} en vez de @code{@{ ... @}}
332 para presentar música simultánea. Y, por supuesto, queremos presentar
333 las partes vocal y del piano al mismo tiempo, ¡no una después de otra!
334 Observe que la construcción @code{<< ... >>} no es realmente necesaria
335 para el pentagrama del cantante (pues contiene una sola expresión
336 musical); sin embargo, el uso de @code{<< ... >>} en lugar de llaves
337 sigue siendo necesario si la música que debe ir en el pentagrama está
338 compuesta por dos expresiones simultáneas, por ejemplo dos voces
339 simultáneas o una voz con letra. Escribiremos algo de música real más
340 tarde; por ahora limitémonos a poner algunas notas y letra de relleno.
342 @lilypond[verbatim,quote,ragged-right]
345 \new Staff = "singer" <<
346 \new Voice = "vocal" { c'1 }
349 \new PianoStaff = "piano" <<
350 \new Staff = "upper" { c'1 }
351 \new Staff = "lower" { c'1 }
358 Ahora tenemos muchos más detalles. Tenemos la pauta del cantante:
359 contiene una @code{Voice} o voz (en LilyPond, este término hace
360 referencia a un conjunto de notas, no necesariamente notas vocales --
361 por ejemplo, un violín generalmente toca una voz --) y el texto de la
362 canción. También tenemos una pauta de piano: contiene un pentagrama
363 superior (mano derecha) y un pentagrama inferior (mano izquierda).
365 En este momento podríamos comenzar a meter las notas. Dentro de las
366 llaves que siguen a @code{\new Voice = "vocal"}, podríamos empezar
375 Pero si lo hiciéramos, la sección @code{\score} se haría bastante
376 larga y sería más difícil comprender lo que ocurre. En lugar de esto
377 utilizaremos identificadores o variables. Recordará que las vimos por
378 primera vez en la sección anterior. Así pues, escribiendo algunas
379 notas, ahora tenemos un fragmento musical de verdad:
381 @lilypond[verbatim,quote,ragged-right]
382 melody = \relative c'' { r4 d8\noBeam g, c4 r }
383 text = \lyricmode { And God said, }
384 upper = \relative c'' { <g d g,>2~ <g d g,> }
385 lower = \relative c { b2 e2 }
389 \new Staff = "singer" <<
390 \new Voice = "vocal" { \melody }
393 \new PianoStaff = "piano" <<
394 \new Staff = "upper" { \upper }
395 \new Staff = "lower" {
405 Tenga cuidado con la diferencia entre las notas, que van precedidas de
406 @code{\relative} o insertadas directamente en la expresión musical, y
407 la letra, que va precedida de @code{\lyricmode}. Estas instrucciones
408 son esenciales para decirle a LilyPond que interprete el contenido que
409 viene a continuación como música y texto, respectivamente.
411 Cuando escriba una sección @code{\score} o cuando la esté leyendo,
412 hágalo despacio y con cuidado. Comience por el nivel exterior y luego
413 trabaje sobre cada uno de los niveles interiores. También es de gran
414 ayuda ser muy estricto con los márgenes (asegúrese de que en su editor
415 de texto cada elemento del mismo nivel comienza en la misma posición
420 Referencia de la notación:
421 @ruser{Structure of a score}.
424 @node Nesting music expressions
425 @subsection Nesting music expressions
427 @cindex pentagramas temporales
428 @cindex temporales, pentagramas
431 No es esencial declarar todos los pentagramas al comienzo; se pueden
432 crear temporalmente en cualquier momento. Esto es de especial
433 utilidad para crear secciones de ossia (véase @rglos{ossia}). A
434 continuación presentamos un ejemplo sencillo que muestra cómo
435 introducir temporalmente un pentagrama nuevo mientras dura un
436 fragmento de tres notas:
438 @lilypond[verbatim,quote,ragged-right]
455 Advierta que el tamaño de la clave es igual al que se imprime en un
456 cambio de clave (ligeramente menor que la clave al principio de una
457 línea). Esto es normal para cualquier clave que se imprime en la
460 @cindex pentagrama, posicionado del
462 La sección ossia se puede colocar encima del pentagrama de la manera
465 @lilypond[verbatim,quote,ragged-right]
466 \new Staff = "main" {
473 alignAboveContext = "main" }
481 Este ejemplo utiliza @code{\with}, que se explica en todo detalle más
482 adelante. Es un medio de modificar el comportamiento predeterminado
483 de un solo pentagrama. Aquí, dice que el pentagrama nuevo se debe
484 colocar por encima del pentagrama llamado @qq{main} en vez de la
485 posición predeterminada que sería por debajo.
489 Los fragmentos de ossia se escriben a menudo sin clave y sin
490 indicación de compás, y generalmente en un tipo más pequeño. Esto
491 necesitaría más instrucciones que aún no se han visto. Véase
492 @ref{Size of objects} y @ruser{Ossia staves}.
495 @node On the un-nestedness of brackets and ties
496 @subsection On the un-nestedness of brackets and ties
498 @cindex corchetes y paréntesis, anidado de
499 @cindex corchetes y paréntesis, tipos de
500 @cindex corchetes y paréntesis, encerrar frente a marcar
501 @cindex paréntesis y corchetes, anidado de
502 @cindex paréntesis y corchetes, tipos de
503 @cindex paréntesis y corchetes, encerrar frente a marcar
505 En la escritura del archivo de entrada de LilyPond, hemos podido ver
506 algunos tipos de paréntesis, llaves o ángulos de distintos tipos.
507 Éstos obedecen a distintas reglas que al principio pueden resultar
508 confusas. Antes de explicar estas reglas, demos un repaso a las
509 distintas clases de corchetes, llaves y paréntesis.
511 @c attempt to force this onto a new page
513 @multitable @columnfractions .3 .7
514 @headitem Tipo de paréntesis
516 @item @code{@{ .. @}}
517 @tab Encierra un fragmento secuencial de música
519 @tab Encierra las notas de un acorde
520 @item @code{<< .. >>}
521 @tab Encierra expresiones musicales simultáneas
523 @tab Marca el comienzo y el final de una ligadura de expresión
524 @item @code{\( .. \)}
525 @tab Marca el comienzo y el final de una ligadura de fraseo
527 @tab Marca el comienzo y el final de un barrado manual
530 A las anteriores, debemos añadir otras construcciones que generan
531 líneas entre o a través de las notas: las ligaduras de unión (marcadas
532 con una tilde curva, @code{~}), los grupos especiales que se escriben
533 como @code{\times x/y @{..@}}, y las notas de adorno, que se escriben
534 como @code{\grace@{..@}}.
536 Fuera de LilyPond, el uso convencional de los paréntesis y otros
537 corchetes requiere que los distintos tipos se encuentren anidados
538 correctamente, como en: @code{<< [ @{ ( .. ) @} ] >>}, de manera que
539 los paréntesis que se cierran deben encontrarse en el orden
540 exactamente opuesto al de los paréntesis que se abren. Esto
541 @strong{es} un requisito para los tres tipos de paréntesis que se
542 describen mediante la palabra @q{Encierra} en la tabla anterior: se
543 deben anidar correctamente. Sin embargo, el resto de las llaves y
544 corchetes, que se encuentran descritos por la palabra @q{Marca} en la
545 misma tabla anterior, @strong{no} tienen por qué anidarse
546 estrictamente con ninguno de los otros paréntesis. De hecho, éstos no
547 son paréntesis en el sentido de que encierran algo: simplemente son
548 marcadores que indican dónde empieza o finaliza algo.
550 Así pues, por ejemplo, una ligadura de fraseo puede dar comienzo
551 antes de una barra insertada manualmente, y acabar antes de que acabe
552 la barra (algo que quizá no sea muy musical, pero es posible):
554 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
555 { g8\( a b[ c b\) a] }
558 En general, los distintos tipos de corchete, y los implicados en
559 grupos especiales, ligaduras de unión y notas de adorno, se pueden
560 mezclar con total libertad. Este ejemplo muestra una barra que se
561 extiende hacia el interior de un grupo de valoración especial (línea
562 1), una ligadura de expresión que se prolonga hasta el interior de un
563 grupo especial (línea 2), una barra y una ligadura de expresión que se
564 prolongan hasta el interior de un grupo especial, una ligadura de
565 unión que atraviesa dos grupos especiales, y una ligadura de fraseo
566 que sale del interior de un grupo especial (líneas 3 y 4).
568 @lilypond[quote,verbatim,fragment,ragged-right]
570 r16[ g16 \times 2/3 {r16 e'8] }
571 g16( a \times 2/3 {b d) e' }
572 g8[( a \times 2/3 {b d') e'~]}
573 \times 4/5 {e'32\( a b d' e'} a'4.\)
578 @node Voices contain music
579 @section Voices contain music
581 Igual que los cantantes, LilyPond necesita voces para cantar. En
582 realidad, la música para cualquier instrumento de una partitura está
583 siempre contenida dentro de una voz --el concepto de LilyPond más
584 fundamental de todos--.
587 * I'm hearing Voices::
588 * Explicitly instantiating voices::
589 * Voices and vocals::
592 @node I'm hearing Voices
593 @subsection I'm hearing Voices
598 @cindex voces, varias
599 @cindex Voice (voz), contexto de
600 @cindex contexto Voice (de voz)
601 @cindex simultánea, música
602 @cindex concurrente, música
603 @cindex voces frente a acordes
604 @cindex acordes frente a voces
606 De las capas más profundas de una partitura de LilyPond, las más bajas
607 y más fundamentales reciben el nombre de @q{Voice contexts}
608 («contextos de voz») o, abreviadamente, @q{Voices} («voces»). Las
609 voces reciben a veces el nombre de @q{layers} («capas») en otros
610 programas de edición de partituras.
612 De hecho, una capa o contexto de voz es la única que puede contener
613 música. Si un contexto de voz no se declara explícitamente, se crea
614 uno de forma automática, como vimos al comienzo de este capítulo.
615 Ciertos instrumentos como el oboe solamente pueden tocar una nota cada
616 vez. La música escrita para estos instrumentos es monofónica y
617 solamente requiere una voz única. Los instrumentos que pueden tocar
618 más de una nota a la vez, como el piano, con frecuencia necesitarán
619 varias voces para codificar las distintas notas y ritmos concurrentes
620 que son capaces de tocar.
622 Una sola voz puede contener muchas notas dentro de un acorde, por
623 supuesto; entonces ¿cuándo, exactamente, se necesitan varias voces?
624 En primer lugar observe este ejemplo de cuatro acordes:
626 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
628 <d g>4 <d fis> <d a'> <d g>
631 Esto se puede expresar utilizando sólo símbolos de acorde con ángulos
632 simples, @code{< ... >}, y para este propósito tan sólo se necesita
633 una voz. Pero suponga que el Fa sostenido fuese realmente una corchea
634 seguida de un Sol corchea, una nota de paso que conduce al La. Ahora
635 tenemos dos notas que empiezan en el mismo momento pero tienen
636 distintas duraciones: la negra Re, y la corchea Fa sostenido. ¿Cómo se
637 codifica esto? No se pueden escribir como un acorde porque todas las
638 notas de un acorde deben tener la misma duración. Y no se pueden
639 escribir como dos notas en secuencia porque tienen que empezar en el
640 mismo momento. Aquí es donde se necesitan dos voces.
642 Veamos cómo se hace esto dentro de la sintaxis de entrada de LilyPond.
647 La forma más fácil de introducir fragmentos con más de una voz en un
648 solo pentagrama es escribir cada voz como una secuencia (con
649 @code{@{...@}}), y combinarlas simultáneamente con ángulos dobles,
650 @code{<<...>>}. Los fragmentos también se deben separar mediante una
651 doble barra invertida, @code{\\}, para situarlos en voces separadas.
652 Sin esto, las notas irían a una sola voz, lo que normalmente produce
653 errores. Esta técnica se adapta especialmente bien a piezas de música
654 que son mayormente monofónicas pero ocasionalmente tienen cortas
655 secciones de polifonía.
657 He aquí cómo dividimos los acordes anteriores en dos voces y añadimos
658 la nota de paso y la ligadura:
660 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
662 % Voice "1" Voice "2"
663 << { g4 fis8( g) a4 g } \\ { d4 d d d } >> |
666 Observe cómo las plicas de la segunda voz ahora se dirigen hacia
669 A continuación veamos otro ejemplo sencillo:
671 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
673 % Voice "1" Voice "2"
674 << { r4 g g4. a8 } \\ { d,2 d4 g } >> |
675 << { bes4 bes c bes } \\ { g4 g g8( a) g4 } >> |
676 << { a2. r4 } \\ { fis2. s4 } >> |
679 No es necesario usar una construcción @code{<< \\ >>} distinta para
680 cada compás. Para música que tenga unas pocas notas en cada compás,
681 esta disposición podría facilitar la legibilidad del código, pero si
682 hay muchas notas en cada compás podría ser mejor dividirlo en dos
683 voces separadas, de la siguiente manera:
685 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
700 @cindex voces, nombrado de
701 @cindex voces que cruzan corchetes
702 @cindex ligaduras que cruzan corchetes
704 Este ejemplo tiene sólo dos voces, pero la misma construcción se puede
705 usar para codificar tres o más voces mediante la adición de más
706 separadores de barra invertida.
708 Los contextos de voz llevan los nombres de @code{"1"}, @code{"2"},
709 etc. En cada uno de estos contextos, la dirección vertical de las
710 ligaduras, plicas, matices dinámicos, etc., se ajusta de la forma
713 @lilypond[quote,verbatim,fragment]
714 \new Staff \relative c' {
717 % Voice "1" Voice "2" Voice "3"
718 << { g4 f e } \\ { r8 e4 d c8 ~ } >> |
719 << { d2 e2 } \\ { c8 b16 a b8 g ~ g2 } \\ { s4 b4 c2 } >> |
723 Todas estas voces están separadas de la voz principal que contiene las
724 notas justo por fuera de la construcción @code{<< .. >>}. Le
725 llamaremos a esto la @emph{construcción simultánea}. Las ligaduras
726 (de prolongación y de expresión) solamente pueden conectar notas que
727 estén dentro de la misma voz, luego las ligaduras no pueden entrar o
728 salir de una construcción simultánea. A la inversa, las voces
729 paralelas de construcciones simultáneas distintas sobre el mismo
730 pentagrama, son la misma voz. Otras propiedades relativas a las voces
731 también conllevan construcciones simultáneas. A continuación vemos el
732 mismo ejemplo, con colores y cabezas distintos para cada voz. Observe
733 que los cambios en una voz no afectan a otras voces, pero persisten
734 más tarde dentro de la misma voz. Observe también que las notas
735 ligadas se pueden dividir entre las mismas voces de dos
736 construcciones, como se indica aquí en la voz de triángulos azules.
738 @lilypond[quote,verbatim]
739 \new Staff \relative c' {
758 { c8 b16 a b8 g ~ g2 }
768 @funindex \voiceOneStyle
769 @funindex \voiceTwoStyle
770 @funindex \voiceThreeStyle
771 @funindex \voiceFourStyle
772 @funindex \voiceNeutralStyle
774 Las instrucciones @code{\voiceXXXStyle} están pensadas principalmente
775 para usarlas en documentos educativos como este mismo. Modifican el
776 color de la cabeza, la plica y las barras, y el estilo de la cabeza,
777 de forma que las voces se puedan distinguir fácilmente. La voz uno
778 está establecida a rombos rojos, la voz dos a triángulos azules, la
779 voz tres a círculos verdes con aspas, y la voz cuatro (que no se
780 utiliza aquí) a aspas color magenta. @code{\voiceNeutralStyle} (que
781 tampoco se usa aquí) devuelve todo al estilo predeterminado. Veremos
782 más adelante cómo el usuario puede crear instrucciones como éstas.
783 Véase @ref{Visibility and color of objects} y @ref{Using variables for
786 @cindex polifonía y modo relativo
787 @cindex relativo, modo, polifonía y
789 La polifonía no cambia la relación de las notas dentro de un bloque
790 @code{\relative @{ @}}. La altura de cada nota aún se calcula con
791 relación a la nota que le precede inmediatamente, o a la primera nota
792 del acorde precedente. Así, en
795 \relative c' @{ notaA << < notaB notaC > \\ notaD >> notaE @}
799 @code{notaB} es relativa a @code{notaA} @*
800 @code{notaC} es relativa a @code{notaB}, no a @code{notaA}; @*
801 @code{notaD} es relativa a @code{notaB}, no a @code{notaA} ni a
803 @code{notaE} es relativa a @code{notaD}, no a @code{notaA}.
805 Una forma alternativa, que podría ser más clara si las notas en las
806 voces están muy separadas, es colocar una instrucción @code{\relative}
807 al principio de cada voz:
810 \relative c' @{ notaA ... @}
812 \relative c'' @{ < notaB notaC > ... @}
814 \relative g' @{ notaD ... @}
816 \relative c' @{ notaE ... @}
819 Finalmente, analicemos las voces en una pieza de música más compleja.
820 He aquí las notas de los dos primeros compases del segundo de los Dos
821 Nocturnos de Chopin, Op 32. Este ejemplo se utilizará en fases
822 posteriores dentro del presente capítulo y el siguiente, para ilustrar
823 varias técnicas para producir notación, y por tanto le pedimos que
824 ignore por ahora cualquier cosa en el código subyacente que le parezca
825 misterioso y tan sólo se concentre en la música y las voces (todas
826 las complicaciones se explicarán en secciones posteriores).
828 @c The following should appear as music without code
829 @lilypond[quote,ragged-right]
830 \new Staff \relative c'' {
839 % Ignore these for now - they are explained in Ch 4
840 \once \override NoteColumn #'force-hshift = #0
842 \once \override NoteColumn #'force-hshift = #0.5
850 Con frecuencia, la dirección de las plicas se utiliza para indicar la
851 continuidad de dos líneas melódicas simultáneas. Aquí, todas las
852 plicas de las notas agudas se dirigen hacia arriba y las de las notas
853 graves hacia abajo. Ésta es la primera indicación de que se requiere
856 Pero la necesidad real de varias voces aflora cuando hay notas que
857 comienzan en el mismo tiempo pero tienen distintas duraciones.
858 Observe las notas que comienzan en la tercera parte del primer compás.
859 El La bemol es una negra con puntillo, el Fa es una negra y el Re
860 bemol es una blanca. Estas notas no se pueden escribir como un acorde
861 porque todas las notas de un acorde deben tener la misma duración.
862 Tampoco se pueden escribir como notas secuenciales, pues deben
863 comenzar al mismo tiempo. Esta sección del compás requiere tres
864 voces, y la práctica común sería escribir todo el compás como tres
865 voces como se muestra abajo, donde hemos usado distintas cabezas y
866 colores para las tres voces. Una vez más, el código que subyace a
867 este ejemplo se explicará más tarde, así pues ignore todo lo que no
870 @c The following should appear as music without code
871 @c The three voice styles should be defined in -init
872 @lilypond[quote,ragged-right]
873 \new Staff \relative c'' {
884 \\ % No Voice three (we want stems down)
887 % Ignore these for now - they are explained in Ch 4
888 \once \override NoteColumn #'force-hshift = #0
890 \once \override NoteColumn #'force-hshift = #0.5
899 Vamos a intentar codificar esta música partiendo de cero. Como
900 veremos, esto se topa con ciertas dificultades. Comenzamos tal y como
901 hemos aprendido, usando la construcción @code{<< \\ >>} para
902 introducir la música del primer compás en tres voces:
904 @lilypond[quote,verbatim,fragment,ragged-right]
905 \new Staff \relative c'' {
908 { c2 aes4. bes8 } \\ { aes2 f4 fes } \\ { <ees c>2 des2 }
915 @cindex voces y dirección de las plicas
916 @cindex plicas, voces y dirección de las
919 Las direcciones de las plicas se asignan automáticamente de forma que
920 las voces de numeración impar reciben las plicas hacia arriba y las de
921 numeración par hacia abajo. Las plicas de las voces 1 y 2 están
922 correctas, pero las plicas de la voz 3 debería ir hacia abajo en este
923 fragmento en particular. Podemos corregir esto simplemente
924 olvidándonos de la voz tres y situando la música en la voz cuatro:
926 @lilypond[quote,verbatim,fragment,ragged-right]
927 \new Staff \relative c'' {
933 \\ % Omit Voice three
942 Vemos que esto arregla la dirección de la plica, pero presenta un
943 problema que se encuentra a veces con varias voces: las plicas de las
944 notas en una voz pueden colisionar con las cabezas de otras voces. Al
945 disponer las notas, LilyPond permite que las notas o acordes de dos
946 voces ocupen la misma columna vertical de notas teniendo en cuenta que
947 las plicas están en direcciones opuestas, pero las notas de la tercera
948 y cuarta voces se desplazan si es necesario para evitar la colisión
949 entre las cabezas. Esto funciona bien por lo general, pero en este
950 ejemplo claramente las notas de la voz inferior no están bien
951 colocadas de forma predeterminada. LilyPond proporciona diversas
952 maneras de ajustar la colocación horizontal de las notas. Aún no
953 estamos preparados para ver cómo corregir esto, así que dejaremos este
954 problema aparcado hasta una sección posterior (véase la propiedad
955 @code{force-hshift} en @ref{Fixing overlapping notation}).
959 Referencia de la notación:
960 @ruser{Multiple voices}.
963 @node Explicitly instantiating voices
964 @subsection Explicitly instantiating voices
971 @funindex \voiceThree
978 @cindex contextos de voz, creación de
980 Los contextos de voz también se pueden crear manualmente dentro de un
981 bloque @code{<< >>} para crear música polifónica, utilizando
982 @code{\voiceOne} ... @code{\voiceFour} para indicar las direcciones
983 requeridas de plicas, ligaduras, etc. En partituras más largas, este
984 método es más claro porque permite que las voces estén separadas y
985 reciban nombres más descriptivos.
987 Concretamente, la construcción @code{<< \\ >>} que usamos en la
993 << @{ e4 f g a @} \\ @{ c,4 d e f @} >>
1003 \new Voice = "1" @{ \voiceOne \relative c' @{ e4 f g a @} @}
1004 \new Voice = "2" @{ \voiceTwo \relative c' @{ c4 d e f @} @}
1008 Los dos ejemplos anteriores producen:
1010 @c The following example should not display the code
1011 @lilypond[ragged-right,quote]
1013 \new Voice = "1" { \voiceOne \relative c' { e4 f g a } }
1014 \new Voice = "2" { \voiceTwo \relative c' { c4 d e f } }
1018 @cindex voces, retorno a única
1019 @cindex retorno a voz única
1021 Las instrucciones @code{\voiceXXX} establecen la dirección de las
1022 plicas, ligaduras de expresión, ligaduras de prolongación,
1023 articulaciones, anotaciones de texto, puntillos y digitaciones.
1024 @code{\voiceOne} y @code{\voiceThree} hacen que estos objetos apunten
1025 hacia arriba, mientras que @code{\voiceTwo} y @code{\voiceFour} los
1026 hacen apuntar hacia abajo. Estas instrucciones también producen un
1027 desplazamiento horizontal para cada voz cuando es necesario para
1028 evitar choques entre las cabezas. La instrucción @code{\oneVoice}
1029 devuelve los ajustes de nuevo a los valores normales para una sola
1032 Veamos en algunos ejemplos sencillos exactamente qué efecto tienen
1033 @code{\oneVoice}, @code{\voiceOne} y @code{voiceTwo} sobre el marcado,
1034 las ligaduras de unión y de expresión y las indicaciones de dinámica:
1036 @lilypond[quote,ragged-right,verbatim]
1038 % Default behavior or behavior after \oneVoice
1039 c d8 ~ d e4 ( f g a ) b-> c
1043 @lilypond[quote,ragged-right,verbatim]
1046 c d8 ~ d e4 ( f g a ) b-> c
1048 c, d8 ~ d e4 ( f g a ) b-> c
1052 @lilypond[quote,ragged-right,verbatim]
1055 c d8 ~ d e4 ( f g a ) b-> c
1057 c, d8 ~ d e4 ( f g a ) b-> c
1061 A continuación veremos tres formas distintas de componer la notación
1062 del mismo pasaje polifónico, cada una de las cuales tiene sus ventajas
1063 según la circunstancia, utilizando el ejemplo de la sección anterior.
1065 Una expresión que aparece directamente dentro de @code{<< >>}
1066 pertenece a la voz principal (pero, observe, @strong{no} dentro de una
1067 construcción @code{<< \\ >>}). Esto es útil cuando aparecen voces
1068 nuevas mientras la voz principal está sonando. A continuación podemos
1069 ver una realización más correcta del ejemplo de la sección anterior.
1070 Las notas rojas en forma de rombo muestran que la melodía principal
1071 está ahora dentro de un contexto de una sola voz, haciendo que se
1072 pueda trazar una ligadura por encima de ellas.
1074 @lilypond[quote,ragged-right,verbatim]
1075 \new Staff \relative c' {
1077 % The following notes are monophonic
1079 % Start simultaneous section of three voices
1081 % Continue the main voice in parallel
1083 % Initiate second voice
1085 % Set stems, etc, down
1087 r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
1089 % Initiate third voice
1091 % Set stems, etc, up
1099 @cindex anidado de expresiones musicales
1100 @cindex anidado de construcciones simultáneas
1101 @cindex anidado de voces
1102 @cindex voces temporales
1103 @cindex voces, anidado de
1105 Son posibles construcciones polifónicas anidadas más profundamente, y
1106 si una voz aparece sólo brevemente podría haber una forma más natural
1107 de tipografiar la música.
1109 @lilypond[quote,ragged-right,verbatim]
1110 \new Staff \relative c' {
1118 {c8 b16 a b8 g ~ g2}
1129 @cindex espaciadoras, notas
1131 Este método de anidar voces nuevas brevemente es útil cuando sólo hay
1132 secciones polifónicas pequeñas, pero cuando todo el pentagrama es muy
1133 polifónico podría ser más claro usar varias voces todo el tiempo,
1134 usando notas espaciadoras para pasar por encima de las secciones en
1135 que una voz está en silencio, como aquí:
1137 @lilypond[quote,ragged-right,verbatim]
1138 \new Staff \relative c' <<
1139 % Initiate first voice
1142 c16^( d e f g4 f e | d2 e2) |
1144 % Initiate second voice
1146 % Set stems, etc, down
1148 s4 r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2 |
1150 % Initiate third voice
1152 % Set stems, etc, up
1159 @subsubheading Note columns
1161 @cindex columna de notas
1162 @cindex colisiones de notas
1163 @cindex notas, colisiones de
1164 @cindex desplazamiento, instrucciones de
1171 @funindex \shiftOnnn
1174 Las notas cercanas de un acorde, o las notas que se producen al mismo
1175 tiempo en distintas voces, se disponen en dos (y ocasionalmente más)
1176 columnas para evitar el solapamiento de las cabezas. Reciben el
1177 nombre de columnas de notas. Hay columnas distintas para cada voz, y
1178 el desplazamiento especificado en curso dependiente de la voz se
1179 aplica a la columna de la nota si en caso contrario se produjese una
1180 colisión. Esto se puede ver en el ejemplo anterior. En el compás 2 el
1181 Do en la voz dos está desplazado a la derecha respecto del Re de la
1182 voz uno, y en el último acorde el Do de la voz tres también está
1183 desplazado a la derecha respecto de las otras notas.
1185 Las instrucciones @code{\shiftOn}, @code{\shiftOnn}, @code{\shiftOnnn}
1186 y @code{\shiftOff} especifican el grado en que se deben desplazar las
1187 notas y acordes de la voz si en caso contrario ocurriese una
1188 colisión. De forma predeterminada, las voces exteriores (normalmente
1189 las voces uno y dos) llevan especificado @code{\shiftOff}, mientras
1190 que las voces interiores (tres y cuatro) tienen @code{\shiftOn}
1191 especificado. Cuando se aplica un desplazamiento, las voces uno y
1192 tres se desplazan hacia la derecha y las voces dos y cuatro se
1193 desplazan hacia la izquierda.
1195 @code{\shiftOnn} y @code{\shiftOnnn} definen niveles adicionales de
1196 desplazamiento que se pueden especificar temporalmente para resolver
1197 colisiones en situaciones complejas (véase @ref{Real music example}).
1199 Una columna de notas puede contener sólo una nota (o acorde) de una
1200 voz con las plicas hacia arriba y una not (o acorde) de una voz con
1201 las plicas hacia abajo. Si las notas de dos voces que tienen las
1202 plicas en la misma dirección se sitúan en la misma posición y las dos
1203 voces no tienen ningún desplazamiento o llevan especificado el mismo
1204 desplazamiento, se producirá el mensaje de error @qq{Chocan demasiadas
1209 Referencia de la notación:
1210 @ruser{Multiple voices}.
1213 @node Voices and vocals
1214 @subsection Voices and vocals
1217 La música vocal presenta una dificultad especial: tenemos que combinar
1218 dos expresiones, a saber, las notas y la letra.
1220 @funindex \new Lyrics
1224 @cindex Lyrics, creación de un contexto
1225 @cindex letra, creación de un contexto de
1226 @cindex letra, enlazar con una voz
1228 Ya ha visto la instrucción @code{\addlyrics@{@}}, que maneja bien
1229 partituras sencillas. Sin embargo esta técnica es algo limitada.
1230 Para música de mayor complejidad, tenemos que introducir la letra en
1231 un contexto @code{Lyrics} utilizando @code{\new Lyrics} y enlazar
1232 explícitamente la letra y las notas mediante @code{\lyricsto@{@}},
1233 usando el nombre asignado a la voz.
1235 @lilypond[quote,verbatim,fragment]
1237 \new Voice = "one" \relative c'' {
1240 c4 b8. a16 g4. f8 e4 d c2
1242 \new Lyrics \lyricsto "one" {
1243 No more let sins and sor -- rows grow.
1248 Observe que la letra se debe enlazar a un contexto de @code{Voice},
1249 @emph{no} a un contexto de @code{Staff}. Este es un caso en que es
1250 necesario crear contextos de @code{Staff} y de @code{Voice}
1253 @cindex letra y barrado
1254 @cindex barrado y letra
1255 @funindex \autoBeamOff
1256 @funindex autoBeamOff
1258 El barrado automático que LilyPond usa de forma predeterminada
1259 funciona bien para la música instrumental, pero no tan bien para
1260 música con letra, donde o bien el barrado no se necesita en absoluto,
1261 o bien se utiliza para indicar los melismas de la letra. En el
1262 ejemplo anterior hemos utilizado la instrucción @code{\autoBeamOff}
1263 para desactivar el barrado automático.
1265 @funindex \new ChoirStaff
1266 @funindex ChoirStaff
1267 @funindex \lyricmode
1269 @cindex vocal, estructura de una partitura
1270 @cindex coro, sistema de
1272 Ahora vamos a reutilizar el ejemplo anterior de «Judas Macabeo» para
1273 ilustrar esta técnica más flexible. Primero la reescribiremos para
1274 que use variables, de manera que la música y la letra se puedan
1275 separar de la estructura de pentagramas. También introduciremos una
1276 llave de grupo de ChoirStaff. La letra en sí se debe introducir con
1277 @code{\lyricmode} para estar seguros de que se interpreta como letra y
1280 @lilypond[quote,verbatim]
1281 global = { \time 6/8 \partial 8 \key f \major}
1282 SopOneMusic = \relative c'' {
1283 c8 | c([ bes)] a a([ g)] f | f'4. b, | c4.~ c4 }
1284 SopTwoMusic = \relative c' {
1285 r8 | r4. r4 c8 | a'([ g)] f f([ e)] d | e([ d)] c bes' }
1286 SopOneLyrics = \lyricmode {
1287 Let | flee -- cy flocks the | hills a -- dorn, __ }
1288 SopTwoLyrics = \lyricmode {
1289 Let | flee -- cy flocks the | hills a -- dorn, }
1294 \new Voice = "SopOne" {
1298 \new Lyrics \lyricsto "SopOne" {
1303 \new Voice = "SopTwo" {
1307 \new Lyrics \lyricsto "SopTwo" {
1315 Ésta es la estructura básica de todas las partituras vocales. Se
1316 pueden añadir más pentagramas según se necesite, se pueden añadir más
1317 voces a los pentagramas y más estrofas a la letra, y las variables que
1318 contienen la música se pueden colocar fácilmente en archivos separados
1319 cuando se hagan demasiado largos.
1321 @cindex himno, estructura de
1322 @cindex SATB, estructura de
1323 @cindex vocal, partitura, varias estrofas
1324 @cindex varias estrofas vocales
1325 @cindex estrofas, varias, vocales
1327 A continuación podemos ver un ejemplo final de la primera línea de un
1328 himno con cuatro estrofas, para coro SATB. En este caso la letra de
1329 las cuatro partes es la misma. Observe cómo utilizamos variables para
1330 separar la notación musical de la estructura de pentagramas. Observe
1331 también cómo se utiliza una variable, para la que hemos elegido el
1332 nombre @q{TimeKey} («compás y tonalidad»), para que contenga varias
1333 instrucciones que se usarán dentro de los dos pentagramas. En otros
1334 ejemplos se le suele dar el nombre de @q{global}.
1338 @lilypond[quote,verbatim]
1339 TimeKey = { \time 4/4 \partial 4 \key c \major}
1340 SopMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
1341 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f f e }
1342 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
1343 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
1344 VerseOne = \lyricmode {
1345 E -- | ter -- nal fa -- ther, | strong to save, }
1346 VerseTwo = \lyricmode {
1347 O | Christ, whose voice the | wa -- ters heard, }
1348 VerseThree = \lyricmode {
1349 O | Ho -- ly Spi -- rit, | who didst brood }
1350 VerseFour = \lyricmode {
1351 O | Tri -- ni -- ty of | love and pow'r }
1357 \new Voice = "Sop" { \voiceOne \TimeKey \SopMusic }
1358 \new Voice = "Alto" { \voiceTwo \AltoMusic }
1359 \new Lyrics \lyricsto "Sop" { \VerseOne }
1360 \new Lyrics \lyricsto "Sop" { \VerseTwo }
1361 \new Lyrics \lyricsto "Sop" { \VerseThree }
1362 \new Lyrics \lyricsto "Sop" { \VerseFour }
1366 \new Voice = "Tenor" { \voiceOne \TimeKey \TenorMusic }
1367 \new Voice = "Bass" { \voiceTwo \BassMusic }
1373 @cindex estrofa y estribillo
1375 Finalizamos con un ejemplo que muestra cómo podemos codificar una
1376 estrofa para solista seguida de un estribillo en dos partes sobre dos
1377 pentagramas. El posicionado de las secciones secuencial y simultánea
1378 para conseguirlo dentro de una sola partitura es un poco enrevesado,
1379 por tanto siga esta explicación con todo cuidado.
1381 Comenzamos el ejemplo con un bloque de partitura que contiene un
1382 @code{ChoirStaff}, pues queremos que aparezca un corchete al comienzo
1383 de la parte de coro. Normalmente necesitaríamos dobles ángulos
1384 después de @code{\new ChoirStaff} para meter dentro todos los
1385 pentagramas en paralelo, pero aquí queremos postponer el paralelismo
1386 mientras dura el solo y por ello usaremos llaves, aunque aquí unos
1387 ángulos dobles no harían daño. Dentro del @code{ChoirStaff} queremos
1388 en primer lugar el pentagrama que va a contener la estrofa. Debe
1389 contener notas y letra en paralelo, así que necesitamos dobles ángulos
1390 encerrando el @code{\new Voice} y el @code{\new Lyrics} para que den
1391 comienzo al mismo tiempo:
1393 @lilypond[quote,verbatim,ragged-right]
1394 versenotes = \relative c'' {
1397 \time 3/4 g g g b b b
1399 versewords = \lyricmode {
1400 One two three four five six
1405 \new Voice = "verse" {
1408 \new Lyrics \lyricsto verse {
1416 Con esto tenemos la línea de la estrofa.
1418 Ahora deseamos continuar con estribilloA (la primera parte del
1419 estribillo) sobre el mismo pentagrama, mientras un segundo pentagrama
1420 aparece en paralelo con él para estribilloB (estribillo, segunda parte),
1421 por lo que ésta es una sección paralela que se debe situar
1422 inmediatamente a continuación del salto de línea @code{\break} en la
1423 voz de la estrofa. ¡Sí, @emph{dentro} de la voz de la estrofa! He
1424 aquí dicha sección paralela. Se podrían introducir más pentagramas de
1430 \new Lyrics \lyricsto estrofa @{
1434 \new Voice = "estribilloB" @{
1437 \new Lyrics \lyricsto "estribilloB" @{
1444 Aquí tenemos el resultado final con dos pentagramas en el estribillo
1445 mostrando cómo la sección paralela se posiciona dentro de la voz de la
1448 @lilypond[quote,verbatim, ragged-right]
1449 versenotes = \relative c'' {
1452 \time 3/4 g g g b b b
1454 refrainnotesA = \relative c'' {
1458 refrainnotesB = \relative c {
1463 versewords = \lyricmode {
1464 One two three four five six
1466 refrainwordsA = \lyricmode {
1469 refrainwordsB = \lyricmode {
1475 \new Voice = "verse" {
1479 \new Lyrics \lyricsto "verse" {
1483 \new Voice = "refrainB" {
1486 \new Lyrics \lyricsto "refrainB" {
1492 \new Lyrics \lyricsto "verse" {
1501 @cindex book, ejemplo de su uso
1505 Sin embargo, y aunque esto es un interesante y útil ejercicio
1506 destinado a ayudarle a comprender cómo funcionan los bloques
1507 secuenciales y simultáneos, en la práctica quizá nos decidiríamos por
1508 codificarlo como dos bloques @code{\score} dentro de un bloque
1509 @code{\book} implícito, como sigue:
1511 @lilypond[quote,verbatim,ragged-right]
1512 versenotes = \relative c'' {
1515 \time 3/4 g g g b b b
1517 refrainnotesA = \relative c'' {
1521 refrainnotesB = \relative c {
1526 versewords = \lyricmode {
1527 One two three four five six
1529 refrainwordsA = \lyricmode {
1532 refrainwordsB = \lyricmode {
1537 \new Voice = "verse" {
1540 \new Lyrics \lyricsto "verse" {
1549 \new Voice = "refrainA" {
1552 \new Lyrics \lyricsto "refrainA" {
1557 \new Voice = "refrainB" {
1560 \new Lyrics \lyricsto "refrainB" {
1570 Referencia de la notación:
1571 @ruser{Vocal music}.
1574 @node Contexts and engravers
1575 @section Contexts and engravers
1577 Los contextos y grabadores se han mencionado de manera informal en
1578 secciones anteriores; ahora tan sólo vamos a ver estos conceptos con
1579 más detalle, pues son importantes en el ajuste fino de la salida de
1583 * Contexts explained::
1584 * Creating contexts::
1585 * Engravers explained::
1586 * Modifying context properties::
1587 * Adding and removing engravers::
1590 @node Contexts explained
1591 @subsection Contexts explained
1593 @cindex contextos, explicación de los
1595 Cuando se imprime la música, se tienen que añadir a la salida una gran
1596 cantidad de elementos notacionales que no aparecen explícitamente en
1597 el archivo de entrada. Por ejemplo, compare la entrada y la salida
1598 del siguiente ejemplo:
1600 @lilypond[quote,verbatim,relative=2,fragment]
1604 La entrada es bastante escueta, pero en la salida se añaden líneas
1605 divisorias, alteraciones accidentales, la clave y la indicación de
1606 compás. LilyPond @emph{interpreta} la entrada. En esta fase se
1607 inspecciona la información musical en orden temporal, de forma
1608 parecida a la lectura de una partitura de izquierda a
1609 derecha. Mientras se lee la entrada, el programa recuerda dónde se
1610 encuentran los límites de los compases, y qué notas requieren
1611 alteraciones explícitas. Esta información se puede presentar sobre
1612 varios niveles. Por ejemplo, el efecto de una alteración accidental
1613 se encuentra limitada a un solo pentagrama, mientras que una barra
1614 divisoria debe estar sincronizada a través de la partitura de arriba a
1617 Dentro de LilyPond, estas reglas y pequeñas porciones de información
1618 se agrupan en @emph{Contexts}. Algunos ejemplos de contextos son
1619 @code{Voice} (Voz), @code{Staff} (Pauta o pentagrama) y @code{Score}
1620 (Partitura). Los contextos son jerárquicos, de forma que reflejan la
1621 naturaleza jerárquica de una partitura musical. Por ejemplo: un
1622 contexto de @code{Staff} contener muchos contextos de @code{Voice}, y
1623 un contexto de @code{Score} puede contener muchos contextos de
1627 @sourceimage{context-example,5cm,,}
1630 Cada contexto asume la responsabilidad de imponer algunas reglas de
1631 notación, creando ciertos objetos de notación y manteniendo las
1632 propiedades asociadas. Por ejemplo, el contexto @code{Voice} puede
1633 introducir una alteración accidental y entonces el contexto
1634 @code{Staff} mantiene la regla de mostrar o suprimir la alteración
1635 para el resto del compás.
1637 Otro ejemplo lo constituye el hecho de que la sincronización de las
1638 líneas divisorias se gestiona dentro del contexto de la partitura,
1639 @code{Score}, de forma predeterminada. Sin embargo, en algunas
1640 músicas posiblemente no queramos que las líneas divisorias estén
1641 sincronizadas (pensemos en una partitura polimétrica en compases de
1642 4/4 y de 3/4). En tales casos, debemos modificar los ajustes por
1643 omisión de los contextos @code{Score} y @code{Staff}.
1645 Para partituras muy sencillas, los contextos se crean implícitamente y
1646 no debemos preocuparnos por ellos. Para piezas mayores, como por
1647 ejemplo cualquiera que tenga más de un pentagrama, los contextos se
1648 deben crear explícitamente para asegurarnos de que tendremos la
1649 cantidad exacta de pentagramas que necesitamos, y que están en el
1650 orden correcto. Para tipografiar piezas con notación especializada,
1651 es frecuente la modificación de contextos existentes o incluso definir
1652 unos completamente nuevos.
1655 Además de los contextos @code{Score,} @code{Staff} y @code{Voice}, hay
1656 contextos que se sitúan entre los niveles de partitura y de pentagrama
1657 para controlar los grupos de pentagraamas, como los contextos
1658 @code{PianoStaff} y @code{ChoirStaff}. También existen contextos
1659 alternativos de pentagrama y de voz, y contextos para la letra, la
1660 percusión, diagramas de trastes, bajo cifrado, etc.
1662 Los nombres de todos los tipos de contextos se componen de una o más
1663 palabras que comienzan con mayúscula y que están unidas unas a otras
1664 sin guión ni barra baja, por ejemplo:
1665 @code{GregorianTranscriptionStaff}.
1669 Referencia de la notación:
1670 @ruser{Contexts explained}.
1673 @node Creating contexts
1674 @subsection Creating contexts
1678 @cindex nuevos contextos
1679 @cindex creación de contextos
1680 @cindex contextos, creación de
1682 Sólo puede haber un contexto en el nivel más alto: el contexto de
1683 partitura @code{Score}. Se crea con la instrucción @code{\score} o,
1684 en partituras sencillas, se crea automáticamente.
1686 Para partituras que solamente tienen una voz y un pentagrama, podemos
1687 dejar que los contextos @code{Voice} y @code{Staff} se creen
1688 automáticamente, pero para partituras más complejas es necesario
1689 crearlos a mano. La instrucción más simple que hace esto es
1690 @code{\new}. Se antepone a una expresión musical, por ejemplo
1693 \new @var{tipo} @var{expresión_musical}
1697 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
1698 @code{Voice}). Esta instrucción crea un contexto nuevo, y comienza a
1699 interpretar la @var{expresión_musical} que está dentro de ese
1702 Observe que no hay ninguna instrucción @code{\new Score}; el contexto
1703 @code{Score} único en el nivel más alto se introduce con
1707 En las secciones anteriore ha podido ver muchos ejemplos prácticos que
1708 creaban nuevos contextos de @code{Staff} y de @code{Voice}, pero para
1709 recordarle cómo se emplean estas instrucciones en la práctica, he aquí
1710 un ejemplo anotado de música real:
1712 @lilypond[quote,verbatim,ragged-right]
1713 \score { % start of single compound music expression
1714 << % start of simultaneous staves section
1716 \new Staff { % create RH staff
1719 \new Voice { % create voice for RH notes
1720 \relative c'' { % start of RH notes
1726 \new Staff << % create LH staff; needs two simultaneous voices
1729 \new Voice { % create LH voice one
1731 \relative g { % start of LH voice one notes
1732 g8 <bes d> ees, <g c> |
1733 g8 <bes d> ees, <g c> |
1734 } % end of LH voice one notes
1735 } % end of LH voice one
1736 \new Voice { % create LH voice two
1738 \relative g { % start of LH voice two notes
1741 } % end of LH voice two notes
1742 } % end of LH voice two
1743 >> % end of LH staff
1744 >> % end of simultaneous staves section
1745 } % end of single compound music expression
1748 (Observe cómo todas las instrucciones que abren un bloque con una
1749 llave curva, @code{@{}, o con ángulos dobles, @code{<<}, están
1750 sangrados (tienen un margen adicional) con dos espacios adicionales, y
1751 la llave de cierre correspondiente tiene un margen exactamente igual.
1752 Aunque no es necesario, la observancia de esta práctica reducirá
1753 considerablemente el número de errores de @q{paréntesis
1754 descompensados}, y se recomienda vivamente. Permite apreciar de un
1755 solo vistazo la estructura de la música, y cualquier paréntesis
1756 descompensado aprecerá con obviedad. Observe también cómo el
1757 pentagrama de la MI se crea usando dobles ángulos porque requiere dos
1758 voces, mientras que el pentagrama de la MD se crea con una expresión
1759 musical única encerrada entre llaves porque sólo requiere una voz.)
1762 @cindex contextos, nombrado
1763 @cindex nombrar contextos
1765 La instrucción @code{\new} también puede otorgar un nombre
1766 identificativo al contexto para distinguirlo de otros contextos del
1770 \new @var{tipo} = @var{identificador} @var{expresión_musical}
1773 Observe la distinción entre el nombre del tipo de contexto,
1774 @code{Staff}, @code{Voice}, etc., y el nombre identificativo de una
1775 instancia en particular de ese tipo, que puede ser cualquier secuencia
1776 de letras inventada por el usuario. En el nombre identificativo
1777 también se pueden utilizar dígitos y espacios, pero en este caso aquél
1778 debe ir entre comillas p.ej. @code{\new Staff = "MiPentagrama 1"
1779 @var{expresión_musical}}. El nombre identificativo se utiliza para
1780 referirnos más tarde a esa instancia en particular de un contexto.
1781 Hemos visto esto en la sección acerca de la letra, en @ref{Voices and
1786 Referencia de la notación:
1787 @ruser{Creating contexts}.
1790 @node Engravers explained
1791 @subsection Engravers explained
1795 Todas y cada una de las marcas de la salida impresa de una partitura
1796 hecha con LilyPond está producida por un @code{Engraver} (grabador).
1797 Así, tenemos un grabador para imprimir pentagramas, otro para imprimir
1798 las cabezas de las notas, otro para las plicas, otro para las barras,
1799 etc, etc. ¡En total hay más de 120 grabadores! Afortunadamente, para
1800 la mayor parte de las partituras no es necesario conocer más que
1801 algunos, y para partituras sencillas no tenemos que saber nada de
1804 Los grabadores residen y operan dentro de Contextos. Los grabadores
1805 como el grabador de la indicación metronómica,
1806 @code{Metronome_mark_engraver}, cuya acción y resultado se aplican a
1807 la partitura como un todo, operan en el contexto del nivel más alto:
1808 el contexto de partitura @code{Score}.
1810 El grabador de la clave @code{Clef_engraver} y el de la armadura
1811 @code{Key_engraver} se encuentran probablemente en todos los contextos
1812 de pentagrama (@code{Staff}), pues los distintos pentagramas podrían
1813 requerir diferentes claves y armaduras.
1815 El grabador de las cabezas de nota @code{Note_heads_engraver} y el de
1816 las plicas @code{Stem_engraver} viven en cada uno de los contextos de
1817 voz @code{Voice}, el contexto de nivel más bajo de todos.
1819 Cada grabador procesa los objetos particulares asociados con su
1820 función, y mantiene las propiedades que están relacionadas con dicha
1821 función. Estas propiedades, como las que están asociadas con los
1822 contextos, se pueden modificar para cambiar el funcionamiento del
1823 grabador o el aspecto de esos elementos en la partitura impresa.
1825 Todos los grabadores tienen nombres compuestos de varias palabras que
1826 describen su función. Sólo está en mayúsculas la inicial de la
1827 primera palabra, y el resto se le une mediante guiones bajos. Así, el
1828 grabador @code{Staff_symbol_engraver} es responsable de la creación de
1829 las líneas del pentagrama, y el @code{Clef_engraver} determina y
1830 establece la altura o el punto de referencia sobre el pentagrama
1831 dibujando un símbolo de clave.
1833 A continuación presentamos algunos de los grabadores más comunes,
1834 junto a su función. Podrá comprobar que es fácil adivinar la función
1835 a partir del nombre (en inglés), y viceversa.
1837 @multitable @columnfractions .3 .7
1840 @item Accidental_engraver
1841 @tab Hace las alteraciones accidentales, de precaución y de sugerencia.
1843 @tab Graba las barras
1845 @tab Graba las claves
1846 @item Completion_heads_engraver
1847 @tab Splits notes which cross bar lines
1848 @c The old Dynamic_engraver is deprecated. -jm
1849 @item New_dynamic_engraver
1850 @tab Crea reguladores e indicaciones dinámicas textuales
1851 @item Forbid_line_break_engraver
1852 @tab Prevents line breaks if a musical element is still active
1854 @tab Crea la armadura de la tonalidad
1855 @item Metronome_mark_engraver
1856 @tab Graba la indicación metronómica
1857 @item Note_heads_engraver
1858 @tab Graba la cabeza de las notas
1860 @tab Graba los silencios
1861 @item Staff_symbol_engraver
1862 @tab Graba las cinco líneas (de forma predeterminada) del pentagrama
1864 @tab Crea las plicas y los trémolos de una sola plica
1865 @item Time_signature_engraver
1866 @tab Crea las indicaciones de compás
1871 Más adelante veremos cómo la salida de LilyPond se puede cambiar
1872 mediante la modificación del funcionamiento de los Grabadores.
1876 Referencia de funcionamiento interno:
1877 @rinternals{Engravers and Performers}.
1880 @node Modifying context properties
1881 @subsection Modifying context properties
1883 @cindex contexto, propiedades de
1884 @cindex contexto, propiedades de, modificación
1885 @cindex modificar las propiedades de contexto
1891 Los contextos se responsabilizan de mantener los valores de un cierto
1892 número de @emph{properties} de contexto. Muchas de ellas se pueden
1893 cambiar para influir en la interpretación del código de entrada y
1894 cambiar así la apariencia de la salida impresa. Se modifican mediante
1895 la instrucción @code{\set}. Esta instrucción toma la forma siguiente:
1898 \set @emph{NombreDelContexto}.@emph{nombreDeLaPropiedad} = #@emph{valor}
1901 Donde el @emph{NombreDelContexto} es normalmente @code{Score},
1902 @code{Staff} o @code{Voice}. Se puede omitir, en cuyo caso se supone
1903 que es @code{Voice}.
1905 Los nombres de las propiedades de contexto consisten en palabras
1906 unidas sin ningún guión o barra baja, y donde todas las palabras
1907 excepto la primera empiezan en mayúscula. A continuación podemos ver
1908 algunos ejemplos de nombres de propiedades utilizadas con frecuencia.
1909 Hay muchas más que las que se muestran aquí.
1911 @c attempt to force this onto a new page
1913 @multitable @columnfractions .25 .15 .45 .15
1914 @headitem nombreDeLaPropiedad
1917 @tab Valor de ejemplo
1920 @tab Si es verdadero, poner becuadros adicionales antes de las alteraciones
1921 @tab @code{#t}, @code{#f}
1922 @item currentBarNumber
1924 @tab Ajustar el número del compás actual
1928 @tab Si es verdadero, imprimir ligaduras de expresión por encima y por debajo de las notas
1929 @tab @code{#t}, @code{#f}
1930 @item instrumentName
1932 @tab Establecer el nombre del pentagrama, situado a la izquierda
1933 @tab @code{"Cello I"}
1936 @tab Aumentar o disminuir el tamaño de la fuente tipográfica
1940 @tab Establecer el texto que se imprime antes del comienzo de una estrofa
1945 donde un valor Booleano es verdadero (@code{#t}, True) o falso
1946 (@code{#f}, False), un Entero es un número entero positivo, un número
1947 Real es un número decimal positivo o negativo, y el texto se encierra
1948 entre comillas dobles. Observe la aparición de signos de cuadradillo,
1949 (@code{#}), en dos lugares diferentes: como parte del valor Booleano
1950 antes de la @code{t} o la @code{f}, y antes del @emph{valor} dentro de
1951 la sentencia @code{\set}. Así pues, cuando se está escribiendo un
1952 valor Booleano, hay que escribir dos signos de cuadradillo, por
1953 ejemplo: @code{##t}.
1955 @cindex propiedades que funcionan en contextos
1956 @cindex establecer propiedades en contextos
1958 Antes de poder establecer cualquiera de estas propiedades, tenemos que
1959 saber en qué contexto operan. A veces es algo obvio, pero en
1960 ocasiones puede ser algo enrevesado. Si especificamos un contexto
1961 equivocado, no se produce ningún mensaje de error, pero el
1962 funcionamiento esperado no tendrá lugar. Por ejemplo, la propiedad
1963 @code{instrumentName} (nombre del instrumento) vive claramente dentro
1964 del contexto de @code{Staff}, puesto que es el pentagrama el que debe
1965 ser nombrado. En este ejemplo, el primer pentagrama resulta
1966 etiquetado, pero no el segundo, porque hemos omitido el nombre del
1969 @lilypond[quote,verbatim,ragged-right]
1971 \new Staff \relative c'' {
1972 \set Staff.instrumentName = #"Soprano"
1975 \new Staff \relative c' {
1976 \set instrumentName = #"Alto" % Wrong!
1982 Recuerde que el nombre del contexto predeterminado es @code{Voice},
1983 así que la segunda instrucción @code{\set} establece la propiedad
1984 @code{instrumentName} del contexto @code{Voice} a @qq{Alto}, pero como
1985 LilyPond no busca esta propiedad en el contexto @code{Voice}, no se
1986 realiza ninguna acción. Esto no es un error, y no se registra ningún
1987 mensaje en el archivo Log de registro de errores.
1989 De forma parecida, si el nombre de la propiedad se escribe con alguna
1990 falta, no se produce ningún mensaje de error, y claramente la acción
1991 esperada no puede tener lugar. De hecho, se puede establecer
1992 cualquier @q{property} (ficticia) usando cualquier nombre que queramos
1993 en cualquier contexto que exista, mediante el uso de la instrucción
1994 @code{\set}. Pero si el nombre no es conocido para LilyPond, no
1995 producirá ninguna acción. Algunos editores de texto que apoyan a los
1996 archivos de entrada de LilyPond de manera especial, documentan los
1997 nombres de propiedades con viñetas cuando psamos sobre ellos con el
1998 puntero del ratón, como JEdit con la extensión LilyPondTool, o
1999 resaltan los nombres de propiedades desconocidas de manera diferente,
2000 como ConTEXT. Si no se utiliza un editor con tales posibilidades, se
2001 recomienda comprobar la corrección del nombre de la propiedad en el
2002 manual de Referencia de funcionamiento interno: véase
2003 @rinternals{Tunable context properties} o @rinternals{Contexts}.
2005 La propiedad @code{instrumentName} tendrá efecto solamente si se
2006 establece dentro del contexto @code{Staff}, pero algunas propiedades
2007 se pueden establecer en más de un contexto. Por ejemplo, la propiedad
2008 @code{extraNatural} está establecida por defecto al valor @code{##t}
2009 (verdadero) para todos los pentagramas. Si se establece a @code{##f}
2010 (falso) en un contexto de @code{Staff} determinado, se aplicará
2011 solamente a las alteraciones de ese pentagrama. Si se establece a
2012 falso en el contexto de la partitura, @code{Score}, se aplicará a
2013 todos los pentagramas.
2015 Así, esto desactivará los becuadros adicionales en un pentagrama:
2017 @lilypond[quote,verbatim,ragged-right]
2019 \new Staff \relative c'' {
2022 \new Staff \relative c'' {
2023 \set Staff.extraNatural = ##f
2030 y esto los desactivará en todos los pentagramas:
2032 @lilypond[quote,verbatim,ragged-right]
2034 \new Staff \relative c'' {
2037 \new Staff \relative c'' {
2038 \set Score.extraNatural = ##f
2044 Como un ejemplo más, si se establece @code{clefOctavation} dentro del
2045 contexto de @code{Score}, éste cambia inmediatamente el valor de la
2046 octavación en todos los pentagramas en curso y establece un nuevo
2047 valor predeterminado que se aplicará a todos los pentagramas.
2049 La instrucción opuesta, @code{\unset}, tiene el efecto de suprimir la
2050 propiedad del contexto, lo que ocasiona que la mayoría de las
2051 porpiedades vuelvan a su valor predeterminado. Normalmente no es
2052 necesario el uso de @code{\unset}, pues una nueva instrucción
2053 @code{\set} hará el ajuste deseado.
2055 Las instrucciones @code{\set} y @code{\unset} pueden aparecer en
2056 cualquier lugar del archivo de entrada y tendrán efecto a partir del
2057 tiempo en que se encuentran y hasta el final de la partitura o hasta
2058 que la propiedad se establezca de nuevo mediante @code{\set} o
2059 @code{\unset}. Probemos a modificar el tamaño de la fuente
2060 tipográfica, lo que afecta al tamaño de las cabezas de las notas
2061 (entre otras cosas) varias veces. El cambio se toma a partir del
2062 valor predeterminado, no el valor en curso.
2064 @lilypond[quote,verbatim,ragged-right,relative=1,fragment]
2066 % make note heads smaller
2069 % make note heads larger
2070 \set fontSize = #2.5
2072 % return to default size
2077 Hemos podido ver cómo establecer los valores de diversos tipos de
2078 propiedad diferentes. Observe que los números enteros y reales van
2079 siempre precedidos de un símbolo de cuadradillo, @code{#}, mientras
2080 que un valor booleano verdadero o falso se especifica mediante
2081 @code{##t} y @code{##f}, con dos cuadradillos. Una propiedad de texto
2082 se debe encerrar entre comillas dobles, como antes, aunque veremos más
2083 adelante que el texto realmente se puede especificar de una forma
2084 mucho más general utilizando la potentísima instrucción @code{markup}.
2086 @unnumberedsubsubsec Setting context properties with @code{\with}
2090 @cindex contexto, propiedades de, establecimiento con \with
2092 Las propiedades de contexto también se pueden establecer en el momento
2093 en que se crea el contexto. A veces esta forma de establecer el valor
2094 de una propiedad es mucho más clara, si ha de quedar fijo durante todo
2095 el tiempo que dure el contexto. Cuando se crea un contexto con una
2096 instrucción @code{\new} puede ir inmediatamente seguido de un bloque
2097 @code{\with @{ .. @}} en el que se establecen los valores de las
2098 propiedades. Por ejemplo, si queremos suprimir la impresión de
2099 becuadros adicionales para toda la duración de un pentagrama, podemos
2103 \new Staff \with @{ extraNatural = ##f @}
2107 de la siguiente forma:
2109 @lilypond[quote,verbatim,ragged-right]
2115 \new Staff \with { extraNatural = ##f }
2122 Las propiedades ajustadas de esta manera aún pueden cambiarse
2123 dinámicamente utilizando @code{\set} y ser devueltas a sus valores
2124 predeterminados mediante @code{\unset}.
2126 @cindex fontSize (tamaño de la tipografía)
2127 @cindex fuente, tamaño de la
2128 @cindex tamaño de la fuente
2130 La propiedad @code{fontSize} se trata de forma distinta. Si se ajusta
2131 dentro de una cláusula @code{\with}, tiene el efecto de reiniciar el
2132 valor predeterminado del tamaño de la fuente tipográfica. Si más
2133 tarde se modifica con @code{\set}, este nuevo valor predeterminado
2134 puede restablecerse con la instrucción @code{\unset fontSize}.
2136 @unnumberedsubsubsec Setting context properties with @code{\context}
2138 @cindex contextos, establecer propiedades de, con \context
2142 Los valores de propiedad de los contextos se pueden establecer para
2143 @emph{todos} los contextos de un tipo determinado, como por ejemplo
2144 todos los contextos de @code{Staff}, con una única instrucción. El
2145 tipo de contexto se identifica mediante la utilización del nombre de
2146 su tipo, como @code{Staff}, precedido de una barra invertida:
2147 @code{\Staff}. El enunciado que establece el valor de la propiedad es
2148 el mismo que el que está en un bloque @code{\with}, presentado
2149 anteriormente. Se coloca en un bloque @code{\context} dentro de un
2150 bloque @code{\layout}. Cada bloque @code{\context} afecta a todos los
2151 contextos del tipo especificado a lo largo del bloque @code{\score} o
2152 @code{\book} en el que aparece el bloque @code{\layout}. A
2153 continuación presentamos un ejemplo que muestra el formato:
2155 @lilypond[verbatim,quote]
2172 Las propiedades de contexto establecidas de esta forma se pueden
2173 sobreescribir para ejemplares concretos de contextos mediante
2174 enunciados dentro de un bloque @code{\with}, y mediante instrucciones
2175 @code{\set} intercaladas dentro de enunciados musicales.
2179 Referencia de la notación:
2180 @ruser{Changing context default settings}.
2182 @c uncomment when backslash-node-name issue is resolved -pm
2183 @c @ruser{The set command}.
2185 Referencia de funcionamiento interno:
2186 @rinternals{Contexts},
2187 @rinternals{Tunable context properties}.
2190 @node Adding and removing engravers
2191 @subsection Adding and removing engravers
2193 @cindex grabadores, adición
2194 @cindex grabadores, eliminación
2195 @cindex adición de grabadores
2196 @cindex eliminación de grabadores
2203 Hemos visto que cada uno de los contextos contiene varios grabadores,
2204 cada uno de los cuales a su vez es responsable de la producción de una
2205 fracción particular del resultado impreso, como líneas divisorias,
2206 pentagramas, cabezas, plicas, etc. Si un grabador es eliminado de un
2207 contexto, ya no podrá producir su salida impresa. Es una forma algo
2208 radical de modificar la salida, pero a veces puede ser útil.
2210 @subsubheading Changing a single context
2212 Para eliminar un grabador de un contexto único, usamos la instrucción
2213 @code{\with} situada inmediatamente después de la instrucción que crea
2214 el contexto, como en la sección anterior.
2216 Como ilustración, repitamos un ejemplo extraído de la sección anterior
2217 con las líneas del pentagrama eliminadas. Recuerde que las líneas del
2218 pentagrama están dibujadas por el grabador
2219 @code{Staff_symbol_engraver}.
2221 @lilypond[quote,verbatim,ragged-right]
2223 \remove Staff_symbol_engraver
2227 \set fontSize = #-4 % make note heads smaller
2229 \set fontSize = #2.5 % make note heads larger
2231 \unset fontSize % return to default size
2236 @cindex ámbito, grabador del
2238 Los grabadores también se pueden añadir a los contextos individuales
2239 La instrucción que lo hace es
2241 @code{\consists @var{Nombre_del_grabador}},
2243 situada dentro de un bloque @code{\with}. Ciertas partituras vocales
2244 tienen una indicación de ámbito o tesitura situada al principio del
2245 pentagrama para indicar el ámbito de notas en dicho pentagrama, véase
2246 @rglos{ambitus}. El ambitus se produce por parte del grabador
2247 @code{Ambitus_engraver}, que normalmente no está incluido en ningún
2248 contexto. Si lo añadimos al contexto @code{Voice}, calcula el rango a
2249 partir de esa única voz:
2251 @lilypond[quote,verbatim,ragged-right]
2254 \consists Ambitus_engraver
2269 pero si añadimos el grabador de ámbito al contexto de @code{Staff},
2270 calcula el rango de todas las notas en todas las voces de ese
2273 @lilypond[quote,verbatim,ragged-right]
2275 \consists Ambitus_engraver
2291 @subsubheading Changing all contexts of the same type
2296 Los ejemplos anteriores muestran la manera de eliminar o añadir
2297 grabadores a los contextos individuales. También es posible eliminar
2298 o añadir grabadores a todos los contextos de un tipo específico,
2299 situando las instrucciones en el contexto correspondiente dentro de un
2300 bloque @code{\layout}. Por ejemplo, si queremos mostrar los rangos de
2301 tesitura para todos los pentagramas de una partitura de cuatro pautas,
2304 @lilypond[quote,verbatim,ragged-right]
2308 \relative c'' { c a b g }
2311 \relative c' { c a b g }
2315 \relative c' { c a b g }
2319 \relative c { c a b g }
2325 \consists Ambitus_engraver
2332 Los valores predeterminados de las propiedades de los contextos
2333 también se pueden establecer para todos los contextos de un tipo en
2334 particular incluyendo la instrucción @code{\set} dentro de un bloque
2335 @code{\context} de la misma forma.
2339 Referencia de la notación:
2340 @ruser{Modifying context plug-ins},
2341 @ruser{Changing context default settings}.
2344 @node Extending the templates
2345 @section Extending the templates
2347 Ha leído el tutorial y ahora sabe escribir música. Pero ¿cómo puede
2348 poner los pentagramas que quiere? Las plantillas están muy bien, pero
2349 ¿qué ocurre si quiere algo que no está en una de ellas? Bien, puede
2350 encontrar montañas de plantillas (véase @ref{Templates}) que le pueden
2351 servir como punto de partida. Pero ¿y si quiere algo que no está
2352 contemplado aquí? Continúe leyendo.
2356 * Soprano and cello::
2357 * Four-part SATB vocal score::
2358 * Building a score from scratch::
2361 @node Soprano and cello
2362 @subsection Soprano and cello
2364 @cindex plantilla, modificar
2365 @cindex modificar plantillas
2367 Para empezar, tome la plantilla que le parezca más parecida a aquello
2368 que quiere conseguir. Digamos que quiere escribir algo para soprano y
2369 cello. En este caso comenzaríamos con la plantilla @q{Notas y letra}
2370 (para la parte de soprano).
2373 \version @w{"@version{}"}
2374 melodia = \relative c' @{
2381 texto = \lyricmode @{
2387 \new Voice = "uno" @{
2391 \new Lyrics \lyricsto "uno" \texto
2398 Ahora queremos añadir una parte de violoncello. Veamos el ejemplo
2402 \version @w{"@version{}"}
2403 melodia = \relative c' @{
2417 No necesitamos dos instrucciones @code{\version}. Vamos a necesitar
2418 la sección @code{melodia}. No queremos dos secciones @code{\score}
2419 (si tuviésemos dos @code{\score}s, acabaríamos con las dos particellas
2420 por separado. Queremos las dos juntas, como un dúo. Dentro de la
2421 sección @code{\score}, no nos hacen falta dos @code{\layout} ni dos
2424 Si nos limitásemos a copiar y pegar la sección @code{melodia},
2425 acabaríamos con dos secciones @code{melodia} separadas, así que vamos
2426 a cambiarles el nombre. Llamaremos @code{musicaSoprano} a la sección
2427 de la soprano y @code{musicaCello} a la sección del violoncello. Al
2428 mismo tiempo cambiaremos el nombre de @code{texto} a
2429 @code{letraSoprano}. Recuerde cambiar el nombre a las dos apariciones
2430 de todos estos nombres -- tanto la definición inicial (la parte
2431 @code{melodia = relative c' @{ }) -- como el uso de ese nombre (en la
2432 sección @code{\score}).
2434 También aprovecharemos para cambiar el pentagrama de la parte del
2435 cello (los violoncellos se escriben normalmente en clave de Fa).
2436 Asimismo, cambiaremos algunas notas del cello.
2439 \version @w{"@version{}"}
2440 musicaSoprano = \relative c' @{
2447 letraSoprano = \lyricmode @{
2451 musicaCello = \relative c @{
2461 \new Voice = "uno" @{
2465 \new Lyrics \lyricsto "uno" \letraSoprano
2472 Esto tiene una apariencia prometedora, pero la parte del cello no sale
2473 en la partitura (no la hemos puesto en la sección @code{\score}). Si
2474 queremos que la parte del cello aparezca debajo de la de soprano,
2478 \new Staff \musicaCello
2482 justo debajo de todo lo de la soprano. También tenemos que poner
2483 @code{<<} y @code{>>} antes y después de la música -- lo que indica a
2484 LilyPond que hay más de una cosa (en este caso, @code{Staff})
2485 sucediendo al mismo tiempo --. La @code{\score} se parecerá ahora a
2488 @c Indentation in this example is deliberately poor
2493 \new Voice = "uno" @{
2497 \new Lyrics \lyricsto "uno" \letraSoprano
2499 \new Staff \musicaCello
2507 Esto parece un poco enrevesado; los márgenes están descuadrados. Esto
2508 tiene fácil solución. Presentamos aquí la plantilla completa para
2511 @lilypond[quote,verbatim,ragged-right,addversion]
2512 sopranoMusic = \relative c' {
2519 sopranoLyrics = \lyricmode {
2523 celloMusic = \relative c {
2533 \new Voice = "one" {
2537 \new Lyrics \lyricsto "one" \sopranoLyrics
2539 \new Staff \celloMusic
2548 Las plantillas de inicio se pueden encontrar en el apéndice
2549 @q{Templates}, véase @ref{Single staff}.
2552 @node Four-part SATB vocal score
2553 @subsection Four-part SATB vocal score
2555 La mayor parte de las partituras vocales escritas para coro mixto a
2556 cuatro voces con acompañamiento orquestal, como el «Elías» de
2557 Mendelssohn o el «Mesías» de Haendel, tienen la música coral y la
2558 letra en cuatro pentagramas para S, A, T y B, respectivamente, con una
2559 reducción de piano del acompañamiento de orquesta, por debajo. He aquí
2560 un ejemplo del «Mesías» de Haendel:
2562 @c The following should appear as music without code
2563 @lilypond[quote,ragged-right]
2564 global = { \key d \major \time 4/4 }
2565 sopranoMusic = \relative c'' {
2567 r4 d2 a4 | d4. d8 a2 | cis4 d cis2 |
2569 sopranoWords = \lyricmode {
2570 Wor -- thy is the lamb that was slain
2572 altoMusic = \relative a' {
2574 r4 a2 a4 | fis4. fis8 a2 | g4 fis e2 |
2576 altoWords = \sopranoWords
2577 tenorMusic = \relative c' {
2579 r4 fis2 e4 | d4. d8 d2 | e4 a, cis2 |
2581 tenorWords = \sopranoWords
2582 bassMusic = \relative c' {
2584 r4 d2 cis4 | b4. b8 fis2 | e4 d a'2 |
2586 bassWords = \sopranoWords
2587 upper = \relative a' {
2590 r4 <a d fis>2 <a e' a>4 |
2591 <d fis d'>4. <d fis d'>8 <a d a'>2 |
2592 <g cis g'>4 <a d fis> <a cis e>2 |
2594 lower = \relative c, {
2597 <d d'>4 <d d'>2 <cis cis'>4 |
2598 <b b'>4. <b' b'>8 <fis fis'>2 |
2599 <e e'>4 <d d'> <a' a'>2 |
2603 << % combine ChoirStaff and PianoStaff in parallel
2605 \new Staff = "sopranos" <<
2606 \set Staff.instrumentName = "Soprano"
2607 \new Voice = "sopranos" { \global \sopranoMusic }
2609 \new Lyrics \lyricsto "sopranos" { \sopranoWords }
2610 \new Staff = "altos" <<
2611 \set Staff.instrumentName = "Alto"
2612 \new Voice = "altos" { \global \altoMusic }
2614 \new Lyrics \lyricsto "altos" { \altoWords }
2615 \new Staff = "tenors" <<
2616 \set Staff.instrumentName = "Tenor"
2617 \new Voice = "tenors" { \global \tenorMusic }
2619 \new Lyrics \lyricsto "tenors" { \tenorWords }
2620 \new Staff = "basses" <<
2621 \set Staff.instrumentName = "Bass"
2622 \new Voice = "basses" { \global \bassMusic }
2624 \new Lyrics \lyricsto "basses" { \bassWords }
2628 \set PianoStaff.instrumentName = "Piano"
2629 \new Staff = "upper" \upper
2630 \new Staff = "lower" \lower
2636 Ninguna de las plantillas proporciona esta disposición con exactitud.
2637 La más parecida es @q{partitura vocal SATB y reducción de piano
2638 automática} (véase @ref{Vocal ensembles}), pero necesitamos cambiar la
2639 disposición y añadir un acompañamiento de piano que no esté derviado
2640 automáticamente de las partes vocales. Las variables que contienen la
2641 música y la letra de las partes vocales es adecuada, pero tendremos
2642 que añadir variables para la reducción de piano.
2644 El orden en que aparecen los contextos en el ChoirStaff de la
2645 plantilla no se corresponde con el orden de la partitura vocal que
2646 hemos mostrado más arriba. Tenemos que reordenarlas para que haya
2647 cuatro pentagramas con la letra escrita directamente bajo las notas de
2648 cada parte. Todas las voces deben ser @code{\voiceOne}, que es la
2649 predeterminada, para que las instrucciones @code{\voiceXXX} se puedan
2650 eliminar. También tenemos que especificar la clave de tenor (clave de
2651 sol octava baja) en las partes de tenor. Aún no hemos encontrado la
2652 forma en que la letra se especifica en la plantilla, así que tenemos
2653 que utilizar el método que nos resulta familiar. También tenemos que
2654 escribir los nombres de cada pentagrama.
2656 Al hacerlo así obtenemos el ChoirStaff siguiente:
2660 \new Staff = "sopranos" <<
2661 \set Staff.instrumentName = "Soprano"
2662 \new Voice = "sopranos" @{ \global \musicaSoprano @}
2664 \new Lyrics \lyricsto "sopranos" @{ \latraSoprano @}
2665 \new Staff = "altos" <<
2666 \set Staff.instrumentName = "Alto"
2667 \new Voice = "altos" @{ \global \musicaAlto @}
2669 \new Lyrics \lyricsto "altos" @{ \letraAlto @}
2670 \new Staff = "tenores" <<
2671 \set Staff.instrumentName = "Tenor"
2672 \new Voice = "tenores" @{ \global \musicaTenor @}
2674 \new Lyrics \lyricsto "tenores" @{ \letraTenor @}
2675 \new Staff = "bajos" <<
2676 \set Staff.instrumentName = "Bass"
2677 \new Voice = "bajos" @{ \global \musicaBajo @}
2679 \new Lyrics \lyricsto "bajos" @{ \letraBajo @}
2680 >> % fin del ChoirStaff
2683 A continuación debemos trabajar sobre la parte de piano. Es fácil:
2684 tan sólo hay que sacar la parte de piano de la plantilla de @q{Piano
2689 \set PianoStaff.instrumentName = "Piano"
2690 \new Staff = "superior" \superior
2691 \new Staff = "inferior" \inferior
2695 y escribir las definiciones de variable para @code{superior} e
2698 Los grupos ChoirStaff y PianoStaff se deben combinar utilizando
2699 ángulos dobles, ya queremos apilarlos unos sobre otros:
2702 << % combinar los grupos ChoirStaff y PianoStaff uno sobre el otro
2704 \new Staff = "sopranos" <<
2705 \new Voice = "sopranos" @{ \global \musicaSoprano @}
2707 \new Lyrics \lyricsto "sopranos" @{ \letraSoprano @}
2708 \new Staff = "altos" <<
2709 \new Voice = "altos" @{ \global \musicaAlto @}
2711 \new Lyrics \lyricsto "altos" @{ \letraAlto @}
2712 \new Staff = "tenores" <<
2713 \clef "G_8" % clave de tenor
2714 \new Voice = "tenores" @{ \global \musicaTenor @}
2716 \new Lyrics \lyricsto "tenores" @{ \letraTenor @}
2717 \new Staff = "bajos" <<
2719 \new Voice = "bajos" @{ \global \musicaBajo @}
2721 \new Lyrics \lyricsto "bajos" @{ \letraBajo @}
2722 >> % fin del ChoirStaff
2725 \set PianoStaff.instrumentName = "Piano"
2726 \new Staff = "upper" \upper
2727 \new Staff = "lower" \lower
2732 Al combinar todo esto junto y escribir la música de los tres compases
2733 del ejemplo anterior, obtenemos:
2735 @lilypond[quote,verbatim,ragged-right,addversion]
2736 global = { \key d \major \time 4/4 }
2737 sopranoMusic = \relative c'' {
2739 r4 d2 a4 | d4. d8 a2 | cis4 d cis2 |
2741 sopranoWords = \lyricmode {
2742 Wor -- thy is the lamb that was slain
2744 altoMusic = \relative a' {
2746 r4 a2 a4 | fis4. fis8 a2 | g4 fis fis2 |
2748 altoWords = \sopranoWords
2749 tenorMusic = \relative c' {
2751 r4 fis2 e4 | d4. d8 d2 | e4 a, cis2 |
2753 tenorWords = \sopranoWords
2754 bassMusic = \relative c' {
2756 r4 d2 cis4 | b4. b8 fis2 | e4 d a'2 |
2758 bassWords = \sopranoWords
2759 upper = \relative a' {
2762 r4 <a d fis>2 <a e' a>4 |
2763 <d fis d'>4. <d fis d'>8 <a d a'>2 |
2764 <g cis g'>4 <a d fis> <a cis e>2 |
2766 lower = \relative c, {
2769 <d d'>4 <d d'>2 <cis cis'>4 |
2770 <b b'>4. <b' b'>8 <fis fis'>2 |
2771 <e e'>4 <d d'> <a' a'>2 |
2775 << % combine ChoirStaff and PianoStaff in parallel
2777 \new Staff = "sopranos" <<
2778 \set Staff.instrumentName = "Soprano"
2779 \new Voice = "sopranos" { \global \sopranoMusic }
2781 \new Lyrics \lyricsto "sopranos" { \sopranoWords }
2782 \new Staff = "altos" <<
2783 \set Staff.instrumentName = "Alto"
2784 \new Voice = "altos" { \global \altoMusic }
2786 \new Lyrics \lyricsto "altos" { \altoWords }
2787 \new Staff = "tenors" <<
2788 \set Staff.instrumentName = "Tenor"
2789 \new Voice = "tenors" { \global \tenorMusic }
2791 \new Lyrics \lyricsto "tenors" { \tenorWords }
2792 \new Staff = "basses" <<
2793 \set Staff.instrumentName = "Bass"
2794 \new Voice = "basses" { \global \bassMusic }
2796 \new Lyrics \lyricsto "basses" { \bassWords }
2800 \set PianoStaff.instrumentName = "Piano "
2801 \new Staff = "upper" \upper
2802 \new Staff = "lower" \lower
2809 @node Building a score from scratch
2810 @subsection Building a score from scratch
2812 @cindex plantilla, escribir su propia
2813 @cindex ejemplo de escritura de una partitura
2814 @cindex escribir una partitura, ejemplo
2815 @cindex partitura, ejemplo de escritura
2817 Después de adquirir algo de soltura en la escritura del código de
2818 LilyPond, se dará cuenta de que es más fácil construir completamente
2819 una partitura partiendo de cero, que modificar una plantilla. También
2820 puede desarrollar su propio estilo de forma que se adapte al tipo de
2821 música que le apetezca. Veamos a continuación cómo confeccionar una
2822 partitura para un preludio de órgano, como ejemplo.
2824 Comenzamos con una sección para el encabezamiento. Aquí es donde van
2825 el título, nombre del compositor, etc., después van las definiciones
2826 de las variables, y finalmente el bloque de partitura. Comencemos a
2827 verlas por encima y más tarde completaremos los detalles.
2829 Utilizaremos los dos primeros compases del preludio de Bach basado en
2830 @emph{Jesu, meine Freude}, que está escrito para órgano con dos
2831 manuales y pedal. Tiene estos dos compases de música al final de la
2832 sección. La parte del manual superior tiene dos voces, y el inferior
2833 y el pedal, una voz cada uno. Así pues, necesitamos cuatro
2834 definiciones para la música y una más para definir el compás y la
2838 \version @w{"@version{}"}
2840 title = "Jesu, meine Freude"
2841 composer = "J S Bach"
2843 TimeKey = @{ \time 4/4 \key c \minor @}
2844 MusicaManualUnoVozUno = @{s1@}
2845 MusicaManualUnoVozDos = @{s1@}
2846 MusicaManualDos = @{s1@}
2847 MusicaPedal = @{s1@}
2853 Por el momento hemos escrito tan sólo una nota espaciadora, @code{s1},
2854 en lugar de la música de verdad. La añadiremos más adelante.
2856 A continuación veamos qué va en el bloque de partitura.
2857 Sencillamente, reflejaremos la estructura de pentagramas que deseemos.
2858 La música de órgano se escribe por lo general en tres pentagramas, uno
2859 para cada uno de los manuales y otro para el pedal. Los pentagramas
2860 de los manuales se abarcan con una llave, así que los incluiremos en
2861 un grupo PianoStaff. La primera parte de manual tiene dos voces, y la
2866 \new Staff = "ManualUno" <<
2867 \new Voice @{ \MusicaManualUnoVozUno @}
2868 \new Voice @{ \MusicaManualUnoVozDos @}
2869 >> % fin del contexto de Staff ManualUno
2870 \new Staff = "ManualDos" <<
2871 \new Voice @{ \MusicaManualDos @}
2872 >> % fin del contexto de Staff ManualDos
2873 >> % fin del contexto de PianoStaff
2876 Después, tenemos que añadir un pentagrama para el órgano de pedal.
2877 Esto va por debajo del PianoStaff, pero debe ser simultáneo con él,
2878 por lo que escribimos dobles ángulos rodeando a los dos. Si esto se
2879 nos olvida, se producirá un error en el archivo log de registro. ¡Es
2880 un error muy común que cometerá antes o después! Intente copiar el
2881 ejemplo final que aparece al final de la sección, borre los dobles
2882 ángulos y procese el archivo para ver qué error produce.
2885 << % el grupo PianoStaff y el pentagrama de Pedal son simultáneos
2887 \new Staff = "ManualUno" <<
2888 \new Voice @{ \MusicaManualUnoVozUno @}
2889 \new Voice @{ \MusicaManualUnoVozDos @}
2890 >> % fin del contexto de Staff ManualUno
2891 \new Staff = "ManualDos" <<
2892 \new Voice @{ \MusicaManualDos @}
2893 >> % fin del contexto de Staff ManualDos
2894 >> % fin del contexto de PianoStaff
2895 \new Staff = "OrganoPedal" <<
2896 \new Voice @{ \MusicaOrganoPedal @}
2901 No es necesario utilizar la construcción simultánea @code{<< >>} para
2902 el pentagrama del manual dos y el pentagrama del órgano de pedal, ya
2903 que contienen una única expresión, pero no hace daño, y es una buena
2904 costumbre utilizar siempre dobles ángulos después de @code{\new Staff}
2905 cuando hay varias voces. Lo opuesto es cierto para las voces:
2906 normalmente deben ir seguidas de llaves @code{@{ .. @}} en caso de que
2907 tengamos música codificada como distintas variables que se deben
2908 situar consecutivamente.
2910 Añadamos esta estructura al bloque de partitura, y ajustemos el
2911 sangrado de los márgenes. También escribimos las claves
2912 correspondientes, nos aseguramos de que las plicas y ligaduras de
2913 unión y de expresión en cada una de las voces del pentagrama superior
2914 apuntan en la dirección adecuada con @code{\voiceOne} y
2915 @code{\voiceTwo} y escribimos el compás y la tonalidad en cada uno de
2916 los pentagramas usando nuestra variable previamente definida
2921 << % el grupo PianoStaff y el pentagrama de Pedal son simultáneos
2923 \new Staff = "ManualUno" <<
2924 \TimeKey % establecer compás y tonalidad
2926 \new Voice @{ \voiceOne \MusicaManualUnoVozUno @}
2927 \new Voice @{ \voiceTwo \MusicaManualUnoVozDos @}
2928 >> % fin del contexto de Staff ManualUno
2929 \new Staff = "ManualDos" <<
2932 \new Voice @{ \MusicaManualDos @}
2933 >> % fin del contexto de Staff ManualDos
2934 >> % fin del contexto de PianoStaff
2935 \new Staff = "OrganoPedal" <<
2938 \new Voice @{ \MusicaOrganoPedal @}
2939 >> % fin del pentagrama de OrganoPedal
2941 @} % end Score context
2944 Con esto se completa la estructura. Toda música para órgano de tres
2945 pentagramas tendrá una estructura similar, aunque el número de voces
2946 puede variar. Todo lo que nos queda es añadir la música, y combinar
2949 @lilypond[quote,verbatim,ragged-right,addversion]
2951 title = "Jesu, meine Freude"
2952 composer = "J S Bach"
2954 TimeKey = { \time 4/4 \key c \minor }
2955 ManualOneVoiceOneMusic = \relative g' {
2956 g4 g f ees | d2 c2 |
2958 ManualOneVoiceTwoMusic = \relative c' {
2959 ees16 d ees8~ ees16 f ees d c8 d~ d c~ |
2960 c c4 b8 c8. g16 c b c d |
2962 ManualTwoMusic = \relative c' {
2963 c16 b c8~ c16 b c g a8 g~ g16 g aes ees |
2964 f ees f d g aes g f ees d e8~ ees16 f ees d |
2966 PedalOrganMusic = \relative c {
2967 r8 c16 d ees d ees8~ ees16 a, b g c b c8 |
2968 r16 g ees f g f g8 c,2 |
2972 << % PianoStaff and Pedal Staff must be simultaneous
2974 \new Staff = "ManualOne" <<
2975 \TimeKey % set time signature and key
2977 \new Voice { \voiceOne \ManualOneVoiceOneMusic }
2978 \new Voice { \voiceTwo \ManualOneVoiceTwoMusic }
2979 >> % end ManualOne Staff context
2980 \new Staff = "ManualTwo" <<
2983 \new Voice { \ManualTwoMusic }
2984 >> % end ManualTwo Staff context
2985 >> % end PianoStaff context
2986 \new Staff = "PedalOrgan" <<
2989 \new Voice { \PedalOrganMusic }
2990 >> % end PedalOrgan Staff context
2992 } % end Score context