1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 46e1b0a15ecf324b3272645224f3a2b3068dce73
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @node General input and output
13 @chapter General input and output
15 Esta sección trata de asuntos relacionados con la entrada y salida
16 generales de LilyPond, más que con la notación específica.
20 * Titles and headers::
21 * Working with input files::
22 * Controlling output::
28 @section Input structure
30 El formato principal de entrada para LilyPond son archivos de texto.
31 Por convenio, el nombre de estos archivos termina en @code{.ly}.
34 * Structure of a score::
35 * Multiple scores in a book::
40 @node Structure of a score
41 @subsection Structure of a score
45 Un bloque @code{\score} debe contener una expresión musical única
46 delimitada por un par de llaves:
55 @warning{Sólo puede haber @strong{una} expresión musical dentro del
56 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
58 Esta expresión musical única puede tener cualquier tamaño, y puede
59 contener otras expresiones musicales hasta cualquier grado de
60 complejidad. Todos los siguientes ejemplos son expresiones musicales:
66 @lilypond[verbatim,quote]
73 @lilypond[verbatim,quote]
75 \new Staff { c'4 c' c' c' }
76 \new Staff { d'4 d' d' d' }
84 \new Staff @{ \flute @}
85 \new Staff @{ \oboe @}
88 \new Staff @{ \violinI @}
89 \new Staff @{ \violinII @}
95 Los comentarios son una excepción a esta regla general (para ver otras
96 excepciones, consulte @ref{File structure}). Tanto los comentarios de
97 una línea como los que están delimitados por @code{%@{ .. %@}} se
98 pueden escribir en cualquier lugar dentro del archivo de entrada. Se
99 pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
100 fuera de la expresión musical única dentro del bloque @code{\score}.
104 Manual de aprendizaje:
105 @rlearning{Working on input files},
106 @rlearning{Music expressions explained},
107 @rlearning{Score is a (single) compound musical expression}.
110 @node Multiple scores in a book
111 @subsection Multiple scores in a book
114 @cindex movimientos, varios
116 Un documento puede contener varias piezas de música y texto. Son
117 ejemplos un libro de estudios o una parte orquestal con varios
118 movimientos. Cada movimiento se introduce con un bloque
127 y los textos se introducen con un bloque @code{\markup}:
137 Todos los movimientos y textos que aparecen en el mismo archivo
138 @code{.ly} se tipografían normalmente en la forma de un solo archivo
153 Sin embargo, si queremos varios archivos de salida a partir del mismo
154 archivo @code{.ly}, podemos escribir varios bloques @code{\book},
155 donde cada uno de estos bloques @code{\book} dará como resultado un
156 archivo de salida distinto. Si no especificamos ningún bloque
157 @code{\book} en el archivo,, LilyPond trata implícitamente todo el
158 archivo como un solo bloque @code{\book}, véase @ref{File structure}.
159 Una excepción importante se da dentro de los documentos de
160 lilypond-book, en los que tenemos que escribir explícitamente un
161 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
162 salida el primer @code{\score} o @code{\markup}.
164 El encabezamiento de cada pieza se puede poner dentro del bloque
165 @code{\score}. Antes de cada movimiento, se imprime el nombre de la
166 pieza (@code{piece}) extraído del encabezamiento. El título del libro
167 entero se puede poner dentro del bloque @code{\book}, pero si no está
168 presente se inserta el encabezamiento @code{\header} que está al
169 principio del archivo.
173 title = "Ocho miniaturas"
174 composer = "Igor Stravinsky"
178 \header @{ piece = "Romanze" @}
181 ..texto de la segunda estrofa..
184 ..texto de la tercera estrofa..
188 \header @{ piece = "Menuetto" @}
195 Se pueden agrupar distintas piezas de música en partes de un libro
196 utilizando bloques @code{\bookpart}. Las partes de libro se separan
197 por medio de saltos de página, y pueden dar comienzo con un título,
198 como el libro propiamente dicho, mediante la especificación del bloque
204 title = "Título del libro"
205 subtitle = "Primera parte"
212 subtitle = "Segunda parte"
221 @subsection File structure
231 Un archivo @code{.ly} puede contener cualquier número de expresiones
232 del nivel superior, donde una expresión del nivel superior es una de
233 las siguientes posibilidades:
237 Una definición de salida, como @code{\paper}, @code{\midi} y
238 @code{\layout}. Tal definición en el nivel más alto cambia los
239 ajustes predeterminados para todo el libro. Si se introduce más de
240 una de estas definiciones del mismo tipo en el nivel más alto,
241 cualquier definición en una expresión posterior tiene prioridad.
244 Una expresión directa de Scheme, como
245 @code{#(set-default-paper-size "a7" 'landscape)} o
246 @code{#(ly:set-option 'point-and-click #f)}.
249 Un bloque @code{\header}. Esto establece el bloque de encabezamiento
250 global. Es el bloque que contiene las definiciones de los ajustes
251 para todo el libro, como el compositor, título, etc.
254 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
255 del nivel superior, y se combina con ellas formando un @code{\book}
256 (libro) único. Este comportamiento se puede cambiar estableciendo el
257 valor de la variable @code{toplevel-score-handler} en el nivel
258 superior. El @emph{handler} predeterminado se define en el archivo de
259 inicio @file{../scm/@/lily@/.scm}.
262 Un bloque @code{\book} combina lógicamente varios movimientos (es
263 decir, varios bloques @code{\score}) en un solo documento. Si hay
264 varias partituras @code{\score}, se crea un solo archivo de salida
265 para cada bloque @code{\book}, en el que se concatenan todos los
266 movimientos correspondientes. La única razón para especificar
267 explícitamente bloques @code{\book} en un archivo de entrada
268 @code{.ly} es si queremos crear varios archivos de salida a partir de
269 un único archivo de entrada. Una excepción se da dentro de los
270 documentos de lilypond-book, en los que tenemos que escribir
271 explícitamente un bloque @code{\book} si queremos tener más de una
272 única partitura @code{\score} o marcado @code{\markup} en el mismo
273 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
274 de la variable @code{toplevel-book-handler} en el nivel superior. El
275 @emph{handler} predeterminado se define en el archivo de inicio
276 @file{../scm/@/lily@/.scm}.
279 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
280 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
281 la inserción de saltos de página o usar distintos ajustes de
282 @code{\paper} en las distintas partes.
285 Una expresión musical compuesta, como
290 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
291 único junto a todas las demás partituras @code{\score} y expresiones
292 musicales del nivel superior. En otras palabras, un archivo que
293 contiene sólo la expresión musical anterior se traduce a
309 Se puede cambiar este comportamiento estableciendo el valor de la
310 variable @code{toplevel-music-handler} en el nivel más alto. El
311 @emph{handler} predeterminado se define en el archivo de inicio
312 @file{../scm/@/lily@/.scm}.
315 Un texto de marcado, por ejemplo una estrofa
318 2. Estrofa dos, línea uno
322 Los textos de marcado se colocan encima, en medio o debajo de las
323 partituras o expresiones musicales, según donde aparezcan escritos.
330 fulano = @{ c4 d e d @}
333 Esto se puede utilizar más tarde en el archivo escribiendo
334 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
335 alfabético; sin números, guiones ni barras bajas.
339 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
344 % No justificar la salida
355 En cualquier punto del archivo se pueden introducir cualquiera de las
356 instrucciones léxicas siguientes:
359 @item @code{\version}
360 @item @code{\include}
361 @item @code{\sourcefilename}
362 @item @code{\sourcefileline}
364 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
367 Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
371 @cindex espacios en blanco
373 Por lo general se ignoran los espacios entre elementos del flujo de
374 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
375 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
376 evitar errores, en las siguientes situaciones:
379 @item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
380 @item A continuación de las instrucciones y variables, es decir, todos los elementos
381 que comienzan con un signo @code{\} de barra invertida.
382 @item A continuación de todo elemento que se deba interpretar como expresión
383 de Scheme, es decir, todo elemento que comience por un signo @code{#}.
384 @item Para separar los elementode de una expresión de Scheme.
385 @item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
386 @code{\override} y @code{\set}. Concretamente, hay que usar espacios
387 alrededor del punto y el signo igual en instrucciones como
388 @code{\override Score . LyricText #'font-size = #5} y antes y después
389 de la instrucción completa.
394 Manual de aprendizaje:
395 @rlearning{How LilyPond input files work}.
398 @node Titles and headers
399 @section Titles and headers
401 Casi toda la música impresa tiene un título y el nombre del
402 compositor; ciertas piezas tienen mucha más información.
407 * Reference to page numbers::
408 * Table of contents::
412 @node Creating titles
413 @subsection Creating titles
415 Se crean títulos para cada uno de los bloques @code{\score} así como
416 para todo el archivo de entrada (o bloque @code{\book}, libro) y las
417 partes de libro (creadas mediante bloques @code{\bookpart}).
419 El contenido de cada título se extrae a partir de los bloques
420 @code{\header} (cabecera). El bloque de cabecera de un libro
421 contempla lo siguiente:
424 @funindex dedicatoria
426 El dedicatario de la música, centrado en lo alto de la primera página.
430 El título de la música, centrado justo debajo de la
435 Subtítulo, centrado debajo del título.
437 @funindex subsubtitle
439 Sub-subtítulo, centrado debajo del subtítulo.
443 Nombre del poeta, a la izquierda, debajo del subtítulo.
447 Nombre del compositor, a la derecha, debajo del subtítulo.
451 Texto de la medida, a la izquierda, debajo del poeta.
455 Nombre del Opus, a la derecha, debajo del compositor.
459 Nombre del arreglista, a la derecha, debajo del Opus.
463 Nombre del instrumento, centrado, debajo del arreglista. También
464 aparece centrado en lo alto de cada página (aparte de la primera).
468 Nombre de la pieza, a la izquierda, debajo del instrumento.
470 @cindex página, saltos, forzar
471 @funindex breakbefore
473 Esto fuerza que el título comience sobre una página nueva (establézcalo a ##t o a ##f).
477 Aviso de Copyright, centrado en la parte inferior de la primera
478 página. Para insertar el símbolo de copyright, consulte
483 Cartel de propósito general en el pie de página, centrado al final de la última.
487 A continuación presentamos una demostración de todos los campos que
488 están disponibles. Fíjese en que puede utilizar en la cabecera
489 cualquier instrucción de marcado de texto (Véase @ref{Formatting text}).
491 @lilypond[quote,verbatim,line-width=11.0\cm]
494 paper-height = 10.0\cm
499 dedication = "dedicated to me"
500 title = \markup \center-column { "Title first line" "Title second line,
502 subtitle = "the subtitle,"
503 subsubtitle = #(string-append "subsubtitle LilyPond version "
506 composer = \markup \center-column { "composer" \small "(1847-1973)" }
507 texttranslator = "Text Translator"
508 meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
510 arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
511 #-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "nger" }
512 instrument = \markup \bold \italic "instrument"
536 Como se mostró anteriormente, puede usar varios bloques
537 @code{\header}. Cuando los mismos campos aparecen en distintos
538 bloques, tiene validez el último en definirse. A continuación un
543 composer = "Compositor"
551 piece = "Otra pieza" % sobreescribe a la anterior
556 Si define la cabecera @code{\header} dentro del bloque @code{\score},
557 por lo general se imprimirán solamente las cabeceras @code{piece} y
558 @code{opus}. Fíjese en que la expresión musical debe aparecer antes
561 @lilypond[quote,verbatim,line-width=11.0\cm]
565 title = "title" % not printed
572 @funindex print-all-headers
574 Se puede cambiar este comportamiento (e imprimir todas las cabeceras
575 cuando la cabecera @code{\header} está definida dentro del bloque
576 @code{\score}) mediante la utilización de
580 print-all-headers = ##t
587 El pie de página por omisión se encuentra vacío, excepto para la
588 primera página, en la que se inserta el campo de @code{copyright}
589 extraído del @code{\header}, y para la última página, en la que se
590 escribe el cartel @code{tagline} sacado del bloque @code{\header}. La
591 línea por omisión para este cartel es @qq{Music engraving by LilyPond
592 (@var{version})}.@footnote{Las partituras bien tipografiadas son una
593 magnífica promoción para nosotros, así que por favor, si puede,
594 conserve intacta la línea del letrero.}
596 Las cabeceras se pueden quitar completamente estableciendo su valor a
608 @subsection Custom titles
610 Una opción más avanzada es cambiar las definiciones de las variables
611 siguientes dentro del bloque @code{\paper}. El archivo de
612 inicio @file{ly/titling-init.ly} ofrece un listado de la disposición
616 @funindex bookTitleMarkup
617 @item bookTitleMarkup
618 Es el título que se escribe en lo alto del documento de salida
619 completo. Normalmente contiene el compositor y el título de la pieza.
621 @funindex scoreTitleMarkup
622 @item scoreTitleMarkup
623 Es el título que se coloca por encima de un bloque @code{\score}.
624 normalmente contiene el nombre del movimiento (campo @code{piece}).
626 @funindex oddHeaderMarkup
627 @item oddHeaderMarkup
628 Es el encabezamiento de las páginas de numeración impar.
630 @funindex evenHeaderMarkup
631 @item evenHeaderMarkup
632 Es el encabezamiento de las páginas de numeración par. Si se deja
633 sin especificar, se usará el encabezamiento de las páginas impares.
635 De forma predeterminada, los encabezamientos se definen de tal forma
636 que el número de página está en el borde exterior, y el instrumento
639 @funindex oddFooterMarkup
640 @item oddFooterMarkup
641 Es el pie de las páginas de numeración impar.
643 @funindex evenFooterMarkup
644 @item evenFooterMarkup
645 Es el pie de las páginas de numeración par. Si se deja sin
646 especificar, se usará en su lugar el encabezamiento de las páginas
649 De forma predeterminada, el pie de página tiene el aviso de
650 copyright en la primera página, y el cartel @code{tagline} en la
656 @cindex encabezamiento
659 @cindex disposición de la página
662 La definición siguiente pone el título en el extremo izquierdo, y el
663 compositor en el extremo derecho sobre una única línea.
667 bookTitleMarkup = \markup {
669 \fromproperty #'header:title
670 \fromproperty #'header:composer
676 @node Reference to page numbers
677 @subsection Reference to page numbers
679 Se puede marcar un lugar determinado de una partitura utilizando la
680 instrucción @code{\label} (etiqueta), bien en lo alto de la estructura
681 o bien dentro de la música. Posteriormente se puede hacer referencia
682 a esta etiqueta dentro de un elemento de marcado, para obtener el
683 número de la página en que se encuentra la marca, usando la
684 instrucción de marcado @code{\page-ref}.
686 @lilypond[verbatim,line-width=11.0\cm]
687 \header { tagline = ##f }
693 \pageBreak \mark A \label #'markA
698 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
699 \markup { Mark A is on page \page-ref #'markA "0" "?" }
703 La instrucción de marcado @code{\page-ref} toma tres argumentos:
705 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
706 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
707 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
710 El motivo de que se necesite un medidor es que en el momento en que se
711 están interpretando los marcados, los saltos de página aún no se han
712 producido y por tanto los números de página no se conocen todavía.
713 Para sortear este inconveniente, la interpretación real del marcado se
714 retrasa hasta un momento posterior; sin embargo, las dimensiones del
715 marcado se tienen que conocer de antemano, así que se usa el medidor
716 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
717 páginas, el medidor puede ser "00", es decir, un número de dos
729 @node Table of contents
730 @subsection Table of contents
732 Se puede insertar un índice general o tabla de contenidos utilizando
733 la instrucción @code{\markuplines \table-of-contents}. Los elementos
734 que deben aparecer en la tabla de contenidos se introducen con la
735 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
736 la jerarquía del código, o dentro de una expresión musical.
739 \markuplines \table-of-contents
742 \tocItem \markup "Primera partitura"
746 \tocItem \markup "Un punto concreto dentro de la primera partitura"
751 \tocItem \markup "Segunda partitura"
759 Los elementos de marcado que se usan para dar formato al índice
760 general se encuentran definidos dentro del bloque @code{\paper}. Los
761 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
762 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
763 los elementos del índice, que consisten en el título del elemento y el
764 número de página. Estas variables se pueden cambiar por parte del
769 %% Traducir el título del índice al español:
770 tocTitleMarkup = \markup \huge \column {
771 \fill-line { \null "Índice general" \null }
774 %% usar una fuente mayor
775 tocItemMarkup = \markup \large \fill-line {
776 \fromproperty #'toc:text \fromproperty #'toc:page
781 Observe la forma en que nos referimos al texto y al número de página
782 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
784 También se pueden definir nuevas instrucciones y elementos de
785 marcado para crear índices generales más elaborados:
787 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
788 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
789 utilizando esta variable de marcado del bloque @code{\paper}.
792 En el ejemplo siguiente se define un estilo nuevo para introducir los
793 nombres de los actos de una ópera en el índice general:
797 tocActMarkup = \markup \large \column {
799 \fill-line { \null \italic \fromproperty #'toc:text \null }
805 #(define-music-function (parser location text) (markup?)
806 (add-toc-item! 'tocActMarkup text))
809 @lilypond[line-width=11.0\cm]
810 \header { tagline = ##f }
812 tocActMarkup = \markup \large \column {
814 \fill-line { \null \italic \fromproperty #'toc:text \null }
820 #(define-music-function (parser location text) (markup?)
821 (add-toc-item! 'tocActMarkup text))
824 \markuplines \table-of-contents
825 \tocAct \markup { Atto Primo }
826 \tocItem \markup { Coro. Viva il nostro Alcide }
827 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
828 \tocAct \markup { Atto Secondo }
829 \tocItem \markup { Sinfonia }
830 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
838 @file{ly/@/toc@/-init@/.ly}.
842 @funindex \table-of-contents
843 @code{\table-of-contents},
849 @node Working with input files
850 @section Working with input files
853 * Including LilyPond files::
854 * Different editions from one source::
856 * Displaying LilyPond notation::
860 @node Including LilyPond files
861 @subsection Including LilyPond files
864 @cindex including files
866 Un proyecto grande se puede dividir en varios archivos. Para
867 referirse a otro archivo, utilice
870 \include "otroarchivo.ly"
873 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
874 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
875 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
876 podríamos querer archivos distintos para cada parte instrumental y
877 crear un archivo de @qq{partitura completa} que reúne los archivos
878 individuales de los instrumentos. Normalmente el archivo incluido
879 define un cierto número de variables que a partir de entonces quedan
880 disponibles para poderlas utilizar en el archivo de la partitura
881 completa. En los archivos incluidos se pueden marcar las secciones
882 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
883 la partitura, véase @ref{Different editions from one source}.
885 Los archivos que están en el directorio de trabajo actual se pueden
886 referenciar simplemente especificando el nombre después de la
887 instrucción @code{\include}. Los archivos en otros lugares se pueden
888 incluir proporcionando una referencia de ruta completa o una ruta
889 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
890 barra invertida de DOS/Windows, \, como separador de directorio). Por
891 ejemplo, si @file{material.ly} está situado un directorio por encima
892 del directorio de trabajo actual, utilice
895 \include "../material.ly"
899 o si los archivos de las partes orquestales incluidas están todos
900 situados en un subdirectorio llamado @file{partes} dentro del
901 directorio actual, use
904 \include "partes/VI.ly"
905 \include "partes/VII.ly"
909 Los archivos de inclusión también pueden contener enunciados
910 @code{\include} a su vez. De forma predeterminada, estos enunciados
911 @code{\include} de segundo nivel no se interpretan hasta que se
912 incorporan al archivo principal, por lo que los nombres de archivo que
913 especifican deben ser relativos al directorio que contiene el archivo
914 principal, no al directorio que contiene el archivo incluido. Sin
915 embargo, este comportamiento se puede modificar pasando la opción
916 @code{-drelative-includes} en la línea de órdenes (o mediante la
917 adición de @code{#(ly:set-option 'relative-includes #t)} al principio
918 del archivo principal de entrada). Con el valor de
919 @code{relative-includes} establecido, la ruta de cada instrucción
920 @code{\include} se considera relativa al archivo que contiene dicha
921 instrucción. Este comportamiento es el recomendado y se convertirá en
922 el comportamiento predeterminado en una versión futura de lilypond.
924 También se pueden incluir archivos de un directorio que está en una
925 ruta de búsqueda especificada como opción al invocar a LilyPond desde
926 la línea de órdenes. Los archivos incluidos se especifican usando
927 solamente su nombre de archivo. Por ejemplo, para compilar mediante
928 este método un archivo @file{principal.ly} que incluye archivos
929 situados en un subdirectorio llamado @file{partes}, cambie al
930 directorio que contiene @file{principal.ly} e introduzca
933 lilypond --include=partes principal.ly
936 y en @file{principal.ly} escriba
944 Los archivos que se incluyen en muchas partituras se pueden poner en
945 el directorio de LilyPond @file{../ly} (la localización de este
946 directorio depende de la instalación: véase
947 @rlearning{Other sources of information}). Estos archivos se pueden
948 incluir sencillamente por su nombre en un enunciado @code{\include}.
949 De esta forma se incluyen los archivos dependientes del idioma como
952 LilyPond incluye de forma predeterminada ciertos archivos cuando se
953 inicia el programa. Estas inclusiones no son visibles para el
954 usuario, pero los archivos se pueden identificar ejecutando
955 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
956 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
957 otras indicaciones. De forma alternativa, pueden verse explicaciones
958 sobre los archivos más importantes de este conjunto en
959 @rlearning{Other sources of information}. Estos archivos se pueden
960 editar, pero los cambios realizados sobre ellos se perderán al
961 instalar una nueva versión de LilyPond.
963 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
964 @rlearning{Scores and parts}.
968 Manual de aprendizaje:
969 @rlearning{Other sources of information},
970 @rlearning{Scores and parts}.
975 Si un archivo incluido recibe un nombre igual al de uno de los
976 archivos de instalación de LilyPond, el archivo que tiene prioridad es
977 el de los archivos de instalación de LilyPond.
980 @node Different editions from one source
981 @subsection Different editions from one source
983 Se encuentran disponibles varios mecanismos para facilitar la
984 producción de distintas versiones de una partitura a partir de la
985 misma fuente musical. Las variables son quizá más útiles para
986 combinar secciones extensas de música y/o anotaciones de diversas
987 formas, mientras que las etiquetas son más útiles para seleccionar una
988 de entra varias secciones de música más cortas. Cualquiera que sea el
989 método utilizado, la separación de la notación de la estructura de la
990 partitura hará que sea más fácil cambiar la estructura dejando intacta
998 @node Using variables
999 @unnumberedsubsubsec Using variables
1001 @cindex variables, uso de las
1003 Si las secciones de la música se definen dentro de variables, se
1004 pueden reutilizar en distintas partes de la partitura, véase
1005 @rlearning{Organizing pieces with variables}. Por ejemplo, una
1006 partitura vocal @notation{a cappella} con frecuencia incluye una
1007 reducción de piano de las partes para ensayar que es idéntica a la
1008 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
1009 puede combinar sobre un solo pentagrama la música de dos variables,
1010 véase @ref{Automatic part combining}. He aquí un ejemplo:
1012 @lilypond[verbatim,quote]
1013 sopranoMusic = \relative c'' { a4 b c b8( a)}
1014 altoMusic = \relative g' { e4 e e f }
1015 tenorMusic = \relative c' { c4 b e d8( c) }
1016 bassMusic = \relative c' { a4 gis a d, }
1017 allLyrics = \lyricmode {King of glo -- ry }
1019 \new Staff = "Soprano" \sopranoMusic
1020 \new Lyrics \allLyrics
1021 \new Staff = "Alto" \altoMusic
1022 \new Lyrics \allLyrics
1023 \new Staff = "Tenor" {
1027 \new Lyrics \allLyrics
1028 \new Staff = "Bass" {
1032 \new Lyrics \allLyrics
1035 \set Staff.printPartCombineTexts = ##f
1041 \set Staff.printPartCombineTexts = ##f
1051 Se pueden producir partituras distintas que presenten sólo las partes
1052 vocales o sólo la parte de piano, cambiando solamente los enunciados
1053 estructurales, sin modificar la notación musical.
1055 Para partituras extensas, las definiciones de variable se pueden poner
1056 en archivos separados que se incluyen más tarde, véase @ref{Including
1061 @unnumberedsubsubsec Using tags
1064 @funindex \keepWithTag
1065 @funindex \removeWithTag
1067 @cindex mantener música etiquetada
1068 @cindex quitar música etiquetada
1070 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
1071 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
1072 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
1073 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
1074 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
1075 música etiquetada es como sigue:
1077 @multitable @columnfractions .5 .5
1081 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
1083 Se incluye la música no etiquetada y la música etiquetada con
1084 @var{nombre}; se excluye la música etiquetada con cualquier otro
1087 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
1089 Se incluye la música no etiquetada y la música etiquetada con
1090 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
1091 música etiquetada con @var{nombre}.
1093 Música etiquetada no precedida de @code{\keepWithTag} ni de
1094 @code{\removeWithTag}
1095 @tab Se incluye toda la música etiquetada y no etiquetada.
1098 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
1099 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
1100 @code{#'parte}), seguido de una expresión musical.
1102 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
1103 que muestra trinos con la notación usual y otra con los trinos
1104 expandidos explícitamente:
1106 @lilypond[verbatim,quote]
1107 music = \relative g' {
1109 \tag #'trills {d8.\trill }
1110 \tag #'expand {\repeat unfold 3 {e32 d} }
1115 \keepWithTag #'trills \music
1118 \keepWithTag #'expand \music
1123 De forma alternativa, a veces es más fácil excluir secciones de música:
1125 @lilypond[verbatim,quote]
1126 music = \relative g' {
1128 \tag #'trills {d8.\trill }
1129 \tag #'expand {\repeat unfold 3 {e32 d} }
1134 \removeWithTag #'expand
1138 \removeWithTag #'trills
1143 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
1147 -\tag #'@var{mi-etiqueta}
1150 a una articulación. Por ejemplo, esto define una nota con una
1151 indicación opcional de digitación y una nota con una anotación
1156 c1-\tag #'warn ^"¡Ojo!"
1159 Se pueden poner varias etiquetas sobre expresiones con varias entradas
1162 @lilypond[quote,verbatim]
1163 music = \relative c'' {
1164 \tag #'a \tag #'both { a a a a }
1165 \tag #'b \tag #'both { b b b b }
1168 \keepWithTag #'a \music
1169 \keepWithTag #'b \music
1170 \keepWithTag #'both \music
1174 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
1175 expresión musical para quitar varias secciones etiquetadas con nombres
1178 @lilypond[verbatim,quote]
1179 music = \relative c'' {
1180 \tag #'A { a a a a }
1181 \tag #'B { b b b b }
1182 \tag #'C { c c c c }
1183 \tag #'D { d d d d }
1192 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
1193 musical producen la eliminación de @emph{todas} las secciones
1194 etiquetadas, porque el primer filtro quita todas las secciones
1195 etiquetadas excepto la que se nombra, y el segundo filtro elimina
1196 incluso esa sección etiquetada.
1200 Manual de aprendizaje:
1201 @rlearning{Organizing pieces with variables}.
1203 Referencia de la notación:
1204 @ref{Automatic part combining},
1205 @ref{Including LilyPond files}.
1209 @c This warning is more general than this placement implies.
1210 @c Rests are not merged whether or not they come from tagged sections.
1211 @c Should be deleted? -td
1216 Multiple rests are not merged if you create a score with more
1217 than one tagged section at the same place.
1222 @subsection Text encoding
1224 LilyPond usa el conjunto de caracteres definido por el consorcio
1225 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
1226 para los conjuntos de caracteres que se utilizan en prácticamente
1227 todos los idiomas modernos y también en muchos otros. Unicode se
1228 puede implementar utilizando varios esquemas de codificación
1229 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
1230 @emph{Unicode Transformation Format}, o formato de transformación de
1231 Unicode) que representa todos los caracteres comunes de Latin en un
1232 solo byte, y representa otros caracteres usando un formato de longitud
1233 variable de hasta cuatro bytes.
1235 El aspecto visual real de los caracteres viene determinado por los
1236 glifos que se definen en las fuentes tipográficas concretas que se
1237 tengan disponibles: una fuente tipográfica define la asignación de un
1238 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
1239 biblioteca Pango para representar y disponer tipográficamente textos
1242 LilyPond no realiza ninguna conversión en la codificación de la
1243 entrada. Esto significa que cualquier text, ya sea el título, la
1244 letra de la canción o una instrucción musical que contenga caracteres
1245 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
1246 forma más fácil de escribir dicho texto es utilizar un editor
1247 preparado para Unicode y guardar el archivo con la codificación UTF-8.
1248 Casi todos los editores modernos populares contemplan el UTF-8, por
1249 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
1250 Windows posteriores a NT usan Unicode como codificación de caracteres
1251 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
1252 puede editar y guardar un archivo en el formato UTF-8. Una
1253 alternativa más funcional para Windows es BabelPad.
1255 Si un archivo de entrada que contiene un carácter que no es ASCII, no
1256 se guarda en el formato UTF-8, se genera el mensaje de error
1259 FT_Get_Glyph_Name () error: argumento inválido
1262 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
1265 %c No verbatim here as the code does not display correctly in PDF
1267 bulgarian = \lyricmode {
1268 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1272 hebrew = \lyricmode {
1273 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1277 portuguese = \lyricmode {
1278 à vo -- cê uma can -- ção legal
1284 \addlyrics { \bulgarian }
1285 \addlyrics { \hebrew }
1286 \addlyrics { \portuguese }
1289 Para introducir un carácter aislado para el que se conoce el punto de
1290 código Unicode pero no está disponible en el editor que se está
1291 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
1292 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
1293 del carácter en cuestión y @code{dddd} es su valor decimal
1294 correspondiente. Pueden omitirse los ceros iniciales, pero es
1295 costumbre indicar los cuatro caracteres en la representación
1296 hexadecimal (observe que @emph{no} debe utilizarse la codificación
1297 UTF-8 del punto de código Unicode después de @code{\char}, pues la
1298 codificación UTF-8 contiene bits adicionales que indican el número de
1301 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
1302 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
1303 @qq{Letra griega Xi pequeña}.
1305 Se puede escribir de esta forma cualquier punto de código Unicode, y
1306 si todos los caracteres especiales se escriben en este formato no es
1307 necesario guardar el archivo de entrada en formato UTF-8. Por
1308 supuesto, debe estar instalada y estar disponible para LilyPond una
1309 fuente tipográfica que contenga codificados todos estos caracteres.
1311 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
1312 en cuatro lugares: en una llamada de ensayo, como texto de
1313 articulación, en la letra y como texto independiente bajo la
1316 @lilypond[quote,verbatim]
1319 c1 \mark \markup { \char ##x03EE }
1320 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1322 \addlyrics { O \markup { \concat{ Ph \char ##x0153 be! } } }
1324 \markup { "Copyright 2008--2009" \char ##x00A9 }
1327 Para escribir el símbolo de copyright en la nota de créditos, utilice:
1331 copyright = \markup @{ \char ##x00A9 "2008" @}
1336 @node Displaying LilyPond notation
1337 @subsection Displaying LilyPond notation
1339 @funindex \displayLilyMusic
1340 La impresión textual de una expresión musical en notación de LilyPond
1341 puede hacerse usando la función musical @code{\displayLilyMusic}. Por
1346 \displayLilyMusic \transpose c a, @{ c e g a bes @}
1353 @{ a, cis e fis g @}
1356 De forma predeterminada, LilyPond imprime estos mensajes en la consola
1357 junto al resto de los mensajes. Para discernir entre estos mensajes y
1358 guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
1359 salida hacia un archivo.
1361 @c TODO What happens under Windows?
1364 lilypond archivo.ly >resultado.txt
1369 @node Controlling output
1370 @section Controlling output
1373 * Extracting fragments of music::
1374 * Skipping corrected music::
1377 @node Extracting fragments of music
1378 @subsection Extracting fragments of music
1380 Es posible citar pequeños fragmentos de una partitura grande
1381 directamente a partir de la salida. Puede compararse con la
1382 separación de una pieza de una partitura, recortándola con tijeras.
1384 Esto se hace definiendo los compases que se deben recortar. Por
1385 ejemplo, la inclusión de la siguiente definición
1392 (make-rhythmic-location 5 1 2)
1393 (make-rhythmic-location 7 3 4)))
1398 extrae un fragmento empezando por la mitad del quinto compás y
1399 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
1400 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
1401 después de tres negras del compás 7.
1403 Se pueden definir más zonas de recorte añadiendo más parejas de
1404 definición de tiempo rhythmic-location a la lista.
1406 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
1407 la opción @code{-dclip-systems}. Los recortes aparecen en la salida
1408 como archivos EPS, y se convierten en PDF y PNG si estos formatos
1409 también están activados.
1411 Para ver más información sobre los formatos de salida, consulte
1412 @rprogram{Invoking lilypond}.
1415 @node Skipping corrected music
1416 @subsection Skipping corrected music
1418 @funindex skipTypesetting
1419 @funindex showFirstLength
1420 @funindex showLastLength
1422 Al escribir o copiar música, normalmente sólo es interesante de ver y
1423 corregir la música cercana al final (donde estamos añadiendo las
1424 notas). Para acelerar este proceso de corrección, es posible saltar
1425 la composición tipográfica de todos excepto unos pocos de los últimos
1426 compases. Esto se consigue poniendo
1429 showLastLength = R1*5
1434 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
1435 cinco compases (suponiendo un compás de 4/4) de cada una de las
1436 partituras @code{\score} del archivo de entrada. Para piezas largas,
1437 el tipografiado de únicamente una parte pequeña es con frecuencia un
1438 orden de magnitud más rápido que el de la obra completa. Si estamos
1439 trabajando sobre el principio de una partitura que ya hemos
1440 tipografiado (p.ej., para añadir una parte instrumental nueva),
1441 también puede ser útil la propiedad @code{showFirstLength}.
1443 Este mecanismo de pasar por alto partes de un partitura se puede
1444 controlar con un grano más fino mediante la propiedad
1445 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
1446 lleva a cabo ningún tipografiado en absoluto.
1448 Esta propiedad se usa también para controlar la salida al archivo
1449 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
1450 y los cambios de instrumento. Está usted advertido.
1452 @lilypond[quote,fragment,ragged-right,verbatim]
1455 \set Score.skipTypesetting = ##t
1457 \set Score.skipTypesetting = ##f
1461 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
1462 voces y pentagramas, ahorrando más tiempo incluso.
1466 @section MIDI output
1471 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
1472 Instrumentos Musicales) es un estándar para interconectar y controlar
1473 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
1474 una serie de notas dentro de un conjunto de pistas. No es un archivo
1475 de sonidos reales; se necesita un programa reproductor especial para
1476 traducir la serie de notas en sonidos de verdad.
1478 Cualquier música se puede convertir a archivos MIDI, de manera que
1479 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
1480 para comprobar la corrección de la música; las octavas equivocadas o
1481 las alteraciones erróneas se ponen de relieve muy claramente al
1482 escuchar la salida MIDI.
1485 La salida MIDI reserva un canal por cada pentagrama, y otro para los
1486 ajustes globales. Por ello, el archivo MIDI no debe tener más de 15
1487 pautas (o 14 si no se usa la percusión). Otros pentagramas permanecen
1491 * Creating MIDI files::
1493 * What goes into the MIDI output?::
1495 * Controlling MIDI dynamics::
1496 * Percussion in MIDI::
1499 @node Creating MIDI files
1500 @subsection Creating MIDI files
1502 Para crear un MIDI a partir de una pieza de música, escriba un bloque
1503 @code{\midi} en la partitura, por ejemplo:
1512 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
1513 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
1514 necesita una notación impresa, debe haber también un bloque
1525 Se traducen correctamente a la salida MIDI la altura y duración de las
1526 notas, las ligaduras de unión, matices y cambios de tempo. Las
1527 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
1528 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
1529 del rango de volumen MIDI disponible. Los crescendi y decrescendi
1530 hacen que el volumen varía linealmente entre sus dos extremos. El
1531 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
1532 eliminar por completo, véase @ref{MIDI block}.
1534 El tempo inicial y los cambios de tempo posteriores se pueden
1535 especificar utilizando la instrucción @code{\tempo} dentro de la
1536 propia notación musical. Se reflejan en cambios de tempo en la salida
1537 MIDI. Esta instrucción normalmente hace que se imprima la indicación
1538 metronómica, pero esto se puede eliminar, véase @ref{Metronome marks}.
1539 Más abajo se describe una forma alternativa de especificar el tempo
1540 MIDI inicial o global, véase @ref{MIDI block}.
1542 Debido a ciertas limitaciones de Windows, la extensión predeterminada
1543 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
1544 operativos utilizan la extensión @code{.midi}. Si prefiere una
1545 extensión diferente, inserte la siguiente línea en el nivel jerárquico
1546 superior del archivo de entrada, antes del inicio de cualquier bloque
1547 @code{\book}, @code{\bookpart} o @code{\score}:
1550 #(ly:set-option 'midi-extension "midi")
1553 La línea anterior establece la extensión predeterminada para los
1554 archivos MIDI a @code{.midi}.
1556 De forma alternativa, esta opción se puede también proporcionar en la
1560 lilypond … -dmidi-extension=midi archivoLily.ly
1564 @unnumberedsubsubsec Instrument names
1566 @cindex instrumento, nombres de
1567 @funindex Staff.midiInstrument
1569 El nombre del instrumento MIDI se establece mediante la propiedad
1570 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
1571 de entre los que están en la lista que aparece en @ref{MIDI
1576 \set Staff.midiInstrument = #"glockenspiel"
1582 \new Staff \with @{midiInstrument = #"cello"@} @{
1587 Si el instrumento elegido no coincide exactamente con uno de los
1588 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
1589 Piano de Cola (@code{"acoustic grand"}).
1593 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
1594 {changing-midi-output-to-one-channel-per-voice.ly}
1598 @c In 2.11 the following no longer seems to be a problem -td
1600 Unterminated (de)crescendos will not render properly in the midi file,
1601 resulting in silent passages of music. The workaround is to explicitly
1602 terminate the (de)crescendo. For example,
1609 will not work properly but
1619 Los cambios del volumen MIDI sólo tienen lugar al principio de la
1620 nota, por lo que los crescendi y decrescendi no pueden afectar al
1621 volumen de una sola nota.
1623 No todos los reproductores de MIDI manejar adecuadamente los cambios de
1624 tempo de la salida MIDI. Entre los reproductores que se sabe que
1625 funcionan se encuentran el Reproductor de Medios de MS Windows y
1626 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
1630 @subsection MIDI block
1634 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
1635 dentro de un bloque de partitura. Es análogo al bloque layout de
1636 diseño de página, pero algo maś simple. Con frecuencia, el bloque
1637 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
1638 contextos, definiciones de contexto nuevas o código para fijar valores
1639 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
1640 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
1641 indicación de tempo:
1649 tempoWholesPerMinute = #(ly:make-moment 72 4)
1655 En este ejemplo, el tempo se establece a 72 pulsos de negra por
1656 minuto. Esta clase de especificación de tempo no puede tomar como
1657 argumento una figura con puntillo. Si necesitamos una figura con
1658 puntillo, dividimos la nota con puntillo en figuras más pequeñas. Por
1659 ejemplo, un tempo de 90 negras con puntillo por minuto se puede
1660 especificar como 270 corcheas por minuto:
1663 tempoWholesPerMinute = #(ly:make-moment 270 8)
1666 @cindex MIDI, definiciones de contexto
1668 Las definiciones de contexto siguen con precisión la misma sintaxis
1669 que la de un bloque @code{\layout}. Los módulos de traducción para el
1670 sonido reciben el nombre de ejecutantes. Los contextos para la salida
1671 MIDI se definen en @file{../ly/@/performer@/-init@/.ly}, véase
1672 @rlearning{Other sources of information}. Por ejemplo, para eliminar
1673 el efecto de los matices de la salida MIDI, inserte las líneas
1674 siguientes en el bloque @code{\midi@{ @}}.
1681 \remove "Dynamic_performer"
1686 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
1687 dentro de un bloque de partitura definido con una instrucción
1688 @code{\score}. Si se sitúa dentro de un contexto de partitura
1689 instanciado explícitamente (es decir, dentro de un bloque @code{\new
1690 Score}) el archivo no funciona. Para resolverlo, encierre las
1691 instrucciones @code{\new Score} y @code{\midi} dentro de un bloque
1696 \new Score @{ @dots{}notas@dots{} @}
1701 @node What goes into the MIDI output?
1702 @subsection What goes into the MIDI output?
1704 @unnumberedsubsubsec Supported in MIDI
1706 @cindex alturas en MIDI
1707 @cindex MIDI, alturas
1708 @cindex cuartos de tono en MIDI
1709 @cindex MIDI, cuartos de tono
1710 @cindex microtonos en MIDI
1711 @cindex MIDI, microtonos
1712 @cindex acordes, nombres de, en MIDI
1713 @cindex MIDI, nombres de
1714 @cindex duraciones en MIDI
1715 @cindex MIDI, duraciones
1718 Los siguientes elementos de notación se reflejan en la salida MIDI:
1722 @item Microtonos (véase @ref{Accidentals}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
1723 @item Acordes escritos como nombres de acorde
1724 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
1725 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
1726 @item Ligaduras de unión
1727 @item Matices o indicaciones de dinámica
1728 @item Crescendi y decrescendi sobre varias notas
1729 @item Cambios de tempo insertados con una marca metronómica
1730 @item Letra de las canciones
1733 @unnumberedsubsubsec Unsupported in MIDI
1735 @c TODO index as above
1737 Los siguientes elementos de notación no tienen ningún efecto sobre la
1741 @item Duraciones escritas como anotaciones, p.ej. el swing
1742 @item Cambios de tempo escritos como anotaciones sin marca de tempo
1743 @item Staccato y otras articulaciones y ornamentos
1744 @item Ligaduras de expresión y de fraseo
1745 @item Crescendi y decrescendi sobre una nota única
1746 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
1748 @item Acordes microtonales
1752 @node Repeats in MIDI
1753 @subsection Repeats in MIDI
1755 @cindex repeticiones, expandir
1756 @funindex \unfoldRepeats
1758 Con un poco de trucaje, se puede hacer que cualquier tipo de
1759 repetición esté presente en la salida MIDI. Esto se consigue mediante
1760 la aplicación de la función musical @code{\unfoldRepeats}. Esta
1761 función cambia todas las repeticiones a repeticiones desplegadas.
1763 @lilypond[quote,verbatim]
1765 \repeat tremolo 8 {c'32 e' }
1766 \repeat percent 2 { c''8 d'' }
1767 \repeat volta 2 {c'4 d' e' f'}
1776 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
1777 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
1778 (con repeticiones desplegadas) y otro para la notación impresa (con
1779 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
1780 y percent --repetición de compases--). Por ejemplo,
1788 \unfoldRepeats @var{..música..}
1794 @node Controlling MIDI dynamics
1795 @subsection Controlling MIDI dynamics
1797 La dinámica en el MIDI está implementada por medio del intérprete
1798 Dynamic_performer que reside de forma predeterminada dentro del
1799 contexto Voice. Es posible controlar el volumen MIDI general, el
1800 volumen relativo de los matices dinámicos y el volumen relativo de los
1801 distintos instrumentos.
1803 @unnumberedsubsubsec Dynamic marks
1805 Los matices o indicaciones de dinámica se traducen a una fracción fija
1806 del rango de volumen MIDI disponible. Las fracciones predeterminadas
1807 se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
1808 @notation{fffff}. El conjunto de indicaciones dinámicas y las
1809 fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
1810 @rlearning{Other sources of information}. Este conjunto de fracciones
1811 se puede cambiar o extender proporcionando una función que toma como
1812 argumento una indicación dinámica y devuelve la fracción requerida, y
1813 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
1816 Por ejemplo, si se requiere una indicación dinámica
1817 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
1818 predeterminado sobre el volumen MIDI, pues no está incluida en el
1819 conjunto predeterminado. De igual manera, si se define una indicación
1820 dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
1821 incluida en el conjunto predeterminado. El ejemplo siguiente muestra
1822 cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
1823 La función Scheme establece la fracción a 0.9 si se encuentra una
1824 indicación dinámica rfz, y en caso contrario llama a la función
1827 @lilypond[verbatim,quote]
1828 #(define (myDynamics dynamic)
1829 (if (equal? dynamic "rfz")
1831 (default-dynamic-absolute-volume dynamic)))
1835 \set Staff.midiInstrument = #"cello"
1836 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
1848 Como alternativa, si se necesitara redefinir la tabla completa de
1849 fracciones, sería mejor usar el procedimiento
1850 @notation{default-dynamic-absolute-volume} que aparece en
1851 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
1852 ejemplo de esta sección muestra cómo se puede hacer esto.
1854 @unnumberedsubsubsec Overall MIDI volume
1856 El volumen general máximo y mínimo de las indicaciones dinámicas de
1857 MIDI se controla estableciendo valores para las propiedades
1858 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
1859 @code{Score}. Estas propiedades tienen efecto solamente sobre las
1860 indicaciones dinámicas, por ello si queremos que tengan validez desde
1861 el comienzo de la partitura, se debe colocar allí una indicación de
1862 dinámica. La fracción que corresponde a cada indicación dinámica se
1863 modifica con esta fórmula:
1866 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
1869 En el ejemplo siguiente, el rango de intensidad dinámica del volumen
1870 general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
1872 @lilypond[verbatim,quote]
1878 \set Staff.midiInstrument = #"flute"
1879 \new Voice \relative c''' {
1887 \set Staff.midiInstrument = #"clarinet"
1888 \new Voice \relative c'' {
1899 tempoWholesPerMinute = #(ly:make-moment 72 2)
1900 midiMinimumVolume = #0.2
1901 midiMaximumVolume = #0.5
1907 @unnumberedsubsubsec Equalizing different instruments (i)
1909 Si las propiedades de volumen MIDI máximo y mínimo están establecidas
1910 en el contexto @code{Staff} se pueden controlar los volúmenes
1911 relativos de los instrumentos MIDI. Esto proporciona un ecualizador
1912 de instrumentos básico que puede realzar significativamente la calidad
1915 En este ejemplo se reduce el volumen del clarinete con relación al de
1916 la flauta. Debe haber una indicación dinámica en la primera nota de
1917 cada instrumento para que esto funcione correctamente.
1919 @lilypond[verbatim,quote]
1925 \set Staff.midiInstrument = #"flute"
1926 \set Staff.midiMinimumVolume = #0.7
1927 \set Staff.midiMaximumVolume = #0.9
1928 \new Voice \relative c''' {
1936 \set Staff.midiInstrument = #"clarinet"
1937 \set Staff.midiMinimumVolume = #0.3
1938 \set Staff.midiMaximumVolume = #0.6
1939 \new Voice \relative c'' {
1950 tempoWholesPerMinute = #(ly:make-moment 72 2)
1956 @unnumberedsubsubsec Equalizing different instruments (ii)
1958 Si las propiedades de volumen MIDI máximo y mínimo no están
1959 establecidas, de forma predeterminada LilyPond aplica un pequeño grado
1960 de ecualización a algunos instrumentos. Los instrumentos y la
1961 ecualización que se aplica se muestra en la tabla
1962 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
1964 El ecualizador básico predeterminado se puede sustituir estableciendo
1965 @code{instrumentEqualizer} en el contexto @code{Score} a un
1966 procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
1967 como único argumento y devuelva un par de fracciones que dan los
1968 volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
1969 sustitución se hace de la misma forma que mostramos para restablecer
1970 la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
1971 al comienzo de esta sección. El ecualizador predeterminado,
1972 @notation{default-instrument-equalizer}, en @file{../scm/midi.scm},
1973 muestra cómo se puede escribir tal procedimiento.
1975 El ejemplo siguiente establece los volúmenes relativos de la flauta y
1976 del clarinete a los mismos valores que el ejemplo anterior.
1978 @lilypond[verbatim,quote]
1979 #(define my-instrument-equalizer-alist '())
1981 #(set! my-instrument-equalizer-alist
1984 ("flute" . (0.7 . 0.9))
1985 ("clarinet" . (0.3 . 0.6)))
1986 my-instrument-equalizer-alist))
1988 #(define (my-instrument-equalizer s)
1989 (let ((entry (assoc s my-instrument-equalizer-alist)))
1998 \set Score.instrumentEqualizer = #my-instrument-equalizer
1999 \set Staff.midiInstrument = #"flute"
2000 \new Voice \relative c''' {
2008 \set Staff.midiInstrument = #"clarinet"
2009 \new Voice \relative c'' {
2020 tempoWholesPerMinute = #(ly:make-moment 72 2)
2027 @c Delete when satisfied this is adequately covered elsewhere -td
2029 @n ode Microtones in MIDI
2030 @s ubsection Microtones in MIDI
2032 @cindex microtones in MIDI
2034 Microtones consisting of half sharps and half flats are exported
2035 to the MIDI file and render correctly in MIDI players which support
2036 pitch bending. See @ref{Note names in other languages}. Here is
2037 an example showing all the half sharps and half flats. It can be
2038 copied out and compiled to test microtones in your MIDI player.
2040 @lilypond[verbatim,quote]
2057 @node Percussion in MIDI
2058 @subsection Percussion in MIDI
2060 La notación de los instrumentos de percusión se realiza normalmente en
2061 un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
2062 salida correctamente por el canal MIDI@tie{}10, pero ciertos
2063 instrumentos de percusión de altura determinada, como el xilófono,
2064 marimba, vibráfono, timbales, etc., se tratan como instrumentos
2065 @qq{normales} y la música para estos instrumentos se debe introducir
2066 en contextos de @code{Staff} normales, no en un contexto
2067 @code{DrumStaff}, para obtener la salida MIDI correcta.
2069 Ciertos sonidos de altura indeterminada que están incluidos en el
2070 estándar General MIDI, como el tom melódico, el tambor taiko, los
2071 tambores sintéticos, etc., no se pueden acceder a través del canal
2072 MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
2073 introducir también en un contexto normal de @code{Staff}, utilizando
2074 las alturas normales adecuadas.
2076 Muchos instrumentos de percusión no están incluidos dentro del
2077 estándar General MIDI, p.ej. las castañuelas. El método más
2078 fácil (aunque no satisfactorio) de producir una salida MIDI al
2079 escribir para estos instrumentos es sustituirlos por el sonido más
2080 parecido del conjunto estándar.
2082 @c TODO Expand with examples, and any other issues
2086 Debido a que el estándar General MIDI no contiene golpes de aro
2087 (@emph{rim shots}), para este propósito se utiliza en su lugar el
2088 golpe lateral de baqueta (@emph{sidestick}).