動画スタビライズズーム
video-stabilize-zoom
スタビライゼーションによって生じる移動する枠を隠すクロップズームを制御します。
スタビライゼーションがカメラの動きをキャンセルすると、フレームが枠の内側で揺れます。クロップインでその枠が出力に現れないよう隠します。video-stabilize-zoom でそのクロップインの決め方を制御します。
| 値 | 効果 |
|---|---|
auto (デフォルト) | クリップの実際の補正量に合わせた最小のズームを自動選択 |
0 | ズームを無効にして黒枠を表示 (診断用途に便利) |
1 – 30 | 固定クロップイン率（%）；バッチ処理で一定のフレーミングを確保 |
auto はクリップが実際に必要とする量を測定し、補正枠をちょうど隠す程度だけクロップします。
固定の整数値 (1–30) は、実際の補正量に関係なくクロップイン率を固定します。異なるクリップのバッチ処理で一定のフレーミングが必要な場合に使用します。
0 はクロップインを無効にし、補正による黒枠をそのまま表示します。診断や意図的なスタイルとして使用できます。
無効な値は警告とともに auto にフォールバックします。
video-stabilize 強度との相互作用
video-stabilize の強度値を上げるほど、カメラの動きをより長いウィンドウで平滑化するため、フレームごとの補正量が増えてクロップインも大きくなります。高い強度設定で video-stabilize-zoom を低い固定値にすると、激しい手ブレのあるクリップで枠のちらつきが発生することがあります。auto に任せるか、固定ズーム値を強度に合わせて大きく設定してください。
例
自動ズームでスタビライズ (デフォルト):
https://assets.imgix.net/videos/handheld.mp4?fm=mp4&video-stabilizeバッチ処理で一定の 8% クロップイン:
https://assets.imgix.net/videos/ugc.mp4?fm=mp4&video-stabilize=30&video-stabilize-zoom=8診断用に枠を表示:
https://assets.imgix.net/videos/shaky.mp4?fm=mp4&video-stabilize=100&video-stabilize-zoom=0