高速プレビューバッチ(FastPreviewBatch)

説明

Fast Preview Batch（高速プレビューバッチ）は、画像またはマスクのバッチ全体を1つのH.264 MP4サムネイルストリップとしてエンコードし、ComfyUIインターフェース上でインタラクティブなグリッドとして表示できるようにします。各フレームはIフレーム（キーフレーム）としてエンコードされるためランダムアクセスが可能で、任意のタイルをクリックして拡表示し、バッチ全体を前後にブラウズできます。数百もの個別PNGファイルを実際に生成する必要がなくなるため、大規模な生成実行時のイテレーションが大幅に高速化され、リソース消費も抑えられます。

このノードはKJNodes/experimentalカテゴリに属し、視覚的な診断ツールとして設計されています。データ出力は生成しません。

入力

使用上の注意

• 高速プレビューバッチを使用するタイミング: 大量の生成フレーム（例：アニメーションワークフロー、潜在バッチサンプリング、マスクシーケンスの検証）を素早く検査する必要がある場合に、個別のプレビュー画像を保存する代わりにこのノードを使用してください。
• ファイルの取り扱い: 生成されたMP4は一時的に保存され、ComfyUIを閉じると破棄されます。スタンダード出力フォルダーには書き込まれません。
• メモリとパフォーマンス: このノードはキーフレームを含む単一ビデオファイルを使用するため、N個の個別PNGの書き込みと読み取りのオーバーヘッドを回避します。これにより、数百から数千フレームのバッチをプレビューする際のレイテンシを大幅に削減できます。
• ストライドサンプリングのロジック: バッチ長がmax_grid_framesを超える場合、グリッドには均一なサブセット（例：Nフレームごと）が表示されます。拡大表示ではバッチ全体をステップ閲覧できます。
• 出力なし: このノードはリアルタイムプレビューのためだけに存在し、データを下流に渡しません。ワークフローチェーンの最後に配置してください。
• 実験的なステータス: KJNodes/experimentalに属するため、このノードは将来のリリースでAPIが変更される可能性があります。カスタムノードパックをアップグレードする際はアップデートを確認してください。