extract_nd_region()

template<typename T >

std::vector< T > MayaFlux::Kakshya::extract_nd_region	(	std::span< const T >	src,
		const Region &	region,
		const std::vector< DataDimension > &	dims
	)

Extract the data described by region from src using the container's dimension descriptors.

Delegates to the existing role-aware extract_region_data machinery so that the region coordinates are interpreted correctly regardless of axis order or modality. The caller decides what the region bounds mean — this function imposes no shape assumption (rectangular, cubic, or otherwise).

For interleaved image data (IMAGE_COLOR / ROW_MAJOR) the channel dimension is included in the walk if the region carries a coordinate for it; if the region has fewer coordinates than dimensions, trailing axes are included in full.

Template Parameters

T	Element type of the source buffer (e.g. uint8_t).

Parameters

src	Flat source buffer in the layout described by dims.
region	N-dimensional bounds; start/end coordinate count may be less than dims.size() — missing trailing axes default to full extent.
dims	Dimension descriptors from the container structure, ordered consistently with the flat buffer layout.

Returns

Flat buffer containing the extracted elements in the same axis order as dims.

Exceptions

std::invalid_argument	if dims is empty or src is smaller than the total element count implied by dims.
std::out_of_range	if any coordinate in region exceeds the corresponding dimension size.

Definition at line 716 of file RegionUtils.hpp.

{
    if (dims.empty()) {
        error<std::invalid_argument>(
            Journal::Component::Kakshya, Journal::Context::Runtime,
            std::source_location::current(),
            "extract_nd_region: dims must not be empty");
    }
 
    uint64_t total = 1;
    for (const auto& d : dims)
        total *= d.size;
 
    if (src.size() < total) {
        error<std::invalid_argument>(
            Journal::Component::Kakshya, Journal::Context::Runtime,
            std::source_location::current(),
            "extract_nd_region: src smaller than total element count implied by dims");
    }
 
    Region clamped = region;
    clamped.start_coordinates.resize(dims.size(), 0);
    clamped.end_coordinates.resize(dims.size());
    for (size_t i = 0; i < dims.size(); ++i) {
        if (i >= region.end_coordinates.size()) {
            clamped.end_coordinates[i] = dims[i].size - 1;
        } else {
            clamped.end_coordinates[i] = std::min(region.end_coordinates[i], dims[i].size - 1);
        }
    }
 
    return extract_region_data<T>(src, clamped, dims);
}

References MayaFlux::Kakshya::Region::end_coordinates, MayaFlux::Journal::Kakshya, MayaFlux::Journal::Runtime, and MayaFlux::Kakshya::Region::start_coordinates.