Object

ColorSpaces

RevenueCat

RevenueCat

Add subscriptions to your apps in minutes

Ad Get started for free
Common
object ColorSpaces

Properties

Common
val Srgb =
    Rgb("sRGB IEC61966-2.1", SrgbPrimaries, Illuminant.D65, SrgbTransferParameters, id = 0)

RGB color space sRGB standardized as IEC 61966-2.1:1999. See details on sRGB color space

Common
val LinearSrgb =
    Rgb("sRGB IEC61966-2.1 (Linear)", SrgbPrimaries, Illuminant.D65, 1.0, 0.0f, 1.0f, id = 1)

RGB color space sRGB standardized as IEC 61966-2.1:1999. See details on Linear sRGB color space

Common
val ExtendedSrgb =
    Rgb(
        "scRGB-nl IEC 61966-2-2:2003",
        SrgbPrimaries,
        Illuminant.D65,
        null,
        { x -> absRcpResponse(x, 1 / 1.055, 0.055 / 1.055, 1 / 12.92, 0.04045, 2.4) },
        { x -> absResponse(x, 1 / 1.055, 0.055 / 1.055, 1 / 12.92, 0.04045, 2.4) },
        -0.799f,
        2.399f,
        SrgbTransferParameters,
        id = 2,
    )

RGB color space scRGB-nl standardized as IEC 61966-2-2:2003. See details on Extended sRGB color space

Common
val LinearExtendedSrgb =
    Rgb("scRGB IEC 61966-2-2:2003", SrgbPrimaries, Illuminant.D65, 1.0, -0.5f, 7.499f, id = 3)

RGB color space scRGB standardized as IEC 61966-2-2:2003. See details on Linear Extended sRGB color space

Common
val Bt709 =
    Rgb(
        "Rec. ITU-R BT.709-5",
        floatArrayOf(0.640f, 0.330f, 0.300f, 0.600f, 0.150f, 0.060f),
        Illuminant.D65,
        TransferParameters(1 / 0.45, 1 / 1.099, 0.099 / 1.099, 1 / 4.5, 0.081),
        id = 4,
    )

RGB color space BT.709 standardized as Rec. ITU-R BT.709-5. See details on BT.709 color space

Common
val Bt2020 =
    Rgb(
        "Rec. ITU-R BT.2020-1",
        floatArrayOf(0.708f, 0.292f, 0.170f, 0.797f, 0.131f, 0.046f),
        Illuminant.D65,
        TransferParameters(1 / 0.45, 1 / 1.0993, 0.0993 / 1.0993, 1 / 4.5, 0.08145),
        id = 5,
    )

RGB color space BT.2020 standardized as Rec. ITU-R BT.2020-1. See details on BT.2020 color space

Common
val DciP3 =
    Rgb(
        "SMPTE RP 431-2-2007 DCI (P3)",
        floatArrayOf(0.680f, 0.320f, 0.265f, 0.690f, 0.150f, 0.060f),
        WhitePoint(0.314f, 0.351f),
        2.6,
        0.0f,
        1.0f,
        id = 6,
    )

RGB color space DCI-P3 standardized as SMPTE RP 431-2-2007. See details on DCI-P3 color space

Common
val DisplayP3 =
    Rgb(
        "Display P3",
        floatArrayOf(0.680f, 0.320f, 0.265f, 0.690f, 0.150f, 0.060f),
        Illuminant.D65,
        SrgbTransferParameters,
        id = 7,
    )

RGB color space Display P3 based on SMPTE RP 431-2-2007 and IEC 61966-2.1:1999. See details on Display P3 color space

Common
val Ntsc1953 =
    Rgb(
        "NTSC (1953)",
        Ntsc1953Primaries,
        Illuminant.C,
        TransferParameters(1 / 0.45, 1 / 1.099, 0.099 / 1.099, 1 / 4.5, 0.081),
        id = 8,
    )

RGB color space NTSC, 1953 standard. See details on NTSC 1953 color space

Common
val SmpteC =
    Rgb(
        "SMPTE-C RGB",
        floatArrayOf(0.630f, 0.340f, 0.310f, 0.595f, 0.155f, 0.070f),
        Illuminant.D65,
        TransferParameters(1 / 0.45, 1 / 1.099, 0.099 / 1.099, 1 / 4.5, 0.081),
        id = 9,
    )

RGB color space SMPTE C. See details on SMPTE C color space

Common
val AdobeRgb =
    Rgb(
        "Adobe RGB (1998)",
        floatArrayOf(0.64f, 0.33f, 0.21f, 0.71f, 0.15f, 0.06f),
        Illuminant.D65,
        2.2,
        0.0f,
        1.0f,
        id = 10,
    )

RGB color space Adobe RGB (1998). See details on Adobe RGB (1998) color space

Common
val ProPhotoRgb =
    Rgb(
        "ROMM RGB ISO 22028-2:2013",
        floatArrayOf(0.7347f, 0.2653f, 0.1596f, 0.8404f, 0.0366f, 0.0001f),
        Illuminant.D50,
        TransferParameters(1.8, 1.0, 0.0, 1 / 16.0, 0.031248),
        id = 11,
    )

RGB color space ProPhoto RGB standardized as ROMM RGB ISO 22028-2:2013. See details on ProPhoto RGB color space

Common
val Aces =
    Rgb(
        "SMPTE ST 2065-1:2012 ACES",
        floatArrayOf(0.73470f, 0.26530f, 0.0f, 1.0f, 0.00010f, -0.0770f),
        Illuminant.D60,
        1.0,
        -65504.0f,
        65504.0f,
        id = 12,
    )

RGB color space ACES standardized as SMPTE ST 2065-1:2012. See details on ACES color space

Common
val Acescg =
    Rgb(
        "Academy S-2014-004 ACEScg",
        floatArrayOf(0.713f, 0.293f, 0.165f, 0.830f, 0.128f, 0.044f),
        Illuminant.D60,
        1.0,
        -65504.0f,
        65504.0f,
        id = 13,
    )

RGB color space ACEScg standardized as Academy S-2014-004. See details on ACEScg color space

Common
val CieXyz: ColorSpace

[XYZ]ColorModel.Xyz color space CIE XYZ. This color space assumes standard illuminant D50 as its white point.

| Property                | Value                 |
|-------------------------|-----------------------|
| Name                    | Generic XYZ           |
| CIE standard illuminant | [D50][Illuminant.D50] |
| Range                   | `[-2.0, 2.0]`         |
Common
val CieLab: ColorSpace

[Lab]ColorModel.Lab color space CIE Lab*. This color space uses CIE XYZ D50 as a profile conversion space.

| Property                | Value                                                   |
|-------------------------|---------------------------------------------------------|
| Name                    | Generic L*a*b*                                          |
| CIE standard illuminant | [D50][Illuminant.D50]                                   |
| Range                   | (L: `[0.0, 100.0]`, a: `[-128, 128]`, b: `[-128, 128]`) |
Common
val Bt2020Hlg =
    Rgb(
        "Hybrid Log Gamma encoding",
        Bt2020Primaries,
        Illuminant.D65,
        null,
        { x -> transferHlgOetf(Bt2020HlgTransferParameters, x) },
        { x -> transferHlgEotf(Bt2020HlgTransferParameters, x) },
        0.0f,
        1.0f,
        Bt2020HlgTransferParameters,
        id = 17,
    )

RGB color space BT.2100 standardized as Hybrid Log Gamma encoding

| Property                | Value                                                   |
|-------------------------|---------------------------------------------------------|
| Name                    | Hybrid Log Gamma encoding                               |
| CIE standard illuminant | [D65][Illuminant.D65]                                   |
| Range                   | `[0.0, 1.0]`                                            |
Common
val Bt2020Pq =
    Rgb(
        "Perceptual Quantizer encoding",
        Bt2020Primaries,
        Illuminant.D65,
        null,
        { x -> transferSt2048Oetf(Bt2020PqTransferParameters, x) },
        { x -> transferSt2048Eotf(Bt2020PqTransferParameters, x) },
        0.0f,
        1.0f,
        Bt2020PqTransferParameters,
        id = 18,
    )

RGB color space BT.2100 standardized as Perceptual Quantizer encoding

| Property                | Value                                                   |
|-------------------------|---------------------------------------------------------|
| Name                    | Perceptual Quantizer encoding                             |
| CIE standard illuminant | [D65][Illuminant.D65]                                   |
| Range                   | `[0.0, 1.0]`                                            |
Common
val Oklab: ColorSpace

[Lab]ColorModel.Lab color space Oklab. This color space uses Oklab D65 as a profile conversion space.

| Property                | Value                                                   |
|-------------------------|---------------------------------------------------------|
| Name                    | Oklab                                                   |
| CIE standard illuminant | [D65][Illuminant.D65]                                   |
| Range                   | (L: `[0.0, 1.0]`, a: `[-2, 2]`, b: `[-2, 2]`)           |

Functions

match

fun match(@Size(9) toXYZD50: FloatArray, function: TransferParameters): ColorSpace?

Returns a ColorSpaces instance of ColorSpace that matches the specified RGB to CIE XYZ transform and transfer functions. If no instance can be found, this method returns null.

The color transform matrix is assumed to target the CIE XYZ space a [D50]Illuminant.D50 standard illuminant.

Parameters
toXYZD50 3x3 column-major transform matrix from RGB to the profile connection space CIE XYZ as an array of 9 floats, cannot be null
function Parameters for the transfer functions

Returns
A non-null ColorSpace if a match is found, null otherwise