open()

bool MayaFlux::IO::SoundFileWriter::open	(	const std::string &	filepath,
		uint32_t	channels,
		uint32_t	sample_rate,
		AVCodecID	explicit_codec
	)

Open the output file and spawn the worker thread.

Format is inferred from the filepath extension (wav, flac, ogg, mp4, mkv…). Pass explicit_codec to override the container's default audio codec.

Parameters

filepath	Destination file path. Extension determines container.
channels	Number of interleaved channels in all submitted data.
sample_rate	PCM sample rate in Hz.
explicit_codec	Encoder override; AV_CODEC_ID_NONE = container default.

Returns

True if the worker started successfully.

Definition at line 46 of file SoundFileWriter.cpp.

{
    if (m_open.load(std::memory_order_acquire)) {
        set_error("open() called while already open");
        return false;
    }
 
    m_channels = channels;
    m_close_promise = std::promise<bool> {};
    m_close_future = m_close_promise.get_future().share();
    m_closing.store(false, std::memory_order_release);
 
    m_worker = std::thread(&SoundFileWriter::worker_loop, this,
        filepath, channels, sample_rate, explicit_codec);
 
    constexpr int k_spin_ms = 500;
    constexpr int k_sleep_us = 500;
    for (int i = 0; i < (k_spin_ms * 1000 / k_sleep_us); ++i) {
        if (m_open.load(std::memory_order_acquire))
            return true;
        std::this_thread::sleep_for(std::chrono::microseconds(k_sleep_us));
    }
 
    if (m_worker.joinable())
        m_worker.join();
    return false;
}

References m_channels, m_close_future, m_close_promise, m_closing, m_open, m_worker, set_error(), and worker_loop().

Here is the call graph for this function: