Select Masks 🎥🅥🅗🅢 (SelectMasks) - ComfyUI-VideoHelperSuite

Select Masks 🎥🅥🅗🅢 ノードは、複数のマスクを含むテンソル（Tensor）を入力として受け取り、ユーザーが提供するインデックス文字列を解析して、どのマスクを保持するかを決定します。

Select Masks ノードは、一連のマスク（MASK）データから、指定されたインデックス値に基づいて特定のマスクをフィルタするためのツールです。その中核機能は、ユーザーがマスクシーケンスの一部を正確に選択し、後続の独立した処理や分析を行えるようにすることです。

ノード機能

このノードは、複数のマスクを含むテンソル（Tensor）を入力として受け取り、ユーザーが提供するインデックス文字列を解析して、どのマスクを保持するかを決定します。インデックスは、単一の数字（例：「2」）、カンマ区切りのリスト（例：「0,3,5」）、範囲式（例：「1:4」）など、多様で柔軟な形式をサポートしており、バッチ選択やスライス操作を非常に便利に行うことができます。

ノードパラメータ説明 - Select Masks 🎥🅥🅗🅢

入力接続 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`mask`	MASK	はい	-	-	mask（入力パラメータ）：複数のマスクを含むテンソルシーケンスを入力します。ノードはこれからフィルタを行います。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`indexes`	文字列	はい	0	-	カンマ区切りリストまたはコロン範囲形式。
`err_if_missing`	ブール	はい	True	-	err_if_missing（入力パラメータ）：Trueに設定すると、指定されたインデックスがマスクシーケンスの範囲を超えている場合、ノードはエラーを発生させます。
`err_if_empty`	ブール	はい	True	-	err_if_empty（入力パラメータ）：Trueに設定すると、インデックスに基づいてフィルタした結果が空の場合、ノードはエラーを発生させます。

出力 (Output)

パラメータ名	データ型	説明
MASK	MASK	MASK（出力パラメータ）：インデックスに基づいてフィルタされたマスクテンソルを出力します。

使用シナリオ

ビデオ処理ワークフローにおいて、このノードは非常に有用です。例えば、「VHS Batch Load Masks」ノードを使用して複数フレームのマスクシーケンスを読み込んだ後、このノードを使用してキーフレーム（例：0、15、30フレーム目）のマスクのみを抽出し、選択されたこれらのマスクを「Apply Mask to Batch」ノードに入力して、ビデオの特定のセグメントに特殊効果処理を適用することができます。

注意事項

インデックス値は0から始まることに注意してください。指定されたインデックスが入力マスクシーケンスの実際の範囲を超えている場合、またはフィルタ結果が空の場合、ノードの動作は err_if_missing および err_if_empty パラメータの設定に依存し、エラーが発生する可能性があります。

Select Masks 🎥🅥🅗🅢 ノードソースコードリンク

Select Masks 🎥🅥🅗🅢 ノードは ComfyUI-VideoHelperSuite ノードパッケージに含まれています。

Select Masks 🎥🅥🅗🅢(SelectMasks)

Select Masks