CmykPixelConversionOptions Class

Immutable options of the color conversion between CMYK pixels (Cmyk32, Cmyk64) and the other pixel formats: see PixelConversionOptions.CmykConversion.

public sealed class CmykPixelConversionOptions

Remarks

From CMYK, the colors are converted with an IccColorTransform from the CMYK profile of the image, or from CmykPixelConversionOptions.CmykProfile when the image has none, to CmykPixelConversionOptions.RgbProfile, which labels the converted pixels. When neither profile exists, the device CMYK formulas of Cmyk are used (CSS Color 5 device-cmyk()), and the converted pixels have no profile.

To CMYK, the colors are converted from the RGB profile of the image, or from CmykPixelConversionOptions.RgbProfile when the image has none, to CmykPixelConversionOptions.CmykProfile, which labels the converted pixels. Without CmykPixelConversionOptions.CmykProfile, the device CMYK formulas of Cmyk are used (the black is what the three inks share), and the converted pixels have no profile. CMYK has no alpha: non-opaque pixels need PixelConversionOptions.BackgroundColor.

The device formulas do not describe what a press prints: they are a convenience for previews and for files whose printing condition is unknown. Use a CMYK profile to prepare colors for print.

Constructors

NameDescription
CmykPixelConversionOptions()

CmykPixelConversionOptions()

CmykPixelConversionOptions.cs
public CmykPixelConversionOptions()

No documentation is available.

Properties

NameDescription
CmykProfileGets the CMYK profile of the CMYK side when the image has none: the source of a conversion from CMYK pixels without profile, and the destination of a conversion to CMYK pixels. null (the default) uses the device CMYK formulas instead.
DefaultGets the default options: the ICC profile of the image when it has one, otherwise the device CMYK formulas; sRGB on the RGB side; media-relative colorimetric intent with black point compensation.
RgbProfileGets the RGB profile of the RGB side when the image has none: the destination of a color-managed conversion from CMYK pixels, and the source of a color-managed conversion of RGB or gray pixels without profile to CMYK. Defaults to IccProfile.Srgb.
TransformGets the rendering intent and the black point compensation of the color-managed conversions. Defaults to IccColorTransformOptions.Default.

Gets the CMYK profile of the CMYK side when the image has none: the source of a conversion from CMYK pixels without profile, and the destination of a conversion to CMYK pixels. null (the default) uses the device CMYK formulas instead.

public IccProfile? CmykProfile { get; init; }

Property value

IccProfile?

Exceptions

ArgumentException
The profile does not declare the CMYK color space.

Gets the default options: the ICC profile of the image when it has one, otherwise the device CMYK formulas; sRGB on the RGB side; media-relative colorimetric intent with black point compensation.

public static CmykPixelConversionOptions Default { get; }

Gets the RGB profile of the RGB side when the image has none: the destination of a color-managed conversion from CMYK pixels, and the source of a color-managed conversion of RGB or gray pixels without profile to CMYK. Defaults to IccProfile.Srgb.

public IccProfile RgbProfile { 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 color-managed conversions. Defaults to IccColorTransformOptions.Default.

public IccColorTransformOptions Transform { get; init; }

Property value

IccColorTransformOptions

Exceptions

ArgumentNullException
The value is null.