Back to Node List

Surface Outline

surface_outline

Draws pixel-art outlines from the surface silhouette and from depth / face-id discontinuities.

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
アウトラインを付けたいサーフェースです。深度・面IDがあると内部の稜線も検出できます。

Output Ports

NameTypeDescription
サーフェース
surface
Surface
加工後の見た目を持つサーフェースです。法線などの他のマップはそのまま通します。
画像
image
Image
加工後の見た目画像です。

Parameters

NameTypeDefaultRangeDescription / Options
外形の線
silhouette
Bool
true

外形(シルエット)に線を描きます。

深度の段差線
interior_depth
Bool
true

深度が大きく飛ぶ場所(手前の物が奥に重なる縁)に線を描きます。

深度のしきい値
depth_threshold
Float
0.080.01–0.5 / step 0.01

内部稜線とみなす深度の段差(0..1)です。

面の境界線
interior_face
Bool
false

面IDが変わる境界(天面と側面の継ぎ目など)に線を描きます。

線の位置
placement
Enum
Inside

外形の線をシルエットの内側に描くか外側に描くかです。

  • 内側Inside
    シルエットの内側の縁ピクセルを置き換えます。スプライトの寸法が変わりません。
  • 外側Outside
    シルエットの外側に線のピクセルを追加します。
色のつけ方
color_mode
Enum
Darken

線の色の決め方です。

  • 下地を暗くDarken
    下地の色を暗くした線にします(selout風。色になじみます)。
  • 単色Flat
    指定した1色で線を描きます。
線の色
color
Color
[0.07999999821186066,0.07999999821186066,0.11999999731779099,1]

単色モードでの線の色です。

暗くする量
darken_lightness
Float
282–60 / step 1

下地の色をどれだけ暗くするかです(OKLCH明度)。

Overview

Draws a pixel-art outline on a Surface. Unlike ordinary outline, which uses only the silhouette, this node uses depth and face IDs to draw internal 3D edges such as box corners and roof/wall boundaries. It is a go-to downstream step after solid rendering.

Usage tips

  • It belongs in the standard chain: solid_render → surface_edge_highlight → surface_outline → surface_light_preview. It quickly makes a 3D-derived image feel hand-pixeled.
  • Outer and internal lines (depth lines and face boundaries) can be adjusted independently. Start with the silhouette, then add internal lines only if the form still lacks depth.
  • Use ordinary outline for an asset that is only an image. This node is specifically for a Surface carrying depth and face IDs.

Related nodes

  • outline — image-based outline

  • surface_edge_highlight — upstream bevel counterpart

  • solid_render — supplies the Surface

  • surface_light_preview — reviews the finished result

  • Processes only albedo and passes every other map through, preserving the accuracy of the G-buffer.

Technical details

  • Silhouette: four-neighbor boundary between opaque and transparent pixels. Inside replaces the edge on the opaque side; Outside adds pixels on the transparent side.
  • Depth line: drawn on the nearer side when neighboring depth-map values (white = near) differ by at least the threshold.
  • Face boundary: drawn along right/down boundaries where face_ids change, avoiding double lines.
  • Pixels added by Outside receive flat normals and neighboring height/depth values to prevent artifacts in downstream lighting.

Examples

Solid Render → Surface Outline → Surface Light Preview creates an outlined isometric block.

Back to Node List
Surface Outline — PixPipeline Node Reference