Back to Node List

Tile Asset Save

tile_asset_save

Saves a TileAsset as a self-contained .pxntile file.

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
タイル素材
asset
TileAsset
Required

Output Ports

NameTypeDescription
概要
summary
Text
保存結果の短いまとめです。

Parameters

NameTypeDefaultRangeDescription / Options
保存先
path
FilePath

保存先の .pxntile ファイルです。

保存モード
save_mode
Enum
Disabled

保存実行と既存ファイルの上書きを制御します。

  • 無効Disabled
  • 新規のみCreateIfMissing
  • 上書きOverwrite

Overview

Pins a TileAsset as a self-contained .pxntile including its image sources. Use it when the asset must reload in another project without its original nodes.

Usage tips

  • Connect the asset-producing node to asset and set save_mode to CreateIfMissing or Overwrite only when you actually want to save.
  • Choose CreateIfMissing to protect existing files; use Overwrite only for an explicit replace.
  • After saving, load it back with tile_asset_load to confirm the same asset hash and images round-trip.

Common pitfalls

  • Nothing is written while save_mode is Disabled — the default that prevents accidental re-saves during normal evaluation.
  • An asset with missing runtime source images cannot be made self-contained; reconnect the upstream images before saving.

Related nodes

  • tile_asset_load
  • tile_palette_save
  • tile_canvas_save
Back to Node List
Tile Asset Save — PixPipeline Node Reference