Added in API level 33

Summary: Constants | Methods | Inherited Methods

DataSpace

---

Kotlin |Java

public final class DataSpace
extends Object

java.lang.Object
↳	android.hardware.DataSpace

---

DataSpace identifies three components of colors - standard (primaries), transfer and range.

A DataSpace describes how buffer data, such as from an Image or a HardwareBuffer should be interpreted by both applications and typical hardware.

As buffer information is not guaranteed to be representative of color information, while DataSpace is typically used to describe three aspects of interpreting colors, some DataSpaces may describe other typical interpretations of buffer data such as depth information.

Note that while ColorSpace and DataSpace are similar concepts, they are not equivalent. Not all ColorSpaces, such as ColorSpace.Named.ACES, are able to be understood by typical hardware blocks so they cannot be DataSpaces.

Standard aspect

Defines the chromaticity coordinates of the source primaries in terms of the CIE 1931 definition of x and y specified in ISO 11664-1.

Transfer aspect

Transfer characteristics are the opto-electronic transfer characteristic at the source as a function of linear optical intensity (luminance).

For digital signals, E corresponds to the recorded value. Normally, the transfer function is applied in RGB space to each of the R, G and B components independently. This may result in color shift that can be minized by applying the transfer function in Lab space only for the L component. Implementation may apply the transfer function in RGB space for all pixel formats if desired.

Range aspect

Defines the range of values corresponding to the unit range of 0-1.

Summary

