MayaFlux 0.2.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
RootGraphicsBuffer.cpp
Go to the documentation of this file.
2
4
7
10
12
13namespace MayaFlux::Buffers {
14
15GraphicsBatchProcessor::GraphicsBatchProcessor(std::shared_ptr<Buffer> root_buffer)
16 : m_root_buffer(std::dynamic_pointer_cast<RootGraphicsBuffer>(std::move(root_buffer)))
17{
19}
20
21void GraphicsBatchProcessor::processing_function(const std::shared_ptr<Buffer>& buffer)
22{
23 auto root_buf = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer);
24 if (!root_buf || root_buf != m_root_buffer) {
26 "GraphicsBatchProcessor can only process its associated RootGraphicsBuffer");
27 return;
28 }
29
30 root_buf->cleanup_marked_buffers();
31
32 for (auto& ch_buffer : root_buf->get_child_buffers()) {
33 if (!ch_buffer)
34 continue;
35
36 if (ch_buffer->needs_removal()) {
37 continue;
38 }
39
40 if (!ch_buffer->has_data_for_cycle()) {
41 continue;
42 }
43
44 try {
45 if (ch_buffer->needs_default_processing() && ch_buffer->get_default_processor()) {
46 ch_buffer->process_default();
47 }
48
49 if (auto chain = ch_buffer->get_processing_chain()) {
50 if (ch_buffer->has_data_for_cycle()) {
51 chain->process_complete(ch_buffer);
52 }
53 }
54
55 auto vk_buffer = std::dynamic_pointer_cast<Buffers::VKBuffer>(ch_buffer);
56 if (vk_buffer && vk_buffer->has_render_pipeline()) {
57 for (const auto& [id, window] : vk_buffer->get_render_pipelines()) {
59 info.buffer = vk_buffer;
60 info.target_window = window;
61 info.pipeline_id = id;
62 info.command_buffer_id = vk_buffer->get_pipeline_command(id);
63
64 root_buf->add_renderable_buffer(info);
65
67 "Registered buffer for rendering to window '{}'",
68 window->get_create_info().title);
69 }
70 }
71
72 } catch (const std::exception& e) {
74 "Error processing graphics buffer: {}", e.what());
75 }
76 }
77}
78
79void GraphicsBatchProcessor::on_attach(const std::shared_ptr<Buffer>& buffer)
80{
81 auto root_graphics_buffer = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer);
82 if (!root_graphics_buffer) {
83 error<std::invalid_argument>(
86 std::source_location::current(),
87 "GraphicsBatchProcessor can only be attached to RootGraphicsBuffer");
88 }
89
91 error<std::runtime_error>(
94 std::source_location::current(),
95 "GraphicsBatchProcessor token incompatible with RootGraphicsBuffer requirements");
96 }
97}
98
99bool GraphicsBatchProcessor::is_compatible_with(const std::shared_ptr<Buffer>& buffer) const
100{
101 return std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer) != nullptr;
102}
103
105 : m_callback(std::move(callback))
106 , m_root_buffer(nullptr)
107{
109}
110
112 : m_callback(nullptr)
113 , m_root_buffer(nullptr)
114{
116}
117
118void PresentProcessor::processing_function(const std::shared_ptr<Buffer>& buffer)
119{
120 auto root_graphics_buffer = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer);
121 if (!root_graphics_buffer) {
123 "RenderProcessor received non-RootGraphicsBuffer");
124 return;
125 }
126
127 if (m_root_buffer && root_graphics_buffer != m_root_buffer) {
129 "RenderProcessor processing buffer that doesn't match attached root");
130 return;
131 }
132
133 if (m_callback) {
134 try {
135 m_callback(root_graphics_buffer);
136 } catch (const std::exception& e) {
137 error_rethrow(
140 std::source_location::current(),
141 "RenderProcessor callback threw exception: {}",
142 e.what());
143 }
144 } else {
145 fallback_renderer(root_graphics_buffer);
146 }
147}
148
149void PresentProcessor::on_attach(const std::shared_ptr<Buffer>& buffer)
150{
151 auto root_graphics_buffer = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer);
152 if (!root_graphics_buffer) {
153 error<std::invalid_argument>(
156 std::source_location::current(),
157 "RenderProcessor can only be attached to RootGraphicsBuffer");
158 }
159
161 error<std::runtime_error>(
164 std::source_location::current(),
165 "RenderProcessor token incompatible with RootGraphicsBuffer requirements");
166 }
167
168 m_root_buffer = root_graphics_buffer;
169
171 "RenderProcessor attached to RootGraphicsBuffer (has_callback: {})",
172 has_callback());
173}
174
175void PresentProcessor::on_detach(const std::shared_ptr<Buffer>& buffer)
176{
177 if (auto root = std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer)) {
178 if (root == m_root_buffer) {
179 m_root_buffer = nullptr;
180 }
181 }
182
184 "RenderProcessor detached from RootGraphicsBuffer");
185}
186
187bool PresentProcessor::is_compatible_with(const std::shared_ptr<Buffer>& buffer) const
188{
189 return std::dynamic_pointer_cast<RootGraphicsBuffer>(buffer) != nullptr;
190}
191
193{
194 m_callback = std::move(callback);
195
197 "RenderProcessor callback {} (attached: {})",
198 m_callback ? "configured" : "cleared",
199 m_root_buffer != nullptr);
200}
201
202void PresentProcessor::fallback_renderer(const std::shared_ptr<RootGraphicsBuffer>& root)
203{
204 const auto& renderable_buffers = root->get_renderable_buffers();
205 if (renderable_buffers.empty()) {
207 "No renderable buffers found in fallback renderer");
208 return;
209 }
210
211 std::unordered_map<Core::Window*, std::vector<const RootGraphicsBuffer::RenderableBufferInfo*>> buffers_by_window;
212 for (const auto& renderable : renderable_buffers) {
213 if (renderable.target_window && renderable.target_window->is_graphics_registered()
214 && renderable.command_buffer_id != Portal::Graphics::INVALID_COMMAND_BUFFER) {
215 buffers_by_window[renderable.target_window.get()].push_back(&renderable);
216 }
217 }
218
219 if (buffers_by_window.empty()) {
220 root->clear_renderable_buffers();
221 return;
222 }
223
225 "PresentProcessor submitting to {} windows", buffers_by_window.size());
226
227 auto& foundry = Portal::Graphics::get_shader_foundry();
229 auto display_service = Registry::BackendRegistry::instance()
231
232 if (!display_service) {
234 "DisplayService not available for dynamic rendering");
235 return;
236 }
237
238 for (const auto& [window_ptr, buffer_infos] : buffers_by_window) {
239 auto window = buffer_infos[0]->target_window;
240
241 uint64_t image_bits = display_service->acquire_next_swapchain_image(window);
242 if (image_bits == 0) {
244 "Failed to acquire swapchain image for window '{}'",
245 window->get_create_info().title);
246 continue;
247 }
248 vk::Image swapchain_image { reinterpret_cast<VkImage>(image_bits) };
249
250 auto primary_cmd_id = foundry.begin_commands(Portal::Graphics::ShaderFoundry::CommandBufferType::GRAPHICS);
251 auto primary_cmd = foundry.get_command_buffer(primary_cmd_id);
252
253 if (!primary_cmd) {
255 "Failed to create primary command buffer for window '{}'",
256 window->get_create_info().title);
257 for (const auto* info : buffer_infos) {
258 info->buffer->clear_pipeline_commands();
259 }
260 continue;
261 }
262
263 try {
264 flow.begin_rendering(primary_cmd_id, window, swapchain_image);
265
266 std::vector<vk::CommandBuffer> secondary_buffers;
267 for (const auto* info : buffer_infos) {
268 auto secondary = foundry.get_command_buffer(info->command_buffer_id);
269 if (secondary) {
270 secondary_buffers.push_back(secondary);
271 }
272 }
273
274 if (!secondary_buffers.empty()) {
275 primary_cmd.executeCommands(secondary_buffers);
276 }
277
278 flow.end_rendering(primary_cmd_id, window);
279
280 foundry.end_commands(primary_cmd_id);
281 uint64_t primary_bits = *reinterpret_cast<uint64_t*>(&primary_cmd);
282 display_service->submit_and_present(window, primary_bits);
283
285 "Presented {} buffers to window '{}'",
286 secondary_buffers.size(), window->get_create_info().title);
287
288 } catch (const std::exception& e) {
290 "Failed to submit/present for window '{}': {}",
291 window->get_create_info().title,
292 e.what());
293 }
294
295 for (const auto* info : buffer_infos) {
296 info->buffer->clear_pipeline_commands();
297 }
298 }
299
300 root->clear_renderable_buffers();
301}
302
309
316
318{
319 auto batch_processor = create_default_processor();
320 if (batch_processor) {
321 set_default_processor(batch_processor);
322 }
323}
324
326{
327 if (this->has_pending_operations()) {
329 }
330
331 get_default_processor()->process(shared_from_this());
332}
333
335{
336 if (m_pending_removal.empty()) {
337 return;
338 }
339
340 auto it = std::remove_if(
341 m_child_buffers.begin(),
342 m_child_buffers.end(),
343 [](const std::shared_ptr<Buffer>& buf) {
344 return buf && buf->needs_removal();
345 });
346
347 size_t removed_count = std::distance(it, m_child_buffers.end());
348
349 if (removed_count > 0) {
350 m_child_buffers.erase(it, m_child_buffers.end());
351
353 "Cleaned up {} graphics buffers (remaining: {})",
354 removed_count, m_child_buffers.size());
355 }
356
357 m_pending_removal.clear();
358}
359
360void RootGraphicsBuffer::set_final_processor(std::shared_ptr<BufferProcessor> processor)
361{
362 m_final_processor = std::move(processor);
363}
364
365std::shared_ptr<BufferProcessor> RootGraphicsBuffer::get_final_processor() const
366{
367 return m_final_processor;
368}
369
370bool RootGraphicsBuffer::has_buffer(const std::shared_ptr<VKBuffer>& buffer) const
371{
372 return std::ranges::find(m_child_buffers, buffer) != m_child_buffers.end();
373}
374
375std::vector<std::shared_ptr<VKBuffer>> RootGraphicsBuffer::get_buffers_by_usage(VKBuffer::Usage usage) const
376{
377 std::vector<std::shared_ptr<VKBuffer>> filtered_buffers;
378
379 for (const auto& buffer : m_child_buffers) {
380 if (buffer && buffer->get_usage() == usage) {
381 filtered_buffers.push_back(buffer);
382 }
383 }
384
385 return filtered_buffers;
386}
387
388std::shared_ptr<BufferProcessor> RootGraphicsBuffer::create_default_processor()
389{
390 return std::make_shared<GraphicsBatchProcessor>(shared_from_this());
391}
392
393} // 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:272
void set_default_processor(const std::shared_ptr< BufferProcessor > &processor) override
Set the buffer's default processor.
Definition VKBuffer.cpp:261
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.
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.