1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
4 Translation of GIT committish: 499a511d4166feaada31114e097f86b5e0c56421
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @c Translators: Reinhold Kainhofer
13 @c Translation checkers: Till Rettig
15 @node Converting from other formats
16 @chapter Converting from other formats
18 LilyPond kann auch Musik aus diversen anderen Formaten importieren.
19 Dieses Kapitel beschreibt die dazu mit LilyPond mitgelieferten
20 Hilfsprogramme. Daneben existieren natürlich auch noch weitere
21 Programme, die Dateien für LilyPond erstellen können, wie etwa
22 graphische Sequenzierprogramme und XML-Konverter. Näheres dazu
23 findet sich auf der @uref{http://@/lilypond@/.org,Homepage} von LilyPond.
25 Die im Folgenden beschriebenen Programme sind eigenständige Hilfsprogramme
26 und werden üblicherweise von der Kommandozeile aufgerufen. Siehe
27 @ref{Command-line usage} für weitere Informationen. Wenn Sie MacOS
28 10.3 oder 10.4 benutzen und Probleme mit diesen Skripten (z. B.
29 @code{convert-ly}) haben, lesen Sie @ref{Setup for MacOS X}.
32 Leider haben wir nicht ausreichend viele Entwickler, um all die folgenden
33 Hilfsprogramme ständig zu warten. Wir stellen den aktuellen Stand zur
34 Verfügung, können aber leider Fehlerberichte nur selten bearbeiten.
35 Selbstverständlich sind Patches von Ihnen sehr willkommen!
39 * Invoking midi2ly:: Import von MIDI.
40 * Invoking musicxml2ly:: Import von MusicXML.
41 * Invoking abc2ly:: Import von ABC.
42 * Invoking etf2ly:: Import von (alten) Finale-Dateien.
43 * Generating LilyPond files:: Grafische Benutzeroberflächen,
44 Musikübersetzer und Programme zur algorithmischen Komposition.
47 @node Invoking midi2ly
48 @section Invoking @command{midi2ly}
52 @command{midi2ly} übersetzt eine Typ@tie{}1 MIDI-Datei in eine
53 Eingabedatei für LilyPond.
55 MIDI (Music Instrument Digital Interface) ist ein internationaler
56 Standard für digitale Instrumente: Es spezifiziert die Verkabelung,
57 ein serielles Protokoll und ein Dateiformat. Das MIDI-Dateiformat
58 ist der de-facto Standard um Musik von vielen Programmen zu exportieren.
59 Allerdings fehlen in den MIDI-Dateien viele Ausdrucks- und
60 Artikulationszeichen. Dennoch kann MIDI vielfach nützlich sein,
61 um Musik von einem Programm zu importieren, für das kein spezielles
62 Hilfsprogramm den direkten Import nach LilyPond unterstützt.
64 @command{midi2ly} konvertiert die MIDI-Spuren nach @rinternals{Staff} und
65 MIDI-Kanäle in @rinternals{Voice} Kontexte. Tonhöhen werden relativ
66 angegeben, Tondauern nur wenn nötig.
68 MIDI-Dateien können auch direkt von einem digitalen Keyboard
69 aufgenommen und dann in eine @file{.ly}-Datei konvertiert werden.
70 Allerdings sind Musikinterpretationen von Menschen (aus gutem Grund!)
71 rhythmisch nicht exakt genug um die Konvertierung von MIDI nach LY
72 trivial zu gestalten. Wenn @command{midi2ly} mit Quantisierung
73 (@code{-s} und @code{-d} Kommandozeilenoptionen) aufgerufen wird,
74 versucht es diese Unschärfen im Zeitablauf zu korrigieren, ist
75 allerdings nicht sonderlich gut darin. Daher können wir diese Technik
76 leider nicht für die Konvertierung von MIDI-Aufnahmen empfehlen.
79 @command{midi2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
81 midi2ly [@var{Optionen}]@dots{} @var{MIDI-Datei}
84 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
85 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
86 @ref{Converting from other formats}.
88 Die folgenden Kommandozeilenoptionen werden von @command{midi2ly}
92 @item -a, --absolute-pitches
93 Gibt absolute Tonhöhen aus.
95 @item -d, --duration-quant=@var{LÄNGE}
96 Quantisiert Tondauern zu Vielfachen von @var{LÄNGE}.
98 @item -e, --explicit-durations
99 Gibt alle Tondauern explizit an.
102 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
104 @item -k, --key=@var{acc}[:@var{Moll}]
105 Setzt die Standard-Tonart. @math{@var{acc} > 0} gibt die Anzahl der
106 Kreuze an, @math{@var{acc} < 0} gibt die Anzahl der Bs der Tonart an.
107 Eine Moll-Tonart wird durch @code{:1} angegeben.
109 @item -o, --output=@var{Datei}
110 Die Ausgabe wird in die Datei @var{Datei}@file{.ly} geschrieben.
112 @item -s, --start-quant=@var{LÄNGE}
113 Quantisiert den Beginn der Noten zu Vielfachen von @var{LÄNGE}.
115 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
116 Erlaubt Tuplet-Dauern der Form @var{DUR}*@var{NUM}/@var{DEN}.
119 Gibt ausführliche informative Meldungen während der Konvertierung aus.
122 Gibt die Versionsnummer aus.
125 Zeigt die Lizenzbedingungen und Urheberrechtshinweise.
127 @item -x, --text-lyrics
128 Interpretiert alle Texte als Liedtexte.
134 Überlappende Noten in einem Arpeggio werden nicht korrekt dargestellt.
135 Nur die erste Note wird eingelesen und konvertiert, die restlichen
136 werden ignoriert. Als Abhilfe können Sie alle Noten auf dieselbe
137 Tonlänge setzen und Phrasierungszeichen oder Pedalindikatoren
141 @node Invoking musicxml2ly
142 @section Invoking @code{musicxml2ly}
146 @uref{http://@/www.@/musicxml@/.org/,MusicXML} ist ein XML-Dialekt
147 zur Darstellung von Musiknotation.
149 @command{musicxml2ly} wandelt eine MusicXML-Datei nach LilyPond um,
150 wobei sowohl die Noten, Artikulationszeichen, Struktur der Partitur,
151 Liedtexte etc. einer MusicXML-Datei (im @q{part-wise}-Format) in eine
154 @command{musicxml2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
156 musicxml2ly [@var{Optionen}]@dots{} @var{XML-Datei}
159 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
160 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
161 @ref{Converting from other formats}.
163 Wenn als Dateiname @file{-} angegeben wird, liest @command{musicxml2ly}
164 Daten direkt von der Kommandozeile ein.
166 Die folgenden Kommandozeilenoptionen werden von @command{musicxml2ly}
171 Konvertiert in absolute Tonhöhen.
174 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
176 @item -l, --language=LANG
177 Inkludiert die Sprachdatei @var{LANG}@file{.ly} in der Ausgabe. Wird z.B.
178 'deutsch' angegeben, wird @file{deutsch.ly} in die .ly-Datei eingebunden
179 und deutsche Notenbezeichnungen benutzt.
182 Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung)
184 @item --nd --no-articulation-directions
185 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
186 von Artikulations- und Lautstärkebezeichnungen.
189 Konvertiert keine Informationen über die Balkensetzung aus der
190 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
192 @item -o,--output=@var{Dateiname}
193 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. Wird
194 als @var{Dateiname} nur @file{-} angegeben, wird das Ergebnis der Konvertierung
195 an der Kommandozeile ausgegeben. Wird diese Option nicht angegeben, so
196 erfolgt die Ausgabe in die Datei @var{XML-Datei}@file{.ly}.
199 Konvertiert in relative Tonhöhen. (Standardeinstellung)
202 Gibt ausführliche informative Meldungen während der Konvertierung aus.
205 Gibt die Versionsnummer aus.
207 @item -z,--compressed
208 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
209 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
214 @node Invoking abc2ly
215 @section Invoking @code{abc2ly}
219 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
220 dokumentiert auf der ABC-Homepage:
223 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
226 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
227 von der Kommandozeile folgendermaßen aufgerufen:
230 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
233 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
234 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
235 @ref{Converting from other formats}.
237 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
241 @item -b,--beams=None
242 Die Balkensetzung aus der ABC-Datei erhalten.
244 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
245 @item -o,--output=@var{Dateiname}
246 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
248 Strenge Auslegung einer erfolgreichen Konvertierung.
250 Gibt die Versionsnummer aus.
253 Es existiert außerdem die Möglichkeit, LilyPond-Befehle für die
254 Konvertierung mit @command{abc2ly} gleich in der ABC-Datei anzugeben.
255 Wenn sich etwa in der ABC-Datei das Kommentar
258 %%LY voices \set autoBeaming = ##f
262 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
263 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
268 %%LY slyrics more words
272 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
273 im Liedtext eingefügt wird.
278 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
279 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
282 Mehrere Lieder in einer Datei können nicht konvertiert werden.
284 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
285 @command{abc2ly} macht dies nicht.
287 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
290 @node Invoking etf2ly
291 @section Invoking @command{etf2ly}
296 @cindex Coda Technology
298 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
299 Music Technology in älteren Versionen des Programms Finale benutzt hat.
301 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
302 und wird von der Kommandozeile folgendermaßen aufgerufen:
305 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
308 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
309 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
310 @ref{Converting from other formats}.
312 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
317 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
318 @item -o,--output=@var{Dateiname}
319 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
321 Gibt die Versionsnummer aus.
327 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
328 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
332 @node Generating LilyPond files
333 @section Generating LilyPond files
335 @cindex Externe Programme, LilyPond-Dateien erzeugen
337 LilyPond selbst wird nur mit den oben genannten Konvertierprogrammen
338 ausgeliefert und unterstützt keine weiteren Formate. Es existieren
339 allerdings externe Hilfsprogramme, die auch LilyPond-Dateien erzeugen
341 Diese umfassen unter anderem:
345 @uref{http://@/www@/.denemo@/.org/,Denemo}, ein grafisches
346 Programm zum Musiksatz.
348 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, ein
349 MIDI-nach-LilyPond Konverter, der monophone MIDI-Eigaben in Echtzeit
352 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, ein
355 @uref{http://@/www@/.nongnu@/.org/@/xml2ly/,xml2ly}, ein Konverter für
356 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}, der auf
357 XML-Transformationen mittels XSLT basiert.
359 @uref{http://@/noteedit@/.berlios@/.de,NoteEdit}, ein grafisches
360 Programm zum Notensatz, das auch
361 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML} importieren kann.
363 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
364 das MIDI importieren kann.
366 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
367 eine LISP-Bibliothek, um Musiknotation zu erzeugen.
369 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml},
370 ein Notensatzprogramm mit experimentellem Export nach LilyPond.
372 @uref{http://www.tuxguitar.com.ar/,TuxGuitar}, ein Programm zur Erzeugung von
373 Gitarren-Tabulaturen, unterstützt den Export nach LilyPond.
375 @uref{http://musescore.org/,MuseScore} unterstützt ebenfalls den
376 Export nach LilyPond.