CmykConversionOptions Class

Immutable options of the color conversion that loads images whose samples are CMYK inks (four-component JPEG files and separated TIFF pages): see ImageDecodeOptions.CmykConversion and ImageReaderOptions.CmykConversion.

public sealed class CmykConversionOptions

Remarks

No pixel format holds CMYK samples: the decoder converts them with an IccColorTransform from the CMYK profile embedded in the file, or from CmykConversionOptions.AssumedSourceProfile when the file has none, to CmykConversionOptions.DestinationProfile. The loaded image holds RGB pixels labeled with CmykConversionOptions.DestinationProfile; the CMYK profile is not kept. An alpha sample of a TIFF page is not a color: it is copied unchanged.

An embedded CMYK profile that is malformed or not supported is an error: it is never replaced by CmykConversionOptions.AssumedSourceProfile.

Constructors

NameDescription
CmykConversionOptions()

CmykConversionOptions()

CmykConversionOptions.cs
public CmykConversionOptions()

No documentation is available.

Properties

NameDescription
AssumedSourceProfileGets the CMYK profile assumed for samples without embedded CMYK profile, or null to reject such images with an UnsupportedImageFeatureException. Defaults to IccProfile.Cgats001CompatibleCmyk.
DefaultGets the default options: conversion to sRGB, IccProfile.Cgats001CompatibleCmyk assumed for samples without profile, media-relative colorimetric intent with black point compensation.
DestinationProfileGets the RGB profile of the loaded pixels. Defaults to IccProfile.Srgb.
TransformGets the rendering intent and the black point compensation of the conversion. Defaults to IccColorTransformOptions.Default.

AssumedSourceProfile

CmykConversionOptions.cs

Gets the CMYK profile assumed for samples without embedded CMYK profile, or null to reject such images with an UnsupportedImageFeatureException. Defaults to IccProfile.Cgats001CompatibleCmyk.

public IccProfile? AssumedSourceProfile { get; init; }

Property value

IccProfile?

Exceptions

ArgumentException
The profile does not declare the CMYK color space.

Gets the default options: conversion to sRGB, IccProfile.Cgats001CompatibleCmyk assumed for samples without profile, media-relative colorimetric intent with black point compensation.

public static CmykConversionOptions Default { get; }

Property value

CmykConversionOptions

DestinationProfile

CmykConversionOptions.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 and the black point compensation of the conversion. Defaults to IccColorTransformOptions.Default.

public IccColorTransformOptions Transform { get; init; }

Property value

IccColorTransformOptions

Exceptions

ArgumentNullException
The value is null.