DocumentationDynamic Media Image Serving and Rendering API

icc

Last update: August 31, 2023
  • Topics:
  • Dynamic Media Classic,SDK/API

CREATED FOR:

  • Developer
  • User

Output Color Profile.

icc= *object*[, *renderIntent*[, *blackpointComp*[, *dither*]]

object
ICC color profile.
renderIntent
perceptual|relative|saturation|absolute.
blackpointComp
1 to enable, 0 to disable blackpoint compensation.
dither
1 to enable, 0 to disable dithering.

The value object specifies the output color space profile to which the image should be converted if it is different from the working profile. The value profile must be either a valid icc::Name defined in the ICC profile map of an image catalog or default catalog, or a relative path to a profile file (typically with .icc or .icm suffix). See object for additional information.

NOTE
The value object may not include ‘,’ characters, even if HTTP-encoded.

The value renderIntent allows overriding the default rendering intent.

The value blackpointComp enables blackpoint compensation if the output profile supports this feature.

NOTE
Not all color conversions support all renderIntent and blackpointComp choices. Typically, these settings are honored only when the ICC output profile characterizes an output device such as a printer or monitor. Also, some ICC output profiles do not support all renderIntent choices.

Note

The modifier dither enables dithering (actually error diffusion), which may avoid or reduce color banding artifacts.

Properties

Request attribute. The server returns an error if an image type is specified with fmt= which does not match profile.

The modifiers renderIntent and blackpointComp are ignored if not compatible with the specified ICC profile. CMYK output device profiles are more likely to support different rendering intents.

Default

If color management is enabled and icc= is not specified, the server delivers the image converted to the output profile ( attribute::IccProfile*) matching the image type specified with fmt=.

If not specified, renderIntent is inherited from attribute::IccRenderIntent, blackpointComp is inherited from attribute::IccBlackPointCompensation, and dither is inherited from attribute::IccDither.

See also

attribute::IccProfile* , attribute::IccRenderIntent, attribute::IccBlackPointCompensation, attribute::IccDither, fmt=, object, Color Management, ICC Profile Map Reference, iccEmbed=

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49