X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fconverters.itely;h=bc92313afaf8fd6ce06f9b6e297ce4e6b907f350;hb=a3a66c625c68d7da92a1844848816bdd7774744a;hp=c9da511b23bdb4a2b9ca9746c66d2871b65a6c54;hpb=5878d2a88269dd0a4a3582cfd3f75f309bafa752;p=lilypond.git diff --git a/Documentation/user/converters.itely b/Documentation/user/converters.itely index c9da511b23..bc92313afa 100644 --- a/Documentation/user/converters.itely +++ b/Documentation/user/converters.itely @@ -1,4 +1,11 @@ @c -*- coding: utf-8; mode: texinfo; -*- +@c This file is part of lilypond.tely +@ignore + Translation of GIT committish: FILL-IN-HEAD-COMMITTISH + + When revising a translation, copy the HEAD committish of the + version that you are working on. See TRANSLATION for details. +@end ignore @node Converting from other formats @chapter Converting from other formats @@ -9,13 +16,26 @@ There are other tools that produce LilyPond input, for example GUI sequencers and XML converters. Refer to the @uref{http://@/lilypond@/.org,website} for more details. +These are separate programs from lilypond itself, and are run +on the command-line. By @q{command-line}, we mean the command +line in the operating system. Windows users +might be more familiar with the terms @q{DOS shell} or +@q{command shell}; OSX users might be more familiar with the +terms @q{terminal} or @q{console}. OSX users should also +consult @ref{Notes for the MacOS X app}. + +Describing how to use +this part of an operating system is outside the scope of this +manual; please consult other documentation on this topic if +you are unfamiliar with the command-line. + @menu * Invoking midi2ly:: Importing MIDI. * Invoking etf2ly:: Importing Finale. -* Invoking abc2ly:: Importing ABC. -* Invoking mup2ly:: Importing MUP. +* Invoking musicxml2ly:: +* Invoking abc2ly:: Importing ABC. * Generating LilyPond files:: @end menu @@ -54,6 +74,9 @@ It is invoked from the command-line as follows, midi2ly [@var{option}]@dots{} @var{midi-file} @end example +Note that by @q{command-line}, we mean the command line of the +operating system. See @ref{Converting from other formats} for +more information about this. The following options are supported by @command{midi2ly}. @@ -73,7 +96,7 @@ Show summary of usage. @item -k, --key=@var{acc}[:@var{minor}] Set default key. @math{@var{acc} > 0} sets number of sharps; @math{@var{acc} < 0} sets number of flats. A minor key is indicated by -":1". +@samp{:1}. @item -o, --output=@var{file} Write output to @var{file}. @@ -123,6 +146,10 @@ It is invoked from the command-line as follows. etf2ly [@var{option}]@dots{} @var{etf-file} @end example +Note that by @q{command-line}, we mean the command line of the +operating system. See @ref{Converting from other formats} for +more information about this. + The following options are supported by @command{etf2ly}: @table @code @@ -140,6 +167,29 @@ version information The list of articulation scripts is incomplete. Empty measures confuse @command{etf2ly}. Sequences of grace notes are ended improperly. +@node Invoking musicxml2ly +@section Invoking @code{musicxml2ly} + +@uref{http://@/www.@/recordarde@/.com/xml@/.html,MusicXML} is an XML dialect +for representing music notation. + +@command{musicxml2ly} extracts the notes from part-wise MusicXML +files, and writes it to a .ly file. It is invoked from the command-line. + +Note that by @q{command-line}, we mean the command line of the +operating system. See @ref{Converting from other formats} for +more information about this. + +The following options are supported by @command{musicxml2ly}: + +@table @code +@item -h,--help +print usage and option summary. +@item -o,--output=@var{file} +set output filename to @var{file}. (default: print to stdout) +@item -v,--version +print version information. +@end table @node Invoking abc2ly @section Invoking @code{abc2ly} @@ -149,7 +199,7 @@ confuse @command{etf2ly}. Sequences of grace notes are ended improperly. ABC is a fairly simple ASCII based format. It is described at the ABC site: @quotation -@uref{http://@/www@/.gre@/.ac@/.uk/@/~c.walshaw/@/abc2mtex/@/abc@/.txt}. +@uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/abc2mtex/@/abc@/.txt}. @end quotation @command{abc2ly} translates from ABC to LilyPond. It is invoked as follows: @@ -176,7 +226,7 @@ source file. If you say: %%LY voices \set autoBeaming = ##f @end example -This will cause the text following the keyword ``voices'' to be inserted +This will cause the text following the keyword @q{voices} to be inserted into the current voice of the LilyPond output file. Similarly, @@ -185,14 +235,14 @@ Similarly, %%LY slyrics more words @end example -will cause the text following the ``slyrics'' keyword to be inserted +will cause the text following the @q{slyrics} keyword to be inserted into the current line of lyrics. @refbugs -The ABC standard is not very ``standard''. For extended features -(e.g., polyphonic music) different conventions exist. +The ABC standard is not very @q{standard}. For extended features +(e.g., polyphonic music) different conventions exist. Multiple tunes in one file cannot be converted. @@ -202,46 +252,6 @@ ABC synchronizes words and notes at the beginning of a line; @command{abc2ly} ignores the ABC beaming. -@node Invoking mup2ly -@section Invoking @command{mup2ly} - -Mup (Music Publisher) is a shareware music notation program by Arkkra -Enterprises. @command{mup2ly} will convert part of a Mup file to LilyPond -format. It is invoked from the command-line as follows: - -@cindex Music Publisher -@cindex Mup -@cindex Arkkra - -@example -mup2ly [@var{option}]@dots{} @var{mup-file} -@end example - -The following options are supported by @command{mup2ly}: - -@table @code -@item -d,--debug -show what constructs are not converted, but skipped. -@item -D, --define=@var{name}[=@code{exp}] -define macro @var{name} with opt expansion @code{exp} -@item -E,--pre-process -only run the pre-processor -@item -h,--help -print help -@item -o,--output=@var{file} -write output to @var{file} -@item -v,--version -version information -@item -w,--warranty -print warranty and copyright. -@end table - - -@refbugs - -Only plain notes (pitches, durations), voices, and staves are -converted. - @node Generating LilyPond files @section Generating LilyPond files @@ -257,18 +267,22 @@ These tools include @item @uref{http://@/denemo@/.sourceforge@/.net/,Denemo}, a graphical score editor. @item -@uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, a realtime monophonic MIDI to LilyPond converter. +@uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, a realtime +monophonic MIDI to LilyPond converter. @item -@uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, an Emacs major mode. +@uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, an +Emacs major mode. @item @uref{http://@/www@/.nongnu@/.org/@/xml2ly/, xml2ly}, which imports @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML} @item @uref{http://@/noteedit@/.berlios@/.de,NoteEdit} -(no longer being developed) which imports @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML} @item @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden}, which imports MIDI +@item +@uref{http://@/common-lisp@/.net/project/fomus/,FOMUS}, +a LISP library to generate music notation @end itemize