ノード一覧に戻る

サーフェースIDマスク

surface_id_mask

サーフェース内の素材IDまたは面IDが一致する場所を白いマスクとして取り出します。

確認済み
解説あり

入力ポート

名前説明
サーフェース
surface
Surface
必須
素材IDや面IDを探したいサーフェースです。

出力ポート

名前説明
マスク
mask
Image
選んだIDと一致する場所が白、それ以外が黒のマスクです。

パラメータ

名前既定値範囲説明・選択肢
IDの種類
id_kind
Enum
Material

素材IDと面IDのどちらからマスクを作るか選びます。

  • 素材IDMaterial
    素材IDから探します。
  • 面IDFace
    面IDから探します。
素材ID
material_id
Text
core:default

マスクとして取り出す素材IDです。

面ID
face_id
Text
surface:default

マスクとして取り出す面IDです。

反転
invert
Bool
false

オンにすると、白と黒を反転します。

まず何に使う?

  • 金属部分だけ、石部分だけ、壁面だけなどを後から加工する
  • Surface Set Map に入れる高さマップや発光マップを、特定IDだけに作る
  • Surface Composite や画像フィルタへ渡すマスクを作る

概要

Surface の中から指定した素材ID・面IDの場所だけを白マスクとして取り出す ノードです。「金属部分だけ」「左の壁面だけ」のような部位限定の加工を、 手でマスクを描かずに実現します。

使い方のポイント

  • Surface ワークフローの強みが出る場面: solid_render 時点で素材IDを 仕込んでおけば、後からどの部位でも取り出せる(選択範囲の自動化)
  • 取り出したマスクは普通の Image なので、画像フィルタのマスク・ surface_set_map 用マップの限定・mask_boolean での組み合わせに使える
  • IDが入っていなければ真っ黒が出る。surface_unpack の material_mask / face_mask でIDの入り具合を先に確認すると迷わない

関連ノード

  • surface_assign_id / surface_assign_material — IDを塗る側

  • surface_unpack — ID分布の目視確認

  • mask_boolean — 取り出したマスクの合成

  • surface_set_map — マスクを使ったマップ加工との連携

  • バージョン: 1

使用例

[Surface] → surface → [Surface ID Mask(id_kind:Material, material_id:core:metal)] → mask

金属部分だけ白いマスクになります。これを Surface Set Map 用のマップ作成や、通常の画像フィルタのマスクに使えます。

ノード一覧に戻る
サーフェースIDマスク — PixPipeline ノード解説