ノード一覧に戻る

タイル素材保存

tile_asset_save

タイル素材を自己完結した .pxntile ファイルとして保存します。

確認済み
解説あり

入力ポート

名前説明
タイル素材
asset
TileAsset
必須
自己完結 .pxntile として保存するタイル素材です。ライブ参照は保存時に実体化できる必要があります。

出力ポート

名前説明
概要
summary
Text
保存結果の短いまとめです。

パラメータ

名前既定値範囲説明・選択肢
保存先
path
FilePath

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

保存モード
save_mode
Enum
Disabled

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

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

概要

TileAssetを画像source込みの自己完結 .pxntile として固定します。別projectでも元ノードなしで再読込したいときに使います。

使い方のポイント

  • TileAssetを作るノードから asset へ接続し、保存時だけ save_modeCreateIfMissing または Overwrite にします。
  • 既存ファイルを守る場合は CreateIfMissing を選びます。既存内容は解析せず、そのまま already-exists を返します。
  • Overwrite は解析可能な対応 .pxntile だけを置換します。破損・別形式・将来versionのファイルは強制置換しません。
  • 保存後は tile_asset_load で読込み、同じ素材hashと画像が戻ることを確認できます。

よくある失敗

  • Disabled のままでは書き込みません。通常評価中の意図しない再保存を防ぐ既定値です。
  • runtime source画像が欠けた素材は自己完結化できません。上流画像を接続し直してから保存してください。

関連ノード

  • tile_asset_load
  • tile_palette_save
  • tile_canvas_save
ノード一覧に戻る
タイル素材保存 — PixPipeline ノード解説