1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 4c31c117565b1c7dd78e606fceb7cba354f2859a
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 de inicio
409 @file{../scm/lily.scm}.
412 Un bloque @code{\book} combina lógicamente varios movimientos (es
413 decir, varios bloques @code{\score}) en un solo documento. Si
414 hay varias partituras @code{\score}, se crea un solo archivo de
415 salida para cada bloque @code{\book}, en el que se concatenan
416 todos los movimientos correspondientes. La única razón para
417 especificar explícitamente bloques @code{\book} en un archivo de
418 entrada @file{.ly} es si queremos crear varios archivos de salida
419 a partir de un único archivo de entrada. Una excepción se da
420 dentro de los documentos de lilypond-book, en los que tenemos que
421 escribir explícitamente un bloque @code{\book} si queremos tener
422 más de una única partitura @code{\score} o marcado @code{\markup}
423 en el mismo ejemplo. Se puede cambiar este comportamiento
424 estableciendo el valor de la variable
425 @code{toplevel-book-handler} en el nivel superior. El
426 @emph{handler} predeterminado se define en el archivo de inicio
427 @file{../scm/lily.scm}.
430 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
431 partes, utilizando bloques @code{\bookpart}, con objeto de
432 facilitar la inserción de saltos de página o usar distintos
433 ajustes de @code{\paper} en las distintas partes.
436 Una expresión musical compuesta, como
441 Esto añade la pieza al @code{\score} y la conforma dentro de un
442 libro único junto a todas las demás partituras @code{\score} y
443 expresiones musicales del nivel superior. En otras palabras, un
444 archivo que contiene sólo la expresión musical anterior se
462 Se puede cambiar este comportamiento estableciendo el valor de la
463 variable @code{toplevel-music-handler} en el nivel más alto. El
464 @emph{handler} predeterminado se define en el archivo de inicio
465 @file{../scm/lily.scm}.
468 Un texto de marcado, por ejemplo una estrofa
471 2. Estrofa dos, línea uno
475 Los textos de marcado se colocan encima, en medio o debajo de las
476 partituras o expresiones musicales, según donde aparezcan
484 fulano = @{ c4 d e d @}
487 Esto se puede utilizar más tarde en el archivo escribiendo
488 @code{\fulano}. El nombre de las variables ha de ser
489 exclusivamente alfabético; sin números, guiones ni barras bajas.
493 El ejemplo siguiente muestra tres cosas que se pueden introducir
494 en el nivel superior:
498 % No justificar la salida
509 En cualquier punto del archivo se pueden introducir cualquiera de
510 las instrucciones léxicas siguientes:
513 @item @code{\version}
514 @item @code{\include}
515 @item @code{\sourcefilename}
516 @item @code{\sourcefileline}
517 @item Un comentario de una línea, determinado por un símbolo @code{%}
521 Un comentario de varias líneas, delimitado por @code{%@{ @dots{}
526 @cindex espacios en blanco
528 Por lo general se ignoran los espacios entre elementos del flujo
529 de entrada, y se pueden omitir o aumentar tranquilamente para
530 mejorar la legibilidad. Sin embargo, los espacios se deben
531 utilizar siempre para evitar errores, en las siguientes
536 @item Alrededor de todas y cada una de las llaves curvas
537 de apertura y cierre.
539 @item A continuación de las instrucciones y variables, es decir,
540 todos los elementos que comienzan con un signo @code{\} de barra
543 @item A continuación de todo elemento que se deba interpretar
544 como expresión de Scheme, es decir, todo elemento que comience
545 por un signo@tie{}@code{#}.
547 @item Para separar los elementos de una expresión de Scheme.
549 @item Dentro de @code{lyricmode} antes y después de las instrucciones
550 @code{\set} y @code{\override}.
555 Manual de aprendizaje:
556 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
558 Referencia de la notación:
559 @ref{Explicación de los títulos},
560 @ref{El bloque layout,,El bloque @code{@bs{}layout}}.
563 @node Títulos y encabezamientos
564 @section Títulos y encabezamientos
565 @translationof Titles and headers
568 @cindex encabezamientos
569 @cindex pies de página
571 Casi toda la música impresa tiene un título y el nombre del
572 compositor; ciertas piezas tienen mucha más información.
575 * Crear títulos encabezamientos y pies de página::
576 * Títulos encabezamientos y pies de página personalizados::
577 * Creación de metadatos de PDF::
578 * Crear notas al pie::
579 * Referencia a números de página::
584 @node Crear títulos encabezamientos y pies de página
585 @subsection Crear títulos, encabezamientos y pies de página
586 @translationof Creating titles headers and footers
589 * Explicación de los títulos::
590 * Presentación predeterminada de los títulos de partes de libro y partitura::
591 * Disposición predeterminada de las cabeceras y pies de página::
595 @node Explicación de los títulos
596 @unnumberedsubsubsec Explicación de los títulos
597 @translationof Titles explained
599 Cada bloque @code{\book} de un solo archivo de entrada produce un
600 archivo de salida distinto, véase @ref{Estructura del archivo}.
601 Dentro de cada archivo de salida están disponibles tres tipos de
602 zonas para títulos: @emph{Títulos de libro} al principio de cada
603 libro, @emph{Títulos de parte de libro} al principio de cada
604 parte de un libro y @emph{Títulos de partitura} al comienzo de
607 Los valores de los campos para encabezamientos tales como
608 @code{title} (para el título) y @code{composer} (para el autor)
609 se establecen en bloques @code{\header} (para ver la sintaxis de
610 los bloques @code{\header} y una lista completa de los campos
611 disponibles de forma predeterminada, consulte @ref{Presentación
612 predeterminada de los títulos de partes de libro y partitura}).
613 Tanto los títulos de libro como los títulos de parte de libro y
614 los títulos de partitura pueden contener los mismos campos,
615 aunque de forma predeterminada los campos de los títulos de
616 partitura se limitan a @code{piece} (pieza) y @code{opus}.
618 Los bloques @code{\header} se pueden situar en cuatro lugares
619 distintos para formar una jerarquía descendente de bloques
625 Al principio del archivo de entrada, antes de cualquier otro bloque
626 @code{\book}, @code{\bookpart} o @code{\score}.
629 Dentro de un bloque @code{\book} pero fuera de los bloques
630 @code{\bookpart} y @code{\score} que están dentro de ese libro.
633 Dentro de un bloque @code{\bookpart} pero fuera de cualquier bloque
634 @code{\score} dentro de dicha parte de libro.
637 Después de la expresión musical de un bloque @code{\score}.
641 Los valores de los campos se filtran a través de esta jerarquía,
642 persistiendo aquellos que se establecen más arriba a no ser que
643 se sobreescriban por un valor establecido más abajo en la
649 El título de un libro deriva de los campos establecidos al
650 principio del archivo de entrada, modificado por campos
651 establecidos en el bloque @code{\book}. Los campos resultantes
652 se usan para imprimir el título de libro para dicho libro,
653 siempre y cuando haya otro material que genere una página al
654 comienzo del libro, antes de la primera parte de libro. Es
655 suficiente una sola instrucción @code{\pageBreak}.
658 Un título de parte de libro se deriva de los campos fijados al
659 principio del archivo de entrada, modificado por los campos
660 establecidos dentro del bloque @code{\book}, y posteriormente
661 modificado por los campos que se fijan dentro del bloque
662 @code{\bookpart}. Los valores resultantes se usan para imprimir
663 el título de parte de libro para esa parte.
666 Un título de partitura se deriva de los campos que se fijan al
667 principio del archivo de entrada, modificados por los campos
668 fijados dentro del bloque @code{\book}, posteriormente
669 modificados por los campos que se fijan dentro del bloque
670 @code{\bookpart} y finalmente modificados por los campos
671 establecidos dentro del bloque @code{\score}. Los valores
672 resultantes se utilizan para imprimir el título de partitura.
673 Observe, sin embargo, que de forma predeterminada solamente se
674 imprimen los campos @code{piece} y @code{opus} en los títulos de
675 partitura a no ser que la variable de @code{\paper},
676 @code{print-all-headers}, tenga el valor @code{#t}.
680 @warning{Recuerde que al poner un bloque @bs{}@code{header}
681 dentro de un bloque @bs{}@code{score}, la expresión musical debe
682 aparecer antes del bloque @bs{}@code{header}.}
684 No es necesario aportar bloques @code{\header} en los cuatro
685 lugares: cualquiera de ellos o incluso todos pueden omitirse. De
686 forma similar, los archivos de entrada sencillos pueden omitir
687 los bloques @code{\book} y @code{\bookpart}, dejando que se creen
690 Si el libro solamente tiene una partitura, el bloque
691 @code{\header} debiera situarse normalmente al principio del
692 archivo de forma que solamente se produce una zona de título de
693 parte de libro, haciendo que estén disponibles para su uso todos
694 los títulos de encabezamientos.
696 Si el libro tiene varias partituras, son posibles distintas
697 combinaciones de bloques @code{\header}, según los distintos
698 tipos de publicaciones musicales. Por ejemplo, si la publicación
699 contiene varias piezas del mismo autor, un bloque @code{\header}
700 colocado al principio del archivo que especifique el título del
701 libro y el autor, con bloques @code{\header} en cada bloque
702 @code{\score} que especifique la @code{piece} y/o el @code{opus}
703 sería lo más adecuado, como aquí:
705 @lilypond[papersize=a5,quote,verbatim,noragged-right]
708 composer = "J. S. Bach."
712 \new Staff \relative {
715 \repeat unfold 2 { g,16( d' b') a b d, b' d, } |
716 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
724 \new Staff \relative {
728 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
729 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
737 Son posibles disposiciones más complejas. Por ejemplo, los
738 campos de texto extraídos del bloque @code{\header} de un libro
739 se pueden imprimir en todos los títulos de partitura, con ciertos
740 campos sobreescritos y otros suprimidos manualmente:
742 @lilypond[papersize=a5,quote,verbatim,noragged-right]
745 print-all-headers = ##t
748 title = "DAS WOHLTEMPERIRTE CLAVIER"
750 % Do not display the default LilyPond footer for this book
753 \markup { \vspace #1 }
757 \new Staff { \clef "bass" s1 }
760 title = "PRAELUDIUM I"
762 % Do not display the subtitle for this score
769 \new Staff { \clef "bass" s1 }
773 subsubtitle = "A 4 VOCI"
775 % Do not display the subtitle for this score
783 Referencia de la notación:
784 @ref{Estructura del archivo},
785 @ref{Presentación predeterminada de los títulos de partes de libro y partitura},
786 @ref{Personalización de los títulos}.
789 @node Presentación predeterminada de los títulos de partes de libro y partitura
790 @unnumberedsubsubsec Presentación predeterminada de los títulos de partes de libro y partitura
791 @translationof Default layout of bookpart and score titles
793 Este ejemplo muestra todas las variables impresas de @code{\header}:
796 @lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
799 % Los siguientes campos están centrados
800 dedication = "Dedication (dedicatoria)"
801 title = "Title (título)"
802 subtitle = "Subtitle (subtítulo)"
803 subsubtitle = "Subsubtitle (sub-subtítulo)"
804 % Los siguientes campos se distribuyen regularmente sobre una línea
805 % el campo "instrument" también aparece en las siguientes páginas
806 instrument = \markup \with-color #green "Instrument (instrumento)"
807 poet = "Poet (poeta)"
808 composer = "Composer (autor)"
809 % Los siguientes campos se sitúan en los extremos opuestos de la misma línea
810 meter = "Meter (metro)"
811 arranger = "Arranger (arreglista)"
812 % Los siguientes campos están centrados en la parte inferior
813 tagline = "La tagline o línea de etiqueta va al final de la última página"
814 copyright = "El copyright va al final de la primera página"
819 % Los siguientes campos se colocan en los extremos de una línea
820 piece = "Piece (pieza) 1"
827 % Los siguientes campos se sitúan en los extremos de una línea
828 piece = "Piece (pieza) 2 en la misma página"
836 % Los siguientes campos se sitúan en los extremos de una línea
837 piece = "Piece (pieza) 3 en una página nueva"
848 El nombre de instrumento se repite en todas las páginas.
851 Solamente @code{piece} (la pieza) y @code{opus} se imprimen en
852 una @code{\score} cuando la variable de papel
853 @code{print-all-headers} se establece a @code{##f} (el valor
857 @c Is the bit about \null markups true? -mp
858 Los campos de texto que se dejan sin establecer dentro de un
859 bloque @code{\header} se sustituyen por elementos de marcado
860 nulos @code{\null} de manera que no ocupen espacio
864 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan
865 los campos de texto @code{piece} y @code{opus} en extremos
866 opuestos de la misma línea.
870 Para cambiar la disposición predeterminada, véase
871 @ref{Personalización de los títulos}.
875 Si un bloque @code{\book} comienza inmediatamente con un bloque
876 @code{\bookpart}, no se imprime ningún título de libro, pues no
877 existe ninguna página en que imprimirlo. Si es necesario un
878 título de libro, inicie el bloque @code{\book} con algún material
879 de marcado o con una instrucción @code{\pageBreak}.
881 Utilice la variable @code{breakbefore} dentro de un bloque
882 @code{\header} que está propiamente dentro de un bloque
883 @code{\score} para hacer que los títulos del bloque
884 @code{\header} del nivel superior aparezcan ocupando toda la
885 primera página, empezando la música (definida en el bloque
886 @code{\score}) en la página siguiente.
889 @lilypond[papersize=c7landscape,verbatim,noragged-right]
892 title = "Este es mi Title (título)"
893 subtitle = "Este es mi Subtitle (subtítulo)"
894 copyright = "Este es el final de la primera página"
897 \repeat unfold 4 { e'' e'' e'' e'' }
899 piece = "Esto es la música"
907 Manual de aprendizaje:
908 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
910 Referencia de la notación:
911 @ref{Personalización de los títulos},
912 @ref{Estructura del archivo}.
915 @file{ly/titling-init.ly}.
918 @node Disposición predeterminada de las cabeceras y pies de página
919 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
920 @translationof Default layout of headers and footers
922 Las @emph{cabeceras} y los @emph{pies} de página son líneas de
923 texto que aparecen en la parte más alta y en la más baja de las
924 páginas separadas del texto principal de un libro. Se controlan
925 mediante las siguientes variables de @code{\paper}:
928 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
929 @item @code{evenHeaderMarkup} (marcado de cabecera par)
930 @item @code{oddFooterMarkup} (marcado de pie impar)
931 @item @code{evenFooterMarkup} (marcado de pie par)
934 Estas variables de marcado sólo pueden acceder a los campos de
935 texto extraídos de bloques @code{\header} del nivel superior (que
936 se aplican a todas las partituras del libro) y se definen en el
937 archivo @file{ly/titling-init.ly}. De forma predeterminada:
942 los números de página se sitúan automáticamente en el extremo
943 superior izquierdo (si es par) o superior derecho (si es impar),
944 a partir de la segunda página.
947 el campo de texto @code{instrument} se sitúa en el centro en cada
948 página, a partir de la segunda página.
951 el texto de @code{copyright} se centra en la parte baja de la
955 la línea @code{tagline} se centra al final de la última página, y
956 debajo del texto de @code{copyright} si sólo hay una página.
960 La línea predeterminada de pie de página de LilyPond se puede
961 cambiar añadiendo un campo @code{tagline} en el bloque
962 @code{\header} del nivel superior.
964 @lilypond[papersize=a8landscape,verbatim]
967 tagline = "... music notation for Everyone"
977 Para eliminar la línea de pie de página predeterminada de
978 LilyPond, establezca el valor de @code{tagline} a @code{##f}.
981 @node Títulos encabezamientos y pies de página personalizados
982 @subsection Títulos, encabezamientos y pies de página personalizados
983 @translationof Custom titles headers and footers
985 @c TODO: somewhere put a link to header spacing info
986 @c (you'll have to explain it more in NR 4).
989 * Formateo personalizado del texto de los títulos::
990 * Personalización de los títulos::
991 * Disposición personalizada de cabeceras y pies de página::
995 @node Formateo personalizado del texto de los títulos
996 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
997 @translationof Custom text formatting for titles
999 Se pueden usar instrucciones @code{\markup} estándar para
1000 personalizar el texto de cualquier cabecera, pie o título dentro
1001 del bloque @code{\header}.
1003 @lilypond[quote,verbatim,noragged-right]
1007 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
1008 opus = \markup { \italic "BWV 846" }
1014 Referencia de la notación:
1015 @ref{Formatear el texto}.
1018 @node Personalización de los títulos
1019 @unnumberedsubsubsec Personalización de los títulos
1020 @translationof Custom layout for titles
1022 @cindex bookTitleMarkup
1023 @cindex scoreTitleMarkup
1024 @funindex bookTitleMarkup
1025 @funindex scoreTitleMarkup
1027 Las instrucciones @code{\markup} dentro del bloque @code{\header}
1028 son útiles para dar un formato simple al texto, pero no permiten
1029 un control preciso sobre la colocación de los títulos. Para
1030 personalizar la colocación de los campos de texto, cambie una o
1031 las dos variables de @code{\paper} siguientes:
1034 @item @code{bookTitleMarkup} (marcado de título del libro)
1035 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
1038 La colocación de los títulos cuando se utilizan los valores
1039 predeterminados de estas variables de @code{\markup} se muestra
1041 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1043 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y
1044 como están definidos en el archivo @file{ly/titling-init.ly} son:
1047 scoreTitleMarkup = \markup @{ \column @{
1048 \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1050 \fromproperty #'header:piece
1051 \fromproperty #'header:opus
1057 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
1058 opuestos de la misma línea:
1060 @lilypond[quote,verbatim,noragged-right]
1064 piece = "PRAELUDIUM I"
1070 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el
1071 campo de texto @code{piece} aparece centrado y en un tipo de
1072 letra grande y en negrita.
1074 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1078 scoreTitleMarkup = \markup {
1081 \fontsize #4 \bold \fromproperty #'header:piece
1082 \fromproperty #'header:opus
1086 \header { tagline = ##f }
1090 piece = "PRAELUDIUM I"
1097 Los campos de texto que normalmente no son efectivos dentro de
1098 los bloques @code{\header} de una partitura se pueden imprimir el
1099 la zona del Título de la partitura si se coloca
1100 @code{print-all-headers} dentro del bloque @code{\paper}. Una
1101 desventaja de la utilización de este método es que los campos de
1102 texto que están orientados específicamente para la zona del
1103 título de parte de libro han de suprimirse manualmente en cada
1104 uno de los bloques @code{\score}. Véase @ref{Explicación de los
1107 Para evitarlo, añada el campo de texto deseado a la definición de
1108 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de
1109 texto @code{composer} (asociado normalmente con
1110 @code{bookTitleMarkup}) se añade a @code{scoreTitleMarkup},
1111 permitiendo que cada partitura muestre un compositor diferente:
1113 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1117 scoreTitleMarkup = \markup {
1120 \fontsize #4 \bold \fromproperty #'header:piece
1121 \fromproperty #'header:composer
1125 \header { tagline = ##f }
1130 composer = "Christian Petzold"
1137 composer = "François Couperin"
1143 También podemos crear nuestros propios campos de texto
1144 personalizados, y referirnos a ellos en la definición del
1145 elemento de marcado.
1147 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1151 scoreTitleMarkup = \markup {
1154 \override #`(direction . ,UP) {
1156 \center-align \fontsize #-1 \bold
1157 \fromproperty #'header:mycustomtext %% User-defined field
1158 \center-align \fontsize #4 \bold
1159 \fromproperty #'header:piece
1162 \fromproperty #'header:opus
1166 \header { tagline = ##f }
1171 mycustomtext = "A 4 VOCI" %% User-defined field
1179 Referencia de la notación:
1180 @ref{Explicación de los títulos}.
1183 @node Disposición personalizada de cabeceras y pies de página
1184 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1185 @translationof Custom layout for headers and footers
1187 @c can make-header and make-footer be removed from
1188 @c paper-defaults-init.ly? -mp
1190 Las instrucciones @code{\markup} dentro del bloque @code{\header}
1191 son de utilidad para dar formato al texto de una manera sencilla,
1192 pero no permiten un control preciso sobre la colocación de las
1193 cabeceras y los pies de página. Para personalizar la colocación
1194 de los campos de texto, use una o más de las siguientes variables
1198 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1199 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1200 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1201 @item @code{evenFooterMarkup} (marcado de pie de página par)
1204 @cindex marcado condicional
1206 @funindex \on-the-fly
1208 La instrucción de marcado @code{\on-the-fly} se puede utilizar
1209 para añadir elementos de forma condicional al texto de
1210 encabezamiento y pie de página definido dentro del bloque
1211 @code{\paper}, usando la sintaxis siguiente:
1214 variable = \markup @{
1216 \on-the-fly \@var{procedimiento} @var{marcado}
1221 El @var{procedimiento} se llama cada vez que se evalúa la
1222 instrucción @code{\markup} en que ésta aparece. El
1223 @var{procedimiento} debería comprobar si se cumple una condición
1224 determinada e interpretar (es decir: imprimir) el argumento
1225 @var{marcado} si, y sólo si, la condición es verdadera.
1227 Se proveen un cierto número de procedimientos ya hechos para la
1228 comprobación de diversas condiciones:
1231 @multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
1233 @headitem Nombre del procedimiento @tab Condición que se comprueba
1235 @item print-page-number-check-first @tab ¿debería imprimirse esta página?
1236 @item create-page-number-stencil @tab ¿es print-page-numbers verdadero?
1237 @item print-all-headers @tab ¿es print-all-headers verdadero?
1238 @item first-page @tab ¿es la primera página del libro?
1239 @item (on-page nmbr) @tab ¿es el número de página = nmbr?
1240 @item last-page @tab ¿es la última página del libro?
1241 @item not-first-page @tab ¿no es la primera página del libro?
1242 @item part-first-page @tab ¿es la primera página de la parte de libro?
1243 @item part-last-page @tab ¿es la última página de la parte de libro?
1244 @item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
1249 El ejemplo siguiente centra los números de página en la parte
1250 baja de las páginas. En primer lugar, los ajustes
1251 predeterminados para @code{oddHeaderMarkup} y
1252 @code{evenHeaderMarkup} se eliminan definiéndolos como un marcado
1253 @emph{nulo}. Después de esto, se redefine @code{oddFooterMarkup}
1254 con el número de página centrado. Finalmente,
1255 @code{evenFooterMarkup} recibe la misma disposición definiéndola
1256 como @code{\oddFooterMarkup}:
1258 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1261 print-page-number = ##t
1262 print-first-page-number = ##t
1263 oddHeaderMarkup = \markup \null
1264 evenHeaderMarkup = \markup \null
1265 oddFooterMarkup = \markup {
1267 \on-the-fly \print-page-number-check-first
1268 \fromproperty #'page:page-number-string
1271 evenFooterMarkup = \oddFooterMarkup
1274 \new Staff { s1 \break s1 \break s1 }
1279 Se pueden combinar varias condiciones de @code{\on-the-fly} con
1280 un operador @q{and}, por ejemplo:
1283 \on-the-fly \first-page
1284 \on-the-fly \last-page
1285 @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
1288 determina si la salida es una sola página.
1291 Referencia de la notación:
1292 @ref{Explicación de los títulos},
1293 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1295 Archivos instalados:
1296 @file{../ly/titling-init.ly}.
1298 @node Creación de metadatos de PDF
1299 @subsection Creación de metadatos de PDF
1300 @translationof Creating PDF metadata
1302 @cindex metadatos de PDF
1304 Además de mostrarse en la salida impresa, las variables de
1305 encabezamiento de @code{\header} se usan para establecer los
1306 metadatos de PDF (la información que muestran los lectores de PDF
1307 como @code{propiedades} del archivo). Por ejemplo, si se
1308 establece la propiedad @code{title} del bloque @code{header} como
1309 @q{Sinfonía núm. 1}, el documento PDF llevará también este
1314 title = "Sinfonía núm. 1"
1318 Si quiere fijar el título de la salida impresa con un texto pero
1319 quiere que la propiedad de título del PDF tenga un texto
1320 diferente, puede usar @code{pdftitle} como se muestra a
1325 title = "Sinfonía núm. 1"
1326 pdftitle = "Sinfonía núm. 1 de Beethoven"
1330 Todas las variables @code{title}, @code{subject},
1331 @code{keywords}, @code{subtitle}, @code{composer},
1332 @code{arranger}, @code{poet}, @code{author} y @code{copyright}
1333 establecen propiedades del PDF y pueden hacerse preceder de
1334 @q{pdf} para fijar una propiedad del archivo PDF a un valor
1335 distinto del de la salida impresa.
1337 La propiedad de PDF @code{Creator} se fija automáticamente a
1338 @q{LilyPond} más la versión actual de LilyPond, y las variables
1339 @code{CreationDate} y @code{ModDate} se fijan a la fecha y hora
1340 actuales. Se puede sobreescribir @code{ModDate} mediante el
1341 establecimiento de un valor para la variable de cabecera
1342 @code{moddate} (o @code{pdfmoddate}) a una cadena de fecha de PDF
1345 @node Crear notas al pie
1346 @subsection Crear notas al pie
1347 @translationof Creating footnotes
1349 @cindex notas al pie
1351 Se pueden crear dos tipos de notas al pie: automáticas y manuales.
1354 * Notas al pie dentro de expresiones musicales::
1355 * Notas al pie en texto independiente::
1358 @node Notas al pie dentro de expresiones musicales
1359 @unnumberedsubsubsec Notas al pie dentro de expresiones musicales
1360 @translationof Footnotes in music expressions
1362 @cindex notas al pie dentro de expresiones musicales
1365 @subsubsubheading Panorámica de las notas al pie
1367 Las notas al pie dentro de expresiones musicales caen dentro de
1371 @item Notas al pie basadas en eventos
1372 Se adjuntan a un evento en particular. Son ejemplos de tales
1373 eventos las notas sueltas, las articulaciones (como indicaciones
1374 de digitación, acentos, indicaciones dinámicas) y los
1375 post-eventos (como las ligaduras de expresión y las barras de
1376 corchea manuales). La forma general de las notas al pie basadas
1377 en eventos es como sigue:
1380 [@var{dirección}] \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1383 @item Notas al pie basadas en tiempo
1384 Se ligan a un punto temporal determinado, dentro de un contexto
1385 musical. Algunas instrucciones como @code{\time} y @code{\clef}
1386 en realidad no usan eventos para crear objetos como la indicación
1387 de compás y la clave. Un acorde tampoco crea un evento por sí
1388 mismo: su plica o corchete se crea al final de un paso de tiempo
1389 (nominalmente, a través de uno de los eventos de nota que
1390 contiene). Una nota al pie basada en tiempo permite anotar tales
1391 objetos de presentación sin referirse a ningún evento.
1393 Una nota al pie basada en tiempo permite que tales objetos de
1394 presentación se puedan anotar sin hacer referencia a un evento.
1395 La forma general para las notas al pie basadas en tiempo es:
1398 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} [@var{Contexto}].@var{Nombre-del-Grob}
1403 Los elementos para las dos formas son como sigue:
1408 Si (y sólo si) el @code{\footnote} se está aplicando a un
1409 post-evento o articulación, debe ir precedida de un indicador de
1410 dirección (@code{-, _, ^}) con el objeto de adjuntar la
1411 @var{música} (con una marca de nota al pie) a la nota o silencio
1415 es un elemento de marcado o cadena de caracteres que especifica
1416 la marca de nota al pie que se usa para marcar tanto el punto de
1417 referencia como la propia nota al pie en la parte inferior de la
1418 página. Se puede omitir (o, de forma equivalente, sustituirse
1419 por @code{\default}) en cuyo caso se genera un número
1420 secuencialmente de forma automática. Tales secuencias numéricas
1421 se reinician en cada página que contiene una nota al pie.
1423 @item desplazamiento
1424 es una pareja de números tal como @samp{#(2 . 1)} que especifica
1425 los desplazamientos en X y en Y en unidades de espacios de
1426 pentagrama a partir del límite del objeto en que se desea situar
1427 la marca. Los valores de desplazamiento positivos se toman a
1428 partir del borde superior derecho, los valores negativos a partir
1429 del borde inferior izquierdo y cero implica que la marca se
1430 centra sobre el borde.
1433 es el contexto en que se crea el grob que recibe la nota al pie.
1434 Se puede omitir si el grob está en un contexto del nivel inferior,
1435 p. ej. un contexto @code{Voice}.
1437 @item Nombre-del-Grob
1438 especifica un tipo de grob que marcar (como @samp{Flag} para el
1439 corchete). Si se da, la nota al pie no se adjunta a una
1440 expresión musical en particular, sino a todos los grobs del tipo
1441 especificado que ocurren en dicho momento de tiempo musical.
1443 @item texto-de-la-nota
1444 es el elemento de marcado o cadena de caracteres que especifica
1445 el texto de la nota al pie que utilizar en la parte baja de la
1449 es el evento musical, post-evento o articulación que se
1454 @subsubsubheading Notas al pie basadas en eventos
1456 @cindex Notas al pie, basadas en eventos
1458 Una nota al pie se adjunta a un objeto de presentación causado
1459 directamente por el evento que corresponde a @var{música}, con la
1463 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1467 @lilypond[quote,verbatim,papersize=a8landscape]
1469 \header { tagline = ##f }
1471 \footnote #'(-1 . 3) "Una nota" a4
1473 \footnote #'(2 . 2) "Un silencio" r4
1479 No es posible marcar un acorde @emph{completo} con una nota al
1480 pie basada en evento: un acorde, incluso aquel que contiene una
1481 sola nota, no produce un verdadero evento por sí mismo. Sin
1482 embargo, las notas individuales que están @emph{dentro} del
1483 acorde sí se pueden marcar:
1486 @lilypond[quote,verbatim,papersize=a8landscape]
1488 \header { tagline = ##f }
1490 \footnote #'(2 . 3) "No funciona" <a-3>2
1491 <\footnote #'(-2 . -3) "Funciona" a-3>4
1492 <a-3 \footnote #'(3 . 1/2) "También funciona" c-5>4
1497 Si se desea que la nota al pie se adjunte a un post-evento o
1498 articulación, la instrucción @code{\footnote} @emph{debe} ir
1499 precedida por un indicador de dirección, @code{-, _, ^}, y
1500 seguida por el post-evento o articulación que se desea anotar
1501 como argumento @var{música}. En esta forma, la @code{\footnote}
1502 se puede considerar como una simple copia de su último argumento
1503 con una marca de nota al pie adjunta. La sintaxis es:
1506 @var{dirección} \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1510 @lilypond[quote,verbatim,papersize=a8landscape]
1512 \header { tagline = ##f }
1514 a'4_\footnote #'(0 . -1) "Ligadura forzada hacia abajo" (
1515 b8^\footnote #'(1 . 0.5) "Barra manual forzada hacia arriba" [
1518 c-\footnote #'(1 . 1) "Tenuto" --
1523 @subsubsubheading notas al pie basadas en tiempo
1525 @cindex notas al pie, basadas en tiempo
1527 Si el objeto de presentación que recibe la nota al pie está
1528 causado @emph{indirectamente} por un evento (como un objeto
1529 @code{Accidental}, alteración, o @code{Stem}, plica, causados por
1530 un evento @code{NoteHead}, cabeza de nota), el nombre del grob
1531 @var{GrobName} del objeto de presentación es necesario después
1532 del texto de la nota al pie, en lugar de @var{música}:
1535 @lilypond[quote,verbatim,papersize=a8landscape]
1537 \header { tagline = ##f }
1539 \footnote #'(-1 . -3) "Un bemol" Accidental
1541 \footnote #'(-1 . 0.5) "Otro bemol" Accidental
1543 \footnote #'(1 . -2) "Una plica" Stem
1549 Sin embargo, observe que cuando se especifica el nombre de un
1550 grob, se adjunta una nota al pie a todos los grobs de ese tipo
1551 dentro del instante de tiempo actual:
1554 @lilypond[quote,verbatim,papersize=a8landscape]
1556 \header { tagline = ##f }
1558 \footnote #'(-1 . 3) "Un bemol" Accidental
1560 \footnote #'(2 . 0.5) "Articulación" Script
1566 Una nota dentro de un acorde puede recibir una nota al pie
1567 individual, basada en evento. El único grob causado directamente
1568 por una nota de un acorde es @samp{NoteHead}, por lo que la
1569 instrucción de nota al pie basada en evento @emph{solamente} es
1570 apta para añadir una nota al pie a la @samp{NoteHead} dentro de
1571 un acorde. Todos los demás grobs de notas de acorde están
1572 causados indirectamente. La propia instrucción @code{\footnote}
1573 no ofrece ninguna sintaxis para especificar al mismo tiempo un
1574 tipo concreto de grob @emph{y también} un evento concreto al que
1575 adjuntar la nota. Sin embargo, se puede usar una instrucción
1576 @code{\footnote} basada en tiempo para especificar el tipo de
1577 grob, y luego añadir la instrucción @code{\single} como prefijo,
1578 con el objeto de que se aplique solamente al evento siguiente:
1581 @lilypond[quote,verbatim,papersize=a8landscape]
1583 \header { tagline = ##f }
1585 < \footnote #'(1 . -2) "Un La" a
1586 \single \footnote #'(-1 . -1) "Un sostenido" Accidental
1588 \single \footnote #'(0.5 . 0.5) "Un bemol" Accidental
1595 @warning{Cuando las notas al pie se adjuntan a varios elementos musicales
1596 que están dentro del mismo momento musical, como ocurre en el
1597 ejemplo anterior, las notas al pie se numeran desde los elementos
1598 más altos a los más bajos tal y como aparecen en la salida
1599 impresa, no en el orden en que se escriben en el flujo de
1602 Los objetos de presentación como las claves y las armaduras de
1603 cambio de tonalidad están, más bien, causadas por propiedades que
1604 cambian, y no por eventos. Otros, como las líneas divisorias y
1605 los números de compás, son una consecuencia directa del paso del
1606 tiempo. Por esta razón, las notas al pie sobre tales objetos
1607 tienen que basarse en su tiempo musical. Las notas al pie
1608 basadas en tiempo so preferibles también cuando se marcan cosas
1609 como las plicas y las barras de corchea en @emph{acordes}: dado
1610 que estas funcionalidades de cada acorde individual están
1611 asignadas normalmente a @emph{un solo} evento dentro del acorde,
1612 sería imprudente descansar en una elección particular.
1614 En las notas al pie basadas en tiempo, siempre se debe
1615 especificar explícitamente el objeto de presentación en cuestión,
1616 y si el grob se crea dentro de un contexto distinto al de nivel
1617 más bajo, debe especificarse el contexto apropiado.
1620 @lilypond[quote,verbatim,papersize=a8landscape]
1622 \header { tagline = ##f }
1625 \footnote #'(-0.5 . -1) "Cambio de compás" Staff.TimeSignature
1627 \footnote #'(1 . -1) "Plica de acorde" Stem
1629 \footnote #'(-0.5 . 1) "Línea divisoria" Staff.BarLine
1631 \footnote #'(0.5 . -1) "Cambio de tonalidad" Staff.KeySignature
1638 Se pueden usar marcas personalizadas como alternativas a las
1639 marcas numéricas, y se puede suprimir la línea de anotación que
1640 une el objeto marcado con su marca:
1643 @lilypond[quote,verbatim,papersize=a8landscape]
1645 \header { tagline = ##f }
1647 \footnote "*" #'(0.5 . -2) \markup { \italic "* La primera nota" } a'4
1649 \footnote \markup { \super "$" } #'(0.5 . 1)
1650 \markup { \super "$" \italic " La segunda nota" } e
1652 \once \override Score.FootnoteItem.annotation-line = ##f
1653 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1654 \markup { \super "+" \italic " Editorial" } \p
1659 Se muestran más ejemplos de marcas personalizadas en
1660 @ref{Notas al pie en texto independiente}.
1663 @node Notas al pie en texto independiente
1664 @unnumberedsubsubsec Notas al pie en texto independiente
1665 @translationof Footnotes in stand-alone text
1667 @cindex notas al pie en texto independiente
1669 Se utilizan dentro de un elemento de marcado fuera de cualquier
1670 expresión musical. No se traza una línea hasta el punto de
1671 referencia: la marca simplemente sigue al elemento de marcado que
1672 se referencia. Se pueden insertar las marcas automáticamente, en
1673 cuyo caso son numéricas. De forma alternativa, se pueden aportar
1674 manualmente marcas personalizadas.
1676 Las notas al pie para texto independiente con marcas automáticas
1677 y personalizadas se crean de distintas formas.
1679 @subsubsubheading Notas al pie en texto independiente con marcas automáticas
1681 La sintaxis de una nota al pie sobre texto independiente con
1682 marcas automáticas es
1685 \markup @{ @dots{} \auto-footnote @var{texto} @var{nota} @dots{} @}
1693 es el elemento de marcado o cadena de caracteres que se desea
1697 es el elemento de marcado o cadena de caracteres que especifica
1698 el texto de la nota al pie que utilizar en la parte baja de la
1705 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1707 \header { tagline = ##f }
1710 \auto-footnote "tune" \italic " By me"
1711 "is shown below. It is a"
1712 \auto-footnote "recent" \italic " Aug 2012"
1721 @subsubsubheading Notas al pie sobre texto independiente con marcas personalizadas
1723 La sintaxis de una nota al pie sobre texto independiente con
1724 marcas personalizadas es
1727 \markup @{ @dots{} \footnote @var{marca} @var{nota} @dots{} @}
1735 es un elemento de marcado o cadena de caracteres que especifica
1736 la marca que se usa para señalar el punto de referencia. Observe
1737 que esta marca @emph{no} se inserta automáticamente antes de la
1741 es el elemento de marcado o cadena de caracteres que especifica
1742 el texto de la nota que aparece en la parte baja de la página,
1743 precedida por la @var{marca} especificada.
1747 Se puede usar como marca un carácter fácil de teclear, como * ó +,
1748 según se muestra en @ref{Notas al pie dentro de expresiones musicales}.
1749 De forma alternativa, se pueden usar alias en ASCII (véase
1750 @ref{Alias de ASCII}):
1752 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1754 \paper { #(include-special-characters) }
1755 \header { tagline = ##f }
1758 \footnote "*" \italic "* By me"
1759 "is shown below. It is a recent"
1760 \footnote \super † \concat {
1761 \super † \italic " Aug 2012"
1771 También pueden utilizarse códigos de caracteres Unicode para
1772 especificar las marcas (véase @ref{Unicode}):
1774 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1776 \header { tagline = ##f }
1779 \footnote \super \char##x00a7 \concat {
1780 \super \char##x00a7 \italic " By me"
1782 "is shown below. It is a recent"
1783 \footnote \super \char##x00b6 \concat {
1784 \super \char##x00b6 \italic " Aug 2012"
1795 Manual de aprendizaje:
1796 @rlearning{Objetos e interfaces}.
1798 Referencia de la notación:
1799 @ref{ASCII aliases},
1800 @ref{Globos de ayuda},
1801 @ref{Lista de caracteres especiales},
1802 @ref{Indicaciones de texto},
1803 @ref{Guiones de texto},
1806 Referencia de funcionamiento interno:
1807 @rinternals{FootnoteEvent},
1808 @rinternals{FootnoteItem},
1809 @rinternals{FootnoteSpanner},
1810 @rinternals{Footnote_engraver}.
1813 Varias notas al pie en la misma página solo pueden ir apiladas
1814 unas sobre otras; no se pueden imprimir en la misma línea.
1816 Las notas al pie no se pueden adjuntar a @code{MultiMeasureRests}
1817 (silencios multicompás), a barras de corchea automáticas ni a la
1818 letra de las canciones.
1820 Las notas al pie pueden colisionar con las pautas, objetos
1821 @code{\markup}, otras marcas de notas al pie y líneas de
1825 @node Referencia a números de página
1826 @subsection Referencia a números de página
1827 @translationof Reference to page numbers
1829 Un lugar determinado de una partitura puede señalizarse usando la
1830 instrucción @code{\label} (etiqueta), ya sea en el nivel superior
1831 o dentro de la música. Podemos referirnos a esta etiqueta más
1832 tarde dentro de un elemento de marcado, para obtener el número de
1833 la página en la que se sitúa el punto señalizado, usando la
1834 instrucción de marcado @code{\page-ref}.
1837 @lilypond[verbatim,papersize=a8landscape]
1838 \header { tagline = ##f }
1844 \pageBreak \mark A \label #'markA
1848 \markup { La primera partitura comienza en la página \page-ref #'firstScore "0" "?" }
1849 \markup { La marca A está en la página \page-ref #'markA "0" "?" }
1853 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1855 @item la etiqueta, un símbolo de Scheme, p.ej. @code{#'firstScore};
1856 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1857 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1860 El motivo de que se necesite un medidor es que en el momento en
1861 que se están interpretando los marcados, los saltos de página aún
1862 no se han producido y por tanto los números de página no se
1863 conocen todavía. Para sortear este inconveniente, la
1864 interpretación real del marcado se retrasa hasta un momento
1865 posterior; sin embargo, las dimensiones del marcado se tienen que
1866 conocer de antemano, así que se usa el medidor para decidir estas
1867 dimensiones. Si el libro tiene entre 10 y 99 páginas, el medidor
1868 puede ser "00", es decir, un número de dos dígitos.
1878 @node Índice general
1879 @subsection Índice general
1880 @translationof Table of contents
1882 Se puede insertar un índice general o tabla de contenidos
1883 utilizando la instrucción @code{\markuplist \table-of-contents}.
1884 Los elementos que deben aparecer en la tabla de contenidos se
1885 introducen con la instrucción @code{\tocItem}, que se puede usar
1886 en el nivel más alto de la jerarquía del código, o dentro de una
1890 \markuplist \table-of-contents
1893 \tocItem \markup "Primera partitura"
1897 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1902 \tocItem \markup "Segunda partitura"
1910 Los elementos de marcado que se usan para dar formato al índice
1911 general o tabla de contenidos se encuentran definidos dentro del
1912 bloque @code{\paper}. Hay dos elementos de marcado
1913 @q{predefinidos} disponibles:
1918 @code{tocTitleMarkup}
1921 Utilizado para dar formato al título del índice general.
1924 tocTitleMarkup = \markup \huge \column {
1925 \fill-line { \null "Índice general" \null }
1931 @code{tocItemMarkup}
1934 Usado para dar formato a los elementos del índice general.
1937 tocItemMarkup = \markup \fill-line {
1938 \fromproperty #'toc:text \fromproperty #'toc:page
1945 Ambas variables pueden modificarse.
1947 He aquí un ejemplo que modifica el título del índice general para
1948 que aparezca en francés:
1952 tocTitleMarkup = \markup \huge \column {
1953 \fill-line { \null "Table des matières" \null }
1958 A continuación aparece un ejemplo que modifica el tamaño de
1959 fuente tipográfica de los elementos del índice general:
1962 tocItemMarkup = \markup \large \fill-line {
1963 \fromproperty #'toc:text \fromproperty #'toc:page
1967 Observe la forma en que nos referimos al texto y al número de
1968 página del elemento de índice, dentro de la definición
1969 @code{tocItemMarkup}.
1971 La instrucción @code{\tocItemWithDotsMarkup} se puede incluir
1972 dentro de @code{tocItemMarkup} para llenar la línea con puntos
1973 entre un elemento del índice general y su número de página
1976 @lilypond[verbatim,line-width=10.0\cm]
1977 \header { tagline = ##f }
1979 tocItemMarkup = \tocItemWithDotsMarkup
1983 \markuplist \table-of-contents
1984 \tocItem \markup { Allegro }
1985 \tocItem \markup { Largo }
1990 Las instrucciones predefinidas con sus propios marcados pueden
1991 definirse también para que construyan un índice general más
1992 complejo. En el ejemplo siguiente se define un estilo nuevo para
1993 introducir los nombres de los actos de una ópera en el índice
1997 Una nueva variable de marcado (llamada @code{tocActMarkup}) se
1998 define en el bloque @code{\paper}:
2002 tocActMarkup = \markup \large \column {
2004 \fill-line { \null \italic \fromproperty #'toc:text \null }
2011 A continuación se crea una función musical personalizada
2012 (@code{tocAct}), que usa la nueva definición de marcado
2013 @code{tocActMarkup}.
2017 #(define-music-function (text) (markup?)
2018 (add-toc-item! 'tocActMarkup text))
2022 Un archivo de entrada de LilyPond que use estas definiciones
2023 personalizadas tendría el aspecto siguiente:
2025 @lilypond[line-width=10.0\cm]
2026 \header { tagline = ##f }
2028 tocActMarkup = \markup \large \column {
2030 \fill-line { \null \italic \fromproperty #'toc:text \null }
2036 #(define-music-function (text) (markup?)
2037 (add-toc-item! 'tocActMarkup text))
2040 \markuplist \table-of-contents
2041 \tocAct \markup { Atto Primo }
2042 \tocItem \markup { Coro. Viva il nostro Alcide }
2043 \tocItem \markup { Cesare. Presti omai l'Egizia terra }
2044 \tocAct \markup { Atto Secondo }
2045 \tocItem \markup { Sinfonia }
2046 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
2052 He aquí un ejemplo de la instrucción @code{\fill-with-pattern}
2053 usada dentro del contexto de un índice general:
2057 tocItemMarkup = \markup { \fill-line {
2058 \override #'(line-width . 70)
2059 \fill-with-pattern #1.5 #CENTER . \fromproperty #'toc:text \fromproperty #'toc:page
2067 @file{ly/toc-init.ly}.
2070 @funindex \table-of-contents
2071 @code{\table-of-contents},
2077 @node Trabajar sobre los archivos de entrada
2078 @section Trabajar sobre los archivos de entrada
2079 @translationof Working with input files
2082 * Inclusión de archivos de LilyPond::
2083 * Distintas ediciones a partir de una misma fuente::
2084 * Caracteres especiales::
2088 @node Inclusión de archivos de LilyPond
2089 @subsection Inclusión de archivos de LilyPond
2090 @translationof Including LilyPond files
2093 @cindex including files
2095 Un proyecto grande se puede dividir en varios archivos. Para
2096 referirse a otro archivo, utilice
2099 \include "otroarchivo.ly"
2102 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo
2103 el contenido de @file{otroarchivo.ly} en el archivo actual en el
2104 lugar en que aparece el @code{\include}. Por ejemplo, en un
2105 proyecto grande podríamos querer archivos distintos para cada
2106 parte instrumental y crear un archivo de @qq{partitura completa}
2107 que reúne los archivos individuales de los instrumentos.
2108 Normalmente el archivo incluido define un cierto número de
2109 variables que a partir de entonces quedan disponibles para
2110 poderlas utilizar en el archivo de la partitura completa. En los
2111 archivos incluidos se pueden marcar las secciones etiquetadas
2112 para ayudar a hacerlas utilizables en distintos lugares de la
2113 partitura, véase @ref{Distintas ediciones a partir de una misma
2116 Los archivos que están en el directorio de trabajo actual se
2117 pueden referenciar simplemente especificando el nombre después de
2118 la instrucción @code{\include}. Los archivos en otros lugares se
2119 pueden incluir proporcionando una referencia de ruta completa o
2120 una ruta relativa (pero utilice la barra inclinada normal del
2121 UNIX, /, no la barra invertida de DOS/Windows, \, como separador
2122 de directorio). Por ejemplo, si @file{material.ly} está situado
2123 un directorio por encima del directorio de trabajo actual,
2127 \include "../material.ly"
2131 o si los archivos de las partes orquestales incluidas están todos
2132 situados en un subdirectorio llamado @file{partes} dentro del
2133 directorio actual, use
2136 \include "partes/VI.ly"
2137 \include "partes/VII.ly"
2141 Los archivos de inclusión también pueden contener enunciados
2142 @code{\include} a su vez. De forma predeterminada, estos
2143 enunciados @code{\include} de segundo nivel no se interpretan
2144 hasta que se incorporan al archivo principal, por lo que los
2145 nombres de archivo que especifican deben ser relativos al
2146 directorio que contiene el archivo principal, no al directorio
2147 que contiene el archivo incluido. Sin embargo, este
2148 comportamiento se puede modificar globalmente pasando la opción
2149 @option{-drelative-includes} en la línea de órdenes (o mediante
2150 la adición de @code{#(ly:set-option 'relative-includes #t)} al
2151 principio del archivo principal de entrada).
2153 Cuando @code{relative-includes} está establecido al valor
2154 @code{#t}, la ruta de cada instrucción @code{\include} se
2155 considera relativa al archivo que contiene dicha instrucción.
2156 Este comportamiento es el recomendado y se convertirá en el
2157 comportamiento predeterminado en una versión futura de lilypond.
2159 Tanto los archivos relativos al directorio principal como los
2160 archivos relativos a algún otro directorio se pueden
2161 @code{\include}ar mediante el establecimiento de
2162 @code{relative-includes} al valor @code{#t} o a @code{#f} en los
2163 lugares apropiados dentro de los archivos. Por ejemplo, si se ha
2164 creado una biblioteca genérica, libA, que a su vez utiliza
2165 sub-archivos que se @code{\include}an por medio del archivo de
2166 entrada de dicha biblioteca, esas instrucciones @code{\include}
2167 tendrán que venir precedidas por @code{#(ly:set-option
2168 #relative-includes #t)} de manera que se interpreten
2169 correctamente al construir el archivo de entrada @code{.ly}
2170 principal, de esta forma:
2181 entonces el archivo de entrada, @code{libA.ly}, contiene
2184 #(ly:set-option 'relative-includes #t)
2188 % vuelta al ajuste predeterminado
2189 #(ly:set-option 'relative-includes #f)
2192 Cualquier archivo @file{.ly} puede entonces incluir la biblioteca
2193 completa, simplemente con
2196 \include "~/libA/libA.ly"
2199 Se pueden usar estructuras de archivo más complejas instando los
2200 cambios en los lugares adecuados.
2202 También se pueden incluir archivos de un directorio que está en
2203 una ruta de búsqueda especificada como opción al invocar a
2204 LilyPond desde la línea de órdenes. Los archivos incluidos se
2205 especifican usando solamente su nombre de archivo. Por ejemplo,
2206 para compilar mediante este método un archivo @file{principal.ly}
2207 que incluye archivos situados en un subdirectorio llamado
2208 @file{partes}, cambie al directorio que contiene
2209 @file{principal.ly} e introduzca
2212 lilypond --include=partes principal.ly
2215 y en @file{principal.ly} escriba
2223 Los archivos que se incluyen en muchas partituras se pueden poner
2224 en el directorio de LilyPond @file{../ly} (la localización de
2225 este directorio depende de la instalación: véase @rlearning{Otras
2226 fuentes de información}). Estos archivos se pueden incluir
2227 sencillamente por su nombre en un enunciado @code{\include}. De
2228 esta forma se incluyen los archivos dependientes del idioma como
2231 LilyPond incluye de forma predeterminada ciertos archivos cuando
2232 se inicia el programa. Estas inclusiones no son visibles para el
2233 usuario, pero los archivos se pueden identificar ejecutando
2234 @code{lilypond --verbose} desde la línea de órdenes. Esto
2235 presentará una lista de rutas y archivos que utiliza LilyPond,
2236 junto a muchas otras indicaciones. De forma alternativa, pueden
2237 verse explicaciones sobre los archivos más importantes de este
2238 conjunto en @rlearning{Otras fuentes de información}. Estos
2239 archivos se pueden editar, pero los cambios realizados sobre
2240 ellos se perderán al instalar una nueva versión de LilyPond.
2242 Pueden verse ejemplos sencillos sobre el uso de @code{\include}
2243 en @rlearning{Partituras y particellas}.
2246 Manual de aprendizaje:
2247 @rlearning{Otras fuentes de información},
2248 @rlearning{Partituras y particellas}.
2251 Si un archivo incluido recibe un nombre igual al de uno de los
2252 archivos de instalación de LilyPond, el archivo que tiene
2253 prioridad es el de los archivos de instalación de LilyPond.
2256 @node Distintas ediciones a partir de una misma fuente
2257 @subsection Distintas ediciones a partir de una misma fuente
2258 @translationof Different editions from one source
2260 Se pueden usar varios métodos para generar la producción de
2261 distintas versiones de una partitura a partir de la misma fuente
2262 musical. Las variables son quizá el más útil para combinar
2263 secciones extensas de música y/o anotaciones. Las etiquetas son
2264 más útiles para seleccionar una sección de entre varias secciones
2265 de música alternativas, más cortas, y se pueden usar también para
2266 dividir piezas de música en distintos trozos.
2268 Cualquiera que sea el método utilizado, la separación de la
2269 notación de la estructura de la partitura hará que sea más fácil
2270 cambiar la estructura dejando intacta la notación.
2273 * Uso de las variables::
2274 * Uso de etiquetas::
2275 * Uso de ajustes globales::
2278 @node Uso de las variables
2279 @unnumberedsubsubsec Uso de las variables
2280 @translationof Using variables
2282 @cindex variables, uso de las
2284 Si las secciones de la música se definen dentro de variables, se
2285 pueden reutilizar en distintas partes de la partitura, véase
2286 @rlearning{Organizar las piezas mediante variables}. Por
2287 ejemplo, una partitura vocal @notation{a cappella} con frecuencia
2288 incluye una reducción de piano de las partes para ensayar que es
2289 idéntica a la música vocal, por lo que ésta sólo se tiene que
2290 escribir una vez. Se puede combinar sobre un solo pentagrama la
2291 música de dos variables, véase @ref{Combinación automática de las
2292 partes}. He aquí un ejemplo:
2294 @lilypond[verbatim,quote]
2295 sopranoMusic = \relative { a'4 b c b8( a) }
2296 altoMusic = \relative { e'4 e e f }
2297 tenorMusic = \relative { c'4 b e d8( c) }
2298 bassMusic = \relative { a4 gis a d, }
2299 allLyrics = \lyricmode { King of glo -- ry }
2301 \new Staff = "Soprano" \sopranoMusic
2302 \new Lyrics \allLyrics
2303 \new Staff = "Alto" \altoMusic
2304 \new Lyrics \allLyrics
2305 \new Staff = "Tenor" {
2309 \new Lyrics \allLyrics
2310 \new Staff = "Bass" {
2314 \new Lyrics \allLyrics
2317 \partcombine \sopranoMusic \altoMusic
2321 \partcombine \tenorMusic \bassMusic
2327 Se pueden producir partituras distintas que presenten sólo las
2328 partes vocales o sólo la parte de piano, cambiando solamente los
2329 enunciados estructurales, sin modificar la notación musical.
2331 Para partituras extensas, las definiciones de variable se pueden
2332 poner en archivos separados que se incluyen más tarde, véase
2333 @ref{Inclusión de archivos de LilyPond}.
2336 @node Uso de etiquetas
2337 @unnumberedsubsubsec Uso de etiquetas
2338 @translationof Using tags
2341 @funindex \keepWithTag
2342 @funindex \removeWithTag
2344 @cindex mantener música etiquetada
2345 @cindex quitar música etiquetada
2347 La instrucción @code{\tag #'@var{parteA}} marca una expresión
2348 musical con el nombre @var{parteA}. Las expresiones etiquetadas
2349 de esta manera se pueden seleccionar o filtrar más tarde por su
2350 nombre, usando bien @code{\keepWithTag #'@var{nombre}} o bien
2351 @code{\removeWithTag #'@var{nombre}}. El resultado de la
2352 aplicación de estos filtros a la música etiquetada es como sigue:
2354 @multitable @columnfractions .5 .5
2358 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
2359 o de @code{\keepWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2360 @tab Se incluye la música no etiquetada y la música etiquetada con
2361 el nombre o nombres de etiqueta dados; se excluye la música
2362 etiquetada con cualquier otro nombre de etiqueta.
2364 Música etiquetada precedida de
2365 @code{\removeWithTag #'@var{nombre}} o
2366 @code{\removeWithTag #'(@var{nombre1} @var{nombre2}@dots{})}
2368 Se incluye la música no etiquetada y la música que no está
2369 etiquetada con ninguno de los nombres de etiqueta dados; se
2370 excluye la música etiquetada con los nombres de etiqueta dados.
2372 Música etiquetada no precedida de @code{\keepWithTag} ni de
2373 @code{\removeWithTag}
2374 @tab Se incluye toda la música etiquetada y no etiquetada.
2377 Los argumentos de las instrucciones @code{\tag},
2378 @code{\keepWithTag} y @code{\removeWithTag} deben ser un símbolo
2379 o lista de símbolos (como @code{#'score} o @code{#'(violinI
2380 violinII}), seguida de una expresión musical. Si @emph{y solo
2381 si} los símbolos son identificadores de LilyPond válidos
2382 (caracteres alfabéticos solamente, sin números, guiones bajos ni
2383 guiones normales) que no puedan confundirse con notas, la porción
2384 @code{#'} se puede omitir y, como abreviatura, una lista de
2385 símbolos puede usar el separador de punto, es decir: @code{\tag
2386 #'(violinI violinII)} se puede escribir como @code{\tag
2387 violinI.violinII}. Lo mismo vale para @code{\keepWithTag} y
2388 @code{\removeWithTag}.
2390 En el ejemplo siguiente vemos dos versiones de una pieza musical,
2391 una que muestra trinos con la notación usual y otra con los
2392 trinos expandidos explícitamente:
2394 @lilypond[verbatim,quote]
2397 \tag #'trills { d8.\trill }
2398 \tag #'expand { \repeat unfold 3 { e32 d } }
2403 \keepWithTag #'trills \music
2406 \keepWithTag #'expand \music
2411 De forma alternativa, a veces es más fácil excluir secciones de música:
2413 @lilypond[verbatim,quote]
2416 \tag #'trills { d8.\trill }
2417 \tag #'expand {\repeat unfold 3 { e32 d } }
2422 \removeWithTag #'expand
2426 \removeWithTag #'trills
2431 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
2435 -\tag #'@var{mi-etiqueta}
2438 a una articulación. Por ejemplo, esto define una nota con una
2439 indicación opcional de digitación y una nota con una anotación
2444 c1-\tag #'warn ^"¡Ojo!"
2447 Se pueden poner varias etiquetas sobre expresiones con varias
2448 entradas de @code{\tag}, o combinando varias etiquetas en una
2451 @lilypond[quote,verbatim]
2452 music = \relative c'' {
2453 \tag #'a \tag #'both { a4 a a a }
2454 \tag #'(b both) { b4 b b b }
2457 \keepWithTag #'a \music
2458 \keepWithTag #'b \music
2459 \keepWithTag #'both \music
2463 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
2464 expresión musical para quitar varias secciones etiquetadas con
2465 nombres distintos. De forma alternativa, podemos usar una sola
2466 instrucción @code{\removeWithTag} con una lista de etiquetas.
2468 @lilypond[verbatim,quote]
2469 music = \relative c'' {
2470 \tag #'A { a4 a a a }
2471 \tag #'B { b4 b b b }
2472 \tag #'C { c4 c c c }
2473 \tag #'D { d4 d d d }
2479 \removeWithTag #'(B C)
2484 El uso de dos o más filtros @code{\keepWithTag} sobre una sola
2485 expresión musical produce la eliminación de @emph{todas} las
2486 secciones etiquetadas. El primer filtro quita todas excepto
2487 la que se nombra, y cualquier filtro posterior
2489 Usando una sola instrucción @code{\keepWithTag} con una
2490 lista de varias etiquetas se suprimirán solamente
2491 las secciones etiquetadas que no aparezcan especificadas en la lista.
2493 @lilypond[verbatim,quote]
2494 music = \relative c'' {
2495 \tag #'violinI { a4 a a a }
2496 \tag #'violinII { b4 b b b }
2497 \tag #'viola { c4 c c c }
2498 \tag #'cello { d4 d d d }
2502 \keepWithTag #'(violinI violinII)
2508 will print @code{\tag}s @var{violinI} and @var{violinII} but not
2509 @var{viola} or @var{cello}.
2511 @cindex grupos de etiquetas
2513 Aunque @code{\keepWithTag} es útil para el manejo de @emph{un
2514 solo} conjunto de alternativas, la eliminación de música
2515 etiquetada con otras etiquetas @emph{no relacionadas} es
2516 problemática si se utilizan para más de un propósito.
2517 En ese caso pueden declararse @q{grupos de etiquetas}:
2520 \tagGroup #'(violinI violinII viola cello)
2524 Ahora todas las etiquetas pertenecen a un solo @q{grupo de etiquetas}.
2525 Observe que las etiquetas individuales no pueden ser miembros
2526 de más de un @emph{grupo de etiquetas}.
2529 \keepWithTag #'violinI @dots{}
2533 mostrará solamente la música etiquetada a partir del
2534 grupo de etiquetas de @code{violinI} y
2535 cualquier fragmento musical etiquetado con una de las
2536 @emph{otras} etiquetas resultará suprimido.
2538 @lilypond[verbatim,quote]
2540 \tagGroup #'(violinI violinII viola cello)
2541 \tag #'violinI { c''4^"violinI" c c c }
2542 \tag #'violinII { a2 a }
2543 \tag #'viola { e8 e e2. }
2544 \tag #'cello { d'2 d4 d }
2549 \keepWithTag #'violinI
2554 Al usar la instrucción @code{\keepWithTag} solo son visibles
2555 las etiquetas de los grupos de aquellas etiquetas se se incluyen
2558 @funindex \pushToTag
2559 @funindex \appendToTag
2560 @cindex dividir en música etiquetada
2562 A veces podemos desear dividir la música en un determinado lugar
2563 dentro de una expresión musical existente. Podemos usar
2564 @code{\pushToTag} y @code{\appendToTag} para añadir material
2565 delante o al final de los @code{elements} de una construcción
2566 musical existente. No toda construcción musical tiene la parte
2567 @code{elements}, pero las músicas secuenciales y simultáneas son
2568 dos apuestas seguras:
2570 @lilypond[verbatim,quote]
2571 music = { \tag #'here { \tag #'here <<c''>> } }
2574 \pushToTag #'here c'
2575 \pushToTag #'here e'
2576 \pushToTag #'here g' \music
2577 \appendToTag #'here c'
2578 \appendToTag #'here e'
2579 \appendToTag #'here g' \music
2583 Las dos instrucciones admiten una etiqueta, el material que
2584 dividir en cada ocurrencia de la etiqueta, y la expresión
2588 Manual de aprendizaje:
2589 @rlearning{Organizar las piezas mediante variables}.
2591 Referencia de la notación:
2592 @ref{Combinación automática de las partes},
2593 @ref{Inclusión de archivos de LilyPond}.
2596 Al llamar a @code{\relative} sobre una expresión musical obtenida
2597 mediante el filtrado de música con las instrucciones
2598 @code{\keepWithTag} o @code{\removeWithTag}, podría ocurrir que
2599 cambiaran las relaciones de octava, dado que solo se tendrán en
2600 cuenta las alturas de las notas que efectivamente permanecen en
2601 la expresión filtrada. La aplicación de @code{\relative} en
2602 primer lugar, antes de @code{\keepWithTag} o de
2603 @code{\removeWithTag}, evita este peligro porque en este caso
2604 @code{\relative} actúa sobre todas las notas tal y como se
2608 @node Uso de ajustes globales
2609 @unnumberedsubsubsec Uso de ajustes globales
2610 @translationof Using global settings
2612 @cindex include-settings
2614 Se pueden incluir ajustes globales a partir de un archivo
2618 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
2621 En archivos diferentes se pueden almacenar grupos de ajustes como
2622 el tamaño de la página o las fuentes tipográficas. Ello permite
2623 hacer diferentes ediciones de la misma partitura así como aplicar
2624 ajustes estándar a muchas partituras, simplemente por medio de la
2625 especificación del archivo de ajustes adecuado.
2627 Esta técnica también funciona bien con el uso de hojas de estilo,
2628 como se estudia en @rlearning{Hojas de estilo}.
2631 Manual de aprendizaje:
2632 @rlearning{Organizar las piezas mediante variables},
2633 @rlearning{Hojas de estilo}.
2635 Referencia de la notación:
2636 @ref{Inclusión de archivos de LilyPond}.
2639 @node Caracteres especiales
2640 @subsection Caracteres especiales
2641 @translationof Special characters
2643 @cindex caracteres especiales
2644 @cindex caracteres no ASCII
2647 * Codificación del texto::
2653 @node Codificación del texto
2654 @unnumberedsubsubsec Codificación del texto
2655 @translationof Text encoding
2659 LilyPond usa el conjunto de caracteres definido por el consorcio
2660 Unicode y la norma ISO/IEC 10646. Define un nombre único y un
2661 código para los conjuntos de caracteres que se utilizan en
2662 prácticamente todos los idiomas modernos y también en muchos
2663 otros. Unicode se puede implementar utilizando varios esquemas
2664 de codificación distintos. LilyPond usa la codificación UTF-8
2665 (UTF son las siglas de @emph{Unicode Transformation Format}, o
2666 formato de transformación de Unicode) que representa todos los
2667 caracteres comunes de la codificación Latin en un solo byte, y
2668 representa otros caracteres usando un formato de longitud
2669 variable de hasta cuatro bytes.
2671 El aspecto visual real de los caracteres viene determinado por
2672 los glifos que se definen en las fuentes tipográficas concretas
2673 que se tengan disponibles: una fuente tipográfica define la
2674 asignación de un subconjunto de los códigos de Unicode a glifos.
2675 LilyPond usa la biblioteca Pango para representar y disponer
2676 tipográficamente textos multilingües.
2678 LilyPond no realiza ninguna conversión en la codificación de la
2679 entrada. Esto significa que cualquier text, ya sea el título, la
2680 letra de la canción o una instrucción musical que contenga
2681 caracteres distintos a los del conjunto ASCII, se deben codificar
2682 en UTF-8. La forma más fácil de escribir dicho texto es utilizar
2683 un editor preparado para Unicode y guardar el archivo con la
2684 codificación UTF-8. Casi todos los editores modernos populares
2685 contemplan el UTF-8, por ejemplo lo hacen vim, Emacs, jEdit y
2686 Gedit. Todos los sistemas MS Windows posteriores a NT usan
2687 Unicode como codificación de caracteres nativa, de manera que
2688 incluso el accesorio Bloc de Notas (Notepad) puede editar y
2689 guardar un archivo en el formato UTF-8. Una alternativa más
2690 funcional para Windows es BabelPad.
2692 Si un archivo de entrada que contiene un carácter que no es
2693 ASCII, no se guarda en el formato UTF-8, se genera el mensaje de
2697 FT_Get_Glyph_Name () error: argumento inválido
2700 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
2702 @c NOTE: No verbatim in the following example as the code does not
2703 @c display correctly in PDF Font settings for Cyrillic and Hebrew
2706 % Linux Libertine fonts contain Cyrillic and Hebrew glyphs.
2710 #:roman "Linux Libertine O,serif"
2711 #:sans "Linux Biolinum O,sans-serif"
2712 #:typewriter "Linux Libertine Mono O,monospace"
2717 bulgarian = \lyricmode {
2718 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2722 hebrew = \lyricmode {
2723 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2727 portuguese = \lyricmode {
2728 à vo -- cê uma can -- ção legal
2734 \addlyrics { \bulgarian }
2735 \addlyrics { \hebrew }
2736 \addlyrics { \portuguese }
2741 @unnumberedsubsubsec Unicode
2742 @translationof Unicode
2746 Para introducir un carácter aislado para el que se conoce el
2747 punto de código Unicode pero no está disponible en el editor que
2748 se está usando, use @code{\char ##xhhhh} o bien @code{\char
2749 #dddd} dentro de un bloque @code{\markup}, donde @code{hhhh} es
2750 el código hexadecimal del carácter en cuestión y @code{dddd} es
2751 su valor decimal correspondiente. Pueden omitirse los ceros
2752 iniciales, pero es costumbre indicar los cuatro caracteres en la
2753 representación hexadecimal (observe que @emph{no} debe utilizarse
2754 la codificación UTF-8 del punto de código Unicode después de
2755 @code{\char}, pues la codificación UTF-8 contiene bits
2756 adicionales que indican el número de octetos). Hay tablas de
2757 códigos Unicode y un índice de nombres de caracteres que da el
2758 punto de código en hexadecimal para cualquier carácter en el
2759 portal del Consorcio Unicode, @uref{http://www.unicode.org/}.
2761 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
2762 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
2763 @qq{Letra griega Xi pequeña}.
2765 Se puede escribir de esta forma cualquier punto de código
2766 Unicode, y si todos los caracteres especiales se escriben en este
2767 formato no es necesario guardar el archivo de entrada en formato
2768 UTF-8. Por supuesto, debe estar instalada y estar disponible
2769 para LilyPond una fuente tipográfica que contenga codificados
2770 todos estos caracteres.
2772 El ejemplo siguiente muestra valores hexadecimales Unicode que se
2773 usan en cuatro lugares: en una llamada de ensayo, como texto de
2774 articulación, en la letra y como texto independiente bajo la
2777 @lilypond[quote,verbatim]
2780 c''1 \mark \markup { \char ##x03EE }
2781 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2783 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2785 \markup { "Copyright 2008--2015" \char ##x00A9 }
2788 @cindex copyright, símbolo de
2790 Para escribir el símbolo de copyright en la nota de créditos, utilice:
2794 copyright = \markup @{ \char ##x00A9 "2008" @}
2799 @node Alias de ASCII
2800 @unnumberedsubsubsec Alias de ASCII
2801 @translationof ASCII aliases
2803 Se puede incluir una lista de alias de ASCII para caracteres
2806 @lilypond[quote,verbatim]
2808 #(include-special-characters)
2811 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2814 \new Staff { \repeat unfold 9 a'4 }
2816 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2821 "The replacement can be disabled:"
2822 "– &OE; …"
2823 \override #'(replacement-alist . ()) "– &OE; …"
2827 También podemos hacer nuestros propios alias, ya sea de forma global,
2829 @lilypond[quote,verbatim]
2831 #(add-text-replacements!
2832 '(("100" . "hundred")
2833 ("dpi" . "dots per inch")))
2835 \markup "A 100 dpi."
2840 @lilypond[quote,verbatim]
2841 \markup \replace #'(("100" . "hundred")
2842 ("dpi" . "dots per inch")) "A 100 dpi."
2846 Referencia de la notación:
2847 @ref{Lista de caracteres especiales}.
2849 Archivos instalados:
2850 @file{ly/text-replacements.ly}.
2853 @node Controlar la salida
2854 @section Controlar la salida
2855 @translationof Controlling output
2858 * Extracción de fragmentos de música::
2859 * Saltar la música corregida::
2860 * Formatos de salida alternativos::
2861 * Sustituir la tipografía de la notación::
2864 @funindex clip-regions
2865 @cindex fragmentos de música
2866 @cindex música, fragmentos
2868 @node Extracción de fragmentos de música
2869 @subsection Extracción de fragmentos de música
2870 @translationof Extracting fragments of music
2872 Es posible producir en la salida uno o más fragmentos de una
2873 partitura mediante la definición de la situación explícita de la
2874 música que se quiere extraer dentro del bloque @code{\layout} del
2875 archivo de entrada, utilizando la función @code{clip-regions}, y
2876 a continuación ejecutando LilyPond con la opción
2877 @option{-dclip-systems}.
2884 (make-rhythmic-location 5 1 2)
2885 (make-rhythmic-location 7 3 4)))
2890 Este ejemplo extrae un solo fragmento del archivo de entrada
2891 @emph{comenzando} después de la duración de una blanca en el
2892 quinto compás (@code{5 1 2}) y @emph{terminando} después de la
2893 tercera negra del compás séptimo (@code{7 3 4}).
2895 Se pueden extraer fragmentos adicionales añadiendo más pares de
2896 entradas de @code{make-rhythmic-location} a la lista
2897 @code{clip-regions} dentro del bloque @code{\layout}.
2899 De forma predeterminada, cada fragmento de música se obtendrá en
2900 la salida como un archivo @code{EPS} distinto, pero también se
2901 pueden crear otros formatos como @code{PDF} o @code{PNG} si es
2902 necesario. La música extraída se obtiene en la salida como si
2903 hubiera sido literalmente @q{cortada} de la partitura original
2904 impresa, de forma que si un fragmento se extiende sobre una o más
2905 líneas, se genera un archivo de salida distinto por cada línea
2909 Referencia de la notación:
2910 @ref{El bloque layout}.
2912 Manual de utilización:
2913 @rprogram{Utilización desde la línea de órdenes}.
2917 @node Saltar la música corregida
2918 @subsection Saltar la música corregida
2919 @translationof Skipping corrected music
2921 @funindex skipTypesetting
2922 @funindex showFirstLength
2923 @funindex showLastLength
2925 Al escribir o copiar música, normalmente sólo es interesante de
2926 ver y corregir la música cercana al final (donde estamos
2927 añadiendo las notas). Para acelerar este proceso de corrección,
2928 es posible saltar la composición tipográfica de todos excepto
2929 unos pocos de los últimos compases. Esto se consigue poniendo
2932 showLastLength = R1*5
2933 \score @{ @dots{} @}
2937 en nuestro archivo fuente. Esto hará que se tracen sólo los
2938 últimos cinco compases (suponiendo un compás de 4/4) de cada una
2939 de las partituras @code{\score} del archivo de entrada. Para
2940 piezas largas, el tipografiado de únicamente una parte pequeña es
2941 con frecuencia un orden de magnitud más rápido que el de la obra
2942 completa. Si estamos trabajando sobre el principio de una
2943 partitura que ya hemos tipografiado (p.ej., para añadir una parte
2944 instrumental nueva), también puede ser útil la propiedad
2945 @code{showFirstLength}.
2947 Este mecanismo de pasar por alto partes de un partitura se puede
2948 controlar con un grano más fino mediante la propiedad
2949 @code{Score.skipTypesetting}. Cuando su valor está establecido,
2950 no se lleva a cabo ningún tipografiado en absoluto.
2952 Esta propiedad se usa también para controlar la salida hacia el
2953 archivo MIDI. Observe que pasa por alto todos los eventos,
2954 incluidos el tempo y los cambios de instrumento. Está usted
2957 @lilypond[quote,ragged-right,verbatim]
2960 \set Score.skipTypesetting = ##t
2963 \set Score.skipTypesetting = ##f
2968 En música polifónica, @code{Score.skipTypesetting} afecta a todas
2969 las voces y pentagramas, ahorrando más tiempo incluso.
2972 @node Formatos de salida alternativos
2973 @subsection Formatos de salida alternativos
2974 @translationof Alternative output formats
2976 @cindex salida de gráficos de vector escalables
2978 @cindex salida de PostScript encapsulado
2980 @cindex PostScript encapsulado, salida de
2982 Los formatos de salida predeterminados para la partitura impresa
2983 son el formato de documento portátil (PDF) y PostScript (PS).
2984 Los formatos de salida Gráficos de red portátiles (PNG),
2985 Gráficos de vector escalables (SVG) y PostScript encapsulado (EPS)
2986 también están disponibles a través de opciones de la línea de
2988 @rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
2991 @node Sustituir la tipografía de la notación
2992 @subsection Sustituir la tipografía de la notación
2993 @translationof Replacing the notation font
2995 Gonville es una alternativa a la tipografía Feta que se utiliza
2996 en LilyPond y se puede descargar de:
2998 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
3001 Aquí presentamos algunos compases de muestra tipografiados con la
3004 @c NOTE: these images are a bit big, but that's important
3005 @c for the font comparison. -gp
3006 @sourceimage{Gonville_after,15cm,,}
3008 Aquí hay unos compases de muestra tipografiados en la fuente Feta
3011 @sourceimage{Gonville_before,15cm,,}
3013 @subsubheading Instrucciones de instalación para MacOS
3015 Descargue y extraiga el archivo zip. Copie la carpeta
3016 @code{lilyfonts} a @file{@var{SHARE_DIR}/lilypond/current}; para
3017 más información, consulte @rlearning{Otras fuentes de
3018 información}. Renombre la carpeta @code{fonts} existente a
3019 @code{fonts_orig} y la carpeta @code{lilyfonts} a @code{fonts}.
3020 Para volver a la fuente Feta, invierta el proceso.
3023 Manual de aprendizaje:
3024 @rlearning{Otras fuentes de información}.
3027 Gonville no se puede usar para tipografiar notación de @q{Música
3028 Antigua} y es probable que cualquier nuevo glifo en versiones
3029 posteriores de LilyPond no existan en la familia tipográfica
3030 Gonville. Diríjase a la página web del autor para obtener más
3031 información sobre éste y otros asuntos, entre ellos el régimen de
3032 licencias de Gonville.
3035 @node Creación de salida MIDI
3036 @section Creación de salida MIDI
3037 @translationof Creating MIDI output
3042 LilyPond puede producir archivos que siguen el estándar MIDI
3043 (Musical Instrument Digital Interface; interfaz digital para
3044 instrumentos musicales) y permitir así comprobar la música por el
3045 oído (con la ayuda de alguna aplicación o dispositivo que
3046 entienda el MIDI). La escucha de la salida MIDI también puede
3047 ser de ayuda en la localización de errores tales como notas que
3048 se han introducido incorrectamente, alteraciones omitidas y otros
3049 casos por el estilo.
3051 Los archivos MIDI no contienen sonido (como los archivos AAC, MP3
3052 o Vorbis) pero requieren software adicional para producir el
3053 sonido a partir de ellos.
3056 * Notación contemplada por el MIDI::
3057 * Notación no contemplada en el MIDI::
3059 * Control de las dinámicas del MIDI::
3060 * Uso de los instrumentos MIDI::
3061 * Uso de las repeticiones con el MIDI::
3062 * Asignación de canales MIDI::
3063 * Propiedades de contexto para efectos MIDI::
3064 * Enriquecimiento de la salida MIDI::
3065 * El script Articulate::
3068 @cindex MIDI, notación contemplada
3070 @node Notación contemplada por el MIDI
3071 @subsection Notación contemplada por el MIDI
3072 @translationof Supported notation for MIDI
3074 Se puede usar la notación musical siguiente con las posibilidades
3075 predeterminadas de LilyPond para producir salida MIDI:
3078 @item Marcas de respiración
3079 @item Acordes introducidos como nombres de acorde
3080 @item Crescendos y decrescendos sobre más de una nota. El volumen se altera de forma lineal entre los dos extremos
3081 @item Indicadores dinámicos desde @code{ppppp} hasta @code{fffff}, incluyendo @code{mp}, @code{mf} y @code{sf}
3082 @item Microtonos, pero @emph{no} acordes microtonales. Se necesita también un reproductor de MIDI capaz de ejecutar eventos de rueda de tono.
3083 @item Letra de las canciones
3084 @item Altura de las notas
3085 @item Ritmo introducido como duraciones de las notas, incluidos los grupos de valoración especial como los tresillos
3086 @item Articulaciones @q{sencillas}; picado, staccato, acento, marcato y portato
3087 @item Cambios de tempo introducidos con la función @code{\tempo}
3088 @item Ligaduras de unión
3089 @item Trémolos que @emph{not} se hayan introducido como un valor del tipo @q{@code{:}[@var{número}]}
3092 También se pueden controlar el panorama, el balance, la expresión
3093 y los efectos de reverberación y chorus mediante el
3094 establecimiento de propiedades de contexto, véase
3095 @ref{Propiedades de contexto para efectos MIDI}.
3097 Si se combina con el script @file{articulate}, es posible
3098 producir la salida por el MIDI de los siguientes elementos
3099 adicionales de notación musical:
3102 @item Appoggiaturas (apoyaturas). Se les da la mitad de la duración de la nota siguiente (sin tener en cuenta los puntillos). Por ejemplo:
3105 \appoggiatura c8 d2.
3109 El Do toma la duración de una negra.
3111 @item Notas y grupos de adorno (mordentes de una nota, trinos, grupetos circulares, etc.)
3112 @item Rallentando, accelerando, ritardando y a tempo
3113 @item Ligaduras de expresión y de fraseo
3118 Véase @ref{Enriquecimiento de la salida MIDI}.
3120 @cindex MIDI, notación no contemplada
3122 @node Notación no contemplada en el MIDI
3123 @subsection Notación no contemplada en el MIDI
3124 @translationof Unsupported notation for MIDI
3126 Los siguientes elementos de notación musical no se pueden hacer
3130 @item Articulaciones distintas al picado, staccato, acento, marcato y portato
3131 @item Crescendos y decrescendos sobre una @emph{sola} nota
3135 @item Caídas y elevaciones
3136 @item Acordes microtonales
3137 @item Duraciones introducidas como anotaciones, p.ej. el swing
3138 @item Cambios de tempo sin @code{\tempo} (p.ej., introducidas como anotaciones)
3139 @item Trémolos que @emph{se introducen} con la notación de la forma @q{@code{:}[@var{número}]}
3143 @node El bloque MIDI
3144 @subsection El bloque MIDI
3145 @translationof The MIDI block
3149 Para crear un archivo de salida MIDI a partir de un archivo de
3150 entrada de LilyPond, introduzca un bloque @code{\midi}, que puede
3151 estar vacío, dentro del bloque @code{\score}:
3155 @var{@dots{} música @dots{}}
3161 @warning{ Un bloque @code{@bs{}score} que, además de la música,
3162 contiene solamente un bloque @code{@bs{}midi} (o sea, @emph{sin}
3163 el bloque @code{@bs{}layout}), solo produce archivos de salida
3164 MIDI; no se imprime ninguna notación musical.}
3166 La extensión predeterminada para los archivos de salida
3167 (@code{.midi}) se puede cambiar usando la opción
3168 @code{-dmidi-extension} con la instrucción @code{lilypond}:
3171 lilypond -dmidi-extension=mid Archivo.ly
3174 Como alternativa, puede añadirse la siguiente expresión de Scheme
3175 antes del comienzo de uno de los bloques @code{\book},
3176 @code{\bookpart} o @code{\score}. Véase @ref{Estructura del archivo}.
3179 #(ly:set-option 'midi-extension "mid")
3183 Referencia de la notación:
3184 @ref{Estructura del archivo}.
3186 Archivos instalados:
3187 @file{scm/midi.scm}.
3190 Están disponibles 15 canales MIDI y un canal adicional (el número
3191 10) para la percusión. Los pentagramas se asignan a los canales
3192 por orden, de forma que una partitura que contenga más de 15
3193 pentagramas da como resultado que los pentagramas adicionales
3194 comparten (pero no sobreescriben) el mismo canal MIDI. Esto
3195 puede ser problemático si los pentagramas que comparten canal
3196 tienen establecidas propiedades MIDI, basadas en canal, en mutuo
3197 conflicto (como distintos instrumentos MIDI).
3200 @node Control de las dinámicas del MIDI
3201 @subsection Control de las dinámicas del MIDI
3202 @translationof Controlling MIDI dynamics
3204 Es posible controlar el volumen MIDI general, el volumen relativo
3205 de las indicaciones de matiz dinámico y el volumen relativo de
3206 los distintos instrumentos.
3208 Las indicaciones matiz dinámico se traducen automáticamente a
3209 niveles de volumen dentro del rango de volúmenes MIDI disponible
3210 mientras que los crescendos y decrescendos varían el volumen
3211 linealmente entre sus dos extremos. Es posible controlar el
3212 volumen relativo de las indicaciones de matiz dinámico, y el
3213 volumen general de los diferentes instrumentos.
3216 * Indicaciones de matiz dinámico en el MIDI::
3217 * Establecimiento del volumen MIDI::
3218 * Establecimiento de las propiedades del bloque MIDI::
3221 @cindex MIDI, volumen
3222 @cindex MIDI, ecualización
3223 @cindex MIDI, matices dinámicos
3224 @cindex dinámica del MIDI
3227 @node Indicaciones de matiz dinámico en el MIDI
3228 @unnumberedsubsubsec Indicaciones de matiz dinámico en el MIDI
3229 @translationof Dynamic marks in MIDI
3231 Solo las marcas de dinámica desde @code{ppppp} hasta
3232 @code{fffff}, incluidos @code{mp}, @code{mf} y @code{sf} tienen
3233 valores asignados. Este valor se aplica a continuación al valor
3234 del rango de volumen MIDI general para obtener el volumen final
3235 que se incluye en la salida MIDI para esa indicación de matiz
3236 dinámico en particular. Las fracciones predeterminadas varían
3237 desde 0.25 para el @notation{ppppp} hasta 0.95 para el
3238 @notation{fffff}. El conjunto completo de las indicaciones de
3239 matiz dinámico pueden verse en el archivo @file{scm/midi.scm}.
3243 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3244 {creating-custom-dynamics-in-midi-output.ly}
3246 Archivos instalados:
3247 @file{ly/script-init.ly}
3248 @file{scm/midi.scm}.
3250 Fragmentos de código:
3253 Referencia de funcionamiento interno:
3254 @rinternals{Dynamic_performer}.
3257 @node Establecimiento del volumen MIDI
3258 @unnumberedsubsubsec Establecimiento del volumen MIDI
3259 @translationof Setting MIDI volume
3261 Los volúmenes generales mínimo y máximo de las indicaciones de
3262 matiz dinámico MIDI se controlan estableciendo las propiedades
3263 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel
3264 del bloque @code{Score}. Estas propiedades tienen efecto
3265 solamente al comienzo de una vos y sobre las indicaciones
3266 dinámicas. La fracción que corresponde a cada indicación
3267 dinámica se modifica con esta fórmula:
3270 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
3273 En el ejemplo siguiente, el rango dinámico del volumen MIDI
3274 general se limita al intervalo entre @code{0.2} y @code{0.5}.
3280 \set Staff.midiInstrument = #"flute"
3281 @var{@dots{} music @dots{}}
3284 \set Staff.midiInstrument = #"clarinet"
3285 @var{@dots{} music @dots{}}
3291 midiMinimumVolume = #0.2
3292 midiMaximumVolume = #0.5
3298 Se puede obtener una ecualización sencilla de instrumentos MIDI
3299 estableciendo las propiedades @code{midiMinimumVolume} y
3300 @code{midiMaximumVolume} dentro del contexto @code{Staff}.
3305 \set Staff.midiInstrument = #"flute"
3306 \set Staff.midiMinimumVolume = #0.7
3307 \set Staff.midiMaximumVolume = #0.9
3308 @var{@dots{} music @dots{}}
3314 Para partituras con más de un pentagrama y más de un instrumento
3315 MIDI, se pueden fijar individualmente los volúmenes relativos de
3322 \set Staff.midiInstrument = #"flute"
3323 \set Staff.midiMinimumVolume = #0.7
3324 \set Staff.midiMaximumVolume = #0.9
3325 @var{@dots{} music @dots{}}
3328 \set Staff.midiInstrument = #"clarinet"
3329 \set Staff.midiMinimumVolume = #0.3
3330 \set Staff.midiMaximumVolume = #0.6
3331 @var{@dots{} music @dots{}}
3338 En este ejemplo el volumen del clarinete se reduce de forma
3339 relativa al volumen de la flauta.
3341 Si no se establecen estas propiedades de volumen, LilyPond aún
3342 aplica un @q{pequeño grado} de ecualización a ciertos
3343 instrumentos. Véase @file{scm/midi.scm}.
3345 Archivos instalados:
3346 @file{scm/midi.scm}.
3349 Referencia de la notación:
3350 @ref{Disposición de la partitura}.
3352 Referencia de funcionamiento interno:
3353 @rinternals{Dynamic_performer}.
3356 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3357 {replacing-default-midi-instrument-equalization.ly}
3360 Los cambios en el volumen del MIDI solamente tienen lugar en el
3361 comienzo de una nota, por lo que los crescendos y decrescendos no
3362 afectan al volumen de una sola nota.
3364 @node Establecimiento de las propiedades del bloque MIDI
3365 @unnumberedsubsubsec Establecimiento de las propiedades del bloque MIDI
3366 @translationof Setting MIDI block properties
3368 El bloque @code{\midi} puede contener distintas disposiciones de
3369 los contextos, definiciones de contexto nuevas o código que fija
3370 los valores de ciertas propiedades.
3374 @var{@dots{} music @dots{}}
3381 Aquí, el tempo se establece a 72 pulsos de negra por minuto. La
3382 indicación de tempo dentro del bloque @code{\midi} no aparece en
3383 la partitura impresa. Aunque cualquier otra indicación de
3384 @code{\tempo} que se especifique dentro del bloque @code{\score}
3385 también se reflejará en la salida MIDI.
3387 Dentro de un bloque @code{\midi}, la instrucción @code{\tempo}
3388 está estableciendo propiedades durante la interpretación de la
3389 música y en el contexto de las definiciones de salida; así, se
3390 interpreta @emph{como si} fuera una modificación de contesto.
3392 @cindex MIDI, definiciones de contexto
3393 @cindex contexto, definiciones con MIDI
3395 Las definiciones de contexto siguen la misma sintaxis que las del
3396 bloque @code{\layout}:
3400 @var{@dots{} music @dots{}}
3404 \remove "Dynamic_performer"
3410 Este ejemplo suprime el efecto de las indicaciones dinámicas
3411 sobre la salida MIDI. Nota: los módulos de traducción de
3412 LilyPond usados para el sonido se llaman @q{performers}.
3415 Manual de aprendizaje:
3416 @rlearning{Otras fuentes de información}.
3418 Referencia de la notación:
3420 @ref{Disposición de la partitura}.
3422 Archivos instalados:
3423 @file{ly/performer-init.ly}.
3425 Fragmentos de código:
3428 Referencia de funcionamiento interno:
3429 @rinternals{Dynamic_performer}.
3432 Ciertos reproductores de MIDI no siempre maneja correctamente los
3433 cambios de tempo en la salida MIDI.
3435 Los cambios efectuados al @code{midiInstrument}, así como ciertas
3436 opciones MIDI, al @emph{comienzo} de un pentagrama pueden
3437 aparecer dos veces en la salida MIDI.
3441 @node Uso de los instrumentos MIDI
3442 @subsection Uso de los instrumentos MIDI
3443 @translationof Using MIDI instruments
3445 Los instrumentos MIDI se establecen usando la propiedad
3446 @code{midiInstrument} dentro de un contexto @code{Staff}.
3451 \set Staff.midiInstrument = #"glockenspiel"
3452 @var{@dots{} music @dots{}}
3462 \new Staff \with @{midiInstrument = #"cello"@} @{
3463 @var{@dots{} music @dots{}}
3469 Si el instrumento elegido no coincide exactamente con uno de los
3470 instrumentos de la lista de la sección @q{instrumentos MIDI}, se
3471 usará el instrumento Piano de Cola (@code{"acoustic grand"}).
3472 Véase @ref{Instrumentos MIDI}.
3475 Manual de aprendizaje:
3476 @rlearning{Otras fuentes de información}.
3478 Referencia de la notación:
3479 @ref{Instrumentos MIDI},
3480 @ref{Disposición de la partitura}.
3482 Archivos instalados:
3483 @file{scm/midi.scm}.
3486 Los instrumentos de percusión cuya notación está en un contexto
3487 @code{DrumStaff} se encontrará a la salida, correctamente, sobre
3488 el canal MIDI número@tie{}10 pero ciertos instrumentos de
3489 percusión afinada como el xilófono, el vibráfono o los timbales,
3490 se tratan como instrumentos @qq{normales}, de forma que la música
3491 de éstos se debe introducir en un contexto @code{Staff} (no
3492 @code{DrumStaff}) para obtener una salida MIDI correcta. Hay una
3493 lista completa de entradas de los @code{sets de percusión del
3494 canal 10} en el archivo @file{scm/midi.scm}. Véase
3495 @rlearning{Otras fuentes de información}.
3498 @node Uso de las repeticiones con el MIDI
3499 @subsection Uso de las repeticiones con el MIDI
3500 @translationof Using repeats with MIDI
3502 @cindex repeticiones en MIDI
3503 @cindex MIDI con repeticiones
3504 @funindex \unfoldRepeats
3506 Las repeticiones se pueden representar en la salida MIDI
3507 aplicando la instrucción @code{\unfoldRepeats}.
3512 \repeat tremolo 8 @{ c'32 e' @}
3513 \repeat percent 2 @{ c''8 d'' @}
3514 \repeat volta 2 @{ c'4 d' e' f' @}
3524 Para restringir el efecto de @code{\unfoldRepeats} a la salida
3525 MIDI únicamente, y al mismo tiempo genera partituras imprimibles,
3526 es necesario hacer @emph{dos} bloques @code{\score}: uno para el
3527 MIDI (con las repeticiones desplegadas) y otro para la notación
3528 (con repeticiones de primera y segunda vez, trémolos y del tipo
3533 @var{@dots{} music @dots{}}
3538 @var{@dots{} music @dots{}}
3544 Si se usan varias voces, cada una de ellas debe contener las
3545 repeticiones completamente desplegadas para poder obtener una
3546 salida MIDI correcta.
3549 Referencia de la notación:
3553 @node Asignación de canales MIDI
3554 @subsection Asignación de canales MIDI
3555 @translationof MIDI channel mapping
3557 @cindex MIDI, canales
3558 @cindex MIDI, pistas
3559 @funindex midiChannelMapping
3561 Cuando se está generando un archivo MIDI de una partitura,
3562 LilyPond asigna cada nota de la partitura automáticamente a un
3563 canal MIDI, aquel en que se tocaría cuando se envía hacia un
3564 dispositivo MIDI. Un canal MIDI tiene una cierta cantidad de
3565 controles disponibles para seleccionar, por ejemplo, el
3566 instrumento que usar para reproducir las notas en ese canal, u
3567 ordenar al dispositivo MIDI que aplique diversos efectos al
3568 sonido producido sobre el canal. En todo momento, cada control
3569 de un canal MIDI solo puede tener asignado un valor único (que
3570 sin embargo se puede modificar, por ejemplo, para cambiar a otro
3571 instrumento en mitad de una partitura).
3573 El estándar MIDI contempla solamente 16 canales por dispositivo
3574 MIDI. Este límite en el número de canales limita también el
3575 número de instrumentos diferentes que pueden estar tocando al
3578 LilyPond crea pistas MIDI separadas para cada pentagrama (o
3579 instrumento o voz, según el valor de
3580 @code{Score.midiChannelMapping}), y también para cada contexto de
3581 letra. No hay un límite para el número de pistas.
3583 Para solventar el número limitado de canales MIDI, LilyPond
3584 contempla algunos modos diferentes para la asignación de canales
3585 MIDI, que se seleccionan usando la propiedad de contexto
3586 @code{Score.midiChannelMapping}. En cada caso, si se necesitan
3587 más canales MIDI que el límite, los números de canal asignados
3588 vuelven a contar desde cero, causando posiblemente una asignación
3589 incorrecta de instrumento a algunas notas. Esta propiedad de
3590 contexto se puede fijar a uno de los siguientes valores:
3596 Reservar un canal MIDI distinto para cada uno de los pentagramas
3597 de la partitura (es el ajuste predeterminado). Todas las notas
3598 de todas las voces comparten el canal MIDI del pentagrama que las
3599 encierra, y todas se codifican dentro de la misma pista MIDI.
3601 El límite de 16 canales se aplica al número total de contextos de
3602 pentagrama y de letra, incluso aunque las letras del MIDI no
3603 consumen un canal MIDI.
3605 @item @code{'instrument}
3607 Reservar un canal MIDI distinto a cada uno de los instrumentos
3608 diferentes especificados en la partitura. Esto significa que
3609 todas las notas reproducidas con el mismo instrumento MIDI
3610 comparten el mismo canal MIDI (y la misma pista), incluso aunque
3611 las notas provengan de diferentes voces o pentagramas.
3613 En este caso los contextos de letra no cuentan para el límite de
3614 16 canales MIDI (ya que no se asignan a un instrumento MIDI), de
3615 forma que este ajuste puede permitir una mejor distribución de
3616 los canales MIDI cuando el número de contextos de pentagrama y de
3617 letra en la partitura excede la cantidad de 16.
3621 Reservar un canal MIDI distinto a cada voz de la partitura que
3622 tenga un nombre único entre las voces de su pentagrama
3623 circundante. Las voces de los distintos pentagramas siempre se
3624 asignan a distintos canales MIDI pero dos voces cualesquiera
3625 contenidas dentro del mismo pentagrama comparten el mismo canal
3626 MIDI sin tienen el mismo nombre. A causa de que
3627 @code{midiInstrument} y los diversos controles MIDI para los
3628 efectos son propiedades del contexto de pentagrama, no se pueden
3629 fijar independientemente para cada voz. La primera voz se
3630 reproduce con el instrumento y los efectos especificados para el
3631 pentagrama, y las voces con un nombre distinto de la primera
3632 recibirán el instrumento y los efectos predeterminados.
3634 Nota: se pueden asignar distintos instrumentos y/o efectos a
3635 varias voces dentro del mismo pentagrama moviendo el
3636 @code{Staff_performer} del contexto @code{Staff} al contexto
3637 @code{Voice}, y dejando que @code{midiChannelMapping} conserve su
3638 valor predeterminado de @code{'staff} o se fije al valor
3639 @code{'instrument}; véase el fragmento de código siguiente.
3643 Por ejemplo, la asignación predeterminada de canal MIDI de una
3644 partitura puede cambiarse al ajuste @code{'instrument} como se
3645 muestra a continuación:
3653 midiChannelMapping = #'instrument
3660 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
3661 {changing-midi-output-to-one-channel-per-voice.ly}
3664 @node Propiedades de contexto para efectos MIDI
3665 @subsection Propiedades de contexto para efectos MIDI
3666 @translationof Context properties for MIDI effects
3668 @cindex Efectos en MIDI
3669 @cindex Panorama en MIDI
3670 @cindex Balance en MIDI
3671 @cindex Estéreo, balance en MIDI
3672 @cindex Expresión en MIDI
3673 @cindex Reverberación en MIDI
3674 @cindex Chorus en MIDI
3675 @funindex midiPanPosition
3676 @funindex midiBalance
3677 @funindex midiExpression
3678 @funindex midiReverbLevel
3679 @funindex midiChorusLevel
3681 Se pueden usar las siguientes propiedades de contexto para
3682 aplicar diversos efectos MIDI a las notas que se reproducen sobre
3683 el canal MIDI asociado con el pentagrama, instrumento MIDI o voz
3684 actual (dependiendo del valor de la propiedad de contexto
3685 @code{Score.midiChannelMapping} y del contexto en que está
3686 situado el @code{Staff_performer}; véase @ref{Asignación de
3689 Los cambios en estas propiedades de contexto afectan a todas las
3690 notas que se reproducen sobre el canal después del cambio, aunque
3691 algunos de los efectos se pueden incluso aplicar también a notas
3692 que están ya sonando en ese momento (dependiendo de la
3693 implementación del dispositivo de salida MIDI).
3695 Se contemplan las siguientes propiedades de contexto:
3699 @item @code{Staff.midiPanPosition}
3701 La posición de panorama controla cómo se distribuye el sonido de
3702 un canal MIDI entre las salidas estéreo izquierda y derecha. La
3703 propiedad de contexto acepta un número entre -1.0 (@code{#LEFT})
3704 y 1.0 (@code{#RIGHT}); el valor -1.0 pone toda la potencia de
3705 sonido en la salida estéreo izquierda (dejando la salida derecha
3706 en completo silencio), el valor 0.0 (@code{#CENTER}) distribuye
3707 el sonido por igual entre las salidas estéreo izquierda y
3708 derecha, y el valor 1.0 mueve todo el sonido a la salida estéreo
3709 derecha. Los valores entre -1.0 y 1.0 se pueden usar para
3710 obtener distribuciones mezcladas entre las salidas estéreo
3711 izquierda y derecha.
3713 @item @code{Staff.midiBalance}
3715 Equilibrio estéreo de un canal MIDI. De forma similar a la
3716 posición de panorama esta propiedad de contexto acepta un número
3717 entre -1.0 (@code{#LEFT}) y 1.0 (@code{#RIGHT}). Varía el
3718 volumen relativo que se envía a los dos altavoces estéreo sin
3719 afectar a la distribución de las propias señales estéreo.
3721 @item @code{Staff.midiExpression}
3723 Nivel de expresión (como una fracción del nivel máximo
3724 disponible) que se aplica a un canal MIDI. Un dispositivo MIDI
3725 combina el nivel de expresión del canal MIDI con el nivel actual
3726 de dinámica de una voz (controlado mediante las instrucciones de
3727 dinámica como @code{\p} o @code{\ff}) para obtener el volumen
3728 total de cada nota dentro de la voz. El control de expresión se
3729 puede usar, por ejemplo, para implementar efectos de crescendo y
3730 decrescendo sobre notas mantenidas (algo que LilyPond no
3731 contempla de forma automática).
3733 @c Issue 4059 contains an attached snippet which shows how this might
3734 @c be done, but this is too large and complex for the NR, even as a
3735 @c referenced snippet. It could be added to the LSR.
3737 El rango de los niveles de expresión se extiende desde 0.0
3738 (ninguna expresión, lo que significa un volumen nulo) hasta 1.0
3739 (expresión al máximo).
3741 @item @code{Staff.midiReverbLevel}
3743 El nivel de reverberación (cono una fracción del máximo nivel
3744 disponible) que se aplica a un canal MIDI. Esta propiedad acepta
3745 números entre 0.0 (sin reverberación) y 1.0 (efecto máximo).
3747 @item @code{Staff.midiChorusLevel}
3749 Nivel del efecto Chorus (como una fracción del máximo nivel
3750 disponible) que se aplica a un canal MIDI. Esta propiedad acepta
3751 números entre 0.0 (sin efecto de chorus) y 1.0 (efecto al
3759 Dado que los archivos MIDI no contienen en realidad ninguna
3760 información sonora, los cambios en estas propiedades de contexto
3761 solamente se convierten en peticiones para que cambien los
3762 controles de canal MIDI dentro de los archivos MIDI emitidos. Si
3763 un dispositivo MIDI determinado (como un reproductor MIDI por
3764 software) puede de hecho manejar cualquiera de estas solicitudes
3765 de un archivo MIDI, es algo que depende totalmente de la
3766 implementación del mismo: un dispositivo podría optar por ignorar
3767 algunas o todas estas solicitudes. Asimismo, la forma en que un
3768 dispositivo MIDI interpreta los diferentes valores de estos
3769 controles (generalmente, el estándar MIDI determina el
3770 comportamiento solamente en los puntos extremos del rango de
3771 valores disponibles para cada control), y el hecho de si un
3772 cambio en el valor de un control afecta a las notas que ya se
3773 están reproduciendo sobre ese canal MIDI o no, también son
3774 aspectos específicos de la implementación del dispositivo MIDI.
3776 Al generar archivos MIDI, LilyPond sencillamente convierte de
3777 forma lineal los valores fraccionarios dentro de cada rango (7
3778 bits, o 14 bits para los controles de canal MIDI que admiten
3779 resolución fina) en valores enteros dentro del rango
3780 correspondiente (de 0 a 127 o de 0 a 32767, respectivamente),
3781 redondeando los valores fraccionarios hacia el entero más próximo
3782 en dirección opuesta al cero. Los valores enteros convertidos se
3783 almacenan tal cual en el archivo MIDI generado. Consulte la
3784 documentación de su dispositivo MIDI para ver información acerca
3785 de cómo interpreta estos valores.
3788 @node Enriquecimiento de la salida MIDI
3789 @subsection Enriquecimiento de la salida MIDI
3790 @translationof Enhancing MIDI output
3793 * El script Articulate::
3796 La salida MIDI predeterminada es muy básica, pero se puede
3797 mejorar mediante la selección de los instrumentos MIDI las
3798 propiedades del bloque @code{\midi} y/o usando el script
3801 @cindex instrumentos, nombres
3802 @cindex MIDI, instrumentos
3803 @cindex articulate, script
3804 @cindex articulate.ly
3805 @funindex Staff.midiInstrument
3808 @node El script Articulate
3809 @subsection El script Articulate
3810 @translationof The Articulate script
3812 Para utilizar el script Articulate, tenemos que incluirlo al
3813 principio de nuestro archivo de entrada:
3816 \include "articulate.ly"
3819 El script crea una salida MIDI en que las notas tienen una
3820 duración ajustada en el tiempo de forma que se correspondan con
3821 una serie de indicaciones de articulación y de tempo. Sin
3822 embargo, la salida tipografiada también se altera para reflejar
3823 literalmente el contenido de la salida MIDI.
3828 @var{@dots{} music @dots{}}
3834 La instrucción @code{\articulate} habilita el procesado de las
3835 abreviaturas como trinos y mordentes de varias notas. En el
3836 propio script puede verse una lista completa de los elementos que
3837 están previstos. Véase @file{ly/articulate.ly}.
3840 Manual de aprendizaje:
3841 @rlearning{Otras fuentes de información}.
3843 Referencia de la notación:
3846 Archivos instalados:
3847 @file{ly/articulate.ly}.
3849 @warning{El script @file{articulate} puede acortar los acordes,
3850 lo que podría no ser adecuado para algunos tipos de instrumento,
3851 como el órgano. Las notas que no tienen ninguna articulación
3852 también se pueden acortar; así, para contener el alcance
3853 de este efecto limite
3854 el uso de de la función @code{\articulate} a segmentos de música
3855 más breves o modifique los valores de las variables definidas
3856 dentro del script @file{articulate}
3857 para compensar el efecto de acortamiento de las notas.}
3861 @node Extraer información musical
3862 @section Extraer información musical
3863 @translationof Extracting musical information
3865 Además de crear un resultado visual y MIDI, LilyPond es capaz de
3866 presentar información musical en forma de texto.
3869 * Impresión del código de notación de LilyPond::
3870 * Impresión de las expresiones musicales de Scheme::
3871 * Guardar los eventos musicales en un archivo::
3875 @node Impresión del código de notación de LilyPond
3876 @subsection Displaying LilyPond notation
3877 @translationof Displaying LilyPond notation
3879 @funindex \displayLilyMusic
3880 La impresión textual de una expresión musical en notación de
3881 LilyPond puede hacerse con la función musical
3882 @code{\displayLilyMusic}. Para ver el resultado, lo más usual es
3883 llamar a LilyPond mediante la línea de órdenes. Por ejemplo,
3887 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3891 imprime lo siguiente:
3894 @{ a,4 cis e fis g @}
3897 De forma predeterminada, LilyPond imprime estos mensajes en la
3898 consola junto al resto de los mensajes de la compilación de
3899 LilyPond. Para discernir entre estos mensajes y guardar el
3900 resultado de @code{\displayLilyMusic}, redireccione la salida
3904 lilypond archivo.ly >resultado.txt
3908 Observe que Lilypond no se limita a mostrar la expresión musical,
3909 sino que también la interpreta (porque @code{\displayLilyMusic}
3910 la devuelve además de mostrarla). Simplemente inserte
3911 @code{\displayLilyMusic} dentro de
3912 la música existente con el objeto de obtener información sobre
3915 Para interpretar y mostrar una sección de música en la consola,
3916 y al mismo tiempo suprimirla del archivo de salida,
3917 use la instrucción @code{\void}.
3921 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3927 @node Impresión de las expresiones musicales de Scheme
3928 @subsection Impresión de las expresiones musicales de Scheme
3929 @translationof Displaying scheme music expressions
3931 Véase @rextend{Presentación de las expresiones musicales}.
3934 @node Guardar los eventos musicales en un archivo
3935 @subsection Guardar los eventos musicales en un archivo
3936 @translationof Saving music events to a file
3938 Los eventos musicales se pueden guardar en un archivo pentagrama
3939 a pentagrama mediante la inclusión de un archivo en nuestra
3940 partitura principal.
3943 \include "event-listener.ly"
3946 De esta forma se crean uno o más archivos llamados
3947 @file{FILENAME-STAFFNAME.notes} ó
3948 @file{FILENAME-unnamed-staff.notes} para cada pentagrama.
3949 Observe que si tiene más de un pentagrama sin nombre, los eventos
3950 de todos los pentagramas se mezclarán entre sí dentro del mismo
3951 archivo. El resultado tiene el aspecto siguiente:
3954 0.000 note 57 4 p-c 2 12
3956 0.250 note 62 4 p-c 7 12
3957 0.500 note 66 8 p-c 9 12
3958 0.625 note 69 8 p-c 14 12
3963 La sintaxis consiste en una línea delimitada por caracteres de
3964 tabulación, con dos campos fijos en cada línea seguidos de
3965 parámetros opcionales.
3968 @var{tiempo} @var{tipo} @var{@dots{}parámetros@dots{}}
3971 Esta información se puede leer fácilmente por parte de otros
3972 programas como guiones de Python, y pueden ser muy útiles para
3973 aquellos investigadores que desean realizar un análisis musical o
3974 hacer experimentos de reproducción con LilyPond.
3977 No todos los eventos musicales de lilypond están contemplados por
3978 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
3979 concepto} bien realizada. Si algunos eventos que quiere ver no
3980 aparecen incluidos, copie @file{event-listener.ly} en su carpeta
3981 de lilypond y modifique el archivo de forma que produzca la
3982 información que desea.