Documentation/de/application/converters.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
   2
   3 @ignore
   4     Translation of GIT committish: 7b70644b95f383b4281e9ffa146d315d2ada11d3
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @c \version "2.12.0"
  11
  12 @c Translators: Reinhold Kainhofer
  13 @c Translation checkers: Till Paala
  14
  15 @node Von anderen Formaten konvertieren
  16 @chapter Von anderen Formaten konvertieren
  17 @translationof Converting from other formats
  18
  19 LilyPond kann auch Musik aus diversen anderen Formaten importieren.
  20 Dieses Kapitel beschreibt die dazu mit LilyPond mitgelieferten
  21 Hilfsprogramme. Daneben existieren natürlich auch noch weitere
  22 Programme, die Dateien für LilyPond erstellen können, wie etwa
  23 graphische Sequenzierprogramme und XML-Konverter. Näheres dazu
  24 findet sich auf der @uref{http://@/lilypond@/.org,Homepage} von LilyPond.
  25
  26 Die im Folgenden beschriebenen Programme sind eigenständige Hilfsprogramme
  27 und werden üblicherweise von der Kommandozeile aufgerufen. Siehe
  28 @ref{Benutzung auf der Kommandozeile} für weitere Informationen.  Wenn Sie MacOS
  29 10.3 oder 10.4 benutzen und Probleme mit diesen Skripten (z. B.
  30 @code{convert-ly}) haben, lesen Sie
  31 Einrichtung für MacOS X.
  32 @c @ref{Einrichtung für MacOS X}.
  33
  34 @knownissues
  35 Leider haben wir nicht ausreichend viele Entwickler, um all die folgenden
  36 Hilfsprogramme ständig zu warten. Wir stellen den aktuellen Stand zur
  37 Verfügung, können aber leider Fehlerberichte nur selten bearbeiten.
  38 Selbstverständlich sind Patches von Ihnen sehr willkommen!
  39
  40
  41 @menu
  42 * midi2ly aufrufen::          Import von MIDI.
  43 * muscxml2ly aufrufen::      Import von MusicXML.
  44 * abc2ly aufrufen::           Import von ABC.
  45 * etf2ly aufrufen::           Import von (alten) Finale-Dateien.
  46 * LilyPond-Dateien erstellen:: Grafische Benutzeroberflächen,
  47 Musikübersetzer und Programme zur algorithmischen Komposition.
  48 @end menu
  49
  50 @node midi2ly aufrufen
  51 @section @command{midi2ly} aufrufen
  52 @translationof Invoking midi2ly
  53
  54 @cindex MIDI
  55
  56 @command{midi2ly} übersetzt eine Typ@tie{}1 MIDI-Datei in eine
  57 Eingabedatei für LilyPond.
  58
  59 MIDI (Music Instrument Digital Interface) ist ein internationaler
  60 Standard für digitale Instrumente: Es spezifiziert die Verkabelung,
  61 ein serielles Protokoll und ein Dateiformat. Das MIDI-Dateiformat
  62 ist der de-facto Standard um Musik von vielen Programmen zu exportieren.
  63 Allerdings fehlen in den MIDI-Dateien viele Ausdrucks- und
  64 Artikulationszeichen. Dennoch kann MIDI vielfach nützlich sein,
  65 um Musik von einem Programm zu importieren, für das kein spezielles
  66 Hilfsprogramm den direkten Import nach LilyPond unterstützt.
  67
  68 @command{midi2ly} konvertiert die MIDI-Spuren nach @rinternals{Staff} und
  69 MIDI-Kanäle in @rinternals{Voice} Kontexte. Tonhöhen werden relativ
  70 angegeben, Tondauern nur wenn nötig.
  71
  72 MIDI-Dateien können auch direkt von einem digitalen Keyboard
  73 aufgenommen und dann in eine @file{.ly}-Datei konvertiert werden.
  74 Allerdings sind Musikinterpretationen von Menschen (aus gutem Grund!)
  75 rhythmisch nicht exakt genug um die Konvertierung von MIDI nach LY
  76 trivial zu gestalten. Wenn @command{midi2ly} mit Quantisierung
  77 (@code{-s} und @code{-d} Kommandozeilenoptionen) aufgerufen wird,
  78 versucht es diese Unschärfen im Zeitablauf zu korrigieren, ist
  79 allerdings nicht sonderlich gut darin. Daher können wir diese Technik
  80 leider nicht für die Konvertierung von MIDI-Aufnahmen empfehlen.
  81
  82
  83 @command{midi2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
  84 @example
  85 midi2ly [@var{Optionen}]@dots{} @var{MIDI-Datei}
  86 @end example
  87
  88 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
  89 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
  90 @ref{Von anderen Formaten konvertieren}.
  91
  92 Die folgenden Kommandozeilenoptionen werden von @command{midi2ly}
  93 unterstützt:
  94
  95 @table @code
  96 @item -a, --absolute-pitches
  97 Gibt absolute Tonhöhen aus.
  98
  99 @item -d, --duration-quant=@var{LÄNGE}
 100 Quantisiert Tondauern zu Vielfachen von @var{LÄNGE}.
 101
 102 @item -e, --explicit-durations
 103 Gibt alle Tondauern explizit an.
 104
 105 @item -h,--help
 106 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 107
 108 @item -k, --key=@var{acc}[:@var{Moll}]
 109 Setzt die Standard-Tonart. @math{@var{acc} > 0} gibt die Anzahl der
 110 Kreuze an, @math{@var{acc} < 0} gibt die Anzahl der Bs der Tonart an.
 111 Eine Moll-Tonart wird durch @code{:1} angegeben.
 112
 113 @item -o, --output=@var{Datei}
 114 Die Ausgabe wird in die Datei @var{Datei}@file{.ly} geschrieben.
 115
 116 @item -s, --start-quant=@var{LÄNGE}
 117 Quantisiert den Beginn der Noten zu Vielfachen von @var{LÄNGE}.
 118
 119 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
 120 Erlaubt Tuplet-Dauern der Form @var{DUR}*@var{NUM}/@var{DEN}.
 121
 122 @item -V, --verbose
 123 Gibt ausführliche informative Meldungen während der Konvertierung aus.
 124
 125 @item -v, --version
 126 Gibt die Versionsnummer aus.
 127
 128 @item -w, --warranty
 129 Zeigt die Lizenzbedingungen und Urheberrechtshinweise.
 130
 131 @item -x, --text-lyrics
 132 Interpretiert alle Texte als Liedtexte.
 133 @end table
 134
 135
 136 @knownissues
 137
 138 Überlappende Noten in einem Arpeggio werden nicht korrekt dargestellt.
 139 Nur die erste Note wird eingelesen und konvertiert, die restlichen
 140 werden ignoriert. Als Abhilfe können Sie alle Noten auf dieselbe
 141 Tonlänge setzen und Phrasierungszeichen oder Pedalindikatoren
 142 hinzufügen.
 143
 144
 145 @node muscxml2ly aufrufen
 146 @section @command{muscxml2ly} aufrufen
 147 @translationof Invoking musicxml2ly
 148
 149 @cindex MusicXML
 150
 151 @uref{http://@/www.@/musicxml@/.org/,MusicXML} ist ein XML-Dialekt
 152 zur Darstellung von Musiknotation.
 153
 154 @command{musicxml2ly} wandelt eine MusicXML-Datei nach LilyPond um,
 155 wobei sowohl die Noten, Artikulationszeichen, Struktur der Partitur,
 156 Liedtexte etc. einer MusicXML-Datei (im @q{part-wise}-Format) in eine
 157 .ly-Datei um.
 158
 159 @command{musicxml2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
 160 @example
 161 musicxml2ly [@var{Optionen}]@dots{} @var{XML-Datei}
 162 @end example
 163
 164 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 165 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 166 @ref{Von anderen Formaten konvertieren}.
 167
 168 Wenn als Dateiname @file{-} angegeben wird, liest @command{musicxml2ly}
 169 Daten direkt von der Kommandozeile ein.
 170
 171 Die folgenden Kommandozeilenoptionen werden von @command{musicxml2ly}
 172 unterstützt:
 173
 174 @table @code
 175 @item -a, --absolute
 176 Konvertiert in absolute Tonhöhen.
 177
 178 @item -h,--help
 179 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 180
 181 @item -l, --language=LANG
 182 Inkludiert die Sprachdatei @var{LANG}@file{.ly} in der Ausgabe. Wird z.B.
 183 'deutsch' angegeben, wird @file{deutsch.ly} in die .ly-Datei eingebunden
 184 und deutsche Notenbezeichnungen benutzt.
 185
 186 @item --lxml
 187 Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung)
 188
 189 @item --nd --no-articulation-directions
 190 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
 191 von Artikulations- und Lautstärkebezeichnungen.
 192
 193 @item --no-beaming
 194 Konvertiert keine Informationen über die Balkensetzung aus der
 195 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
 196
 197 @item -o,--output=@var{Dateiname}
 198 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben. Wird
 199 als @var{Dateiname} nur @file{-} angegeben, wird das Ergebnis der Konvertierung
 200 an der Kommandozeile ausgegeben. Wird diese Option nicht angegeben, so
 201 erfolgt die Ausgabe in die Datei @var{XML-Datei}@file{.ly}.
 202
 203 @item -r,--relative
 204 Konvertiert in relative Tonhöhen. (Standardeinstellung)
 205
 206 @item -v, --verbose
 207 Gibt ausführliche informative Meldungen während der Konvertierung aus.
 208
 209 @item --version
 210 Gibt die Versionsnummer aus.
 211
 212 @item  -z,--compressed
 213 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
 214 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
 215 @file{.mxl}.
 216 @end table
 217
 218
 219 @node abc2ly aufrufen
 220 @section @command{abc2ly} aufrufen
 221 @translationof Invoking abc2ly
 222
 223 @cindex ABC
 224
 225 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
 226 dokumentiert auf der ABC-Homepage:
 227
 228 @quotation
 229 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
 230 @end quotation
 231
 232 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
 233 von der Kommandozeile folgendermaßen aufgerufen:
 234
 235 @example
 236 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
 237 @end example
 238
 239 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 240 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 241 @ref{Von anderen Formaten konvertieren}.
 242
 243 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
 244 unterstützt:
 245
 246 @table @code
 247 @item -b,--beams=None
 248 Die Balkensetzung aus der ABC-Datei erhalten.
 249 @item -h,--help
 250 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 251 @item -o,--output=@var{Dateiname}
 252 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
 253 @item -s,--strict
 254 Strenge Auslegung einer erfolgreichen Konvertierung.
 255 @item -v,--version
 256 Gibt die Versionsnummer aus.
 257 @end table
 258
 259 Es existiert außerdem die Möglichkeit, LilyPond-Befehle für die
 260 Konvertierung mit @command{abc2ly} gleich in der ABC-Datei anzugeben.
 261 Wenn sich etwa in der ABC-Datei das Kommentar
 262
 263 @example
 264 %%LY voices \set autoBeaming = ##f
 265 @end example
 266
 267 @noindent
 268 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
 269 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
 270
 271 Ebenso bewirkt
 272
 273 @example
 274 %%LY slyrics more words
 275 @end example
 276
 277 @noindent
 278 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
 279 im Liedtext eingefügt wird.
 280
 281
 282 @knownissues
 283
 284 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
 285 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
 286 Konventionen.
 287
 288 Mehrere Lieder in einer Datei können nicht konvertiert werden.
 289
 290 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
 291 @command{abc2ly} macht dies nicht.
 292
 293 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
 294
 295
 296 @node etf2ly aufrufen
 297 @section @command{etf2ly} aufrufen
 298 @translationof Invoking etf2ly
 299
 300 @cindex ETF
 301 @cindex enigma
 302 @cindex Finale
 303 @cindex Coda Technology
 304
 305 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
 306 Music Technology in älteren Versionen des Programms Finale benutzt hat.
 307
 308 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
 309 und wird von der Kommandozeile folgendermaßen aufgerufen:
 310
 311 @example
 312 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
 313 @end example
 314
 315 Unter @q{Kommandozeile} verstehen wir dabei die Kommandozeile des
 316 jeweiligen Betriebssystems. Für nähere Informationen hierzu siehe
 317 @ref{Von anderen Formaten konvertieren}.
 318
 319 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
 320 unterstützt:
 321
 322 @table @code
 323 @item -h,--help
 324 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 325 @item -o,--output=@var{Dateiname}
 326 Die Ausgabe wird in die Datei @var{Dateiname}@file{.ly} geschrieben.
 327 @item --version
 328 Gibt die Versionsnummer aus.
 329 @end table
 330
 331
 332 @knownissues
 333
 334 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
 335 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
 336 beendet.
 337
 338
 339 @node LilyPond-Dateien erstellen
 340 @section LilyPond-Dateien erstellen
 341 @translationof Generating LilyPond files
 342
 343 @cindex Externe Programme, LilyPond-Dateien erzeugen
 344
 345 LilyPond selbst wird nur mit den oben genannten Konvertierprogrammen
 346 ausgeliefert und unterstützt keine weiteren Formate. Es existieren
 347 allerdings externe Hilfsprogramme, die auch LilyPond-Dateien erzeugen
 348 können.
 349 Diese umfassen unter anderem:
 350
 351 @itemize
 352 @item
 353 @uref{http://@/www@/.denemo@/.org/,Denemo}, ein grafisches
 354 Programm zum Musiksatz.
 355 @item
 356 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, ein
 357 MIDI-nach-LilyPond Konverter, der monophone MIDI-Eigaben in Echtzeit
 358 konvertiert.
 359 @item
 360 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, ein
 361 Emacs-Modus.
 362 @item
 363 @uref{http://@/www@/.nongnu@/.org/@/xml2ly/,xml2ly}, ein Konverter für
 364 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}, der auf
 365 XML-Transformationen mittels XSLT basiert.
 366 @item
 367 @uref{http://@/noteedit@/.berlios@/.de,NoteEdit}, ein grafisches
 368 Programm zum Notensatz, das auch
 369 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML} importieren kann.
 370 @item
 371 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
 372 das MIDI importieren kann.
 373 @item
 374 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
 375 eine LISP-Bibliothek, um Musiknotation zu erzeugen.
 376 @item
 377 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml},
 378 ein Notensatzprogramm mit experimentellem Export nach LilyPond.
 379 @item
 380 @uref{http://www.tuxguitar.com.ar/,TuxGuitar}, ein Programm zur Erzeugung von
 381 Gitarren-Tabulaturen, unterstützt den Export nach LilyPond.
 382 @item
 383 @uref{http://musescore.org/,MuseScore} unterstützt ebenfalls den
 384 Export nach LilyPond.
 385 @end itemize
 386