to_image() [1/2]

std::shared_ptr< Core::VKImage > MayaFlux::Kakshya::TextureContainer::to_image	(	uint32_t	layer,
		const std::shared_ptr< Buffers::VKBuffer > &	staging
	)		const

Upload one layer to a new VKImage, reusing a caller-supplied staging buffer.

Allocates the VKImage without pixel data (create_2d with nullptr), then uploads via the provided staging buffer, bypassing the per-call VkBuffer allocation inside TextureLoom. Use TextureLoom::create_streaming_staging() to allocate the staging buffer once before the render loop.

Parameters

layer	Array layer index (default 0).
staging	Host-visible staging VKBuffer sized to at least byte_size().

Returns

Newly created VKImage, or nullptr on failure.

Definition at line 407 of file TextureContainer.cpp.

{
    if (layer >= m_data.size()) {
        MF_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "TextureContainer::to_image(staging) layer {} out of range ({})", layer, m_data.size());
        return nullptr;
    }
 
    std::shared_ptr<Core::VKImage> img;
    seqlock_read_void(m_slot_locks[layer], 8, [&] {
        auto [ptr, bytes] = variant_bytes(m_data[layer]);
        if (!ptr || bytes == 0) {
            MF_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
                "TextureContainer::to_image(staging) called on empty/invalid buffer");
            return;
        }
        auto& loom = TextureLoom::instance();
        img = loom.create_2d(m_width, m_height, m_format, nullptr);
        if (!img) {
            MF_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
                "TextureContainer::to_image(staging): VKImage allocation failed");
            return;
        }
        loom.upload_data(img, ptr, bytes, staging);
    });
    return img;
}

References MF_ERROR, and ptr.