bind_host_vk_buffer()

void MayaFlux::Buffers::DescriptorBindingsProcessor::bind_host_vk_buffer	(	const std::string &	name,
		const std::shared_ptr< VKBuffer > &	buffer,
		const std::string &	descriptor_name,
		uint32_t	set,
		Portal::Graphics::DescriptorRole	role = Portal::Graphics::DescriptorRole::STORAGE
	)

Bind a host-visible VKBuffer as a descriptor source.

Fails hard at bind time if the buffer is not host-visible. Reads mapped memory each cycle and uploads to the descriptor. Always treated as VECTOR binding.

Parameters

name	Logical binding name
buffer	Host-visible VKBuffer to read from
descriptor_name	Name in shader config bindings
set	Descriptor set index
role	Descriptor role (default: STORAGE)

Definition at line 266 of file DescriptorBindingsProcessor.cpp.

{
    if (!buffer) {
        MF_ERROR(Journal::Component::Buffers, Journal::Context::BufferProcessing,
            "Cannot bind null VKBuffer '{}'", name);
        return;
    }
 
    if (!buffer->is_host_visible()) {
        MF_ERROR(Journal::Component::Buffers, Journal::Context::BufferProcessing,
            "VKBuffer '{}' is device-local. Binding device-local buffers as descriptor "
            "sources requires a GPU-side copy via compute shader, not CPU readback. "
            "Use a host-visible buffer or restructure the pipeline.",
            name);
        return;
    }
 
    if (m_config.bindings.find(descriptor_name) == m_config.bindings.end()) {
        MF_ERROR(Journal::Component::Buffers, Journal::Context::BufferProcessing,
            "Descriptor '{}' not found in shader config", descriptor_name);
        return;
    }
 
    const auto& binding_config = m_config.bindings[descriptor_name];
    auto gpu_buffer = create_descriptor_buffer(buffer->get_size_bytes(), role);
 
    auto [it, inserted] = m_bindings.try_emplace(name);
    auto& binding = it->second;
 
    binding.buffer = buffer;
    binding.descriptor_name = descriptor_name;
    binding.set_index = set;
    binding.binding_index = binding_config.binding;
    binding.role = role;
    binding.binding_type = BindingType::VECTOR;
    binding.source_type = SourceType::HOST_VK_BUFFER;
    binding.gpu_buffer = gpu_buffer;
    binding.buffer_offset = 0;
    binding.buffer_size = buffer->get_size_bytes();
 
    bind_buffer(descriptor_name, gpu_buffer);
    m_needs_descriptor_rebuild = true;
 
    MF_DEBUG(Journal::Component::Buffers, Journal::Context::BufferProcessing,
        "Bound host VKBuffer '{}' to descriptor '{}' ({} bytes)",
        name, descriptor_name, buffer->get_size_bytes());
}

References MayaFlux::Buffers::ShaderProcessor::bind_buffer(), MayaFlux::Buffers::ShaderConfig::bindings, MayaFlux::Journal::BufferProcessing, MayaFlux::Journal::Buffers, create_descriptor_buffer(), HOST_VK_BUFFER, m_bindings, MayaFlux::Buffers::ShaderProcessor::m_config, MayaFlux::Buffers::ShaderProcessor::m_needs_descriptor_rebuild, MF_DEBUG, MF_ERROR, and VECTOR.

Here is the call graph for this function: