mirror of
https://github.com/Evolution-X/hardware_interfaces
synced 2026-02-01 16:50:18 +00:00
Merge "graphics/common: add stable AIDL types"
This commit is contained in:
committed by
Android (Google) Code Review
commit
3ef7c8bd0c
20
graphics/common/aidl/Android.bp
Normal file
20
graphics/common/aidl/Android.bp
Normal file
@@ -0,0 +1,20 @@
|
||||
aidl_interface {
|
||||
name: "vintf-graphics-common",
|
||||
vendor_available: true,
|
||||
vndk: {
|
||||
enabled: true,
|
||||
support_system_process: true,
|
||||
},
|
||||
srcs: [
|
||||
"android/hardware/graphics/common/*.aidl",
|
||||
],
|
||||
stability: "vintf",
|
||||
backend: {
|
||||
java: {
|
||||
enabled: false,
|
||||
},
|
||||
cpp: {
|
||||
enabled: false,
|
||||
},
|
||||
},
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
/**
|
||||
* Blend modes, settable per layer.
|
||||
*/
|
||||
@VintfStability
|
||||
@Backing(type="int")
|
||||
enum BlendMode {
|
||||
INVALID = 0,
|
||||
|
||||
/** colorOut = colorSrc */
|
||||
NONE = 1,
|
||||
|
||||
/** colorOut = colorSrc + colorDst * (1 - alphaSrc) */
|
||||
PREMULTIPLIED = 2,
|
||||
|
||||
/** colorOut = colorSrc * alphaSrc + colorDst * (1 - alphaSrc) */
|
||||
COVERAGE = 3,
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
/**
|
||||
* Used by IAllocator/IMapper (gralloc) to describe standard chroma siting
|
||||
*/
|
||||
@VintfStability
|
||||
@Backing(type="long")
|
||||
enum ChromaSiting {
|
||||
/* This format does not have chroma siting. */
|
||||
NONE = 0,
|
||||
|
||||
/* This format has chroma siting but the type being used is unknown. */
|
||||
UNKNOWN = 1,
|
||||
|
||||
/* Cb and Cr are sited interstitially, halfway between alternate luma samples.
|
||||
* This is used by 4:2:0 for JPEG/JFIF, H.261, MPEG-1. */
|
||||
SITED_INTERSTITIAL = 2,
|
||||
|
||||
/* Cb and Cr are horizontally sited coincident with a luma sample.
|
||||
* Cb and Cr are vertically sited interstitially.
|
||||
* This is used by 4:2:0 for MPEG-2 frame pictures. */
|
||||
COSITED_HORIZONTAL = 3,
|
||||
}
|
||||
@@ -0,0 +1,30 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
/**
|
||||
* Used by IAllocator/IMapper (gralloc) to describe standard compression strategies
|
||||
*/
|
||||
@VintfStability
|
||||
@Backing(type="long")
|
||||
enum Compression {
|
||||
/* Represents all uncompressed buffers */
|
||||
NONE = 0,
|
||||
|
||||
/* VESA Display Stream Compression (DSC) */
|
||||
DISPLAY_STREAM_COMPRESSION = 1,
|
||||
}
|
||||
@@ -0,0 +1,682 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
@VintfStability
|
||||
@Backing(type="int")
|
||||
enum Dataspace {
|
||||
/**
|
||||
* Default-assumption data space, when not explicitly specified.
|
||||
*
|
||||
* It is safest to assume the 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.
|
||||
*/
|
||||
UNKNOWN = 0x0,
|
||||
|
||||
/**
|
||||
* Arbitrary dataspace with manually defined characteristics. Definition
|
||||
* for colorspaces or other meaning must be communicated separately.
|
||||
*
|
||||
* This is used when specifying primaries, transfer characteristics,
|
||||
* etc. separately.
|
||||
*
|
||||
* A typical use case is in video encoding parameters (e.g. for H.264),
|
||||
* where a colorspace can have separately defined primaries, transfer
|
||||
* characteristics, etc.
|
||||
*/
|
||||
ARBITRARY = 0x1,
|
||||
|
||||
/**
|
||||
* Color-description aspects
|
||||
*
|
||||
* The following aspects define various characteristics of the color
|
||||
* specification. These represent bitfields, so that a data space value
|
||||
* can specify each of them independently.
|
||||
*/
|
||||
|
||||
STANDARD_SHIFT = 16,
|
||||
|
||||
/**
|
||||
* 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.
|
||||
*/
|
||||
STANDARD_MASK = 63 << 16, // 63 << STANDARD_SHIFT = 0x3F
|
||||
|
||||
/**
|
||||
* Chromacity coordinates are unknown or are determined by the application.
|
||||
* Implementations shall use the following suggested standards:
|
||||
*
|
||||
* All YCbCr formats: BT709 if size is 720p or larger (since most video
|
||||
* content is letterboxed this corresponds to width is
|
||||
* 1280 or greater, or height is 720 or greater).
|
||||
* BT601_625 if size is smaller than 720p or is JPEG.
|
||||
* All RGB formats: BT709.
|
||||
*
|
||||
* For all other formats standard is undefined, and implementations should use
|
||||
* an appropriate standard for the data represented.
|
||||
*/
|
||||
STANDARD_UNSPECIFIED = 0 << 16, // STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* Primaries: x y
|
||||
* green 0.300 0.600
|
||||
* blue 0.150 0.060
|
||||
* red 0.640 0.330
|
||||
* white (D65) 0.3127 0.3290
|
||||
*
|
||||
* Use the unadjusted KR = 0.2126, KB = 0.0722 luminance interpretation
|
||||
* for RGB conversion.
|
||||
*/
|
||||
STANDARD_BT709 = 1 << 16, // 1 << STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* Primaries: x y
|
||||
* green 0.290 0.600
|
||||
* blue 0.150 0.060
|
||||
* red 0.640 0.330
|
||||
* white (D65) 0.3127 0.3290
|
||||
*
|
||||
* KR = 0.299, KB = 0.114. This adjusts the 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.
|
||||
*/
|
||||
STANDARD_BT601_625 = 2 << 16, // 2 << STANDARD_SHIFT,
|
||||
|
||||
/**
|
||||
* Primaries: x y
|
||||
* green 0.290 0.600
|
||||
* blue 0.150 0.060
|
||||
* red 0.640 0.330
|
||||
* white (D65) 0.3127 0.3290
|
||||
*
|
||||
* Use the unadjusted KR = 0.222, KB = 0.071 luminance interpretation
|
||||
* for RGB conversion.
|
||||
*/
|
||||
STANDARD_BT601_625_UNADJUSTED = 3 << 16, // 3 << STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* Primaries: x y
|
||||
* green 0.310 0.595
|
||||
* blue 0.155 0.070
|
||||
* red 0.630 0.340
|
||||
* white (D65) 0.3127 0.3290
|
||||
*
|
||||
* KR = 0.299, KB = 0.114. This adjusts the 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.
|
||||
*/
|
||||
STANDARD_BT601_525 = 4 << 16, // 4 << STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* Primaries: x y
|
||||
* green 0.310 0.595
|
||||
* blue 0.155 0.070
|
||||
* red 0.630 0.340
|
||||
* white (D65) 0.3127 0.3290
|
||||
*
|
||||
* Use the unadjusted KR = 0.212, KB = 0.087 luminance interpretation
|
||||
* for RGB conversion (as in SMPTE 240M).
|
||||
*/
|
||||
STANDARD_BT601_525_UNADJUSTED = 5 << 16, // 5 << STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* Primaries: x y
|
||||
* green 0.170 0.797
|
||||
* blue 0.131 0.046
|
||||
* red 0.708 0.292
|
||||
* white (D65) 0.3127 0.3290
|
||||
*
|
||||
* Use the unadjusted KR = 0.2627, KB = 0.0593 luminance interpretation
|
||||
* for RGB conversion.
|
||||
*/
|
||||
STANDARD_BT2020 = 6 << 16, // 6 << STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* Primaries: x y
|
||||
* green 0.170 0.797
|
||||
* blue 0.131 0.046
|
||||
* red 0.708 0.292
|
||||
* white (D65) 0.3127 0.3290
|
||||
*
|
||||
* Use the unadjusted KR = 0.2627, KB = 0.0593 luminance interpretation
|
||||
* for RGB conversion using the linear domain.
|
||||
*/
|
||||
STANDARD_BT2020_CONSTANT_LUMINANCE = 7 << 16, // 7 << STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* Primaries: x y
|
||||
* green 0.21 0.71
|
||||
* blue 0.14 0.08
|
||||
* red 0.67 0.33
|
||||
* white (C) 0.310 0.316
|
||||
*
|
||||
* Use the unadjusted KR = 0.30, KB = 0.11 luminance interpretation
|
||||
* for RGB conversion.
|
||||
*/
|
||||
STANDARD_BT470M = 8 << 16, // 8 << STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* Primaries: x y
|
||||
* green 0.243 0.692
|
||||
* blue 0.145 0.049
|
||||
* red 0.681 0.319
|
||||
* white (C) 0.310 0.316
|
||||
*
|
||||
* Use the unadjusted KR = 0.254, KB = 0.068 luminance interpretation
|
||||
* for RGB conversion.
|
||||
*/
|
||||
STANDARD_FILM = 9 << 16, // 9 << STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* SMPTE EG 432-1 and SMPTE RP 431-2. (DCI-P3)
|
||||
* Primaries: x y
|
||||
* green 0.265 0.690
|
||||
* blue 0.150 0.060
|
||||
* red 0.680 0.320
|
||||
* white (D65) 0.3127 0.3290
|
||||
*/
|
||||
STANDARD_DCI_P3 = 10 << 16, // 10 << STANDARD_SHIFT
|
||||
|
||||
/**
|
||||
* Adobe RGB
|
||||
* Primaries: x y
|
||||
* green 0.210 0.710
|
||||
* blue 0.150 0.060
|
||||
* red 0.640 0.330
|
||||
* white (D65) 0.3127 0.3290
|
||||
*/
|
||||
STANDARD_ADOBE_RGB = 11 << 16, // 11 << STANDARD_SHIFT
|
||||
|
||||
|
||||
|
||||
TRANSFER_SHIFT = 22,
|
||||
|
||||
/**
|
||||
* 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.
|
||||
*/
|
||||
|
||||
TRANSFER_MASK = 31 << 22, // 31 << TRANSFER_SHIFT = 0x1F
|
||||
|
||||
/**
|
||||
* Transfer characteristics are unknown or are determined by the
|
||||
* application.
|
||||
*
|
||||
* Implementations should use the following transfer functions:
|
||||
*
|
||||
* For YCbCr formats: use TRANSFER_SMPTE_170M
|
||||
* For RGB formats: use TRANSFER_SRGB
|
||||
*
|
||||
* For all other formats transfer function is undefined, and implementations
|
||||
* should use an appropriate standard for the data represented.
|
||||
*/
|
||||
TRANSFER_UNSPECIFIED = 0 << 22, // 0 << TRANSFER_SHIFT
|
||||
|
||||
/**
|
||||
* Transfer characteristic curve:
|
||||
* E = L
|
||||
* L - luminance of image 0 <= L <= 1 for conventional colorimetry
|
||||
* E - corresponding electrical signal
|
||||
*/
|
||||
TRANSFER_LINEAR = 1 << 22, // 1 << TRANSFER_SHIFT
|
||||
|
||||
/**
|
||||
* 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
|
||||
*/
|
||||
TRANSFER_SRGB = 2 << 22, // 2 << TRANSFER_SHIFT
|
||||
|
||||
/**
|
||||
* BT.601 525, BT.601 625, BT.709, BT.2020
|
||||
*
|
||||
* 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
|
||||
*/
|
||||
TRANSFER_SMPTE_170M = 3 << 22, // 3 << TRANSFER_SHIFT
|
||||
|
||||
/**
|
||||
* Assumed 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
|
||||
*/
|
||||
TRANSFER_GAMMA2_2 = 4 << 22, // 4 << TRANSFER_SHIFT
|
||||
|
||||
/**
|
||||
* 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
|
||||
*/
|
||||
TRANSFER_GAMMA2_6 = 5 << 22, // 5 << TRANSFER_SHIFT
|
||||
|
||||
/**
|
||||
* 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
|
||||
*/
|
||||
TRANSFER_GAMMA2_8 = 6 << 22, // 6 << TRANSFER_SHIFT
|
||||
|
||||
/**
|
||||
* 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
|
||||
*/
|
||||
TRANSFER_ST2084 = 7 << 22, // 7 << TRANSFER_SHIFT
|
||||
|
||||
/**
|
||||
* 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
|
||||
*/
|
||||
TRANSFER_HLG = 8 << 22, // 8 << TRANSFER_SHIFT
|
||||
|
||||
RANGE_SHIFT = 27,
|
||||
|
||||
/**
|
||||
* Range aspect
|
||||
*
|
||||
* Defines the range of values corresponding to the unit range of 0-1.
|
||||
* This is defined for YCbCr only, but can be expanded to RGB space.
|
||||
*/
|
||||
RANGE_MASK = 7 << 27, // 7 << RANGE_SHIFT = 0x7
|
||||
|
||||
/**
|
||||
* Range is unknown or are determined by the application. Implementations
|
||||
* shall use the following suggested ranges:
|
||||
*
|
||||
* All YCbCr formats: limited range.
|
||||
* All RGB or RGBA formats (including RAW and Bayer): full range.
|
||||
* All Y formats: full range
|
||||
*
|
||||
* For all other formats range is undefined, and implementations should use
|
||||
* an appropriate range for the data represented.
|
||||
*/
|
||||
RANGE_UNSPECIFIED = 0 << 27, // 0 << RANGE_SHIFT = 0x0
|
||||
|
||||
/**
|
||||
* 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.
|
||||
*/
|
||||
RANGE_FULL = 1 << 27, // 1 << RANGE_SHIFT = 0x8000000
|
||||
|
||||
/**
|
||||
* 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
|
||||
*/
|
||||
RANGE_LIMITED = 2 << 27, // 2 << RANGE_SHIFT = 0x10000000
|
||||
|
||||
/**
|
||||
* Extended range is used for scRGB. Intended for use with
|
||||
* floating point pixel formats. [0.0 - 1.0] is the standard
|
||||
* sRGB space. Values outside the range 0.0 - 1.0 can encode
|
||||
* color outside the sRGB gamut.
|
||||
* Used to blend / merge multiple dataspaces on a single display.
|
||||
*/
|
||||
RANGE_EXTENDED = 3 << 27, // 3 << RANGE_SHIFT = 0x18000000
|
||||
|
||||
/**
|
||||
* sRGB linear encoding:
|
||||
*
|
||||
* The red, green, and blue components are stored in sRGB space, but
|
||||
* are linear, not gamma-encoded.
|
||||
* The RGB primaries and the white point are the same as BT.709.
|
||||
*
|
||||
* The values are encoded using the full range ([0,255] for 8-bit) for all
|
||||
* components.
|
||||
*/
|
||||
SRGB_LINEAR = 1 << 16 | 1 << 22 | 1 << 27, // deprecated, use V0_SRGB_LINEAR
|
||||
|
||||
V0_SRGB_LINEAR = 1 << 16 | 1 << 22 | 1 << 27, // STANDARD_BT709 | TRANSFER_LINEAR | RANGE_FULL
|
||||
|
||||
|
||||
/**
|
||||
* scRGB linear encoding:
|
||||
*
|
||||
* The red, green, and blue components are stored in extended sRGB space,
|
||||
* but are linear, not gamma-encoded.
|
||||
* The RGB primaries and the white point are the same as BT.709.
|
||||
*
|
||||
* 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.
|
||||
*/
|
||||
V0_SCRGB_LINEAR = 1 << 16 | 1 << 22 | 3 << 27, // STANDARD_BT709 | TRANSFER_LINEAR | RANGE_EXTENDED
|
||||
|
||||
|
||||
/**
|
||||
* sRGB gamma encoding:
|
||||
*
|
||||
* The red, green and blue components are stored in sRGB space, and
|
||||
* converted to linear space when read, using the SRGB transfer function
|
||||
* for each of the R, G and B components. 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.
|
||||
*
|
||||
* Use full range and BT.709 standard.
|
||||
*/
|
||||
SRGB = 1 << 16 | 2 << 22 | 1 << 27, // deprecated, use V0_SRGB
|
||||
|
||||
V0_SRGB = 1 << 16 | 2 << 22 | 1 << 27, // STANDARD_BT709 | TRANSFER_SRGB | RANGE_FULL
|
||||
|
||||
|
||||
/**
|
||||
* scRGB:
|
||||
*
|
||||
* The red, green, and blue components are stored in extended sRGB space,
|
||||
* but are linear, not gamma-encoded.
|
||||
* The RGB primaries and the white point are the same as BT.709.
|
||||
*
|
||||
* 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.
|
||||
*/
|
||||
V0_SCRGB = 1 << 16 | 2 << 22 | 3 << 27, // STANDARD_BT709 | TRANSFER_SRGB | RANGE_EXTENDED
|
||||
|
||||
/**
|
||||
* YCbCr Colorspaces
|
||||
* -----------------
|
||||
*
|
||||
* Primaries are given using (x,y) coordinates in the CIE 1931 definition
|
||||
* of x and y specified by ISO 11664-1.
|
||||
*
|
||||
* Transfer characteristics are the opto-electronic transfer characteristic
|
||||
* at the source as a function of linear optical intensity (luminance).
|
||||
*/
|
||||
|
||||
/**
|
||||
* JPEG File Interchange Format (JFIF)
|
||||
*
|
||||
* Same model as BT.601-625, but all values (Y, Cb, Cr) range from 0 to 255
|
||||
*
|
||||
* Use full range, BT.601 transfer and BT.601_625 standard.
|
||||
*/
|
||||
JFIF = 2 << 16 | 3 << 22 | 1 << 27, // deprecated, use V0_JFIF
|
||||
|
||||
V0_JFIF = 2 << 16 | 3 << 22 | 1 << 27, // STANDARD_BT601_625 | TRANSFER_SMPTE_170M | RANGE_FULL
|
||||
|
||||
/**
|
||||
* ITU-R Recommendation 601 (BT.601) - 625-line
|
||||
*
|
||||
* Standard-definition television, 625 Lines (PAL)
|
||||
*
|
||||
* Use limited range, BT.601 transfer and BT.601_625 standard.
|
||||
*/
|
||||
BT601_625 = 2 << 16 | 3 << 22 | 2 << 27, // deprecated, use V0_BT601_625
|
||||
|
||||
V0_BT601_625 = 2 << 16 | 3 << 22 | 2 << 27, // STANDARD_BT601_625 | TRANSFER_SMPTE_170M | RANGE_LIMITED
|
||||
|
||||
|
||||
/**
|
||||
* ITU-R Recommendation 601 (BT.601) - 525-line
|
||||
*
|
||||
* Standard-definition television, 525 Lines (NTSC)
|
||||
*
|
||||
* Use limited range, BT.601 transfer and BT.601_525 standard.
|
||||
*/
|
||||
BT601_525 = 4 << 16 | 3 << 22 | 2 << 27, // deprecated, use V0_BT601_525
|
||||
|
||||
V0_BT601_525 = 4 << 16 | 3 << 22 | 2 << 27, // STANDARD_BT601_525 | TRANSFER_SMPTE_170M | RANGE_LIMITED
|
||||
|
||||
/**
|
||||
* ITU-R Recommendation 709 (BT.709)
|
||||
*
|
||||
* High-definition television
|
||||
*
|
||||
* Use limited range, BT.709 transfer and BT.709 standard.
|
||||
*/
|
||||
BT709 = 1 << 16 | 3 << 22 | 2 << 27, // deprecated, use V0_BT709
|
||||
|
||||
V0_BT709 = 1 << 16 | 3 << 22 | 2 << 27, // STANDARD_BT709 | TRANSFER_SMPTE_170M | RANGE_LIMITED
|
||||
|
||||
|
||||
/**
|
||||
* SMPTE EG 432-1 and SMPTE RP 431-2.
|
||||
*
|
||||
* Digital Cinema DCI-P3
|
||||
*
|
||||
* Use full range, linear transfer and D65 DCI-P3 standard
|
||||
*/
|
||||
DCI_P3_LINEAR = 10 << 16 | 1 << 22 | 1 << 27, // STANDARD_DCI_P3 | TRANSFER_LINEAR | RANGE_FULL
|
||||
|
||||
|
||||
/**
|
||||
* SMPTE EG 432-1 and SMPTE RP 431-2.
|
||||
*
|
||||
* Digital Cinema DCI-P3
|
||||
*
|
||||
* Use full range, gamma 2.6 transfer and D65 DCI-P3 standard
|
||||
* Note: Application is responsible for gamma encoding the data as
|
||||
* a 2.6 gamma encoding is not supported in HW.
|
||||
*/
|
||||
DCI_P3 = 10 << 16 | 5 << 22 | 1 << 27, // STANDARD_DCI_P3 | TRANSFER_GAMMA2_6 | RANGE_FULL
|
||||
|
||||
|
||||
/**
|
||||
* Display P3
|
||||
*
|
||||
* Display P3 uses same primaries and white-point as DCI-P3
|
||||
* linear transfer function makes this the same as DCI_P3_LINEAR.
|
||||
*/
|
||||
DISPLAY_P3_LINEAR = 10 << 16 | 1 << 22 | 1 << 27, // STANDARD_DCI_P3 | TRANSFER_LINEAR | RANGE_FULL
|
||||
|
||||
|
||||
/**
|
||||
* Display P3
|
||||
*
|
||||
* Use same primaries and white-point as DCI-P3
|
||||
* but sRGB transfer function.
|
||||
*/
|
||||
DISPLAY_P3 = 10 << 16 | 2 << 22 | 1 << 27, // STANDARD_DCI_P3 | TRANSFER_SRGB | RANGE_FULL
|
||||
|
||||
|
||||
/**
|
||||
* Adobe RGB
|
||||
*
|
||||
* Use full range, gamma 2.2 transfer and Adobe RGB primaries
|
||||
* Note: Application is responsible for gamma encoding the data as
|
||||
* a 2.2 gamma encoding is not supported in HW.
|
||||
*/
|
||||
ADOBE_RGB = 11 << 16 | 4 << 22 | 1 << 27, // STANDARD_ADOBE_RGB | TRANSFER_GAMMA2_2 | RANGE_FULL
|
||||
|
||||
|
||||
/**
|
||||
* ITU-R Recommendation 2020 (BT.2020)
|
||||
*
|
||||
* Ultra High-definition television
|
||||
*
|
||||
* Use full range, linear transfer and BT2020 standard
|
||||
*/
|
||||
BT2020_LINEAR = 6 << 16 | 1 << 22 | 1 << 27, // STANDARD_BT2020 | TRANSFER_LINEAR | RANGE_FULL
|
||||
|
||||
|
||||
/**
|
||||
* ITU-R Recommendation 2020 (BT.2020)
|
||||
*
|
||||
* Ultra High-definition television
|
||||
*
|
||||
* Use full range, BT.709 transfer and BT2020 standard
|
||||
*/
|
||||
BT2020 = 6 << 16 | 3 << 22 | 1 << 27, // STANDARD_BT2020 | TRANSFER_SMPTE_170M | RANGE_FULL
|
||||
|
||||
/**
|
||||
* ITU-R Recommendation 2020 (BT.2020)
|
||||
*
|
||||
* Ultra High-definition television
|
||||
*
|
||||
* Use full range, SMPTE 2084 (PQ) transfer and BT2020 standard
|
||||
*/
|
||||
BT2020_PQ = 6 << 16 | 7 << 22 | 1 << 27, // STANDARD_BT2020 | TRANSFER_ST2084 | RANGE_FULL
|
||||
|
||||
|
||||
/**
|
||||
* Data spaces for non-color formats
|
||||
*/
|
||||
|
||||
/**
|
||||
* The buffer contains depth ranging measurements from a depth camera.
|
||||
* This value is valid with formats:
|
||||
* HAL_PIXEL_FORMAT_Y16: 16-bit samples, consisting of a depth measurement
|
||||
* and an associated confidence value. The 3 MSBs of the sample make
|
||||
* up the confidence value, and the low 13 LSBs of the sample make up
|
||||
* the depth measurement.
|
||||
* For the confidence section, 0 means 100% confidence, 1 means 0%
|
||||
* confidence. The mapping to a linear float confidence value between
|
||||
* 0.f and 1.f can be obtained with
|
||||
* float confidence = (((depthSample >> 13) - 1) & 0x7) / 7.0f;
|
||||
* The depth measurement can be extracted simply with
|
||||
* uint16_t range = (depthSample & 0x1FFF);
|
||||
* HAL_PIXEL_FORMAT_BLOB: A depth point cloud, as
|
||||
* a variable-length float (x,y,z, confidence) coordinate point list.
|
||||
* The point cloud will be represented with the android_depth_points
|
||||
* structure.
|
||||
*/
|
||||
DEPTH = 0x1000,
|
||||
|
||||
/**
|
||||
* The buffer contains sensor events from sensor direct report.
|
||||
* This value is valid with formats:
|
||||
* HAL_PIXEL_FORMAT_BLOB: an array of sensor event structure that forms
|
||||
* a lock free queue. Format of sensor event structure is specified
|
||||
* in Sensors HAL.
|
||||
*/
|
||||
SENSOR = 0x1001,
|
||||
|
||||
/**
|
||||
* ITU-R Recommendation 2020 (BT.2020)
|
||||
*
|
||||
* Ultra High-definition television
|
||||
*
|
||||
* Use limited range, BT.709 transfer and BT2020 standard
|
||||
*/
|
||||
BT2020_ITU = 6 << 16 | 3 << 22 | 2 << 27, // STANDARD_BT2020 | TRANSFER_SMPTE_170M | RANGE_LIMITED
|
||||
|
||||
/**
|
||||
* ITU-R Recommendation 2100 (BT.2100)
|
||||
*
|
||||
* High dynamic range television
|
||||
*
|
||||
* Use limited/full range, PQ/HLG transfer, and BT2020 standard
|
||||
* limited range is the preferred / normative definition for BT.2100
|
||||
*/
|
||||
BT2020_ITU_PQ = 6 << 16 | 7 << 22 | 2 << 27, // STANDARD_BT2020 | TRANSFER_ST2084 | RANGE_LIMITED
|
||||
BT2020_ITU_HLG = 6 << 16 | 8 << 22 | 2 << 27, // STANDARD_BT2020 | TRANSFER_HLG | RANGE_LIMITED
|
||||
BT2020_HLG = 6 << 16 | 8 << 22 | 1 << 27, // STANDARD_BT2020 | TRANSFER_HLG | RANGE_FULL
|
||||
|
||||
/**
|
||||
* ITU-R Recommendation 2020 (BT.2020)
|
||||
*
|
||||
* Ultra High-definition television
|
||||
*
|
||||
* Use full range, sRGB transfer and BT2020 standard
|
||||
*/
|
||||
DISPLAY_BT2020 = 6 << 16 | 2 << 22 | 1 << 27, // STANDARD_BT2020 | TRANSFER_SRGB | RANGE_FULL
|
||||
|
||||
/**
|
||||
* ISO 16684-1:2011(E)
|
||||
*
|
||||
* Embedded depth metadata following the dynamic depth specification.
|
||||
*/
|
||||
DYNAMIC_DEPTH = 0x1002,
|
||||
|
||||
/**
|
||||
* JPEG APP segments format as specified by JEIDA spec
|
||||
*
|
||||
* The buffer must only contain APP1 (Application Marker) segment followed
|
||||
* by zero or more APPn segments, as is specified by JEITA CP-3451C section 4.5.4.
|
||||
* The APP1 segment optionally contains a thumbnail. The buffer will not
|
||||
* contain main compressed image.
|
||||
*
|
||||
* This value is valid with formats:
|
||||
* HAL_PIXEL_FORMAT_BLOB: JPEG APP segments optionally containing thumbnail image
|
||||
* in APP1. BLOB buffer with this dataspace is output by HAL, and used by
|
||||
* camera framework to encode into a HEIC image.
|
||||
*/
|
||||
JPEG_APP_SEGMENTS = 0x1003,
|
||||
|
||||
/**
|
||||
* ISO/IEC 23008-12
|
||||
*
|
||||
* High Efficiency Image File Format (HEIF)
|
||||
*
|
||||
* This value is valid with formats:
|
||||
* HAL_PIXEL_FORMAT_BLOB: A HEIC image encoded by HEIC or HEVC encoder
|
||||
* according to ISO/IEC 23008-12.
|
||||
*/
|
||||
HEIF = 0x1004,
|
||||
}
|
||||
@@ -0,0 +1,52 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
/**
|
||||
* This struct is used for types that are commonly extended by vendors. For example, buffer
|
||||
* compression is typically SoC specific. It is not possible for Android to define every possible
|
||||
* proprietary vendor compression strategy. Instead, compression is represented using this
|
||||
* ExtendableType that can support standard compression strategies while still allowing
|
||||
* every vendor to easily add their own non-standard definitions.
|
||||
*/
|
||||
@VintfStability
|
||||
parcelable ExtendableType {
|
||||
/**
|
||||
* Name of the stable aidl interface whose value is stored in this structure.
|
||||
*
|
||||
* For standard types, the "name" field will be set to the stable aidl name of the type such as
|
||||
* "android.hardware.graphics.common.Compression".
|
||||
*
|
||||
* For custom vendor types, the "name" field will be set to the name of the custom
|
||||
* @VendorStability vendor AIDL interface such as
|
||||
* "vendor.mycompanyname.graphics.common.Compression". The name of the vendor extension should
|
||||
* contain the name of the company that owns the extension. Including the company
|
||||
* name in the "name" field prevents type collisions between different vendors.
|
||||
*/
|
||||
@utf8InCpp String name;
|
||||
|
||||
/**
|
||||
* Enum value of the from the stable aidl interface
|
||||
*
|
||||
* For standard types, the "value" field will be set to an enum value from that stable aidl
|
||||
* type such as "NONE".
|
||||
*
|
||||
* For vendor types, the "value" field should be set to the enum value from the custom
|
||||
* @VendorStability vendor AIDL interface extended type such as "MY_COMPRESSION_TYPE1".
|
||||
*/
|
||||
long value = 0;
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
/**
|
||||
* Used by IAllocator/IMapper (gralloc) to describe standard interlaced strategies
|
||||
*/
|
||||
@VintfStability
|
||||
@Backing(type="long")
|
||||
enum Interlaced {
|
||||
/* The buffer is not interlaced. */
|
||||
NONE = 0,
|
||||
|
||||
/* The buffer's planes are interlaced horizontally. The height of each interlaced plane is
|
||||
* 1/2 the height of the buffer's height. */
|
||||
TOP_BOTTOM = 1,
|
||||
|
||||
/* The buffer's planes are interlaced vertically. The width of each interlaced plane is
|
||||
* 1/2 the width of the buffer's width. */
|
||||
RIGHT_LEFT = 2,
|
||||
}
|
||||
@@ -0,0 +1,125 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
import android.hardware.graphics.common.PlaneLayoutComponent;
|
||||
import android.hardware.graphics.common.Rect;
|
||||
|
||||
/**
|
||||
* Used by IAllocator/IMapper (gralloc) to describe the plane layout of a buffer.
|
||||
*
|
||||
* PlaneLayout uses the following definitions:
|
||||
*
|
||||
* - Component - a component is one channel of a pixel. For example, an RGBA format has
|
||||
* four components: R, G, B and A.
|
||||
* - Sample - a sample is comprised of all the components in a given plane. For example,
|
||||
* a buffer with one Y plane and one CbCr plane has one plane with a sample of Y
|
||||
* and one plane with a sample of CbCr.
|
||||
* - Pixel - a pixel is comprised of all the (non-metadata/raw) components in buffer across
|
||||
* all planes. For example, a buffer with a plane of Y and a plane of CbCr has a pixel
|
||||
* of YCbCr.
|
||||
*/
|
||||
|
||||
@VintfStability
|
||||
parcelable PlaneLayout {
|
||||
/**
|
||||
* An list of plane layout components. This list of components should include
|
||||
* every component in this plane. For example, a CbCr plane should return a
|
||||
* vector of size two with one PlaneLayoutComponent for Cb and one for Cr.
|
||||
*/
|
||||
PlaneLayoutComponent[] components;
|
||||
|
||||
/**
|
||||
* Offset to the first byte of the plane (in bytes), from the start of the allocation.
|
||||
*/
|
||||
long offsetInBytes;
|
||||
|
||||
/**
|
||||
* Bits per sample increment (aka column increment): describes the distance
|
||||
* in bits from one sample to the next sample (to the right) on the same row for the
|
||||
* the component plane.
|
||||
*
|
||||
* The default value is 0. Return the default value if the increment is undefined, unknown,
|
||||
* or variable.
|
||||
*
|
||||
* This can be negative. A negative increment indicates that the samples are read from
|
||||
* right to left.
|
||||
*/
|
||||
long sampleIncrementInBits;
|
||||
|
||||
/**
|
||||
* Horizontal stride: number of bytes between two vertically adjacent
|
||||
* samples in given plane. This can be mathematically described by:
|
||||
*
|
||||
* strideInBytes = ALIGN(widthInSamples * bps / 8, alignment)
|
||||
*
|
||||
* where,
|
||||
*
|
||||
* bps: average bits per sample
|
||||
* alignment (in bytes): dependent upon pixel format and usage
|
||||
*
|
||||
* strideInBytes can contain additional padding beyond the widthInSamples.
|
||||
*
|
||||
* The default value is 0. Return the default value if the stride is undefined, unknown,
|
||||
* or variable.
|
||||
*
|
||||
* This can be negative. A negative stride indicates that the rows are read from
|
||||
* bottom to top.
|
||||
*/
|
||||
long strideInBytes;
|
||||
|
||||
/**
|
||||
* Dimensions of plane (in samples).
|
||||
*
|
||||
* This is the number of samples in the plane, even if subsampled.
|
||||
*
|
||||
* See 'strideInBytes' for relationship between strideInBytes and widthInSamples.
|
||||
*/
|
||||
long widthInSamples;
|
||||
long heightInSamples;
|
||||
|
||||
/**
|
||||
* Can be used to get the total size in bytes of any memory used by the plane
|
||||
* including extra padding. This should not include any extra metadata used to describe the
|
||||
* plane.
|
||||
*/
|
||||
long totalSizeInBytes;
|
||||
|
||||
/**
|
||||
* Horizontal and vertical subsampling. Must be a positive power of 2.
|
||||
*
|
||||
* These fields indicate the number of horizontally or vertically adjacent pixels that use
|
||||
* the same pixel data. A value of 1 indicates no subsampling.
|
||||
*/
|
||||
long horizontalSubsampling;
|
||||
long verticalSubsampling;
|
||||
|
||||
/**
|
||||
* Some buffer producers require extra padding to their output buffer; therefore the
|
||||
* physical size of the native buffer will be larger than its logical size.
|
||||
* The crop rectangle determines the offset and logical size of the buffer that should be
|
||||
* read by consumers.
|
||||
*
|
||||
* The crop rectangle is measured in samples and is relative to the offset of the
|
||||
* plane. Valid crop rectangles are within the boundaries of the plane:
|
||||
* [0, 0, widthInSamples, heightInSamples].
|
||||
*
|
||||
* The default crop rectangle is a rectangle the same size as the plane:
|
||||
* [0, 0, widthInSamples, heightInSamples].
|
||||
*/
|
||||
Rect crop;
|
||||
}
|
||||
@@ -0,0 +1,67 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
import android.hardware.graphics.common.ExtendableType;
|
||||
|
||||
/**
|
||||
* Used by IAllocator/IMapper (gralloc) to describe the type and location of a component in a
|
||||
* buffer's plane.
|
||||
*
|
||||
* PlaneLayoutComponent uses the following definitions:
|
||||
*
|
||||
* - Component - a component is one channel of a pixel. For example, an RGBA format has
|
||||
* four components: R, G, B and A.
|
||||
* - Sample - a sample is comprised of all the components in a given plane. For example,
|
||||
* a buffer with one Y plane and one CbCr plane has one plane with a sample of Y
|
||||
* and one plane with a sample of CbCr.
|
||||
* - Pixel - a pixel is comprised of all the (non-metadata/raw) components in buffer across
|
||||
* all planes. For example, a buffer with a plane of Y and a plane of CbCr has a pixel
|
||||
* of YCbCr.
|
||||
*/
|
||||
|
||||
@VintfStability
|
||||
parcelable PlaneLayoutComponent {
|
||||
/**
|
||||
* The type of this plane layout component.
|
||||
*
|
||||
* android.hardware.graphics.common.PlaneLayoutComponent defines the standard
|
||||
* plane layout component types. Vendors may extend this type to include any
|
||||
* non-standard plane layout component types. For instructions on how to
|
||||
* create a vendor extension, refer to ExtendableType.aidl.
|
||||
*/
|
||||
ExtendableType type;
|
||||
|
||||
/**
|
||||
* Offset in bits to the first instance of this component in the plane.
|
||||
* This is relative to the plane's offset (PlaneLayout::offset).
|
||||
*
|
||||
* If the offset cannot be described using a int64_t, this should be set to -1.
|
||||
* For example, if the plane is compressed and the offset is not defined or
|
||||
* relevant, return -1.
|
||||
*/
|
||||
long offsetInBits;
|
||||
|
||||
/**
|
||||
* The number of bits used per component in the plane.
|
||||
*
|
||||
* If the plane layout component cannot be described using componentSizeInBits, this
|
||||
* should be set to -1. For example, if the component varies in size throughout
|
||||
* the plane, return -1.
|
||||
*/
|
||||
long sizeInBits;
|
||||
}
|
||||
@@ -0,0 +1,46 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
/**
|
||||
* Used by IAllocator/IMapper (gralloc) to describe standard plane layout component types
|
||||
*
|
||||
* The enum values have been taken directly from gralloc1's android_flex_component for compatiblity
|
||||
* reasons. However, unlike gralloc1's android_flex_component, this field is NOT a bit field.
|
||||
* A plane's components should NOT be expressed by bitwise OR-ing different
|
||||
* PlaneLayoutComponentTypes together.
|
||||
*/
|
||||
@VintfStability
|
||||
@Backing(type="long")
|
||||
enum PlaneLayoutComponentType {
|
||||
/* Luma */
|
||||
Y = 1 << 0,
|
||||
/* Chroma blue */
|
||||
CB = 1 << 1,
|
||||
/* Chroma red */
|
||||
CR = 1 << 2,
|
||||
|
||||
/* Red */
|
||||
R = 1 << 10,
|
||||
/* Green */
|
||||
G = 1 << 11,
|
||||
/* Blue */
|
||||
B = 1 << 12,
|
||||
|
||||
/* Alpha */
|
||||
A = 1 << 30,
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
/**
|
||||
* Copyright (c) 2019, The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
/**
|
||||
* General purpose definition of a rectangle.
|
||||
*/
|
||||
|
||||
@VintfStability
|
||||
parcelable Rect {
|
||||
int left;
|
||||
int top;
|
||||
int right;
|
||||
int bottom;
|
||||
}
|
||||
@@ -0,0 +1,282 @@
|
||||
/**
|
||||
* Copyright (c) 2019,libgralloctypes_helper The Android Open Source Project
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
package android.hardware.graphics.common;
|
||||
|
||||
/**
|
||||
* Used by IAllocator/IMapper (gralloc) to describe standard metadata types.
|
||||
*
|
||||
* This is an enum that defines the common types of gralloc 4 buffer metadata. The comments for
|
||||
* each enum include a description of the metadata that is associated with the type.
|
||||
*
|
||||
* IMapper@4.x must support getting the following standard buffer metadata types. IMapper@4.x may
|
||||
* support setting these standard buffer metadata types as well.
|
||||
*/
|
||||
@VintfStability
|
||||
@Backing(type="long")
|
||||
enum StandardMetadataType {
|
||||
INVALID = 0,
|
||||
|
||||
/**
|
||||
* Can be used to get the random ID of the buffer. This ID should be psuedorandom with
|
||||
* sufficient entropy.
|
||||
*
|
||||
* This ID should only be used for debugging purposes. It cannot be used as a basis for any
|
||||
* control flows.
|
||||
*
|
||||
* The buffer ID is determined at allocation time and should not change during the lifetime
|
||||
* of the buffer.
|
||||
*
|
||||
* The buffer ID is a uint64_t.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is represented by 8 bytes written in little endian.
|
||||
*/
|
||||
BUFFER_ID = 1,
|
||||
|
||||
/**
|
||||
* Can be used to get the name passed in by the client at allocation time in the
|
||||
* BufferDescriptorInfo.
|
||||
*
|
||||
* The buffer name is determined at allocation time and should not change during the lifetime
|
||||
* of the buffer.
|
||||
*
|
||||
* The buffer name is a string.
|
||||
*
|
||||
* When it is encoded into a byte stream, the length of the string is written using 8 bytes in
|
||||
* little endian. It is followed by a char array of the string's
|
||||
* characters. The array is not null-terminated.
|
||||
*/
|
||||
NAME = 2,
|
||||
|
||||
/**
|
||||
* Can be used to get the number of elements per buffer row requested at allocation time in
|
||||
* the BufferDescriptorInfo.
|
||||
*
|
||||
* The width is determined at allocation time and should not change during the lifetime
|
||||
* of the buffer.
|
||||
*
|
||||
* The width is a uint64_t.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is represented by 8 bytes written in little endian.
|
||||
*/
|
||||
WIDTH = 3,
|
||||
|
||||
/**
|
||||
* Can be used to get the number of elements per buffer column requested at allocation time in
|
||||
* the BufferDescriptorInfo.
|
||||
*
|
||||
* The height is determined at allocation time and should not change during the lifetime
|
||||
* of the buffer.
|
||||
*
|
||||
* The height is a uint64_t.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is represented by 8 bytes written in little endian.
|
||||
*/
|
||||
HEIGHT = 4,
|
||||
|
||||
/**
|
||||
* Can be used to get the number of layers requested at allocation time in the
|
||||
* BufferDescriptorInfo.
|
||||
*
|
||||
* The layer count is determined at allocation time and should not change during the lifetime
|
||||
* of the buffer.
|
||||
*
|
||||
* The layer count is a uint64_t.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is represented by 8 bytes written in little endian.
|
||||
*/
|
||||
LAYER_COUNT = 5,
|
||||
|
||||
/**
|
||||
* Can be used to get the buffer format requested at allocation time in the
|
||||
* BufferDescriptorInfo.
|
||||
*
|
||||
* The requested pixel format is determined at allocation time and should not change during
|
||||
* the lifetime of the buffer.
|
||||
*
|
||||
* The requested pixel format is a android.hardware.graphics.common@1.2::PixelFormat.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is first cast to a int32_t and then represented in
|
||||
* the byte stream by 4 bytes written in little endian.
|
||||
*/
|
||||
PIXEL_FORMAT_REQUESTED = 6,
|
||||
|
||||
/**
|
||||
* Can be used to get the fourcc code for the format. Fourcc codes are standard across all
|
||||
* devices of the same kernel version. Fourcc codes must follow the Linux definition of a
|
||||
* fourcc format found in: include/uapi/drm/drm_fourcc.h.
|
||||
*
|
||||
* The pixel format fourcc code is represented by a uint32_t.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is represented by 4 bytes written in little endian.
|
||||
*/
|
||||
PIXEL_FORMAT_FOURCC = 7,
|
||||
|
||||
/**
|
||||
* Can be used to get the modifier for the format. Together fourcc and modifier describe the
|
||||
* real pixel format. Each fourcc and modifier pair is unique and must fully define the format
|
||||
* and layout of the buffer. Modifiers can change any property of the buffer. Modifiers must
|
||||
* follow the Linux definition of a modifier found in: include/uapi/drm/drm_fourcc.h.
|
||||
*
|
||||
* The pixel format modifier is represented by a uint64_t.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is represented by 8 bytes written in little endian.
|
||||
*/
|
||||
PIXEL_FORMAT_MODIFIER = 8,
|
||||
|
||||
/**
|
||||
* Can be used to get the usage requested at allocation time in the BufferDescriptorInfo.
|
||||
*
|
||||
* The usage is determined at allocation time and should not change during the lifetime
|
||||
* of the buffer.
|
||||
*
|
||||
* The usage is a uint64_t bit field of android.hardware.graphics.common@1.2::BufferUsage's.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is represented by 8 bytes written in little endian.
|
||||
*/
|
||||
USAGE = 9,
|
||||
|
||||
/**
|
||||
* Can be used to get the total size in bytes of any memory used by the buffer including its
|
||||
* metadata and extra padding. This is the total number of bytes used by the buffer allocation.
|
||||
*
|
||||
* The allocation size is a uint64_t.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is represented by 8 bytes written in little endian.
|
||||
*/
|
||||
ALLOCATION_SIZE = 10,
|
||||
|
||||
/**
|
||||
* Can be used to get if a buffer has protected content. If the buffer does not have protected
|
||||
* content, this should return 0. If a buffer has protected content, this should return 1.
|
||||
*
|
||||
* In future versions, this field will be extended to expose more information about the type
|
||||
* of protected content in the buffer.
|
||||
*
|
||||
* The protected content is a uint64_t.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is represented by 8 bytes written in little endian.
|
||||
*/
|
||||
PROTECTED_CONTENT = 11,
|
||||
|
||||
/**
|
||||
* Can be used to get the compression strategy of the buffer. If the device has more than one
|
||||
* compression strategy, it should have different unique values for each compression
|
||||
* strategy.
|
||||
*
|
||||
* Compression is a stable aidl android.hardware.graphics.common.ExtendableType.
|
||||
*
|
||||
* android.hardware.graphics.common.Compression defines the standard compression
|
||||
* strategies. Vendors may extend this type to include any compression strategies.
|
||||
*
|
||||
* When it is encoded into a byte stream, the length of the name field string is written using
|
||||
* 8 bytes in little endian. It is followed by a char array of the string's
|
||||
* characters. The array is not null-terminated. Finally the value field is written as 8 bytes
|
||||
* in little endian.
|
||||
*/
|
||||
COMPRESSION = 12,
|
||||
|
||||
/**
|
||||
* Can be used to get how the buffer's planes are interlaced.
|
||||
*
|
||||
* Interlaced is a stable aidl android.hardware.graphics.common.ExtendableType.
|
||||
*
|
||||
* android.hardware.graphics.common.Interlaced defines the standard interlaced
|
||||
* strategies. Vendors may extend this type to include any non-standard interlaced
|
||||
* strategies.
|
||||
*
|
||||
* When it is encoded into a byte stream, the length of the name field string is written using
|
||||
* 8 bytes in little endian. It is followed by a char array of the string's
|
||||
* characters. The array is not null-terminated. Finally the value field is written as 8 bytes
|
||||
* in little endian.
|
||||
*/
|
||||
INTERLACED = 13,
|
||||
|
||||
/**
|
||||
* Can be used to get the chroma siting of a buffer.
|
||||
*
|
||||
* Chroma siting is a stable aidl android.hardware.graphics.common.ExtendableType.
|
||||
*
|
||||
* android.hardware.graphics.common.ChromaSiting defines the standard chroma
|
||||
* sitings. Vendors may extend this type to include any non-standard chroma sitings.
|
||||
*
|
||||
* When it is encoded into a byte stream, the length of the name field string is written using
|
||||
* 8 bytes in little endian. It is followed by a char array of the string's
|
||||
* characters. The array is not null-terminated. Finally the value field is written as 8 bytes
|
||||
* in little endian.
|
||||
*/
|
||||
CHROMA_SITING = 14,
|
||||
|
||||
/**
|
||||
* Can be used to get the PlaneLayout(s) of the buffer. There should be one PlaneLayout per
|
||||
* plane in the buffer. For example if the buffer only has one plane, only one PlaneLayout
|
||||
* should be returned.
|
||||
*
|
||||
* If the buffer has planes interlaced through time, the returned PlaneLayout structs should be
|
||||
* ordered by time. The nth PlaneLayout should be from the same time or earlier than the
|
||||
* n+1 PlaneLayout.
|
||||
*
|
||||
* The plane layout is a list of stable aidl android.hardware.graphics.common.PlaneLayout's.
|
||||
*
|
||||
* When it is encoded into a byte stream, the total number of PlaneLayouts is written using
|
||||
* 8 bytes in little endian. It is followed by each PlaneLayout.
|
||||
*
|
||||
* To encode a PlaneLayout, write the length of its PlaneLayoutComponent[] components
|
||||
* field as 8 bytes in little endian and then encode each of its components. Finally, write the
|
||||
* following fields in this order each as 8 bytes in little endian: offsetInBytes,
|
||||
* sampleIncrementInBits, strideInBytes, widthInSamples, totalSizeInBytes,
|
||||
* horizontalSubsampling, verticalSubsampling.
|
||||
*
|
||||
* To encode a PlaneLayoutComponent, encode its PlaneLayoutComponentType type field. Next
|
||||
* encode offsetInBits followed by sizeInBits each as 8 bytes in little endian.
|
||||
*
|
||||
* To encode a PlaneLayoutComponentType, write the length of the name field string as
|
||||
* 8 bytes in little endian. It is followed by a char array of the string's
|
||||
* characters. The array is not null-terminated. Finally the value field is written as 8 bytes
|
||||
* in little endian.
|
||||
*/
|
||||
PLANE_LAYOUTS = 15,
|
||||
|
||||
/**
|
||||
* Can be used to get or set the dataspace of the buffer. The framework may attempt to set
|
||||
* this value.
|
||||
*
|
||||
* The default dataspace is Dataspace::UNKNOWN. If this dataspace is set to any valid value
|
||||
* other than Dataspace::UNKNOWN, this dataspace overrides all other dataspaces. For example,
|
||||
* if the buffer has Dataspace::DISPLAY_P3 and it is being displayed on a composer Layer that
|
||||
* is Dataspace::sRGB, the buffer should be treated as a DISPLAY_P3 buffer.
|
||||
*
|
||||
* The dataspace is a stable aidl android.hardware.graphics.common.Dataspace.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is first cast to a int32_t and then represented in
|
||||
* the byte stream by 4 bytes written in little endian.
|
||||
*/
|
||||
DATASPACE = 16,
|
||||
|
||||
/**
|
||||
* Can be used to get or set the BlendMode. The framework may attempt to set this value.
|
||||
*
|
||||
* The default blend mode is INVALID. If the BlendMode is set to any
|
||||
* valid value other than INVALID, this BlendMode overrides all other
|
||||
* dataspaces. For a longer description of this behavior see MetadataType::DATASPACE.
|
||||
*
|
||||
* The blend mode is a stable aidl android.hardware.graphics.common.BlendMode.
|
||||
*
|
||||
* When it is encoded into a byte stream, it is first cast to a int32_t and then represented by
|
||||
* 4 bytes written in little endian.
|
||||
*/
|
||||
BLEND_MODE = 17,
|
||||
}
|
||||
Reference in New Issue
Block a user