to_image() [2/2]

std::shared_ptr< Core::VKImage > MayaFlux::Kakshya::WindowContainer::to_image

(

const std::shared_ptr< Buffers::VKBuffer > &

staging

)

const

Upload the full surface readback to a new VKImage, reusing a caller-supplied persistent staging buffer.

Allocates the VKImage without pixel data, 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

staging

Host-visible staging VKBuffer sized to at least width * height * bytes_per_pixel.

Returns

Newly created VKImage, or nullptr on failure.

Definition at line 188 of file WindowContainer.cpp.

{
    std::shared_lock lock(m_data_mutex);
 
    if (m_processed_data.empty()) {
        MF_RT_WARN(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "WindowContainer::to_image(staging) — no readback data for '{}'",
            m_window->get_create_info().title);
        return nullptr;
    }
 
    const auto* pixels = std::get_if<std::vector<uint8_t>>(&m_processed_data[0]);
    if (!pixels || pixels->empty()) {
        MF_RT_WARN(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "WindowContainer::to_image(staging) — processed_data[0] is not uint8_t or is empty for '{}'",
            m_window->get_create_info().title);
        return nullptr;
    }
 
    const auto fmt = query_surface_format(m_window);
    const auto img_fmt = surface_format_to_image_format(fmt);
    const uint32_t w = m_structure.get_width();
    const uint32_t h = m_structure.get_height();
 
    auto& loom = Portal::Graphics::TextureLoom::instance();
 
    auto img = loom.create_2d(w, h, img_fmt, nullptr);
    if (!img) {
        MF_RT_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "WindowContainer::to_image(staging) — VKImage allocation failed for '{}'",
            m_window->get_create_info().title);
        return nullptr;
    }
 
    loom.upload_data(img, pixels->data(), pixels->size(), staging);
    return img;
}

References MayaFlux::Journal::ContainerProcessing, MayaFlux::Kakshya::ContainerDataStructure::get_height(), MayaFlux::Kakshya::ContainerDataStructure::get_width(), h, MayaFlux::Portal::Graphics::TextureLoom::instance(), MayaFlux::Journal::Kakshya, lock(), m_data_mutex, m_processed_data, m_structure, m_window, MF_RT_ERROR, MF_RT_WARN, pixels, and MayaFlux::Kakshya::query_surface_format().

Here is the call graph for this function: