サーフェース合成

surface_composite

別のサーフェースを上に重ね、見た目・各マップ・素材ID・面IDをまとめて合成します。

確認済み

解説あり

入力ポート

名前	型	説明
下地 base	Surface 必須	下地になるサーフェースです。
重ねるサーフェース overlay	Surface 必須	上に重ねるサーフェースです。
マスク mask	Image	重ねる場所を制限する任意のマスクです。

出力ポート

名前	型	説明
サーフェース surface	Surface	合成したサーフェースです。
プレビュー preview	Image	見た目の画像を確認するプレビューです。

パラメータ

名前	型	既定値	範囲	説明・選択肢
ブレンド mode	Enum	Normal	—	重ねるサーフェースの見た目の色をどう混ぜるかです。通常`Normal` 重ねるサーフェースの色をそのまま載せます。乗算`Multiply` 下地を暗くします。影や汚れ向けです。スクリーン`Screen` 下地を明るくします。光やハイライト向けです。オーバーレイ`Overlay` コントラストを強めます。加算`Add` 色を加算します。発光表現向けです。減算`Subtract` 上の色を差し引いて暗くします差の絶対値`Difference` 2色の差を取り出します。違い比較や特殊効果に有用比較（暗）`Darken` チャンネルごとに暗い方の色を残します比較（明）`Lighten` チャンネルごとに明るい方の色を残しますソフトライト`SoftLight` やわらかいコントラスト。淡い陰影や色付けに有用ハードライト`HardLight` 強いコントラスト。はっきりした光と影に有用覆い焼き`ColorDodge` 下の色を強く明るくします。強い光の表現に有用焼き込み`ColorBurn` 下の色を強く暗くします。深い影の表現に有用
不透明度 opacity	Float	1	0–1 / step 0.01	重ねるサーフェース全体の強さです。
オフセットX offset_x	Int	0	-4096–4096	重ねるサーフェースを横にずらす量です。
オフセットY offset_y	Int	0	-4096–4096	重ねるサーフェースを縦にずらす量です。
マップの扱い map_policy	Enum	AllMaps	—	見た目以外の高さ・法線・発光なども一緒に合成するかです。全マップ`AllMaps` 見た目、高さ、法線、発光などをまとめて合成します。見た目だけ`AlbedoOnly` 見た目の色だけを合成し、他のマップは下地のまま残します。
高さの合成 height_mode	Enum	OverlayMap	—	重ねるサーフェースが高さマップをどう変えるかです。重ねるマップを使う`OverlayMap` 重ねるサーフェースの高さマップを、そのまま下地になじませます。従来の挙動です。下地より高くする`Raised` 重ねた部分を下地より高くします。壁に窓枠、床に敷石を付ける時に向きます。高さを足す`Add` 下地の高さに、重ねるサーフェースの高さを足します。高い方を使う`Max` 下地と重ねるサーフェースを比べて、高い方を使います。
重ねる高さ height_offset	Float	0	-1–1 / step 0.01	重ねた部分を下地からどれくらい出すかです。窓枠や装飾を少し手前に出したい時に使います。
重ねる高さの強さ overlay_height_scale	Float	1	0–4 / step 0.01	重ねるサーフェースが持つ高さマップをどれくらい効かせるかです。
高さから法線を作り直す rebuild_normal_from_height	Bool	false	—	合成後の高さマップから光の当たり方用の法線マップを作り直します。出っ張りのハイライトを合わせたい時に使います。
IDの扱い id_policy	Enum	OverlayVisible	—	素材IDと面IDをどう合成するかです。重ねた場所を使う`OverlayVisible` 重ねたサーフェースが見えている場所では、素材IDと面IDも上書きします。下地を残す`KeepBase` 素材IDと面IDは下地のまま残します。
マスクの見方 mask_source	Enum	Alpha	—	マスク画像のどの値で重ねる強さを決めるかです。アルファ`Alpha` 透明度で重ねる場所を決めます。明るさ`Luminance` 白黒の明るさで重ねる場所を決めます。赤`Red` 赤チャンネルで重ねる場所を決めます。緑`Green` 緑チャンネルで重ねる場所を決めます。青`Blue` 青チャンネルで重ねる場所を決めます。
左右ループ wrap_x	Bool	false	—	重ねるサーフェースの左右端がつながっているものとして読みます。
上下ループ wrap_y	Bool	false	—	重ねるサーフェースの上下端がつながっているものとして読みます。

概要

2つの Surface を重ねて、1つの Surface にまとめるノードです。

画像だけを重ねるのではなく、高さ、法線、発光、ざらつき、素材ID、面IDも一緒に合成できます。たとえば、床のサーフェースに汚れパーツを重ねたり、壁の上に金属パーツを置いたり、アイソメ面の一部に別の面パーツを足したい時に使います。

出力サイズは常に base のサイズです。overlay は offset_x / offset_y で置く位置を決めます。

使い方のポイント

通常画像の blend に相当するSurface版。ライティング前に部品を重ねるのが正しい順序(ライティング後の画像を重ねると光の整合が崩れる)
高さの扱いが鍵: height_mode で「下地より高く置く」等を選び、重ねた部品が出っ張るのか埋まるのかを決める
重ねた後に rebuild_normal_from_height をONにすると、段差の法線が作り直されて光の当たりが自然になる
確認はサブマッププレビュー(H=高さ、N=法線)を切り替えながら行う

よくある失敗

重ねたのに光で浮き上がらない: 高さを上げていない(height_mode/offset)か、法線を再構築していない。画像として重なっても、光は高さ・法線を見ている
overlayが切れる: 出力サイズは常にbase基準。overlayはoffsetで位置決めし、はみ出しは切れる

使用例

Grid Pattern で作った床サーフェースを base にし、汚れや水たまりのサーフェースを overlay にして重ねる。
Surface Plane で作った壁に、別の小さな金属パーツのサーフェースを重ね、id_policy=OverlayVisible で金属IDも一緒に入れる。
壁に窓枠を貼る時は、height_mode=下地より高くする、height_offset=0.05〜0.15、rebuild_normal_from_height=ON にする。Surface Light Preview で落ち影を強めると、窓枠が壁より少し出ているように見えます。
見た目だけステッカーのように貼りたい時は、map_policy=AlbedoOnly、id_policy=KeepBase にする。
タイル素材として端をまたいで重ねたい時は、wrap_x や wrap_y をONにする。

確認方法

Image to Surface を2つ作り、1つを base、もう1つを overlay に接続する。
offset_x / offset_y を動かして、重なる位置が変わるか確認する。
Surface プレビューの A、H、ID、F を切り替え、見た目以外のマップやIDも同じ場所で重なっているか確認する。
height_mode=下地より高くする、height_offset=0.1 にして、H プレビューで重ねた場所だけ明るくなるか確認する。
rebuild_normal_from_height=ON にして、N プレビューで出っ張りの端に色変化が出るか確認する。
Surface Light Preview につなぎ、発光や法線、面IDを含むサーフェースとして扱えるか確認する。