ImageEn, unit iexBitmaps

TIOParams.IEN_Compression

TIOParams.IEN_Compression


Declaration

property IEN_Compression: TIOFileType;


Description

Specifies the format to save an ImageEn layer file.

If CompressionFormat is -1, a lossless zlib compression format is used (preserving pixel format and alpha channel).
If CompressionFormat is -2, a non-compressed format is used (preserving pixel format and alpha channel).
Otherwise any standard image format can be used, except ioTIFF.
If you offset a value by 10000, e.g. 10000 + ioPNG, then non-transparent layers (e.g. background/layer 0) will be JPEG format, and the remaining layers the specified format. This is useful if you want maximum compression but need to maintain transparency.

Note:
If your image layers use an alpha channel, ensure IEN_Compression is -1, -2 or ioPNG
Even if a standard compression format, such as ioJPEG is used, the file will only be readable by ImageEn
ioPNG should not be used if you need compatibility with ImageEn versions that use ieenWIC
If ioJPEG compression is used, JPEG Quality is specified by IOParamDefaults (80, by default)

Default: -1


Examples

// Use PNG as the compression format
ImageEnView1.IO.Params.IEN_Compression := ioPNG;
ImageEnView1.IO.SaveToFileIEN('D:\Layers.ien');

// Use JPEG as the compression format (transparency will be lost)
ImageEnView1.IO.Params.IEN_Compression := ioJPEG;
IEGlobalSettings().IOParamDefaults.JPEG_Quality := 95;
ImageEnView1.IO.SaveToFileIEN('D:\Layers.ien');

// Use PNG as the compression format for layers with transparency, otherwise use JPEG
ImageEnView1.IO.Params.IEN_Compression := 10000 + ioPNG;
IEGlobalSettings().IOParamDefaults.JPEG_Quality := 95;
ImageEnView1.IO.SaveToFileIEN('D:\Layers.ien');

// Use internal compression format (transparency will be maintained)
ImageEnView1.IO.Params.IEN_Compression := -1;
ImageEnView1.IO.SaveToFileIEN('D:\Layers.ien');

// Use internal compression format for layers with transparency, otherwise use JPEG
ImageEnView1.IO.Params.IEN_Compression := 10000 + -1;
IEGlobalSettings().IOParamDefaults.JPEG_Quality := 95;
ImageEnView1.IO.SaveToFileIEN('D:\Layers.ien');