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 - MMTOOLC1.EXE: C++ Builder 1.0 - MMTOOLC3.EXE: C++ Builder 3.0 - MMTOOLC4.EXE: C++ Builder 4.0 - MMTOOLC5.EXE: C++ Builder 5.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: ========================== 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. 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: ==================================== 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. 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: --------------------- 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