1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 799d9e5ab487eb45de64c0347fd096b48680a3f2
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Entrada y salida generales
14 @chapter Entrada y salida generales
15 @translationof General input and output
17 Esta sección trata de asuntos relacionados con la entrada y salida
18 generales de LilyPond, más que con la notación específica.
21 * Estructura del código de entrada::
22 * Títulos y encabezamientos::
23 * Trabajar sobre los archivos de entrada::
24 * Controlar la salida::
26 * Extraer información musical::
30 @node Estructura del código de entrada
31 @section Estructura del código de entrada
32 @translationof Input structure
34 El formato principal de entrada para LilyPond son archivos de texto.
35 Por convenio, el nombre de estos archivos termina en @file{.ly}.
38 * Estructura de una partitura::
39 * Varias partituras en un libro::
40 * Varios archivos de salida a partir de uno de entrada::
41 * Nombres de los archivos de salida::
42 * Estructura del archivo::
46 @node Estructura de una partitura
47 @subsection Estructura de una partitura
48 @translationof Structure of a score
52 Un bloque @code{\score} debe contener una expresión musical única
53 delimitada por un par de llaves:
62 @warning{Sólo puede haber @strong{una} expresión musical dentro del
63 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
65 Esta expresión musical única puede tener cualquier tamaño, y puede
66 contener otras expresiones musicales hasta cualquier grado de
67 complejidad. Todos los siguientes ejemplos son expresiones musicales:
73 @lilypond[verbatim,quote]
80 @lilypond[verbatim,quote]
82 \new Staff { c'4 c' c' c' }
83 \new Staff { d'4 d' d' d' }
91 \new Staff @{ \flute @}
92 \new Staff @{ \oboe @}
95 \new Staff @{ \violinI @}
96 \new Staff @{ \violinII @}
102 Los comentarios son una excepción a esta regla general (para ver otras
103 excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
104 una línea como los que están delimitados por @code{%@{ .. %@}} se
105 pueden escribir en cualquier lugar dentro del archivo de entrada. Se
106 pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
107 fuera de la expresión musical única dentro del bloque @code{\score}.
109 Recuerde que incluso dentro de un archivo que contenga solamente un
110 bloque @code{\score}, éste se encuentra incluido implícitamente dentro
111 de un bloque @code{\book}. Un bloque @code{\book} dentro de un
112 archivo fuente produce al menos un archivo de salida, y de forma
113 predeterminada el nombre del archivo de salida que se produce está
114 derivado del nombre del archivo de entrada, de forma que
115 @file{fandangoforelephants.ly} da como resultado
116 @file{fandangoforelephants.pdf}.
118 (Para ver más detalles acerca de los bloques @code{\book}, consulte
119 @ref{Varias partituras en un libro}, @ref{Varios archivos de salida a
120 partir de uno de entrada} y @ref{Estructura del archivo}.)
123 Manual de aprendizaje:
124 @rlearning{Trabajar sobre los archivos de entrada},
125 @rlearning{Explicación de las expresiones musicales},
126 @rlearning{La partitura es una (única) expresión musical compuesta}.
129 @node Varias partituras en un libro
130 @subsection Varias partituras en un libro
131 @translationof Multiple scores in a book
134 @cindex movimientos, varios
136 Un documento puede contener varias piezas de música y texto. Son
137 ejemplos un libro de estudios o una parte orquestal con varios
138 movimientos. Cada movimiento se introduce con un bloque
147 y los textos se introducen con un bloque @code{\markup}:
157 Todos los movimientos y textos que aparecen en el mismo archivo
158 @file{.ly} se tipografían normalmente en la forma de un solo archivo
173 Una excepción importante se da dentro de los documentos de
174 lilypond-book, en los que tenemos que escribir explícitamente un
175 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
176 salida el primer @code{\score} o @code{\markup}.
178 El encabezamiento de cada pieza se puede poner dentro del bloque
179 @code{\score}. Antes de cada movimiento, se imprime el nombre de la
180 pieza (@code{piece}) extraído del encabezamiento. El título del libro
181 entero se puede poner dentro del bloque @code{\book}, pero si no está
182 presente se inserta el encabezamiento @code{\header} que está al
183 principio del archivo.
187 title = "Ocho miniaturas"
188 composer = "Igor Stravinsky"
192 \header @{ piece = "Romanze" @}
195 ..texto de la segunda estrofa..
198 ..texto de la tercera estrofa..
202 \header @{ piece = "Menuetto" @}
208 Se pueden agrupar distintas piezas de música en partes de un libro
209 utilizando bloques @code{\bookpart}. Las partes de libro se separan
210 por medio de saltos de página, y pueden dar comienzo con un título,
211 como el libro propiamente dicho, mediante la especificación del bloque
217 title = "Título del libro"
218 subtitle = "Primera parte"
225 subtitle = "Segunda parte"
233 @node Varios archivos de salida a partir de uno de entrada
234 @subsection Varios archivos de salida a partir de uno de entrada
235 @translationof Multiple output files from one input file
237 Si queremos varios archivos de salida a partir del mismo archivo
238 @file{.ly}, podemos escribir varios bloques @code{\book}, donde cada
239 uno de estos bloques @code{\book} dará como resultado un archivo de
240 salida distinto. Si no especificamos ningún bloque @code{\book} en el
241 archivo, LilyPond trata implícitamente todo el archivo como un solo
242 bloque @code{\book}, véase @ref{Estructura del archivo}.
244 Al producir varios archivos a partir de un solo archivo fuente,
245 Lilypond se asegura de que ninguno de los archivos de salida de ningún
246 bloque @code{\book} sobreescribe el archivo de salida producido por un
247 @code{\book} anterior del mismo archivo de entrada.
249 Lo hace añadiendo un sufijo al nombre de la salida para cada libro
250 @code{\book} que utiliza el nombre del archivo de salida
251 predeterminado, derivado del archivo fuente de entrada.
253 El comportamiento predeterminado es añadir un sufijo con el número de
254 versión para cada nombre que pueda coincidir; así:
259 \layout @{ @dots{} @}
263 \layout @{ @dots{} @}
267 \layout @{ @dots{} @}
271 en el archivo fuente @file{eightminiatures.ly}, produce
275 @file{eightminiatures.pdf},
277 @file{eightminiatures-1.pdf} y
279 @file{eightminiatures-2.pdf}.
283 @node Nombres de los archivos de salida
284 @subsection Nombres de los archivos de salida
285 @translationof Output file names
287 @funindex \bookOutputSuffix
288 @funindex \bookOutputName
290 Lilypond le ofrece unos mecanismos que le permiten controlar los
291 nombres de archivo que se utilizan por parte de los diversos motores
292 finales al producir los archivos de salida.
294 En la sección anterior vimos cómo Lilypond evita las coincidencias de
295 nombres al producir varias salidas a partir de un único archivo fuente
296 de entrada. También podemos especificar nuestros propios sufijos para
297 cada bloque @code{\book}, de manera que podemos producir, por ejemplo,
298 archivos con los nombres @file{eightminiatures-Romanze.pdf},
299 @file{eightminiatures-Menuetto.pdf} y
300 @file{eightminiatures-Nocturne.pdf} añadiendo una declaración
301 @code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
305 \bookOutputSuffix "Romanze"
307 \layout @{ @dots{} @}
310 \bookOutputSuffix "Menuetto"
312 \layout @{ @dots{} @}
315 \bookOutputSuffix "Nocturne"
317 \layout @{ @dots{} @}
321 También podemos especificar un nombre de archivo de salida diferente
322 para cada bloque @code{book}, mediante la utilización de declaraciones
323 @code{\bookOutputName}:
327 \bookOutputName "Romanze"
329 \layout @{ @dots{} @}
332 \bookOutputName "Menuetto"
334 \layout @{ @dots{} @}
337 \bookOutputName "Nocturne"
339 \layout @{ @dots{} @}
343 El código anterior produce los siguientes archivos de salida:
349 @file{Menuetto.pdf} y
355 @node Estructura del archivo
356 @subsection Estructura del archivo
357 @translationof File structure
367 Un archivo @file{.ly} puede contener cualquier número de expresiones
368 del nivel superior, donde una expresión del nivel superior es una de
369 las siguientes posibilidades:
373 Una definición de salida, como @code{\paper}, @code{\midi} y
374 @code{\layout}. Tal definición en el nivel más alto cambia los
375 ajustes predeterminados para todo el libro. Si se introduce más de
376 una de estas definiciones del mismo tipo en el nivel más alto, las
377 definiciones se combinan, pero en situaciones de conflicto las
378 definiciones más tardías tienen preferencia. Para ver los detalles
379 sobre cómo afecta al bloque @code{\layout}, consulte
380 @ref{El bloque \layout}.
383 Una expresión directa de Scheme, como
384 @code{#(set-default-paper-size "a7" 'landscape)} o
385 @code{#(ly:set-option 'point-and-click #f)}.
388 Un bloque @code{\header}. Esto establece el bloque de encabezamiento
389 global (es decir, al principio del archivo). Es el bloque que
390 contiene los ajustes predeterminados de los campos de encabezamientos
391 como el compositor, título, etc. para todos los libros que están
392 dentro del archivo (véase @ref{Explicación de los títulos}).
395 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
396 del nivel superior, y se combina con ellas formando un @code{\book}
397 (libro) único. Este comportamiento se puede cambiar estableciendo el
398 valor de la variable @code{toplevel-score-handler} en el nivel
399 superior. El @emph{handler} predeterminado se define en el archivo de
400 inicio @file{../scm/lily.scm}.
403 Un bloque @code{\book} combina lógicamente varios movimientos (es
404 decir, varios bloques @code{\score}) en un solo documento. Si hay
405 varias partituras @code{\score}, se crea un solo archivo de salida
406 para cada bloque @code{\book}, en el que se concatenan todos los
407 movimientos correspondientes. La única razón para especificar
408 explícitamente bloques @code{\book} en un archivo de entrada
409 @file{.ly} es si queremos crear varios archivos de salida a partir de
410 un único archivo de entrada. Una excepción se da dentro de los
411 documentos de lilypond-book, en los que tenemos que escribir
412 explícitamente un bloque @code{\book} si queremos tener más de una
413 única partitura @code{\score} o marcado @code{\markup} en el mismo
414 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
415 de la variable @code{toplevel-book-handler} en el nivel superior. El
416 @emph{handler} predeterminado se define en el archivo de inicio
417 @file{../scm/lily.scm}.
420 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
421 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
422 la inserción de saltos de página o usar distintos ajustes de
423 @code{\paper} en las distintas partes.
426 Una expresión musical compuesta, como
431 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
432 único junto a todas las demás partituras @code{\score} y expresiones
433 musicales del nivel superior. En otras palabras, un archivo que
434 contiene sólo la expresión musical anterior se traduce a
451 Se puede cambiar este comportamiento estableciendo el valor de la
452 variable @code{toplevel-music-handler} en el nivel más alto. El
453 @emph{handler} predeterminado se define en el archivo de inicio
454 @file{../scm/lily.scm}.
457 Un texto de marcado, por ejemplo una estrofa
460 2. Estrofa dos, línea uno
464 Los textos de marcado se colocan encima, en medio o debajo de las
465 partituras o expresiones musicales, según donde aparezcan escritos.
472 fulano = @{ c4 d e d @}
475 Esto se puede utilizar más tarde en el archivo escribiendo
476 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
477 alfabético; sin números, guiones ni barras bajas.
481 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
486 % No justificar la salida
497 En cualquier punto del archivo se pueden introducir cualquiera de las
498 instrucciones léxicas siguientes:
501 @item @code{\version}
502 @item @code{\include}
503 @item @code{\sourcefilename}
504 @item @code{\sourcefileline}
506 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
509 Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
513 @cindex espacios en blanco
515 Por lo general se ignoran los espacios entre elementos del flujo de
516 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
517 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
518 evitar errores, en las siguientes situaciones:
522 @item Alrededor de todas y cada una de las llaves curvas
523 de apertura y cierre.
525 @item A continuación de las instrucciones y variables, es decir,
526 todos los elementos que comienzan con un signo @code{\} de barra
529 @item A continuación de todo elemento que se deba interpretar
530 como expresión de Scheme, es decir, todo elemento que comience por
531 un signo@tie{}@code{#}.
533 @item Para separar los elementos de una expresión de Scheme.
535 @item Dentro de @code{lyricmode} antes y después de las instrucciones
536 @code{\set} y @code{\override}.
541 Manual de aprendizaje:
542 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
544 Referencia de la notación:
545 @ref{Explicación de los títulos},
546 @ref{El bloque \layout}.
548 @node Títulos y encabezamientos
549 @section Títulos y encabezamientos
550 @translationof Titles and headers
552 Casi toda la música impresa tiene un título y el nombre del
553 compositor; ciertas piezas tienen mucha más información.
556 * Crear títulos encabezamientos y pies de página::
557 * Títulos encabezamientos y pies de página personalizados::
558 * Crear notas al pie::
559 * Referencia a números de página::
564 @node Crear títulos encabezamientos y pies de página
565 @subsection Crear títulos, encabezamientos y pies de página
566 @translationof Creating titles headers and footers
569 * Explicación de los títulos::
570 * Presentación predeterminada de los títulos de partes de libro y partitura::
571 * Disposición predeterminada de las cabeceras y pies de página::
575 @node Explicación de los títulos
576 @unnumberedsubsubsec Explicación de los títulos
577 @translationof Titles explained
579 Cada bloque @code{\book} de un solo archivo de entrada produce un
580 archivo de salida distinto, véase @ref{Estructura del archivo}.
581 Dentro de cada archivo de salida están disponibles dos tipos de zonas
582 para títulos: @emph{Títulos de parte de libro} al principio de cada
583 parte de un libro y @emph{Títulos de partitura} al comienzo de una
586 Los valores de los campos para encabezamientos tales como @code{title}
587 (para el título) y @code{composer} (para el autor) se establecen en
588 bloques @code{\header} (para ver la sintaxis de los bloques
589 @code{\header} y una lista completa de los campos disponibles de forma
590 predeterminada, consulte @ref{Presentación predeterminada de los
591 títulos de partes de libro y partitura}). Tanto los títulos de parte
592 de libro como los títulos de partitura pueden contener los mismos
593 campos, aunque de forma predeterminada los campos de los títulos de
594 partitura se limitan a @code{piece} (pieza) y @code{opus}.
596 Los bloques @code{\header} se pueden situar en cuatro lugares
597 distintos para formar una jerarquía descendente de bloques
603 Al principio del archivo de entrada, antes de cualquier otro bloque
604 @code{\book}, @code{\bookpart} o @code{\score}.
607 Dentro de un bloque @code{\book} pero fuera de los bloques
608 @code{\bookpart} y @code{\score} que están dentro de ese libro.
611 Dentro de un bloque @code{\bookpart} pero fuera de cualquier bloque
612 @code{\score} dentro de dicha parte de libro.
615 Después de la expresión musical de un bloque @code{\score}.
619 Los valores de los campos se fitran a través de esta jerarquía,
620 persistiendo aquellos que se establecen más arriba a no ser que se
621 sobreescriban por un valor establecido más abajo en la jerarquía, y
627 Un título de parte de libro se deriva de los campos fijados al
628 principio del archivo de entrada, modificado por los campos
629 establecidos dentro del bloque @code{\book}, y posteriormente
630 modificado por los campos que se fijan dentro del bloque
631 @code{\bookpart}. Los valores resultantes se usan para imprimir el
632 título de parte de libro para esa parte.
635 Un título de partitura se deriva de los campos que se fijan al
636 principio del archivo de entrada, modificados por los campos fijados
637 dentro del bloque @code{\book}, posteriormente modificados por los
638 campos que se fijan dentro del bloque @code{\bookpart} y finalmente
639 modificados por los campos establecidos dentro del bloque
640 @code{\score}. Los valores restulantes se utilizan para imprimir el
641 título de partitura. Observe, sin embargo, que de forma
642 predeterminada solamente se imprimen los campos @code{piece} y
643 @code{opus} en los títulos de partitura a no ser que la variable de
644 @code{\paper}, @code{print-all-headers}, tenga el valor @code{#t}.
648 @warning{Recuerde que al poner un bloque @bs{}@code{header} dentro de
649 un bloque @bs{}@code{score}, la expresión musical debe aparecer antes
650 del bloque @bs{}@code{header}.}
652 No es necesario aportar bloques @code{\header} en los cuatro lugares:
653 cualquiera de ellos o incluso todos pueden omitirse. De forma
654 similar, los archivos de entrada sencillos pueden omitir los bloques
655 @code{\book} y @code{\bookpart}, dejando que se creen de forma
658 Si el lobro solamente tiene una partitura, el bloque @code{\header}
659 debiera situarse normalmente al principio del archivo de forma que
660 solamente se produce una zona de título de parte de libro, haciendo
661 que estén disponibles para su uso todos los títulos de
664 Si el libro tiene varias partituras, son posibles distintas
665 combinaciones de bloques @code{\header}, según los distintos tipos de
666 publicaciones musicales. Por ejemplo, si la publicación contiene
667 varias piezas del mismo autor, un bloque @code{\header} colocado al
668 principio del archivo que especifique el título del libro y el autor,
669 con bloques @code{\header} en cada bloque @code{\score} que
670 especifique la @code{piece} y/o el @code{opus} sería lo más adecuado,
673 @lilypond[papersize=a5,quote,verbatim,noragged-right]
676 composer = "J. S. Bach."
680 \new Staff \relative g, {
683 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
684 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
692 \new Staff \relative b {
696 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
697 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
705 Son posibles disposiciones más complejas. Por ejemplo, los campos de
706 texto extraídos del bloque @code{\header} de un libro se pueden
707 imprimir en todos los títulos de partitura, con ciertos campos
708 sobreescritos y otros suprimidos manualmente:
710 @lilypond[papersize=a5,quote,verbatim,noragged-right]
713 print-all-headers = ##t
716 title = "DAS WOHLTEMPERIRTE CLAVIER"
718 % Do not display the tagline for this book
721 \markup { \vspace #1 }
725 \new Staff { \clef "bass" s1 }
728 title = "PRAELUDIUM I"
730 % Do not display the subtitle for this score
737 \new Staff { \clef "bass" s1 }
741 subsubtitle = "A 4 VOCI"
743 % Do not display the subtitle for this score
751 Referencia de la notación:
752 @ref{Estructura del archivo},
753 @ref{Presentación predeterminada de los títulos de partes de libro y partitura},
754 @ref{Personalización de los títulos}.
757 @node Presentación predeterminada de los títulos de partes de libro y partitura
758 @unnumberedsubsubsec Presentación predeterminada de los títulos de partes de libro y partitura
759 @translationof Default layout of bookpart and score titles
761 Este ejemplo muestra todas las variables de @code{\header}:
764 @lilypond[papersize=a7,quote,verbatim,noragged-right]
767 % Los siguientes campos están centrados
768 dedication = "Dedication (dedicatoria)"
769 title = "Title (título)"
770 subtitle = "Subtitle (subtítulo)"
771 subsubtitle = "Subsubtitle (sub-subtítulo)"
772 % Los siguientes campos se distribuyen regularmente sobre una línea
773 % el campo "instrument" también aparece en las siguientes páginas
774 instrument = \markup \with-color #green "Instrument (instrumento)"
775 poet = "Poet (poeta)"
776 composer = "Composer (autor)"
777 % Los siguientes campos se sitúan en los extremos opuestos de la misma línea
778 meter = "Meter (metro)"
779 arranger = "Arranger (arreglista)"
780 % Los siguientes campos están centrados en la parte inferior
781 tagline = "la tagline o línea de etiqueta va al final de la úitlma página"
782 copyright = "el copyright va al final de la primera página"
787 % Los siguientes campos se colocan en los extremos de una línea
788 piece = "Piece (pieza) 1"
795 % Los siguientes campos se sitúan en los extremos de una línea
796 piece = "Piece (pieza) 2 en la misma página"
804 % Los siguientes campos se sitúan en los extremos de una línea
805 piece = "Piece (pieza) 3 en una página nueva"
816 El nombre de instrumento se repite en todas las páginas.
819 Solamente @code{piece} (la pieza) y @code{opus} se imprimen en una
820 @code{\score} cuando la variable de papel @code{print-all-headers} se
821 establece a @code{##f} (el valor predeterminado).
824 @c Is the bit about \null markups true? -mp
825 Los campos de texto que se dejan sin establecer dentro de un bloque
826 @code{\header} se sustituyen por elementos de marcado nulos
827 @code{\null} de manera que no ocupen espacio innecesariamente.
830 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan los
831 campos de texto @code{piece} y @code{opus} en extremos opuestos de la
836 Para cambiar la disposición predeterminada, véase
837 @ref{Personalización de los títulos}.
841 Utilice la variable @code{breakbefore} dentro de un bloque
842 @code{\header} que está propiamente dentro de un bloque @code{\score}
843 para hacer que los títulos del bloque @code{\header} del nivel
844 superior aparezcan ocupando toda la primera página, empezando la
845 música (definida en el bloque @code{\score}) en la página siguiente.
848 @lilypond[papersize=a8landscape,verbatim,noragged-right]
851 title = "Este es mi Title (título)"
852 subtitle = "Este es mi Subtitle (subtítulo)"
853 copyright = "Este es el final de la primera página"
856 \repeat unfold 4 { e'' e'' e'' e'' }
858 piece = "Esto es la música"
866 Manual de aprendizaje:
867 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
869 Referencia de la notación:
870 @ref{Personalización de los títulos},
871 @ref{Estructura del archivo}.
874 @file{ly/titling-init.ly}.
877 @node Disposición predeterminada de las cabeceras y pies de página
878 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
879 @translationof Default layout of headers and footers
881 Las @emph{cabeceras} y los @emph{pies} de página son líneas de texto
882 que aparecen en la parte más alta y en la más baja de las páginas
883 separadas del texto principal de un libro. Se controlan mediante las
884 siguientes variables de @code{\paper}:
887 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
888 @item @code{evenHeaderMarkup} (marcado de cabecera par)
889 @item @code{oddFooterMarkup} (marcado de pie impar)
890 @item @code{evenFooterMarkup} (marcado de pie par)
893 Estas variables de marcado sólo pueden acceder a los campos de texto
894 extraídos de bloques @code{\header} del nivel superior (que se aplican
895 a todas las partituras del libro) y se definen en el archivo
896 @file{ly/titling-init.ly}. De forma predeterminada:
901 los números de página se sitúan automáticamente en el extremo superior
902 izquierdo (si es par) o superior derecho (si es impar), a partir de la
906 el campo de texto @code{instrument} se sitúa en el centro en cada
907 página, a partir de la segunda página.
910 el texto de @code{copyright} se centra en la parte baja de la primera
914 la línea @code{tagline} se centra al final de la última página, y
915 debajo del texto de @code{copyright} si sólo hay una página.
919 @lilypond[papersize=a8landscape]
929 La línea de etiqueta tagline predeterminada se puede cambiar añadiendo un campo
930 @code{tagline} en el bloque @code{\header} del nivel superior.
932 @lilypond[papersize=a8landscape,verbatim]
935 tagline = "... music notation for Everyone"
945 Para eliminar la línea @code{tagline}, establezca su valor a
949 @node Títulos encabezamientos y pies de página personalizados
950 @subsection Títulos, encabezamientos y pies de página personalizados
951 @translationof Custom titles headers and footers
953 @c TODO: somewhere put a link to header spacing info
954 @c (you'll have to explain it more in NR 4).
957 * Formateo personalizado del texto de los títulos::
958 * Personalización de los títulos::
959 * Disposición personalizada de cabeceras y pies de página::
963 @node Formateo personalizado del texto de los títulos
964 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
965 @translationof Custom text formatting for titles
967 Se pueden usar instrucciones @code{\markup} estándar para personalizar
968 el texto de cualquier cabecera, pie o título dentro del bloque
971 @lilypond[quote,verbatim,noragged-right]
975 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
976 subtitle = \markup { \italic "(Excerpt)" }
982 Referencia de la notación:
983 @ref{Formatear el texto}.
986 @node Personalización de los títulos
987 @unnumberedsubsubsec Personalización de los títulos
988 @translationof Custom layout for titles
990 @cindex bookTitleMarkup
991 @cindex scoreTitleMarkup
992 @funindex bookTitleMarkup
993 @funindex scoreTitleMarkup
995 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
996 útiles para dar un formato simple al texto, pero no permiten un
997 control preciso sobre la colocación de los títulos. Para personalizar
998 la colocación de los campos de texto, cambie una o las dos variables de
999 @code{\paper} siguientes:
1002 @item @code{bookTitleMarkup} (marcado de título del libro)
1003 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
1006 La colocación de los títulos cuando se utilizan los valores
1007 predeterminados de estas variables de @code{\markup} se muestra en los
1009 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1011 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y como
1012 están definidos en el archivo @file{ly/titling-init.ly} son:
1015 scoreTitleMarkup = \markup @{ \column @{
1016 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
1018 \fromproperty #'header:piece
1019 \fromproperty #'header:opus
1025 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
1026 opuestos de la misma línea:
1028 @lilypond[quote,verbatim,noragged-right]
1032 piece = "PRAELUDIUM I"
1038 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el campo
1039 de texto @code{piece} aparece centrado y en un tipo de letra grande y
1042 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1046 scoreTitleMarkup = \markup {
1049 \fontsize #4 \bold \fromproperty #'header:piece
1050 \fromproperty #'header:opus
1054 \header { tagline = ##f }
1058 piece = "PRAELUDIUM I"
1065 Los campos de texto que normalmente no son efectivos
1066 dentro de los bloques @code{\header} de una partitura
1067 se pueden imprimir el la zona del Título de la partitura
1068 si se coloca @code{print-all-headers} dentro del bloque @code{\paper}.
1069 Una desventaja de la
1070 utilización de este método es que los campos de texto que están
1071 orientados específicamente para la zona del título de parte de libro
1072 han de suprimirse manualmente en cada uno de los bloques
1073 @code{\score}. Véase @ref{Explicación de los títulos}.
1075 Para evitarlo, añada el campo de texto deseado a la definición de
1076 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de texto
1077 @code{composer} (asociado normalmente con @code{bookTitleMarkup}) se
1078 añade a @code{scoreTitleMarkup}, permitiendo que cada partitura
1079 muestre un compositor diferente:
1081 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1085 scoreTitleMarkup = \markup {
1088 \fontsize #4 \bold \fromproperty #'header:piece
1089 \fromproperty #'header:composer
1093 \header { tagline = ##f }
1098 composer = "Christian Petzold"
1105 composer = "François Couperin"
1111 También podemos crear nuestros propios campos de texto personalizados,
1112 y referirnos a ellos en la definición del elemento de marcado.
1114 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1118 scoreTitleMarkup = \markup {
1121 \override #`(direction . ,UP) {
1123 \center-align \fontsize #-1 \bold
1124 \fromproperty #'header:mycustomtext %% User-defined field
1125 \center-align \fontsize #4 \bold
1126 \fromproperty #'header:piece
1129 \fromproperty #'header:opus
1133 \header { tagline = ##f }
1138 mycustomtext = "A 4 VOCI" %% User-defined field
1146 Referencia de la notación:
1147 @ref{Explicación de los títulos}.
1150 @node Disposición personalizada de cabeceras y pies de página
1151 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1152 @translationof Custom layout for headers and footers
1154 @c can make-header and make-footer be removed from
1155 @c paper-defaults-init.ly? -mp
1157 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1158 de utilidad para dar formato al texto de una manera sencilla, pero no
1159 permiten un control preciso sobre la colocación de las cabeceras y los
1160 pies de página. Para personalizar la colocación de los campos de
1161 texto, use una o más de las siguientes variables de @code{\paper}:
1164 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1165 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1166 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1167 @item @code{evenFooterMarkup} (marcado de pie de página par)
1170 @cindex marcado condicional
1172 @funindex \on-the-fly
1174 La instrucción de marcado @code{\on-the-fly} se puede utilizar para
1175 añadir elementos de forma condicional al texto de encabezamiento y pie
1176 de página definido dentro del bloque @code{\paper}, usando la sintaxis
1180 @code{variable} = @code{\markup} @{
1182 @code{\on-the-fly} #@var{procedimiento} @var{marcado}
1187 El @var{procedimiento} se llama cada vez que se evalúa la instrucción
1188 @code{\markup} en que ésta aparece. El @var{procedimiento} debería
1189 comprobar si se cumple una condición determinada e interpretar (es
1190 decir: imprimir) el argumento @var{marcado} si, y sólo si, la
1191 condición es verdadera.
1193 Se proveen un cierto número de procedimientos ya hechos para la
1194 comprobación de diversas condiciones:
1197 @multitable {print-page-number-check-first-----} {¿es el núm. de páginas en la parte de libro > 1?-----}
1199 @headitem Nombre del procedimiento @tab Condición que se comprueba
1201 @item print-page-number-check-first @tab ¿debería imprimirse esta página?
1202 @item create-page-number-stencil @tab ¿es print-page-numbers verdadero?
1203 @item print-all-headers @tab ¿es print-all-headers verdadero?
1204 @item first-page @tab ¿es la primera página del libro?
1205 @item (on-page nmbr) @tab ¿es el número de página = nmbr?
1206 @item last-page @tab ¿es la última página del libro?
1207 @item not-first-page @tab ¿no es la primera página del libro?
1208 @item part-first-page @tab ¿es la primera página de la parte de libro?
1209 @item part-last-page @tab ¿es la última página de la parte de libro?
1210 @item not-single-page @tab ¿es el núm. de páginas en la parte de libro > 1?
1215 El ejemplo siguiente centra los números de página en la parte baja de
1216 las páginas. En primer lugar, los ajustes predeterminados para
1217 @code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
1218 definiéndolos como un marcado @emph{nulo}. Después de esto, se
1219 redefine @code{oddFooterMarkup} con el número de página centrado.
1220 Finalmente, @code{evenFooterMarkup} recibe la misma disposición
1221 definiéndola como @code{\oddFooterMarkup}:
1223 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1226 print-page-number = ##t
1227 print-first-page-number = ##t
1228 oddHeaderMarkup = \markup \null
1229 evenHeaderMarkup = \markup \null
1230 oddFooterMarkup = \markup {
1232 \on-the-fly #print-page-number-check-first
1233 \fromproperty #'page:page-number-string
1236 evenFooterMarkup = \oddFooterMarkup
1239 \new Staff { s1 \break s1 \break s1 }
1244 Se pueden combinar varias condiciones de @code{\on-the-fly} con un
1245 operador @q{and}, por ejemplo:
1248 @code{\on-the-fly #first-page}
1249 @code{\on-the-fly #last-page}
1250 @code{@{ \markup ... \fromproperty #'header: ... @}}
1253 determina si la salida es una sola página.
1256 Referencia de la notación:
1257 @ref{Explicación de los títulos},
1258 @ref{Presentación predeterminada de los títulos de partes de libro y partitura}.
1260 Archivos instalados:
1261 @file{../ly/titling-init.ly}.
1264 @node Crear notas al pie
1265 @subsection Crear notas al pie
1266 @translationof Creating footnotes
1268 @cindex notas al pie
1270 Se pueden crear dos tipos de notas al pie: automáticas y manuales.
1273 * Notas al pie dentro de expresiones musicales::
1274 * Notas al pie en texto independiente::
1277 @node Notas al pie dentro de expresiones musicales
1278 @unnumberedsubsubsec Notas al pie dentro de expresiones musicales
1279 @translationof Footnotes in music expressions
1281 @cindex notas al pie dentro de expresiones musicales
1284 @subsubsubheading Panorámica de las notas al pie
1286 Las notas al pie dentro de expresiones musicales caen dentro de dos
1290 @item Notas al pie basadas en eventos
1291 Se adjuntan a un evento en particular. Son ejemplos de tales eventos
1292 las notas sueltas, las articulaciones (como indicaciones de digitación,
1293 acentos, indicaciones dinámicas) y los post-eventos (como las ligaduras de expresión
1294 y las barras de corchea manuales). La forma general de las notas
1295 al pie basadas en eventos es como sigue:
1298 [@var{dirección}] \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1301 @item Notas al pie basadas en tiempo
1302 Se ligan a un punto temporal determinado, dentro de un contexto
1303 musical. Algunas instrucciones como @code{\time} y @code{\clef} en
1304 realidad no usan eventos para crear objetos como la indicación de
1305 compás y la clave. Un acorde tampoco crea un evento por sí mismo: su
1306 plica o corchete se crea al final de un paso de tiempo (nominalmente,
1307 a través de uno de los eventos de nota que contiene). Una nota al pie
1308 basada en tiempo permite anotar tales objetos de presentación sin
1309 referirse a ningún evento.
1311 Una nota al pie basada en tiempo permite que tales objetos de
1312 presentación se puedan anotar sin hacer referencia a un evento.
1313 La forma general para las notas al pie basadas en tiempo es:
1316 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} [@var{Contexto}].@var{Nombre-del-Grob}
1321 Los elementos para las dos formas son como sigue:
1326 Si (y sólo si) el @code{\footnote} se está aplicando a un post-evento
1327 o articulación, debe ir precedida de un indicador de dirección
1328 (@code{-, _, ^}) con el objeto de adjuntar la @var{música} (con una
1329 marca de nota al pie) a la nota o silencio precedente.
1332 es un elemento de marcado o cadena de caracteres que especifica la
1333 marca de nota al pie que se usa para marcar tanto el punto de
1334 referencia como la propia nota al pie en la parte inferior de la
1335 página. Se puede omitir (o, de forma equivalente, sustituirse por
1336 @code{\default}) en cuyo caso se genera un número secuencialmente de
1337 forma automática. Tales secuencias numéricas se reinician en cada
1338 página que contiene una nota al pie.
1340 @item desplazamiento
1341 es una pareja de números tal como @samp{#(2 . 1)} que especifica los
1342 desplazamientos en X y en Y en unidades de espacios de pentagrama a
1343 partir del límite del objeto en que se desea situar la marca. Los
1344 valores de desplazamiento positivos se toman a partir del borde
1345 superior derecho, los valores negativos a partir del borde inferior
1346 izquierdo y cero implica que la marca se centra sobre el borde.
1349 es el contexto en que se crea el grob que recibe la nota al pie.
1350 Se puede omitir si el grob está en un contexto del nivel inferior,
1351 p.ej un contexto @code{Voice}.
1353 @item Nombre-del-Grob
1354 especifica un tipo de grob que marcar (como @samp{Flag} para el
1355 corchete). Si se da, la nota al pie no se adjunta a una expresión
1356 musical en particular, sino a todos los grobs del tipo
1357 especificado que ocurren en dicho momento de tiempo musical.
1359 @item texto-de-la-nota
1360 es el elemento de marccado o cadena de caracteres que especifica el
1361 texto de la nota al pie que utilizar en la parte baja de la página.
1364 es el evento musical, post-evento o articulación que se
1369 @subsubsubheading Notas al pie basadas en eventos
1371 @cindex Notas al pie, basadas en eventos
1373 Una nota al pie se adjunta a un objeto de presentación causado
1374 directamente por el evento que corresponde a @var{música}, con la
1378 \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1382 @lilypond[quote,verbatim,papersize=a8landscape]
1384 \header { tagline = ##f }
1386 \footnote #'(-1 . 3) "Una nota" a4
1388 \footnote #'(2 . 2) "Un silencio" r4
1394 No es posible marcar un acrode @emph{completo} con una nota al pie
1395 basada en evento: un acorde, incluso aquel que contiene una sola
1396 nota, no produce un verdadero evento por sí mismo. Sin embargo,
1397 las notas individuales que están @emph{dentro} del acorde sí se
1401 @lilypond[quote,verbatim,papersize=a8landscape]
1403 \header { tagline = ##f }
1405 \footnote #'(2 . 3) "No funciona" <a-3>2
1406 <\footnote #'(-2 . -3) "Funciona" a-3>4
1407 <a-3 \footnote #'(3 . 1/2) "También funciona" c-5>4
1412 Si se desea que la nota al pie se adjunte a un post-evento o
1413 articulación, la instrucción @code{\footnote} @emph{debe} ir
1414 precedida por un indicador de dirección, @code{-, _, ^}, y seguida
1415 por el post-evento o articulación que se desea anotar como
1416 argumento @var{música}. En esta forma, la @code{\footnote} se
1417 puede considerar como una simple copia de su último argumento con
1418 una marca de nota al pie adjunta. La sintaxis es:
1421 @var{dirección} \footnote [@var{marca}] @var{desplazamiento} @var{texto-de-la-nota} @var{música}
1425 @lilypond[quote,verbatim,papersize=a8landscape]
1427 \header { tagline = ##f }
1429 a4_\footnote #'(0 . -1) "Ligadura forzada hacia abajo" (
1430 b8^\footnote #'(1 . 0.5) "Barra manual forzada hacia arriba" [
1433 c-\footnote #'(1 . 1) "Tenuto" --
1438 @subsubsubheading notas al pie basadas en tiempo
1440 @cindex notas al pie, basadas en tiempo
1442 Si el objeto de presentación que recibe la nota al pie está
1443 causado @emph{indirectamente} por un evento (como un objeto
1444 @code{Accidental}, alteración, o @code{Stem}, plica, causados por
1445 un evento @code{NoteHead}, cabeza de nota), el nombre del grob
1446 @var{GrobName} del objeto de presentación es necesario después del
1447 texto de la nota al pie, en lugar de @var{música}:
1450 @lilypond[quote,verbatim,papersize=a8landscape]
1452 \header { tagline = ##f }
1454 \footnote #'(-1 . -3) "Un bemol" Accidental
1456 \footnote #'(-1 . 0.5) "Otro bemol" Accidental
1458 \footnote #'(1 . -2) "Una plica" Stem
1464 Sin embargo, observe que cuando se especifica el nombre de un
1465 grob, se adjunta una nota al pie a todos los grobs de ese tipo
1466 dentro del instante de tiempo actual:
1469 @lilypond[quote,verbatim,papersize=a8landscape]
1471 \header { tagline = ##f }
1473 \footnote #'(-1 . 3) "Un bemol" Accidental
1475 \footnote #'(2 . 0.5) "Articulación" Script
1481 Una nota dentro de un acorde puede recibir una nota al pie
1482 individual, basada en evento. El único grob causado directamente
1483 por una nota de un acorde es @samp{NoteHead}, por lo que la
1484 instrucción de nota al pie basada en evento @emph{solamente} es
1485 apta para añadir una nota al pie a la @samp{NoteHead} dentro de un
1486 acorde. Todos los demás grobs de notas de acorde están causados
1487 indirectamente. La propia instrucción @code{\footnote} no ofrece
1488 ninguna sintaxis para especificar al mismo tiempo un tipo concreto
1489 de grob @emph{y también} un evento concreto al que adjuntar la
1490 nota. Sin embargo, se puede usat una instrucción @code{\footnote}
1491 basada en tiempo para especificar el tipo de grob, y luego añadir
1492 la instrucción @code{\single} como prefijo, con el objeto de que
1493 se aplique solamente al evento siguiente:
1496 @lilypond[quote,verbatim,papersize=a8landscape]
1498 \header { tagline = ##f }
1500 < \footnote #'(1 . -2) "An A" a
1501 \single \footnote #'(-1 . -1) "Un sostenido" Accidental
1503 \single \footnote #'(0.5 . 0.5) "Un bemol" Accidental
1510 @warning {Cuando las notas al pie se adjuntan a varios elementos musicales que
1511 están dentro del mismo momento musical, como ocurre en el ejemplo
1512 anterior, las notas al pie se numeran desde los elementos más
1513 altos a los más bajos tal y como aparecen en la salida impresa, no
1514 en el orden en que se escriben en el flujo de entrada.}
1516 Los objetos de presentación como las claves y las armaduras de
1517 cambio de tonalidad están, más bien, causadas por propiedades que
1518 cambian, y no por eventos. Otros, como las líneas divisorias y
1519 los números de compás, son una consecuencia directa del paso del
1520 tiempo. Por esta razón, las notas al pie sobre tales objetos
1521 tienen que basarse en su tiempo musical. Las notas al pie basadas
1522 en tiempo so preferibles también cuando se marcan cosas como las
1523 plicas y las barras de corchea en @emph{acordes}: dado que estas
1524 funcionalidades de cada acorde individual están asignadas
1525 normalmente a @emph{un solo} evento dentro del acorde, sería
1526 imprudente descansar en una elección particular.
1528 En las notas al pie basadas en tiempo, siempre se debe especificar
1529 explícitamente el objeto de presentación en cuestión, y si el grob
1530 se crea dentro de un contexto distinto al de nivel más bajo, debe
1531 especificarse el contexto apropiado.
1534 @lilypond[quote,verbatim,papersize=a8landscape]
1536 \header { tagline = ##f }
1539 \footnote #'(-0.5 . -1) "Cambio de compás" Staff.TimeSignature
1541 \footnote #'(1 . -1) "Plica de acorde" Stem
1543 \footnote #'(-0.5 . 1) "Línea divisoria" Staff.BarLine
1545 \footnote #'(0.5 . -1) "Cambio de tonalidad" Staff.KeySignature
1552 Se pueden usar marcas personalizadas como alternativas a las
1553 marcas numéricas, y se puede suprimir la línea de anotación que
1554 une el objeto marcado con su marca:
1557 @lilypond[quote,verbatim,papersize=a8landscape]
1559 \header { tagline = ##f }
1561 \footnote "*" #'(0.5 . -2) \markup { \italic "* La primera nota" } a'4
1563 \footnote \markup { \super "$" } #'(0.5 . 1)
1564 \markup { \super "$" \italic " La segunda nota" } e
1566 \once \override Score.FootnoteItem.annotation-line = ##f
1567 b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
1568 \markup { \super "+" \italic " Editorial" } \p
1573 Se muestran más ejemplos de marcas personalizadas en
1574 @ref{Notas al pie en texto independiente}.
1577 @node Notas al pie en texto independiente
1578 @unnumberedsubsubsec Notas al pie en texto independiente
1579 @translationof Footnotes in stand-alone text
1581 @cindex notas al pie en texto independiente
1583 Se utilizan dentro de un elemento de marcado fuera de cualquier
1584 expresión musical. No se traza una líne hasta el punto de referencia:
1585 la marca simplemente sigue al elemento de marcado que se referencia.
1586 Se pueden insertar las marcas automáticamente, en cuyo caso son
1587 numéricas. De forma alternativa, se pueden aportar manualmente marcas
1590 Las notas al pie para texto independiente con marcas automáticas y
1591 personalizadas se crean de distintas formas.
1593 @subsubsubheading Notas al pie en texto independiente con marcas automáticas
1595 La sintaxis de una nota al pue sobre texto independiente con marcas
1599 \markup @{ ... \auto-footnote @var{texto} @var{nota} ... @}
1607 es el elemento de marcado o cadena de caracteres que se desea anotar.
1610 es el elemento de marcado o cadena de caracteres que especifica el
1611 texto de la nota al pie que utilizar en la parte baja de la página.
1617 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1619 \header { tagline = ##f }
1622 \auto-footnote "tune" \italic " By me"
1623 "is shown below. It is a"
1624 \auto-footnote "recent" \italic " Aug 2012"
1633 @subsubsubheading Notas al pie sobre texto independiente con marcas personalizadas
1635 La sintaxis de una nota al pie sobre texto independiente con marcas
1639 \markup @{ ... \footnote @var{marca} @var{nota} ... @}
1647 es un elemento de marcado o cadena de caracteres que especifica la
1648 marca que se usa para señalar el punto de referencia. Observe que
1649 esta marca @emph{no} se inserta automáticamente antes de la propia
1653 es el elemento de marcado o cadena de caracteres que especifica el
1654 texto de la nota que aparece en la parte baja de la página, precedida
1655 por la @var{marca} especificada.
1659 Se puede usar como marca un carácter fácil de teclear, como * ó +,
1660 según se muestra en @ref{Notas al pie dentro de expresiones musicales}.
1661 De forma alternativa, se pueden usar alias en ASCII (véase
1662 @ref{Alias de ASCII}):
1664 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1666 \paper { #(include-special-characters) }
1667 \header { tagline = ##f }
1670 \footnote "*" \italic "* By me"
1671 "is shown below. It is a recent"
1672 \footnote \super † \concat {
1673 \super † \italic " Aug 2012"
1683 También pueden utilizarse códigos de caracteres Unicode para
1684 especificar las marcas (véase @ref{Unicode}):
1686 @lilypond[verbatim,quote,ragged-right,papersize=a8]
1688 \header { tagline = ##f }
1691 \footnote \super \char##x00a7 \concat {
1692 \super \char##x00a7 \italic " By me"
1694 "is shown below. It is a recent"
1695 \footnote \super \char##x00b6 \concat {
1696 \super \char##x00b6 \italic " Aug 2012"
1707 Manual de aprendizaje:
1708 @rlearning{Objetos e interfaces}.
1710 Referencia de la notación:
1711 @ref{ASCII aliases},
1712 @ref{Globos de ayuda},
1713 @ref{List of special characters},
1714 @ref{Indicaciones de texto},
1715 @ref{Guiones de texto},
1718 Referencia de funcionamiento interno:
1719 @rinternals{FootnoteEvent},
1720 @rinternals{FootnoteItem},
1721 @rinternals{FootnoteSpanner},
1722 @rinternals{Footnote_engraver}.
1725 Varias notas al pie en la misma página solo pueden ir apiladas unas
1726 sobre otras; no se pueden imprimir en la misma línea.
1728 Las notas al pie no se pueden adjuntar a @code{MultiMeasureRests}
1729 (silencios multicompás), a barras de corchea automáticas ni a la
1730 letra de las canciones.
1732 Las notas al pie pueden colisionar con las pautas, objetos
1733 @code{\markup}, otras marcas de notas al pie y líneas de
1737 @node Referencia a números de página
1738 @subsection Referencia a números de página
1739 @translationof Reference to page numbers
1741 Un lugar determinado de una partitura puede señalizarse usando la
1742 instrucción @code{\label} (etiqueta), ya sea en el nivel superior o
1743 dentro de la música. Podemos referirnos a esta etiqueta más tarde
1744 dentro de un elemento de marcado, para obtener el número de la página
1745 en la que se sitúa el punto señalizado, usando la instrucción de
1746 marcado @code{\page-ref}.
1749 @lilypond[verbatim,papersize=a8landscape]
1750 \header { tagline = ##f }
1756 \pageBreak \mark A \label #'markA
1760 \markup { La primera partitura comienza en la página \page-ref #'firstScore "0" "?" }
1761 \markup { La marca A está en la página \page-ref #'markA "0" "?" }
1765 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1767 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
1768 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1769 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1772 El motivo de que se necesite un medidor es que en el momento en que se
1773 están interpretando los marcados, los saltos de página aún no se han
1774 producido y por tanto los números de página no se conocen todavía.
1775 Para sortear este inconveniente, la interpretación real del marcado se
1776 retrasa hasta un momento posterior; sin embargo, las dimensiones del
1777 marcado se tienen que conocer de antemano, así que se usa el medidor
1778 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
1779 páginas, el medidor puede ser "00", es decir, un número de dos
1790 @node Índice general
1791 @subsection Índice general
1792 @translationof Table of contents
1794 Se puede insertar un índice general o tabla de contenidos utilizando
1795 la instrucción @code{\markuplist \table-of-contents}. Los elementos
1796 que deben aparecer en la tabla de contenidos se introducen con la
1797 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
1798 la jerarquía del código, o dentro de una expresión musical.
1801 \markuplist \table-of-contents
1804 \tocItem \markup "Primera partitura"
1808 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1813 \tocItem \markup "Segunda partitura"
1821 Los elementos de marcado que se usan para dar formato al índice
1822 general se encuentran definidos dentro del bloque @code{\paper}. Los
1823 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
1824 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
1825 los elementos del índice, que consisten en el título del elemento y el
1826 número de página. Estas variables se pueden cambiar por parte del
1831 %% Traducir el título del índice al español:
1832 tocTitleMarkup = \markup \huge \column {
1833 \fill-line { \null "Índice general" \null }
1836 %% usar una fuente mayor
1837 tocItemMarkup = \markup \large \fill-line {
1838 \fromproperty #'toc:text \fromproperty #'toc:page
1843 Observe la forma en que nos referimos al texto y al número de página
1844 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
1846 También se pueden definir nuevas instrucciones y elementos de
1847 marcado para crear índices generales más elaborados:
1849 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
1850 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
1851 utilizando esta variable de marcado del bloque @code{\paper}.
1854 En el ejemplo siguiente se define un estilo nuevo para introducir los
1855 nombres de los actos de una ópera en el índice general:
1859 tocActMarkup = \markup \large \column {
1861 \fill-line { \null \italic \fromproperty #'toc:text \null }
1867 #(define-music-function (parser location text) (markup?)
1868 (add-toc-item! 'tocActMarkup text))
1871 @lilypond[line-width=10.0\cm]
1872 \header { tagline = ##f }
1874 tocActMarkup = \markup \large \column {
1876 \fill-line { \null \italic \fromproperty #'toc:text \null }
1882 #(define-music-function (parser location text) (markup?)
1883 (add-toc-item! 'tocActMarkup text))
1886 \markuplist \table-of-contents
1887 \tocAct \markup { Atto Primo }
1888 \tocItem \markup { Coro. Viva il nostro Alcide }
1889 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1890 \tocAct \markup { Atto Secondo }
1891 \tocItem \markup { Sinfonia }
1892 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1897 Se pueden añadir puntos de relleno entre un elemento y su número de página:
1899 @lilypond[verbatim,line-width=10.0\cm]
1900 \header { tagline = ##f }
1902 tocItemMarkup = \tocItemWithDotsMarkup
1906 \markuplist \table-of-contents
1907 \tocItem \markup { Allegro }
1908 \tocItem \markup { Largo }
1915 @file{ly/toc-init.ly}.
1918 @funindex \table-of-contents
1919 @code{\table-of-contents},
1925 @node Trabajar sobre los archivos de entrada
1926 @section Trabajar sobre los archivos de entrada
1927 @translationof Working with input files
1930 * Inclusión de archivos de LilyPond::
1931 * Distintas ediciones a partir de una misma fuente::
1932 * Caracteres especiales::
1936 @node Inclusión de archivos de LilyPond
1937 @subsection Inclusión de archivos de LilyPond
1938 @translationof Including LilyPond files
1941 @cindex including files
1943 Un proyecto grande se puede dividir en varios archivos. Para
1944 referirse a otro archivo, utilice
1947 \include "otroarchivo.ly"
1950 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
1951 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
1952 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
1953 podríamos querer archivos distintos para cada parte instrumental y
1954 crear un archivo de @qq{partitura completa} que reúne los archivos
1955 individuales de los instrumentos. Normalmente el archivo incluido
1956 define un cierto número de variables que a partir de entonces quedan
1957 disponibles para poderlas utilizar en el archivo de la partitura
1958 completa. En los archivos incluidos se pueden marcar las secciones
1959 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
1960 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
1962 Los archivos que están en el directorio de trabajo actual se pueden
1963 referenciar simplemente especificando el nombre después de la
1964 instrucción @code{\include}. Los archivos en otros lugares se pueden
1965 incluir proporcionando una referencia de ruta completa o una ruta
1966 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
1967 barra invertida de DOS/Windows, \, como separador de directorio). Por
1968 ejemplo, si @file{material.ly} está situado un directorio por encima
1969 del directorio de trabajo actual, utilice
1972 \include "../material.ly"
1976 o si los archivos de las partes orquestales incluidas están todos
1977 situados en un subdirectorio llamado @file{partes} dentro del
1978 directorio actual, use
1981 \include "partes/VI.ly"
1982 \include "partes/VII.ly"
1986 Los archivos de inclusión también pueden contener enunciados
1987 @code{\include} a su vez. De forma predeterminada, estos enunciados
1988 @code{\include} de segundo nivel no se interpretan hasta que se
1989 incorporan al archivo principal, por lo que los nombres de archivo que
1990 especifican deben ser relativos al directorio que contiene el archivo
1991 principal, no al directorio que contiene el archivo incluido. Sin
1992 embargo, este comportamiento se puede modificar globalmente pasando la
1993 opción @option{-drelative-includes} en la línea de órdenes (o mediante
1994 la adición de @code{#(ly:set-option 'relative-includes #t)} al
1995 principio del archivo principal de entrada).
1997 Cuando @code{relative-includes} está establecido al valor @code{#t},
1998 la ruta de cada instrucción @code{\include} se considera relativa al
1999 archivo que contiene dicha instrucción. Este comportamiento es el
2000 recomendado y se convertirá en el comportamiento predeterminado en una
2001 versión futura de lilypond.
2003 Tanto los archivos relativos al directorio principal como los archivos
2004 relativos a algún otro directorio se pueden @code{\include}ar mediante
2005 el establecimiento de @code{relative-includes} al valor @code{#t} o a
2006 @code{#f} en los lugares apropiados dentro de los archivos. Por
2007 ejemplo, si se ha creado una biblioteca genérica, libA, que a su vez
2008 utiliza sub-archivos que se @code{\include}an por medio del archivo de
2009 entrada de dicha biblioteca, esas instrucciones @code{\include}
2010 tendrán que venir precedidas por @code{#(ly:set-option
2011 #relative-includes #t)} de manera que se interpreten correctamente al
2012 construir el archivo de entrada @code{.ly} principal, de esta forma:
2023 entonces el archivo de entrada, @code{libA.ly}, contiene
2026 #(ly:set-option 'relative-includes #t)
2030 % vuelta al ajuste predeterminado
2031 #(ly:set-option 'relative-includes #f)
2034 Cualquier archivo @file{.ly} puede entonces incluir la biblioteca
2035 completa, simplemente con
2038 \include "~/libA/libA.ly"
2041 Se pueden usar estructuras de archivo más complejas instando los
2042 cambios en los lugares adecuados.
2044 También se pueden incluir archivos de un directorio que está en una
2045 ruta de búsqueda especificada como opción al invocar a LilyPond desde
2046 la línea de órdenes. Los archivos incluidos se especifican usando
2047 solamente su nombre de archivo. Por ejemplo, para compilar mediante
2048 este método un archivo @file{principal.ly} que incluye archivos
2049 situados en un subdirectorio llamado @file{partes}, cambie al
2050 directorio que contiene @file{principal.ly} e introduzca
2053 lilypond --include=partes principal.ly
2056 y en @file{principal.ly} escriba
2064 Los archivos que se incluyen en muchas partituras se pueden poner en
2065 el directorio de LilyPond @file{../ly} (la localización de este
2066 directorio depende de la instalación: véase
2067 @rlearning{Otras fuentes de información}). Estos archivos se pueden
2068 incluir sencillamente por su nombre en un enunciado @code{\include}.
2069 De esta forma se incluyen los archivos dependientes del idioma como
2072 LilyPond incluye de forma predeterminada ciertos archivos cuando se
2073 inicia el programa. Estas inclusiones no son visibles para el
2074 usuario, pero los archivos se pueden identificar ejecutando
2075 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
2076 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
2077 otras indicaciones. De forma alternativa, pueden verse explicaciones
2078 sobre los archivos más importantes de este conjunto en
2079 @rlearning{Otras fuentes de información}. Estos archivos se pueden
2080 editar, pero los cambios realizados sobre ellos se perderán al
2081 instalar una nueva versión de LilyPond.
2083 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
2084 @rlearning{Partituras y particellas}.
2087 Manual de aprendizaje:
2088 @rlearning{Otras fuentes de información},
2089 @rlearning{Partituras y particellas}.
2092 Si un archivo incluido recibe un nombre igual al de uno de los
2093 archivos de instalación de LilyPond, el archivo que tiene prioridad es
2094 el de los archivos de instalación de LilyPond.
2097 @node Distintas ediciones a partir de una misma fuente
2098 @subsection Distintas ediciones a partir de una misma fuente
2099 @translationof Different editions from one source
2101 Se pueden usar varios métodos para generar la producción de distintas
2102 versiones de una partitura a partir de la misma fuente musical. Las
2103 variables son quizá el más útil para combinar secciones extensas de
2104 música y/o anotaciones. Las etiquetas son más útiles para seleccionar
2105 una sección de entre varias secciones de música alternativas, más
2106 cortas, y se pueden usar también para dividir piezas de música en
2109 Cualquiera que sea el método utilizado, la separación de la notación
2110 de la estructura de la partitura hará que sea más fácil cambiar la
2111 estructura dejando intacta la notación.
2114 * Uso de las variables::
2115 * Uso de etiquetas::
2116 * Uso de ajustes globales::
2119 @node Uso de las variables
2120 @unnumberedsubsubsec Uso de las variables
2121 @translationof Using variables
2123 @cindex variables, uso de las
2125 Si las secciones de la música se definen dentro de variables, se
2126 pueden reutilizar en distintas partes de la partitura, véase
2127 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
2128 partitura vocal @notation{a cappella} con frecuencia incluye una
2129 reducción de piano de las partes para ensayar que es idéntica a la
2130 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
2131 puede combinar sobre un solo pentagrama la música de dos variables,
2132 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
2134 @lilypond[verbatim,quote]
2135 sopranoMusic = \relative c'' { a4 b c b8( a) }
2136 altoMusic = \relative g' { e4 e e f }
2137 tenorMusic = \relative c' { c4 b e d8( c) }
2138 bassMusic = \relative c' { a4 gis a d, }
2139 allLyrics = \lyricmode {King of glo -- ry }
2141 \new Staff = "Soprano" \sopranoMusic
2142 \new Lyrics \allLyrics
2143 \new Staff = "Alto" \altoMusic
2144 \new Lyrics \allLyrics
2145 \new Staff = "Tenor" {
2149 \new Lyrics \allLyrics
2150 \new Staff = "Bass" {
2154 \new Lyrics \allLyrics
2157 \set Staff.printPartCombineTexts = ##f
2163 \set Staff.printPartCombineTexts = ##f
2173 Se pueden producir partituras distintas que presenten sólo las partes
2174 vocales o sólo la parte de piano, cambiando solamente los enunciados
2175 estructurales, sin modificar la notación musical.
2177 Para partituras extensas, las definiciones de variable se pueden poner
2178 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
2181 @node Uso de etiquetas
2182 @unnumberedsubsubsec Uso de etiquetas
2183 @translationof Using tags
2186 @funindex \keepWithTag
2187 @funindex \removeWithTag
2188 @funindex \pushToTag
2189 @funindex \appendToTag
2191 @cindex mantener música etiquetada
2192 @cindex quitar música etiquetada
2193 @cindex división en música etiquetada
2195 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
2196 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
2197 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
2198 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
2199 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
2200 música etiquetada es como sigue:
2202 @multitable @columnfractions .5 .5
2206 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
2208 Se incluye la música no etiquetada y la música etiquetada con
2209 @var{nombre}; se excluye la música etiquetada con cualquier otro
2212 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
2214 Se incluye la música no etiquetada y la música etiquetada con
2215 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
2216 música etiquetada con @var{nombre}.
2218 Música etiquetada no precedida de @code{\keepWithTag} ni de
2219 @code{\removeWithTag}
2220 @tab Se incluye toda la música etiquetada y no etiquetada.
2223 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
2224 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
2225 @code{#'parte}), seguido de una expresión musical.
2227 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
2228 que muestra trinos con la notación usual y otra con los trinos
2229 expandidos explícitamente:
2231 @lilypond[verbatim,quote]
2232 music = \relative g' {
2234 \tag #'trills { d8.\trill }
2235 \tag #'expand { \repeat unfold 3 { e32 d } }
2240 \keepWithTag #'trills \music
2243 \keepWithTag #'expand \music
2248 De forma alternativa, a veces es más fácil excluir secciones de música:
2250 @lilypond[verbatim,quote]
2251 music = \relative g' {
2253 \tag #'trills { d8.\trill }
2254 \tag #'expand {\repeat unfold 3 { e32 d } }
2259 \removeWithTag #'expand
2263 \removeWithTag #'trills
2268 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
2272 -\tag #'@var{mi-etiqueta}
2275 a una articulación. Por ejemplo, esto define una nota con una
2276 indicación opcional de digitación y una nota con una anotación
2281 c1-\tag #'warn ^"¡Ojo!"
2284 Se pueden poner varias etiquetas sobre expresiones con varias entradas
2287 @lilypond[quote,verbatim]
2288 music = \relative c'' {
2289 \tag #'a \tag #'both { a4 a a a }
2290 \tag #'b \tag #'both { b4 b b b }
2293 \keepWithTag #'a \music
2294 \keepWithTag #'b \music
2295 \keepWithTag #'both \music
2299 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
2300 expresión musical para quitar varias secciones etiquetadas con nombres
2303 @lilypond[verbatim,quote]
2304 music = \relative c'' {
2305 \tag #'A { a4 a a a }
2306 \tag #'B { b4 b b b }
2307 \tag #'C { c4 c c c }
2308 \tag #'D { d4 d d d }
2317 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
2318 musical producen la eliminación de @emph{todas} las secciones
2319 etiquetadas, porque el primer filtro quita todas las secciones
2320 etiquetadas excepto la que se nombra, y el segundo filtro elimina
2321 incluso esa sección etiquetada.
2323 A vecespodemos desear dividir la música en un determinado lugar dentro
2324 de una expresión musical existente. Podemos usar @code{\pushToTag} y
2325 @code{\appendToTag} para añadir material delante o al final de los
2326 @code{elements} de una construcción musical existente. No toda
2327 construcción musical tiene la parte @code{elements}, pero las músicas
2328 secuenciaes y simultáneas son dos apuestas seguras:
2330 @lilypond[verbatim,quote]
2331 test = { \tag #'here { \tag #'here <<c''>> } }
2334 \pushToTag #'here c'
2335 \pushToTag #'here e'
2336 \pushToTag #'here g' \test
2337 \appendToTag #'here c'
2338 \appendToTag #'here e'
2339 \appendToTag #'here g' \test
2343 Las dos instrucciones admiten una etiqueta, el material que dividir en
2344 cada ocurrencia de la etiqueta, y la expresión etiquetada. Las
2345 instrucciones aseguran que se copia todo lo que cambian, de forma que
2346 el código original @code{\test} retiene su significado.
2349 Manual de aprendizaje:
2350 @rlearning{Organizar las piezas mediante variables}.
2352 Referencia de la notación:
2353 @ref{Combinación automática de las partes},
2354 @ref{Inclusión de archivos de LilyPond}.
2357 @c This warning is more general than this placement implies.
2358 @c Rests are not merged whether or not they come from tagged sections.
2359 @c Should be deleted? -td
2362 Multiple rests are not merged if you create a score with more
2363 than one tagged section at the same place.
2367 @node Uso de ajustes globales
2368 @unnumberedsubsubsec Uso de ajustes globales
2369 @translationof Using global settings
2371 @cindex include-settings
2373 Se pueden incluir ajustes globales a partir de un archivo distinto:
2376 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
2379 En archivos diferentes se pueden almacenar grupos de ajustes como
2380 el tamaño de la página o las fuentes tipográficas. Ello permite
2381 hacer diferentes ediciones de la mism a partitura así como aplicar
2382 ajustes estándar a muchas partituras, simplemente por medio de la
2383 especificación del archivo de ajustes adecuado.
2385 Esta técnica también funciona bien con el uso de hojas de estilo,
2386 como se estudia en @rlearning{Hojas de estilo}.
2389 Manual de aprendizaje:
2390 @rlearning{Organizar las piezas mediante variables},
2391 @rlearning{Hojas de estilo}.
2393 Referencia de la notación:
2394 @ref{Inclusión de archivos de LilyPond}.
2397 @node Caracteres especiales
2398 @subsection Caracteres especiales
2399 @translationof Special characters
2401 @cindex caracteres especiales
2402 @cindex caracteres no ASCII
2405 * Codificación del texto::
2411 @node Codificación del texto
2412 @unnumberedsubsubsec Codificación del texto
2413 @translationof Text encoding
2417 LilyPond usa el conjunto de caracteres definido por el consorcio
2418 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
2419 para los conjuntos de caracteres que se utilizan en prácticamente
2420 todos los idiomas modernos y también en muchos otros. Unicode se
2421 puede implementar utilizando varios esquemas de codificación
2422 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
2423 @emph{Unicode Transformation Format}, o formato de transformación de
2424 Unicode) que representa todos los caracteres comunes de Latin en un
2425 solo byte, y representa otros caracteres usando un formato de longitud
2426 variable de hasta cuatro bytes.
2428 El aspecto visual real de los caracteres viene determinado por los
2429 glifos que se definen en las fuentes tipográficas concretas que se
2430 tengan disponibles: una fuente tipográfica define la asignación de un
2431 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
2432 biblioteca Pango para representar y disponer tipográficamente textos
2435 LilyPond no realiza ninguna conversión en la codificación de la
2436 entrada. Esto significa que cualquier text, ya sea el título, la
2437 letra de la canción o una instrucción musical que contenga caracteres
2438 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
2439 forma más fácil de escribir dicho texto es utilizar un editor
2440 preparado para Unicode y guardar el archivo con la codificación UTF-8.
2441 Casi todos los editores modernos populares contemplan el UTF-8, por
2442 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
2443 Windows posteriores a NT usan Unicode como codificación de caracteres
2444 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
2445 puede editar y guardar un archivo en el formato UTF-8. Una
2446 alternativa más funcional para Windows es BabelPad.
2448 Si un archivo de entrada que contiene un carácter que no es ASCII, no
2449 se guarda en el formato UTF-8, se genera el mensaje de error
2452 FT_Get_Glyph_Name () error: argumento inválido
2455 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
2458 %c No verbatim here as the code does not display correctly in PDF
2460 bulgarian = \lyricmode {
2461 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
2465 hebrew = \lyricmode {
2466 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
2470 portuguese = \lyricmode {
2471 à vo -- cê uma can -- ção legal
2477 \addlyrics { \bulgarian }
2478 \addlyrics { \hebrew }
2479 \addlyrics { \portuguese }
2484 @unnumberedsubsubsec Unicode
2485 @translationof Unicode
2489 Para introducir un carácter aislado para el que se conoce el punto de
2490 código Unicode pero no está disponible en el editor que se está
2491 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
2492 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
2493 del carácter en cuestión y @code{dddd} es su valor decimal
2494 correspondiente. Pueden omitirse los ceros iniciales, pero es
2495 costumbre indicar los cuatro caracteres en la representación
2496 hexadecimal (observe que @emph{no} debe utilizarse la codificación
2497 UTF-8 del punto de código Unicode después de @code{\char}, pues la
2498 codificación UTF-8 contiene bits adicionales que indican el número de
2499 octetos). Hay tablas de códigos Unicode y un índice de nombres de
2500 caracteres que da el punto de código en hexadecimal para cualquier
2501 carácter en el portal del Consorcio Unicode,
2502 @uref{http://www.unicode.org/}.
2504 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
2505 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
2506 @qq{Letra griega Xi pequeña}.
2508 Se puede escribir de esta forma cualquier punto de código Unicode, y
2509 si todos los caracteres especiales se escriben en este formato no es
2510 necesario guardar el archivo de entrada en formato UTF-8. Por
2511 supuesto, debe estar instalada y estar disponible para LilyPond una
2512 fuente tipográfica que contenga codificados todos estos caracteres.
2514 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
2515 en cuatro lugares: en una llamada de ensayo, como texto de
2516 articulación, en la letra y como texto independiente bajo la
2519 @lilypond[quote,verbatim]
2522 c1 \mark \markup { \char ##x03EE }
2523 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
2525 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
2527 \markup { "Copyright 2008--2012" \char ##x00A9 }
2530 @cindex copyright, símbolo de
2532 Para escribir el símbolo de copyright en la nota de créditos, utilice:
2536 copyright = \markup @{ \char ##x00A9 "2008" @}
2541 @node Alias de ASCII
2542 @unnumberedsubsubsec Alias de ASCII
2543 @translationof ASCII aliases
2545 Se puede incluir una lista de alias de ASCII para caracteres
2548 @lilypond[quote,verbatim]
2550 #(include-special-characters)
2553 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
2556 \new Staff { \repeat unfold 9 a'4 }
2558 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
2563 "The replacement can be disabled:"
2564 "– &OE; …"
2565 \override #'(replacement-alist . ()) "– &OE; …"
2569 También podemos hacer nuestros propios alias, ya sea de forma global:
2571 @lilypond[quote,verbatim]
2573 #(add-text-replacements!
2574 '(("100" . "hundred")
2575 ("dpi" . "dots per inch")))
2577 \markup "A 100 dpi."
2582 @lilypond[quote,verbatim]
2583 \markup \replace #'(("100" . "hundred")
2584 ("dpi" . "dots per inch")) "A 100 dpi."
2588 Referencia de la notación:
2589 @ref{Lista de caracteres especiales}.
2591 Archivos instalados:
2592 @file{ly/text-replacements.ly}.
2595 @node Controlar la salida
2596 @section Controlar la salida
2597 @translationof Controlling output
2600 * Extracción de fragmentos de música::
2601 * Saltar la música corregida::
2602 * Formatos de salida alternativos::
2603 * Sustituir la tipografía de la notación::
2607 @node Extracción de fragmentos de música
2608 @subsection Extracción de fragmentos de música
2609 @translationof Extracting fragments of music
2611 Es posible citar pequeños fragmentos de una partitura grande
2612 directamente a partir de la salida. Puede compararse con la
2613 separación de una pieza de una partitura, recortándola con tijeras.
2615 Esto se hace definiendo los compases que se deben recortar. Por
2616 ejemplo, la inclusión de la siguiente definición
2623 (make-rhythmic-location 5 1 2)
2624 (make-rhythmic-location 7 3 4)))
2629 extrae un fragmento empezando por la mitad del quinto compás y
2630 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
2631 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
2632 después de tres negras del compás 7.
2634 Se pueden definir más zonas de recorte añadiendo más parejas de
2635 definición de tiempo rhythmic-location a la lista.
2637 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
2638 la opción @option{-dclip-systems}. Los recortes aparecen en la salida
2639 como archivos EPS, y se convierten en PDF y PNG si estos formatos
2640 también están activados.
2642 Para ver más información sobre los formatos de salida, consulte
2643 @rprogram{Invocar a LilyPond}.
2646 @node Saltar la música corregida
2647 @subsection Saltar la música corregida
2648 @translationof Skipping corrected music
2650 @funindex skipTypesetting
2651 @funindex showFirstLength
2652 @funindex showLastLength
2654 Al escribir o copiar música, normalmente sólo es interesante de ver y
2655 corregir la música cercana al final (donde estamos añadiendo las
2656 notas). Para acelerar este proceso de corrección, es posible saltar
2657 la composición tipográfica de todos excepto unos pocos de los últimos
2658 compases. Esto se consigue poniendo
2661 showLastLength = R1*5
2666 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
2667 cinco compases (suponiendo un compás de 4/4) de cada una de las
2668 partituras @code{\score} del archivo de entrada. Para piezas largas,
2669 el tipografiado de únicamente una parte pequeña es con frecuencia un
2670 orden de magnitud más rápido que el de la obra completa. Si estamos
2671 trabajando sobre el principio de una partitura que ya hemos
2672 tipografiado (p.ej., para añadir una parte instrumental nueva),
2673 también puede ser útil la propiedad @code{showFirstLength}.
2675 Este mecanismo de pasar por alto partes de un partitura se puede
2676 controlar con un grano más fino mediante la propiedad
2677 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
2678 lleva a cabo ningún tipografiado en absoluto.
2680 Esta propiedad se usa también para controlar la salida al archivo
2681 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
2682 y los cambios de instrumento. Está usted advertido.
2684 @lilypond[quote,relative=2,ragged-right,verbatim]
2686 \set Score.skipTypesetting = ##t
2688 \set Score.skipTypesetting = ##f
2692 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
2693 voces y pentagramas, ahorrando más tiempo incluso.
2696 @node Formatos de salida alternativos
2697 @subsection Formatos de salida alternativos
2698 @translationof Alternative output formats
2700 @cindex salida de gráficos de vector escalables
2702 @cindex salida de PostScript encapsulado
2704 @cindex PostScript encapsulado, salida de
2706 Los formatos de salida predeterminados para la partitura impresa son
2707 el formato de documento portátil (PDF) y PostScript (PS). Los
2708 formatos de salida Gráficos de vector escalables (SVG), PostScript
2709 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
2710 disponibles a través de opciones de la línea de órdenes, véase
2711 @rprogram{Opciones básicas de la línea de órdenes para LilyPond}.
2714 @node Sustituir la tipografía de la notación
2715 @subsection Sustituir la tipografía de la notación
2716 @translationof Replacing the notation font
2718 Gonville es una alternativa a la tipografía Feta que se utiliza en
2719 LilyPond y se puede descargar de:
2721 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2724 Aquí presentamos algunos compases de muestra tipografiados con la
2727 @c NOTE: these images are a bit big, but that's important
2728 @c for the font comparison. -gp
2729 @sourceimage{Gonville_after,,,}
2731 Aquí hay unos compases de muestra tipografiados en la fuente Feta de
2734 @sourceimage{Gonville_before,,,}
2736 @subsubheading Instrucciones de instalación para MacOS
2738 Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
2739 a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
2740 consulte @rlearning{Otras fuentes de información}. Renombre la carpeta
2741 @code{fonts} existente a @code{fonts_orig} y la carpeta
2742 @code{lilyfonts} a @code{fonts}. Para volver a la fuente Feta,
2743 invierta el proceso.
2746 Manual de aprendizaje:
2747 @rlearning{Otras fuentes de información}.
2751 Gonville no se puede usar para tipografiar notación de @q{Música
2752 Antigua} y es probable que cualquier nuevo glifo en versiones
2753 posteriores de LilyPond no existan en la familia
2754 tipográfica Gonville. Diríjase a la página web del autor para obtener más
2755 información sobre éste y otros asuntos, entre ellos el régimen de
2756 licencias de Gonville.
2760 @section Salida MIDI
2761 @translationof MIDI output
2766 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
2767 Instrumentos Musicales) es un estándar para interconectar y controlar
2768 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
2769 una serie de notas dentro de un conjunto de pistas. No es un archivo
2770 de sonidos reales; se necesita un programa reproductor especial para
2771 traducir la serie de notas en sonidos de verdad.
2773 Cualquier música se puede convertir a archivos MIDI, de manera que
2774 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
2775 para comprobar la corrección de la música; las octavas equivocadas o
2776 las alteraciones erróneas se ponen de relieve muy claramente al
2777 escuchar la salida MIDI.
2779 La salida estándar de MIDI es un poco primitiva; de forma opcional, se
2780 encuentra disponible una salida MIDI mejorada y mucho más realista,
2781 por medio de @ref{El script Articulate}.
2783 La salida MIDI reserva un canal por cada pentagrama, y reserva
2784 el canal 10 para la percusión. Sólo hay 16 canales MIDI por cada
2785 dispositivo, por lo que si la partitura tiene más de 15 pautas, los
2786 canales MIDI se reutilizarán.
2789 * Crear archivos MIDI::
2790 * Instrumentos MIDI::
2792 * ¿Qué sale por el MIDI?::
2793 * Repeticiones y MIDI::
2794 * Control de los matices en el MIDI::
2795 * Percusión en MIDI::
2796 * El script Articulate::
2799 @node Crear archivos MIDI
2800 @subsection Crear archivos MIDI
2801 @translationof Creating MIDI files
2803 Para crear un MIDI a partir de una pieza de música, escriba un bloque
2804 @code{\midi} en la partitura, por ejemplo:
2813 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
2814 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
2815 necesita una notación impresa, debe haber también un bloque
2826 Se traducen correctamente a la salida MIDI la altura y duración de las
2827 notas, las ligaduras de unión, matices y cambios de tempo. Las
2828 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
2829 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
2830 del rango de volumen MIDI disponible. Los crescendi y decrescendi
2831 hacen que el volumen varía linealmente entre sus dos extremos. El
2832 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
2833 eliminar por completo, véase @ref{El bloque MIDI}.
2835 El tempo inicial y los cambios de tempo posteriores se pueden
2836 especificar utilizando la instrucción @code{\tempo} dentro de la
2837 propia notación musical. Se reflejan en cambios de tempo en la salida
2838 MIDI. Esta instrucción normalmente hace que se imprima la indicación
2839 metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
2840 Más abajo se describe una forma alternativa de especificar el tempo
2841 MIDI inicial o global, véase @ref{El bloque MIDI}.
2843 Debido a ciertas limitaciones de Windows, la extensión predeterminada
2844 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
2845 operativos utilizan la extensión @code{.midi}. Si prefiere una
2846 extensión diferente, inserte la siguiente línea en el nivel jerárquico
2847 superior del archivo de entrada, antes del inicio de cualquier bloque
2848 @code{\book}, @code{\bookpart} o @code{\score}:
2851 #(ly:set-option 'midi-extension "midi")
2854 La línea anterior establece la extensión predeterminada para los
2855 archivos MIDI a @code{.midi}.
2857 De forma alternativa, esta opción se puede también proporcionar en
2858 la línea de órdenes:
2861 lilypond … -dmidi-extension=midi archivoLily.ly
2867 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2868 {changing-midi-output-to-one-channel-per-voice.ly}
2872 @c In 2.11 the following no longer seems to be a problem -td
2874 Unterminated (de)crescendos will not render properly in the midi file,
2875 resulting in silent passages of music. The workaround is to explicitly
2876 terminate the (de)crescendo. For example,
2883 will not work properly but
2886 @{ a4\< b c d\!\f @}
2893 Los cambios del volumen MIDI sólo tienen lugar al principio de la
2894 nota, por lo que los crescendi y decrescendi no pueden afectar al
2895 volumen de una sola nota.
2897 No todos los reproductores de MIDI manejan adecuadamente los
2898 cambios de tempo de la salida MIDI. Entre los reproductores que
2899 se sabe que funcionan se encuentran el Reproductor de Medios de MS
2900 Windows y @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
2902 @node Instrumentos MIDI
2903 @subsection Instrumentos MIDI
2904 @translationof MIDI Instruments
2906 @cindex instrumento, nombres de
2907 @funindex Staff.midiInstrument
2909 El instrumento MIDI que se quiere utilizar se establece fijando la
2910 propiedad @code{Staff.midiInstrument} al nombre del instrumento.
2911 El nombre se debe elegir de entre los que están en la lista que
2912 aparece en @ref{instrumentos MIDI}.
2916 \set Staff.midiInstrument = #"glockenspiel"
2922 \new Staff \with @{midiInstrument = #"cello"@} @{
2927 Si el instrumento elegido no coincide exactamente con uno de los
2928 instrumentos de la lista de instrumentos MIDI, se usará el
2929 instrumento Piano de Cola (@code{"acoustic grand"}).
2931 @node El bloque MIDI
2932 @subsection El bloque MIDI
2933 @translationof MIDI block
2937 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
2938 dentro de un bloque de partitura. Es análogo al bloque layout de
2939 diseño de página, pero algo más simple. Con frecuencia, el bloque
2940 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
2941 contextos, definiciones de contexto nuevas o código para fijar valores
2942 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
2943 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
2944 indicación de tempo:
2955 En este ejemplo, el tempo se establece a 72 pulsos de negra por
2956 minuto. @code{\tempo} is actually a music command for
2957 setting properties during the interpretation of music: in the
2958 context of output definitions like a @code{\midi} block, as a matter of
2959 courtesy those are reinterpreted as if they were context modifications.
2961 @cindex MIDI, definiciones de contexto
2963 Las definiciones de contexto siguen con precisión la misma sintaxis
2964 que la de un bloque @code{\layout}. Los módulos de traducción para el
2965 sonido reciben el nombre de ejecutantes. Los contextos para la salida
2966 MIDI se definen en @file{../ly/performer-init.ly}, véase
2967 @rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
2968 el efecto de los matices de la salida MIDI, inserte las líneas
2969 siguientes en el bloque @code{\midi@{ @}}.
2976 \remove "Dynamic_performer"
2981 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
2982 dentro de un bloque de partitura definido con una instrucción
2987 @{ @dots{}notas@dots{} @}
2993 @node ¿Qué sale por el MIDI?
2994 @subsection ¿Qué sale por el MIDI?
2995 @translationof What goes into the MIDI output?
2998 * Contemplado en el MIDI::
2999 * No contemplado en el MIDI::
3002 @node Contemplado en el MIDI
3003 @unnumberedsubsubsec Contemplado en el MIDI
3004 @translationof Supported in MIDI
3006 @cindex alturas en MIDI
3007 @cindex MIDI, alturas
3008 @cindex cuartos de tono en MIDI
3009 @cindex MIDI, cuartos de tono
3010 @cindex microtonos en MIDI
3011 @cindex MIDI, microtonos
3012 @cindex acordes, nombres de, en MIDI
3013 @cindex MIDI, nombres de
3014 @cindex duraciones en MIDI
3015 @cindex MIDI, duraciones
3016 @cindex Articlulate, scripts
3017 @cindex MIDI, articulaciones
3018 @cindex articulaciones en MIDI
3019 @cindex trinos en MIDI
3020 @cindex grupetos en MIDI
3021 @cindex rallentando en MIDI
3022 @cindex accelerando en MIDI
3025 Los siguientes elementos de notación se reflejan en la salida MIDI:
3029 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
3030 @item Acordes escritos como nombres de acorde
3031 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
3032 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
3033 @item Ligaduras de unión
3034 @item Matices o indicaciones de dinámica
3035 @item Crescendi y decrescendi sobre varias notas
3036 @item Cambios de tempo insertados con una marca metronómica
3037 @item Letra de las canciones
3040 Utilizando @ref{El script Articulate}, a la lista anterior se añaden
3041 una serie de elementos:
3044 @item Articulaciones (ligaduras de expresión, picados, etc)
3045 @item Trinos, mordentes circulares
3046 @item Rallentando y accelerando
3050 @node No contemplado en el MIDI
3051 @unnumberedsubsubsec No contemplado en el MIDI
3052 @translationof Unsupported in MIDI
3054 @c TODO index as above
3056 Los siguientes elementos de notación no tienen ningún efecto sobre la
3057 salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
3060 @item Duraciones escritas como anotaciones, p.ej. el swing
3061 @item Cambios de tempo escritos como anotaciones sin marca de tempo
3062 @item Staccato y otras articulaciones y ornamentos
3063 @item Ligaduras de expresión y de fraseo
3064 @item Crescendi y decrescendi sobre una nota única
3065 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
3067 @item Acordes microtonales
3071 @node Repeticiones y MIDI
3072 @subsection Repeticiones y MIDI
3073 @translationof Repeats in MIDI
3075 @cindex repeticiones, expandir
3076 @funindex \unfoldRepeats
3078 Con un poco de trucaje, se puede hacer que cualquier tipo de
3079 repetición esté presente en la salida MIDI. Esto se consigue mediante
3080 la aplicación de la función musical @code{\unfoldRepeats}. Esta
3081 función cambia todas las repeticiones a repeticiones desplegadas.
3083 @lilypond[quote,verbatim]
3085 \repeat tremolo 8 { c'32 e' }
3086 \repeat percent 2 { c''8 d'' }
3087 \repeat volta 2 { c'4 d' e' f' }
3096 En partituras con varias voces, el desplegado de las repeticiones en
3097 la salida MIDI solo se produce correctamente si @emph{todas y cada
3098 una} de las voces incluye las repeticiones de manera completa y
3101 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
3102 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
3103 (con repeticiones desplegadas) y otro para la notación impresa (con
3104 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
3105 y percent --repetición de compases--). Por ejemplo,
3113 \unfoldRepeats @var{..música..}
3119 @node Control de los matices en el MIDI
3120 @subsection Control de los matices en el MIDI
3121 @translationof Controlling MIDI dynamics
3123 La dinámica en el MIDI está implementada por medio del intérprete
3124 Dynamic_performer que reside de forma predeterminada dentro del
3125 contexto Voice. Es posible controlar el volumen MIDI general, el
3126 volumen relativo de los matices dinámicos y el volumen relativo de los
3127 distintos instrumentos.
3130 * Indicaciones dinámicas::
3131 * Volumen maestro MIDI::
3132 * Balance entre instrumentos (i)::
3133 * Balance entre instrumentos (ii)::
3136 @node Indicaciones dinámicas
3137 @unnumberedsubsubsec Indicaciones dinámicas
3138 @translationof Dynamic marks
3140 Los matices o indicaciones de dinámica se traducen a una fracción
3141 fija del rango de volumen MIDI disponible. Las fracciones
3142 predeterminadas se extienden desde 0.25 para @notation{ppppp}
3143 hasta 0.95 para @notation{fffff}. El conjunto de indicaciones
3144 dinámicas y las fracciones asociadas pueden verse en
3145 @file{../scm/midi.scm}, véase @rlearning{Otras fuentes de
3146 información}. Este conjunto de fracciones se puede cambiar o
3147 extender proporcionando una función que toma como argumento una
3148 indicación dinámica y devuelve la fracción requerida, y
3149 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
3152 Por ejemplo, si se requiere una indicación dinámica
3153 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
3154 predeterminado sobre el volumen MIDI, pues no está incluida en el
3155 conjunto predeterminado. De igual manera, si se define una
3156 indicación dinámica nueva con @code{make-dynamic-script}, ésta
3157 tampoco estará incluida en el conjunto predeterminado. El ejemplo
3158 siguiente muestra cómo hay que añadir el volumen MIDI para estas
3159 indicaciones dinámicas. La función Scheme establece la fracción a
3160 0.9 si se encuentra una indicación dinámica rfz, y en caso
3161 contrario llama a la función predeterminada.
3163 @lilypond[verbatim,quote]
3164 #(define (myDynamics dynamic)
3165 (if (equal? dynamic "rfz")
3167 (default-dynamic-absolute-volume dynamic)))
3171 \set Staff.midiInstrument = #"cello"
3172 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
3184 Como alternativa, si se necesitara redefinir la tabla completa de
3185 fracciones, sería mejor usar el procedimiento
3186 @notation{default-dynamic-absolute-volume} que aparece en
3187 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
3188 ejemplo de esta sección muestra cómo se puede hacer esto.
3190 @node Volumen maestro MIDI
3191 @unnumberedsubsubsec Volumen maestro MIDI
3192 @translationof Overall MIDI volume
3194 El volumen general máximo y mínimo de las indicaciones dinámicas
3195 de MIDI se controla estableciendo valores para las propiedades
3196 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
3197 @code{Score}. Estas propiedades tienen efecto solamente sobre las
3198 indicaciones dinámicas, por ello si queremos que tengan validez
3199 desde el comienzo de la partitura, se debe colocar allí una
3200 indicación de dinámica. La fracción que corresponde a cada
3201 indicación dinámica se modifica con esta fórmula:
3204 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
3207 En el ejemplo siguiente, el rango de intensidad dinámica del
3208 volumen general MIDI está limitado al intervalo desde 0.2 hasta
3211 @lilypond[verbatim,quote]
3217 \set Staff.midiInstrument = #"flute"
3218 \new Voice \relative c''' {
3226 \set Staff.midiInstrument = #"clarinet"
3227 \new Voice \relative c'' {
3239 midiMinimumVolume = #0.2
3240 midiMaximumVolume = #0.5
3246 @node Balance entre instrumentos (i)
3247 @unnumberedsubsubsec Balance entre instrumentos (i)
3248 @translationof Equalizing different instruments (i)
3250 Si las propiedades de volumen MIDI máximo y mínimo están
3251 establecidas en el contexto @code{Staff} se pueden controlar los
3252 volúmenes relativos de los instrumentos MIDI. Esto proporciona un
3253 ecualizador de instrumentos básico que puede realzar
3254 significativamente la calidad de la salida MIDI.
3256 En este ejemplo se reduce el volumen del clarinete con relación al
3257 de la flauta. Debe haber una indicación dinámica en la primera
3258 nota de cada instrumento para que esto funcione correctamente.
3260 @lilypond[verbatim,quote]
3266 \set Staff.midiInstrument = #"flute"
3267 \set Staff.midiMinimumVolume = #0.7
3268 \set Staff.midiMaximumVolume = #0.9
3269 \new Voice \relative c''' {
3277 \set Staff.midiInstrument = #"clarinet"
3278 \set Staff.midiMinimumVolume = #0.3
3279 \set Staff.midiMaximumVolume = #0.6
3280 \new Voice \relative c'' {
3295 @node Balance entre instrumentos (ii)
3296 @unnumberedsubsubsec Balance entre instrumentos (ii)
3297 @translationof Equalizing different instruments (ii)
3299 Si las propiedades de volumen MIDI máximo y mínimo no están
3300 establecidas, de forma predeterminada LilyPond aplica un pequeño
3301 grado de ecualización a algunos instrumentos. Los instrumentos y
3302 la ecualización que se aplica se muestra en la tabla
3303 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
3305 El ecualizador básico predeterminado se puede sustituir
3306 estableciendo @code{instrumentEqualizer} en el contexto
3307 @code{Score} a un procedimiento Scheme nuevo que acepte el nombre
3308 de un instrumento MIDI como único argumento y devuelva un par de
3309 fracciones que dan los volúmenes máximo y mínimo que se aplican a
3310 dicho instrumento. Esta sustitución se hace de la misma forma que
3311 mostramos para restablecer la fracción de volumen absoluto
3312 @code{dynamicAbsoluteVolumeFunction} al comienzo de esta sección.
3313 El ecualizador predeterminado,
3314 @notation{default-instrument-equalizer}, en
3315 @file{../scm/midi.scm}, muestra cómo se puede escribir tal
3318 El ejemplo siguiente establece los volúmenes relativos de la
3319 flauta y del clarinete a los mismos valores que el ejemplo
3322 @lilypond[verbatim,quote]
3323 #(define my-instrument-equalizer-alist '())
3325 #(set! my-instrument-equalizer-alist
3328 ("flute" . (0.7 . 0.9))
3329 ("clarinet" . (0.3 . 0.6)))
3330 my-instrument-equalizer-alist))
3332 #(define (my-instrument-equalizer s)
3333 (let ((entry (assoc s my-instrument-equalizer-alist)))
3342 \set Score.instrumentEqualizer = #my-instrument-equalizer
3343 \set Staff.midiInstrument = #"flute"
3344 \new Voice \relative c''' {
3352 \set Staff.midiInstrument = #"clarinet"
3353 \new Voice \relative c'' {
3368 @c Delete when satisfied this is adequately covered elsewhere -td
3370 @n ode Microtones in MIDI
3371 @s ubsection Microtones in MIDI
3373 @cindex microtones in MIDI
3375 Microtones consisting of half sharps and half flats are exported
3376 to the MIDI file and render correctly in MIDI players which support
3377 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
3378 an example showing all the half sharps and half flats. It can be
3379 copied out and compiled to test microtones in your MIDI player.
3381 @lilypond[verbatim,quote]
3398 @node Percusión en MIDI
3399 @subsection Percusión en MIDI
3400 @translationof Percussion in MIDI
3402 La notación de los instrumentos de percusión se realiza
3403 normalmente en un contexto @code{DrumStaff} y cuando se hace de
3404 esta forma se les da salida correctamente por el canal
3405 MIDI@tie{}10, pero ciertos instrumentos de percusión de altura
3406 determinada, como el xilófono, marimba, vibráfono, timbales, etc.,
3407 se tratan como instrumentos @qq{normales} y la música para estos
3408 instrumentos se debe introducir en contextos de @code{Staff}
3409 normales, no en un contexto @code{DrumStaff}, para obtener la
3410 salida MIDI correcta.
3412 Ciertos sonidos de altura indeterminada que están incluidos en el
3413 estándar General MIDI, como el tom melódico, el tambor taiko, los
3414 tambores sintéticos, etc., no se pueden acceder a través del canal
3415 MIDI@tie{}10, por lo que la notación para dichos instrumentos se
3416 debe introducir también en un contexto normal de @code{Staff},
3417 utilizando las alturas normales adecuadas.
3419 Muchos instrumentos de percusión no están incluidos dentro del
3420 estándar General MIDI, p.ej. las castañuelas. El método más fácil
3421 (aunque no satisfactorio) de producir una salida MIDI al escribir
3422 para estos instrumentos es sustituirlos por el sonido más parecido
3423 del conjunto estándar.
3425 @c TODO Expand with examples, and any other issues
3429 Debido a que el estándar General MIDI no contiene golpes de aro
3430 (@emph{rim shots}), para este propósito se utiliza en su lugar el
3431 golpe lateral de baqueta (@emph{sidestick}).
3434 @node El script Articulate
3435 @subsection El script Articulate
3436 @translationof The Articulate script
3438 Es posible obtener una salida MIDI más real si se utiliza el
3439 script Articulate. Éste trata de tener en cuenta las
3440 articulaciones (ligaduras de expresión, picados, etc), mediante la
3441 sustitución de las notas con secuencias musicales de silencios y
3442 notas escaladas en el tiempo de forma apropiada. También trata de
3443 desplegar los trinos, grupetos circulares, etc. y responder a las
3444 indicaciones de rallentando y accelerando.
3446 Para utilizar el script Articulate, tenemos que incluirlo al
3447 principio de nuestro archivo de entrada:
3450 \include "articulate.ly"
3453 y en la sección @code{\score}, hacer lo siguiente:
3456 \unfoldRepeats \articulate <<
3457 resto de la partitura...
3461 Después de alterar el código de entrada de esta manera el
3462 resultado visual se altera profundamente, pero el bloque
3463 @code{\midi} estándar produce un archivo MIDI mejorado.
3465 Si bien no es esencial para que funcione el script Articulate,
3466 podemos insertar la instrucción @code{\unfoldRepeats} según
3467 aparece en el ejemplo anterior, dado que habilita la ejecución de
3468 abreviaturas tales como los @notation{trinos}.
3472 Articulate acorta los acordes, y ciertos fragmentos de música
3473 (especialmente la música de órgano) es posible que suene peor.
3476 @node Extraer información musical
3477 @section Extraer información musical
3478 @translationof Extracting musical information
3480 Además de crear un resultado visual y MIDI, LilyPond es capaz de
3481 presentar información musical en forma de texto.
3484 * Impresión del código de notación de LilyPond::
3485 * Impresión de las expresiones musicales de Scheme::
3486 * Guardar los eventos musicales en un archivo::
3490 @node Impresión del código de notación de LilyPond
3491 @subsection Displaying LilyPond notation
3492 @translationof Displaying LilyPond notation
3494 @funindex \displayLilyMusic
3495 La impresión textual de una expresión musical en notación de
3496 LilyPond puede hacerse con la función musical
3497 @code{\displayLilyMusic}. Para ver el resultado, lo más usual es
3498 llamar a LilyPond mediante la línea de órdenes. Por ejemplo,
3502 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3506 imprime lo siguiente:
3509 @{ a,4 cis e fis g @}
3512 De forma predeterminada, LilyPond imprime estos mensajes en la
3513 consola junto al resto de los mensajes de la compilación de
3514 LilyPond. Para discernir entre estos mensajes y guardar el
3515 resultado de @code{\display@{MATERIAL@}}, redireccione la salida
3519 lilypond archivo.ly >resultado.txt
3523 @node Impresión de las expresiones musicales de Scheme
3524 @subsection Impresión de las expresiones musicales de Scheme
3525 @translationof Displaying scheme music expressions
3527 Véase @rextend{Presentación de las expresiones musicales}.
3530 @node Guardar los eventos musicales en un archivo
3531 @subsection Guardar los eventos musicales en un archivo
3532 @translationof Saving music events to a file
3534 Los eventos musicales se pueden guardar en un archivo pentagrama a
3535 pentagrama mediante la inclusión de un archivo en nuestra
3536 partitura principal.
3539 \include "event-listener.ly"
3542 De esta forma se crean uno o más archivos llamados
3543 @file{FILENAME-STAFFNAME.notes} ó
3544 @file{FILENAME-unnamed-staff.notes} para cada pentagrama. Observe
3545 que si tiene más de un pentagrama sin nombre, los eventos de todos
3546 los pentagramas se mezclarán entre sí dentro del mismo archivo.
3547 El resultado tiene el aspecto siguiente:
3550 0.000 note 57 4 p-c 2 12
3552 0.250 note 62 4 p-c 7 12
3553 0.500 note 66 8 p-c 9 12
3554 0.625 note 69 8 p-c 14 12
3559 La sintaxis consiste en una línea delimitada por caracteres de
3560 tabulación, con dos campos fijos en cada línea seguidos de
3561 parámetros opcionales.
3564 @var{tiempo} @var{tipo} @var{...parámetros...}
3567 Esta información se puede leer fácilmente por parte de otros
3568 programas como guiones de Python, y pueden ser muy útiles para
3569 aquellos investigadores que desean realizar un análisis musical o
3570 hacer experimientos de reproducción con LilyPond.
3573 No todos los eventos musicales de lilypond están contemplados por
3574 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
3575 concepto} bien realizada. Si algunos eventos que quiere ver no
3576 aparecen incluidos, copie @file{event-listener.ly} en su carpeta
3577 de lilypond y modifique el archivo de forma que produzca la
3578 información que desea.