Documentation/de/user/converters.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
   2 @c This file is part of lilypond-program.tely
   3 @ignore
   4     Translation of GIT committish: c1be53409464d49dffa013f3dfeb9eb4910edd92
   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 Translators: Reinhold Kainhofer
  11
  12 @node Converting from other formats
  13 @chapter Converting from other formats
  14
  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.
  21
  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.
  25
  26
  27 @knownissues
  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!
  32
  33
  34 @menu
  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
  41 @end menu
  42
  43 @node Invoking midi2ly
  44 @section Invoking @command{midi2ly}
  45
  46 @cindex MIDI
  47
  48 @command{midi2ly} übersetzt eine Typ@tie{}1 MIDI-Datei in eine
  49 Eingabedatei für LilyPond.
  50
  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.
  59
  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.
  63
  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.
  73
  74
  75 @command{midi2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
  76 @example
  77 midi2ly [@var{Optionen}]@dots{} @var{MIDI-Datei}
  78 @end example
  79
  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}.
  83
  84 Die folgenden Kommandozeilenoptionen werden von @command{midi2ly}
  85 unterstützt:
  86
  87 @table @code
  88 @item -a, --absolute-pitches
  89 Gibt absolute Tonhöhen aus.
  90
  91 @item -d, --duration-quant=@var{LÄNGE}
  92 Quantisiert Tondauern zu Vielfachen von @var{LÄNGE}.
  93
  94 @item -e, --explicit-durations
  95 Gibt alle Tondauern explizit an.
  96
  97 @item -h,--help
  98 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
  99
 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.
 104
 105 @item -o, --output=@var{Datei}
 106 Die Ausgabe wird in die Datei @var{Datei}@file{.ly} geschrieben.
 107
 108 @item -s, --start-quant=@var{LÄNGE}
 109 Quantisiert den Beginn der Noten zu Vielfachen von @var{LÄNGE}.
 110
 111 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
 112 Erlaubt Tuplet-Dauern der Form @var{DUR}*@var{NUM}/@var{DEN}.
 113
 114 @item -V, --verbose
 115 Gibt zusätzliche Debug-Informationen während der Konvertierung aus.
 116
 117 @item -v, --version
 118 Gibt die Versionsnummer aus.
 119
 120 @item -w, --warranty
 121 Zeigt die Lizenzbedingungen und Urheberrechtshinweise.
 122
 123 @item -x, --text-lyrics
 124 Interpretiert alle Texte als Liedtexte.
 125 @end table
 126
 127
 128 @knownissues
 129
 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
 134 hinzufügen.
 135
 136
 137 @node Invoking musicxml2ly
 138 @section Invoking @code{musicxml2ly}
 139
 140 @cindex MusicXML
 141
 142 @uref{http://@/www.@/musicxml@/.org/,MusicXML} ist ein XML-Dialekt
 143 zur Darstellung von Musiknotation.
 144
 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
 148 .ly-Datei um.
 149
 150 @command{musicxml2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
 151 @example
 152 musicxml2ly [@var{Optionen}]@dots{} @var{XML-Datei}
 153 @end example
 154
 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}.
 158
 159 Wenn als Dateiname @file{-} angegeben wird, liest @command{musicxml2ly}
 160 Daten direkt von der Kommandozeile ein.
 161
 162 Die folgenden Kommandozeilenoptionen werden von @command{musicxml2ly}
 163 unterstützt:
 164
 165 @table @code
 166 @item -a, --absolute
 167 Konvertiert in absolute Tonhöhen.
 168
 169 @item -h,--help
 170 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 171
 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.
 176
 177 @item --lxml
 178 Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung)
 179
 180 @item --nd --no-articulation-directions
 181 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
 182 von Artikulations- und Lautstärkebezeichnungen.
 183
 184 @item --no-beaming
 185 Konvertiert keine Informationen über die Balkensetzung aus der
 186 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
 187
 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}.
 193
 194 @item -r,--relative
 195 Konvertiert in relative Tonhöhen. (Standardeinstellung)
 196
 197 @item -v, --verbose
 198 Gibt zusätzliche Debug-Informationen während der Konvertierung aus.
 199
 200 @item --version
 201 Gibt die Versionsnummer aus.
 202
 203 @item  -z,--compressed
 204 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
 205 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
 206 @file{.mxl}.
 207 @end table
 208
 209
 210 @node Invoking abc2ly
 211 @section Invoking @code{abc2ly}
 212
 213 @cindex ABC
 214
 215 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
 216 dokumentiert auf der ABC-Homepage:
 217
 218 @quotation
 219 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
 220 @end quotation
 221
 222 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
 223 von der Kommandozeile folgendermaßen aufgerufen:
 224
 225 @example
 226 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
 227 @end example
 228
 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}.
 232
 233 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
 234 unterstützt:
 235
 236 @table @code
 237 @item -b,--beams=None
 238 Die Balkensetzung aus der ABC-Datei erhalten.
 239 @item -h,--help
 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.
 243 @item -s,--strict
 244 Strenge Auslegung einer erfolgreichen Konvertierung.
 245 @item -v,--version
 246 Gibt die Versionsnummer aus.
 247 @end table
 248
 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
 252
 253 @example
 254 %%LY voices \set autoBeaming = ##f
 255 @end example
 256
 257 @noindent
 258 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
 259 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
 260
 261 Ebenso bewirkt
 262
 263 @example
 264 %%LY slyrics more words
 265 @end example
 266
 267 @noindent
 268 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
 269 im Liedtext eingefügt wird.
 270
 271
 272 @knownissues
 273
 274 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
 275 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
 276 Konventionen.
 277
 278 Mehrere Lieder in einer Datei können nicht konvertiert werden.
 279
 280 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
 281 @command{abc2ly} macht dies nicht.
 282
 283 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
 284
 285
 286 @node Invoking etf2ly
 287 @section Invoking @command{etf2ly}
 288
 289 @cindex ETF
 290 @cindex enigma
 291 @cindex Finale
 292 @cindex Coda Technology
 293
 294 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
 295 Music Technology in älteren Versionen des Programms Finale benutzt hat.
 296
 297 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
 298 und wird von der Kommandozeile folgendermaßen aufgerufen:
 299
 300 @example
 301 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
 302 @end example
 303
 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}.
 307
 308 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
 309 unterstützt:
 310
 311 @table @code
 312 @item -h,--help
 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.
 316 @item --version
 317 Gibt die Versionsnummer aus.
 318 @end table
 319
 320
 321 @knownissues
 322
 323 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
 324 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
 325 beendet.
 326
 327
 328 @node Generating LilyPond files
 329 @section Generating LilyPond files
 330
 331 @cindex Externe Programme, LilyPond-Dateien erzeugen
 332
 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
 336 können.
 337 Diese umfassen unter anderem:
 338
 339 @itemize
 340 @item
 341 @uref{http://@/denemo@/.sourceforge@/.net/,Denemo}, ein grafisches
 342 Programm zum Musiksatz.
 343 @item
 344 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, ein
 345 MIDI-nach-LilyPond Konverter, der monophone MIDI-Eigaben in Echtzeit
 346 konvertiert.
 347 @item
 348 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, ein
 349 Emacs-Modus.
 350 @item
 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.
 354 @item
 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.
 358 @item
 359 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
 360 das MIDI importieren kann.
 361 @item
 362 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
 363 eine LISP-Bibliothek, um Musiknotation zu erzeugen.
 364 @item
 365 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml},
 366 ein Notensatzprogramm mit experimentellem Export nach LilyPond.
 367 @item
 368 @uref{http://www.tuxguitar.com.ar/,TuxGuitar}, ein Programm zur Erzeugung von
 369 Gitarren-Tabulaturen, unterstützt den Export nach LilyPond.
 370 @item
 371 @uref{http://musescore.org/,MuseScore} unterstützt ebenfalls den
 372 Export nach LilyPond.
 373 @end itemize
 374