Select Every Nth Mask 🎥🅥🅗🅢 (SelectEveryNthMask) - ComfyUI-VideoHelperSuite

Select Every Nth Mask 🎥🅥🅗🅢 ノードは、複数フレームのマスクを表すテンソルを入力として受け取り、skip_first_masks パラメータで指定された数の先頭マスクをスキップし、select_every_nth パラメータで設定された間隔（N）に基づいて、N 個ごとにマスクを選択し、最終的に新しいマスクシーケンスを出力します。

Select Every Nth Mask ノードは、マスクシーケンスを処理するためのフィルタリングツールです。その中核機能は、入力された一連のマスクから、指定された間隔ルールに従って一部のマスクを選択的に抽出し、新しい、より疎なマスクシーケンスを作成することです。このノードは主に、マスクデータの簡素化またはリサンプリングに使用されます。

ノード機能

このノードは、複数フレームのマスクを表すテンソルを入力として受け取り、skip_first_masks パラメータで指定された数の先頭マスクをスキップし、select_every_nth パラメータで設定された間隔（N）に基づいて、N 個ごとにマスクを選択し、最終的に新しいマスクシーケンスを出力します。その技術的な実装は Python のテンソルスライス操作に基づいており、任意の長さのマスクシーケンスを効率的に処理し、フィルタリング後のマスク数を返すことができます。

ノードパラメータ説明 - Select Every Nth Mask 🎥🅥🅗🅢

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`mask`	MASK	はい	-	-	mask（入力パラメータ）：入力される複数フレームのマスクシーケンス。型は MASK。これがフィルタリングされる元のデータソースです。

コントロールパラメータ (Parameters)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`select_every_nth`	INT	はい	1	1 - BIGMAX (ステップ: 1)	、ステップは 1。
`skip_first_masks`	INT	はい	0	0 - BIGMAX (ステップ: 1)	、ステップは 1。

Output

パラメータ名	データ型	説明
MASK	MASK	MASK（出力パラメータ）：フィルタリング後に得られた新しいマスクシーケンスを出力します。
count	INT	count（出力パラメータ）：フィルタリング後の新しいマスクシーケンスに含まれるマスクの総数を出力します。

使用シナリオ

ビデオ処理ワークフローにおいて、このノードは非常に有用です。例えば、高フレームレートのビデオマスクシーケンスがあり、その中で数フレームごとの画像にのみエフェクトを適用したい場合、このノードを使用して対象フレームのマスクを素早く抽出し、その結果を後続の合成や特殊効果ノードに渡すことで、計算リソースを節約し、処理のペースを制御できます。

注意事項

使用する際には、入力される mask パラメータが複数フレームのマスクを含むテンソルである必要があります。select_every_nth と skip_first_masks の値は、出力が空のシーケンスにならないように設定する必要があります。つまり、スキップするマスク数が入力マスクの総数以上にならないように注意してください。

Select Every Nth Mask 🎥🅥🅗🅢 ノードソースコードリンク

Select Every Nth Mask 🎥🅥🅗🅢 ノードは ComfyUI-VideoHelperSuite ノードパッケージから提供されています。

Select Every Nth Mask 🎥🅥🅗🅢(SelectEveryNthMask)