// Copyright 2019-2022, Collabora, Ltd. // SPDX-License-Identifier: BSL-1.0 /*! * @file * @brief Flags helpers for compositor swapchain images. * * These functions all concern only the compositor swapchain images that are * shared between the compositor and the application. That's why they are * grouped together and they are here because they need to be shared between * the @ref vk_image_collection and @ref comp_swapchain code so that they apply * the same flags everywhere. * * CSCI = Compositor SwapChain Images. * * @author Jakob Bornecrantz * @author Christoph Haag * @author Benjamin Saunders * @ingroup aux_vk */ #include "xrt/xrt_handles.h" #include "util/u_misc.h" #include "util/u_debug.h" #include "vk/vk_helpers.h" #include #include #include /* * * Helpers. * */ static bool check_feature(VkFormat format, enum xrt_swapchain_usage_bits usage, VkFormatFeatureFlags format_features, VkFormatFeatureFlags flag) { if ((format_features & flag) == 0) { U_LOG_E("vk_csci_get_image_usage_flags: %s requested but %s not supported for format %s (%08x) (%08x)", xrt_swapchain_usage_string(usage), vk_format_feature_string(flag), vk_format_string(format), format_features, flag); return false; } return true; } /* * * 'Exported' functions. * */ VkAccessFlags vk_csci_get_barrier_access_mask(enum xrt_swapchain_usage_bits bits) { VkAccessFlags result = 0; if ((bits & XRT_SWAPCHAIN_USAGE_UNORDERED_ACCESS) != 0) { result |= VK_ACCESS_INPUT_ATTACHMENT_READ_BIT; if ((bits & XRT_SWAPCHAIN_USAGE_COLOR) != 0) { result |= VK_ACCESS_COLOR_ATTACHMENT_READ_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_DEPTH_STENCIL) != 0) { result |= VK_ACCESS_DEPTH_STENCIL_ATTACHMENT_READ_BIT; } } if ((bits & XRT_SWAPCHAIN_USAGE_COLOR) != 0) { result |= VK_ACCESS_COLOR_ATTACHMENT_WRITE_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_DEPTH_STENCIL) != 0) { result |= VK_ACCESS_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_TRANSFER_SRC) != 0) { result |= VK_ACCESS_TRANSFER_READ_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_TRANSFER_DST) != 0) { result |= VK_ACCESS_TRANSFER_WRITE_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_SAMPLED) != 0) { result |= VK_ACCESS_SHADER_READ_BIT; } return result; } VkImageLayout vk_csci_get_barrier_optimal_layout(VkFormat format) { // clang-format off #define CASE_COLOR(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL; #define CASE_DS(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL; // clang-format on switch (format) { VK_CSCI_FORMATS(CASE_COLOR, CASE_DS, CASE_DS, CASE_DS) default: // assert(false && !"Format not supported!"); return VK_IMAGE_LAYOUT_UNDEFINED; } #undef CASE_COLOR #undef CASE_DS } VkImageAspectFlags vk_csci_get_barrier_aspect_mask(VkFormat format) { // clang-format off #define CASE_COLOR(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_ASPECT_COLOR_BIT; #define CASE_DS(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_ASPECT_DEPTH_BIT | VK_IMAGE_ASPECT_STENCIL_BIT; #define CASE_D(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_ASPECT_DEPTH_BIT; #define CASE_S(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_ASPECT_STENCIL_BIT; // clang-format on switch (format) { VK_CSCI_FORMATS(CASE_COLOR, CASE_DS, CASE_D, CASE_S) default: // assert(false && !"Format not supported!"); return 0; } #undef CASE_COLOR #undef CASE_DS #undef CASE_D #undef CASE_S } VkImageAspectFlags vk_csci_get_image_view_aspect(VkFormat format, enum xrt_swapchain_usage_bits bits) { // clang-format off #define CASE_COLOR(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_ASPECT_COLOR_BIT; #define CASE_DS(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_ASPECT_DEPTH_BIT; // We only want to sample the depth. #define CASE_D(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_ASPECT_DEPTH_BIT; #define CASE_S(FORMAT) case VK_FORMAT_##FORMAT: return VK_IMAGE_ASPECT_STENCIL_BIT; // clang-format on switch (format) { VK_CSCI_FORMATS(CASE_COLOR, CASE_DS, CASE_D, CASE_S) default: // assert(false && !"Format not supported!"); return 0; } #undef CASE_COLOR #undef CASE_DS #undef CASE_D #undef CASE_S } VkImageUsageFlags vk_csci_get_image_usage_flags(struct vk_bundle *vk, VkFormat format, enum xrt_swapchain_usage_bits bits) { VkFormatProperties prop; vk->vkGetPhysicalDeviceFormatProperties(vk->physical_device, format, &prop); VkImageUsageFlags image_usage = 0; if ((bits & XRT_SWAPCHAIN_USAGE_DEPTH_STENCIL) != 0) { if (!check_feature(format, XRT_SWAPCHAIN_USAGE_DEPTH_STENCIL, prop.optimalTilingFeatures, VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT)) { return 0; } image_usage |= VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT; } if ((prop.optimalTilingFeatures & VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT) != 0) { image_usage |= VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_COLOR) != 0) { if (!check_feature(format, XRT_SWAPCHAIN_USAGE_COLOR, prop.optimalTilingFeatures, VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT)) { return 0; } image_usage |= VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_TRANSFER_SRC) != 0) { if (!check_feature(format, XRT_SWAPCHAIN_USAGE_TRANSFER_SRC, prop.optimalTilingFeatures, VK_FORMAT_FEATURE_TRANSFER_SRC_BIT)) { return 0; } image_usage |= VK_IMAGE_USAGE_TRANSFER_SRC_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_TRANSFER_DST) != 0) { if (!check_feature(format, XRT_SWAPCHAIN_USAGE_TRANSFER_DST, prop.optimalTilingFeatures, VK_FORMAT_FEATURE_TRANSFER_DST_BIT)) { return 0; } image_usage |= VK_IMAGE_USAGE_TRANSFER_DST_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_SAMPLED) != 0) { if (!check_feature(format, XRT_SWAPCHAIN_USAGE_SAMPLED, prop.optimalTilingFeatures, VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT)) { return 0; } image_usage |= VK_IMAGE_USAGE_SAMPLED_BIT; } if ((bits & XRT_SWAPCHAIN_USAGE_INPUT_ATTACHMENT) != 0) { image_usage |= VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT; } // For compositors to be able to read it. if (true) { VkFormatFeatureFlags format_features = prop.optimalTilingFeatures; VkFormatFeatureFlags flag = VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT; if ((format_features & flag) == 0) { U_LOG_E("%s: Compositor needs %s but not supported for format %s (%08x) (%08x)", __func__, vk_format_feature_string(flag), vk_format_string(format), format_features, flag); return 0; } image_usage |= VK_IMAGE_USAGE_SAMPLED_BIT; } return image_usage; } VkExternalMemoryHandleTypeFlags vk_csci_get_image_external_handle_type(struct vk_bundle *vk) { #if defined(XRT_GRAPHICS_BUFFER_HANDLE_IS_FD) return VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT_KHR; #elif defined(XRT_GRAPHICS_BUFFER_HANDLE_IS_AHARDWAREBUFFER) return VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID; #elif defined(XRT_GRAPHICS_BUFFER_HANDLE_IS_WIN32_HANDLE) return VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_BIT; #else #error "need port" #endif }