write()

void MayaFlux::IO::IOManager::write	(	const std::shared_ptr< Kakshya::SoundStreamContainer > &	container,
		const std::string &	filepath,
		AVCodecID	codec_id = AV_CODEC_ID_NONE
	)

Write a SoundStreamContainer to file in one shot.

Opens a writer, posts the container's full data, closes, and stores the encode future in m_save_tasks. Non-blocking; returns immediately. Container metadata (sample_rate, channels) drives the encoder parameters.

Parameters

container	Source container; any SoundStreamContainer child.
filepath	Output file path.
codec_id	Encoder override; AV_CODEC_ID_NONE = container default.

Definition at line 350 of file IOManager.cpp.

{
    if (!container) {
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "write: null container");
        return;
    }
 
    auto writer = std::make_shared<SoundFileWriter>();
    if (!writer->open(filepath,
            container->get_num_channels(),
            container->get_sample_rate(),
            codec_id)) {
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "write: open failed for '{}': {}", filepath, writer->last_error());
        return;
    }
 
    writer->write(container->get_data());
    auto fut = writer->close();
 
    std::lock_guard lock(m_save_tasks_mutex);
    m_save_tasks.push_back(std::move(fut));
    std::erase_if(m_save_tasks, [](std::future<bool>& f) {
        return f.wait_for(std::chrono::seconds(0)) == std::future_status::ready;
    });
}

References MayaFlux::Journal::FileIO, MayaFlux::Journal::IO, m_save_tasks, m_save_tasks_mutex, and MF_ERROR.