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 342 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::region_to_image — no readback data for '{}'",
            m_window->get_create_info().title);
        return nullptr;
    }
 
    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 nullptr;
    }
 
    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 nullptr;
    }
 
    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;
    }
 
    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 fmt = query_surface_format(m_window);
    const auto img_fmt = surface_format_to_image_format(fmt);
 
    auto 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, lock(), m_data_mutex, 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: