Class VideoModeDriver

One-time setup. Return false to abort the capture (e.g. no codec supports the request). Drivers that fail here must show the user an explanatory toast before returning false.

Capture one frame. Called once per turntable frame after the animation loop has rendered the rotated camera. May throw on encoder errors — the loop tolerates up to MAX_CONSECUTIVE_ERRORS before aborting.

frameIndex is the OUTPUT sequence index (number of successful captures so far), not the source loop index. With tolerated frame failures the source loop's index advances while the output index stays contiguous — drivers that use this index for timestamps (VideoModeDriver) get gap-free output timing. Drivers that name files use ZipSequenceCapture's own success counter and can ignore this parameter.

Finalize after the loop completes (or aborts via cancel). Called with the actual count of captured frames (may be < totalFrames if the user cancelled or errors triggered an abort).

Tear down a partial encoder without delivering a video. Called by the panel when the offline session is aborted. Idempotent.