よつばゲームズ

ノード一覧に戻る

Aseprite読込

aseprite_load

`.ase` / `.aseprite` ファイルを読み込みます。

下書き

解説あり

出力ポート

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

パラメータ

名前	型	既定値	範囲	説明・選択肢
パス 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 を後ろにつなぐのが正しいです

ノード一覧に戻る