﻿Fate-REX (Fate - Resource EXtractor):
Mit Fate-REX lassen sich (fast) alle Ressourcen(Bilder, Sprites, Sounds, Fate-Thema) aus dem Spiel 'Fate - Gates of Dawn' extrahieren.
Animationen lassen sich derzeit noch nicht extrahieren, da das Dateiformat und der Algorithmus noch unbekannt sind.



Benötigt:
Dieses Programm benötigt das Spiel: 'Fate - Gates of Dawn' (egal welche Master-Version).
Es muss allerdings die HD-installierte Version sein (Disketten-Versionen oder WHD-Load Versionen funktionieren NICHT!)
Download: 
- v1.4 (Deutsch)  : https://www.mightandmagicworld.de/filebase/fate_1_game-f196/index.html#
- v1.6 (Englisch) : https://www.mightandmagicworld.de/phpbb/ftopic24741.html



Abhängigkeiten:
Das Programm 'Fate-REX' ist ein so genanntes 'Stand-alone executable'. D.h. es werden zur Ausführung keine zusätzlichen Laufzeitbibliotheken (z.B. VisualBasic, VisualC) oder Frameworks (z.B. JavaSE oder DotNet) benötigt.
Zum Abspielen von Soundeffekten und des Fate-Themas, wird allerdings DirectX 9 benötigt (Das Programm selbst funktioniert aber auch ohne DirectX 9).



Systeme:
Getestet:	Windows XP(x86), Windows 7(x64), Windows 10(x32, x64)
Ungetestet:	Windows Vista, Windows 8



Installation:
Zur installation einfach einen beliebigen Ordner erstellen und alle Dateien aus dem Archiv dort hinein kopieren.
Beim ersten Start des Programms 'Fate-REX', wird im Benutzerverzeichnis:

WinXP: 'C:\Dokumente und Einstellungen\BENUTZERNAME\Anwendungsdaten' 
Win7+: 'C:\Benutzer\BENUTZERNAME\AppData\Roaming'

ein Ordner mit dem Namen 'FateRex' erstellt. In diesem Ordner wird die Initialisierungsdatei 'fate_rex.ini' erstellt. Diese Datei enthält die Programmeinstellungen.


Dieses Vorgehen hat folgende Vorteile:
- Es werden keine Administrator-Rechte benötigt um das Programm auszuführen.
- Es werden keine Änderungen an der Registrierungsdatenbank (Registry) vorgenommen.

Aber auch Nachteile:
- Die Programmdateien müssen bei der 'Deinstallation' manuell entfernt werden (außer fate_rex.ini).
- Es wird kein Eintrag im Startmenü erstellt
- Es wird keine Verknüpfung auf dem Desktop angelegt



Bedienungsanleitung:
Intro->Suchen
Die Schaltfläche 'Suchen' öffnet den Verzeichnis-Requester. Hier muss der Ordner angegeben werden, in dem sich das Spiel 'Fate - Gates of Dawn' befindet.
Dieser Ordner hat in der Download-Version aus dem obigen Link, den Namen 'GatesOfDawn' und beinhaltet die Ordner '0' bis 'x'.
Nachdem der richtige Ordner ausgewählt wurde, startet der Import-Prozess automatisch.
Info: In den deutschen Versionen (1.4 & 1.7), gibt es 4 Bilder weniger, als in der englischen Version. Beim Import werden diese 4 Bilder als 'Nicht geladen' angezeigt.

Sonstige->Weltkarte: Die Daten für die Weltkarte sind in 160 Dateien gespeichert. Um nicht bei jedem Programmstart die ganzen Dateien laden zu müssen, hebe ich mich dazu entschlossen, es dem Benutzer zu überlassen, ob und wann die Weltkarte geladen werden soll.

Export Palette::
Hierbei wird die Palette des aktuell ausgewählten Bildes im 256 Farben 'JASC-Format' gespeichert.

Bilder->Speichern::
Hierbei wird das aktuell ausgewählte Bild, in der Originalgröße, im Bitmap-Format gespeichert.

