26 std::vector<Core::VertexBinding>,
27 std::vector<Core::VertexAttribute>>
28 translate_semantic_layout(
const Kakshya::VertexLayout& layout)
35 "Translated semantic vertex layout: {} bindings, {} attributes",
36 vk_bindings.size(), vk_attributes.size());
38 return { vk_bindings, vk_attributes };
51 "RenderFlow already initialized (static flag)");
57 "RenderFlow already initialized");
64 "ShaderFoundry must be initialized before RenderFlow");
73 "DisplayService not found in BackendRegistry");
80 "RenderFlow initialized");
91 "RenderFlow stopped");
101 "Shutting down RenderFlow...");
105 "Cannot shutdown RenderFlow: ShaderFoundry not initialized");
113 "Cannot shutdown RenderFlow: Vulkan device is null");
127 "RenderFlow shutdown complete");
140 return vk::PrimitiveTopology::ePointList;
142 return vk::PrimitiveTopology::eLineList;
144 return vk::PrimitiveTopology::eLineStrip;
146 return vk::PrimitiveTopology::eTriangleList;
148 return vk::PrimitiveTopology::eTriangleStrip;
150 return vk::PrimitiveTopology::eTriangleFan;
152 return vk::PrimitiveTopology::eTriangleList;
156 vk::PolygonMode to_vk_polygon_mode(
PolygonMode mode)
160 return vk::PolygonMode::eFill;
162 return vk::PolygonMode::eLine;
164 return vk::PolygonMode::ePoint;
166 return vk::PolygonMode::eFill;
170 vk::CullModeFlags to_vk_cull_mode(
CullMode mode)
174 return vk::CullModeFlagBits::eNone;
176 return vk::CullModeFlagBits::eFront;
178 return vk::CullModeFlagBits::eBack;
180 return vk::CullModeFlagBits::eFrontAndBack;
182 return vk::CullModeFlagBits::eBack;
186 vk::CompareOp to_vk_compare_op(
CompareOp op)
190 return vk::CompareOp::eNever;
192 return vk::CompareOp::eLess;
194 return vk::CompareOp::eEqual;
196 return vk::CompareOp::eLessOrEqual;
198 return vk::CompareOp::eGreater;
200 return vk::CompareOp::eNotEqual;
202 return vk::CompareOp::eGreaterOrEqual;
204 return vk::CompareOp::eAlways;
206 return vk::CompareOp::eLess;
210 vk::BlendFactor to_vk_blend_factor(
BlendFactor factor)
214 return vk::BlendFactor::eZero;
216 return vk::BlendFactor::eOne;
218 return vk::BlendFactor::eSrcColor;
220 return vk::BlendFactor::eOneMinusSrcColor;
222 return vk::BlendFactor::eDstColor;
224 return vk::BlendFactor::eOneMinusDstColor;
226 return vk::BlendFactor::eSrcAlpha;
228 return vk::BlendFactor::eOneMinusSrcAlpha;
230 return vk::BlendFactor::eDstAlpha;
232 return vk::BlendFactor::eOneMinusDstAlpha;
234 return vk::BlendFactor::eOne;
238 vk::BlendOp to_vk_blend_op(
BlendOp op)
242 return vk::BlendOp::eAdd;
244 return vk::BlendOp::eSubtract;
246 return vk::BlendOp::eReverseSubtract;
248 return vk::BlendOp::eMin;
250 return vk::BlendOp::eMax;
252 return vk::BlendOp::eAdd;
263 const std::vector<vk::Format>& color_formats,
264 vk::Format depth_format)
268 "RenderFlow not initialized");
274 "Pipeline requires either mesh shader or vertex shader");
278 if (color_formats.empty()) {
280 "At least one color format required for dynamic rendering pipeline");
311 "Pipeline using semantic VertexLayout ({} vertices, {} attributes)",
315 auto [vk_bindings, vk_attributes] = translate_semantic_layout(
324 "Pipeline using explicit vertex config ({} bindings, {} attributes)",
329 vk_binding.
binding = binding.binding;
330 vk_binding.stride = binding.stride;
331 vk_binding.input_rate = binding.per_instance ? vk::VertexInputRate::eInstance : vk::VertexInputRate::eVertex;
338 vk_attr.binding = attr.binding;
339 vk_attr.format = attr.format;
340 vk_attr.offset = attr.offset;
347 "Pipeline will use shader reflection for vertex input");
378 std::vector<vk::DescriptorSetLayout> layouts;
380 std::vector<vk::DescriptorSetLayoutBinding> bindings;
381 for (
const auto& binding : desc_set) {
382 vk::DescriptorSetLayoutBinding vk_binding;
383 vk_binding.binding = binding.binding;
384 vk_binding.descriptorType = binding.type;
385 vk_binding.descriptorCount = 1;
386 vk_binding.stageFlags = vk::ShaderStageFlagBits::eVertex | vk::ShaderStageFlagBits::eFragment;
387 bindings.push_back(vk_binding);
390 vk::DescriptorSetLayoutCreateInfo layout_info;
391 layout_info.bindingCount =
static_cast<uint32_t
>(bindings.size());
392 layout_info.pBindings = bindings.data();
395 layouts.push_back(layout);
399 vk::ShaderStageFlags push_constant_stages;
402 push_constant_stages = vk::ShaderStageFlagBits::eMeshEXT;
404 push_constant_stages |= vk::ShaderStageFlagBits::eTaskEXT;
407 push_constant_stages |= vk::ShaderStageFlagBits::eFragment;
410 push_constant_stages = vk::ShaderStageFlagBits::eVertex | vk::ShaderStageFlagBits::eFragment;
412 push_constant_stages |= vk::ShaderStageFlagBits::eGeometry;
415 push_constant_stages |= vk::ShaderStageFlagBits::eTessellationControl;
418 push_constant_stages |= vk::ShaderStageFlagBits::eTessellationEvaluation;
423 vk::PushConstantRange range;
424 range.stageFlags = push_constant_stages;
434 vk::DynamicState::eViewport,
435 vk::DynamicState::eScissor
438 auto pipeline = std::make_shared<Core::VKGraphicsPipeline>();
441 "Failed to create VKGraphicsPipeline for dynamic rendering");
443 for (
auto layout : layouts) {
454 state.
layout = pipeline->get_layout();
459 "Dynamic rendering pipeline created (ID: {}, {} color attachments)",
460 pipeline_id, color_formats.size());
474 if (it->second.pipeline) {
475 it->second.pipeline->cleanup(device);
478 if (it->second.layout) {
479 device.destroyPipelineLayout(it->second.layout);
482 for (
auto layout : it->second.layouts) {
484 device.destroyDescriptorSetLayout(layout);
491 "Destroyed graphics pipeline (ID: {})", pipeline_id);
499 if (state.pipeline) {
500 state.pipeline->cleanup(device);
503 for (
auto layout : state.layouts) {
505 device.destroyDescriptorSetLayout(layout);
512 "Cleaned up all graphics pipelines");
521 const std::shared_ptr<Core::Window>& window,
522 vk::Image swapchain_image,
523 const std::array<float, 4>& clear_color,
524 vk::ImageView depth_image_view)
529 "Invalid command buffer ID: {}", cmd_id);
535 "Cannot begin rendering for null window");
539 if (!swapchain_image) {
541 "Cannot begin rendering with null swapchain image");
548 "Window '{}' not registered for rendering. "
549 "Call register_window_for_rendering() first.",
550 window->get_create_info().title);
553 it->second.swapchain_image = swapchain_image;
556 uint32_t width = 0, height = 0;
559 if (width == 0 || height == 0) {
561 "Invalid swapchain extent for window '{}': {}x{}",
562 window->get_create_info().title, width, height);
569 "Failed to get image view for window '{}'",
570 window->get_create_info().title);
574 vk::ImageMemoryBarrier pre_barrier {};
575 pre_barrier.oldLayout = vk::ImageLayout::eUndefined;
576 pre_barrier.newLayout = vk::ImageLayout::eColorAttachmentOptimal;
577 pre_barrier.srcQueueFamilyIndex = VK_QUEUE_FAMILY_IGNORED;
578 pre_barrier.dstQueueFamilyIndex = VK_QUEUE_FAMILY_IGNORED;
579 pre_barrier.image = swapchain_image;
580 pre_barrier.subresourceRange.aspectMask = vk::ImageAspectFlagBits::eColor;
581 pre_barrier.subresourceRange.baseMipLevel = 0;
582 pre_barrier.subresourceRange.levelCount = 1;
583 pre_barrier.subresourceRange.baseArrayLayer = 0;
584 pre_barrier.subresourceRange.layerCount = 1;
585 pre_barrier.srcAccessMask = vk::AccessFlagBits::eNone;
586 pre_barrier.dstAccessMask = vk::AccessFlagBits::eColorAttachmentWrite;
589 vk::PipelineStageFlagBits::eTopOfPipe,
590 vk::PipelineStageFlagBits::eColorAttachmentOutput,
591 vk::DependencyFlags {},
596 vk::RenderingAttachmentInfo color_attachment {};
597 color_attachment.sType = vk::StructureType::eRenderingAttachmentInfo;
598 color_attachment.pNext =
nullptr;
599 color_attachment.imageView = image_view;
600 color_attachment.imageLayout = vk::ImageLayout::eColorAttachmentOptimal;
601 color_attachment.resolveMode = vk::ResolveModeFlagBits::eNone;
602 color_attachment.resolveImageView =
nullptr;
603 color_attachment.resolveImageLayout = vk::ImageLayout::eUndefined;
604 color_attachment.loadOp = vk::AttachmentLoadOp::eClear;
605 color_attachment.storeOp = vk::AttachmentStoreOp::eStore;
608 color_attachment.clearValue.color = vk::ClearColorValue(clear_color);
610 color_attachment.clearValue.color = vk::ClearColorValue(window->get_create_info().clear_color);
613 vk::RenderingAttachmentInfo depth_attachment {};
614 if (depth_image_view) {
615 depth_attachment.sType = vk::StructureType::eRenderingAttachmentInfo;
616 depth_attachment.pNext =
nullptr;
617 depth_attachment.imageView = depth_image_view;
618 depth_attachment.imageLayout = vk::ImageLayout::eDepthStencilAttachmentOptimal;
619 depth_attachment.resolveMode = vk::ResolveModeFlagBits::eNone;
620 depth_attachment.resolveImageView =
nullptr;
621 depth_attachment.resolveImageLayout = vk::ImageLayout::eUndefined;
622 depth_attachment.loadOp = vk::AttachmentLoadOp::eClear;
623 depth_attachment.storeOp = vk::AttachmentStoreOp::eDontCare;
624 depth_attachment.clearValue.depthStencil = vk::ClearDepthStencilValue { 1.0F, 0 };
627 vk::RenderingInfo rendering_info {};
628 rendering_info.sType = vk::StructureType::eRenderingInfo;
629 rendering_info.pNext =
nullptr;
630 rendering_info.flags = vk::RenderingFlagBits::eContentsSecondaryCommandBuffers;
631 rendering_info.renderArea.offset = vk::Offset2D { 0, 0 };
632 rendering_info.renderArea.extent = vk::Extent2D { width, height };
633 rendering_info.layerCount = 1;
634 rendering_info.colorAttachmentCount = 1;
635 rendering_info.pColorAttachments = &color_attachment;
636 rendering_info.pDepthAttachment = depth_image_view ? &depth_attachment :
nullptr;
637 rendering_info.pStencilAttachment =
nullptr;
639 cmd.beginRendering(rendering_info);
642 "Began dynamic rendering for window '{}' ({}x{}, depth: {})",
643 window->get_create_info().title, width, height,
644 depth_image_view ?
"yes" :
"no");
649 const std::shared_ptr<Core::Window>& window)
654 "Invalid command buffer ID: {}", cmd_id);
663 "No swapchain image tracked for window '{}'",
664 window->get_create_info().title);
668 vk::ImageMemoryBarrier post_barrier {};
669 post_barrier.oldLayout = vk::ImageLayout::eColorAttachmentOptimal;
670 post_barrier.newLayout = vk::ImageLayout::ePresentSrcKHR;
671 post_barrier.srcQueueFamilyIndex = VK_QUEUE_FAMILY_IGNORED;
672 post_barrier.dstQueueFamilyIndex = VK_QUEUE_FAMILY_IGNORED;
673 post_barrier.image = it->second.swapchain_image;
674 post_barrier.subresourceRange.aspectMask = vk::ImageAspectFlagBits::eColor;
675 post_barrier.subresourceRange.baseMipLevel = 0;
676 post_barrier.subresourceRange.levelCount = 1;
677 post_barrier.subresourceRange.baseArrayLayer = 0;
678 post_barrier.subresourceRange.layerCount = 1;
679 post_barrier.srcAccessMask = vk::AccessFlagBits::eColorAttachmentWrite;
680 post_barrier.dstAccessMask = vk::AccessFlagBits::eNone;
683 vk::PipelineStageFlagBits::eColorAttachmentOutput,
684 vk::PipelineStageFlagBits::eBottomOfPipe,
685 vk::DependencyFlags {},
690 it->second.swapchain_image =
nullptr;
693 "Ended dynamic rendering for window '{}'",
694 window->get_create_info().title);
706 "Invalid pipeline ID: {}", pipeline_id);
713 "Invalid command buffer ID: {}", cmd_id);
717 pipeline_it->second.pipeline->bind(cmd);
722 const std::vector<std::shared_ptr<Buffers::VKBuffer>>& buffers,
723 uint32_t first_binding)
728 "Invalid command buffer ID: {}", cmd_id);
732 std::vector<vk::Buffer> vk_buffers;
733 std::vector<vk::DeviceSize> offsets(buffers.size(), 0);
735 vk_buffers.reserve(buffers.size());
736 for (
const auto& buf : buffers) {
737 vk_buffers.push_back(buf->get_buffer());
758 cmd.bindVertexBuffers(first_binding, vk_buffers, offsets);
763 const std::shared_ptr<Buffers::VKBuffer>& buffer,
764 vk::IndexType index_type)
769 "Invalid command buffer ID: {}", cmd_id);
773 cmd.bindIndexBuffer(buffer->get_buffer(), 0, index_type);
779 const std::vector<DescriptorSetID>& descriptor_sets)
784 "Invalid pipeline ID: {}", pipeline_id);
791 "Invalid command buffer ID: {}", cmd_id);
795 std::vector<vk::DescriptorSet> vk_sets;
796 vk_sets.reserve(descriptor_sets.size());
797 for (
auto ds_id : descriptor_sets) {
801 cmd.bindDescriptorSets(
802 vk::PipelineBindPoint::eGraphics,
803 pipeline_it->second.layout,
818 "Invalid pipeline ID: {}", pipeline_id);
825 "Invalid command buffer ID: {}", cmd_id);
830 pipeline_it->second.layout,
831 pipeline_it->second.push_constant_stages,
833 static_cast<uint32_t
>(size),
839 uint32_t vertex_count,
840 uint32_t instance_count,
841 uint32_t first_vertex,
842 uint32_t first_instance)
847 "Invalid command buffer ID: {}", cmd_id);
851 cmd.draw(vertex_count, instance_count, first_vertex, first_instance);
856 uint32_t index_count,
857 uint32_t instance_count,
858 uint32_t first_index,
859 int32_t vertex_offset,
860 uint32_t first_instance)
867 cmd.drawIndexed(index_count, instance_count, first_index,
868 vertex_offset, first_instance);
873 uint32_t group_count_x,
874 uint32_t group_count_y,
875 uint32_t group_count_z)
880 "Invalid command buffer ID: {}", cmd_id);
884 cmd.drawMeshTasksEXT(group_count_x, group_count_y, group_count_z);
889 const std::shared_ptr<Buffers::VKBuffer>& buffer,
890 vk::DeviceSize offset,
898 cmd.drawMeshTasksIndirectEXT(buffer->get_buffer(), offset, draw_count, stride);
909 "Cannot register null window");
913 if (!window->is_graphics_registered()) {
915 "Window '{}' not registered with graphics backend yet.",
916 window->get_create_info().title);
921 association.
window = window;
925 "Registered window '{}' for dynamic rendering",
926 window->get_create_info().title);
942 "Unregistered window '{}' from rendering",
943 window->get_create_info().title);
954 std::vector<std::shared_ptr<Core::Window>> windows;
958 if (
auto window = association.window.lock()) {
959 windows.push_back(window);
972 return *
static_cast<vk::ImageView*
>(view_ptr);
985 "Invalid pipeline ID: {}", pipeline_id);
989 std::vector<DescriptorSetID> descriptor_set_ids;
990 for (
const auto& layout : pipeline_it->second.layouts) {
994 "Failed to allocate descriptor set for pipeline {}", pipeline_id);
997 descriptor_set_ids.push_back(ds_id);
1001 "Allocated {} descriptor sets for pipeline {}",
1002 descriptor_set_ids.size(), pipeline_id);
1004 return descriptor_set_ids;
#define MF_INFO(comp, ctx,...)
#define MF_ERROR(comp, ctx,...)
#define MF_RT_ERROR(comp, ctx,...)
#define MF_TRACE(comp, ctx,...)
#define MF_WARN(comp, ctx,...)
#define MF_DEBUG(comp, ctx,...)
void bind_pipeline(CommandBufferID cmd_id, RenderPipelineID pipeline)
Bind graphics pipeline.
void register_window_for_rendering(const std::shared_ptr< Core::Window > &window)
Register a window for dynamic rendering.
void push_constants(CommandBufferID cmd_id, RenderPipelineID pipeline, const void *data, size_t size)
Push constants.
std::unordered_map< std::shared_ptr< Core::Window >, WindowRenderAssociation > m_window_associations
void begin_rendering(CommandBufferID cmd_id, const std::shared_ptr< Core::Window > &window, vk::Image swapchain_image, const std::array< float, 4 > &clear_color=default_color, vk::ImageView depth_image_view=nullptr)
Begin dynamic rendering to a window.
vk::ImageView get_current_image_view(const std::shared_ptr< Core::Window > &window)
Get current image view for window.
std::vector< DescriptorSetID > allocate_pipeline_descriptors(RenderPipelineID pipeline)
Allocate descriptor sets for pipeline.
void destroy_pipeline(RenderPipelineID pipeline_id)
Destroy a graphics pipeline.
void bind_vertex_buffers(CommandBufferID cmd_id, const std::vector< std::shared_ptr< Buffers::VKBuffer > > &buffers, uint32_t first_binding=0)
Bind vertex buffers.
std::vector< std::shared_ptr< Core::Window > > get_registered_windows() const
Get all registered windows.
void end_rendering(CommandBufferID cmd_id, const std::shared_ptr< Core::Window > &window)
End dynamic rendering.
void draw_indexed(CommandBufferID cmd_id, uint32_t index_count, uint32_t instance_count=1, uint32_t first_index=0, int32_t vertex_offset=0, uint32_t first_instance=0)
Indexed draw command.
std::unordered_map< RenderPipelineID, PipelineState > m_pipelines
bool is_initialized() const
void bind_index_buffer(CommandBufferID cmd_id, const std::shared_ptr< Buffers::VKBuffer > &buffer, vk::IndexType index_type=vk::IndexType::eUint32)
Bind index buffer.
ShaderFoundry * m_shader_foundry
void bind_descriptor_sets(CommandBufferID cmd_id, RenderPipelineID pipeline, const std::vector< DescriptorSetID > &descriptor_sets)
Bind descriptor sets.
void draw_mesh_tasks(CommandBufferID cmd_id, uint32_t group_count_x, uint32_t group_count_y=1, uint32_t group_count_z=1)
Draw mesh tasks (mesh shading pipeline only)
bool is_window_registered(const std::shared_ptr< Core::Window > &window) const
Check if a window is registered for rendering.
void draw(CommandBufferID cmd_id, uint32_t vertex_count, uint32_t instance_count=1, uint32_t first_vertex=0, uint32_t first_instance=0)
Draw command.
void draw_mesh_tasks_indirect(CommandBufferID cmd_id, const std::shared_ptr< Buffers::VKBuffer > &buffer, vk::DeviceSize offset=0, uint32_t draw_count=1, uint32_t stride=sizeof(VkDrawMeshTasksIndirectCommandEXT))
Draw mesh tasks indirect.
void unregister_window(const std::shared_ptr< Core::Window > &window)
Unregister a window from rendering.
Registry::Service::DisplayService * m_display_service
std::atomic< uint64_t > m_next_pipeline_id
RenderPipelineID create_pipeline(const RenderPipelineConfig &config, const std::vector< vk::Format > &color_formats, vk::Format depth_format=vk::Format::eUndefined)
Create graphics pipeline for dynamic rendering (no render pass object)
static bool s_initialized
vk::DescriptorSet get_descriptor_set(DescriptorSetID descriptor_set_id)
Get Vulkan descriptor set handle from DescriptorSetID.
vk::Device get_device() const
std::shared_ptr< Core::VKShaderModule > get_vk_shader_module(ShaderID shader_id)
bool is_initialized() const
Check if compiler is initialized.
static ShaderFoundry & instance()
vk::CommandBuffer get_command_buffer(CommandBufferID cmd_id)
Get Vulkan command buffer handle from CommandBufferID.
DescriptorSetID allocate_descriptor_set(vk::DescriptorSetLayout layout)
Allocate descriptor set for a pipeline.
static std::pair< std::vector< Core::VertexBinding >, std::vector< Core::VertexAttribute > > translate_layout(const Kakshya::VertexLayout &layout, uint32_t binding_index=0)
Translate a semantic vertex layout to Vulkan binding/attribute descriptions.
Interface * get_service()
Query for a backend service.
static BackendRegistry & instance()
Get the global registry instance.
@ Rendering
GPU rendering operations (graphics pipeline, frame rendering)
@ Portal
High-level user-facing API layer.
PolygonMode
Rasterization polygon mode.
constexpr RenderPipelineID INVALID_RENDER_PIPELINE
const std::array< float, 4 > default_color
CullMode
Face culling mode.
uint64_t RenderPipelineID
constexpr ShaderID INVALID_SHADER
BlendOp
Blending operation.
BlendFactor
Blending factor.
PrimitiveTopology
Vertex assembly primitive topology.
CompareOp
Depth/stencil comparison operation.
constexpr DescriptorSetID INVALID_DESCRIPTOR_SET
vk::BlendOp alpha_blend_op
vk::BlendFactor dst_alpha_blend_factor
vk::BlendFactor src_alpha_blend_factor
vk::BlendFactor dst_color_blend_factor
vk::BlendOp color_blend_op
vk::BlendFactor src_color_blend_factor
std::vector< ColorBlendAttachment > color_blend_attachments
bool use_vertex_shader_reflection
vk::CompareOp depth_compare_op
std::vector< vk::Format > color_attachment_formats
vk::PrimitiveTopology topology
std::shared_ptr< VKShaderModule > task_shader
std::shared_ptr< VKShaderModule > fragment_shader
std::shared_ptr< VKShaderModule > mesh_shader
std::vector< vk::DynamicState > dynamic_states
std::vector< vk::PushConstantRange > push_constant_ranges
vk::PolygonMode polygon_mode
std::shared_ptr< VKShaderModule > vertex_shader
std::vector< vk::DescriptorSetLayout > descriptor_set_layouts
std::vector< VertexBinding > vertex_bindings
bool primitive_restart_enable
vk::CullModeFlags cull_mode
std::vector< VertexAttribute > vertex_attributes
std::shared_ptr< VKShaderModule > geometry_shader
vk::Format depth_attachment_format
std::shared_ptr< VKShaderModule > tess_evaluation_shader
std::shared_ptr< VKShaderModule > tess_control_shader
Configuration for creating a graphics pipeline.
CompareOp depth_compare_op
std::vector< vk::DescriptorSetLayout > layouts
vk::ShaderStageFlags push_constant_stages
std::shared_ptr< Core::VKGraphicsPipeline > pipeline
vk::PipelineLayout layout
std::vector< ShaderID > shader_ids
std::weak_ptr< Core::Window > window
std::vector< std::vector< DescriptorBindingInfo > > descriptor_sets
std::vector< Core::VertexAttribute > vertex_attributes
ShaderID tess_eval_shader
Optional.
std::vector< Core::VertexBinding > vertex_bindings
std::optional< Kakshya::VertexLayout > semantic_vertex_layout
ShaderID tess_control_shader
Optional.
bool use_vertex_shader_reflection
std::vector< BlendAttachmentConfig > blend_attachments
DepthStencilConfig depth_stencil
ShaderID mesh_shader
Optional.
size_t push_constant_size
PrimitiveTopology topology
ShaderID geometry_shader
Optional.
ShaderID task_shader
Optional.
RasterizationConfig rasterization
Complete render pipeline configuration.
std::function< void *(const std::shared_ptr< void > &)> get_current_image_view
Get current swapchain image view for rendering.
std::function< void(const std::shared_ptr< void > &, uint32_t &, uint32_t &)> get_swapchain_extent
Get swapchain extent for a window.
Backend display and presentation service interface.