capture_window()

uint32_t MayaFlux::IO::IOManager::capture_window	(	const std::shared_ptr< Core::Window > &	window,
		const std::string &	filepath,
		double	frame_rate,
		AVCodecID	codec_id = AV_CODEC_ID_NONE
	)

Begin continuous capture of a window's rendered frames to a file.

Delegates to VideoFileWriter::record(). The encoder is opened lazily on the first delivered frame so pixel format and dimensions come from the live swapchain. Returns an opaque capture id for use with stop_video_capture().

Returns 0 if the window is null or record() fails.

Parameters

window	Window whose swapchain frames will be captured.
filepath	Output file path. Extension determines container format.
frame_rate	Nominal frame rate written into the container header.
codec_id	Encoder override; AV_CODEC_ID_NONE = container default.

Returns

Capture handle; pass to stop_video_capture() to finalise.

Definition at line 625 of file IOManager.cpp.

{
    if (!window) {
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "capture_window: null window");
        return 0;
    }
 
    auto writer = std::make_shared<VideoFileWriter>();
    if (!writer->record(window, filepath, frame_rate, codec_id)) {
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "capture_window: record failed for '{}': {}", filepath, writer->last_error());
        return 0;
    }
 
    const uint32_t id = m_next_video_capture_id.fetch_add(1, std::memory_order_relaxed);
 
    {
        std::lock_guard lock(m_video_captures_mutex);
        m_video_captures.emplace(id, VideoCaptureState { .writer = writer, .capture_id = id });
        m_video_writers.push_back(writer);
    }
 
    return id;
}

References MayaFlux::Journal::FileIO, MayaFlux::Journal::IO, m_next_video_capture_id, m_video_captures, m_video_captures_mutex, m_video_writers, MF_ERROR, window, and MayaFlux::IO::IOManager::VideoCaptureState::writer.