
 ********************
 *                  *
 *    BmpToRaw 3    *
 *                  *
 * Von Malte Linder *
 *                  *
 ********************

BmpToRaw ist ein Programm, das die Konvertierung eines Windows-Bitmaps in ein RAW Bitmap fr Logos und Himmelsgrafiken fr den Tomb Raider Level Editor erleichtert.


Was ist neu in Version 2
------------------------
- Untersttzung von Himmelsgrafiken
- Integrierter RAWViewer zur Anzeige von RAW Dateien mit Logos oder Himmelsgrafiken
- Meldungen und Mens in englischen oder deutschen Texten


Was ist neu in Version 3
------------------------
- PAK Format Untersttzung fr Logos
- Transparenzumschaltung wirkt sich auch auf geladene Logos aus
- Hintergrundgrafik bei Transparenz
- Durchschnittsfarbe eines Bildes ermittelbar
- Integrierter PAKViewer zur Anzeige von PAK Dateien mit Logos

Version 3 ist die letzte Version von BmpToRaw.


Installation
------------
Kopiere die Dateien BmpToRaw.exe, TransPic.raw und zlib.dll einfach in einen beliebigen Ordner. Einfach auf das Programm doppelklicken, um es zu starten. Du kannst auch eine Verknpfung auf dem Desktop oder im Startmen anlegen. Das Programm trgt weder Zeilen in die Registry ein, noch erzeugt es unbemerkt irgendwelche Dateien. TransPic.raw enthlt das Hintergrundbild bei Transparenz. Wenn die Datei nicht verhanden ist, verwendet das Programm kein Transparenzbitmap.
Um das Programm zu deinstallieren, reicht es, diese Dateien wieder zu lschen.


Bedienung
---------
1) Erstelle ein Windows-Bitmap fr ein Logo (512 Pixel * 256 Pixel, schwarz ist im Spielmen transparent) oder eine Himmelsgrafik (256 Pixel * 256 Pixel). Speichere das Bild als Windows-Bitmap (*.bmp) mit 24 Bit Farbtiefe.
2) Starte BmpToRaw.
3) Klicke auf Datei|BMP ffnen. ffne im erscheinenden Dialog dein Bitmap aus Punkt 1.
4) Klicke auf Datei|RAW speichern (Logos und Himmelsgrafiken) oder Datei|PAK speichern (Logos). Im Speichern-Dialog kannst du den Ordner und den Dateinamen des RAW beziehungsweise PAK Bildes angeben.
5) Klicke auf Datei|Beenden. Falls du noch mehr Bilder umwandeln willst, kannst du wie ab Punkt 3 beschrieben weitere Bilder ffnen und als RAW oder PAK speichern.

Die Einstellungen des RAW oder PAK Bildes werden automatisch vom Programm getroffen, sodass du die Datei sofort benutzen kannst. Um das Bitmap jedoch ins Spiel zu integrieren, musst du noch folgendes machen:

Logo:
Konvertiere die RAW Datei mit dem Tomb Raider Level Editor Tool PACKER.EXE oder speichere sie direkt mit BmpToRaw als PAK Datei und schiebe die PAK Datei (sie muss UKLOGO.PAK heien) in den Ordner mit den TR4 Dateien.

Himmelsgrafik:
Verschiebe die RAW Datei in den WAD Ordner und gebe ihr den Namen des WAD. Konvertiere dann dein Level. Je nach Himmelsgrafik muss die Zeile "Layer1=R,G,B,Geschwindigkeit" im Script bearbeitet werden, um den Himmel richtig darzustellen.


Einstellungen
-------------
Achtung: Deine Einstellungen werden nicht gespeichert. Das Programm startet immer mit den Standardeinstellungen.

1) Transparenz
Wenn diese Einstellung aktiviert ist (Standard), wird beim Anzeigen eines Logos schwarz transparent angezeigt, um zu zeigen, welche Teile des Bildes im Spielmen transparent sind. Dies bezieht sich nur auf die Anzeige. Schwarze Pixel aus dem Bitmap werden auch als schwarze Pixel in die RAW beziehungsweise PAK Datei geschrieben. Wenn die Funktion deaktiviert ist, werden schwarze Pixel auch schwarz angezeigt. Wenn das Programm beim Start die Datei TransPic.raw ffnen kann, wird dieses Bitmap als Hintergrund dargestellt, ansonsten ist der Hintergrund wei. Du kannst auch den Hintergrund ndern, indem du TransPic.raw durch ein beliebiges anderes Logo im RAW Format ersetzt.

2) Deutsch, Englisch
Hier kann die Sprache eingestellt werden, in der alle Texte des Programms ausgegeben werden.


