1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: c7d6848e128f461a4cec093f7a71a34b2dc314eb
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 Ub 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 expresions
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 únca 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 cmbiar 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 bariable @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{%@{ .. %@}}.
373 Manual de aprendizaje:
374 @rlearning{How LilyPond input files work}.
377 @node Titles and headers
378 @section Titles and headers
380 Casi toda la música impresa tiene un título y el nombre del
381 compositor; ciertas piezas tienen mucha más información.
386 * Reference to page numbers::
387 * Table of contents::
391 @node Creating titles
392 @subsection Creating titles
394 Se crean títulos para cada uno de los bloques @code{\score} así como
395 para todo el archivo de entrada (o bloque @code{\book}, libro) y las
396 partes de libro (creadas mediante bloques @code{\bookpart}).
398 El contenido de cada título se extrae a partir de los bloques
399 @code{\header} (cabecera). El bloque de cabecera de un libro
400 contempla lo siguiente:
403 @funindex dedicatoria
405 El dedicatario de la música, centrado en lo alto de la primera página.
409 El título de la música, centrado justo debajo de la
414 Subtítulo, centrado debajo del título.
416 @funindex subsubtitle
418 Sub-subtítulo, centrado debajo del subtítulo.
422 Nombre del poeta, a la izquierda, debajo del subtítulo.
426 Nombre del compositor, a la derecha, debajo del subtítulo.
430 Texto de la medida, a la izquierda, debajo del poeta.
434 Nombre del Opus, a la derecha, debajo del compositor.
438 Nombre del arreglista, a la derecha, debajo del Opus.
442 Nombre del instrumento, centrado, debajo del arreglista. También
443 aparece centrado en lo alto de cada página (aparte de la primera).
447 Nombre de la pieza, a la izquierda, debajo del instrumento.
449 @cindex página, saltos, forzar
450 @funindex breakbefore
452 Esto fuerza que el título comience sobre una página nueva (establézcalo a ##t o a ##f).
456 Aviso de Copyright, centrado en la parte inferior de la primera
457 página. Para insertar el símbolo de copyright symbol, consulte
462 Cartel de propósito general en el pie de página, centrado al final de la última.
466 A continuación presentamos una demostración de todos los campos que
467 están disponibles. Fíjese en que puede utilizar en la cabecera
468 cualquier instrucción de marcado de texto (Véase @ref{Formatting text}).
470 @lilypond[quote,verbatim,line-width=11.0\cm]
473 paper-height = 10.0\cm
478 dedication = "dedicated to me"
479 title = \markup \center-column { "Title first line" "Title second line,
481 subtitle = "the subtitle,"
482 subsubtitle = #(string-append "subsubtitle LilyPond version "
485 composer = \markup \center-column { "composer" \small "(1847-1973)" }
486 texttranslator = "Text Translator"
487 meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
489 arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
490 #-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "nger" }
491 instrument = \markup \bold \italic "instrument"
515 Como se mostró anteriormente, puede usar varios bloques
516 @code{\header}. Cuando los mismos campos aparecen en distintos
517 bloques, tiene validez el último en definirse. A continuación un
522 composer = "Compositor"
530 piece = "Otra pieza" % sobreescribe a la anterior
535 Si define la cabecera @code{\header} dentro del bloque @code{\score},
536 por lo general se imprimirán solamente las cabeceras @code{piece} y
537 @code{opus}. Fíjese en que la expresión musical debe aparecer antes
540 @lilypond[quote,verbatim,line-width=11.0\cm]
544 title = "title" % not printed
551 @funindex print-all-headers
553 Se puede cambiar este comportamiento (e imprimir todas las cabeceras
554 cuando la cabecera @code{\header} está definida dentro del bloque
555 @code{\score}) mediante la utilización de
559 print-all-headers = ##t
566 El pie de página por omisión se encuentra vacío, excepto para la
567 primera página, en la que se inserta el campo de @code{copyright}
568 extraído del @code{\header}, y para la última página, en la que se
569 escribe el cartel @code{tagline} sacado del bloque @code{\header}. La
570 línea por omisión para este cartel es @qq{Music engraving by LilyPond
571 (@var{version})}.@footnote{Las partituras bien tipografiadas son una
572 magnífica promoción para nosotros, así que por favor, si puede,
573 conserve intacta la línea del letrero.}
575 Las cabeceras se pueden quitar completamente estableciendo su valor a
587 @subsection Custom titles
589 Una opción más avanzada es cambiar las definiciones de las variables
590 siguientes dentro del bloque @code{\paper} block. El archivo de
591 inicio @file{ly/titling-init.ly} ofrece un listado de la disposición
595 @funindex bookTitleMarkup
596 @item bookTitleMarkup
597 Es el título que se escribe en lo alto del documento de salida
598 completo. Normalmente contiene el compositor y el título de la pieza.
600 @funindex scoreTitleMarkup
601 @item scoreTitleMarkup
602 Es el título que se coloca por encima de un bloque @code{\score}.
603 normalmente contiene el nombre del movimiento (campo @code{piece}).
605 @funindex oddHeaderMarkup
606 @item oddHeaderMarkup
607 Es el encabezamiento de las páginas de numeración impar.
609 @funindex evenHeaderMarkup
610 @item evenHeaderMarkup
611 Es el encabezamiento de las páginas de numeración par. Si se deja
612 sin especificar, se usará el encabezamiento de las páginas impares.
614 De forma predeterminada, los encabezamientos se definen de tal forma
615 que el número de página está en el borde exterior, y el isntrumento
618 @funindex oddFooterMarkup
619 @item oddFooterMarkup
620 Es el pie de las páginas de numeración impar.
622 @funindex evenFooterMarkup
623 @item evenFooterMarkup
624 Es el pie de las páginas de numeración par. Si se deja sin
625 especificar, se usará en su lugar el encabezamiento de las páginas
628 De forma predeterminada, el pie de página tiene el aviso de
629 copyright en la primera página, y el cartel @code{tagline} en la
635 @cindex encabezamiento
638 @cindex disposición de la página
641 La definición siguiente pone el título en el extremo izquierdo, y el
642 compositor en el extremo derecho sobre una única línea.
646 bookTitleMarkup = \markup {
648 \fromproperty #'header:title
649 \fromproperty #'header:composer
655 @node Reference to page numbers
656 @subsection Reference to page numbers
658 Se puede marcar un lugar determinado de una partitura utilizando la
659 instrucción @code{\label} (etiqueta), bien en lo alto de la estructura
660 o bien dentro de la música. Posteriormente se puede hacer referencia
661 a esta etiqueta dentro de un elemento de marcado, para obtener el
662 número de la página en que se encuentra la marca, usando la
663 instrucción de marcado @code{\page-ref}.
665 @lilypond[verbatim,line-width=11.0\cm]
666 \header { tagline = ##f }
672 \pageBreak \mark A \label #'markA
677 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
678 \markup { Mark A is on page \page-ref #'markA "0" "?" }
682 La instrucción de marcado @code{\page-ref} toma tres argumentos:
684 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
685 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
686 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
689 El motivo de que se necesite un medidor es que en el momento en que se
690 están interpretando los marcados, los saltos de página aún no se han
691 producido y por tanto los números de página no se conocen todavía.
692 Para sortear este inconveniente, la interpretación real del marcado se
693 retrasa hasta un momento posterior; sin embargo, las dimensiones del
694 marcado se tienen que conocer de antemano, así que se usa el medidor
695 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
696 páginas, el medidor puede ser "00", es decir, un número de dos
708 @node Table of contents
709 @subsection Table of contents
711 Se puede insertar un índice general o tabla de contenidos utilizando
712 la instrucción @code{\markuplines \table-of-contents}. Los elementos
713 que deben aparecer en la tabla de contenidos se introducen con la
714 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
715 la jerarquía del código, o dentro de una expresión musical.
718 \markuplines \table-of-contents
721 \tocItem \markup "Primera partitura"
725 \tocItem \markup "Un punto concreto dentro de la primera partitura"
730 \tocItem \markup "Segunda partitura"
738 Los elementos de marcado que se usan para dar formato al índice
739 general se encuentran definidos dentro del bloque @code{\paper}. Los
740 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
741 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
742 los elementos del índice, que consisten en el título del elemento y el
743 número de página. Estas variables se pueden cambiar por parte del
748 %% Traducir el título del índice al español:
749 tocTitleMarkup = \markup \huge \column {
750 \fill-line { \null "Índice general" \null }
753 %% usar una fuente mayor
754 tocItemMarkup = \markup \large \fill-line {
755 \fromproperty #'toc:text \fromproperty #'toc:page
760 Observe la forma en que nos referimos al texto y al número de página
761 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
763 También se pueden definir nuevas instrucciones y elementos de
764 marcado para crear índices generales más eleborados:
766 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
767 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
768 utilizando esta variable de marcado del bloque @code{\paper}.
771 En el ejemplo siguiente se define un estilo nuevo para introducir los
772 nombres de los actos de una ópera en el índice general:
776 tocActMarkup = \markup \large \column {
778 \fill-line { \null \italic \fromproperty #'toc:text \null }
784 #(define-music-function (parser location text) (markup?)
785 (add-toc-item! 'tocActMarkup text))
788 @lilypond[line-width=11.0\cm]
789 \header { tagline = ##f }
791 tocActMarkup = \markup \large \column {
793 \fill-line { \null \italic \fromproperty #'toc:text \null }
799 #(define-music-function (parser location text) (markup?)
800 (add-toc-item! 'tocActMarkup text))
803 \markuplines \table-of-contents
804 \tocAct \markup { Atto Primo }
805 \tocItem \markup { Coro. Viva il nostro Alcide }
806 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
807 \tocAct \markup { Atto Secondo }
808 \tocItem \markup { Sinfonia }
809 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
817 @file{ly/@/toc@/-init@/.ly}.
821 @funindex \table-of-contents
822 @code{\table-of-contents},
828 @node Working with input files
829 @section Working with input files
832 * Including LilyPond files::
833 * Different editions from one source::
835 * Displaying LilyPond notation::
839 @node Including LilyPond files
840 @subsection Including LilyPond files
843 @cindex including files
845 Un proyecto grande se puede dividir en varios archivos. Para
846 referirse a otro archivo, utilice
849 \include "otroarchivo.ly"
852 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
853 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
854 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
855 podríamos querer archivos distintos para cada parte instrumental y
856 crear un archivo de @qq{partitura completa} que reúne los archivos
857 individuales de los instrumentos. Normalmente el archivo incluido
858 define un cierto número de variables que a partir de entonces quedan
859 disponibles para poderlas utilizar en el archivo de la partitura
860 completa. En los archivos incluidos se pueden marcar las secciones
861 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
862 la partitura, véase @ref{Different editions from one source}.
864 Los archivos que están en el directorio de trabajo actual se pueden
865 referenciar simplemente especificando el nombre depués de la
866 instrucción @code{\include}. Los archivos en otros lugares se pueden
867 incluir proporcionando una referencia de ruta completa o una ruta
868 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
869 barra invertida de DOS/Windows, \, como separador de directorio). Por
870 ejemplo, si @file{material.ly} está situado un directorio por encima
871 del directorio de trabajo actual, utilice
874 \include "../material.ly"
878 o si los archivos de las partes orquestales incluidas están todos
879 situados en un subdirectorio llamado @file{partes} dentro del
880 directorio actual, use
883 \include "partes/VI.ly"
884 \include "partes/VII.ly"
888 Los archivos de inclusión también pueden contener enunciados
889 @code{\include} a su vez. De forma predeterminada, estos enunciados
890 @code{\include} de segundo nivel no se interpretan hasta que se
891 incorporan al archivo principal, por lo que los nombres de archivo que
892 especifican deben ser relativos al directorio que contiene el archivo
893 principal, no al directorio que contiene el archivo incluido. Sin
894 embargo, este comportamiento se puede modificar pasando la opción
895 @code{-drelative-includes} en la línea de órdenes (o mediante la
896 adición de @code{#(ly:set-option 'relative-includes #t)} al principio
897 del archivo principal de entrada). Con el valor de
898 @code{relative-includes} establecido, la ruta de cada instrucción
899 @code{\include} se considera relativa al archivo que contiene dicha
900 instrucción. Este comportamiento es el recomendado y se convertirá en
901 el comportamiento predeterminado en una versión futura de lilypond.
903 También se pueden incluir archivos de un directorio que está en una
904 ruta de búsqueda especificada como opción al invocar a LilyPond desde
905 la línea de órdenes. Los archivos incluidos se especifican usando
906 solamente su nombre de archivo. Por ejemplo, para compilar mediante
907 este método un archivo @file{principal.ly} que incluye archivos
908 situados en un subdirectorio llamado @file{partes}, cambie al
909 directorio que contiene @file{principal.ly} e introduzca
912 lilypond --include=partes principal.ly
915 y en @file{principal.ly} escriba
923 Los archivos que se incluyen en muchas partituras se pueden poner en
924 el directorio de LilyPond @file{../ly} (la localización de este
925 directorio depende de la instalación: véase
926 @rlearning{Other sources of information}). Estos archivos se pueden
927 incluir sencillamente por su nombre en un enunciado @code{\include}.
928 De esta forma se incluyen los archivos dependientes del idioma como
931 LilyPond incluye de forma predeterminada ciertos archivos cuando se
932 inicia el programa. Estas inclusiones no son visibles para el
933 usuario, pero los archivos se pueden identificar ejecutando
934 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
935 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
936 otras indicaciones. De forma alternativa, pueden verse explicaciones
937 sobre los archivos más importantes de este conjunto en
938 @rlearning{Other sources of information}. Estos archivos se pueden
939 editar, pero los cambios realizados sobre ellos se perderán al
940 instalar una nueva versión de LilyPond.
942 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
943 @rlearning{Scores and parts}.
947 Manual de aprendizaje:
948 @rlearning{Other sources of information},
949 @rlearning{Scores and parts}.
954 Si un archivo incluido recibe un nombre igual al de uno de los
955 archivos de instalación de LilyPond, el archivo que tiene prioridad es
956 el de los archivos de instalación de LilyPond.
959 @node Different editions from one source
960 @subsection Different editions from one source
962 Se encuentran disponibles varios mecanismos para facilitar la
963 producción de distintas versiones de una partitura a partir de la
964 misma fuente musical. Las variables son quizá más útiles para
965 combinar secciones extensas de música y/o anotaciones de diversas
966 formas, mientras que las etiquetas son más útiles para seleccionar una
967 de entra varias secciones de música más cortas. Cualquiera que sea el
968 método utilizado, la separación de la notación de la estructura de la
969 partitura hará que sea más fácil cambiar la estructura dejando intacta
977 @node Using variables
978 @unnumberedsubsubsec Using variables
980 @cindex variables, uso de las
982 Si las secciones de la música se definen dentro de variables, se
983 pueden reutilizar en distintas partes de la partitura, véase
984 @rlearning{Organizing pieces with variables}. Por ejemplo, una
985 partitura vocal @notation{a cappella} con frecuencia incluye una
986 reducción de piano de las partes para ensayar que ees idéntica a la
987 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
988 puede combinar sobre un solo pentagrama la música de dos variables,
989 véase @ref{Automatic part combining}. He aquí un ejemplo:
991 @lilypond[verbatim,quote]
992 sopranoMusic = \relative c'' { a4 b c b8( a)}
993 altoMusic = \relative g' { e4 e e f }
994 tenorMusic = \relative c' { c4 b e d8( c) }
995 bassMusic = \relative c' { a4 gis a d, }
996 allLyrics = \lyricmode {King of glo -- ry }
998 \new Staff = "Soprano" \sopranoMusic
999 \new Lyrics \allLyrics
1000 \new Staff = "Alto" \altoMusic
1001 \new Lyrics \allLyrics
1002 \new Staff = "Tenor" {
1006 \new Lyrics \allLyrics
1007 \new Staff = "Bass" {
1011 \new Lyrics \allLyrics
1014 \set Staff.printPartCombineTexts = ##f
1020 \set Staff.printPartCombineTexts = ##f
1030 Se pueden producir partituras distintas que presenten sólo las partes
1031 vocales o sólo la parte de piano, cambiando solamente los enunciados
1032 estructurales, sin modificar la notación musical.
1034 Para partituras extensas, las definiciones de variable se pueden poner
1035 en archivos separados que se incluyen más tarde, véase @ref{Including
1040 @unnumberedsubsubsec Using tags
1043 @funindex \keepWithTag
1044 @funindex \removeWithTag
1046 @cindex manetener música etiquetada
1047 @cindex quitar música etiquetada
1049 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
1050 con el nombre @var{parteA}. Las expresiones etoiquetadas de esta
1051 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
1052 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
1053 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
1054 música etiquetada es como sigue:
1056 @multitable @columnfractions .5 .5
1060 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
1062 Se incluye la música no etiquetada y la música etiquetada con
1063 @var{nombre}; se excluye la música etiquetada con cualquier otro
1066 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
1068 Se incluye la música no etiquetada y la música etiquetada con
1069 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
1070 música etiquetada con @var{nombre}.
1072 Música etiquetada no precedida de @code{\keepWithTag} ni de
1073 @code{\removeWithTag}
1074 @tab Se incluye toda la música etiquetada y no etiquetada.
1077 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
1078 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
1079 @code{#'parte}), seguido de una expresión musical.
1081 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
1082 que muestra trinos con la notación usual y otra con los trinos
1083 expandidos explícitamente:
1085 @lilypond[verbatim,quote]
1086 music = \relative g' {
1088 \tag #'trills {d8.\trill }
1089 \tag #'expand {\repeat unfold 3 {e32 d} }
1094 \keepWithTag #'trills \music
1097 \keepWithTag #'expand \music
1102 De forma alternativa, a veces es más fácil excluir secciones de música:
1104 @lilypond[verbatim,quote]
1105 music = \relative g' {
1107 \tag #'trills {d8.\trill }
1108 \tag #'expand {\repeat unfold 3 {e32 d} }
1113 \removeWithTag #'expand
1117 \removeWithTag #'trills
1122 El flitrado con etiquetas se puede aplicar a articulaciones, textos,
1126 -\tag #'@var{mi-etiqueta}
1129 a una articulación. Por ejemplo, esto define una nota con una
1130 indicación opcional de digitación y una nota con una anotación
1135 c1-\tag #'warn ^"¡Ojo!"
1138 Se pueden poner varias etiquetas sobre expresiones con varias entradas
1141 @lilypond[quote,verbatim]
1142 music = \relative c'' {
1143 \tag #'a \tag #'both { a a a a }
1144 \tag #'b \tag #'both { b b b b }
1147 \keepWithTag #'a \music
1148 \keepWithTag #'b \music
1149 \keepWithTag #'both \music
1153 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
1154 expresión musical para quitar varias secciones etiquetadas con nombres
1157 @lilypond[verbatim,quote]
1158 music = \relative c'' {
1159 \tag #'A { a a a a }
1160 \tag #'B { b b b b }
1161 \tag #'C { c c c c }
1162 \tag #'D { d d d d }
1171 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
1172 musical producen la eliminación de @emph{todas} las secciones
1173 etiquetadas, porque el primer filtro quita todas las secciones
1174 etiquetadas excepto la que se nombra, y el segundo filtro elimina
1175 incluso esa sección etiquetada.
1179 Manual de aprendizaje:
1180 @rlearning{Organizing pieces with variables}.
1182 Referencia de la notación:
1183 @ref{Automatic part combining},
1184 @ref{Including LilyPond files}.
1188 @c This warning is more general than this placement implies.
1189 @c Rests are not merged whether or not they come from tagged sections.
1190 @c Should be deleted? -td
1195 Multiple rests are not merged if you create a score with more
1196 than one tagged section at the same place.
1201 @subsection Text encoding
1203 LilyPond usa el conjunto de caracteres definido por el consorcio
1204 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
1205 para los conjuntos de caracteres que se utilizan en prácticamente
1206 todos los idiomas modernos y también en muchos otros. Unicode se
1207 puede implementar utilizando varios esquemas de codificación
1208 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
1209 @emph{Unicode Transformation Format}, o formato de transformación de
1210 Unicode) que representa todos los caracteres comunes de Latin en un
1211 solo byte, y representa otros caracteres usando un formato de longitud
1212 variable de hasta cuatro bytes.
1214 El aspecto visual real de los caracteres viene determinado por los
1215 glifos que se definen en las fuentes tipográficas concretas que se
1216 tengan disponibles: una fuente tipográfica define la asignación de un
1217 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
1218 biblioteca Pango para representar y disponer tipográficamente textos
1221 Lilypond no realiza ninguna conversión en la codificación de la
1222 entrada. Esto significa que cualquier text, ya sea el título, la
1223 letra de la canción o una instrucción musical que contenga caracteres
1224 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
1225 forma más fácil de escribir dicho texto es utilizar un editor
1226 preparado para Unicode y guardar el archivo con la codificación UTF-8.
1227 Casi todos los editores modernos populares contemplan el UTF-8, por
1228 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
1229 Windows posteriores a NT usan Unicode como codificación de caracteres
1230 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
1231 puede editar y guardar un archivo en el formato UTF-8. Una
1232 alternativa más funcional para Windows es BabelPad.
1234 Si un archivo de entrada que contiene un carácter que no es ASCII, no
1235 se guarda en el formato UTF-8, se genera el mensaje de error
1238 FT_Get_Glyph_Name () error: argumento inválido
1241 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
1244 %c No verbatim here as the code does not display correctly in PDF
1246 bulgarian = \lyricmode {
1247 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1251 hebrew = \lyricmode {
1252 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1256 portuguese = \lyricmode {
1257 à vo -- cê uma can -- ção legal
1263 \addlyrics { \bulgarian }
1264 \addlyrics { \hebrew }
1265 \addlyrics { \portuguese }
1268 Para introducir un caracter aislado para el que se conoce la secuencia
1269 de escape de Unicode pero no está disponible en el editor que se está
1270 usando, use @code{\char ##xhhhh} dentro de un bloque @code{\markup},
1271 donde @code{hhhh} es el código hexadecimal del carácter en cuestión.
1272 Por ejemplo, @code{\char ##x03BE} inserta el carácter Unicode U+03BE,
1273 que tiene el nombre Unicode @qq{Letra griega Xi pequeña}. Se puede
1274 sustituir cualquier código hexadecimal Unicode, y si todos los
1275 caracteres especiales se escriben en este formato no es necesario
1276 guardar el archivo de entrada en formato UTF-8. Por supuesto, debe
1277 estar instalada y estar disponible para Lilypond una fuente
1278 tipográfica que contenga codificados todos estos caracteres.
1280 El ejemplo siguiente muestra caracteres codificados en UTF-8 que se
1281 usan en cuatro lugares: en una llamada de ensayo, como texto de
1282 articulación, en la letra y como texto independiente bajo la
1285 @lilypond[quote,verbatim]
1288 c1 \mark \markup { \char ##x03EE }
1289 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1291 \addlyrics { O \markup { \concat{ Ph \char ##x0153 be! } } }
1293 \markup { "Copyright 2008--2009" \char ##x00A9 }
1296 Para escribir el símbolo de copyright en la nota de créditos, utilice:
1300 copyright = \markup @{ \char ##x00A9 "2008" @}
1305 @node Displaying LilyPond notation
1306 @subsection Displaying LilyPond notation
1308 @funindex \displayLilyMusic
1309 La impresión textual de una expresión musical en notación de LilyPond
1310 puede hacerse usando la función musical @code{\displayLilyMusic}. Por
1315 \displayLilyMusic \transpose c a, @{ c e g a bes @}
1322 @{ a, cis e fis g @}
1325 De forma predeterminada, LilyPond imprime estos mensajes en la consola
1326 junto al resto de los mensajes. Para discernir entre estos mensajes y
1327 guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
1328 salida hacia un archivo.
1330 @c TODO What happens under Windows?
1333 lilypond archivo.ly >resultado.txt
1338 @node Controlling output
1339 @section Controlling output
1342 * Extracting fragments of music::
1343 * Skipping corrected music::
1346 @node Extracting fragments of music
1347 @subsection Extracting fragments of music
1349 Es posible citar pequeños fragmentos de una partitura grande
1350 directamente a partir de la salida. Puede compararse con la
1351 separación de una pieza de una partitura, recortándola con tijeras.
1353 Esto se hace definiendo los compases que se deben recortar. Por
1354 ejemplo, la inclusión de la siguiente definición
1361 (make-rhythmic-location 5 1 2)
1362 (make-rhythmic-location 7 3 4)))
1367 extrae un fragmento empezando por la mitad del quinto compás y
1368 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
1369 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
1370 después de tres negras del compás 7.
1372 Se pueden definir más zonas de recorte añadiendo más parejas de
1373 definición de tiempo rhythmic-location a la lista.
1375 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
1376 la opción @code{-dclip-systems}. Los recortes aparecen en la salida
1377 como archivos EPS, y se convierten en PDF y PNG si estos formatos
1378 también están activados.
1380 Para ver más información sobre los formatos de salida, consulte
1381 @rprogram{Invoking lilypond}.
1384 @node Skipping corrected music
1385 @subsection Skipping corrected music
1387 @funindex skipTypesetting
1388 @funindex showFirstLength
1389 @funindex showLastLength
1391 Al escribir o copiar música, normalmente sólo es interesante de ver y
1392 corregir la música cercana al final (donde estams añadiendo las
1393 notas). Para acelerar este proceso de corrección, es posible saltar
1394 la composición tipográfica de todos excepto unos pocos de los últimos
1395 compases. Esto se consigue poniendo
1398 showLastLength = R1*5
1403 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
1404 cinco compases (suponniendo un compás de 4/4) de cada una de las
1405 partituras @code{\score} del archivo de entrada. Para piezas largas,
1406 el tipografiado de únicamente una parte pequeña es con frecuencia un
1407 orden de magnitud más rápido que el de la obra completa. Si estamos
1408 trabajando sobre el principio de una partitura que ya hemos
1409 tipografiado (p.ej., para añadir una parte instrumental nueva),
1410 también puede ser útil la propiedad @code{showFirstLength}.
1412 Este mecanismo de pasar por alto partes de un partitura se puede
1413 controlar con un grano más fino mediante la propiedad
1414 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
1415 lleva a cabo ningún tipografiado en absoluto.
1417 Esta propiedad se usa también para controlar la salida al archivo
1418 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
1419 y los cambios de instrumento. Está usted advertido.
1421 @lilypond[quote,fragment,ragged-right,verbatim]
1424 \set Score.skipTypesetting = ##t
1426 \set Score.skipTypesetting = ##f
1430 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
1431 voces y pentagramas, ahorrando más tiempo incluso.
1435 @section MIDI output
1440 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
1441 Instrumentos Musicales) es un estándar para interconectar y controlar
1442 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
1443 una serie de notas dentro de un conjunto de pistas. No es un archivoo
1444 de sonidos reales; se necesita un programa reproductor especial para
1445 traducir la serie de notas en sonidos de verdad.
1447 Cualquier música se puede convertir a archivos MIDI, de manera que
1448 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
1449 para comprobar la corrección de la música; las octavas equivocadas o
1450 las alteraciones erróneas se ponen de relieve muy claramente al
1451 escuchar la salida MIDI.
1454 La salida MIDI reserva un canal por cada pentagrama, y otro para los
1455 ajustes globales. Por ello, el archivo MIDI no debe tener más de 15
1456 pautas (o 14 si no se usa la percusión). Otros pentagramas permanecen
1460 * Creating MIDI files::
1462 * What goes into the MIDI output?::
1464 * Controlling MIDI dynamics::
1465 * Percussion in MIDI::
1468 @node Creating MIDI files
1469 @subsection Creating MIDI files
1471 Para crear un MIDI a partir de una pieza de música, escriba un bloque
1472 @code{\midi} en la partitura, por ejemplo:
1481 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
1482 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
1483 necesita una notación impresa, debe haber también un bloque
1494 Se traducen correctamente a la salida MIDI la altura y duración de las
1495 notas, las ligaduras de unión, matices y cambios de tempo. Las
1496 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
1497 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
1498 del rango de volumen MIDI disponible. Los crescendi y decrescendi
1499 hacen que el volumen varía linealmente entre sus dos extremos. El
1500 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
1501 eliminar por completo, véase @ref{MIDI block}.
1503 El tempo inicial y los cambios de tempo posteriores se pueden
1504 especificar utilizando la instrucción @code{\tempo} dentro de la
1505 propia notación musical. Se reflejan en cambios de tempo en la salida
1506 MIDI. Esta instrucción normalmente hace que se imprima la indicación
1507 metronómica, pero esto se puede eliminar, véase @ref{Metronome marks}.
1508 Más abajo se describe una forma alternativa de especificar el tempo
1509 MIDI inicial o global, véase @ref{MIDI block}.
1511 @unnumberedsubsubsec Instrument names
1513 @cindex instrumento, nombres de
1514 @funindex Staff.midiInstrument
1516 El nombre del instrumento MIDI se establece mediante la propiedad
1517 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
1518 de entre los que están en la lista que aparece en @ref{MIDI
1523 \set Staff.midiInstrument = #"glockenspiel"
1529 \new Staff \with @{midiInstrument = #"cello"@} @{
1534 Si el instrumento elegido no coincide exactamente con uno de los
1535 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
1536 Piano de Cola (@code{"acoustic grand"}).
1540 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
1541 {changing-midi-output-to-one-channel-per-voice.ly}
1545 @c In 2.11 the following no longer seems to be a problem -td
1547 Unterminated (de)crescendos will not render properly in the midi file,
1548 resulting in silent passages of music. The workaround is to explicitly
1549 terminate the (de)crescendo. For example,
1556 will not work properly but
1566 Los cambios del volumen MIDI sólo tienen lugar al principio de la
1567 nota, por lo que los crescendi y decrescendi no pueden afectar al
1568 volumen de una sola nota.
1570 No todos los repoductores de MIDI manejar adecuadamente los cambios de
1571 tempo de la salida MIDI. Entre los reproductores que se sabe que
1572 funcionan se encuentran el Reproductor de Medios de MS Windows y
1573 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
1577 @subsection MIDI block
1581 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
1582 dentro de un bloque de partitura. Es análogo al bloque layout de
1583 diseño de página, pero algo maś simple. Con frecuencia, el bloque
1584 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
1585 contextos, definiciones de contexto nuevas o código para fijar valores
1586 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
1587 tempo inicial exportado alarchivo MIDI sin hacer que se imprima una
1588 indicación de tempo:
1596 tempoWholesPerMinute = #(ly:make-moment 72 4)
1602 En este ejemplo, el tempo se establece a 72 pulsos de negra por
1603 minuto. Esta clase de especificación de tempo no puede tomar como
1604 argumento una figura con puntillo. Si necesitamos una figura con
1605 puntillo, dividimos la nota con puntillo en figuras más pequeñas. Por
1606 ejemplo, un tempo de 90 negras con puntillo por minuto se puede
1607 especificar como 270 corcheas por minuto:
1610 tempoWholesPerMinute = #(ly:make-moment 270 8)
1613 @cindex MIDI, definiciones de contexto
1615 Las definiciones de contexto siguen con precisión la misma sintaxis
1616 que la de un bloque @code{\layout}. Los módulos de traducción para el
1617 sonido reciben el nombre de ejecutantes. Los contextos para la salida
1618 MIDI se definen en @file{../ly/@/performer@/-init@/.ly}, véase
1619 @rlearning{Other sources of information}. Por ejemplo, para eliminar
1620 el efecto de los matices de la salida MIDI, inserte las líneas
1621 siguientes en el bloque @code{\midi@{ @}}.
1628 \remove "Dynamic_performer"
1633 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
1634 dentro de un bloque de partitura definido con una instrucción
1635 @code{\score}. Si se sitúa dentro de un contexto de partitura
1636 instanciado explícitamente (es decir, dentro de un bloque @code{\new
1637 Score}) el archivo no funciona. Para resolverlo, encierre las
1638 instrucciones @code{\new Score} y @code{\midi} dentro de un bloque
1643 \new Score @{ @dots{}notas@dots{} @}
1648 @node What goes into the MIDI output?
1649 @subsection What goes into the MIDI output?
1651 @unnumberedsubsubsec Supported in MIDI
1653 @cindex alturas en MIDI
1654 @cindex MIDI, alturas
1655 @cindex cuartos de tono en MIDI
1656 @cindex MIDI, cuartos de tono
1657 @cindex microtonos en MIDI
1658 @cindex MIDI, microtonos
1659 @cindex acordes, nombres de, en MIDI
1660 @cindex MIDI, nombres de
1661 @cindex duraciones en MIDI
1662 @cindex MIDI, duraciones
1665 Los siguientes elementos de notación se reflejan en la salida MIDI:
1669 @item Microtonos (véase @ref{Accidentals}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
1670 @item Acordes escritos como nombres de acorde
1671 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
1672 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
1673 @item Ligaduras de unión
1674 @item Matices o indicaciones de dinámica
1675 @item Crescendi y decrescendi sobre varias notas
1676 @item Cambios de tempo insertados con una marca metronómica
1677 @item Letra de las canciones
1680 @unnumberedsubsubsec Unsupported in MIDI
1682 @c TODO index as above
1684 Los siguientes elementos de notación no tienen ningún efecto sobre la
1688 @item Duraciones escritas como anotaciones, p.ej. el swing
1689 @item Cambios de tempo escritos como anotacioens sin marca de tempo
1690 @item Staccato y otras articulaciones y ornamentos
1691 @item Ligaduras de expresión y de fraseo
1692 @item Crescendi y decrescendi sobre una nota única
1693 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
1695 @item Acordes microtonales
1699 @node Repeats in MIDI
1700 @subsection Repeats in MIDI
1702 @cindex repeticiones, expandir
1703 @funindex \unfoldRepeats
1705 Con un poco de trucaje, se puede hacer que cualquier tipo de
1706 repetición esté presente en la salida MIDI. Esto se consigue mediante
1707 la aplicación de la función musical @code{\unfoldRepeats}. Esta
1708 función cambia todas las repeticiones a repeticiones desplegadas.
1710 @lilypond[quote,verbatim]
1712 \repeat tremolo 8 {c'32 e' }
1713 \repeat percent 2 { c''8 d'' }
1714 \repeat volta 2 {c'4 d' e' f'}
1723 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
1724 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
1725 (con repeticiones desplegadas) y otro para la notación impresa (con
1726 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
1727 y percent --repetición de compases--). Por ejemplo,
1735 \unfoldRepeats @var{..música..}
1741 @node Controlling MIDI dynamics
1742 @subsection Controlling MIDI dynamics
1744 La dinámica en el MIDI está implementada por medio del intérprete
1745 Dynamic_performer que reside de forma predeterminada dentro del
1746 contexto Voice. Es posible controlar el volumen MIDI general, el
1747 volumen relativo de los matices dinámicos y el volumen relativo de los
1748 distintos instrumentos.
1750 @unnumberedsubsubsec Dynamic marks
1752 Los matices o indicaciones de dinámica se traducen a una fracción fija
1753 del rango de volumen MIDI disponible. Las fracciones predeterminadas
1754 se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
1755 @notation{fffff}. El conjunto de indicaciones dinámicas y las
1756 fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
1757 @rlearning{Other sources of information}. Este conjunto de fracciones
1758 se puede cmbiar o extender proporcionando una función que toma como
1759 argumento una indicación dinámica y devuelve la fracción requerida, y
1760 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
1763 Por ejemplo, si se requiere una indicación dinámica
1764 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
1765 predeterminado sobre el voumen MIDI, pues no está incluida en el
1766 conjunto predeterminado. De igual manera, si se define una indicación
1767 dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
1768 incluida en el conjunto predeterminado. El ejemplo siguiente muestra
1769 cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
1770 La función Scheme establece la fracción a 0.9 si se encuentra una
1771 indicación dinámica rfz, y en caso contrario llama a la función
1774 @lilypond[verbatim,quote]
1775 #(define (myDynamics dynamic)
1776 (if (equal? dynamic "rfz")
1778 (default-dynamic-absolute-volume dynamic)))
1782 \set Staff.midiInstrument = #"cello"
1783 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
1795 Como alternativa, si se necesitara redefinir la tabla completa de
1796 fracciones, sería mejor usar el procedimiento
1797 @notation{default-dynamic-absolute-volume} que aparece en
1798 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
1799 ejemplo de esta sección muestra cómo se puede hacer esto.
1801 @unnumberedsubsubsec Overall MIDI volume
1803 El volumen general máximo y mínimo de las indicaciones dinámicas de
1804 MIDI se controla estableciendo valores para las propiedades
1805 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
1806 @code{Score}. Estas propiedades tienen efecto solamente sobre las
1807 indicaciones dinámicas, por ello si queremos que tengan validez desde
1808 el comienzo de la partitura, se debe colocar allí una indicación de
1809 dinámica. La fracción que corresponde a cada indicación dinámica se
1810 modifica con esta fórmula:
1813 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
1816 En el ejemplo siguiente, el rango de intensidad dinámica del volumen
1817 general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
1819 @lilypond[verbatim,quote]
1825 \set Staff.midiInstrument = #"flute"
1826 \new Voice \relative c''' {
1834 \set Staff.midiInstrument = #"clarinet"
1835 \new Voice \relative c'' {
1846 tempoWholesPerMinute = #(ly:make-moment 72 2)
1847 midiMinimumVolume = #0.2
1848 midiMaximumVolume = #0.5
1854 @unnumberedsubsubsec Equalizing different instruments (i)
1856 Si las propiedades de volumen MIDI máximo y mínimo están establecidas
1857 en el contexto @code{Staff} se pueden controlar los volúmenes
1858 relativos de los instrumentos MIDI. Esto proporciona un ecualizador
1859 de instrumentos básico que puede realzar significativamente la calidad
1862 En este ejemplo se reduce el volumen del clarinete con relación al de
1863 la flauta. Debe haber una indicación dinámica en la primera nota de
1864 cada instrumento para que esto funcione correctamente.
1866 @lilypond[verbatim,quote]
1872 \set Staff.midiInstrument = #"flute"
1873 \set Staff.midiMinimumVolume = #0.7
1874 \set Staff.midiMaximumVolume = #0.9
1875 \new Voice \relative c''' {
1883 \set Staff.midiInstrument = #"clarinet"
1884 \set Staff.midiMinimumVolume = #0.3
1885 \set Staff.midiMaximumVolume = #0.6
1886 \new Voice \relative c'' {
1897 tempoWholesPerMinute = #(ly:make-moment 72 2)
1903 @unnumberedsubsubsec Equalizing different instruments (ii)
1905 Si las propiedades de volumen MIDI máximo y mínimo no están
1906 establecidas, de forma predeterminada LilyPond aplica un pequeño grado
1907 de ecualización a algunos instrumentos. Los instrumentos y la
1908 ecualización que se aplica se muestra en la tabla
1909 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
1911 El ecualizador básico predeterminado se puede sustituir estableciendo
1912 @code{instrumentEqualizer} en el contexto @code{Score} a un
1913 procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
1914 como único argumento y devuelva un par de fracciones que dan los
1915 volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
1916 sustitución se hace de la misma forma que mostramos para reestablecer
1917 la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
1918 al comienzo de esta sección. El ecualizador predeterminado,
1919 @notation{default-instrument-equalizer}, en @file{../scm/midi.scm},
1920 muestra cómo se puede escribir tal procedimiento.
1922 El ejemplo siguiente establece los volúmenes relativos de la flauta y
1923 del clarinete a los mismos valores que el ejemplo anterior.
1925 @lilypond[verbatim,quote]
1926 #(define my-instrument-equalizer-alist '())
1928 #(set! my-instrument-equalizer-alist
1931 ("flute" . (0.7 . 0.9))
1932 ("clarinet" . (0.3 . 0.6)))
1933 my-instrument-equalizer-alist))
1935 #(define (my-instrument-equalizer s)
1936 (let ((entry (assoc s my-instrument-equalizer-alist)))
1945 \set Score.instrumentEqualizer = #my-instrument-equalizer
1946 \set Staff.midiInstrument = #"flute"
1947 \new Voice \relative c''' {
1955 \set Staff.midiInstrument = #"clarinet"
1956 \new Voice \relative c'' {
1967 tempoWholesPerMinute = #(ly:make-moment 72 2)
1974 @c Delete when satisfied this is adequately covered elsewhere -td
1976 @n ode Microtones in MIDI
1977 @s ubsection Microtones in MIDI
1979 @cindex microtones in MIDI
1981 Microtones consisting of half sharps and half flats are exported
1982 to the MIDI file and render correctly in MIDI players which support
1983 pitch bending. See @ref{Note names in other languages}. Here is
1984 an example showing all the half sharps and half flats. It can be
1985 copied out and compiled to test microtones in your MIDI player.
1987 @lilypond[verbatim,quote]
2004 @node Percussion in MIDI
2005 @subsection Percussion in MIDI
2007 La notación de los instrumentos de percusión se realiza normalmente en
2008 un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
2009 salida correctamente por el canal MIDI@tie{}10, pero ciertos
2010 instrumentos de percusión de altura determinada, como el xilófono,
2011 marimba, vibráfono, timbales, etc., se tratan como instrumentos
2012 @qq{normales} y la música para estos instrumentos se debe introducir
2013 en contestos de @code{Staff} normales, no en un contexto
2014 @code{DrumStaff}, para obtener la salida MIDI correcta.
2016 Ciertos sonidos de altura indeterminada que están incluidos en el
2017 estándar General MIDI, como el tom melódico, el tambor taiko, los
2018 tambores sintéticos, etc., no se pueden acceder a través del canal
2019 MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
2020 introducir también en un contexto normal de @code{Staff}, utilizando
2021 las alturas normales adecuadas.
2023 Muchos instrumentos de percusión no están incluidos dentro del
2024 estándar General MIDI standard, p.ej. las castañuelas. El método más
2025 fácil (aunque no satisfactorio) de producir una salida MIDI al
2026 escribir para estos instrumentos es sustituirlos por el sonido más
2027 parecido del conjunto estándar.
2029 @c TODO Expand with examples, and any other issues
2033 Debido a que el estándar General MIDI no contiene golpes de aro
2034 (@emph{rim shots}), para este propósito se utiliza en su lugar el
2035 golpe lateral de baqueta (@emph{sidestick}).