マスクで混合

名前	型	説明
元画像 original	Image 必須	マスクが黒い所で使う画像です
処理後画像 processed	Image 必須	マスクが白い所で使う画像です（例: 明るさ調整した版）
マスク mask	Image 必須	マスク画像です。白い所が処理後、黒い所が元画像になります

名前	型	説明
画像 output	Image	混合結果の画像です

パラメータ

名前	型	既定値	範囲	説明・選択肢
反転 invert	Bool	false	—	白黒を入れ替え、黒い所に処理後画像を使います
Alphaを使用 alpha_enabled	Bool	false	—	マスクの輝度ではなくアルファチャンネルを使用します
アルファ補間 alpha_mode	Enum	Premultiplied	—	入力画像のアルファ値が異なる時にRGBをどう補間するかを選びます乗算済みアルファ`Premultiplied` 乗算済みアルファ空間で混合し、完全透明ピクセルのRGBによる色縁を防ぎますストレートRGBA`StraightRGBA` 透明ピクセルに保存されたRGBを含め、RGBAの各チャンネルを個別に混合します
マスク外の扱い outside	Enum	Original	—	マスク画像がキャンバスより小さい時、範囲外をどう扱うかです元画像`Original` マスクの範囲外は元画像のまま残します処理後画像`Processed` マスクの範囲外は処理後画像を使います透明`Transparent` マスクの範囲外は透明にします

PixPipeline では補正ノード（明度調整・ぼかし等）に個別のマスク入力を持たせません（§2.8 局所補正の原則）。代わりに「全体に補正した版」と「元画像」をこのノードでマスク合成します。

元画像 ───────────────┐
                      ├─ [マスクで混合] ─→ 結果
元画像 → [明度調整] ──┘        ↑
マスク ─────────────────────────┘

マスク値 0〜1 で 元画像 → 処理後画像 を線形補間します（グレーマスクで部分的な効き具合を作れる）
通常は Premultiplied（乗算済みアルファ）を使います。完全透明ピクセルに残ったRGBを無視するため、透明境界に暗い縁や色縁が出にくく、結果のアルファが0なら透明黒になります
透明ピクセル内のRGBも含めてRGBAの数値をそのまま混ぜたい場合だけ StraightRGBA を選びます。旧v2プロジェクトは見た目を維持するため、この方式へ自動移行します
処理後画像がキャンバスより小さい場合、その範囲外は透明として混合されます

「この部分だけ明るく/ぼかしたい」と思ったら、補正ノードのマスク入力を探すのではなく 必ずこの形(元画像+補正全体がけ版+マスク)に組む。これがPixPipelineの標準作法
元画像から2本に分岐させ、片方だけに補正を通して両方をこのノードへ——という「Y字の合流」がグラフの見た目の目印になる
グレーマスクで「効き50%」のような部分適用もできる(線形補間)
画像の見た目を合成する通常用途では Premultiplied のまま使い、StraightRGBA は透明RGBをデータとして編集する互換用途に限定する
よく使う組み合わせは公式カスタムノード(MaskedBrightness等)としても提供されている

originalとprocessedを逆につないだ: 白い所に出るのが processed。効果が逆に出たら接続を入れ替えるか invert をON
マスクが小さくて端の挙動が変: outside でマスク範囲外の扱い(元画像/処理後/透明)を明示できる
3入力の用意が面倒: 同じ画像から分岐すればよい(元画像を2回描く必要はない)

局所的な明るさ調整: 元画像とその Brightness 適用版を、Path Mask で描いた範囲だけ混合
部分ぼかし: Gaussian Blur 版を Histogram Scan のソフトマスクで混ぜて被写界深度風に
公式カスタムノード: MaskedBrightness / MaskedBlur / MaskedHSVAdjust はこのノードのラッパーです