Interface OfflineCaptureDriver

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).

Optional: signal whether the driver wants the loop to abort early (e.g. ZIP disk write failed and continuing would be pointless). Polled each iteration.

Optional partial-resource cleanup hook. Called from the panel's finally block when:

• setup completed but capture/finalize threw, OR
• the offline session was aborted (dispose / user cancel). Drivers should release encoder/zip/file resources without downloading or toasting "saved". Distinct from finalize, which is the success path that delivers the artifact.