1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
4 Translation of GIT committish: 4ca01b6da8d60b0d8575be05ae974429c91becd5
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::
26 * Extraer información musical::
30 @node Estructura del código de entrada
31 @section Estructura del código de entrada
32 @translationof Input structure
34 El formato principal de entrada para LilyPond son archivos de texto.
35 Por convenio, el nombre de estos archivos termina en @file{.ly}.
38 * Estructura de una partitura::
39 * Varias partituras en un libro::
40 * Varios archivos de salida a partir de uno de entrada::
41 * Nombres de los archivos de salida::
42 * Estructura del archivo::
46 @node Estructura de una partitura
47 @subsection Estructura de una partitura
48 @translationof Structure of a score
52 Un bloque @code{\score} debe contener una expresión musical única
53 delimitada por un par de llaves:
62 @warning{Sólo puede haber @strong{una} expresión musical dentro del
63 bloque @code{\score}, y @strong{debe} estar encerrada entre llaves.}
65 Esta expresión musical única puede tener cualquier tamaño, y puede
66 contener otras expresiones musicales hasta cualquier grado de
67 complejidad. Todos los siguientes ejemplos son expresiones musicales:
73 @lilypond[verbatim,quote]
80 @lilypond[verbatim,quote]
82 \new Staff { c'4 c' c' c' }
83 \new Staff { d'4 d' d' d' }
91 \new Staff @{ \flute @}
92 \new Staff @{ \oboe @}
95 \new Staff @{ \violinI @}
96 \new Staff @{ \violinII @}
102 Los comentarios son una excepción a esta regla general (para ver otras
103 excepciones, consulte @ref{Estructura del archivo}). Tanto los comentarios de
104 una línea como los que están delimitados por @code{%@{ .. %@}} se
105 pueden escribir en cualquier lugar dentro del archivo de entrada. Se
106 pueden escribir dentro o fuera del bloque @code{\score}, y dentro o
107 fuera de la expresión musical única dentro del bloque @code{\score}.
109 Recuerde que incluso dentro de un archivo que contenga solamente un
110 bloque @code{\score}, éste se encuentra incluido implícitamente dentro
111 de un bloque @code{\book}. Un bloque @code{\book} dentro de un
112 archivo fuente produce al menos un archivo de salida, y de forma
113 predeterminada el nombre del archivo de salida que se produce está
114 derivado del nombre del archivo de entrada, de forma que
115 @file{fandangoforelephants.ly} da como resultado
116 @file{fandangoforelephants.pdf}.
118 (Para ver más detalles acerca de los bloques @code{\book}, consulte
119 @ref{Varias partituras en un libro}, @ref{Varios archivos de salida a
120 partir de uno de entrada} y @ref{Estructura del archivo}.)
123 Manual de aprendizaje:
124 @rlearning{Trabajar sobre los archivos de entrada},
125 @rlearning{Explicación de las expresiones musicales},
126 @rlearning{La partitura es una (única) expresión musical compuesta}.
129 @node Varias partituras en un libro
130 @subsection Varias partituras en un libro
131 @translationof Multiple scores in a book
134 @cindex movimientos, varios
136 Un documento puede contener varias piezas de música y texto. Son
137 ejemplos un libro de estudios o una parte orquestal con varios
138 movimientos. Cada movimiento se introduce con un bloque
147 y los textos se introducen con un bloque @code{\markup}:
157 Todos los movimientos y textos que aparecen en el mismo archivo
158 @file{.ly} se tipografían normalmente en la forma de un solo archivo
173 Una excepción importante se da dentro de los documentos de
174 lilypond-book, en los que tenemos que escribir explícitamente un
175 bloque @code{\book}, pues en caso contrario sólo aparecerá en la
176 salida el primer @code{\score} o @code{\markup}.
178 El encabezamiento de cada pieza se puede poner dentro del bloque
179 @code{\score}. Antes de cada movimiento, se imprime el nombre de la
180 pieza (@code{piece}) extraído del encabezamiento. El título del libro
181 entero se puede poner dentro del bloque @code{\book}, pero si no está
182 presente se inserta el encabezamiento @code{\header} que está al
183 principio del archivo.
187 title = "Ocho miniaturas"
188 composer = "Igor Stravinsky"
192 \header @{ piece = "Romanze" @}
195 ..texto de la segunda estrofa..
198 ..texto de la tercera estrofa..
202 \header @{ piece = "Menuetto" @}
209 Se pueden agrupar distintas piezas de música en partes de un libro
210 utilizando bloques @code{\bookpart}. Las partes de libro se separan
211 por medio de saltos de página, y pueden dar comienzo con un título,
212 como el libro propiamente dicho, mediante la especificación del bloque
218 title = "Título del libro"
219 subtitle = "Primera parte"
226 subtitle = "Segunda parte"
233 @node Varios archivos de salida a partir de uno de entrada
234 @subsection Varios archivos de salida a partir de uno de entrada
235 @translationof Multiple output files from one input file
237 Si queremos varios archivos de salida a partir del mismo archivo
238 @file{.ly}, podemos escribir varios bloques @code{\book}, donde cada
239 uno de estos bloques @code{\book} dará como resultado un archivo de
240 salida distinto. Si no especificamos ningún bloque @code{\book} en el
241 archivo, LilyPond trata implícitamente todo el archivo como un solo
242 bloque @code{\book}, véase @ref{Estructura del archivo}.
244 Al producir varios archivos a partir de un solo archivo fuente,
245 Lilypond se asegura de que ninguno de los archivos de salida de ningún
246 bloque @code{\book} sobreescribe el archivo de salida producido por un
247 @code{\book} anterior del mismo archivo de entrada.
249 Lo hace añadiendo un sufijo al nombre de la salida para cada libro
250 @code{\book} que utiliza el nombre del archivo de salida
251 predeterminado, derivado del archivo fuente de entrada.
253 El comportamiento predeterminado es añadir un sufijo con el número de
254 versión para cada nombre que pueda coincidir; así:
259 \layout @{ @dots{} @}
263 \layout @{ @dots{} @}
267 \layout @{ @dots{} @}
271 en el archivo fuente @file{eightminiatures.ly}, produce
275 @file{eightminiatures.pdf},
277 @file{eightminiatures-1.pdf} y
279 @file{eightminiatures-2.pdf}.
282 @node Nombres de los archivos de salida
283 @subsection Nombres de los archivos de salida
284 @translationof Output file names
286 @funindex \bookOutputSuffix
287 @funindex \bookOutputName
289 Lilypond le ofrece unos mecanismos que le permiten controlar los
290 nombres de archivo que se utilizan por parte de los diversos motores
291 finales al producir los archivos de salida.
293 En la sección anterior vimos cómo Lilypond evita las coincidencias de
294 nombres al producir varias salidas a partir de un único archivo fuente
295 de entrada. También podemos especificar nuestros propios sufijos para
296 cada bloque @code{\book}, de manera que podemos producir, por ejemplo,
297 archivos con los nombres @file{eightminiatures-Romanze.pdf},
298 @file{eightminiatures-Menuetto.pdf} y
299 @file{eightminiatures-Nocturne.pdf} añadiendo una declaración
300 @code{\bookOutputSuffix} dentro de cada bloque @code{\book}.
304 \bookOutputSuffix "Romanze"
306 \layout @{ @dots{} @}
309 \bookOutputSuffix "Menuetto"
311 \layout @{ @dots{} @}
314 \bookOutputSuffix "Nocturne"
316 \layout @{ @dots{} @}
320 También podemos especificar un nombre de archivo de salida diferente
321 para cada bloque @code{book}, mediante la utilización de declaraciones
322 @code{\bookOutputName}:
326 \bookOutputName "Romanze"
328 \layout @{ @dots{} @}
331 \bookOutputName "Menuetto"
333 \layout @{ @dots{} @}
336 \bookOutputName "Nocturne"
338 \layout @{ @dots{} @}
342 El código anterior produce los siguientes archivos de salida:
348 @file{Menuetto.pdf} y
353 @node Estructura del archivo
354 @subsection Estructura del archivo
355 @translationof File structure
365 Un archivo @file{.ly} puede contener cualquier número de expresiones
366 del nivel superior, donde una expresión del nivel superior es una de
367 las siguientes posibilidades:
371 Una definición de salida, como @code{\paper}, @code{\midi} y
372 @code{\layout}. Tal definición en el nivel más alto cambia los
373 ajustes predeterminados para todo el libro. Si se introduce más de
374 una de estas definiciones del mismo tipo en el nivel más alto,
375 cualquier definición en una expresión posterior tiene prioridad.
378 Una expresión directa de Scheme, como
379 @code{#(set-default-paper-size "a7" 'landscape)} o
380 @code{#(ly:set-option 'point-and-click #f)}.
383 Un bloque @code{\header}. Esto establece el bloque de encabezamiento
384 global. Es el bloque que contiene las definiciones de los ajustes
385 para todo el libro, como el compositor, título, etc.
388 Un bloque @code{\score}. Esta partitura se reúne con otras partituras
389 del nivel superior, y se combina con ellas formando un @code{\book}
390 (libro) único. Este comportamiento se puede cambiar estableciendo el
391 valor de la variable @code{toplevel-score-handler} en el nivel
392 superior. El @emph{handler} predeterminado se define en el archivo de
393 inicio @file{../scm/lily.scm}.
396 Un bloque @code{\book} combina lógicamente varios movimientos (es
397 decir, varios bloques @code{\score}) en un solo documento. Si hay
398 varias partituras @code{\score}, se crea un solo archivo de salida
399 para cada bloque @code{\book}, en el que se concatenan todos los
400 movimientos correspondientes. La única razón para especificar
401 explícitamente bloques @code{\book} en un archivo de entrada
402 @file{.ly} es si queremos crear varios archivos de salida a partir de
403 un único archivo de entrada. Una excepción se da dentro de los
404 documentos de lilypond-book, en los que tenemos que escribir
405 explícitamente un bloque @code{\book} si queremos tener más de una
406 única partitura @code{\score} o marcado @code{\markup} en el mismo
407 ejemplo. Se puede cambiar este comportamiento estableciendo el valor
408 de la variable @code{toplevel-book-handler} en el nivel superior. El
409 @emph{handler} predeterminado se define en el archivo de inicio
410 @file{../scm/lily.scm}.
413 Un bloque @code{\bookpart}. Un libro puede dividirse en varias
414 partes, utilizando bloques @code{\bookpart}, con objeto de facilitar
415 la inserción de saltos de página o usar distintos ajustes de
416 @code{\paper} en las distintas partes.
419 Una expresión musical compuesta, como
424 Esto añade la pieza al @code{\score} y la conforma dentro de un libro
425 único junto a todas las demás partituras @code{\score} y expresiones
426 musicales del nivel superior. En otras palabras, un archivo que
427 contiene sólo la expresión musical anterior se traduce a
443 Se puede cambiar este comportamiento estableciendo el valor de la
444 variable @code{toplevel-music-handler} en el nivel más alto. El
445 @emph{handler} predeterminado se define en el archivo de inicio
446 @file{../scm/lily.scm}.
449 Un texto de marcado, por ejemplo una estrofa
452 2. Estrofa dos, línea uno
456 Los textos de marcado se colocan encima, en medio o debajo de las
457 partituras o expresiones musicales, según donde aparezcan escritos.
464 fulano = @{ c4 d e d @}
467 Esto se puede utilizar más tarde en el archivo escribiendo
468 @code{\fulano}. El nombre de las variables ha de ser exclusivamente
469 alfabético; sin números, guiones ni barras bajas.
473 El ejemplo siguiente muestra tres cosas que se pueden introducir en el
478 % No justificar la salida
489 En cualquier punto del archivo se pueden introducir cualquiera de las
490 instrucciones léxicas siguientes:
493 @item @code{\version}
494 @item @code{\include}
495 @item @code{\sourcefilename}
496 @item @code{\sourcefileline}
498 Un comentario de una línea, determinado por un símbolo @code{%} al principio.
501 Un comentario de varias líneas, delimitado por @code{%@{ .. %@}}.
505 @cindex espacios en blanco
507 Por lo general se ignoran los espacios entre elementos del flujo de
508 entrada, y se pueden omitir o aumentar tranquilamente para mejorar la
509 legibilidad. Sin embargo, los espacios se deben utilizar siempre para
510 evitar errores, en las siguientes situaciones:
513 @item Alrededor de todas y cada una de las llaves curvas de apertura y cierre.
514 @item A continuación de las instrucciones y variables, es decir, todos los elementos
515 que comienzan con un signo @code{\} de barra invertida.
516 @item A continuación de todo elemento que se deba interpretar como expresión
517 de Scheme, es decir, todo elemento que comience por un signo@tie{}@code{#}.
518 @item Para separar los elementos de una expresión de Scheme.
519 @item Dentro de @code{lyricmode} para separar todos los términos de las instrucciones
520 @code{\override} y @code{\set}. Concretamente, hay que usar espacios
521 alrededor del punto y el signo igual en instrucciones como
522 @code{\override Score . LyricText #'font-size = #5} y antes y después
523 de la instrucción completa.
528 Manual de aprendizaje:
529 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}.
532 @node Títulos y cabeceras
533 @section Títulos y cabeceras
534 @translationof Titles and headers
536 Casi toda la música impresa tiene un título y el nombre del
537 compositor; ciertas piezas tienen mucha más información.
540 * Crear títulos cabeceras y pies de página::
541 * Cabeceras pies y títulos personalizados::
542 * Referencia a números de página::
547 @node Crear títulos cabeceras y pies de página
548 @subsection Crear títulos, cabeceras y pies de página
549 @translationof Creating titles headers and footers
552 * Explicación de los bloques de títulos::
553 * Presentación predeterminada de los bloques de título del libro y la partitura::
554 * Disposición predeterminada de las cabeceras y pies de página::
558 @node Explicación de los bloques de títulos
559 @unnumberedsubsubsec Explicación de los bloques de títulos
560 @translationof Title blocks explained
562 @c TODO: figure out how \bookpart titles work
564 Existen dos clases de bloques de títulos: el bloque principal de
565 títulos que aparece encima del primer bloque @code{\score} de un
566 libro, y los bloques individuales de título que aparecen dentro de
567 cada bloque @code{\score}. Los campos de texto para los dos tipos de
568 bloque se introducen mediante un bloque @code{\header}.
570 Si el libro tiene una única partitura, el bloque @code{\header} se
571 puede situar dentro o fuera del bloque @code{\score}.
573 @warning{Recuerde que al añadir un bloque @bs{}@code{header} dentro de
574 un bloque @bs{}@code{score}, la expresión musical debe aparecer antes
575 del bloque @bs{}@code{header}.}
577 @lilypond[papersize=a5,quote,verbatim,noragged-right]
580 composer = "J. S. Bach."
584 \new Staff \relative g, {
587 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
588 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
596 \new Staff \relative b {
600 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
601 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
609 Los campos de texto extraídos del bloque prinicipal de título de un
610 libro se pueden imprimir en todos los bloques @code{\score}, o
611 suprimirse manualmente:
613 @lilypond[papersize=a5,quote,verbatim,noragged-right]
616 print-all-headers = ##t
619 title = "DAS WOHLTEMPERIRTE CLAVIER"
621 % Do not display the tagline for this book
624 \markup { \vspace #1 }
628 \new Staff { \clef "bass" s1 }
631 title = "PRAELUDIUM I"
633 % Do not display the subtitle for this score
640 \new Staff { \clef "bass" s1 }
644 subsubtitle = "A 4 VOCI"
646 % Do not display the subtitle for this score
654 Referencia de la notación:
655 @ref{Estructura del archivo},
656 @ref{Personalización de los bloques de título}.
659 @node Presentación predeterminada de los bloques de título del libro y la partitura
660 @unnumberedsubsubsec Presentación predeterminada de los bloques de título del libro y la partitura
661 @translationof Default layout of book and score title blocks
663 La disposición y formato de los bloques de título están controlados
664 por medio de dos variables de @code{\paper}: @code{bookTitleMarkup}
665 para el bloque de título @code{\header} principal y
666 @code{scoreTitleMarkup} para los bloques @code{\header} individuales
667 dentro de un bloque @code{\score}.
669 @lilypond[papersize=a6,quote,verbatim,noragged-right]
671 % The following fields are centered
672 dedication = "Dedication"
674 subtitle = "Subtitle"
675 subsubtitle = "Subsubtitle"
676 instrument = "Instrument"
678 % The following fields are left-aligned on the left side
682 % The following fields are right-aligned on the right side
683 composer = "Composer"
684 arranger = "Arranger"
690 % The following fields are placed at opposite ends of the same line
697 @c Is the bit about \null markups true? -mp
699 Los campos de texto que se dejan sin establecer dentro de un bloque
700 @code{\header} se sustituyen por elementos de marcado nulos
701 @code{\null} de manera que no ocupen espacio innecesariamente.
703 Los ajustes predeterminados para @code{scoreTitleMarkup} sitúan los
704 campos de texto @code{piece} y @code{opus} en extremos opuestos de la
709 Utilice la variable @code{breakbefore} dentro de un bloque
710 @code{\header} que está propiamente dentro de un bloque @code{\score}
711 para hacer que los títulos del bloque @code{\header} del nivel
712 superior aparezcan ocupando toda la primera página, empezando la
713 música (definida en el bloque @code{\score}) en la página siguiente.
715 @lilypond[papersize=a8landscape,verbatim,noragged-right]
718 title = "This is my Title"
719 subtitle = "This is my Subtitle"
720 copyright = "This is the bottom of the first page"
723 \repeat unfold 4 { e'' e'' e'' e'' }
725 piece = "This is the Music"
733 Manual de aprendizaje:
734 @rlearning{Cómo funcionan los archivos de entrada de LilyPond}
736 Referencia de la notación:
737 @ref{Estructura del archivo}.
740 @file{ly/titling-init.ly}.
742 @node Disposición predeterminada de las cabeceras y pies de página
743 @unnumberedsubsubsec Disposición predeterminada de las cabeceras y pies de página
744 @translationof Default layout of headers and footers
746 Las @emph{cabeceras} y los @emph{pies} de página son líneas de texto
747 que aparecen en la parte más alta y en la más baja de las páginas
748 separadas del texto principal de un libro. Se controlan mediante las
749 siguientes variables de @code{\paper}:
752 @item @code{oddHeaderMarkup} (marcado de cabecera impar)
753 @item @code{evenHeaderMarkup} (marcado de cabecera par)
754 @item @code{oddFooterMarkup} (marcado de pie impar)
755 @item @code{evenFooterMarkup} (marcado de pie par)
758 Estas variables de marcado sólo pueden acceder a los campos de texto
759 extraídos de bloques @code{\header} del nivel superior (que se aplican
760 a todas las partituras del libro) y se definen en el archivo
761 @file{ly/titling-init.ly}. De forma predeterminada:
766 los números de página se sitúan automáticamente en el extremo superior
767 izquierdo (si es par) o superior derecho (si es impar), a partir de la
771 el campo de texto @code{instrument} se sitúa en el centro en cada
772 página, a partir de la segunda página.
775 el texto de @code{copyright} se centra en la parte baja de la primera
779 la línea @code{tagline} se centra al final de la última página, y
780 debajo del texto de @code{copyright} si sólo hay una página.
784 @lilypond[papersize=a8landscape]
794 La línea de etiqueta tagline predeterminada se puede cambiar añadiendo un campo
795 @code{tagline} en el bloque @code{\header} del nivel superior.
797 @lilypond[papersize=a8landscape,verbatim]
800 tagline = "... music notation for Everyone"
810 Para eliminar la línea @code{tagline}, establezca su valor a
814 @node Cabeceras pies y títulos personalizados
815 @subsection Cabeceras, pies y títulos personalizados
816 @translationof Custom headers footers and titles
818 @c TODO: somewhere put a link to header spacing info
819 @c (you'll have to explain it more in NR 4).
822 * Formateo personalizado del texto de los bloques de título::
823 * Personalización de los bloques de título::
824 * Disposición personalizada de cabeceras y pies de página::
828 @node Formateo personalizado del texto de los bloques de título
829 @unnumberedsubsubsec Formateo personalizado del texto de los bloques de título
830 @translationof Custom text formatting for title blocks
832 Se pueden usar instrucciones @code{\markup} estándar para personalizar
833 el texto de cualquier cabecera, pie o título dentro del bloque
836 @lilypond[quote,verbatim,noragged-right]
840 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
841 subtitle = \markup { \italic "(Excerpt)" }
847 Referencia de la notación:
848 @ref{Formatear el texto}.
851 @node Personalización de los bloques de título
852 @unnumberedsubsubsec Personalización de los bloques de título
853 @translationof Custom layout for title blocks
855 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
856 útiles para dar un formato simple al texto, pero no permiten un
857 control preciso sobre la colocación de los títulos. Para personalizar
858 la colocación de los campos de texto, use una o las dos variables de
859 @code{\paper} siguientes:
862 @item @code{bookTitleMarkup} (marcado de título del libro)
863 @item @code{scoreTitleMarkup} (marcado de título de la partitura)
866 Estas variables de marcado se estudian en
867 @ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
869 Los ajustes predeterminados para @code{scoreTitleMarkup} tal y como
870 están definidos en el archivo @file{ly/titling-init.ly} son:
873 scoreTitleMarkup = \markup @{ \column @{
874 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
876 \fromproperty #'header:piece
877 \fromproperty #'header:opus
883 Esto sitúa los campos de texto @code{piece} y @code{opus} en extremos
884 opuestos de la misma línea:
886 @lilypond[quote,verbatim,noragged-right]
890 piece = "PRAELUDIUM I"
896 Este ejemplo redefine @code{scoreTitleMarkup} de manera que el campo
897 de texto @code{piece} aparece centrado y en un tipo de letra grande y
900 @lilypond[papersize=a5,quote,verbatim,noragged-right]
904 scoreTitleMarkup = \markup {
907 \fontsize #4 \bold \fromproperty #'header:piece
908 \fromproperty #'header:opus
912 \header { tagline = ##f }
916 piece = "PRAELUDIUM I"
923 Los campos de texto reservados normalmente para el bloque principal de
924 título se pueden insertar dentro de los bloques de título de las
925 partituras individuales con la variable @code{print-all-headers}
926 establecida dentro del bloque @code{\paper}. Una desventaja de la
927 utilización de este método es que los campos de texto que están
928 orientados específicamente para el bloque @code{\header} del nivel
929 superior han de suprimirse manualmente en cada uno de los bloques
930 @code{\score}. Véase @ref{Explicación de los bloques de títulos}.
932 Para evitarlo, añada el campo de texto deseado a la definición de
933 @code{scoreTitleMarkup}. En el ejemplo siguiente, el campo de texto
934 @code{composer} (asociado normalmente con @code{bookTitleMarkup}) se
935 añade a @code{scoreTitleMarkup}, permitiendo que cada partitura
936 muestre un compositor diferente:
938 @lilypond[papersize=a5,quote,verbatim,noragged-right]
942 scoreTitleMarkup = \markup {
945 \fontsize #4 \bold \fromproperty #'header:piece
946 \fromproperty #'header:composer
950 \header { tagline = ##f }
955 composer = "Christian Petzold"
962 composer = "François Couperin"
968 También podemos crear nuestros propios campos de texto personalizados,
969 y referirnos a ellos en la definición del elemento de marcado.
971 @lilypond[papersize=a5,quote,verbatim,noragged-right]
975 scoreTitleMarkup = \markup {
978 \override #`(direction . ,UP) {
980 \center-align \fontsize #-1 \bold
981 \fromproperty #'header:mycustomtext %% User-defined field
982 \center-align \fontsize #4 \bold
983 \fromproperty #'header:piece
986 \fromproperty #'header:opus
990 \header { tagline = ##f }
995 mycustomtext = "A 4 VOCI" %% User-defined field
1003 Referencia de la notación:
1004 @ref{Explicación de los bloques de títulos}.
1007 @node Disposición personalizada de cabeceras y pies de página
1008 @unnumberedsubsubsec Disposición personalizada de cabeceras y pies de página
1009 @translationof Custom layout for headers and footers
1011 @c can make-header and make-footer be removed from
1012 @c paper-defaults-init.ly? -mp
1014 Las instrucciones @code{\markup} dentro del bloque @code{\header} son
1015 de utilidad para dar formato al texto de una manera sencilla, pero no
1016 permiten un control preciso sobre la colocación de las cabeceras y los
1017 pies de página. Para personalizar la colocación de los campos de
1018 texto, use una o más de las siguientes variables de @code{\paper}:
1021 @item @code{oddHeaderMarkup} (marcado de encabezamiento impar)
1022 @item @code{evenHeaderMarkup} (marcado de encabezamiento par)
1023 @item @code{oddFooterMarkup} (marcado de pie de página impar)
1024 @item @code{evenFooterMarkup} (marcado de pie de página par)
1027 El ejemplo siguiente centra los números de página en la parte baja de
1028 las páginas. En primer lugar, los ajustes predeterminados para
1029 @code{oddHeaderMarkup} y @code{evenHeaderMarkup} se eliminan
1030 definiéndolos como un marcado @emph{nulo}. Después de esto, se
1031 redefine @code{oddFooterMarkup} con el número de página centrado.
1032 Finalmente, @code{evenFooterMarkup} recibe la misma disposición
1033 definiéndola como @code{\oddFooterMarkup}:
1035 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1038 print-page-number = ##t
1039 print-first-page-number = ##t
1040 oddHeaderMarkup = \markup \null
1041 evenHeaderMarkup = \markup \null
1042 oddFooterMarkup = \markup {
1044 \on-the-fly #print-page-number-check-first
1045 \fromproperty #'page:page-number-string
1048 evenFooterMarkup = \oddFooterMarkup
1051 \new Staff { s1 \break s1 \break s1 }
1058 @ref{Explicación de los bloques de títulos},
1059 @ref{Presentación predeterminada de los bloques de título del libro y la partitura}.
1062 @node Referencia a números de página
1063 @subsection Referencia a números de página
1064 @translationof Reference to page numbers
1066 Un lugar determinado de una partitura puede señalizarse usando la
1067 instrucción @code{\label} (etiqueta), ya sea en el nivel superior o
1068 dentro de la música. Podemos referirnos a esta etiqueta más tarde
1069 dentro de un elemento de marcado, para obtener el número de la página
1070 en la que se sitúa el punto señalizado, usando la instrucción de
1071 marcado @code{\page-ref}.
1074 \header { tagline = ##f }
1080 \pageBreak \mark A \label #'markA
1084 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
1085 \markup { Mark A is on page \page-ref #'markA "0" "?" }
1089 La instrucción de marcado @code{\page-ref} toma tres argumentos:
1091 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
1092 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
1093 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
1096 El motivo de que se necesite un medidor es que en el momento en que se
1097 están interpretando los marcados, los saltos de página aún no se han
1098 producido y por tanto los números de página no se conocen todavía.
1099 Para sortear este inconveniente, la interpretación real del marcado se
1100 retrasa hasta un momento posterior; sin embargo, las dimensiones del
1101 marcado se tienen que conocer de antemano, así que se usa el medidor
1102 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
1103 páginas, el medidor puede ser "00", es decir, un número de dos
1115 @node Índice general
1116 @subsection Índice general
1117 @translationof Table of contents
1119 Se puede insertar un índice general o tabla de contenidos utilizando
1120 la instrucción @code{\markuplines \table-of-contents}. Los elementos
1121 que deben aparecer en la tabla de contenidos se introducen con la
1122 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
1123 la jerarquía del código, o dentro de una expresión musical.
1126 \markuplines \table-of-contents
1129 \tocItem \markup "Primera partitura"
1133 \tocItem \markup "Un punto concreto dentro de la primera partitura"
1138 \tocItem \markup "Segunda partitura"
1146 Los elementos de marcado que se usan para dar formato al índice
1147 general se encuentran definidos dentro del bloque @code{\paper}. Los
1148 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
1149 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
1150 los elementos del índice, que consisten en el título del elemento y el
1151 número de página. Estas variables se pueden cambiar por parte del
1156 %% Traducir el título del índice al español:
1157 tocTitleMarkup = \markup \huge \column {
1158 \fill-line { \null "Índice general" \null }
1161 %% usar una fuente mayor
1162 tocItemMarkup = \markup \large \fill-line {
1163 \fromproperty #'toc:text \fromproperty #'toc:page
1168 Observe la forma en que nos referimos al texto y al número de página
1169 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
1171 También se pueden definir nuevas instrucciones y elementos de
1172 marcado para crear índices generales más elaborados:
1174 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
1175 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
1176 utilizando esta variable de marcado del bloque @code{\paper}.
1179 En el ejemplo siguiente se define un estilo nuevo para introducir los
1180 nombres de los actos de una ópera en el índice general:
1184 tocActMarkup = \markup \large \column {
1186 \fill-line { \null \italic \fromproperty #'toc:text \null }
1192 #(define-music-function (parser location text) (markup?)
1193 (add-toc-item! 'tocActMarkup text))
1196 @lilypond[line-width=11.0\cm]
1197 \header { tagline = ##f }
1199 tocActMarkup = \markup \large \column {
1201 \fill-line { \null \italic \fromproperty #'toc:text \null }
1207 #(define-music-function (parser location text) (markup?)
1208 (add-toc-item! 'tocActMarkup text))
1211 \markuplines \table-of-contents
1212 \tocAct \markup { Atto Primo }
1213 \tocItem \markup { Coro. Viva il nostro Alcide }
1214 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1215 \tocAct \markup { Atto Secondo }
1216 \tocItem \markup { Sinfonia }
1217 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1222 Se pueden añadir puntos de relleno entre un elemento y su número de página:
1224 @lilypond[verbatim,quote]
1225 \header { tagline = ##f }
1227 tocItemMarkup = \tocItemWithDotsMarkup
1231 \markuplines \table-of-contents
1232 \tocItem \markup { Allegro }
1233 \tocItem \markup { Largo }
1241 @file{../ly/toc-init.ly}.
1245 @funindex \table-of-contents
1246 @code{\table-of-contents},
1252 @node Trabajar sobre los archivos de entrada
1253 @section Trabajar sobre los archivos de entrada
1254 @translationof Working with input files
1257 * Inclusión de archivos de LilyPond::
1258 * Distintas ediciones a partir de una misma fuente::
1259 * Codificación del texto::
1263 @node Inclusión de archivos de LilyPond
1264 @subsection Inclusión de archivos de LilyPond
1265 @translationof Including LilyPond files
1268 @cindex including files
1270 Un proyecto grande se puede dividir en varios archivos. Para
1271 referirse a otro archivo, utilice
1274 \include "otroarchivo.ly"
1277 La línea @code{\include "otroarchivo.ly"} equivale a pegar todo el
1278 contenido de @file{otroarchivo.ly} en el archivo actual en el lugar en
1279 que aparece el @code{\include}. Por ejemplo, en un proyecto grande
1280 podríamos querer archivos distintos para cada parte instrumental y
1281 crear un archivo de @qq{partitura completa} que reúne los archivos
1282 individuales de los instrumentos. Normalmente el archivo incluido
1283 define un cierto número de variables que a partir de entonces quedan
1284 disponibles para poderlas utilizar en el archivo de la partitura
1285 completa. En los archivos incluidos se pueden marcar las secciones
1286 etiquetadas para ayudar a hacerlas utilizables en distintos lugares de
1287 la partitura, véase @ref{Distintas ediciones a partir de una misma fuente}.
1289 Los archivos que están en el directorio de trabajo actual se pueden
1290 referenciar simplemente especificando el nombre después de la
1291 instrucción @code{\include}. Los archivos en otros lugares se pueden
1292 incluir proporcionando una referencia de ruta completa o una ruta
1293 relativa (pero utilice la barra inclinada normal del UNIX, /, no la
1294 barra invertida de DOS/Windows, \, como separador de directorio). Por
1295 ejemplo, si @file{material.ly} está situado un directorio por encima
1296 del directorio de trabajo actual, utilice
1299 \include "../material.ly"
1303 o si los archivos de las partes orquestales incluidas están todos
1304 situados en un subdirectorio llamado @file{partes} dentro del
1305 directorio actual, use
1308 \include "partes/VI.ly"
1309 \include "partes/VII.ly"
1313 Los archivos de inclusión también pueden contener enunciados
1314 @code{\include} a su vez. De forma predeterminada, estos enunciados
1315 @code{\include} de segundo nivel no se interpretan hasta que se
1316 incorporan al archivo principal, por lo que los nombres de archivo que
1317 especifican deben ser relativos al directorio que contiene el archivo
1318 principal, no al directorio que contiene el archivo incluido. Sin
1319 embargo, este comportamiento se puede modificar pasando la opción
1320 @option{-drelative-includes} en la línea de órdenes (o mediante la
1321 adición de @code{#(ly:set-option 'relative-includes #t)} al principio
1322 del archivo principal de entrada). Con el valor de
1323 @code{relative-includes} establecido, la ruta de cada instrucción
1324 @code{\include} se considera relativa al archivo que contiene dicha
1325 instrucción. Este comportamiento es el recomendado y se convertirá en
1326 el comportamiento predeterminado en una versión futura de lilypond.
1328 También se pueden incluir archivos de un directorio que está en una
1329 ruta de búsqueda especificada como opción al invocar a LilyPond desde
1330 la línea de órdenes. Los archivos incluidos se especifican usando
1331 solamente su nombre de archivo. Por ejemplo, para compilar mediante
1332 este método un archivo @file{principal.ly} que incluye archivos
1333 situados en un subdirectorio llamado @file{partes}, cambie al
1334 directorio que contiene @file{principal.ly} e introduzca
1337 lilypond --include=partes principal.ly
1340 y en @file{principal.ly} escriba
1348 Los archivos que se incluyen en muchas partituras se pueden poner en
1349 el directorio de LilyPond @file{../ly} (la localización de este
1350 directorio depende de la instalación: véase
1351 @rlearning{Otras fuentes de información}). Estos archivos se pueden
1352 incluir sencillamente por su nombre en un enunciado @code{\include}.
1353 De esta forma se incluyen los archivos dependientes del idioma como
1356 LilyPond incluye de forma predeterminada ciertos archivos cuando se
1357 inicia el programa. Estas inclusiones no son visibles para el
1358 usuario, pero los archivos se pueden identificar ejecutando
1359 @code{lilypond --verbose} desde la línea de órdenes. Esto presentará
1360 una lista de rutas y archivos que utiliza LilyPond, junto a muchas
1361 otras indicaciones. De forma alternativa, pueden verse explicaciones
1362 sobre los archivos más importantes de este conjunto en
1363 @rlearning{Otras fuentes de información}. Estos archivos se pueden
1364 editar, pero los cambios realizados sobre ellos se perderán al
1365 instalar una nueva versión de LilyPond.
1367 Pueden verse ejemplos sencillos sobre el uso de @code{\include} en
1368 @rlearning{Partituras y particellas}.
1372 Manual de aprendizaje:
1373 @rlearning{Otras fuentes de información},
1374 @rlearning{Partituras y particellas}.
1379 Si un archivo incluido recibe un nombre igual al de uno de los
1380 archivos de instalación de LilyPond, el archivo que tiene prioridad es
1381 el de los archivos de instalación de LilyPond.
1384 @node Distintas ediciones a partir de una misma fuente
1385 @subsection Distintas ediciones a partir de una misma fuente
1386 @translationof Different editions from one source
1388 Se encuentran disponibles varios mecanismos para facilitar la
1389 producción de distintas versiones de una partitura a partir de la
1390 misma fuente musical. Las variables son quizá más útiles para
1391 combinar secciones extensas de música y/o anotaciones de diversas
1392 formas, mientras que las etiquetas son más útiles para seleccionar una
1393 de entra varias secciones de música más cortas. Cualquiera que sea el
1394 método utilizado, la separación de la notación de la estructura de la
1395 partitura hará que sea más fácil cambiar la estructura dejando intacta
1399 * Uso de las variables::
1400 * Uso de etiquetas::
1401 * Uso de ajustes globales::
1404 @node Uso de las variables
1405 @unnumberedsubsubsec Uso de las variables
1406 @translationof Using variables
1408 @cindex variables, uso de las
1410 Si las secciones de la música se definen dentro de variables, se
1411 pueden reutilizar en distintas partes de la partitura, véase
1412 @rlearning{Organizar las piezas mediante variables}. Por ejemplo, una
1413 partitura vocal @notation{a cappella} con frecuencia incluye una
1414 reducción de piano de las partes para ensayar que es idéntica a la
1415 música vocal, por lo que ésta sólo se tiene que escribir una vez. Se
1416 puede combinar sobre un solo pentagrama la música de dos variables,
1417 véase @ref{Combinación automática de las partes}. He aquí un ejemplo:
1419 @lilypond[verbatim,quote]
1420 sopranoMusic = \relative c'' { a4 b c b8( a) }
1421 altoMusic = \relative g' { e4 e e f }
1422 tenorMusic = \relative c' { c4 b e d8( c) }
1423 bassMusic = \relative c' { a4 gis a d, }
1424 allLyrics = \lyricmode {King of glo -- ry }
1426 \new Staff = "Soprano" \sopranoMusic
1427 \new Lyrics \allLyrics
1428 \new Staff = "Alto" \altoMusic
1429 \new Lyrics \allLyrics
1430 \new Staff = "Tenor" {
1434 \new Lyrics \allLyrics
1435 \new Staff = "Bass" {
1439 \new Lyrics \allLyrics
1442 \set Staff.printPartCombineTexts = ##f
1448 \set Staff.printPartCombineTexts = ##f
1458 Se pueden producir partituras distintas que presenten sólo las partes
1459 vocales o sólo la parte de piano, cambiando solamente los enunciados
1460 estructurales, sin modificar la notación musical.
1462 Para partituras extensas, las definiciones de variable se pueden poner
1463 en archivos separados que se incluyen más tarde, véase @ref{Inclusión de archivos de LilyPond}.
1466 @node Uso de etiquetas
1467 @unnumberedsubsubsec Uso de etiquetas
1468 @translationof Using tags
1471 @funindex \keepWithTag
1472 @funindex \removeWithTag
1474 @cindex mantener música etiquetada
1475 @cindex quitar música etiquetada
1477 La instrucción @code{\tag #'@var{parteA}} marca una expresión musical
1478 con el nombre @var{parteA}. Las expresiones etiquetadas de esta
1479 manera se pueden seleccionar o filtrar más tarde por su nombre, usando
1480 bien @code{\keepWithTag #'@var{nombre}} o bien @code{\removeWithTag
1481 #'@var{nombre}}. El resultado de la aplicación de estos filtros a la
1482 música etiquetada es como sigue:
1484 @multitable @columnfractions .5 .5
1488 Música etiquetada precedida de @code{\keepWithTag #'@var{nombre}}
1490 Se incluye la música no etiquetada y la música etiquetada con
1491 @var{nombre}; se excluye la música etiquetada con cualquier otro
1494 Música etiquetada precedida de @code{\removeWithTag #'@var{nombre}}
1496 Se incluye la música no etiquetada y la música etiquetada con
1497 cualquier nombre de etiqueta distinto a @var{nombre}; se excluye la
1498 música etiquetada con @var{nombre}.
1500 Música etiquetada no precedida de @code{\keepWithTag} ni de
1501 @code{\removeWithTag}
1502 @tab Se incluye toda la música etiquetada y no etiquetada.
1505 Los argumentos de las instrucciones @code{\tag}, @code{\keepWithTag} y
1506 @code{\removeWithTag} deben ser un símbolo (como @code{#'partitura} o
1507 @code{#'parte}), seguido de una expresión musical.
1509 En el ejemplo siguiente vemos dos versiones de una pieza musical, una
1510 que muestra trinos con la notación usual y otra con los trinos
1511 expandidos explícitamente:
1513 @lilypond[verbatim,quote]
1514 music = \relative g' {
1516 \tag #'trills { d8.\trill }
1517 \tag #'expand { \repeat unfold 3 { e32 d } }
1522 \keepWithTag #'trills \music
1525 \keepWithTag #'expand \music
1530 De forma alternativa, a veces es más fácil excluir secciones de música:
1532 @lilypond[verbatim,quote]
1533 music = \relative g' {
1535 \tag #'trills { d8.\trill }
1536 \tag #'expand {\repeat unfold 3 { e32 d } }
1541 \removeWithTag #'expand
1545 \removeWithTag #'trills
1550 El filtrado con etiquetas se puede aplicar a articulaciones, textos,
1554 -\tag #'@var{mi-etiqueta}
1557 a una articulación. Por ejemplo, esto define una nota con una
1558 indicación opcional de digitación y una nota con una anotación
1563 c1-\tag #'warn ^"¡Ojo!"
1566 Se pueden poner varias etiquetas sobre expresiones con varias entradas
1569 @lilypond[quote,verbatim]
1570 music = \relative c'' {
1571 \tag #'a \tag #'both { a4 a a a }
1572 \tag #'b \tag #'both { b4 b b b }
1575 \keepWithTag #'a \music
1576 \keepWithTag #'b \music
1577 \keepWithTag #'both \music
1581 Se pueden aplicar varios filtros @code{\removeWithTag} a una sola
1582 expresión musical para quitar varias secciones etiquetadas con nombres
1585 @lilypond[verbatim,quote]
1586 music = \relative c'' {
1587 \tag #'A { a4 a a a }
1588 \tag #'B { b4 b b b }
1589 \tag #'C { c4 c c c }
1590 \tag #'D { d4 d d d }
1599 Dos o más filtros @code{\keepWithTag} aplicados a una sola expresión
1600 musical producen la eliminación de @emph{todas} las secciones
1601 etiquetadas, porque el primer filtro quita todas las secciones
1602 etiquetadas excepto la que se nombra, y el segundo filtro elimina
1603 incluso esa sección etiquetada.
1607 Manual de aprendizaje:
1608 @rlearning{Organizar las piezas mediante variables}.
1610 Referencia de la notación:
1611 @ref{Combinación automática de las partes},
1612 @ref{Inclusión de archivos de LilyPond}.
1616 @c This warning is more general than this placement implies.
1617 @c Rests are not merged whether or not they come from tagged sections.
1618 @c Should be deleted? -td
1623 Multiple rests are not merged if you create a score with more
1624 than one tagged section at the same place.
1628 @node Uso de ajustes globales
1629 @unnumberedsubsubsec Uso de ajustes globales
1630 @translationof Using global settings
1632 @cindex include-settings
1634 Se pueden incluir ajustes globales a partir de un archivo distinto:
1637 lilypond -dinclude-settings=MIS_AJUSTES.ly MI_PARTITURA.ly
1640 En archivos diferentes se pueden almacenar grupos de ajustes como
1641 el tamaño de la página o las fuentes tipográficas. Ello permite
1642 hacer diferentes ediciones de la mism a partitura así como aplicar
1643 ajustes estándar a muchas partituras, simplemente por medio de la
1644 especificación del archivo de ajustes adecuado.
1646 Esta técnica también funciona bien con el uso de hojas de estilo,
1647 como se estudia en @rlearning{Hojas de estilo}.
1650 Manual de aprendizaje:
1651 @rlearning{Organizar las piezas mediante variables},
1652 @rlearning{Hojas de estilo}.
1654 Referencia de la notación:
1655 @ref{Inclusión de archivos de LilyPond}.
1657 @node Codificación del texto
1658 @subsection Codificación del texto
1659 @translationof Text encoding
1663 @cindex caracteres no ASCII
1665 LilyPond usa el conjunto de caracteres definido por el consorcio
1666 Unicode y la norma ISO/IEC 10646. Define un nombre único y un código
1667 para los conjuntos de caracteres que se utilizan en prácticamente
1668 todos los idiomas modernos y también en muchos otros. Unicode se
1669 puede implementar utilizando varios esquemas de codificación
1670 distintos. LilyPond usa la codificación UTF-8 (UTF son las siglas de
1671 @emph{Unicode Transformation Format}, o formato de transformación de
1672 Unicode) que representa todos los caracteres comunes de Latin en un
1673 solo byte, y representa otros caracteres usando un formato de longitud
1674 variable de hasta cuatro bytes.
1676 El aspecto visual real de los caracteres viene determinado por los
1677 glifos que se definen en las fuentes tipográficas concretas que se
1678 tengan disponibles: una fuente tipográfica define la asignación de un
1679 subconjunto de los códigos de Unicode a glifos. LilyPond usa la
1680 biblioteca Pango para representar y disponer tipográficamente textos
1683 LilyPond no realiza ninguna conversión en la codificación de la
1684 entrada. Esto significa que cualquier text, ya sea el título, la
1685 letra de la canción o una instrucción musical que contenga caracteres
1686 distintos a los del conjunto ASCII, se deben codificar en UTF-8. La
1687 forma más fácil de escribir dicho texto es utilizar un editor
1688 preparado para Unicode y guardar el archivo con la codificación UTF-8.
1689 Casi todos los editores modernos populares contemplan el UTF-8, por
1690 ejemplo lo hacen vim, Emacs, jEdit, y GEdit. Todos los sistemas MS
1691 Windows posteriores a NT usan Unicode como codificación de caracteres
1692 nativa, de manera que incluso el accesorio Bloc de Notas (Notepad)
1693 puede editar y guardar un archivo en el formato UTF-8. Una
1694 alternativa más funcional para Windows es BabelPad.
1696 Si un archivo de entrada que contiene un carácter que no es ASCII, no
1697 se guarda en el formato UTF-8, se genera el mensaje de error
1700 FT_Get_Glyph_Name () error: argumento inválido
1703 He aquí un ejemplo que muestra texto cirílico, hebreo y portugués:
1706 %c No verbatim here as the code does not display correctly in PDF
1708 bulgarian = \lyricmode {
1709 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1713 hebrew = \lyricmode {
1714 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1718 portuguese = \lyricmode {
1719 à vo -- cê uma can -- ção legal
1725 \addlyrics { \bulgarian }
1726 \addlyrics { \hebrew }
1727 \addlyrics { \portuguese }
1730 Para introducir un carácter aislado para el que se conoce el punto de
1731 código Unicode pero no está disponible en el editor que se está
1732 usando, use @code{\char ##xhhhh} o bien @code{\char #dddd} dentro de
1733 un bloque @code{\markup}, donde @code{hhhh} es el código hexadecimal
1734 del carácter en cuestión y @code{dddd} es su valor decimal
1735 correspondiente. Pueden omitirse los ceros iniciales, pero es
1736 costumbre indicar los cuatro caracteres en la representación
1737 hexadecimal (observe que @emph{no} debe utilizarse la codificación
1738 UTF-8 del punto de código Unicode después de @code{\char}, pues la
1739 codificación UTF-8 contiene bits adicionales que indican el número de
1740 octetos). Hay tablas de códigos Unicode y un índice de nombres de
1741 caracteres que da el punto de código en hexadecimal para cualquier
1742 carácter en el portal del Consorcio Unicode,
1743 @uref{http://www.unicode.org/}.
1746 Por ejemplo, tanto @code{\char ##x03BE} como @code{\char #958}
1747 insertan el carácter Unicode U+03BE, que tiene el nombre Unicode
1748 @qq{Letra griega Xi pequeña}.
1750 Se puede escribir de esta forma cualquier punto de código Unicode, y
1751 si todos los caracteres especiales se escriben en este formato no es
1752 necesario guardar el archivo de entrada en formato UTF-8. Por
1753 supuesto, debe estar instalada y estar disponible para LilyPond una
1754 fuente tipográfica que contenga codificados todos estos caracteres.
1756 El ejemplo siguiente muestra valores hexadecimales Unicode que se usan
1757 en cuatro lugares: en una llamada de ensayo, como texto de
1758 articulación, en la letra y como texto independiente bajo la
1761 @lilypond[quote,verbatim]
1764 c1 \mark \markup { \char ##x03EE }
1765 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1767 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
1769 \markup { "Copyright 2008--2011" \char ##x00A9 }
1772 @cindex copyright, símbolo de
1774 Para escribir el símbolo de copyright en la nota de créditos, utilice:
1778 copyright = \markup @{ \char ##x00A9 "2008" @}
1786 @node Controlar la salida
1787 @section Controlar la salida
1788 @translationof Controlling output
1791 * Extracción de fragmentos de música::
1792 * Saltar la música corregida::
1793 * Formatos de salida alternativos::
1794 * Sustituir la tipografía de la notación::
1797 @node Extracción de fragmentos de música
1798 @subsection Extracción de fragmentos de música
1799 @translationof Extracting fragments of music
1801 Es posible citar pequeños fragmentos de una partitura grande
1802 directamente a partir de la salida. Puede compararse con la
1803 separación de una pieza de una partitura, recortándola con tijeras.
1805 Esto se hace definiendo los compases que se deben recortar. Por
1806 ejemplo, la inclusión de la siguiente definición
1813 (make-rhythmic-location 5 1 2)
1814 (make-rhythmic-location 7 3 4)))
1819 extrae un fragmento empezando por la mitad del quinto compás y
1820 finalizando en el séptimo compás. El significado de @code{5 1 2} es:
1821 después de una blanca (1/2) en el compás 5, y el de @code{7 3 4}
1822 después de tres negras del compás 7.
1824 Se pueden definir más zonas de recorte añadiendo más parejas de
1825 definición de tiempo rhythmic-location a la lista.
1827 Para poder utilizar esta funcionalidad, LilyPond se debe invocar con
1828 la opción @option{-dclip-systems}. Los recortes aparecen en la salida
1829 como archivos EPS, y se convierten en PDF y PNG si estos formatos
1830 también están activados.
1832 Para ver más información sobre los formatos de salida, consulte
1833 @rprogram{Invocar a LilyPond}.
1836 @node Saltar la música corregida
1837 @subsection Saltar la música corregida
1838 @translationof Skipping corrected music
1840 @funindex skipTypesetting
1841 @funindex showFirstLength
1842 @funindex showLastLength
1844 Al escribir o copiar música, normalmente sólo es interesante de ver y
1845 corregir la música cercana al final (donde estamos añadiendo las
1846 notas). Para acelerar este proceso de corrección, es posible saltar
1847 la composición tipográfica de todos excepto unos pocos de los últimos
1848 compases. Esto se consigue poniendo
1851 showLastLength = R1*5
1856 en nuestro archivo fuente. Esto hará que se tracen sólo los últimos
1857 cinco compases (suponiendo un compás de 4/4) de cada una de las
1858 partituras @code{\score} del archivo de entrada. Para piezas largas,
1859 el tipografiado de únicamente una parte pequeña es con frecuencia un
1860 orden de magnitud más rápido que el de la obra completa. Si estamos
1861 trabajando sobre el principio de una partitura que ya hemos
1862 tipografiado (p.ej., para añadir una parte instrumental nueva),
1863 también puede ser útil la propiedad @code{showFirstLength}.
1865 Este mecanismo de pasar por alto partes de un partitura se puede
1866 controlar con un grano más fino mediante la propiedad
1867 @code{Score.skipTypesetting}. Cuando su valor está establecido, no se
1868 lleva a cabo ningún tipografiado en absoluto.
1870 Esta propiedad se usa también para controlar la salida al archivo
1871 MIDI. Observe que pasa por alto todos los eventos, incluidos el tempo
1872 y los cambios de instrumento. Está usted advertido.
1874 @lilypond[quote,relative=2,ragged-right,verbatim]
1876 \set Score.skipTypesetting = ##t
1878 \set Score.skipTypesetting = ##f
1882 En música polifónica, @code{Score.skipTypesetting} afecta a todas las
1883 voces y pentagramas, ahorrando más tiempo incluso.
1885 @node Formatos de salida alternativos
1886 @subsection Formatos de salida alternativos
1887 @translationof Alternative output formats
1889 @cindex salida de gráficos de vector escalables
1891 @cindex salida de PostScript encapsulado
1893 @cindex PostScript encapsulado, salida de
1895 Los formatos de salida predeterminados para la partitura impresa son
1896 el formato de documento portátil (PDF) y PostScript (PS). Los
1897 formatos de salida Gráficos de vector escalables (SVG), PostScript
1898 encapsulado (EPS) y Gráficos de red portátiles (PNG) también están
1899 disponibles a través de opciones de la línea de órdenes, véase
1900 @rprogram{Opciones de la línea de órdenes para lilypond}.
1903 @node Sustituir la tipografía de la notación
1904 @subsection Sustituir la tipografía de la notación
1905 @translationof Replacing the notation font
1907 Gonville es una alternativa a la tipografía Feta que se utiliza en
1908 LilyPond y se puede descargar de:
1910 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
1913 Aquí presentamos algunos compases de muestra tipografiados con la
1916 @c NOTE: these images are a bit big, but that's important
1917 @c for the font comparison. -gp
1918 @sourceimage{Gonville_after,,,}
1920 Aquí hay unos compases de muestra tipografiados en la fuente Feta de
1923 @sourceimage{Gonville_before,,,}
1925 @subsubheading Instrucciones de instalación para MacOS
1927 Descargue y extraiga el archivo zip. Copie la carpeta @code{lilyfonts}
1928 a @file{@var{SHARE_DIR}/lilypond/current}; para más información,
1929 consulte @rlearning{Otras fuentes de información}. Renombre la carpeta
1930 @code{fonts} existente a @code{fonts_orig} y la carpeta
1931 @code{lilyfonts} a @code{fonts}. Para volver a la fuente Feta,
1932 invierta el proceso.
1935 Manual de aprendizaje:
1936 @rlearning{Otras fuentes de información}.
1940 Gonville no se puede usar para tipografiar notación de @q{Música
1941 Antigua} y es probable que cualquier nuevo glifo en versiones
1942 posteriores de LilyPond no existan en la familia
1943 tipográfica Gonville. Diríjase a la página web del autor para obtener más
1944 información sobre éste y otros asuntos, entre ellos el régimen de
1945 licencias de Gonville.
1949 @section Salida MIDI
1950 @translationof MIDI output
1955 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
1956 Instrumentos Musicales) es un estándar para interconectar y controlar
1957 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
1958 una serie de notas dentro de un conjunto de pistas. No es un archivo
1959 de sonidos reales; se necesita un programa reproductor especial para
1960 traducir la serie de notas en sonidos de verdad.
1962 Cualquier música se puede convertir a archivos MIDI, de manera que
1963 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
1964 para comprobar la corrección de la música; las octavas equivocadas o
1965 las alteraciones erróneas se ponen de relieve muy claramente al
1966 escuchar la salida MIDI.
1968 La salida estándar de MIDI es un poco primitiva; de forma opcional, se
1969 encuentra disponible una salida MIDI mejorada y mucho más realista,
1970 por medio de @ref{El script Articulate}.
1973 La salida MIDI reserva un canal por cada pentagrama, y otro para los
1974 ajustes globales. Por ello, el archivo MIDI no debe tener más de 15
1975 pautas (o 14 si no se usa la percusión). Otros pentagramas permanecen
1979 * Crear archivos MIDI::
1981 * ¿Qué sale por el MIDI?::
1982 * Repeticiones y MIDI::
1983 * Control de los matices en el MIDI::
1984 * Percusión en MIDI::
1985 * El script Articulate::
1988 @node Crear archivos MIDI
1989 @subsection Crear archivos MIDI
1990 @translationof Creating MIDI files
1992 Para crear un MIDI a partir de una pieza de música, escriba un bloque
1993 @code{\midi} en la partitura, por ejemplo:
2002 Si hay un bloque @code{\midi} dentro de un @code{\score} que no tenga
2003 ningún bloque @code{\layout}, solamente se producirá MIDI. Si se
2004 necesita una notación impresa, debe haber también un bloque
2015 Se traducen correctamente a la salida MIDI la altura y duración de las
2016 notas, las ligaduras de unión, matices y cambios de tempo. Las
2017 indicaciones dinámicas, crescendi y decrescendi se traducen a niveles
2018 de volumen MIDI. Las marcas dinámicas se traducen a una fracción fija
2019 del rango de volumen MIDI disponible. Los crescendi y decrescendi
2020 hacen que el volumen varía linealmente entre sus dos extremos. El
2021 efecto de las indicaciones dinámicas sobre la salida MIDI se puede
2022 eliminar por completo, véase @ref{El bloque MIDI}.
2024 El tempo inicial y los cambios de tempo posteriores se pueden
2025 especificar utilizando la instrucción @code{\tempo} dentro de la
2026 propia notación musical. Se reflejan en cambios de tempo en la salida
2027 MIDI. Esta instrucción normalmente hace que se imprima la indicación
2028 metronómica, pero esto se puede eliminar, véase @ref{Indicaciones metronómicas}.
2029 Más abajo se describe una forma alternativa de especificar el tempo
2030 MIDI inicial o global, véase @ref{El bloque MIDI}.
2032 Debido a ciertas limitaciones de Windows, la extensión predeterminada
2033 para los archivos MIDI en Windows es @code{.mid}. Otros sistemas
2034 operativos utilizan la extensión @code{.midi}. Si prefiere una
2035 extensión diferente, inserte la siguiente línea en el nivel jerárquico
2036 superior del archivo de entrada, antes del inicio de cualquier bloque
2037 @code{\book}, @code{\bookpart} o @code{\score}:
2040 #(ly:set-option 'midi-extension "midi")
2043 La línea anterior establece la extensión predeterminada para los
2044 archivos MIDI a @code{.midi}.
2046 De forma alternativa, esta opción se puede también proporcionar en la
2050 lilypond … -dmidi-extension=midi archivoLily.ly
2054 @unnumberedsubsubsec Nombres de instrumentos
2056 @cindex instrumento, nombres de
2057 @funindex Staff.midiInstrument
2059 El nombre del instrumento MIDI se establece mediante la propiedad
2060 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
2061 de entre los que están en la lista que aparece en @ref{Instrumentos MIDI}.
2065 \set Staff.midiInstrument = #"glockenspiel"
2071 \new Staff \with @{midiInstrument = #"cello"@} @{
2076 Si el instrumento elegido no coincide exactamente con uno de los
2077 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
2078 Piano de Cola (@code{"acoustic grand"}).
2082 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2083 {changing-midi-output-to-one-channel-per-voice.ly}
2087 @c In 2.11 the following no longer seems to be a problem -td
2089 Unterminated (de)crescendos will not render properly in the midi file,
2090 resulting in silent passages of music. The workaround is to explicitly
2091 terminate the (de)crescendo. For example,
2098 will not work properly but
2101 @{ a4\< b c d\!\f @}
2108 Los cambios del volumen MIDI sólo tienen lugar al principio de la
2109 nota, por lo que los crescendi y decrescendi no pueden afectar al
2110 volumen de una sola nota.
2112 No todos los reproductores de MIDI manejar adecuadamente los cambios de
2113 tempo de la salida MIDI. Entre los reproductores que se sabe que
2114 funcionan se encuentran el Reproductor de Medios de MS Windows y
2115 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
2118 @node El bloque MIDI
2119 @subsection El bloque MIDI
2120 @translationof MIDI block
2124 Si se requiere una salida MIDI, debe aparecer un bloque @code{\midi}
2125 dentro de un bloque de partitura. Es análogo al bloque layout de
2126 diseño de página, pero algo más simple. Con frecuencia, el bloque
2127 @code{\midi} se deja vacío, pero puede contener reorganizaciones de
2128 contextos, definiciones de contexto nuevas o código para fijar valores
2129 de propiedades. Por ejemplo, en el ejemplo siguiente se establece el
2130 tempo inicial exportado al archivo MIDI sin hacer que se imprima una
2131 indicación de tempo:
2139 tempoWholesPerMinute = #(ly:make-moment 72 4)
2145 En este ejemplo, el tempo se establece a 72 pulsos de negra por
2146 minuto. Esta clase de especificación de tempo no puede tomar como
2147 argumento una figura con puntillo. Si necesitamos una figura con
2148 puntillo, dividimos la nota con puntillo en figuras más pequeñas. Por
2149 ejemplo, un tempo de 90 negras con puntillo por minuto se puede
2150 especificar como 270 corcheas por minuto:
2153 tempoWholesPerMinute = #(ly:make-moment 270 8)
2156 @cindex MIDI, definiciones de contexto
2158 Las definiciones de contexto siguen con precisión la misma sintaxis
2159 que la de un bloque @code{\layout}. Los módulos de traducción para el
2160 sonido reciben el nombre de ejecutantes. Los contextos para la salida
2161 MIDI se definen en @file{../ly/performer-init.ly}, véase
2162 @rlearning{Otras fuentes de información}. Por ejemplo, para eliminar
2163 el efecto de los matices de la salida MIDI, inserte las líneas
2164 siguientes en el bloque @code{\midi@{ @}}.
2171 \remove "Dynamic_performer"
2176 La salida MIDI se crea sólo cuando se incluye un bloque @code{\midi}
2177 dentro de un bloque de partitura definido con una instrucción
2182 @{ @dots{}notas@dots{} @}
2187 @node ¿Qué sale por el MIDI?
2188 @subsection ¿Qué sale por el MIDI?
2189 @translationof What goes into the MIDI output?
2191 @unnumberedsubsubsec Contemplado en el MIDI
2193 @cindex alturas en MIDI
2194 @cindex MIDI, alturas
2195 @cindex cuartos de tono en MIDI
2196 @cindex MIDI, cuartos de tono
2197 @cindex microtonos en MIDI
2198 @cindex MIDI, microtonos
2199 @cindex acordes, nombres de, en MIDI
2200 @cindex MIDI, nombres de
2201 @cindex duraciones en MIDI
2202 @cindex MIDI, duraciones
2203 @cindex Articlulate, scripts
2204 @cindex MIDI, articulaciones
2205 @cindex articulaciones en MIDI
2206 @cindex trinos en MIDI
2207 @cindex grupetos en MIDI
2208 @cindex rallentando en MIDI
2209 @cindex accelerando en MIDI
2212 Los siguientes elementos de notación se reflejan en la salida MIDI:
2216 @item Microtonos (véase @ref{Alteraciones accidentales}. La reproducción necesita un reproductor que contemple la curvatura de tono o @emph{pitch bend}.)
2217 @item Acordes escritos como nombres de acorde
2218 @item Ritmos escritos como duraciones de las notas, incluidos los grupos de valoración especial
2219 @item Trémolos escritos sin @q{@code{:}[@var{número}]}
2220 @item Ligaduras de unión
2221 @item Matices o indicaciones de dinámica
2222 @item Crescendi y decrescendi sobre varias notas
2223 @item Cambios de tempo insertados con una marca metronómica
2224 @item Letra de las canciones
2227 Utilizando @ref{El script Articulate}, a la lista anterior se añaden
2228 una serie de elementos:
2231 @item Articulaciones (ligaduras de expresión, picados, etc)
2232 @item Trinos, mordentes circulares
2233 @item Rallentando y accelerando
2237 @unnumberedsubsubsec No contemplado en el MIDI
2239 @c TODO index as above
2241 Los siguientes elementos de notación no tienen ningún efecto sobre la
2242 salida MIDI, a no ser que utilicemos @ref{El script Articulate}:
2245 @item Duraciones escritas como anotaciones, p.ej. el swing
2246 @item Cambios de tempo escritos como anotaciones sin marca de tempo
2247 @item Staccato y otras articulaciones y ornamentos
2248 @item Ligaduras de expresión y de fraseo
2249 @item Crescendi y decrescendi sobre una nota única
2250 @item Trémolos introducidos con @q{@code{:}[@var{número}]}
2252 @item Acordes microtonales
2256 @node Repeticiones y MIDI
2257 @subsection Repeticiones y MIDI
2258 @translationof Repeats in MIDI
2260 @cindex repeticiones, expandir
2261 @funindex \unfoldRepeats
2263 Con un poco de trucaje, se puede hacer que cualquier tipo de
2264 repetición esté presente en la salida MIDI. Esto se consigue mediante
2265 la aplicación de la función musical @code{\unfoldRepeats}. Esta
2266 función cambia todas las repeticiones a repeticiones desplegadas.
2268 @lilypond[quote,verbatim]
2270 \repeat tremolo 8 { c'32 e' }
2271 \repeat percent 2 { c''8 d'' }
2272 \repeat volta 2 { c'4 d' e' f' }
2281 En partituras con varias voces, el desplegado de las repeticiones en
2282 la salida MIDI solo se produce correctamente si @emph{todas y cada
2283 una} de las voces incluye las repeticiones de manera completa y
2286 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
2287 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
2288 (con repeticiones desplegadas) y otro para la notación impresa (con
2289 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
2290 y percent --repetición de compases--). Por ejemplo,
2298 \unfoldRepeats @var{..música..}
2304 @node Control de los matices en el MIDI
2305 @subsection Control de los matices en el MIDI
2306 @translationof Controlling MIDI dynamics
2308 La dinámica en el MIDI está implementada por medio del intérprete
2309 Dynamic_performer que reside de forma predeterminada dentro del
2310 contexto Voice. Es posible controlar el volumen MIDI general, el
2311 volumen relativo de los matices dinámicos y el volumen relativo de los
2312 distintos instrumentos.
2314 @unnumberedsubsubsec Indicaciones dinámicas
2316 Los matices o indicaciones de dinámica se traducen a una fracción fija
2317 del rango de volumen MIDI disponible. Las fracciones predeterminadas
2318 se extienden desde 0.25 para @notation{ppppp} hasta 0.95 para
2319 @notation{fffff}. El conjunto de indicaciones dinámicas y las
2320 fracciones asociadas pueden verse en @file{../scm/midi.scm}, véase
2321 @rlearning{Otras fuentes de información}. Este conjunto de fracciones
2322 se puede cambiar o extender proporcionando una función que toma como
2323 argumento una indicación dinámica y devuelve la fracción requerida, y
2324 estableciendo @code{Score.dynamicAbsoluteVolumeFunction} a esta
2327 Por ejemplo, si se requiere una indicación dinámica
2328 @notation{rinforzando}, @code{\rfz}, ésta no tiene ningún efecto
2329 predeterminado sobre el volumen MIDI, pues no está incluida en el
2330 conjunto predeterminado. De igual manera, si se define una indicación
2331 dinámica nueva con @code{make-dynamic-script}, ésta tampoco estará
2332 incluida en el conjunto predeterminado. El ejemplo siguiente muestra
2333 cómo hay que añadir el volumen MIDI para estas indicaciones dinámicas.
2334 La función Scheme establece la fracción a 0.9 si se encuentra una
2335 indicación dinámica rfz, y en caso contrario llama a la función
2338 @lilypond[verbatim,quote]
2339 #(define (myDynamics dynamic)
2340 (if (equal? dynamic "rfz")
2342 (default-dynamic-absolute-volume dynamic)))
2346 \set Staff.midiInstrument = #"cello"
2347 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2359 Como alternativa, si se necesitara redefinir la tabla completa de
2360 fracciones, sería mejor usar el procedimiento
2361 @notation{default-dynamic-absolute-volume} que aparece en
2362 @file{../scm/midi.scm} y la tabla asociada como modelo. El último
2363 ejemplo de esta sección muestra cómo se puede hacer esto.
2365 @unnumberedsubsubsec Volumen maestro MIDI
2367 El volumen general máximo y mínimo de las indicaciones dinámicas de
2368 MIDI se controla estableciendo valores para las propiedades
2369 @code{midiMinimumVolume} y @code{midiMaximumVolume} en el nivel de
2370 @code{Score}. Estas propiedades tienen efecto solamente sobre las
2371 indicaciones dinámicas, por ello si queremos que tengan validez desde
2372 el comienzo de la partitura, se debe colocar allí una indicación de
2373 dinámica. La fracción que corresponde a cada indicación dinámica se
2374 modifica con esta fórmula:
2377 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fracción
2380 En el ejemplo siguiente, el rango de intensidad dinámica del volumen
2381 general MIDI está limitado al intervalo desde 0.2 hasta 0.5.
2383 @lilypond[verbatim,quote]
2389 \set Staff.midiInstrument = #"flute"
2390 \new Voice \relative c''' {
2398 \set Staff.midiInstrument = #"clarinet"
2399 \new Voice \relative c'' {
2410 tempoWholesPerMinute = #(ly:make-moment 72 2)
2411 midiMinimumVolume = #0.2
2412 midiMaximumVolume = #0.5
2418 @unnumberedsubsubsec Balance entre instrumentos (i)
2420 Si las propiedades de volumen MIDI máximo y mínimo están establecidas
2421 en el contexto @code{Staff} se pueden controlar los volúmenes
2422 relativos de los instrumentos MIDI. Esto proporciona un ecualizador
2423 de instrumentos básico que puede realzar significativamente la calidad
2426 En este ejemplo se reduce el volumen del clarinete con relación al de
2427 la flauta. Debe haber una indicación dinámica en la primera nota de
2428 cada instrumento para que esto funcione correctamente.
2430 @lilypond[verbatim,quote]
2436 \set Staff.midiInstrument = #"flute"
2437 \set Staff.midiMinimumVolume = #0.7
2438 \set Staff.midiMaximumVolume = #0.9
2439 \new Voice \relative c''' {
2447 \set Staff.midiInstrument = #"clarinet"
2448 \set Staff.midiMinimumVolume = #0.3
2449 \set Staff.midiMaximumVolume = #0.6
2450 \new Voice \relative c'' {
2461 tempoWholesPerMinute = #(ly:make-moment 72 2)
2467 @unnumberedsubsubsec Balance entre instrumentos (ii)
2469 Si las propiedades de volumen MIDI máximo y mínimo no están
2470 establecidas, de forma predeterminada LilyPond aplica un pequeño grado
2471 de ecualización a algunos instrumentos. Los instrumentos y la
2472 ecualización que se aplica se muestra en la tabla
2473 @notation{instrument-equalizer-alist} en @file{../scm/midi.scm}.
2475 El ecualizador básico predeterminado se puede sustituir estableciendo
2476 @code{instrumentEqualizer} en el contexto @code{Score} a un
2477 procedimiento Scheme nuevo que acepte el nombre de un instrumento MIDI
2478 como único argumento y devuelva un par de fracciones que dan los
2479 volúmenes máximo y mínimo que se aplican a dicho instrumento. Esta
2480 sustitución se hace de la misma forma que mostramos para restablecer
2481 la fracción de volumen absoluto @code{dynamicAbsoluteVolumeFunction}
2482 al comienzo de esta sección. El ecualizador predeterminado,
2483 @notation{default-instrument-equalizer}, en
2484 @file{../scm/midi.scm}, muestra cómo se puede escribir tal
2487 El ejemplo siguiente establece los volúmenes relativos de la flauta y
2488 del clarinete a los mismos valores que el ejemplo anterior.
2490 @lilypond[verbatim,quote]
2491 #(define my-instrument-equalizer-alist '())
2493 #(set! my-instrument-equalizer-alist
2496 ("flute" . (0.7 . 0.9))
2497 ("clarinet" . (0.3 . 0.6)))
2498 my-instrument-equalizer-alist))
2500 #(define (my-instrument-equalizer s)
2501 (let ((entry (assoc s my-instrument-equalizer-alist)))
2510 \set Score.instrumentEqualizer = #my-instrument-equalizer
2511 \set Staff.midiInstrument = #"flute"
2512 \new Voice \relative c''' {
2520 \set Staff.midiInstrument = #"clarinet"
2521 \new Voice \relative c'' {
2532 tempoWholesPerMinute = #(ly:make-moment 72 2)
2539 @c Delete when satisfied this is adequately covered elsewhere -td
2541 @n ode Microtones in MIDI
2542 @s ubsection Microtones in MIDI
2544 @cindex microtones in MIDI
2546 Microtones consisting of half sharps and half flats are exported
2547 to the MIDI file and render correctly in MIDI players which support
2548 pitch bending. See @ref{Nombres de las notas en otros idiomas}. Here is
2549 an example showing all the half sharps and half flats. It can be
2550 copied out and compiled to test microtones in your MIDI player.
2552 @lilypond[verbatim,quote]
2569 @node Percusión en MIDI
2570 @subsection Percusión en MIDI
2571 @translationof Percussion in MIDI
2573 La notación de los instrumentos de percusión se realiza normalmente en
2574 un contexto @code{DrumStaff} y cuando se hace de esta forma se les da
2575 salida correctamente por el canal MIDI@tie{}10, pero ciertos
2576 instrumentos de percusión de altura determinada, como el xilófono,
2577 marimba, vibráfono, timbales, etc., se tratan como instrumentos
2578 @qq{normales} y la música para estos instrumentos se debe introducir
2579 en contextos de @code{Staff} normales, no en un contexto
2580 @code{DrumStaff}, para obtener la salida MIDI correcta.
2582 Ciertos sonidos de altura indeterminada que están incluidos en el
2583 estándar General MIDI, como el tom melódico, el tambor taiko, los
2584 tambores sintéticos, etc., no se pueden acceder a través del canal
2585 MIDI@tie{}10, por lo que la notación para dichos instrumentos se debe
2586 introducir también en un contexto normal de @code{Staff}, utilizando
2587 las alturas normales adecuadas.
2589 Muchos instrumentos de percusión no están incluidos dentro del
2590 estándar General MIDI, p.ej. las castañuelas. El método más
2591 fácil (aunque no satisfactorio) de producir una salida MIDI al
2592 escribir para estos instrumentos es sustituirlos por el sonido más
2593 parecido del conjunto estándar.
2595 @c TODO Expand with examples, and any other issues
2599 Debido a que el estándar General MIDI no contiene golpes de aro
2600 (@emph{rim shots}), para este propósito se utiliza en su lugar el
2601 golpe lateral de baqueta (@emph{sidestick}).
2603 @node El script Articulate
2604 @subsection El script Articulate
2605 @translationof The Articulate script
2607 Es posible obtener una salida MIDI más real si se utiliza el script
2608 Articulate. Éste trata de tener en cuenta las articulaciones
2609 (ligaduras de expresión, picados, etc), mediante la sustitución de las
2610 notas con secuencias musicales de silencios y notas escaladas en el
2611 tiempo de forma apropiada. También trata de desplegar los trinos,
2612 grupetos circulares, etc. y responder a las indicaciones de
2613 rallentando y accelerando.
2615 Para utilizar el script Articulate, tenemos que incluirlo al principio
2616 de nuestro archivo de entrada:
2619 \include "articulate.ly"
2622 y en la sección @code{\score}, hacer lo siguiente:
2625 \unfoldRepeats \articulate <<
2626 resto de la partitura...
2630 Después de alterar el código de entrada de esta manera el resultado
2631 visual se altera profundamente, pero el bloque @code{\midi} estándar
2632 produce un archivo MIDI mejorado.
2634 Si bien no es esencial para que funcione el script Articulate, podemos
2635 insertar la instrucción @code{\unfoldRepeats} según aparece en el
2636 ejemplo anterior, dado que habilita la ejecución de abreviaturas tales
2637 como los @notation{trinos}.
2641 Articulate acorta los acordes, y ciertos fragmentos de música
2642 (especialmente la música de órgano) es posible que suene peor.
2645 @node Extraer información musical
2646 @section Extraer información musical
2647 @translationof Extracting musical information
2649 Además de crear un resultado visual y MIDI,
2650 LilyPond es capaz de presentar información
2651 musical en forma de texto.
2654 * Impresión del código de notación de LilyPond::
2655 * Impresión de las expresiones musicales de Scheme::
2656 * Guardar los eventos musicales en un archivo::
2659 @node Impresión del código de notación de LilyPond
2660 @subsection Displaying LilyPond notation
2661 @translationof Displaying LilyPond notation
2663 @funindex \displayLilyMusic
2664 La impresión textual de una expresión musical en notación de LilyPond
2665 puede hacerse con la función musical @code{\displayLilyMusic} pero solamente
2666 mediante la línea de órdenes. Por ejemplo,
2670 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
2677 @{ a,4 cis e fis g @}
2680 De forma predeterminada, LilyPond imprime estos mensajes en la consola
2681 junto al resto de los mensajes de la compilación de LilyPond.
2682 Para discernir entre estos mensajes y
2683 guardar el resultado de @code{\display@{MATERIAL@}}, redireccione la
2684 salida hacia un archivo.
2687 lilypond archivo.ly >resultado.txt
2691 @node Impresión de las expresiones musicales de Scheme
2692 @subsection Impresión de las expresiones musicales de Scheme
2693 @translationof Displaying scheme music expressions
2695 Véase @rextend{Presentación de las expresiones musicales}.
2698 @node Guardar los eventos musicales en un archivo
2699 @subsection Guardar los eventos musicales en un archivo
2700 @translationof Saving music events to a file
2702 Los eventos musicales se pueden guardar en un archivo pentagrama a
2703 pentagrama mediante la inclusión de un archivo en nuestra partitura
2707 \include "event-listener.ly"
2710 De esta forma se crean uno o más archivos llamados
2711 @file{FILENAME-STAFFNAME.notes} ó @file{FILENAME-unnamed-staff.notes}
2712 para cada pentagrama. Observe que si tiene más de un pentagrama sin
2713 nombre, los eventos de todos los pentagramas se mezclarán entre sí
2714 dentro del mismo archivo. El resultado tiene el aspecto siguiente:
2717 0.000 note 57 4 p-c 2 12
2719 0.250 note 62 4 p-c 7 12
2720 0.500 note 66 8 p-c 9 12
2721 0.625 note 69 8 p-c 14 12
2726 La sintaxis consiste en una línea delimitada por caracteres de
2727 tabulación, con dos campos fijos en cada línea seguidos de parámetros
2731 @var{tiempo} @var{tipo} @var{...parámetros...}
2734 Esta información se puede leer fácilmente por parte de otros programas
2735 como guiones de Python, y pueden ser muy útiles para aquellos
2736 investigadores que desean realizar un análisis musical o hacer
2737 experimientos de reproducción con LilyPond.
2742 No todos los eventos musicales de lilypond están contemplados por
2743 @file{event-listener.ly}. Se pretende que sea una @qq{prueba de
2744 concepto} bien realizada. Si algunos eventos que quiere ver no
2745 aparecen incluidos, copie @file{event-listener.ly} en su carpeta de
2746 lilypond y modifique el archivo de forma que produzca la información