CieLabConversionOptions Class

Immutable options of the color conversion that loads images whose samples are CIE 1976 L*a*b* colors (TIFF pages with the CIELab and ICCLab photometric interpretations): see ImageDecodeOptions.CieLabConversion and ImageReaderOptions.CieLabConversion.

public sealed class CieLabConversionOptions

Remarks

No pixel format holds L*a*b* samples: the decoder converts each color, relative to the white point of the file (D50 when the file declares none, as Adobe's TIFF technical note says), to CIEXYZ of the ICC profile connection space (adapted to D50 with the linear Bradford transform), then to CieLabConversionOptions.DestinationProfile. The loaded image holds RGB pixels labeled with CieLabConversionOptions.DestinationProfile. The colors outside its gamut are brought into it as IccColorTransformOptions.GamutMapping says, so the conversion can lose colors. An alpha sample is not a color: it is copied unchanged.

The colors are treated as the colorimetry of the connection space: their white is the white of the connection space, so the ICC-absolute colorimetric intent rescales them by the media white of the destination only, and their black is no light (L* = 0), which is what black point compensation maps to the black of the destination.

Constructors

NameDescription
CieLabConversionOptions()

CieLabConversionOptions()

CieLabConversionOptions.cs
public CieLabConversionOptions()

No documentation is available.

Properties

NameDescription
DefaultGets the default options: conversion to sRGB with the media-relative colorimetric intent and black point compensation.
DestinationProfileGets the RGB profile of the loaded pixels. Defaults to IccProfile.Srgb.
TransformGets the rendering intent, the black point compensation and the gamut mapping of the conversion. Defaults to IccColorTransformOptions.Default.

Gets the default options: conversion to sRGB with the media-relative colorimetric intent and black point compensation.

public static CieLabConversionOptions Default { get; }

DestinationProfile

CieLabConversionOptions.cs

Gets the RGB profile of the loaded pixels. Defaults to IccProfile.Srgb.

public IccProfile DestinationProfile { get; init; }

Property value

IccProfile

Exceptions

ArgumentNullException
The value is null.
ArgumentException
The profile does not declare the RGB color space.

Gets the rendering intent, the black point compensation and the gamut mapping of the conversion. Defaults to IccColorTransformOptions.Default.

public IccColorTransformOptions Transform { get; init; }

Property value

IccColorTransformOptions

Exceptions

ArgumentNullException
The value is null.