Back to Node List

Image To Aseprite

image_to_aseprite

Wraps one Image as a flat one-layer one-frame Aseprite document.

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

Input Ports

NameTypeDescription
画像
image
Image
Required
Aseprite document に包み直したい画像です。

Output Ports

NameTypeDescription
Aseprite
ase
AsepriteFile
1 レイヤー 1 フレームの flat な Aseprite document です。
フレーム数
frame_count
Int
このノードでは常に 1 です。
概要
summary
Text
変換後 document の短い概要です。

Parameters

NameTypeDefaultRangeDescription / Options
レイヤー名
layer_name
Text
Layer 1

生成する単一レイヤーの名前です。

表示時間(ms)
duration_ms
Int
1001–60000

Aseprite document 側に入れる 1 フレームの表示時間です。

Overview

Wraps a regular Image in an Aseprite document with one layer and one frame. Use it to save a still image created or processed in PixPipeline as .aseprite. The resulting document is flat and has no layer hierarchy.

Usage tips

  • The standard round trip is aseprite_load → ase_frame_select → (image processing) → image_to_aseprite → aseprite_export.
  • Use spritesheet_to_aseprite to write back an animation with multiple frames.

Related nodes

  • spritesheet_to_aseprite — the animation counterpart
  • aseprite_export — saves the document downstream; usually used together
  • ase_frame_select — converts in the opposite direction, document to Image

Read this first

  • This node does not restore the original Aseprite layer structure.
  • It wraps an Image in a new, flat Aseprite document.
  • Use it as the return path when you want to save a processed image in Aseprite format.

Basic workflow

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

This round trip:

  • extracts one frame from Aseprite,
  • processes it with image nodes, and
  • saves the result as a one-frame Aseprite document.

When to use it

  • To save an image processed after AseFrameSelect in Aseprite format
  • To pass a still image built with PixelCanvas, Preview, or related nodes to Aseprite
  • When one layer is enough and you simply need an .aseprite file

Example

  • layer_name = Body
  • duration_ms = 80

The input image becomes an Aseprite document with:

  • the layer name Body,
  • one frame, and
  • a display time of 80ms.

Notes

  • Multiple layers from the original Aseprite document are not restored.
  • Original tags and fine-grained editor metadata are not restored automatically.
  • Treat this as a node that simply wraps one image in Aseprite format.
Back to Node List
Image To Aseprite — PixPipeline Node Reference