Overview
Extracts one composited frame as a regular Image from an Aseprite document.
This is the boundary where the contents of an .aseprite file enter
PixPipeline's image-node pipeline.
Usage tips
- The basic Aseprite workflow is
aseprite_load โ (ase_layer_select) โ ase_frame_select โ image processing. To narrow the layers, place the layer selection before frame selection. - Promote
frameto an input pin ๐ to step through an Aseprite animation from the PixPipeline side. - The output is the fully composited appearance. If you need a specific layer,
narrow it with
ase_layer_selectfirst. - Composition applies the known Aseprite blend modes and treats parent Group visibility, opacity, and blending as a hierarchy rather than ignoring them.
Related nodes
aseprite_loadโ supplies the documentase_layer_selectโ narrows the layers upstreamimage_to_asepriteโ writes a processed image back into a documentase_tagsโ obtains frame ranges from tag information
Read this first
- This is the node that turns an
AsepriteFileinto a regularImage. - Use it as the boundary when connecting Aseprite data to existing PixPipeline image nodes.
Basic workflow
AsepriteLoad
-> AseFrameSelect
-> Preview
This previews the first frame of the .aseprite file as-is.
Example with selected layers
AsepriteLoad
-> AseLayerSelect
-> AseFrameSelect
-> Outline
-> Preview
This wiring:
- keeps only the layers you need,
- converts the selected frame to an image, and
- processes it with regular image nodes.
Example
frame = 3
In this case:
- the fourth frame is emitted from
image, and - that frame's display time is emitted from
duration_ms.
If the source document has only two frames, the index is automatically clamped to the valid range.
When to use it
- To process one Aseprite frame as a regular image
- To preview the result after narrowing the layers
- To reference an Aseprite frame duration in the graph
Notes
- The node outputs only one frame.
- If
aseprite_loadhad to fall back from an unknown blend mode tonormal, inspect that node'swarningsoutput. - To handle every frame as a sprite sheet, combine it with the P07A sprite-sheet nodes or use the upcoming Aseprite animation workflow.