Bilder->Clipboard::
Hierbei wird das aktuell ausgewählte Bild, in der Originalgröße, in den Zwischenspeicher kopiert.
Vom Zwischenspeicher kann es dann in Grafikprogramme (z.B. IrfanView, Paint, Gimp, etc.) eingefügt werden.
Achtung: 
- Funktioniert nicht mit 'Windows-Store Apps'!
- IrfanView: IrfanView hat ein Problem mit dem Einfügen von 8Bit-Bildern, was dazu führt, dass das Bild "auf dem Kopf steht". Abhilfe: Einfach die Taste 'v' drücken und das Bild wird richtig herum angezeigt.

Sounds speichern:
Hierbei wird der aktuell ausgewählte Sound im Wave-Format gespeichert.

Thema speichern:
Hierbei wird das Fate-Thema im Mod-Format gespeichert.

Optionen->Bilder Clipboard::
Hier kann man einstellen, in welchem Bit-Format die Bilder in den Zwischenspeicher kopiert werden.
8Bit -> 256 Farben, 24Bit -> 16.7 Mio. Farben.

Optionen->Bilder Speichern::
Hier kann man einstellen, in welchem Bit-Format die Bilder gespeichert werden.
Diese Einstellung gilt auch für den 'Bulk-Export'!
8Bit -> 256 Farben, 24Bit -> 16.7 Mio. Farben.

Optionen->Bulk-Export::
Mit dem 'Bulk-Export', lassen sich alle Bilder/Sounds der ausgewählten Kategorien auf einmal exportieren.
Die Verzeichnisstruktur wird dabei automatisch angelegt.
Die Schaltfläche 'Verzeichnis' öffnet den Verzeichnis-Requester. Hier sollte man einen leeren Ordner angeben/anlegen, in dem die zu exportierenden Daten gespeichert werden sollen.

Optionen->Deinstallation::
Über die Schaltfläche 'Deinstallieren' wird nur der Ordner 'FateRex', inklusive der Datei 'fate_rex.ini', aus dem Benutzerverzeichnis gelöscht. Die restlichen Dateien müssen manuell entfernt werden.
Achtung: Wenn das Programm nach der 'Deinstallation' wieder gestartet wird, dann wird der Ordner 'FateRex' wieder angelegt.

Tipp:
Da die Einträge in den Auswahlboxen sehr zahlreich sein können, und es etwas mühselig ist jeden Eintrag mit der Maus auszuwählen, kann man der Auswahlbox den Fokus geben (mit der Maus anklicken) und dann mit den Tasten 'Pfeil-Hoch' & 'Pfeil-Runter' durch die Einträge gehen.



Rechtliches:
Fate-REX
Copyright (c) 2018  Dragonfly

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. 

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. 

You should have received a copy of the GNU General Public License along with this program; if not, see <http://www.gnu.org/licenses/>.


Übersetzung:
Dieses Programm ist freie Software. Sie können es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation veröffentlicht, weitergeben und/oder modifizieren, entweder gemäß Version 3 der Lizenz oder (nach Ihrer Option) jeder späteren Version. 

Die Veröffentlichung dieses Programms erfolgt in der Hoffnung, dass es Ihnen von Nutzen sein wird, aber OHNE IRGENDEINE GARANTIE, sogar ohne die implizite Garantie der MARKTREIFE oder der VERWENDBARKEIT FÜR EINEN BESTIMMTEN ZWECK. Details finden Sie in der GNU General Public License. 

Sie sollten ein Exemplar der GNU General Public License zusammen mit diesem Programm erhalten haben. Falls nicht, siehe <http://www.gnu.org/licenses/>.



Drittanbieter:
Die Dateien 'Fate-REX_32.exe' & 'Fate-REX_64.exe' enthalten folgende Bibliothek:

- libmodplug (Public Domain)



Bilder:
Die Bilddatei: 'fate_rex.bmp' wurde von Dragonfly erstellt und ist Public Domain.



Code:
Der Quellcode in der Datei: 'sources/DPI_Aware.pbi' ist ursprünglich Public Domain, wurde von Dragonfly angepasst und ist weiterhin Public Domain.



Vielen Dank für´s lesen!
