Siguiente: , Anterior: Integrar música y texto, Arriba: LilyPond-book


4.3 Opciones de fragmentos de música

Durante los próximos párrafos, una ‘instrucción de LilyPond’ se refiere a cualquier instrucción descrita en las secciones anteriores que se maneja por parte de lilypond-book para que produzca un fragmento de música. Por simplicidad, las instrucciones de LilyPond solamente se muestran en la sintaxis de LaTeX.

Observe que la cadena de opciones se analiza de izquierda a derecha; si una opción aparece varias veces, se toma la última solamente.

Están disponibles las siguientes opciones para las instrucciones de LilyPond:

staffsize=altura
Establecer la altura del pentagrama como altura, medida en puntos.
ragged-right
Producir líneas no justificadas por la derecha y con espaciado natural, es decir, se añade ragged-right = ##t al fragmento de LilyPond. Esta es la opción predeterminada para la instrucción \lilypond{} si no está presente la opción line-width. También es la opción predeterminada para el entorno lilypond si está establecida la opción fragment, y no se especifica la anchura de la línea explícitamente.
packed
Producir líneas con el espaciado empaquetado, es decir, se añade packed = ##t al fragmento de código de LilyPond.
line-width
line-width=tamaño\unidades
Establecer el ancho de línea como tamaño, utilizando unidades como unidad. unidades es una de las siguientes cadenas: cm, mm, in o pt. Esta opción afecta a la salida de LilyPond (esto es, a la longitud del pentagrama del fragmento musical), no al formato del texto.

Si se usa sin ningún argumento, se establece el ancho de la línea a un valor predeterminado (calculado con un algoritmo heurístico).

Si no se da ninguna opción line-width, lilypond-book trata de adivinar un valor predeterminado para los entornos lilypond que no usan la opción ragged-right.

notime
No imprimir la indicación de compás, y desactivar las indicaciones temporales de la música (armadura y líneas divisorias).
fragment
Hacer que lilypond-book añada algunos códigos necesarios para que podamos escribir simplemente, por ejemplo,
     c'4

sin \layout, \score, etc.

nofragment
No añadir escribir el código adicional que completa la sintaxis de LilyPond en los fragmentos de música. Al ser la opción predeterminada, nofragment normalmente es redundante.
indent=tamaño\unidades
Establecer el sangrado del primer sistema de pentagramas como tamaño, utilizando unidades como unidad. unidades es una de las siguientes cadenas: cm, mm, in o pt. Esta opción afecta a LilyPond, no al formato del texto.
noindent
Establecer el sangrado del primer sistema de la música como cero. Esta opción afecta a LilyPond, no al formato del texto. Puesto que el valor predeterminado es que no haya ningún sangrado, noindent normalmente es redundante.
quote
Reducir la longitud de la línea de un fragmento musical en 2*0.4in (pulgadas) y colocar la salida dentro de un bloque de cita (quotation). El valor de ‘0.4in’ se puede controlar con la opción exampleindent.
exampleindent
Establecer la longitud del sangrado que la opción quote aplica al fragmento musical.
relative
relative=n
Usar el modo de octava relativa. De forma predeterminada, las notas se especifican con relación al Do central. El argumento entero opcional especifica la octava de la nota inicial, donde el valor predeterminado 1 es el Do central.

LilyPond utiliza también lilypond-book para producir su propia documentación. Para hacerlo, están a nuestra disposición ciertas opciones algo esotéricas para los fragmentos musicales.

verbatim
El argumento de una instrucción de LilyPond se copia al archivo de salida y se incluye dentro de un bloque «verbatim» o preformateado, seguido del texto que se escriba con la opción intertext (que no funciona aún); después se imprime la música en sí. Esta opción no funciona bien con \lilypond{} si forma parte de un párrafo.

Si se usa la opción verbatim dentro de una instrucción lilypondfile, es posible incluir con estilo preformateado sólo una parte del archivo fuente. Si el archivo de código fuente contiene un comentario que contiene ‘begin verbatim’ (sin las comillas), la cita del bloque de estilo preformateado empezará después de la última vez que aparezca este comentario; de forma similar, la cita del bloque preformateado se detendrá justo antes de la primera vez que aparezca un comentario que contenga ‘end verbatim’, si lo hay. En el siguiente ejemplo de código fuente, la música se interpreta en el modo relativo, pero la cita preformateada no presentará el bloque relative, es decir

     \relative c' { % begin verbatim
       c4 e2 g4
       f2 e % end verbatim
     }

se imprimirá como un bloque preformateado como

       c4 e2 g4
       f2 e

addversion
(Sólo para la salida de Texinfo.) Anteponer la línea \version @w{"@version{}"} a la salida de verbatim.
texidoc
(Sólo para la salida de Texinfo.) Si se llama a lilypond con la opción --header=texidoc, y el archivo que se procesa se llama fulanito.ly, crea un archivo fulanito.texidoc si existe un campo texidoc dentro del bloque \header de cabecera. La opción texidoc hace que lilypond-book incluya estos archivos, añadiendo su contenido como un bloque de documentación inmediatamente antes del fragmento musical.

Suponiendo que el archivo fulanito.ly contiene

     \header {
       texidoc = "Este archivo es un ejemplo de una sola nota."
     }
     { c'4 }

y que tenemos lo siguiente en nuestro documento de Texinfo prueba.texinfo

     @lilypondfile[texidoc]{fulanito.ly}

la siguiente orden da como salida el resultado esperado:

     lilypond-book --process="lilypond --format=tex --tex \
                   --header=texidoc prueba.texinfo

La mayoría de los documentos de prueba de LilyPond (en el directorio input de la distribución) son pequeños archivos .ly que tienen exactamente este aspecto.

lilyquote
(Sólo para la salida de Texinfo.) Esta opción es similar a quote, pero se pone dentro del bloque de cita solamente el fragmento de música (y el bloque preformateado que se da en la opción verbatim). Esta opción es útil si queremos citar (quote) el fragmento musical pero no el bloque de documentación texidoc.
printfilename
Si un archivo de entrada de LilyPond se incluye con \lilypondfile, imprimir el nombre del archivo inmediatamente antes del fragmento musical. Para la salida HTML, esto es un enlace. Sólo se imprime el nombre base del archivo, es decir, se elimina la parte del directorio de la ruta del archivo.
fontload
Esta opción incluye las fuentes tipográficas en todos los archivos EPS generados para este fragmento. Se debe usar si el fragmento usa cualquier tipografía que LaTeX no es capaz de encontrar por sí solo.

Esta página corresponde a LilyPond-2.11.58 (rama de desarrollo).

Informe de los fallos a través de la lista en español lilypond-es, o en inglés a través de http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs.

Se agradecen las sugerencias para la documentación.

Otros idiomas: English, deutsch.