===============================================
=== Am Fluss der Zeit / Drakensang - N2Tool ===
===============================================
v1.10 by JOG

N2Tool ist ein Kommandozeilenwerkzeug zum Bearbeiten von N2-Dateien.

Hauptanwendungszweck ist das Retexturieren von Einzelobjekt N2-Dateien (z.B. Waffen)
sowie das Auslesen und Wiedereinbinden einzelner Modell-Eintrge aus N2-Sammeldateien,
(z.B. female.n2 um ein grnes KGIA Hemd zustzlich zum hellblauen erweitern)


N2Tool bietet folgende Funktionen:

- Einzelobjekt-N2-Dateien (z.B. Waffen) sowie extrahierten GfxSkin Eintrge aus Modell-Sammeldateien modifizieren
- GfxSkin Eintrge aus einer N2-Sammeldatei Auslesen und zur Weiterbearbeitung in eine separate Datei speichern
- Whrend dem Auslesen den GfxSkin-Namen und die Texturen (color, bump, spec) ndern.
- Die separierten (und modifizierten) Dateien wieder an die N2-Sammeldateien anhngen.
- GfxSkin Eintrge aus N2-Sammeldateien entfernen.



STANDARDMODUS
--------------------------------------------
N2Tool [options] n2file [target]
--------------------------------------------

Im Standardmodus erwartet N2TOOL nur einen Dateinamen.
Die Wildcards'*' und '?' sind erlaubt, fallen mehrere Dateien in das Suchschema,
werden im Standardmodus nacheinander alle gefundenen Dateien bearbeitet.

Ohne weitere Parameter werden nur die aktuellen Werte angezeigt, dabei unterscheidet N2Tool zwischen N2-Dateien
und den mit dem Kommando "GET" extrahierten GfXSkins die auch einen Header-Namen beinhalten. 

Wenn N2TOOL die Dateistruktur nicht erkennt, oder wenn die Zieldatei grsser als 20 Kilobyte ist,
wird mit einer Fehlermeldung abgebrochen. Enthlt die Datei mehrere Modell-Eintrge, wird nur der erste bearbeitet.

Wurde eine Zieldatei angegeben, wird diese Datei als Kopie der N2-Datei erstellt, und alle nderungen dort durchgefhrt.
Ohne Angabe einer Zieldatei wird stattdessen ein Backup erstellt.


Mit folgenden Optionen kann die N2-Datei modifiziert werden:

 -n:<text>     Den GfXSkin-Namen des Eintrags ndern. (Nur bei zuvor mit "GET" extrahierten GfXSkins mglich.)

 -tc:<color>   Die "Color-Map" (Textur) auf diese Datei setzen. (Pfad ausgehend von export\textures)
 -tb:<bump>    Die "Bump-Map" (Tiefeninfo/3D-Strukturen) auf diese Datei setzen.
 -ts:<spec>    Die "Specular Map" (Reflektion) auf diese dds-Datei setzen.
 -te:<emsv>    Die "Emissive Map" (Glhen/Leuchten) auf diese dds-Datei setzen.

 -#ei:<wert>   Die "Emissive Intensity" (Leuchtkraft der Glowmap) wird auf den angegebenen Gleitkommawert gesetzt.
 -#si:<wert>   Die "Specular Intensity" (Strke der Reflektion) wird auf den angegebenen Gleitkommawert gesetzt.
 -#sp:<wert>   Die "Specular Power" (Fokusierung des Auftreffenden/Reflektierten Lichts) wird gesetzt (Gleitkommawert).
 -#bs:<wert>   Die "Bump Scale" (Verstrkung/Abschwchung des 3D Effekts aus der Bump-Map) wird gesetzt (Gleitkommawert).


Zustzlich gibt es noch zwei Optionen die dem Backup-Handling dienen:

 -b:<text>  Statt ".bak" wird der angegebene Text als Dateiendung fr Backups verwendet
            (z.B. mit "-b:hemd.bak" wird der Name des Backups zu "female.n2.hemd.bak".)
            Ist das erste Zeichen ein Punkt, wird es ignoriert. "-b:.hemd.bak" und "-b:hemd.bak" sind gleichwertig.

 -nb        Es wird kein Backup erstellt.  


Optionen knnen an jede beliebige Stelle im Programmaufruf geschrieben werden. 
Statt des Doppelpunkts (:) kann nach Belieben auch ein Gleichheitszeichen (=) verwendet werden.
Die Gleitkommawerte knnen mit Dezimalpunkt oder Komma angegeben werden. 




KOMMANDOS
=========

Im Standardmodus knnen nur Einzelmodell Dateien (z.B. Waffen) bearbeitet werden.

Um Modell-Sammlungen (z.B. Kleidung, Gesichter) zu bearbeiten, werden die Kommandos GET (Auslesen),
ADD (Einfgen), MOD (Auslesen, Modifizieren und Einfgen) und DEL (Lschen) verwendet.

