# ColorSpace.RenderIntent

Added in[API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# RenderIntent

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/graphics/ColorSpace.RenderIntent "View this page in Java")  

```
class RenderIntent
```

|---|---|--------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                          |||
| ↳ | [kotlin.Enum](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-enum/index.html)\<[android.graphics.ColorSpace.RenderIntent](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#)\> ||
|   | ↳ | [android.graphics.ColorSpace.RenderIntent](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#) |

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Known Direct Subclasses [ColorSpace.RenderIntent.ABSOLUTE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:ABSOLUTE),[ColorSpace.RenderIntent.PERCEPTUAL](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:PERCEPTUAL),[ColorSpace.RenderIntent.RELATIVE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:RELATIVE),[ColorSpace.RenderIntent.SATURATION](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:SATURATION) |-----------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [ColorSpace.RenderIntent.ABSOLUTE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:ABSOLUTE)     | Colors that are in the destination gamut are left unchanged.                                                                                                                                                                                                  | | [ColorSpace.RenderIntent.PERCEPTUAL](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:PERCEPTUAL) | Compresses the source gamut into the destination gamut.                                                                                                                                                                                                       | | [ColorSpace.RenderIntent.RELATIVE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:RELATIVE)     | Similar to the[ABSOLUTE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#)render intent, this render intent matches the closest color in the destination gamut but makes adjustments for the destination white point. | | [ColorSpace.RenderIntent.SATURATION](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:SATURATION) | Attempts to maintain the relative saturation of colors from the source gamut to the destination gamut, to keep highly saturated colors as saturated as possible.                                                                                              | |

A render intent determines how a[connector](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.Connector)maps colors from one color space to another. The choice of mapping is important when the source color space has a larger color gamut than the destination color space.

## Summary

|                                                                                                                                                                                       Enum values                                                                                                                                                                                        ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [ABSOLUTE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:ABSOLUTE) Colors that are in the destination gamut are left unchanged.                                                                                                                                                                                                  |
| [PERCEPTUAL](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:PERCEPTUAL) Compresses the source gamut into the destination gamut.                                                                                                                                                                                                   |
| [RELATIVE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:RELATIVE) Similar to the[ABSOLUTE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#)render intent, this render intent matches the closest color in the destination gamut but makes adjustments for the destination white point. |
| [SATURATION](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#ENUM_VALUE:SATURATION) Attempts to maintain the relative saturation of colors from the source gamut to the destination gamut, to keep highly saturated colors as saturated as possible.                                                                                          |

## Enum values

### ABSOLUTE

Added in[API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
enum val ABSOLUTE : ColorSpace.RenderIntent
```

Colors that are in the destination gamut are left unchanged. Colors that fall outside of the destination gamut are mapped to the closest possible color within the gamut of the destination color space (they are clipped).  

### PERCEPTUAL

Added in[API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
enum val PERCEPTUAL : ColorSpace.RenderIntent
```

Compresses the source gamut into the destination gamut. This render intent affects all colors, inside and outside of destination gamut. The goal of this render intent is to preserve the visual relationship between colors.

This render intent is currently not implemented and behaves like[RELATIVE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#).  

### RELATIVE

Added in[API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
enum val RELATIVE : ColorSpace.RenderIntent
```

Similar to the[ABSOLUTE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#)render intent, this render intent matches the closest color in the destination gamut but makes adjustments for the destination white point.  

### SATURATION

Added in[API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
enum val SATURATION : ColorSpace.RenderIntent
```

Attempts to maintain the relative saturation of colors from the source gamut to the destination gamut, to keep highly saturated colors as saturated as possible.

This render intent is currently not implemented and behaves like[RELATIVE](https://developer.android.com/reference/kotlin/android/graphics/ColorSpace.RenderIntent#).