TIEGlobalSettings.JPEG2000Engine

Declaration

property JPEG2000Engine: TIEImagingEngine;

Description

Specifies which engine is used to load and save JPEG2000 format images.

Property	Description	32bit Requirement	64bit Requirement
ieenAuto	Automatically chooses ieenDLL if a DLL is found in the EXE folder, otherwise ieenNative (32bit only)	-	-
ieenNative	Uses native loading code (32bit only)	ieNativeJ2K in uses	N/A
ieenDLL	Uses an ImageEn DLL to support the file format. This option gives the best performance and functionality	ielib32.dll or ievision.dll	ielib64.dll or ievision64.dll
ieenWIC	WIC does not support JPEG2000	N/A	N/A
ieenNone	Format is unavailable	-	-

Note:
◼ieenDLL requires you to ship the IELib or IEVision DLL with your application.
◼ieenNative requires you to add ieNativeJ2K to your uses clause (only supported for 32bit applications)
◼To remove native support for JPEG2000 from your project, ensure that none of the following units exist in your uses clauses: ieNativeJ2K, iexUtils, iexDefs
◼With ieenAuto, only the EXE folder is searched for relevant DLLs. For ieenDLL, the system path is also checked (or specify a path by calling RegisterPlugins)
◼You can get the active engine using ActiveJPEG2000Engine, and the status of all imaging engines using ImageEnVersion.Status

Default: ieenAuto (which uses ieenDLL if a DLL is available, otherwise ieenNative in 32bit apps)

Engine Performance

Demos

	Demos\InputOutput\ImagingEngines\ImagingEngines.dpr
	Demos\InputOutput\IEViewPerformance\Performance.dpr

Examples

// Use native code to load JPEG2000 images even if DLL is available
// Ensure you have added ieNativeJ2K to the uses clause of one of your project units!
IEGlobalSettings().JPEG2000Engine := ieenNative;

// Force use of IELib DLL for improved performance
// ImageEn will attempt to load the DLL even if it's not in the EXE folder. If the DLL is not found or is outdated, an error will be raised
IEGlobalSettings().JPEGEngine := ieenDLL;
IEGlobalSettings().PNGEngine := ieenDLL;
IEGlobalSettings().JPEG2000Engine := ieenDLL;
IEGlobalSettings().CameraRawEngine := ieenDLL;

TIEGlobalSettings.JPEG2000Engine