1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: c20bed72fb602fabf67087649df283f1978a9d94
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Entrada y salida generales
14 @chapter Entrada y salida generales
15 @translationof General input and output
17 Esta sección trata de asuntos relacionados con la entrada y salida
18 generales de LilyPond, más que con la notación específica.
21 * Estructura del código de entrada::
22 * Títulos y cabeceras::
23 * Trabajar sobre los archivos de entrada::
24 * Controlar la salida::
26 * Extraer información musical::
30 @node Estructura del código de entrada
31 @section Estructura del código de entrada
32 @translationof Input structure
34 El formato principal de entrada para LilyPond son archivos de texto.
35 Por convenio, el nombre de estos archivos termina en @file{.ly}.
38 * Estructura de una partitura::
39 * Varias partituras en un libro::
40 * Varios archivos de salida a partir de uno de entrada::
41 * Nombres de los archivos de salida::
42 * Estructura del archivo::
46 @node Estructura de una partitura
47 @subsection Estructura de una partitura
48 @translationof Structure of a score
52 Un bloque @code{\score} debe contener una expresión musical única
53 delimitada por un par de llaves:
62 @warning{Sólo puede haber @strong{una} expresión musical dentro del
63 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
65 Esta expresión musical única puede tener cualquier tamaño, y puede
66 contener otras expresiones musicales hasta cualquier grado de
67 complejidad. Todos los siguientes ejemplos son expresiones musicales:
73 @lilypond[verbatim,quote]
80 @lilypond[verbatim,quote]
82 \new Staff { c'4 c' c' c' }
83 \new Staff { d'4 d' d' d' }
91 \new Staff @{ \flute @}
92 \new Staff @{ \oboe @}
95 \new Staff @{ \violinI @}
96 \new Staff @{ \violinII @}
102 Los comentarios son una excepción a esta regla general (para ver otras
103 excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
104 una línea como los que están delimitados por @code{%@{ .. %@}} se
105 pueden escribir en cualquier lugar dentro del archivo de entrada. Se
106 pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
107 fuera de la expresión musical única dentro del bloque @code{\score}.
109 Recuerde que incluso dentro de un archivo que contenga solamente un
110 bloque @code{\score}, éste se encuentra incluido implícitamente dentro
111 de un bloque @code{\book}. Un bloque @code{\book} dentro de un
112 archivo fuente produce al menos un archivo de salida, y de forma
113 predeterminada el nombre del archivo de salida que se produce está
114 derivado del nombre del archivo de entrada, de forma que
115 @file{fandangoforelephants.ly} da como resultado
116 @file{fandangoforelephants.pdf}.
118 (Para ver más detalles acerca de los bloques @code{\book}, consulte
119 @ref{Varias partituras en un libro}, @ref{Varios archivos de salida a
120 partir de uno de entrada} y @ref{Estructura del archivo}.)
123 Manual de aprendizaje:
124 @rlearning{Trabajar sobre los archivos de entrada},
125 @rlearning{Explicación de las expresiones musicales},
126 @rlearning{La partitura es una (única) expresión musical compuesta}.
129 @node Varias partituras en un libro
130 @subsection Varias partituras en un libro
131 @translationof Multiple scores in a book
134 @cindex movimientos, varios
136 Un documento puede contener varias piezas de música y texto. Son
137 ejemplos un libro de estudios o una parte orquestal con varios
138 movimientos. Cada movimiento se introduce con un bloque
147 y los textos se introducen con un bloque @code{\markup}:
157 Todos los movimientos y textos que aparecen en el mismo archivo
158 @file{.ly} se tipografían normalmente en la forma de un solo archivo
173 Una excepción importante se da dentro de los documentos de
174 lilypond-book, en los que tenemos que escribir explícitamente un
175 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
176 salida el primer @code{\score} o @code{\markup}.
178 El encabezamiento de cada pieza se puede poner dentro del bloque
179 @code{\score}. Antes de cada movimiento, se imprime el nombre de la
180 pieza (@code{piece}) extraído del encabezamiento. El título del libro
181 entero se puede poner dentro del bloque @code{\book}, pero si no está
182 presente se inserta el encabezamiento @code{\header} que está al
183 principio del archivo.
187 title = "Ocho miniaturas"
188 composer = "Igor Stravinsky"
192 \header @{ piece = "Romanze" @}
195 ..texto de la segunda estrofa..
198 ..texto de la tercera estrofa..
202 \header @{ piece = "Menuetto" @}
208 Se pueden agrupar distintas piezas de música en partes de un libro
209 utilizando bloques @code{\bookpart}. Las partes de libro se separan
210 por medio de saltos de página, y pueden dar comienzo con un título,
211 como el libro propiamente dicho, mediante la especificación del bloque
217 title = "Título del libro"
218 subtitle = "Primera parte"
225 subtitle = "Segunda parte"
233 @node Varios archivos de salida a partir de uno de entrada
234 @subsection Varios archivos de salida a partir de uno de entrada
235 @translationof Multiple output files from one input file
237 Si queremos varios archivos de salida a partir del mismo archivo
238 @file{.ly}, podemos escribir varios bloques @code{\book}, donde cada
239 uno de estos bloques @code{\book} dará como resultado un archivo de
240 salida distinto. Si no especificamos ningún bloque @code{\book} en el
241 archivo, LilyPond trata implícitamente todo el archivo como un solo
242 bloque @code{\book}, véase @ref{Estructura del archivo}.
244 Al producir varios archivos a partir de un solo archivo fuente,
245 Lilypond se asegura de que ninguno de los archivos de salida de ningún
246 bloque @code{\book} sobreescribe el archivo de salida producido por un
247 @code{\book} anterior del mismo archivo de entrada.
249 Lo hace añadiendo un sufijo al nombre de la salida para cada libro
250 @code{\book} que utiliza el nombre del archivo de salida
251 predeterminado, derivado del archivo fuente de entrada.
253 El comportamiento predeterminado es añadir un sufijo con el número de
254 versión para cada nombre que pueda coincidir; así:
259 \layout @{ @dots{} @}
263 \layout @{ @dots{} @}
267 \layout @{ @dots{} @}
271 en el archivo fuente @file{eightminiatures.ly}, produce
275 @file{eightminiatures.pdf},
277 @file{eightminiatures-1.pdf} y
279 @file{eightminiatures-2.pdf}.
283 @node Nombres de los archivos de salida
284 @subsection Nombres de los archivos de salida
285 @translationof Output file names
287 @funindex \bookOutputSuffix
288 @funindex \bookOutputName
290 Lilypond le ofrece unos mecanismos que le permiten controlar los
291 nombres de archivo que se utilizan por parte de los diversos motores
292 finales al producir los archivos de salida.
294 En la sección anterior vimos cómo Lilypond evita las coincidencias de
295 nombres al producir varias salidas a partir de un único archivo fuente
296 de entrada. También podemos especificar nuestros propios sufijos para
297 cada bloque @code{\book}, de manera que podemos producir, por ejemplo,
298 archivos con los nombres @file{eightminiatures-Romanze.pdf},
299 @file{eightminiatures-Menuetto.pdf} y
300 @file{eightminiatures-Nocturne.pdf} añadiendo una declaración
301 @code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
305 \bookOutputSuffix "Romanze"
307 \layout @{ @dots{} @}
310 \bookOutputSuffix "Menuetto"
312 \layout @{ @dots{} @}
315 \bookOutputSuffix "Nocturne"
317 \layout @{ @dots{} @}
321 También podemos especificar un nombre de archivo de salida diferente
322 para cada bloque @code{book}, mediante la utilización de declaraciones
323 @code{\bookOutputName}:
327 \bookOutputName "Romanze"
329 \layout @{ @dots{} @}
332 \bookOutputName "Menuetto"
334 \layout @{ @dots{} @}
337 \bookOutputName "Nocturne"
339 \layout @{ @dots{} @}
343 El código anterior produce los siguientes archivos de salida:
349 @file{Menuetto.pdf} y
355 @node Estructura del archivo
356 @subsection Estructura del archivo
357 @translationof File structure
367 Un archivo @file{.ly} puede contener cualquier número de expresiones
368 del nivel superior, donde una expresión del nivel superior es una de
369 las siguientes posibilidades:
373 Una definición de salida, como @code{\paper}, @code{\midi} y
374 @code{\layout}. Tal definición en el nivel más alto cambia los
375 ajustes predeterminados para todo el libro. Si se introduce más de
376 una de estas definiciones del mismo tipo en el nivel más alto,
377 cualquier definición en una expresión posterior tiene prioridad.
380 Una expresión directa de Scheme, como
381 @code{#(set-default-paper-size "a7" 'landscape)} o
382 @code{#(ly:set-option 'point-and-click #f)}.
385 Un bloque @code{\header}. Esto establece el bloque de encabezamiento
386 global. Es el bloque que contiene las definiciones de los ajustes
387 para todo el libro, como el compositor, título, etc.
390 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
391 del nivel superior, y se combina con ellas formando un @code{\book}
392 (libro) único. Este comportamiento se puede cambiar estableciendo el
393 valor de la variable @code{toplevel-score-handler} en el nivel
394 superior. El @emph{handler} predeterminado se define en el archivo de
395 inicio @file{../scm/lily.scm}.
398 Un bloque @code{\book} combina lógicamente varios movimientos (es
399 decir, varios bloques @code{\score}) en un solo documento. Si hay
400 varias partituras @code{\score}, se crea un solo archivo de salida
401 para cada bloque @code{\book}, en el que se concatenan todos los
402 movimientos correspondientes. La única razón para especificar
403 explícitamente bloques @code{\book} en un archivo de entrada
404 @file{.ly} es si queremos crear varios archivos de salida a partir de
405 un único archivo de entrada. Una excepción se da dentro de los
406 documentos de lilypond-book, en los que tenemos que escribir
407 explícitamente un bloque @code{\book} si queremos tener más de una
408 única partitura @code{\score} o marcado @code{\markup} en el mismo
409 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
410 de la variable @code{toplevel-book-handler} en el nivel superior. El
411 @emph{handler} predeterminado se define en el archivo de inicio
412 @file{../scm/lily.scm}.
415 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
416 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
417 la inserción de saltos de página o usar distintos ajustes de
418 @code{\paper} en las distintas partes.
421 Una expresión musical compuesta, como
426 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
427 único junto a todas las demás partituras @code{\score} y expresiones
428 musicales del nivel superior. En otras palabras, un archivo que
429 contiene sólo la expresión musical anterior se traduce a
446 Se puede cambiar este comportamiento estableciendo el valor de la
447 variable @code{toplevel-music-handler} en el nivel más alto. El
448 @emph{handler} predeterminado se define en el archivo de inicio
449 @file{../scm/lily.scm}.
452 Un texto de marcado, por ejemplo una estrofa
455 2. Estrofa dos, línea uno
459 Los textos de marcado se colocan encima, en medio o debajo de las
460 partituras o expresiones musicales, según donde aparezcan escritos.
467 fulano = @{ c4 d e d @}
470 Esto se puede utilizar más tarde en el archivo escribiendo
471 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
472 alfabético; sin números, guiones ni barras bajas.
476 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
481 % No justificar la salida
492 En cualquier punto del archivo se pueden introducir cualquiera de las
493 instrucciones léxicas siguientes:
496 @item @code{\version}
497 @item @code{\include}
498 @item @code{\sourcefilename}
499 @item @code{\sourcefileline}
501 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
504 Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
508 @cindex espacios en blanco
510 Por lo general se ignoran los espacios entre elementos del flujo de
511 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
512 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
513 evitar errores, en las siguientes situaciones:
516 @item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
517 @item A continuación de las instrucciones y variables, es decir, todos los elementos
518 que comienzan con un signo @code{\} de barra invertida.
519 @item A continuación de todo elemento que se deba interpretar como expresión
520 de Scheme, es decir, todo elemento que comience por un signo@tie{}@code{#}.
521 @item Para separar los elementos de una expresión de Scheme.
522 @item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
523 @code{\override} y @code{\set}. Concretamente, hay que usar espacios
524 alrededor del punto y el signo igual en instrucciones como
525 @code{\override Score . LyricText #'font-size = #5} y antes y después
526 de la instrucción completa.
531 Manual de aprendizaje:
532 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
535 @node Títulos y cabeceras
536 @section Títulos y cabeceras
537 @translationof Titles and headers
539 Casi toda la música impresa tiene un título y el nombre del
540 compositor; ciertas piezas tienen mucha más información.
543 * Crear títulos cabeceras y pies de página::
544 * Cabeceras pies y títulos personalizados::
545 * Crear notas al pie::
546 * Referencia a números de página::
551 @node Crear títulos cabeceras y pies de página
552 @subsection Crear títulos, cabeceras y pies de página
553 @translationof Creating titles headers and footers
556 * Explicación de los bloques de títulos::
557 * Presentación predeterminada de los bloques de título del libro y la partitura::
558 * Disposición predeterminada de las cabeceras y pies de página::
562 @node Explicación de los bloques de títulos
563 @unnumberedsubsubsec Explicación de los bloques de títulos
564 @translationof Title blocks explained
566 @c TODO: figure out how \bookpart titles work
568 Existen dos clases de bloques de títulos: el bloque principal de
569 títulos que aparece encima del primer bloque @code{\score} de un
570 libro, y los bloques individuales de título que aparecen dentro de
571 cada bloque @code{\score}. Los campos de texto para los dos tipos de
572 bloque se introducen mediante un bloque @code{\header}.
574 Si el libro tiene una única partitura, el bloque @code{\header} se
575 puede situar dentro o fuera del bloque @code{\score}.
577 @warning{Recuerde que al añadir un bloque @bs{}@code{header} dentro de
578 un bloque @bs{}@code{score}, la expresión musical debe aparecer antes
579 del bloque @bs{}@code{header}.}
581 @lilypond[papersize=a5,quote,verbatim,noragged-right]
584 composer = "J. S. Bach."
588 \new Staff \relative g, {
591 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
592 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
600 \new Staff \relative b {
604 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
605 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
613 Los campos de texto extraídos del bloque prinicipal de título de un
614 libro se pueden imprimir en todos los bloques @code{\score}, o
615 suprimirse manualmente:
617 @lilypond[papersize=a5,quote,verbatim,noragged-right]
620 print-all-headers = ##t
623 title = "DAS WOHLTEMPERIRTE CLAVIER"
625 % Do not display the tagline for this book
628 \markup { \vspace #1 }
632 \new Staff { \clef "bass" s1 }
635 title = "PRAELUDIUM I"
637 % Do not display the subtitle for this score
644 \new Staff { \clef "bass" s1 }
648 subsubtitle = "A 4 VOCI"
650 % Do not display the subtitle for this score
658 Referencia de la notación:
659 @ref{Estructura del archivo},
660 @ref{Personalización de los bloques de título}.
663 @node Presentación predeterminada de los bloques de título del libro y la partitura
664 @unnumberedsubsubsec Presentación predeterminada de los bloques de título del libro y la partitura
665 @translationof Default layout of book and score title blocks
667 La disposición y formato de los bloques de título están controlados
668 por medio de dos variables de @code{\paper}: @code{bookTitleMarkup}
669 para el bloque de título @code{\header} principal y
670 @code{scoreTitleMarkup} para los bloques @code{\header} individuales
671 dentro de un bloque @code{\score}.
673 @lilypond[papersize=a6,quote,verbatim,noragged-right]
675 % The following fields are centered
676 dedication = "Dedication"
678 subtitle = "Subtitle"
679 subsubtitle = "Subsubtitle"
680 instrument = "Instrument"
682 % The following fields are left-aligned on the left side
686 % The following fields are right-aligned on the right side
687 composer = "Composer"
688 arranger = "Arranger"
694 % The following fields are placed at opposite ends of the same line
701 @c Is the bit about \null markups true? -mp
703 Los campos de texto que se dejan sin establecer dentro de un bloque
704 @code{\header} se sustituyen por elementos de marcado nulos
705 @code{\null} de manera que no ocupen espacio innecesariamente.
707 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan los
708 campos de texto @code{piece} y @code{opus} en extremos opuestos de la
713 Utilice la variable @code{breakbefore} dentro de un bloque
714 @code{\header} que está propiamente dentro de un bloque @code{\score}
715 para hacer que los títulos del bloque @code{\header} del nivel
716 superior aparezcan ocupando toda la primera página, empezando la
717 música (definida en el bloque @code{\score}) en la página siguiente.
719 @lilypond[papersize=a8landscape,verbatim,noragged-right]
722 title = "This is my Title"
723 subtitle = "This is my Subtitle"
724 copyright = "This is the bottom of the first page"
727 \repeat unfold 4 { e'' e'' e'' e'' }
729 piece = "This is the Music"
737 Manual de aprendizaje:
738 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
740 Referencia de la notación:
741 @ref{Estructura del archivo}.
744 @file{ly/titling-init.ly}.
747 @node Disposición predeterminada de las cabeceras y pies de página
748 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
749 @translationof Default layout of headers and footers
751 Las @emph{cabeceras} y los @emph{pies} de página son líneas de texto
752 que aparecen en la parte más alta y en la más baja de las páginas
753 separadas del texto principal de un libro. Se controlan mediante las
754 siguientes variables de @code{\paper}:
757 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
758 @item @code{evenHeaderMarkup} (marcado de cabecera par)
759 @item @code{oddFooterMarkup} (marcado de pie impar)
760 @item @code{evenFooterMarkup} (marcado de pie par)
763 Estas variables de marcado sólo pueden acceder a los campos de texto
764 extraídos de bloques @code{\header} del nivel superior (que se aplican
765 a todas las partituras del libro) y se definen en el archivo
766 @file{ly/titling-init.ly}. De forma predeterminada:
771 los números de página se sitúan automáticamente en el extremo superior
772 izquierdo (si es par) o superior derecho (si es impar), a partir de la
776 el campo de texto @code{instrument} se sitúa en el centro en cada
777 página, a partir de la segunda página.
780 el texto de @code{copyright} se centra en la parte baja de la primera
784 la línea @code{tagline} se centra al final de la última página, y
785 debajo del texto de @code{copyright} si sólo hay una página.
789 @lilypond[papersize=a8landscape]
799 La línea de etiqueta tagline predeterminada se puede cambiar añadiendo un campo
800 @code{tagline} en el bloque @code{\header} del nivel superior.
802 @lilypond[papersize=a8landscape,verbatim]
805 tagline = "... music notation for Everyone"
815 Para eliminar la línea @code{tagline}, establezca su valor a
819 @node Cabeceras pies y títulos personalizados
820 @subsection Cabeceras, pies y títulos personalizados
821 @translationof Custom headers footers and titles
823 @c TODO: somewhere put a link to header spacing info
824 @c (you'll have to explain it more in NR 4).
827 * Formateo personalizado del texto de los bloques de título::
828 * Personalización de los bloques de título::
829 * Disposición personalizada de cabeceras y pies de página::
833 @node Formateo personalizado del texto de los bloques de título
834 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
835 @translationof Custom text formatting for title blocks
837 Se pueden usar instrucciones @code{\markup} estándar para personalizar
838 el texto de cualquier cabecera, pie o título dentro del bloque
841 @lilypond[quote,verbatim,noragged-right]
845 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
846 subtitle = \markup { \italic "(Excerpt)" }
852 Referencia de la notación:
853 @ref{Formatear el texto}.
856 @node Personalización de los bloques de título
857 @unnumberedsubsubsec Personalización de los bloques de título
858 @translationof Custom layout for title blocks
860 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
861 útiles para dar un formato simple al texto, pero no permiten un
862 control preciso sobre la colocación de los títulos. Para personalizar
863 la colocación de los campos de texto, use una o las dos variables de
864 @code{\paper} siguientes:
867 @item @code{bookTitleMarkup} (marcado de título del libro)
868 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
871 Estas variables de marcado se estudian en
872 @ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
874 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y como
875 están definidos en el archivo @file{ly/titling-init.ly} son:
878 scoreTitleMarkup = \markup @{ \column @{
879 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
881 \fromproperty #'header:piece
882 \fromproperty #'header:opus
888 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
889 opuestos de la misma línea:
891 @lilypond[quote,verbatim,noragged-right]
895 piece = "PRAELUDIUM I"
901 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el campo
902 de texto @code{piece} aparece centrado y en un tipo de letra grande y
905 @lilypond[papersize=a5,quote,verbatim,noragged-right]
909 scoreTitleMarkup = \markup {
912 \fontsize #4 \bold \fromproperty #'header:piece
913 \fromproperty #'header:opus
917 \header { tagline = ##f }
921 piece = "PRAELUDIUM I"
928 Los campos de texto reservados normalmente para el bloque principal de
929 título se pueden insertar dentro de los bloques de título de las
930 partituras individuales con la variable @code{print-all-headers}
931 establecida dentro del bloque @code{\paper}. Una desventaja de la
932 utilización de este método es que los campos de texto que están
933 orientados específicamente para el bloque @code{\header} del nivel
934 superior han de suprimirse manualmente en cada uno de los bloques
935 @code{\score}. Véase @ref{Explicación de los bloques de títulos}.
937 Para evitarlo, añada el campo de texto deseado a la definición de
938 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de texto
939 @code{composer} (asociado normalmente con @code{bookTitleMarkup}) se
940 añade a @code{scoreTitleMarkup}, permitiendo que cada partitura
941 muestre un compositor diferente:
943 @lilypond[papersize=a5,quote,verbatim,noragged-right]
947 scoreTitleMarkup = \markup {
950 \fontsize #4 \bold \fromproperty #'header:piece
951 \fromproperty #'header:composer
955 \header { tagline = ##f }
960 composer = "Christian Petzold"
967 composer = "François Couperin"
973 También podemos crear nuestros propios campos de texto personalizados,
974 y referirnos a ellos en la definición del elemento de marcado.
976 @lilypond[papersize=a5,quote,verbatim,noragged-right]
980 scoreTitleMarkup = \markup {
983 \override #`(direction . ,UP) {
985 \center-align \fontsize #-1 \bold
986 \fromproperty #'header:mycustomtext %% User-defined field
987 \center-align \fontsize #4 \bold
988 \fromproperty #'header:piece
991 \fromproperty #'header:opus
995 \header { tagline = ##f }
1000 mycustomtext = "A 4 VOCI" %% User-defined field
1008 Referencia de la notación:
1009 @ref{Explicación de los bloques de títulos}.
1012 @node Disposición personalizada de cabeceras y pies de página
1013 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1014 @translationof Custom layout for headers and footers
1016 @c can make-header and make-footer be removed from
1017 @c paper-defaults-init.ly? -mp
1019 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1020 de utilidad para dar formato al texto de una manera sencilla, pero no
1021 permiten un control preciso sobre la colocación de las cabeceras y los
1022 pies de página. Para personalizar la colocación de los campos de
1023 texto, use una o más de las siguientes variables de @code{\paper}:
1026 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1027 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1028 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1029 @item @code{evenFooterMarkup} (marcado de pie de página par)
1032 El ejemplo siguiente centra los números de página en la parte baja de
1033 las páginas. En primer lugar, los ajustes predeterminados para
1034 @code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
1035 definiéndolos como un marcado @emph{nulo}. Después de esto, se
1036 redefine @code{oddFooterMarkup} con el número de página centrado.
1037 Finalmente, @code{evenFooterMarkup} recibe la misma disposición
1038 definiéndola como @code{\oddFooterMarkup}:
1040 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1043 print-page-number = ##t
1044 print-first-page-number = ##t
1045 oddHeaderMarkup = \markup \null
1046 evenHeaderMarkup = \markup \null
1047 oddFooterMarkup = \markup {
1049 \on-the-fly #print-page-number-check-first
1050 \fromproperty #'page:page-number-string
1053 evenFooterMarkup = \oddFooterMarkup
1056 \new Staff { s1 \break s1 \break s1 }
1062 Referencia de la notación:
1063 @ref{Explicación de los bloques de títulos},
1064 @ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
1067 @node Crear notas al pie
1068 @subsection Crear notas al pie
1069 @translationof Creating footnotes
1071 Se pueden crear dos tipos de notas al pie: automáticas y manuales.
1074 * Panorámica de las notas al pie::
1075 * Notas al pie automáticas::
1076 * Notas al pie manuales::
1079 @node Panorámica de las notas al pie
1080 @unnumberedsubsubsec Panorámica de las notas al pie
1081 @translationof Footnotes overview
1083 Las notas al pie automáticas crean indicadores numéricos crecientes;
1084 en cambio las notas al pie manuales permiten crear un indicador
1085 personalizado. Normalmente, las notas al pie se aplican como
1086 @code{\tweak}s y por ello se pueden colocar directamente sobre los
1087 grobs (objetos gráficos) creados por la mayor parte de los elementos y
1088 post-eventos musicales. En los casos en que esto no funciona así
1089 (como con las líneas divisorias y los cambios de compás, donde los
1090 grobs se producen como consecuencia de cambios en propiedades), las
1091 notas al pie se pueden también especificar como un evento musical
1092 independiente que afecta a todos los grobs de un tipo dado en un punto
1095 La forma completa de una instrucción de nota al pie es
1098 \footnote @var{marca} @var{desplazamiento} @var{grob} @var{nota}
1102 Los elementos son como sigue:
1106 es un elemento de marcado o cadena que especifica la nmarca de nota al
1107 pie que se usa tanto para señalar el punto de referencia como la nota
1108 en sí en la parte inferior de la página. Se puede omitir (o, de forma
1109 equivalente, sustituirse con @code{\default}) en cuyo caso se genera
1110 un número en secuencia.
1111 @item desplazamiento
1112 es una pareja de números como @samp{#(2 . 1)} que especifica los
1113 desplazamientos X e Y a partir del punto de referencia en que se
1116 especifica, por su nombre, un tipo de objeto gráfico o grob que marcar
1117 (como @samp{#'Flag} para el corchete de una nota). Si se da, el grob
1118 respectivo se usa como punto de referencia incluso en el caso de que
1119 su @q{causa} no sea la propia @var{música} referenciada sino un grob
1120 creado a partir de ella. Se puede omitit (o sustituirse por
1121 @code{\default}), y entonces sólo se anotará un grob creado
1124 Esta cadena o elemento de marcado especifica el texto de la nota que
1125 utilizar en la parte inferior de la página.
1127 Éste es el elemento, evento musical o componente de un acorde o
1128 post-evento, que se está anotando. Aunque no puede omitirse, @emph{sí
1129 puede} sustituirse por @code{\default} en cuyo caso la nota al pie no
1130 se adjunta a una expresión musical dada, sino a un momento de tiempo.
1131 Es obligatorio en este caso utilizar el argumento @var{grob} para
1132 seleccionar un tipo de grob afectado, como @samp{#'TimeSignature}
1133 (indicación de compás).
1136 Como ocurre con @code{\tweak}, si nuestra @code{\footnote} se aplica a
1137 un post-evento o articulación, tendrá que ser ella misma precedida de
1138 @code{-} para que el analizador sintáctico adjunte el resultado a la
1139 nota o silencio precedente.
1142 @node Notas al pie automáticas
1143 @unnumberedsubsubsec Notas al pie automáticas
1144 @translationof Automatic footnotes
1146 Las notas al pie automáticas toman cuatro argumentos: la posición
1147 @samp{(x . y)} del indicador, el nombre opcional del @var{grob} que
1148 especifica el objeto de presentación que se anota, el elemento de
1149 marcado de la porpia @var{nota} que aparecerá en la parte inferior de
1150 la página, y por supuesto la @var{música} a que adjuntar la nota al
1153 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1155 \header { tagline = ##f }
1157 \footnote #'(0.5 . -2)
1158 \markup { The first note }
1160 \footnote #'(0.5 . 1) #'Flag
1161 \markup { The third note }
1167 Las notas en acorde no ofrecen ninguna dificultad especial:
1169 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1171 \header { tagline = ##f }
1174 \footnote #'(1 . -1.25) "Here is a C" c
1175 \footnote #'(2 . -0.25) \markup { \italic "An E-flat" } es
1176 \footnote #'(2 . 3) \markup { \bold "This is a G" } g
1182 @warning{Cuando las notas al pie tienen la misma posición vertical, se
1183 imprimen en orden de descendencia: cuando más alta es la nota al pie,
1184 más arriba está en la lista.}
1186 He aquí unos ejemplos más de grobs con notas al pie, que
1187 muestran también la posición relativa de las notas respecto de la
1188 línea informativa y la línea de copyright.
1190 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1192 \header { copyright = \markup { "Copyright 1970" } }
1194 a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
1195 -\footnote #'(0 . 1.5) \markup { A slur } (
1196 b8)-\footnote #'(0 . -2) \markup { Beam } [ e]
1197 \footnote #'(1 . -1) #'Stem
1198 \markup { \teeny { This is a stem } }
1200 \footnote #'(0 . 0.5) #'AccidentalCautionary
1201 \markup \italic { A cautionary accidental }
1202 \footnote #'(1 . 1) "The note itself"
1203 dis?4-\footnote #'(0.5 . -0.5) \markup \italic { Slow Down }
1209 Para los elementos @code{\markup} del nivel superior, se requiere el
1210 uso de la instrucción @code{\auto-footnote}:
1212 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1214 \header { tagline = ##f }
1215 \markup { \auto-footnote "A simple tune" \italic "By me" }
1223 @node Notas al pie manuales
1224 @unnumberedsubsubsec Notas al pie manuales
1225 @translationof Manual footnotes
1227 @cindex notas al pie manuales
1229 Las notas al pie marcadas manualmente toman un primer argumento
1230 adicional de marcado, @var{marca} para construir la marca de
1231 referencia. A diferencia de las marcas de notas al pie generadas
1232 automáticamente, no aparecen antes del elemento de marcado @var{nota}
1233 en la parte inferior de la página: el establecimiento de la conexión
1234 visual se deja para el usuario. LilyPond sólo asegura que el marcado
1235 correspondiente aparece en la parte inferior de la misma página.
1237 Aparte de esto, su uso es idéntico al de las notas al pie numeradas
1240 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1242 \header { tagline = ##f }
1246 \markup { \italic "1. The first note" }
1250 \markup { \bold "2" } #'(0.5 . 1)
1251 "2. The second note"
1254 d-\footnote "3" #'(0.5 . -1) "3. Piano" \p
1259 Para anotar notas de acordes con notas al pie manuales:
1261 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1263 \header { tagline = ##f }
1266 \footnote "1" #'(1 . -1.25) "1. C" c
1268 \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" es
1269 \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
1275 @warning {Cuando las notas al pie tienen la misma posición vertical, las
1276 anotaciones se imprimen en orden de descendencia; cuanto más alta es
1277 la nota al pie, más arriba está en la lista.}
1279 He aquí algunos ejemplos de grobs anotados manualmente, mostrando
1280 también la posición relativa de las notas al pie respecto a la línea
1281 informativa a la de copyright:
1283 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1285 \header { tagline = ##f }
1288 \markup { \teeny 1 } #'(-3 . 0)
1289 \markup { 1. \bold Forte } \f
1291 \markup { \teeny b } #'(0 . 1.5)
1292 \markup { b. A slur } (
1294 \markup { \teeny 3 } #'(0 . -2)
1295 \markup { 3. Beam } [
1298 \markup { 4 } #'(1 . -1) #'Stem
1299 \markup { \bold 4. { This is a stem } }
1302 \markup \concat \teeny { "sharp (v)" }
1303 #'(0 . 0.5) #'AccidentalCautionary
1304 \markup \italic { v. A cautionary accidental }
1306 \markup \concat \teeny { "a" } #'(0.5 . -0.5)
1307 \markup \italic { a. Slow Down } _"rit."
1309 \markup { \teeny \musicglyph #"rests.4" }
1311 \markup { \null } \breathe
1316 Para anotar manualmente un elemento @code{\markup} del nivel superior:
1318 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1320 \header { tagline = ##f }
1321 \markup { "A simple tune" \footnote "*" \italic "* By me" }
1329 Manual de aprendizaje:
1330 @rlearning{Objetos e interfaces}.
1332 Referencia de la notación:
1333 @ref{Globos de ayuda},
1334 @ref{Disposición de la página},
1335 @ref{Indicaciones de texto},
1336 @ref{Guiones de texto},
1337 @ref{Títulos y cabeceras}.
1339 Referencia de funcionamiento interno:
1340 @rinternals{FootnoteEvent},
1341 @rinternals{FootnoteItem},
1342 @rinternals{FootnoteSpanner},
1343 @rinternals{Footnote_engraver}.
1346 Varias notas al pie en la misma página solo pueden ir apiladas unas
1347 sobre otras, y no se pueden imprimir en la misma línea. Las notas al
1348 pie no se pueden adjuntar a elementos de silencio multicompás
1349 @code{MultiMeasureRests}, y pueden colisionar con el objeto
1350 @code{Staff}, objetos de @code{\markup} y otras anotaciones
1351 @code{footnote}. Cuando use una cualquiera de las instrucciones
1352 @code{footnote} se requiere un bloque @code{\paper} que contenga
1353 @code{footnote-auto-number = ##f}.
1356 @node Referencia a números de página
1357 @subsection Referencia a números de página
1358 @translationof Reference to page numbers
1360 Un lugar determinado de una partitura puede señalizarse usando la
1361 instrucción @code{\label} (etiqueta), ya sea en el nivel superior o
1362 dentro de la música. Podemos referirnos a esta etiqueta más tarde
1363 dentro de un elemento de marcado, para obtener el número de la página
1364 en la que se sitúa el punto señalizado, usando la instrucción de
1365 marcado @code{\page-ref}.
1368 \header { tagline = ##f }
1374 \pageBreak \mark A \label #'markA
1378 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
1379 \markup { Mark A is on page \page-ref #'markA "0" "?" }
1383 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1385 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
1386 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1387 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1390 El motivo de que se necesite un medidor es que en el momento en que se
1391 están interpretando los marcados, los saltos de página aún no se han
1392 producido y por tanto los números de página no se conocen todavía.
1393 Para sortear este inconveniente, la interpretación real del marcado se
1394 retrasa hasta un momento posterior; sin embargo, las dimensiones del
1395 marcado se tienen que conocer de antemano, así que se usa el medidor
1396 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
1397 páginas, el medidor puede ser "00", es decir, un número de dos
1408 @node Índice general
1409 @subsection Índice general
1410 @translationof Table of contents
1412 Se puede insertar un índice general o tabla de contenidos utilizando
1413 la instrucción @code{\markuplist \table-of-contents}. Los elementos
1414 que deben aparecer en la tabla de contenidos se introducen con la
1415 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
1416 la jerarquía del código, o dentro de una expresión musical.
1419 \markuplist \table-of-contents
1422 \tocItem \markup "Primera partitura"
1426 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1431 \tocItem \markup "Segunda partitura"
1439 Los elementos de marcado que se usan para dar formato al índice
1440 general se encuentran definidos dentro del bloque @code{\paper}. Los
1441 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
1442 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
1443 los elementos del índice, que consisten en el título del elemento y el
1444 número de página. Estas variables se pueden cambiar por parte del
1449 %% Traducir el título del índice al español:
1450 tocTitleMarkup = \markup \huge \column {
1451 \fill-line { \null "Índice general" \null }
1454 %% usar una fuente mayor
1455 tocItemMarkup = \markup \large \fill-line {
1456 \fromproperty #'toc:text \fromproperty #'toc:page
1461 Observe la forma en que nos referimos al texto y al número de página
1462 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
1464 También se pueden definir nuevas instrucciones y elementos de
1465 marcado para crear índices generales más elaborados:
1467 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
1468 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
1469 utilizando esta variable de marcado del bloque @code{\paper}.
1472 En el ejemplo siguiente se define un estilo nuevo para introducir los
1473 nombres de los actos de una ópera en el índice general:
1477 tocActMarkup = \markup \large \column {
1479 \fill-line { \null \italic \fromproperty #'toc:text \null }
1485 #(define-music-function (parser location text) (markup?)
1486 (add-toc-item! 'tocActMarkup text))
1489 @lilypond[line-width=11.0\cm]
1490 \header { tagline = ##f }
1492 tocActMarkup = \markup \large \column {
1494 \fill-line { \null \italic \fromproperty #'toc:text \null }
1500 #(define-music-function (parser location text) (markup?)
1501 (add-toc-item! 'tocActMarkup text))
1504 \markuplist \table-of-contents
1505 \tocAct \markup { Atto Primo }
1506 \tocItem \markup { Coro. Viva il nostro Alcide }
1507 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1508 \tocAct \markup { Atto Secondo }
1509 \tocItem \markup { Sinfonia }
1510 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1515 Se pueden añadir puntos de relleno entre un elemento y su número de página:
1517 @lilypond[verbatim,quote]
1518 \header { tagline = ##f }
1520 tocItemMarkup = \tocItemWithDotsMarkup
1524 \markuplist \table-of-contents
1525 \tocItem \markup { Allegro }
1526 \tocItem \markup { Largo }
1533 @file{ly/toc-init.ly}.
1536 @funindex \table-of-contents
1537 @code{\table-of-contents},
1543 @node Trabajar sobre los archivos de entrada
1544 @section Trabajar sobre los archivos de entrada
1545 @translationof Working with input files
1548 * Inclusión de archivos de LilyPond::
1549 * Distintas ediciones a partir de una misma fuente::
1550 * Caracteres especiales::
1554 @node Inclusión de archivos de LilyPond
1555 @subsection Inclusión de archivos de LilyPond
1556 @translationof Including LilyPond files
1559 @cindex including files
1561 Un proyecto grande se puede dividir en varios archivos. Para
1562 referirse a otro archivo, utilice
1565 \include "otroarchivo.ly"
1568 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
1569 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
1570 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
1571 podríamos querer archivos distintos para cada parte instrumental y
1572 crear un archivo de @qq{partitura completa} que reúne los archivos
1573 individuales de los instrumentos. Normalmente el archivo incluido
1574 define un cierto número de variables que a partir de entonces quedan
1575 disponibles para poderlas utilizar en el archivo de la partitura
1576 completa. En los archivos incluidos se pueden marcar las secciones
1577 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
1578 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
1580 Los archivos que están en el directorio de trabajo actual se pueden
1581 referenciar simplemente especificando el nombre después de la
1582 instrucción @code{\include}. Los archivos en otros lugares se pueden
1583 incluir proporcionando una referencia de ruta completa o una ruta
1584 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
1585 barra invertida de DOS/Windows, \, como separador de directorio). Por
1586 ejemplo, si @file{material.ly} está situado un directorio por encima
1587 del directorio de trabajo actual, utilice
1590 \include "../material.ly"
1594 o si los archivos de las partes orquestales incluidas están todos
1595 situados en un subdirectorio llamado @file{partes} dentro del
1596 directorio actual, use
1599 \include "partes/VI.ly"
1600 \include "partes/VII.ly"
1604 Los archivos de inclusión también pueden contener enunciados
1605 @code{\include} a su vez. De forma predeterminada, estos enunciados
1606 @code{\include} de segundo nivel no se interpretan hasta que se
1607 incorporan al archivo principal, por lo que los nombres de archivo que
1608 especifican deben ser relativos al directorio que contiene el archivo
1609 principal, no al directorio que contiene el archivo incluido. Sin
1610 embargo, este comportamiento se puede modificar pasando la opción
1611 @option{-drelative-includes} en la línea de órdenes (o mediante la
1612 adición de @code{#(ly:set-option 'relative-includes #t)} al principio
1613 del archivo principal de entrada). Con el valor de
1614 @code{relative-includes} establecido, la ruta de cada instrucción
1615 @code{\include} se considera relativa al archivo que contiene dicha
1616 instrucción. Este comportamiento es el recomendado y se convertirá en
1617 el comportamiento predeterminado en una versión futura de lilypond.
1619 También se pueden incluir archivos de un directorio que está en una
1620 ruta de búsqueda especificada como opción al invocar a LilyPond desde
1621 la línea de órdenes. Los archivos incluidos se especifican usando
1622 solamente su nombre de archivo. Por ejemplo, para compilar mediante
1623 este método un archivo @file{principal.ly} que incluye archivos
1624 situados en un subdirectorio llamado @file{partes}, cambie al
1625 directorio que contiene @file{principal.ly} e introduzca
1628 lilypond --include=partes principal.ly
1631 y en @file{principal.ly} escriba
1639 Los archivos que se incluyen en muchas partituras se pueden poner en
1640 el directorio de LilyPond @file{../ly} (la localización de este
1641 directorio depende de la instalación: véase
1642 @rlearning{Otras fuentes de información}). Estos archivos se pueden
1643 incluir sencillamente por su nombre en un enunciado @code{\include}.
1644 De esta forma se incluyen los archivos dependientes del idioma como
1647 LilyPond incluye de forma predeterminada ciertos archivos cuando se
1648 inicia el programa. Estas inclusiones no son visibles para el
1649 usuario, pero los archivos se pueden identificar ejecutando
1650 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
1651 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
1652 otras indicaciones. De forma alternativa, pueden verse explicaciones
1653 sobre los archivos más importantes de este conjunto en
1654 @rlearning{Otras fuentes de información}. Estos archivos se pueden
1655 editar, pero los cambios realizados sobre ellos se perderán al
1656 instalar una nueva versión de LilyPond.
1658 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
1659 @rlearning{Partituras y particellas}.
1662 Manual de aprendizaje:
1663 @rlearning{Otras fuentes de información},
1664 @rlearning{Partituras y particellas}.
1667 Si un archivo incluido recibe un nombre igual al de uno de los
1668 archivos de instalación de LilyPond, el archivo que tiene prioridad es
1669 el de los archivos de instalación de LilyPond.
1672 @node Distintas ediciones a partir de una misma fuente
1673 @subsection Distintas ediciones a partir de una misma fuente
1674 @translationof Different editions from one source
1676 Se pueden usar varios métodos para generar la producción de distintas
1677 versiones de una partitura a partir de la misma fuente musical. Las
1678 variables son quizá el más útil para combinar secciones extensas de
1679 música y/o anotaciones. Las etiquetas son más útiles para seleccionar
1680 una sección de entre varias secciones de música alternativas, más
1681 cortas, y se pueden usar también para dividir piezas de música en
1684 Cualquiera que sea el método utilizado, la separación de la notación
1685 de la estructura de la partitura hará que sea más fácil cambiar la
1686 estructura dejando intacta la notación.
1689 * Uso de las variables::
1690 * Uso de etiquetas::
1691 * Uso de ajustes globales::
1694 @node Uso de las variables
1695 @unnumberedsubsubsec Uso de las variables
1696 @translationof Using variables
1698 @cindex variables, uso de las
1700 Si las secciones de la música se definen dentro de variables, se
1701 pueden reutilizar en distintas partes de la partitura, véase
1702 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
1703 partitura vocal @notation{a cappella} con frecuencia incluye una
1704 reducción de piano de las partes para ensayar que es idéntica a la
1705 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
1706 puede combinar sobre un solo pentagrama la música de dos variables,
1707 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
1709 @lilypond[verbatim,quote]
1710 sopranoMusic = \relative c'' { a4 b c b8( a) }
1711 altoMusic = \relative g' { e4 e e f }
1712 tenorMusic = \relative c' { c4 b e d8( c) }
1713 bassMusic = \relative c' { a4 gis a d, }
1714 allLyrics = \lyricmode {King of glo -- ry }
1716 \new Staff = "Soprano" \sopranoMusic
1717 \new Lyrics \allLyrics
1718 \new Staff = "Alto" \altoMusic
1719 \new Lyrics \allLyrics
1720 \new Staff = "Tenor" {
1724 \new Lyrics \allLyrics
1725 \new Staff = "Bass" {
1729 \new Lyrics \allLyrics
1732 \set Staff.printPartCombineTexts = ##f
1738 \set Staff.printPartCombineTexts = ##f
1748 Se pueden producir partituras distintas que presenten sólo las partes
1749 vocales o sólo la parte de piano, cambiando solamente los enunciados
1750 estructurales, sin modificar la notación musical.
1752 Para partituras extensas, las definiciones de variable se pueden poner
1753 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
1756 @node Uso de etiquetas
1757 @unnumberedsubsubsec Uso de etiquetas
1758 @translationof Using tags
1761 @funindex \keepWithTag
1762 @funindex \removeWithTag
1763 @funindex \pushToTag
1764 @funindex \appendToTag
1766 @cindex mantener música etiquetada
1767 @cindex quitar música etiquetada
1768 @cindex división en música etiquetada
1770 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
1771 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
1772 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
1773 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
1774 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
1775 música etiquetada es como sigue:
1777 @multitable @columnfractions .5 .5
1781 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
1783 Se incluye la música no etiquetada y la música etiquetada con
1784 @var{nombre}; se excluye la música etiquetada con cualquier otro
1787 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
1789 Se incluye la música no etiquetada y la música etiquetada con
1790 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
1791 música etiquetada con @var{nombre}.
1793 Música etiquetada no precedida de @code{\keepWithTag} ni de
1794 @code{\removeWithTag}
1795 @tab Se incluye toda la música etiquetada y no etiquetada.
1798 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
1799 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
1800 @code{#'parte}), seguido de una expresión musical.
1802 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
1803 que muestra trinos con la notación usual y otra con los trinos
1804 expandidos explícitamente:
1806 @lilypond[verbatim,quote]
1807 music = \relative g' {
1809 \tag #'trills { d8.\trill }
1810 \tag #'expand { \repeat unfold 3 { e32 d } }
1815 \keepWithTag #'trills \music
1818 \keepWithTag #'expand \music
1823 De forma alternativa, a veces es más fácil excluir secciones de música:
1825 @lilypond[verbatim,quote]
1826 music = \relative g' {
1828 \tag #'trills { d8.\trill }
1829 \tag #'expand {\repeat unfold 3 { e32 d } }
1834 \removeWithTag #'expand
1838 \removeWithTag #'trills
1843 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
1847 -\tag #'@var{mi-etiqueta}
1850 a una articulación. Por ejemplo, esto define una nota con una
1851 indicación opcional de digitación y una nota con una anotación
1856 c1-\tag #'warn ^"¡Ojo!"
1859 Se pueden poner varias etiquetas sobre expresiones con varias entradas
1862 @lilypond[quote,verbatim]
1863 music = \relative c'' {
1864 \tag #'a \tag #'both { a4 a a a }
1865 \tag #'b \tag #'both { b4 b b b }
1868 \keepWithTag #'a \music
1869 \keepWithTag #'b \music
1870 \keepWithTag #'both \music
1874 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
1875 expresión musical para quitar varias secciones etiquetadas con nombres
1878 @lilypond[verbatim,quote]
1879 music = \relative c'' {
1880 \tag #'A { a4 a a a }
1881 \tag #'B { b4 b b b }
1882 \tag #'C { c4 c c c }
1883 \tag #'D { d4 d d d }
1892 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
1893 musical producen la eliminación de @emph{todas} las secciones
1894 etiquetadas, porque el primer filtro quita todas las secciones
1895 etiquetadas excepto la que se nombra, y el segundo filtro elimina
1896 incluso esa sección etiquetada.
1898 A vecespodemos desear dividir la música en un determinado lugar dentro
1899 de una expresión musical existente. Podemos usar @code{\pushToTag} y
1900 @code{\appendToTag} para añadir material delante o al final de los
1901 @code{elements} de una construcción musical existente. No toda
1902 construcción musical tiene la parte @code{elements}, pero las músicas
1903 secuenciaes y simultáneas son dos apuestas seguras:
1905 @lilypond[verbatim,quote]
1906 test = { \tag #'here { \tag #'here <<c''>> } }
1909 \pushToTag #'here c'
1910 \pushToTag #'here e'
1911 \pushToTag #'here g' \test
1912 \appendToTag #'here c'
1913 \appendToTag #'here e'
1914 \appendToTag #'here g' \test
1918 Las dos instrucciones admiten una etiqueta, el material que dividir en
1919 cada ocurrencia de la etiqueta, y la expresión etiquetada. Las
1920 instrucciones aseguran que se copia todo lo que cambian, de forma que
1921 el código original @code{\test} retiene su significado.
1924 Manual de aprendizaje:
1925 @rlearning{Organizar las piezas mediante variables}.
1927 Referencia de la notación:
1928 @ref{Combinación automática de las partes},
1929 @ref{Inclusión de archivos de LilyPond}.
1932 @c This warning is more general than this placement implies.
1933 @c Rests are not merged whether or not they come from tagged sections.
1934 @c Should be deleted? -td
1937 Multiple rests are not merged if you create a score with more
1938 than one tagged section at the same place.
1942 @node Uso de ajustes globales
1943 @unnumberedsubsubsec Uso de ajustes globales
1944 @translationof Using global settings
1946 @cindex include-settings
1948 Se pueden incluir ajustes globales a partir de un archivo distinto:
1951 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
1954 En archivos diferentes se pueden almacenar grupos de ajustes como
1955 el tamaño de la página o las fuentes tipográficas. Ello permite
1956 hacer diferentes ediciones de la mism a partitura así como aplicar
1957 ajustes estándar a muchas partituras, simplemente por medio de la
1958 especificación del archivo de ajustes adecuado.
1960 Esta técnica también funciona bien con el uso de hojas de estilo,
1961 como se estudia en @rlearning{Hojas de estilo}.
1964 Manual de aprendizaje:
1965 @rlearning{Organizar las piezas mediante variables},
1966 @rlearning{Hojas de estilo}.
1968 Referencia de la notación:
1969 @ref{Inclusión de archivos de LilyPond}.
1972 @node Caracteres especiales
1973 @subsection Caracteres especiales
1974 @translationof Special characters
1976 @cindex caracteres especiales
1977 @cindex caracteres no ASCII
1980 * Codificación del texto::
1986 @node Codificación del texto
1987 @unnumberedsubsubsec Codificación del texto
1988 @translationof Text encoding
1992 LilyPond usa el conjunto de caracteres definido por el consorcio
1993 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
1994 para los conjuntos de caracteres que se utilizan en prácticamente
1995 todos los idiomas modernos y también en muchos otros. Unicode se
1996 puede implementar utilizando varios esquemas de codificación
1997 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
1998 @emph{Unicode Transformation Format}, o formato de transformación de
1999 Unicode) que representa todos los caracteres comunes de Latin en un
2000 solo byte, y representa otros caracteres usando un formato de longitud
2001 variable de hasta cuatro bytes.
2003 El aspecto visual real de los caracteres viene determinado por los
2004 glifos que se definen en las fuentes tipográficas concretas que se
2005 tengan disponibles: una fuente tipográfica define la asignación de un
2006 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
2007 biblioteca Pango para representar y disponer tipográficamente textos
2010 LilyPond no realiza ninguna conversión en la codificación de la
2011 entrada. Esto significa que cualquier text, ya sea el título, la
2012 letra de la canción o una instrucción musical que contenga caracteres
2013 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
2014 forma más fácil de escribir dicho texto es utilizar un editor
2015 preparado para Unicode y guardar el archivo con la codificación UTF-8.
2016 Casi todos los editores modernos populares contemplan el UTF-8, por
2017 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
2018 Windows posteriores a NT usan Unicode como codificación de caracteres
2019 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
2020 puede editar y guardar un archivo en el formato UTF-8. Una
2021 alternativa más funcional para Windows es BabelPad.
2023 Si un archivo de entrada que contiene un carácter que no es ASCII, no
2024 se guarda en el formato UTF-8, se genera el mensaje de error
2027 FT_Get_Glyph_Name () error: argumento inválido
2030 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
2033 %c No verbatim here as the code does not display correctly in PDF
2035 bulgarian = \lyricmode {
2036 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2040 hebrew = \lyricmode {
2041 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2045 portuguese = \lyricmode {
2046 à vo -- cê uma can -- ção legal
2052 \addlyrics { \bulgarian }
2053 \addlyrics { \hebrew }
2054 \addlyrics { \portuguese }
2059 @unnumberedsubsubsec Unicode
2063 Para introducir un carácter aislado para el que se conoce el punto de
2064 código Unicode pero no está disponible en el editor que se está
2065 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
2066 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
2067 del carácter en cuestión y @code{dddd} es su valor decimal
2068 correspondiente. Pueden omitirse los ceros iniciales, pero es
2069 costumbre indicar los cuatro caracteres en la representación
2070 hexadecimal (observe que @emph{no} debe utilizarse la codificación
2071 UTF-8 del punto de código Unicode después de @code{\char}, pues la
2072 codificación UTF-8 contiene bits adicionales que indican el número de
2073 octetos). Hay tablas de códigos Unicode y un índice de nombres de
2074 caracteres que da el punto de código en hexadecimal para cualquier
2075 carácter en el portal del Consorcio Unicode,
2076 @uref{http://www.unicode.org/}.
2078 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
2079 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
2080 @qq{Letra griega Xi pequeña}.
2082 Se puede escribir de esta forma cualquier punto de código Unicode, y
2083 si todos los caracteres especiales se escriben en este formato no es
2084 necesario guardar el archivo de entrada en formato UTF-8. Por
2085 supuesto, debe estar instalada y estar disponible para LilyPond una
2086 fuente tipográfica que contenga codificados todos estos caracteres.
2088 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
2089 en cuatro lugares: en una llamada de ensayo, como texto de
2090 articulación, en la letra y como texto independiente bajo la
2093 @lilypond[quote,verbatim]
2096 c1 \mark \markup { \char ##x03EE }
2097 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2099 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2101 \markup { "Copyright 2008--2012" \char ##x00A9 }
2104 @cindex copyright, símbolo de
2106 Para escribir el símbolo de copyright en la nota de créditos, utilice:
2110 copyright = \markup @{ \char ##x00A9 "2008" @}
2115 @node Alias de ASCII
2116 @unnumberedsubsubsec Alias de ASCII
2117 @translationof ASCII aliases
2119 Se puede incluir una lista de alias de ASCII para caracteres
2122 @lilypond[quote,verbatim]
2124 #(include-special-characters)
2127 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2130 \new Staff { \repeat unfold 9 a'4 }
2132 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2137 "The replacement can be disabled:"
2138 "– &OE; …"
2139 \override #'(replacement-alist . ()) "– &OE; …"
2143 También podemos hacer nuestros propios alias, ya sea de forma global:
2145 @lilypond[quote,verbatim]
2147 #(add-text-replacements!
2148 '(("100" . "hundred")
2149 ("dpi" . "dots per inch")))
2151 \markup "A 100 dpi."
2156 @lilypond[quote,verbatim]
2157 \markup \replace #'(("100" . "hundred")
2158 ("dpi" . "dots per inch")) "A 100 dpi."
2162 Referencia de la notación:
2163 @ref{Lista de caracteres especiales}.
2165 Archivos instalados:
2166 @file{ly/text-replacements.ly}.
2169 @node Controlar la salida
2170 @section Controlar la salida
2171 @translationof Controlling output
2174 * Extracción de fragmentos de música::
2175 * Saltar la música corregida::
2176 * Formatos de salida alternativos::
2177 * Sustituir la tipografía de la notación::
2181 @node Extracción de fragmentos de música
2182 @subsection Extracción de fragmentos de música
2183 @translationof Extracting fragments of music
2185 Es posible citar pequeños fragmentos de una partitura grande
2186 directamente a partir de la salida. Puede compararse con la
2187 separación de una pieza de una partitura, recortándola con tijeras.
2189 Esto se hace definiendo los compases que se deben recortar. Por
2190 ejemplo, la inclusión de la siguiente definición
2197 (make-rhythmic-location 5 1 2)
2198 (make-rhythmic-location 7 3 4)))
2203 extrae un fragmento empezando por la mitad del quinto compás y
2204 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
2205 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
2206 después de tres negras del compás 7.
2208 Se pueden definir más zonas de recorte añadiendo más parejas de
2209 definición de tiempo rhythmic-location a la lista.
2211 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
2212 la opción @option{-dclip-systems}. Los recortes aparecen en la salida
2213 como archivos EPS, y se convierten en PDF y PNG si estos formatos
2214 también están activados.
2216 Para ver más información sobre los formatos de salida, consulte
2217 @rprogram{Invocar a LilyPond}.
2220 @node Saltar la música corregida
2221 @subsection Saltar la música corregida
2222 @translationof Skipping corrected music
2224 @funindex skipTypesetting
2225 @funindex showFirstLength
2226 @funindex showLastLength
2228 Al escribir o copiar música, normalmente sólo es interesante de ver y
2229 corregir la música cercana al final (donde estamos añadiendo las
2230 notas). Para acelerar este proceso de corrección, es posible saltar
2231 la composición tipográfica de todos excepto unos pocos de los últimos
2232 compases. Esto se consigue poniendo
2235 showLastLength = R1*5
2240 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
2241 cinco compases (suponiendo un compás de 4/4) de cada una de las
2242 partituras @code{\score} del archivo de entrada. Para piezas largas,
2243 el tipografiado de únicamente una parte pequeña es con frecuencia un
2244 orden de magnitud más rápido que el de la obra completa. Si estamos
2245 trabajando sobre el principio de una partitura que ya hemos
2246 tipografiado (p.ej., para añadir una parte instrumental nueva),
2247 también puede ser útil la propiedad @code{showFirstLength}.
2249 Este mecanismo de pasar por alto partes de un partitura se puede
2250 controlar con un grano más fino mediante la propiedad
2251 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
2252 lleva a cabo ningún tipografiado en absoluto.
2254 Esta propiedad se usa también para controlar la salida al archivo
2255 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
2256 y los cambios de instrumento. Está usted advertido.
2258 @lilypond[quote,relative=2,ragged-right,verbatim]
2260 \set Score.skipTypesetting = ##t
2262 \set Score.skipTypesetting = ##f
2266 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
2267 voces y pentagramas, ahorrando más tiempo incluso.
2270 @node Formatos de salida alternativos
2271 @subsection Formatos de salida alternativos
2272 @translationof Alternative output formats
2274 @cindex salida de gráficos de vector escalables
2276 @cindex salida de PostScript encapsulado
2278 @cindex PostScript encapsulado, salida de
2280 Los formatos de salida predeterminados para la partitura impresa son
2281 el formato de documento portátil (PDF) y PostScript (PS). Los
2282 formatos de salida Gráficos de vector escalables (SVG), PostScript
2283 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
2284 disponibles a través de opciones de la línea de órdenes, véase
2285 @rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
2288 @node Sustituir la tipografía de la notación
2289 @subsection Sustituir la tipografía de la notación
2290 @translationof Replacing the notation font
2292 Gonville es una alternativa a la tipografía Feta que se utiliza en
2293 LilyPond y se puede descargar de:
2295 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2298 Aquí presentamos algunos compases de muestra tipografiados con la
2301 @c NOTE: these images are a bit big, but that's important
2302 @c for the font comparison. -gp
2303 @sourceimage{Gonville_after,,,}
2305 Aquí hay unos compases de muestra tipografiados en la fuente Feta de
2308 @sourceimage{Gonville_before,,,}
2310 @subsubheading Instrucciones de instalación para MacOS
2312 Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
2313 a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
2314 consulte @rlearning{Otras fuentes de información}. Renombre la carpeta
2315 @code{fonts} existente a @code{fonts_orig} y la carpeta
2316 @code{lilyfonts} a @code{fonts}. Para volver a la fuente Feta,
2317 invierta el proceso.
2320 Manual de aprendizaje:
2321 @rlearning{Otras fuentes de información}.
2325 Gonville no se puede usar para tipografiar notación de @q{Música
2326 Antigua} y es probable que cualquier nuevo glifo en versiones
2327 posteriores de LilyPond no existan en la familia
2328 tipográfica Gonville. Diríjase a la página web del autor para obtener más
2329 información sobre éste y otros asuntos, entre ellos el régimen de
2330 licencias de Gonville.
2334 @section Salida MIDI
2335 @translationof MIDI output
2340 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
2341 Instrumentos Musicales) es un estándar para interconectar y controlar
2342 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
2343 una serie de notas dentro de un conjunto de pistas. No es un archivo
2344 de sonidos reales; se necesita un programa reproductor especial para
2345 traducir la serie de notas en sonidos de verdad.
2347 Cualquier música se puede convertir a archivos MIDI, de manera que
2348 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
2349 para comprobar la corrección de la música; las octavas equivocadas o
2350 las alteraciones erróneas se ponen de relieve muy claramente al
2351 escuchar la salida MIDI.
2353 La salida estándar de MIDI es un poco primitiva; de forma opcional, se
2354 encuentra disponible una salida MIDI mejorada y mucho más realista,
2355 por medio de @ref{El script Articulate}.
2357 La salida MIDI reserva un canal por cada pentagrama, y reserva
2358 el canal 10 para la percusión. Sólo hay 16 canales MIDI por cada
2359 dispositivo, por lo que si la partitura tiene más de 15 pautas, los
2360 canales MIDI se reutilizarán.
2363 * Crear archivos MIDI::
2365 * ¿Qué sale por el MIDI?::
2366 * Repeticiones y MIDI::
2367 * Control de los matices en el MIDI::
2368 * Percusión en MIDI::
2369 * El script Articulate::
2373 @node Crear archivos MIDI
2374 @subsection Crear archivos MIDI
2375 @translationof Creating MIDI files
2377 Para crear un MIDI a partir de una pieza de música, escriba un bloque
2378 @code{\midi} en la partitura, por ejemplo:
2387 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
2388 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
2389 necesita una notación impresa, debe haber también un bloque
2400 Se traducen correctamente a la salida MIDI la altura y duración de las
2401 notas, las ligaduras de unión, matices y cambios de tempo. Las
2402 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
2403 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
2404 del rango de volumen MIDI disponible. Los crescendi y decrescendi
2405 hacen que el volumen varía linealmente entre sus dos extremos. El
2406 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
2407 eliminar por completo, véase @ref{El bloque MIDI}.
2409 El tempo inicial y los cambios de tempo posteriores se pueden
2410 especificar utilizando la instrucción @code{\tempo} dentro de la
2411 propia notación musical. Se reflejan en cambios de tempo en la salida
2412 MIDI. Esta instrucción normalmente hace que se imprima la indicación
2413 metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
2414 Más abajo se describe una forma alternativa de especificar el tempo
2415 MIDI inicial o global, véase @ref{El bloque MIDI}.
2417 Debido a ciertas limitaciones de Windows, la extensión predeterminada
2418 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
2419 operativos utilizan la extensión @code{.midi}. Si prefiere una
2420 extensión diferente, inserte la siguiente línea en el nivel jerárquico
2421 superior del archivo de entrada, antes del inicio de cualquier bloque
2422 @code{\book}, @code{\bookpart} o @code{\score}:
2425 #(ly:set-option 'midi-extension "midi")
2428 La línea anterior establece la extensión predeterminada para los
2429 archivos MIDI a @code{.midi}.
2431 De forma alternativa, esta opción se puede también proporcionar en la
2435 lilypond … -dmidi-extension=midi archivoLily.ly
2439 @unnumberedsubsubsec Nombres de instrumentos
2441 @cindex instrumento, nombres de
2442 @funindex Staff.midiInstrument
2444 El nombre del instrumento MIDI se establece mediante la propiedad
2445 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
2446 de entre los que están en la lista que aparece en @ref{Instrumentos MIDI}.
2450 \set Staff.midiInstrument = #"glockenspiel"
2456 \new Staff \with @{midiInstrument = #"cello"@} @{
2461 Si el instrumento elegido no coincide exactamente con uno de los
2462 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
2463 Piano de Cola (@code{"acoustic grand"}).
2467 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2468 {changing-midi-output-to-one-channel-per-voice.ly}
2472 @c In 2.11 the following no longer seems to be a problem -td
2474 Unterminated (de)crescendos will not render properly in the midi file,
2475 resulting in silent passages of music. The workaround is to explicitly
2476 terminate the (de)crescendo. For example,
2483 will not work properly but
2486 @{ a4\< b c d\!\f @}
2493 Los cambios del volumen MIDI sólo tienen lugar al principio de la
2494 nota, por lo que los crescendi y decrescendi no pueden afectar al
2495 volumen de una sola nota.
2497 No todos los reproductores de MIDI manejar adecuadamente los cambios de
2498 tempo de la salida MIDI. Entre los reproductores que se sabe que
2499 funcionan se encuentran el Reproductor de Medios de MS Windows y
2500 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
2503 @node El bloque MIDI
2504 @subsection El bloque MIDI
2505 @translationof MIDI block
2509 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
2510 dentro de un bloque de partitura. Es análogo al bloque layout de
2511 diseño de página, pero algo más simple. Con frecuencia, el bloque
2512 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
2513 contextos, definiciones de contexto nuevas o código para fijar valores
2514 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
2515 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
2516 indicación de tempo:
2527 En este ejemplo, el tempo se establece a 72 pulsos de negra por
2528 minuto. @code{\tempo} is actually a music command for
2529 setting properties during the interpretation of music: in the
2530 context of output definitions like a @code{\midi} block, as a matter of
2531 courtesy those are reinterpreted as if they were context modifications.
2533 @cindex MIDI, definiciones de contexto
2535 Las definiciones de contexto siguen con precisión la misma sintaxis
2536 que la de un bloque @code{\layout}. Los módulos de traducción para el
2537 sonido reciben el nombre de ejecutantes. Los contextos para la salida
2538 MIDI se definen en @file{../ly/performer-init.ly}, véase
2539 @rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
2540 el efecto de los matices de la salida MIDI, inserte las líneas
2541 siguientes en el bloque @code{\midi@{ @}}.
2548 \remove "Dynamic_performer"
2553 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
2554 dentro de un bloque de partitura definido con una instrucción
2559 @{ @dots{}notas@dots{} @}
2565 @node ¿Qué sale por el MIDI?
2566 @subsection ¿Qué sale por el MIDI?
2567 @translationof What goes into the MIDI output?
2569 @unnumberedsubsubsec Contemplado en el MIDI
2571 @cindex alturas en MIDI
2572 @cindex MIDI, alturas
2573 @cindex cuartos de tono en MIDI
2574 @cindex MIDI, cuartos de tono
2575 @cindex microtonos en MIDI
2576 @cindex MIDI, microtonos
2577 @cindex acordes, nombres de, en MIDI
2578 @cindex MIDI, nombres de
2579 @cindex duraciones en MIDI
2580 @cindex MIDI, duraciones
2581 @cindex Articlulate, scripts
2582 @cindex MIDI, articulaciones
2583 @cindex articulaciones en MIDI
2584 @cindex trinos en MIDI
2585 @cindex grupetos en MIDI
2586 @cindex rallentando en MIDI
2587 @cindex accelerando en MIDI
2590 Los siguientes elementos de notación se reflejan en la salida MIDI:
2594 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
2595 @item Acordes escritos como nombres de acorde
2596 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
2597 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
2598 @item Ligaduras de unión
2599 @item Matices o indicaciones de dinámica
2600 @item Crescendi y decrescendi sobre varias notas
2601 @item Cambios de tempo insertados con una marca metronómica
2602 @item Letra de las canciones
2605 Utilizando @ref{El script Articulate}, a la lista anterior se añaden
2606 una serie de elementos:
2609 @item Articulaciones (ligaduras de expresión, picados, etc)
2610 @item Trinos, mordentes circulares
2611 @item Rallentando y accelerando
2615 @unnumberedsubsubsec No contemplado en el MIDI
2617 @c TODO index as above
2619 Los siguientes elementos de notación no tienen ningún efecto sobre la
2620 salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
2623 @item Duraciones escritas como anotaciones, p.ej. el swing
2624 @item Cambios de tempo escritos como anotaciones sin marca de tempo
2625 @item Staccato y otras articulaciones y ornamentos
2626 @item Ligaduras de expresión y de fraseo
2627 @item Crescendi y decrescendi sobre una nota única
2628 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
2630 @item Acordes microtonales
2634 @node Repeticiones y MIDI
2635 @subsection Repeticiones y MIDI
2636 @translationof Repeats in MIDI
2638 @cindex repeticiones, expandir
2639 @funindex \unfoldRepeats
2641 Con un poco de trucaje, se puede hacer que cualquier tipo de
2642 repetición esté presente en la salida MIDI. Esto se consigue mediante
2643 la aplicación de la función musical @code{\unfoldRepeats}. Esta
2644 función cambia todas las repeticiones a repeticiones desplegadas.
2646 @lilypond[quote,verbatim]
2648 \repeat tremolo 8 { c'32 e' }
2649 \repeat percent 2 { c''8 d'' }
2650 \repeat volta 2 { c'4 d' e' f' }
2659 En partituras con varias voces, el desplegado de las repeticiones en
2660 la salida MIDI solo se produce correctamente si @emph{todas y cada
2661 una} de las voces incluye las repeticiones de manera completa y
2664 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
2665 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
2666 (con repeticiones desplegadas) y otro para la notación impresa (con
2667 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
2668 y percent --repetición de compases--). Por ejemplo,
2676 \unfoldRepeats @var{..música..}
2682 @node Control de los matices en el MIDI
2683 @subsection Control de los matices en el MIDI
2684 @translationof Controlling MIDI dynamics
2686 La dinámica en el MIDI está implementada por medio del intérprete
2687 Dynamic_performer que reside de forma predeterminada dentro del
2688 contexto Voice. Es posible controlar el volumen MIDI general, el
2689 volumen relativo de los matices dinámicos y el volumen relativo de los
2690 distintos instrumentos.
2692 @unnumberedsubsubsec Indicaciones dinámicas
2694 Los matices o indicaciones de dinámica se traducen a una fracción fija
2695 del rango de volumen MIDI disponible. Las fracciones predeterminadas
2696 se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
2697 @notation{fffff}. El conjunto de indicaciones dinámicas y las
2698 fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
2699 @rlearning{Otras fuentes de información}. Este conjunto de fracciones
2700 se puede cambiar o extender proporcionando una función que toma como
2701 argumento una indicación dinámica y devuelve la fracción requerida, y
2702 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
2705 Por ejemplo, si se requiere una indicación dinámica
2706 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
2707 predeterminado sobre el volumen MIDI, pues no está incluida en el
2708 conjunto predeterminado. De igual manera, si se define una indicación
2709 dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
2710 incluida en el conjunto predeterminado. El ejemplo siguiente muestra
2711 cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
2712 La función Scheme establece la fracción a 0.9 si se encuentra una
2713 indicación dinámica rfz, y en caso contrario llama a la función
2716 @lilypond[verbatim,quote]
2717 #(define (myDynamics dynamic)
2718 (if (equal? dynamic "rfz")
2720 (default-dynamic-absolute-volume dynamic)))
2724 \set Staff.midiInstrument = #"cello"
2725 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2737 Como alternativa, si se necesitara redefinir la tabla completa de
2738 fracciones, sería mejor usar el procedimiento
2739 @notation{default-dynamic-absolute-volume} que aparece en
2740 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
2741 ejemplo de esta sección muestra cómo se puede hacer esto.
2743 @unnumberedsubsubsec Volumen maestro MIDI
2745 El volumen general máximo y mínimo de las indicaciones dinámicas de
2746 MIDI se controla estableciendo valores para las propiedades
2747 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
2748 @code{Score}. Estas propiedades tienen efecto solamente sobre las
2749 indicaciones dinámicas, por ello si queremos que tengan validez desde
2750 el comienzo de la partitura, se debe colocar allí una indicación de
2751 dinámica. La fracción que corresponde a cada indicación dinámica se
2752 modifica con esta fórmula:
2755 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
2758 En el ejemplo siguiente, el rango de intensidad dinámica del volumen
2759 general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
2761 @lilypond[verbatim,quote]
2767 \set Staff.midiInstrument = #"flute"
2768 \new Voice \relative c''' {
2776 \set Staff.midiInstrument = #"clarinet"
2777 \new Voice \relative c'' {
2789 midiMinimumVolume = #0.2
2790 midiMaximumVolume = #0.5
2796 @unnumberedsubsubsec Balance entre instrumentos (i)
2798 Si las propiedades de volumen MIDI máximo y mínimo están establecidas
2799 en el contexto @code{Staff} se pueden controlar los volúmenes
2800 relativos de los instrumentos MIDI. Esto proporciona un ecualizador
2801 de instrumentos básico que puede realzar significativamente la calidad
2804 En este ejemplo se reduce el volumen del clarinete con relación al de
2805 la flauta. Debe haber una indicación dinámica en la primera nota de
2806 cada instrumento para que esto funcione correctamente.
2808 @lilypond[verbatim,quote]
2814 \set Staff.midiInstrument = #"flute"
2815 \set Staff.midiMinimumVolume = #0.7
2816 \set Staff.midiMaximumVolume = #0.9
2817 \new Voice \relative c''' {
2825 \set Staff.midiInstrument = #"clarinet"
2826 \set Staff.midiMinimumVolume = #0.3
2827 \set Staff.midiMaximumVolume = #0.6
2828 \new Voice \relative c'' {
2842 @unnumberedsubsubsec Balance entre instrumentos (ii)
2844 Si las propiedades de volumen MIDI máximo y mínimo no están
2845 establecidas, de forma predeterminada LilyPond aplica un pequeño grado
2846 de ecualización a algunos instrumentos. Los instrumentos y la
2847 ecualización que se aplica se muestra en la tabla
2848 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
2850 El ecualizador básico predeterminado se puede sustituir estableciendo
2851 @code{instrumentEqualizer} en el contexto @code{Score} a un
2852 procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
2853 como único argumento y devuelva un par de fracciones que dan los
2854 volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
2855 sustitución se hace de la misma forma que mostramos para restablecer
2856 la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
2857 al comienzo de esta sección. El ecualizador predeterminado,
2858 @notation{default-instrument-equalizer}, en
2859 @file{../scm/midi.scm}, muestra cómo se puede escribir tal
2862 El ejemplo siguiente establece los volúmenes relativos de la flauta y
2863 del clarinete a los mismos valores que el ejemplo anterior.
2865 @lilypond[verbatim,quote]
2866 #(define my-instrument-equalizer-alist '())
2868 #(set! my-instrument-equalizer-alist
2871 ("flute" . (0.7 . 0.9))
2872 ("clarinet" . (0.3 . 0.6)))
2873 my-instrument-equalizer-alist))
2875 #(define (my-instrument-equalizer s)
2876 (let ((entry (assoc s my-instrument-equalizer-alist)))
2885 \set Score.instrumentEqualizer = #my-instrument-equalizer
2886 \set Staff.midiInstrument = #"flute"
2887 \new Voice \relative c''' {
2895 \set Staff.midiInstrument = #"clarinet"
2896 \new Voice \relative c'' {
2911 @c Delete when satisfied this is adequately covered elsewhere -td
2913 @n ode Microtones in MIDI
2914 @s ubsection Microtones in MIDI
2916 @cindex microtones in MIDI
2918 Microtones consisting of half sharps and half flats are exported
2919 to the MIDI file and render correctly in MIDI players which support
2920 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
2921 an example showing all the half sharps and half flats. It can be
2922 copied out and compiled to test microtones in your MIDI player.
2924 @lilypond[verbatim,quote]
2941 @node Percusión en MIDI
2942 @subsection Percusión en MIDI
2943 @translationof Percussion in MIDI
2945 La notación de los instrumentos de percusión se realiza normalmente en
2946 un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
2947 salida correctamente por el canal MIDI@tie{}10, pero ciertos
2948 instrumentos de percusión de altura determinada, como el xilófono,
2949 marimba, vibráfono, timbales, etc., se tratan como instrumentos
2950 @qq{normales} y la música para estos instrumentos se debe introducir
2951 en contextos de @code{Staff} normales, no en un contexto
2952 @code{DrumStaff}, para obtener la salida MIDI correcta.
2954 Ciertos sonidos de altura indeterminada que están incluidos en el
2955 estándar General MIDI, como el tom melódico, el tambor taiko, los
2956 tambores sintéticos, etc., no se pueden acceder a través del canal
2957 MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
2958 introducir también en un contexto normal de @code{Staff}, utilizando
2959 las alturas normales adecuadas.
2961 Muchos instrumentos de percusión no están incluidos dentro del
2962 estándar General MIDI, p.ej. las castañuelas. El método más
2963 fácil (aunque no satisfactorio) de producir una salida MIDI al
2964 escribir para estos instrumentos es sustituirlos por el sonido más
2965 parecido del conjunto estándar.
2967 @c TODO Expand with examples, and any other issues
2971 Debido a que el estándar General MIDI no contiene golpes de aro
2972 (@emph{rim shots}), para este propósito se utiliza en su lugar el
2973 golpe lateral de baqueta (@emph{sidestick}).
2976 @node El script Articulate
2977 @subsection El script Articulate
2978 @translationof The Articulate script
2980 Es posible obtener una salida MIDI más real si se utiliza el script
2981 Articulate. Éste trata de tener en cuenta las articulaciones
2982 (ligaduras de expresión, picados, etc), mediante la sustitución de las
2983 notas con secuencias musicales de silencios y notas escaladas en el
2984 tiempo de forma apropiada. También trata de desplegar los trinos,
2985 grupetos circulares, etc. y responder a las indicaciones de
2986 rallentando y accelerando.
2988 Para utilizar el script Articulate, tenemos que incluirlo al principio
2989 de nuestro archivo de entrada:
2992 \include "articulate.ly"
2995 y en la sección @code{\score}, hacer lo siguiente:
2998 \unfoldRepeats \articulate <<
2999 resto de la partitura...
3003 Después de alterar el código de entrada de esta manera el resultado
3004 visual se altera profundamente, pero el bloque @code{\midi} estándar
3005 produce un archivo MIDI mejorado.
3007 Si bien no es esencial para que funcione el script Articulate, podemos
3008 insertar la instrucción @code{\unfoldRepeats} según aparece en el
3009 ejemplo anterior, dado que habilita la ejecución de abreviaturas tales
3010 como los @notation{trinos}.
3014 Articulate acorta los acordes, y ciertos fragmentos de música
3015 (especialmente la música de órgano) es posible que suene peor.
3018 @node Extraer información musical
3019 @section Extraer información musical
3020 @translationof Extracting musical information
3022 Además de crear un resultado visual y MIDI,
3023 LilyPond es capaz de presentar información
3024 musical en forma de texto.
3027 * Impresión del código de notación de LilyPond::
3028 * Impresión de las expresiones musicales de Scheme::
3029 * Guardar los eventos musicales en un archivo::
3033 @node Impresión del código de notación de LilyPond
3034 @subsection Displaying LilyPond notation
3035 @translationof Displaying LilyPond notation
3037 @funindex \displayLilyMusic
3038 La impresión textual de una expresión musical en notación de LilyPond
3039 puede hacerse con la función musical @code{\displayLilyMusic}.
3040 Para ver el resultado, lo más usual es llamar a LilyPond
3041 mediante la línea de órdenes. Por ejemplo,
3045 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3049 imprime lo siguiente:
3052 @{ a,4 cis e fis g @}
3055 De forma predeterminada, LilyPond imprime estos mensajes en la consola
3056 junto al resto de los mensajes de la compilación de LilyPond.
3057 Para discernir entre estos mensajes y
3058 guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
3059 salida hacia un archivo.
3062 lilypond archivo.ly >resultado.txt
3066 @node Impresión de las expresiones musicales de Scheme
3067 @subsection Impresión de las expresiones musicales de Scheme
3068 @translationof Displaying scheme music expressions
3070 Véase @rextend{Presentación de las expresiones musicales}.
3073 @node Guardar los eventos musicales en un archivo
3074 @subsection Guardar los eventos musicales en un archivo
3075 @translationof Saving music events to a file
3077 Los eventos musicales se pueden guardar en un archivo pentagrama a
3078 pentagrama mediante la inclusión de un archivo en nuestra partitura
3082 \include "event-listener.ly"
3085 De esta forma se crean uno o más archivos llamados
3086 @file{FILENAME-STAFFNAME.notes} ó @file{FILENAME-unnamed-staff.notes}
3087 para cada pentagrama. Observe que si tiene más de un pentagrama sin
3088 nombre, los eventos de todos los pentagramas se mezclarán entre sí
3089 dentro del mismo archivo. El resultado tiene el aspecto siguiente:
3092 0.000 note 57 4 p-c 2 12
3094 0.250 note 62 4 p-c 7 12
3095 0.500 note 66 8 p-c 9 12
3096 0.625 note 69 8 p-c 14 12
3101 La sintaxis consiste en una línea delimitada por caracteres de
3102 tabulación, con dos campos fijos en cada línea seguidos de parámetros
3106 @var{tiempo} @var{tipo} @var{...parámetros...}
3109 Esta información se puede leer fácilmente por parte de otros programas
3110 como guiones de Python, y pueden ser muy útiles para aquellos
3111 investigadores que desean realizar un análisis musical o hacer
3112 experimientos de reproducción con LilyPond.
3115 No todos los eventos musicales de lilypond están contemplados por
3116 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
3117 concepto} bien realizada. Si algunos eventos que quiere ver no
3118 aparecen incluidos, copie @file{event-listener.ly} en su carpeta de
3119 lilypond y modifique el archivo de forma que produzca la información