よつばゲームズ
ノード一覧に戻る

サーフェース書き出し

surface_export

サーフェースを、ゲームエンジン用のPNGテクスチャセット(見た目・法線・高さ・くぼみ・発光・ざらつき)として書き出します。

下書き
解説あり

入力ポート

名前型説明
サーフェース
surface
Surface
必須
テクスチャセットとして書き出すサーフェースです。

出力ポート

名前型説明
プレビュー
preview
Image
書き出すサーフェースの見た目画像です。

パラメータ

名前型既定値範囲説明・選択肢
保存先(ベース)
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
  • UnityUnity
    base_Albedo / base_Normal / base_Height / base_Occlusion / base_Emission / base_Roughness
  • GodotGodot
    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
11–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
ノード一覧に戻る
サーフェース書き出し — PixPipeline ノード解説