feat(vulkan): implement secondary command buffer system for improved rendering

- Introduced a new secondary command buffer system to enhance parallel command recording, allowing for more efficient rendering of draw surfaces.
- Implemented functions for initializing, shutting down, and managing secondary command buffers, improving the Vulkan renderer's performance.
- Updated command buffer management to utilize per-frame fences, ensuring better synchronization and resource handling during rendering.
- Enhanced error handling for device loss scenarios in secondary buffer operations, contributing to improved stability and recovery.
- Added comprehensive documentation and comments to clarify the functionality and usage of the secondary command buffer system.

This commit significantly enhances the Vulkan renderer's capability to handle complex rendering tasks, leading to better performance and maintainability.

Author: timfox

CMakeLists.txt

@@ -1547,6 +1547,7 @@ SET(RENDERER_VK_SRCS
 	src/renderers/vulkan/vk_utils.c
 	src/renderers/vulkan/vk_commands.c
 	src/renderers/vulkan/vk_resource_state.c
+	src/renderers/vulkan/vk_secondary_buffers.c
 	src/renderers/vulkan/vk_pipeline.c
 	src/renderers/vulkan/vk_shader_manager.cpp
 	src/renderers/vulkan/vk_shader_validation.c

src/renderers/vulkan/vk.c

@@ -110,6 +110,7 @@ void *Sys_LoadFunction(void *handle, const char *name) {
 #include "vk_world_effects.h"
 #include "vk_frame.h"
 #include "vk_resource_state.h"
+#include "vk_secondary_buffers.h"
 
 #include "vk_post_process.h"
 #ifdef USE_VULKAN_RAY_TRACING
@@ -569,6 +570,7 @@ PFN_vkCmdEndRenderPass							qvkCmdEndRenderPass;
 PFN_vkCmdNextSubpass								qvkCmdNextSubpass;
 PFN_vkCmdPipelineBarrier							qvkCmdPipelineBarrier;
 PFN_vkCmdPushConstants							qvkCmdPushConstants;
+PFN_vkCmdExecuteCommands						qvkCmdExecuteCommands;
 PFN_vkCmdSetDepthBias							qvkCmdSetDepthBias;
 PFN_vkCmdSetScissor								qvkCmdSetScissor;
 PFN_vkCmdSetViewport								qvkCmdSetViewport;
@@ -3749,6 +3751,7 @@ static void init_vulkan_library( void )
 	INIT_DEVICE_FUNCTION(vkCmdDraw)
 	INIT_DEVICE_FUNCTION(vkCmdDrawIndexed)
 	INIT_DEVICE_FUNCTION(vkCmdDrawIndexedIndirect)
+	INIT_DEVICE_FUNCTION(vkCmdExecuteCommands)
 	INIT_DEVICE_FUNCTION(vkCmdEndRenderPass)
 	INIT_DEVICE_FUNCTION(vkCmdNextSubpass)
 	INIT_DEVICE_FUNCTION(vkCmdPipelineBarrier)
@@ -4326,6 +4329,7 @@ static void __attribute__((unused)) deinit_device_functions( void )
 	qvkCmdDraw									= NULL;
 	qvkCmdDrawIndexed							= NULL;
 	qvkCmdDrawIndexedIndirect					= NULL;
+	qvkCmdExecuteCommands						= NULL;
 	qvkCmdEndRenderPass							= NULL;
 	qvkCmdNextSubpass							= NULL;
 	qvkCmdPipelineBarrier						= NULL;
@@ -4742,6 +4746,9 @@ void vk_initialize( void )
 
         // Initialize resource state tracker
         vk_resource_state_init();
+        
+        // Initialize secondary command buffer system
+        vk_secondary_buffers_init();
     // Optional: initialize timeline semaphore if available
         #ifdef VK_KHR_TIMELINE_SEMAPHORE
         if (qvkCreateSemaphore) {
@@ -9793,6 +9800,9 @@ void vk_shutdown( refShutdownCode_t code ) {
 
 				// Shutdown resource state tracker
 				vk_resource_state_shutdown();
+				
+				// Shutdown secondary command buffer system
+				vk_secondary_buffers_shutdown();
 
 				// Ray tracing and raymarching moved to RTX renderer only