[icon]

GNU LilyPond

-- --

What is LilyPond
Home
Examples
Templates
Download
GNU/Linux binaries
Windows binaries
Source code
Documentation
Tutorial
Manual
Glossary
Index

Support
Mailing lists
Search
WikiWiki

External sites
lilypond.org/stable
lilypond.org/development
savannah.gnu.org
ftp.lilypond.org
Mutopia
Other music online

Invoking ly2dvi

Nicely titled output is created through a separate program: ly2dvi is a script that uses LilyPond and LaTeX to create a nicely titled piece of sheet music, in DVI format or PostScript.

             ly2dvi [option]... file...
     

To have ly2dvi read from stdin, use a dash - for file.

Ly2dvi supports the following options:

-k,--keep
Keep the temporary directory including LilyPond and ly2dvi output files. The temporary directory is created in the current directory as ly2dvi.dir.
-d,--dependencies
Write makefile dependencies for every input file.
-h,--help
Print usage help.
-I,--include=dir
Add dir to LilyPond's include path.
-m,--no-paper
Produce MIDI output only.
--no-lily
Do not run LilyPond; useful for debugging ly2dvi.
-o,--output=file
Generate output to file. The extension of file is ignored.
-P,--postscript
Also generate PostScript output, using dvips. The postscript uses the standard TeX bitmap fonts for your printer.
-p,--pdf
Also generate Portable Document Format (PDF). This option will generate a PS file using scalable fonts, and will run the PS file through ps2pdf producing a PDF file.

If you use lilypond-book or your own wrapper files, don't use \usepackage[[T1]{fontenc} in the file header but don't forget \usepackage[latin1]{inputenc} if you use any other non-anglosaxian characters.

--preview
Also generate a picture of the first system of the score.
-s,--set=key=val
Add key= val to the settings, overriding those specified in the files. Possible keys: language, latexheaders, latexpackages, latexoptions, papersize, pagenumber, linewidth, orientation, textheight.
-v,--version
Show version information .
-V,--verbose
Be verbose.
--debug
Print even more information. This is useful when generating bugreports.
-w,--warranty
Show the warranty with which GNU LilyPond comes. (It comes with NO WARRANTY!)

Titling layout

Ly2dvi extracts the following header fields from the LY files to generate titling. An example demonstrating all these fields is in input/test/ly2dvi-testpage.ly.

title
The title of the music. Centered on top of the first page.
subtitle
Subtitle, centered below the title.
poet
Name of the poet, left flushed below the subtitle.
composer
Name of the composer, right flushed below the subtitle.
meter
Meter string, left flushed below the poet.
opus
Name of the opus, right flushed below the composer.
arranger
Name of the arranger, right flushed below the opus.
instrument
Name of the instrument, centered below the arranger
dedication
[docme]
piece
Name of the piece, left flushed below the instrument
head
A text to print in the header of all pages. It is not called header, because \header is a reserved word in LilyPond.
copyright
A text to print in the footer of the first page. Default is to print the standard footer also on the first page.
footer
A text to print in the footer of all but the last page.
tagline
Line to print at the bottom of last page. The default text is "Lily was here, version-number".

Additional parameters

Ly2dvi responds to several parameters specified in a \paper section of the LilyPond file. They can be overridden by supplying a --set command line option.

language
Specify LaTeX language: the babel package will be included. Default: unset.

Read from the \header block.

latexheaders
Specify additional LaTeX headers file.

Normally read from the \header block. Default value: empty

latexpackages
Specify additional LaTeX packages file. This works cumulative, so you can add multiple packages using multiple -s=latexpackages options. Normally read from the \header block. Default value: geometry.
latexoptions
Specify additional options for the LaTeX \documentclass. You can put any valid value here. This was designed to allow ly2dvi to produce output for double-sided paper, with balanced margins and pagenumbers on alternating sides. To achieve this specify twoside
orientation
Set orientation. Choices are portrait or landscape. Is read from the \paper block, if set.
textheight
The vertical extension of the music on the page. It is normally calculated automatically, based on the paper size.
linewidth
The music line width. It is normally read from the \paper block.
papersize
The paper size (as a name, e.g. a4). It is normally read from the \paper block.
pagenumber
If set to no, no page numbers will be printed. If set to a positive integer, start with this value as the first page number.
fontenc
The font encoding, should be set identical to the font-encoding property in the score.

Environment variables

LANG
selects the language for the warning messages of Ly2dvi and LilyPond.
GUILE_MAX_SEGMENT_SIZE
is an option for GUILE, the scheme interpreter; it sets the size of the chunks of memory allocated by GUILE. By increasing this from its default 8388608, the performance of LilyPond on large scores is slightly improved.
Go back to index of LilyPond.

Please send GNU LilyPond questions and comments to lilypond-user@gnu.org.

Please send comments on these web pages to (address unknown)

Copyright (c) 1997--2002 Han-Wen Nienhuys and Jan Nieuwenhuizen.

Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.


This page was built from LilyPond-1.7.14 (development-branch) by

Buchan Milne <(address unknown)>, Thu Mar 6 21:11:35 2003 CET.