gather_frames()

void MayaFlux::Kakshya::SoundStreamContainer::gather_frames	(	std::span< const uint64_t >	frames,
		std::span< double >	out
	)		const

Copy arbitrary frames into a caller-owned buffer without allocating.

Parameters

frames	Frame indices, in any order, repeats allowed.
out	Receives frames.size() * channel count values, frame-major. Indices past the end of the stream yield zeros.

Definition at line 185 of file SoundStreamContainer.cpp.

{
    std::ranges::fill(out, 0.0);
 
    const uint64_t channels = m_num_channels;
    const auto& spans = get_span_cache();
    if (spans.empty() || channels == 0) {
        return;
    }
 
    const bool interleaved = m_structure.organization == OrganizationStrategy::INTERLEAVED;
    const size_t count = std::min<size_t>(frames.size(), out.size() / channels);
 
    for (size_t k = 0; k < count; ++k) {
        const uint64_t frame = frames[k];
        if (frame >= m_num_frames) {
            continue;
        }
 
        double* dst = out.data() + k * channels;
 
        if (interleaved) {
            const uint64_t base = frame * channels;
            if (base + channels <= spans[0].size()) {
                std::copy_n(spans[0].data() + base, channels, dst);
            }
            continue;
        }
 
        for (uint64_t c = 0; c < channels && c < spans.size(); ++c) {
            if (frame < spans[c].size()) {
                dst[c] = spans[c][frame];
            }
        }
    }
}

References channels, count, dst, get_span_cache(), MayaFlux::Kakshya::INTERLEAVED, m_num_channels, m_num_frames, m_structure, MayaFlux::Kakshya::ContainerDataStructure::organization, out, and size.

Referenced by MayaFlux::Kakshya::DynamicSoundStream::snapshot().

Here is the call graph for this function:

Here is the caller graph for this function: