マスクの表示 (DisplayMask)
概要 (What is it?)
DisplayMask ノードは、入力画像から特定のチャンネル（赤、緑、青、またはアルファ）を抽出してマスク画像を生成します。マスクはグレースケール画像であり、白い領域は完全な不透明（または高輝度）、黒い領域は完全な透明（または低輝度）を表します。画像内のさまざまなチャンネルや透明度情報を視覚化・確認するのに役立ちます。
使用する場面 (When would I use it?)
以下のような場面でこのノードを使用します：
- 画像の透過（アルファ）情報を可視化マスクとして抽出したい場合
- 特定の色チャンネル（赤、緑、青）をマスクとして抽出したい場合
- 画像編集ワークフロー用のマット・マスクを作成したい場合
- 画像の各チャンネルの成分を視覚的に検査したい場合
- 後続のマスク合成処理ノードに渡すマスクを生成したい場合
- 画像パイプライン内のアルファチャンネルやカラーチャンネルの問題をデバッグしたい場合
使い方 (How to use it)
基本セットアップ
- ワークフローに DisplayMask ノードを追加します
- 画像ソースを "input_image" 入力に接続します
- "channel" ドロップダウンから目的のチャンネルを選択します
- 生成されたマスクが "output_mask" パラメータから出力されます
パラメータ一覧 (Parameters)
- input_image: マスクを作成する対象の画像（他の画像ノードから接続可能）
- channel: マスクとして抽出するチャンネル（red, green, blue, alpha）
出力 (Outputs)
- output_mask: 入力画像の指定チャンネルから生成されたグレースケールマスク画像
使用例 (Example)
一般的なワークフローパターンの例：
- GenerateImage または LoadImage などのノードで画像を生成または読み込みます
- その画像を DisplayMask ノードの "input_image" パラメータに接続します
- 目的のチャンネルを選択します（例: 透明度の確認なら "alpha"、赤成分の抽出なら "red"）
- DisplayMask ノードが指定チャンネルを抽出して可視マスクを作成します
- "output_mask" を DisplayImage に接続して結果を確認するか、他のマスクノードに渡します
チャンネルオプション (Channel Options)
- alpha: 透過チャンネルを抽出（デフォルト） - 画像のどの領域が透明であるかを可視化
- red: 赤色チャンネルを抽出 - 赤色要素の分離に有効
- green: 緑色チャンネルを抽出 - 緑色要素の分離に有効
- blue: 青色チャンネルを抽出 - 青色要素の分離に有効
重要な注意点 (Important Notes)
- チャンネル抽出: 指定されたチャンネルを入力画像から分離し、マスク画像に変換します
- グレースケール出力: 出力はグレースケール画像となり、選択チャンネルの値が高いピクセルは白、低いピクセルは黒になります
- リアルタイム処理: 接続やチャンネルの切り替えに応じて即座に処理が実行されます
- 出力形式: 可逆圧縮の PNG ファイルとして保存されます
- サポート形式: RGB、RGBA、グレースケール（L）、グレースケール＋アルファ（LA）をサポート
よくある問題 (Common Issues)
- 出力されない: "input_image" パラメータに入力画像が正しく接続されているか確認してください
- 真っ黒なマスクになる: 選択したチャンネルの値が全体的に 0 に近い可能性があります
- 真っ白なマスクになる: 選択したチャンネルの値が全体的に最大値に近い可能性があります
- サポート外モードのエラー: 画像モードに存在しないチャンネル（例: RGB 画像でのアルファ）を指定した場合の動作を確認してください
技術的な詳細 (Technical Details)
このノードは以下の処理を行います：
- 入力画像を URL から読み込み
- 指定されたチャンネル（赤、緑、青、またはアルファ）を抽出
- グレースケールマスク画像に変換
- 新しい画像アーティファクトとして保存
なお、RGB 画像にはアルファチャンネルが存在しないため、RGB 画像で alpha を選択した場合は赤（red）チャンネルにフォールバックします。