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: 499a511d4166feaada31114e097f86b5e0c56421
   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 Rettig
  14
  15 @node Converting from other formats
  16 @chapter Converting from other formats
  17
  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.
  24
  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}.
  30
  31 @knownissues
  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!
  36
  37
  38 @menu
  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.
  45 @end menu
  46
  47 @node Invoking midi2ly
  48 @section Invoking @command{midi2ly}
  49
  50 @cindex MIDI
  51
  52 @command{midi2ly} übersetzt eine Typ@tie{}1 MIDI-Datei in eine
  53 Eingabedatei für LilyPond.
  54
  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.
  63
  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.
  67
  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.
  77
  78
  79 @command{midi2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
  80 @example
  81 midi2ly [@var{Optionen}]@dots{} @var{MIDI-Datei}
  82 @end example
  83
  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}.
  87
  88 Die folgenden Kommandozeilenoptionen werden von @command{midi2ly}
  89 unterstützt:
  90
  91 @table @code
  92 @item -a, --absolute-pitches
  93 Gibt absolute Tonhöhen aus.
  94
  95 @item -d, --duration-quant=@var{LÄNGE}
  96 Quantisiert Tondauern zu Vielfachen von @var{LÄNGE}.
  97
  98 @item -e, --explicit-durations
  99 Gibt alle Tondauern explizit an.
 100
 101 @item -h,--help
 102 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 103
 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.
 108
 109 @item -o, --output=@var{Datei}
 110 Die Ausgabe wird in die Datei @var{Datei}@file{.ly} geschrieben.
 111
 112 @item -s, --start-quant=@var{LÄNGE}
 113 Quantisiert den Beginn der Noten zu Vielfachen von @var{LÄNGE}.
 114
 115 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
 116 Erlaubt Tuplet-Dauern der Form @var{DUR}*@var{NUM}/@var{DEN}.
 117
 118 @item -V, --verbose
 119 Gibt ausführliche informative Meldungen während der Konvertierung aus.
 120
 121 @item -v, --version
 122 Gibt die Versionsnummer aus.
 123
 124 @item -w, --warranty
 125 Zeigt die Lizenzbedingungen und Urheberrechtshinweise.
 126
 127 @item -x, --text-lyrics
 128 Interpretiert alle Texte als Liedtexte.
 129 @end table
 130
 131
 132 @knownissues
 133
 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
 138 hinzufügen.
 139
 140
 141 @node Invoking musicxml2ly
 142 @section Invoking @code{musicxml2ly}
 143
 144 @cindex MusicXML
 145
 146 @uref{http://@/www.@/musicxml@/.org/,MusicXML} ist ein XML-Dialekt
 147 zur Darstellung von Musiknotation.
 148
 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
 152 .ly-Datei um.
 153
 154 @command{musicxml2ly} wird von der Kommandozeile folgendermaßen aufgerufen:
 155 @example
 156 musicxml2ly [@var{Optionen}]@dots{} @var{XML-Datei}
 157 @end example
 158
 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}.
 162
 163 Wenn als Dateiname @file{-} angegeben wird, liest @command{musicxml2ly}
 164 Daten direkt von der Kommandozeile ein.
 165
 166 Die folgenden Kommandozeilenoptionen werden von @command{musicxml2ly}
 167 unterstützt:
 168
 169 @table @code
 170 @item -a, --absolute
 171 Konvertiert in absolute Tonhöhen.
 172
 173 @item -h,--help
 174 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 175
 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.
 180
 181 @item --lxml
 182 Benutzt das lxml.etree Python-Paket für die Verarbeitung von XML (benötigt weniger Speicher und Rechenleistung)
 183
 184 @item --nd --no-articulation-directions
 185 Konvertiert keine Richtungsangaben (@code{^}, @code{_} oder @code{-})
 186 von Artikulations- und Lautstärkebezeichnungen.
 187
 188 @item --no-beaming
 189 Konvertiert keine Informationen über die Balkensetzung aus der
 190 MusicXML-Datei. Stattdessen wird dies LilyPond überlassen.
 191
 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}.
 197
 198 @item -r,--relative
 199 Konvertiert in relative Tonhöhen. (Standardeinstellung)
 200
 201 @item -v, --verbose
 202 Gibt ausführliche informative Meldungen während der Konvertierung aus.
 203
 204 @item --version
 205 Gibt die Versionsnummer aus.
 206
 207 @item  -z,--compressed
 208 Die Eingabedatei wird als komprimierte MusicXML-Datei eingelesen.
 209 Dies ist die Standardeinstellung für Dateien mit der Erweiterung
 210 @file{.mxl}.
 211 @end table
 212
 213
 214 @node Invoking abc2ly
 215 @section Invoking @code{abc2ly}
 216
 217 @cindex ABC
 218
 219 ABC ist ein relativ einfaches ASCII-basierendes Musikformat und ist
 220 dokumentiert auf der ABC-Homepage:
 221
 222 @quotation
 223 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html}.
 224 @end quotation
 225
 226 @command{abc2ly} konvertiert ABC-Dateien nach LilyPond und wird
 227 von der Kommandozeile folgendermaßen aufgerufen:
 228
 229 @example
 230 abc2ly [@var{Optionen}]@dots{} @var{ABC-Datei}
 231 @end example
 232
 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}.
 236
 237 Die folgenden Kommandozeilenoptionen werden von @command{abc2ly}
 238 unterstützt:
 239
 240 @table @code
 241 @item -b,--beams=None
 242 Die Balkensetzung aus der ABC-Datei erhalten.
 243 @item -h,--help
 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.
 247 @item -s,--strict
 248 Strenge Auslegung einer erfolgreichen Konvertierung.
 249 @item -v,--version
 250 Gibt die Versionsnummer aus.
 251 @end table
 252
 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
 256
 257 @example
 258 %%LY voices \set autoBeaming = ##f
 259 @end example
 260
 261 @noindent
 262 befindet, so wird der Text nach dem Schlüsselwort @q{voices} direkt
 263 in die aktuelle Stimme in der LilyPond-Datei eingefügt.
 264
 265 Ebenso bewirkt
 266
 267 @example
 268 %%LY slyrics more words
 269 @end example
 270
 271 @noindent
 272 dass alles nach dem @q{slyrics} Schlüsselwort an der aktuellen Stelle
 273 im Liedtext eingefügt wird.
 274
 275
 276 @knownissues
 277
 278 Der ABC-Standard ist eigentlich kein wirklich vollständiger Standard.
 279 Für komplexere Notation wie etwa Polyphonie existieren verschiedene
 280 Konventionen.
 281
 282 Mehrere Lieder in einer Datei können nicht konvertiert werden.
 283
 284 ABC synchronisiert den Liedtext am Anfang jeder Zeile mit den Noten,
 285 @command{abc2ly} macht dies nicht.
 286
 287 @command{abc2ly} ignoriert die Balkensetzung in der ABC-Datei.
 288
 289
 290 @node Invoking etf2ly
 291 @section Invoking @command{etf2ly}
 292
 293 @cindex ETF
 294 @cindex enigma
 295 @cindex Finale
 296 @cindex Coda Technology
 297
 298 ETF (Enigma Transport Format) ist ein Dateiformat, das Coda
 299 Music Technology in älteren Versionen des Programms Finale benutzt hat.
 300
 301 @command{etf2ly} konvertiert Teile einer ETF-Datei nach LilyPond
 302 und wird von der Kommandozeile folgendermaßen aufgerufen:
 303
 304 @example
 305 etf2ly [@var{Optionen}]@dots{} @var{ETF-Datei}
 306 @end example
 307
 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}.
 311
 312 Die folgenden Kommandozeilenoptionen werden von @command{etf2ly}
 313 unterstützt:
 314
 315 @table @code
 316 @item -h,--help
 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.
 320 @item --version
 321 Gibt die Versionsnummer aus.
 322 @end table
 323
 324
 325 @knownissues
 326
 327 Die Liste der Artikulationszeichen is unvollständig. Leere Takte
 328 verwirren @command{etf2ly}. Mehrfache Vorschlagnoten werden falsch
 329 beendet.
 330
 331
 332 @node Generating LilyPond files
 333 @section Generating LilyPond files
 334
 335 @cindex Externe Programme, LilyPond-Dateien erzeugen
 336
 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
 340 können.
 341 Diese umfassen unter anderem:
 342
 343 @itemize
 344 @item
 345 @uref{http://@/www@/.denemo@/.org/,Denemo}, ein grafisches
 346 Programm zum Musiksatz.
 347 @item
 348 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, ein
 349 MIDI-nach-LilyPond Konverter, der monophone MIDI-Eigaben in Echtzeit
 350 konvertiert.
 351 @item
 352 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, ein
 353 Emacs-Modus.
 354 @item
 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.
 358 @item
 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.
 362 @item
 363 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
 364 das MIDI importieren kann.
 365 @item
 366 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
 367 eine LISP-Bibliothek, um Musiknotation zu erzeugen.
 368 @item
 369 @uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml},
 370 ein Notensatzprogramm mit experimentellem Export nach LilyPond.
 371 @item
 372 @uref{http://www.tuxguitar.com.ar/,TuxGuitar}, ein Programm zur Erzeugung von
 373 Gitarren-Tabulaturen, unterstützt den Export nach LilyPond.
 374 @item
 375 @uref{http://musescore.org/,MuseScore} unterstützt ebenfalls den
 376 Export nach LilyPond.
 377 @end itemize
 378