get_frame()

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

overridevirtual

Get a single frame of data efficiently.

Parameters

frame_index

Index of the frame (in the temporal dimension)

Returns

Span of data representing one complete frame

Implements MayaFlux::Kakshya::NDDataContainer.

Definition at line 190 of file SoundStreamContainer.cpp.

{
    if (frame_index >= m_num_frames) {
        return {};
    }
 
    const auto& spans = get_span_cache();
 
    if (m_structure.organization == OrganizationStrategy::INTERLEAVED) {
        if (spans.empty())
            return {};
 
        auto frame_span = extract_frame<double>(spans[0], frame_index, m_num_channels);
        return { frame_span.data(), frame_span.size() };
    }
 
    static thread_local std::vector<double> frame_buffer;
    auto frame_span = extract_frame<double>(spans, frame_index, frame_buffer);
    return { frame_span.data(), frame_span.size() };
}

References get_span_cache(), MayaFlux::Kakshya::INTERLEAVED, m_num_channels, m_num_frames, m_structure, and MayaFlux::Kakshya::ContainerDataStructure::organization.

Here is the call graph for this function: