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