Yotsuba Games
Back to Node List

Surface Set Map

surface_set_map

Replaces every connected map inside a Surface and keeps unconnected maps unchanged.

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
ใƒžใƒƒใƒ—ใ‚’ๅทฎใ—ๆ›ฟใˆใŸใ„ใ‚ตใƒผใƒ•ใ‚งใƒผใ‚นใงใ™ใ€‚
่ฆ‹ใŸ็›ฎ
albedo
Image
ๆŽฅ็ถšใ™ใ‚‹ใจใ€่ฆ‹ใŸ็›ฎใฎ่‰ฒ็”ปๅƒใ‚’ๅทฎใ—ๆ›ฟใˆใพใ™ใ€‚
้ซ˜ใ•
height_map
Image
ๆŽฅ็ถšใ™ใ‚‹ใจใ€้ซ˜ใ•ใƒžใƒƒใƒ—ใ‚’ๅทฎใ—ๆ›ฟใˆใพใ™ใ€‚็™ฝใ„ใปใฉ้ซ˜ใใชใ‚Šใพใ™ใ€‚
ๆณ•็ทš
normal_map
Image
ๆŽฅ็ถšใ™ใ‚‹ใจใ€ๅ…‰ใฎๅฝ“ใŸใ‚Šๆ–นใซไฝฟใ†้ขใฎๅ‘ใใƒžใƒƒใƒ—ใ‚’ๅทฎใ—ๆ›ฟใˆใพใ™ใ€‚
ใใผใฟใฎๆš—ใ•
ao_map
Image
ๆŽฅ็ถšใ™ใ‚‹ใจใ€ใใผใฟใ‚„้š™้–“ใ‚’ๆš—ใใ™ใ‚‹ใƒžใƒƒใƒ—ใ‚’ๅทฎใ—ๆ›ฟใˆใพใ™ใ€‚
็™บๅ…‰
emission_map
Image
ๆŽฅ็ถšใ™ใ‚‹ใจใ€่‡ชๅˆ†ใงๅ…‰ใ‚‹ๅ ดๆ‰€ใจ่‰ฒใฎใƒžใƒƒใƒ—ใ‚’ๅทฎใ—ๆ›ฟใˆใพใ™ใ€‚
ใ–ใ‚‰ใคใ
roughness_map
Image
ๆŽฅ็ถšใ™ใ‚‹ใจใ€ใƒžใƒƒใƒˆใ•ใ‚„ๅ…‰ใฎ้‹ญใ•ใ‚’ๆฑบใ‚ใ‚‹ใƒžใƒƒใƒ—ใ‚’ๅทฎใ—ๆ›ฟใˆใพใ™ใ€‚

Output Ports

NameTypeDescription
ใ‚ตใƒผใƒ•ใ‚งใƒผใ‚น
surface
Surface
ๆŽฅ็ถšใ—ใŸใƒžใƒƒใƒ—ใ ใ‘ใ‚’ๅทฎใ—ๆ›ฟใˆใŸใ‚ตใƒผใƒ•ใ‚งใƒผใ‚นใงใ™ใ€‚
ใƒ—ใƒฌใƒ“ใƒฅใƒผ
preview
Image
่ฆ‹ใŸ็›ฎใฎ็”ปๅƒใ‚’็ขบ่ชใ™ใ‚‹ใƒ—ใƒฌใƒ“ใƒฅใƒผใงใ™ใ€‚

Overview

Replaces maps inside a Surface with only the connected images. Unconnected maps retain their original Surface contents.

For example, process only the emission and height maps in separate nodes and write them back while preserving the original visible color and roughness. To replace only one map, connect only that input.

Every replacement image must match the size of the original Surface.

Usage tips

  • The basic pattern is a round trip with surface_unpack: extract โ†’ process with image nodes โ†’ write back with Set Map. This makes the full library of existing image filters available for Surface contents.
  • Only connected inputs are replaced, so connect just the maps you intend to modify. This makes partial updates safe.
  • After replacing height, also use surface_rebuild_normal to keep normals consistent.

Related nodes

  • surface_unpack โ€” extracts maps
  • surface_rebuild_normal โ€” restores consistency after replacing height
  • surface_id_mask โ€” helps create a map for only selected parts
  • noise_generate / height_from_image โ€” sources for inserted maps

Examples

  • Extract emission with Surface Unpack, brighten it with Levels, then write it back through emission_map.
  • Connect a noise image to height_map and review the floor with relief under lighting.
  • Connect a hand-drawn grayscale map to roughness_map so only metal areas produce sharp highlights.
  • To preserve the visible appearance, leave albedo disconnected and connect only the required maps.
Back to Node List
Surface Set Map โ€” PixPipeline Node Reference