Constants
int	DATASPACE_ADOBE_RGB Adobe RGB encoding.
int	DATASPACE_BT2020 ITU-R Recommendation 2020 (BT.2020) Ultra High-definition television.
int	DATASPACE_BT2020_HLG Hybrid Log Gamma encoding.
int	DATASPACE_BT2020_PQ Perceptual Quantizer encoding.
int	DATASPACE_BT601_525 ITU-R Recommendation 709 (BT.709) High-definition television.
int	DATASPACE_BT601_625 ITU-R Recommendation 601 (BT.601) - 525-line Standard-definition television, 525 Lines (NTSC).
int	DATASPACE_BT709 ITU-R Recommendation 709 (BT.709) High-definition television.
int	DATASPACE_DCI_P3 SMPTE EG 432-1 and SMPTE RP 431-2 Digital Cinema DCI-P3.
int	DATASPACE_DEPTH Depth.
int	DATASPACE_DISPLAY_P3 Display P3 encoding.
int	DATASPACE_DYNAMIC_DEPTH ISO 16684-1:2011(E) Dynamic Depth.
int	DATASPACE_HEIF High Efficiency Image File Format (HEIF).
int	DATASPACE_HEIF_ULTRAHDR ISO/IEC 23008-12:2024 High Efficiency Image File Format (HEIF) with embedded HDR gain map This value is valid with formats: HAL_PIXEL_FORMAT_BLOB: A HEIC image encoded by HEVC encoder according to ISO/IEC 23008-12:2024 that includes an HDR gain map and metadata according to ISO/CD 21496\u20101.
int	DATASPACE_JFIF JPEG File Interchange Format (JFIF).
int	DATASPACE_JPEG_R Ultra HDR JPEG image with embedded HDR gain map following the Ultra HDR specification and starting with Android version V ISO/CD 21496\u20101 This value is valid with formats: HAL_PIXEL_FORMAT_BLOB: JPEG image encoded by Jpeg/R encoder according to ISO/CD 21496\u20101 The image contains a standard SDR JPEG and a gain map.
int	DATASPACE_SCRGB scRGB gamma encoding.
int	DATASPACE_SCRGB_LINEAR scRGB linear encoding.
int	DATASPACE_SRGB sRGB gamma encoding.
int	DATASPACE_SRGB_LINEAR sRGB linear encoding.
int	DATASPACE_UNKNOWN Default-assumption data space, when not explicitly specified.
int	RANGE_EXTENDED Extended range can be used in combination with FP16 to communicate scRGB or with SurfaceControl.Transaction.setExtendedRangeBrightness(SurfaceControl, float, float) to indicate an HDR range.
int	RANGE_FULL Full range uses all values for Y, Cb and Cr from 0 to 2^b-1, where b is the bit depth of the color format.
int	RANGE_LIMITED Limited range uses values 16/256*2^b to 235/256*2^b for Y, and 1/16*2^b to 15/16*2^b for Cb, Cr, R, G and B, where b is the bit depth of the color format.
int	RANGE_UNSPECIFIED Range characteristics are unknown or are determined by the application.
int	STANDARD_ADOBE_RGB Adobe RGB primaries.
int	STANDARD_BT2020 Use the unadjusted KR = 0.2627, KB = 0.0593 luminance interpretation for RGB conversion.
int	STANDARD_BT2020_CONSTANT_LUMINANCE Use the unadjusted KR = 0.2627, KB = 0.0593 luminance interpretation for RGB conversion using the linear domain.
int	STANDARD_BT470M Use the unadjusted KR = 0.30, KB = 0.11 luminance interpretation for RGB conversion.
int	STANDARD_BT601_525 Use the adjusted KR = 0.299, KB = 0.114 luminance interpretation for RGB conversion from the one purely determined by the primaries to minimize the color shift into RGB space that uses BT.709 primaries.
int	STANDARD_BT601_525_UNADJUSTED Use the unadjusted KR = 0.212, KB = 0.087 luminance interpretation for RGB conversion (as in SMPTE 240M).
int	STANDARD_BT601_625 Use the adjusted KR = 0.299, KB = 0.114 luminance interpretation for RGB conversion from the one purely determined by the primaries to minimize the color shift into RGB space that uses BT.709 primaries.
int	STANDARD_BT601_625_UNADJUSTED Use the unadjusted KR = 0.222, KB = 0.071 luminance interpretation for RGB conversion.
int	STANDARD_BT709 Use the unadjusted KR = 0.2126, KB = 0.0722 luminance interpretation for RGB conversion.
int	STANDARD_DCI_P3 SMPTE EG 432-1 and SMPTE RP 431-2.
int	STANDARD_FILM Use the unadjusted KR = 0.254, KB = 0.068 luminance interpretation for RGB conversion.
int	STANDARD_UNSPECIFIED Chromacity coordinates are unknown or are determined by the application.
int	TRANSFER_GAMMA2_2 Display gamma 2.2.
int	TRANSFER_GAMMA2_6 Display gamma 2.6.
int	TRANSFER_GAMMA2_8 Display gamma 2.8.
int	TRANSFER_HLG ARIB STD-B67 Hybrid Log Gamma.
int	TRANSFER_LINEAR Linear transfer.
int	TRANSFER_SMPTE_170M SMPTE 170M transfer.
int	TRANSFER_SRGB sRGB transfer.
int	TRANSFER_ST2084 SMPTE ST 2084 (Dolby Perceptual Quantizer).
int	TRANSFER_UNSPECIFIED Transfer characteristics are unknown or are determined by the application.

Public methods
static int	getRange(int dataSpace) Unpack the range field value from the packed dataSpace value
static int	getStandard(int dataSpace) Unpack the standard field value from the packed dataSpace value.
static int	getTransfer(int dataSpace) Unpack the transfer field value from the packed dataSpace value
static int	pack(int standard, int transfer, int range) Pack the dataSpace value using standard, transfer and range field value.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

DATASPACE_ADOBE_RGB

Added in API level 33

public static final int DATASPACE_ADOBE_RGB

Adobe RGB encoding.

Composed of the following -

   Primaries: STANDARD_ADOBE_RGB
   Transfer: TRANSFER_GAMMA2_2
   Range: RANGE_FULL

Note: Application is responsible for gamma encoding the data.

Constant Value: 151715840 (0x090b0000)

DATASPACE_BT2020

Added in API level 33

public static final int DATASPACE_BT2020

ITU-R Recommendation 2020 (BT.2020) Ultra High-definition television.

