LibreOffice
LibreOffice 24.2 SDK API Reference
Variables
com::sun::star::rendering::RenderingIntent Constant Group Reference

The rendering intent for a color space. More...

Variables

const byte PERCEPTUAL =0
 Also known as the image intent, this rendering intent aims to preserve the visual relationship between colors in a way that is perceived as natural to the human eye, although the color values themselves may change. More...
 
const byte SATURATION =1
 The rendering intent for business graphics that maintains vivid color at the expense of accurate color. More...
 
const byte RELATIVE_COLORIMETRIC =2
 The rendering intent almost identical to Absolute Colorimetric except for the following difference: Relative Colorimetric compares the white point (extreme highlight) of the source color space to that of the destination color space and shifts all colors accordingly. More...
 
const byte ABSOLUTE_COLORIMETRIC =3
 The rendering intent that leaves colors that fall inside the destination gamut unchanged. More...
 

Detailed Description

The rendering intent for a color space.

The rendering intent for a color space mostly determines how out-of-gamut color is treated. See Wikipedia for a thorough explanation.

Since
OOo 2.0

Variable Documentation

◆ ABSOLUTE_COLORIMETRIC

const byte ABSOLUTE_COLORIMETRIC =3

The rendering intent that leaves colors that fall inside the destination gamut unchanged.

Out of gamut colors are clipped. No scaling of colors to destination white point is performed. This intent aims to maintain color accuracy at the expense of preserving relationships between colors, and is useful for seeing how output will look on a non-neutral substrate.

◆ PERCEPTUAL

const byte PERCEPTUAL =0

Also known as the image intent, this rendering intent aims to preserve the visual relationship between colors in a way that is perceived as natural to the human eye, although the color values themselves may change.

This intent is most suitable for photographic images.

◆ RELATIVE_COLORIMETRIC

const byte RELATIVE_COLORIMETRIC =2

The rendering intent almost identical to Absolute Colorimetric except for the following difference: Relative Colorimetric compares the white point (extreme highlight) of the source color space to that of the destination color space and shifts all colors accordingly.

◆ SATURATION

const byte SATURATION =1

The rendering intent for business graphics that maintains vivid color at the expense of accurate color.

It scales the source gamut to the destination gamut but preserves relative saturation instead of hue, so when scaling to a smaller gamut, hues may shift. This rendering intent is primarily designed for business graphics, where bright saturated colors are more important than the exact relationship between colors (such as in a photographic image).