on_attach()

void MayaFlux::Buffers::MeshProcessor::on_attach ( const std::shared_ptr< Buffer > &  )

overrideprotectedvirtual

Called when this processor is attached to a buffer.

Parameters

buffer

Buffer this processor is being attached to

Provides an opportunity for the processor to initialize buffer-specific state, allocate resources, or perform validation. With expanded processor capabilities, this method can also:

• Analyze Buffer Characteristics: Examine data type, size, and format requirements
• Select Optimal Backend: Choose the most appropriate processing backend for the buffer
• Initialize Hardware Resources: Set up GPU contexts, CUDA streams, or other acceleration
• Configure Processing Parameters: Adapt algorithm parameters to buffer characteristics
• Establish Processing Strategy: Determine whether to use sequential or parallel execution
• Validate Compatibility: Ensure the processor can handle the buffer's data type and format

Default implementation does nothing, but derived classes should override this method to leverage the full capabilities of the expanded processor architecture.

Reimplemented from MayaFlux::Buffers::BufferProcessor.

Definition at line 21 of file MeshProcessor.cpp.

{
    if (!m_buffer_service) {
        m_buffer_service = Registry::BackendRegistry::instance()
                               .get_service<Registry::Service::BufferService>();
    }
 
    if (!m_buffer_service) {
        error<std::runtime_error>(
            Journal::Component::Buffers,
            Journal::Context::BufferProcessing,
            std::source_location::current(),
            "MeshProcessor requires a valid BufferService");
    }
 
    auto mesh_buf = std::dynamic_pointer_cast<MeshBuffer>(buffer);
    if (!mesh_buf) {
        MF_ERROR(Journal::Component::Buffers, Journal::Context::BufferProcessing,
            "MeshProcessor: attached to non-MeshBuffer — detaching");
        return;
    }
 
    if (!mesh_buf->m_mesh_data.is_valid()) {
        MF_ERROR(Journal::Component::Buffers, Journal::Context::BufferProcessing,
            "MeshProcessor: MeshData is not valid on attach — no GPU resources allocated");
        return;
    }
 
    m_mesh_buffer = mesh_buf;
 
    ensure_initialized(mesh_buf);
 
    allocate_gpu_buffers(mesh_buf);
    upload_vertices(mesh_buf);
    upload_indices(mesh_buf);
    link_index_resources();
 
    mesh_buf->clear_vertices_dirty();
    mesh_buf->clear_indices_dirty();
 
    mesh_buf->set_vertex_layout(mesh_buf->m_mesh_data.layout);
 
    MF_INFO(Journal::Component::Buffers, Journal::Context::BufferProcessing,
        "MeshProcessor: initialised — {} vertices, {} indices ({} faces), stride {}",
        mesh_buf->get_vertex_count(),
        mesh_buf->get_index_count(),
        mesh_buf->get_face_count(),
        mesh_buf->m_mesh_data.layout.stride_bytes);
}

References allocate_gpu_buffers(), MayaFlux::Journal::BufferProcessing, MayaFlux::Journal::Buffers, MayaFlux::Buffers::VKBufferProcessor::ensure_initialized(), MayaFlux::Registry::BackendRegistry::get_service(), MayaFlux::Registry::BackendRegistry::instance(), link_index_resources(), MayaFlux::Buffers::VKBufferProcessor::m_buffer_service, m_mesh_buffer, MF_ERROR, MF_INFO, upload_indices(), and upload_vertices().

Here is the call graph for this function: