// Copyright 2016 Dolphin Emulator Project // Copyright 2020 DuckStation Emulator Project // Licensed under GPLv2+ // Refer to the LICENSE file included. #pragma once #include "../string.h" #include "../types.h" #include "vulkan_loader.h" #include #include #include #include namespace Vulkan { namespace Util { inline constexpr u32 MakeRGBA8Color(float r, float g, float b, float a) { return (static_cast(std::clamp(static_cast(r * 255.0f), 0, 255)) << 0) | (static_cast(std::clamp(static_cast(g * 255.0f), 0, 255)) << 8) | (static_cast(std::clamp(static_cast(b * 255.0f), 0, 255)) << 16) | (static_cast(std::clamp(static_cast(a * 255.0f), 0, 255)) << 24); } bool IsDepthFormat(VkFormat format); bool IsCompressedFormat(VkFormat format); VkFormat GetLinearFormat(VkFormat format); u32 GetTexelSize(VkFormat format); u32 GetBlockSize(VkFormat format); // Clamps a VkRect2D to the specified dimensions. VkRect2D ClampRect2D(const VkRect2D& rect, u32 width, u32 height); // Map {SRC,DST}_COLOR to {SRC,DST}_ALPHA VkBlendFactor GetAlphaBlendFactor(VkBlendFactor factor); // Safe destroy helpers void SafeDestroyFramebuffer(VkFramebuffer& fb); void SafeDestroyShaderModule(VkShaderModule& sm); void SafeDestroyPipeline(VkPipeline& p); void SafeDestroyPipelineLayout(VkPipelineLayout& pl); void SafeDestroyDescriptorSetLayout(VkDescriptorSetLayout& dsl); void SafeDestroyBufferView(VkBufferView& bv); void SafeDestroyImageView(VkImageView& iv); void SafeDestroySampler(VkSampler& samp); void SafeDestroySemaphore(VkSemaphore& sem); void SafeFreeGlobalDescriptorSet(VkDescriptorSet& ds); void SetViewport(VkCommandBuffer command_buffer, int x, int y, int width, int height, float min_depth = 0.0f, float max_depth = 1.0f); void SetScissor(VkCommandBuffer command_buffer, int x, int y, int width, int height); // Combines viewport and scissor updates void SetViewportAndScissor(VkCommandBuffer command_buffer, int x, int y, int width, int height, float min_depth = 0.0f, float max_depth = 1.0f); // Wrapper for creating an barrier on a buffer void BufferMemoryBarrier(VkCommandBuffer command_buffer, VkBuffer buffer, VkAccessFlags src_access_mask, VkAccessFlags dst_access_mask, VkDeviceSize offset, VkDeviceSize size, VkPipelineStageFlags src_stage_mask, VkPipelineStageFlags dst_stage_mask); // Create a shader module from the specified SPIR-V. VkShaderModule CreateShaderModule(const u32* spv, size_t spv_word_count); // Compile a vertex shader and create a shader module, discarding the intermediate SPIR-V. VkShaderModule CompileAndCreateVertexShader(std::string_view source_code); // Compile a geometry shader and create a shader module, discarding the intermediate SPIR-V. VkShaderModule CompileAndCreateGeometryShader(std::string_view source_code); // Compile a fragment shader and create a shader module, discarding the intermediate SPIR-V. VkShaderModule CompileAndCreateFragmentShader(std::string_view source_code); // Compile a compute shader and create a shader module, discarding the intermediate SPIR-V. VkShaderModule CompileAndCreateComputeShader(std::string_view source_code); const char* VkResultToString(VkResult res); const char* VkImageLayoutToString(VkImageLayout layout); void LogVulkanResult(int level, const char* func_name, VkResult res, const char* msg, ...) printflike(4, 5); #define LOG_VULKAN_ERROR(res, ...) ::Vulkan::Util::LogVulkanResult(1, __func__, res, __VA_ARGS__) // Provides a compile-time mapping between a Vulkan-type into its matching VkObjectType template struct VkObjectTypeMap; // clang-format off template<> struct VkObjectTypeMap { using type = VkInstance ; static constexpr VkObjectType value = VK_OBJECT_TYPE_INSTANCE; }; template<> struct VkObjectTypeMap { using type = VkPhysicalDevice ; static constexpr VkObjectType value = VK_OBJECT_TYPE_PHYSICAL_DEVICE; }; template<> struct VkObjectTypeMap { using type = VkDevice ; static constexpr VkObjectType value = VK_OBJECT_TYPE_DEVICE; }; template<> struct VkObjectTypeMap { using type = VkQueue ; static constexpr VkObjectType value = VK_OBJECT_TYPE_QUEUE; }; template<> struct VkObjectTypeMap { using type = VkSemaphore ; static constexpr VkObjectType value = VK_OBJECT_TYPE_SEMAPHORE; }; template<> struct VkObjectTypeMap { using type = VkCommandBuffer ; static constexpr VkObjectType value = VK_OBJECT_TYPE_COMMAND_BUFFER; }; template<> struct VkObjectTypeMap { using type = VkFence ; static constexpr VkObjectType value = VK_OBJECT_TYPE_FENCE; }; template<> struct VkObjectTypeMap { using type = VkDeviceMemory ; static constexpr VkObjectType value = VK_OBJECT_TYPE_DEVICE_MEMORY; }; template<> struct VkObjectTypeMap { using type = VkBuffer ; static constexpr VkObjectType value = VK_OBJECT_TYPE_BUFFER; }; template<> struct VkObjectTypeMap { using type = VkImage ; static constexpr VkObjectType value = VK_OBJECT_TYPE_IMAGE; }; template<> struct VkObjectTypeMap { using type = VkEvent ; static constexpr VkObjectType value = VK_OBJECT_TYPE_EVENT; }; template<> struct VkObjectTypeMap { using type = VkQueryPool ; static constexpr VkObjectType value = VK_OBJECT_TYPE_QUERY_POOL; }; template<> struct VkObjectTypeMap { using type = VkBufferView ; static constexpr VkObjectType value = VK_OBJECT_TYPE_BUFFER_VIEW; }; template<> struct VkObjectTypeMap { using type = VkImageView ; static constexpr VkObjectType value = VK_OBJECT_TYPE_IMAGE_VIEW; }; template<> struct VkObjectTypeMap { using type = VkShaderModule ; static constexpr VkObjectType value = VK_OBJECT_TYPE_SHADER_MODULE; }; template<> struct VkObjectTypeMap { using type = VkPipelineCache ; static constexpr VkObjectType value = VK_OBJECT_TYPE_PIPELINE_CACHE; }; template<> struct VkObjectTypeMap { using type = VkPipelineLayout ; static constexpr VkObjectType value = VK_OBJECT_TYPE_PIPELINE_LAYOUT; }; template<> struct VkObjectTypeMap { using type = VkRenderPass ; static constexpr VkObjectType value = VK_OBJECT_TYPE_RENDER_PASS; }; template<> struct VkObjectTypeMap { using type = VkPipeline ; static constexpr VkObjectType value = VK_OBJECT_TYPE_PIPELINE; }; template<> struct VkObjectTypeMap { using type = VkDescriptorSetLayout ; static constexpr VkObjectType value = VK_OBJECT_TYPE_DESCRIPTOR_SET_LAYOUT; }; template<> struct VkObjectTypeMap { using type = VkSampler ; static constexpr VkObjectType value = VK_OBJECT_TYPE_SAMPLER; }; template<> struct VkObjectTypeMap { using type = VkDescriptorPool ; static constexpr VkObjectType value = VK_OBJECT_TYPE_DESCRIPTOR_POOL; }; template<> struct VkObjectTypeMap { using type = VkDescriptorSet ; static constexpr VkObjectType value = VK_OBJECT_TYPE_DESCRIPTOR_SET; }; template<> struct VkObjectTypeMap { using type = VkFramebuffer ; static constexpr VkObjectType value = VK_OBJECT_TYPE_FRAMEBUFFER; }; template<> struct VkObjectTypeMap { using type = VkCommandPool ; static constexpr VkObjectType value = VK_OBJECT_TYPE_COMMAND_POOL; }; template<> struct VkObjectTypeMap { using type = VkDescriptorUpdateTemplate; static constexpr VkObjectType value = VK_OBJECT_TYPE_DESCRIPTOR_UPDATE_TEMPLATE; }; template<> struct VkObjectTypeMap { using type = VkSurfaceKHR ; static constexpr VkObjectType value = VK_OBJECT_TYPE_SURFACE_KHR; }; template<> struct VkObjectTypeMap { using type = VkSwapchainKHR ; static constexpr VkObjectType value = VK_OBJECT_TYPE_SWAPCHAIN_KHR; }; template<> struct VkObjectTypeMap { using type = VkDebugUtilsMessengerEXT ; static constexpr VkObjectType value = VK_OBJECT_TYPE_DEBUG_UTILS_MESSENGER_EXT; }; // clang-format on inline void SetObjectName(VkDevice device, void* object_handle, VkObjectType object_type, const char* format, ...) { #ifdef _DEBUG if (!vkSetDebugUtilsObjectNameEXT) { return; } std::va_list ap; SmallString str; va_start(ap, format); str.FormatVA(format, ap); va_end(ap); const VkDebugUtilsObjectNameInfoEXT nameInfo{VK_STRUCTURE_TYPE_DEBUG_UTILS_OBJECT_NAME_INFO_EXT, nullptr, object_type, reinterpret_cast(object_handle), str}; vkSetDebugUtilsObjectNameEXT(device, &nameInfo); #endif } template inline void SetObjectName(VkDevice device, T object_handle, const char* format, ...) { #ifdef _DEBUG std::va_list ap; va_start(ap, format); SetObjectName(device, reinterpret_cast((typename VkObjectTypeMap::type)object_handle), VkObjectTypeMap::value, format, ap); va_end(ap); #endif } // Command buffer debug utils inline void BeginDebugScope(VkCommandBuffer command_buffer, const char* scope_name, const std::array& scope_color = {0.5, 0.5, 0.5, 1.0}) { #ifdef _DEBUG if (!vkCmdBeginDebugUtilsLabelEXT) { return; } const VkDebugUtilsLabelEXT label{VK_STRUCTURE_TYPE_DEBUG_UTILS_LABEL_EXT, nullptr, scope_name, {scope_color[0], scope_color[1], scope_color[2], scope_color[3]}}; vkCmdBeginDebugUtilsLabelEXT(command_buffer, &label); #endif } inline void EndDebugScope(VkCommandBuffer command_buffer) { #ifdef _DEBUG if (!vkCmdEndDebugUtilsLabelEXT) { return; } vkCmdEndDebugUtilsLabelEXT(command_buffer); #endif } inline void InsertDebugLabel(VkCommandBuffer command_buffer, const char* label_name, const std::array& label_color = {0.5, 0.5, 0.5, 1.0}) { #ifdef _DEBUG if (!vkCmdInsertDebugUtilsLabelEXT) { return; } const VkDebugUtilsLabelEXT label{VK_STRUCTURE_TYPE_DEBUG_UTILS_LABEL_EXT, nullptr, label_name, {label_color[0], label_color[1], label_color[2], label_color[3]}}; vkCmdInsertDebugUtilsLabelEXT(command_buffer, &label); #endif } // Queue debug utils inline void BeginDebugScope(VkQueue queue, const char* scope_name, const std::array& scope_color = {0.75, 0.75, 0.75, 1.0}) { #ifdef _DEBUG if (!vkQueueBeginDebugUtilsLabelEXT) { return; } const VkDebugUtilsLabelEXT label{VK_STRUCTURE_TYPE_DEBUG_UTILS_LABEL_EXT, nullptr, scope_name, {scope_color[0], scope_color[1], scope_color[2], scope_color[3]}}; vkQueueBeginDebugUtilsLabelEXT(queue, &label); #endif } inline void EndDebugScope(VkQueue queue) { #ifdef _DEBUG if (!vkQueueEndDebugUtilsLabelEXT) { return; } vkQueueEndDebugUtilsLabelEXT(queue); #endif } inline void InsertDebugLabel(VkQueue queue, const char* label_name, const std::array& label_color = {0.75, 0.75, 0.75, 1.0}) { #ifdef _DEBUG if (!vkQueueInsertDebugUtilsLabelEXT) { return; } const VkDebugUtilsLabelEXT label{VK_STRUCTURE_TYPE_DEBUG_UTILS_LABEL_EXT, nullptr, label_name, {label_color[0], label_color[1], label_color[2], label_color[3]}}; vkQueueInsertDebugUtilsLabelEXT(queue, &label); #endif } template class DebugScope { public: DebugScope(T context, const char* format, ...) {} }; #ifdef _DEBUG template<> class DebugScope { public: DebugScope(VkCommandBuffer context, const char* format, ...); ~DebugScope(); private: static constexpr u8 max_depth = 8u; static u8 depth; VkCommandBuffer command_buffer; }; template<> class DebugScope { public: DebugScope(VkQueue context, const char* format, ...); ~DebugScope(); private: static constexpr u8 max_depth = 8u; static u8 depth; VkQueue queue; }; #endif } // namespace Util } // namespace Vulkan