Output Image File

6 VersionsOutput

Encodes Image or VideoFrame inputs to PNG or JPEG and writes them to disk under a prefixed, zero-padded index, optionally subsampling the stream and capping storage to a rolling window of files.

How it fits

Typical backends

Frames annotated by visualize are archived to disk as an evidence trail.

A higher-rate source is subsampled to build an image dataset by keeping only every Nth frame.

Caveats

Hard constraintimage_format accepts only png or jpg (jpeg is treated as jpg); any other value aborts startup, as does setting every_n to zero (use one to save every frame).
I/O contractThe filename index counts saved files rather than received frames, so with a large every_n the index still advances by one per written file.
FallbackA positive max_files turns the directory into a circular buffer whose oldest files are silently overwritten.
Parameter interactioninclude_timestamp is honoured only for video-frame inputs, and preserve_alpha only affects PNG output since JPEG always drops alpha; jpeg_quality and png_compression each apply only to their respective format.
State lifetimeAll configuration is captured once at startup; runtime changes have no effect.

Versions

043fc2dadefault
Automated release
8/1/2026