Skip to content

Most visited

Recently visited

navigation

ColorSpace.Connector

public static class ColorSpace.Connector
extends Object

java.lang.Object
   ↳ 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 ColorSpace.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 }
 

See also:

Summary

Public methods

ColorSpace getDestination()

Returns the destination color space this connector will convert to.

ColorSpace.RenderIntent getRenderIntent()

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

ColorSpace getSource()

Returns the source color space this connector will convert from.

float[] transform(float[] v)

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

float[] transform(float r, float g, float b)

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

Inherited methods

From class java.lang.Object

Public methods

getDestination

added in API level 26
ColorSpace getDestination ()

Returns the destination color space this connector will convert to.

Returns
ColorSpace A non-null instance of ColorSpace

See also:

getRenderIntent

added in API level 26
ColorSpace.RenderIntent getRenderIntent ()

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

Returns
ColorSpace.RenderIntent A non-null ColorSpace.RenderIntent

See also:

getSource

added in API level 26
ColorSpace getSource ()

Returns the source color space this connector will convert from.

Returns
ColorSpace A non-null instance of ColorSpace

See also:

transform

added in API level 26
float[] transform (float[] v)

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

Parameters
v float: A non-null array of 3 floats containing the value to transform and that will hold the result of the transform

Returns
float[] The v array passed as a parameter, containing the specified color transformed from the source space to the destination space

This value will never be null.

See also:

transform

added in API level 26
float[] transform (float r, 
                float g, 
                float b)

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

Returns
float[] A new array of 3 floats containing the specified color transformed from the source space to the destination space

This value will never be null.

See also:

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)