Back to Node List

Tile Canvas Save

tile_canvas_save

Saves a .pxntilemap and aligns pinned project snapshots.

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
タイルキャンバス
canvas
TileCanvas
Required
タイルマップの参照・文書です。保存には全依存のexact素材が必要で、snapshotはマップ本体より先に公開されます。

Output Ports

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

Parameters

NameTypeDefaultRangeDescription / Options
保存先
path
FilePath

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

保存モード
save_mode
Enum
Disabled

新規のみは既存の通常ファイルを内容を読まずに保護します。上書きは解析可能な対応形式だけを置換します。

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

Overview

Saves a TileCanvas document together with pinned snapshots of the assets it uses, keeping them consistent — the save path that makes a project folder reproducible offline on its own.

Usage tips

  • Connect canvas from the tile-canvas editing node, and enable save_mode only for explicit saves.
  • The saved .pxntilemap carries a project-relative fallback key referencing the same exact hashes as the snapshot index.
  • Snapshot and index publication can happen before the main map file is written. If that final write fails, an unreferenced content-addressed snapshot may remain; this is safe and it can be reused by a later save or cleanup pass.

Common pitfalls

  • A .pxntilemap alone is refs-only. It is not a self-contained distribution — keep the project assets with it.
  • If a runtime asset at the exact pinned hash is missing, the snapshot cannot be pinned and the save fails; resolve the missing asset and retry.

Related nodes

  • tile_canvas_load
  • tile_palette_save
  • tile_asset_save
Back to Node List
Tile Canvas Save — PixPipeline Node Reference