on_attach()

void MayaFlux::Buffers::TransferProcessor::on_attach ( std::shared_ptr< Buffer >  )

overridevirtual

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 94 of file TransferProcessor.cpp.

{
    if (m_direction == TransferDirection::AUDIO_TO_GPU) {
        if (auto vk_buffer = std::dynamic_pointer_cast<VKBuffer>(buffer)) {
            if (!validate_audio_to_gpu(vk_buffer)) {
                MF_ERROR(Journal::Component::Buffers, Journal::Context::BufferProcessing,
                    "TransferProcessor not configured for the attached VKBuffer instance (audio→gpu).");
                return;
            }
 
            if (!vk_buffer->is_initialized()) {
                MF_ERROR(Journal::Component::Buffers, Journal::Context::BufferProcessing,
                    "VKBuffer not initialized - register with BufferManager first.");
                return;
            }
 
            if (!vk_buffer->is_host_visible()) {
                auto it = m_staging_map.find(vk_buffer);
                if (it == m_staging_map.end()) {
                    MF_WARN(Journal::Component::Buffers, Journal::Context::BufferProcessing,
                        "No staging buffer configured for device-local VKBuffer. Create one for efficient transfers.");
                }
            }
        } else {
            error<std::invalid_argument>(Journal::Component::Buffers, Journal::Context::BufferProcessing,
                std::source_location::current(),
                "TransferProcessor (audio→gpu) requires VKBuffer attachment");
        }
 
    } else if (m_direction == TransferDirection::GPU_TO_AUDIO) {
        if (auto audio_buffer = std::dynamic_pointer_cast<AudioBuffer>(buffer)) {
            if (!validate_gpu_to_audio(audio_buffer)) {
                MF_ERROR(Journal::Component::Buffers, Journal::Context::BufferProcessing,
                    "TransferProcessor not configured for the attached AudioBuffer instance (gpu→audio).");
                return;
            }
        } else {
            error<std::invalid_argument>(Journal::Component::Buffers, Journal::Context::BufferProcessing,
                std::source_location::current(),
                "TransferProcessor (gpu→audio) requires AudioBuffer attachment");
        }
    }
}

References MayaFlux::Buffers::AUDIO_TO_GPU, MayaFlux::Journal::BufferProcessing, MayaFlux::Journal::Buffers, MayaFlux::Buffers::GPU_TO_AUDIO, m_direction, m_staging_map, MF_ERROR, MF_WARN, validate_audio_to_gpu(), and validate_gpu_to_audio().

Here is the call graph for this function: