#> man dvdwizard

 SYNTAX
     dvdwizard [Optionen] mpeg-file(s)


 BESCHREIBUNG
     dvdwizard ist ein Wrapper-Script, dass mit diversen Unter-
     Skripten und Tools vollautomatisch aus einem oder mehreren MPEG-
     Streams eine DVD-Struktur mit Kapiteln und Menus erzeugt. Diese
     Verzeichnis-Struktur kann anschließend auf eine DVD gebrannt
     werden und sollte auf den meisten Hardware-DVD-Playern lauffähig
     sein.


 OPTIONEN
     dvdwizard braucht zur Erzeugung einer DVD zumindest die Angabe
     eines mpeg-files, welches in die DVD-Struktur umgewandelt werden
     soll. Darüber hinaus können aber über eine Vielzahl von Optionen
     weitaus komplexere DVDs erzeugt werden.
     

     Die Optionen unterteilen sich in verschiedene Gruppen, die
     jeweils andere Aspekte der Verarbeitung beeinflußen. Dabei müssen
     die Optionen einer Gruppe nicht zwangsläufig zusammen angegeben
     werden und auch die Reihenfolge der Gruppen kann willkürlich
     gewählt werden. Eine kleine Ausnahme hierzu bilden die Titleset-
     Optionen, - dazu mehr weiter unten.


 unspezifische Optionen:
     Die unspezifischen Optionen dienen nur zur Information, sie
     leiten keine Verarbeitung ein.

       -h, --help 
          zeigt eine kurze Syntax-Beschreibung an

       -v 
          gibt die Programmversion aus


 Umgebungsoptionen:
     Die Umgebungsoptionen beeinflussen die generelle
     Verarbeitungsumgebung. Hiermit werden Ein- und Ausgabepfade und
     -dateien angegeben sowie Start- und Endepunkt der Verarbeitung
     festgelegt. Die im folgenden verwendete Variable $BASEDIR kann in
     der Konfigurationsdatei von dvdwizard festgelegt werden, der
     Default ist das aktuelle Arbeitsverzeichnis, aus dem heraus
     dvdwizard aufgerufen wird

       -C, --config-file dateiname [$HOME/.dvdwizard/dvdwizard.conf]
          gibt an, welche Datei als Konfigurationsdatei verwendet
          werden soll. In dieser Datei können einige Defaultparameter
          eingetragen werden, die somit nicht mehr beim Aufruf von
          dvdwizard angegeben werden müssen. Näheres zu der
          Konfigurationsdatei gibt es unter man dvdwizard.conf

       -o, --output verzeichnis [$BASEDIR/dvd]
          gibt an, wohin die fertige DVD-Struktur geschrieben werden
          soll. Das angegebene Verzeichnis wird neu angelegt, wenn es
          nicht vorhanden ist. Eventuell vorhandene Dateien in dem
          Verzeichnis werden gelöscht.

       -x, --xml dateiname [$BASEDIR/dvdwizard.xml]
          gibt an, in welche Datei die XML-Definitionen für den Aufruf
          von dvdauthor geschrieben werden sollen

       -l, --logfile dateiname [$BASEDIR/dvdwizard.log]
          gibt an, in welche Datei die Loginformationen über alle
          Verarbeitungsschritte von dvdwizard ausgegeben werden
          sollen. Das Log enthält u.a. alle Programmausgaben der
          aufgerufenen Tools und ist als erste Anlaufstelle bei
          Verarbeitungsproblemen unerläßlich.

       --restart dvdcpics|mk_vmgm|mk_vtsm|author
          im Falle eines Verarbeitungsabbruches und nach Klärung der
          Gründe für den Abbruch kann dvdwizard mit dem Restart-
          Parameter auf einem späteren Verarbeitungsschritt wieder
          aufgesetzt werden. Bedingung für einen solchen Restart ist
          jedoch, daß der Aufruf mit den gleichen Parametern,
          erweitert um -restart, von Statten geht.

      --xmlonly
          mit diesem Parameter kann das finale Authoring der DVD
          verhindert werden. In diesem Falle werden nur die Menus und
          das xml-File für dvdauthor erzeugt. Diese Option ist für
          solche Fälle gedacht, wenn vor dem abschließenden Authoring
          noch manuelle Adjustierungen an der xml-Datei vorgenommen
          werden sollen.


 DVD-Optionen:
     Die Gruppe der DVD-Optionen beeinflußt die gesamte DVD. So können
     z.B. der Titel und das Erscheinungsbild des DVD-Hauptmenus (VMGM)
     beeinflußt werden, aber auch die zu verwendende TV-Norm und die
     Sprache der Audio-Tracks festgelegt werden.

      -T, --vmgm zeichenkette [Titel aus erstem Titleset]
          Legt den Titel der gesamten DVD fest. Dieser wird auf dem
          DVD-Hauptmenu angezeigt, sofern nicht die Option --notitle
          angegeben wurde. Wird -T nicht angegeben, wird der Titel des
          ersten Titlesets der DVD für das VMGM-Menu herangezogen

      -B, --vmgmbg dateiname [builtin]
          Angabe, welches Hintergrundbild für das DVD-Hauptmenu
          verwendet werden soll. Wird dieser Parameter nicht
          angegeben, wird intern ein Hintergrundbild von dvdwizard
          erzeugt.

      -N, --tvnorm PAL|NTSC [PAL o. Konfig-File]
          TV-Norm, in der die DVD erzeugt werden soll. Zur Auswahl
          stehen PAL (Europa und Australien) oder NTSC (Amerika). Wird
          der Parameter nicht angegeben, wird die Angabe im Konfig-
          File (siehe Parameter -C) verwendet. Ist auch kein Konfig-
          File vorhanden, wird PAL angenommen.

      -V, --tvsize XxY [635x535 o. Konfig-File]
          Angabe des sichtbaren Bereiches auf dem Fernseher. Viele
          Fernsehgeräte zeigen nicht die gesamten Bildbereich von
          720x576 sondern einen kleineren Ausschnitt. Der Defaultwert
          kann im Konfig-File angegeben werden, ohne Konfig-File wird
          635x535 angenommen.

      -WS NOPANSCAN|NOLETTERBOX []
          Angabe, wie Widescreen-Formate (16:9) auf einem 4:3 TV
          dargestellt werden sollen. Diese Einstellung betrifft alle
          Titlesets der DVD, sofern diese keinen eigenen -ws Parameter
          haben.

      -P, --palette dateiname []
          Angabe einer Datei mit Farbzuordnungen für Untertitel.

      -A, --Audio codeliste [de,en o. Konfig-File]
          Angabe der Sprachen der verwendeten Audio-Tracks. Die in
          dieser Liste angegebene Reihenfolge wird bei der
          Kennzeichnung der verschiedenen Audio-Formate für jedes
          Format verwendet. Wenn die DVD z.B. drei Audiospuren hat, in
          der Reihenfolge mp2,ac3,mp2, wird der erste mp2-Track mit
          "de" gekennzeichnet, genauso wie der erste (und einzige)
          ac3-Track. Der zweite mp2-Track würde dann als "en"
          ausgewiesen. Gäbe es einen zweiten ac3-Track, würde dieser
          ebenfalls "en" als Kennzeichnung erhalten. Die hier gemachte
          Angabe gilt für alle Titlesets der DVD, kann jedoch pro
          Titleset mit der Option -a überschrieben werden. Werden
          keine Angaben gemacht, gilt der Default aus dem Konfig-File,
          ohne Konfig-File wird deutsch als erste Sprache und englisch
          als zweite Sprache angenommen.

      --notitle
          Unterdrückt die Ausgabe des DVD-Titels (siehe Option -T) auf
          dem VMGM-Menu.


 Titleset-Optionen:
     Diese letzte Gruppe der Optionen definiert ein einzelnes Titleset
     auf der DVD. dvdwizard erlaubt es, bis zu 9 Titlesets auf einer
     DVD unterzubringen. Jedes Titleset wird durch ein einleitendes -t
     begonnen und alle Titleset-Optionen sowie mpeg files, die bis zum
     nächsten -t angegeben werden, gehören zu diesem Titleset.

      -t, --vts "auto"|zeichenkette|dateiname
          Leitet die Definition eines neuen Titlesets ein. Nach dieser
          Option steht einer der drei angegebenen Parametern:
          "auto" bedeutet, daß der Titel des Titlesets aus dem
          Dateinamen des ersten mpeg files ermittelt wird.
          zeichenkette gibt den für das Titleset zu verwendende Titel
          direkt an
          dateiname gibt das erste für das Titleset zu verwendende
          mpeg file an. Der Titel des Titelsets wird aus diesem
          Dateinamen ermittelt. Wenn die DVD nur ein einzelnes
          Titleset enthalten soll, kann die Option -t weggelassen
          werden.

      -c, --chapters 0|dateiname|timecode-liste|intervall [300]
          Gibt an, wie das Titleset in Kapitel unterteilt werden soll.
          Möglich sind folgende Angaben:
          0 bedeutet, daß keine Kapiteleinteilung vorgenommen wird,
          außer zum Beginn eines jeden mpeg files, die für das
          Titleset angegeben wurden
          dateiname gibt eine Datei an, in der sich eine timecode-
          liste für die Kapiteleinteilung befindet
          timecode-liste gibt eine durch Kommata getrennte Liste von
          Timecodes im Format [h:[mm:]]ss[.frac] an. Jeder Timecode
          markiert den Beginn eines neuen Kapitels.
          intervall gibt an, daß das Titleset in Kapitel mit einer
          fixen Größe unterteilt werden soll. Die Angabe enthält die
          Länge der Kapitel in Sekunden
          Weitergehende Informationen zu dieser Angabe erhält man
          unter man chaptercheck

      -b, --vtsmbg dateiname [builtin]
          Angabe, welches Hintergrundbild für die Titleset-Menus
          (VTSM) verwendet werden soll. Wird dieser Parameter nicht
          angegeben, wird intern ein Hintergrundbild von dvdwizard
          erzeugt. Das hier angegebene Image-File wird einheitlich für
          alle Menus des Titlesets sowie den Thumbnail des Titlesets
          auf dem DVD-Hauptmenu verwendet.

      -ws NOPANSCAN|NOLETTERBOX []
          Identisch mit -WS, bezieht sich jedoch nur auf das
          zugehörige Titleset

      -a, --audio codeliste [aus -A]
          siehe Beschreibung der DVD-Option -A. Verwendung und Format
          sind identisch, allerdings bezieht sich diese Angabe hier
          nur auf das jeweilige Titleset.

      -s, --subpic codeliste []
          Gibt an, in welcher Sprache die im MPEG-File vorhandenen
          Untertitelspuren sind. Angabe erfolgt analog zu den -A|-a
          Optionen mit einer durch Kommate separierten Liste von
          Ländercodes


 mpeg file(s):
     Neben den zuvor beschriebenen Optionen, muß dvdwizard mit
     mindestens einem mpeg file aufgerufen werden. Bei der Angabe von
     mehreren mpeg files können diese entweder auf mehrere Titlesets
     verteilt werden oder aber zu einem gemeinsamen Titleset
     zusammengeführt werden. Die mpeg files müssen in einem von
     dvdauthor zu verarbeitendem Format vorliegen.


 BEISPIELE
     Hier ein paar Beispiele, die den Gebrauch von dvdwizard ein wenig
     illustrieren sollen:

      dvdwizard my_video.mpg
          Die einfachste Form des Aufrufs. dvdwizard erzeugt aus
          my_video.mpg eine DVD mit einem Titleset. Hintergrundbilder
          werden intern erzeugt, der Film wird in fixe, fünfminütige
          Kapitel eingeteilt und der Titel der DVD wird "My Video"
          heißen.

      dvdwizard -C /usr/share/dvdwizard.conf
          -T "My Movies" -N NTSC -t movie1.mpg movie2.mpg
          Die Default-Konfiguration soll aus der Datei
          /usr/share/dvdwizard.conf eingelesen werden, der Title der
          DVD lautet "My Movies". Als TV-Norm wird NTSC verwendet und
          die Dateien movie1.mpg und movie2.mpg werden zu einem
          Titleset zusammengefügt

      dvdwizard --xmlonly
          -t "Urlaub" -b  /images/Sonne.ppm movie1.mpg
          -t "Weihnachten" -b  /images/schnee.jpg -c 0 -a de,fr
           movie2.mpg movie3.mpg
          Hierbei wird keine DVD-Struktur erzeugt, sondern nur die
          Menus und XML-Definition für dvdauthor erzeugt. Die Objekte
          werden mit zwei Titlesets erzeugt, die jeweils ein eigenes
          Hintergrundbild haben. Das zweite Titleset wird in nur 2
          Kapitel unterteilt (-c 0 und zwei mpeg files) und hat
          offensichtlich mindestens zwei Tonspuren, die zum einen in
          deutsch und zum anderen in französisch vorliegen.


 SIEHE AUCH
     udrec_suite(1), dvdauthor(1), dvdwizard.conf(5), dvdcpics(1),
     mk_vmgm(1), mk_vtsm(1), mk_vtsm_audio(1), dvdtguess(1),
     chaptercheck(1), mpgprobe(1)