@node Invoking lilypond
@subsection Invoking @command{lilypond}
-@cindex Invoking @command{lilypond}
-@cindex command line options for @command{lilypond}
-@cindex options, command line
-@cindex switches
-
-
The @command{lilypond} executable may be called as follows from the command line.
@example
@node Command line options for lilypond
@subsection Command line options for @command{lilypond}
+@cindex Invoking @command{lilypond}
+@cindex command line options for @command{lilypond}
+@cindex options, command line
+@cindex switches
+
The following options are supported:
@table @code
Here are a few interesting options.
+@cindex help, command line
+
@table @samp
@item help
Running @code{lilypond -dhelp} will print all of the @code{-d} options
available.
+@cindex paper-size, command line
+
@item paper-size
This option sets the default paper-size,
@example
Note that the string must be enclosed in escaped quotes ( @code{\"} ).
@c Match " in previous line to help context-sensitive editors
+@cindex safe, command line
+
@item safe
Do not trust the @code{.ly} input.
lead to huge files.
@item eps
+
+@cindex Postscript, encapulated
+@cindex EPS (Encapsulated PostScript)
+
for encapsulated PostScript. This dumps every page (system) as a separate
@file{EPS} file, without fonts, and as one collated @file{EPS} file with
all pages (systems) including fonts.
This mode is used by default by @command{lilypond-book}.
@item svg
+
@cindex SVG (Scalable Vector Graphics)
+
for SVG (Scalable Vector Graphics).
This creates a single SVG file containing the entire music output
SVG editor or user agent.
@item scm
+
@cindex Scheme dump
+
for a dump of the raw, internal Scheme-based drawing commands.
@item null
Example: @code{lilypond -dbackend=svg @var{filename}.ly}
@item preview
+@cindex preview, command line
Generate an output file containing the titles and the first system
@item print-pages
Set the default output file to @var{FILE}. The appropriate
suffix will be added (e.g. @code{.pdf} for pdf)
+@cindex PostScript output
+
@item --ps
Generate PostScript.
+@cindex Portable Network Graphics (PNG) output
+
@item --png
Generate pictures of each page, in PNG format. This implies
@code{--ps}. The resolution in DPI of the image may be set with
-dresolution=110
@end example
+@cindex Portable Document Format (PDF) output
+
@item --pdf
Generate PDF. This implies @code{--ps}.
@menu
* Extracting fragments of music::
* Skipping corrected music::
+* Alternative output formats::
@end menu
@node Extracting fragments of music
In polyphonic music, @code{Score.skipTypesetting} will affect all
voices and staves, saving even more time.
+@node Alternative output formats
+@subsection Alternative output formats
+
+@cindex scalable vector graphics output
+@cindex SVG output
+@cindex encapsulated postscript output
+@cindex EPS output
+
+The default output formats for the printed score are Portable
+Document Format (PDF) and PostScript (PS). Scalable Vector
+Graphics (SVG), Encapsulated PostScript (EPS) and Portable
+Network Graphics (PNG) output formats are also available through
+command line options, see @rprogram{Command line options for
+lilypond}.
@node MIDI output