[ << Ejecutar LilyPond ]	[Top][Contents][Index]	[ Actualizar ficheros con convert-ly >> ]
[ < Opciones básicas de la línea de órdenes para LilyPond ]	[ Up: Utilización desde la línea de órdenes ]	[ Variables de entorno > ]

---

Opciones avanzadas de línea de órdenes para LilyPond

La opción -d es la interfaz de la línea de órdenes a la función de Scheme de LilyPond ly:set-option. Esto significa que todas las opciones que se relacionan aquí pueden establecerse también dentro de los propios archivos .ly.

-d, --define-default=opción[=valor]

-d, --define-default=no-opción

Fijar el símbolo interno de Scheme equivalente opción a valor. Por ejemplo, la opción de línea de órdenes

-dbackend=svg

equivale a

#(ly:set-option 'backend 'svg)

dentro de un archivo de entrada de LilyPond.

Si no se proporciona el valor, usar #t como valor. Se puede añadir el prefijo no- a la opción para ‘desactivar’ una opción, aportando #f como valor. Por ejemplo,

-dpoint-and-click="#f"

es lo mismo que

-dno-point-and-click

[Observe que el carácter ‘#’ introduce un comentario en muchos shells. Por este motivo se recomienda siempre entrecomillar las expresiones que lo contengan.]

La siguiente tabla relaciona todos los nombres de opción junto con sus valores. Dentro del código de Scheme, los valores de opción se pueden leer usando la función ly:get-option.

anti-alias-factor número

Generar el gráfico a mayor resolución (usando el factor número, which must be a positive integer ≤ 8) y reducir la escala para evitar el pixelado en las imágenes PNG. Predeterminado: 1.

aux-files bool

Si bool es #t, crear archivos .tex, .texi y .count. Esta opción existe principalmente para usarla por parte de lilypond-book. Predeterminado: #f.

backend símbolo

Usar símbolo como backend para la salida de LilyPond. Los valores posiboles son:

ps

Es el ajuste predeterminado. Los archivos de PostScript incluyen las fuentes TTF, Type1 y OTF. No se genera ningún ‘subconjunto’ de dichas fuentes tipográficas. Advierta que el uso de conjuntos de caracteres ‘orientales’ como el japonés puede dar lugar a archivos de tamaño muy grande.

Para la salida PDF se utiliza también el backend ps; los datos PS resultantes se post-procesan mediante el guión ps2pdf de Ghostscript, que también efectúa subconjuntos de fuentes de manera predeterminada.

cairo

Crea una salida de gráficos a través de la biblioteca Cairo. Este backend puede producir salidas PS, EPS, PDF, PNG y SVG.

svg

Gráficos vectoriales escalables. Por cada página de la salida, se crea un solo archivo SVG. Los glifos musicales se codifican como gráficos vectoriales, pero las fuentes tipográficas del texto no se incrustan en los archivos SVG. Cualquier visor de SVG necesita que las fuentes de texto correspondientes estén disponibles para la correcta representación tanto del texto como de la letra. Se recomienda no utilizar ‘alias’ ni ‘listas’ de fuentes tipográficas por si el visor de SVG no es capaz de manejarlas.

clip-systems bool

Si bool es #t, extraer fragmentos de música de la partitura. Requiere que la función clip-regions esté definida dentro del bloque \layout. Véase Extracción de fragmentos de música. No se extrae ningún fragmento si se usa con la opción -dno-print-pages. Predeterminado: #f.

compile-scheme-code bool

Usar el compilador Guile para ejecutar código de Scheme, en lugar del evaluador. Para más información, véase Debugging Scheme code.

crop bool

Si bool es #t, se crea un segundo archivo PDF (con la extensión .cropped.pdf), junto con una copia de él en formato imagen de matriz de puntos (con la extensión .cropped.png). Esta salida incluye toda la música y los títulos de cabecera, sin los márgenes, en una sola imagen, posiblemente muy alta. Si se establece la opción --eps o --ps, se produce un archivo EPS recortado (con la extensión .cropped.eps) en lugar de un PDF recortado. Predeterminado: #f.

De acuerdo con el funcionamiento de LilyPond, las dimensiones del archivo de salida que se crea siempre se redondean a un número entero de puntos grandes de PostScript; esto puede producir una pequeña cantidad de espacio en blanco en el margen derecho. Para evitarlo, establezca la variable de papel line-width a un número entero de puntos grandes como 450\bp.

Observe que por el momento esta opción no se adapta demasiado bien a la salida multisistema porque el espacio vertical entre los sistemas se elimina.

datadir

Prefijo de los archivos de datos. Esta opción es de solo lectura; su establecimiento no tiene ningún efecto.

debug-eval bool

Si bool es #t, usar el evaluador depurador de Scheme, que imprime trazas con números de línea cuando hay errores. Predeterminado: #f, o #t cuando se usa --verbose.

debug-skylines bool

Si bool es #t, efectuar una depuración de las líneas de horizonte. Predeterminado: #f.

delete-intermediate-files bool

Si bool es #t, eliminar los archivos intermedios .ps inútiles que se crean durante la compilación. Predeterminado: #t.

embed-source-code bool

Si bool es #t, empotrar los archivos de entrada en código de LilyPond dentro del documento PDF generado. Predeterminado: #f.

eps-box-padding número

Rellenar el borde izquierdo de la caja contenedora (bounding box) del EPS de salida en número milímetros. Predeterminado: #f (que significa que no se rellena la caja contenedora).

first cadena

Mostrar solo la música que tenga una longitud dada por cadena al principio. Esto es equivalente a

showFirstLength = cadena

si se escribe al principio del archivo de entrada. Si están fijadas tanto -dfirst como showFirstLength, la opción de la línea de órdenes tiene prioridad. Véase Extracción de fragmentos de música. Predeterminado: #f.

font-export-dir cadena

Fijar el directorio para la exportación de fuentes tipográficas como archivos de PostScript a cadena. Esto es de utilidad cuando queremos crear primero un PDF sin las fuentes incrustadas, e incrustar más tarde las fuentes con Ghostscript como se ve más abajo.

$ lilypond -dfont-export-dir=fontdir \
           -dgs-never-embed-fonts foo.ly
$ gs -q -dBATCH -dNOPAUSE -sDEVICE=pdfwrite \
     -sOutputFile=foo.embedded.pdf foo.pdf fontdir/*.font.ps

Nota: a diferencia de font-ps-resdir, este método no puede empotrar las fuentes CID con Ghostscript 9.26 y posteriores.

Nota: de forma parecida a font-ps-resdir, esta opción se salta las fuentes TrueType porque el empotrado de fuentes TrueType puede producir un desbaratamiento de los caracteres. Para evitar este dessbaratabiento, use gs-never-embed-fonts, pues a pesar de su nombre esta opción empotra las fuentes TrueType.

Predeterminado: #f (que significa no exportar el directorio).

font-ps-resdir cadena

Fijar el directorio (como cadena) para construir un subconjunto del directorio de recursos PostScript y usarlo para empotrar las fuentes más tarde. Esto es útil si queremos crear primero un PDF sin las fuentes empotradas y empotrar las fuentes más tarde con Ghostscript como se ve más abajo.

$ lilypond -dfont-ps-resdir=resdir \
           -dgs-never-embed-fonts foo.ly
$ gs -q -dBATCH -dNOPAUSE -sDEVICE=pdfwrite \
     -I resdir -I resdir/Font \
     -sOutputFile=foo.embedded.pdf foo.pdf

Nota: es mejor no especificar un directorio que contenga el nombre Resource porque este tiene un significado especial al especificarlo con la opción -I para Ghostscript.

Nota: a diferencia de font-export-dir, este método puede empotrar fuentes CID con Ghostscript 9.26 y posteriores.

Nota: de forma parecida a font-export-dir, esta opción se salta las fuentes TrueType porque el empotrado tardío de fuentes TrueType puede causar un desbaratamiento de los caracteres. Para evitar el desbaratamiento, use gs-never-embed-fonts, ya que este empotra las fuentes TrueType a pesar de su nombre.

Predeterminado: #f (que significa no crear subconjuntos en el directorio).

gs-load-fonts bool

Si bool es #t, cargar fuentes a través de Ghostscript. Esta opción hace que los archivos de salida de LilyPond solo contenga referencias a todas las fuentes, lo que debe después resolverse a las fuentes reales en un paso de post-procesado por medio de Ghostscript. Predeterminado: #f.

gs-load-lily-fonts bool

Si bool es #t, cargar las fuentes de LilyPond por medio de Ghostscript. Esta opción hace que los archivos de salida de LilyPond contengan solamente referencias a sus fuentes de música, lo que debe después resolverse a las fuentes reales en un paso de post-procesado por medio de Ghostscript. Todas las demás fuentes se dirigen a la salida como es habitual. Predeterminado: #f.

gs-never-embed-fonts bool

Si bool es #t, hacer que Ghostscript incruste solamente tipos de letra TrueType y ningún otro formato de fuente. Predeterminado: #f.

help bool

Si bool es #t, mostrar una pantalla de ayuda y salir. Predeterminado: #f.

include-book-title-preview bool

Si bool es #t, incluir los títulos de libro en las imágenes de vista previa. Predeterminado: #t.

include-eps-fonts bool

Si bool es #t, incluir las fuentes tipográficas en los archivos EPS de cada uno de los sistemas. Predeterminado: #t.

include-settings cadena

Incluir el archivo cadena de ajustes globales, que se incluye antes de que la partitura se procese. Esta opción se puede pasar más de una vez para incluir varios archivos. Predeterminado: sin establecer (que significa que no se incluye ningún archivo de ajustes globales).

job-count número

Procesar en paralelo, utilizando el número de tareas especificado (siendo número un entero positivo). Predeterminado: #f (que significa que no se hace ningún procesado paralelo).

last cadena

Mostrar solamente la música con una duración dada por el valor de cadena al final. Esto es equivalente a

showLastLength = cadena

si se escribe al principio del archivo de entrada. Si están establecidos tanto -dlast como showLastLength, tiene prioridad la opción de la línea de órdenes. Véase Extracción de fragmentos de música. Predeterminado: #f.

log-file cadena

Redirigir la salida hacia el archivo de registro cadena.log. Predeterminado: #f (que significa ningún archivo de registro).

max-markup-depth número

Fijar la profundidad máxima del árbol de marcado al valor número (being a non-negative integer). Si un elemento de marcado tiene más niveles, suponer que no va a finalizar por sí mismo, imprimir un mensaje de advertencia y devolver un elemento de marcado nulo en su lugar. Predeterminado: 1024.

midi-extension cadena

Fijar la extensión de archivo predeterminada para los archivos MIDI de salida a .cadena. Predeterminado: "midi".

music-strings-to-paths bool

Si bool es #t, converir las cadenas de texto a trayectos cuando los glifos pertenecen a una fuente musical. Predeterminado: #f.

paper-size cadena

Fijar el tamaño del papel a cadena. Predeterminado: "a4".

pixmap-format cadena

Establecer el formato de salida de Ghostscript para las imágenes de matriz de puntos a cadena. Predeterminado: "png16m".

png-width altura

png-height anchura

Para la salida PNG, fijar la anchura y la altura (en píxeles) del archivo de imagen creado. Si falta una de las opciones, la otra dimensión se calcula de acuerdo a la caja circundante EPS, reteniendo la relación de aspecto. Tanto altura como anchura deben ser números enteros no negativos.

Además de --png, se deben usar --eps, -dcrop o -dpreview para conseguir un escalado adecuado sin que haya recorte.

La opción -dresolution se ignora.

Observe que hay un bug en las versiones de Ghostscript hasta la 9.52 para estas dos opciones: produce imágenes PNG vacías si la altura es más grande que la anchura.

Predeterminado: 0 tanto para anchura como para altura (que significa que las dos dimensiones se derivan a partir de la caja circundante de EPS).

point-and-click valor

Si valor es #t, añadir enlaces de ‘apuntar y pulsar’ a las salidas de PDF y SVG. Hay más valores de opción posibles; see Apuntar y pulsar. Predeterminado: #t.

preview bool

Si bool es #t, crear imágenes de vista previa además de la salida normal. Predeterminado: #f.

Para un nombre de archivo de entrada archivo y el formato de salida fmt, genera un archivo de salida, con el nombre file.preview.fmt, que contiene los títulos y el primer sistema de la música. Si se están utilizando bloques \book o \bookpart, aparecen en la salida los títulos de \book, \bookpart o \score, incluido el primer sistema de cada bloque \score si la variable de \paper print-all-headers está fijada al valor #t.

Para suprimir la salida usual, utilice las opciones -dprint-pages o -dno-print-pages según sus necesidades.

print-pages bool

Si bool es #t, generar páginas completas. Predeterminado: #t.

La opción -dno-print-pages es útil en combinación con las opciones -dpreview o -dcrop.

protected-scheme-parsing bool

Si bool es #t, continuar cuando se interceptan errores en el código empotrado de Scheme dentro del analizador sintáctico. Si se establece al valor #f, detenerse cuando se produzca algún error e imprimir una traza de la pila. Predeterminado: #t.

read-file-list bool

Si bool es #t, manejar todos los argumentos de archivo en la línea de órdenes como listas de archivos de entrada de LilyPond que procesar, con un archivo de entrada por cada línea en dichas listas. Predeterminado: #f.

relative-includes bool

Cuando se procesa una instrucción \include, buscar el archivo de inclusión en una ruta relativa al archivo actual si bool es #t. Si se establece a #f, buscar el archivo según una ruta relativa al archivo raíz. Predeterminado: #t.

resolution número

Fijar la resolución para generar imágenes de matriz de puntos PNG a número ppp (que debe ser un número positivo). Predeterminado: 101.

separate-log-files bool

Para los archivos de entrada archivo1.ly, archivo2.ly, …, dar salida a datos de registro hacia los archivos archivo1.log, archivo2.log, …, si bool es #t. Predeterminado: #f.

separate-page-formats cadena

Lista de formatos separados por comas (svg, pdf, png o eps) para usarlos para las imágenes de página separadas en lilypond-book. See Otros programas. Predeterminado: #f.

show-available-fonts bool

Si bool es #t, imprimir un listado de los nombres de fuente tipográfica disponibles tal y como los proporciona la biblioteca fontconfig. Al final de esta lista, LilyPond presenta los ajustes de configuración del propio fontconfig. Predeterminado: #f.

staff-size número

Fijar el tamaño global del pentagrama en número puntos (que debe ser un número positivo). Esto es equivalente a

#(set-global-staff-size número)

si se escribe al comienzo del archivo de entrada. Predeterminado: 20pt.

strip-output-dir bool

Si bool es #t, no utilizar la parte del directorio tomada de las rutas de los archivos cuando se construyen nombres de archivos de salida. Predeterminado: #t.

strokeadjust bool

Si bool es #t, forzar el ajuste de los trazos de PostScript. Esta opción es relevante principalmente cuando se genera un PDF a partir de la salida de PostScript (el ajuste del trazo está por lo general activado automáticamente para dispositivos de mapa de puntos de baja resolución). Sin esta opción, los visores de PDF tienden a producir anchuras de plica muy poco consistentes con las resoluciones típicas de las pantallas de ordenador. Sin embargo, la opción no afecta de forma muy significativa a la calidad de la impresión y causa grandes incrementos en el tamaño del archivo PDF. Predeterminado: #f.

tall-page-formats cadena

Lista de formatos separados por comas (svg, pdf, png o eps) que usar para la imagen de ‘página larga’ en lilypond-book. See Otros programas. Predeterminado: #f.

use-paper-size-for-page bool

Si bool es #t, cada página se fija al tamaño del papel, posiblemente recortanfo partes que se salen de la página. Si se establece a #f se redimensiona la página según sea necesario de forma que todo el contenido esté incluido. Predeterminado: #t.

verbose bool

Nivel de verbosidad. Esta es una opción de solo lectura; su establecimiento no tiene ningún efecto.

warning-as-error bool

Si bool es #t, cambiar todos los mensajes de advertencia y de ‘error de programación’ a errores. Predeterminado: #f.