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


Introduction:
-------------

Blitz Media-Linker is a Wizard-Controlled Program with it you can Create Stand-Alone-
Executables (Single Executables) of your own Blitz-Programs. So you can add all Media-
Files to your Executable File and Create it as Stand-Alone (Single) File. So you must
not rewrite, change or add the ExtractEngine (like in BBCruncher) in your Blitz-
Sourcecode, but can accept the Sourcecode directly in Blitz Media-Linker when the
Sourcecode has a Final-State. Therefore is this Tool not only usable for Advanced
Users, but also good for Beginners. A Wizard (GUI) will you help with the Installation
in Step-by-Step.


Instruction:
------------

Following Steps are required before the Single-Executable will be Created.:

1) Select a Blitz-Sourcecode to create it as Single-Executable File.
   (This Sourcecode must be in a Final-State)

2) Select a Filename to Save your Single-Executable File.

3) Choose now all your Media-Files thats required in your Project. (PICs, Sounds and so on.)
   (Don't forget a File, otherwise your Single-Executable File can be Crash)

4) Select a Compression-Level for your Media-Files or choose "None" for No Compression.

5) Now you must choose the Path where you have BlitzBasic, Blitz3D or BlitzPlus Installed.
   (Required for Compiling the Final-Sourcecode)

6) Done! - Your Single-Executable can now run without External-Files.


Features:
---------

- Wizard-Controlled and Step-by-Step Installation.
- Easy Controlling, so also good usable for Beginners.
- Based on the known CrunchEngine of BBCruncher.
- Supports the ExtractEngines of BBCruncher. (optional - If available in Sourcecode)
- No rewrite or changes on Final-Sourcecode required.


Important - Please Note this:
-----------------------------

Use not any routines for check the exists of a MediaFile like.:

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

Type it only directly in Your Source. For Example:

b=LoadBuffer(buffer,File$)

If you have created a Single-Exe and not forget any Files to add, then will the Final-Exe
find these Files ever. A separate check-routine is also NOT required. Otherwise your
Final Single-Exe will be crash or give you a alert thats the File is not found.
(e.g. AlertMessages from the own check-routine.)


How I can use UPX ?
-------------------

Copy UPX.EXE into your Blitz Media-Linker drawer for use. UPX can be found
here: http://upx.sourceforge.net/


History:
--------

V1.0 - First Release.

V1.1 - Added Recursive Including Support.
     - Some Routines changed.

V1.2 - Fixed: Picture Recognization in some .b3d-Files

V1.3 - Added: All required Paths will now save in a ConfigFile.
     - Added: Include a new option "AddPath".  
     - Added: User can now select to a Split-Project (Exe + Archive)
              or Single-Exe when a Project is bigger than 10 MB.

V1.4 - Fixed: Multitasking problems in Crunch Process.
     - Some Changes.

V1.5 - Some SpeedUp in Data-Compression.
     - Added: A new option to force a BlitzPlus Compilation for better compatibly.
     - Some Fixes.

V1.6 - Some SpeedUp in Data-Compression.
     - Added: UPX-Support. (Not available in Archive!)
     - It can always be chosen between a Single-Exe and a Split-Project now.
     - ReadFile() is supported now and therefore can be accessed files within an archive now.
     - Project-Files can now Load/Save.
     - Some Fixes.

V1.7 - Added the Dialog "Are you sure to Close Current Project".
     - More stability under Windows 98 if BML is started from a Shortcut.
     - Some Fixes.

V1.8 - Whitespaces before Include-Instructions are now allowed.
     - Processwindow can now no longer clicked in background.
     - Some Fixes.

V1.9 - Added: Support for DDS-Files.
     - New Feature: When a File is unavailable in FinalExe, it will be now loaded externally.
     - Some Fixes.
