FOMUS currently creates notation files for LilyPond versions 2.4 and 2.6.
The OUTPUT
setting keyword to use is :LILYPOND
.
FOMUS outputs a slightly different file depending on whether LilyPond version 2.4 or 2.6 is installed to insure
that it compiles correctly (a file for one version may give an error when compiled in the other version).
A .ly
extension is added to the base filename to make the complete output filename.
When FOMUS loads it looks for LilyPond
and viewer application executables in several locations in the filesystem.
If these executables are in an uncommon location or the user wants to specify these herself, several options exist for
setting the pathnames and changing command line arguments.
When setup correctly, FOMUS can automatically compile the output file and launch a viewer (a PostScript
viewing application in Gnome or KDE
or the Preview application in OS X).
Tremolos might be represented by displaying slash marks (like in the MusicXML
:XML-1NOTE-TREMOLO-KLUDGE
and :XML-MULTINOTE-TREMOLO-KLUDGE
options)
in rare cases where they can't be indicated properly.
:FILENAME | :VIEW-OPTS | :OUT-EXT |
:PROCESS | :VERSION | :TEXT-MARKUP |
:VIEW | :FILEHEAD | :TEXTDYN-MARKUP |
:EXE | :SCOREHEAD | :TEXTTEMPO-MARKUP |
:OPTS | :LILY-PARTHEAD | :TEXTNOTE-MARKUP |
:VIEW-EXE | :LILY-PARTNAME | :TEXTACC-MARKUP |
:EXE
This is a string specifying the path and filename to the LilyPond executable.
The full pathname may or may not need to be specified depending on the Lisp implementation.
This overrides the LILYPOND-EXE
setting if used.
:OPTS
This is a list of strings representing options to be passed to the LilyPond executable.
The default is currently '("--ps")
for Linux or '("--pdf")
for OS X/Windows,
specifying that LilyPond should generate either a PostScript or PDF format file.
This overrides the LILYPOND-OPTS
setting if used.
:FILEHEAD
This is a string or list of strings representing text to be inserted directly into the output file. Each string in the list is followed by a carriage return. The text is inserted near the top of the file at a point before any score or part data appears.
:FILENAME
This is a string representing the output filename.
It overrides the FILENAME
setting if used.
:OUT-EXT
This is a string specifying the extension for the output filename that is created when LilyPond is run.
The default is "ps"
for Linux and "pdf"
for OS X/Windows.
This overrides the LILYPOND-OUT-EXT
setting if used.
:LILY-PARTHEAD
This option is specified in PART
part objects
and is valid only for that part.
It is a string or list of strings representing text to be inserted directly into the output file.
Each string is followed by a carriage return.
The text inserted at the beginning of a staff section just before note, rest and other
information appears for that part in the file.
:LILY-PARTNAME
This option is specified in PART
part objects
and is valid only for that part.
It is a string representing a part name used to uniquely identify the part in the output file.
If it isn't supplied, FOMUS automatically generates a name.
:PROCESS
If set to T
, indicates that FOMUS should call LilyPond
to process the output file once it's been written.
If set to NIL
, only the output file is written and no processing occurs (unless
VIEW
is set to T
).
:SCOREHEAD
This is a string or list of strings representing text to be inserted directly into the output file at the beginning of a score block. Each string in the list is followed by a carriage return.
:TEXT-MARKUP
This is a "wrapper" string specifying LilyPond markup instructions to be used when
printing text above or below the staff.
The string must have an ~A
or similar substring to indicate where to place the actual text
(as if in a call to FORMAT
).
The default value is "\markup{\italic{~A}}"
.
:TEXTACC-MARKUP
This is a "wrapper" string specifying LilyPond markup instructions to be used when
engraving accidentals as text.
The string must have an ~A
or similar substring to indicate where to place the actual text
(as if in a call to FORMAT
).
The default value is "\\markup{\\tiny{~A}}"
.
:TEXTDYN-MARKUP
This is a "wrapper" string specifying LilyPond markup instructions to be used when
printing text in a dynamic-type font.
The string must have an ~A
or similar substring to indicate where to place the actual text
(as if in a call to FORMAT
).
The default value is "\markup{\dynamic{\italic{\bold{~A}}}}"
.
:TEXTNOTE-MARKUP
This is a "wrapper" string specifying LilyPond markup instructions to be used when
printing text above single notes.
The string must have an ~A
or similar substring to indicate where to place the actual text
(as if in a call to FORMAT
).
The default value is "\markup{\italic{~A}}"
.
:TEXTTEMPO-MARKUP
This is a "wrapper" string specifying LilyPond markup instructions to be used when
printing text in a heavy "tempo" font.
The string must have an ~A
or similar substring to indicate where to place the actual text
(as if in a call to FORMAT
).
The default value is "\markup{\bold{\huge{~A}}}"
.
:VERSION
If set to a string (for example, "2.8"
), forces FOMUS to output LilyPond files for that
version.
:VIEW
If set to T
, indicates that FOMUS should call LilyPond
to process the output file then open the results with a viewer program for immediate viewing.
If set to NIL
, no viewer application is opened.
:VIEW-EXE
This is a string specifying the path and filename to the executable for the viewer application.
The full pathname may or may not need to be specified depending on the Lisp implementation.
The default application depends on what is installed on the user's machine, and should be
one appropriate for viewing PostScript files.
This overrides the LILYPOND-VIEW-EXE
setting if used.
:VIEW-OPTS
This is a list of strings representing options to be passed to the viewer application executable.
This overrides the LILYPOND-VIEW-OPTS
setting if used.