Composed of the following -

   Primaries: STANDARD_BT2020
   Transfer: TRANSFER_SMPTE_170M
   Range: RANGE_FULL

Constant Value: 147193856 (0x08c60000)

DATASPACE_BT2020_HLG

Added in API level 34

public static final int DATASPACE_BT2020_HLG

Hybrid Log Gamma encoding.

Composed of the following -

   Primaries: STANDARD_BT2020
   Transfer: TRANSFER_HLG
   Range: RANGE_FULL

Constant Value: 168165376 (0x0a060000)

DATASPACE_BT2020_PQ

Added in API level 33

public static final int DATASPACE_BT2020_PQ

Perceptual Quantizer encoding.

Composed of the following -

   Primaries: STANDARD_BT2020
   Transfer: TRANSFER_ST2084
   Range: RANGE_FULL

Constant Value: 163971072 (0x09c60000)

DATASPACE_BT601_525

Added in API level 33

public static final int DATASPACE_BT601_525

ITU-R Recommendation 709 (BT.709) High-definition television.

Composed of the following -

   Primaries: STANDARD_BT601_525
   Transfer: TRANSFER_SMPTE_170M
   Range: RANGE_LIMITED

Constant Value: 281280512 (0x10c40000)

DATASPACE_BT601_625

Added in API level 33

public static final int DATASPACE_BT601_625

ITU-R Recommendation 601 (BT.601) - 525-line Standard-definition television, 525 Lines (NTSC).

Composed of the following -

   Primaries: STANDARD_BT601_625
   Transfer: TRANSFER_SMPTE_170M
   Range: RANGE_LIMITED

Constant Value: 281149440 (0x10c20000)

DATASPACE_BT709

Added in API level 33

public static final int DATASPACE_BT709

ITU-R Recommendation 709 (BT.709) High-definition television.

Composed of the following -

   Primaries: STANDARD_BT709
   Transfer: TRANSFER_SMPTE_170M
   Range: RANGE_LIMITED

Constant Value: 281083904 (0x10c10000)

DATASPACE_DCI_P3

Added in API level 33

public static final int DATASPACE_DCI_P3

SMPTE EG 432-1 and SMPTE RP 431-2 Digital Cinema DCI-P3.

Composed of the following -

   Primaries: STANDARD_DCI_P3
   Transfer: TRANSFER_GAMMA2_6
   Range: RANGE_FULL

Note: Application is responsible for gamma encoding the data as a 2.6 gamma encoding is not supported in HW.

Constant Value: 155844608 (0x094a0000)

DATASPACE_DEPTH

Added in API level 34

public static final int DATASPACE_DEPTH

Depth. This value is valid with formats HAL_PIXEL_FORMAT_Y16 and HAL_PIXEL_FORMAT_BLOB.

Constant Value: 4096 (0x00001000)

DATASPACE_DISPLAY_P3

Added in API level 33

public static final int DATASPACE_DISPLAY_P3

Display P3 encoding.

Composed of the following -

   Primaries: STANDARD_DCI_P3
   Transfer: TRANSFER_SRGB
   Range: RANGE_FULL

Constant Value: 143261696 (0x088a0000)

DATASPACE_DYNAMIC_DEPTH

Added in API level 34

public static final int DATASPACE_DYNAMIC_DEPTH

ISO 16684-1:2011(E) Dynamic Depth. Embedded depth metadata following the dynamic depth specification.

Constant Value: 4098 (0x00001002)

DATASPACE_HEIF

Added in API level 34

public static final int DATASPACE_HEIF

High Efficiency Image File Format (HEIF).

This value is valid with HardwareBuffer.BLOB format. The combination is an HEIC image encoded by HEIC or HEVC encoder according to ISO/IEC 23008-12.

Constant Value: 4100 (0x00001004)

DATASPACE_HEIF_ULTRAHDR

Added in API level 36

public static final int DATASPACE_HEIF_ULTRAHDR

ISO/IEC 23008-12:2024 High Efficiency Image File Format (HEIF) with embedded HDR gain map

