Back to Node List

Surface Unpack

surface_unpack

Extracts the image maps stored inside a Surface.

Reviewed
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
サーフェース
surface
Surface
Required
中のマップを取り出したいサーフェースです。

Output Ports

NameTypeDescription
見た目
albedo
Image
最終的に見える色の画像です。
高さ
height
Image
高さマップです。未設定なら中間グレーを出します。
深度
depth
Image
ビュー深度マップです。未設定なら黒を出します。白いほど手前です。
曲率
curvature
Image
曲率マップです。未設定なら平坦を表す中間グレーを出します。
法線
normal
Image
法線マップです。未設定なら平らな向きの色を出します。
くぼみの暗さ
ao
Image
くぼみの暗さです。未設定なら白を出します。
発光
emission
Image
発光マップです。未設定なら透明の黒を出します。
ざらつき
roughness
Image
ざらつきマップです。未設定なら中間より少し明るいグレーを出します。
素材IDマスク
material_mask
Image
素材IDの割り当てを白黒で見やすくした確認用画像です。
面IDマスク
face_mask
Image
面IDの割り当てを白黒で見やすくした確認用画像です。床・壁・屋根などの面分けを確認できます。

Overview

Extracts every map inside a Surface as an ordinary image. Use it to inspect Surface contents or process individual maps with existing image filters.

Unset maps are returned as convenient default images: height and curvature are middle gray (0.5), depth is black (0.0), normals are flat, AO is white, and emission is transparent.

Usage tips

  • Its counterpart is surface_set_map. The go-to loop for processing Surface contents with image nodes is: extract with Unpack → process with regular image filters → write back with Set Map.
  • It is also valuable for debugging. When lighting looks wrong, visually inspect height, normal, and material_mask to quickly find the cause.
  • It also serves as the conversion point when you need only albedo—the final appearance as a regular image.

Related nodes

  • surface_set_map — writes processed maps back
  • solid_render — a primary Surface source
  • channel_split — similar operation for an image
  • surface_light_preview — combines map inspection with lighting review

Examples

  • Extract only emission, adjust its brightness with Levels, then write it back with Surface Set Map.
  • Extract height and reuse it as a map for Blur or Displace.
  • Inspect material_mask to see which material ID is assigned at each location.
  • Inspect face_mask to verify face IDs for floors, walls, and roofs.
Back to Node List
Surface Unpack — PixPipeline Node Reference