Registers all available plug-in DLLs to add image formats and advanced functionality to ImageEn.
Parameter
Description
PlugIns
Which plug-ins to check for and load, or [] for all
DLLPath
Optionally, specify the folder containing the add-in DLLs (if not the EXE folder or system path)
IEVisionUserEmail, IEVisionUserSerial
If you have purchased IEVision specify your email and serial number. Leave blank to run IEVision in trial mode
ExeFolderOnly
Whether to search only the EXE folder or the system path for plug-ins. Setting to false may make the method much slower
You should call RegisterPlugIns once in your application (ideally at application start-up). There is no risk to calling RegisterPlugIns() multiple times.
Note: ◼If loading fails, you can get debugging information from: DLLLoadingLog ◼The expected version of IELib/IEVision is available from: ImageEnVersion.IELibVersionStr ◼Registering of the IELib, IELang and PDFium plug-ins is optional as they will be automatically registered when they are first needed (if found in your EXE folder) ◼To register the legacy ImageMagick plug-In, ImageMagick.dll use: IEAddExtIOPlugIn ◼You can get the status of all loaded plug-ins using ImageEnVersion.Status
// Register all available plug-ins IEGlobalSettings().RegisterPlugIns();
// Register all available plug-in DLLs found in alternative folder IEGlobalSettings().RegisterPlugIns( 'C:\ImageEnPlugIns\' );
// Register all available plug-ins (IEVision user) IEGlobalSettings().RegisterPlugIns( [], 'me@mycompany.com', 'ievis-12345-67890-12345-67890-12345-67890' );
// Register only IEVision IEGlobalSettings().RegisterPlugIns( [iepiIEVision], 'me@mycompany.com', 'ievis-12345-67890-12345-67890-12345-67890' ); if not ( iepiIEVision in IEGlobalSettings().ActivePlugIns ) then begin ShowMessage( 'This application requires the ievision.dll plug-in, v' + IEGlobalSettings().ImageEnVersion.IELibVersionStr +'. Please download it from www.imageen.com' ); exit; end;
// Register the PDFium Plug-In DLL and show a warning if not found IEGlobalSettings().RegisterPlugIns([ iepiPDFium ]); if not ( iepiPDFium in IEGlobalSettings().ActivePlugIns ) then ShowMessage( 'PDF DLL not found. Please reinstall.' );
// Change language to Italian and show warning if language dll is not found IEGlobalSettings().RegisterPlugIns([ iepiLanguages ]); if not ( iepiLanguages in IEGlobalSettings().ActivePlugIns ) then ShowMessage( 'IELang32.dll not found. Please reinstall.' ) else IEGlobalSettings().MsgLanguage := msItalian;
// Register plug-ins from different folders under the EXE folder IEGlobalSettings().RegisterPlugIns( '.\MagickDLL\', [ iepiImageMagick ]); IEGlobalSettings().RegisterPlugIns( '.\PdfiumDLL\', [ iepiPDFium ]); IEGlobalSettings().RegisterPlugIns( '.\IELangDLL\', [ iepiLanguages ]);
// Register IEVision DLL with a custom filename (renamed XyzViz.DLL) IEGlobalSettings().RegisterPlugIns( 'C:\Program Files\MyApp\XyzViz.DLL', [iepiIEVision], 'me@mycompany.com', 'ievis-12345-67890-12345-67890-12345-67890' );
// Output logging information for DLL registration IEGlobalSettings().DLLLoadingLogEnabled := True; IEGlobalSettings().RegisterPlugIns(); memLog.Text := IEGlobalSettings().DLLLoadingLog;