This value is valid with formats:

• HAL_PIXEL_FORMAT_BLOB: A HEIC image encoded by HEVC encoder according to ISO/IEC 23008-12:2024 that includes an HDR gain map and metadata according to ISO/CD 21496\u20101.

Constant Value: 4102 (0x00001006)

DATASPACE_JFIF

Added in API level 33

public static final int DATASPACE_JFIF

JPEG File Interchange Format (JFIF).

Composed of the following -

   Primaries: STANDARD_BT601_625
   Transfer: TRANSFER_SMPTE_170M
   Range: RANGE_FULL

Same model as BT.601-625, but all values (Y, Cb, Cr) range from 0 to 255

Constant Value: 146931712 (0x08c20000)

DATASPACE_JPEG_R

Added in API level 34

public static final int DATASPACE_JPEG_R

Ultra HDR JPEG image with embedded HDR gain map following the Ultra HDR specification and starting with Android version V ISO/CD 21496\u20101

This value is valid with formats:

• HAL_PIXEL_FORMAT_BLOB: JPEG image encoded by Jpeg/R encoder according to ISO/CD 21496\u20101

The image contains a standard SDR JPEG and a gain map. Ultra HDR decoders can use the gain map to boost the brightness of the rendered image.

Constant Value: 4101 (0x00001005)

DATASPACE_SCRGB

Added in API level 33

public static final int DATASPACE_SCRGB

scRGB gamma encoding.

Composed of the following -

   Primaries: STANDARD_BT709
   Transfer: TRANSFER_SRGB
   Range: RANGE_EXTENDED

The values are floating point. A pixel value of 1.0, 1.0, 1.0 corresponds to sRGB white (D65) at 80 nits. Values beyond the range [0.0 - 1.0] would correspond to other colors spaces and/or HDR content.

Constant Value: 411107328 (0x18810000)

DATASPACE_SCRGB_LINEAR

Added in API level 33

public static final int DATASPACE_SCRGB_LINEAR

scRGB linear encoding.

Composed of the following -

   Primaries: STANDARD_BT709
   Transfer: TRANSFER_LINEAR
   Range: RANGE_EXTENDED

The values are floating point. A pixel value of 1.0, 1.0, 1.0 corresponds to sRGB white (D65) at 80 nits. Values beyond the range [0.0 - 1.0] would correspond to other colors spaces and/or HDR content.

Constant Value: 406913024 (0x18410000)

DATASPACE_SRGB

Added in API level 33

public static final int DATASPACE_SRGB

sRGB gamma encoding.

Composed of the following -

   Primaries: STANDARD_BT709
   Transfer: TRANSFER_SRGB
   Range: RANGE_FULL

When written, the inverse transformation is performed. The alpha component, if present, is always stored in linear space and is left unmodified when read or written.

Constant Value: 142671872 (0x08810000)

DATASPACE_SRGB_LINEAR

Added in API level 33

public static final int DATASPACE_SRGB_LINEAR

sRGB linear encoding.

Composed of the following -

   Primaries: STANDARD_BT709
   Transfer: TRANSFER_LINEAR
   Range: RANGE_FULL

The values are encoded using the full range ([0,255] for 8-bit) for all components.

Constant Value: 138477568 (0x08410000)

DATASPACE_UNKNOWN

Added in API level 33

public static final int DATASPACE_UNKNOWN

Default-assumption data space, when not explicitly specified.

It is safest to assume a buffer is an image with sRGB primaries and encoding ranges, but the consumer and/or the producer of the data may simply be using defaults. No automatic gamma transform should be expected, except for a possible display gamma transform when drawn to a screen.

Constant Value: 0 (0x00000000)

RANGE_EXTENDED

Added in API level 33

public static final int RANGE_EXTENDED

Extended range can be used in combination with FP16 to communicate scRGB or with SurfaceControl.Transaction.setExtendedRangeBrightness(SurfaceControl, float, float) to indicate an HDR range.

