ノード一覧に戻る

タイルキャンバス読込

tile_canvas_load

固定されたタイル素材依存を持つ .pxntilemap を読み込みます。

確認済み
解説あり

入力ポート

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

出力ポート

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

パラメータ

名前既定値範囲説明・選択肢
ファイル
path
FilePath

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

概要

.pxntilemap を読み込み、固定されたTileAsset依存を上流入力またはproject snapshotから復元します。

使い方のポイント

  • tile_palette_load → tile_canvas_load と接続すると、同じexact hashの上流素材が最優先で使われます。
  • palette外の素材は additional_assetsList<TileAsset> として渡します。
  • 上流に完全一致がなければproject snapshotを使い、異なるhashは自動採用しません。

よくある失敗

  • 新しいrevisionだけを接続しても古い固定hashは置換されません。更新を確定して保存し直すか、対応snapshotを戻してください。
  • missing診断があってもcellやlayerは削除されません。placeholderのまま再リンクできます。

関連ノード

  • tile_canvas_save
  • tile_palette_load
  • tile_asset_load
ノード一覧に戻る
タイルキャンバス読込 — PixPipeline ノード解説