Installation Instructions for Multimedia Tools
-----------------------------------------------

!!! Make sure you have downloaded the right version:

- MMTOOL2.EXE : Delphi 2.0
- MMTOOL3.EXE : Delphi 3.0
- MMTOOL4.EXE : Delphi 4.0
- MMTOOL5.EXE : Delphi 5.0
- MMTOOL6.EXE : Delphi 6.0
- MMTOOL7.EXE : Delphi 7.0

- MMTOOLC1.EXE: C++ Builder 1.0
- MMTOOLC3.EXE: C++ Builder 3.0
- MMTOOLC4.EXE: C++ Builder 4.0
- MMTOOLC5.EXE: C++ Builder 5.0
- MMTOOLC6.EXE: C++ Builder 6.0

===============================
Delphi 2.0 and C++ Builder 1.0:
===============================

Delphi     : BACKUP YOUR ....\DELPHI\BIN\CMPLIB32.DCL
C++ Builder: BACKUP YOUR ....\CBUILDER\BIN\CMPLIB32.CCL

Better safe than sorry.

The installation has copied all Multimedia Tools VCL files onto your
harddrive.  Copy these VCL files into a directory containing
your 3rd party added VCL's.

Execute Delphi or C++ Builder. In the IDE select Components\Install...
and browse your 3rd party added VCL's directory.

>>>>>>   Select MMTOOLS.PAS and press the OK button.

After the library is rebuilt, you will notice many new icons on your toolbar
under MMTOOLS.

===============================
Delphi 3.0, 4.0, 5.0, 6.0, 7.0:
===============================

The installation has copied all Multimedia Tools VCL files onto your
harddrive.  Copy these VCL files into a directory containing
your 3rd party added VCL's.

Execute Delphi. In Delphi select File\Open and browse
your 3rd party added VCL's directory.

Delphi 3.0: >>>>>>   Select MMTOOLS_D3.DPK and press the OK button.

Delphi 4.0: >>>>>>   Select MMTOOLS_D4.DPK and press the OK button.

Delphi 5.0: >>>>>>   Select MMTOOLS_D5.DPK and press the OK button.

Delphi 6.0: >>>>>>   Select MMTOOLS_D6.DPK and press the OK button.

Delphi 7.0: >>>>>>   Select MMTOOLS_D7.DPK and press the OK button.

Now compile the package and select install.
After the package is rebuilt and installed, you will notice many new icons
on your Delphi toolbar under MMTOOLS.

====================================
C++ Builder 3.0, 4.0, 5.0, 6.0:
====================================

The installation has copied all Multimedia Tools VCL files onto your
harddrive.  Copy these VCL files into a directory containing
your 3rd party added VCL's.

Execute C++ Builder. In C++ Builder select File\Open and browse
your 3rd party added VCL's directory.

C++ Builder 3.0: >>>>>>   Select MMTOOLS_C3.BPK and press the OK button.

C++ Builder 4.0: >>>>>>   Select MMTOOLS_C4.BPK and press the OK button.

C++ Builder 5.0: >>>>>>   Select MMTOOLS_C5.BPK and press the OK button.

C++ Builder 6.0: >>>>>>   Select MMTOOLS_C6.BPK and press the OK button.

Now compile the package and select Component\Install Package.
After the package is rebuilt and installed, you will notice many new icons
on your Delphi toolbar under MMTOOLS.

Installation Troubleshooting:
-----------------------------
The Delphi Library searchpath is very short (127 characters). The more
VCL components you add, the larger your searchpath. Should you get a
message MMTOOLS.PAS or  MMTOOLS.DCU not found, then your path is being
truncated, the solution is to copy several 3rd party VCLs into one directory
and delete the freed directories from your searchpath.

If Complib cannot find a required DLL you will notice that all Icons
are gone from your delphi toolbar and you get a message COMPLIB.DCL not found.
No Panic, just copy all required DLLs to the windows\system directory
and restart Delphi.

Delphi 2.0:
-----------

There is a known problem with Delphi 2.0 that causes the CMPLIB install and
rebuild functions to fail.  Here is a description of the problem and a work-around.

If you add too many VCLs to the library you may get one of the following two
link errors:

    - Link stack overflow.
    - Access violation $FFFFFFFF

The only remody for this is to remove components from the library until the
link successeds.  This is done in the "Install Components" dialog by highlighting
a name in the "Installed units" box and clicking the Remove button. The component
will be removed from the library but will NOT be deleted from your disk. You can
add components back in to the library if you remove something that you are not
using in your programs.

Users who have run into this problem linking the MMTools components have
been able to rebuild the component library by removing only one or two component
registration units.

What to do when the link fails:

When the link fails, sometimes, but not always, CMPLIB32.DLL (an intermediate
link file) needs to be deleted.  You must exit Delphi to delete this file due
to a sharing violation.  You also need to copy a valid CMPLIB32.DCL to your
Delphi20\Bin directory.

Here are two batch files one of our users sent us to make it easier to deal
with rebuild errors. Be sure to change the drive and path to Delphi to match
your system.

  D:\Delphi20\Bin\Backup\GET.BAT     (save a good rebuild)
    D:
    cd D:\Delphi20\Bin\Backup
    copy ..\CMPLIB32.DCL
    copy ..\DELPHI32.DMT
    copy ..\DELPHI32.DRO
    copy ..\DELPHI32.DSK

  D:\Delphi20\Bin\Backup\OOPS.BAT    (restore a good rebuild)
    D:
    cd D:\Delphi20\Bin\Backup
    if exist  ..\CMPLIB32.DLL del  ..\CMPLIB32.DLL
    copy CMPLIB32.DCL ..
    copy DELPHI32.DMT ..
    copy DELPHI32.DRO ..
    copy DELPHI32.DSK ..


Delphi 2.0:
-----------

Sometimes you get the following error:

"Error: (0): Overflow in conversion or arithmetic operation."

In such a case please disable debug infos for the component library
or the project !

(Menu: Tools\Options\Library...)


Delphi 3.0, 4.0, 5.0, 6.0, 7.0:
-------------------------------
Sometimes Delphi crashes if you have (re)compiled a package, this is a
bug in Delphi and we don't know a solution. Simply restart your machine
and load the previous compiled package.


C++ Builder 1.0:
----------------

There is a known problem with C++ Builder that causes the linker to fail
with the following error message:

[Linker Error] Fatal Assertion failded:
!lastLine || lines[0].offset+base >= lastLine->offset at "IMPORT.CPP", line xxxx

The only solution is compiling the library or project again. If this occurs in
a project don't recompile the project, simply start the app (Menu: Run\Run...)

NOTE: This error occurs only with imported Delphi projects, for example our
      demo projects. It occurs not with C++ projects !


C++ Builder 3.0:
----------------

Some times C++ Builder generates a access violation while starting a projct.
Simply open the project options and toggle the full debug options two times.


!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
NOTE: If you run the MMTools demos with C++ Builder don't forget to set the
      library and project searchpath to your MMTools directory:

      Options\Environment\Directories
      Options\Project\Directories