Video Stabilize Zoom
video-stabilize-zoom
Controls the crop-zoom that hides the moving borders that video stabilization exposes.
When stabilization cancels camera motion it swings the frame inside its borders. A crop-in hides those borders so they never appear in the output. video-stabilize-zoom controls how that crop-in is determined.
| Value | Effect |
|---|---|
auto (default) | Picks the smallest zoom that covers the clip’s actual correction excursions |
0 | Disables the zoom; exposes black borders (useful for diagnostics) |
1 – 30 | Fixed crop-in percent; deterministic framing across a batch |
auto measures what the clip actually needs and crops in just enough to cover the correction borders. This gives the least field-of-view loss for each unique clip.
A fixed integer (1–30) fixes the crop-in percentage regardless of the clip’s actual excursions. Use this when you need consistent framing across a batch of different clips at the cost of cropping in more than strictly necessary on stable clips.
0 disables the crop-in entirely and lets the stabilization correction borders appear as black fill — useful for diagnosing what the stabilizer is correcting without committing to a crop.
Garbage values fall back to auto with a warning.
Interaction with video-stabilize strength
Higher video-stabilize strength values smooth the camera path over a longer window, which requires larger per-frame corrections and therefore more crop-in. If you fix video-stabilize-zoom at a low value while using a high strength, you may see occasional border flickers on clips with severe shake. Let auto adapt, or raise the fixed zoom to match the strength.
Examples
Stabilize with automatic zoom (default):
https://assets.imgix.net/videos/handheld.mp4?fm=mp4&video-stabilizeFixed 8% crop-in for consistent framing across a batch:
https://assets.imgix.net/videos/ugc.mp4?fm=mp4&video-stabilize=30&video-stabilize-zoom=8Expose borders for diagnostics:
https://assets.imgix.net/videos/shaky.mp4?fm=mp4&video-stabilize=100&video-stabilize-zoom=0