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 refresh its cached VKImage.

Performs a CPU-side crop via extract_region_data and uploads it. Region coordinates follow IMAGE_COLOR convention: [SPATIAL_Y, SPATIAL_X]. The returned image dimensions are derived from the region extent. The image is retained by the container and refreshed for any later region with the same width and height.

Parameters

region

Pixel rectangle. Must have at least 2 coordinates.

Returns

VKImage sized to the region, or nullptr on failure.

Definition at line 277 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;
    }
 
    if (region.start_coordinates[0] > region.end_coordinates[0]
        || region.start_coordinates[1] > region.end_coordinates[1]) {
        MF_RT_ERROR(Journal::Component::Kakshya, Journal::Context::ContainerProcessing,
            "WindowContainer::region_to_image : inverted region");
        return nullptr;
    }
 
    auto pixels = snapshot_pixels();
    if (!pixels)
        return nullptr;
 
    std::vector<uint8_t> cropped;
    try {
        cropped = extract_region_data<uint8_t>(
            std::span<const uint8_t> { pixels->pixels.data(), pixels->pixels.size() },
            region,
            pixels->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;
    }
 
    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 key = std::pair { rw, rh };
    const auto format = get_image_format();
    Memory::SerializedSeqlockWriteGuard image_guard(m_image_cache_lock);
    return Portal::Graphics::TextureLoom::instance().refresh_cached_image(
        m_region_images[key], sampled_image_key(rw, rh, format), cropped);
}

References MayaFlux::Journal::ContainerProcessing, MayaFlux::Kakshya::Region::end_coordinates, format, get_image_format(), MayaFlux::Portal::Graphics::TextureLoom::instance(), MayaFlux::Journal::Kakshya, m_image_cache_lock, m_region_images, m_window, MF_RT_ERROR, pixels, MayaFlux::Portal::Graphics::TextureLoom::refresh_cached_image(), snapshot_pixels(), and MayaFlux::Kakshya::Region::start_coordinates.

Here is the call graph for this function: