create_ring()

MAYAFLUX_API std::shared_ptr< Kakshya::DynamicSoundStream > MayaFlux::create_ring	(	double	seconds,
		uint32_t	channels = 1
	)

Make a circular stream that keeps the most recent seconds of a signal.

The stream runs at the engine sample rate. Fill it with record_into and read it with taps that use lag, or copy its recent past with snapshot.

Parameters

seconds	How much of the past to keep.
channels	Number of channels.

Returns

The ring, or nullptr if it would be empty.

Definition at line 199 of file Rigs.cpp.

{
    const uint32_t rate = Config::get_sample_rate();
    const auto capacity = static_cast<uint64_t>(seconds * static_cast<double>(rate));
 
    if (capacity == 0 || channels == 0) {
        MF_ERROR(Journal::Component::API, Journal::Context::Configuration,
            "create_ring: {} seconds on {} channels is empty", seconds, channels);
        return nullptr;
    }
 
    auto ring = std::make_shared<Kakshya::DynamicSoundStream>(rate, channels);
    ring->enable_circular_buffer(capacity);
    return ring;
}

References MayaFlux::Journal::API, channels, MayaFlux::Journal::Configuration, MayaFlux::Config::get_sample_rate(), MF_ERROR, and rate.

Here is the call graph for this function: