
------------------------------------------------------------------------------
   Blitz Media-Linker V1.9 - (W) 2005-2006 by Harald Wagner (AL90@Lycos.de)
------------------------------------------------------------------------------
                             www.blitztools.de.vu
------------------------------------------------------------------------------


Einleitung:
-----------

Blitz Media-Linker ist ein Wizard gesteuertes Programm mit dem man Stand-Alone-Executables
(Single Executables) von seinen Blitz-Programmen erstellen kann. D.H. es werden alle Media-
Files mit der Executablen Datei verbunden. Im gegensatz zum umfangreicheren BBCruncher
ist dabei keinerlei Umprogrammierung und/oder integration der ExtractEngines, wie es beim
BBCruncher der fall ist, ntig. Somit ist der Blitz Media-Linker auch fr Einsteiger bestens
geeignet, da vorhandene Blitz-Quellcodes so bernommen werden knnen wie sie sind.
Ein Wizard (GUI) fhrt Sie dabei Schritt-fr-Schritt durch die Installation.


Kurzanleitung:
--------------

Volgende Schritte und Einstellungen werden dabei vorgenommen.:

1) Whlen Sie einen Blitz-Quellcode aus, aus dem Sie eine Single-Executable erstellen
   mchten. (Der Quellcode sollte dabei einen Finalen Status haben)

2) Whlen Sie einen Dateinamen unter dem die Executable Datei gespeichert werden soll.

3) Whlen Sie nun alle Media-Daten die fr Ihr Project erforderlich sind. (PICs, SNDs u.s.w.)
   (Vergessen Sie dabei keine Datei, da die Finale-Exe sonst abstrtzen knnte)

4) Whlen Sie hier den Kompressionsgrad fr Ihre Media-Dateien oder bernehmen Sie sie
   ohne Kompression.

5) Abschliessend whlen Sie noch den Pfad unter dem Sie BlitzBasic, Blitz3D oder BlitzPlus
   Installiert haben, damit der Compiler den Quellcode auch vorher noch Compilieren kann.

6) Fertig! - Ihre Single-Executable ist nun sofort ausfhrbar, ohne das weiterhin externe
   Dateien bentigt werden.


Features:
---------

- Wizard Steuerung und Schritt-fr-Schritt Installation.
- Durch die einfachheit auch fr Einsteiger sehr leicht zu bedienen.
- Basierend auf der bekannten CrunchEngine des BBCrunchers.
- Untersttzt die ExtractEngines des BBCrunchers. (optional - wenn im Sourcecode vorhanden)
- Keinerlei Um/Programmierung oder sonstige anpassungen am Sourcecode notwendig.


Was man beachten sollte:
------------------------

Benutzen Sie niemals irgendwelche abfragen in Ihrem Code, die Dateien auf ihre Existenz
berprfen wie zum beispiel:

If Filesize(File$)>0 Then b=LoadBuffer(buffer,File$)

Schreiben Sie stattdessen den Befehl direkt hin wie zum beispiel:

b=LoadBuffer(buffer,File$)

Wenn Sie eine Single-Exe erstellen und sicher sind, das Sie alle Dateien mit einbezogen
haben, dann wird die Single-Exe diese Dateien ohnehin finden. Separate abfragen
sind damit nicht nur berflssig, sondern werden Ihre Exe-Datei mit sicherheit zum
absturtz bringen, oder zumindest eine Warnmeldung ausgeben. (Kme natrlich darauf an
welche sicherheitsabfragen Sie eingebunden haben.)


Wie kann Ich UPX verwenden ?
----------------------------

Kopieren Sie einfach die UPX.EXE in Ihr Blitz Media-Linker Verzeichnis um
UPX zu benutzen. UPX kann unter folgende Web-URL heruntergeladen werden:

http://upx.sourceforge.net/


Die Entwicklungsgeschichte:
---------------------------

V1.0 - Erste Verffentlichung.

V1.1 - Rekursives Including wird nun untersttzt.
     - Einige Routinen berarbeitet.

V1.2 - Fixed: Picture Erkennung in einigen .b3d-Files

V1.3 - Hinzugefgt: Bentigten Pfade werden nun in einer ConfigDatei gespeichert.
     - Hinzugefgt: Eine neue option ("AddPath") ist hinzugekommen.  
     - Hinzugefgt: Der Anwender kann nun zwichen einem Split-Project (Exe + Archive)
                    oder Single-Exe whlen, wenn das Project grsser als 10 MB ist.

V1.4 - Fixed: Multitasking problem whrend des Crunchens.
     - Einiges berarbeitet.

V1.5 - Komprimierung wurde um einiges beschleunigt.
     - Hinzugefgt: Eine neue Option zum Forcieren einer Compilation mit BlitzPlus.
     - Einige Fixes.

V1.6 - Komprimierung wurde um einiges beschleunigt.
     - Hinzugefgt: UPX-Untersttzung. (Nicht im Archiv enthalten!)
     - Es kann nun immer zwichen einer Single-Exe und einem Split-Project gewhlt werden.
     - ReadFile() wird nun untersttzt und somit kann nun auch auf Dateien innerhalb
       eines Archives zugegriffen werden.
     - Projekt-Files knnen nun gespeichert und geladen werden.
     - Einige Fixes.

V1.7 - Eine abfrage auf "Aktuelles Project beenden" wurde hinzugefgt.
     - Bessere stabilitt unter Windows 98 wenn BML von einer Verknpfung gestartet wird.
     - Einige Fixes.

V1.8 - Leerzeichen vor Include-Anweisungen sind nun erlaubt.
     - Das Processfenster kann nun nicht mehr in den Hintergrund geklickt werden.
     - Einige Fixes.

V1.9 - Hinzugefgt: Untersttzung fr DDS-Files.
     - Neues Feature: Wenn eine Datei in der FinalExe nicht existiert, wird diese extern geladen.
     - Einige Fixes.
