1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
11 @node General input and output
12 @chapter General input and output
19 * Titles and headers::
20 * Working with input files::
21 * Controlling output::
26 @section Input structure
32 * Structure of a score::
33 * Multiple scores in a book::
37 @node Structure of a score
38 @subsection Structure of a score
43 @node Multiple scores in a book
44 @subsection Multiple scores in a book
50 @subsection File structure
55 @node Titles and headers
56 @section Titles and headers
58 Casi toda la música impresa tiene un título y el nombre del
59 compositor; ciertas piezas tienen mucha más información.
64 * Reference to page numbers::
69 @subsection Creating titles
71 Se crean títulos para cada uno de los bloques @code{\score} así como
72 para todo el archivo de entrada (o bloque @code{\book} (libro)).
74 El contenido de cada título se extrae a partir de los bloques
75 @code{\header} (cabecera). El bloque de cabecera de un libro
76 contempla lo siguiente:
81 El dedicatario de la música, centrado en lo alto de la primera página.
85 El título de la música, centrado justo debajo de la
90 Subtítulo, centrado debajo del título.
94 Sub-subtítulo, centrado debajo del subtítulo.
98 Nombre del poeta, a la izquierda, debajo del subtítulo.
102 Nombre del compositor, a la derecha, debajo del subtítulo.
106 Texto de la medida, a la izquierda, debajo del poeta.
110 Nombre del Opus, a la derecha, debajo del compositor.
114 Nombre del arreglista, a la derecha, debajo del Opus.
118 Nombre del instrumento, centrado, debajo del arreglista. También
119 aparece centrado en lo alto de cada página (aparte de la primera).
123 Nombre de la pieza, a la izquierda, debajo del instrumento.
125 @cindex página, saltos, forzar
126 @funindex breakbefore
128 Esto fuerza que el título comience sobre una página nueva (establézcalo a ##t o a ##f).
132 Aviso de Copyright, centrado en la parte inferior de la primera
133 página. Para insertar el símbolo de copyright symbol, consulte
138 Cartel de propósito general en el pie de página, centrado al final de la última.
142 A continuación presentamos una demostración de todos los campos que
143 están disponibles. Fíjese en que puede utilizar en la cabecera
144 cualquier instrucción de marcado de texto (Véase @ref{Formatting text}).
146 @lilypond[quote,verbatim,line-width=11.0\cm]
149 paper-height = 10.0\cm
154 dedication = "dedicated to me"
155 title = \markup \center-align { "Title first line" "Title second line,
157 subtitle = "the subtitle,"
158 subsubtitle = #(string-append "subsubtitle LilyPond version "
161 composer = \markup \center-align { "composer" \small "(1847-1973)" }
162 texttranslator = "Text Translator"
163 meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
165 arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
166 #-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "nger" }
167 instrument = \markup \bold \italic "instrument"
191 Como se mostró anteriormente, puede usar varios bloques
192 @code{\header}. Cuando los mismos campos aparecen en distintos
193 bloques, tiene validez el último en definirse. A continuación un
198 composer = "Compositor"
206 piece = "Otra pieza" % sobreescribe a la anterior
211 Si define la cabecera @code{\header} dentro del bloque @code{\score},
212 por lo general se imprimirán solamente las cabeceras @code{piece} y
213 @code{opus}. Fíjese en que la expresión musical debe aparecer antes
216 @lilypond[quote,verbatim,line-width=11.0\cm]
220 title = "title" % not printed
227 @funindex printallheaders
229 Se puede cambiar este comportamiento (e imprimir todas las cabeceras
230 cuando la cabecera @code{\header} está definida dentro del bloque
231 @code{\score}) mediante la utilización de
242 El pie de página por omisión se encuentra vacío, excepto para la
243 primera página, en la que se inserta el campo de @code{copyright}
244 extraído del @code{\header}, y para la última página, en la que se
245 escribe el cartel @code{tagline} sacado del bloque @code{\header}. La
246 línea por omisión para este cartel es @qq{Music engraving by LilyPond
247 (@var{version})}.@footnote{Las partituras bien tipografiadas son una
248 magnífica promoción para nosotros, así que por favor, si puede,
249 conserve intacta la línea del letrero.}
251 Las cabeceras se pueden quitar completamente estableciendo su valor a
263 @subsection Custom titles
265 Una opción más avanzada es cambiar las definiciones de las variables
266 siguientes dentro del bloque @code{\paper} block. El archivo de
267 inicio @file{ly/titling-init.ly} ofrece un listado de la disposición
271 @funindex bookTitleMarkup
272 @item bookTitleMarkup
273 Es el título que se escribe en lo alto del documento de salida
274 completo. Normalmente contiene el compositor y el título de la pieza.
276 @funindex scoreTitleMarkup
277 @item scoreTitleMarkup
278 Es el título que se coloca por encima de un bloque @code{\score}.
279 normalmente contiene el nombre del movimiento (campo @code{piece}).
281 @funindex oddHeaderMarkup
282 @item oddHeaderMarkup
283 Es el encabezamiento de las páginas de numeración impar.
285 @funindex evenHeaderMarkup
286 @item evenHeaderMarkup
287 Es el encabezamiento de las páginas de numeración par. Si se deja
288 sin especificar, se usará el encabezamiento de las páginas impares.
290 De forma predeterminada, los encabezamientos se definen de tal forma
291 que el número de página está en el borde exterior, y el isntrumento
294 @funindex oddFooterMarkup
295 @item oddFooterMarkup
296 Es el pie de las páginas de numeración impar.
298 @funindex evenFooterMarkup
299 @item evenFooterMarkup
300 Es el pie de las páginas de numeración par. Si se deja sin
301 especificar, se usará en su lugar el encabezamiento de las páginas
304 De forma predeterminada, el pie de página tiene el aviso de
305 copyright en la primera página, y el cartel @code{tagline} en la
311 @cindex encabezamiento
314 @cindex disposición de la página
317 La definición siguiente pone el título en el extremo izquierdo, y el
318 compositor en el extremo derecho sobre una única línea.
322 bookTitleMarkup = \markup {
324 \fromproperty #'header:title
325 \fromproperty #'header:composer
331 @node Reference to page numbers
332 @subsection Reference to page numbers
334 Se puede marcar un lugar determinado de una partitura utilizando la
335 instrucción @code{\label} (etiqueta), bien en lo alto de la estructura
336 o bien dentro de la música. Posteriormente se puede hacer referencia
337 a esta etiqueta dentro de un elemento de marcado, para obtener el
338 número de la página en que se encuentra la marca, usando la
339 instrucción de marcado @code{\page-ref}.
341 @lilypond[verbatim,line-width=11.0\cm]
342 \header { tagline = ##f }
348 \pageBreak \mark A \label #'markA
353 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
354 \markup { Mark A is on page \page-ref #'markA "0" "?" }
358 La instrucción de marcado @code{\page-ref} toma tres argumentos:
360 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
361 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
362 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
365 El motivo de que se necesite un medidor es que en el momento en que se
366 están interpretando los marcados, los saltos de página aún no se han
367 producido y por tanto los números de página no se conocen todavía.
368 Para sortear este inconveniente, la interpretación real del marcado se
369 retrasa hasta un momento posterior; sin embargo, las dimensiones del
370 marcado se tienen que conocer de antemano, así que se usa el medidor
371 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
372 páginas, el medidor puede ser "00", es decir, un número de dos
382 @node Table of contents
383 @subsection Table of contents
384 Se puede insertar un índice general o tabla de contenidos utilizando
385 la instrucción @code{\markuplines \table-of-contents}. Los elementos
386 que deben aparecer en la tabla de contenidos se introducen con la
387 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
388 la jerarquía del código, o dentro de una expresión musical.
391 \markuplines \table-of-contents
394 \tocItem \markup "Primera partitura"
398 \tocItem \markup "Un punto concreto dentro de la primera partitura"
403 \tocItem \markup "Segunda partitura"
411 Los elementos de marcado que se usan para dar formato al índice
412 general se encuentran definidos dentro del bloque @code{\paper}. Los
413 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
414 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
415 los elementos del índice, que consisten en el título del elemento y el
416 número de página. Estas variables se pueden cambiar por parte del
421 %% Traducir el título del índice al español:
422 tocTitleMarkup = \markup \huge \column {
423 \fill-line { \null "Índice general" \null }
426 %% usar una fuente mayor
427 tocItemMarkup = \markup \large \fill-line {
428 \fromproperty #'toc:text \fromproperty #'toc:page
433 Observe la forma en que nos referimos al texto y al número de página
434 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
436 También se pueden definir nuevas instrucciones y elementos de
437 marcado para crear índices generales más eleborados:
439 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
440 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
441 utilizando esta variable de marcado del bloque @code{\paper}.
444 En el ejemplo siguiente se define un estilo nuevo para introducir los
445 nombres de los actos de una ópera en el índice general:
449 tocActMarkup = \markup \large \column {
451 \fill-line { \null \italic \fromproperty #'toc:text \null }
457 #(define-music-function (parser location text) (markup?)
458 (add-toc-item! 'tocActMarkup text))
461 @lilypond[line-width=11.0\cm]
462 \header { tagline = ##f }
464 tocActMarkup = \markup \large \column {
466 \fill-line { \null \italic \fromproperty #'toc:text \null }
472 #(define-music-function (parser location text) (markup?)
473 (add-toc-item! 'tocActMarkup text))
476 \markuplines \table-of-contents
477 \tocAct \markup { Atto Primo }
478 \tocItem \markup { Coro. Viva il nostro Alcide }
479 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
480 \tocAct \markup { Atto Secondo }
481 \tocItem \markup { Sinfonia }
482 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
489 Archivos de inicio: @file{ly/@/toc@/-init@/.ly}.
493 @funindex \table-of-contents
494 @code{\table-of-contents}
499 @node Working with input files
500 @section Working with input files
506 * Including LilyPond files::
507 * Different editions from one source::
509 * Displaying LilyPond notation::
512 @node Including LilyPond files
513 @subsection Including LilyPond files
518 @node Different editions from one source
519 @subsection Different editions from one source
529 @node Using variables
530 @unnumberedsubsubsec Using variables
536 @unnumberedsubsubsec Using tags
542 @subsection Text encoding
547 @node Displaying LilyPond notation
548 @subsection Displaying LilyPond notation
553 @node Controlling output
554 @section Controlling output
560 * Extracting fragments of music::
561 * Skipping corrected music::
564 @node Extracting fragments of music
565 @subsection Extracting fragments of music
570 @node Skipping corrected music
571 @subsection Skipping corrected music
582 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
583 Instrumentos Musicales) es un estándar para interconectar y controlar
584 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
585 una serie de notas dentro de un conjunto de pistas. No es un archivoo
586 de sonidos reales; se necesita un programa reproductor especial para
587 traducir la serie de notas en sonidos de verdad.
589 Cualquier música se puede convertir a archivos MIDI, de manera que
590 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
591 para comprobar la corrección de la música; las octavas equivocadas o
592 las alteraciones erróneas se ponen de relieve muy claramente al
593 escuchar la salida MIDI.
597 Muchhos efectos con interés musical como el swing, la articulación, el
598 fraseo, etc., no se traducen al midi.
600 La salida midi reserva un canal para cada pentagrama, y uno más para
601 los ajustes globales. Por ello, el archivo de entrada no debería
602 tener más de 15 pentagramas (o 14 si no usa percusión). Los otros
603 pentagramas permanecerán en silencio.
605 No todos los reproductores de midi manejan correctamente los cambios
606 de tempo en la salida midi. Entre los reproductores que se sabe que
607 funcionan, se encuentra
608 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
612 * Creating MIDI files::
614 * What goes into the MIDI output?::
616 * Controlling MIDI dynamics::
619 @node Creating MIDI files
620 @subsection Creating MIDI files
622 Para crear un MIDI a partir de una pieza de música, escriba un bloque
623 @code{\midi} en la partitura, por ejemplo:
631 tempoWholesPerMinute = #(ly:make-moment 72 4)
637 El tempo se puede especificar utilizando la instrucción @code{\tempo}
638 dentro de la propia música, véase @ref{Metronome marks}. Más abajo se
639 muestra una alternativa que no da lugar a una indicación metronómica
640 en la partitura impresa. En este ejemplo, el tempo de negras se
641 establece en 72 pulsos por minuto. Esta clase de especificación del
642 tempo no puede tomar notas con puntillo como argumento. En este caso,
643 divida las notas con puntillo en unidades más pequeñas. Por ejemplo,
644 un tempo de 90 negras con puntillo por minuto se puede especificar
645 como 270 corcheas por minuto:
648 tempoWholesPerMinute = #(ly:make-moment 270 8)
651 Si hay una instrucción @code{\midi} dentro de un @code{\score},
652 solamente se producirá MIDI. Si se necesita también una notación
653 impresa, se debe escribir un bloque @code{\layout}
662 @cindex layout, bloque
666 Se interpretan las ligaduras de unión, los matices dinámicos y los
667 cambios de tempo. Las marcas dinámicas, crescendi y decrescendi se
668 traducen en niveles de volumen MIDI. Las marcas de dinámica se
669 traducen a una fracción fija del rango de volumen MIDI disponible, los
670 crescendi y decrescendi hacen que el volumen varíe de forma lineal
671 entre sus dos extremos. Las fracciones se pueden ajustar mediante
672 @code{dynamicAbsoluteVolumeFunction} dentro de un contexto
673 @rinternals{Voice}. Para cada tipo de instrumento MIDI se puede
674 definir un rango de volumen. Esto proporciona un control de
675 ecualización básico, que puede realzar significativamente la calidad
676 de la salida MIDI. El ecualizador se puede controlar estableciendo un
677 valor para @code{instrumentEqualizer}, o fijando
680 \set Staff.midiMinimumVolume = #0.2
681 \set Staff.midiMaximumVolume = #0.8
684 Para quitar los matices dinámicos de la salida MIDI, escriba las
685 siguientes líneas dentro de la sección @code{\midi@{@}}.
692 \remove "Dynamic_performer"
700 Los (de)crescendos sin terminar no se procesarán adecuadamente en el
701 archivo midi, dando como resultado pasajes de música en silenco. Una
702 forma de sortearlo es terminar el (de)crescendo explícitamente. Por
710 no funcionará bien, pero
720 Solamente se crea una salida MIDI cuando la instrucción @code{\midi}
721 está dentro de un bloque @code{\score}. Si lo escribe dentro de un
722 contexto instanciado explícitamente (es decir: @code{\new Score} ) el
723 archivo no se producirá. Para solucionarlo, encierre el @code{\new
724 Score} y el @code{\midi} dentro de un bloque @code{\score}.
728 \new Score @{ @dots{}notas@dots{} @}
734 @unnumberedsubsubsec Instrument names
735 @cindex instrumento, nombres de
736 @funindex Staff.midiInstrument
738 El nombre del instrumento MIDI se establece mediante la propiedad
739 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
740 de entre los que están en la lista que aparece en @ref{MIDI
744 \set Staff.midiInstrument = "glockenspiel"
748 Si el instrumento elegido no coincide exactamente con uno de los
749 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
750 Piano de Cola (@code{"acoustic grand"}).
754 @subsection MIDI block
759 El bloque @code{\midi} es similar al bloque @code{\layout}, pero algo
760 más simple. Puede contener definiciones de contexto.
763 @cindex contexto, definición de
765 Las definiciones de contexto siguen con exactitud la misma sintaxis
766 que dentro del bloque \layout. Los módulos de traducción para el
767 sonido reciben el nombre de «performers» o intérpretes. Los contextos
768 para la salida MIDI se encuentran definidos dentro de
769 @file{ly/@/performer@/-init@/.ly}.
772 @node What goes into the MIDI output?
773 @subsection What goes into the MIDI output?
777 @unnumberedsubsubsec Supported in MIDI
778 @unnumberedsubsubsec Unsupported in MIDI
780 @node Repeats in MIDI
781 @subsection Repeats in MIDI
783 @cindex repeticiones, expandir
784 @funindex \unfoldRepeats
786 Con un poco de trucaje, se puede hacer que cualquier tipo de
787 repetición esté presente en la salida MIDI. Esto se consigue mediante
788 la aplicación de la función musical @code{\unfoldRepeats}. Esta
789 función cambia todas las repeticiones a repeticiones desplegadas.
791 @lilypond[quote,verbatim,fragment,line-width=8.0\cm]
793 \repeat tremolo 8 {c'32 e' }
794 \repeat percent 2 { c''8 d'' }
795 \repeat volta 2 {c'4 d' e' f'}
804 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
805 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
806 (con repeticiones desplegadas) y otro para la notación impresa (con
807 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
808 y percent --repetición de compases--). Por ejemplo,
816 \unfoldRepeats @var{..música..}
822 @node Controlling MIDI dynamics
823 @subsection Controlling MIDI dynamics
828 @unnumberedsubsubsec Dynamic marks
829 @unnumberedsubsubsec Overall MIDI volume
830 @unnumberedsubsubsec Equalizing different instruments (i)
831 @unnumberedsubsubsec Equalizing different instruments (ii)