Added in API level 26

Connector


open class Connector
kotlin.Any
   ↳ android.graphics.ColorSpace.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:

$$C = T^{-1}_{dst} . T_{src}$$

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 ColorSpace

Returns the destination color space this connector will convert to.

open ColorSpace.RenderIntent!

Returns the render intent this connector will use when mapping the source color space to the destination color space.

open ColorSpace

Returns the source color space this connector will convert from.

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

Transforms the specified color from the source color space to a color in the destination color space.

open FloatArray

Transforms the specified color from the source color space to a color in the destination color space.

Public methods

getDestination

Added in API level 26
open fun getDestination(): ColorSpace

Returns the destination color space this connector will convert to.

Return
ColorSpace A non-null instance of ColorSpace

See Also

getRenderIntent

Added in API level 26
open fun getRenderIntent(): ColorSpace.RenderIntent!

Returns the render intent this connector will use when mapping the source color space to the destination color space.

Return
ColorSpace.RenderIntent! A non-null RenderIntent

getSource

Added in API level 26
open fun getSource(): ColorSpace

Returns the source color space this connector will convert from.

Return
ColorSpace A non-null instance of ColorSpace

transform

Added in API level 26
open fun transform(
    r: Float,
    g: Float,
    b: Float
): FloatArray

Transforms the specified color from the source color space to a color in the destination color space. This convenience method assumes a source color model with 3 components (typically RGB). To transform from color models with more than 3 components, such as CMYK, use transform(float[]) instead.

Parameters
r Float: The red component of the color to transform
g Float: The green component of the color to transform
b Float: The blue component of the color to transform
Return
FloatArray A new array of 3 floats containing the specified color transformed from the source space to the destination space This value cannot be null.

transform

Added in API level 26
open fun transform(v: FloatArray): FloatArray

Transforms the specified color from the source color space to a color in the destination color space.

Parameters
v FloatArray: A non-null array of 3 floats containing the value to transform and that will hold the result of the transform
Return
FloatArray The v array passed as a parameter, containing the specified color transformed from the source space to the destination space This value cannot be null.