TIEGlobalSettings.HeifEngine

Declaration

Description

Specifies which engine is used to load and save Heif images.

Property	Description	32bit Requirement	64bit Requirement
ieenAuto	Automatically chooses ieenDLL if the LibHeif DLL is found in the EXE folder, otherwise ieenLegacy (if ImageMagick is available) or ieenWIC	-	-
ieenNative, ieenDLL	Uses the LibHeif DLL	libheif.dll	libheif.dll
ieenWIC	Uses the WIC API (Windows Imaging Component) - Read-Only!	Always Supported	Always Supported
ieenLegacy	Uses the ImageMagick Plug-in	ImageMagick DLLs	ImageMagick DLLs
ieenNone	Format is unavailable	-	-

Note:
◼ieenDLL requires you to ship the LibHeif DLLs with your application
◼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)
◼ieenNative and ieenWIC are not supported for saving
◼You can get the active engine using ActiveHeifEngine, and the status of all imaging engines using ImageEnVersion.Status

Default: ieenAuto (which uses ieenDLL if the LibHeif DLL is available, otherwise ieenLegacy (if ImageMagick is available) or ieenWIC

Example

// Use the Heif DLL to create save files
IEGlobalSettings().HeifEngine := ieenDLL;

TIEGlobalSettings.HeifEngine