Diese Befehle knnen wie Optionen an beliebiger Stelle im Programmaufruf angegeben werden.

Die Wildcards'*' und '?' sind auch hier fr den Dateinamen erlaubt, fallen allerdings mehrere
Dateien in das Suchschema, wird hier nur die erste gefundene Datei bearbeitet.



GET - Auslesen
--------------------------------------------
N2Tool [options] GET n2file GfxSkin [target]
--------------------------------------------
Liest einen einzelnen GfxSkin-Eintrag aus einer Sammelmodell-Datei aus.

 n2file    Die N2-Datei (z.B. "female_n2") aus der ausgelesen wird.
 GfxSkin   Der Name des Eintrags der ausgelesen werden soll (Die "GfxSkin" aus der Datenbank)
 target    (Optional) Die Zieldatei in die gespeichert werden soll 
           Wird keine Datei angegeben, wird der Name aus "GfxSkin" (z.B. "torso_cl_hemd_dieb.itm")

 Optionen:

 -n:<text>     Den GfXSkin-Namen des Eintrags ndern, und somit einen neuen erstellen.

 -tc:<color>   Die "Color-Map" (Textur) des Eintrags auf diese Datei setzen. (Pfad ausgehend von export\textures)
 -tb:<bump>    Die "Bump-Map" (Tiefeninfo/3D-Strukturen) des Eintrags auf diese Datei setzen.
 -ts:<spec>    Die "Specular Map" (Reflektion) auf diese dds-Datei setzen.
 -te:<emsv>    Die "Emissive Map" (Glhen/Leuchten) auf diese dds-Datei setzen.

 -#ei:<wert>   Die "Emissive Intensity" (Leuchtkraft der Glowmap) wird auf den angegebenen Gleitkommawert gesetzt.
 -#si:<wert>   Die "Specular Intensity" (Strke der Reflektion) wird auf den angegebenen Gleitkommawert gesetzt.
 -#sp:<wert>   Die "Specular Power" (Fokusierung des Auftreffenden/Reflektierten Lichts) wird gesetzt (Gleitkommawert).
 -#bs:<wert>   Die "Bump Scale" (Verstrkung/Abschwchung des 3D Effekts aus der Bump-Map) wird gesetzt (Gleitkommawert).

 -a[:<target>] Die Zieldatei wird nicht berschrieben sondern um die ausgelesenen Daten erweitert

Der Parameter -a ist ntzlich, um eine Datei zu erstellen die mehrere genderte Eintrge enthlt die alle mit
einem einzelnen ADD Befehl eingelesen werden. (Somit wird die N2-Datei nur einmal modifiziert, und es wird nur ein Backup erstellt)
Der Name der Zieldatei kann auch hier angegeben werden. Da der Standardname dem GfxSkin-Namen entspricht, ist es beim Benutzen
des Parameters -a sinnvoll, eine Zieldatei anzugeben, wenn aus verschiedenen N2-Dateien ausgelesen wird (z.b. male.n2 und female.n2)

Eine Nachbearbeitung im Standardmodus ist bei einer solchen Datei nicht mehr mglich (es kann nur der erste Eintrag gendert werden)




ADD - Einfgen
----------------------------------------------
N2Tool [options] ADD n2file ADDinFile [target]
----------------------------------------------
Baut einen zuvor ausgelesenen GfxSkin-Eintrag wieder in die Sammeldatei ein. 

 n2file    Die N2-Datei (z.B. "female_n2") die modifiziert wird.
 ADDinFile Die Datei mit den einzufgenden Daten (zuvor mit GET extrahiert und ggfs. modifiziert) 
 target    (Optional) Statt in das n2file wird das Resultat in diese alternative Zieldatei gespeichert  

 Optionen:

 -b:<text>  Statt ".bak" wird der angegebene Text als Dateiendung fr Backups verwendet
            (z.B. mit "-b:hemd.bak" wird der Name des Backups zu "female.n2.hemd.bak".)
            Ist das erste Zeichen ein Punkt, wird es ignoriert. "-b:.hemd.bak" und "-b:hemd.bak" sind gleichwertig.

 -nb        Es wird kein Backup erstellt.  




MOD - Auslesen und Einfgen
------------------------------------------------
N2Tool [options] MOD n2file GfxSkin [target]
------------------------------------------------
Die Daten werden aus der N2-Datei ausgelesen, und direkt wieder hinten angehngt. 
Diese Funktion macht nur Sinn wenn gleichzeitig auch nderungen vorgenommen werden.

 n2file    Die N2-Datei (z.B. "female_n2") aus der ausgelesen wird.
 GfxSkin   Die Datei mit den einzufgenden Daten (zuvor mit GET extrahiert und ggfs. modifiziert) 
 target    Die Temporre Zieldatei fr die extrahierten Daten. Wird am Ende gelscht.    