When used with floating point pixel formats and #STANDARD_BT709 then [0.0 - 1.0] is the standard sRGB space and values outside the range [0.0 - 1.0] can encode color outside the sRGB gamut. [-0.5, 7.5] is the standard scRGB range. Used to blend/merge multiple dataspaces on a single display.

As of Build.VERSION_CODES.UPSIDE_DOWN_CAKE this may be combined with SurfaceControl.Transaction.setExtendedRangeBrightness(SurfaceControl, float, float) and other formats such as HardwareBuffer.RGBA_8888 or HardwareBuffer.RGBA_1010102 to communicate a variable HDR brightness range

Constant Value: 402653184 (0x18000000)

RANGE_FULL

Added in API level 33

public static final int RANGE_FULL

Full range uses all values for Y, Cb and Cr from 0 to 2^b-1, where b is the bit depth of the color format.

Constant Value: 134217728 (0x08000000)

RANGE_LIMITED

Added in API level 33

public static final int RANGE_LIMITED

Limited range uses values 16/256*2^b to 235/256*2^b for Y, and 1/16*2^b to 15/16*2^b for Cb, Cr, R, G and B, where b is the bit depth of the color format.

E.g. For 8-bit-depth formats: Luma (Y) samples should range from 16 to 235, inclusive Chroma (Cb, Cr) samples should range from 16 to 240, inclusive For 10-bit-depth formats: Luma (Y) samples should range from 64 to 940, inclusive Chroma (Cb, Cr) samples should range from 64 to 960, inclusive.

Constant Value: 268435456 (0x10000000)

RANGE_UNSPECIFIED

Added in API level 33

public static final int RANGE_UNSPECIFIED

Range characteristics are unknown or are determined by the application.

Constant Value: 0 (0x00000000)

STANDARD_ADOBE_RGB

Added in API level 33

public static final int STANDARD_ADOBE_RGB

Adobe RGB primaries.

 Primaries:       x       y
  green           0.210   0.710
  blue            0.150   0.060
  red             0.640   0.330
  white (D65)     0.3127  0.3290 

Constant Value: 720896 (0x000b0000)

STANDARD_BT2020

Added in API level 33

public static final int STANDARD_BT2020

Use the unadjusted KR = 0.2627, KB = 0.0593 luminance interpretation for RGB conversion.

 Primaries:       x       y
  green           0.170   0.797
  blue            0.131   0.046
  red             0.708   0.292
  white (D65)     0.3127  0.3290 

Constant Value: 393216 (0x00060000)

STANDARD_BT2020_CONSTANT_LUMINANCE

Added in API level 33

public static final int STANDARD_BT2020_CONSTANT_LUMINANCE

Use the unadjusted KR = 0.2627, KB = 0.0593 luminance interpretation for RGB conversion using the linear domain.

 Primaries:       x       y
  green           0.170   0.797
  blue            0.131   0.046
  red             0.708   0.292
  white (D65)     0.3127  0.3290 

Constant Value: 458752 (0x00070000)

STANDARD_BT470M

Added in API level 33

public static final int STANDARD_BT470M

Use the unadjusted KR = 0.30, KB = 0.11 luminance interpretation for RGB conversion.

 Primaries:       x      y
  green           0.21   0.71
  blue            0.14   0.08
  red             0.67   0.33
  white (C)       0.310  0.316 

Constant Value: 524288 (0x00080000)

STANDARD_BT601_525

Added in API level 33

public static final int STANDARD_BT601_525

Use the adjusted KR = 0.299, KB = 0.114 luminance interpretation for RGB conversion from the one purely determined by the primaries to minimize the color shift into RGB space that uses BT.709 primaries.

 Primaries:       x       y
  green           0.310   0.595
  blue            0.155   0.070
  red             0.630   0.340
  white (D65)     0.3127  0.3290 

Constant Value: 262144 (0x00040000)

STANDARD_BT601_525_UNADJUSTED

Added in API level 33

public static final int STANDARD_BT601_525_UNADJUSTED

Use the unadjusted KR = 0.212, KB = 0.087 luminance interpretation for RGB conversion (as in SMPTE 240M).

 Primaries:       x       y
  green           0.310   0.595
  blue            0.155   0.070
  red             0.630   0.340
  white (D65)     0.3127  0.3290 

Constant Value: 327680 (0x00050000)

STANDARD_BT601_625

Added in API level 33

public static final int STANDARD_BT601_625

Use the adjusted KR = 0.299, KB = 0.114 luminance interpretation for RGB conversion from the one purely determined by the primaries to minimize the color shift into RGB space that uses BT.709 primaries.

 Primaries:       x       y
  green           0.290   0.600
  blue            0.150   0.060
  red             0.640   0.330
  white (D65)     0.3127  0.3290 

Constant Value: 131072 (0x00020000)

STANDARD_BT601_625_UNADJUSTED

Added in API level 33

public static final int STANDARD_BT601_625_UNADJUSTED

Use the unadjusted KR = 0.222, KB = 0.071 luminance interpretation for RGB conversion.

 Primaries:       x       y
  green           0.290   0.600
  blue            0.150   0.060
  red             0.640   0.330
  white (D65)     0.3127  0.3290 

Constant Value: 196608 (0x00030000)

STANDARD_BT709

Added in API level 33

public static final int STANDARD_BT709

Use the unadjusted KR = 0.2126, KB = 0.0722 luminance interpretation for RGB conversion.

 Primaries:       x       y
  green           0.300   0.600
  blue            0.150   0.060
  red             0.640   0.330
  white (D65)     0.3127  0.3290 

Constant Value: 65536 (0x00010000)

STANDARD_DCI_P3

Added in API level 33

public static final int STANDARD_DCI_P3

SMPTE EG 432-1 and SMPTE RP 431-2.

 Primaries:       x       y
  green           0.265   0.690
  blue            0.150   0.060
  red             0.680   0.320
  white (D65)     0.3127  0.3290 

Constant Value: 655360 (0x000a0000)

STANDARD_FILM

Added in API level 33

public static final int STANDARD_FILM

Use the unadjusted KR = 0.254, KB = 0.068 luminance interpretation for RGB conversion.

 Primaries:       x       y
  green           0.243   0.692
  blue            0.145   0.049
  red             0.681   0.319
  white (C)       0.310   0.316 

Constant Value: 589824 (0x00090000)

STANDARD_UNSPECIFIED

Added in API level 33

public static final int STANDARD_UNSPECIFIED

Chromacity coordinates are unknown or are determined by the application.

Constant Value: 0 (0x00000000)

TRANSFER_GAMMA2_2

Added in API level 33

public static final int TRANSFER_GAMMA2_2

Display gamma 2.2.

Transfer characteristic curve:
 E = L ^ (1/2.2)
     L - luminance of image 0 <= L <= 1 for conventional colorimetry
     E - corresponding electrical signal

Constant Value: 16777216 (0x01000000)

TRANSFER_GAMMA2_6

Added in API level 33

public static final int TRANSFER_GAMMA2_6

Display gamma 2.6.

Transfer characteristic curve:
 E = L ^ (1/2.6)
     L - luminance of image 0 <= L <= 1 for conventional colorimetry
     E - corresponding electrical signal

Constant Value: 20971520 (0x01400000)

TRANSFER_GAMMA2_8

Added in API level 33

public static final int TRANSFER_GAMMA2_8

Display gamma 2.8.

Transfer characteristic curve:
 E = L ^ (1/2.8)
     L - luminance of image 0 <= L <= 1 for conventional colorimetry
     E - corresponding electrical signal

Constant Value: 25165824 (0x01800000)

TRANSFER_HLG

Added in API level 33

public static final int TRANSFER_HLG

ARIB STD-B67 Hybrid Log Gamma.

