/* * 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 . 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 #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 #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__ */