load_audio_bounded()

std::shared_ptr< Kakshya::DynamicSoundStream > MayaFlux::IO::IOManager::load_audio_bounded	(	const std::string &	filepath,
		uint64_t	max_frames = 0,
		bool	truncate = false
	)

Load an audio file into a fully resident, size-bounded DynamicSoundStream.

Applies the engine sample rate, ROW_MAJOR layout, and the engine buffer size as the CursorAccessProcessor block size. The result is ready for use with StreamSliceProcessor without any further configuration.

Parameters

filepath	Path to the audio file.
max_frames	Upper bound on frame count. 0 defaults to 5 s at the engine sample rate inside SoundFileReader::load_bounded.
truncate	If true, silently truncate files exceeding max_frames.

Returns

Configured DynamicSoundStream, or nullptr on failure.

Definition at line 278 of file IOManager.cpp.

{
    auto reader = std::make_shared<IO::SoundFileReader>();
 
    if (!reader->can_read(filepath)) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "IOManager::load_bounded: unsupported format '{}'", filepath);
        return nullptr;
    }
 
    reader->set_target_sample_rate(m_sample_rate);
 
    auto stream = reader->load_bounded(filepath, max_frames, truncate);
    if (!stream) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "IOManager::load_bounded: failed for '{}'", filepath);
        return nullptr;
    }
 
    stream->set_memory_layout(Kakshya::MemoryLayout::ROW_MAJOR);
 
    m_audio_readers.push_back(std::move(reader));
 
    return stream;
}

References MayaFlux::Journal::API, MayaFlux::Journal::FileIO, m_audio_readers, m_sample_rate, MF_ERROR, and MayaFlux::Kakshya::ROW_MAJOR.