Yotsuba Games
Back to Node List

Aseprite Export

aseprite_export

Writes an Aseprite document to disk when save mode allows it.

Draft
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
Aseprite
ase
AsepriteFile
Required
保存したい Aseprite document です。

Output Ports

NameTypeDescription
Aseprite
ase
AsepriteFile
そのまま流した Aseprite document です。

Parameters

NameTypeDefaultRangeDescription / Options
パス
path
FilePath
——

保存先の `.ase` / `.aseprite` パスです。

保存モード
save_mode
Enum
Disabled—

どの条件で実際に保存するかを切り替えます。

  • 無効Disabled
    ファイルへ書き込みません。
  • 新規のみCreateIfMissing
    ファイルが無い時だけ保存します。
  • 上書きOverwrite
    既存ファイルも上書き保存します。

保存モード

  • Disabled
    • 保存しません
  • CreateIfMissing
    • まだファイルが無い時だけ保存します
  • Overwrite
    • 既存ファイルも上書きします
    • ただし bytes が同じ時は無駄な再保存をしません

まず大事なこと

  • このノードは side-effect node です
  • つまり、評価の中で実際にファイルを書きます
  • 誤保存を避けるため、最初は Disabled です

一番基本の使い方

AsepriteLoad
  -> AseLayerSelect
  -> AsepriteExport

この形なら、Aseprite を読み込んで、必要なレイヤーだけ残した結果を別ファイルへ保存できます。

加工した画像を戻す例

AsepriteLoad
  -> AseFrameSelect
  -> Outline
  -> ImageToAseprite
  -> AsepriteExport

この流れなら、Aseprite から取り出した 1 フレーム画像を加工して、その結果を flat な Aseprite として保存できます。

スプライトシートを書き戻す例

FxBakeSpriteSheet
  -> SpriteSheetToAseprite
  -> AsepriteExport

この形なら、PixPipeline 側で作ったアニメーションを Aseprite のタイムラインとして保存できます。

どういう時に使うか

  • Aseprite 由来の layer / frame を選別した結果を書き戻したい時
  • graph の中で作った AsepriteFile を外へ保存したい時
  • ImageToAseprite や SpriteSheetToAseprite で作った flat document を保存したい時

例

  • path = hero_body_only.aseprite
  • save_mode = Overwrite

この時、評価で ase 入力の document がそのパスへ保存されます。
保存が実行された場合は _saved = true になります。

対応範囲と読み捨てられるもの

  • 出力ファイルのカラーモードは常に RGBA です。入力 document が Indexed 由来でも、インデックス情報は復元されません。
  • Normal / Group レイヤー、フレーム、タグ、パレットを出力します。透明ピクセルだけのセルはファイルへ書きません。
  • セルの元の x/y オフセット、セル不透明度、linked cel のリンク構造は、読み込み時にキャンバス画像へ実体化されているため復元されません。
  • Tilemap の内容、スライス、ユーザーデータは出力対象外です。
  • 未知の blend mode は normal にフォールバックします。

注意

  • path が空の時は保存しません
  • v1 では Aseprite の全 metadata を完全往復することは目的にしていません
  • 特に editor 固有の細かい設定までは保持しないことがあります
  • PixPipeline の中で「読んで、選んで、保存する」基本 I/O を成立させるのがこの段階の役割です
Back to Node List