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_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/2562^b` to `235/2562^b` for Y, and `1/162^b` to `15/162^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_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

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

 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

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`

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

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`

dataSpace

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

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`

dataSpace

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

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`

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