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
15 UNTRANSLATED NODE: IGNORE ME
21 * Titles and headers::
22 * Working with input files::
23 * Controlling output::
28 @section Input structure
31 UNTRANSLATED NODE: IGNORE ME
36 * Structure of a score::
37 * Multiple scores in a book::
41 @node Structure of a score
42 @subsection Structure of a score
45 UNTRANSLATED NODE: IGNORE ME
49 @node Multiple scores in a book
50 @subsection Multiple scores in a book
53 UNTRANSLATED NODE: IGNORE ME
58 @subsection File structure
61 UNTRANSLATED NODE: IGNORE ME
65 @node Titles and headers
66 @section Titles and headers
68 Casi toda la música impresa tiene un título y el nombre del
69 compositor; ciertas piezas tienen mucha más información.
74 * Reference to page numbers::
79 @subsection Creating titles
81 Se crean títulos para cada uno de los bloques @code{\score} así como
82 para todo el archivo de entrada (o bloque @code{\book} (libro)).
84 El contenido de cada título se extrae a partir de los bloques
85 @code{\header} (cabecera). El bloque de cabecera de un libro
86 contempla lo siguiente:
91 El dedicatario de la música, centrado en lo alto de la primera página.
95 El título de la música, centrado justo debajo de la
100 Subtítulo, centrado debajo del título.
102 @funindex subsubtitle
104 Sub-subtítulo, centrado debajo del subtítulo.
108 Nombre del poeta, a la izquierda, debajo del subtítulo.
112 Nombre del compositor, a la derecha, debajo del subtítulo.
116 Texto de la medida, a la izquierda, debajo del poeta.
120 Nombre del Opus, a la derecha, debajo del compositor.
124 Nombre del arreglista, a la derecha, debajo del Opus.
128 Nombre del instrumento, centrado, debajo del arreglista. También
129 aparece centrado en lo alto de cada página (aparte de la primera).
133 Nombre de la pieza, a la izquierda, debajo del instrumento.
135 @cindex página, saltos, forzar
136 @funindex breakbefore
138 Esto fuerza que el título comience sobre una página nueva (establézcalo a ##t o a ##f).
142 Aviso de Copyright, centrado en la parte inferior de la primera
143 página. Para insertar el símbolo de copyright symbol, consulte
148 Cartel de propósito general en el pie de página, centrado al final de la última.
152 A continuación presentamos una demostración de todos los campos que
153 están disponibles. Fíjese en que puede utilizar en la cabecera
154 cualquier instrucción de marcado de texto (Véase @ref{Formatting text}).
156 @lilypond[quote,verbatim,line-width=11.0\cm]
159 paper-height = 10.0\cm
164 dedication = "dedicated to me"
165 title = \markup \center-align { "Title first line" "Title second line,
167 subtitle = "the subtitle,"
168 subsubtitle = #(string-append "subsubtitle LilyPond version "
171 composer = \markup \center-align { "composer" \small "(1847-1973)" }
172 texttranslator = "Text Translator"
173 meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
175 arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
176 #-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "nger" }
177 instrument = \markup \bold \italic "instrument"
201 Como se mostró anteriormente, puede usar varios bloques
202 @code{\header}. Cuando los mismos campos aparecen en distintos
203 bloques, tiene validez el último en definirse. A continuación un
208 composer = "Compositor"
216 piece = "Otra pieza" % sobreescribe a la anterior
221 Si define la cabecera @code{\header} dentro del bloque @code{\score},
222 por lo general se imprimirán solamente las cabeceras @code{piece} y
223 @code{opus}. Fíjese en que la expresión musical debe aparecer antes
226 @lilypond[quote,verbatim,line-width=11.0\cm]
230 title = "title" % not printed
237 @funindex printallheaders
239 Se puede cambiar este comportamiento (e imprimir todas las cabeceras
240 cuando la cabecera @code{\header} está definida dentro del bloque
241 @code{\score}) mediante la utilización de
252 El pie de página por omisión se encuentra vacío, excepto para la
253 primera página, en la que se inserta el campo de @code{copyright}
254 extraído del @code{\header}, y para la última página, en la que se
255 escribe el cartel @code{tagline} sacado del bloque @code{\header}. La
256 línea por omisión para este cartel es @qq{Music engraving by LilyPond
257 (@var{version})}.@footnote{Las partituras bien tipografiadas son una
258 magnífica promoción para nosotros, así que por favor, si puede,
259 conserve intacta la línea del letrero.}
261 Las cabeceras se pueden quitar completamente estableciendo su valor a
273 @subsection Custom titles
275 Una opción más avanzada es cambiar las definiciones de las variables
276 siguientes dentro del bloque @code{\paper} block. El archivo de
277 inicio @file{ly/titling-init.ly} ofrece un listado de la disposición
281 @funindex bookTitleMarkup
282 @item bookTitleMarkup
283 Es el título que se escribe en lo alto del documento de salida
284 completo. Normalmente contiene el compositor y el título de la pieza.
286 @funindex scoreTitleMarkup
287 @item scoreTitleMarkup
288 Es el título que se coloca por encima de un bloque @code{\score}.
289 normalmente contiene el nombre del movimiento (campo @code{piece}).
291 @funindex oddHeaderMarkup
292 @item oddHeaderMarkup
293 Es el encabezamiento de las páginas de numeración impar.
295 @funindex evenHeaderMarkup
296 @item evenHeaderMarkup
297 Es el encabezamiento de las páginas de numeración par. Si se deja
298 sin especificar, se usará el encabezamiento de las páginas impares.
300 De forma predeterminada, los encabezamientos se definen de tal forma
301 que el número de página está en el borde exterior, y el isntrumento
304 @funindex oddFooterMarkup
305 @item oddFooterMarkup
306 Es el pie de las páginas de numeración impar.
308 @funindex evenFooterMarkup
309 @item evenFooterMarkup
310 Es el pie de las páginas de numeración par. Si se deja sin
311 especificar, se usará en su lugar el encabezamiento de las páginas
314 De forma predeterminada, el pie de página tiene el aviso de
315 copyright en la primera página, y el cartel @code{tagline} en la
321 @cindex encabezamiento
324 @cindex disposición de la página
327 La definición siguiente pone el título en el extremo izquierdo, y el
328 compositor en el extremo derecho sobre una única línea.
332 bookTitleMarkup = \markup {
334 \fromproperty #'header:title
335 \fromproperty #'header:composer
341 @node Reference to page numbers
342 @subsection Reference to page numbers
344 Se puede marcar un lugar determinado de una partitura utilizando la
345 instrucción @code{\label} (etiqueta), bien en lo alto de la estructura
346 o bien dentro de la música. Posteriormente se puede hacer referencia
347 a esta etiqueta dentro de un elemento de marcado, para obtener el
348 número de la página en que se encuentra la marca, usando la
349 instrucción de marcado @code{\page-ref}.
351 @lilypond[verbatim,line-width=11.0\cm]
352 \header { tagline = ##f }
358 \pageBreak \mark A \label #'markA
363 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
364 \markup { Mark A is on page \page-ref #'markA "0" "?" }
368 La instrucción de marcado @code{\page-ref} toma tres argumentos:
370 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
371 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
372 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
375 El motivo de que se necesite un medidor es que en el momento en que se
376 están interpretando los marcados, los saltos de página aún no se han
377 producido y por tanto los números de página no se conocen todavía.
378 Para sortear este inconveniente, la interpretación real del marcado se
379 retrasa hasta un momento posterior; sin embargo, las dimensiones del
380 marcado se tienen que conocer de antemano, así que se usa el medidor
381 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
382 páginas, el medidor puede ser "00", es decir, un número de dos
392 @node Table of contents
393 @subsection Table of contents
394 Se puede insertar un índice general o tabla de contenidos utilizando
395 la instrucción @code{\markuplines \table-of-contents}. Los elementos
396 que deben aparecer en la tabla de contenidos se introducen con la
397 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
398 la jerarquía del código, o dentro de una expresión musical.
401 \markuplines \table-of-contents
404 \tocItem \markup "Primera partitura"
408 \tocItem \markup "Un punto concreto dentro de la primera partitura"
413 \tocItem \markup "Segunda partitura"
421 Los elementos de marcado que se usan para dar formato al índice
422 general se encuentran definidos dentro del bloque @code{\paper}. Los
423 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
424 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
425 los elementos del índice, que consisten en el título del elemento y el
426 número de página. Estas variables se pueden cambiar por parte del
431 %% Traducir el título del índice al español:
432 tocTitleMarkup = \markup \huge \column {
433 \fill-line { \null "Índice general" \null }
436 %% usar una fuente mayor
437 tocItemMarkup = \markup \large \fill-line {
438 \fromproperty #'toc:text \fromproperty #'toc:page
443 Observe la forma en que nos referimos al texto y al número de página
444 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
446 También se pueden definir nuevas instrucciones y elementos de
447 marcado para crear índices generales más eleborados:
449 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
450 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
451 utilizando esta variable de marcado del bloque @code{\paper}.
454 En el ejemplo siguiente se define un estilo nuevo para introducir los
455 nombres de los actos de una ópera en el índice general:
459 tocActMarkup = \markup \large \column {
461 \fill-line { \null \italic \fromproperty #'toc:text \null }
467 #(define-music-function (parser location text) (markup?)
468 (add-toc-item! 'tocActMarkup text))
471 @lilypond[line-width=11.0\cm]
472 \header { tagline = ##f }
474 tocActMarkup = \markup \large \column {
476 \fill-line { \null \italic \fromproperty #'toc:text \null }
482 #(define-music-function (parser location text) (markup?)
483 (add-toc-item! 'tocActMarkup text))
486 \markuplines \table-of-contents
487 \tocAct \markup { Atto Primo }
488 \tocItem \markup { Coro. Viva il nostro Alcide }
489 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
490 \tocAct \markup { Atto Secondo }
491 \tocItem \markup { Sinfonia }
492 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
499 Archivos de inicio: @file{ly/@/toc@/-init@/.ly}.
503 @funindex \table-of-contents
504 @code{\table-of-contents}
509 @node Working with input files
510 @section Working with input files
513 UNTRANSLATED NODE: IGNORE ME
518 * Including LilyPond files::
519 * Different editions from one source::
521 * Displaying LilyPond notation::
524 @node Including LilyPond files
525 @subsection Including LilyPond files
528 UNTRANSLATED NODE: IGNORE ME
532 @node Different editions from one source
533 @subsection Different editions from one source
536 UNTRANSLATED NODE: IGNORE ME
545 @node Using variables
546 @unnumberedsubsubsec Using variables
549 UNTRANSLATED NODE: IGNORE ME
554 @unnumberedsubsubsec Using tags
557 UNTRANSLATED NODE: IGNORE ME
562 @subsection Text encoding
565 UNTRANSLATED NODE: IGNORE ME
569 @node Displaying LilyPond notation
570 @subsection Displaying LilyPond notation
573 UNTRANSLATED NODE: IGNORE ME
577 @node Controlling output
578 @section Controlling output
581 UNTRANSLATED NODE: IGNORE ME
586 * Extracting fragments of music::
587 * Skipping corrected music::
590 @node Extracting fragments of music
591 @subsection Extracting fragments of music
594 UNTRANSLATED NODE: IGNORE ME
598 @node Skipping corrected music
599 @subsection Skipping corrected music
602 UNTRANSLATED NODE: IGNORE ME
612 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
613 Instrumentos Musicales) es un estándar para interconectar y controlar
614 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
615 una serie de notas dentro de un conjunto de pistas. No es un archivoo
616 de sonidos reales; se necesita un programa reproductor especial para
617 traducir la serie de notas en sonidos de verdad.
619 Cualquier música se puede convertir a archivos MIDI, de manera que
620 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
621 para comprobar la corrección de la música; las octavas equivocadas o
622 las alteraciones erróneas se ponen de relieve muy claramente al
623 escuchar la salida MIDI.
627 Muchhos efectos con interés musical como el swing, la articulación, el
628 fraseo, etc., no se traducen al midi.
630 La salida midi reserva un canal para cada pentagrama, y uno más para
631 los ajustes globales. Por ello, el archivo de entrada no debería
632 tener más de 15 pentagramas (o 14 si no usa percusión). Los otros
633 pentagramas permanecerán en silencio.
635 No todos los reproductores de midi manejan correctamente los cambios
636 de tempo en la salida midi. Entre los reproductores que se sabe que
637 funcionan, se encuentra
638 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
642 * Creating MIDI files::
644 * What goes into the MIDI output?::
646 * Controlling MIDI dynamics::
649 @node Creating MIDI files
650 @subsection Creating MIDI files
652 Para crear un MIDI a partir de una pieza de música, escriba un bloque
653 @code{\midi} en la partitura, por ejemplo:
661 tempoWholesPerMinute = #(ly:make-moment 72 4)
667 El tempo se puede especificar utilizando la instrucción @code{\tempo}
668 dentro de la propia música, véase @ref{Metronome marks}. Más abajo se
669 muestra una alternativa que no da lugar a una indicación metronómica
670 en la partitura impresa. En este ejemplo, el tempo de negras se
671 establece en 72 pulsos por minuto. Esta clase de especificación del
672 tempo no puede tomar notas con puntillo como argumento. En este caso,
673 divida las notas con puntillo en unidades más pequeñas. Por ejemplo,
674 un tempo de 90 negras con puntillo por minuto se puede especificar
675 como 270 corcheas por minuto:
678 tempoWholesPerMinute = #(ly:make-moment 270 8)
681 Si hay una instrucción @code{\midi} dentro de un @code{\score},
682 solamente se producirá MIDI. Si se necesita también una notación
683 impresa, se debe escribir un bloque @code{\layout}
692 @cindex layout, bloque
696 Se interpretan las ligaduras de unión, los matices dinámicos y los
697 cambios de tempo. Las marcas dinámicas, crescendi y decrescendi se
698 traducen en niveles de volumen MIDI. Las marcas de dinámica se
699 traducen a una fracción fija del rango de volumen MIDI disponible, los
700 crescendi y decrescendi hacen que el volumen varíe de forma lineal
701 entre sus dos extremos. Las fracciones se pueden ajustar mediante
702 @code{dynamicAbsoluteVolumeFunction} dentro de un contexto
703 @rinternals{Voice}. Para cada tipo de instrumento MIDI se puede
704 definir un rango de volumen. Esto proporciona un control de
705 ecualización básico, que puede realzar significativamente la calidad
706 de la salida MIDI. El ecualizador se puede controlar estableciendo un
707 valor para @code{instrumentEqualizer}, o fijando
710 \set Staff.midiMinimumVolume = #0.2
711 \set Staff.midiMaximumVolume = #0.8
714 Para quitar los matices dinámicos de la salida MIDI, escriba las
715 siguientes líneas dentro de la sección @code{\midi@{@}}.
722 \remove "Dynamic_performer"
730 Los (de)crescendos sin terminar no se procesarán adecuadamente en el
731 archivo midi, dando como resultado pasajes de música en silenco. Una
732 forma de sortearlo es terminar el (de)crescendo explícitamente. Por
740 no funcionará bien, pero
750 Solamente se crea una salida MIDI cuando la instrucción @code{\midi}
751 está dentro de un bloque @code{\score}. Si lo escribe dentro de un
752 contexto instanciado explícitamente (es decir: @code{\new Score} ) el
753 archivo no se producirá. Para solucionarlo, encierre el @code{\new
754 Score} y el @code{\midi} dentro de un bloque @code{\score}.
758 \new Score @{ @dots{}notas@dots{} @}
764 @unnumberedsubsubsec Instrument names
765 @cindex instrumento, nombres de
766 @funindex Staff.midiInstrument
768 El nombre del instrumento MIDI se establece mediante la propiedad
769 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
770 de entre los que están en la lista que aparece en @ref{MIDI
774 \set Staff.midiInstrument = "glockenspiel"
778 Si el instrumento elegido no coincide exactamente con uno de los
779 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
780 Piano de Cola (@code{"acoustic grand"}).
784 @subsection MIDI block
789 El bloque @code{\midi} es similar al bloque @code{\layout}, pero algo
790 más simple. Puede contener definiciones de contexto.
793 @cindex contexto, definición de
795 Las definiciones de contexto siguen con exactitud la misma sintaxis
796 que dentro del bloque \layout. Los módulos de traducción para el
797 sonido reciben el nombre de «performers» o intérpretes. Los contextos
798 para la salida MIDI se encuentran definidos dentro de
799 @file{ly/@/performer@/-init@/.ly}.
802 @node What goes into the MIDI output?
803 @subsection What goes into the MIDI output?
806 UNTRANSLATED NODE: IGNORE ME
809 @unnumberedsubsubsec Supported in MIDI
810 @unnumberedsubsubsec Unsupported in MIDI
812 @node Repeats in MIDI
813 @subsection Repeats in MIDI
815 @cindex repeticiones, expandir
816 @funindex \unfoldRepeats
818 Con un poco de trucaje, se puede hacer que cualquier tipo de
819 repetición esté presente en la salida MIDI. Esto se consigue mediante
820 la aplicación de la función musical @code{\unfoldRepeats}. Esta
821 función cambia todas las repeticiones a repeticiones desplegadas.
823 @lilypond[quote,verbatim,fragment,line-width=8.0\cm]
825 \repeat tremolo 8 {c'32 e' }
826 \repeat percent 2 { c''8 d'' }
827 \repeat volta 2 {c'4 d' e' f'}
836 Al crear un archivo de partitura que use @code{\unfoldRepeats} para el
837 MIDI, es necesario hacer dos bloques @code{\score}: uno para el MIDI
838 (con repeticiones desplegadas) y otro para la notación impresa (con
839 repeticiones de volta --primera y segunda vez--, tremolo --trémolo--,
840 y percent --repetición de compases--). Por ejemplo,
848 \unfoldRepeats @var{..música..}
854 @node Controlling MIDI dynamics
855 @subsection Controlling MIDI dynamics
858 UNTRANSLATED NODE: IGNORE ME
862 @unnumberedsubsubsec Dynamic marks
863 @unnumberedsubsubsec Overall MIDI volume
864 @unnumberedsubsubsec Equalizing different instruments (i)
865 @unnumberedsubsubsec Equalizing different instruments (ii)