MayaFlux 0.4.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
RootGraphicsBuffer.cpp
Go to the documentation of this file.
2
4
7
10
11namespace MayaFlux::Buffers {
12
13GraphicsBatchProcessor::GraphicsBatchProcessor(std::shared_ptr<Buffer> root_buffer)
14 : m_root_buffer(std::dynamic_pointer_cast<RootGraphicsBuffer>(std::move(root_buffer)))
15{
17}
18
19void GraphicsBatchProcessor::processing_function(const std::shared_ptr<Buffer>& buffer)
20{
21 auto root_buf = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer);
22 if (!root_buf || root_buf != m_root_buffer) {
24 "GraphicsBatchProcessor can only process its associated RootGraphicsBuffer");
25 return;
26 }
27
28 root_buf->cleanup_marked_buffers();
29
30 for (auto& ch_buffer : root_buf->get_child_buffers()) {
31 if (!ch_buffer)
32 continue;
33
34 if (ch_buffer->needs_removal()) {
35 continue;
36 }
37
38 if (!ch_buffer->has_data_for_cycle()) {
39 continue;
40 }
41
42 try {
43 if (ch_buffer->needs_default_processing() && ch_buffer->get_default_processor()) {
44 ch_buffer->process_default();
45 }
46
47 if (auto chain = ch_buffer->get_processing_chain()) {
48 if (ch_buffer->has_data_for_cycle()) {
49 chain->process_complete(ch_buffer);
50 }
51 }
52
53 auto vk_buffer = std::dynamic_pointer_cast<Buffers::VKBuffer>(ch_buffer);
54 if (vk_buffer && vk_buffer->has_render_pipeline()) {
55 for (const auto& [id, window] : vk_buffer->get_render_pipelines()) {
57 info.buffer = vk_buffer;
58 info.target_window = window;
59 info.pipeline_id = id;
60 info.command_buffer_id = vk_buffer->get_pipeline_command(id);
61 info.needs_depth = vk_buffer->needs_depth_attachment();
62
63 root_buf->add_renderable_buffer(info);
64
66 "Registered buffer for rendering to window '{}'",
67 window->get_create_info().title);
68 }
69 }
70
71 } catch (const std::exception& e) {
73 "Error processing graphics buffer: {}", e.what());
74 }
75 }
76}
77
78void GraphicsBatchProcessor::on_attach(const std::shared_ptr<Buffer>& buffer)
79{
80 auto root_graphics_buffer = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer);
81 if (!root_graphics_buffer) {
82 error<std::invalid_argument>(
85 std::source_location::current(),
86 "GraphicsBatchProcessor can only be attached to RootGraphicsBuffer");
87 }
88
90 error<std::runtime_error>(
93 std::source_location::current(),
94 "GraphicsBatchProcessor token incompatible with RootGraphicsBuffer requirements");
95 }
96}
97
98bool GraphicsBatchProcessor::is_compatible_with(const std::shared_ptr<Buffer>& buffer) const
99{
100 return std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer) != nullptr;
101}
102
104 : m_callback(std::move(callback))
105 , m_root_buffer(nullptr)
106{
108}
109
111 : m_callback(nullptr)
112 , m_root_buffer(nullptr)
113{
115}
116
117void PresentProcessor::processing_function(const std::shared_ptr<Buffer>& buffer)
118{
119 auto root_graphics_buffer = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer);
120 if (!root_graphics_buffer) {
122 "RenderProcessor received non-RootGraphicsBuffer");
123 return;
124 }
125
126 if (m_root_buffer && root_graphics_buffer != m_root_buffer) {
128 "RenderProcessor processing buffer that doesn't match attached root");
129 return;
130 }
131
132 if (m_callback) {
133 try {
134 m_callback(root_graphics_buffer);
135 } catch (const std::exception& e) {
136 error_rethrow(
139 std::source_location::current(),
140 "RenderProcessor callback threw exception: {}",
141 e.what());
142 }
143 } else {
144 fallback_renderer(root_graphics_buffer);
145 }
146}
147
148void PresentProcessor::on_attach(const std::shared_ptr<Buffer>& buffer)
149{
150 auto root_graphics_buffer = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer);
151 if (!root_graphics_buffer) {
152 error<std::invalid_argument>(
155 std::source_location::current(),
156 "RenderProcessor can only be attached to RootGraphicsBuffer");
157 }
158
160 error<std::runtime_error>(
163 std::source_location::current(),
164 "RenderProcessor token incompatible with RootGraphicsBuffer requirements");
165 }
166
167 m_root_buffer = root_graphics_buffer;
168
170 "RenderProcessor attached to RootGraphicsBuffer (has_callback: {})",
171 has_callback());
172}
173
174void PresentProcessor::on_detach(const std::shared_ptr<Buffer>& buffer)
175{
176 if (auto root = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer)) {
177 if (root == m_root_buffer) {
178 m_root_buffer = nullptr;
179 }
180 }
181
183 "RenderProcessor detached from RootGraphicsBuffer");
184}
185
186bool PresentProcessor::is_compatible_with(const std::shared_ptr<Buffer>& buffer) const
187{
188 return std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer) != nullptr;
189}
190
192{
193 m_callback = std::move(callback);
194
196 "RenderProcessor callback {} (attached: {})",
197 m_callback ? "configured" : "cleared",
198 m_root_buffer != nullptr);
199}
200
201void PresentProcessor::fallback_renderer(const std::shared_ptr<RootGraphicsBuffer>& root)
202{
203 const auto& renderable_buffers = root->get_renderable_buffers();
204 if (renderable_buffers.empty()) {
205 return;
206 }
207
208 std::unordered_map<Core::Window*, std::vector<const RootGraphicsBuffer::RenderableBufferInfo*>> buffers_by_window;
209 for (const auto& renderable : renderable_buffers) {
210 if (renderable.target_window && renderable.target_window->is_graphics_registered()
211 && renderable.command_buffer_id != Portal::Graphics::INVALID_COMMAND_BUFFER) {
212 buffers_by_window[renderable.target_window.get()].push_back(&renderable);
213 }
214 }
215
216 if (buffers_by_window.empty()) {
217 root->clear_renderable_buffers();
218 return;
219 }
220
222 "PresentProcessor submitting to {} windows", buffers_by_window.size());
223
224 auto& foundry = Portal::Graphics::get_shader_foundry();
226 auto display_service = Registry::BackendRegistry::instance()
228
229 if (!display_service) {
231 "DisplayService not available for dynamic rendering");
232 return;
233 }
234
235 for (const auto& [window_ptr, buffer_infos] : buffers_by_window) {
236 auto window = buffer_infos[0]->target_window;
237
238 uint64_t image_bits = display_service->acquire_next_swapchain_image(window);
239 if (image_bits == 0) {
241 "Failed to acquire swapchain image for window '{}'",
242 window->get_create_info().title);
243 continue;
244 }
245 vk::Image swapchain_image { reinterpret_cast<VkImage>(image_bits) };
246
247 auto primary_cmd_id = foundry.begin_commands(Portal::Graphics::ShaderFoundry::CommandBufferType::GRAPHICS);
248 auto primary_cmd = foundry.get_command_buffer(primary_cmd_id);
249
250 if (!primary_cmd) {
252 "Failed to create primary command buffer for window '{}'",
253 window->get_create_info().title);
254 for (const auto* info : buffer_infos) {
255 info->buffer->clear_pipeline_commands();
256 }
257 continue;
258 }
259
260 try {
261 bool window_needs_depth = false;
262 for (const auto* info : buffer_infos) {
263 if (info->needs_depth) {
264 window_needs_depth = true;
265 break;
266 }
267 }
268
269 vk::ImageView depth_view = nullptr;
270 if (window_needs_depth) {
271 display_service->ensure_depth_attachment(window);
272 auto* view_ptr = display_service->get_depth_image_view(window);
273 if (view_ptr) {
274 depth_view = *static_cast<vk::ImageView*>(view_ptr);
275 }
276 }
277
278 flow.begin_rendering(primary_cmd_id, window, swapchain_image,
280
281 std::vector<vk::CommandBuffer> secondary_buffers;
282 for (const auto* info : buffer_infos) {
283 auto secondary = foundry.get_command_buffer(info->command_buffer_id);
284 if (secondary) {
285 secondary_buffers.push_back(secondary);
286 }
287 }
288
289 if (!secondary_buffers.empty()) {
290 primary_cmd.executeCommands(secondary_buffers);
291 }
292
293 flow.end_rendering(primary_cmd_id, window);
294
295 foundry.end_commands(primary_cmd_id);
296 uint64_t primary_bits = *reinterpret_cast<uint64_t*>(&primary_cmd);
297 display_service->submit_and_present(window, primary_bits);
298
300 "Presented {} buffers to window '{}'",
301 secondary_buffers.size(), window->get_create_info().title);
302
303 } catch (const std::exception& e) {
305 "Failed to submit/present for window '{}': {}",
306 window->get_create_info().title,
307 e.what());
308 }
309
310 for (const auto* info : buffer_infos) {
311 info->buffer->clear_pipeline_commands();
312 }
313 }
314
315 root->clear_renderable_buffers();
316}
317
324
331
333{
334 auto batch_processor = create_default_processor();
335 if (batch_processor) {
336 set_default_processor(batch_processor);
337 }
338}
339
341{
342 if (this->has_pending_operations()) {
344 }
345
346 get_default_processor()->process(shared_from_this());
347}
348
350{
351 if (m_pending_removal.empty()) {
352 return;
353 }
354
355 auto it = std::remove_if(
356 m_child_buffers.begin(),
357 m_child_buffers.end(),
358 [](const std::shared_ptr<Buffer>& buf) {
359 return buf && buf->needs_removal();
360 });
361
362 size_t removed_count = std::distance(it, m_child_buffers.end());
363
364 if (removed_count > 0) {
365 m_child_buffers.erase(it, m_child_buffers.end());
366
368 "Cleaned up {} graphics buffers (remaining: {})",
369 removed_count, m_child_buffers.size());
370 }
371
372 m_pending_removal.clear();
373}
374
375void RootGraphicsBuffer::set_final_processor(std::shared_ptr<BufferProcessor> processor)
376{
377 m_final_processor = std::move(processor);
378}
379
380std::shared_ptr<BufferProcessor> RootGraphicsBuffer::get_final_processor() const
381{
382 return m_final_processor;
383}
384
385bool RootGraphicsBuffer::has_buffer(const std::shared_ptr<VKBuffer>& buffer) const
386{
387 return std::ranges::find(m_child_buffers, buffer) != m_child_buffers.end();
388}
389
390std::vector<std::shared_ptr<VKBuffer>> RootGraphicsBuffer::get_buffers_by_usage(VKBuffer::Usage usage) const
391{
392 std::vector<std::shared_ptr<VKBuffer>> filtered_buffers;
393
394 for (const auto& buffer : m_child_buffers) {
395 if (buffer && buffer->get_usage() == usage) {
396 filtered_buffers.push_back(buffer);
397 }
398 }
399
400 return filtered_buffers;
401}
402
403std::shared_ptr<BufferProcessor> RootGraphicsBuffer::create_default_processor()
404{
405 return std::make_shared<GraphicsBatchProcessor>(shared_from_this());
406}
407
408} // namespace MayaFlux::Buffers
#define MF_INFO(comp, ctx,...)
#define MF_RT_WARN(comp, ctx,...)
#define MF_RT_ERROR(comp, ctx,...)
#define MF_RT_TRACE(comp, ctx,...)
#define MF_RT_DEBUG(comp, ctx,...)
std::shared_ptr< RootGraphicsBuffer > m_root_buffer
Shared pointer to the root buffer this processor manages.
bool is_compatible_with(const std::shared_ptr< Buffer > &buffer) const override
Checks compatibility with a specific buffer type.
void processing_function(const std::shared_ptr< Buffer > &buffer) override
Processes a buffer by coordinating child buffer operations.
GraphicsBatchProcessor(std::shared_ptr< Buffer > root_buffer)
Creates a new graphics batch processor.
void on_attach(const std::shared_ptr< Buffer > &buffer) override
Called when processor is attached to a buffer.
std::function< void(const std::shared_ptr< RootGraphicsBuffer > &root)> RenderCallback
Callback signature for render operations.
void processing_function(const std::shared_ptr< Buffer > &buffer) override
Executes the render callback.
RenderCallback m_callback
User-provided render callback.
bool has_callback() const
Checks if a callback is configured.
bool is_compatible_with(const std::shared_ptr< Buffer > &buffer) const override
Checks compatibility with a specific buffer type.
void set_callback(RenderCallback callback)
Sets or updates the render callback.
void fallback_renderer(const std::shared_ptr< RootGraphicsBuffer > &root)
void on_attach(const std::shared_ptr< Buffer > &buffer) override
Called when processor is attached to a buffer.
void on_detach(const std::shared_ptr< Buffer > &buffer) override
Called when processor is detached from a buffer.
PresentProcessor()
Default constructor (no callback set)
std::shared_ptr< RootGraphicsBuffer > m_root_buffer
Reference to root buffer (for validation and callbacks)
void process_pending_buffer_operations()
Process pending operations - call this at start of processing cycles.
ProcessingToken m_preferred_processing_token
Preferred processing token for this root buffer.
TokenEnforcementStrategy m_token_enforcement_strategy
Current token enforcement strategy for this root buffer.
std::vector< std::shared_ptr< VKBuffer > > m_child_buffers
Vector of tributary buffers that contribute to this root buffer.
void process_default() override
Processes this root buffer using default processing.
std::shared_ptr< BufferProcessor > get_final_processor() const
Gets the current final processor.
void cleanup_marked_buffers()
Removes buffers marked for deletion.
void set_final_processor(std::shared_ptr< BufferProcessor > processor)
Sets an optional final processor.
std::vector< std::shared_ptr< VKBuffer > > get_buffers_by_usage(VKBuffer::Usage usage) const
Gets buffers filtered by usage type.
std::shared_ptr< BufferProcessor > m_final_processor
Optional final processor (rarely used in graphics)
std::vector< std::shared_ptr< VKBuffer > > m_pending_removal
Buffers pending removal (cleaned up in next process cycle)
void initialize()
Initializes the root buffer with default processor.
bool has_buffer(const std::shared_ptr< VKBuffer > &buffer) const
Checks if a specific buffer is registered.
~RootGraphicsBuffer() override
Virtual destructor ensuring proper cleanup.
RootGraphicsBuffer()
Creates a new root graphics buffer.
std::shared_ptr< BufferProcessor > create_default_processor()
Creates the default graphics batch processor.
Root container for GPU buffer lifecycle management and batch processing.
std::shared_ptr< Buffers::BufferProcessor > get_default_processor() const override
Get the currently attached default processor.
Definition VKBuffer.cpp:281
void set_default_processor(const std::shared_ptr< BufferProcessor > &processor) override
Set the buffer's default processor.
Definition VKBuffer.cpp:270
Interface * get_service()
Query for a backend service.
static BackendRegistry & instance()
Get the global registry instance.
bool are_tokens_compatible(ProcessingToken preferred, ProcessingToken current)
Determines if two processing tokens are compatible for joint execution.
@ GRAPHICS_BACKEND
Standard graphics processing backend configuration.
@ STRICT
Strictly enforces token assignment with no cross-token sharing.
@ BufferManagement
Buffer Management (Buffers::BufferManager, creating buffers)
@ BufferProcessing
Buffer processing (Buffers::BufferManager, processing chains)
@ Buffers
Buffers, Managers, processors and processing chains.
@ Core
Core engine, backend, subsystems.
const std::array< float, 4 > default_color
MAYAFLUX_API RenderFlow & get_render_flow()
Get the global render flow instance.
MAYAFLUX_API ShaderFoundry & get_shader_foundry()
Get the global shader compiler instance.
constexpr CommandBufferID INVALID_COMMAND_BUFFER
Information about a buffer that's ready to render.
Backend display and presentation service interface.