OptionalonFinalize: () => voidOne-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.
Tear down a partial ZIP without delivering an artifact.
Optional callback invoked from finalize() so the panel can flip its
isEXRSequenceRecordingflag back to false. Plumbed as a callback rather than a direct field write so the driver stays decoupled from the panel.