Capture plans

A CapturePlan expands enabled shots into a deterministic queue before Unity state changes. Expansion takes the Cartesian product of scene, camera variant, quality, locale, state variant, and output profile. Duplicate values are collapsed and the preview is sorted deterministically.

Sources and ranges

CaptureShot.SourceKind supports Game View, targeted camera, RenderTexture, 360, image sequence, movie, audio, and HDRP AOV Recorder paths where Recorder exposes them. Ranges can use frames, time, or Timeline. Frame cadence comes from the shot range and selected profile.

Preparation order

Built-in descriptors use these provider IDs:

• scene.load
• gameobject.active
• quality.select
• locale.select
• timeline.position

Custom ICapturePreparationStep instances run by ascending Order. Cleanup extensions run by descending order. Every preparation and cleanup result is recorded with warnings or a retryable failure.

Readiness

After warm-up, every named readiness probe must remain ready for the complete stable-ready duration. A probe can report not-ready without failing. Timeout and cancellation are distinct outcomes. Retries create no final output until a staged result passes verification.

Takes

Output names combine the sanitized shot, camera, quality, locale, state, and profile identities with take001, take002, and later numbers. An existing file or directory advances the take number. Finalization refuses overwrite even if the destination appears after queue expansion.