DataSpace
class DataSpace
| kotlin.Any | |
| ↳ | 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 | |
|---|---|
| static Int |
Adobe RGB encoding. |
| static Int |
ITU-R Recommendation 2020 (BT.2020) Ultra High-definition television. |
| static Int |
Hybrid Log Gamma encoding. |
| static Int |
Perceptual Quantizer encoding. |
| static Int |
ITU-R Recommendation 709 (BT.709) High-definition television. |
| static Int |
ITU-R Recommendation 601 (BT.601) - 525-line Standard-definition television, 525 Lines (NTSC). |
| static Int |
ITU-R Recommendation 709 (BT.709) High-definition television. |
| static Int |
SMPTE EG 432-1 and SMPTE RP 431-2 Digital Cinema DCI-P3. |
| static Int |
Depth. |
| static Int |
Display P3 encoding. |
| static Int |
ISO 16684-1:2011(E) Dynamic Depth. |
| static Int |
High Efficiency Image File Format (HEIF). |
| static Int |
JPEG File Interchange Format (JFIF). |
| static Int |
Ultra HDR JPEG image with embedded HDR gain map following the Ultra HDR specification and starting with Android version |
| static Int |
scRGB gamma encoding. |
| static Int |
scRGB linear encoding. |
| static Int |
sRGB gamma encoding. |
| static Int |
sRGB linear encoding. |
| static Int |
Default-assumption data space, when not explicitly specified. |
| static Int |
Extended range can be used in combination with FP16 to communicate scRGB or with |
| static Int |
Full range uses all values for Y, Cb and Cr from |
| static Int |
Limited range uses values |
| static Int |
Range characteristics are unknown or are determined by the application. |
| static Int |
Adobe RGB primaries. |
| static Int |
Use the unadjusted |
| static Int |
Use the unadjusted |
| static Int |
Use the unadjusted |
| static Int |
Use the adjusted |
| static Int |
Use the unadjusted |
| static Int |
Use the adjusted |
| static Int |
Use the unadjusted |
| static Int |
Use the unadjusted |
| static Int |
SMPTE EG 432-1 and SMPTE RP 431-2. |
| static Int |
Use the unadjusted |
| static Int |
Chromacity coordinates are unknown or are determined by the application. |
| static Int |
Display gamma 2. |
| static Int |
Display gamma 2. |
| static Int |
Display gamma 2. |
| static Int |
ARIB STD-B67 Hybrid Log Gamma. |
| static Int |
Linear transfer. |
| static Int |
SMPTE 170M transfer. |
| static Int |
sRGB transfer. |
| static Int |
SMPTE ST 2084 (Dolby Perceptual Quantizer). |
| static Int |
Transfer characteristics are unknown or are determined by the application. |
| Public methods | |
|---|---|
| static Int |
Unpack the range field value from the packed dataSpace value |
| static Int |
getStandard(dataSpace: Int)Unpack the standard field value from the packed dataSpace value. |
| static Int |
getTransfer(dataSpace: Int)Unpack the transfer field value from the packed dataSpace value |
| static Int |
Pack the dataSpace value using standard, transfer and range field value. |
Constants
DATASPACE_ADOBE_RGB
static val DATASPACE_ADOBE_RGB: Int
Adobe RGB encoding.
Composed of the following -
Primaries: STANDARD_ADOBE_RGB Transfer: TRANSFER_GAMMA2_2 Range: RANGE_FULL
Value: 151715840DATASPACE_BT2020
static val DATASPACE_BT2020: Int
ITU-R Recommendation 2020 (BT.2020) Ultra High-definition television.
Composed of the following -
Primaries: STANDARD_BT2020 Transfer: TRANSFER_SMPTE_170M Range: RANGE_FULL
Value: 147193856DATASPACE_BT2020_HLG
static val DATASPACE_BT2020_HLG: Int
Hybrid Log Gamma encoding.
Composed of the following -
Primaries: STANDARD_BT2020 Transfer: TRANSFER_HLG Range: RANGE_FULL
Value: 168165376DATASPACE_BT2020_PQ
static val DATASPACE_BT2020_PQ: Int
Perceptual Quantizer encoding.
Composed of the following -
Primaries: STANDARD_BT2020 Transfer: TRANSFER_ST2084 Range: RANGE_FULL
Value: 163971072DATASPACE_BT601_525
static val DATASPACE_BT601_525: Int
ITU-R Recommendation 709 (BT.709) High-definition television.
Composed of the following -
Primaries: STANDARD_BT601_525 Transfer: TRANSFER_SMPTE_170M Range: RANGE_LIMITED
Value: 281280512DATASPACE_BT601_625
static val DATASPACE_BT601_625: Int
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
Value: 281149440DATASPACE_BT709
static val DATASPACE_BT709: Int
ITU-R Recommendation 709 (BT.709) High-definition television.
Composed of the following -
Primaries: STANDARD_BT709 Transfer: TRANSFER_SMPTE_170M Range: RANGE_LIMITED
Value: 281083904DATASPACE_DCI_P3
static val DATASPACE_DCI_P3: Int
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
Value: 155844608DATASPACE_DEPTH
static val DATASPACE_DEPTH: Int
Depth. This value is valid with formats HAL_PIXEL_FORMAT_Y16 and HAL_PIXEL_FORMAT_BLOB.
Value: 4096DATASPACE_DISPLAY_P3
static val DATASPACE_DISPLAY_P3: Int
Display P3 encoding.
Composed of the following -
Primaries: STANDARD_DCI_P3 Transfer: TRANSFER_SRGB Range: RANGE_FULL
Value: 143261696DATASPACE_DYNAMIC_DEPTH
static val DATASPACE_DYNAMIC_DEPTH: Int
ISO 16684-1:2011(E) Dynamic Depth. Embedded depth metadata following the dynamic depth specification.
Value: 4098DATASPACE_HEIF
static val DATASPACE_HEIF: Int
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.
Value: 4100DATASPACE_JFIF
static val DATASPACE_JFIF: Int
JPEG File Interchange Format (JFIF).
Composed of the following -
Primaries: STANDARD_BT601_625 Transfer: TRANSFER_SMPTE_170M Range: RANGE_FULL
0 to 255
Value: 146931712DATASPACE_JPEG_R
static val DATASPACE_JPEG_R: Int
Ultra HDR JPEG image with embedded HDR gain map following the Ultra HDR specification and starting with Android version V ISO/CD 21496‐1
This value is valid with formats:
- HAL_PIXEL_FORMAT_BLOB: JPEG image encoded by Jpeg/R encoder according to ISO/CD 21496‐1
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.
Value: 4101DATASPACE_SCRGB
static val DATASPACE_SCRGB: Int
scRGB gamma encoding.
Composed of the following -
Primaries: STANDARD_BT709 Transfer: TRANSFER_SRGB Range: RANGE_EXTENDED
Value: 411107328DATASPACE_SCRGB_LINEAR
static val DATASPACE_SCRGB_LINEAR: Int
scRGB linear encoding.
Composed of the following -
Primaries: STANDARD_BT709 Transfer: TRANSFER_LINEAR Range: RANGE_EXTENDED
Value: 406913024DATASPACE_SRGB
static val DATASPACE_SRGB: Int
sRGB gamma encoding.
Composed of the following -
Primaries: STANDARD_BT709 Transfer: TRANSFER_SRGB Range: RANGE_FULL
Value: 142671872DATASPACE_SRGB_LINEAR
static val DATASPACE_SRGB_LINEAR: Int
sRGB linear encoding.
Composed of the following -
Primaries: STANDARD_BT709 Transfer: TRANSFER_LINEAR Range: RANGE_FULL
Value: 138477568DATASPACE_UNKNOWN
static val DATASPACE_UNKNOWN: Int
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.
Value: 0RANGE_EXTENDED
static val RANGE_EXTENDED: Int
Extended range can be used in combination with FP16 to communicate scRGB or with android.view.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 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE this may be combined with android.view.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
Value: 402653184RANGE_FULL
static val RANGE_FULL: Int
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.
Value: 134217728RANGE_LIMITED
static val RANGE_LIMITED: Int
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.
Value: 268435456RANGE_UNSPECIFIED
static val RANGE_UNSPECIFIED: Int
Range characteristics are unknown or are determined by the application.
Value: 0STANDARD_ADOBE_RGB
static val STANDARD_ADOBE_RGB: Int
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
Value: 720896STANDARD_BT2020
static val STANDARD_BT2020: Int
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
Value: 393216STANDARD_BT2020_CONSTANT_LUMINANCE
static val STANDARD_BT2020_CONSTANT_LUMINANCE: Int
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
Value: 458752STANDARD_BT470M
static val STANDARD_BT470M: Int
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
Value: 524288STANDARD_BT601_525
static val STANDARD_BT601_525: Int
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
Value: 262144STANDARD_BT601_525_UNADJUSTED
static val STANDARD_BT601_525_UNADJUSTED: Int
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
Value: 327680STANDARD_BT601_625
static val STANDARD_BT601_625: Int
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
Value: 131072STANDARD_BT601_625_UNADJUSTED
static val STANDARD_BT601_625_UNADJUSTED: Int
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
Value: 196608STANDARD_BT709
static val STANDARD_BT709: Int
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
Value: 65536STANDARD_DCI_P3
static val STANDARD_DCI_P3: Int
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
Value: 655360STANDARD_FILM
static val STANDARD_FILM: Int
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
Value: 589824STANDARD_UNSPECIFIED
static val STANDARD_UNSPECIFIED: Int
Chromacity coordinates are unknown or are determined by the application.
Value: 0TRANSFER_GAMMA2_2
static val TRANSFER_GAMMA2_2: Int
Display gamma 2.2.
<code>Transfer characteristic curve: E = L ^ (1/2.2) L - luminance of image 0 <= L <= 1 for conventional colorimetry E - corresponding electrical signal</code>
Value: 16777216TRANSFER_GAMMA2_6
static val TRANSFER_GAMMA2_6: Int
Display gamma 2.6.
<code>Transfer characteristic curve: E = L ^ (1/2.6) L - luminance of image 0 <= L <= 1 for conventional colorimetry E - corresponding electrical signal</code>
Value: 20971520TRANSFER_GAMMA2_8
static val TRANSFER_GAMMA2_8: Int
Display gamma 2.8.
<code>Transfer characteristic curve: E = L ^ (1/2.8) L - luminance of image 0 <= L <= 1 for conventional colorimetry E - corresponding electrical signal</code>
Value: 25165824TRANSFER_HLG
static val TRANSFER_HLG: Int
ARIB STD-B67 Hybrid Log Gamma.
<code>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</code>
Value: 33554432TRANSFER_LINEAR
static val TRANSFER_LINEAR: Int
Linear transfer.
<code>Transfer characteristic curve: E = L L - luminance of image 0 <= L <= 1 for conventional colorimetry E - corresponding electrical signal</code>
Value: 4194304TRANSFER_SMPTE_170M
static val TRANSFER_SMPTE_170M: Int
SMPTE 170M transfer.
<code>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</code>
Value: 12582912TRANSFER_SRGB
static val TRANSFER_SRGB: Int
sRGB transfer.
<code>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</code>
Value: 8388608TRANSFER_ST2084
static val TRANSFER_ST2084: Int
SMPTE ST 2084 (Dolby Perceptual Quantizer).
<code>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</code>
Value: 29360128TRANSFER_UNSPECIFIED
static val TRANSFER_UNSPECIFIED: Int
Transfer characteristics are unknown or are determined by the application.
Value: 0Public methods
getRange
static fun getRange(dataSpace: Int): Int
Unpack the range field value from the packed dataSpace value
| Return | |
|---|---|
Int |
The range aspect Value is either 0 or a combination of android.hardware.DataSpace#RANGE_UNSPECIFIED, android.hardware.DataSpace#RANGE_FULL, android.hardware.DataSpace#RANGE_LIMITED, and android.hardware.DataSpace#RANGE_EXTENDED |
getStandard
static fun getStandard(dataSpace: Int): Int
Unpack the standard field value from the packed dataSpace value.
getTransfer
static fun getTransfer(dataSpace: Int): Int
Unpack the transfer field value from the packed dataSpace value
pack
static fun pack(
standard: Int,
transfer: Int,
range: Int
): Int
Pack the dataSpace value using standard, transfer and range field value. Field values should be in the correct bits place.