1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 2b1c53c017a17890a0f5bc72a4d8880eeb5f4991
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 @code{.ly}.
37 * Estructura de una partitura::
38 * Varias partituras en un libro::
39 * Estructura del archivo::
43 @node Estructura de una partitura
44 @subsection Estructura de una partitura
45 @translationof Structure of a score
49 Un bloque @code{\score} debe contener una expresión musical única
50 delimitada por un par de llaves:
59 @warning{Sólo puede haber @strong{una} expresión musical dentro del
60 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
62 Esta expresión musical única puede tener cualquier tamaño, y puede
63 contener otras expresiones musicales hasta cualquier grado de
64 complejidad. Todos los siguientes ejemplos son expresiones musicales:
70 @lilypond[verbatim,quote]
77 @lilypond[verbatim,quote]
79 \new Staff { c'4 c' c' c' }
80 \new Staff { d'4 d' d' d' }
88 \new Staff @{ \flute @}
89 \new Staff @{ \oboe @}
92 \new Staff @{ \violinI @}
93 \new Staff @{ \violinII @}
99 Los comentarios son una excepción a esta regla general (para ver otras
100 excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
101 una línea como los que están delimitados por @code{%@{ .. %@}} se
102 pueden escribir en cualquier lugar dentro del archivo de entrada. Se
103 pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
104 fuera de la expresión musical única dentro del bloque @code{\score}.
108 Manual de aprendizaje:
109 @rlearning{Trabajar sobre los archivos de entrada},
110 @rlearning{Explicación de las expresiones musicales},
111 @rlearning{La partitura es una (única) expresión musical compuesta}.
114 @node Varias partituras en un libro
115 @subsection Varias partituras en un libro
116 @translationof Multiple scores in a book
119 @cindex movimientos, varios
121 Un documento puede contener varias piezas de música y texto. Son
122 ejemplos un libro de estudios o una parte orquestal con varios
123 movimientos. Cada movimiento se introduce con un bloque
132 y los textos se introducen con un bloque @code{\markup}:
142 Todos los movimientos y textos que aparecen en el mismo archivo
143 @code{.ly} se tipografían normalmente en la forma de un solo archivo
158 Sin embargo, si queremos varios archivos de salida a partir del mismo
159 archivo @code{.ly}, podemos escribir varios bloques @code{\book},
160 donde cada uno de estos bloques @code{\book} dará como resultado un
161 archivo de salida distinto. Si no especificamos ningún bloque
162 @code{\book} en el archivo,, LilyPond trata implícitamente todo el
163 archivo como un solo bloque @code{\book}, véase @ref{Estructura del archivo}.
164 Una excepción importante se da dentro de los documentos de
165 lilypond-book, en los que tenemos que escribir explícitamente un
166 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
167 salida el primer @code{\score} o @code{\markup}.
169 El encabezamiento de cada pieza se puede poner dentro del bloque
170 @code{\score}. Antes de cada movimiento, se imprime el nombre de la
171 pieza (@code{piece}) extraído del encabezamiento. El título del libro
172 entero se puede poner dentro del bloque @code{\book}, pero si no está
173 presente se inserta el encabezamiento @code{\header} que está al
174 principio del archivo.
178 title = "Ocho miniaturas"
179 composer = "Igor Stravinsky"
183 \header @{ piece = "Romanze" @}
186 ..texto de la segunda estrofa..
189 ..texto de la tercera estrofa..
193 \header @{ piece = "Menuetto" @}
200 Se pueden agrupar distintas piezas de música en partes de un libro
201 utilizando bloques @code{\bookpart}. Las partes de libro se separan
202 por medio de saltos de página, y pueden dar comienzo con un título,
203 como el libro propiamente dicho, mediante la especificación del bloque
209 title = "Título del libro"
210 subtitle = "Primera parte"
217 subtitle = "Segunda parte"
225 @node Estructura del archivo
226 @subsection Estructura del archivo
227 @translationof File structure
237 Un archivo @code{.ly} puede contener cualquier número de expresiones
238 del nivel superior, donde una expresión del nivel superior es una de
239 las siguientes posibilidades:
243 Una definición de salida, como @code{\paper}, @code{\midi} y
244 @code{\layout}. Tal definición en el nivel más alto cambia los
245 ajustes predeterminados para todo el libro. Si se introduce más de
246 una de estas definiciones del mismo tipo en el nivel más alto,
247 cualquier definición en una expresión posterior tiene prioridad.
250 Una expresión directa de Scheme, como
251 @code{#(set-default-paper-size "a7" 'landscape)} o
252 @code{#(ly:set-option 'point-and-click #f)}.
255 Un bloque @code{\header}. Esto establece el bloque de encabezamiento
256 global. Es el bloque que contiene las definiciones de los ajustes
257 para todo el libro, como el compositor, título, etc.
260 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
261 del nivel superior, y se combina con ellas formando un @code{\book}
262 (libro) único. Este comportamiento se puede cambiar estableciendo el
263 valor de la variable @code{toplevel-score-handler} en el nivel
264 superior. El @emph{handler} predeterminado se define en el archivo de
265 inicio @file{../@/scm/@/lily@/.scm}.
268 Un bloque @code{\book} combina lógicamente varios movimientos (es
269 decir, varios bloques @code{\score}) en un solo documento. Si hay
270 varias partituras @code{\score}, se crea un solo archivo de salida
271 para cada bloque @code{\book}, en el que se concatenan todos los
272 movimientos correspondientes. La única razón para especificar
273 explícitamente bloques @code{\book} en un archivo de entrada
274 @code{.ly} es si queremos crear varios archivos de salida a partir de
275 un único archivo de entrada. Una excepción se da dentro de los
276 documentos de lilypond-book, en los que tenemos que escribir
277 explícitamente un bloque @code{\book} si queremos tener más de una
278 única partitura @code{\score} o marcado @code{\markup} en el mismo
279 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
280 de la variable @code{toplevel-book-handler} en el nivel superior. El
281 @emph{handler} predeterminado se define en el archivo de inicio
282 @file{../@/scm/@/lily@/.scm}.
285 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
286 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
287 la inserción de saltos de página o usar distintos ajustes de
288 @code{\paper} en las distintas partes.
291 Una expresión musical compuesta, como
296 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
297 único junto a todas las demás partituras @code{\score} y expresiones
298 musicales del nivel superior. En otras palabras, un archivo que
299 contiene sólo la expresión musical anterior se traduce a
315 Se puede cambiar este comportamiento estableciendo el valor de la
316 variable @code{toplevel-music-handler} en el nivel más alto. El
317 @emph{handler} predeterminado se define en el archivo de inicio
318 @file{../@/scm/@/lily@/.scm}.
321 Un texto de marcado, por ejemplo una estrofa
324 2. Estrofa dos, línea uno
328 Los textos de marcado se colocan encima, en medio o debajo de las
329 partituras o expresiones musicales, según donde aparezcan escritos.
336 fulano = @{ c4 d e d @}
339 Esto se puede utilizar más tarde en el archivo escribiendo
340 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
341 alfabético; sin números, guiones ni barras bajas.
345 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
350 % No justificar la salida
361 En cualquier punto del archivo se pueden introducir cualquiera de las
362 instrucciones léxicas siguientes:
365 @item @code{\version}
366 @item @code{\include}
367 @item @code{\sourcefilename}
368 @item @code{\sourcefileline}
370 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
373 Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
377 @cindex espacios en blanco
379 Por lo general se ignoran los espacios entre elementos del flujo de
380 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
381 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
382 evitar errores, en las siguientes situaciones:
385 @item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
386 @item A continuación de las instrucciones y variables, es decir, todos los elementos
387 que comienzan con un signo @code{\} de barra invertida.
388 @item A continuación de todo elemento que se deba interpretar como expresión
389 de Scheme, es decir, todo elemento que comience por un signo @code{#}.
390 @item Para separar los elementos de una expresión de Scheme.
391 @item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
392 @code{\override} y @code{\set}. Concretamente, hay que usar espacios
393 alrededor del punto y el signo igual en instrucciones como
394 @code{\override Score . LyricText #'font-size = #5} y antes y después
395 de la instrucción completa.
400 Manual de aprendizaje:
401 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
404 @node Títulos y cabeceras
405 @section Títulos y cabeceras
406 @translationof Titles and headers
408 Casi toda la música impresa tiene un título y el nombre del
409 compositor; ciertas piezas tienen mucha más información.
413 * Títulos personalizados::
414 * Referencias a números de página::
420 @subsection Crear títulos
421 @translationof Creating titles
423 Se crean títulos para cada uno de los bloques @code{\score} así como
424 para todo el archivo de entrada (o bloque @code{\book}, libro) y las
425 partes de libro (creadas mediante bloques @code{\bookpart}).
427 El contenido de cada título se extrae a partir de los bloques
428 @code{\header} (cabecera). El bloque de cabecera de un libro
429 contempla lo siguiente:
432 @funindex dedicatoria
434 El dedicatario de la música, centrado en lo alto de la primera página.
438 El título de la música, centrado justo debajo de la
443 Subtítulo, centrado debajo del título.
445 @funindex subsubtitle
447 Sub-subtítulo, centrado debajo del subtítulo.
451 Nombre del poeta, a la izquierda, debajo del subtítulo.
455 Nombre del compositor, a la derecha, debajo del subtítulo.
459 Texto de la medida, a la izquierda, debajo del poeta.
463 Nombre del Opus, a la derecha, debajo del compositor.
467 Nombre del arreglista, a la derecha, debajo del Opus.
471 Nombre del instrumento, centrado, debajo del arreglista. También
472 aparece centrado en lo alto de cada página (aparte de la primera).
476 Nombre de la pieza, a la izquierda, debajo del instrumento.
478 @cindex página, saltos, forzar
479 @funindex breakbefore
481 Esto fuerza que el título comience sobre una página nueva (establézcalo a ##t o a ##f).
485 Aviso de Copyright, centrado en la parte inferior de la primera
486 página. Para insertar el símbolo de copyright, consulte
487 @ref{Codificación del texto}.
491 Cartel de propósito general en el pie de página, centrado al final de la última.
495 A continuación presentamos una demostración de todos los campos que
496 están disponibles. Fíjese en que puede utilizar en la cabecera
497 cualquier instrucción de marcado de texto (Véase @ref{Formatear el texto}).
499 @lilypond[quote,verbatim,line-width=11.0\cm]
502 paper-height = 10.0\cm
507 dedication = "dedicated to me"
508 title = \markup \center-column { "Title first line" "Title second line,
510 subtitle = "the subtitle,"
511 subsubtitle = #(string-append "subsubtitle LilyPond version "
514 composer = \markup \center-column { "composer" \small "(1847-1973)" }
515 texttranslator = "Text Translator"
516 meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
518 arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
519 #-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "nger" }
520 instrument = \markup \bold \italic "instrument"
544 Como se mostró anteriormente, puede usar varios bloques
545 @code{\header}. Cuando los mismos campos aparecen en distintos
546 bloques, tiene validez el último en definirse. A continuación un
551 composer = "Compositor"
559 piece = "Otra pieza" % sobreescribe a la anterior
564 Si define la cabecera @code{\header} dentro del bloque @code{\score},
565 por lo general se imprimirán solamente las cabeceras @code{piece} y
566 @code{opus}. Fíjese en que la expresión musical debe aparecer antes
569 @lilypond[quote,verbatim,line-width=11.0\cm]
573 title = "title" % not printed
580 @funindex print-all-headers
582 Se puede cambiar este comportamiento (e imprimir todas las cabeceras
583 cuando la cabecera @code{\header} está definida dentro del bloque
584 @code{\score}) mediante la utilización de
588 print-all-headers = ##t
595 El pie de página por omisión se encuentra vacío, excepto para la
596 primera página, en la que se inserta el campo de @code{copyright}
597 extraído del @code{\header}, y para la última página, en la que se
598 escribe el cartel @code{tagline} sacado del bloque @code{\header}. La
599 línea por omisión para este cartel es @qq{Music engraving by LilyPond
600 (@var{version})}.@footnote{Las partituras bien tipografiadas son una
601 magnífica promoción para nosotros, así que por favor, si puede,
602 conserve intacta la línea del letrero.}
604 Las cabeceras se pueden quitar completamente estableciendo su valor a
615 @node Títulos personalizados
616 @subsection Títulos personalizados
617 @translationof Custom titles
619 Una opción más avanzada es cambiar las definiciones de las variables
620 siguientes dentro del bloque @code{\paper}. El archivo de inicio
621 @file{../@/ly/@/titling@/-init@/.ly} ofrece un listado de la
622 disposición predeterminada.
625 @funindex bookTitleMarkup
626 @item bookTitleMarkup
627 Es el título que se escribe en lo alto del documento de salida
628 completo. Normalmente contiene el compositor y el título de la pieza.
630 @funindex scoreTitleMarkup
631 @item scoreTitleMarkup
632 Es el título que se coloca por encima de un bloque @code{\score}.
633 normalmente contiene el nombre del movimiento (campo @code{piece}).
635 @funindex oddHeaderMarkup
636 @item oddHeaderMarkup
637 Es el encabezamiento de las páginas de numeración impar.
639 @funindex evenHeaderMarkup
640 @item evenHeaderMarkup
641 Es el encabezamiento de las páginas de numeración par. Si se deja
642 sin especificar, se usará el encabezamiento de las páginas impares.
644 De forma predeterminada, los encabezamientos se definen de tal forma
645 que el número de página está en el borde exterior, y el instrumento
648 @funindex oddFooterMarkup
649 @item oddFooterMarkup
650 Es el pie de las páginas de numeración impar.
652 @funindex evenFooterMarkup
653 @item evenFooterMarkup
654 Es el pie de las páginas de numeración par. Si se deja sin
655 especificar, se usará en su lugar el encabezamiento de las páginas
658 De forma predeterminada, el pie de página tiene el aviso de
659 copyright en la primera página, y el cartel @code{tagline} en la
665 @cindex encabezamiento
668 @cindex disposición de la página
671 La definición siguiente pone el título en el extremo izquierdo, y el
672 compositor en el extremo derecho sobre una única línea.
676 bookTitleMarkup = \markup {
678 \fromproperty #'header:title
679 \fromproperty #'header:composer
685 @node Referencias a números de página
686 @subsection Referencias a números de página
687 @translationof Reference to page numbers
689 Se puede marcar un lugar determinado de una partitura utilizando la
690 instrucción @code{\label} (etiqueta), bien en lo alto de la estructura
691 o bien dentro de la música. Posteriormente se puede hacer referencia
692 a esta etiqueta dentro de un elemento de marcado, para obtener el
693 número de la página en que se encuentra la marca, usando la
694 instrucción de marcado @code{\page-ref}.
696 @lilypond[verbatim,line-width=11.0\cm]
697 \header { tagline = ##f }
703 \pageBreak \mark A \label #'markA
708 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
709 \markup { Mark A is on page \page-ref #'markA "0" "?" }
713 La instrucción de marcado @code{\page-ref} toma tres argumentos:
715 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
716 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
717 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
720 El motivo de que se necesite un medidor es que en el momento en que se
721 están interpretando los marcados, los saltos de página aún no se han
722 producido y por tanto los números de página no se conocen todavía.
723 Para sortear este inconveniente, la interpretación real del marcado se
724 retrasa hasta un momento posterior; sin embargo, las dimensiones del
725 marcado se tienen que conocer de antemano, así que se usa el medidor
726 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
727 páginas, el medidor puede ser "00", es decir, un número de dos
740 @subsection Índice general
741 @translationof Table of contents
743 Se puede insertar un índice general o tabla de contenidos utilizando
744 la instrucción @code{\markuplines \table-of-contents}. Los elementos
745 que deben aparecer en la tabla de contenidos se introducen con la
746 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
747 la jerarquía del código, o dentro de una expresión musical.
750 \markuplines \table-of-contents
753 \tocItem \markup "Primera partitura"
757 \tocItem \markup "Un punto concreto dentro de la primera partitura"
762 \tocItem \markup "Segunda partitura"
770 Los elementos de marcado que se usan para dar formato al índice
771 general se encuentran definidos dentro del bloque @code{\paper}. Los
772 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
773 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
774 los elementos del índice, que consisten en el título del elemento y el
775 número de página. Estas variables se pueden cambiar por parte del
780 %% Traducir el título del índice al español:
781 tocTitleMarkup = \markup \huge \column {
782 \fill-line { \null "Índice general" \null }
785 %% usar una fuente mayor
786 tocItemMarkup = \markup \large \fill-line {
787 \fromproperty #'toc:text \fromproperty #'toc:page
792 Observe la forma en que nos referimos al texto y al número de página
793 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
795 También se pueden definir nuevas instrucciones y elementos de
796 marcado para crear índices generales más elaborados:
798 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
799 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
800 utilizando esta variable de marcado del bloque @code{\paper}.
803 En el ejemplo siguiente se define un estilo nuevo para introducir los
804 nombres de los actos de una ópera en el índice general:
808 tocActMarkup = \markup \large \column {
810 \fill-line { \null \italic \fromproperty #'toc:text \null }
816 #(define-music-function (parser location text) (markup?)
817 (add-toc-item! 'tocActMarkup text))
820 @lilypond[line-width=11.0\cm]
821 \header { tagline = ##f }
823 tocActMarkup = \markup \large \column {
825 \fill-line { \null \italic \fromproperty #'toc:text \null }
831 #(define-music-function (parser location text) (markup?)
832 (add-toc-item! 'tocActMarkup text))
835 \markuplines \table-of-contents
836 \tocAct \markup { Atto Primo }
837 \tocItem \markup { Coro. Viva il nostro Alcide }
838 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
839 \tocAct \markup { Atto Secondo }
840 \tocItem \markup { Sinfonia }
841 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
849 @file{../@/ly/@/toc@/-init@/.ly}.
853 @funindex \table-of-contents
854 @code{\table-of-contents},
860 @node Trabajar sobre los archivos de entrada
861 @section Trabajar sobre los archivos de entrada
862 @translationof Working with input files
865 * Inclusión de archivos de LilyPond::
866 * Distintas ediciones a partir de una misma fuente::
867 * Codificación del texto::
868 * Presentar la notación de LilyPond::
872 @node Inclusión de archivos de LilyPond
873 @subsection Inclusión de archivos de LilyPond
874 @translationof Including LilyPond files
877 @cindex including files
879 Un proyecto grande se puede dividir en varios archivos. Para
880 referirse a otro archivo, utilice
883 \include "otroarchivo.ly"
886 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
887 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
888 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
889 podríamos querer archivos distintos para cada parte instrumental y
890 crear un archivo de @qq{partitura completa} que reúne los archivos
891 individuales de los instrumentos. Normalmente el archivo incluido
892 define un cierto número de variables que a partir de entonces quedan
893 disponibles para poderlas utilizar en el archivo de la partitura
894 completa. En los archivos incluidos se pueden marcar las secciones
895 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
896 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
898 Los archivos que están en el directorio de trabajo actual se pueden
899 referenciar simplemente especificando el nombre después de la
900 instrucción @code{\include}. Los archivos en otros lugares se pueden
901 incluir proporcionando una referencia de ruta completa o una ruta
902 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
903 barra invertida de DOS/Windows, \, como separador de directorio). Por
904 ejemplo, si @file{material.ly} está situado un directorio por encima
905 del directorio de trabajo actual, utilice
908 \include "../material.ly"
912 o si los archivos de las partes orquestales incluidas están todos
913 situados en un subdirectorio llamado @file{partes} dentro del
914 directorio actual, use
917 \include "partes/VI.ly"
918 \include "partes/VII.ly"
922 Los archivos de inclusión también pueden contener enunciados
923 @code{\include} a su vez. De forma predeterminada, estos enunciados
924 @code{\include} de segundo nivel no se interpretan hasta que se
925 incorporan al archivo principal, por lo que los nombres de archivo que
926 especifican deben ser relativos al directorio que contiene el archivo
927 principal, no al directorio que contiene el archivo incluido. Sin
928 embargo, este comportamiento se puede modificar pasando la opción
929 @code{-drelative-includes} en la línea de órdenes (o mediante la
930 adición de @code{#(ly:set-option 'relative-includes #t)} al principio
931 del archivo principal de entrada). Con el valor de
932 @code{relative-includes} establecido, la ruta de cada instrucción
933 @code{\include} se considera relativa al archivo que contiene dicha
934 instrucción. Este comportamiento es el recomendado y se convertirá en
935 el comportamiento predeterminado en una versión futura de lilypond.
937 También se pueden incluir archivos de un directorio que está en una
938 ruta de búsqueda especificada como opción al invocar a LilyPond desde
939 la línea de órdenes. Los archivos incluidos se especifican usando
940 solamente su nombre de archivo. Por ejemplo, para compilar mediante
941 este método un archivo @file{principal.ly} que incluye archivos
942 situados en un subdirectorio llamado @file{partes}, cambie al
943 directorio que contiene @file{principal.ly} e introduzca
946 lilypond --include=partes principal.ly
949 y en @file{principal.ly} escriba
957 Los archivos que se incluyen en muchas partituras se pueden poner en
958 el directorio de LilyPond @file{../ly} (la localización de este
959 directorio depende de la instalación: véase
960 @rlearning{Otras fuentes de información}). Estos archivos se pueden
961 incluir sencillamente por su nombre en un enunciado @code{\include}.
962 De esta forma se incluyen los archivos dependientes del idioma como
965 LilyPond incluye de forma predeterminada ciertos archivos cuando se
966 inicia el programa. Estas inclusiones no son visibles para el
967 usuario, pero los archivos se pueden identificar ejecutando
968 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
969 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
970 otras indicaciones. De forma alternativa, pueden verse explicaciones
971 sobre los archivos más importantes de este conjunto en
972 @rlearning{Otras fuentes de información}. Estos archivos se pueden
973 editar, pero los cambios realizados sobre ellos se perderán al
974 instalar una nueva versión de LilyPond.
976 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
977 @rlearning{Partituras y particellas}.
981 Manual de aprendizaje:
982 @rlearning{Otras fuentes de información},
983 @rlearning{Partituras y particellas}.
988 Si un archivo incluido recibe un nombre igual al de uno de los
989 archivos de instalación de LilyPond, el archivo que tiene prioridad es
990 el de los archivos de instalación de LilyPond.
993 @node Distintas ediciones a partir de una misma fuente
994 @subsection Distintas ediciones a partir de una misma fuente
995 @translationof Different editions from one source
997 Se encuentran disponibles varios mecanismos para facilitar la
998 producción de distintas versiones de una partitura a partir de la
999 misma fuente musical. Las variables son quizá más útiles para
1000 combinar secciones extensas de música y/o anotaciones de diversas
1001 formas, mientras que las etiquetas son más útiles para seleccionar una
1002 de entra varias secciones de música más cortas. Cualquiera que sea el
1003 método utilizado, la separación de la notación de la estructura de la
1004 partitura hará que sea más fácil cambiar la estructura dejando intacta
1008 * Uso de las variables::
1009 * Uso de etiquetas::
1012 @node Uso de las variables
1013 @unnumberedsubsubsec Uso de las variables
1014 @translationof Using variables
1016 @cindex variables, uso de las
1018 Si las secciones de la música se definen dentro de variables, se
1019 pueden reutilizar en distintas partes de la partitura, véase
1020 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
1021 partitura vocal @notation{a cappella} con frecuencia incluye una
1022 reducción de piano de las partes para ensayar que es idéntica a la
1023 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
1024 puede combinar sobre un solo pentagrama la música de dos variables,
1025 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
1027 @lilypond[verbatim,quote]
1028 sopranoMusic = \relative c'' { a4 b c b8( a)}
1029 altoMusic = \relative g' { e4 e e f }
1030 tenorMusic = \relative c' { c4 b e d8( c) }
1031 bassMusic = \relative c' { a4 gis a d, }
1032 allLyrics = \lyricmode {King of glo -- ry }
1034 \new Staff = "Soprano" \sopranoMusic
1035 \new Lyrics \allLyrics
1036 \new Staff = "Alto" \altoMusic
1037 \new Lyrics \allLyrics
1038 \new Staff = "Tenor" {
1042 \new Lyrics \allLyrics
1043 \new Staff = "Bass" {
1047 \new Lyrics \allLyrics
1050 \set Staff.printPartCombineTexts = ##f
1056 \set Staff.printPartCombineTexts = ##f
1066 Se pueden producir partituras distintas que presenten sólo las partes
1067 vocales o sólo la parte de piano, cambiando solamente los enunciados
1068 estructurales, sin modificar la notación musical.
1070 Para partituras extensas, las definiciones de variable se pueden poner
1071 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
1074 @node Uso de etiquetas
1075 @unnumberedsubsubsec Uso de etiquetas
1076 @translationof Using tags
1079 @funindex \keepWithTag
1080 @funindex \removeWithTag
1082 @cindex mantener música etiquetada
1083 @cindex quitar música etiquetada
1085 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
1086 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
1087 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
1088 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
1089 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
1090 música etiquetada es como sigue:
1092 @multitable @columnfractions .5 .5
1096 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
1098 Se incluye la música no etiquetada y la música etiquetada con
1099 @var{nombre}; se excluye la música etiquetada con cualquier otro
1102 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
1104 Se incluye la música no etiquetada y la música etiquetada con
1105 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
1106 música etiquetada con @var{nombre}.
1108 Música etiquetada no precedida de @code{\keepWithTag} ni de
1109 @code{\removeWithTag}
1110 @tab Se incluye toda la música etiquetada y no etiquetada.
1113 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
1114 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
1115 @code{#'parte}), seguido de una expresión musical.
1117 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
1118 que muestra trinos con la notación usual y otra con los trinos
1119 expandidos explícitamente:
1121 @lilypond[verbatim,quote]
1122 music = \relative g' {
1124 \tag #'trills {d8.\trill }
1125 \tag #'expand {\repeat unfold 3 {e32 d} }
1130 \keepWithTag #'trills \music
1133 \keepWithTag #'expand \music
1138 De forma alternativa, a veces es más fácil excluir secciones de música:
1140 @lilypond[verbatim,quote]
1141 music = \relative g' {
1143 \tag #'trills {d8.\trill }
1144 \tag #'expand {\repeat unfold 3 {e32 d} }
1149 \removeWithTag #'expand
1153 \removeWithTag #'trills
1158 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
1162 -\tag #'@var{mi-etiqueta}
1165 a una articulación. Por ejemplo, esto define una nota con una
1166 indicación opcional de digitación y una nota con una anotación
1171 c1-\tag #'warn ^"¡Ojo!"
1174 Se pueden poner varias etiquetas sobre expresiones con varias entradas
1177 @lilypond[quote,verbatim]
1178 music = \relative c'' {
1179 \tag #'a \tag #'both { a a a a }
1180 \tag #'b \tag #'both { b b b b }
1183 \keepWithTag #'a \music
1184 \keepWithTag #'b \music
1185 \keepWithTag #'both \music
1189 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
1190 expresión musical para quitar varias secciones etiquetadas con nombres
1193 @lilypond[verbatim,quote]
1194 music = \relative c'' {
1195 \tag #'A { a a a a }
1196 \tag #'B { b b b b }
1197 \tag #'C { c c c c }
1198 \tag #'D { d d d d }
1207 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
1208 musical producen la eliminación de @emph{todas} las secciones
1209 etiquetadas, porque el primer filtro quita todas las secciones
1210 etiquetadas excepto la que se nombra, y el segundo filtro elimina
1211 incluso esa sección etiquetada.
1215 Manual de aprendizaje:
1216 @rlearning{Organizar las piezas mediante variables}.
1218 Referencia de la notación:
1219 @ref{Combinación automática de las partes},
1220 @ref{Inclusión de archivos de LilyPond}.
1224 @c This warning is more general than this placement implies.
1225 @c Rests are not merged whether or not they come from tagged sections.
1226 @c Should be deleted? -td
1231 Multiple rests are not merged if you create a score with more
1232 than one tagged section at the same place.
1236 @node Codificación del texto
1237 @subsection Codificación del texto
1238 @translationof Text encoding
1242 @cindex caracteres no ASCII
1244 LilyPond usa el conjunto de caracteres definido por el consorcio
1245 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
1246 para los conjuntos de caracteres que se utilizan en prácticamente
1247 todos los idiomas modernos y también en muchos otros. Unicode se
1248 puede implementar utilizando varios esquemas de codificación
1249 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
1250 @emph{Unicode Transformation Format}, o formato de transformación de
1251 Unicode) que representa todos los caracteres comunes de Latin en un
1252 solo byte, y representa otros caracteres usando un formato de longitud
1253 variable de hasta cuatro bytes.
1255 El aspecto visual real de los caracteres viene determinado por los
1256 glifos que se definen en las fuentes tipográficas concretas que se
1257 tengan disponibles: una fuente tipográfica define la asignación de un
1258 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
1259 biblioteca Pango para representar y disponer tipográficamente textos
1262 LilyPond no realiza ninguna conversión en la codificación de la
1263 entrada. Esto significa que cualquier text, ya sea el título, la
1264 letra de la canción o una instrucción musical que contenga caracteres
1265 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
1266 forma más fácil de escribir dicho texto es utilizar un editor
1267 preparado para Unicode y guardar el archivo con la codificación UTF-8.
1268 Casi todos los editores modernos populares contemplan el UTF-8, por
1269 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
1270 Windows posteriores a NT usan Unicode como codificación de caracteres
1271 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
1272 puede editar y guardar un archivo en el formato UTF-8. Una
1273 alternativa más funcional para Windows es BabelPad.
1275 Si un archivo de entrada que contiene un carácter que no es ASCII, no
1276 se guarda en el formato UTF-8, se genera el mensaje de error
1279 FT_Get_Glyph_Name () error: argumento inválido
1282 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
1285 %c No verbatim here as the code does not display correctly in PDF
1287 bulgarian = \lyricmode {
1288 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1292 hebrew = \lyricmode {
1293 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1297 portuguese = \lyricmode {
1298 à vo -- cê uma can -- ção legal
1304 \addlyrics { \bulgarian }
1305 \addlyrics { \hebrew }
1306 \addlyrics { \portuguese }
1309 Para introducir un carácter aislado para el que se conoce el punto de
1310 código Unicode pero no está disponible en el editor que se está
1311 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
1312 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
1313 del carácter en cuestión y @code{dddd} es su valor decimal
1314 correspondiente. Pueden omitirse los ceros iniciales, pero es
1315 costumbre indicar los cuatro caracteres en la representación
1316 hexadecimal (observe que @emph{no} debe utilizarse la codificación
1317 UTF-8 del punto de código Unicode después de @code{\char}, pues la
1318 codificación UTF-8 contiene bits adicionales que indican el número de
1319 octetos). Hay tablas de códigos Unicode y un índice de nombres de
1320 caracteres que da el punto de código en hexadecimal para cualquier
1321 carácter en el portal del Consorcio Unicode,
1322 @uref{http://www.unicode.org/}.
1325 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
1326 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
1327 @qq{Letra griega Xi pequeña}.
1329 Se puede escribir de esta forma cualquier punto de código Unicode, y
1330 si todos los caracteres especiales se escriben en este formato no es
1331 necesario guardar el archivo de entrada en formato UTF-8. Por
1332 supuesto, debe estar instalada y estar disponible para LilyPond una
1333 fuente tipográfica que contenga codificados todos estos caracteres.
1335 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
1336 en cuatro lugares: en una llamada de ensayo, como texto de
1337 articulación, en la letra y como texto independiente bajo la
1340 @lilypond[quote,verbatim]
1343 c1 \mark \markup { \char ##x03EE }
1344 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1346 \addlyrics { O \markup { \concat{ Ph \char ##x0153 be! } } }
1348 \markup { "Copyright 2008--2010" \char ##x00A9 }
1351 @cindex copyright, símbolo de
1353 Para escribir el símbolo de copyright en la nota de créditos, utilice:
1357 copyright = \markup @{ \char ##x00A9 "2008" @}
1362 @node Presentar la notación de LilyPond
1363 @subsection Presentar la notación de LilyPond
1364 @translationof Displaying LilyPond notation
1366 @funindex \displayLilyMusic
1367 La impresión textual de una expresión musical en notación de LilyPond
1368 puede hacerse usando la función musical @code{\displayLilyMusic}. Por
1373 \displayLilyMusic \transpose c a, @{ c e g a bes @}
1380 @{ a, cis e fis g @}
1383 De forma predeterminada, LilyPond imprime estos mensajes en la consola
1384 junto al resto de los mensajes. Para discernir entre estos mensajes y
1385 guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
1386 salida hacia un archivo.
1388 @c TODO What happens under Windows?
1391 lilypond archivo.ly >resultado.txt
1396 @node Controlar la salida
1397 @section Controlar la salida
1398 @translationof Controlling output
1401 * Extracción de fragmentos de música::
1402 * Saltar la música corregida::
1403 * Formatos de salida alternativos::
1404 * Sustituir la tipografía de la notación::
1407 @node Extracción de fragmentos de música
1408 @subsection Extracción de fragmentos de música
1409 @translationof Extracting fragments of music
1411 Es posible citar pequeños fragmentos de una partitura grande
1412 directamente a partir de la salida. Puede compararse con la
1413 separación de una pieza de una partitura, recortándola con tijeras.
1415 Esto se hace definiendo los compases que se deben recortar. Por
1416 ejemplo, la inclusión de la siguiente definición
1423 (make-rhythmic-location 5 1 2)
1424 (make-rhythmic-location 7 3 4)))
1429 extrae un fragmento empezando por la mitad del quinto compás y
1430 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
1431 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
1432 después de tres negras del compás 7.
1434 Se pueden definir más zonas de recorte añadiendo más parejas de
1435 definición de tiempo rhythmic-location a la lista.
1437 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
1438 la opción @code{-dclip-systems}. Los recortes aparecen en la salida
1439 como archivos EPS, y se convierten en PDF y PNG si estos formatos
1440 también están activados.
1442 Para ver más información sobre los formatos de salida, consulte
1443 @rprogram{Invocar a LilyPond}.
1446 @node Saltar la música corregida
1447 @subsection Saltar la música corregida
1448 @translationof Skipping corrected music
1450 @funindex skipTypesetting
1451 @funindex showFirstLength
1452 @funindex showLastLength
1454 Al escribir o copiar música, normalmente sólo es interesante de ver y
1455 corregir la música cercana al final (donde estamos añadiendo las
1456 notas). Para acelerar este proceso de corrección, es posible saltar
1457 la composición tipográfica de todos excepto unos pocos de los últimos
1458 compases. Esto se consigue poniendo
1461 showLastLength = R1*5
1466 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
1467 cinco compases (suponiendo un compás de 4/4) de cada una de las
1468 partituras @code{\score} del archivo de entrada. Para piezas largas,
1469 el tipografiado de únicamente una parte pequeña es con frecuencia un
1470 orden de magnitud más rápido que el de la obra completa. Si estamos
1471 trabajando sobre el principio de una partitura que ya hemos
1472 tipografiado (p.ej., para añadir una parte instrumental nueva),
1473 también puede ser útil la propiedad @code{showFirstLength}.
1475 Este mecanismo de pasar por alto partes de un partitura se puede
1476 controlar con un grano más fino mediante la propiedad
1477 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
1478 lleva a cabo ningún tipografiado en absoluto.
1480 Esta propiedad se usa también para controlar la salida al archivo
1481 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
1482 y los cambios de instrumento. Está usted advertido.
1484 @lilypond[quote,fragment,ragged-right,verbatim]
1487 \set Score.skipTypesetting = ##t
1489 \set Score.skipTypesetting = ##f
1493 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
1494 voces y pentagramas, ahorrando más tiempo incluso.
1496 @node Formatos de salida alternativos
1497 @subsection Formatos de salida alternativos
1498 @translationof Alternative output formats
1500 @cindex salida de gráficos de vector escalables
1502 @cindex salida de PostScript encapsulado
1504 @cindex PostScript encapsulado, salida de
1506 Los formatos de salida predeterminados para la partitura impresa son
1507 el formato de documento portátil (PDF) y PostScript (PS). Los
1508 formatos de salida Gráficos de vector escalables (SVG), PostScript
1509 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
1510 disponibles a través de opciones de la línea de órdenes, véase
1511 @rprogram{Opciones de la línea de órdenes para lilypond}.
1514 @node Sustituir la tipografía de la notación
1515 @subsection Sustituir la tipografía de la notación
1516 @translationof Replacing the notation font
1522 @section Salida MIDI
1523 @translationof MIDI output
1528 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
1529 Instrumentos Musicales) es un estándar para interconectar y controlar
1530 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
1531 una serie de notas dentro de un conjunto de pistas. No es un archivo
1532 de sonidos reales; se necesita un programa reproductor especial para
1533 traducir la serie de notas en sonidos de verdad.
1535 Cualquier música se puede convertir a archivos MIDI, de manera que
1536 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
1537 para comprobar la corrección de la música; las octavas equivocadas o
1538 las alteraciones erróneas se ponen de relieve muy claramente al
1539 escuchar la salida MIDI.
1542 La salida MIDI reserva un canal por cada pentagrama, y otro para los
1543 ajustes globales. Por ello, el archivo MIDI no debe tener más de 15
1544 pautas (o 14 si no se usa la percusión). Otros pentagramas permanecen
1548 * Crear archivos MIDI::
1550 * ¿Qué sale por el MIDI?::
1551 * Repeticiones y MIDI::
1552 * Control de los matices en el MIDI::
1553 * Percusión en MIDI::
1556 @node Crear archivos MIDI
1557 @subsection Crear archivos MIDI
1558 @translationof Creating MIDI files
1560 Para crear un MIDI a partir de una pieza de música, escriba un bloque
1561 @code{\midi} en la partitura, por ejemplo:
1570 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
1571 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
1572 necesita una notación impresa, debe haber también un bloque
1583 Se traducen correctamente a la salida MIDI la altura y duración de las
1584 notas, las ligaduras de unión, matices y cambios de tempo. Las
1585 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
1586 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
1587 del rango de volumen MIDI disponible. Los crescendi y decrescendi
1588 hacen que el volumen varía linealmente entre sus dos extremos. El
1589 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
1590 eliminar por completo, véase @ref{El bloque MIDI}.
1592 El tempo inicial y los cambios de tempo posteriores se pueden
1593 especificar utilizando la instrucción @code{\tempo} dentro de la
1594 propia notación musical. Se reflejan en cambios de tempo en la salida
1595 MIDI. Esta instrucción normalmente hace que se imprima la indicación
1596 metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
1597 Más abajo se describe una forma alternativa de especificar el tempo
1598 MIDI inicial o global, véase @ref{El bloque MIDI}.
1600 Debido a ciertas limitaciones de Windows, la extensión predeterminada
1601 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
1602 operativos utilizan la extensión @code{.midi}. Si prefiere una
1603 extensión diferente, inserte la siguiente línea en el nivel jerárquico
1604 superior del archivo de entrada, antes del inicio de cualquier bloque
1605 @code{\book}, @code{\bookpart} o @code{\score}:
1608 #(ly:set-option 'midi-extension "midi")
1611 La línea anterior establece la extensión predeterminada para los
1612 archivos MIDI a @code{.midi}.
1614 De forma alternativa, esta opción se puede también proporcionar en la
1618 lilypond … -dmidi-extension=midi archivoLily.ly
1622 @unnumberedsubsubsec Nombres de instrumentos
1624 @cindex instrumento, nombres de
1625 @funindex Staff.midiInstrument
1627 El nombre del instrumento MIDI se establece mediante la propiedad
1628 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
1629 de entre los que están en la lista que aparece en @ref{Instrumentos MIDI}.
1633 \set Staff.midiInstrument = #"glockenspiel"
1639 \new Staff \with @{midiInstrument = #"cello"@} @{
1644 Si el instrumento elegido no coincide exactamente con uno de los
1645 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
1646 Piano de Cola (@code{"acoustic grand"}).
1650 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
1651 {changing-midi-output-to-one-channel-per-voice.ly}
1655 @c In 2.11 the following no longer seems to be a problem -td
1657 Unterminated (de)crescendos will not render properly in the midi file,
1658 resulting in silent passages of music. The workaround is to explicitly
1659 terminate the (de)crescendo. For example,
1666 will not work properly but
1676 Los cambios del volumen MIDI sólo tienen lugar al principio de la
1677 nota, por lo que los crescendi y decrescendi no pueden afectar al
1678 volumen de una sola nota.
1680 No todos los reproductores de MIDI manejar adecuadamente los cambios de
1681 tempo de la salida MIDI. Entre los reproductores que se sabe que
1682 funcionan se encuentran el Reproductor de Medios de MS Windows y
1683 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
1686 @node El bloque MIDI
1687 @subsection El bloque MIDI
1688 @translationof MIDI block
1692 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
1693 dentro de un bloque de partitura. Es análogo al bloque layout de
1694 diseño de página, pero algo más simple. Con frecuencia, el bloque
1695 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
1696 contextos, definiciones de contexto nuevas o código para fijar valores
1697 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
1698 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
1699 indicación de tempo:
1707 tempoWholesPerMinute = #(ly:make-moment 72 4)
1713 En este ejemplo, el tempo se establece a 72 pulsos de negra por
1714 minuto. Esta clase de especificación de tempo no puede tomar como
1715 argumento una figura con puntillo. Si necesitamos una figura con
1716 puntillo, dividimos la nota con puntillo en figuras más pequeñas. Por
1717 ejemplo, un tempo de 90 negras con puntillo por minuto se puede
1718 especificar como 270 corcheas por minuto:
1721 tempoWholesPerMinute = #(ly:make-moment 270 8)
1724 @cindex MIDI, definiciones de contexto
1726 Las definiciones de contexto siguen con precisión la misma sintaxis
1727 que la de un bloque @code{\layout}. Los módulos de traducción para el
1728 sonido reciben el nombre de ejecutantes. Los contextos para la salida
1729 MIDI se definen en @file{../@/ly/@/performer@/-init@/.ly}, véase
1730 @rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
1731 el efecto de los matices de la salida MIDI, inserte las líneas
1732 siguientes en el bloque @code{\midi@{ @}}.
1739 \remove "Dynamic_performer"
1744 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
1745 dentro de un bloque de partitura definido con una instrucción
1746 @code{\score}. Si se sitúa dentro de un contexto de partitura
1747 instanciado explícitamente (es decir, dentro de un bloque @code{\new
1748 Score}) el archivo no funciona. Para resolverlo, encierre las
1749 instrucciones @code{\new Score} y @code{\midi} dentro de un bloque
1754 \new Score @{ @dots{}notas@dots{} @}
1759 @node ¿Qué sale por el MIDI?
1760 @subsection ¿Qué sale por el MIDI?
1761 @translationof What goes into the MIDI output?
1763 @unnumberedsubsubsec Contemplado en el MIDI
1765 @cindex alturas en MIDI
1766 @cindex MIDI, alturas
1767 @cindex cuartos de tono en MIDI
1768 @cindex MIDI, cuartos de tono
1769 @cindex microtonos en MIDI
1770 @cindex MIDI, microtonos
1771 @cindex acordes, nombres de, en MIDI
1772 @cindex MIDI, nombres de
1773 @cindex duraciones en MIDI
1774 @cindex MIDI, duraciones
1777 Los siguientes elementos de notación se reflejan en la salida MIDI:
1781 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
1782 @item Acordes escritos como nombres de acorde
1783 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
1784 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
1785 @item Ligaduras de unión
1786 @item Matices o indicaciones de dinámica
1787 @item Crescendi y decrescendi sobre varias notas
1788 @item Cambios de tempo insertados con una marca metronómica
1789 @item Letra de las canciones
1792 @unnumberedsubsubsec No contemplado en el MIDI
1794 @c TODO index as above
1796 Los siguientes elementos de notación no tienen ningún efecto sobre la
1800 @item Duraciones escritas como anotaciones, p.ej. el swing
1801 @item Cambios de tempo escritos como anotaciones sin marca de tempo
1802 @item Staccato y otras articulaciones y ornamentos
1803 @item Ligaduras de expresión y de fraseo
1804 @item Crescendi y decrescendi sobre una nota única
1805 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
1807 @item Acordes microtonales
1811 @node Repeticiones y MIDI
1812 @subsection Repeticiones y MIDI
1813 @translationof Repeats in MIDI
1815 @cindex repeticiones, expandir
1816 @funindex \unfoldRepeats
1818 Con un poco de trucaje, se puede hacer que cualquier tipo de
1819 repetición esté presente en la salida MIDI. Esto se consigue mediante
1820 la aplicación de la función musical @code{\unfoldRepeats}. Esta
1821 función cambia todas las repeticiones a repeticiones desplegadas.
1823 @lilypond[quote,verbatim]
1825 \repeat tremolo 8 {c'32 e' }
1826 \repeat percent 2 { c''8 d'' }
1827 \repeat volta 2 {c'4 d' e' f'}
1836 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
1837 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
1838 (con repeticiones desplegadas) y otro para la notación impresa (con
1839 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
1840 y percent --repetición de compases--). Por ejemplo,
1848 \unfoldRepeats @var{..música..}
1854 @node Control de los matices en el MIDI
1855 @subsection Control de los matices en el MIDI
1856 @translationof Controlling MIDI dynamics
1858 La dinámica en el MIDI está implementada por medio del intérprete
1859 Dynamic_performer que reside de forma predeterminada dentro del
1860 contexto Voice. Es posible controlar el volumen MIDI general, el
1861 volumen relativo de los matices dinámicos y el volumen relativo de los
1862 distintos instrumentos.
1864 @unnumberedsubsubsec Indicaciones dinámicas
1866 Los matices o indicaciones de dinámica se traducen a una fracción fija
1867 del rango de volumen MIDI disponible. Las fracciones predeterminadas
1868 se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
1869 @notation{fffff}. El conjunto de indicaciones dinámicas y las
1870 fracciones asociadas pueden verse en @file{../@/scm/@/midi.scm}, véase
1871 @rlearning{Otras fuentes de información}. Este conjunto de fracciones
1872 se puede cambiar o extender proporcionando una función que toma como
1873 argumento una indicación dinámica y devuelve la fracción requerida, y
1874 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
1877 Por ejemplo, si se requiere una indicación dinámica
1878 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
1879 predeterminado sobre el volumen MIDI, pues no está incluida en el
1880 conjunto predeterminado. De igual manera, si se define una indicación
1881 dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
1882 incluida en el conjunto predeterminado. El ejemplo siguiente muestra
1883 cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
1884 La función Scheme establece la fracción a 0.9 si se encuentra una
1885 indicación dinámica rfz, y en caso contrario llama a la función
1888 @lilypond[verbatim,quote]
1889 #(define (myDynamics dynamic)
1890 (if (equal? dynamic "rfz")
1892 (default-dynamic-absolute-volume dynamic)))
1896 \set Staff.midiInstrument = #"cello"
1897 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
1909 Como alternativa, si se necesitara redefinir la tabla completa de
1910 fracciones, sería mejor usar el procedimiento
1911 @notation{default-dynamic-absolute-volume} que aparece en
1912 @file{../@/scm/@/midi.scm} y la tabla asociada como modelo. El último
1913 ejemplo de esta sección muestra cómo se puede hacer esto.
1915 @unnumberedsubsubsec Volumen maestro MIDI
1917 El volumen general máximo y mínimo de las indicaciones dinámicas de
1918 MIDI se controla estableciendo valores para las propiedades
1919 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
1920 @code{Score}. Estas propiedades tienen efecto solamente sobre las
1921 indicaciones dinámicas, por ello si queremos que tengan validez desde
1922 el comienzo de la partitura, se debe colocar allí una indicación de
1923 dinámica. La fracción que corresponde a cada indicación dinámica se
1924 modifica con esta fórmula:
1927 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
1930 En el ejemplo siguiente, el rango de intensidad dinámica del volumen
1931 general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
1933 @lilypond[verbatim,quote]
1939 \set Staff.midiInstrument = #"flute"
1940 \new Voice \relative c''' {
1948 \set Staff.midiInstrument = #"clarinet"
1949 \new Voice \relative c'' {
1960 tempoWholesPerMinute = #(ly:make-moment 72 2)
1961 midiMinimumVolume = #0.2
1962 midiMaximumVolume = #0.5
1968 @unnumberedsubsubsec Balance entre instrumentos (i)
1970 Si las propiedades de volumen MIDI máximo y mínimo están establecidas
1971 en el contexto @code{Staff} se pueden controlar los volúmenes
1972 relativos de los instrumentos MIDI. Esto proporciona un ecualizador
1973 de instrumentos básico que puede realzar significativamente la calidad
1976 En este ejemplo se reduce el volumen del clarinete con relación al de
1977 la flauta. Debe haber una indicación dinámica en la primera nota de
1978 cada instrumento para que esto funcione correctamente.
1980 @lilypond[verbatim,quote]
1986 \set Staff.midiInstrument = #"flute"
1987 \set Staff.midiMinimumVolume = #0.7
1988 \set Staff.midiMaximumVolume = #0.9
1989 \new Voice \relative c''' {
1997 \set Staff.midiInstrument = #"clarinet"
1998 \set Staff.midiMinimumVolume = #0.3
1999 \set Staff.midiMaximumVolume = #0.6
2000 \new Voice \relative c'' {
2011 tempoWholesPerMinute = #(ly:make-moment 72 2)
2017 @unnumberedsubsubsec Balance entre instrumentos (i)
2019 Si las propiedades de volumen MIDI máximo y mínimo no están
2020 establecidas, de forma predeterminada LilyPond aplica un pequeño grado
2021 de ecualización a algunos instrumentos. Los instrumentos y la
2022 ecualización que se aplica se muestra en la tabla
2023 @notation{instrument-equalizer-alist} en @file{../@/scm/@/midi.scm}.
2025 El ecualizador básico predeterminado se puede sustituir estableciendo
2026 @code{instrumentEqualizer} en el contexto @code{Score} a un
2027 procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
2028 como único argumento y devuelva un par de fracciones que dan los
2029 volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
2030 sustitución se hace de la misma forma que mostramos para restablecer
2031 la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
2032 al comienzo de esta sección. El ecualizador predeterminado,
2033 @notation{default-instrument-equalizer}, en
2034 @file{../@/scm/@/midi.scm}, muestra cómo se puede escribir tal
2037 El ejemplo siguiente establece los volúmenes relativos de la flauta y
2038 del clarinete a los mismos valores que el ejemplo anterior.
2040 @lilypond[verbatim,quote]
2041 #(define my-instrument-equalizer-alist '())
2043 #(set! my-instrument-equalizer-alist
2046 ("flute" . (0.7 . 0.9))
2047 ("clarinet" . (0.3 . 0.6)))
2048 my-instrument-equalizer-alist))
2050 #(define (my-instrument-equalizer s)
2051 (let ((entry (assoc s my-instrument-equalizer-alist)))
2060 \set Score.instrumentEqualizer = #my-instrument-equalizer
2061 \set Staff.midiInstrument = #"flute"
2062 \new Voice \relative c''' {
2070 \set Staff.midiInstrument = #"clarinet"
2071 \new Voice \relative c'' {
2082 tempoWholesPerMinute = #(ly:make-moment 72 2)
2089 @c Delete when satisfied this is adequately covered elsewhere -td
2091 @n ode Microtones in MIDI
2092 @s ubsection Microtones in MIDI
2094 @cindex microtones in MIDI
2096 Microtones consisting of half sharps and half flats are exported
2097 to the MIDI file and render correctly in MIDI players which support
2098 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
2099 an example showing all the half sharps and half flats. It can be
2100 copied out and compiled to test microtones in your MIDI player.
2102 @lilypond[verbatim,quote]
2119 @node Percusión en MIDI
2120 @subsection Percusión en MIDI
2121 @translationof Percussion in MIDI
2123 La notación de los instrumentos de percusión se realiza normalmente en
2124 un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
2125 salida correctamente por el canal MIDI@tie{}10, pero ciertos
2126 instrumentos de percusión de altura determinada, como el xilófono,
2127 marimba, vibráfono, timbales, etc., se tratan como instrumentos
2128 @qq{normales} y la música para estos instrumentos se debe introducir
2129 en contextos de @code{Staff} normales, no en un contexto
2130 @code{DrumStaff}, para obtener la salida MIDI correcta.
2132 Ciertos sonidos de altura indeterminada que están incluidos en el
2133 estándar General MIDI, como el tom melódico, el tambor taiko, los
2134 tambores sintéticos, etc., no se pueden acceder a través del canal
2135 MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
2136 introducir también en un contexto normal de @code{Staff}, utilizando
2137 las alturas normales adecuadas.
2139 Muchos instrumentos de percusión no están incluidos dentro del
2140 estándar General MIDI, p.ej. las castañuelas. El método más
2141 fácil (aunque no satisfactorio) de producir una salida MIDI al
2142 escribir para estos instrumentos es sustituirlos por el sonido más
2143 parecido del conjunto estándar.
2145 @c TODO Expand with examples, and any other issues
2149 Debido a que el estándar General MIDI no contiene golpes de aro
2150 (@emph{rim shots}), para este propósito se utiliza en su lugar el
2151 golpe lateral de baqueta (@emph{sidestick}).