append_frames()

uint64_t MayaFlux::Kakshya::DynamicSoundStream::append_frames	(	std::span< const double >	data,
		uint32_t	channel = 0
	)

Write one channel at its write head and advance the head.

Linear mode appends after the last frame written, growing the stream if auto-resize is on. Circular mode wraps at capacity and overwrites the oldest frames; a block larger than the capacity keeps only its newest frames. Each channel has its own head, so writing every channel of a stream once per cycle keeps them aligned.

Parameters

data	Samples for one channel.
channel	Channel to write.

Returns

Number of frames written.

Definition at line 221 of file DynamicSoundStream.cpp.

{
    if (data.empty() || channel >= get_num_channels()) {
        return 0;
    }
 
    if (m_write_heads.size() < get_num_channels()) {
        m_write_heads.resize(get_num_channels(), 0);
    }
 
    uint64_t& head = m_write_heads[channel];
 
    if (!m_is_circular) {
        const uint64_t written = write_frames(data, head, channel);
        head += written;
        return written;
    }
 
    if (data.size() > m_circular_capacity) {
        const uint64_t skip = data.size() - m_circular_capacity;
        head = (head + skip) % m_circular_capacity;
        data = data.subspan(skip);
    }
 
    const uint64_t first = std::min<uint64_t>(data.size(), m_circular_capacity - head);
    uint64_t written = write_frames(data.subspan(0, first), head, channel);
 
    if (first < data.size()) {
        written += write_frames(data.subspan(first), 0, channel);
    }
 
    head = (head + data.size()) % m_circular_capacity;
    return written;
}

References MayaFlux::Kakshya::SoundStreamContainer::get_num_channels(), m_circular_capacity, m_is_circular, m_write_heads, and write_frames().

Here is the call graph for this function: