Back to Node List

Ase Tags

ase_tags

Extracts Aseprite animation tags as a list of maps.

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
タグ一覧
tags
List<Map>
タグを map のリストとして返します。
タグ数
count
Int
タグ数です。
概要
summary
Text
抽出したタグの短い概要です。

Overview

Extracts Aseprite animation tags (ranges such as idle and walk) as a List. Because tag names, frame ranges, and playback directions become data, you can automate range-based work such as processing only the walk frames.

Usage tips

  • A practical workflow is to filter with list_filter, for example name == "walk", then use from_frame / to_frame to control the frame input of ase_frame_select.
  • To inspect the tag structure, use list_get to view one item at a time.

Related nodes

  • aseprite_load — supplies the document
  • list_get / list_filter / list_map — process the tag data
  • ase_frame_select — consumes the frame range

Read this first

  • tags is a List<Map>, not text.
  • You can therefore connect it directly to the P08/P09 nodes:
    • ListGet
    • ListMap
    • ListFilter

Contents of tags

Each tag is a Map with the following keys.

key Type Meaning
name Text Tag name
from_frame Int Zero-based start frame
to_frame Int Zero-based inclusive end frame
direction Text One of forward, reverse, ping_pong, or ping_pong_reverse
repeat Int Repeat count

Basic workflow

AsepriteLoad
  -> AseTags
  -> ListGet

This selects one tag so you can inspect its contents.

Example

If the Aseprite document has two tags:

  • idle
  • walk

then tags conceptually contains:

[
  {
    "name": "idle",
    "from_frame": 0,
    "to_frame": 3,
    "direction": "forward",
    "repeat": 0
  },
  {
    "name": "walk",
    "from_frame": 4,
    "to_frame": 11,
    "direction": "forward",
    "repeat": 0
  }
]

When to use it

  • To reference Aseprite tag data from the graph
  • To retain only a specific tag with ListFilter
  • To pass tag names or frame ranges to the UI or variants

Notes

  • v1 only reads tag data.
  • The tag range is from_frame..=to_frame, including both endpoints.
  • Advanced workflows that edit and write tags back are planned for a later stage.
Back to Node List
Ase Tags — PixPipeline Node Reference