create_samplers() [1/2]

MAYAFLUX_API std::vector< std::shared_ptr< Kriya::SamplingPipeline > > MayaFlux::create_samplers	(	const std::string &	filepath,
		uint32_t	num_samples = 48000 *5,
		bool	truncate = true,
		uint64_t	max_dur_ms = 0,
		uint32_t	max_channels = 0
	)

Construct one built SamplingPipeline per channel from an audio file.

Loads the file once into a shared DynamicSoundStream, then constructs one SamplingPipeline per channel. All pipelines share the same stream with no redundant IO. max_channels = 0 uses all channels available in the file.

auto ch = MayaFlux::create_samplers("res/stereo.wav", 48000 * 5);
ch[0]->play(0, ch[0]->slice_from_stream());
ch[1]->play(0, ch[1]->slice_from_stream());

Parameters

filepath	Path to the audio file (any FFmpeg-supported format).
num_samples	Number of samples to load (default: 48000 * 5).
truncate	Truncate stream to num_samples if true (default: true).
max_dur_ms	Optional maximum duration in milliseconds. 0 for infinite.
max_channels	Maximum channels to create pipelines for. 0 = all available.

Returns

Vector of built SamplingPipelines, one per channel. Empty on load failure.

Definition at line 106 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_samplers: failed to load '{}'", filepath);
        return {};
    }
 
    return samplers_from_stream(stream, max_dur_ms, max_channels);
}

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

Here is the call graph for this function: