ImageEn, unit iexBitmaps

TIOParams.DefaultICCProfile

TIOParams.DefaultICCProfile

Declaration

property DefaultICCProfile: TIEICC;

Description

Specifies a default ICC profile to use if an image does not contain a color profile (i.e. InputICCProfile is not assigned).
You can specify a DefaultICCProfile, as an alternative profile to apply (ColorProfileMode = iecpApply) or render (ColorProfileMode = iecpRender) to the image.

Understanding ICC Profiles

There are three main ImageEn ICC Profiles:

 InputICCProfile: The Color Profile of the Image

This is the profile contained in the image file (that was provided by the image source, e.g. a digital camera or scanner). It is filled when loading the image. ColorProfileMode specifies how it is used:
ColorProfileMode Effect
iecpApply Profile is applied to the image while loading (i.e the image is modified). To determine if an input profile has been applied, use: ImageEnView.IO.Params.InputICCProfile.IsApplied
iecpRender Profile is copied to ColorProfile and used to render the image (without modifying the image)
iecpIgnore Profile is stored but not used

If InputICCProfile has not been applied (i.e. ColorProfileMode is iecpRender or iecpIgnore), it is saved to the image when saving to a compatible format (JPEG, TIFF or PSD).

 DefaultICCProfile: The Fallback Color Profile

If an image does not contain a color profile (i.e. InputICCProfile), then this property allows you to specify an alternative profile to apply (ColorProfileMode = iecpApply) or render (ColorProfileMode = iecpRender) to the image.

 OutputICCProfile: The Output Color Profile

Defines the color profile for our usage of the image (e.g. a monitor or printer). This property defaults to sRGB, which is suitable for display, printing and saving.

Note:

TIEBitmap.ColorProfile is a copy of InputICCProfile that is used for rendering (i.e. when ColorProfileMode = iecpRender)
ICC profiles can be read from JPEG (RGB and CMYK), TIFF, PNG and PSD files (for PNG, only rendering is supported). They are written to JPEG, TIFF and PSD files
For the output profile (OutputICCProfile) ImageEn defaults to an embedded sRGB profile (suitable for display, printing and saving)

Example

// Load a color profile to apply to the image if one is not available
ImageEnView1.IO.Params.DefaultICCProfile.LoadFromFile('C:\Windows\System32\spool\drivers\color\AdobeRGB1998.icc');
ImageEnView1.IEBitmap.ColorProfileMode := iecpApply;
ImageEnView1.IO.LoadFromFile('C:\input.tif');

See Also

InputICCProfile
OutputICCProfile
Color Management System
ColorProfile
ColorProfileMode
ConvertColorFunction