1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
/*
* Copyright (C) 2018-2020 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 FORMAT_INFO_H_
#define FORMAT_INFO_H_
#include "mali_gralloc_buffer.h"
typedef uint8_t format_support_flags;
/* Base format unsupported */
#define F_NONE 0
/* Base format supports uncompressed */
#define F_LIN ((uint8_t)1 << 0)
/* Base format supports AFBC */
#define F_AFBC ((uint8_t)1 << 1)
/* Base format supports AFBC with different swizzle */
#define F_AFBC_SWIZ ((uint8_t)1 << 2)
typedef struct
{
uint64_t width;
uint64_t height;
} rect_t;
constexpr bool is_power2(uint8_t n)
{
return ((n & (n-1)) == 0);
}
/*
* Pixel format information.
*
* These properties are used by gralloc for buffer allocation.
* Each format is uniquely identified with 'id'.
*/
typedef struct
{
uint32_t id; /* Format ID. */
uint8_t npln; /* Number of planes. */
uint8_t ncmp[MAX_PLANES]; /* Number of components in each plane. */
uint8_t bps; /* Bits per sample (primary/largest). */
uint8_t bpp_afbc[MAX_PLANES]; /* Bits per pixel (AFBC), without implicit padding. 'X' in RGBX is still included. */
uint8_t bpp[MAX_PLANES]; /* Bits per pixel (linear/uncompressed), including any implicit sample padding defined by format (e.g. 10-bit Y210 padded to 16-bits).
* NOTE: bpp[n] and/or (bpp[n] * align_w_cpu) must be multiples of 8. */
uint8_t hsub; /* Horizontal sub-sampling (YUV formats). Pixel rounding in width (all formats). Must be a power of 2. */
uint8_t vsub; /* Vertical sub-sampling (YUV formats). Pixel rounding in height (all formats). Must be a power of 2. */
uint8_t align_w; /* Alignment of width (per plane, in pixels). Must be a power of 2. NOTE: where 'is_yuv == true', this must be a multiple of 'hsub'. */
uint8_t align_h; /* Alignment of height (per plane, in pixels). Must be a power of 2. NOTE: where 'is_yuv == true', this must be a multiple of 'vsub'. */
uint8_t align_w_cpu; /* Alignment of width for CPU access (per plane, in pixels). ALIGN_W_CPU_DEFAULT: 1. Must be a power of 2. */
uint16_t tile_size; /* Tile size (in pixels), assumed square. Uncompressed only. */
bool has_alpha; /* Alpha channel present. */
bool is_rgb; /* RGB format. */
bool is_yuv; /* YUV format. */
bool afbc; /* AFBC supported (per specification and by gralloc). IP support not considered. */
bool linear; /* Linear/uncompressed supported. */
bool yuv_transform; /* Supports AFBC YUV transform: 3+ channel RGB (strict R-G-B-? order) with less than 12-bit per sample. */
bool flex; /* Linear version of format can be represented as flex. */
bool planes_contiguous; /* True if all planes in format are contiguous in memory. Has no effect on non-planar formats. */
const char *name; /* Human-readable name. */
/* Computes the total number of components in the format. */
int total_components() const
{
int sum = 0;
for (auto n: ncmp)
{
sum += n;
}
return sum;
}
} format_info_t;
typedef struct
{
uint32_t id; /* Format ID. */
format_support_flags cpu_wr; /* CPU producer. */
format_support_flags cpu_rd; /* CPU consumer. */
format_support_flags gpu_wr; /* GPU producer. */
format_support_flags gpu_rd; /* GPU consumer. */
format_support_flags dpu_wr; /* DPU producer. */
format_support_flags dpu_rd; /* DPU consumer. */
format_support_flags dpu_aeu_wr; /* DPU AEU producer. (UNUSED IN EXYNOS) */
format_support_flags vpu_wr; /* VPU producer. */
format_support_flags vpu_rd; /* VPU consumer. */
format_support_flags cam_wr; /* Camera producer. */
} format_ip_support_t;
extern const format_info_t formats[];
extern const format_ip_support_t formats_ip_support[];
extern const size_t num_formats;
extern const size_t num_ip_formats;
extern int32_t get_format_index(const uint32_t base_format);
extern int32_t get_ip_format_index(const uint32_t base_format);
extern uint32_t get_internal_format(const uint32_t base_format, const bool map_to_internal);
void get_format_dataspace(uint32_t base_format,
uint64_t usage,
int width,
int height,
android_dataspace_t *dataspace);
extern bool sanitize_formats(void);
extern const char *format_name(const uint32_t base_format);
#endif
|
