動画スタビライズ

GPU アクセラレーションによる2パス光学フロー処理でカメラシェイクを除去します。

video-stabilize はブール値または 0 から 100 の整数強度値を受け付けます。ベアパラメータ (?video-stabilize) または true を指定すると、デフォルト強度 25 でスタビライゼーションが有効になります。整数値でカスタム強度を設定できます。0、false、または解析不能な値はオフになります。

値は拒否されずに補正されます — 無効な値はデフォルト動作にダウングレードされ、警告がログに記録されます。

仕組み

スタビライゼーションは2パス処理です。

1. 軌跡解析。 クリップを一度デコードし、NVIDIA ハードウェア光学フローエンジンがフレームペア間のグローバルモーションを測定します。前景の動体 (人物、車両、水面) やテクスチャのない領域は除外されるため、測定されるパスは被写体ではなくカメラの動きを反映します。
2. ワープ。 カメラパスをローパスフィルターで平滑化し、実際のパスと平滑化パスの差分を GPU 上で各フレームにワープします。HDR ソースはワープを通じて 10-bit 深度を維持します。

インタラクション

• fit=smart-crop — スタビライゼーションでカメラの動きを先にキャンセルし、その後スマートクロップが安定したフレーム上で被写体を追跡します。
• トリム (video-clip-*) — 解析はトリムされた範囲のみで実行されます。
• スピード、オーバーレイ、キャプション、カラー、VFX — すべて通常通り合成されます。
• 静止画、スプライトシート、音声のみ — タイムラインのない出力では警告なしにドロップされます。

スコープ

MP4/WebM、HLS/DASH (ベースパスで1回適用)、アニメーション GIF/WebP に適用されます。静止画、スプライトシート、VTT、音声のみ出力、オーディオグラムでは警告なしにドロップされます。

スタビライゼーションが成功すると、レスポンスヘッダー X-Imgix-Video-Operations に stabilize が記録され、X-Imgix-Video-Stabilized-Duration にエンコード済み動画の長さが記録されます。

例

手持ち映像をデフォルト強度でスタビライズ:

https://assets.imgix.net/videos/handheld.mp4?fm=mp4&video-stabilize

ドローン映像を固定カメラ風に:

https://assets.imgix.net/videos/drone.mp4?fm=mp4&video-stabilize=75