Ase Layer Select

Name	Type	Description
Aseprite ase	AsepriteFile Required	元の Aseprite document です。

Name	Type	Description
Aseprite ase	AsepriteFile	選択後の Aseprite document です。
レイヤー数 layer_count	Int	選択後に残ったレイヤー数です。階層維持のため残した祖先も含みます。
概要 summary	Text	選択後 document の短い概要です。

Parameters

Name	Type	Default	Range	Description / Options
選択方法 selection_mode	Enum	Index	—	対象レイヤーの選び方です。番号`Index` レイヤー番号で選択します。名前`Name` 名前が一致する最初のレイヤーを選択します。
レイヤー番号 layer_index	Int	0	0–1024	Index モードで使う 0 始まりのレイヤー番号です。
レイヤー名 layer_name	Text	—	—	Name モードで使うレイヤー名です。
子レイヤーも含める include_children	Bool	true	—	選択したレイヤーの子孫レイヤーも残します。階層維持に必要な祖先は、この設定にかかわらず常に残ります。

Overview

Narrows an Aseprite document to one layer, optionally including its children. The output remains an AsepriteFile; ase_frame_select converts it to an image downstream. Use this to extract parts such as "body only" or "everything except guides."

Usage tips

The standard order is aseprite_load → ase_layer_select → ase_frame_select. "Narrow the layers, then convert to an image" makes the intent clear.
Selection by name (Name) is more resilient to layer-structure changes. Index selection can shift when layers are reordered.
Enable include_children to select an entire folder.

Related nodes

ase_frame_select — converts the narrowed document to an image; usually used together
aseprite_load — supplies the document
aseprite_export — saves the narrowed document

Read this first

This node does not return an image.
Its output remains an AsepriteFile.
Its role is to narrow an Aseprite document; the following AseFrameSelect performs the image conversion.

Most natural wiring

AsepriteLoad
  -> AseLayerSelect
  -> AseFrameSelect
  -> Preview

Selecting the layers before extracting a frame makes the intent easier to follow.

When to use it

To extract only the body of a character
To remove UI or guide layers
To keep all layers grouped under a folder

Example 1: Select by index

selection_mode = Index
layer_index = 2
include_children = true

This returns an AsepriteFile that:

selects the third layer, and
retains its child layers.

Example 2: Select by name

selection_mode = Name
layer_name = body
include_children = false

This keeps:

the first layer whose name matches body, and
any ancestors required to preserve its hierarchy.

Notes

Name selection uses the first match.
include_children controls descendants only. Ancestors required to preserve the hierarchy are always retained, even when it is false, and are included in layer_count.
A missing Index or Name returns a zero-layer document and shows a layer_not_found warning in the Inspector.
If you need a single image, connect AseFrameSelect after this node.

Input Ports

Output Ports