blob: dd42c22a4ca80c455dc517b5cbc7acb24a10aa7a [file] [edit]
/*
* Copyright © 2023 Collabora, Ltd.
* Copyright © 2026 Google LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice (including the next
* paragraph) shall be included in all copies or substantial portions of the
* Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
* IN THE SOFTWARE.
*/
#ifndef VK_ANDROID_H
#define VK_ANDROID_H
#include <stdbool.h>
#include "vulkan/vulkan_core.h"
#include "vulkan/vk_android_native_buffer.h"
#include "util/detect_os.h"
#ifdef __cplusplus
extern "C" {
#endif
struct u_gralloc;
struct vk_device;
struct vk_image;
#ifdef VK_USE_PLATFORM_ANDROID_KHR
struct u_gralloc *vk_android_get_ugralloc(void);
VkResult vk_android_import_anb(struct vk_device *device,
const VkImageCreateInfo *pCreateInfo,
const VkAllocationCallbacks *alloc,
struct vk_image *image);
VkResult vk_android_import_anb_memory(struct vk_device *device,
struct vk_image *image,
const VkNativeBufferANDROID *anb,
const VkAllocationCallbacks *alloc);
VkResult vk_android_get_anb_layout(
const VkImageCreateInfo *pCreateInfo,
VkImageDrmFormatModifierExplicitCreateInfoEXT *out,
VkSubresourceLayout *out_layouts, int max_planes);
VkResult vk_android_init_deferred_image(struct vk_device *device,
struct vk_image *image,
const VkImageCreateInfo *pCreateInfo,
const VkAllocationCallbacks *pAllocator);
#else
static inline struct u_gralloc *
vk_android_get_ugralloc(void)
{
return NULL;
}
static inline VkResult
vk_android_import_anb(struct vk_device *device,
const VkImageCreateInfo *pCreateInfo,
const VkAllocationCallbacks *alloc,
struct vk_image *image)
{
return VK_ERROR_FEATURE_NOT_PRESENT;
}
static inline VkResult
vk_android_get_anb_layout(
const VkImageCreateInfo *pCreateInfo,
VkImageDrmFormatModifierExplicitCreateInfoEXT *out,
VkSubresourceLayout *out_layouts, int max_planes)
{
return VK_ERROR_FEATURE_NOT_PRESENT;
}
static inline VkResult
vk_android_init_deferred_image(struct vk_device *device,
struct vk_image *image,
const VkImageCreateInfo *pCreateInfo,
const VkAllocationCallbacks *pAllocator)
{
return VK_ERROR_FEATURE_NOT_PRESENT;
}
#endif
#if defined(VK_USE_PLATFORM_ANDROID_KHR) && ANDROID_API_LEVEL >= 26
struct AHardwareBuffer;
uint64_t vk_android_get_front_buffer_usage(void);
VkFormat vk_ahb_format_to_image_format(uint32_t ahb_format);
uint32_t vk_image_format_to_ahb_format(VkFormat vk_format);
VkFormat vk_external_format_to_efr_format(VkFormat external_format);
uint64_t vk_image_usage_to_ahb_usage(const VkImageCreateFlags2KHR vk_create,
const VkImageUsageFlags2KHR vk_usage);
struct AHardwareBuffer *vk_alloc_ahardware_buffer(
const VkMemoryAllocateInfo *pAllocateInfo);
VkResult vk_android_get_ahb_layout(
struct AHardwareBuffer *ahardware_buffer,
VkImageDrmFormatModifierExplicitCreateInfoEXT *out,
VkSubresourceLayout *out_layouts, int max_planes);
VkResult vk_android_get_ahb_image_properties(
VkPhysicalDevice pdev_handle,
const VkPhysicalDeviceImageFormatInfo2 *info,
VkImageFormatProperties2 *props);
void vk_android_get_ahb_buffer_properties(
VkPhysicalDevice pdev_handle,
const VkPhysicalDeviceExternalBufferInfo *info,
VkExternalBufferProperties *props);
bool vk_android_rp_attachment_has_external_format(
const VkAttachmentDescription2 *desc);
VkFormat vk_android_get_external_format(const void *pnext);
bool vk_android_is_efr_rp(struct vk_device *device,
const VkRenderPassCreateInfo2 *info);
VkResult vk_android_create_efr_rp(struct vk_device *device,
const VkRenderPassCreateInfo2 *info,
const VkAllocationCallbacks *alloc,
VkRenderPass *out_rp_handle);
bool vk_android_is_efr_rendering_info(const VkRenderingInfo *info);
const VkRenderingInfo *vk_android_get_efr_rendering_info(
const VkRenderingInfo *info,
VkRenderingInfo *local_info,
VkRenderingAttachmentInfo *local_color_att);
bool vk_android_is_efr_inheritance_rendering_info(
const VkCommandBufferInheritanceInfo *info,
const VkCommandBufferInheritanceRenderingInfo *r_info);
const VkCommandBufferInheritanceRenderingInfo *
vk_android_get_efr_inheritance_rendering_info(
const VkCommandBufferInheritanceInfo *info,
const VkCommandBufferInheritanceRenderingInfo *r_info,
VkCommandBufferInheritanceRenderingInfo *local_info,
VkFormat *local_color_format);
bool vk_android_is_efr_pipeline_rendering_info(
const VkGraphicsPipelineCreateInfo *info,
const VkPipelineRenderingCreateInfo *r_info);
const VkPipelineRenderingCreateInfo *
vk_android_get_efr_pipeline_rendering_info(
const VkGraphicsPipelineCreateInfo *info,
const VkPipelineRenderingCreateInfo *r_info,
VkPipelineRenderingCreateInfo *local_info,
VkFormat *local_color_format);
#else /* defined(VK_USE_PLATFORM_ANDROID_KHR) && ANDROID_API_LEVEL >= 26 */
static inline uint64_t
vk_android_get_front_buffer_usage(void)
{
return 0;
}
static inline VkFormat
vk_ahb_format_to_image_format(uint32_t ahb_format)
{
return VK_FORMAT_UNDEFINED;
}
static inline uint32_t
vk_image_format_to_ahb_format(VkFormat vk_format)
{
return 0;
}
static inline VkFormat
vk_external_format_to_efr_format(VkFormat external_format)
{
return VK_FORMAT_UNDEFINED;
}
static inline uint64_t
vk_image_usage_to_ahb_usage(const VkImageCreateFlags2KHR vk_create,
const VkImageUsageFlags2KHR vk_usage)
{
return 0;
}
static inline struct AHardwareBuffer *
vk_alloc_ahardware_buffer(const VkMemoryAllocateInfo *pAllocateInfo)
{
return NULL;
}
static inline VkResult
vk_android_get_ahb_layout(
struct AHardwareBuffer *ahardware_buffer,
VkImageDrmFormatModifierExplicitCreateInfoEXT *out,
VkSubresourceLayout *out_layouts, int max_planes)
{
return VK_ERROR_FEATURE_NOT_PRESENT;
}
static inline VkResult
vk_android_get_ahb_image_properties(
VkPhysicalDevice pdev_handle,
const VkPhysicalDeviceImageFormatInfo2 *info,
VkImageFormatProperties2 *props)
{
return VK_ERROR_FORMAT_NOT_SUPPORTED;
}
static inline void
vk_android_get_ahb_buffer_properties(
VkPhysicalDevice pdev_handle,
const VkPhysicalDeviceExternalBufferInfo *info,
VkExternalBufferProperties *props)
{
}
static inline bool
vk_android_rp_attachment_has_external_format(
const VkAttachmentDescription2 *desc)
{
return false;
}
static inline VkFormat
vk_android_get_external_format(const void *pnext)
{
return VK_FORMAT_UNDEFINED;
}
static inline bool
vk_android_is_efr_rp(struct vk_device *device,
const VkRenderPassCreateInfo2 *info)
{
return false;
}
static inline VkResult
vk_android_create_efr_rp(struct vk_device *device,
const VkRenderPassCreateInfo2 *info,
const VkAllocationCallbacks *alloc,
VkRenderPass *out_rp_handle)
{
return VK_ERROR_UNKNOWN;
}
static inline bool
vk_android_is_efr_rendering_info(const VkRenderingInfo *info)
{
return false;
}
static inline const VkRenderingInfo *
vk_android_get_efr_rendering_info(const VkRenderingInfo *info,
VkRenderingInfo *local_info,
VkRenderingAttachmentInfo *local_color_att)
{
return NULL;
}
static inline bool
vk_android_is_efr_inheritance_rendering_info(
const VkCommandBufferInheritanceInfo *info,
const VkCommandBufferInheritanceRenderingInfo *r_info)
{
return false;
}
static inline const VkCommandBufferInheritanceRenderingInfo *
vk_android_get_efr_inheritance_rendering_info(
const VkCommandBufferInheritanceInfo *info,
const VkCommandBufferInheritanceRenderingInfo *r_info,
VkCommandBufferInheritanceRenderingInfo *local_info,
VkFormat *local_color_format)
{
return NULL;
}
static inline bool
vk_android_is_efr_pipeline_rendering_info(
const VkGraphicsPipelineCreateInfo *info,
const VkPipelineRenderingCreateInfo *r_info)
{
return false;
}
static inline const VkPipelineRenderingCreateInfo *
vk_android_get_efr_pipeline_rendering_info(
const VkGraphicsPipelineCreateInfo *info,
const VkPipelineRenderingCreateInfo *r_info,
VkPipelineRenderingCreateInfo *local_info,
VkFormat *local_color_format)
{
return NULL;
}
#endif /* ANDROID_API_LEVEL >= 26 */
#ifdef __cplusplus
}
#endif
#endif /* VK_ANDROID_H */