extract_frames

:contentReference[oaicite:1]{index=1}

Description

Extracts individual frames from a video file and saves them as image files (typically PNG).
Ideal for analysis, archival, animation workflows, visual debugging, and creating frame-based artwork.

Purpose

extract_frames gives creators a fast and predictable way to output every frame (or selected frames via global videobeaux options) as standalone image files.
This is useful for:

• animation and rotoscoping workflows,
• ML dataset preparation,
• glitch-art and frame-painting processes,
• shot-by-shot inspection or QC,
• archival still-frame extraction.

How It Works

1. Frame Decoding
   Video frames are decoded sequentially.
2. Image Export
   Each frame is exported as its own image file using the globally configured pixel format and image output settings.
3. Naming Convention
   Frames are typically numbered sequentially (e.g., 000001.png, 000002.png, etc.), depending on videobeaux output rules.
4. Output Directory
   The destination directory is defined by global videobeaux settings (--outfile, mapping rules, etc.).

Program Template

videobeaux -P extract_frames \
  -i input.mp4 \
  -o output.mp4

Arguments

• (No program-specific arguments — this tool relies entirely on global videobeaux settings such as image format, numbering, and frame selection.)

Real World Example

videobeaux -P extract_frames \
  -i myvideo.mp4 \
  -o extract_frames_styled.mp4

Technical Notes

• PNG is the default format due to lossless quality, but other formats may be used depending on global configuration.
• Large videos may produce thousands of frames; ensure adequate disk space.
• Frame extraction is decode-limited — higher-resolution videos take longer per frame.
• If frames are dropped or duplicated in the source video stream, extraction will preserve exactly what the decoder receives.
• Good for use ahead of per-frame manipulation tools, compositing, or generative workflows.

Recommended Usage

• Creating frame sequences for animation, compositing, or painting.
• Building datasets for computer vision or machine learning.
• Inspecting motion continuity, exposure behavior, or compression artifacts.
• Generating image sequences for later re-import into editing or FX tools.

Quality Tips

• Use PNG for archival quality; JPG for lightweight previews.
• If color accuracy is critical, set a high-bit-depth pixel format globally (e.g., rgb48le).
• Use SSD storage for significantly faster write speeds on large sequences.
• When extracting for VFX, ensure your project frame rate matches the video’s native frame rate to avoid timing mismatch.