Alle fr GET und ADD beschriebenen Optionen sind hier gltig. Beim Benutzen des Parameters -a und Angabe einer
bereits existierenden "Zieldatei" wird diese um die auszulesenden Daten erweitert, anschliessend eingelesen und gelscht. 




DEL - Lschen
----------------------------------------------
N2Tool [options] DEL n2file GfxSkin [target]
----------------------------------------------
Entfernt einen Eintrag aus einer Sammeldatei

 n2file    Die N2-Datei (z.B. "female_n2") die modifiziert wird.
 GfxSkin   Der Name (GfxSkin) des Eintrags der entfernt werden soll
 target    (Optional) Statt in das n2file wird das Resultat in diese alternative Zieldatei gespeichert  

 Optionen 

 -b:<text>  Den angegebenen Text als Dateiendung fr Backups verwenden
 -nb        Kein Backup erstellen




Beispiele:
==========

Auslesen der GfxSkin "torso_cl_hemd_dieb" zur Weiterbearbeitung im standerd-Modus oder per Hex-Editor 
> N2Tool GET female.n2 torso_cl_hemd_dieb  


Auslesen der GfxSkin "torso_cl_hemd_dieb" mit nderung des GfxSkin-Namens und der Textur
> N2Tool GET female.n2 torso_cl_hemd_dieb -n:neues_hemd -tc:mein_mod\neues_hemd.dds


Einlesen der soeben erstellten Datei damit das Hemd im Spiel benutzt werden kann
> N2Tool ADD female.n2 torso_cl_hemd_dieb.itm

 
Auslesen und modifizieren wie oben, nur unter Verwendung eines bestimmten Dateinamens 
> N2Tool GET female.n2 torso_cl_hemd_dieb mein_mod.itm -n:neues_hemd  -tc:mein_mod\neues_hemd.dds


Anhngen einer zweiten Modifikation an die soeben erstellte Datei 
> N2Tool GET female.n2 torso_cl_hemd_dieb -a:mein_mod.itm -n:second_hand_hemd  -tc:mein_mod\gebrauchtes_hemd.dds


Einlesen der Datei mit den beiden Hemden
> N2Tool ADD female.n2 mein_mod.itm


Alternativ: Anhngen einer dritten Variante und anschliessendes Einlesen.
> N2Tool MOD female.n2 torso_cl_hemd_dieb -a:mein_mod.itm -n:dreckshemd  -tc:mein_mod\verschmutztes_hemd.dds


Deinstallieren eines der drei soeben installierten Hemden
> N2Tool DEL female.n2 second_hand_hemd



Auslesen der GfxSkin "torso_cl_hemd_dieb" setzen einer Glowmap mit starker Leuchtkraft  
> N2Tool GET female.n2 torso_cl_hemd_dieb -n:leucht_hemd -te:mein_mod\leucht_hemd_emissive.dds -#ei:3.14159265

Ansehen der aktuellen Werte in der soeben erstellten Datei
> N2Tool torso_cl_hemd_dieb.itm

Reduzieren der Leuchtkraft und umbenennen zu "hemd_mit_leuchtstickerei"
> N2Tool torso_cl_hemd_dieb.itm -#ei:1.23456 -n:hemd_mit_leuchtstickerei


--------------------------------------------------------------------------------------------
SONSTIGES
--------------------------------------------------------------------------------------------

N2Tool ist ein KOMMANDOZEILEN-Programm, es im Explorer per Doppelklick zu starten bringt rein gar nichts.

Fr Kommandozeilenhasser und als Vorlage zur Modinstallation ist die beiliegende "N2tool_demo.bat" gedacht. 
Diese Datei zusammen mit N2Tool.exe in dasselbe Verzeichnis wie die zu ndernde N2-Datei kopieren,
Die "SET" Eintrge entsprechend ndern, und die Batchdatei starten.

set oldname=  Der GfxSkin-Name des originalen Modells
set newname=  Der neue GfxSkin-Name 
set color=    Die Textur (Pfadangabe ausgehend von export\textures)
set bump=     Bump-Map
set spec=     Spec-Map


--------------------------------------------------------------------------------------------
CREDITS
--------------------------------------------------------------------------------------------
Gerald - Auf dessen Nachforschungen dieses Tool basiert.


--------------------------------------------------------------------------------------------
VERSIONEN
--------------------------------------------------------------------------------------------

v1.00   (27.04.10) 
        
v1.10   (08.05.10) 
        - Retexturing Optionen um "emissive-map" erweitert
        - Funktionen zum Setzen der Emissive Intensity, Specular Intensity, Specular Power, und Bump Scale
        - Neuen Standardmodus zum Bearbeiten von Einzelobjekt-N2-Dateien (z.B. Waffen)
          oder bereits extrahierten GfxSkin-Dateien. 
