Package icyllis.arc3d.core

# Enum Class ColorSpace.RenderIntent

java.lang.Object
java.lang.Enum<ColorSpace.RenderIntent>
icyllis.arc3d.core.ColorSpace.RenderIntent

All Implemented Interfaces:
  `Serializable`, `Comparable<ColorSpace.RenderIntent>`, `Constable`

Enclosing class:
  `ColorSpace`

public static enum ColorSpace.RenderIntent extends Enum<ColorSpace.RenderIntent>

A render intent determines how a `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.

See Also:
  - `ColorSpace.connect(ColorSpace, ColorSpace, RenderIntent)`

- ## Nested Class Summary

  ## Nested classes/interfaces inherited from class java.lang.Enum

  `Enum.EnumDesc<E extends Enum<E>>`

- ## Enum Constant Summary

  Enum Constants
  Enum Constant
  Description
  `ABSOLUTE`
  Colors that are in the destination gamut are left unchanged.
  `PERCEPTUAL`
  Compresses the source gamut into the destination gamut.
  `RELATIVE`
  Similar to the `ABSOLUTE` render intent, this render intent matches the closest color in the destination gamut but makes adjustments for the destination white point.
  `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.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `static ColorSpace.RenderIntent`
  `valueOf(String name)`
  Returns the enum constant of this class with the specified name.
  `static ColorSpace.RenderIntent[]`
  `values()`
  Returns an array containing the constants of this enum class, in the order they are declared.

  ### Methods inherited from class java.lang.Enum

  `clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf`

  ### Methods inherited from class java.lang.Object

  `getClass, notify, notifyAll, wait, wait, wait`

- ## Enum Constant Details

  - ### PERCEPTUAL

    public static final ColorSpace.RenderIntent PERCEPTUAL

    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`.

  - ### RELATIVE

    public static final ColorSpace.RenderIntent RELATIVE
    Similar to the `ABSOLUTE` render intent, this render intent matches the closest color in the destination gamut but makes adjustments for the destination white point.

  - ### SATURATION

    public static final ColorSpace.RenderIntent 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.

    This render intent is currently not implemented and behaves like `RELATIVE`.

  - ### ABSOLUTE

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

- ## Method Details

  - ### values

    public static ColorSpace.RenderIntent[] values()
    Returns an array containing the constants of this enum class, in the order they are declared.
    Returns:
      an array containing the constants of this enum class, in the order they are declared

  - ### valueOf

    public static ColorSpace.RenderIntent valueOf(String name)
    Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
    Parameters:
      `name` - the name of the enum constant to be returned.
    Returns:
      the enum constant with the specified name
    Throws:
      `IllegalArgumentException` - if this enum class has no constant with the specified name
      `NullPointerException` - if the argument is null