create_tap_set() [1/2]

MAYAFLUX_API Kriya::TapSetBuilder MayaFlux::create_tap_set	(	const std::string &	filepath,
		uint32_t	num_samples = 48000 *5,
		bool	truncate = true
	)

Begin describing several taps that read one audio file.

Loads the file like create_sampler and returns a builder. Each tap() adds a tap with its own entry time, speed, direction, level and channel, and start() plays them. Keep the resulting TapSet alive for as long as it should sound.

auto taps = MayaFlux::create_tap_set("res/h.wav")
    .tap().speed(1.0)
    .tap().enters_after(2.0).speed(3.0 / 2.0).level(0.8)
    .tap().enters_after(4.0).speed(2.0).backward().level(0.6)
    .start();

Parameters

filepath	Path to the audio file (any FFmpeg-supported format).
num_samples	Number of samples to load from the file (default: 48000 * 5).
truncate	Truncate stream to num_samples if true (default: true).

Returns

Builder. If the file cannot be loaded, start() returns an empty TapSet.

Definition at line 135 of file Rigs.cpp.

{
    auto stream = get_io_manager()->load_audio_bounded(filepath, num_samples, truncate);
 
    if (!stream) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "create_tap_set: failed to load '{}'", filepath);
    }
 
    return create_tap_set_from_stream(std::move(stream));
}

References MayaFlux::Journal::API, create_tap_set_from_stream(), MayaFlux::Journal::FileIO, get_io_manager(), MF_ERROR, and stream.

Here is the call graph for this function: