1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: 1d64963847973b27eeff0129094fde8541c29f6f
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @node General input and output
13 @chapter General input and output
15 Esta sección trata de asuntos relacionados con la entrada y salida
16 generales de LilyPond, más que con la notación específica.
20 * Titles and headers::
21 * Working with input files::
22 * Controlling output::
27 @section Input structure
29 El formato principal de entrada para LilyPond son archivos de texto.
30 Por convenio, el nombre de estos archivos termina en @code{.ly}.
33 * Structure of a score::
34 * Multiple scores in a book::
38 @node Structure of a score
39 @subsection Structure of a score
44 @node Multiple scores in a book
45 @subsection Multiple scores in a book
51 @subsection File structure
56 @node Titles and headers
57 @section Titles and headers
59 Casi toda la música impresa tiene un título y el nombre del
60 compositor; ciertas piezas tienen mucha más información.
65 * Reference to page numbers::
70 @subsection Creating titles
72 Se crean títulos para cada uno de los bloques @code{\score} así como
73 para todo el archivo de entrada (o bloque @code{\book} (libro)).
75 El contenido de cada título se extrae a partir de los bloques
76 @code{\header} (cabecera). El bloque de cabecera de un libro
77 contempla lo siguiente:
82 El dedicatario de la música, centrado en lo alto de la primera página.
86 El título de la música, centrado justo debajo de la
91 Subtítulo, centrado debajo del título.
95 Sub-subtítulo, centrado debajo del subtítulo.
99 Nombre del poeta, a la izquierda, debajo del subtítulo.
103 Nombre del compositor, a la derecha, debajo del subtítulo.
107 Texto de la medida, a la izquierda, debajo del poeta.
111 Nombre del Opus, a la derecha, debajo del compositor.
115 Nombre del arreglista, a la derecha, debajo del Opus.
119 Nombre del instrumento, centrado, debajo del arreglista. También
120 aparece centrado en lo alto de cada página (aparte de la primera).
124 Nombre de la pieza, a la izquierda, debajo del instrumento.
126 @cindex página, saltos, forzar
127 @funindex breakbefore
129 Esto fuerza que el título comience sobre una página nueva (establézcalo a ##t o a ##f).
133 Aviso de Copyright, centrado en la parte inferior de la primera
134 página. Para insertar el símbolo de copyright symbol, consulte
139 Cartel de propósito general en el pie de página, centrado al final de la última.
143 A continuación presentamos una demostración de todos los campos que
144 están disponibles. Fíjese en que puede utilizar en la cabecera
145 cualquier instrucción de marcado de texto (Véase @ref{Formatting text}).
147 @lilypond[quote,verbatim,line-width=11.0\cm]
150 paper-height = 10.0\cm
155 dedication = "dedicated to me"
156 title = \markup \center-column { "Title first line" "Title second line,
158 subtitle = "the subtitle,"
159 subsubtitle = #(string-append "subsubtitle LilyPond version "
162 composer = \markup \center-column { "composer" \small "(1847-1973)" }
163 texttranslator = "Text Translator"
164 meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
166 arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
167 #-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "nger" }
168 instrument = \markup \bold \italic "instrument"
192 Como se mostró anteriormente, puede usar varios bloques
193 @code{\header}. Cuando los mismos campos aparecen en distintos
194 bloques, tiene validez el último en definirse. A continuación un
199 composer = "Compositor"
207 piece = "Otra pieza" % sobreescribe a la anterior
212 Si define la cabecera @code{\header} dentro del bloque @code{\score},
213 por lo general se imprimirán solamente las cabeceras @code{piece} y
214 @code{opus}. Fíjese en que la expresión musical debe aparecer antes
217 @lilypond[quote,verbatim,line-width=11.0\cm]
221 title = "title" % not printed
228 @funindex printallheaders
230 Se puede cambiar este comportamiento (e imprimir todas las cabeceras
231 cuando la cabecera @code{\header} está definida dentro del bloque
232 @code{\score}) mediante la utilización de
243 El pie de página por omisión se encuentra vacío, excepto para la
244 primera página, en la que se inserta el campo de @code{copyright}
245 extraído del @code{\header}, y para la última página, en la que se
246 escribe el cartel @code{tagline} sacado del bloque @code{\header}. La
247 línea por omisión para este cartel es @qq{Music engraving by LilyPond
248 (@var{version})}.@footnote{Las partituras bien tipografiadas son una
249 magnífica promoción para nosotros, así que por favor, si puede,
250 conserve intacta la línea del letrero.}
252 Las cabeceras se pueden quitar completamente estableciendo su valor a
264 @subsection Custom titles
266 Una opción más avanzada es cambiar las definiciones de las variables
267 siguientes dentro del bloque @code{\paper} block. El archivo de
268 inicio @file{ly/titling-init.ly} ofrece un listado de la disposición
272 @funindex bookTitleMarkup
273 @item bookTitleMarkup
274 Es el título que se escribe en lo alto del documento de salida
275 completo. Normalmente contiene el compositor y el título de la pieza.
277 @funindex scoreTitleMarkup
278 @item scoreTitleMarkup
279 Es el título que se coloca por encima de un bloque @code{\score}.
280 normalmente contiene el nombre del movimiento (campo @code{piece}).
282 @funindex oddHeaderMarkup
283 @item oddHeaderMarkup
284 Es el encabezamiento de las páginas de numeración impar.
286 @funindex evenHeaderMarkup
287 @item evenHeaderMarkup
288 Es el encabezamiento de las páginas de numeración par. Si se deja
289 sin especificar, se usará el encabezamiento de las páginas impares.
291 De forma predeterminada, los encabezamientos se definen de tal forma
292 que el número de página está en el borde exterior, y el isntrumento
295 @funindex oddFooterMarkup
296 @item oddFooterMarkup
297 Es el pie de las páginas de numeración impar.
299 @funindex evenFooterMarkup
300 @item evenFooterMarkup
301 Es el pie de las páginas de numeración par. Si se deja sin
302 especificar, se usará en su lugar el encabezamiento de las páginas
305 De forma predeterminada, el pie de página tiene el aviso de
306 copyright en la primera página, y el cartel @code{tagline} en la
312 @cindex encabezamiento
315 @cindex disposición de la página
318 La definición siguiente pone el título en el extremo izquierdo, y el
319 compositor en el extremo derecho sobre una única línea.
323 bookTitleMarkup = \markup {
325 \fromproperty #'header:title
326 \fromproperty #'header:composer
332 @node Reference to page numbers
333 @subsection Reference to page numbers
335 Se puede marcar un lugar determinado de una partitura utilizando la
336 instrucción @code{\label} (etiqueta), bien en lo alto de la estructura
337 o bien dentro de la música. Posteriormente se puede hacer referencia
338 a esta etiqueta dentro de un elemento de marcado, para obtener el
339 número de la página en que se encuentra la marca, usando la
340 instrucción de marcado @code{\page-ref}.
342 @lilypond[verbatim,line-width=11.0\cm]
343 \header { tagline = ##f }
349 \pageBreak \mark A \label #'markA
354 \markup { The first score begins on page \page-ref #'firstScore "0" "?" }
355 \markup { Mark A is on page \page-ref #'markA "0" "?" }
359 La instrucción de marcado @code{\page-ref} toma tres argumentos:
361 @item la etiqueta, un símbolo de scheme, p.ej. @code{#'firstScore};
362 @item un elemento de marcado que se usará como medidor para estimar las dimensiones del marcado;
363 @item un elemento de marcado que se utilizará en sustitución del número de página si la etiqueta es desconocida.
366 El motivo de que se necesite un medidor es que en el momento en que se
367 están interpretando los marcados, los saltos de página aún no se han
368 producido y por tanto los números de página no se conocen todavía.
369 Para sortear este inconveniente, la interpretación real del marcado se
370 retrasa hasta un momento posterior; sin embargo, las dimensiones del
371 marcado se tienen que conocer de antemano, así que se usa el medidor
372 para decidir estas dimensiones. Si el libro tiene entre 10 y 99
373 páginas, el medidor puede ser "00", es decir, un número de dos
383 @node Table of contents
384 @subsection Table of contents
385 Se puede insertar un índice general o tabla de contenidos utilizando
386 la instrucción @code{\markuplines \table-of-contents}. Los elementos
387 que deben aparecer en la tabla de contenidos se introducen con la
388 instrucción @code{\tocItem}, que se puede usar en el nivel más alto de
389 la jerarquía del código, o dentro de una expresión musical.
392 \markuplines \table-of-contents
395 \tocItem \markup "Primera partitura"
399 \tocItem \markup "Un punto concreto dentro de la primera partitura"
404 \tocItem \markup "Segunda partitura"
412 Los elementos de marcado que se usan para dar formato al índice
413 general se encuentran definidos dentro del bloque @code{\paper}. Los
414 elementos predeterminados son @code{tocTitleMarkup}, para dar formato
415 al título de la tabla, y @code{tocItemMarkup}, para aplicar formato a
416 los elementos del índice, que consisten en el título del elemento y el
417 número de página. Estas variables se pueden cambiar por parte del
422 %% Traducir el título del índice al español:
423 tocTitleMarkup = \markup \huge \column {
424 \fill-line { \null "Índice general" \null }
427 %% usar una fuente mayor
428 tocItemMarkup = \markup \large \fill-line {
429 \fromproperty #'toc:text \fromproperty #'toc:page
434 Observe la forma en que nos referimos al texto y al número de página
435 del elemento de índice, dentro de la definición @code{tocItemMarkup}.
437 También se pueden definir nuevas instrucciones y elementos de
438 marcado para crear índices generales más eleborados:
440 @item en primer lugar, defina una variable de marcado nueva dentro del bloque @code{\paper}
441 @item luego defina una función de música cuyo propósito es añadir un elemento al índice general
442 utilizando esta variable de marcado del bloque @code{\paper}.
445 En el ejemplo siguiente se define un estilo nuevo para introducir los
446 nombres de los actos de una ópera en el índice general:
450 tocActMarkup = \markup \large \column {
452 \fill-line { \null \italic \fromproperty #'toc:text \null }
458 #(define-music-function (parser location text) (markup?)
459 (add-toc-item! 'tocActMarkup text))
462 @lilypond[line-width=11.0\cm]
463 \header { tagline = ##f }
465 tocActMarkup = \markup \large \column {
467 \fill-line { \null \italic \fromproperty #'toc:text \null }
473 #(define-music-function (parser location text) (markup?)
474 (add-toc-item! 'tocActMarkup text))
477 \markuplines \table-of-contents
478 \tocAct \markup { Atto Primo }
479 \tocItem \markup { Coro. Viva il nostro Alcide }
480 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
481 \tocAct \markup { Atto Secondo }
482 \tocItem \markup { Sinfonia }
483 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
490 Archivos de inicio: @file{ly/@/toc@/-init@/.ly}.
494 @funindex \table-of-contents
495 @code{\table-of-contents}
500 @node Working with input files
501 @section Working with input files
504 * Including LilyPond files::
505 * Different editions from one source::
507 * Displaying LilyPond notation::
510 @node Including LilyPond files
511 @subsection Including LilyPond files
516 @node Different editions from one source
517 @subsection Different editions from one source
519 Se encuentran disponibles varios mecanismos para facilitar la
520 producción de distintas versiones de una partitura a partir de la
521 misma fuente musical. Las variables son quizá más útiles para
522 combinar secciones extensas de música y/o anotaciones de diversas
523 formas, mientras que las etiquetas son más útiles para seleccionar una
524 de entra varias secciones de música más cortas. Cualquiera que sea el
525 método utilizado, la separación de la notación de la estructura de la
526 partitura hará que sea más fácil cambiar la estructura dejando intacta
534 @node Using variables
535 @unnumberedsubsubsec Using variables
541 @unnumberedsubsubsec Using tags
547 @subsection Text encoding
552 @node Displaying LilyPond notation
553 @subsection Displaying LilyPond notation
558 @node Controlling output
559 @section Controlling output
562 * Extracting fragments of music::
563 * Skipping corrected music::
566 @node Extracting fragments of music
567 @subsection Extracting fragments of music
572 @node Skipping corrected music
573 @subsection Skipping corrected music
584 El MIDI (Musical Instrument Digital Interface, Interfase Digital para
585 Instrumentos Musicales) es un estándar para interconectar y controlar
586 instrumentos musicales electrónicos. Un archivo o secuencia MIDI es
587 una serie de notas dentro de un conjunto de pistas. No es un archivoo
588 de sonidos reales; se necesita un programa reproductor especial para
589 traducir la serie de notas en sonidos de verdad.
591 Cualquier música se puede convertir a archivos MIDI, de manera que
592 podamos escuchar lo que hayamos introducido. Esto es muy conveniente
593 para comprobar la corrección de la música; las octavas equivocadas o
594 las alteraciones erróneas se ponen de relieve muy claramente al
595 escuchar la salida MIDI.
599 Muchos efectos con interés musical como el swing, la articulación, el
600 fraseo, etc., no se traducen al midi.
602 La salida midi reserva un canal para cada pentagrama, y uno más para
603 los ajustes globales. Por ello, el archivo de entrada no debería
604 tener más de 15 pentagramas (o 14 si no usa percusión). Los otros
605 pentagramas permanecerán en silencio.
607 No todos los reproductores de midi manejan correctamente los cambios
608 de tempo en la salida midi. Entre los reproductores que se sabe que
609 funcionan, se encuentra
610 @uref{http://@/timidity@/.sourceforge@/.net/,timidity}.
614 * Creating MIDI files::
616 * What goes into the MIDI output?::
618 * Controlling MIDI dynamics::
621 @node Creating MIDI files
622 @subsection Creating MIDI files
624 Para crear un MIDI a partir de una pieza de música, escriba un bloque
625 @code{\midi} en la partitura, por ejemplo:
633 tempoWholesPerMinute = #(ly:make-moment 72 4)
639 El tempo se puede especificar utilizando la instrucción @code{\tempo}
640 dentro de la propia música, véase @ref{Metronome marks}. Más abajo se
641 muestra una alternativa que no da lugar a una indicación metronómica
642 en la partitura impresa. En este ejemplo, el tempo de negras se
643 establece en 72 pulsos por minuto. Esta clase de especificación del
644 tempo no puede tomar notas con puntillo como argumento. En este caso,
645 divida las notas con puntillo en unidades más pequeñas. Por ejemplo,
646 un tempo de 90 negras con puntillo por minuto se puede especificar
647 como 270 corcheas por minuto:
650 tempoWholesPerMinute = #(ly:make-moment 270 8)
653 Si hay una instrucción @code{\midi} dentro de un @code{\score},
654 solamente se producirá MIDI. Si se necesita también una notación
655 impresa, se debe escribir un bloque @code{\layout}
664 @cindex layout, bloque
668 Se interpretan las ligaduras de unión, los matices dinámicos y los
669 cambios de tempo. Las marcas dinámicas, crescendi y decrescendi se
670 traducen en niveles de volumen MIDI. Las marcas de dinámica se
671 traducen a una fracción fija del rango de volumen MIDI disponible, los
672 crescendi y decrescendi hacen que el volumen varíe de forma lineal
673 entre sus dos extremos. Las fracciones se pueden ajustar mediante
674 @code{dynamicAbsoluteVolumeFunction} dentro de un contexto
675 @rinternals{Voice}. Para cada tipo de instrumento MIDI se puede
676 definir un rango de volumen. Esto proporciona un control de
677 ecualización básico, que puede realzar significativamente la calidad
678 de la salida MIDI. El ecualizador se puede controlar estableciendo un
679 valor para @code{instrumentEqualizer}, o fijando
682 \set Staff.midiMinimumVolume = #0.2
683 \set Staff.midiMaximumVolume = #0.8
686 Para quitar los matices dinámicos de la salida MIDI, escriba las
687 siguientes líneas dentro de la sección @code{\midi@{@}}.
694 \remove "Dynamic_performer"
702 Los (de)crescendos sin terminar no se procesarán adecuadamente en el
703 archivo midi, dando como resultado pasajes de música en silenco. Una
704 forma de sortearlo es terminar el (de)crescendo explícitamente. Por
712 no funcionará bien, pero
722 Solamente se crea una salida MIDI cuando la instrucción @code{\midi}
723 está dentro de un bloque @code{\score}. Si lo escribe dentro de un
724 contexto instanciado explícitamente (es decir: @code{\new Score} ) el
725 archivo no se producirá. Para solucionarlo, encierre el @code{\new
726 Score} y el @code{\midi} dentro de un bloque @code{\score}.
730 \new Score @{ @dots{}notas@dots{} @}
736 @unnumberedsubsubsec Instrument names
737 @cindex instrumento, nombres de
738 @funindex Staff.midiInstrument
740 El nombre del instrumento MIDI se establece mediante la propiedad
741 @code{Staff.midiInstrument}. El nombre del instrumento se debe elegir
742 de entre los que están en la lista que aparece en @ref{MIDI
746 \set Staff.midiInstrument = "glockenspiel"
750 Si el instrumento elegido no coincide exactamente con uno de los
751 instrumentos de la lista de instrumentos MIDI, se usará el instrumento
752 Piano de Cola (@code{"acoustic grand"}).
756 @subsection MIDI block
761 El bloque @code{\midi} es similar al bloque @code{\layout}, pero algo
762 más simple. Puede contener definiciones de contexto.
765 @cindex contexto, definición de
767 Las definiciones de contexto siguen con exactitud la misma sintaxis
768 que dentro del bloque \layout. Los módulos de traducción para el
769 sonido reciben el nombre de «performers» o intérpretes. Los contextos
770 para la salida MIDI se encuentran definidos dentro de
771 @file{ly/@/performer@/-init@/.ly}.
774 @node What goes into the MIDI output?
775 @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
825 La dinámica en el MIDI está implementada por medio del intérprete
826 Dynamic_performer que reside de forma predeterminada dentro del
827 contexto Voice. Es posible controlar el volumen MIDI general, el
828 volumen relativo de los matices dinámicos y el volumen relativo de los
829 distintos instrumentos.
831 @unnumberedsubsubsec Dynamic marks
832 @unnumberedsubsubsec Overall MIDI volume
833 @unnumberedsubsubsec Equalizing different instruments (i)
834 @unnumberedsubsubsec Equalizing different instruments (ii)
836 @node Percussion in MIDI
837 @subsection Percussion in MIDI