再生速度の変更 (ChangeSpeed)

概要 (What is it?)

ChangeSpeed ノードは、動画の再生速度を変更します。FFmpeg の setpts フィルタを使用して映像のタイミングを調整し、それに合わせて音声（オーディオ）の速度も自動調整（atempo）するため、音ズレを起こさず滑らかな速度変更が可能です。

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

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

• 早送り（ファストモーション）効果を作りたい場合（例: 2倍速、3倍速）
• スローモーション効果を作りたい場合（例: 0.5倍速、0.25倍速）
• 長い動画を短時間で確認・レビューしたい場合
• 素早い動きをコマ送り・スローでじっくり分析したい場合
• タイムラプス風の映像を作成したい場合
• 映像のテンポやリズムを調整したい場合

使い方 (How to use it)

基本セットアップ

1. ワークフローに ChangeSpeed ノードを追加します
2. ビデオソースを "video" 入力に接続します
3. 目的の再生速度倍率（speed）を設定します
4. ワークフローを実行して再生速度を変更します

パラメータ一覧 (Parameters)

• video: 速度を変更する対象のビデオコンテンツ（VideoArtifact および VideoUrlArtifact をサポート）

• speed: 再生速度の倍率（0.1〜10.0倍、デフォルト: 1.0）

  • 0.1: 10倍遅い（超スローモーション）
  • 0.5: 2倍遅い（標準スローモーション）
  • 1.0: 通常速度（デフォルト）
  • 2.0: 2倍速（早送り）
  • 5.0: 5倍速（高速早送り）
  • 10.0: 10倍速（最大速度・タイムラプス）

• include_audio: 出力ファイルに音声を含めるかどうか（デフォルト: true）

  • 有効: 映像の速度に合わせて音声のテンポも自動調整されます
  • 無効: 音声トラックを削除し、無音（ミュート）動画として出力します

• processing_speed: 処理速度と出力品質のバランス（デフォルト: "balanced"）

  • fast: 最速処理、品質は控えめ（ultrafast プリセット、CRF 30）
  • balanced: 速度と品質のバランス（medium プリセット、CRF 23）
  • quality: 最高品質、処理時間は長め（slow プリセット、CRF 18）

出力 (Outputs)

• video: 再生速度が変更された動画（他のノードに接続可能）

使用例 (Example)

動画を 3 倍速にしてファストモーション効果を作成する例：

1. ワークフローに ChangeSpeed ノードを追加します
2. LoadVideo ノードからのビデオ出力を ChangeSpeed の "video" 入力に接続します
3. 3 倍速で再生するため "speed" を 3.0 に設定します
4. 音声も含めて 3 倍速にするため "include_audio" は有効（デフォルト）のままにします
5. ワークフローを実行すると、映像と音声が同期して 3 倍速になった動画が生成されます
6. 出力ファイル名は {original_filename}_speed3.0.{format} となります

重要な注意点 (Important Notes)

• 高品質なタイムスタンプ変更のために FFmpeg の setpts フィルタを使用しています
• 音声は atempo フィルタによって自動的に伸縮され、ピッチ（音高）を保ちながら速度だけが調整されます
• 極端な速度変更（過度のスローや超高速再生）の場合、オーディオの音質に歪みが生じることがあります
• include_audio を無効化すると、完全な無音動画が作成されます

おすすめの倍率設定 (Speed Examples)

• 0.25x: 4倍スロー - スポーツや素早いアクションの分析に最適
• 0.5x: 2倍スロー - 定番のスローモーション演出
• 1.0x: 等倍 - 変更なし
• 2.0x: 2倍速 - テンポの良い早送り
• 3.0x: 3倍速 - 作業風景などのクイック表示
• 5.0x: 5倍速 - タイムラプス的な演出