1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 1e5c6b0f54079eb3285dcc4c7e53f17d8bb03933
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
18 salida generales de LilyPond, más que con la notación específica.
21 * Estructura del código de entrada::
22 * Títulos y encabezamientos::
23 * Trabajar sobre los archivos de entrada::
24 * Controlar la salida::
25 * Creación de salida MIDI::
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
35 texto. Por convenio, el nombre de estos archivos termina en
39 * Estructura de una partitura::
40 * Varias partituras en un libro::
41 * Varios archivos de salida a partir de uno de entrada::
42 * Nombres de los archivos de salida::
43 * Estructura del archivo::
47 @node Estructura de una partitura
48 @subsection Estructura de una partitura
49 @translationof Structure of a score
53 Un bloque @code{\score} debe contener una expresión musical única
54 delimitada por un par de llaves:
63 @warning{Sólo puede haber @strong{una} expresión musical dentro del
64 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
66 Esta expresión musical única puede tener cualquier tamaño, y
67 puede contener otras expresiones musicales hasta cualquier grado
68 de complejidad. Todos los siguientes ejemplos son expresiones
75 @lilypond[verbatim,quote]
82 @lilypond[verbatim,quote]
84 \new Staff { c'4 c' c' c' }
85 \new Staff { d'4 d' d' d' }
93 \new Staff @{ \flute @}
94 \new Staff @{ \oboe @}
97 \new Staff @{ \violinI @}
98 \new Staff @{ \violinII @}
104 Los comentarios son una excepción a esta regla general (para ver
105 otras excepciones, consulte @ref{Estructura del archivo}). Tanto
106 los comentarios de una línea como los que están delimitados por
107 @code{%@{ @dots{} %@}} se pueden escribir en cualquier lugar
108 dentro del archivo de entrada. Se pueden escribir dentro o fuera
109 del bloque @code{\score}, y dentro o fuera de la expresión
110 musical única dentro del bloque @code{\score}.
112 Recuerde que incluso dentro de un archivo que contenga solamente
113 un bloque @code{\score}, éste se encuentra incluido
114 implícitamente dentro de un bloque @code{\book}. Un bloque
115 @code{\book} dentro de un archivo fuente produce al menos un
116 archivo de salida, y de forma predeterminada el nombre del
117 archivo de salida que se produce está derivado del nombre del
118 archivo de entrada, de forma que @file{fandangoforelephants.ly}
119 da como resultado @file{fandangoforelephants.pdf}.
121 (Para ver más detalles acerca de los bloques @code{\book},
122 consulte @ref{Varias partituras en un libro},
123 @ref{Varios archivos de salida a partir de uno de entrada} y
124 @ref{Estructura del archivo}.)
127 Manual de aprendizaje:
128 @rlearning{Trabajar sobre los archivos de entrada},
129 @rlearning{Explicación de las expresiones musicales},
130 @rlearning{La partitura es una (única) expresión musical compuesta}.
133 @node Varias partituras en un libro
134 @subsection Varias partituras en un libro
135 @translationof Multiple scores in a book
138 @cindex movimientos, varios
140 Un documento puede contener varias piezas de música y texto. Son
141 ejemplos un libro de estudios o una parte orquestal con varios
142 movimientos. Cada movimiento se introduce con un bloque
147 @var{@dots{}música@dots{}}
151 y los textos se introducen con un bloque @code{\markup}:
155 @var{@dots{}texto@dots{}}
161 Todos los movimientos y textos que aparecen en el mismo archivo
162 @file{.ly} se tipografían normalmente en la forma de un solo
177 Una excepción importante se da dentro de los documentos de
178 lilypond-book, en los que tenemos que escribir explícitamente un
179 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
180 salida el primer @code{\score} o @code{\markup}.
182 El encabezamiento de cada pieza se puede poner dentro del bloque
183 @code{\score}. Antes de cada movimiento, se imprime el nombre de
184 la pieza (@code{piece}) extraído del encabezamiento. El título
185 del libro entero se puede poner dentro del bloque @code{\book},
186 pero si no está presente se inserta el encabezamiento
187 @code{\header} que está al principio del archivo.
191 title = "Ocho miniaturas"
192 composer = "Igor Stravinsky"
196 \header @{ piece = "Romanze" @}
199 @dots{}texto de la segunda estrofa@dots{}
202 @dots{}texto de la tercera estrofa@dots{}
206 \header @{ piece = "Menuetto" @}
212 Se pueden agrupar distintas piezas de música en partes de un
213 libro utilizando bloques @code{\bookpart}. Las partes de libro
214 se separan por medio de saltos de página, y pueden dar comienzo
215 con un título, como el libro propiamente dicho, mediante la
216 especificación del bloque @code{\header}.
221 title = "Título del libro"
222 subtitle = "Primera parte"
229 subtitle = "Segunda parte"
237 @node Varios archivos de salida a partir de uno de entrada
238 @subsection Varios archivos de salida a partir de uno de entrada
239 @translationof Multiple output files from one input file
241 Si queremos varios archivos de salida a partir del mismo archivo
242 @file{.ly}, podemos escribir varios bloques @code{\book}, donde
243 cada uno de estos bloques @code{\book} dará como resultado un
244 archivo de salida distinto. Si no especificamos ningún bloque
245 @code{\book} en el archivo, LilyPond trata implícitamente todo el
246 archivo como un solo bloque @code{\book}, véase @ref{Estructura
249 Al producir varios archivos a partir de un solo archivo fuente,
250 LilyPond se asegura de que ninguno de los archivos de salida de
251 ningún bloque @code{\book} sobreescribe el archivo de salida
252 producido por un @code{\book} anterior del mismo archivo de
255 Lo hace añadiendo un sufijo al nombre de la salida para cada
256 libro @code{\book} que utiliza el nombre del archivo de salida
257 predeterminado, derivado del archivo fuente de entrada.
259 El comportamiento predeterminado es añadir un sufijo con el
260 número de versión para cada nombre que pueda coincidir; así:
277 en el archivo fuente @file{eightminiatures.ly}, produce
281 @file{eightminiatures.pdf},
283 @file{eightminiatures-1.pdf} y
285 @file{eightminiatures-2.pdf}.
289 @node Nombres de los archivos de salida
290 @subsection Nombres de los archivos de salida
291 @translationof Output file names
293 @funindex \bookOutputSuffix
294 @funindex \bookOutputName
296 LilyPond le ofrece unos mecanismos que le permiten controlar los
297 nombres de archivo que se utilizan por parte de los diversos
298 motores finales al producir los archivos de salida.
300 En la sección anterior vimos cómo LilyPond evita las
301 coincidencias de nombres al producir varias salidas a partir de
302 un único archivo fuente de entrada. También podemos especificar
303 nuestros propios sufijos para cada bloque @code{\book}, de manera
304 que podemos producir, por ejemplo, archivos con los nombres
305 @file{eightminiatures-Romanze.pdf},
306 @file{eightminiatures-Menuetto.pdf} y
307 @file{eightminiatures-Nocturne.pdf} añadiendo una declaración
308 @code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
312 \bookOutputSuffix "Romanze"
317 \bookOutputSuffix "Menuetto"
322 \bookOutputSuffix "Nocturne"
328 También podemos especificar un nombre de archivo de salida
329 diferente para cada bloque @code{book}, mediante la utilización
330 de declaraciones @code{\bookOutputName}:
334 \bookOutputName "Romanze"
339 \bookOutputName "Menuetto"
344 \bookOutputName "Nocturne"
350 El código anterior produce los siguientes archivos de salida:
356 @file{Menuetto.pdf} y
362 @node Estructura del archivo
363 @subsection Estructura del archivo
364 @translationof File structure
374 Un archivo @file{.ly} puede contener cualquier número de
375 expresiones del nivel superior, donde una expresión del nivel
376 superior es una de las siguientes posibilidades:
380 Una definición de salida, como @code{\paper}, @code{\midi} y
381 @code{\layout}. Tal definición en el nivel más alto cambia los
382 ajustes predeterminados para todo el libro. Si se introduce más
383 de una de estas definiciones del mismo tipo en el nivel más alto,
384 las definiciones se combinan, pero en situaciones de conflicto
385 las definiciones más tardías tienen preferencia. Para ver los
386 detalles sobre cómo afecta al bloque @code{\layout}, consulte
387 @ref{El bloque layout,,El bloque @code{@bs{}layout}}.
390 Una expresión directa de Scheme, como
391 @code{#(set-default-paper-size "a7" 'landscape)} o
392 @code{#(ly:set-option 'point-and-click #f)}.
395 Un bloque @code{\header}. Esto establece el bloque de
396 encabezamiento global (es decir, al principio del archivo). Es
397 el bloque que contiene los ajustes predeterminados de los campos
398 de encabezamientos como el compositor, título, etc. para todos
399 los libros que están dentro del archivo (véase
400 @ref{Explicación de los títulos}).
403 Un bloque @code{\score}. Esta partitura se reúne con otras
404 partituras del nivel superior, y se combina con ellas formando un
405 @code{\book} (libro) único. Este comportamiento se puede cambiar
406 estableciendo el valor de la variable
407 @code{toplevel-score-handler} en el nivel superior (el
408 @emph{handler} predeterminado se define en el archivo
409 @file{../scm/lily-library.scm} y su valor se establece en el archivo
410 @file{../ly/declarations-init.ly}.)
413 Un bloque @code{\book} combina lógicamente varios movimientos (es
414 decir, varios bloques @code{\score}) en un solo documento. Si
415 hay varias partituras @code{\score}, se crea un solo archivo de
416 salida para cada bloque @code{\book}, en el que se concatenan
417 todos los movimientos correspondientes. La única razón para
418 especificar explícitamente bloques @code{\book} en un archivo de
419 entrada @file{.ly} es si queremos crear varios archivos de salida
420 a partir de un único archivo de entrada. Una excepción se da
421 dentro de los documentos de lilypond-book, en los que tenemos que
422 escribir explícitamente un bloque @code{\book} si queremos tener
423 más de una única partitura @code{\score} o marcado @code{\markup}
424 en el mismo ejemplo. Se puede cambiar este comportamiento
425 estableciendo el valor de la variable
426 @code{toplevel-book-handler} en el nivel superior. El
427 @emph{handler} predeterminado se define en el archivo de inicio
428 @file{../scm/lily.scm}.
431 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
432 partes, utilizando bloques @code{\bookpart}, con objeto de
433 facilitar la inserción de saltos de página o usar distintos
434 ajustes de @code{\paper} en las distintas partes.
437 Una expresión musical compuesta, como
442 Esto añade la pieza al @code{\score} y la conforma dentro de un
443 libro único junto a todas las demás partituras @code{\score} y
444 expresiones musicales del nivel superior. En otras palabras, un
445 archivo que contiene sólo la expresión musical anterior se
463 Se puede cambiar este comportamiento estableciendo el valor de la
464 variable @code{toplevel-music-handler} en el nivel más alto. El
465 @emph{handler} predeterminado se define en el archivo de inicio
466 @file{../scm/lily.scm}.
469 Un texto de marcado, por ejemplo una estrofa
472 2. Estrofa dos, línea uno
476 Los textos de marcado se colocan encima, en medio o debajo de las
477 partituras o expresiones musicales, según donde aparezcan
485 fulano = @{ c4 d e d @}
488 Esto se puede utilizar más tarde en el archivo escribiendo
489 @code{\fulano}. El nombre de las variables ha de ser
490 exclusivamente alfabético; sin números, guiones ni barras bajas.
494 El ejemplo siguiente muestra tres cosas que se pueden introducir
495 en el nivel superior:
499 % No justificar la salida
510 En cualquier punto del archivo se pueden introducir cualquiera de
511 las instrucciones léxicas siguientes:
514 @item @code{\version}
515 @item @code{\include}
516 @item @code{\sourcefilename}
517 @item @code{\sourcefileline}
518 @item Un comentario de una línea, determinado por un símbolo @code{%}
522 Un comentario de varias líneas, delimitado por @code{%@{ @dots{}
527 @cindex espacios en blanco
529 Por lo general se ignoran los espacios entre elementos del flujo
530 de entrada, y se pueden omitir o aumentar tranquilamente para
531 mejorar la legibilidad. Sin embargo, los espacios se deben
532 utilizar siempre para evitar errores, en las siguientes
537 @item Alrededor de todas y cada una de las llaves curvas
538 de apertura y cierre.
540 @item A continuación de las instrucciones y variables, es decir,
541 todos los elementos que comienzan con un signo @code{\} de barra
544 @item A continuación de todo elemento que se deba interpretar
545 como expresión de Scheme, es decir, todo elemento que comience
546 por un signo@tie{}@code{#}.
548 @item Para separar los elementos de una expresión de Scheme.
550 @item Dentro de @code{lyricmode} antes y después de las instrucciones
551 @code{\set} y @code{\override}.
556 Manual de aprendizaje:
557 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
559 Referencia de la notación:
560 @ref{Explicación de los títulos},
561 @ref{El bloque layout,,El bloque @code{@bs{}layout}}.
564 @node Títulos y encabezamientos
565 @section Títulos y encabezamientos
566 @translationof Titles and headers
569 @cindex encabezamientos
570 @cindex pies de página
572 Casi toda la música impresa tiene un título y el nombre del
573 compositor; ciertas piezas tienen mucha más información.
576 * Crear títulos encabezamientos y pies de página::
577 * Títulos encabezamientos y pies de página personalizados::
578 * Crear metadatos en los archivos de salida::
579 * Crear notas al pie::
580 * Referencia a números de página::
585 @node Crear títulos encabezamientos y pies de página
586 @subsection Crear títulos, encabezamientos y pies de página
587 @translationof Creating titles headers and footers
590 * Explicación de los títulos::
591 * Presentación predeterminada de los títulos de partes de libro y partitura::
592 * Disposición predeterminada de las cabeceras y pies de página::
596 @node Explicación de los títulos
597 @unnumberedsubsubsec Explicación de los títulos
598 @translationof Titles explained
600 Cada bloque @code{\book} de un solo archivo de entrada produce un
601 archivo de salida distinto, véase @ref{Estructura del archivo}.
602 Dentro de cada archivo de salida están disponibles tres tipos de
603 zonas para títulos: @emph{Títulos de libro} al principio de cada
604 libro, @emph{Títulos de parte de libro} al principio de cada
605 parte de un libro y @emph{Títulos de partitura} al comienzo de
608 Los valores de los campos para encabezamientos tales como
609 @code{title} (para el título) y @code{composer} (para el autor)
610 se establecen en bloques @code{\header} (para ver la sintaxis de
611 los bloques @code{\header} y una lista completa de los campos
612 disponibles de forma predeterminada, consulte @ref{Presentación
613 predeterminada de los títulos de partes de libro y partitura}).
614 Tanto los títulos de libro como los títulos de parte de libro y
615 los títulos de partitura pueden contener los mismos campos,
616 aunque de forma predeterminada los campos de los títulos de
617 partitura se limitan a @code{piece} (pieza) y @code{opus}.
619 Los bloques @code{\header} se pueden situar en cuatro lugares
620 distintos para formar una jerarquía descendente de bloques
626 Al principio del archivo de entrada, antes de cualquier otro bloque
627 @code{\book}, @code{\bookpart} o @code{\score}.
630 Dentro de un bloque @code{\book} pero fuera de los bloques
631 @code{\bookpart} y @code{\score} que están dentro de ese libro.
634 Dentro de un bloque @code{\bookpart} pero fuera de cualquier bloque
635 @code{\score} dentro de dicha parte de libro.
638 Después de la expresión musical de un bloque @code{\score}.
642 Los valores de los campos se filtran a través de esta jerarquía,
643 persistiendo aquellos que se establecen más arriba a no ser que
644 se sobreescriban por un valor establecido más abajo en la
650 El título de un libro deriva de los campos establecidos al
651 principio del archivo de entrada, modificado por campos
652 establecidos en el bloque @code{\book}. Los campos resultantes
653 se usan para imprimir el título de libro para dicho libro,
654 siempre y cuando haya otro material que genere una página al
655 comienzo del libro, antes de la primera parte de libro. Es
656 suficiente una sola instrucción @code{\pageBreak}.
659 Un título de parte de libro se deriva de los campos fijados al
660 principio del archivo de entrada, modificado por los campos
661 establecidos dentro del bloque @code{\book}, y posteriormente
662 modificado por los campos que se fijan dentro del bloque
663 @code{\bookpart}. Los valores resultantes se usan para imprimir
664 el título de parte de libro para esa parte.
667 Un título de partitura se deriva de los campos que se fijan al
668 principio del archivo de entrada, modificados por los campos
669 fijados dentro del bloque @code{\book}, posteriormente
670 modificados por los campos que se fijan dentro del bloque
671 @code{\bookpart} y finalmente modificados por los campos
672 establecidos dentro del bloque @code{\score}. Los valores
673 resultantes se utilizan para imprimir el título de partitura.
674 Observe, sin embargo, que de forma predeterminada solamente se
675 imprimen los campos @code{piece} y @code{opus} en los títulos de
676 partitura a no ser que la variable de @code{\paper},
677 @code{print-all-headers}, tenga el valor @code{#t}.
681 @warning{Recuerde que al poner un bloque @bs{}@code{header}
682 dentro de un bloque @bs{}@code{score}, la expresión musical debe
683 aparecer antes del bloque @bs{}@code{header}.}
685 No es necesario aportar bloques @code{\header} en los cuatro
686 lugares: cualquiera de ellos o incluso todos pueden omitirse. De
687 forma similar, los archivos de entrada sencillos pueden omitir
688 los bloques @code{\book} y @code{\bookpart}, dejando que se creen
691 Si el libro solamente tiene una partitura, el bloque
692 @code{\header} debiera situarse normalmente al principio del
693 archivo de forma que solamente se produce una zona de título de
694 parte de libro, haciendo que estén disponibles para su uso todos
695 los títulos de encabezamientos.
697 Si el libro tiene varias partituras, son posibles distintas
698 combinaciones de bloques @code{\header}, según los distintos
699 tipos de publicaciones musicales. Por ejemplo, si la publicación
700 contiene varias piezas del mismo autor, un bloque @code{\header}
701 colocado al principio del archivo que especifique el título del
702 libro y el autor, con bloques @code{\header} en cada bloque
703 @code{\score} que especifique la @code{piece} y/o el @code{opus}
704 sería lo más adecuado, como aquí:
706 @lilypond[papersize=a5,quote,verbatim,noragged-right]
709 composer = "J. S. Bach."
713 \new Staff \relative {
716 \repeat unfold 2 { g,16( d' b') a b d, b' d, } |
717 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
725 \new Staff \relative {
729 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
730 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
738 Son posibles disposiciones más complejas. Por ejemplo, los
739 campos de texto extraídos del bloque @code{\header} de un libro
740 se pueden imprimir en todos los títulos de partitura, con ciertos
741 campos sobreescritos y otros suprimidos manualmente:
743 @lilypond[papersize=a5,quote,verbatim,noragged-right]
746 print-all-headers = ##t
749 title = "DAS WOHLTEMPERIRTE CLAVIER"
751 % Do not display the default LilyPond footer for this book
754 \markup { \vspace #1 }
758 \new Staff { \clef "bass" s1 }
761 title = "PRAELUDIUM I"
763 % Do not display the subtitle for this score
770 \new Staff { \clef "bass" s1 }
774 subsubtitle = "A 4 VOCI"
776 % Do not display the subtitle for this score
784 Referencia de la notación:
785 @ref{Estructura del archivo},
786 @ref{Presentación predeterminada de los títulos de partes de libro y partitura},
787 @ref{Personalización de los títulos}.
790 @node Presentación predeterminada de los títulos de partes de libro y partitura
791 @unnumberedsubsubsec Presentación predeterminada de los títulos de partes de libro y partitura
792 @translationof Default layout of bookpart and score titles
794 Este ejemplo muestra todas las variables impresas de @code{\header}:
797 @lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
800 % Los siguientes campos están centrados
801 dedication = "Dedication (dedicatoria)"
802 title = "Title (título)"
803 subtitle = "Subtitle (subtítulo)"
804 subsubtitle = "Subsubtitle (sub-subtítulo)"
805 % Los siguientes campos se distribuyen regularmente sobre una línea
806 % el campo "instrument" también aparece en las siguientes páginas
807 instrument = \markup \with-color #green "Instrument (instrumento)"
808 poet = "Poet (poeta)"
809 composer = "Composer (autor)"
810 % Los siguientes campos se sitúan en los extremos opuestos de la misma línea
811 meter = "Meter (metro)"
812 arranger = "Arranger (arreglista)"
813 % Los siguientes campos están centrados en la parte inferior
814 tagline = "La tagline o línea de etiqueta va al final de la última página"
815 copyright = "El copyright va al final de la primera página"
820 % Los siguientes campos se colocan en los extremos de una línea
821 piece = "Piece (pieza) 1"
828 % Los siguientes campos se sitúan en los extremos de una línea
829 piece = "Piece (pieza) 2 en la misma página"
837 % Los siguientes campos se sitúan en los extremos de una línea
838 piece = "Piece (pieza) 3 en una página nueva"
849 El nombre de instrumento se repite en todas las páginas.
852 Solamente @code{piece} (la pieza) y @code{opus} se imprimen en
853 una @code{\score} cuando la variable de papel
854 @code{print-all-headers} se establece a @code{##f} (el valor
858 @c Is the bit about \null markups true? -mp
859 Los campos de texto que se dejan sin establecer dentro de un
860 bloque @code{\header} se sustituyen por elementos de marcado
861 nulos @code{\null} de manera que no ocupen espacio
865 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan
866 los campos de texto @code{piece} y @code{opus} en extremos
867 opuestos de la misma línea.
871 Para cambiar la disposición predeterminada, véase
872 @ref{Personalización de los títulos}.
876 Si un bloque @code{\book} comienza inmediatamente con un bloque
877 @code{\bookpart}, no se imprime ningún título de libro, pues no
878 existe ninguna página en que imprimirlo. Si es necesario un
879 título de libro, inicie el bloque @code{\book} con algún material
880 de marcado o con una instrucción @code{\pageBreak}.
882 Utilice la variable @code{breakbefore} dentro de un bloque
883 @code{\header} que está propiamente dentro de un bloque
884 @code{\score} para hacer que los títulos del bloque
885 @code{\header} del nivel superior aparezcan ocupando toda la
886 primera página, empezando la música (definida en el bloque
887 @code{\score}) en la página siguiente.
890 @lilypond[papersize=c7landscape,verbatim,noragged-right]
893 title = "Este es mi Title (título)"
894 subtitle = "Este es mi Subtitle (subtítulo)"
895 copyright = "Este es el final de la primera página"
898 \repeat unfold 4 { e'' e'' e'' e'' }
900 piece = "Esto es la música"
908 Manual de aprendizaje:
909 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
911 Referencia de la notación:
912 @ref{Personalización de los títulos},
913 @ref{Estructura del archivo}.
916 @file{ly/titling-init.ly}.
919 @node Disposición predeterminada de las cabeceras y pies de página
920 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
921 @translationof Default layout of headers and footers
923 Las @emph{cabeceras} y los @emph{pies} de página son líneas de
924 texto que aparecen en la parte más alta y en la más baja de las
925 páginas separadas del texto principal de un libro. Se controlan
926 mediante las siguientes variables de @code{\paper}:
929 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
930 @item @code{evenHeaderMarkup} (marcado de cabecera par)
931 @item @code{oddFooterMarkup} (marcado de pie impar)
932 @item @code{evenFooterMarkup} (marcado de pie par)
935 Estas variables de marcado sólo pueden acceder a los campos de
936 texto extraídos de bloques @code{\header} del nivel superior (que
937 se aplican a todas las partituras del libro) y se definen en el
938 archivo @file{ly/titling-init.ly}. De forma predeterminada:
943 los números de página se sitúan automáticamente en el extremo
944 superior izquierdo (si es par) o superior derecho (si es impar),
945 a partir de la segunda página.
948 el campo de texto @code{instrument} se sitúa en el centro en cada
949 página, a partir de la segunda página.
952 el texto de @code{copyright} se centra en la parte baja de la
956 la línea @code{tagline} se centra al final de la última página, y
957 debajo del texto de @code{copyright} si sólo hay una página.
961 La línea predeterminada de pie de página de LilyPond se puede
962 cambiar añadiendo un campo @code{tagline} en el bloque
963 @code{\header} del nivel superior.
965 @lilypond[papersize=a8landscape,verbatim]
968 tagline = "... music notation for Everyone"
978 Para eliminar la línea de pie de página predeterminada de
979 LilyPond, establezca el valor de @code{tagline} a @code{##f}.
982 @node Títulos encabezamientos y pies de página personalizados
983 @subsection Títulos, encabezamientos y pies de página personalizados
984 @translationof Custom titles headers and footers
986 @c TODO: somewhere put a link to header spacing info
987 @c (you'll have to explain it more in NR 4).
990 * Formateo personalizado del texto de los títulos::
991 * Personalización de los títulos::
992 * Disposición personalizada de cabeceras y pies de página::
996 @node Formateo personalizado del texto de los títulos
997 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
998 @translationof Custom text formatting for titles
1000 Se pueden usar instrucciones @code{\markup} estándar para
1001 personalizar el texto de cualquier cabecera, pie o título dentro
1002 del bloque @code{\header}.
1004 @lilypond[quote,verbatim,noragged-right]
1008 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
1009 opus = \markup { \italic "BWV 846" }
1015 Referencia de la notación:
1016 @ref{Formatear el texto}.
1019 @node Personalización de los títulos
1020 @unnumberedsubsubsec Personalización de los títulos
1021 @translationof Custom layout for titles
1023 @cindex bookTitleMarkup
1024 @cindex scoreTitleMarkup
1025 @funindex bookTitleMarkup
1026 @funindex scoreTitleMarkup
1028 Las instrucciones @code{\markup} dentro del bloque @code{\header}
1029 son útiles para dar un formato simple al texto, pero no permiten
1030 un control preciso sobre la colocación de los títulos. Para
1031 personalizar la colocación de los campos de texto, cambie una o
1032 las dos variables de @code{\paper} siguientes:
1035 @item @code{bookTitleMarkup} (marcado de título del libro)
1036 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
1039 La colocación de los títulos cuando se utilizan los valores
1040 predeterminados de estas variables de @code{\markup} se muestra
1042 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1044 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y
1045 como están definidos en el archivo @file{ly/titling-init.ly} son:
1048 scoreTitleMarkup = \markup @{ \column @{
1049 \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1051 \fromproperty #'header:piece
1052 \fromproperty #'header:opus
1058 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
1059 opuestos de la misma línea:
1061 @lilypond[quote,verbatim,noragged-right]
1065 piece = "PRAELUDIUM I"
1071 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el
1072 campo de texto @code{piece} aparece centrado y en un tipo de
1073 letra grande y en negrita.
1075 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1079 scoreTitleMarkup = \markup {
1082 \fontsize #4 \bold \fromproperty #'header:piece
1083 \fromproperty #'header:opus
1087 \header { tagline = ##f }
1091 piece = "PRAELUDIUM I"
1098 Los campos de texto que normalmente no son efectivos dentro de
1099 los bloques @code{\header} de una partitura se pueden imprimir el
1100 la zona del Título de la partitura si se coloca
1101 @code{print-all-headers} dentro del bloque @code{\paper}. Una
1102 desventaja de la utilización de este método es que los campos de
1103 texto que están orientados específicamente para la zona del
1104 título de parte de libro han de suprimirse manualmente en cada
1105 uno de los bloques @code{\score}. Véase @ref{Explicación de los
1108 Para evitarlo, añada el campo de texto deseado a la definición de
1109 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de
1110 texto @code{composer} (asociado normalmente con
1111 @code{bookTitleMarkup}) se añade a @code{scoreTitleMarkup},
1112 permitiendo que cada partitura muestre un compositor diferente:
1114 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1118 scoreTitleMarkup = \markup {
1121 \fontsize #4 \bold \fromproperty #'header:piece
1122 \fromproperty #'header:composer
1126 \header { tagline = ##f }
1131 composer = "Christian Petzold"
1138 composer = "François Couperin"
1144 También podemos crear nuestros propios campos de texto
1145 personalizados, y referirnos a ellos en la definición del
1146 elemento de marcado.
1148 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1152 scoreTitleMarkup = \markup {
1155 \override #`(direction . ,UP) {
1157 \center-align \fontsize #-1 \bold
1158 \fromproperty #'header:mycustomtext %% User-defined field
1159 \center-align \fontsize #4 \bold
1160 \fromproperty #'header:piece
1163 \fromproperty #'header:opus
1167 \header { tagline = ##f }
1172 mycustomtext = "A 4 VOCI" %% User-defined field
1180 Referencia de la notación:
1181 @ref{Explicación de los títulos}.
1184 @node Disposición personalizada de cabeceras y pies de página
1185 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1186 @translationof Custom layout for headers and footers
1188 @c can make-header and make-footer be removed from
1189 @c paper-defaults-init.ly? -mp
1191 Las instrucciones @code{\markup} dentro del bloque @code{\header}
1192 son de utilidad para dar formato al texto de una manera sencilla,
1193 pero no permiten un control preciso sobre la colocación de las
1194 cabeceras y los pies de página. Para personalizar la colocación
1195 de los campos de texto, use una o más de las siguientes variables
1199 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1200 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1201 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1202 @item @code{evenFooterMarkup} (marcado de pie de página par)
1205 @cindex marcado condicional
1207 @funindex \on-the-fly
1209 La instrucción de marcado @code{\on-the-fly} se puede utilizar
1210 para añadir elementos de forma condicional al texto de
1211 encabezamiento y pie de página definido dentro del bloque
1212 @code{\paper}, usando la sintaxis siguiente:
1215 variable = \markup @{
1217 \on-the-fly \@var{procedimiento} @var{marcado}
1222 El @var{procedimiento} se llama cada vez que se evalúa la
1223 instrucción @code{\markup} en que ésta aparece. El
1224 @var{procedimiento} debería comprobar si se cumple una condición
1225 determinada e interpretar (es decir: imprimir) el argumento
1226 @var{marcado} si, y sólo si, la condición es verdadera.
1228 Se proveen un cierto número de procedimientos ya hechos para la
1229 comprobación de diversas condiciones:
1232 @multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
1234 @headitem Nombre del procedimiento @tab Condición que se comprueba
1236 @item print-page-number-check-first @tab ¿debería imprimirse este número de página?
1237 @item create-page-number-stencil @tab ¿es print-page-numbers verdadero?
1238 @item print-all-headers @tab ¿es print-all-headers verdadero?
1239 @item first-page @tab ¿es la primera página del libro?
1240 @item not-first-page @tab ¿no es la primera página del libro?
1241 @item (on-page nmbr) @tab ¿es el número de página = nmbr?
1242 @item last-page @tab ¿es la última página del libro?
1243 @item part-first-page @tab ¿es la primera página de la parte de libro?
1244 @item not-part-first-page @tab ¿no es la primera página de la parte de libro?
1245 @item part-last-page @tab ¿es la última página de la parte de libro?
1246 @item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
1251 El ejemplo siguiente centra los números de página en la parte
1252 baja de las páginas. En primer lugar, los ajustes
1253 predeterminados para @code{oddHeaderMarkup} y
1254 @code{evenHeaderMarkup} se eliminan definiéndolos como un marcado
1255 @emph{nulo}. Después de esto, se redefine @code{oddFooterMarkup}
1256 con el número de página centrado. Finalmente,
1257 @code{evenFooterMarkup} recibe la misma disposición definiéndola
1258 como @code{\oddFooterMarkup}:
1260 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1263 print-page-number = ##t
1264 print-first-page-number = ##t
1265 oddHeaderMarkup = \markup \null
1266 evenHeaderMarkup = \markup \null
1267 oddFooterMarkup = \markup {
1269 \on-the-fly \print-page-number-check-first
1270 \fromproperty #'page:page-number-string
1273 evenFooterMarkup = \oddFooterMarkup
1276 \new Staff { s1 \break s1 \break s1 }
1281 Se pueden combinar varias condiciones de @code{\on-the-fly} con
1282 un operador @q{and}, por ejemplo:
1285 \on-the-fly \first-page
1286 \on-the-fly \last-page
1287 @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
1290 determina si la salida es una sola página.
1293 Referencia de la notación:
1294 @ref{Explicación de los títulos},
1295 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1297 Archivos instalados:
1298 @file{../ly/titling-init.ly}.
1300 @node Crear metadatos en los archivos de salida
1301 @subsection Crear metadatos en los archivos de salida
1302 @translationof Creating output file metadata
1304 @cindex metadatos de PDF
1305 @cindex metadatos de MIDI
1307 Además de mostrarse en la salida impresa, las variables de
1308 encabezamiento de @code{\header} se usan para establecer los
1309 metadatos para los archivos de salida. Por ejemplo, con los
1310 archivos PDF, estos metadatos pueden mostrarse por parte de los
1311 lectores de documentos como @code{propiedades} del PDF. Para cada
1312 tipo de archivo de salida, solamente se consultan las definiciones
1313 de @code{\header} de los bloques que definen archivos separados de
1314 ese tipo, y los bloques más altos en la jerarquía de bloques. Por
1315 tanto, para los archivos PDF, solo afectan a los metadatos de PDF
1316 de cada documento las definiciones de @code{\header} de los
1317 niveles de @code{\book} y de nivel superior, mientras que para
1318 archivos MIDI, se usan todas las cabeceras que están por encima o
1319 al nivel de @code{\score}.
1322 establece la propiedad @code{title} del bloque @code{header} como
1323 @q{Sinfonía núm. 1}, el documento PDF llevará también este
1324 título, y lo usará como el nombre de la secuencia del archivo MIDI.
1328 title = "Sinfonía núm. 1"
1332 Si quiere fijar el título de la salida impresa con un texto pero
1333 quiere que la propiedad de título del PDF tenga un texto
1334 diferente, puede usar @code{pdftitle} como se muestra a
1339 title = "Sinfonía núm. 1"
1340 pdftitle = "Sinfonía núm. 1 de Beethoven"
1344 Todas las variables @code{title}, @code{subject},
1345 @code{keywords}, @code{subtitle}, @code{composer},
1346 @code{arranger}, @code{poet}, @code{author} y @code{copyright}
1347 establecen propiedades del PDF y pueden hacerse preceder de
1348 @q{pdf} para fijar una propiedad del archivo PDF a un valor
1349 distinto del de la salida impresa.
1351 La propiedad de PDF @code{Creator} se fija automáticamente a
1352 @q{LilyPond} más la versión actual de LilyPond, y las variables
1353 @code{CreationDate} y @code{ModDate} se fijan a la fecha y hora
1354 actuales. Se puede sobreescribir @code{ModDate} mediante el
1355 establecimiento de un valor para la variable de cabecera
1356 @code{moddate} (o @code{pdfmoddate}) a una cadena de fecha de PDF
1359 La variable @code{title} establece también el nombre de la
1360 secuencia para el archivo MIDI. Se puede usar la variable
1361 @code{midititle} para fijar el nombre de la secuencia
1362 independientemente del valor usado para la salida impresa.
1364 @node Crear notas al pie
1365 @subsection Crear notas al pie
1366 @translationof Creating footnotes
1368 @cindex notas al pie
1370 Se pueden crear dos tipos de notas al pie: automáticas y manuales.
1373 * Notas al pie dentro de expresiones musicales::
1374 * Notas al pie en texto independiente::
1377 @node Notas al pie dentro de expresiones musicales
1378 @unnumberedsubsubsec Notas al pie dentro de expresiones musicales
1379 @translationof Footnotes in music expressions
1381 @cindex notas al pie dentro de expresiones musicales
1384 @subsubsubheading Panorámica de las notas al pie
1386 Las notas al pie dentro de expresiones musicales caen dentro de
1390 @item Notas al pie basadas en eventos
1391 Se adjuntan a un evento en particular. Son ejemplos de tales
1392 eventos las notas sueltas, las articulaciones (como indicaciones
1393 de digitación, acentos, indicaciones dinámicas) y los
1394 post-eventos (como las ligaduras de expresión y las barras de
1395 corchea manuales). La forma general de las notas al pie basadas
1396 en eventos es como sigue:
1399 [@var{dirección}] \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1402 @item Notas al pie basadas en tiempo
1403 Se ligan a un punto temporal determinado, dentro de un contexto
1404 musical. Algunas instrucciones como @code{\time} y @code{\clef}
1405 en realidad no usan eventos para crear objetos como la indicación
1406 de compás y la clave. Un acorde tampoco crea un evento por sí
1407 mismo: su plica o corchete se crea al final de un paso de tiempo
1408 (nominalmente, a través de uno de los eventos de nota que
1409 contiene). Una nota al pie basada en tiempo permite anotar tales
1410 objetos de presentación sin referirse a ningún evento.
1412 Una nota al pie basada en tiempo permite que tales objetos de
1413 presentación se puedan anotar sin hacer referencia a un evento.
1414 La forma general para las notas al pie basadas en tiempo es:
1417 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} [@var{Contexto}].@var{Nombre-del-Grob}
1422 Los elementos para las dos formas son como sigue:
1427 Si (y sólo si) el @code{\footnote} se está aplicando a un
1428 post-evento o articulación, debe ir precedida de un indicador de
1429 dirección (@code{-, _, ^}) con el objeto de adjuntar la
1430 @var{música} (con una marca de nota al pie) a la nota o silencio
1434 es un elemento de marcado o cadena de caracteres que especifica
1435 la marca de nota al pie que se usa para marcar tanto el punto de
1436 referencia como la propia nota al pie en la parte inferior de la
1437 página. Se puede omitir (o, de forma equivalente, sustituirse
1438 por @code{\default}) en cuyo caso se genera un número
1439 secuencialmente de forma automática. Tales secuencias numéricas
1440 se reinician en cada página que contiene una nota al pie.
1442 @item desplazamiento
1443 es una pareja de números tal como @samp{#(2 . 1)} que especifica
1444 los desplazamientos en X y en Y en unidades de espacios de
1445 pentagrama a partir del límite del objeto en que se desea situar
1446 la marca. Los valores de desplazamiento positivos se toman a
1447 partir del borde superior derecho, los valores negativos a partir
1448 del borde inferior izquierdo y cero implica que la marca se
1449 centra sobre el borde.
1452 es el contexto en que se crea el grob que recibe la nota al pie.
1453 Se puede omitir si el grob está en un contexto del nivel inferior,
1454 p. ej. un contexto @code{Voice}.
1456 @item Nombre-del-Grob
1457 especifica un tipo de grob que marcar (como @samp{Flag} para el
1458 corchete). Si se da, la nota al pie no se adjunta a una
1459 expresión musical en particular, sino a todos los grobs del tipo
1460 especificado que ocurren en dicho momento de tiempo musical.
1462 @item texto-de-la-nota
1463 es el elemento de marcado o cadena de caracteres que especifica
1464 el texto de la nota al pie que utilizar en la parte baja de la
1468 es el evento musical, post-evento o articulación que se
1473 @subsubsubheading Notas al pie basadas en eventos
1475 @cindex Notas al pie, basadas en eventos
1477 Una nota al pie se adjunta a un objeto de presentación causado
1478 directamente por el evento que corresponde a @var{música}, con la
1482 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1486 @lilypond[quote,verbatim,papersize=a8landscape]
1488 \header { tagline = ##f }
1490 \footnote #'(-1 . 3) "Una nota" a4
1492 \footnote #'(2 . 2) "Un silencio" r4
1498 No es posible marcar un acorde @emph{completo} con una nota al
1499 pie basada en evento: un acorde, incluso aquel que contiene una
1500 sola nota, no produce un verdadero evento por sí mismo. Sin
1501 embargo, las notas individuales que están @emph{dentro} del
1502 acorde sí se pueden marcar:
1505 @lilypond[quote,verbatim,papersize=a8landscape]
1507 \header { tagline = ##f }
1509 \footnote #'(2 . 3) "No funciona" <a-3>2
1510 <\footnote #'(-2 . -3) "Funciona" a-3>4
1511 <a-3 \footnote #'(3 . 1/2) "También funciona" c-5>4
1516 Si se desea que la nota al pie se adjunte a un post-evento o
1517 articulación, la instrucción @code{\footnote} @emph{debe} ir
1518 precedida por un indicador de dirección, @code{-, _, ^}, y
1519 seguida por el post-evento o articulación que se desea anotar
1520 como argumento @var{música}. En esta forma, la @code{\footnote}
1521 se puede considerar como una simple copia de su último argumento
1522 con una marca de nota al pie adjunta. La sintaxis es:
1525 @var{dirección} \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1529 @lilypond[quote,verbatim,papersize=a8landscape]
1531 \header { tagline = ##f }
1533 a'4_\footnote #'(0 . -1) "Ligadura forzada hacia abajo" (
1534 b8^\footnote #'(1 . 0.5) "Barra manual forzada hacia arriba" [
1537 c-\footnote #'(1 . 1) "Tenuto" --
1542 @subsubsubheading notas al pie basadas en tiempo
1544 @cindex notas al pie, basadas en tiempo
1546 Si el objeto de presentación que recibe la nota al pie está
1547 causado @emph{indirectamente} por un evento (como un objeto
1548 @code{Accidental}, alteración, o @code{Stem}, plica, causados por
1549 un evento @code{NoteHead}, cabeza de nota), el nombre del grob
1550 @var{GrobName} del objeto de presentación es necesario después
1551 del texto de la nota al pie, en lugar de @var{música}:
1554 @lilypond[quote,verbatim,papersize=a8landscape]
1556 \header { tagline = ##f }
1558 \footnote #'(-1 . -3) "Un bemol" Accidental
1560 \footnote #'(-1 . 0.5) "Otro bemol" Accidental
1562 \footnote #'(1 . -2) "Una plica" Stem
1568 Sin embargo, observe que cuando se especifica el nombre de un
1569 grob, se adjunta una nota al pie a todos los grobs de ese tipo
1570 dentro del instante de tiempo actual:
1573 @lilypond[quote,verbatim,papersize=a8landscape]
1575 \header { tagline = ##f }
1577 \footnote #'(-1 . 3) "Un bemol" Accidental
1579 \footnote #'(2 . 0.5) "Articulación" Script
1585 Una nota dentro de un acorde puede recibir una nota al pie
1586 individual, basada en evento. El único grob causado directamente
1587 por una nota de un acorde es @samp{NoteHead}, por lo que la
1588 instrucción de nota al pie basada en evento @emph{solamente} es
1589 apta para añadir una nota al pie a la @samp{NoteHead} dentro de
1590 un acorde. Todos los demás grobs de notas de acorde están
1591 causados indirectamente. La propia instrucción @code{\footnote}
1592 no ofrece ninguna sintaxis para especificar al mismo tiempo un
1593 tipo concreto de grob @emph{y también} un evento concreto al que
1594 adjuntar la nota. Sin embargo, se puede usar una instrucción
1595 @code{\footnote} basada en tiempo para especificar el tipo de
1596 grob, y luego añadir la instrucción @code{\single} como prefijo,
1597 con el objeto de que se aplique solamente al evento siguiente:
1600 @lilypond[quote,verbatim,papersize=a8landscape]
1602 \header { tagline = ##f }
1604 < \footnote #'(1 . -2) "Un La" a
1605 \single \footnote #'(-1 . -1) "Un sostenido" Accidental
1607 \single \footnote #'(0.5 . 0.5) "Un bemol" Accidental
1614 @warning{Cuando las notas al pie se adjuntan a varios elementos musicales
1615 que están dentro del mismo momento musical, como ocurre en el
1616 ejemplo anterior, las notas al pie se numeran desde los elementos
1617 más altos a los más bajos tal y como aparecen en la salida
1618 impresa, no en el orden en que se escriben en el flujo de
1621 Los objetos de presentación como las claves y las armaduras de
1622 cambio de tonalidad están, más bien, causadas por propiedades que
1623 cambian, y no por eventos. Otros, como las líneas divisorias y
1624 los números de compás, son una consecuencia directa del paso del
1625 tiempo. Por esta razón, las notas al pie sobre tales objetos
1626 tienen que basarse en su tiempo musical. Las notas al pie
1627 basadas en tiempo so preferibles también cuando se marcan cosas
1628 como las plicas y las barras de corchea en @emph{acordes}: dado
1629 que estas funcionalidades de cada acorde individual están
1630 asignadas normalmente a @emph{un solo} evento dentro del acorde,
1631 sería imprudente descansar en una elección particular.
1633 En las notas al pie basadas en tiempo, siempre se debe
1634 especificar explícitamente el objeto de presentación en cuestión,
1635 y si el grob se crea dentro de un contexto distinto al de nivel
1636 más bajo, debe especificarse el contexto apropiado.
1639 @lilypond[quote,verbatim,papersize=a8landscape]
1641 \header { tagline = ##f }
1644 \footnote #'(-0.5 . -1) "Cambio de compás" Staff.TimeSignature
1646 \footnote #'(1 . -1) "Plica de acorde" Stem
1648 \footnote #'(-0.5 . 1) "Línea divisoria" Staff.BarLine
1650 \footnote #'(0.5 . -1) "Cambio de tonalidad" Staff.KeySignature
1657 Se pueden usar marcas personalizadas como alternativas a las
1658 marcas numéricas, y se puede suprimir la línea de anotación que
1659 une el objeto marcado con su marca:
1662 @lilypond[quote,verbatim,papersize=a8landscape]
1664 \header { tagline = ##f }
1666 \footnote "*" #'(0.5 . -2) \markup { \italic "* La primera nota" } a'4
1668 \footnote \markup { \super "$" } #'(0.5 . 1)
1669 \markup { \super "$" \italic " La segunda nota" } e
1671 \once \override Score.FootnoteItem.annotation-line = ##f
1672 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1673 \markup { \super "+" \italic " Editorial" } \p
1678 Se muestran más ejemplos de marcas personalizadas en
1679 @ref{Notas al pie en texto independiente}.
1682 @node Notas al pie en texto independiente
1683 @unnumberedsubsubsec Notas al pie en texto independiente
1684 @translationof Footnotes in stand-alone text
1686 @cindex notas al pie en texto independiente
1688 Se utilizan dentro de un elemento de marcado fuera de cualquier
1689 expresión musical. No se traza una línea hasta el punto de
1690 referencia: la marca simplemente sigue al elemento de marcado que
1691 se referencia. Se pueden insertar las marcas automáticamente, en
1692 cuyo caso son numéricas. De forma alternativa, se pueden aportar
1693 manualmente marcas personalizadas.
1695 Las notas al pie para texto independiente con marcas automáticas
1696 y personalizadas se crean de distintas formas.
1698 @subsubsubheading Notas al pie en texto independiente con marcas automáticas
1700 La sintaxis de una nota al pie sobre texto independiente con
1701 marcas automáticas es
1704 \markup @{ @dots{} \auto-footnote @var{texto} @var{nota} @dots{} @}
1712 es el elemento de marcado o cadena de caracteres que se desea
1716 es el elemento de marcado o cadena de caracteres que especifica
1717 el texto de la nota al pie que utilizar en la parte baja de la
1724 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1726 \header { tagline = ##f }
1729 \auto-footnote "tune" \italic " By me"
1730 "is shown below. It is a"
1731 \auto-footnote "recent" \italic " Aug 2012"
1740 @subsubsubheading Notas al pie sobre texto independiente con marcas personalizadas
1742 La sintaxis de una nota al pie sobre texto independiente con
1743 marcas personalizadas es
1746 \markup @{ @dots{} \footnote @var{marca} @var{nota} @dots{} @}
1754 es un elemento de marcado o cadena de caracteres que especifica
1755 la marca que se usa para señalar el punto de referencia. Observe
1756 que esta marca @emph{no} se inserta automáticamente antes de la
1760 es el elemento de marcado o cadena de caracteres que especifica
1761 el texto de la nota que aparece en la parte baja de la página,
1762 precedida por la @var{marca} especificada.
1766 Se puede usar como marca un carácter fácil de teclear, como * ó +,
1767 según se muestra en @ref{Notas al pie dentro de expresiones musicales}.
1768 De forma alternativa, se pueden usar alias en ASCII (véase
1769 @ref{Alias de ASCII}):
1771 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1773 \paper { #(include-special-characters) }
1774 \header { tagline = ##f }
1777 \footnote "*" \italic "* By me"
1778 "is shown below. It is a recent"
1779 \footnote \super † \concat {
1780 \super † \italic " Aug 2012"
1790 También pueden utilizarse códigos de caracteres Unicode para
1791 especificar las marcas (véase @ref{Unicode}):
1793 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1795 \header { tagline = ##f }
1798 \footnote \super \char##x00a7 \concat {
1799 \super \char##x00a7 \italic " By me"
1801 "is shown below. It is a recent"
1802 \footnote \super \char##x00b6 \concat {
1803 \super \char##x00b6 \italic " Aug 2012"
1814 Manual de aprendizaje:
1815 @rlearning{Objetos e interfaces}.
1817 Referencia de la notación:
1818 @ref{ASCII aliases},
1819 @ref{Globos de ayuda},
1820 @ref{Lista de caracteres especiales},
1821 @ref{Indicaciones de texto},
1822 @ref{Guiones de texto},
1825 Referencia de funcionamiento interno:
1826 @rinternals{FootnoteEvent},
1827 @rinternals{FootnoteItem},
1828 @rinternals{FootnoteSpanner},
1829 @rinternals{Footnote_engraver}.
1832 Varias notas al pie en la misma página solo pueden ir apiladas
1833 unas sobre otras; no se pueden imprimir en la misma línea.
1835 Las notas al pie no se pueden adjuntar a @code{MultiMeasureRests}
1836 (silencios multicompás), a barras de corchea automáticas ni a la
1837 letra de las canciones.
1839 Las notas al pie pueden colisionar con las pautas, objetos
1840 @code{\markup}, otras marcas de notas al pie y líneas de
1844 @node Referencia a números de página
1845 @subsection Referencia a números de página
1846 @translationof Reference to page numbers
1848 Un lugar determinado de una partitura puede señalizarse usando la
1849 instrucción @code{\label} (etiqueta), ya sea en el nivel superior
1850 o dentro de la música. Podemos referirnos a esta etiqueta más
1851 tarde dentro de un elemento de marcado, para obtener el número de
1852 la página en la que se sitúa el punto señalizado, usando la
1853 instrucción de marcado @code{\page-ref}.
1856 @lilypond[verbatim,papersize=a8landscape]
1857 \header { tagline = ##f }
1863 \pageBreak \mark A \label #'markA
1867 \markup { La primera partitura comienza en la página \page-ref #'firstScore "0" "?" }
1868 \markup { La marca A está en la página \page-ref #'markA "0" "?" }
1872 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1874 @item la etiqueta, un símbolo de Scheme, p.ej. @code{#'firstScore};
1875 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1876 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1879 El motivo de que se necesite un medidor es que en el momento en
1880 que se están interpretando los marcados, los saltos de página aún
1881 no se han producido y por tanto los números de página no se
1882 conocen todavía. Para sortear este inconveniente, la
1883 interpretación real del marcado se retrasa hasta un momento
1884 posterior; sin embargo, las dimensiones del marcado se tienen que
1885 conocer de antemano, así que se usa el medidor para decidir estas
1886 dimensiones. Si el libro tiene entre 10 y 99 páginas, el medidor
1887 puede ser "00", es decir, un número de dos dígitos.
1897 @node Índice general
1898 @subsection Índice general
1899 @translationof Table of contents
1901 Se puede insertar un índice general o tabla de contenidos
1902 utilizando la instrucción @code{\markuplist \table-of-contents}.
1903 Los elementos que deben aparecer en la tabla de contenidos se
1904 introducen con la instrucción @code{\tocItem}, que se puede usar
1905 en el nivel más alto de la jerarquía del código, o dentro de una
1909 \markuplist \table-of-contents
1912 \tocItem \markup "Primera partitura"
1916 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1921 \tocItem \markup "Segunda partitura"
1929 Los elementos de marcado que se usan para dar formato al índice
1930 general o tabla de contenidos se encuentran definidos dentro del
1931 bloque @code{\paper}. Hay dos elementos de marcado
1932 @q{predefinidos} disponibles:
1937 @code{tocTitleMarkup}
1940 Utilizado para dar formato al título del índice general.
1943 tocTitleMarkup = \markup \huge \column {
1944 \fill-line { \null "Índice general" \null }
1950 @code{tocItemMarkup}
1953 Usado para dar formato a los elementos del índice general.
1956 tocItemMarkup = \markup \fill-line {
1957 \fromproperty #'toc:text \fromproperty #'toc:page
1964 Ambas variables pueden modificarse.
1966 He aquí un ejemplo que modifica el título del índice general para
1967 que aparezca en francés:
1971 tocTitleMarkup = \markup \huge \column {
1972 \fill-line { \null "Table des matières" \null }
1977 A continuación aparece un ejemplo que modifica el tamaño de
1978 fuente tipográfica de los elementos del índice general:
1981 tocItemMarkup = \markup \large \fill-line {
1982 \fromproperty #'toc:text \fromproperty #'toc:page
1986 Observe la forma en que nos referimos al texto y al número de
1987 página del elemento de índice, dentro de la definición
1988 @code{tocItemMarkup}.
1990 La instrucción @code{\tocItemWithDotsMarkup} se puede incluir
1991 dentro de @code{tocItemMarkup} para llenar la línea con puntos
1992 entre un elemento del índice general y su número de página
1995 @lilypond[verbatim,line-width=10.0\cm]
1996 \header { tagline = ##f }
1998 tocItemMarkup = \tocItemWithDotsMarkup
2002 \markuplist \table-of-contents
2003 \tocItem \markup { Allegro }
2004 \tocItem \markup { Largo }
2009 Las instrucciones predefinidas con sus propios marcados pueden
2010 definirse también para que construyan un índice general más
2011 complejo. En el ejemplo siguiente se define un estilo nuevo para
2012 introducir los nombres de los actos de una ópera en el índice
2016 Una nueva variable de marcado (llamada @code{tocActMarkup}) se
2017 define en el bloque @code{\paper}:
2021 tocActMarkup = \markup \large \column {
2023 \fill-line { \null \italic \fromproperty #'toc:text \null }
2030 A continuación se crea una función musical personalizada
2031 (@code{tocAct}), que usa la nueva definición de marcado
2032 @code{tocActMarkup}.
2036 #(define-music-function (text) (markup?)
2037 (add-toc-item! 'tocActMarkup text))
2041 Un archivo de entrada de LilyPond que use estas definiciones
2042 personalizadas tendría el aspecto siguiente:
2044 @lilypond[line-width=10.0\cm]
2045 \header { tagline = ##f }
2047 tocActMarkup = \markup \large \column {
2049 \fill-line { \null \italic \fromproperty #'toc:text \null }
2055 #(define-music-function (text) (markup?)
2056 (add-toc-item! 'tocActMarkup text))
2059 \markuplist \table-of-contents
2060 \tocAct \markup { Atto Primo }
2061 \tocItem \markup { Coro. Viva il nostro Alcide }
2062 \tocItem \markup { Cesare. Presti omai l'Egizia terra }
2063 \tocAct \markup { Atto Secondo }
2064 \tocItem \markup { Sinfonia }
2065 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
2071 He aquí un ejemplo de la instrucción @code{\fill-with-pattern}
2072 usada dentro del contexto de un índice general:
2076 tocItemMarkup = \markup { \fill-line {
2077 \override #'(line-width . 70)
2078 \fill-with-pattern #1.5 #CENTER . \fromproperty #'toc:text \fromproperty #'toc:page
2086 @file{ly/toc-init.ly}.
2089 @funindex \table-of-contents
2090 @code{\table-of-contents},
2096 @node Trabajar sobre los archivos de entrada
2097 @section Trabajar sobre los archivos de entrada
2098 @translationof Working with input files
2101 * Inclusión de archivos de LilyPond::
2102 * Distintas ediciones a partir de una misma fuente::
2103 * Caracteres especiales::
2107 @node Inclusión de archivos de LilyPond
2108 @subsection Inclusión de archivos de LilyPond
2109 @translationof Including LilyPond files
2112 @cindex including files
2114 Un proyecto grande se puede dividir en varios archivos. Para
2115 referirse a otro archivo, utilice
2118 \include "otroarchivo.ly"
2121 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo
2122 el contenido de @file{otroarchivo.ly} en el archivo actual en el
2123 lugar en que aparece el @code{\include}. Por ejemplo, en un
2124 proyecto grande podríamos querer archivos distintos para cada
2125 parte instrumental y crear un archivo de @qq{partitura completa}
2126 que reúne los archivos individuales de los instrumentos.
2127 Normalmente el archivo incluido define un cierto número de
2128 variables que a partir de entonces quedan disponibles para
2129 poderlas utilizar en el archivo de la partitura completa. En los
2130 archivos incluidos se pueden marcar las secciones etiquetadas
2131 para ayudar a hacerlas utilizables en distintos lugares de la
2132 partitura, véase @ref{Distintas ediciones a partir de una misma
2135 Los archivos que están en el directorio de trabajo actual se
2136 pueden referenciar simplemente especificando el nombre después de
2137 la instrucción @code{\include}. Los archivos en otros lugares se
2138 pueden incluir proporcionando una referencia de ruta completa o
2139 una ruta relativa (pero utilice la barra inclinada normal del
2140 UNIX, /, no la barra invertida de DOS/Windows, \, como separador
2141 de directorio). Por ejemplo, si @file{material.ly} está situado
2142 un directorio por encima del directorio de trabajo actual,
2146 \include "../material.ly"
2150 o si los archivos de las partes orquestales incluidas están todos
2151 situados en un subdirectorio llamado @file{partes} dentro del
2152 directorio actual, use
2155 \include "partes/VI.ly"
2156 \include "partes/VII.ly"
2160 Los archivos de inclusión también pueden contener enunciados
2161 @code{\include} a su vez. De forma predeterminada, estos
2162 enunciados @code{\include} de segundo nivel no se interpretan
2163 hasta que se incorporan al archivo principal, por lo que los
2164 nombres de archivo que especifican deben ser relativos al
2165 directorio que contiene el archivo principal, no al directorio
2166 que contiene el archivo incluido. Sin embargo, este
2167 comportamiento se puede modificar globalmente pasando la opción
2168 @option{-drelative-includes} en la línea de órdenes (o mediante
2169 la adición de @code{#(ly:set-option 'relative-includes #t)} al
2170 principio del archivo principal de entrada).
2172 Cuando @code{relative-includes} está establecido al valor
2173 @code{#t}, la ruta de cada instrucción @code{\include} se
2174 considera relativa al archivo que contiene dicha instrucción.
2175 Este comportamiento es el recomendado y se convertirá en el
2176 comportamiento predeterminado en una versión futura de lilypond.
2178 Tanto los archivos relativos al directorio principal como los
2179 archivos relativos a algún otro directorio se pueden
2180 @code{\include}ar mediante el establecimiento de
2181 @code{relative-includes} al valor @code{#t} o a @code{#f} en los
2182 lugares apropiados dentro de los archivos. Por ejemplo, si se ha
2183 creado una biblioteca genérica, libA, que a su vez utiliza
2184 sub-archivos que se @code{\include}an por medio del archivo de
2185 entrada de dicha biblioteca, esas instrucciones @code{\include}
2186 tendrán que venir precedidas por @code{#(ly:set-option
2187 #relative-includes #t)} de manera que se interpreten
2188 correctamente al construir el archivo de entrada @code{.ly}
2189 principal, de esta forma:
2200 entonces el archivo de entrada, @code{libA.ly}, contiene
2203 #(ly:set-option 'relative-includes #t)
2207 % vuelta al ajuste predeterminado
2208 #(ly:set-option 'relative-includes #f)
2211 Cualquier archivo @file{.ly} puede entonces incluir la biblioteca
2212 completa, simplemente con
2215 \include "~/libA/libA.ly"
2218 Se pueden usar estructuras de archivo más complejas instando los
2219 cambios en los lugares adecuados.
2221 También se pueden incluir archivos de un directorio que está en
2222 una ruta de búsqueda especificada como opción al invocar a
2223 LilyPond desde la línea de órdenes. Los archivos incluidos se
2224 especifican usando solamente su nombre de archivo. Por ejemplo,
2225 para compilar mediante este método un archivo @file{principal.ly}
2226 que incluye archivos situados en un subdirectorio llamado
2227 @file{partes}, cambie al directorio que contiene
2228 @file{principal.ly} e introduzca
2231 lilypond --include=partes principal.ly
2234 y en @file{principal.ly} escriba
2242 Los archivos que se incluyen en muchas partituras se pueden poner
2243 en el directorio de LilyPond @file{../ly} (la localización de
2244 este directorio depende de la instalación: véase @rlearning{Otras
2245 fuentes de información}). Estos archivos se pueden incluir
2246 sencillamente por su nombre en un enunciado @code{\include}. De
2247 esta forma se incluyen los archivos dependientes del idioma como
2250 LilyPond incluye de forma predeterminada ciertos archivos cuando
2251 se inicia el programa. Estas inclusiones no son visibles para el
2252 usuario, pero los archivos se pueden identificar ejecutando
2253 @code{lilypond --verbose} desde la línea de órdenes. Esto
2254 presentará una lista de rutas y archivos que utiliza LilyPond,
2255 junto a muchas otras indicaciones. De forma alternativa, pueden
2256 verse explicaciones sobre los archivos más importantes de este
2257 conjunto en @rlearning{Otras fuentes de información}. Estos
2258 archivos se pueden editar, pero los cambios realizados sobre
2259 ellos se perderán al instalar una nueva versión de LilyPond.
2261 Pueden verse ejemplos sencillos sobre el uso de @code{\include}
2262 en @rlearning{Partituras y particellas}.
2265 Manual de aprendizaje:
2266 @rlearning{Otras fuentes de información},
2267 @rlearning{Partituras y particellas}.
2270 Si un archivo incluido recibe un nombre igual al de uno de los
2271 archivos de instalación de LilyPond, el archivo que tiene
2272 prioridad es el de los archivos de instalación de LilyPond.
2275 @node Distintas ediciones a partir de una misma fuente
2276 @subsection Distintas ediciones a partir de una misma fuente
2277 @translationof Different editions from one source
2279 Se pueden usar varios métodos para generar la producción de
2280 distintas versiones de una partitura a partir de la misma fuente
2281 musical. Las variables son quizá el más útil para combinar
2282 secciones extensas de música y/o anotaciones. Las etiquetas son
2283 más útiles para seleccionar una sección de entre varias secciones
2284 de música alternativas, más cortas, y se pueden usar también para
2285 dividir piezas de música en distintos trozos.
2287 Cualquiera que sea el método utilizado, la separación de la
2288 notación de la estructura de la partitura hará que sea más fácil
2289 cambiar la estructura dejando intacta la notación.
2292 * Uso de las variables::
2293 * Uso de etiquetas::
2294 * Uso de ajustes globales::
2297 @node Uso de las variables
2298 @unnumberedsubsubsec Uso de las variables
2299 @translationof Using variables
2301 @cindex variables, uso de las
2303 Si las secciones de la música se definen dentro de variables, se
2304 pueden reutilizar en distintas partes de la partitura, véase
2305 @rlearning{Organizar las piezas mediante variables}. Por
2306 ejemplo, una partitura vocal @notation{a cappella} con frecuencia
2307 incluye una reducción de piano de las partes para ensayar que es
2308 idéntica a la música vocal, por lo que ésta sólo se tiene que
2309 escribir una vez. Se puede combinar sobre un solo pentagrama la
2310 música de dos variables, véase @ref{Combinación automática de las
2311 partes}. He aquí un ejemplo:
2313 @lilypond[verbatim,quote]
2314 sopranoMusic = \relative { a'4 b c b8( a) }
2315 altoMusic = \relative { e'4 e e f }
2316 tenorMusic = \relative { c'4 b e d8( c) }
2317 bassMusic = \relative { a4 gis a d, }
2318 allLyrics = \lyricmode { King of glo -- ry }
2320 \new Staff = "Soprano" \sopranoMusic
2321 \new Lyrics \allLyrics
2322 \new Staff = "Alto" \altoMusic
2323 \new Lyrics \allLyrics
2324 \new Staff = "Tenor" {
2328 \new Lyrics \allLyrics
2329 \new Staff = "Bass" {
2333 \new Lyrics \allLyrics
2336 \partcombine \sopranoMusic \altoMusic
2340 \partcombine \tenorMusic \bassMusic
2346 Se pueden producir partituras distintas que presenten sólo las
2347 partes vocales o sólo la parte de piano, cambiando solamente los
2348 enunciados estructurales, sin modificar la notación musical.
2350 Para partituras extensas, las definiciones de variable se pueden
2351 poner en archivos separados que se incluyen más tarde, véase
2352 @ref{Inclusión de archivos de LilyPond}.
2355 @node Uso de etiquetas
2356 @unnumberedsubsubsec Uso de etiquetas
2357 @translationof Using tags
2360 @funindex \keepWithTag
2361 @funindex \removeWithTag
2363 @cindex mantener música etiquetada
2364 @cindex quitar música etiquetada
2366 La instrucción @code{\tag #'@var{parteA}} marca una expresión
2367 musical con el nombre @var{parteA}. Las expresiones etiquetadas
2368 de esta manera se pueden seleccionar o filtrar más tarde por su
2369 nombre, usando bien @code{\keepWithTag #'@var{nombre}} o bien
2370 @code{\removeWithTag #'@var{nombre}}. El resultado de la
2371 aplicación de estos filtros a la música etiquetada es como sigue:
2373 @multitable @columnfractions .5 .5
2377 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
2378 o de @code{\keepWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2379 @tab Se incluye la música no etiquetada y la música etiquetada con
2380 el nombre o nombres de etiqueta dados; se excluye la música
2381 etiquetada con cualquier otro nombre de etiqueta.
2383 Música etiquetada precedida de
2384 @code{\removeWithTag #'@var{nombre}} o
2385 @code{\removeWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2387 Se incluye la música no etiquetada y la música que no está
2388 etiquetada con ninguno de los nombres de etiqueta dados; se
2389 excluye la música etiquetada con los nombres de etiqueta dados.
2391 Música etiquetada no precedida de @code{\keepWithTag} ni de
2392 @code{\removeWithTag}
2393 @tab Se incluye toda la música etiquetada y no etiquetada.
2396 Los argumentos de las instrucciones @code{\tag},
2397 @code{\keepWithTag} y @code{\removeWithTag} deben ser un símbolo
2398 o lista de símbolos (como @code{#'score} o @code{#'(violinI
2399 violinII}), seguida de una expresión musical. Si @emph{y solo
2400 si} los símbolos son identificadores de LilyPond válidos
2401 (caracteres alfabéticos solamente, sin números, guiones bajos ni
2402 guiones normales) que no puedan confundirse con notas, la porción
2403 @code{#'} se puede omitir y, como abreviatura, una lista de
2404 símbolos puede usar el separador de punto, es decir: @code{\tag
2405 #'(violinI violinII)} se puede escribir como @code{\tag
2406 violinI.violinII}. Lo mismo vale para @code{\keepWithTag} y
2407 @code{\removeWithTag}.
2409 En el ejemplo siguiente vemos dos versiones de una pieza musical,
2410 una que muestra trinos con la notación usual y otra con los
2411 trinos expandidos explícitamente:
2413 @lilypond[verbatim,quote]
2416 \tag #'trills { d8.\trill }
2417 \tag #'expand { \repeat unfold 3 { e32 d } }
2422 \keepWithTag #'trills \music
2425 \keepWithTag #'expand \music
2430 De forma alternativa, a veces es más fácil excluir secciones de música:
2432 @lilypond[verbatim,quote]
2435 \tag #'trills { d8.\trill }
2436 \tag #'expand {\repeat unfold 3 { e32 d } }
2441 \removeWithTag #'expand
2445 \removeWithTag #'trills
2450 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
2454 -\tag #'@var{mi-etiqueta}
2457 a una articulación. Por ejemplo, esto define una nota con una
2458 indicación opcional de digitación y una nota con una anotación
2463 c1-\tag #'warn ^"¡Ojo!"
2466 Se pueden poner varias etiquetas sobre expresiones con varias
2467 entradas de @code{\tag}, o combinando varias etiquetas en una
2470 @lilypond[quote,verbatim]
2471 music = \relative c'' {
2472 \tag #'a \tag #'both { a4 a a a }
2473 \tag #'(b both) { b4 b b b }
2476 \keepWithTag #'a \music
2477 \keepWithTag #'b \music
2478 \keepWithTag #'both \music
2482 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
2483 expresión musical para quitar varias secciones etiquetadas con
2484 nombres distintos. De forma alternativa, podemos usar una sola
2485 instrucción @code{\removeWithTag} con una lista de etiquetas.
2487 @lilypond[verbatim,quote]
2488 music = \relative c'' {
2489 \tag #'A { a4 a a a }
2490 \tag #'B { b4 b b b }
2491 \tag #'C { c4 c c c }
2492 \tag #'D { d4 d d d }
2498 \removeWithTag #'(B C)
2503 El uso de dos o más filtros @code{\keepWithTag} sobre una sola
2504 expresión musical produce la eliminación de @emph{todas} las
2505 secciones etiquetadas. El primer filtro quita todas excepto la
2506 que se nombra, y cualquier filtro posterior elimina el resto.
2507 Usando una sola instrucción @code{\keepWithTag} con una lista de
2508 varias etiquetas se suprimirán solamente las secciones etiquetadas
2509 que no aparezcan especificadas en la lista.
2511 @lilypond[verbatim,quote]
2512 music = \relative c'' {
2513 \tag #'violinI { a4 a a a }
2514 \tag #'violinII { b4 b b b }
2515 \tag #'viola { c4 c c c }
2516 \tag #'cello { d4 d d d }
2520 \keepWithTag #'(violinI violinII)
2526 will print @code{\tag}s @var{violinI} and @var{violinII} but not
2527 @var{viola} or @var{cello}.
2529 @cindex grupos de etiquetas
2531 Aunque @code{\keepWithTag} es útil para el manejo de @emph{un
2532 solo} conjunto de alternativas, la eliminación de música
2533 etiquetada con otras etiquetas @emph{no relacionadas} es
2534 problemática si se utilizan para más de un propósito. En ese caso
2535 pueden declararse @q{grupos de etiquetas}:
2538 \tagGroup #'(violinI violinII viola cello)
2542 Ahora todas las etiquetas pertenecen a un solo @q{grupo de etiquetas}.
2543 Observe que las etiquetas individuales no pueden ser miembros
2544 de más de un @emph{grupo de etiquetas}.
2547 \keepWithTag #'violinI @dots{}
2551 mostrará solamente la música etiquetada a partir del
2552 grupo de etiquetas de @code{violinI} y
2553 cualquier fragmento musical etiquetado con una de las
2554 @emph{otras} etiquetas resultará suprimido.
2556 @lilypond[verbatim,quote]
2558 \tagGroup #'(violinI violinII viola cello)
2559 \tag #'violinI { c''4^"violinI" c c c }
2560 \tag #'violinII { a2 a }
2561 \tag #'viola { e8 e e2. }
2562 \tag #'cello { d'2 d4 d }
2567 \keepWithTag #'violinI
2572 Al usar la instrucción @code{\keepWithTag} solo son visibles
2573 las etiquetas de los grupos de aquellas etiquetas se se incluyen
2576 @funindex \pushToTag
2577 @funindex \appendToTag
2578 @cindex dividir en música etiquetada
2580 A veces podemos desear dividir la música en un determinado lugar
2581 dentro de una expresión musical existente. Podemos usar
2582 @code{\pushToTag} y @code{\appendToTag} para añadir material
2583 delante o al final de los @code{elements} de una construcción
2584 musical existente. No toda construcción musical tiene la parte
2585 @code{elements}, pero las músicas secuenciales y simultáneas son
2586 dos apuestas seguras:
2588 @lilypond[verbatim,quote]
2589 music = { \tag #'here { \tag #'here <<c''>> } }
2592 \pushToTag #'here c'
2593 \pushToTag #'here e'
2594 \pushToTag #'here g' \music
2595 \appendToTag #'here c'
2596 \appendToTag #'here e'
2597 \appendToTag #'here g' \music
2601 Las dos instrucciones admiten una etiqueta, el material que
2602 dividir en cada ocurrencia de la etiqueta, y la expresión
2606 Manual de aprendizaje:
2607 @rlearning{Organizar las piezas mediante variables}.
2609 Referencia de la notación:
2610 @ref{Combinación automática de las partes},
2611 @ref{Inclusión de archivos de LilyPond}.
2614 Al llamar a @code{\relative} sobre una expresión musical obtenida
2615 mediante el filtrado de música con las instrucciones
2616 @code{\keepWithTag} o @code{\removeWithTag}, podría ocurrir que
2617 cambiaran las relaciones de octava, dado que solo se tendrán en
2618 cuenta las alturas de las notas que efectivamente permanecen en
2619 la expresión filtrada. La aplicación de @code{\relative} en
2620 primer lugar, antes de @code{\keepWithTag} o de
2621 @code{\removeWithTag}, evita este peligro porque en este caso
2622 @code{\relative} actúa sobre todas las notas tal y como se
2626 @node Uso de ajustes globales
2627 @unnumberedsubsubsec Uso de ajustes globales
2628 @translationof Using global settings
2630 @cindex include-settings
2632 Se pueden incluir ajustes globales a partir de un archivo
2636 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
2639 En archivos diferentes se pueden almacenar grupos de ajustes como
2640 el tamaño de la página o las fuentes tipográficas. Ello permite
2641 hacer diferentes ediciones de la misma partitura así como aplicar
2642 ajustes estándar a muchas partituras, simplemente por medio de la
2643 especificación del archivo de ajustes adecuado.
2645 Esta técnica también funciona bien con el uso de hojas de estilo,
2646 como se estudia en @rlearning{Hojas de estilo}.
2649 Manual de aprendizaje:
2650 @rlearning{Organizar las piezas mediante variables},
2651 @rlearning{Hojas de estilo}.
2653 Referencia de la notación:
2654 @ref{Inclusión de archivos de LilyPond}.
2657 @node Caracteres especiales
2658 @subsection Caracteres especiales
2659 @translationof Special characters
2661 @cindex caracteres especiales
2662 @cindex caracteres no ASCII
2665 * Codificación del texto::
2671 @node Codificación del texto
2672 @unnumberedsubsubsec Codificación del texto
2673 @translationof Text encoding
2677 LilyPond usa el conjunto de caracteres definido por el consorcio
2678 Unicode y la norma ISO/IEC 10646. Define un nombre único y un
2679 código para los conjuntos de caracteres que se utilizan en
2680 prácticamente todos los idiomas modernos y también en muchos
2681 otros. Unicode se puede implementar utilizando varios esquemas
2682 de codificación distintos. LilyPond usa la codificación UTF-8
2683 (UTF son las siglas de @emph{Unicode Transformation Format}, o
2684 formato de transformación de Unicode) que representa todos los
2685 caracteres comunes de la codificación Latin en un solo byte, y
2686 representa otros caracteres usando un formato de longitud
2687 variable de hasta cuatro bytes.
2689 El aspecto visual real de los caracteres viene determinado por
2690 los glifos que se definen en las fuentes tipográficas concretas
2691 que se tengan disponibles: una fuente tipográfica define la
2692 asignación de un subconjunto de los códigos de Unicode a glifos.
2693 LilyPond usa la biblioteca Pango para representar y disponer
2694 tipográficamente textos multilingües.
2696 LilyPond no realiza ninguna conversión en la codificación de la
2697 entrada. Esto significa que cualquier text, ya sea el título, la
2698 letra de la canción o una instrucción musical que contenga
2699 caracteres distintos a los del conjunto ASCII, se deben codificar
2700 en UTF-8. La forma más fácil de escribir dicho texto es utilizar
2701 un editor preparado para Unicode y guardar el archivo con la
2702 codificación UTF-8. Casi todos los editores modernos populares
2703 contemplan el UTF-8, por ejemplo lo hacen vim, Emacs, jEdit y
2704 Gedit. Todos los sistemas MS Windows posteriores a NT usan
2705 Unicode como codificación de caracteres nativa, de manera que
2706 incluso el accesorio Bloc de Notas (Notepad) puede editar y
2707 guardar un archivo en el formato UTF-8. Una alternativa más
2708 funcional para Windows es BabelPad.
2710 Si un archivo de entrada que contiene un carácter que no es
2711 ASCII, no se guarda en el formato UTF-8, se genera el mensaje de
2715 FT_Get_Glyph_Name () error: argumento inválido
2718 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
2720 @c NOTE: No verbatim in the following example as the code does not
2721 @c display correctly in PDF Font settings for Cyrillic and Hebrew
2724 % Linux Libertine fonts contain Cyrillic and Hebrew glyphs.
2728 #:roman "Linux Libertine O,serif"
2729 #:sans "Linux Biolinum O,sans-serif"
2730 #:typewriter "Linux Libertine Mono O,monospace"
2735 bulgarian = \lyricmode {
2736 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2740 hebrew = \lyricmode {
2741 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2745 portuguese = \lyricmode {
2746 à vo -- cê uma can -- ção legal
2752 \addlyrics { \bulgarian }
2753 \addlyrics { \hebrew }
2754 \addlyrics { \portuguese }
2759 @unnumberedsubsubsec Unicode
2760 @translationof Unicode
2764 Para introducir un carácter aislado para el que se conoce el
2765 punto de código Unicode pero no está disponible en el editor que
2766 se está usando, use @code{\char ##xhhhh} o bien @code{\char
2767 #dddd} dentro de un bloque @code{\markup}, donde @code{hhhh} es
2768 el código hexadecimal del carácter en cuestión y @code{dddd} es
2769 su valor decimal correspondiente. Pueden omitirse los ceros
2770 iniciales, pero es costumbre indicar los cuatro caracteres en la
2771 representación hexadecimal (observe que @emph{no} debe utilizarse
2772 la codificación UTF-8 del punto de código Unicode después de
2773 @code{\char}, pues la codificación UTF-8 contiene bits
2774 adicionales que indican el número de octetos). Hay tablas de
2775 códigos Unicode y un índice de nombres de caracteres que da el
2776 punto de código en hexadecimal para cualquier carácter en el
2777 portal del Consorcio Unicode, @uref{http://www.unicode.org/}.
2779 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
2780 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
2781 @qq{Letra griega Xi pequeña}.
2783 Se puede escribir de esta forma cualquier punto de código
2784 Unicode, y si todos los caracteres especiales se escriben en este
2785 formato no es necesario guardar el archivo de entrada en formato
2786 UTF-8. Por supuesto, debe estar instalada y estar disponible
2787 para LilyPond una fuente tipográfica que contenga codificados
2788 todos estos caracteres.
2790 El ejemplo siguiente muestra valores hexadecimales Unicode que se
2791 usan en cuatro lugares: en una llamada de ensayo, como texto de
2792 articulación, en la letra y como texto independiente bajo la
2795 @lilypond[quote,verbatim]
2798 c''1 \mark \markup { \char ##x03EE }
2799 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2801 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2803 \markup { "Copyright 2008--2015" \char ##x00A9 }
2806 @cindex copyright, símbolo de
2808 Para escribir el símbolo de copyright en la nota de créditos, utilice:
2812 copyright = \markup @{ \char ##x00A9 "2008" @}
2817 @node Alias de ASCII
2818 @unnumberedsubsubsec Alias de ASCII
2819 @translationof ASCII aliases
2821 Se puede incluir una lista de alias de ASCII para caracteres
2824 @lilypond[quote,verbatim]
2826 #(include-special-characters)
2829 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2832 \new Staff { \repeat unfold 9 a'4 }
2834 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2839 "The replacement can be disabled:"
2840 "– &OE; …"
2841 \override #'(replacement-alist . ()) "– &OE; …"
2845 También podemos hacer nuestros propios alias, ya sea de forma global,
2847 @lilypond[quote,verbatim]
2849 #(add-text-replacements!
2850 '(("100" . "hundred")
2851 ("dpi" . "dots per inch")))
2853 \markup "A 100 dpi."
2858 @lilypond[quote,verbatim]
2859 \markup \replace #'(("100" . "hundred")
2860 ("dpi" . "dots per inch")) "A 100 dpi."
2864 Referencia de la notación:
2865 @ref{Lista de caracteres especiales}.
2867 Archivos instalados:
2868 @file{ly/text-replacements.ly}.
2871 @node Controlar la salida
2872 @section Controlar la salida
2873 @translationof Controlling output
2876 * Extracción de fragmentos de música::
2877 * Saltar la música corregida::
2878 * Formatos de salida alternativos::
2879 * Sustituir la tipografía de la notación::
2882 @funindex clip-regions
2883 @cindex fragmentos de música
2884 @cindex música, fragmentos
2886 @node Extracción de fragmentos de música
2887 @subsection Extracción de fragmentos de música
2888 @translationof Extracting fragments of music
2890 Es posible producir en la salida uno o más fragmentos de una
2891 partitura mediante la definición de la situación explícita de la
2892 música que se quiere extraer dentro del bloque @code{\layout} del
2893 archivo de entrada, utilizando la función @code{clip-regions}, y
2894 a continuación ejecutando LilyPond con la opción
2895 @option{-dclip-systems}.
2902 (make-rhythmic-location 5 1 2)
2903 (make-rhythmic-location 7 3 4)))
2908 Este ejemplo extrae un solo fragmento del archivo de entrada
2909 @emph{comenzando} después de la duración de una blanca en el
2910 quinto compás (@code{5 1 2}) y @emph{terminando} después de la
2911 tercera negra del compás séptimo (@code{7 3 4}).
2913 Se pueden extraer fragmentos adicionales añadiendo más pares de
2914 entradas de @code{make-rhythmic-location} a la lista
2915 @code{clip-regions} dentro del bloque @code{\layout}.
2917 De forma predeterminada, cada fragmento de música se obtendrá en
2918 la salida como un archivo @code{EPS} distinto, pero también se
2919 pueden crear otros formatos como @code{PDF} o @code{PNG} si es
2920 necesario. La música extraída se obtiene en la salida como si
2921 hubiera sido literalmente @q{cortada} de la partitura original
2922 impresa, de forma que si un fragmento se extiende sobre una o más
2923 líneas, se genera un archivo de salida distinto por cada línea
2927 Referencia de la notación:
2928 @ref{El bloque layout}.
2930 Manual de utilización:
2931 @rprogram{Utilización desde la línea de órdenes}.
2935 @node Saltar la música corregida
2936 @subsection Saltar la música corregida
2937 @translationof Skipping corrected music
2939 @funindex skipTypesetting
2940 @funindex showFirstLength
2941 @funindex showLastLength
2943 Al escribir o copiar música, normalmente sólo es interesante de
2944 ver y corregir la música cercana al final (donde estamos
2945 añadiendo las notas). Para acelerar este proceso de corrección,
2946 es posible saltar la composición tipográfica de todos excepto
2947 unos pocos de los últimos compases. Esto se consigue poniendo
2950 showLastLength = R1*5
2951 \score @{ @dots{} @}
2955 en nuestro archivo fuente. Esto hará que se tracen sólo los
2956 últimos cinco compases (suponiendo un compás de 4/4) de cada una
2957 de las partituras @code{\score} del archivo de entrada. Para
2958 piezas largas, el tipografiado de únicamente una parte pequeña es
2959 con frecuencia un orden de magnitud más rápido que el de la obra
2960 completa. Si estamos trabajando sobre el principio de una
2961 partitura que ya hemos tipografiado (p.ej., para añadir una parte
2962 instrumental nueva), también puede ser útil la propiedad
2963 @code{showFirstLength}.
2965 Este mecanismo de pasar por alto partes de un partitura se puede
2966 controlar con un grano más fino mediante la propiedad
2967 @code{Score.skipTypesetting}. Cuando su valor está establecido,
2968 no se lleva a cabo ningún tipografiado en absoluto.
2970 Esta propiedad se usa también para controlar la salida hacia el
2971 archivo MIDI. Observe que pasa por alto todos los eventos,
2972 incluidos el tempo y los cambios de instrumento. Está usted
2975 @lilypond[quote,ragged-right,verbatim]
2978 \set Score.skipTypesetting = ##t
2981 \set Score.skipTypesetting = ##f
2986 En música polifónica, @code{Score.skipTypesetting} afecta a todas
2987 las voces y pentagramas, ahorrando más tiempo incluso.
2990 @node Formatos de salida alternativos
2991 @subsection Formatos de salida alternativos
2992 @translationof Alternative output formats
2994 @cindex salida de gráficos de vector escalables
2996 @cindex salida de PostScript encapsulado
2998 @cindex PostScript encapsulado, salida de
3000 Los formatos de salida predeterminados para la partitura impresa
3001 son el formato de documento portátil (PDF) y PostScript (PS).
3002 Los formatos de salida Gráficos de red portátiles (PNG),
3003 Gráficos de vector escalables (SVG) y PostScript encapsulado (EPS)
3004 también están disponibles a través de opciones de la línea de
3006 @rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
3009 @node Sustituir la tipografía de la notación
3010 @subsection Sustituir la tipografía de la notación
3011 @translationof Replacing the notation font
3013 Gonville es un conjunto de glifos alternativo a la tipografía Feta
3014 (que es parte de la tipografía Emmentaler que se usa en LilyPond).
3015 Se puede descargar de:
3018 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
3021 Aquí presentamos algunos compases de muestra tipografiados con la
3024 @c NOTE: these images are a bit big, but that's important
3025 @c for the font comparison. -gp
3026 @sourceimage{Gonville_after,15cm,,}
3028 Aquí hay unos compases de muestra tipografiados con los glifos Feta
3031 @sourceimage{Gonville_before,15cm,,}
3033 @subsubheading Instrucciones de instalación para MacOS
3035 Descargue y extraiga el archivo zip. Copie la carpeta
3036 @code{lilyfonts} a @file{@var{SHARE_DIR}/lilypond/current}; para
3037 más información, consulte @rlearning{Otras fuentes de
3038 información}. Renombre la carpeta @code{fonts} existente a
3039 @code{fonts_orig} y la carpeta @code{lilyfonts} a @code{fonts}.
3040 Para volver a la fuente Emmentaler, invierta el proceso.
3043 Manual de aprendizaje:
3044 @rlearning{Otras fuentes de información}.
3046 Referencia de la notación:
3047 @ref{La tipografía Emmentaler}.
3050 Gonville no se puede usar para tipografiar notación de @q{Música
3051 Antigua} y es probable que cualquier nuevo glifo en versiones
3052 posteriores de LilyPond no existan en la familia tipográfica
3053 Gonville. Diríjase a la página web del autor para obtener más
3054 información sobre éste y otros asuntos, entre ellos el régimen de
3055 licencias de Gonville.
3058 @node Creación de salida MIDI
3059 @section Creación de salida MIDI
3060 @translationof Creating MIDI output
3065 LilyPond puede producir archivos que siguen el estándar MIDI
3066 (Musical Instrument Digital Interface; interfaz digital para
3067 instrumentos musicales) y permitir así comprobar la música por el
3068 oído (con la ayuda de alguna aplicación o dispositivo que
3069 entienda el MIDI). La escucha de la salida MIDI también puede
3070 ser de ayuda en la localización de errores tales como notas que
3071 se han introducido incorrectamente, alteraciones omitidas y otros
3072 casos por el estilo.
3074 Los archivos MIDI no contienen sonido (como los archivos AAC, MP3
3075 o Vorbis) pero requieren software adicional para producir el
3076 sonido a partir de ellos.
3079 * Notación contemplada por el MIDI::
3080 * Notación no contemplada en el MIDI::
3082 * Control de las dinámicas del MIDI::
3083 * Uso de los instrumentos MIDI::
3084 * Uso de las repeticiones con el MIDI::
3085 * Asignación de canales MIDI::
3086 * Propiedades de contexto para efectos MIDI::
3087 * Enriquecimiento de la salida MIDI::
3088 * El script Articulate::
3091 @cindex MIDI, notación contemplada
3093 @node Notación contemplada por el MIDI
3094 @subsection Notación contemplada por el MIDI
3095 @translationof Supported notation for MIDI
3097 Se puede usar la notación musical siguiente con las posibilidades
3098 predeterminadas de LilyPond para producir salida MIDI:
3101 @item Marcas de respiración
3102 @item Acordes introducidos como nombres de acorde
3103 @item Crescendos y decrescendos sobre más de una nota. El volumen se altera de forma lineal entre los dos extremos
3104 @item Indicadores dinámicos desde @code{ppppp} hasta @code{fffff}, incluyendo @code{mp}, @code{mf} y @code{sf}
3105 @item Microtonos, pero @emph{no} acordes microtonales. Se necesita también un reproductor de MIDI capaz de ejecutar eventos de rueda de tono.
3106 @item Letra de las canciones
3107 @item Altura de las notas
3108 @item Ritmo introducido como duraciones de las notas, incluidos los grupos de valoración especial como los tresillos
3109 @item Articulaciones @q{sencillas}; picado, staccato, acento, marcato y portato
3110 @item Cambios de tempo introducidos con la función @code{\tempo}
3111 @item Ligaduras de unión
3112 @item Trémolos que @emph{not} se hayan introducido como un valor del tipo @q{@code{:}[@var{número}]}
3115 También se pueden controlar el panorama, el balance, la expresión
3116 y los efectos de reverberación y chorus mediante el
3117 establecimiento de propiedades de contexto, véase
3118 @ref{Propiedades de contexto para efectos MIDI}.
3120 Si se combina con el script @file{articulate}, es posible
3121 producir la salida por el MIDI de los siguientes elementos
3122 adicionales de notación musical:
3125 @item Appoggiaturas (apoyaturas). Se les da la mitad de la duración de la nota siguiente (sin tener en cuenta los puntillos). Por ejemplo:
3128 \appoggiatura c8 d2.
3132 El Do toma la duración de una negra.
3134 @item Notas y grupos de adorno (mordentes de una nota, trinos, grupetos circulares, etc.)
3135 @item Rallentando, accelerando, ritardando y a tempo
3136 @item Ligaduras de expresión y de fraseo
3141 Véase @ref{Enriquecimiento de la salida MIDI}.
3143 @cindex MIDI, notación no contemplada
3145 @node Notación no contemplada en el MIDI
3146 @subsection Notación no contemplada en el MIDI
3147 @translationof Unsupported notation for MIDI
3149 Los siguientes elementos de notación musical no se pueden hacer
3153 @item Articulaciones distintas al picado, staccato, acento, marcato y portato
3154 @item Crescendos y decrescendos sobre una @emph{sola} nota
3158 @item Caídas y elevaciones
3159 @item Acordes microtonales
3160 @item Duraciones introducidas como anotaciones, p.ej. el swing
3161 @item Cambios de tempo sin @code{\tempo} (p.ej., introducidas como anotaciones)
3162 @item Trémolos que @emph{se introducen} con la notación de la forma @q{@code{:}[@var{número}]}
3166 @node El bloque MIDI
3167 @subsection El bloque MIDI
3168 @translationof The MIDI block
3172 Para crear un archivo de salida MIDI a partir de un archivo de
3173 entrada de LilyPond, introduzca un bloque @code{\midi}, que puede
3174 estar vacío, dentro del bloque @code{\score}:
3178 @var{@dots{} música @dots{}}
3184 @warning{Un bloque @code{@bs{}score} que, además de la música,
3185 contiene solamente un bloque @code{@bs{}midi} (o sea, @emph{sin}
3186 el bloque @code{@bs{}layout}), solo produce archivos de salida
3187 MIDI; no se imprime ninguna notación musical.}
3189 La extensión predeterminada para los archivos de salida
3190 (@code{.midi}) se puede cambiar usando la opción
3191 @code{-dmidi-extension} con la instrucción @code{lilypond}:
3194 lilypond -dmidi-extension=mid Archivo.ly
3197 Como alternativa, puede añadirse la siguiente expresión de Scheme
3198 antes del comienzo de uno de los bloques @code{\book},
3199 @code{\bookpart} o @code{\score}. Véase @ref{Estructura del archivo}.
3202 #(ly:set-option 'midi-extension "mid")
3206 Referencia de la notación:
3207 @ref{Estructura del archivo},
3208 @ref{Crear metadatos en los archivos de salida}.
3210 Archivos instalados:
3211 @file{scm/midi.scm}.
3214 Están disponibles 15 canales MIDI y un canal adicional (el número
3215 10) para la percusión. Los pentagramas se asignan a los canales
3216 por orden, de forma que una partitura que contenga más de 15
3217 pentagramas da como resultado que los pentagramas adicionales
3218 comparten (pero no sobreescriben) el mismo canal MIDI. Esto
3219 puede ser problemático si los pentagramas que comparten canal
3220 tienen establecidas propiedades MIDI, basadas en canal, en mutuo
3221 conflicto (como distintos instrumentos MIDI).
3224 @node Control de las dinámicas del MIDI
3225 @subsection Control de las dinámicas del MIDI
3226 @translationof Controlling MIDI dynamics
3228 Es posible controlar el volumen MIDI general, el volumen relativo
3229 de las indicaciones de matiz dinámico y el volumen relativo de
3230 los distintos instrumentos.
3232 Las indicaciones matiz dinámico se traducen automáticamente a
3233 niveles de volumen dentro del rango de volúmenes MIDI disponible
3234 mientras que los crescendos y decrescendos varían el volumen
3235 linealmente entre sus dos extremos. Es posible controlar el
3236 volumen relativo de las indicaciones de matiz dinámico, y el
3237 volumen general de los diferentes instrumentos.
3240 * Indicaciones de matiz dinámico en el MIDI::
3241 * Establecimiento del volumen MIDI::
3242 * Establecimiento de las propiedades del bloque MIDI::
3245 @cindex MIDI, volumen
3246 @cindex MIDI, ecualización
3247 @cindex MIDI, matices dinámicos
3248 @cindex dinámica del MIDI
3251 @node Indicaciones de matiz dinámico en el MIDI
3252 @unnumberedsubsubsec Indicaciones de matiz dinámico en el MIDI
3253 @translationof Dynamic marks in MIDI
3255 Solo las marcas de dinámica desde @code{ppppp} hasta
3256 @code{fffff}, incluidos @code{mp}, @code{mf} y @code{sf} tienen
3257 valores asignados. Este valor se aplica a continuación al valor
3258 del rango de volumen MIDI general para obtener el volumen final
3259 que se incluye en la salida MIDI para esa indicación de matiz
3260 dinámico en particular. Las fracciones predeterminadas varían
3261 desde 0.25 para el @notation{ppppp} hasta 0.95 para el
3262 @notation{fffff}. El conjunto completo de las indicaciones de
3263 matiz dinámico pueden verse en el archivo @file{scm/midi.scm}.
3267 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3268 {creating-custom-dynamics-in-midi-output.ly}
3270 Archivos instalados:
3271 @file{ly/script-init.ly}
3272 @file{scm/midi.scm}.
3274 Fragmentos de código:
3277 Referencia de funcionamiento interno:
3278 @rinternals{Dynamic_performer}.
3281 @node Establecimiento del volumen MIDI
3282 @unnumberedsubsubsec Establecimiento del volumen MIDI
3283 @translationof Setting MIDI volume
3285 Los volúmenes generales mínimo y máximo de las indicaciones de
3286 matiz dinámico MIDI se controlan estableciendo las propiedades
3287 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel
3288 del bloque @code{Score}. Estas propiedades tienen efecto
3289 solamente al comienzo de una vos y sobre las indicaciones
3290 dinámicas. La fracción que corresponde a cada indicación
3291 dinámica se modifica con esta fórmula:
3294 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
3297 En el ejemplo siguiente, el rango dinámico del volumen MIDI
3298 general se limita al intervalo entre @code{0.2} y @code{0.5}.
3304 \set Staff.midiInstrument = #"flute"
3305 @var{@dots{} music @dots{}}
3308 \set Staff.midiInstrument = #"clarinet"
3309 @var{@dots{} music @dots{}}
3315 midiMinimumVolume = #0.2
3316 midiMaximumVolume = #0.5
3322 Se puede obtener una ecualización sencilla de instrumentos MIDI
3323 estableciendo las propiedades @code{midiMinimumVolume} y
3324 @code{midiMaximumVolume} dentro del contexto @code{Staff}.
3329 \set Staff.midiInstrument = #"flute"
3330 \set Staff.midiMinimumVolume = #0.7
3331 \set Staff.midiMaximumVolume = #0.9
3332 @var{@dots{} music @dots{}}
3338 Para partituras con más de un pentagrama y más de un instrumento
3339 MIDI, se pueden fijar individualmente los volúmenes relativos de
3346 \set Staff.midiInstrument = #"flute"
3347 \set Staff.midiMinimumVolume = #0.7
3348 \set Staff.midiMaximumVolume = #0.9
3349 @var{@dots{} music @dots{}}
3352 \set Staff.midiInstrument = #"clarinet"
3353 \set Staff.midiMinimumVolume = #0.3
3354 \set Staff.midiMaximumVolume = #0.6
3355 @var{@dots{} music @dots{}}
3362 En este ejemplo el volumen del clarinete se reduce de forma
3363 relativa al volumen de la flauta.
3365 Si no se establecen estas propiedades de volumen, LilyPond aún
3366 aplica un @q{pequeño grado} de ecualización a ciertos
3367 instrumentos. Véase @file{scm/midi.scm}.
3369 Archivos instalados:
3370 @file{scm/midi.scm}.
3373 Referencia de la notación:
3374 @ref{Disposición de la partitura}.
3376 Referencia de funcionamiento interno:
3377 @rinternals{Dynamic_performer}.
3380 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3381 {replacing-default-midi-instrument-equalization.ly}
3384 Los cambios en el volumen del MIDI solamente tienen lugar en el
3385 comienzo de una nota, por lo que los crescendos y decrescendos no
3386 afectan al volumen de una sola nota.
3388 @node Establecimiento de las propiedades del bloque MIDI
3389 @unnumberedsubsubsec Establecimiento de las propiedades del bloque MIDI
3390 @translationof Setting MIDI block properties
3392 El bloque @code{\midi} puede contener distintas disposiciones de
3393 los contextos, definiciones de contexto nuevas o código que fija
3394 los valores de ciertas propiedades.
3398 @var{@dots{} music @dots{}}
3405 Aquí, el tempo se establece a 72 pulsos de negra por minuto. La
3406 indicación de tempo dentro del bloque @code{\midi} no aparece en
3407 la partitura impresa. Aunque cualquier otra indicación de
3408 @code{\tempo} que se especifique dentro del bloque @code{\score}
3409 también se reflejará en la salida MIDI.
3411 Dentro de un bloque @code{\midi}, la instrucción @code{\tempo}
3412 está estableciendo propiedades durante la interpretación de la
3413 música y en el contexto de las definiciones de salida; así, se
3414 interpreta @emph{como si} fuera una modificación de contesto.
3416 @cindex MIDI, definiciones de contexto
3417 @cindex contexto, definiciones con MIDI
3419 Las definiciones de contexto siguen la misma sintaxis que las del
3420 bloque @code{\layout}:
3424 @var{@dots{} music @dots{}}
3428 \remove "Dynamic_performer"
3434 Este ejemplo suprime el efecto de las indicaciones dinámicas
3435 sobre la salida MIDI. Nota: los módulos de traducción de
3436 LilyPond usados para el sonido se llaman @q{performers}.
3439 Manual de aprendizaje:
3440 @rlearning{Otras fuentes de información}.
3442 Referencia de la notación:
3444 @ref{Disposición de la partitura}.
3446 Archivos instalados:
3447 @file{ly/performer-init.ly}.
3449 Fragmentos de código:
3452 Referencia de funcionamiento interno:
3453 @rinternals{Dynamic_performer}.
3456 Ciertos reproductores de MIDI no siempre maneja correctamente los
3457 cambios de tempo en la salida MIDI.
3459 Los cambios efectuados al @code{midiInstrument}, así como ciertas
3460 opciones MIDI, al @emph{comienzo} de un pentagrama pueden
3461 aparecer dos veces en la salida MIDI.
3465 @node Uso de los instrumentos MIDI
3466 @subsection Uso de los instrumentos MIDI
3467 @translationof Using MIDI instruments
3469 Los instrumentos MIDI se establecen usando la propiedad
3470 @code{midiInstrument} dentro de un contexto @code{Staff}.
3475 \set Staff.midiInstrument = #"glockenspiel"
3476 @var{@dots{} music @dots{}}
3486 \new Staff \with @{midiInstrument = #"cello"@} @{
3487 @var{@dots{} music @dots{}}
3493 Si el instrumento elegido no coincide exactamente con uno de los
3494 instrumentos de la lista de la sección @q{instrumentos MIDI}, se
3495 usará el instrumento Piano de Cola (@code{"acoustic grand"}).
3496 Véase @ref{Instrumentos MIDI}.
3499 Manual de aprendizaje:
3500 @rlearning{Otras fuentes de información}.
3502 Referencia de la notación:
3503 @ref{Instrumentos MIDI},
3504 @ref{Disposición de la partitura}.
3506 Archivos instalados:
3507 @file{scm/midi.scm}.
3510 Los instrumentos de percusión cuya notación está en un contexto
3511 @code{DrumStaff} se encontrará a la salida, correctamente, sobre
3512 el canal MIDI número@tie{}10 pero ciertos instrumentos de
3513 percusión afinada como el xilófono, el vibráfono o los timbales,
3514 se tratan como instrumentos @qq{normales}, de forma que la música
3515 de éstos se debe introducir en un contexto @code{Staff} (no
3516 @code{DrumStaff}) para obtener una salida MIDI correcta. Hay una
3517 lista completa de entradas de los @code{sets de percusión del
3518 canal 10} en el archivo @file{scm/midi.scm}. Véase
3519 @rlearning{Otras fuentes de información}.
3522 @node Uso de las repeticiones con el MIDI
3523 @subsection Uso de las repeticiones con el MIDI
3524 @translationof Using repeats with MIDI
3526 @cindex repeticiones en MIDI
3527 @cindex MIDI con repeticiones
3528 @funindex \unfoldRepeats
3530 Las repeticiones se pueden representar en la salida MIDI
3531 aplicando la instrucción @code{\unfoldRepeats}.
3536 \repeat tremolo 8 @{ c'32 e' @}
3537 \repeat percent 2 @{ c''8 d'' @}
3538 \repeat volta 2 @{ c'4 d' e' f' @}
3548 Para restringir el efecto de @code{\unfoldRepeats} a la salida
3549 MIDI únicamente, y al mismo tiempo genera partituras imprimibles,
3550 es necesario hacer @emph{dos} bloques @code{\score}: uno para el
3551 MIDI (con las repeticiones desplegadas) y otro para la notación
3552 (con repeticiones de primera y segunda vez, trémolos y del tipo
3557 @var{@dots{} music @dots{}}
3562 @var{@dots{} music @dots{}}
3568 Si se usan varias voces, cada una de ellas debe contener las
3569 repeticiones completamente desplegadas para poder obtener una
3570 salida MIDI correcta.
3573 Referencia de la notación:
3577 @node Asignación de canales MIDI
3578 @subsection Asignación de canales MIDI
3579 @translationof MIDI channel mapping
3581 @cindex MIDI, canales
3582 @cindex MIDI, pistas
3583 @funindex midiChannelMapping
3585 Cuando se está generando un archivo MIDI de una partitura,
3586 LilyPond asigna cada nota de la partitura automáticamente a un
3587 canal MIDI, aquel en que se tocaría cuando se envía hacia un
3588 dispositivo MIDI. Un canal MIDI tiene una cierta cantidad de
3589 controles disponibles para seleccionar, por ejemplo, el
3590 instrumento que usar para reproducir las notas en ese canal, u
3591 ordenar al dispositivo MIDI que aplique diversos efectos al
3592 sonido producido sobre el canal. En todo momento, cada control
3593 de un canal MIDI solo puede tener asignado un valor único (que
3594 sin embargo se puede modificar, por ejemplo, para cambiar a otro
3595 instrumento en mitad de una partitura).
3597 El estándar MIDI contempla solamente 16 canales por dispositivo
3598 MIDI. Este límite en el número de canales limita también el
3599 número de instrumentos diferentes que pueden estar tocando al
3602 LilyPond crea pistas MIDI separadas para cada pentagrama (o
3603 instrumento o voz, según el valor de
3604 @code{Score.midiChannelMapping}), y también para cada contexto de
3605 letra. No hay un límite para el número de pistas.
3607 Para solventar el número limitado de canales MIDI, LilyPond
3608 contempla algunos modos diferentes para la asignación de canales
3609 MIDI, que se seleccionan usando la propiedad de contexto
3610 @code{Score.midiChannelMapping}. En cada caso, si se necesitan
3611 más canales MIDI que el límite, los números de canal asignados
3612 vuelven a contar desde cero, causando posiblemente una asignación
3613 incorrecta de instrumento a algunas notas. Esta propiedad de
3614 contexto se puede fijar a uno de los siguientes valores:
3620 Reservar un canal MIDI distinto para cada uno de los pentagramas
3621 de la partitura (es el ajuste predeterminado). Todas las notas
3622 de todas las voces comparten el canal MIDI del pentagrama que las
3623 encierra, y todas se codifican dentro de la misma pista MIDI.
3625 El límite de 16 canales se aplica al número total de contextos de
3626 pentagrama y de letra, incluso aunque las letras del MIDI no
3627 consumen un canal MIDI.
3629 @item @code{'instrument}
3631 Reservar un canal MIDI distinto a cada uno de los instrumentos
3632 diferentes especificados en la partitura. Esto significa que
3633 todas las notas reproducidas con el mismo instrumento MIDI
3634 comparten el mismo canal MIDI (y la misma pista), incluso aunque
3635 las notas provengan de diferentes voces o pentagramas.
3637 En este caso los contextos de letra no cuentan para el límite de
3638 16 canales MIDI (ya que no se asignan a un instrumento MIDI), de
3639 forma que este ajuste puede permitir una mejor distribución de
3640 los canales MIDI cuando el número de contextos de pentagrama y de
3641 letra en la partitura excede la cantidad de 16.
3645 Reservar un canal MIDI distinto a cada voz de la partitura que
3646 tenga un nombre único entre las voces de su pentagrama
3647 circundante. Las voces de los distintos pentagramas siempre se
3648 asignan a distintos canales MIDI pero dos voces cualesquiera
3649 contenidas dentro del mismo pentagrama comparten el mismo canal
3650 MIDI sin tienen el mismo nombre. A causa de que
3651 @code{midiInstrument} y los diversos controles MIDI para los
3652 efectos son propiedades del contexto de pentagrama, no se pueden
3653 fijar independientemente para cada voz. La primera voz se
3654 reproduce con el instrumento y los efectos especificados para el
3655 pentagrama, y las voces con un nombre distinto de la primera
3656 recibirán el instrumento y los efectos predeterminados.
3658 Nota: se pueden asignar distintos instrumentos y/o efectos a
3659 varias voces dentro del mismo pentagrama moviendo el
3660 @code{Staff_performer} del contexto @code{Staff} al contexto
3661 @code{Voice}, y dejando que @code{midiChannelMapping} conserve su
3662 valor predeterminado de @code{'staff} o se fije al valor
3663 @code{'instrument}; véase el fragmento de código siguiente.
3667 Por ejemplo, la asignación predeterminada de canal MIDI de una
3668 partitura puede cambiarse al ajuste @code{'instrument} como se
3669 muestra a continuación:
3677 midiChannelMapping = #'instrument
3684 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3685 {changing-midi-output-to-one-channel-per-voice.ly}
3688 @node Propiedades de contexto para efectos MIDI
3689 @subsection Propiedades de contexto para efectos MIDI
3690 @translationof Context properties for MIDI effects
3692 @cindex Efectos en MIDI
3693 @cindex Panorama en MIDI
3694 @cindex Balance en MIDI
3695 @cindex Estéreo, balance en MIDI
3696 @cindex Expresión en MIDI
3697 @cindex Reverberación en MIDI
3698 @cindex Chorus en MIDI
3699 @funindex midiPanPosition
3700 @funindex midiBalance
3701 @funindex midiExpression
3702 @funindex midiReverbLevel
3703 @funindex midiChorusLevel
3705 Se pueden usar las siguientes propiedades de contexto para
3706 aplicar diversos efectos MIDI a las notas que se reproducen sobre
3707 el canal MIDI asociado con el pentagrama, instrumento MIDI o voz
3708 actual (dependiendo del valor de la propiedad de contexto
3709 @code{Score.midiChannelMapping} y del contexto en que está
3710 situado el @code{Staff_performer}; véase @ref{Asignación de
3713 Los cambios en estas propiedades de contexto afectan a todas las
3714 notas que se reproducen sobre el canal después del cambio, aunque
3715 algunos de los efectos se pueden incluso aplicar también a notas
3716 que están ya sonando en ese momento (dependiendo de la
3717 implementación del dispositivo de salida MIDI).
3719 Se contemplan las siguientes propiedades de contexto:
3723 @item @code{Staff.midiPanPosition}
3725 La posición de panorama controla cómo se distribuye el sonido de
3726 un canal MIDI entre las salidas estéreo izquierda y derecha. La
3727 propiedad de contexto acepta un número entre -1.0 (@code{#LEFT})
3728 y 1.0 (@code{#RIGHT}); el valor -1.0 pone toda la potencia de
3729 sonido en la salida estéreo izquierda (dejando la salida derecha
3730 en completo silencio), el valor 0.0 (@code{#CENTER}) distribuye
3731 el sonido por igual entre las salidas estéreo izquierda y
3732 derecha, y el valor 1.0 mueve todo el sonido a la salida estéreo
3733 derecha. Los valores entre -1.0 y 1.0 se pueden usar para
3734 obtener distribuciones mezcladas entre las salidas estéreo
3735 izquierda y derecha.
3737 @item @code{Staff.midiBalance}
3739 Equilibrio estéreo de un canal MIDI. De forma similar a la
3740 posición de panorama esta propiedad de contexto acepta un número
3741 entre -1.0 (@code{#LEFT}) y 1.0 (@code{#RIGHT}). Varía el
3742 volumen relativo que se envía a los dos altavoces estéreo sin
3743 afectar a la distribución de las propias señales estéreo.
3745 @item @code{Staff.midiExpression}
3747 Nivel de expresión (como una fracción del nivel máximo
3748 disponible) que se aplica a un canal MIDI. Un dispositivo MIDI
3749 combina el nivel de expresión del canal MIDI con el nivel actual
3750 de dinámica de una voz (controlado mediante las instrucciones de
3751 dinámica como @code{\p} o @code{\ff}) para obtener el volumen
3752 total de cada nota dentro de la voz. El control de expresión se
3753 puede usar, por ejemplo, para implementar efectos de crescendo y
3754 decrescendo sobre notas mantenidas (algo que LilyPond no
3755 contempla de forma automática).
3757 @c Issue 4059 contains an attached snippet which shows how this might
3758 @c be done, but this is too large and complex for the NR, even as a
3759 @c referenced snippet. It could be added to the LSR.
3761 El rango de los niveles de expresión se extiende desde 0.0
3762 (ninguna expresión, lo que significa un volumen nulo) hasta 1.0
3763 (expresión al máximo).
3765 @item @code{Staff.midiReverbLevel}
3767 El nivel de reverberación (cono una fracción del máximo nivel
3768 disponible) que se aplica a un canal MIDI. Esta propiedad acepta
3769 números entre 0.0 (sin reverberación) y 1.0 (efecto máximo).
3771 @item @code{Staff.midiChorusLevel}
3773 Nivel del efecto Chorus (como una fracción del máximo nivel
3774 disponible) que se aplica a un canal MIDI. Esta propiedad acepta
3775 números entre 0.0 (sin efecto de chorus) y 1.0 (efecto al
3783 Dado que los archivos MIDI no contienen en realidad ninguna
3784 información sonora, los cambios en estas propiedades de contexto
3785 solamente se convierten en peticiones para que cambien los
3786 controles de canal MIDI dentro de los archivos MIDI emitidos. Si
3787 un dispositivo MIDI determinado (como un reproductor MIDI por
3788 software) puede de hecho manejar cualquiera de estas solicitudes
3789 de un archivo MIDI, es algo que depende totalmente de la
3790 implementación del mismo: un dispositivo podría optar por ignorar
3791 algunas o todas estas solicitudes. Asimismo, la forma en que un
3792 dispositivo MIDI interpreta los diferentes valores de estos
3793 controles (generalmente, el estándar MIDI determina el
3794 comportamiento solamente en los puntos extremos del rango de
3795 valores disponibles para cada control), y el hecho de si un
3796 cambio en el valor de un control afecta a las notas que ya se
3797 están reproduciendo sobre ese canal MIDI o no, también son
3798 aspectos específicos de la implementación del dispositivo MIDI.
3800 Al generar archivos MIDI, LilyPond sencillamente convierte de
3801 forma lineal los valores fraccionarios dentro de cada rango (7
3802 bits, o 14 bits para los controles de canal MIDI que admiten
3803 resolución fina) en valores enteros dentro del rango
3804 correspondiente (de 0 a 127 o de 0 a 32767, respectivamente),
3805 redondeando los valores fraccionarios hacia el entero más próximo
3806 en dirección opuesta al cero. Los valores enteros convertidos se
3807 almacenan tal cual en el archivo MIDI generado. Consulte la
3808 documentación de su dispositivo MIDI para ver información acerca
3809 de cómo interpreta estos valores.
3812 @node Enriquecimiento de la salida MIDI
3813 @subsection Enriquecimiento de la salida MIDI
3814 @translationof Enhancing MIDI output
3817 * El script Articulate::
3820 La salida MIDI predeterminada es muy básica, pero se puede
3821 mejorar mediante la selección de los instrumentos MIDI las
3822 propiedades del bloque @code{\midi} y/o usando el script
3825 @cindex instrumentos, nombres
3826 @cindex MIDI, instrumentos
3827 @cindex articulate, script
3828 @cindex articulate.ly
3829 @funindex Staff.midiInstrument
3832 @node El script Articulate
3833 @subsection El script Articulate
3834 @translationof The Articulate script
3836 Para utilizar el script Articulate, tenemos que incluirlo al
3837 principio de nuestro archivo de entrada:
3840 \include "articulate.ly"
3843 El script crea una salida MIDI en que las notas tienen una
3844 duración ajustada en el tiempo de forma que se correspondan con
3845 una serie de indicaciones de articulación y de tempo. Sin
3846 embargo, la salida tipografiada también se altera para reflejar
3847 literalmente el contenido de la salida MIDI.
3852 @var{@dots{} music @dots{}}
3858 La instrucción @code{\articulate} habilita el procesado de las
3859 abreviaturas como trinos y mordentes de varias notas. En el
3860 propio script puede verse una lista completa de los elementos que
3861 están previstos. Véase @file{ly/articulate.ly}.
3864 Manual de aprendizaje:
3865 @rlearning{Otras fuentes de información}.
3867 Referencia de la notación:
3870 Archivos instalados:
3871 @file{ly/articulate.ly}.
3873 @warning{El script @file{articulate} puede acortar los acordes,
3874 lo que podría no ser adecuado para algunos tipos de instrumento,
3875 como el órgano. Las notas que no tienen ninguna articulación
3876 también se pueden acortar; así, para contener el alcance
3877 de este efecto limite
3878 el uso de de la función @code{\articulate} a segmentos de música
3879 más breves o modifique los valores de las variables definidas
3880 dentro del script @file{articulate}
3881 para compensar el efecto de acortamiento de las notas.}
3885 @node Extraer información musical
3886 @section Extraer información musical
3887 @translationof Extracting musical information
3889 Además de crear un resultado visual y MIDI, LilyPond es capaz de
3890 presentar información musical en forma de texto.
3893 * Impresión del código de notación de LilyPond::
3894 * Impresión de las expresiones musicales de Scheme::
3895 * Guardar los eventos musicales en un archivo::
3899 @node Impresión del código de notación de LilyPond
3900 @subsection Displaying LilyPond notation
3901 @translationof Displaying LilyPond notation
3903 @funindex \displayLilyMusic
3904 La impresión textual de una expresión musical en notación de
3905 LilyPond puede hacerse con la función musical
3906 @code{\displayLilyMusic}. Para ver el resultado, lo más usual es
3907 llamar a LilyPond mediante la línea de órdenes. Por ejemplo,
3911 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3915 imprime lo siguiente:
3918 @{ a,4 cis e fis g @}
3921 De forma predeterminada, LilyPond imprime estos mensajes en la
3922 consola junto al resto de los mensajes de la compilación de
3923 LilyPond. Para discernir entre estos mensajes y guardar el
3924 resultado de @code{\displayLilyMusic}, redireccione la salida
3928 lilypond archivo.ly >resultado.txt
3932 Observe que LilyPond no se limita a mostrar la expresión musical,
3933 sino que también la interpreta (porque @code{\displayLilyMusic}
3934 la devuelve además de mostrarla). Simplemente inserte
3935 @code{\displayLilyMusic} dentro de
3936 la música existente con el objeto de obtener información sobre
3939 Para interpretar y mostrar una sección de música en la consola,
3940 y al mismo tiempo suprimirla del archivo de salida,
3941 use la instrucción @code{\void}.
3945 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3951 @node Impresión de las expresiones musicales de Scheme
3952 @subsection Impresión de las expresiones musicales de Scheme
3953 @translationof Displaying scheme music expressions
3955 Véase @rextend{Presentación de las expresiones musicales}.
3958 @node Guardar los eventos musicales en un archivo
3959 @subsection Guardar los eventos musicales en un archivo
3960 @translationof Saving music events to a file
3962 Los eventos musicales se pueden guardar en un archivo pentagrama
3963 a pentagrama mediante la inclusión de un archivo en nuestra
3964 partitura principal.
3967 \include "event-listener.ly"
3970 De esta forma se crean uno o más archivos llamados
3971 @file{FILENAME-STAFFNAME.notes} ó
3972 @file{FILENAME-unnamed-staff.notes} para cada pentagrama.
3973 Observe que si tiene más de un pentagrama sin nombre, los eventos
3974 de todos los pentagramas se mezclarán entre sí dentro del mismo
3975 archivo. El resultado tiene el aspecto siguiente:
3978 0.000 note 57 4 p-c 2 12
3980 0.250 note 62 4 p-c 7 12
3981 0.500 note 66 8 p-c 9 12
3982 0.625 note 69 8 p-c 14 12
3987 La sintaxis consiste en una línea delimitada por caracteres de
3988 tabulación, con dos campos fijos en cada línea seguidos de
3989 parámetros opcionales.
3992 @var{tiempo} @var{tipo} @var{@dots{}parámetros@dots{}}
3995 Esta información se puede leer fácilmente por parte de otros
3996 programas como guiones de Python, y pueden ser muy útiles para
3997 aquellos investigadores que desean realizar un análisis musical o
3998 hacer experimentos de reproducción con LilyPond.
4001 No todos los eventos musicales de lilypond están contemplados por
4002 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
4003 concepto} bien realizada. Si algunos eventos que quiere ver no
4004 aparecen incluidos, copie @file{event-listener.ly} en su carpeta
4005 de lilypond y modifique el archivo de forma que produzca la
4006 información que desea.