1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: c1be53409464d49dffa013f3dfeb9eb4910edd92
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
10 @c Translators: Reinhold Kainhofer
12 @node Converting from other formats
13 @chapter Converting from other formats
15 LilyPond kann auch Musik aus diversen anderen Formaten importieren.
16 Dieses Kapitel beschreibt die dazu mit LilyPond mitgelieferten
17 Hilfsprogramme. Daneben existieren natürlich auch noch weitere
18 Programme, die Dateien für LilyPond erstellen können, wie etwa
19 graphische Sequenzierprogramme und XML-Konverter. Näheres dazu
20 findet sich auf der @uref{http://@/lilypond@/.org,Homepage} von LilyPond.
22 Die im Folgenden beschriebenen Programme sind eigenständige Hilfsprogramme
23 und werden üblicherweise von der Kommandozeile aufgerufen. Siehe
24 @ref{Command-line usage} für weitere Informationen.
28 Leider haben wir nicht ausreichend viele Entwickler, um all die folgenden
29 Hilfsprogramme ständig zu warten. Wir stellen den aktuellen Stand zur
30 Verfügung, können aber leider Fehlerberichte nur selten bearbeiten.
31 Selbstverständlich sind Patches von Ihnen sehr willkommen!
35 * Invoking midi2ly:: Import von MIDI
36 * Invoking musicxml2ly:: Import von MusicXML
37 * Invoking abc2ly:: Import von ABC
38 * Invoking etf2ly:: Import von (alten) Finale-Dateien
39 * Generating LilyPond files:: Grafische Benutzeroberflächen,
40 Musikübersetzer und Programme zur algorithmischen Komposition
43 @node Invoking midi2ly
44 @section Invoking @command{midi2ly}
48 @command{midi2ly} übersetzt eine Typ@tie{}1 MIDI-Datei in eine
49 Eingabedatei für LilyPond.
51 MIDI (Music Instrument Digital Interface) ist ein internationaler
52 Standard für digitale Instrumente: Es spezifiziert die Verkabelung,
53 ein serielles Protokoll und ein Dateiformat. Das MIDI-Dateiformat
54 ist der de-facto Standard um Musik von vielen Programmen zu exportieren.
55 Allerdings fehlen in den MIDI-Dateien viele Ausdrucks- und
56 Artikulationszeichen. Dennoch kann MIDI vielfach nützlich sein,
57 um Musik von einem Programm zu importieren, für das kein spezielles
58 Hilfsprogramm den direkten Import nach LilyPond unterstützt.
60 @command{midi2ly} konvertiert die MIDI-Spuren nach @rinternals{Staff} und
61 MIDI-Kanäle in @rinternals{Voice} Kontexte. Tonhöhen werden relativ
62 angegeben, Tondauern nur wenn nötig.
64 MIDI-Dateien können auch direkt von einem digitalen Keyboard
65 aufgenommen und dann in eine @file{.ly}-Datei konvertiert werden.
66 Allerdings sind Musikinterpretationen von Menschen (aus gutem Grund!)
67 rhythmisch nicht exakt genug um die Konvertierung von MIDI nach LY
68 trivial zu gestalten. Wenn @command{midi2ly} mit Quantisierung
69 (@code{-s} und @code{-d} Kommandozeilenoptionen) aufgerufen wird,
70 versucht es diese Unschärfen im Zeitablauf zu korrigieren, ist
71 allerdings nicht sonderlich gut darin. Daher können wir diese Technik
72 leider nicht für die Konvertierung von MIDI-Aufnahmen empfehlen.
75 @command{midi2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
77 midi2ly [@var{Optionen}]@dots{} @var{MIDI-Datei}
80 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
81 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
82 @ref{Converting from other formats}.
84 Die folgenden Kommandozeilenoptionen werden von @command{midi2ly}
88 @item -a, --absolute-pitches
89 Gibt absolute Tonhöhen aus.
91 @item -d, --duration-quant=@var{LÄNGE}
92 Quantisiert Tondauern zu Vielfachen von @var{LÄNGE}.
94 @item -e, --explicit-durations
95 Gibt alle Tondauern explizit an.
98 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
100 @item -k, --key=@var{acc}[:@var{Moll}]
101 Setzt die Standard-Tonart. @math{@var{acc} > 0} gibt die Anzahl der
102 Kreuze an, @math{@var{acc} < 0} gibt die Anzahl der Bs der Tonart an.
103 Eine Moll-Tonart wird durch @code{:1} angegeben.
105 @item -o, --output=@var{Datei}
106 Die Ausgabe wird in die Datei @var{Datei}@file{.ly} geschrieben.
108 @item -s, --start-quant=@var{LÄNGE}
109 Quantisiert den Beginn der Noten zu Vielfachen von @var{LÄNGE}.
111 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
112 Erlaubt Tuplet-Dauern der Form @var{DUR}*@var{NUM}/@var{DEN}.
115 Gibt ausführliche informative Meldungen während der Konvertierung aus.
118 Gibt die Versionsnummer aus.
121 Zeigt die Lizenzbedingungen und Urheberrechtshinweise.
123 @item -x, --text-lyrics
124 Interpretiert alle Texte als Liedtexte.
130 Überlappende Noten in einem Arpeggio werden nicht korrekt dargestellt.
131 Nur die erste Note wird eingelesen und konvertiert, die restlichen
132 werden ignoriert. Als Abhilfe können Sie alle Noten auf dieselbe
133 Tonlänge setzen und Phrasierungszeichen oder Pedalindikatoren
137 @node Invoking musicxml2ly
138 @section Invoking @code{musicxml2ly}
142 @uref{http://@/www.@/musicxml@/.org/,MusicXML} ist ein XML-Dialekt
143 zur Darstellung von Musiknotation.
145 @command{musicxml2ly} wandelt eine MusicXML-Datei nach LilyPond um,
146 wobei sowohl die Noten, Artikulationszeichen, Struktur der Partitur,
147 Liedtexte etc. einer MusicXML-Datei (im @q{part-wise}-Format) in eine
150 @command{musicxml2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
152 musicxml2ly [@var{Optionen}]@dots{} @var{XML-Datei}
155 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
156 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
157 @ref{Converting from other formats}.
159 Wenn als Dateiname @file{-} angegeben wird, liest @command{musicxml2ly}
160 Daten direkt von der Kommandozeile ein.
162 Die folgenden Kommandozeilenoptionen werden von @command{musicxml2ly}
167 Konvertiert in absolute Tonhöhen.
170 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
172 @item -l, --language=LANG
173 Inkludiert die Sprachdatei @var{LANG}@file{.ly} in der Ausgabe. Wird z.B.
174 'deutsch' angegeben, wird @file{deutsch.ly} in die .ly-Datei eingebunden
175 und deutsche Notenbezeichnungen benutzt.
178 Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung)
180 @item --nd --no-articulation-directions
181 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
182 von Artikulations- und Lautstärkebezeichnungen.
185 Konvertiert keine Informationen über die Balkensetzung aus der
186 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
188 @item -o,--output=@var{Dateiname}
189 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. Wird
190 als @var{Dateiname} nur @file{-} angegeben, wird das Ergebnis der Konvertierung
191 an der Kommandozeile ausgegeben. Wird diese Option nicht angegeben, so
192 erfolgt die Ausgabe in die Datei @var{XML-Datei}@file{.ly}.
195 Konvertiert in relative Tonhöhen. (Standardeinstellung)
198 Gibt ausführliche informative Meldungen während der Konvertierung aus.
201 Gibt die Versionsnummer aus.
203 @item -z,--compressed
204 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
205 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
210 @node Invoking abc2ly
211 @section Invoking @code{abc2ly}
215 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
216 dokumentiert auf der ABC-Homepage:
219 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
222 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
223 von der Kommandozeile folgendermaßen aufgerufen:
226 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
229 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
230 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
231 @ref{Converting from other formats}.
233 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
237 @item -b,--beams=None
238 Die Balkensetzung aus der ABC-Datei erhalten.
240 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
241 @item -o,--output=@var{Dateiname}
242 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
244 Strenge Auslegung einer erfolgreichen Konvertierung.
246 Gibt die Versionsnummer aus.
249 Es existiert außerdem die Möglichkeit, LilyPond-Befehle für die
250 Konvertierung mit @command{abc2ly} gleich in der ABC-Datei anzugeben.
251 Wenn sich etwa in der ABC-Datei das Kommentar
254 %%LY voices \set autoBeaming = ##f
258 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
259 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
264 %%LY slyrics more words
268 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
269 im Liedtext eingefügt wird.
274 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
275 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
278 Mehrere Lieder in einer Datei können nicht konvertiert werden.
280 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
281 @command{abc2ly} macht dies nicht.
283 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
286 @node Invoking etf2ly
287 @section Invoking @command{etf2ly}
292 @cindex Coda Technology
294 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
295 Music Technology in älteren Versionen des Programms Finale benutzt hat.
297 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
298 und wird von der Kommandozeile folgendermaßen aufgerufen:
301 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
304 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
305 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
306 @ref{Converting from other formats}.
308 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
313 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
314 @item -o,--output=@var{Dateiname}
315 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
317 Gibt die Versionsnummer aus.
323 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
324 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
328 @node Generating LilyPond files
329 @section Generating LilyPond files
331 @cindex Externe Programme, LilyPond-Dateien erzeugen
333 LilyPond selbst wird nur mit den oben genannten Konvertierprogrammen
334 ausgeliefert und unterstützt keine weiteren Formate. Es existieren
335 allerdings externe Hilfsprogramme, die auch LilyPond-Dateien erzeugen
337 Diese umfassen unter anderem:
341 @uref{http://@/denemo@/.sourceforge@/.net/,Denemo}, ein grafisches
342 Programm zum Musiksatz.
344 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, ein
345 MIDI-nach-LilyPond Konverter, der monophone MIDI-Eigaben in Echtzeit
348 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, ein
351 @uref{http://@/www@/.nongnu@/.org/@/xml2ly/,xml2ly}, ein Konverter für
352 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}, der auf
353 XML-Transformationen mittels XSLT basiert.
355 @uref{http://@/noteedit@/.berlios@/.de,NoteEdit}, ein grafisches
356 Programm zum Notensatz, das auch
357 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML} importieren kann.
359 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
360 das MIDI importieren kann.
362 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
363 eine LISP-Bibliothek, um Musiknotation zu erzeugen.
365 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml},
366 ein Notensatzprogramm mit experimentellem Export nach LilyPond.
368 @uref{http://www.tuxguitar.com.ar/,TuxGuitar}, ein Programm zur Erzeugung von
369 Gitarren-Tabulaturen, unterstützt den Export nach LilyPond.
371 @uref{http://musescore.org/,MuseScore} unterstützt ebenfalls den
372 Export nach LilyPond.