pyramid_layout()

PyramidLayout MayaFlux::Kinesis::Vision::pyramid_layout ( uint32_t  w, uint32_t  h, uint32_t  requested, uint32_t  min_extent = 16  )

inline

Place up to requested pyramid levels for a w x h base image.

Levels stop early when the next one would have a side under min_extent, so small images get fewer levels rather than degenerate ones. requested is clamped to [1, PyramidLayout::k_max_levels].

Parameters

w	Base width in pixels.
h	Base height in pixels.
requested	Desired number of levels including the base.
min_extent	Smallest side a level may have.

Returns

Layout with level 0 at the origin and the rest stacked to its right.

Definition at line 63 of file Pyramid.hpp.

{
    PyramidLayout layout;
    layout.level[0] = { .ox = 0, .oy = 0, .w = w, .h = h };
 
    const uint32_t wanted = std::clamp(requested, 1U, PyramidLayout::k_max_levels);
    uint32_t count = 1;
    uint32_t column_h = 0;
    uint32_t column_w = 0;
 
    while (count < wanted) {
        const auto& above = layout.level[count - 1];
        const uint32_t lw = (above.w + 1U) / 2U;
        const uint32_t lh = (above.h + 1U) / 2U;
        if (std::min(lw, lh) < min_extent)
            break;
 
        layout.level[count] = { .ox = w, .oy = column_h, .w = lw, .h = lh };
        column_h += lh;
        column_w = std::max(column_w, lw);
        ++count;
    }
 
    layout.levels = count;
    layout.atlas_w = w + column_w;
    layout.atlas_h = std::max(h, column_h);
    return layout;
}

References MayaFlux::Kinesis::Vision::PyramidLayout::atlas_h, MayaFlux::Kinesis::Vision::PyramidLayout::atlas_w, count, h, MayaFlux::Kinesis::Vision::PyramidLayout::k_max_levels, MayaFlux::Kinesis::Vision::PyramidLayout::level, and MayaFlux::Kinesis::Vision::PyramidLayout::levels.

Referenced by MayaFlux::Yantra::VisionGpuExecutor::build_flow_pyramid().

Here is the caller graph for this function: