| /* |
| * Copyright (C) 2016-2017 ARM Limited. All rights reserved. |
| * |
| * Copyright (C) 2008 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. |
| */ |
| |
| #ifndef MALI_GRALLOC_FORMATS_H_ |
| #define MALI_GRALLOC_FORMATS_H_ |
| |
| #include <system/graphics.h> |
| |
| /* Internal formats are represented in gralloc as a 64bit identifier |
| * where the 32 lower bits are a base format and the 32 upper bits are modifiers. |
| * |
| * Modifier bits are divided into mutually exclusive ones and those that are not. |
| */ |
| /* Internal format type */ |
| typedef uint64_t mali_gralloc_internal_format; |
| |
| /* Internal format masks */ |
| #define MALI_GRALLOC_INTFMT_FMT_MASK 0x00000000ffffffffULL |
| #define MALI_GRALLOC_INTFMT_EXT_MASK 0xffffffff00000000ULL |
| #define MALI_GRALLOC_INTFMT_ME_EXT_MASK 0x0000ffff00000000ULL |
| #define MALI_GRALLOC_INTFMT_REG_EXT_MASK 0xffff000000000000ULL |
| |
| /* Internal base formats */ |
| |
| /* Base formats that do not have an identical HAL match |
| * are defined starting at the Android private range |
| */ |
| #define MALI_GRALLOC_FORMAT_INTERNAL_RANGE_BASE 0x100 |
| |
| typedef enum |
| { |
| MALI_GRALLOC_FORMAT_TYPE_USAGE, |
| MALI_GRALLOC_FORMAT_TYPE_INTERNAL, |
| } mali_gralloc_format_type; |
| |
| typedef enum |
| { |
| /* Internal definitions for HAL formats. */ |
| MALI_GRALLOC_FORMAT_INTERNAL_RGBA_8888 = HAL_PIXEL_FORMAT_RGBA_8888, |
| MALI_GRALLOC_FORMAT_INTERNAL_RGBX_8888 = HAL_PIXEL_FORMAT_RGBX_8888, |
| MALI_GRALLOC_FORMAT_INTERNAL_RGB_888 = HAL_PIXEL_FORMAT_RGB_888, |
| MALI_GRALLOC_FORMAT_INTERNAL_RGB_565 = HAL_PIXEL_FORMAT_RGB_565, |
| MALI_GRALLOC_FORMAT_INTERNAL_BGRA_8888 = HAL_PIXEL_FORMAT_BGRA_8888, |
| MALI_GRALLOC_FORMAT_INTERNAL_YV12 = HAL_PIXEL_FORMAT_YV12, |
| MALI_GRALLOC_FORMAT_INTERNAL_Y8 = HAL_PIXEL_FORMAT_Y8, |
| MALI_GRALLOC_FORMAT_INTERNAL_Y16 = HAL_PIXEL_FORMAT_Y16, |
| MALI_GRALLOC_FORMAT_INTERNAL_YUV420_888 = HAL_PIXEL_FORMAT_YCbCr_420_888, |
| |
| /* Camera specific HAL formats */ |
| MALI_GRALLOC_FORMAT_INTERNAL_RAW16 = HAL_PIXEL_FORMAT_RAW16, |
| MALI_GRALLOC_FORMAT_INTERNAL_RAW12 = HAL_PIXEL_FORMAT_RAW12, |
| MALI_GRALLOC_FORMAT_INTERNAL_RAW10 = HAL_PIXEL_FORMAT_RAW10, |
| MALI_GRALLOC_FORMAT_INTERNAL_BLOB = HAL_PIXEL_FORMAT_BLOB, |
| |
| /* Flexible YUV formats would be parsed but not have any representation as |
| * internal format itself but one of the ones below |
| */ |
| |
| /* The internal private formats that have no HAL equivivalent are defined |
| * afterwards starting at a specific base range */ |
| MALI_GRALLOC_FORMAT_INTERNAL_NV12 = MALI_GRALLOC_FORMAT_INTERNAL_RANGE_BASE, |
| MALI_GRALLOC_FORMAT_INTERNAL_NV21, |
| MALI_GRALLOC_FORMAT_INTERNAL_YUV422_8BIT, |
| |
| /* Extended YUV formats |
| * |
| * NOTE: P010, P210, and Y410 are only supported uncompressed. |
| */ |
| MALI_GRALLOC_FORMAT_INTERNAL_Y0L2, |
| MALI_GRALLOC_FORMAT_INTERNAL_P010, |
| MALI_GRALLOC_FORMAT_INTERNAL_P210, |
| MALI_GRALLOC_FORMAT_INTERNAL_Y210, |
| MALI_GRALLOC_FORMAT_INTERNAL_Y410, |
| |
| /* Add more internal formats here. Make sure decode_internal_format() is updated. */ |
| |
| /* These are legacy 0.3 gralloc formats used only by the wrap/unwrap macros. */ |
| MALI_GRALLOC_FORMAT_INTERNAL_YV12_WRAP, |
| MALI_GRALLOC_FORMAT_INTERNAL_Y8_WRAP, |
| MALI_GRALLOC_FORMAT_INTERNAL_Y16_WRAP, |
| |
| MALI_GRALLOC_FORMAT_INTERNAL_RANGE_LAST, |
| } mali_gralloc_pixel_format; |
| |
| /* Format Modifier Bits Locations */ |
| #define MALI_GRALLOC_INTFMT_ME_EXTENSION_BIT_START 32 |
| #define MALI_GRALLOC_INTFMT_EXTENSION_BIT_START (MALI_GRALLOC_INTFMT_ME_EXTENSION_BIT_START + 16) |
| |
| /* Mutually Exclusive Modifier Bits */ |
| |
| /* This format will use AFBC */ |
| #define MALI_GRALLOC_INTFMT_AFBC_BASIC (1ULL << (MALI_GRALLOC_INTFMT_ME_EXTENSION_BIT_START + 0)) |
| |
| /* This format uses AFBC split block mode */ |
| #define MALI_GRALLOC_INTFMT_AFBC_SPLITBLK (1ULL << (MALI_GRALLOC_INTFMT_ME_EXTENSION_BIT_START + 1)) |
| |
| #define MALI_GRALLOC_INTFMT_UNUSED (1ULL << (MALI_GRALLOC_INTFMT_ME_EXTENSION_BIT_START + 2)) |
| |
| /* This format uses AFBC wide block mode */ |
| #define MALI_GRALLOC_INTFMT_AFBC_WIDEBLK (1ULL << (MALI_GRALLOC_INTFMT_ME_EXTENSION_BIT_START + 3)) |
| |
| /* Regular Modifier Bits */ |
| #define MALI_GRALLOC_INTFMT_AFBC_TILED_HEADERS (1ULL << (MALI_GRALLOC_INTFMT_EXTENSION_BIT_START + 0)) |
| |
| /* This mask should be used to check or clear support for AFBC for an internal format |
| * These bits are mutually exclusive so this mask should not be used to enable support |
| */ |
| #define MALI_GRALLOC_INTFMT_AFBCENABLE_MASK \ |
| ((uint64_t)(MALI_GRALLOC_INTFMT_AFBC_BASIC | MALI_GRALLOC_INTFMT_AFBC_SPLITBLK | MALI_GRALLOC_INTFMT_AFBC_WIDEBLK)) |
| |
| /* These are legacy Gralloc 0.3 support macros for passing private formats through the 0.3 alloc interface. |
| * It packs modifier bits together with base format into a 32 bit format identifier. |
| * Gralloc 1.0 interface should use private functions to set private buffer format in the buffer descriptor. |
| * |
| * Packing: |
| * |
| * Bits 15-0: mali_gralloc_pixel_format format |
| * Bits 23-16: mutually exclusive modifier bits |
| * Bits 31-24: regular modifier bits |
| */ |
| static inline int mali_gralloc_format_wrapper(int format, int modifiers) |
| { |
| /* Internal formats that are identical to HAL formats |
| * have the same definition. This is convenient for |
| * client parsing code to not have to parse them separately. |
| * |
| * For 3 of the HAL YUV formats that have very large definitions |
| * this causes problems for packing in modifier bits. |
| * Because of this reason we redefine these three formats |
| * while packing/unpacking them. |
| */ |
| if (format == MALI_GRALLOC_FORMAT_INTERNAL_YV12) |
| { |
| format = MALI_GRALLOC_FORMAT_INTERNAL_YV12_WRAP; |
| } |
| else if (format == MALI_GRALLOC_FORMAT_INTERNAL_Y8) |
| { |
| format = MALI_GRALLOC_FORMAT_INTERNAL_Y8_WRAP; |
| } |
| else if (format == MALI_GRALLOC_FORMAT_INTERNAL_Y16) |
| { |
| format = MALI_GRALLOC_FORMAT_INTERNAL_Y16_WRAP; |
| } |
| |
| return (modifiers | format); |
| } |
| |
| static inline uint64_t mali_gralloc_format_unwrap(int x) |
| { |
| uint64_t internal_format = (uint64_t)(((((uint64_t)(x)) & 0xff000000) << 24) | // Regular modifier bits |
| ((((uint64_t)(x)) & 0x00ff0000) << 16) | // Mutually exclusive modifier bits |
| (((uint64_t)(x)) & 0x0000ffff)); // Private format |
| |
| uint64_t base_format = internal_format & MALI_GRALLOC_INTFMT_FMT_MASK; |
| uint64_t modifiers = internal_format & MALI_GRALLOC_INTFMT_EXT_MASK; |
| |
| if (base_format == MALI_GRALLOC_FORMAT_INTERNAL_YV12_WRAP) |
| { |
| base_format = MALI_GRALLOC_FORMAT_INTERNAL_YV12; |
| } |
| else if (base_format == MALI_GRALLOC_FORMAT_INTERNAL_Y8_WRAP) |
| { |
| base_format = MALI_GRALLOC_FORMAT_INTERNAL_Y8; |
| } |
| else if (base_format == MALI_GRALLOC_FORMAT_INTERNAL_Y16_WRAP) |
| { |
| base_format = MALI_GRALLOC_FORMAT_INTERNAL_Y16; |
| } |
| |
| return (modifiers | base_format); |
| } |
| |
| #define GRALLOC_PRIVATE_FORMAT_WRAPPER(x) (mali_gralloc_format_wrapper(x, 0)) |
| #define GRALLOC_PRIVATE_FORMAT_WRAPPER_AFBC(x) (mali_gralloc_format_wrapper(x, (MALI_GRALLOC_INTFMT_AFBC_BASIC >> 16))) |
| #define GRALLOC_PRIVATE_FORMAT_WRAPPER_AFBC_SPLITBLK(x) \ |
| (mali_gralloc_format_wrapper(x, (MALI_GRALLOC_INTFMT_AFBC_SPLITBLK >> 16))) |
| #define GRALLOC_PRIVATE_FORMAT_WRAPPER_AFBC_WIDEBLK(x) \ |
| (mali_gralloc_format_wrapper(x, (MALI_GRALLOC_INTFMT_AFBC_WIDEBLK >> 16))) |
| #define GRALLOC_PRIVATE_FORMAT_WRAPPER_AFBC_TILED_HEADERS_BASIC(x) \ |
| (mali_gralloc_format_wrapper(x, (MALI_GRALLOC_INTFMT_AFBC_TILED_HEADERS >> 24) | \ |
| (MALI_GRALLOC_INTFMT_AFBC_BASIC >> 16))) |
| #define GRALLOC_PRIVATE_FORMAT_WRAPPER_AFBC_TILED_HEADERS_WIDE(x) \ |
| (mali_gralloc_format_wrapper(x, (MALI_GRALLOC_INTFMT_AFBC_TILED_HEADERS >> 24) | \ |
| (MALI_GRALLOC_INTFMT_AFBC_WIDEBLK >> 16))) |
| #define GRALLOC_PRIVATE_FORMAT_UNWRAP(x) mali_gralloc_format_unwrap(x) |
| |
| /* IP block capability masks */ |
| #define MALI_GRALLOC_FORMAT_CAPABILITY_OPTIONS_PRESENT ((uint64_t)(1 << 0)) |
| #define MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_BASIC ((uint64_t)(1 << 1)) |
| #define MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_SPLITBLK ((uint64_t)(1 << 2)) |
| #define MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_WIDEBLK ((uint64_t)(1 << 3)) |
| #define MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_WIDEBLK_YUV_DISABLE ((uint64_t)(1 << 4)) |
| #define MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_YUV_NOREAD ((uint64_t)(1 << 5)) |
| #define MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_YUV_NOWRITE ((uint64_t)(1 << 6)) |
| #define MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_TILED_HEADERS ((uint64_t)(1 << 7)) |
| |
| #define MALI_GRALLOC_FORMAT_CAPABILITY_AFBCENABLE_MASK \ |
| ((uint64_t)(MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_BASIC | MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_SPLITBLK | \ |
| MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_WIDEBLK | MALI_GRALLOC_FORMAT_CAPABILITY_AFBC_TILED_HEADERS)) |
| |
| struct mali_gralloc_format_caps |
| { |
| uint64_t caps_mask; |
| }; |
| typedef struct mali_gralloc_format_caps mali_gralloc_format_caps; |
| |
| #define MALI_GRALLOC_FORMATCAPS_SYM_NAME mali_gralloc_format_capabilities |
| #define MALI_GRALLOC_FORMATCAPS_SYM_NAME_STR "mali_gralloc_format_capabilities" |
| |
| /* Producer and Consumer definitions */ |
| typedef enum |
| { |
| MALI_GRALLOC_PRODUCER_VIDEO_DECODER, |
| MALI_GRALLOC_PRODUCER_GPU, |
| MALI_GRALLOC_PRODUCER_CAMERA, |
| } mali_gralloc_producer_type; |
| |
| typedef enum |
| { |
| |
| /* For surface composition in SurfaceFlinger a producer |
| * will not know what consumer will process a buffer. |
| * |
| * MALI_GRALLOC_CONSUMER_GPU_OR_DISPLAY means the GPU |
| * MUST support the given format but it should be allocated |
| * with preference to the DPU. |
| */ |
| MALI_GRALLOC_CONSUMER_GPU_OR_DISPLAY, |
| MALI_GRALLOC_CONSUMER_VIDEO_ENCODER, |
| |
| /* This is used when no known "premium" dpu is configured. |
| * For example, HDLCD/CLCD would be such a dpu. |
| */ |
| MALI_GRALLOC_CONSUMER_GPU_EXCL, |
| } mali_gralloc_consumer_type; |
| |
| /* Internal prototypes */ |
| #if defined(GRALLOC_LIBRARY_BUILD) |
| uint64_t mali_gralloc_select_format(uint64_t req_format, mali_gralloc_format_type type, uint64_t usage, |
| int buffer_size); |
| #endif |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| void mali_gralloc_get_gpu_caps(struct mali_gralloc_format_caps *gpu_caps); |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* MALI_GRALLOC_FORMATS_H_ */ |