Surface Plane — PixPipeline Node Reference

Output Ports

Name	Type	Description
サーフェース surface	Surface	この面を画像化したサーフェースです。中に面情報も一緒に入っています。
サーフェースジオメトリ geometry	SurfaceGeometry	高度な面編集や再画像化で使う元の面データです。
プレビュー preview	Image	見た目の画像を確認するプレビューです。

Parameters

Name	Type	Default	Range	Description / Options
キャンバス幅 width	Int	32	1–4096	ジオメトリ全体の横幅です。
キャンバス高さ height	Int	32	1–4096	ジオメトリ全体の高さです。
X x	Int	0	-4096–4096	面の左端の位置です。
Y y	Int	0	-4096–4096	面の上端の位置です。
幅 face_width	Int	32	1–4096	面そのものの横幅です。
高さ face_height	Int	32	1–4096	面そのものの高さです。
面の種類 kind	Enum	Top	—	この面が床・壁・屋根など、どの向きの面かを選びます。上面`Top` 上向きの平らな面です。床`Floor` 床として扱う面です。左壁`WallLeft` 左向きの壁面です。右壁`WallRight` 右向きの壁面です。前壁`WallFront` 手前側の壁面です。奥壁`WallBack` 奥側の壁面です。天井`Ceiling` 下から見る天井面です。左屋根`RoofSlopeLeft` 左側へ傾いた屋根面です。右屋根`RoofSlopeRight` 右側へ傾いた屋根面です。斜面`Ramp` 斜めに上がる面です。板`Billboard` 画像として正面を向く平面です。
面ID face_id	Text	surface:plane	—	画像化した時に face_id マップへ入る面IDです。
素材ID material_id	Text	core:default	—	画像化した時に material_id マップへ入る素材IDです。
色 color	Color	[0.800000011920929,0.800000011920929,0.800000011920929,1]	—	画像化した時の面の見た目の色です。
奥行き depth	Float	0	-1024–1024 / step 0.1	面が重なった時、この値が大きい面ほど手前に描かれます。
高さ値 height_value	Float	0.5	0–1 / step 0.01	この面に書き込む高さマップの値です。白いほど高くなります。

Overview

Creates one rectangular plane as a Surface with face information. It stores the face type, face ID, material ID, depth, and height for a floor, wall, roof, or similar surface.

Normally, connect the surface output directly to Surface Light Preview. Normals, height, material IDs, and face IDs are generated for the plane's orientation, so no separate rasterization node is required for preview.

The geometry output is an advanced output for detailed face-data processing. It is unnecessary for ordinary work.

Usage tips

Unlike surface_solid, which creates an untextured flat surface, this node's plane has a face orientation (normal) such as floor, wall, or roof. A wall darkens correctly under lighting.
It is also a convenient minimal setup for learning and testing lighting: connect one plane to surface_light_preview and inspect how light direction affects it.

Related nodes

surface_solid — solid-color version without orientation
surface_light_preview — reviews the effect of face orientation
surface_geometry_rasterize — rerasterizes the geometry output
iso_scene_to_surface_geometry — generates face geometry for an entire scene

Examples

Set kind=WallLeft and face_id=wall:left to review lighting on a left wall.
Even with the same stone color, use separate face_id=iso:top and face_id=wall:left values, then review the face division with F in the Surface preview.
Connect surface to Surface Light Preview and change the light direction to confirm that the wall brightness changes.