Transfer characteristic curve:
 E = r * L^0.5                 for 0 <= L <= 1
   = a * ln(L - b) + c         for 1 < L
 a = 0.17883277
 b = 0.28466892
 c = 0.55991073
 r = 0.5
     L - luminance of image 0 <= L for HDR colorimetry. L = 1 corresponds
         to reference white level of 100 cd/m2
     E - corresponding electrical signal

Constant Value: 33554432 (0x02000000)

TRANSFER_LINEAR

Added in API level 33

public static final int TRANSFER_LINEAR

Linear transfer.

Transfer characteristic curve:
  E = L
      L - luminance of image 0 <= L <= 1 for conventional colorimetry
      E - corresponding electrical signal

Constant Value: 4194304 (0x00400000)

TRANSFER_SMPTE_170M

Added in API level 33

public static final int TRANSFER_SMPTE_170M

SMPTE 170M transfer.

Transfer characteristic curve:
 E = 1.099 * L ^ 0.45 - 0.099  for 0.018 <= L <= 1
   = 4.500 * L                 for 0 <= L < 0.018
     L - luminance of image 0 <= L <= 1 for conventional colorimetry
     E - corresponding electrical signal

Use for YCbCr formats.

Constant Value: 12582912 (0x00c00000)

TRANSFER_SRGB

Added in API level 33

public static final int TRANSFER_SRGB

sRGB transfer.

Transfer characteristic curve:
 E = 1.055 * L^(1/2.4) - 0.055  for 0.0031308 <= L <= 1
   = 12.92 * L                  for 0 <= L < 0.0031308
     L - luminance of image 0 <= L <= 1 for conventional colorimetry
     E - corresponding electrical signal

Use for RGB formats.

Constant Value: 8388608 (0x00800000)

TRANSFER_ST2084

Added in API level 33

public static final int TRANSFER_ST2084

SMPTE ST 2084 (Dolby Perceptual Quantizer).

Transfer characteristic curve:
 E = ((c1 + c2 * L^n) / (1 + c3 * L^n)) ^ m
 c1 = c3 - c2 + 1 = 3424 / 4096 = 0.8359375
 c2 = 32 * 2413 / 4096 = 18.8515625
 c3 = 32 * 2392 / 4096 = 18.6875
 m = 128 * 2523 / 4096 = 78.84375
 n = 0.25 * 2610 / 4096 = 0.1593017578125
     L - luminance of image 0 <= L <= 1 for HDR colorimetry.
         L = 1 corresponds to 10000 cd/m2
     E - corresponding electrical signal

Constant Value: 29360128 (0x01c00000)

TRANSFER_UNSPECIFIED

Added in API level 33

public static final int TRANSFER_UNSPECIFIED

Transfer characteristics are unknown or are determined by the application.

Constant Value: 0 (0x00000000)

Public methods

getRange

Added in API level 33

public static int getRange (int dataSpace)

Unpack the range field value from the packed dataSpace value

Parameters
dataSpace	int: The packed dataspace value Value is either 0 or a combination of DATASPACE_UNKNOWN, DATASPACE_SCRGB_LINEAR, DATASPACE_SRGB, DATASPACE_SCRGB, DATASPACE_DISPLAY_P3, DATASPACE_BT2020_HLG, DATASPACE_BT2020_PQ, DATASPACE_ADOBE_RGB, DATASPACE_JFIF, DATASPACE_BT601_625, DATASPACE_BT601_525, DATASPACE_BT2020, DATASPACE_BT709, DATASPACE_DCI_P3, and DATASPACE_SRGB_LINEAR

Returns
int	The range aspect Value is either 0 or a combination of RANGE_UNSPECIFIED, RANGE_FULL, RANGE_LIMITED, and RANGE_EXTENDED

getStandard

Added in API level 33

public static int getStandard (int dataSpace)

Unpack the standard field value from the packed dataSpace value.

