start()

void MayaFlux::IO::VolumeCapture::start	(	uint32_t	max_frames = 0,
		uint64_t	frame_interval = 1
	)

Spawn the capture routine, resetting the frame counter.

Parameters

max_frames	Stop after this many frames. Zero records until stop(), which at tens of megabytes per frame fills a disk given time.
frame_interval	Frames between captures. One records every frame; higher values thin the sequence, which is usually what a large lattice wants.

Definition at line 287 of file VolumeTransfer.cpp.

{
    if (!m_volume) {
        MF_ERROR(Journal::Component::IO, Journal::Context::FileIO,
            "VolumeCapture: cannot start, null volume");
        return;
    }
 
    stop();
 
    m_frame = 0;
    m_max_frames = max_frames;
    m_recording = true;
    m_task_name = "volume_capture_"
        + std::to_string(g_next_capture_id.fetch_add(1, std::memory_order_relaxed));
 
    auto routine = [](Vruta::TaskScheduler&,
                       VolumeCapture* capture,
                       uint64_t interval) -> Vruta::GraphicsRoutine {
        auto& p = co_await Kriya::GetGraphicsPromise {};
        while (!p.should_terminate && capture->capture_frame()) {
            co_await Kriya::FrameDelay { .frames_to_wait = interval };
        }
        capture->m_recording = false;
    };
 
    m_scheduler.add_task(
        std::make_shared<Vruta::GraphicsRoutine>(
            routine(m_scheduler, this, frame_interval)),
        m_task_name, false);
 
    MF_INFO(Journal::Component::IO, Journal::Context::FileIO,
        "VolumeCapture: recording '{}' every {} frame(s), {}",
        m_pattern, frame_interval,
        max_frames == 0 ? std::string("unbounded")
                        : std::format("{} frames", max_frames));
}

References MayaFlux::Vruta::TaskScheduler::add_task(), MayaFlux::Journal::FileIO, MayaFlux::Kriya::FrameDelay::frames_to_wait, MayaFlux::Journal::IO, m_frame, m_max_frames, m_pattern, m_recording, m_scheduler, m_task_name, m_volume, MF_ERROR, MF_INFO, and stop().

Here is the call graph for this function: