ImageEn, unit iesettings

TIEImageEnGlobalSettings.RegisterPlugIns

TIEImageEnGlobalSettings.RegisterPlugIns


Declaration

function RegisterPlugIns(PlugIns: TIEPlugIns = []; IEVisionUserEmail: WideString = ''; IEVisionUserSerial: WideString = ''; ExeFolderOnly: Boolean = True): TIEPlugIns;


Description

Registers all available plug-in DLL's to add image formats and advanced functionality to ImageEn.
Parameter Description
PlugIns Which plug-ins to check for and load, or [] for all
IEVisionUserEmail, IEVisionUserSerial If you have purchased IEVision, then 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.

The following plug-ins are loaded if available:
Plug-In Description Equivalent Methods
IELib (iepiIELib) Support for Camera Raw formats, and faster loading of JPEG, PNG and JPEG2000 IELibAvailable
IEVision (iepiIEVision) Advanced functionality plug-in IEVisionSetSerialNumber and IEVisionAvailable
PDFium (iepiPDFium) Viewing and manipulation of PDF files PDFiumLibAvailable
ImageMagick (iepiImageMagick) Support for a wider range of image formats (supports both installed and DLL-only versions) IsAvailable and RegisterPlugin

Most plug-ins can be downloaded from:
http://www.imageen.com/download/

Result is equivalent to: ActivePlugIns

Note: If loading fails, you can get debugging information from: DLLLoadingLog


Example

// Register all available plug-ins
IEGlobalSettings().RegisterPlugIns();

// 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' + IEVC_EXPECTED_LIBRARY_VERSION +'. Please download it from www.imageen.com' );
  exit;
end;

// Register the PDFium Plug-In DLL and show a warning if it is not found
IEGlobalSettings().RegisterPlugIns([ iepiPDFium ]);
if not ( iepiPDFium in IEGlobalSettings().ActivePlugIns ) then
  ShowMessage( 'PDF DLL not found. Please reinstall.' );


See Also

- ActivePlugIns
- DLLLoadingLog
- IELibAvailable
- IEVisionSetSerialNumber
- IEVisionAvailable
- PDFiumLibAvailable
- IsAvailable
- RegisterPlugin
- IEAddExtIOPlugIn