MayaFlux 1.0.0
Digital-First Multimedia Processing Framework
Loading...
Searching...
No Matches
ComputeProcessor.cpp
Go to the documentation of this file.
2
3namespace MayaFlux::Buffers {
4
5//==============================================================================
6// Construction
7//==============================================================================
8
9ComputeProcessor::ComputeProcessor(const std::string& shader_path, uint32_t workgroup_x)
10 : ShaderProcessor(shader_path)
11
12{
13 m_dispatch_config.workgroup_x = workgroup_x;
14}
15
23
24void ComputeProcessor::initialize_pipeline(const std::shared_ptr<VKBuffer>& buffer)
25{
28 "Cannot create pipeline without shader");
29 return;
30 }
31
32 auto& compute_press = Portal::Graphics::get_compute_press();
33
34 std::map<std::pair<uint32_t, uint32_t>, Portal::Graphics::DescriptorBindingInfo> unified_bindings;
35
36 const auto& descriptor_bindings = buffer->get_pipeline_context().descriptor_buffer_bindings;
37 for (const auto& binding : descriptor_bindings) {
38 unified_bindings[{ binding.set, binding.binding }] = binding;
39 }
40
41 for (const auto& [name, binding] : m_config.bindings) {
42 auto key = std::make_pair(binding.set, binding.binding);
43 if (unified_bindings.find(key) == unified_bindings.end()) {
44 unified_bindings[key] = Portal::Graphics::DescriptorBindingInfo {
45 .set = binding.set,
46 .binding = binding.binding,
47 .type = binding.type,
48 .buffer_info = {},
49 .name = name
50 };
51 }
52 }
53
54 std::map<uint32_t, std::vector<Portal::Graphics::DescriptorBindingInfo>> bindings_by_set;
55 for (const auto& [key, binding] : unified_bindings) {
56 bindings_by_set[binding.set].push_back(binding);
57 }
58
59 std::vector<std::vector<Portal::Graphics::DescriptorBindingInfo>> descriptor_sets;
60
61 descriptor_sets.reserve(bindings_by_set.size());
62 for (const auto& [set_index, set_bindings] : bindings_by_set) {
63 descriptor_sets.push_back(set_bindings);
64 }
65
66 const auto previous_pipeline = m_pipeline_id;
67
68 m_pipeline_id = compute_press.create_pipeline(
70 descriptor_sets,
72
73 if (previous_pipeline != Portal::Graphics::INVALID_COMPUTE_PIPELINE) {
74 compute_press.destroy_pipeline(previous_pipeline);
75 }
76
79 "Failed to create compute pipeline");
80 return;
81 }
82
84
86 "Compute pipeline created (ID: {}, {} descriptor sets, {} bytes push constants)",
87 m_pipeline_id, descriptor_sets.size(), m_config.push_constant_size);
88}
89
90void ComputeProcessor::initialize_descriptors(const std::shared_ptr<VKBuffer>& buffer)
91{
94 "Cannot allocate descriptor sets without pipeline");
95 return;
96 }
97
99
100 auto& compute_press = Portal::Graphics::get_compute_press();
101
102 m_descriptor_set_ids = compute_press.allocate_pipeline_descriptors(m_pipeline_id);
103
104 if (m_descriptor_set_ids.empty()) {
106 "Failed to allocate descriptor sets");
107 return;
108 }
109
112
114 "Descriptor sets initialized: {} sets", m_descriptor_set_ids.size());
115}
116
117//==============================================================================
118// Dispatch Configuration
119//==============================================================================
120
121void ComputeProcessor::set_workgroup_size(uint32_t x, uint32_t y, uint32_t z)
122{
126}
127
132
140
142 std::function<std::array<uint32_t, 3>(const std::shared_ptr<VKBuffer>&)> calculator)
143{
145 m_dispatch_config.custom_calculator = std::move(calculator);
146}
147
148std::array<uint32_t, 3> ComputeProcessor::calculate_dispatch_size(const std::shared_ptr<VKBuffer>& buffer)
149{
150 using DispatchMode = ShaderDispatchConfig::DispatchMode;
151
152 switch (m_dispatch_config.mode) {
153 case DispatchMode::MANUAL:
155
156 case DispatchMode::ELEMENT_COUNT: {
157 uint64_t element_count = 0;
158 const auto& dimensions = buffer->get_dimensions();
159
160 if (!dimensions.empty()) {
161 element_count = dimensions[0].size;
162 } else {
163 element_count = buffer->get_size_bytes() / sizeof(float);
164 }
165
166 auto groups_x = static_cast<uint32_t>(
168 return { groups_x, 1, 1 };
169 }
170
171 case DispatchMode::BUFFER_SIZE: {
172 uint64_t size_bytes = buffer->get_size_bytes();
173 auto groups_x = static_cast<uint32_t>(
175 return { groups_x, 1, 1 };
176 }
177
178 case DispatchMode::CUSTOM:
181 }
182 return { 1, 1, 1 };
183
184 default:
185 return { 1, 1, 1 };
186 }
187}
188
193
196 const std::shared_ptr<VKBuffer>&,
197 uint32_t)
198{
199 return true;
200}
201
204 const std::shared_ptr<VKBuffer>& buffer,
205 uint32_t)
206{
208 cmd_id,
209 buffer->get_buffer(),
210 vk::AccessFlagBits::eShaderWrite,
211 vk::AccessFlagBits::eShaderRead | vk::AccessFlagBits::eShaderWrite,
212 vk::PipelineStageFlagBits::eComputeShader,
213 vk::PipelineStageFlagBits::eComputeShader);
214}
215
216void ComputeProcessor::execute_shader(const std::shared_ptr<VKBuffer>& buffer)
217{
220 "Cannot dispatch without pipeline and descriptors");
221 return;
222 }
223
224 if (m_descriptor_set_ids.empty()) {
226 "Descriptor sets not initialized");
227 return;
228 }
229
230 auto& foundry = Portal::Graphics::get_shader_foundry();
231 auto& compute_press = Portal::Graphics::get_compute_press();
232
233 auto cmd_id = foundry.begin_commands(Portal::Graphics::ShaderFoundry::CommandBufferType::COMPUTE);
234
235 m_last_command_buffer = cmd_id;
237
238 compute_press.bind_pipeline(cmd_id, m_pipeline_id);
239
240 auto& descriptor_bindings = buffer->get_pipeline_context().descriptor_buffer_bindings;
241 if (!descriptor_bindings.empty()) {
242 for (const auto& binding : descriptor_bindings) {
243 if (binding.set >= m_descriptor_set_ids.size()) {
245 "Descriptor set index {} out of range", binding.set);
246 continue;
247 }
248
249 foundry.update_descriptor_buffer(
250 m_descriptor_set_ids[binding.set],
251 binding.binding,
252 binding.type,
253 binding.buffer_info.buffer,
254 binding.buffer_info.offset,
255 binding.buffer_info.range);
256 }
257 }
258
259 if (!m_descriptor_set_ids.empty()) {
260 compute_press.bind_descriptor_sets(cmd_id, m_pipeline_id, m_descriptor_set_ids);
261 }
262
263 on_before_execute(cmd_id, buffer);
264 pump_feeds(false);
265
266 const uint32_t iterations = std::max(1U, m_dispatch_config.iteration_count);
267 const auto dispatch_size = calculate_dispatch_size(buffer);
268
269 for (uint32_t i = 0; i < iterations; ++i) {
270 if (!on_iteration(cmd_id, buffer, i)) {
271 continue;
272 }
273
275
276 if (!m_push_constant_scratch.empty()) {
277 compute_press.push_constants(
278 cmd_id, m_pipeline_id,
281 }
282
283 compute_press.dispatch(cmd_id, dispatch_size[0], dispatch_size[1], dispatch_size[2]);
284
285 if (i + 1 < iterations) {
286 on_iteration_barrier(cmd_id, buffer, i);
287 }
288 }
289
290 on_after_execute(cmd_id, buffer);
291
292 foundry.buffer_barrier(
293 cmd_id,
294 buffer->get_buffer(),
295 vk::AccessFlagBits::eShaderWrite,
296 vk::AccessFlagBits::eShaderRead | vk::AccessFlagBits::eTransferRead,
297 vk::PipelineStageFlagBits::eComputeShader,
298 vk::PipelineStageFlagBits::eComputeShader | vk::PipelineStageFlagBits::eTransfer);
299
300 submit_recorded(cmd_id, buffer);
301}
302
314
315} // namespace MayaFlux::Buffers
#define MF_INFO(comp, ctx,...)
#define MF_ERROR(comp, ctx,...)
#define MF_RT_ERROR(comp, ctx,...)
#define MF_DEBUG(comp, ctx,...)
std::shared_ptr< NetworkGeometryBuffer > buffer
uint32_t mode
std::string name
Definition VKDevice.cpp:123
size_t count
virtual void on_iteration_barrier(Portal::Graphics::CommandBufferID cmd_id, const std::shared_ptr< VKBuffer > &buffer, uint32_t index)
Called after each iteration except the last.
std::vector< uint8_t > m_push_constant_scratch
Merged push constant block, reused across iterations.
void set_workgroup_size(uint32_t x, uint32_t y=1, uint32_t z=1)
Set workgroup size (should match shader local_size)
void initialize_descriptors(const std::shared_ptr< VKBuffer > &buffer) override
void execute_shader(const std::shared_ptr< VKBuffer > &buffer) override
ComputeProcessor(const std::string &shader_path, uint32_t workgroup_x=256)
Construct processor with shader path.
void initialize_pipeline(const std::shared_ptr< VKBuffer > &buffer) override
Portal::Graphics::ComputePipelineID m_pipeline_id
void set_iteration_count(uint32_t count)
Set how many dispatches are recorded per execute cycle.
void set_dispatch_mode(ShaderDispatchConfig::DispatchMode mode)
Set dispatch mode.
virtual bool on_iteration(Portal::Graphics::CommandBufferID cmd_id, const std::shared_ptr< VKBuffer > &buffer, uint32_t index)
Called before each iteration's push constants and dispatch.
void set_manual_dispatch(uint32_t x, uint32_t y=1, uint32_t z=1)
Set manual dispatch group counts.
virtual std::array< uint32_t, 3 > calculate_dispatch_size(const std::shared_ptr< VKBuffer > &buffer)
Calculate dispatch size from buffer.
void set_custom_dispatch(std::function< std::array< uint32_t, 3 >(const std::shared_ptr< VKBuffer > &)> calculator)
Set custom dispatch calculator.
Portal::Graphics::CommandBufferID m_last_command_buffer
Portal::Graphics::ShaderID m_shader_id
virtual void on_after_execute(Portal::Graphics::CommandBufferID cmd_id, const std::shared_ptr< VKBuffer > &buffer)
Called after each process callback.
virtual void on_descriptors_created()
Called after descriptor sets are created.
size_t resolve_push_constant_size(const std::shared_ptr< VKBuffer > &buffer) const
Byte width of this processor's push constant block, extended to cover any fragment staged on the buff...
virtual void update_descriptors(const std::shared_ptr< VKBuffer > &buffer)
void resolve_push_constants_into(std::vector< uint8_t > &out, const std::shared_ptr< VKBuffer > &buffer) const
resolve_push_constants() written into out, reusing its storage.
virtual bool on_before_execute(Portal::Graphics::CommandBufferID cmd_id, const std::shared_ptr< VKBuffer > &buffer)
Called before each process callback.
virtual void on_pipeline_created(Portal::Graphics::ComputePipelineID pipeline_id)
Called after pipeline is created.
std::shared_ptr< VKBuffer > m_last_processed_buffer
void submit_recorded(Portal::Graphics::CommandBufferID cmd_id, const std::shared_ptr< VKBuffer > &buffer)
Submit a recorded command buffer honoring the submission mode.
virtual void on_before_descriptors_create()
Called before descriptor sets are created.
void pump_feeds(bool early=true)
Pull every feed and write its result.
bool resolve_pending_dispatch(bool block)
Resolve an outstanding asynchronous submission.
std::vector< Portal::Graphics::DescriptorSetID > m_descriptor_set_ids
Abstract base class for shader-based buffer processing.
void destroy_pipeline(ComputePipelineID pipeline_id)
void buffer_barrier(CommandBufferID cmd_id, vk::Buffer buffer, vk::AccessFlags src_access, vk::AccessFlags dst_access, vk::PipelineStageFlags src_stage, vk::PipelineStageFlags dst_stage)
Insert buffer memory barrier.
@ BufferProcessing
Buffer processing (Buffers::BufferManager, processing chains)
@ Buffers
Buffers, Managers, processors and processing chains.
constexpr ShaderID INVALID_SHADER
MAYAFLUX_API ShaderFoundry & get_shader_foundry()
Get the global shader compiler instance.
constexpr ComputePipelineID INVALID_COMPUTE_PIPELINE
MAYAFLUX_API ComputePress & get_compute_press()
std::unordered_map< std::string, ShaderBinding > bindings
enum MayaFlux::Buffers::ShaderDispatchConfig::DispatchMode mode
std::function< std::array< uint32_t, 3 >(const std::shared_ptr< VKBuffer > &)> custom_calculator
@ CUSTOM
User-provided calculation function.
uint32_t workgroup_x
Workgroup size X (should match shader)
uint32_t iteration_count
Dispatches recorded per execute cycle.
std::array< uint32_t, 3 > workgroup_size
Complete declarative description of a generated compute shader.