ノード一覧に戻る

Aseタグ

ase_tags

Aseprite のアニメーションタグを map のリストとして取り出します。

確認済み
解説あり

入力ポート

名前説明
Aseprite
ase
AsepriteFile
必須
元の Aseprite document です。

出力ポート

名前説明
タグ一覧
tags
List<Map>
タグを map のリストとして返します。
タグ数
count
Int
タグ数です。
概要
summary
Text
抽出したタグの短い概要です。

概要

Aseprite のアニメーションタグ(idle / walk 等の区間情報)を List で 取り出すノードです。タグ名・フレーム範囲・再生方向をデータとして扱えるので、 「walk のフレームだけ処理する」ような区間指定の自動化に使えます。

使い方のポイント

  • list_filtername == "walk" のように絞り、from_frame / to_framease_frame_select の frame 制御に使うのが実践形
  • タグ構成の確認だけなら list_get で1件ずつ見るのが手軽

関連ノード

  • aseprite_load — document の供給元
  • list_get / list_filter / list_map — タグデータの加工
  • ase_frame_select — フレーム範囲の使い先

まず大事なこと

  • tags は text ではなく List<Map> です
  • そのため、P08/P09 の
    • ListGet
    • ListMap
    • ListFilter へそのままつなげます

tags の中身

各 tag は次の key を持つ Map です。

key 意味
name Text tag 名
from_frame Int 0 始まりの開始フレーム
to_frame Int 0 始まりの終了フレーム。このフレームも区間に含みます
direction Text forward, reverse, ping_pong, ping_pong_reverse のいずれか
repeat Int repeat 回数

一番基本の使い方

AsepriteLoad
  -> AseTags
  -> ListGet

これで tag を 1 件選んで中身を確認できます。

もし Aseprite 側に

  • idle
  • walk

の 2 つの tag があるなら、tags は概念的にこうなります。

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

どういう時に使うか

  • Aseprite の tag 情報を graph 側で参照したい時
  • 特定の tag だけを ListFilter で残したい時
  • tag 名や frame 範囲を UI や variant 側へ渡したい時

注意

  • v1 は tag 情報を読むだけです
  • from_frame..=to_frame がタグの範囲で、両端を含みます
  • tag を編集して書き戻す高度な workflow は後段です
ノード一覧に戻る
Aseタグ — PixPipeline ノード解説