FilterZeroMasksAndCorrespondingImages

FilterZeroMasksAndCorrespondingImages ノードは、マスク（MASK）のリストを必須入力として受け取り、オプションで画像（IMAGE）のリストを受け取ることができます。

FilterZeroMasksAndCorrespondingImages ノードは、データのクリーニングとフィルタリングに使用されるツールです。その中核機能は、内容が空のマスクを自動的に識別して分離し、同時に関連付けられた画像データを同期処理することです。このノードを通じて、ユーザーはワークフロー内のデータを効率的に整理し、無効なマスクエントリを削除できます。

ノード機能

このノードは、マスク（MASK）のリストを必須入力として受け取り、オプションで画像（IMAGE）のリストを受け取ります。その内部メカニズムは、入力されたすべてのマスクを走査し、非ゼロピクセルの数を計算することでマスクが空かどうかを判断します。画像リストが提供された場合、ノードはその長さがマスクリストと一致することを確認し、マスクのフィルタリング結果に基づいて画像を同期してグループ処理します。

ノードパラメータ説明 - FilterZeroMasksAndCorrespondingImages

入力接続 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`masks`	MASK	はい	-	-	masks（入力パラメータ）：フィルタリングが必要なマスクのリストを入力します。ノードは各マスクに非ゼロピクセルが含まれるかどうかをチェックします。
`original_images`	IMAGE	いいえ	-	-	original_images（入力パラメータ）：オプションで入力する画像リスト。その数は`masks`パラメータ内のマスク数と完全に一致する必要があります。

出力 (Outputs)

パラメータ名	データ型	説明
non_zero_masks_out	MASK	non_zero_masks_out（出力パラメータ）：すべての空でない有効なマスクを出力します。
non_zero_mask_images_out	IMAGE	non_zero_mask_images_out（出力パラメータ）：空でないマスクに対応する元の画像を出力します。
zero_mask_images_out	IMAGE	zero_mask_images_out（出力パラメータ）：空のマスクに対応する元の画像を出力します。
zero_mask_images_out_indexes	INDEXES	zero_mask_images_out_indexes（出力パラメータ）：元の入力リスト内における空のマスクのインデックス位置を出力します。

使用シナリオ

画像を一括生成し、後続処理が必要なワークフローにおいて、このノードは非常に有用です。例えば、ユーザーはまず複数のプロンプトを使用して一批の画像と対応するマスクを生成し、その結果をこのノードに接続できます。ノードは、有効な内容が生成されなかったマスクを自動的にフィルタリングし、内容のあるマスクとそれに対応する画像を出力して、次のステップの詳細化操作に使用します。同時に、空のマスクに対応する画像は検査用に個別に出力します。

注意事項

画像入力が提供された場合、その数はマスクの数と厳密に等しくなければなりません。そうでない場合、ノードは画像入力を無視し警告を発します。このノードはマスクや画像自体の内容を変更せず、マスクがすべてゼロかどうかに基づいて再グループ化とインデックス付けのみを行います。