Back to Node List

Tile Canvas Load

tile_canvas_load

Loads a .pxntilemap with pinned TileAsset dependencies.

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
タイルパレット
tile_palette
TilePalette
タイルパレットの参照・配置です。解決済み素材はexact snapshotへ固定し、未解決参照はplaceholderのまま保持します。
追加素材
additional_assets
List<TileAsset>
追加タイル素材候補です。マップ依存のcontent hashと完全一致する候補だけを採用します。

Output Ports

NameTypeDescription
タイルキャンバス
canvas
TileCanvas
固定されたexact素材を持つタイルマップです。欠損・新revisionだけの依存はplaceholderで保持します。
警告
warnings
Text
severity・code・message key・文書path・cell/layer・素材識別子を可能な範囲で含む診断です。

Parameters

NameTypeDefaultRangeDescription / Options
ファイル
path
FilePath

.pxntilemap ファイルのパスです。

Overview

Loads a .pxntilemap and restores its pinned TileAsset dependencies from upstream inputs or project snapshots.

Usage tips

  • Wiring tile_palette_loadtile_canvas_load makes upstream assets with the same exact hash the first choice.
  • Pass assets outside the palette to additional_assets as a List<TileAsset>.
  • Without an exact upstream match, project snapshots are used; assets with a different hash are never adopted automatically.

Common pitfalls

  • Connecting only a newer revision does not replace the old pinned hash. Confirm the update and re-save, or restore the matching snapshot.
  • Cells and layers are never deleted on missing diagnostics — they stay as placeholders you can re-link later.

Related nodes

  • tile_canvas_save
  • tile_palette_load
  • tile_asset_load
Back to Node List
Tile Canvas Load — PixPipeline Node Reference