1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond-learning.tely
4 Translation of GIT committish: bea70d053e3e279c3fbb18cbce52d995ce04fec7
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
11 @node Fundamental concepts
12 @chapter Fundamental concepts
14 Ha podido ver en el tutorial cómo producir música bellamente impresa a
15 partir de un simple archivo de texto. Esta sección presenta los
16 conceptos y técnicas que se requieren para producir partituras
17 igualmente bellas pero más complejas.
20 * How LilyPond files work::
21 * Voices contain music::
22 * Contexts and engravers::
23 * Extending the templates::
27 @node How LilyPond files work
28 @section How LilyPond files work
30 El formato de entrada de LilyPond es bastante libre en su forma y
31 concede a los usuarios con experiencia mucha flexibilidad para
32 estructurar sus archivos de la forma que deseen. Sin embargo, toda
33 esta flexibilidad puede hacer que las cosas se vuelvan confusas para
34 los nuevos usuarios. Esta sección le va a explicar parte de esta
35 estructura, pero puede obviar ciertos detalles en aras de la
36 simplicidad. Para ver una descripción completa del formato de
37 entrada, consulte @ruser{File structure}.
41 * Introduction to the LilyPond file structure::
42 * Score is a (single) compound musical expression::
43 * Nesting music expressions::
44 * On the un-nestedness of brackets and ties::
47 @node Introduction to the LilyPond file structure
48 @subsection Introduction to the LilyPond file structure
50 Un ejemplo básico de archivo de entrada de lilypond es el siguiente:
53 \version @w{"@version{}"}
55 @var{...expresión musical compuesta...} % toda la música viene aquí
63 Existen muchas variaciones de este esquema básico, pero el ejemplo
64 constituye un útil punto de partida.
66 Hasta el momento, ninguno de los ejemplos que ha podido ver utiliza la
67 instrucción @code{\score@{@}}. Esto es así a causa de que LilyPond
68 añade automáticamente las órdenes adicionales que se requieren cuando
69 le proporcionamos una entrada sencilla. LilyPond trata una entrada
79 como una abreviatura de esta otra:
96 En tras palabras, si la entrada consta de una única expresión musical,
97 LilyPond interpreta el archivo como si la expresción musical estuviera
98 rodeada por un envoltorio hecho por las instrucciones que acabamos de
99 ver. De todas formas, vamos a volver al primer ejemplo para examinar
100 la instrucción @code{\score}, dejando las demás en su forma
103 Un bloque @code{\score} siempre debe contener una expresión musical
104 única, que debe aparecer inmediatamente después de la instrucción
105 @code{\score}. Recuerde que una expresión musical podía ser cualquier
106 cosa entre una sola nota hasta una enorme expresión compuesta como
111 @var{...inserte aquí la partitura completa de una ópera de Wagner...}
117 Puesto que todo se encuentra dentro de @code{@{ ... @}}, cuenta como
118 una expresión musical.
120 Como vimos anteriormente, el bloque @code{\score} puede contener otras
133 Hay personas que ponen algunos de estos comandos fuera del
134 bloque @code{\score} (por ejemplo, @code{\header} se
135 sitúa con frecuencia por encima del @code{\score}. Es tan sólo
136 otra abreviatura que LilyPond acepta.
138 Dos instrucciones más que no hemos visto aún son @code{\layout @{ @}}
139 y @code{\midi @{@}}. Si aparecen tal y como se muestran aquí, hacen
140 que LilyPond produzca una salida impresa y una salida MIDI,
141 respectivamente. Se describen con todo detalle en el manual de
142 Referencia de la notación, en @ruser{Score layout} y en
143 @ruser{Creating MIDI files}.
145 Podemos escribir varios bloques @code{\score}. Cada uno de ellos
146 recibirá el mismo tratamiento que una partitura independiente, pero se
147 combinarán todos juntos en un archivo de salida único. No se necesita
148 ninguna instrucción @code{\book}, se creará una implícitamente. Sin
149 embargo, si quiere archivos de salida separados a partir de un archivo
150 @code{.ly}, entonces es necesario utilizar la instrucción @code{\book}
151 para separar las distintas secciones: cada bloque @code{\book} produce
152 un archivo de salida distinto. Para ver más detalles, consulte
153 @ruser{Multiple scores in a book}.
157 Otro atajo genial es la posibilidad de definir variables.
158 Todas las plantillas emplean lo siguiente:
161 melodia = \relative c' @{
170 Cuando LilyPond examina este archivo, toma el valor de @code{melodia}
171 (todo lo que está después del signo igual) y lo inserta dondequiera
172 que ve @code{\melodia}. No se requiere un cuidado especial con los
173 nombres (puede ser @code{melodia}, @code{global},
174 @code{manoderechadelpiano} o @code{fulanomengano}). Para ver más
175 detalles, consulte @ref{Saving typing with variables and functions}.
176 Recuerde que puede usar casi cualquier nombre que se le ocurra, en la
177 medida en que contenga solamente caracteres alfabéticos y sea
178 diferente de cualquiera de los nombres de instrucción de LilyPond.
179 Las limitaciones exactas que afectan a los nombres de variable se
180 detallan en @ruser{File structure}.
185 Para ver una definición completa del formato del código de entrada,
186 consulte @ruser{File structure}.
188 @node Score is a (single) compound musical expression
189 @subsection Score is a (single) compound musical expression
191 @cindex expresión musical compuesta
192 @cindex música, expresión compuesta de
194 En la sección anterior, @ruser{How LilyPond files work} hemos podido
195 ver la organización general de los archivos de entrada de LilyPond.
196 Pero parece que nos saltamos la parte más importante: ¿cómo
197 averiguamos qué escribir después de @code{\score}?
199 No nos hemos saltado nada en absoluto. El gran misterio es, sencillamente,
200 que no hay @emph{ningún} misterio. La siguiente línea lo explica
204 @emph{Una @code{\score} debe comenzar con una única expresión musical.}
208 Quizá encuentre útil dar un repaso a @ruser{Music expressions
209 explained}. En esta sección, vimos cómo elaborar grandes expresiones
210 musicales a partir de pequeñas piezas (comenzábamos con notas, luego
211 acordes, etc.). Ahora partiremos de una gran expresión musical y
212 recorreremos el camino inverso hacia abajo.
216 @{ % esta llave da inicio a la expresión musical completa
218 @var{...introduzca aquí la partitura completa de una ópera de Wagner...}
220 @} % esta llave da por terminada la expresión musical completa
225 Una ópera de Wagner completa puede ser fácilmente el doble de larga
226 que este manual, por tanto vamos a hacer sólo un cantante y un piano.
227 No necesitamos un @code{GrandStaff} para este conjunto, así que lo
228 retiramos. Sin embargo, sí que @emph{necesitamos} un cantante y un
234 \new Staff = "cantante" <<
236 \new PianoStaff = piano <<
243 Recuerde que usamos @code{<<} y @code{>>} en vez de @code{@{ ... @}}
244 para presentar música simultánea. Y, por supuesto, queremos presentar
245 las partes vocal y del piano al mismo tiempo, ¡no una después de otra!
246 Sin embargo, la construcción @code{<< ... >>} no es realmente
247 necesaria para el pentagrama del cantante (pues contiene una sola
248 expresión musical), pero los pentagramas (Staff) a menudo necesitan
249 varias voces (Voice) en su interior, así es bueno adoptar el hábito de
250 usar @code{<< ... >>} en lugar de llaves. Escribiremos algo de música
251 real más tarde; por ahora limitémonos a poner algunas notas y letra de
254 @lilypond[verbatim,quote,ragged-right]
257 \new Staff = "singer" <<
258 \new Voice = "vocal" { c'1 }
261 \new PianoStaff = "piano" <<
262 \new Staff = "upper" { c'1 }
263 \new Staff = "lower" { c'1 }
270 Ahora tenemos muchos más detalles. Tenemos la pauta del cantante:
271 contiene una @code{Voice} o voz (en LilyPond, este término hace
272 referencia a un conjunto de notas, no necesariamente notas vocales --
273 por ejemplo, un violín generalmente toca una voz --) y el texto de la
274 canción. También tenemos una pauta de piano: contiene un pentagrama
275 superior (mano derecha) y un pentagrama inferior (mano izquierda).
277 En este momento podríamos comenzar a meter las notas. Dentro de las
278 llaves que siguen a @code{\new Voice = vocal}, podríamos empezar
287 Pero si lo hiciéramos, la sección @code{\score} se haría bastante
288 larga y sería más difícil comprender lo que ocurre. En lugar de esto
289 utilizaremos identificadores o variables. Recordará que las vimos por
290 primera vez en la sección anterior. Así pues, escribiendo algunas
291 notas, ahora tenemos un fragmento musical de verdad:
293 @lilypond[verbatim,quote,ragged-right]
294 melody = \relative c'' { r4 d8\noBeam g, c4 r }
295 text = \lyricmode { And God said, }
296 upper = \relative c'' { <g d g,>2~ <g d g,> }
297 lower = \relative c { b2 e2 }
301 \new Staff = "singer" <<
302 \new Voice = "vocal" { \melody }
305 \new PianoStaff = "piano" <<
306 \new Staff = "upper" { \upper }
307 \new Staff = "lower" {
317 Tenga cuidado con la diferencia entre las notas, que se introducen con
318 @code{\relative}, y la letra, que se introduce con @code{\lyricmode}.
319 Estas instrucciones son esenciales para decirle a LilyPond que
320 interprete el contenido que viene a continuación como música y texto,
323 Cuando escriba una sección @code{\score} o cuando la esté leyendo,
324 hágalo despacio y con cuidado. Comience por la capa exterior y luego
325 trabaje sobre cada una de las capas interiores. También ayuda ser
326 estricto con los márgenes (asegúrese de que en su editor de texto cada
327 elemento de la misma capa comienza en la misma posición horizontal).
330 @node Nesting music expressions
331 @subsection Nesting music expressions
333 No es esencial declarar todos los pentagramas al comienzo; se pueden
334 crear temporalmente en cualquier momento. Esto es de especial
335 utilidad para crear secciones de ossia (véase @rglos{ossia}). A
336 continuación presentamos un ejemplo sencillo que muestra cómo
337 introducir temporalmente un pentagrama nuevo mientras dura un
338 fragmento de tras notas:
340 @lilypond[verbatim,quote,ragged-right]
357 Advierta que el tamaño de la clave es igual al que se imprime en un
358 cambio de clave (ligemamente menor que la clave al principio de una
359 línea). Esto es normal para cualquier clave que se imprime en la
362 La sección ossia se puede colocar encima del pentagrama de la manera
365 @lilypond[verbatim,quote,ragged-right]
373 alignAboveContext = "main" }
381 Este ejemplo utiliza @code{\with}, que se explica en todo detalle más
382 adelante. Es un medio de modificar el comportamiento predeterminado
383 de un solo pentagrama. Aquí, dice que el pentagrama nuevo se debe
384 colocar por encima del pentagrama llamado @qq{main} en vez de la
385 posición predeterminada que seería por debajo.
387 Los fragmentos de ossia se escriben a menudo sin clave y sin
388 indicación de compás, y generalmente en un tipo más pequeño. Esto
389 necesitaría más instrucciones que aún no se han visto. Véase
390 @ref{Size of objects}
393 @node On the un-nestedness of brackets and ties
394 @subsection On the un-nestedness of brackets and ties
397 En la escritura del archivo de entrada de LilyPond, hemos podido ver
398 algunos tipos de paréntesis, llaves o ángulos de distintos tipos.
399 Éstos obedecen a distintas reglas que al principio pueden resultar
400 confusas. Antes de explicar estas reglas, demos un repaso a las
401 distintas clases de corchetes, llaves y paréntesis.
403 @c attempt to force this onto a new page
405 @multitable @columnfractions .3 .7
406 @headitem Tipo de paréntesis
408 @item @code{@{ .. @}}
409 @tab Encierra un fragmento secuencial de música
411 @tab Encierra las notas de un acorde
412 @item @code{<< .. >>}
413 @tab Encierra secciones concurrentes o simultáneas
415 @tab Marca el comienzo y el final de una ligadura de expresión
416 @item @code{\( .. \)}
417 @tab Marca el comienzo y el final de una ligadura de fraseo
419 @tab Marca el comienzo y el final de un barrado manual
422 A las anteriores, debemos añadir otras construcciones que generan
423 líneas entre o a través de las notas: las ligaduras de unión (marcadas
424 con una tilde curva, @code{~}), los grupos especiales que se escriben
425 como @code{\times x/y @{..@}}, y las notas de adorno, que se escriben
426 como @code{\grace@{..@}}.
428 Fuera de LilyPond, el uso convencional de los paréntesis y otros
429 corchetes requiere que los distintos tipos se encuentren anidados
430 correctamente, como en: @code{<< [ @{ ( .. ) @} ] >>}, de manera que
431 los paréntesis que se cierran deben encontrarse en el orden
432 exactamente opuesto al de los paréntesis que se abren. Esto
433 @strong{es} un requisito para los tres tipos de paréntesis que se
434 describen mediante la parabla @q{Encierra} en la tabla anterior: se
435 deben anidar correctamente. Sin embargo, el resto de las llaves y
436 corchetes, que se encuentran descritos por la palabra @q{Marca} en la
437 misma tabla anterior, @strong{no} tienen por qué anidarse
438 estrictamente con ninguno de los otros paréntesis. De hecho, éstos no
439 son paréntesis en el sentido de que encierran algo: simplemente son
440 marcadores que indican dónde empieza o finaliza algo.
442 Asíi pues, por ejemplo, una ligadura de fraseo puede dar comienzo
443 antes de una barra insertada manualmente, y acabar antes de que acabe
444 la barra (algo que quizá no sea muy musical, pero es posible):
446 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
447 { g8\( a b[ c b\) a] }
450 En general, los distintos tipos de corchete, y los implicados en
451 grupos especiiales, ligaduras de unión y notas de adorno, se pueden
452 mezclar con total libertad. Este ejemplo muestra una barra que se
453 extiende hacia el interior de un grupo de valoración especial (línea
454 1), una ligadura de expresión que se prolonga hasta el interior de un
455 grupo especial (línea 2), una barra y una ligadura de expresión que se
456 prolongan hasta el interior de un grupo especial, una ligadura de
457 unión que atraviesa dos grupos especiales, y una ligadura de fraseo
458 que sale del interior de un grupo especial (líneas 3 y 4).
460 @lilypond[quote,verbatim,fragment,ragged-right]
462 r16[ g16 \times 2/3 {r16 e'8] }
463 g16( a \times 2/3 {b d) e' }
464 g8[( a \times 2/3 {b d') e'~]}
465 \times 4/5 {e'32\( a b d' e'} a'4.\)
470 @node Voices contain music
471 @section Voices contain music
473 UNTRANSLATED NODE: IGNORE ME
476 * I'm hearing Voices::
477 * Explicitly instantiating voices::
478 * Voices and vocals::
481 @node I'm hearing Voices
482 @subsection I'm hearing Voices
484 UNTRANSLATED NODE: IGNORE ME
486 @node Explicitly instantiating voices
487 @subsection Explicitly instantiating voices
489 UNTRANSLATED NODE: IGNORE ME
491 @node Voices and vocals
492 @subsection Voices and vocals
494 UNTRANSLATED NODE: IGNORE ME
496 @node Contexts and engravers
497 @section Contexts and engravers
499 UNTRANSLATED NODE: IGNORE ME
502 * Contexts explained::
503 * Creating contexts::
504 * Engravers explained::
505 * Modifying context properties::
506 * Adding and removing engravers::
508 @node Contexts explained
509 @subsection Contexts explained
511 Cuando se imprime la música, se tienen que añadir a la salida una gran cantidad de elementos
512 notacionales. Por ejemplo, compare la entrada y la salida del siguiente ejemplo:
514 @lilypond[quote,verbatim,relative=2,fragment]
518 La entrada es bastante escueta, pero en la salida se añaden líneas divisorias, alteraciones accidentales,
519 la clave y la indicación de compás. LilyPond @emph{interpreta} la
520 entrada. En esta fase se inspecciona la información musical en orden temporal,
521 de forma parecida a la lectura de una partitura de izquierda a derecha. Mientras se lee
522 la entrada, el programa recuerda dónde se encuentran los límites de los compases, y qué notas
523 requieren alteraciones explícitas. Esta información se puede presentar sobre varios
524 niveles. Por ejemplo, el efecto de una alteración accidental se encuentra limitada
525 a un solo pentagrama, mientras que una barra divisoria debe estar sincronizada a través
526 de la partitura de arriba a abajo.
528 Dentro de LilyPond, estas reglas y pequeñas porciones de información se agrupan en
529 @emph{Contexts}. Algunos ejemplos de contextos son @code{Voice} (Voz),
530 @code{Staff} (Pauta o pentagrama) y @code{Score} (Partitura). Los contextos son jerárquicos, por
531 ejemplo: un @code{Staff} contener muchas @code{Voice}s, y una
532 @code{Score} puede contener muchos contextos de @code{Staff}.
535 @sourceimage{context-example,5cm,,}
538 Cada contexto asume la responsabilidad de imponer algunas reglas de notación,
539 creando ciertos objetos de notación y manteniendo las propiedades
540 asociadas. Por ejemplo, el contexto @code{Voice} puede introducir una alteración
541 accidental y entonces el contexto @code{Staff} mantiene la regla de mostrar o
542 suprimir la alteración para el resto del compás. La
543 sincronización de las líneas divisorias se gestiona dentro del contexto de la partitura, @code{Score}.
545 Sin embargo, en algunas músicas posiblemente no queramos que las líneas divisorias estén
546 sincronizada (pensemos en una partitura polimétrica en compases de 4/4 y de 3/4). En tales casos,
547 debemos modificar los ajustes por omisión de los contextos @code{Score}
550 Para partituras muy sencillas, los contextos se crean implícitamente y no debemos
551 preocuparnos por ellos. Para piezas mayores, como por ejemplo cualquiera que tenga más de un pentagrama,
552 los contextos se deben crear explícitamente para asegurarnos
553 de que tendremos la cantidad exacta de pentagramas que necesitamos,
554 y que están en el orden correcto. Para tipografiar piezas
555 con notación especializada, puede ser útil modificar contextos existentes
556 o definir unos nuevos.
559 En la referencia del programa se encuentra una descripción completa de todos los contextos que están disponibles,
562 @internalsref{Contexts}.
565 Traducción @expansion{} Contexto.
568 @c [TODO: describe propagation]
570 @node Creating contexts
571 @subsection Creating contexts
573 Sólo puede haber un contexto en el nivel más alto: el contexto de
574 partitura @code{Score}. Se crea con la instrucción @code{\score} o,
575 en partituras sencillas, se crea automáticamente.
577 Para partituras que solamente tienen una voz y un pentagrama, podemos
578 dejar que los contextos @code{Voice} y @code{Staff} se creen
579 automáticamente, pero para partituras más complejas es necesario
580 crearlos a mano. La instrucción más simple que hace esto es
581 @code{\new}. Se antepone a una expresión musical, por ejemplo
584 @cindex contextos nuevos
585 @cindex nuevo, contexto
588 \new @var{tipo} @var{expresión_musical}
592 donde @var{tipo} es el nombre de un contexto (como @code{Staff} o
593 @code{Voice}). Esta instrucción crea un contexto nuevo, y comienza a
594 interpretar la @var{expresión_musical} que está dentro de ese
597 Observe que no hay ninguna instrucción @code{\new Score}; el contexto
598 @code{Score} único en el nivel más alto se introduce con
601 La instrucción @code{\new} también puede otorgar un nombre
602 identificativo al contexto para distinguirlo de otros contextos del
606 \new @var{tipo} = @var{identificador} @var{expresión_musical}
609 Observe la distinción entre el nombre del tipo de contexto,
610 @code{Staff}, @code{Voice}, etc., y el nombre identificativo de una
611 instancia en particular de ese tipo, que puede ser cualquier secuencia
612 de letras inventada por el usuario. El nombre identificativo se
613 utiliza para referirnos más tarde a esa instancia en particular de un
614 contexto. Hemos visto esto en la sección acerca de la letra, en
615 @ref{Voices and vocals}.
617 @node Engravers explained
618 @subsection Engravers explained
622 Todas y cada una de las marcas de la salida impresa de una partitura
623 hecha con LiilyPond está producida por un @code{Engraver} (grabador).
624 Así, tenemos un grabador para imprimir pentagramas, otro para imprimir
625 las cabezas de las notas, otro para las plicas, otro para las barras,
626 etc, etc. ¡En total hay más de 120 grabadores! Afortunadamente, para
627 la mayor parte de las partituras no es necesario conocer más que
628 algunos, y para partituras sencillas no tenemos que saber nada de
631 Los grabadores residen y operan dentro de Contextos. Los grabadores
632 como el grabador de la indicación metronómica,
633 @code{Metronome_mark_engraver}, cuya acción y resultado se aplica a la
634 partitura como un todo, operan en el contexto del nivel más alto: el
635 contexto de partitura @code{Score}.
637 El grabador de la clave @code{Clef_engraver} y el de la armadura
638 @code{Key_engraver} se encuentran probablemente en todos los contextos
639 de pentagrama (Staff), pues los distintos pentagramas podrían requerir
640 diferentes claves y armaduras.
642 El grabador de las cabezas de nota @code{Note_heads_engraver} y el de
643 las plicas @code{Stem_engraver} viven en cada uno de los contextos de
644 voz @code{Voice}, el contexto de nivel más bajo de todos.
646 Cada grabador procesa los objetos particulares asociados con su
647 función, y mantiene las propiedades que están relacionadas con dicha
648 función. Estas propiedades, como las que están asociadas con los
649 contextos, se pueden modificar para cambiar el funcionamiento del
650 grabador o el aspecto de esos elementos en la partitura impresa.
652 Todos los grabadores tienen nombres compuestos de varias palabras que
653 describen su función. Sólo está en mayúsculas la inicial de la
654 primera palabra, y el resto se le une mediante guiones bajos. Así, el
655 grabador @code{Staff_symbol_engraver} es responsable de la creación de
656 las líneas del pentagrama, y el @code{Clef_engraver} determina y
657 establece la altura o el punto de referencia sobre el pentagrama
658 dibujando un símbolo de clave.
660 A continuación presentamos algunos de los grabadores más comunes,
661 junto a su función. Podrá comprobar que es fácil adivinar la función
662 a partir del nombre (en inglés), y viceversa.
664 @multitable @columnfractions .3 .7
667 @item Accidental_engraver
668 @tab Hace las alteraciones accidentales, de precaución y de sugerencia.
670 @tab Graba las barras
672 @tab Graba las claves
673 @item Dynamic_engraver
674 @tab Crea reguladores e indicaciones dinámicas textuales
676 @tab Crea la armadura de la tonalidad
677 @item Metronome_mark_engraver
678 @tab Graba la indicación metronómica
679 @item Note_heads_engraver
680 @tab Graba la cabeza de las notas
682 @tab Graba los silencios
683 @item Staff_symbol_engraver
684 @tab Graba las cinco líneas (de forma predeterminada) del pentagrama
686 @tab Crea las plicas y los trémolos de una sola plica
687 @item Time_signature_engraver
688 @tab Crea las indicaciones de compás
693 Más adelante veremos cómo la salida de LilyPond se puede cambiar
694 mediante la modificación del funcionamiento de los Grabadores.
697 @node Modifying context properties
698 @subsection Modifying context properties
700 @cindex contexto, propiedades de
704 Los contextos se responsabilizan de mantener los valores de un cierto
705 número de @emph{properties} de contexto. Muchas de ellas se pueden
706 cambiar para influir en la interpretación del código de entrada y
707 cambiar así la apariencia de la salida impresa. Se modifican mediante
708 la instrucción @code{\set}. Esta instrucción toma la forma siguiente:
711 \set @emph{NombreDelContexto}.@emph{nombreDeLaPropiedad} = #@emph{valor}
714 Donde el @emph{NombreDelContexto} es normalmente @code{Score},
715 @code{Staff} o @code{Voice}. Se puede omitir, en cuyo caso se supone
718 Los nombres de las propiedades de contexto consisten en palabras
719 unidas sin ningún guión o barra baja, y donde todas las palabras
720 excepto la primera empiezan en mayúscula. A continuación podemos ver
721 algunos ejemplos de nombres de propiedades utilizadas con frecuencia.
722 Hay muchas más que las que se muestran aquí.
724 @c attempt to force this onto a new page
726 @multitable @columnfractions .25 .15 .45 .15
727 @headitem nombreDeLaPropiedad
730 @tab Valor de ejemplo
733 @tab Se es verdadero, poner becuadros adicionales antes de las alteraciones
734 @tab @code{#t}, @code{#f}
735 @item currentBarNumber
737 @tab Ajustar el número del compás actual
741 @tab Si es verdadero, imprimir ligaduras de expresión por encima y por debajo de las notas
742 @tab @code{#t}, @code{#f}
745 @tab Establecer el nombre del pentagrama, situado a la izquierda
746 @tab @code{"Cello I"}
749 @tab Aumentar o disminuir el tamaño de la fuente tipográfica
753 @tab Establecer el texto que se imprime antes del comienzo de una estrofa
758 donde un valor Booleano es verdadero (@code{#t}, True) o falso
759 (@code{#f}, False), un Entero es un número entero positivo, un número
760 Real es un número decimal positivo o negativo, y el texto se encierra
761 entre comillas dobles. Observe la aparición de signos de cuadradillo,
762 (@code{#}), en dos lugares diferentes: como parte del valor Booleano
763 antes de la @code{t} o la @code{f}, y antes del @emph{valor} dentro de
764 la sentencia @code{\set}. Así pues, cuando se está escribiendo un
765 valor Booleano, hay que escribir dos signos de cuadradillo, por
768 Antes de poder establecer cualquiera de estas propiedades, tenemos que
769 saber en qué contexto operan. A veces es algo obvio, pero en
770 ocasiones puede ser algo enrevesado. Si especificamos un contexto
771 equivocado, no se produce ningún mensaje de error, pero el
772 funcionamiento esperado no tendrá lugar. Por ejemplo, la propiedad
773 @code{instrumentName} (nombre del instrumento) vive claramente dentro
774 del contexto de Staff, puesto que es el pentagrama el que debe ser
775 nombrado. En este ejemplo, el primer pentagrama resulta etiquetado,
776 pero no el segundo, porque hemos omitido el nombre del contexto.
778 @lilypond[quote,verbatim,ragged-right]
780 \new Staff \relative c'' {
781 \set Staff.instrumentName = #"Soprano"
784 \new Staff \relative c' {
785 \set instrumentName = #"Alto" % Wrong!
791 Recuerde que el nombre del contexto predeterminado es Voice, así que
792 la segunda instrucción @code{\set} establece la propiedad
793 @code{instrumentName} del contexto Voice a @qq{Alto}, pero como
794 LilyPond no busca esta propiedad en el contexto @code{Voice}, no se
795 realiza ninguna acción. Esto no es un error, y no se registra ningún
796 mensaje en el archivo de errores Log.
798 De forma parecida, si el nombre de la propiedad se escribe con alguna
799 falta, no se produce ningún mensaje de error, y claramente la acción
800 esperada no puede tener lugar. De hecho, se puede establecer
801 cualquier @q{property} (ficticia) usando cualquier nombre que queramos
802 en cualquier contexto que exista, mediante el uso de la instrucción
803 @code{\set}. Pero si el nombre no es conocido para LilyPond, no
804 producirá ninguna acción. Esta es una de las razones por las que es
805 muy recomendable ussar un editor que sea sensible al contexto y con
806 resaltado de la sintaxis para la edición de archivos de LilyPond, como
807 por ejemplo Vim, Jedit, ConTEXT o Emacs, ya que los nombres de
808 propiedades desconocidas se resaltarán de forma distinta.
810 La propiedad @code{instrumentName} tendrá efecto solamente si se
811 establece dentro del contexto @code{Staff}, pero algunas propiedades
812 se pueden establecer en más de un contexto. Por ejemplo, la propiedad
813 @code{extraNatural} está establecida por defecto al valor ##t
814 (verdadero) para todos los pentagramas. Si se establece a ##f (falso)
815 en un contexto de @code{Staff} determinado, se aplicará solamente a
816 las alteraciones de ese pentagrama. Si se establece a falso en el
817 contexto de la partitura, @code{Score}, se aplicará a todos los
820 Así, esto desactivará los becuadros adicionales en un pentagrama:
822 @lilypond[quote,verbatim,ragged-right]
824 \new Staff \relative c'' {
827 \new Staff \relative c'' {
828 \set Staff.extraNatural = ##f
835 y esto los desactivará en todos los pentagramas:
837 @lilypond[quote,verbatim,ragged-right]
839 \new Staff \relative c'' {
842 \new Staff \relative c'' {
843 \set Score.extraNatural = ##f
849 El valor de cada propiedad establecido de esta forma se puede devolver
850 a su valor original con la instrucción @code{\unset}.
852 Las instrucciones @code{\set} y @code{\unset} pueden aparecer en
853 cualquier lugar del archivo de entrada y tendrán efecto a partir del
854 tiempo en que se encuentran y hasta el final de la partitura o hasta
855 que la propiedad se establezca de nuevo mediante @code{\set} o
856 @code{\unset}. Probemos a modificar el tamaño de la fuente
857 tipográfica, lo que afecta al tamaño de las cabezas de las notas
858 (entre otras cosas) varias veces. El cambio se toma a partir del
859 valor predeterminado, no el valor en curso.
861 @lilypond[quote,verbatim,ragged-right,relative=1,fragment]
863 % make note heads smaller
866 % make note heads larger
869 % return to original size
874 Hemos podido ver cómo establecer los valores de diversos tipos de
875 propiedad diferentes. Observe que los números enteros y reales van
876 siempre precedidos de un símbolo de cuadradillo, @code{#}, mientras
877 que un valor booleano verdadero o falso se especifica mediante ##t y
878 ##f, con dos cuadradillos. Una propiedad de texto se debe encerrar
879 entre comillas dobles, como antes, aunque veremos más adelante que el
880 texto realmente se peude especificar de una dorma mucho más general
881 utilizando la potentísima instrucción @code{markup}.
886 Las propiedades de contexto también se pueden establecer en el momento
887 en que se crea el contexto. A veces esta forma de establecer el valor
888 de una propiedad es mucho más clara, si ha de quedar fijo durante todo
889 el tiempo que dure el contexto. Cuando se crea un contexto con una
890 instrucción @code{\new} puede ir inmediatamente seguido de un bloque
891 @code{\with @{ .. @}} en el que se establecen los valores de las
892 propiedades. Por ejemplo, si queremos suprimir la impresión de
893 becuadros adicionales para toda la duración de un pentagrama, podemos
897 \new Staff \with @{ extraNatural = ##f @}
901 de la siguiente forma:
903 @lilypond[quote,verbatim,ragged-right]
909 \new Staff \with { extraNatural = ##f }
916 Efectivamente, esto sobreescribe el valor predeterminado de la
917 propiedad. Aún se puede modificar dinámicamente utilizando
918 @code{\set} y devolverlo a su (nuevo) valor predeterminado con
921 @node Adding and removing engravers
922 @subsection Adding and removing engravers
924 @cindex Grabadores, adición
925 @cindex Grabadores, eliminación
930 Hemos visto que cada uno de los contextos contiene varios grabadores,
931 cada uno de los cuales a su vez es responsable de la producción de una
932 fracción particular del resultado impreso, como líneas divisorias,
933 pentagramas, cabezas, plicas, etc. Si un grabador es eliminado de un
934 contexto, ya no podrá producir su salida impresa. Es una forma algo
935 radical de modificar la salida, pero a veces puede ser útil.
937 @subsubheading Changing a single context
939 Para eliminar un grabador de un contexto único, usamos la instrucción
940 @code{\with} situada inmediatamente después de la instrucción que crea
941 el contexto, como en la sección anterior.
943 Como ilustración, repitamos un ejemplo extraído de la sección anterior
944 con las líneas del pentagrama eliminadas. Recuerde que las líneas del
945 pentagrama están dibujadas por el grabador Staff_symbol_engraver.
947 @lilypond[quote,verbatim,ragged-right]
949 \remove Staff_symbol_engraver
953 \set fontSize = #-4 % make note heads smaller
955 \set fontSize = #2.5 % make note heads larger
957 \unset fontSize % return to original size
962 @cindex ámbito, grabador del
964 Los grabadores también se pueden añadir a los contextos individuales
965 La instrucción que lo hace es
967 @code{\consists @emph{Nombre_del_grabador}},
969 situada dentro de un bloque @code{\with}. Ciertas partituras vocales
970 tienen una indicación de @rglos{ambitus} situada al principio del
971 pentagrama para indicar el ámbito de notas en dicho pentagrama. El
972 ambitus se produce por parte del grabador @code{Ambitus_engraver}, que
973 normalmente no está incluido en ningún contexto. Si lo añadimos al
974 contexto @code{Voice}, calcula el rango a partir de esa única voz:
976 @lilypond[quote,verbatim,ragged-right]
979 \consists Ambitus_engraver
994 pero si añadimos el grabador de Ambitus al contexto de @code{Staff},
995 calcula el rango a partir de todas las notas en todas las voces de ese
998 @lilypond[quote,verbatim,ragged-right]
1000 \consists Ambitus_engraver
1016 @subsubheading Changing all contexts of the same type
1018 Los ejemplos anteriores muestran la manera de eliminar o añadir
1019 grabadores a los contextos individuales. También es posible eliminar
1020 o añadir grabadores a todos los contextos de un tipo específico,
1021 situando las instrucciones en el contexto correspondiente dentro de un
1022 bloque @code{\layout}. Por ejemplo, si queremos mostrar los rangos de
1023 tesitura para todos los pentagramas de una partitura de cuatro pautas,
1026 @lilypond[quote,verbatim,ragged-right]
1030 \relative c'' { c a b g }
1033 \relative c' { c a b g }
1037 \relative c' { c a b g }
1041 \relative c { c a b g }
1047 \consists Ambitus_engraver
1054 Los valores predeterminados de las propiedades de los contextos
1055 también se pueden establecer para todos los contextos de un tipo en
1056 particular incluyendo la instrucción @code{\set} dentro de un bloque
1057 @code{\context} de la misma forma.
1059 @node Extending the templates
1060 @section Extending the templates
1062 Ha leído el tutorial y ahora sabe escribir música. Pero ¿cómo puede poner
1063 los pentagramas que quiere? Las plantillas están muy bien, pero ¿qué ocurre
1064 si quiere algo que no está en una de ellas?
1066 Para empezar, tome la plantilla que le parezca más parecida a aquello que quiere
1067 conseguir. Digamos que quiere escribir algo para soprano y cello.
1068 En este caso comenzaríamos con la plantilla @q{Notas y letra} (para la parte
1073 melodia = \relative c' @{
1081 texto = \lyricmode @{
1087 \new Voice = "uno" @{
1091 \new Lyrics \lyricsto "uno" \text
1098 Ahora queremos añadir una parte de violoncello. Veamos el ejemplo @q{Sólo notas}:
1102 melodia = \relative c' @{
1117 No necesitamos dos comandos @code{\version}. Vamos a necesitar la sección @code{melodia}.
1118 No queremos dos secciones @code{\score} (si tuviésemos dos @code{\score}s, acabaríamos con las dos particellas por separado.
1119 Queremos las dos juntas, como un dúo.
1120 Dentro de la sección @code{\score}, no nos hacen falta dos
1121 @code{\layout} ni dos @code{\midi}.
1123 Si nos limitásemos a copiar y pegar la sección @code{melodia}, acabaríamos con dos
1124 secciones @code{melodia} separadas, así que vamos a cambiarles el nombre. Llamaremos
1125 @code{musicaSoprano} a la sección de la soprano y @code{musicaCello} a la sección del violoncello.
1126 Al mismo tiempo cambiaremos el nombre de @code{texto}
1127 a @code{letraSoprano}. Recuerde cambiar el nombre a las dos apariciones de todos estos
1128 nombres -- tanto la definición inicial (la
1129 parte @code{melodia = relative c' @{ }) --
1130 como el uso de ese nombre (en la sección @code{\score}).
1132 También aprovecharemos para cambiar el pentagrama de la parte del cello (los violoncellos
1133 se escriben normalmente en clave de Fa). Asimismo, cambiaremos algunas
1138 musicaSoprano = \relative c' @{
1146 letraSoprano = \lyricmode @{
1150 musicaCello = \relative c @{
1160 \new Voice = "uno" @{
1164 \new Lyrics \lyricsto "uno" \letraSoprano
1171 Esto tiene una pinta prometedora, pero la parte del cello no sale en la partitura
1172 (no la hemos puesto en la sección @code{\score}). Si queremos que la parte
1173 del cello aparezca debajo de la de soprano, tenemos que añadir
1176 \new Staff \musicaCello
1180 justo debajo de todo lo de la soprano. También tenemos que poner @code{<<} y
1181 @code{>>} antes y después de la música -- lo que indica a LilyPond que hay
1182 más de una cosa (en este caso, @code{Staff}) sucediendo al mismo tiempo -- . La
1183 @code{\score} se parecerá ahora a esto
1189 \new Voice = "uno" @{
1193 \new Lyrics \lyricsto "uno" \letraSoprano
1195 \new Staff \musicaCello
1203 Esto parece un poco enrevesado; los márgenes están descuadrados. Esto tiene
1204 fácil solución. Presentamos aquí la plantilla completa para soprano y cello.
1206 @lilypond[quote,verbatim,ragged-right]
1208 sopranoMusic = \relative c' {
1216 sopranoLyrics = \lyricmode {
1220 celloMusic = \relative c {
1231 \new Voice = "one" {
1235 \new Lyrics \lyricsto "one" \sopranoLyrics
1237 \new Staff \celloMusic
1245 * Soprano and cello::
1246 * Four-part SATB vocal score::
1247 * Building a score from scratch::
1249 @node Soprano and cello
1250 @subsection Soprano and cello
1252 UNTRANSLATED NODE: IGNORE ME
1254 @node Four-part SATB vocal score
1255 @subsection Four-part SATB vocal score
1257 UNTRANSLATED NODE: IGNORE ME
1259 @node Building a score from scratch
1260 @subsection Building a score from scratch
1262 UNTRANSLATED NODE: IGNORE ME
1266 When you actually translate this file, please remove these lines as
1267 well as all `UNTRANSLATED NODE: IGNORE ME' lines.