// Copyright 2016 Dolphin Emulator Project // SPDX-License-Identifier: GPL-2.0-or-later #pragma once #include #include #include #include #include #include #include #include #include #include #include "Common/BlockingLoop.h" #include "Common/Flag.h" #include "Common/Semaphore.h" #include "VideoBackends/Vulkan/Constants.h" namespace Vulkan { class CommandBufferManager { public: explicit CommandBufferManager(bool use_threaded_submission); ~CommandBufferManager(); bool Initialize(); // These command buffers are allocated per-frame. They are valid until the command buffer // is submitted, after that you should call these functions again. VkCommandBuffer GetCurrentInitCommandBuffer() { CmdBufferResources& cmd_buffer_resources = GetCurrentCmdBufferResources(); cmd_buffer_resources.init_command_buffer_used = true; return cmd_buffer_resources.command_buffers[0]; } VkCommandBuffer GetCurrentCommandBuffer() const { const CmdBufferResources& cmd_buffer_resources = m_command_buffers[m_current_cmd_buffer]; return cmd_buffer_resources.command_buffers[1]; } // Allocates a descriptors set from the pool reserved for the current frame. VkDescriptorSet AllocateDescriptorSet(VkDescriptorSetLayout set_layout); // Fence "counters" are used to track which commands have been completed by the GPU. // If the last completed fence counter is greater or equal to N, it means that the work // associated counter N has been completed by the GPU. The value of N to associate with // commands can be retreived by calling GetCurrentFenceCounter(). u64 GetCompletedFenceCounter() const { return m_completed_fence_counter; } // Gets the fence that will be signaled when the currently executing command buffer is // queued and executed. Do not wait for this fence before the buffer is executed. u64 GetCurrentFenceCounter() const { auto& resources = m_command_buffers[m_current_cmd_buffer]; return resources.fence_counter; } // Returns the semaphore for the current command buffer, which can be used to ensure the // swap chain image is ready before the command buffer executes. VkSemaphore GetCurrentCommandBufferSemaphore() { auto& resources = m_command_buffers[m_current_cmd_buffer]; resources.semaphore_used = true; return resources.semaphore; } // Ensure that the worker thread has submitted any previous command buffers and is idle. void WaitForWorkerThreadIdle(); // Wait for a fence to be completed. // Also invokes callbacks for completion. void WaitForFenceCounter(u64 fence_counter); void SubmitCommandBuffer(bool submit_on_worker_thread, bool wait_for_completion, VkSwapchainKHR present_swap_chain = VK_NULL_HANDLE, uint32_t present_image_index = 0xFFFFFFFF); // Was the last present submitted to the queue a failure? If so, we must recreate our swapchain. bool CheckLastPresentFail() { return m_last_present_failed.TestAndClear(); } VkResult GetLastPresentResult() const { return m_last_present_result; } // Schedule a vulkan resource for destruction later on. This will occur when the command buffer // is next re-used, and the GPU has finished working with the specified resource. void DeferBufferDestruction(VkBuffer object); void DeferBufferViewDestruction(VkBufferView object); void DeferDeviceMemoryDestruction(VkDeviceMemory object); void DeferFramebufferDestruction(VkFramebuffer object); void DeferImageDestruction(VkImage object); void DeferImageViewDestruction(VkImageView object); private: bool CreateCommandBuffers(); void DestroyCommandBuffers(); bool CreateSubmitThread(); void WaitForCommandBufferCompletion(u32 command_buffer_index); void SubmitCommandBuffer(u32 command_buffer_index, VkSwapchainKHR present_swap_chain, u32 present_image_index); void BeginCommandBuffer(); VkDescriptorPool CreateDescriptorPool(u32 descriptor_sizes); const u32 DESCRIPTOR_SETS_PER_POOL = 1024; struct CmdBufferResources { // [0] - Init (upload) command buffer, [1] - draw command buffer VkCommandPool command_pool = VK_NULL_HANDLE; std::array command_buffers = {}; VkFence fence = VK_NULL_HANDLE; VkSemaphore semaphore = VK_NULL_HANDLE; u64 fence_counter = 0; bool init_command_buffer_used = false; bool semaphore_used = false; u32 frame_index = 0; std::vector> cleanup_resources; }; struct FrameResources { std::vector descriptor_pools; u32 current_descriptor_pool_index = 0; }; FrameResources& GetCurrentFrameResources() { return m_frame_resources[m_current_frame]; } CmdBufferResources& GetCurrentCmdBufferResources() { return m_command_buffers[m_current_cmd_buffer]; } u64 m_next_fence_counter = 1; u64 m_completed_fence_counter = 0; std::array m_frame_resources; std::array m_command_buffers; u32 m_current_frame = 0; u32 m_current_cmd_buffer = 0; // Threaded command buffer execution std::thread m_submit_thread; std::unique_ptr m_submit_loop; struct PendingCommandBufferSubmit { VkSwapchainKHR present_swap_chain; u32 present_image_index; u32 command_buffer_index; }; VkSemaphore m_present_semaphore = VK_NULL_HANDLE; std::deque m_pending_submits; std::mutex m_pending_submit_lock; std::condition_variable m_submit_worker_condvar; bool m_submit_worker_idle = true; Common::Flag m_last_present_failed; VkResult m_last_present_result = VK_SUCCESS; bool m_use_threaded_submission = false; u32 m_descriptor_set_count = 0; }; extern std::unique_ptr g_command_buffer_mgr; } // namespace Vulkan