| /* |
| * MESA: buffer_handle_t is defined by all Mesa builds, even if |
| * one is building for a non-Android target. This avoids unnecessary |
| * conditionals in driver code. |
| * |
| * We don't need to define buffer_handle_t locally when (__ANDROID__) |
| * or ANDROID are set. Here's the distinction between the two: |
| * |
| * - AOSP always defines ANDROID, since it just means one is using the |
| * AOSP tree. It means the build environment is Android, roughly. |
| * - __ANDROID__ is defined by the toolchain. This typically means the |
| * build target is Android. |
| * |
| * If the build environment is Android, AOSP can provide common Android |
| * headers, such as <cutils/native_handle.h>. This allows one to build |
| * and test certain aspects of Android window system code, on the host |
| * system rather the build target. |
| */ |
| |
| #if defined(__ANDROID__) || defined(ANDROID) |
| |
| #include <cutils/native_handle.h> |
| #if ANDROID_API_LEVEL < 28 |
| /* buffer_handle_t was defined in the deprecated system/window.h */ |
| typedef const native_handle_t *buffer_handle_t; |
| #endif |
| |
| #else |
| |
| typedef void *buffer_handle_t; |
| |
| #endif |
| |
| /* |
| * Copyright 2015 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 __VK_ANDROID_NATIVE_BUFFER_H__ |
| #define __VK_ANDROID_NATIVE_BUFFER_H__ |
| |
| #include <vulkan/vulkan.h> |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| #define VK_ANDROID_native_buffer 1 |
| |
| #define VK_ANDROID_NATIVE_BUFFER_EXTENSION_NUMBER 11 |
| /* |
| * NOTE ON VK_ANDROID_NATIVE_BUFFER_SPEC_VERSION 6 |
| * |
| * This version of the extension transitions from gralloc0 to gralloc1 usage |
| * flags (int -> 2x uint64_t). The WSI implementation will temporarily continue |
| * to fill out deprecated fields in VkNativeBufferANDROID, and will call the |
| * deprecated vkGetSwapchainGrallocUsageANDROID if the new |
| * vkGetSwapchainGrallocUsage2ANDROID is not supported. This transitionary |
| * backwards-compatibility support is temporary, and will likely be removed |
| * (along with all gralloc0 support) in a future release. |
| */ |
| /* |
| * NOTE ON VK_ANDROID_NATIVE_BUFFER_SPEC_VERSION 8 |
| * |
| * This version of the extension doesn't introduce new types or structs, but is |
| * to accommodate the new struct VkBindImageMemorySwapchainInfoKHR added in |
| * VK_KHR_swapchain spec version 69. When VkBindImageMemorySwapchainInfoKHR is |
| * chained in the pNext chain of VkBindImageMemoryInfo, a VkNativeBufferANDROID |
| * that holds the correct gralloc handle according to the imageIndex specified |
| * in VkBindImageMemorySwapchainInfoKHR will be additionally chained to the |
| * pNext chain of VkBindImageMemoryInfo and passed down to the driver. |
| */ |
| /* |
| * NOTE ON VK_ANDROID_NATIVE_BUFFER_SPEC_VERSION 9 |
| * |
| * This version of the extension is largely designed to clean up the mix of |
| * GrallocUsage and GrallocUsage2 |
| */ |
| /* |
| * NOTE ON VK_ANDROID_NATIVE_BUFFER_SPEC_VERSION 10 |
| * |
| * This version of the extension cleans up a bug introduced in version 9 |
| */ |
| /* |
| * NOTE ON VK_ANDROID_NATIVE_BUFFER_SPEC_VERSION 11 |
| * |
| * This version of the extension deprecates the last of grallocusage and |
| * extends VkNativeBufferANDROID to support passing AHardwareBuffer* |
| */ |
| #define VK_ANDROID_NATIVE_BUFFER_SPEC_VERSION 11 |
| #define VK_ANDROID_NATIVE_BUFFER_EXTENSION_NAME "VK_ANDROID_native_buffer" |
| |
| #define VK_ANDROID_NATIVE_BUFFER_ENUM(type, id) \ |
| ((type)(1000000000 + \ |
| (1000 * (VK_ANDROID_NATIVE_BUFFER_EXTENSION_NUMBER - 1)) + (id))) |
| #define VK_STRUCTURE_TYPE_NATIVE_BUFFER_ANDROID \ |
| VK_ANDROID_NATIVE_BUFFER_ENUM(VkStructureType, 0) |
| #define VK_STRUCTURE_TYPE_SWAPCHAIN_IMAGE_CREATE_INFO_ANDROID \ |
| VK_ANDROID_NATIVE_BUFFER_ENUM(VkStructureType, 1) |
| #define VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PRESENTATION_PROPERTIES_ANDROID \ |
| VK_ANDROID_NATIVE_BUFFER_ENUM(VkStructureType, 2) |
| #define VK_STRUCTURE_TYPE_GRALLOC_USAGE_INFO_ANDROID \ |
| VK_ANDROID_NATIVE_BUFFER_ENUM(VkStructureType, 3) |
| #define VK_STRUCTURE_TYPE_GRALLOC_USAGE_INFO_2_ANDROID \ |
| VK_ANDROID_NATIVE_BUFFER_ENUM(VkStructureType, 4) |
| |
| /* clang-format off */ |
| typedef enum VkSwapchainImageUsageFlagBitsANDROID { |
| VK_SWAPCHAIN_IMAGE_USAGE_SHARED_BIT_ANDROID = 0x00000001, |
| VK_SWAPCHAIN_IMAGE_USAGE_FLAG_BITS_MAX_ENUM = 0x7FFFFFFF |
| } VkSwapchainImageUsageFlagBitsANDROID; |
| typedef VkFlags VkSwapchainImageUsageFlagsANDROID; |
| |
| /* |
| * struct VkNativeBufferUsage2ANDROID |
| * |
| * consumer: gralloc1 consumer usage flag |
| * producer: gralloc1 producer usage flag |
| */ |
| typedef struct { |
| uint64_t consumer; |
| uint64_t producer; |
| } VkNativeBufferUsage2ANDROID; |
| |
| /* |
| * struct VkNativeBufferANDROID |
| * |
| * sType: VK_STRUCTURE_TYPE_NATIVE_BUFFER_ANDROID |
| * pNext: NULL or a pointer to a structure extending this structure |
| * handle: buffer handle returned from gralloc alloc() |
| * stride: stride returned from gralloc alloc() |
| * format: gralloc format requested when the buffer was allocated |
| * usage: gralloc usage requested when the buffer was allocated |
| * usage2: gralloc usage requested when the buffer was allocated |
| * usage3: gralloc usage requested when the buffer was allocated |
| * ahb: The AHardwareBuffer* from the actual ANativeWindowBuffer. Caller |
| * maintains ownership of resource. AHardwareBuffer pointer is only valid |
| * for the duration of the function call |
| */ |
| typedef struct { |
| VkStructureType sType; |
| const void* pNext; |
| buffer_handle_t handle; |
| int stride; |
| int format; |
| int usage; /* DEPRECATED in SPEC_VERSION 6 */ |
| VkNativeBufferUsage2ANDROID usage2; /* DEPRECATED in SPEC_VERSION 9 */ |
| uint64_t usage3; /* ADDED in SPEC_VERSION 9 */ |
| struct AHardwareBuffer* ahb; /* ADDED in SPEC_VERSION 11 */ |
| } VkNativeBufferANDROID; |
| |
| /* |
| * struct VkSwapchainImageCreateInfoANDROID |
| * |
| * sType: VK_STRUCTURE_TYPE_SWAPCHAIN_IMAGE_CREATE_INFO_ANDROID |
| * pNext: NULL or a pointer to a structure extending this structure |
| * usage: is a bitmask of VkSwapchainImageUsageFlagsANDROID |
| */ |
| typedef struct { |
| VkStructureType sType; |
| const void* pNext; |
| VkSwapchainImageUsageFlagsANDROID usage; |
| } VkSwapchainImageCreateInfoANDROID; |
| |
| /* |
| * struct VkPhysicalDevicePresentationPropertiesANDROID |
| * |
| * sType: VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PRESENTATION_PROPERTIES_ANDROID |
| * pNext: NULL or a pointer to a structure extending this structure |
| * sharedImage: specifies if the image can be shared with the display system |
| */ |
| typedef struct { |
| VkStructureType sType; |
| const void* pNext; |
| VkBool32 sharedImage; |
| } VkPhysicalDevicePresentationPropertiesANDROID; |
| |
| /* |
| * struct VkGrallocUsageInfoANDROID |
| * |
| * sType: VK_STRUCTURE_TYPE_GRALLOC_USAGE_INFO_ANDROID |
| * pNext: NULL or a pointer to a structure extending this structure |
| * format: value specifying the format the image will be created with |
| * imageUsage: bitmask of VkImageUsageFlagBits describing intended usage |
| * |
| * DEPRECATED in SPEC_VERSION 10 |
| */ |
| typedef struct { |
| VkStructureType sType; |
| const void* pNext; |
| VkFormat format; |
| VkImageUsageFlags imageUsage; |
| } VkGrallocUsageInfoANDROID; |
| |
| /* |
| * struct VkGrallocUsageInfo2ANDROID |
| * |
| * sType: VK_STRUCTURE_TYPE_GRALLOC_USAGE_INFO_2_ANDROID |
| * pNext: NULL or a pointer to a structure extending this structure |
| * format: value specifying the format the image will be created with |
| * imageUsage: bitmask of VkImageUsageFlagBits describing intended usage |
| * swapchainImageUsage: is a bitmask of VkSwapchainImageUsageFlagsANDROID |
| * |
| * DEPRECATED in SPEC_VERSION 11 |
| */ |
| typedef struct { |
| VkStructureType sType; |
| const void* pNext; |
| VkFormat format; |
| VkImageUsageFlags imageUsage; |
| VkSwapchainImageUsageFlagsANDROID swapchainImageUsage; |
| } VkGrallocUsageInfo2ANDROID; |
| |
| /* DEPRECATED in SPEC_VERSION 6 */ |
| typedef VkResult (VKAPI_PTR *PFN_vkGetSwapchainGrallocUsageANDROID)( |
| VkDevice device, |
| VkFormat format, |
| VkImageUsageFlags imageUsage, |
| int* grallocUsage); |
| |
| /* DEPRECATED in SPEC_VERSION 9 */ |
| typedef VkResult (VKAPI_PTR *PFN_vkGetSwapchainGrallocUsage2ANDROID)( |
| VkDevice device, |
| VkFormat format, |
| VkImageUsageFlags imageUsage, |
| VkSwapchainImageUsageFlagsANDROID swapchainImageUsage, |
| uint64_t* grallocConsumerUsage, |
| uint64_t* grallocProducerUsage); |
| |
| /* DEPRECATED in SPEC_VERSION 10 */ |
| typedef VkResult (VKAPI_PTR *PFN_vkGetSwapchainGrallocUsage3ANDROID)( |
| VkDevice device, |
| const VkGrallocUsageInfoANDROID* grallocUsageInfo, |
| uint64_t* grallocUsage); |
| |
| /* DEPRECATED in SPEC_VERSION 11 */ |
| typedef VkResult (VKAPI_PTR *PFN_vkGetSwapchainGrallocUsage4ANDROID)( |
| VkDevice device, |
| const VkGrallocUsageInfo2ANDROID* grallocUsageInfo, |
| uint64_t* grallocUsage); |
| |
| typedef VkResult (VKAPI_PTR *PFN_vkAcquireImageANDROID)( |
| VkDevice device, |
| VkImage image, |
| int nativeFenceFd, |
| VkSemaphore semaphore, |
| VkFence fence); |
| |
| typedef VkResult (VKAPI_PTR *PFN_vkQueueSignalReleaseImageANDROID)( |
| VkQueue queue, |
| uint32_t waitSemaphoreCount, |
| const VkSemaphore* pWaitSemaphores, |
| VkImage image, |
| int* pNativeFenceFd); |
| |
| #ifndef VK_NO_PROTOTYPES |
| |
| /* DEPRECATED in SPEC_VERSION 6 */ |
| VKAPI_ATTR VkResult VKAPI_CALL vkGetSwapchainGrallocUsageANDROID( |
| VkDevice device, |
| VkFormat format, |
| VkImageUsageFlags imageUsage, |
| int* grallocUsage |
| ); |
| |
| /* DEPRECATED in SPEC_VERSION 9 */ |
| VKAPI_ATTR VkResult VKAPI_CALL vkGetSwapchainGrallocUsage2ANDROID( |
| VkDevice device, |
| VkFormat format, |
| VkImageUsageFlags imageUsage, |
| VkSwapchainImageUsageFlagsANDROID swapchainImageUsage, |
| uint64_t* grallocConsumerUsage, |
| uint64_t* grallocProducerUsage |
| ); |
| |
| /* DEPRECATED in SPEC_VERSION 10 */ |
| VKAPI_ATTR VkResult VKAPI_CALL vkGetSwapchainGrallocUsage3ANDROID( |
| VkDevice device, |
| const VkGrallocUsageInfoANDROID* grallocUsageInfo, |
| uint64_t* grallocUsage |
| ); |
| |
| /* DEPRECATED in SPEC_VERSION 11 */ |
| VKAPI_ATTR VkResult VKAPI_CALL vkGetSwapchainGrallocUsage4ANDROID( |
| VkDevice device, |
| const VkGrallocUsageInfo2ANDROID* grallocUsageInfo, |
| uint64_t* grallocUsage |
| ); |
| |
| VKAPI_ATTR VkResult VKAPI_CALL vkAcquireImageANDROID( |
| VkDevice device, |
| VkImage image, |
| int nativeFenceFd, |
| VkSemaphore semaphore, |
| VkFence fence |
| ); |
| |
| VKAPI_ATTR VkResult VKAPI_CALL vkQueueSignalReleaseImageANDROID( |
| VkQueue queue, |
| uint32_t waitSemaphoreCount, |
| const VkSemaphore* pWaitSemaphores, |
| VkImage image, |
| int* pNativeFenceFd |
| ); |
| |
| #endif |
| /* clang-format on */ |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* __VK_ANDROID_NATIVE_BUFFER_H__ */ |