動画のリサイズ (ResizeVideo)

概要 (What is it?)

ResizeVideo ノードは、FFmpeg を使用して複数のスケーリングモード（幅基準、高さ基準、パーセンテージ、または幅と高さの直接指定）で動画をリサイズします。アスペクト比を維持しながら背景色でレターボックス（パディング）を追加したり、クロップして全画面にフィットさせたり、目的に応じた柔軟な変形が可能です。

使用する場面 (When would I use it?)

以下のような場面でこのノードを使用します：

正確なパーセンテージ（比率）で動画を拡大・縮小したい場合
アスペクト比を保ったまま、指定した幅や高さに合わせてリサイズしたい場合
パディング（余白補完）やクロップ（切り抜き）を用いて、厳密な解像度（1280x720 など）に動画を適合させたい場合
ワークフロー全体で統一された動画サイズ基準を維持したい場合

使い方 (How to use it)

基本セットアップ

ワークフローに ResizeVideo ノードを追加します
ビデオソースを "video" 入力に接続します
"resize_mode"（リサイズモード）を選択します
選択したモードに応じた寸法パラメータを設定します
ワークフローを実行して動画をリサイズします

パラメータ一覧 (Parameters)

video: リサイズするビデオコンテンツ（VideoArtifact および VideoUrlArtifact をサポート）
resize_mode: リサイズ方式の選択
- width: アスペクト比を維持しながら目標の幅に合わせてリサイズ
- height: アスペクト比を維持しながら目標の高さに合わせてリサイズ
- percentage: 元のサイズに対するパーセンテージ比率でスケーリング
- width and height: 幅と高さを直接指定し、fit_mode で適合させる
target_size: 幅または高さモード時の目標ピクセルサイズ（1〜8000）
percentage: パーセンテージモード時の倍率比率（1〜500、デフォルト: 100）
target_width: 幅と高さモード時の目標幅（ピクセル単位）
target_height: 幅と高さモード時の目標高さ（ピクセル単位）
fit_mode: 目標解像度に対する画像の適合方法（width and height モード時）
- fit: アスペクト比を維持し、余白部分にパディング（黒帯等）を追加
- fill: アスペクト比を維持し、画面全体を埋めるように余剰部分をクロップ
- stretch: アスペクト比を無視して目標サイズいっぱいに引き伸ばし
background_color: fit モード時の余白（レターボックス）の背景色（16進数カラーコード）
scaling_algorithm: リサンプリングに使用する補間アルゴリズム（デフォルト: "bicubic"）
- neighbor, bilinear, bicubic, lanczos
lanczos_parameter: Lanczos 補間のチューニングパラメータ（1.0〜10.0、デフォルト: 3.0。scaling_algorithm が "lanczos" の場合のみ有効）

出力 (Outputs)

resized_video: リサイズされたビデオコンテンツ（他のノードに接続可能）

使用例 (Example)

アスペクト比を保ち、黒帯を付加して動画を 1280x720（720p HD）にリサイズする例：

resize_mode を width and height に設定
target_width を 1280 に設定
target_height を 720 に設定
fit_mode を fit に設定
background_color を #000000（黒）に設定
実行すると、映像の縦横比を歪めることなく綺麗な 720p 動画にリサイズされます

重要な注意点 (Important Notes)

高速かつ高品質な動画処理のために FFmpeg を使用しています
コーデック（H.264 等）の仕様制約を満たすため、計算後の寸法は自動的に 2 の倍数（偶数ピクセル）に微調整されます
元のオーディオトラックはそのまま保持されます