フィット
fit
fit パラメータは、w と h の両方が指定された場合に動画をどのようにリサイズするかを制御します。どちらか一方の寸法のみの場合、全モードがアスペクト比を維持してリサイズします。
| 値 | 動作 | 歪み | 出力サイズ |
|---|---|---|---|
scale（デフォルト） | w×h に正確にストレッチ | アスペクト比が異なる場合あり | 正確 |
crop | 対象アスペクトにセンタークロップ後スケール | なし | 正確 |
clip | w×h 内にフィット、アスペクト比を維持 | なし | ≤ 要求値 |
max | clip と同様だが、ソースを超える拡大なし | なし | ≤ 要求値かつ ≤ ソース |
fill | 内側にフィット後、背景で正確な w×h にパディング | なし | 正確 |
fillmax | fill と同様だが、フォアグラウンドの拡大なし | なし | 正確 |
smart-crop | AI被写体追跡クロップ | なし | 正確 |
scale
デフォルトの動作です。動画を要求された寸法に正確にストレッチします。アスペクト比が異なる場合、動画が歪みます。歪みなしにリサイズするには他の fit モードを使用してください。
crop
対象ボックスを埋めるように動画をスケールし、超過分をセンタークロップします。出力は正確に w×h で、歪みもバーもありません。
クロップをエッジや特定の点に向けるには、crop グラビティパラメータ（例: crop=top）、または crop=focalpoint と fp-x / fp-y を使用してください。video-center-crop=true は fit=crop のレガシーエイリアスです。
clip
フレーム全体をボックス内に収め、アスペクト比を維持します。クロップもパディングもなし：一方の軸が要求より小さくなります。正確な寸法にパディングするには fit=fill を使用してください。
max
clip と同様ですが、要求されたボックスよりも小さいソースを拡大しません。
fill
フレーム全体をボックス内に収め（clip と同様）、余白を埋めて正確な w×h の出力を生成します。デフォルトはソリッド黒背景です。人気の「ぼかし背景」には fill=blur、ブランド背景画像には fill=image、ソリッドカラーの変更には fill-color を使用してください。
fit=fillmax は同一ですが、フォアグラウンドをソース解像度を超えて拡大しません。
smart-crop
機能の有効化
このパラメータは、ソースの 高度な設定 で無効化または有効化できます。
すべてのレンダリング機能はデフォルトで有効になっています。
AI被写体追跡クロップモードを有効にします。動画内の注目領域を自動検出し、指定された w×h にクロップして塗りつぶします。被写体がフレームから外れた場合、クロップウィンドウが調整されます。