1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 9f651e1f5143787aeda825a4061f82eede4943a3
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @node Entrada y salida generales
14 @chapter Entrada y salida generales
15 @translationof General input and output
17 Esta sección trata de asuntos relacionados con la entrada y salida
18 generales de LilyPond, más que con la notación específica.
21 * Estructura del código de entrada::
22 * Títulos y cabeceras::
23 * Trabajar sobre los archivos de entrada::
24 * Controlar la salida::
29 @node Estructura del código de entrada
30 @section Estructura del código de entrada
31 @translationof Input structure
33 El formato principal de entrada para LilyPond son archivos de texto.
34 Por convenio, el nombre de estos archivos termina en @file{.ly}.
37 * Estructura de una partitura::
38 * Varias partituras en un libro::
39 * Varios archivos de salida a partir de uno de entrada::
40 * Nombres de los archivos de salida::
41 * Estructura del archivo::
45 @node Estructura de una partitura
46 @subsection Estructura de una partitura
47 @translationof Structure of a score
51 Un bloque @code{\score} debe contener una expresión musical única
52 delimitada por un par de llaves:
61 @warning{Sólo puede haber @strong{una} expresión musical dentro del
62 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
64 Esta expresión musical única puede tener cualquier tamaño, y puede
65 contener otras expresiones musicales hasta cualquier grado de
66 complejidad. Todos los siguientes ejemplos son expresiones musicales:
72 @lilypond[verbatim,quote]
79 @lilypond[verbatim,quote]
81 \new Staff { c'4 c' c' c' }
82 \new Staff { d'4 d' d' d' }
90 \new Staff @{ \flute @}
91 \new Staff @{ \oboe @}
94 \new Staff @{ \violinI @}
95 \new Staff @{ \violinII @}
101 Los comentarios son una excepción a esta regla general (para ver otras
102 excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
103 una línea como los que están delimitados por @code{%@{ .. %@}} se
104 pueden escribir en cualquier lugar dentro del archivo de entrada. Se
105 pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
106 fuera de la expresión musical única dentro del bloque @code{\score}.
108 Recuerde que incluso dentro de un archivo que contenga solamente un
109 bloque @code{\score}, éste se encuentra incluido implícitamente dentro
110 de un bloque @code{\book}. Un bloque @code{\book} dentro de un
111 archivo fuente produce al menos un archivo de salida, y de forma
112 predeterminada el nombre del archivo de salida que se produce está
113 derivado del nombre del archivo de entrada, de forma que
114 @file{fandangoforelephants.ly} da como resultado
115 @file{fandangoforelephants.pdf}.
117 (Para ver más detalles acerca de los bloques @code{\book}, consulte
118 @ref{Varias partituras en un libro}, @ref{Varios archivos de salida a
119 partir de uno de entrada} y @ref{Estructura del archivo}.)
122 Manual de aprendizaje:
123 @rlearning{Trabajar sobre los archivos de entrada},
124 @rlearning{Explicación de las expresiones musicales},
125 @rlearning{La partitura es una (única) expresión musical compuesta}.
128 @node Varias partituras en un libro
129 @subsection Varias partituras en un libro
130 @translationof Multiple scores in a book
133 @cindex movimientos, varios
135 Un documento puede contener varias piezas de música y texto. Son
136 ejemplos un libro de estudios o una parte orquestal con varios
137 movimientos. Cada movimiento se introduce con un bloque
146 y los textos se introducen con un bloque @code{\markup}:
156 Todos los movimientos y textos que aparecen en el mismo archivo
157 @file{.ly} se tipografían normalmente en la forma de un solo archivo
172 Una excepción importante se da dentro de los documentos de
173 lilypond-book, en los que tenemos que escribir explícitamente un
174 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
175 salida el primer @code{\score} o @code{\markup}.
177 El encabezamiento de cada pieza se puede poner dentro del bloque
178 @code{\score}. Antes de cada movimiento, se imprime el nombre de la
179 pieza (@code{piece}) extraído del encabezamiento. El título del libro
180 entero se puede poner dentro del bloque @code{\book}, pero si no está
181 presente se inserta el encabezamiento @code{\header} que está al
182 principio del archivo.
186 title = "Ocho miniaturas"
187 composer = "Igor Stravinsky"
191 \header @{ piece = "Romanze" @}
194 ..texto de la segunda estrofa..
197 ..texto de la tercera estrofa..
201 \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"
232 @node Varios archivos de salida a partir de uno de entrada
233 @subsection Varios archivos de salida a partir de uno de entrada
234 @translationof Multiple output files from one input file
236 Si queremos varios archivos de salida a partir del mismo archivo
237 @file{.ly}, podemos escribir varios bloques @code{\book}, donde cada
238 uno de estos bloques @code{\book} dará como resultado un archivo de
239 salida distinto. Si no especificamos ningún bloque @code{\book} en el
240 archivo, LilyPond trata implícitamente todo el archivo como un solo
241 bloque @code{\book}, véase @ref{Estructura del archivo}.
243 Al producir varios archivos a partir de un solo archivo fuente,
244 Lilypond se asegura de que ninguno de los archivos de salida de ningún
245 bloque @code{\book} sobreescribe el archivo de salida producido por un
246 @code{\book} anterior del mismo archivo de entrada.
248 Lo hace añadiendo un sufijo al nombre de la salida para cada libro
249 @code{\book} que utiliza el nombre del archivo de salida
250 predeterminado, derivado del archivo fuente de entrada.
252 El comportamiento predeterminado es añadir un sufijo con el número de
253 versión para cada nombre que pueda coincidir; así:
258 \layout @{ @dots{} @}
262 \layout @{ @dots{} @}
266 \layout @{ @dots{} @}
270 en el archivo fuente @file{eightminiatures.ly}, produce
274 @file{eightminiatures.pdf},
276 @file{eightminiatures-1.pdf} y
278 @file{eightminiatures-2.pdf}.
281 @node Nombres de los archivos de salida
282 @subsection Nombres de los archivos de salida
283 @translationof Output file names
285 @funindex \bookOutputSuffix
286 @funindex \bookOutputName
288 Lilypond le ofrece unos mecanismos que le permiten controlar los
289 nombres de archivo que se utilizan por parte de los diversos motores
290 finales al producir los archivos de salida.
292 En la sección anterior vimos cómo Lilypond evita las coincidencias de
293 nombres al producir varias salidas a partir de un único archivo fuente
294 de entrada. También podemos especificar nuestros propios sufijos para
295 cada bloque @code{\book}, de manera que podemos producir, por ejemplo,
296 archivos con los nombres @file{eightminiatures-Romanze.pdf},
297 @file{eightminiatures-Menuetto.pdf} y
298 @file{eightminiatures-Nocturne.pdf} añadiendo una declaración
299 @code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
303 \bookOutputSuffix "Romanze"
305 \layout @{ @dots{} @}
308 \bookOutputSuffix "Menuetto"
310 \layout @{ @dots{} @}
313 \bookOutputSuffix "Nocturne"
315 \layout @{ @dots{} @}
319 También podemos especificar un nombre de archivo de salida diferente
320 para cada bloque @code{book}, mediante la utilización de declaraciones
321 @code{\bookOutputName}:
325 \bookOutputName "Romanze"
327 \layout @{ @dots{} @}
330 \bookOutputName "Menuetto"
332 \layout @{ @dots{} @}
335 \bookOutputName "Nocturne"
337 \layout @{ @dots{} @}
341 El código anterior produce los siguientes archivos de salida:
347 @file{Menuetto.pdf} y
352 @node Estructura del archivo
353 @subsection Estructura del archivo
354 @translationof File structure
364 Un archivo @file{.ly} puede contener cualquier número de expresiones
365 del nivel superior, donde una expresión del nivel superior es una de
366 las siguientes posibilidades:
370 Una definición de salida, como @code{\paper}, @code{\midi} y
371 @code{\layout}. Tal definición en el nivel más alto cambia los
372 ajustes predeterminados para todo el libro. Si se introduce más de
373 una de estas definiciones del mismo tipo en el nivel más alto,
374 cualquier definición en una expresión posterior tiene prioridad.
377 Una expresión directa de Scheme, como
378 @code{#(set-default-paper-size "a7" 'landscape)} o
379 @code{#(ly:set-option 'point-and-click #f)}.
382 Un bloque @code{\header}. Esto establece el bloque de encabezamiento
383 global. Es el bloque que contiene las definiciones de los ajustes
384 para todo el libro, como el compositor, título, etc.
387 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
388 del nivel superior, y se combina con ellas formando un @code{\book}
389 (libro) único. Este comportamiento se puede cambiar estableciendo el
390 valor de la variable @code{toplevel-score-handler} en el nivel
391 superior. El @emph{handler} predeterminado se define en el archivo de
392 inicio @file{../scm/lily.scm}.
395 Un bloque @code{\book} combina lógicamente varios movimientos (es
396 decir, varios bloques @code{\score}) en un solo documento. Si hay
397 varias partituras @code{\score}, se crea un solo archivo de salida
398 para cada bloque @code{\book}, en el que se concatenan todos los
399 movimientos correspondientes. La única razón para especificar
400 explícitamente bloques @code{\book} en un archivo de entrada
401 @file{.ly} es si queremos crear varios archivos de salida a partir de
402 un único archivo de entrada. Una excepción se da dentro de los
403 documentos de lilypond-book, en los que tenemos que escribir
404 explícitamente un bloque @code{\book} si queremos tener más de una
405 única partitura @code{\score} o marcado @code{\markup} en el mismo
406 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
407 de la variable @code{toplevel-book-handler} en el nivel superior. El
408 @emph{handler} predeterminado se define en el archivo de inicio
409 @file{../scm/lily.scm}.
412 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
413 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
414 la inserción de saltos de página o usar distintos ajustes de
415 @code{\paper} en las distintas partes.
418 Una expresión musical compuesta, como
423 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
424 único junto a todas las demás partituras @code{\score} y expresiones
425 musicales del nivel superior. En otras palabras, un archivo que
426 contiene sólo la expresión musical anterior se traduce a
442 Se puede cambiar este comportamiento estableciendo el valor de la
443 variable @code{toplevel-music-handler} en el nivel más alto. El
444 @emph{handler} predeterminado se define en el archivo de inicio
445 @file{../scm/lily.scm}.
448 Un texto de marcado, por ejemplo una estrofa
451 2. Estrofa dos, línea uno
455 Los textos de marcado se colocan encima, en medio o debajo de las
456 partituras o expresiones musicales, según donde aparezcan escritos.
463 fulano = @{ c4 d e d @}
466 Esto se puede utilizar más tarde en el archivo escribiendo
467 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
468 alfabético; sin números, guiones ni barras bajas.
472 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
477 % No justificar la salida
488 En cualquier punto del archivo se pueden introducir cualquiera de las
489 instrucciones léxicas siguientes:
492 @item @code{\version}
493 @item @code{\include}
494 @item @code{\sourcefilename}
495 @item @code{\sourcefileline}
497 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
500 Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
504 @cindex espacios en blanco
506 Por lo general se ignoran los espacios entre elementos del flujo de
507 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
508 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
509 evitar errores, en las siguientes situaciones:
512 @item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
513 @item A continuación de las instrucciones y variables, es decir, todos los elementos
514 que comienzan con un signo @code{\} de barra invertida.
515 @item A continuación de todo elemento que se deba interpretar como expresión
516 de Scheme, es decir, todo elemento que comience por un signo @code{#}.
517 @item Para separar los elementos de una expresión de Scheme.
518 @item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
519 @code{\override} y @code{\set}. Concretamente, hay que usar espacios
520 alrededor del punto y el signo igual en instrucciones como
521 @code{\override Score . LyricText #'font-size = #5} y antes y después
522 de la instrucción completa.
527 Manual de aprendizaje:
528 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
531 @node Títulos y cabeceras
532 @section Títulos y cabeceras
533 @translationof Titles and headers
535 Casi toda la música impresa tiene un título y el nombre del
536 compositor; ciertas piezas tienen mucha más información.
539 * Crear títulos cabeceras y pies de página::
540 * Cabeceras pies y títulos personalizados::
541 * Referencia a números de página::
546 @node Crear títulos cabeceras y pies de página
547 @subsection Crear títulos, cabeceras y pies de página
548 @translationof Creating titles headers and footers
551 * Explicación de los bloques de títulos::
552 * Presentación predeterminada de los bloques de título del libro y la partitura::
553 * Disposición predeterminada de las cabeceras y pies de página::
557 @node Explicación de los bloques de títulos
558 @unnumberedsubsubsec Explicación de los bloques de títulos
559 @translationof Title blocks explained
561 @c TODO: figure out how \bookpart titles work
563 Existen dos clases de bloques de títulos: el bloque principal de
564 títulos que aparece encima del primer bloque @code{\score} de un
565 libro, y los bloques individuales de título que aparecen dentro de
566 cada bloque @code{\score}. Los campos de texto para los dos tipos de
567 bloque se introducen mediante un bloque @code{\header}.
569 Si el libro tiene una única partitura, el bloque @code{\header} se
570 puede situar dentro o fuera del bloque @code{\score}.
572 @warning{Recuerde que al añadir un bloque @bs{}@code{header} dentro de
573 un bloque @bs{}@code{score}, la expresión musical debe aparecer antes
574 del bloque @bs{}@code{header}.}
576 @lilypond[papersize=a5,quote,verbatim,noragged-right]
579 composer = "J. S. Bach."
583 \new Staff \relative g, {
586 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
587 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
595 \new Staff \relative b {
599 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
600 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
608 Los campos de texto extraídos del bloque prinicipal de título de un
609 libro se pueden imprimir en todos los bloques @code{\score}, o
610 suprimirse manualmente:
612 @lilypond[papersize=a5,quote,verbatim,noragged-right]
615 print-all-headers = ##t
618 title = "DAS WOHLTEMPERIRTE CLAVIER"
620 % Do not display the tagline for this book
623 \markup { \vspace #1 }
627 \new Staff { \clef "bass" s1 }
630 title = "PRAELUDIUM I"
632 % Do not display the subtitle for this score
639 \new Staff { \clef "bass" s1 }
643 subsubtitle = "A 4 VOCI"
645 % Do not display the subtitle for this score
653 Referencia de la notación:
654 @ref{Estructura del archivo},
655 @ref{Personalización de los bloques de título}.
658 @node Presentación predeterminada de los bloques de título del libro y la partitura
659 @unnumberedsubsubsec Presentación predeterminada de los bloques de título del libro y la partitura
660 @translationof Default layout of book and score title blocks
662 La disposición y formato de los bloques de título están controlados
663 por medio de dos variables de @code{\paper}: @code{bookTitleMarkup}
664 para el bloque de título @code{\header} principal y
665 @code{scoreTitleMarkup} para los bloques @code{\header} individuales
666 dentro de un bloque @code{\score}.
668 @lilypond[papersize=a6,quote,verbatim,noragged-right]
670 % The following fields are centered
671 dedication = "Dedication"
673 subtitle = "Subtitle"
674 subsubtitle = "Subsubtitle"
675 instrument = "Instrument"
677 % The following fields are left-aligned on the left side
681 % The following fields are right-aligned on the right side
682 composer = "Composer"
683 arranger = "Arranger"
689 % The following fields are placed at opposite ends of the same line
696 @c Is the bit about \null markups true? -mp
698 Los campos de texto que se dejan sin establecer dentro de un bloque
699 @code{\header} se sustituyen por elementos de marcado nulos
700 @code{\null} de manera que no ocupen espacio innecesariamente.
702 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan los
703 campos de texto @code{piece} y @code{opus} en extremos opuestos de la
708 Utilice la variable @code{breakbefore} dentro de un bloque
709 @code{\header} que está propiamente dentro de un bloque @code{\score}
710 para hacer que los títulos del bloque @code{\header} del nivel
711 superior aparezcan ocupando toda la primera página, empezando la
712 música (definida en el bloque @code{\score}) en la página siguiente.
714 @lilypond[papersize=a8landscape,verbatim,noragged-right]
717 title = "This is my Title"
718 subtitle = "This is my Subtitle"
719 copyright = "This is the bottom of the first page"
722 \repeat unfold 4 { e'' e'' e'' e'' }
724 piece = "This is the Music"
732 Manual de aprendizaje:
733 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
735 Referencia de la notación:
736 @ref{Estructura del archivo}.
739 @file{ly/titling-init.ly}.
741 @node Disposición predeterminada de las cabeceras y pies de página
742 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
743 @translationof Default layout of headers and footers
745 Las @emph{cabeceras} y los @emph{pies} de página son líneas de texto
746 que aparecen en la parte más alta y en la más baja de las páginas
747 separadas del texto principal de un libro. Se controlan mediante las
748 siguientes variables de @code{\paper}:
751 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
752 @item @code{evenHeaderMarkup} (marcado de cabecera par)
753 @item @code{oddFooterMarkup} (marcado de pie impar)
754 @item @code{evenFooterMarkup} (marcado de pie par)
757 Estas variables de marcado sólo pueden acceder a los campos de texto
758 extraídos de bloques @code{\header} del nivel superior (que se aplican
759 a todas las partituras del libro) y se definen en el archivo
760 @file{ly/titling-init.ly}. De forma predeterminada:
765 los números de página se sitúan automáticamente en el extremo superior
766 izquierdo (si es par) o superior derecho (si es impar), a partir de la
770 el campo de texto @code{instrument} se sitúa en el centro en cada
771 página, a partir de la segunda página.
774 el texto de @code{copyright} se centra en la parte baja de la primera
778 la línea @code{tagline} se centra al final de la última página, y
779 debajo del texto de @code{copyright} si sólo hay una página.
783 @lilypond[papersize=a8landscape]
793 La línea de etiqueta tagline predeterminada se puede cambiar añadiendo un campo
794 @code{tagline} en el bloque @code{\header} del nivel superior.
796 @lilypond[papersize=a8landscape,verbatim]
799 tagline = "... music notation for Everyone"
809 Para eliminar la línea @code{tagline}, establezca su valor a
813 @node Cabeceras pies y títulos personalizados
814 @subsection Cabeceras, pies y títulos personalizados
815 @translationof Custom headers footers and titles
817 @c TODO: somewhere put a link to header spacing info
818 @c (you'll have to explain it more in NR 4).
821 * Formateo personalizado del texto de los bloques de título::
822 * Personalización de los bloques de título::
823 * Disposición personalizada de cabeceras y pies de página::
827 @node Formateo personalizado del texto de los bloques de título
828 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
829 @translationof Custom text formatting for title blocks
831 Se pueden usar instrucciones @code{\markup} estándar para personalizar
832 el texto de cualquier cabecera, pie o título dentro del bloque
835 @lilypond[quote,verbatim,noragged-right]
839 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
840 subtitle = \markup { \italic "(Excerpt)" }
846 Referencia de la notación:
847 @ref{Formatear el texto}.
850 @node Personalización de los bloques de título
851 @unnumberedsubsubsec Personalización de los bloques de título
852 @translationof Custom layout for title blocks
854 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
855 útiles para dar un formato simple al texto, pero no permiten un
856 control preciso sobre la colocación de los títulos. Para personalizar
857 la colocación de los campos de texto, use una o las dos variables de
858 @code{\paper} siguientes:
861 @item @code{bookTitleMarkup} (marcado de título del libro)
862 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
865 Estas variables de marcado se estudian en
866 @ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
868 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y como
869 están definidos en el archivo @file{ly/titling-init.ly} son:
872 scoreTitleMarkup = \markup @{ \column @{
873 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
875 \fromproperty #'header:piece
876 \fromproperty #'header:opus
882 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
883 opuestos de la misma línea:
885 @lilypond[quote,verbatim,noragged-right]
889 piece = "PRAELUDIUM I"
895 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el campo
896 de texto @code{piece} aparece centrado y en un tipo de letra grande y
899 @lilypond[papersize=a5,quote,verbatim,noragged-right]
903 scoreTitleMarkup = \markup {
906 \fontsize #4 \bold \fromproperty #'header:piece
907 \fromproperty #'header:opus
911 \header { tagline = ##f }
915 piece = "PRAELUDIUM I"
922 Los campos de texto reservados normalmente para el bloque principal de
923 título se pueden insertar dentro de los bloques de título de las
924 partituras individuales con la variable @code{print-all-headers}
925 establecida dentro del bloque @code{\paper}. Una desventaja de la
926 utilización de este método es que los campos de texto que están
927 orientados específicamente para el bloque @code{\header} del nivel
928 superior han de suprimirse manualmente en cada uno de los bloques
929 @code{\score}. Véase @ref{Explicación de los bloques de títulos}.
931 Para evitarlo, añada el campo de texto deseado a la definición de
932 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de texto
933 @code{composer} (asociado normalmente con @code{bookTitleMarkup}) se
934 añade a @code{scoreTitleMarkup}, permitiendo que cada partitura
935 muestre un compositor diferente:
937 @lilypond[papersize=a5,quote,verbatim,noragged-right]
941 scoreTitleMarkup = \markup {
944 \fontsize #4 \bold \fromproperty #'header:piece
945 \fromproperty #'header:composer
949 \header { tagline = ##f }
954 composer = "Christian Petzold"
961 composer = "François Couperin"
967 También podemos crear nuestros propios campos de texto personalizados,
968 y referirnos a ellos en la definición del elemento de marcado.
970 @lilypond[papersize=a5,quote,verbatim,noragged-right]
974 scoreTitleMarkup = \markup {
977 \override #`(direction . ,UP) {
979 \center-align \fontsize #-1 \bold
980 \fromproperty #'header:mycustomtext %% User-defined field
981 \center-align \fontsize #4 \bold
982 \fromproperty #'header:piece
985 \fromproperty #'header:opus
989 \header { tagline = ##f }
994 mycustomtext = "A 4 VOCI" %% User-defined field
1002 @node Disposición personalizada de cabeceras y pies de página
1003 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1004 @translationof Custom layout for headers and footers
1006 @c can make-header and make-footer be removed from
1007 @c paper-defaults-init.ly? -mp
1009 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1010 de utilidad para dar formato al texto de una manera sencilla, pero no
1011 permiten un control preciso sobre la colocación de las cabeceras y los
1012 pies de página. Para personalizar la colocación de los campos de
1013 texto, use una o más de las siguientes variables de @code{\paper}:
1016 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1017 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1018 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1019 @item @code{evenFooterMarkup} (marcado de pie de página par)
1022 Estas variables de marcado se estudian en
1023 @ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
1025 El ejemplo siguiente centra los números de página en la parte baja de
1026 las páginas. En primer lugar, los ajustes predeterminados para
1027 @code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
1028 definiéndolos como un marcado @emph{nulo}. Después de esto, se
1029 redefine @code{oddFooterMarkup} con el número de página centrado.
1030 Finalmente, @code{evenFooterMarkup} recibe la misma disposición
1031 definiéndola como @code{\oddFooterMarkup}:
1033 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1036 print-page-number = ##t
1037 print-first-page-number = ##t
1038 oddHeaderMarkup = \markup \null
1039 evenHeaderMarkup = \markup \null
1040 oddFooterMarkup = \markup {
1042 \on-the-fly #print-page-number-check-first
1043 \fromproperty #'page:page-number-string
1046 evenFooterMarkup = \oddFooterMarkup
1049 \new Staff { s1 \break s1 \break s1 }
1055 @node Referencia a números de página
1056 @subsection Referencia a números de página
1057 @translationof Reference to page numbers
1059 Un lugar determinado de una partitura puede señalizarse usando la
1060 instrucción @code{\label} (etiqueta), ya sea en el nivel superior o
1061 dentro de la música. Podemos referirnos a esta etiqueta más tarde
1062 dentro de un elemento de marcado, para obtener el número de la página
1063 en la que se sitúa el punto señalizado, usando la instrucción de
1064 marcado @code{\page-ref}.
1067 \header { tagline = ##f }
1073 \pageBreak \mark A \label #'markA
1077 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
1078 \markup { Mark A is on page \page-ref #'markA "0" "?" }
1082 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1084 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
1085 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1086 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1089 El motivo de que se necesite un medidor es que en el momento en que se
1090 están interpretando los marcados, los saltos de página aún no se han
1091 producido y por tanto los números de página no se conocen todavía.
1092 Para sortear este inconveniente, la interpretación real del marcado se
1093 retrasa hasta un momento posterior; sin embargo, las dimensiones del
1094 marcado se tienen que conocer de antemano, así que se usa el medidor
1095 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
1096 páginas, el medidor puede ser "00", es decir, un número de dos
1108 @node Índice general
1109 @subsection Índice general
1110 @translationof Table of contents
1112 Se puede insertar un índice general o tabla de contenidos utilizando
1113 la instrucción @code{\markuplines \table-of-contents}. Los elementos
1114 que deben aparecer en la tabla de contenidos se introducen con la
1115 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
1116 la jerarquía del código, o dentro de una expresión musical.
1119 \markuplines \table-of-contents
1122 \tocItem \markup "Primera partitura"
1126 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1131 \tocItem \markup "Segunda partitura"
1139 Los elementos de marcado que se usan para dar formato al índice
1140 general se encuentran definidos dentro del bloque @code{\paper}. Los
1141 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
1142 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
1143 los elementos del índice, que consisten en el título del elemento y el
1144 número de página. Estas variables se pueden cambiar por parte del
1149 %% Traducir el título del índice al español:
1150 tocTitleMarkup = \markup \huge \column {
1151 \fill-line { \null "Índice general" \null }
1154 %% usar una fuente mayor
1155 tocItemMarkup = \markup \large \fill-line {
1156 \fromproperty #'toc:text \fromproperty #'toc:page
1161 Observe la forma en que nos referimos al texto y al número de página
1162 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
1164 También se pueden definir nuevas instrucciones y elementos de
1165 marcado para crear índices generales más elaborados:
1167 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
1168 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
1169 utilizando esta variable de marcado del bloque @code{\paper}.
1172 En el ejemplo siguiente se define un estilo nuevo para introducir los
1173 nombres de los actos de una ópera en el índice general:
1177 tocActMarkup = \markup \large \column {
1179 \fill-line { \null \italic \fromproperty #'toc:text \null }
1185 #(define-music-function (parser location text) (markup?)
1186 (add-toc-item! 'tocActMarkup text))
1189 @lilypond[line-width=11.0\cm]
1190 \header { tagline = ##f }
1192 tocActMarkup = \markup \large \column {
1194 \fill-line { \null \italic \fromproperty #'toc:text \null }
1200 #(define-music-function (parser location text) (markup?)
1201 (add-toc-item! 'tocActMarkup text))
1204 \markuplines \table-of-contents
1205 \tocAct \markup { Atto Primo }
1206 \tocItem \markup { Coro. Viva il nostro Alcide }
1207 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1208 \tocAct \markup { Atto Secondo }
1209 \tocItem \markup { Sinfonia }
1210 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1215 Se pueden añadir puntos de relleno entre un elemento y su número de página:
1217 @lilypond[verbatim,quote]
1218 \header { tagline = ##f }
1220 tocItemMarkup = \tocItemWithDotsMarkup
1224 \markuplines \table-of-contents
1225 \tocItem \markup { Allegro }
1226 \tocItem \markup { Largo }
1234 @file{../ly/toc-init.ly}.
1238 @funindex \table-of-contents
1239 @code{\table-of-contents},
1245 @node Trabajar sobre los archivos de entrada
1246 @section Trabajar sobre los archivos de entrada
1247 @translationof Working with input files
1250 * Inclusión de archivos de LilyPond::
1251 * Distintas ediciones a partir de una misma fuente::
1252 * Codificación del texto::
1253 * Presentar la notación de LilyPond::
1257 @node Inclusión de archivos de LilyPond
1258 @subsection Inclusión de archivos de LilyPond
1259 @translationof Including LilyPond files
1262 @cindex including files
1264 Un proyecto grande se puede dividir en varios archivos. Para
1265 referirse a otro archivo, utilice
1268 \include "otroarchivo.ly"
1271 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
1272 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
1273 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
1274 podríamos querer archivos distintos para cada parte instrumental y
1275 crear un archivo de @qq{partitura completa} que reúne los archivos
1276 individuales de los instrumentos. Normalmente el archivo incluido
1277 define un cierto número de variables que a partir de entonces quedan
1278 disponibles para poderlas utilizar en el archivo de la partitura
1279 completa. En los archivos incluidos se pueden marcar las secciones
1280 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
1281 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
1283 Los archivos que están en el directorio de trabajo actual se pueden
1284 referenciar simplemente especificando el nombre después de la
1285 instrucción @code{\include}. Los archivos en otros lugares se pueden
1286 incluir proporcionando una referencia de ruta completa o una ruta
1287 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
1288 barra invertida de DOS/Windows, \, como separador de directorio). Por
1289 ejemplo, si @file{material.ly} está situado un directorio por encima
1290 del directorio de trabajo actual, utilice
1293 \include "../material.ly"
1297 o si los archivos de las partes orquestales incluidas están todos
1298 situados en un subdirectorio llamado @file{partes} dentro del
1299 directorio actual, use
1302 \include "partes/VI.ly"
1303 \include "partes/VII.ly"
1307 Los archivos de inclusión también pueden contener enunciados
1308 @code{\include} a su vez. De forma predeterminada, estos enunciados
1309 @code{\include} de segundo nivel no se interpretan hasta que se
1310 incorporan al archivo principal, por lo que los nombres de archivo que
1311 especifican deben ser relativos al directorio que contiene el archivo
1312 principal, no al directorio que contiene el archivo incluido. Sin
1313 embargo, este comportamiento se puede modificar pasando la opción
1314 @code{-drelative-includes} en la línea de órdenes (o mediante la
1315 adición de @code{#(ly:set-option 'relative-includes #t)} al principio
1316 del archivo principal de entrada). Con el valor de
1317 @code{relative-includes} establecido, la ruta de cada instrucción
1318 @code{\include} se considera relativa al archivo que contiene dicha
1319 instrucción. Este comportamiento es el recomendado y se convertirá en
1320 el comportamiento predeterminado en una versión futura de lilypond.
1322 También se pueden incluir archivos de un directorio que está en una
1323 ruta de búsqueda especificada como opción al invocar a LilyPond desde
1324 la línea de órdenes. Los archivos incluidos se especifican usando
1325 solamente su nombre de archivo. Por ejemplo, para compilar mediante
1326 este método un archivo @file{principal.ly} que incluye archivos
1327 situados en un subdirectorio llamado @file{partes}, cambie al
1328 directorio que contiene @file{principal.ly} e introduzca
1331 lilypond --include=partes principal.ly
1334 y en @file{principal.ly} escriba
1342 Los archivos que se incluyen en muchas partituras se pueden poner en
1343 el directorio de LilyPond @file{../ly} (la localización de este
1344 directorio depende de la instalación: véase
1345 @rlearning{Otras fuentes de información}). Estos archivos se pueden
1346 incluir sencillamente por su nombre en un enunciado @code{\include}.
1347 De esta forma se incluyen los archivos dependientes del idioma como
1350 LilyPond incluye de forma predeterminada ciertos archivos cuando se
1351 inicia el programa. Estas inclusiones no son visibles para el
1352 usuario, pero los archivos se pueden identificar ejecutando
1353 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
1354 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
1355 otras indicaciones. De forma alternativa, pueden verse explicaciones
1356 sobre los archivos más importantes de este conjunto en
1357 @rlearning{Otras fuentes de información}. Estos archivos se pueden
1358 editar, pero los cambios realizados sobre ellos se perderán al
1359 instalar una nueva versión de LilyPond.
1361 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
1362 @rlearning{Partituras y particellas}.
1366 Manual de aprendizaje:
1367 @rlearning{Otras fuentes de información},
1368 @rlearning{Partituras y particellas}.
1373 Si un archivo incluido recibe un nombre igual al de uno de los
1374 archivos de instalación de LilyPond, el archivo que tiene prioridad es
1375 el de los archivos de instalación de LilyPond.
1378 @node Distintas ediciones a partir de una misma fuente
1379 @subsection Distintas ediciones a partir de una misma fuente
1380 @translationof Different editions from one source
1382 Se encuentran disponibles varios mecanismos para facilitar la
1383 producción de distintas versiones de una partitura a partir de la
1384 misma fuente musical. Las variables son quizá más útiles para
1385 combinar secciones extensas de música y/o anotaciones de diversas
1386 formas, mientras que las etiquetas son más útiles para seleccionar una
1387 de entra varias secciones de música más cortas. Cualquiera que sea el
1388 método utilizado, la separación de la notación de la estructura de la
1389 partitura hará que sea más fácil cambiar la estructura dejando intacta
1393 * Uso de las variables::
1394 * Uso de etiquetas::
1395 * Uso de ajustes globales::
1398 @node Uso de las variables
1399 @unnumberedsubsubsec Uso de las variables
1400 @translationof Using variables
1402 @cindex variables, uso de las
1404 Si las secciones de la música se definen dentro de variables, se
1405 pueden reutilizar en distintas partes de la partitura, véase
1406 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
1407 partitura vocal @notation{a cappella} con frecuencia incluye una
1408 reducción de piano de las partes para ensayar que es idéntica a la
1409 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
1410 puede combinar sobre un solo pentagrama la música de dos variables,
1411 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
1413 @lilypond[verbatim,quote]
1414 sopranoMusic = \relative c'' { a4 b c b8( a) }
1415 altoMusic = \relative g' { e4 e e f }
1416 tenorMusic = \relative c' { c4 b e d8( c) }
1417 bassMusic = \relative c' { a4 gis a d, }
1418 allLyrics = \lyricmode {King of glo -- ry }
1420 \new Staff = "Soprano" \sopranoMusic
1421 \new Lyrics \allLyrics
1422 \new Staff = "Alto" \altoMusic
1423 \new Lyrics \allLyrics
1424 \new Staff = "Tenor" {
1428 \new Lyrics \allLyrics
1429 \new Staff = "Bass" {
1433 \new Lyrics \allLyrics
1436 \set Staff.printPartCombineTexts = ##f
1442 \set Staff.printPartCombineTexts = ##f
1452 Se pueden producir partituras distintas que presenten sólo las partes
1453 vocales o sólo la parte de piano, cambiando solamente los enunciados
1454 estructurales, sin modificar la notación musical.
1456 Para partituras extensas, las definiciones de variable se pueden poner
1457 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
1460 @node Uso de etiquetas
1461 @unnumberedsubsubsec Uso de etiquetas
1462 @translationof Using tags
1465 @funindex \keepWithTag
1466 @funindex \removeWithTag
1468 @cindex mantener música etiquetada
1469 @cindex quitar música etiquetada
1471 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
1472 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
1473 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
1474 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
1475 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
1476 música etiquetada es como sigue:
1478 @multitable @columnfractions .5 .5
1482 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
1484 Se incluye la música no etiquetada y la música etiquetada con
1485 @var{nombre}; se excluye la música etiquetada con cualquier otro
1488 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
1490 Se incluye la música no etiquetada y la música etiquetada con
1491 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
1492 música etiquetada con @var{nombre}.
1494 Música etiquetada no precedida de @code{\keepWithTag} ni de
1495 @code{\removeWithTag}
1496 @tab Se incluye toda la música etiquetada y no etiquetada.
1499 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
1500 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
1501 @code{#'parte}), seguido de una expresión musical.
1503 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
1504 que muestra trinos con la notación usual y otra con los trinos
1505 expandidos explícitamente:
1507 @lilypond[verbatim,quote]
1508 music = \relative g' {
1510 \tag #'trills { d8.\trill }
1511 \tag #'expand { \repeat unfold 3 { e32 d } }
1516 \keepWithTag #'trills \music
1519 \keepWithTag #'expand \music
1524 De forma alternativa, a veces es más fácil excluir secciones de música:
1526 @lilypond[verbatim,quote]
1527 music = \relative g' {
1529 \tag #'trills { d8.\trill }
1530 \tag #'expand {\repeat unfold 3 { e32 d } }
1535 \removeWithTag #'expand
1539 \removeWithTag #'trills
1544 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
1548 -\tag #'@var{mi-etiqueta}
1551 a una articulación. Por ejemplo, esto define una nota con una
1552 indicación opcional de digitación y una nota con una anotación
1557 c1-\tag #'warn ^"¡Ojo!"
1560 Se pueden poner varias etiquetas sobre expresiones con varias entradas
1563 @lilypond[quote,verbatim]
1564 music = \relative c'' {
1565 \tag #'a \tag #'both { a4 a a a }
1566 \tag #'b \tag #'both { b4 b b b }
1569 \keepWithTag #'a \music
1570 \keepWithTag #'b \music
1571 \keepWithTag #'both \music
1575 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
1576 expresión musical para quitar varias secciones etiquetadas con nombres
1579 @lilypond[verbatim,quote]
1580 music = \relative c'' {
1581 \tag #'A { a4 a a a }
1582 \tag #'B { b4 b b b }
1583 \tag #'C { c4 c c c }
1584 \tag #'D { d4 d d d }
1593 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
1594 musical producen la eliminación de @emph{todas} las secciones
1595 etiquetadas, porque el primer filtro quita todas las secciones
1596 etiquetadas excepto la que se nombra, y el segundo filtro elimina
1597 incluso esa sección etiquetada.
1601 Manual de aprendizaje:
1602 @rlearning{Organizar las piezas mediante variables}.
1604 Referencia de la notación:
1605 @ref{Combinación automática de las partes},
1606 @ref{Inclusión de archivos de LilyPond}.
1610 @c This warning is more general than this placement implies.
1611 @c Rests are not merged whether or not they come from tagged sections.
1612 @c Should be deleted? -td
1617 Multiple rests are not merged if you create a score with more
1618 than one tagged section at the same place.
1622 @node Uso de ajustes globales
1623 @unnumberedsubsubsec Uso de ajustes globales
1624 @translationof Using global settings
1626 @cindex include-settings
1628 Se pueden incluir ajustes globales a partir de un archivo distinto:
1631 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
1634 En archivos diferentes se pueden almacenar grupos de ajustes como
1635 el tamaño de la página o las fuentes tipográficas. Ello permite
1636 hacer diferentes ediciones de la mism a partitura así como aplicar
1637 ajustes estándar a muchas partituras, simplemente por medio de la
1638 especificación del archivo de ajustes adecuado.
1640 Esta técnica también funciona bien con el uso de hojas de estilo,
1641 como se estudia en @rlearning{Hojas de estilo}.
1644 Manual de aprendizaje:
1645 @rlearning{Organizar las piezas mediante variables},
1646 @rlearning{Hojas de estilo}.
1648 Referencia de la notación:
1649 @ref{Inclusión de archivos de LilyPond}.
1651 @node Codificación del texto
1652 @subsection Codificación del texto
1653 @translationof Text encoding
1657 @cindex caracteres no ASCII
1659 LilyPond usa el conjunto de caracteres definido por el consorcio
1660 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
1661 para los conjuntos de caracteres que se utilizan en prácticamente
1662 todos los idiomas modernos y también en muchos otros. Unicode se
1663 puede implementar utilizando varios esquemas de codificación
1664 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
1665 @emph{Unicode Transformation Format}, o formato de transformación de
1666 Unicode) que representa todos los caracteres comunes de Latin en un
1667 solo byte, y representa otros caracteres usando un formato de longitud
1668 variable de hasta cuatro bytes.
1670 El aspecto visual real de los caracteres viene determinado por los
1671 glifos que se definen en las fuentes tipográficas concretas que se
1672 tengan disponibles: una fuente tipográfica define la asignación de un
1673 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
1674 biblioteca Pango para representar y disponer tipográficamente textos
1677 LilyPond no realiza ninguna conversión en la codificación de la
1678 entrada. Esto significa que cualquier text, ya sea el título, la
1679 letra de la canción o una instrucción musical que contenga caracteres
1680 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
1681 forma más fácil de escribir dicho texto es utilizar un editor
1682 preparado para Unicode y guardar el archivo con la codificación UTF-8.
1683 Casi todos los editores modernos populares contemplan el UTF-8, por
1684 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
1685 Windows posteriores a NT usan Unicode como codificación de caracteres
1686 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
1687 puede editar y guardar un archivo en el formato UTF-8. Una
1688 alternativa más funcional para Windows es BabelPad.
1690 Si un archivo de entrada que contiene un carácter que no es ASCII, no
1691 se guarda en el formato UTF-8, se genera el mensaje de error
1694 FT_Get_Glyph_Name () error: argumento inválido
1697 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
1700 %c No verbatim here as the code does not display correctly in PDF
1702 bulgarian = \lyricmode {
1703 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1707 hebrew = \lyricmode {
1708 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1712 portuguese = \lyricmode {
1713 à vo -- cê uma can -- ção legal
1719 \addlyrics { \bulgarian }
1720 \addlyrics { \hebrew }
1721 \addlyrics { \portuguese }
1724 Para introducir un carácter aislado para el que se conoce el punto de
1725 código Unicode pero no está disponible en el editor que se está
1726 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
1727 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
1728 del carácter en cuestión y @code{dddd} es su valor decimal
1729 correspondiente. Pueden omitirse los ceros iniciales, pero es
1730 costumbre indicar los cuatro caracteres en la representación
1731 hexadecimal (observe que @emph{no} debe utilizarse la codificación
1732 UTF-8 del punto de código Unicode después de @code{\char}, pues la
1733 codificación UTF-8 contiene bits adicionales que indican el número de
1734 octetos). Hay tablas de códigos Unicode y un índice de nombres de
1735 caracteres que da el punto de código en hexadecimal para cualquier
1736 carácter en el portal del Consorcio Unicode,
1737 @uref{http://www.unicode.org/}.
1740 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
1741 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
1742 @qq{Letra griega Xi pequeña}.
1744 Se puede escribir de esta forma cualquier punto de código Unicode, y
1745 si todos los caracteres especiales se escriben en este formato no es
1746 necesario guardar el archivo de entrada en formato UTF-8. Por
1747 supuesto, debe estar instalada y estar disponible para LilyPond una
1748 fuente tipográfica que contenga codificados todos estos caracteres.
1750 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
1751 en cuatro lugares: en una llamada de ensayo, como texto de
1752 articulación, en la letra y como texto independiente bajo la
1755 @lilypond[quote,verbatim]
1758 c1 \mark \markup { \char ##x03EE }
1759 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1761 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
1763 \markup { "Copyright 2008--2011" \char ##x00A9 }
1766 @cindex copyright, símbolo de
1768 Para escribir el símbolo de copyright en la nota de créditos, utilice:
1772 copyright = \markup @{ \char ##x00A9 "2008" @}
1777 @node Presentar la notación de LilyPond
1778 @subsection Presentar la notación de LilyPond
1779 @translationof Displaying LilyPond notation
1781 @funindex \displayLilyMusic
1782 La impresión textual de una expresión musical en notación de LilyPond
1783 puede hacerse con la función musical @code{\displayLilyMusic} pero solamente
1784 mediante la línea de órdenes. Por ejemplo,
1788 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
1795 @{ a,4 cis e fis g @}
1798 De forma predeterminada, LilyPond imprime estos mensajes en la consola
1799 junto al resto de los mensajes de la compilación de LilyPond.
1800 Para discernir entre estos mensajes y
1801 guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
1802 salida hacia un archivo.
1805 lilypond archivo.ly >resultado.txt
1810 @node Controlar la salida
1811 @section Controlar la salida
1812 @translationof Controlling output
1815 * Extracción de fragmentos de música::
1816 * Saltar la música corregida::
1817 * Formatos de salida alternativos::
1818 * Sustituir la tipografía de la notación::
1821 @node Extracción de fragmentos de música
1822 @subsection Extracción de fragmentos de música
1823 @translationof Extracting fragments of music
1825 Es posible citar pequeños fragmentos de una partitura grande
1826 directamente a partir de la salida. Puede compararse con la
1827 separación de una pieza de una partitura, recortándola con tijeras.
1829 Esto se hace definiendo los compases que se deben recortar. Por
1830 ejemplo, la inclusión de la siguiente definición
1837 (make-rhythmic-location 5 1 2)
1838 (make-rhythmic-location 7 3 4)))
1843 extrae un fragmento empezando por la mitad del quinto compás y
1844 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
1845 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
1846 después de tres negras del compás 7.
1848 Se pueden definir más zonas de recorte añadiendo más parejas de
1849 definición de tiempo rhythmic-location a la lista.
1851 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
1852 la opción @code{-dclip-systems}. Los recortes aparecen en la salida
1853 como archivos EPS, y se convierten en PDF y PNG si estos formatos
1854 también están activados.
1856 Para ver más información sobre los formatos de salida, consulte
1857 @rprogram{Invocar a LilyPond}.
1860 @node Saltar la música corregida
1861 @subsection Saltar la música corregida
1862 @translationof Skipping corrected music
1864 @funindex skipTypesetting
1865 @funindex showFirstLength
1866 @funindex showLastLength
1868 Al escribir o copiar música, normalmente sólo es interesante de ver y
1869 corregir la música cercana al final (donde estamos añadiendo las
1870 notas). Para acelerar este proceso de corrección, es posible saltar
1871 la composición tipográfica de todos excepto unos pocos de los últimos
1872 compases. Esto se consigue poniendo
1875 showLastLength = R1*5
1880 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
1881 cinco compases (suponiendo un compás de 4/4) de cada una de las
1882 partituras @code{\score} del archivo de entrada. Para piezas largas,
1883 el tipografiado de únicamente una parte pequeña es con frecuencia un
1884 orden de magnitud más rápido que el de la obra completa. Si estamos
1885 trabajando sobre el principio de una partitura que ya hemos
1886 tipografiado (p.ej., para añadir una parte instrumental nueva),
1887 también puede ser útil la propiedad @code{showFirstLength}.
1889 Este mecanismo de pasar por alto partes de un partitura se puede
1890 controlar con un grano más fino mediante la propiedad
1891 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
1892 lleva a cabo ningún tipografiado en absoluto.
1894 Esta propiedad se usa también para controlar la salida al archivo
1895 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
1896 y los cambios de instrumento. Está usted advertido.
1898 @lilypond[quote,relative=2,ragged-right,verbatim]
1900 \set Score.skipTypesetting = ##t
1902 \set Score.skipTypesetting = ##f
1906 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
1907 voces y pentagramas, ahorrando más tiempo incluso.
1909 @node Formatos de salida alternativos
1910 @subsection Formatos de salida alternativos
1911 @translationof Alternative output formats
1913 @cindex salida de gráficos de vector escalables
1915 @cindex salida de PostScript encapsulado
1917 @cindex PostScript encapsulado, salida de
1919 Los formatos de salida predeterminados para la partitura impresa son
1920 el formato de documento portátil (PDF) y PostScript (PS). Los
1921 formatos de salida Gráficos de vector escalables (SVG), PostScript
1922 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
1923 disponibles a través de opciones de la línea de órdenes, véase
1924 @rprogram{Opciones de la línea de órdenes para lilypond}.
1927 @node Sustituir la tipografía de la notación
1928 @subsection Sustituir la tipografía de la notación
1929 @translationof Replacing the notation font
1931 Gonville es una alternativa a la tipografía Feta que se utiliza en
1932 LilyPond y se puede descargar de:
1934 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
1937 Aquí presentamos algunos compases de muestra tipografiados con la
1940 @c NOTE: these images are a bit big, but that's important
1941 @c for the font comparison. -gp
1942 @sourceimage{Gonville_after,,,}
1944 Aquí hay unos compases de muestra tipografiados en la fuente Feta de
1947 @sourceimage{Gonville_before,,,}
1949 @subsubheading Instrucciones de instalación para MacOS
1951 Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
1952 a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
1953 consulte @rlearning{Otras fuentes de información}. Mueva la carpeta
1954 @code{fonts} existente a @code{fonts_orig} y mueva la carpeta
1955 @code{lilyfonts} a @code{fonts}. Sencillamente vuelva a mover
1956 @code{fonts_orig} a @code{fonts} para volver a la fuente Feta.
1959 Manual de aprendizaje:
1960 @rlearning{Otras fuentes de información}.
1964 Gonville no se puede usar para tipografiar notación de @q{Música
1965 Antigua}. Diríjase a la página web del autor para obtener más
1966 información sobre éste y otros asuntos, entre ellos el régimen de
1967 licencias de Gonville.
1971 @section Salida MIDI
1972 @translationof MIDI output
1977 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
1978 Instrumentos Musicales) es un estándar para interconectar y controlar
1979 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
1980 una serie de notas dentro de un conjunto de pistas. No es un archivo
1981 de sonidos reales; se necesita un programa reproductor especial para
1982 traducir la serie de notas en sonidos de verdad.
1984 Cualquier música se puede convertir a archivos MIDI, de manera que
1985 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
1986 para comprobar la corrección de la música; las octavas equivocadas o
1987 las alteraciones erróneas se ponen de relieve muy claramente al
1988 escuchar la salida MIDI.
1990 La salida estándar de MIDI es un poco primitiva; de forma opcional, se
1991 encuentra disponible una salida MIDI mejorada y mucho más realista,
1992 por medio de @ref{El script Articulate}.
1995 La salida MIDI reserva un canal por cada pentagrama, y otro para los
1996 ajustes globales. Por ello, el archivo MIDI no debe tener más de 15
1997 pautas (o 14 si no se usa la percusión). Otros pentagramas permanecen
2001 * Crear archivos MIDI::
2003 * ¿Qué sale por el MIDI?::
2004 * Repeticiones y MIDI::
2005 * Control de los matices en el MIDI::
2006 * Percusión en MIDI::
2007 * El script Articulate::
2010 @node Crear archivos MIDI
2011 @subsection Crear archivos MIDI
2012 @translationof Creating MIDI files
2014 Para crear un MIDI a partir de una pieza de música, escriba un bloque
2015 @code{\midi} en la partitura, por ejemplo:
2024 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
2025 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
2026 necesita una notación impresa, debe haber también un bloque
2037 Se traducen correctamente a la salida MIDI la altura y duración de las
2038 notas, las ligaduras de unión, matices y cambios de tempo. Las
2039 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
2040 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
2041 del rango de volumen MIDI disponible. Los crescendi y decrescendi
2042 hacen que el volumen varía linealmente entre sus dos extremos. El
2043 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
2044 eliminar por completo, véase @ref{El bloque MIDI}.
2046 El tempo inicial y los cambios de tempo posteriores se pueden
2047 especificar utilizando la instrucción @code{\tempo} dentro de la
2048 propia notación musical. Se reflejan en cambios de tempo en la salida
2049 MIDI. Esta instrucción normalmente hace que se imprima la indicación
2050 metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
2051 Más abajo se describe una forma alternativa de especificar el tempo
2052 MIDI inicial o global, véase @ref{El bloque MIDI}.
2054 Debido a ciertas limitaciones de Windows, la extensión predeterminada
2055 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
2056 operativos utilizan la extensión @code{.midi}. Si prefiere una
2057 extensión diferente, inserte la siguiente línea en el nivel jerárquico
2058 superior del archivo de entrada, antes del inicio de cualquier bloque
2059 @code{\book}, @code{\bookpart} o @code{\score}:
2062 #(ly:set-option 'midi-extension "midi")
2065 La línea anterior establece la extensión predeterminada para los
2066 archivos MIDI a @code{.midi}.
2068 De forma alternativa, esta opción se puede también proporcionar en la
2072 lilypond … -dmidi-extension=midi archivoLily.ly
2076 @unnumberedsubsubsec Nombres de instrumentos
2078 @cindex instrumento, nombres de
2079 @funindex Staff.midiInstrument
2081 El nombre del instrumento MIDI se establece mediante la propiedad
2082 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
2083 de entre los que están en la lista que aparece en @ref{Instrumentos MIDI}.
2087 \set Staff.midiInstrument = #"glockenspiel"
2093 \new Staff \with @{midiInstrument = #"cello"@} @{
2098 Si el instrumento elegido no coincide exactamente con uno de los
2099 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
2100 Piano de Cola (@code{"acoustic grand"}).
2104 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
2105 {changing-midi-output-to-one-channel-per-voice.ly}
2109 @c In 2.11 the following no longer seems to be a problem -td
2111 Unterminated (de)crescendos will not render properly in the midi file,
2112 resulting in silent passages of music. The workaround is to explicitly
2113 terminate the (de)crescendo. For example,
2120 will not work properly but
2123 @{ a4\< b c d\!\f @}
2130 Los cambios del volumen MIDI sólo tienen lugar al principio de la
2131 nota, por lo que los crescendi y decrescendi no pueden afectar al
2132 volumen de una sola nota.
2134 No todos los reproductores de MIDI manejar adecuadamente los cambios de
2135 tempo de la salida MIDI. Entre los reproductores que se sabe que
2136 funcionan se encuentran el Reproductor de Medios de MS Windows y
2137 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
2140 @node El bloque MIDI
2141 @subsection El bloque MIDI
2142 @translationof MIDI block
2146 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
2147 dentro de un bloque de partitura. Es análogo al bloque layout de
2148 diseño de página, pero algo más simple. Con frecuencia, el bloque
2149 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
2150 contextos, definiciones de contexto nuevas o código para fijar valores
2151 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
2152 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
2153 indicación de tempo:
2161 tempoWholesPerMinute = #(ly:make-moment 72 4)
2167 En este ejemplo, el tempo se establece a 72 pulsos de negra por
2168 minuto. Esta clase de especificación de tempo no puede tomar como
2169 argumento una figura con puntillo. Si necesitamos una figura con
2170 puntillo, dividimos la nota con puntillo en figuras más pequeñas. Por
2171 ejemplo, un tempo de 90 negras con puntillo por minuto se puede
2172 especificar como 270 corcheas por minuto:
2175 tempoWholesPerMinute = #(ly:make-moment 270 8)
2178 @cindex MIDI, definiciones de contexto
2180 Las definiciones de contexto siguen con precisión la misma sintaxis
2181 que la de un bloque @code{\layout}. Los módulos de traducción para el
2182 sonido reciben el nombre de ejecutantes. Los contextos para la salida
2183 MIDI se definen en @file{../ly/performer-init.ly}, véase
2184 @rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
2185 el efecto de los matices de la salida MIDI, inserte las líneas
2186 siguientes en el bloque @code{\midi@{ @}}.
2193 \remove "Dynamic_performer"
2198 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
2199 dentro de un bloque de partitura definido con una instrucción
2204 @{ @dots{}notas@dots{} @}
2209 @node ¿Qué sale por el MIDI?
2210 @subsection ¿Qué sale por el MIDI?
2211 @translationof What goes into the MIDI output?
2213 @unnumberedsubsubsec Contemplado en el MIDI
2215 @cindex alturas en MIDI
2216 @cindex MIDI, alturas
2217 @cindex cuartos de tono en MIDI
2218 @cindex MIDI, cuartos de tono
2219 @cindex microtonos en MIDI
2220 @cindex MIDI, microtonos
2221 @cindex acordes, nombres de, en MIDI
2222 @cindex MIDI, nombres de
2223 @cindex duraciones en MIDI
2224 @cindex MIDI, duraciones
2225 @cindex Articlulate, scripts
2226 @cindex MIDI, articulaciones
2227 @cindex articulaciones en MIDI
2228 @cindex trinos en MIDI
2229 @cindex grupetos en MIDI
2230 @cindex rallentando en MIDI
2231 @cindex accelerando en MIDI
2234 Los siguientes elementos de notación se reflejan en la salida MIDI:
2238 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
2239 @item Acordes escritos como nombres de acorde
2240 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
2241 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
2242 @item Ligaduras de unión
2243 @item Matices o indicaciones de dinámica
2244 @item Crescendi y decrescendi sobre varias notas
2245 @item Cambios de tempo insertados con una marca metronómica
2246 @item Letra de las canciones
2249 Utilizando @ref{El script Articulate}, a la lista anterior se añaden
2250 una serie de elementos:
2253 @item Articulaciones (ligaduras de expresión, picados, etc)
2254 @item Trinos, mordentes circulares
2255 @item Rallentando y accelerando
2259 @unnumberedsubsubsec No contemplado en el MIDI
2261 @c TODO index as above
2263 Los siguientes elementos de notación no tienen ningún efecto sobre la
2264 salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
2267 @item Duraciones escritas como anotaciones, p.ej. el swing
2268 @item Cambios de tempo escritos como anotaciones sin marca de tempo
2269 @item Staccato y otras articulaciones y ornamentos
2270 @item Ligaduras de expresión y de fraseo
2271 @item Crescendi y decrescendi sobre una nota única
2272 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
2274 @item Acordes microtonales
2278 @node Repeticiones y MIDI
2279 @subsection Repeticiones y MIDI
2280 @translationof Repeats in MIDI
2282 @cindex repeticiones, expandir
2283 @funindex \unfoldRepeats
2285 Con un poco de trucaje, se puede hacer que cualquier tipo de
2286 repetición esté presente en la salida MIDI. Esto se consigue mediante
2287 la aplicación de la función musical @code{\unfoldRepeats}. Esta
2288 función cambia todas las repeticiones a repeticiones desplegadas.
2290 @lilypond[quote,verbatim]
2292 \repeat tremolo 8 { c'32 e' }
2293 \repeat percent 2 { c''8 d'' }
2294 \repeat volta 2 { c'4 d' e' f' }
2303 En partituras con varias voces, el desplegado de las repeticiones en
2304 la salida MIDI solo se produce correctamente si @emph{todas y cada
2305 una} de las voces incluye las repeticiones de manera completa y
2308 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
2309 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
2310 (con repeticiones desplegadas) y otro para la notación impresa (con
2311 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
2312 y percent --repetición de compases--). Por ejemplo,
2320 \unfoldRepeats @var{..música..}
2326 @node Control de los matices en el MIDI
2327 @subsection Control de los matices en el MIDI
2328 @translationof Controlling MIDI dynamics
2330 La dinámica en el MIDI está implementada por medio del intérprete
2331 Dynamic_performer que reside de forma predeterminada dentro del
2332 contexto Voice. Es posible controlar el volumen MIDI general, el
2333 volumen relativo de los matices dinámicos y el volumen relativo de los
2334 distintos instrumentos.
2336 @unnumberedsubsubsec Indicaciones dinámicas
2338 Los matices o indicaciones de dinámica se traducen a una fracción fija
2339 del rango de volumen MIDI disponible. Las fracciones predeterminadas
2340 se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
2341 @notation{fffff}. El conjunto de indicaciones dinámicas y las
2342 fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
2343 @rlearning{Otras fuentes de información}. Este conjunto de fracciones
2344 se puede cambiar o extender proporcionando una función que toma como
2345 argumento una indicación dinámica y devuelve la fracción requerida, y
2346 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
2349 Por ejemplo, si se requiere una indicación dinámica
2350 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
2351 predeterminado sobre el volumen MIDI, pues no está incluida en el
2352 conjunto predeterminado. De igual manera, si se define una indicación
2353 dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
2354 incluida en el conjunto predeterminado. El ejemplo siguiente muestra
2355 cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
2356 La función Scheme establece la fracción a 0.9 si se encuentra una
2357 indicación dinámica rfz, y en caso contrario llama a la función
2360 @lilypond[verbatim,quote]
2361 #(define (myDynamics dynamic)
2362 (if (equal? dynamic "rfz")
2364 (default-dynamic-absolute-volume dynamic)))
2368 \set Staff.midiInstrument = #"cello"
2369 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2381 Como alternativa, si se necesitara redefinir la tabla completa de
2382 fracciones, sería mejor usar el procedimiento
2383 @notation{default-dynamic-absolute-volume} que aparece en
2384 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
2385 ejemplo de esta sección muestra cómo se puede hacer esto.
2387 @unnumberedsubsubsec Volumen maestro MIDI
2389 El volumen general máximo y mínimo de las indicaciones dinámicas de
2390 MIDI se controla estableciendo valores para las propiedades
2391 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
2392 @code{Score}. Estas propiedades tienen efecto solamente sobre las
2393 indicaciones dinámicas, por ello si queremos que tengan validez desde
2394 el comienzo de la partitura, se debe colocar allí una indicación de
2395 dinámica. La fracción que corresponde a cada indicación dinámica se
2396 modifica con esta fórmula:
2399 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
2402 En el ejemplo siguiente, el rango de intensidad dinámica del volumen
2403 general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
2405 @lilypond[verbatim,quote]
2411 \set Staff.midiInstrument = #"flute"
2412 \new Voice \relative c''' {
2420 \set Staff.midiInstrument = #"clarinet"
2421 \new Voice \relative c'' {
2432 tempoWholesPerMinute = #(ly:make-moment 72 2)
2433 midiMinimumVolume = #0.2
2434 midiMaximumVolume = #0.5
2440 @unnumberedsubsubsec Balance entre instrumentos (i)
2442 Si las propiedades de volumen MIDI máximo y mínimo están establecidas
2443 en el contexto @code{Staff} se pueden controlar los volúmenes
2444 relativos de los instrumentos MIDI. Esto proporciona un ecualizador
2445 de instrumentos básico que puede realzar significativamente la calidad
2448 En este ejemplo se reduce el volumen del clarinete con relación al de
2449 la flauta. Debe haber una indicación dinámica en la primera nota de
2450 cada instrumento para que esto funcione correctamente.
2452 @lilypond[verbatim,quote]
2458 \set Staff.midiInstrument = #"flute"
2459 \set Staff.midiMinimumVolume = #0.7
2460 \set Staff.midiMaximumVolume = #0.9
2461 \new Voice \relative c''' {
2469 \set Staff.midiInstrument = #"clarinet"
2470 \set Staff.midiMinimumVolume = #0.3
2471 \set Staff.midiMaximumVolume = #0.6
2472 \new Voice \relative c'' {
2483 tempoWholesPerMinute = #(ly:make-moment 72 2)
2489 @unnumberedsubsubsec Balance entre instrumentos (ii)
2491 Si las propiedades de volumen MIDI máximo y mínimo no están
2492 establecidas, de forma predeterminada LilyPond aplica un pequeño grado
2493 de ecualización a algunos instrumentos. Los instrumentos y la
2494 ecualización que se aplica se muestra en la tabla
2495 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
2497 El ecualizador básico predeterminado se puede sustituir estableciendo
2498 @code{instrumentEqualizer} en el contexto @code{Score} a un
2499 procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
2500 como único argumento y devuelva un par de fracciones que dan los
2501 volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
2502 sustitución se hace de la misma forma que mostramos para restablecer
2503 la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
2504 al comienzo de esta sección. El ecualizador predeterminado,
2505 @notation{default-instrument-equalizer}, en
2506 @file{../scm/midi.scm}, muestra cómo se puede escribir tal
2509 El ejemplo siguiente establece los volúmenes relativos de la flauta y
2510 del clarinete a los mismos valores que el ejemplo anterior.
2512 @lilypond[verbatim,quote]
2513 #(define my-instrument-equalizer-alist '())
2515 #(set! my-instrument-equalizer-alist
2518 ("flute" . (0.7 . 0.9))
2519 ("clarinet" . (0.3 . 0.6)))
2520 my-instrument-equalizer-alist))
2522 #(define (my-instrument-equalizer s)
2523 (let ((entry (assoc s my-instrument-equalizer-alist)))
2532 \set Score.instrumentEqualizer = #my-instrument-equalizer
2533 \set Staff.midiInstrument = #"flute"
2534 \new Voice \relative c''' {
2542 \set Staff.midiInstrument = #"clarinet"
2543 \new Voice \relative c'' {
2554 tempoWholesPerMinute = #(ly:make-moment 72 2)
2561 @c Delete when satisfied this is adequately covered elsewhere -td
2563 @n ode Microtones in MIDI
2564 @s ubsection Microtones in MIDI
2566 @cindex microtones in MIDI
2568 Microtones consisting of half sharps and half flats are exported
2569 to the MIDI file and render correctly in MIDI players which support
2570 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
2571 an example showing all the half sharps and half flats. It can be
2572 copied out and compiled to test microtones in your MIDI player.
2574 @lilypond[verbatim,quote]
2591 @node Percusión en MIDI
2592 @subsection Percusión en MIDI
2593 @translationof Percussion in MIDI
2595 La notación de los instrumentos de percusión se realiza normalmente en
2596 un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
2597 salida correctamente por el canal MIDI@tie{}10, pero ciertos
2598 instrumentos de percusión de altura determinada, como el xilófono,
2599 marimba, vibráfono, timbales, etc., se tratan como instrumentos
2600 @qq{normales} y la música para estos instrumentos se debe introducir
2601 en contextos de @code{Staff} normales, no en un contexto
2602 @code{DrumStaff}, para obtener la salida MIDI correcta.
2604 Ciertos sonidos de altura indeterminada que están incluidos en el
2605 estándar General MIDI, como el tom melódico, el tambor taiko, los
2606 tambores sintéticos, etc., no se pueden acceder a través del canal
2607 MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
2608 introducir también en un contexto normal de @code{Staff}, utilizando
2609 las alturas normales adecuadas.
2611 Muchos instrumentos de percusión no están incluidos dentro del
2612 estándar General MIDI, p.ej. las castañuelas. El método más
2613 fácil (aunque no satisfactorio) de producir una salida MIDI al
2614 escribir para estos instrumentos es sustituirlos por el sonido más
2615 parecido del conjunto estándar.
2617 @c TODO Expand with examples, and any other issues
2621 Debido a que el estándar General MIDI no contiene golpes de aro
2622 (@emph{rim shots}), para este propósito se utiliza en su lugar el
2623 golpe lateral de baqueta (@emph{sidestick}).
2625 @node El script Articulate
2626 @subsection El script Articulate
2627 @translationof The Articulate script
2629 Es posible obtener una salida MIDI más real si se utiliza el script
2630 Articulate. Éste trata de tener en cuenta las articulaciones
2631 (ligaduras de expresión, picados, etc), mediante la sustitución de las
2632 notas con secuencias musicales de silencios y notas escaladas en el
2633 tiempo de forma apropiada. También trata de desplegar los trinos,
2634 grupetos circulares, etc. y responder a las indicaciones de
2635 rallentando y accelerando.
2637 Para utilizar el script Articulate, tenemos que incluirlo al principio
2638 de nuestro archivo de entrada:
2641 \include "articulate.ly"
2644 y en la sección @code{\score}, hacer lo siguiente:
2647 \unfoldRepeats \articulate <<
2648 resto de la partitura...
2652 Después de alterar el código de entrada de esta manera el resultado
2653 visual se altera profundamente, pero el bloque @code{\midi} estándar
2654 produce un archivo MIDI mejorado.
2656 Si bien no es esencial para que funcione el script Articulate, podemos
2657 insertar la instrucción @code{\unfoldRepeats} según aparece en el
2658 ejemplo anterior, dado que habilita la ejecución de abreviaturas tales
2659 como los @notation{trinos}.
2663 Articulate acorta los acordes, y ciertos fragmentos de música
2664 (especialmente la música de órgano) es posible que suene peor.