region_to_image()

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

(

const Region &

region

)

const

Crop a region from the last readback and upload it as a VKImage.

Performs a CPU-side crop via extract_region_data; no additional GPU work beyond the readback that populated processed_data[0]. Region coordinates follow IMAGE_COLOR convention: [SPATIAL_Y, SPATIAL_X]. The returned image dimensions are derived from the region extent.

Parameters

region

Pixel rectangle. Must have at least 2 coordinates.

Returns

VKImage sized to the region, or nullptr on failure.

Definition at line 332 of file WindowContainer.cpp.

{
    if (region.start_coordinates.size() < 2 || region.end_coordinates.size() < 2) {
        MF_RT_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "WindowContainer::region_to_image — region must have at least 2 coordinates (SPATIAL_Y, SPATIAL_X)");
        return nullptr;
    }
 
    std::shared_ptr<Core::VKImage> img;
    seqlock_read_void(m_data_lock, 8, [&] {
        if (m_processed_data.empty()) {
            MF_RT_WARN(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
                "WindowContainer::region_to_image — no readback data for '{}'",
                m_window->get_create_info().title);
            return;
        }
 
        const auto* src = std::get_if<std::vector<uint8_t>>(&m_processed_data[0]);
        if (!src || src->empty()) {
            MF_RT_WARN(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
                "WindowContainer::region_to_image — processed_data[0] is not uint8_t or is empty for '{}'",
                m_window->get_create_info().title);
            return;
        }
 
        std::vector<uint8_t> cropped;
        try {
            cropped = extract_region_data<uint8_t>(
                std::span<const uint8_t> { src->data(), src->size() },
                region,
                m_structure.dimensions);
        } catch (const std::exception& e) {
            MF_RT_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
                "WindowContainer::region_to_image — crop failed for '{}': {}",
                m_window->get_create_info().title, e.what());
            return;
        }
 
        const auto rh = static_cast<uint32_t>(region.end_coordinates[0] - region.start_coordinates[0] + 1);
        const auto rw = static_cast<uint32_t>(region.end_coordinates[1] - region.start_coordinates[1] + 1);
        const auto img_fmt = surface_format_to_image_format(query_surface_format(m_window));
 
        img = Portal::Graphics::TextureLoom::instance().create_2d(rw, rh, img_fmt, cropped.data());
        if (!img) {
            MF_RT_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
                "WindowContainer::region_to_image — TextureLoom::create_2d failed ({}x{}) for '{}'",
                rw, rh, m_window->get_create_info().title);
        }
    });
 
    return img;
}

References MayaFlux::Journal::ContainerProcessing, MayaFlux::Portal::Graphics::TextureLoom::create_2d(), MayaFlux::Kakshya::ContainerDataStructure::dimensions, MayaFlux::Kakshya::Region::end_coordinates, MayaFlux::Portal::Graphics::TextureLoom::instance(), MayaFlux::Journal::Kakshya, m_data_lock, m_processed_data, m_structure, m_window, MF_RT_ERROR, MF_RT_WARN, MayaFlux::Kakshya::query_surface_format(), and MayaFlux::Kakshya::Region::start_coordinates.

Here is the call graph for this function: