ComfyUI-Cadence-Retime: MiniMax H3向けTwixtorスタイルのスピードランプ

Hud224がComfyUI-Cadence-Retime（GitHub）をリリースしました。これは、不均一な動画カデンスを解析し、可変の小数フレームリマップをIMAGEバッチに直接適用するComfyUIノードパックです。

Twixtorスタイルのスピードランプとモーションの線形化をComfyUI内で実現します。After Effectsも、外部の動画デコーダーも、CSVを介した往復処理も必要ありません。

このパックはMiniMax H3ワークフロー向けに作られました。H3はモデルに組み込まれたスピードランプがよく指摘されるモデルで、クリップは多くの場合、ゆっくり始まり、加速し、その後落ち着く動きになります。Cadence Retimeはそのモーションを一定のスクリーン移動に正規化し、ショット全体に独自のスピードカーブを描くこともできます。

Cadence Retimeノード：Cadence:プレフィックス配下のモーション解析、マップビルダー、適用ノード。

機能

• 不均一なモーションの線形化：メモリ内のオプティカルフロー解析が、読み込んだIMAGEバッチからスクリーン変位を測定し、単調な小数ソースフレームマップを構築します。gentle、standard、strongモードは段階的に一定のスクリーン移動へ近づけます。
• クリエイティブなリタイムの構築：3つのマップビルダーを備えています。Retime Preset（リニア、イーズイン/アウト、スローミドル）、Source-Time Curve（出力時間からソース時間への直接マッピング）、Speed Curve（0.25倍から4倍の再生速度を編集可能なグラフ、対数スケール）。
• 正確なフレームのサンプリング：整数フレーム位置は常に未加工のソースバッチから取得され、小数フレーム位置のみがオプションの高密度RIFE/GMFSS補間バッチからサンプリングされるため、リタイムされていないフレームはシャープなまま維持されます。
• 音声同期の維持：Cadence: Apply Retime + Audioは、同期バリスピード（ピッチがスピードに追従）を使用して同じピクチャーマップで音声トラックをリタイムするか、音声をそのままパススルーします。
• レガシーフレームマップのインポート：テキスト、JSON、CSVコンテンツ、ローカルCSVパス、またはCADENCE_MAPの直接接続に対応します。

インタラクティブなスピードカーブエディター：中央ラインより上は速く再生され、下は遅く再生されます。

推奨ワークフロー

一般的なH3クリップでは、コンパクトなNormalize Motionノードが最短ルートです。

1. 未加工の動画をIMAGEバッチとして読み込み、source_imagesに接続します。
2. 必要に応じて同じソースをRIFEまたはGMFSSで4倍補間し、motion_interpolated_imagesに接続します。
3. retimed_imagesをVideo Combineに送り、output_fpsをそのフレームレート入力に配線します。

推奨される最初のパスの設定は、strength: standard、analysis_resolution: 256、minimum_static_frames: 3、motion_multiplier: 0（自動）、または明示的な4倍VFIブランチを使用する場合は4です。4倍補間が通常の作業設定で、8倍は難しいパララックスや大きな補正の場合のみ使用します。protect_static_edgesはフル移動の線形化ではオフのままとし、意図的な静止開始や終了時の静止を維持したい場合に有効化できます。

背景

Banodoco Discordのデイリーサマリーは8月21日にこのリリースを取り上げました（アナウンス）：4倍補間を実行すると、ノードが必要に応じて小数フレームを取得し、約1秒で更新されます。これはhuddaduddがAfter Effectsで使用している「小さくレンダリング、後でリタイム」スタイルを、ComfyUI内で実現したものです。

インストール

ComfyUI/custom_nodes/にクローンしてComfyUIを再起動します。追加のPythonパッケージは不要です。ノードはCadence RetimeメニューにAnalysis、Maps、Applyのサブカテゴリとして表示されます。テストスイートはリポジトリに同梱されています（python -m unittest discover -s tests）。