Connector

open class Connector

A connector transforms colors from a source color space to a destination color space.

A source color space is connected to a destination color space using the color transform \(C\) computed from their respective transforms noted \(T_{src}\) and \(T_{dst}\) in the following equation:

The transform \(C\) shown above is only valid when the source and destination color spaces have the same profile connection space (PCS). We know that instances of ColorSpace always use CIE XYZ as their PCS but their white points might differ. When they do, we must perform a chromatic adaptation of the color spaces' transforms. To do so, we use the von Kries method described in the documentation of Adaptation, using the CIE standard illuminant D50 as the target white point.

Example of conversion from sRGB to DCI-P3:

ColorSpace.Connector connector = ColorSpace.connect(
          ColorSpace.get(ColorSpace.Named.SRGB),
          ColorSpace.get(ColorSpace.Named.DCI_P3));
  float[] p3 = connector.transform(1.0f, 0.0f, 0.0f);
  // p3 contains { 0.9473, 0.2740, 0.2076 }
  

Summary

Public methods

open fun getDestination(): ColorSpace

open fun getRenderIntent(): ColorSpace.RenderIntent!

open fun getSource(): ColorSpace

open fun transform(
    r: Float, 
    g: Float, 
    b: Float
): FloatArray

open fun transform(v: FloatArray): FloatArray