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
|
/* Copyright (c) 2018-2019 The Khronos Group Inc.
* Copyright (c) 2018-2019 Valve Corporation
* Copyright (c) 2018-2019 LunarG, Inc.
* Copyright (C) 2018-2019 Google Inc.
*
* 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.
*
* Author: Dave Houlton <daveh@lunarg.com>
*/
#ifndef ANDROID_NDK_TYPES_H_
#define ANDROID_NDK_TYPES_H_
#ifdef VK_USE_PLATFORM_ANDROID_KHR
// All eums referenced by VK_ANDROID_external_memory_android_hardware_buffer are present in
// the platform-28 (Android P) versions of the header files. A partial set exists in the
// platform-26 (O) headers, where hardware_buffer.h first appears in the NDK.
//
// Building Vulkan validation with NDK header files prior to platform-26 is not supported.
//
// Decoder ring for Android compile symbols found here: https://github.com/android-ndk/ndk/issues/407
#ifdef __ANDROID__ // Compiling for Android
#include <android/api-level.h>
#include <android/hardware_buffer.h> // First appearance in Android O (platform-26)
// If NDK is O (platform-26 or -27), supplement the missing enums with pre-processor defined literals
// If Android P or later, then all required enums are already defined
#if defined(__ANDROID_API_O__) && !defined(__ANDROID_API_P__)
// Formats
#define AHARDWAREBUFFER_FORMAT_D16_UNORM 0x30
#define AHARDWAREBUFFER_FORMAT_D24_UNORM 0x31
#define AHARDWAREBUFFER_FORMAT_D24_UNORM_S8_UINT 0x32
#define AHARDWAREBUFFER_FORMAT_D32_FLOAT 0x33
#define AHARDWAREBUFFER_FORMAT_D32_FLOAT_S8_UINT 0x34
#define AHARDWAREBUFFER_FORMAT_S8_UINT 0x35
// Usage bits
#define AHARDWAREBUFFER_USAGE_GPU_CUBE_MAP 0x2000000
#define AHARDWAREBUFFER_USAGE_GPU_MIPMAP_COMPLETE 0x4000000
#endif // __ANDROID_API_O__ && !_P__
#else // Not __ANDROID__, but VK_USE_PLATFORM_ANDROID_KHR
// This combination should not be seen in the wild, but can be used to allow testing
// of the AHB extension validation on other platforms using MockICD
//
// Define the minimal set of NDK enums and structs needed to compile
// VK_ANDROID_external_memory_android_hardware_buffer validation without an NDK present
struct AHardwareBuffer {};
// Enumerations of format and usage flags for Android opaque external memory blobs
typedef enum AHardwareBufferFormat {
AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM = 1,
AHARDWAREBUFFER_FORMAT_R8G8B8X8_UNORM = 2,
AHARDWAREBUFFER_FORMAT_R8G8B8_UNORM = 3,
AHARDWAREBUFFER_FORMAT_R5G6B5_UNORM = 4,
AHARDWAREBUFFER_FORMAT_R16G16B16A16_FLOAT = 0x16,
AHARDWAREBUFFER_FORMAT_R10G10B10A2_UNORM = 0x2b,
AHARDWAREBUFFER_FORMAT_D16_UNORM = 0x30,
AHARDWAREBUFFER_FORMAT_D24_UNORM = 0x31,
AHARDWAREBUFFER_FORMAT_D24_UNORM_S8_UINT = 0x32,
AHARDWAREBUFFER_FORMAT_D32_FLOAT = 0x33,
AHARDWAREBUFFER_FORMAT_D32_FLOAT_S8_UINT = 0x34,
AHARDWAREBUFFER_FORMAT_S8_UINT = 0x35,
AHARDWAREBUFFER_FORMAT_BLOB = 0x21
} AHardwareBufferFormat;
typedef enum AHardwareBufferUsage {
AHARDWAREBUFFER_USAGE_GPU_SAMPLED_IMAGE = 0x100,
AHARDWAREBUFFER_USAGE_GPU_COLOR_OUTPUT = 0x200,
AHARDWAREBUFFER_USAGE_GPU_CUBE_MAP = 0x2000000,
AHARDWAREBUFFER_USAGE_GPU_MIPMAP_COMPLETE = 0x4000000,
AHARDWAREBUFFER_USAGE_PROTECTED_CONTENT = 0x4000,
AHARDWAREBUFFER_USAGE_GPU_DATA_BUFFER = 0x1000000
} AHardwareBufferUsage;
typedef struct AHardwareBuffer_Desc {
uint32_t format; // One of AHARDWAREBUFFER_FORMAT_*.
uint32_t height; // Height in pixels.
uint32_t layers; // Number of images in an image array.
uint32_t rfu0; // Initialize to zero, reserved for future use.
uint64_t rfu1; // Initialize to zero, reserved for future use.
uint32_t stride; // Row stride in pixels, ignored for AHardwareBuffer_allocate()
uint64_t usage; // Combination of AHARDWAREBUFFER_USAGE_*.
uint32_t width; // Width in pixels.
} AHardwareBuffer_Desc;
// Minimal NDK fxn stubs to allow testing on ndk-less platform
static inline int AHardwareBuffer_allocate(const AHardwareBuffer_Desc *ahbDesc, AHardwareBuffer **buffer) {
size_t size = ahbDesc->height * ahbDesc->width * 8; // Alloc for largest (64 bpp) format
if (size < sizeof(AHardwareBuffer_Desc)) size = sizeof(AHardwareBuffer_Desc);
*buffer = (AHardwareBuffer *)malloc(size);
memcpy((void *)(*buffer), (void *)ahbDesc, sizeof(AHardwareBuffer_Desc));
return 0;
}
static inline void AHardwareBuffer_release(AHardwareBuffer *buffer) {
if (buffer) free(buffer);
}
static inline void AHardwareBuffer_describe(const AHardwareBuffer *buffer, AHardwareBuffer_Desc *outDesc) {
if (buffer && outDesc) {
memcpy((void *)outDesc, (void *)buffer, sizeof(AHardwareBuffer_Desc));
}
return;
}
#endif // __ANDROID__
#endif // VK_USE_PLATFORM_ANDROID_KHR
#endif // ANDROID_NDK_TYPES_H_
|
