create_samplers()

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 66 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 {};
    }
 
    const uint32_t ch_count = (max_channels == 0)
        ? stream->get_num_channels()
        : std::min(max_channels, stream->get_num_channels());
 
    std::vector<std::shared_ptr<Kriya::SamplingPipeline>> result;
    result.reserve(ch_count);
 
    for (uint32_t i = 0; i < ch_count; ++i)
        result.push_back(create_sampler_from_stream(stream, i, max_dur_ms));
 
    return result;
}

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

Here is the call graph for this function: