マスクで混合 — PixPipeline ノード解説

入力ポート

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

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

名前

型

説明

画像

output

Image

混合結果の画像です

パラメータ

名前型既定値範囲説明・選択肢

名前	型	既定値	範囲	説明・選択肢
反転 invert	Bool	false	—	白黒を入れ替え、黒い所に処理後画像を使います
Alphaを使用 alpha_enabled	Bool	false	—	マスクの輝度ではなくアルファチャンネルを使用します
マスク外の扱い outside	Enum	Original	—	マスク画像がキャンバスより小さい時、範囲外をどう扱うかです元画像`Original` マスクの範囲外は元画像のまま残します処理後画像`Processed` マスクの範囲外は処理後画像を使います透明`Transparent` マスクの範囲外は透明にします

反転

invert

Bool

false

—

白黒を入れ替え、黒い所に処理後画像を使います

Alphaを使用

alpha_enabled

Bool

false

—

マスクの輝度ではなくアルファチャンネルを使用します

マスク外の扱い

outside

Enum

Original

—

マスク画像がキャンバスより小さい時、範囲外をどう扱うかです

概要

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

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

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