Yotsuba Games
Back to Node List

Aseprite Load

aseprite_load

Loads an .ase or .aseprite document from disk.

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

Output Ports

NameTypeDescription
Aseprite
ase
AsepriteFile
読み込まれた Aseprite document です。
フレーム数
frame_count
Int
読み込まれた document の総フレーム数です。
レイヤー数
layer_count
Int
読み込まれた document の総レイヤー数です。
概要
summary
Text
読み込まれた document の短い概要です。
警告
warnings
Text
読み込み時に無視された未対応のAsepriteデータです。

Parameters

NameTypeDefaultRangeDescription / Options
パス
path
FilePath
——

読み込む `.ase` / `.aseprite` ファイルのパスです。

まず大事なこと

  • AsepriteLoad は 画像 1 枚を読むノードではありません
  • 出てくるのは Image ではなく、layer / frame / tag / palette をまとめて持つ AsepriteFile です
  • そのため、普通はこの後に
    • AseLayerSelect
    • AseFrameSelect
    • AsePalette
    • AseTags をつないで必要な情報だけ取り出します

一番基本の使い方

AsepriteLoad
  -> AseLayerSelect
  -> AseFrameSelect
  -> Preview

この形にすると、

  • .aseprite を読む
  • 欲しいレイヤーだけ残す
  • 欲しいフレームだけ Image にする

という流れを最短で試せます。

どういう時に使うか

  • 既存の Aseprite 絵を PixPipeline に持ってきたい時
  • layer 単位で取り出して加工したい時
  • frame 単位で画像を抜き出したい時
  • Aseprite の palette や tag を graph 側で再利用したい時

例

  • path = hero_walk.aseprite

この時 AsepriteLoad は、

  • 全フレーム
  • 全レイヤー
  • palette
  • tags

を含んだ AsepriteFile を返します。

ここから

  • AseFrameSelect
    • 1 フレームを Image にする
  • AsePalette
    • palette を取り出す
  • AseTags
    • tags を List<Map> にする

という使い方をします。

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

  • RGBA / Grayscale / Indexed の各カラーモードを読み込めます。Normal / Group レイヤー、タグ、パレットも保持します。
  • セルの x/y オフセットとセル不透明度はレイヤーごとのキャンバス画像へ焼き込まれます。linked cel はリンクではなく各フレームの実体画像になります。
  • Tilemap レイヤーはレイヤー情報だけが残り、タイル内容は読み捨てられます。検出時は warnings に警告が出ます。
  • スライスは読み捨てられ、検出時は warnings に警告が出ます。ユーザーデータも保持されません。
  • 未知の blend mode は normal として扱われ、warnings に警告が出ます。

注意

  • path が空の時は、空の default document を返します
  • このノードだけでは画像 1 枚になりません
  • 「まず見た目を出したい」時は、AseFrameSelect を後ろにつなぐのが正しいです
Back to Node List
Aseprite Load — PixPipeline Node Reference