Back to Node List

Surface Export

surface_export

Writes a Surface as a set of PNG texture maps (albedo, normal, height, AO, emission, roughness) for game engines.

Draft

Guide available

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

Input Ports

Name	Type	Description
サーフェース surface	Surface Required	テクスチャセットとして書き出すサーフェースです。

Output Ports

Name	Type	Description
プレビュー preview	Image	書き出すサーフェースの見た目画像です。

Parameters

Name	Type	Default	Range	Description / Options
保存先(ベース) path	FilePath	—	—	基準になる.pngパスです。ファイル名にマップごとのサフィックスが付きます(例: brick.png → brick_n.png)。
保存モード save_mode	Enum	Disabled	—	ファイルを保存するか、既存ファイルを上書きするかです。無効`Disabled` 新規のみ`CreateIfMissing` 上書き`Overwrite`
命名規約 naming	Enum	Suffix	—	マップセットのファイル命名規約です。短縮形`Suffix` base.png / base_n.png / base_h.png / base_ao.png / base_e.png / base_r.png Unity`Unity` base_Albedo / base_Normal / base_Height / base_Occlusion / base_Emission / base_Roughness Godot`Godot` base_albedo / base_normal / base_height / base_ao / base_emission / base_roughness
法線のY軸規約 normal_convention	Enum	OpenGL	—	書き出し先エンジンのノーマルマップ規約です。内部はOpenGL規約で保持しているため、DirectXを選ぶとGチャンネルを反転します。 OpenGL (Godot等)`OpenGL` Gチャンネルが上向き(+Y)です。Godot や Blender で使われます。 DirectX (Unity等)`DirectX` Gチャンネルが下向き(-Y)です。Unity や Unreal で使われます。
拡大倍率 scale	Int	1	1–16	全マップに適用する整数倍の最近傍拡大です。
見た目を書き出す export_albedo	Bool	true	—	見た目の画像を書き出します。
法線を書き出す export_normal	Bool	true	—	法線マップがあれば書き出します。
高さを書き出す export_height	Bool	true	—	高さマップがあれば書き出します。
くぼみを書き出す export_ao	Bool	true	—	くぼみマップがあれば書き出します。
発光を書き出す export_emission	Bool	true	—	発光マップがあれば書き出します。
ざらつきを書き出す export_roughness	Bool	true	—	ざらつきマップがあれば書き出します。

概要

副作用: あり(has_side_effects: true、ファイル書き込み)

技術詳細

内部のノーマルマップは OpenGL 規約(+Y up)で保持しており、DirectX 選択時のみ flip_normal_map_y()(pxn-core)で G チャンネルを反転する
拡大は scale_image_nearest()(pxn-core)による最近傍補間
存在しないマップは黙ってスキップされる(将来: 素材既定値での補完)

使用例

画像からサーフェース → サーフェース書き出し で、HD-2D 系エンジンのマテリアルに読み込めるマップセットを作る
Godot の StandardMaterial3D へは naming=Godot / normal=OpenGL、Unity の Lit へは naming=Unity / normal=DirectX

Back to Node List

Surface Export — PixPipeline Node Reference