ImageEn, unit imageenio

TImageEnIO.AutoConvertFormat

TImageEnIO.AutoConvertFormat

Declaration

property AutoConvertFormat: Boolean;

Description

When true, the pixel format will be automatically converted to one that is compatible to the file format being saved to.
For example, when saving to DICOM with iedcJPEG and your image format is incompatible, e.g. ie1g, it is converted automatically to ie24RGB.
If AutoConvertFormat = False and you try to save with an incompatible format it will fail.

Specific effects:
When saving to TIFF the PixelFormat is converted if not one of the following: ie1g, ie8p, ie8g, ie16g, ie24RGB, ie32f, ie48RGB, ieCMYK
When saving to JPEG2000 the PixelFormat is converted if not one of the following: ie1g, ie8g, ie16g, ie24RGB, ie48RGB
When saving to WebP or HEIF the PixelFormat is converted if not one of the following: ie24RGB, ie32RGB
When saving to DICOM the PixelFormat is converted if not one of the following: ie1g, ie8g, ie16g, ie32f, ie24RGB (or ie8g, ie24RGB for iedcJPEG, ie8g, ie16g, ie24RGB for iedcJPEG2000/iedcLosslessJPEG2000
When saving to PNG with format of ie1g, ie8g, ie8p or ie16g and the image has a valid alpha channel, it is promoted to ie8p or ie2RGB

Default: True