get_frames()

void MayaFlux::Kakshya::SoundStreamContainer::get_frames ( std::span< double >  output, uint64_t  start_frame, uint64_t  num_frames  ) const

overridevirtual

Get multiple frames efficiently.

Parameters

output	Buffer to write frames into
start_frame	First frame index
num_frames	Number of frames to retrieve

Implements MayaFlux::Kakshya::NDDataContainer.

Definition at line 209 of file SoundStreamContainer.cpp.

{
    if (start_frame >= m_num_frames || output.empty()) {
        std::ranges::fill(output, 0.0);
        return;
    }
 
    uint64_t frames_to_copy = std::min<size_t>(num_frames, m_num_frames - start_frame);
    uint64_t elements_to_copy = std::min(
        frames_to_copy * m_num_channels,
        static_cast<uint64_t>(output.size()));
 
    auto interleaved_data = get_data_as_double();
    uint64_t offset = start_frame * m_num_channels;
 
    if (offset < interleaved_data.size()) {
        uint64_t available = std::min<size_t>(elements_to_copy, interleaved_data.size() - offset);
        std::copy_n(interleaved_data.begin() + offset, available, output.begin());
 
        if (available < output.size()) {
            std::fill(output.begin() + available, output.end(), 0.0);
        }
    } else {
        std::ranges::fill(output, 0.0);
    }
}

References get_data_as_double(), m_num_channels, and m_num_frames.

Here is the call graph for this function: