from_image()

void MayaFlux::Kakshya::TextureContainer::from_image	(	const std::shared_ptr< Core::VKImage > &	image,
		uint32_t	layer = 0
	)

Download pixel data from a VKImage into this container.

Parameters

image	Source GPU texture. Must be initialized and match dimensions.
layer	Array layer index for array textures (default 0).

Blocking. Overwrites the existing pixel buffer. Does not change declared width, height, or format — caller must ensure consistency.

Definition at line 233 of file TextureContainer.cpp.

{
    if (!image || !image->is_initialized()) {
        MF_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "TextureContainer::from_image called with uninitialised image");
        return;
    }
 
    if (layer >= m_data.size()) {
        MF_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "TextureContainer::from_image layer {} out of range ({})", layer, m_data.size());
        return;
    }
 
    const size_t sz = byte_size();
 
    const size_t element_count = static_cast<size_t>(m_width) * m_height * m_channels;
    m_data[layer] = make_empty_storage(m_format, element_count);
 
    auto [ptr, bytes] = variant_bytes_mut(m_data[layer]);
    if (!ptr || bytes != sz) {
        MF_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "TextureContainer::from_image variant size mismatch ({} vs {})", bytes, sz);
        return;
    }
 
    TextureLoom::instance().download_data(image, ptr, sz);
 
    {
        std::unique_lock lock(m_data_mutex);
        m_processed_data[layer] = m_data[layer];
    }
 
    update_processing_state(ProcessingState::READY);
 
    MF_DEBUG(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
        "TextureContainer: downloaded {} bytes from VKImage", sz);
}

References image, MF_DEBUG, MF_ERROR, and ptr.