Parameters
dataSpace	int: The packed dataspace value Value is either 0 or a combination of DATASPACE_UNKNOWN, DATASPACE_SCRGB_LINEAR, DATASPACE_SRGB, DATASPACE_SCRGB, DATASPACE_DISPLAY_P3, DATASPACE_BT2020_HLG, DATASPACE_BT2020_PQ, DATASPACE_ADOBE_RGB, DATASPACE_JFIF, DATASPACE_BT601_625, DATASPACE_BT601_525, DATASPACE_BT2020, DATASPACE_BT709, DATASPACE_DCI_P3, and DATASPACE_SRGB_LINEAR

Returns
int	The standard aspect Value is either 0 or a combination of STANDARD_UNSPECIFIED, STANDARD_BT709, STANDARD_BT601_625, STANDARD_BT601_625_UNADJUSTED, STANDARD_BT601_525, STANDARD_BT601_525_UNADJUSTED, STANDARD_BT2020, STANDARD_BT2020_CONSTANT_LUMINANCE, STANDARD_BT470M, STANDARD_FILM, STANDARD_DCI_P3, and STANDARD_ADOBE_RGB

getTransfer

Added in API level 33

public static int getTransfer (int dataSpace)

Unpack the transfer field value from the packed dataSpace value

Parameters
dataSpace	int: The packed dataspace value Value is either 0 or a combination of DATASPACE_UNKNOWN, DATASPACE_SCRGB_LINEAR, DATASPACE_SRGB, DATASPACE_SCRGB, DATASPACE_DISPLAY_P3, DATASPACE_BT2020_HLG, DATASPACE_BT2020_PQ, DATASPACE_ADOBE_RGB, DATASPACE_JFIF, DATASPACE_BT601_625, DATASPACE_BT601_525, DATASPACE_BT2020, DATASPACE_BT709, DATASPACE_DCI_P3, and DATASPACE_SRGB_LINEAR

Returns
int	The transfer aspect Value is either 0 or a combination of TRANSFER_UNSPECIFIED, TRANSFER_LINEAR, TRANSFER_SRGB, TRANSFER_SMPTE_170M, TRANSFER_GAMMA2_2, TRANSFER_GAMMA2_6, TRANSFER_GAMMA2_8, TRANSFER_ST2084, and TRANSFER_HLG

pack

Added in API level 33

public static int pack (int standard, 
                int transfer, 
                int range)

Pack the dataSpace value using standard, transfer and range field value. Field values should be in the correct bits place.

Parameters
standard	int: Chromaticity coordinates of source primaries Value is either 0 or a combination of STANDARD_UNSPECIFIED, STANDARD_BT709, STANDARD_BT601_625, STANDARD_BT601_625_UNADJUSTED, STANDARD_BT601_525, STANDARD_BT601_525_UNADJUSTED, STANDARD_BT2020, STANDARD_BT2020_CONSTANT_LUMINANCE, STANDARD_BT470M, STANDARD_FILM, STANDARD_DCI_P3, and STANDARD_ADOBE_RGB
transfer	int: Opto-electronic transfer characteristic at the source Value is either 0 or a combination of TRANSFER_UNSPECIFIED, TRANSFER_LINEAR, TRANSFER_SRGB, TRANSFER_SMPTE_170M, TRANSFER_GAMMA2_2, TRANSFER_GAMMA2_6, TRANSFER_GAMMA2_8, TRANSFER_ST2084, and TRANSFER_HLG
range	int: The range of values Value is either 0 or a combination of RANGE_UNSPECIFIED, RANGE_FULL, RANGE_LIMITED, and RANGE_EXTENDED

Returns
int	The int dataspace packed by standard, transfer and range value Value is either 0 or a combination of DATASPACE_UNKNOWN, DATASPACE_SCRGB_LINEAR, DATASPACE_SRGB, DATASPACE_SCRGB, DATASPACE_DISPLAY_P3, DATASPACE_BT2020_HLG, DATASPACE_BT2020_PQ, DATASPACE_ADOBE_RGB, DATASPACE_JFIF, DATASPACE_BT601_625, DATASPACE_BT601_525, DATASPACE_BT2020, DATASPACE_BT709, DATASPACE_DCI_P3, and DATASPACE_SRGB_LINEAR