[[Vorlage(Getestet, bionic, focal)]] {{{#!vorlage Wissen [:Pakete_installieren: Installation von Programmen] [:Programme starten: Ein Programm ohne Menüeintrag starten] [:Menüeditor: Programme zum Menü hinzufügen] [:Terminal: Ein Terminal öffnen] }}} [[Inhaltsverzeichnis(1)]] [[Bild(./ScummVM-icon.png, 64, align=left)]] Bei den ScummVM-Tools handet es sich um eine nützliche Sammlung von Werkzeugen für [:Spiele/ScummVM:ScummVM]. Bei ihrem Einsatz ist zu beachten, dass nicht jede Programmversion mit allen Funktionen kompatibel ist. Dies hängt u.a. davon ab ob Funktionen beim kompilieren (de)aktiviert wurden. Mit Hilfe der Werkźeuge kann man unter anderem Dateien aus Spielen extrahieren, Audiodateien in ein anderes Format (z.B. '''flac''', '''mp3''' oder '''ogg''') zu konvertieren und anschließend zu komprimieren. Dem Benutzer steht eine grafische Oberfläche oder die Kommandozeile zur Verfügung um die Befehle einzeln zu übergeben oder in Skripten zu nutzen. {{{#!vorlage Tabelle [[Bild(./ScummVMTools.jpg, x250)]] +++ <:>GUI }}} = Installation = Die Werkzeugsammlung ist in den Paketquellen undhalten und kann mittels {{{#!vorlage Paketinstallation scummvm-tools, univers }}} installiert [1] werden. Über `scummvm-tools` (GUI) bzw. `scummvm-tools-cli` kann das Programm gestartet werden [2] - auf Wunsch einen Menüeintrag [3] für die GUI vornehmen. = GUI = Für die meisten Anwendungsfälle reicht die Verwendung der grafischen Oberfläche, da mit ihr alle wichtigen Schritte vorgenommen werden können Die Bedienung der grafischen Oberfläche ist intuitiv zu erfassen. {{{#!vorlage Tabelle ScummVM Tools +++ Menüpunkt Beschreibung +++ ''"Compress"'' Audio-, Sprach-, Animationsdateien komprimieren. +++ ''"Extract"'' Inhalt aus Archiven entpacken. +++ ''"Advanced"'' Werkzeug auswählen. +++ ''"Setings"'' [#Audioparameter Einstellungen] für [wikipedia:MP3:] ('''*.mp3'''), [:FLAC:] ('''*.flac''') und [:Vorbis:Ogg/Vorbis] ('''*.ogg''') anpassen. }}} == Beispiele == === Audiodatei === {{{#!vorlage Tabelle <:>[[Bild(Beispiel_01.png, x150)]] <:>[[Bild(Beispiel_02.png, x150)]] <:>[[Bild(Beispiel_03.png, x150)]] <:>[[Bild(Beispiel_04.png, x150)]] <:>[[Bild(Beispiel_05.png, x150)]] <:>[[Bild(Beispiel_06.png, x150)]] <:>[[Bild(Beispiel_07.png, x150)]] <:>[[Bild(Beispiel_08.png, x150)]] +++ <:>''"Compress"'' <:>'''simon.wav''' <:>`compress_agos` <:>'''simon.ogg''' <:>Plattform <:>Audiocodec <:>Umwandlung <:>Statusmeldung }}} In den meisten Fällen werden die Audiodateien komprimiert. Im konkreten Fall wird der Ordner des Spieles Simon the Sorcerer aufrufen und die Audiodatei '''simon.wav''' ausgewählt. Es wird erkannt, dass es sich um eine Datei des bereits erwähnten Spieleitels handelt und eine entsprechende Weiterverarbeitungsmöglichkeit aufgezeigt (`compress_agos`). Der Ausgabepfad und der Dateiname werden im folgenden Schritt definiert und nach der Wahl des gewünschten Codecs umgewandelt. Bei letzterem kann die [#Audioparameter Qualität] angepaßt werden. Dies beeinflußt die Endgröße der Ausgabedatei. In den Grundeinstellungen wandelte das Programm die Ausgangsdatei '''simon.wav''' (206,1 MB) in '''simon.ogg''' (67,5 MB) um. {{{#!vorlage Tabelle [[Bild(./Settings.jpg, x250)]] +++ <:>Einstellungen }}} = Audioparameter = An den Audioeinstellungen kann man ein Vielzahl von Einstellungen vornehmen um das gewünschte Endergebnis zu erhalten. Abhängig von der gewünschten Qualitätsstufe fällt die Dateigröße aus. {{{#!vorlage Tabelle Audioparameter +++ MP3 +++ Parameter Beschreibung +++ `-b X` X = Gewünschte Bitrate bei [wikipedia:LAME#Bitrate-Modi:ABR] (durchschnittliche Datenrate) bzw. minimal erwünschte Bitrate bei [wikipedia:LAME#Bitrate-Modi:VBR] (variable Datenrate). +++ `-B X` X = maximale [wikipedia:LAME#Bitrate-Modi:ABR/VBR] Bitrate. +++ `--vbr` Variable Datenrate verwenden. +++ `--abr` Durchschnittliche Datenrate verwenden. +++ `-V X` X = Wahl der Qualitätsstufe. Die Werte `0-9` können verwendet werden wobei `0` die beste Qualität verspricht. +++ `-q X` Legt die Qualität des MPEG-Algorithmus fest. Dieser kann den Bereich zwischen `0 - 9` umfassen - wobei `0` die beste Qualität bedeutet. +++ `--silent` Ausgabe von LAME wird verhindert. +++ `--lame-path` Definiert den Dateipfad wo Lame zu finden ist. In der Grundeinstellung: `lame` +++ Vorbis +++ Parameter Beschreibung +++ `-b X` X legt die nominale Bitrate fest. +++ `-m X` X definiert die minimum Bitrate. +++ `-M X` X als maximale Bitrate. +++ `-q X` Definiert den Wert zwischen `-1` und `10` der VBR-Qualität wobei der Wert `10` die beste Qualität ist. +++ `--silent` Die Ausgabe von oggenc wird unterbunden. +++ Free Lossless Audio Codec (Flac) +++ Parameter Beschreibung +++ `--fast` Bei der Kompression nutzt FLAC die Qualitätsstufe `0` (niedrigste). +++ `--best` FLAC verwendet `8` bei dieser Vorgabe. +++ `-X` Legt den Wert X der Komprimierung, welcher zwischen `0` (niedrigste Qualität) und `8` (beste Qualität) liegen kann, fest. +++ `-b X` Definiert die 8wikipedia:Free_Lossless_Audio_Codec#Kompressionsstufen:Blockgröße]. Der Wert muss ein Vielfaches von 8 sein und zwischen 8 und 160 liegenn. +++ `--verify` Dateien werden erst kodiert und später dekodiert um sie auf die Richtigkeit hin zu überprüfen. +++ `--silent` Die Ausgabe von FLAC ist auf stumm geschaltet. }}} == Terminal == Die zur Verfügung stehenden Werkzeuge erhält man durch den Aufruf im Terminal [2]: {{{#!vorlage Befehl scummvm-tools-cli --list }}} Der generelle Aufruf [2] sieht wie folgt aus: {{{#!vorlage Befehl scummvm-tools-cli [--Werkzeug ] [Werkzeugspezifische Optionen] [-o ] }}} == Werkzeuge == Unter anderem stehen die folgenden Werkzeuge zur Verfügung: {{{#!vorlage Tabelle Terminal +++ Werkzeug Beschreibung Syntax Beispiel +++ <-4 rowclass="highlight">Extraktion +++ '''extract_kyra''' Entpackt die Dateien mit der Endung '''.PAK''' aus den Spielen der Kyrandia Serie. ``extract_kyra [Parameter] `` +++ <-4 rowclass="highlight">Komprimierung +++ '''compress_agos''' Komprimiert und konvertiert die Sprachdateien ('''*.von''' und '''*.wav''') von [:Spiele/Floyd:Floyd] und Simon the Sorcerer 1/2 in die Formate MP3, Vorbis oder FLAC. ``compress_agos [Parameter] `` ``./scummvm-tools-cli --tool compress_agos --vorbis -q 7 SIMON.WAV`` +++ '''compress_gob''' Komprimiert die Daten von Gobliiins! +++ '''compress_kyra''' Umwandlung und Komprimierung der Sprachdateien ('''*.VRM''') von The Legend of Kyrandia in die Formate MP3, Vorbis oder FLAC. ``./compress_kyra Eingabedatei Ausgabedatei`` ``./scummvm-tools-cli --tool compress_kyra input/GEMCUT.VRM output/GEMCUT.VRM`` +++ '''compress_queen''' Wird verwendet, um die Datendatei von Flight of the Amazon Queen neu zu erstellen und optionale MP3-, Vorbis- oder FLAC-Komprimierung zuzulassen. ``./scummvm-tools-cli --tool compress_queen [-o Ausgabedatei] queen.1`` +++ '''compress_saga''' Dient zum Komprimieren der digitaler Sounddateien der SAGA-Engine in MP3, Vorbis oder FLAC. Wobei ```` die zu verwendende Sounddatei ist. Für Erben der Erde können die Dateien für digitale Musik ('''music.rsc'''), Sprache ('''Voices.rsc''') und Soundeffekte ('''sounds.rsc''') komprimiert werden. Für den Titel I have no mouth können die Sprachdateien ('''voices*.res''') komprimiert werden. Die komprimierten Dateien haben die Erweiterung '''.cmp'''. ``./scummvm-tools-cli --tool compress_saga `` +++ '''compress_sci''' Komprimiert die '''resource.aud'''/'''.sfx''' und '''AUDIO001.002'''-Dateien von [wikipedia:Sierra_Entertainment:Sierra Entertainment]. Jedoch ist es __inkompatibel__ mit SCI32-Titeln! ``./scummvm-tools-cli --tool compress_sci --vorbis [-o output] resource.aud`` +++ '''compress_scumm_bun''' Musik- und Sprachdateien des '''.bun'''-Formats können in MP3, Vorbis oder FLAC umgewandelt werden. ``./scummvm-tools-cli --tool compress_scumm_bun --flac digmusic.bun uncomp comp`` +++ '''compress_scumm_san''' Smush-Animaionsdateien ('''.san''') werden verlustfrei in zlib komprimiert. Außerdem kann eine separate '''.ogg'''-Datei angelegt werden. ``./scummvm-tools-cli --tool compress_scumm_san opening.san uncomp/ comp/`` +++ '''compress_scumm_sou''' Wandelt die Dateien mit den Endungen '''*.sou''' in '''*.so3''' (MP3), '''*.sog''' (Vorbis) oder '''*.sof''' (FLAC) um. ``compress_scumm_sou [Parameter] monster.sou`` ``./scummvm-tools-cli --mp3 MONSTER.SOU`` +++ '''compress_sword1''' Sprache und Musik ('''*.clu''') von Baphomets Fluch in '''*.cl3''' (MP3), '''*.clg''' (Vorbis) bzw. '''*.clf''' (FLAC) umwandeln. ``compress_sword1 [Parameter] `` +++ '''compress_sword2''' Baphomets Fluch 2 - Der Spiegel der Finsternis (s. '''compress_sword1'''). ``compress_sword2 [Parameter] `` +++ '''compress_tinsel''' Komprimierung von tinsel '''.smp'''-Dateien. +++ '''compress_touche''' Dient zum Komprimieren und Packen der Touché-Sprachdateien ('''Vxxx''' und '''OBJ''') in MP3, Vorbis oder FLAC in eine einzelne Datei mit dem Namen '''TOUCHE.SO3''', '''TOUCHE.SOG''' oder '''TOUCHE.SOF'''. Dies ist abhängig von der Klangkomprimierung. Anschließend sind nur die Dateien '''TOUCHE.DAT''' und '''TOUCHE.SOx''' unter ScummVM erforderlich. ``./scummvm-tools-cli --tool compress_touche [-o outputfile] `` +++ '''compress_tucker''' Wird zum Komprimieren von '''.wav'''-Dateien aus den '''FX''', '''MUSIC''' und '''SPEECH'''-Verzeichnissen in eine einzelne Datei mit dem Namen '''TUCKER.SOx''' verwendet. Nach dem Komprimieren sind die 3 Verzeichnisse nicht mehr erforderlich. +++ <-4 rowclass="highlight">Encoder +++ '''encode_dxa''' Erstellt die Videodatei '''*.dxa''' aus den Smacker Videos ('''*.smk'''). Video wird zuerst in '''*.PNG''' umgewandel sowie eine Datei im Format '''*.wav''' erstellt. Später wird das Video enkodiert und als Ergebnis erhält man die Video- sowie die Videospur im gewählten Format (flac, mp3 oder ogg). ``encode_dxa `` [:Spiele/Floyd:Floyd] +++ '''convert_dxa.bat, convert_dxa_one.bat''' Skripte zur automatischen Konvertierung von '''.smk'''-Dateien innerhalb eines Ordners. +++ '''convert_dxa.sh''' Skript, welches die Umwandlung in '''*.dxa''' vornimmt. [:Wine:] wird hierfür benötigt. +++ <-4 rowclass="highlight">Extraktionswerkzeuge +++ '''extract_agos''' Extrahiert die gepackten Dateien, die in den Amiga- und Atari-Versionen von Elvira 1/2, Waxworks und Simon the Sorcerer 1 verwendet werden. ``./scummvm-tools-cli --tool extract_agos ... `` +++ '''extract_cge''' Entpacken der Spieledatendateien von Soltys und Sfinx. Die muss entweder die Datei vol.cat oder die Datei vol.dat sein. ``./scummvm-tools-cli --tool extract_cge [-o Ausgabeverzeichnis] `` +++ '''extract_cine''' Entpackt die Archivdateien der [wikipedia:Delphine_Software_International:Delphine Cinematique Engine]. Es wird nur eine Eingabedatei akzeptiert. Liegt ein Archiv vor, so wird nur dieses entpackt. Liegt die Datei '''vol.cnf''' vor, dann werden alle in der Datei '''vol.cnf''' aufgeführten Archive entpackt. ``./scummvm-tools-cli --tool extract_cine [-o Ausgabeverzeichnis] `` +++ '''extract_cruise_pc''' Entpacken der '''.E1'''-, '''.E4'''- und '''.E5'''-Dateien, die in einigen Versionen von Cruise for a Corpse enthalten sind. Mittels ``extract_cine``gelangt man an die '''.D1'''- bis '''.D5'''-Dateien. ``./scummvm-tools-cli --tool extract_cruise_pc [-o Ausgabeverzeichnis] `` +++ '''extract_fascination_cd''' Extrahieren des versteckten STK von der Fascination CD. Es wurde entwickelt, um nur mit '''.iso'''-Dateien der ersten Datenspur zu arbeiten, d. H. ~ 11 MB, nicht 652 MB. Die ISO-Erstellung für einzelne Spuren kann mit einem Tool wie [:dd:] erstellt werden. +++ '''extract_gob_stk''' Extrahieren der Dateien aus einer Stick-Datei, welche von der Gob-Engine verwendet wird ('''.STK''', '''.ITK''' und '''.LTK''') . +++ '''extract_kyra''' Entpackt '''.pak'''-Dateien aus den Kyrandia-Spielen und Installationspaketdateien aus der DOS-Diskettenversion von Hand of Fate. Es sollten alle zu verarbeitenden Dateien im Ordner voliegen. Weitere Argumente ,üssen übergeben werden. Der Befehl ``./scummvm-tools-cli --help extract_kyra`` hilft hierbei. ``./scummvm-tools-cli --tool extract_kyra -x [-o Ausgabeverzeichnis] `` +++ '''pack_cge''' Packt die Soltys- und Sfinx-Spieledatendateien ``./scummvm-tools-cli --tool pack_cge [-o Ausgabeverzeichnis] `` }}} Weitere Möglichkeiten um Daten zu extrahieren sind im Wiki von [https://wiki.scummvm.org/index.php/User_Manual/Appendix:_Tools#Extraction_Tools scummvm.org] {en} zu finden. {{{#!vorlage Hinweis Bevor man am Originalspieleordner Veränderungen vornimmt sollte man lieber eine Kopie des Ordners anlegen. }}} = Werkzeuge = == pack_bladerunner == Dieses Werkzeug kann verwendet werden um die vier '''CDFRAMES.DAT'''-Dateien, welche von den vier Blade Runner CDs stammen, in eine einzelne '''HDFRAMES.DAT'''-Datei zu konvertieren. Diese wird anstelle der Ursprungsdateien in das Spieleverzeichnis kopiert. Über das Terminal [4] kann der Prozess eingeleitet werden. Die Syntax sieht wie folgt aus: {{{#!vorlage Befehl ./scummvm-tools-cli --tool pack_bladerunner /CDFRAMES1.DAT }}} {{{#!vorlage Hinweis ```` ist der Dateipfad, welcher die '''CDFRAMES.DAT'''-Dateien der CDs, welche im Vorfeld zu '''CDFRAMES1.DAT''', '''CDFRAMES2.DAT''', '''CDFRAMES3.DAT''' und '''CDFRAMES4.DAT''' umbenannt worden sind }}} Der Aufruf aus dem Verzeichnis heraus: {{{#!vorlage Befehl ./scummvm-tools-cli --tool pack_bladerunner CDFRAMES1.DAT }}} {{{ Warning: Could not find file CDFRAMES Warning: Retrying for file CDFRAMES1 Reading 536 pages from CDFRAMES1.DAT... Reading 1789 pages from CDFRAMES2.DAT... Reading 1691 pages from CDFRAMES3.DAT... Reading 1332 pages from CDFRAMES4.DAT... All done! File is created in ./HDFRAMES.DAT }}} == Skriptwerkzeuge == Um Skripte in Spielen zu analysieren bringt die Sammlung die folgenden Werkzeuge mit: {{{#!vorlage Tabelle Skriptwerkzeuge +++ Werkzeug Beschreibung +++ '''decine''' Dekompiliert [wikipedia:Delphine_Software_International:Delphine's Cinematique]-Skripte der Engine (u.a. Future Wars und Operation Stealth). +++ '''degob''' Verarbeitet '''.TOT'''-Skripte, welche in Titeln aus dem Hause [wikipedia_en:Coktel_Vision:Coktel Vision], Verwendung finden (z.B. Gobliiins oder Lost in Time). +++ '''dekyra''' Grundlegender Skript-Disassembler für Legend of Kyrandia-Spiele +++ '''descumm''' Dekompiliert SCUMM-Scripte. +++ '''desword2''' Zerlegt die Skripte von Baphomets Fluch 2: Die Spiegel der Finsternis (engl. Originaltitel: Broken Sword 2: The Smoking Mirror) }}} Bei Bedarf können weitere Informationen in der [:man:Manpage] oder der Programmhilfe nachgelesen werden [4]: {{{#!vorlage Befehl decine -h USAGE: decine [type] [version] [filename] type: -prc or -rel (Use -prc for *.prc-files, -rel for *.rel-files) version: -v1 or -v2 (Use -v1 for Future Wars, -v2 for Operation Stealth) filename: The name of the script file to decode }}} = Sonstiges = == Dateinamen == Mitunter ist es nötig, dass die Dateinamen des ein oder anderen Spiels bestimmte Vorgaben hinsichtlich der Gross-/Kleinschreibung erfüllen müssen. Mit den folgenden Befehlen lassen sich diese mühelos im Terminal [4] umbenennen: {{{#!vorlage Befehl for i in *; do mv $i `echo $i | tr [:upper:] [:lower:]`; done #Alle Dateinamen werden klein geschrieben. for i in *; do mv $i `echo $i | tr [:lower:] [:upper:]`; done #Alle Dateinamen werden GROSS geschrieben. }}} = Links = * [http://wiki.scummvm.org/index.php/User_Manual/Appendix:_Tools Handbuch] {en} # tag: Emulation und Virtualisierung, Spiele, ScummVM