Extras
------
Hier findest du zustzliche Funktionen.

1) RAWViewer
Mit diesem Extra kannst du eine RAW Datei mit einem Logo oder einer Himmelsgrafik betrachten, die Bearbeitung ist nicht mglich. Es werden nur Logos und Himmelsgrafiken untersttzt.

2) PAKViewer
Prinzip wie der RAWViewer. Allerdings zeigt dieser Viewer PAK Logos an.

3) Durchschnittsfarbe
Diese Funktion ermittelt die Durchschnittsfarbe des geladenen Bildes. Bei Logos zhlen transparente Teile nicht als Teil des Bitmaps. Das Ergebnis ist eventuell fr die RGB Werte einer Himmelsgrafik im Script interressant.


Fehler
------
Whrend der Arbeit mit BmpToRaw knnen Fehler auftreten. Das Programm informiert dich mit einer Fehlermeldung.

"Die Bildschirmauflsung ist fr das Fenster zu gering."
Das Fenster passt nicht auf den Bildschirm, weil die Auflsung des Monitors zu gering ist. Stelle in der Systemsteuerung eine hhere Auflsung ein.

"Es konnte nicht gengend Arbeitsspeicher angefordert werden."
Starte Windows neu und versuche es noch einmal!

"ZLIB.DLL konnte nicht geffnet werden."
BmpToRaw 3 braucht die Datei ZLIB.DLL, um PAK Bilder zu speichern oder zu ffnen. Die Datei muss sich im Verzeichnis von BmpToRaw.exe befinden.

"ZLIB.DLL - Funktionen wurden nicht gefunden."
Bei der Datei ZLIB.DLL im Programmverzeichnis muss es sich um die mitgelieferte Datei ZLIB.DLL handeln.

"Die Datei konnte nicht geffnet werden."
Tritt entweder beim ffnen beziehungsweise Speichern einer BMP, RAW oder PAK Datei auf.
BMP/RAW/PAK ffnen: Starte den Computer neu und versuche es noch einmal.
RAW/PAK speichern: Hier kann es mehrere Ursachen geben. Wenn du eine bereits bestehende Datei berschreiben wolltest, tritt dieser Fehler auf, wenn die Datei schreibgeschtzt ist. Falls du eine neue Datei anlegen wolltest, kann es sein, dass entweder kein freier Speicherplatz mehr auf dem Datentrger vorhanden ist oder der Datentrger schreibgeschtzt ist.

"In die Datei konnte nicht geschrieben werden."
Eventuell ist der Speicherplatz ausgegangen. Die Datei wurde nicht vollstndig geschrieben und ist defekt. Wenn der Speicherplatz zu klein ist (384 Kilobyte fr eine RAW Datei mit Logo, 192 Kilobyte fr eine RAW Datei mit Himmelsgrafik, maximal 393626 Bytes fr eine PAK Datei mit Logo), musst du genug Speicherplatz auf dem Datentrger freigeben. Versuche dann, die defekte Datei durch ein erneutes Speichern zu berschreiben.

"Aus der Datei konnte nicht gelesen werden."
Starte den Rechner neu und versuche es erneut!

"Die Datei konnte nicht geschlossen werden."
Die RAW oder PAK Datei muss nicht unbedingt fehlerhaft sein. Teste sie einfach! Falls sie tatschlich Fehler enthlt, erstelle die Datei einfach neu!

"Das Bitmap hat keine korrekte Gre."
Stelle in deinem Bitmap die richtige Gre ein (512 Pixel * 256 Pixel fr Logos, 256 Pixel * 256 Pixel fr Himmelsgrafiken)!

"Die Farbtiefe des Bitmaps muss 24 Bit betragen (RGB)."
Speichere dein Bitmap in der korrekten Farbtiefe (24 Bit, RGB)!

"Die Datei enthlt kein untersttztes Format."
Der RAWViewer kann nur RAW Dateien mit einem korrekten Logo oder einer Himmelsgrafik ffnen.
Der PAKViewer untersttzt nur korrekte PAK Logos.

"Die Daten konnten nicht dekomprimiert werden."
Bei der PAK Datei muss es sich um ein gepacktes Logo im Tomb Raider Level Editor Format handeln.


Besonderen Dank an
------------------
- Timm fr die groartige Hilfe bei der Entwicklung.
- die Leute aus dem EIDOS Forum fr die Hilfe bei vielen Problemen.


Info
----
BmpToRaw 3

Programmierung:
Malte Linder
maltelinder@thelindercompany.de

Website:
www.thelindercompany.de