Yotsuba Games
Back to Node List

Ase Frame Select

ase_frame_select

Extracts one composited frame image from an 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
Aseprite
ase
AsepriteFile
Required
ๅ…ƒใฎ Aseprite document ใงใ™ใ€‚

Output Ports

NameTypeDescription
็”ปๅƒ
image
Image
้ธๆŠžใƒ•ใƒฌใƒผใƒ ใ‚’ๅˆๆˆใ—ใŸ็”ปๅƒใงใ™ใ€‚
่กจ็คบๆ™‚้–“(ms)
duration_ms
Int
้ธๆŠžใƒ•ใƒฌใƒผใƒ ใฎ่กจ็คบๆ™‚้–“ใงใ™ใ€‚
ใƒ•ใƒฌใƒผใƒ ็•ชๅท
frame_index
Int
ๅฎŸ้š›ใซไฝฟใ‚ใ‚ŒใŸใ‚ฏใƒฉใƒณใƒ—ๅพŒใฎใƒ•ใƒฌใƒผใƒ ็•ชๅทใงใ™ใ€‚
ๆฆ‚่ฆ
summary
Text
้ธๆŠžใƒ•ใƒฌใƒผใƒ ใฎ็Ÿญใ„ๆฆ‚่ฆใงใ™ใ€‚

Parameters

NameTypeDefaultRangeDescription / Options
ใƒ•ใƒฌใƒผใƒ 
frame
Int
00โ€“4096

ๅ–ใ‚Šๅ‡บใ™ 0 ๅง‹ใพใ‚Šใฎใƒ•ใƒฌใƒผใƒ ็•ชๅทใงใ™ใ€‚

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 frame to 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_select first.
  • 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 document
  • ase_layer_select โ€” narrows the layers upstream
  • image_to_aseprite โ€” writes a processed image back into a document
  • ase_tags โ€” obtains frame ranges from tag information

Read this first

  • This is the node that turns an AsepriteFile into a regular Image.
  • 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_load had to fall back from an unknown blend mode to normal, inspect that node's warnings output.
  • To handle every frame as a sprite sheet, combine it with the P07A sprite-sheet nodes or use the upcoming Aseprite animation workflow.
Back to Node List
Ase Frame Select โ€” PixPipeline Node Reference