マスクの結合 (CombineMasks)

概要 (What is it?)

CombineMasks ノードは、複数のマスク画像のリストを受け取り、ピクセルごとの最大値（論理和 / Union 演算） を取ることで単一の統合マスクに結合します。

これは、セグメンテーションノードが複数のマスクを出力し、それらを後続処理で 1 つのマスクとしてまとめて適用したい場合に非常に役立ちます。

使用する場面 (When would I use it?)

以下のような場面でこのノードを使用します：

• 複数のセグメンテーションマスクを 1 つのマスクに統合したい場合
• 検出された複数の物体から 1 つの「被写体マスク」を作成したい場合
• 単一のマスク入力を想定している後続ノードのワークフローを簡素化したい場合

使い方 (How to use it)

基本セットアップ

1. ワークフローに CombineMasks ノードを追加します
2. 結合したい 1 つ以上のマスクをリストとして masks 入力に接続します
3. output_mask 出力を統合マスクとして後続ノードに渡します

パラメータ一覧 (Parameters)

• masks: 結合するマスク画像のリスト

出力 (Outputs)

• output_mask: 統合された単一のマスク（PNG 画像）

重要な注意点 (Important Notes)

• Union（論理和）ロジック: ピクセルごとに、すべての入力マスクの中で最も明るい（最大）値が出力マスクの値として採用されます。
• サイズの要件: すべての入力マスクは同一の解像度（縦横の寸法）である必要があります。サイズが異なる場合、明確なエラーメッセージとともに検証が失敗します。
• アルファチャンネルの処理: 入力マスクが RGBA または LA 形式の場合、ノードはそのアルファチャンネルをマスク値として使用します。それ以外（RGB やグレースケール）の場合はグレースケールに変換して処理します。