| /* 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_ |