get_frame()

std::span< const double > MayaFlux::Kakshya::TextureContainer::get_frame ( uint64_t  frame_index ) const

overridevirtual

Returns a normalized double view of one pixel row.

Maps frame_index to row index (SPATIAL_Y). Each uint8_t sample is normalized to [0.0, 1.0]. The returned span is backed by m_frame_cache and remains valid until the next call to get_frame() or clear().

Parameters

frame_index

Row index in [0, height).

Returns

Span of width * channels doubles, or empty if out of range.

Implements MayaFlux::Kakshya::NDDataContainer.

Definition at line 450 of file TextureContainer.cpp.

{
    if (frame_index >= m_height)
        return {};
 
    std::shared_lock lock(m_data_mutex);
    if (m_data.empty())
        return {};
 
    const size_t row_elems = static_cast<size_t>(m_width) * m_channels;
    const size_t offset = static_cast<size_t>(frame_index) * row_elems;
 
    m_frame_cache.resize(row_elems);
    for (size_t i = 0; i < row_elems; ++i)
        m_frame_cache[i] = read_normalized_at(m_data[0], m_format, offset + i);
 
    return { m_frame_cache.data(), m_frame_cache.size() };
}