リスト展開

list_unpack

リストの要素を個別に出力します

確認済み

解説あり

入力ポート

名前	型	説明
リスト list	List<Number> 必須	展開するリスト

出力ポート

名前	型	説明
要素 0 item_0	Number	リストの要素 0
要素 1 item_1	Number	リストの要素 1
要素 2 item_2	Number	リストの要素 2
要素 3 item_3	Number	リストの要素 3
要素数 count	Int	リストの要素数

パラメータ

名前型既定値範囲説明・選択肢

名前	型	既定値	範囲	説明・選択肢
要素の型 item_type	Enum	Number	—	このノードが展開するリスト要素の型を選びます。Any は上級者向けです。数値（汎用）`Number` Float と Int の両方を扱える数値リストです小数`Float` 小数値のリストです整数`Int` 整数値のリストです ON/OFF`Bool` ON/OFF のリストです色`Color` 色のリストです文字`Text` 文字のリストです画像`Image` 画像のリストですパス`Path` パスのリストですピクセル線`PixelLine` ピクセル線のリストです Vec2`Vec2` 2D ベクトルのリストです Vec3`Vec3` 3D ベクトルのリストです OKLCH補正`OklchAdjust` OKLCH基準の明るさ・鮮やかさ・色相・透明度の補正セットのリストですパレット`Palette` パレットのリストですリスト`List` リストのリストを作りますマップ`Map` マップのリストです文字レイアウト`TextLayout` 文字レイアウトのリストですピクセルパッチ`PixelPatch` ピクセルパッチのリストです記録レイヤー`RecordedLayer` 記録レイヤーのリストですアニメーションクリップ`AnimationClip` アニメーションクリップのリストです Asepriteファイル`AsepriteFile` Aseprite document のリストですルールグリッド`RuleGridSpec` RuleGridSpec のリストですルールタイルセット`RuleTileSet` RuleTileSet のリストですルールタイル素材`RuleTileAsset` RuleTileAsset のリストですルールセット`RuleSet` RuleSet のリストですルールキャンバス`RuleCanvas` RuleCanvas のリストです解決済みルール配置`RuleResolved` RuleResolved のリストですルールタイルアトラス`RuleTileAtlas` RuleTileAtlas のリストです 9スライス`NineSlice` 9スライスUI素材のリストです 2D FX 状態`FxState2D` FxState2D のリストですスプライトシート`SpriteSheet` スプライトシートのリストですバリアントスナップショット`VariantSnapshot` variant snapshot のリストですバリアントレシピ`VariantRecipe` variant recipe のリストですバリアントレコード`VariantRecord` variant record のリストです IsoItem`IsoItem` IsoItem のリストです IsoScene`IsoScene` IsoScene のリストです IsoWorld`IsoWorld` IsoWorld のリストですタイル素材`TileAsset` タイル素材のリストです(tile_palette_create の入力などに使います) タイルパレット`TilePalette` タイルパレットのリストですタイルマップ`TileCanvas` タイルマップのリストです解決済みタイル配置`TileResolved` 解決済みタイル配置のリストです Any（上級者向け）`Any` 上級者向けです。どの型でも混ぜられますが、取り出した値の型が下流ノードの期待と合わないと実行時エラーになります。
出力数 count	Int	4	1–16	出力スロットの数

要素の型

item_type

Enum

Number

—

このノードが展開するリスト要素の型を選びます。Any は上級者向けです。

数値（汎用）Number
Float と Int の両方を扱える数値リストです
小数Float
小数値のリストです
整数Int
整数値のリストです
ON/OFFBool
ON/OFF のリストです
色Color
色のリストです
文字Text
文字のリストです
画像Image
画像のリストです
パスPath
パスのリストです
ピクセル線PixelLine
ピクセル線のリストです
Vec2Vec2
2D ベクトルのリストです
Vec3Vec3
3D ベクトルのリストです
OKLCH補正OklchAdjust
OKLCH基準の明るさ・鮮やかさ・色相・透明度の補正セットのリストです
パレットPalette
パレットのリストです
リストList
リストのリストを作ります
マップMap
マップのリストです
文字レイアウトTextLayout
文字レイアウトのリストです
ピクセルパッチPixelPatch
ピクセルパッチのリストです
記録レイヤーRecordedLayer
記録レイヤーのリストです
アニメーションクリップAnimationClip
アニメーションクリップのリストです
AsepriteファイルAsepriteFile
Aseprite document のリストです
ルールグリッドRuleGridSpec
RuleGridSpec のリストです
ルールタイルセットRuleTileSet
RuleTileSet のリストです
ルールタイル素材RuleTileAsset
RuleTileAsset のリストです
ルールセットRuleSet
RuleSet のリストです
ルールキャンバスRuleCanvas
RuleCanvas のリストです
解決済みルール配置RuleResolved
RuleResolved のリストです
ルールタイルアトラスRuleTileAtlas
RuleTileAtlas のリストです
9スライスNineSlice
9スライスUI素材のリストです
2D FX 状態FxState2D
FxState2D のリストです
スプライトシートSpriteSheet
スプライトシートのリストです
バリアントスナップショットVariantSnapshot
variant snapshot のリストです
バリアントレシピVariantRecipe
variant recipe のリストです
バリアントレコードVariantRecord
variant record のリストです
IsoItemIsoItem
IsoItem のリストです
IsoSceneIsoScene
IsoScene のリストです
IsoWorldIsoWorld
IsoWorld のリストです
タイル素材TileAsset
タイル素材のリストです(tile_palette_create の入力などに使います)
タイルパレットTilePalette
タイルパレットのリストです
タイルマップTileCanvas
タイルマップのリストです
解決済みタイル配置TileResolved
解決済みタイル配置のリストです
Any（上級者向け）Any
上級者向けです。どの型でも混ぜられますが、取り出した値の型が下流ノードの期待と合わないと実行時エラーになります。

出力数

count

Int

1–16

出力スロットの数

概要

リストを個別の出力ポートにバラすノードです(list_create の逆)。リストの中身を別々の配線に分けて、それぞれ違う加工・プレビューへ流したい時に使います。

使い方のポイント

「4色パレットを4本の配線に分けて、それぞれ別のパーツの色にする」のような 要素ごとに役割が違う分配が主用途
全要素に同じ処理をするなら list_map(バラす必要がない)。バラすのは処理が要素ごとに異なる時だけ
スロット数(count パラメータ)は最大16。リストがそれより長い分は出力されないので、必要なら list_slice で先に範囲を選ぶ

技術詳細

item_type で list 入力と各 item_n 出力の型が連動します
count は「表示する出力スロット数」で、実際のリスト長とは別です
count 出力は実際に届いたリストの要素数を返します
Palette は List<Color> として展開できます
Any を選ぶと混在リストも展開できますが、下流で型不一致の警告が出る可能性があります

使用例

List<Image> を個別出力して複数のプレビューや分岐に渡す
色パレットを展開して各色を個別ノードへ送る
count 出力を使って、現在有効な候補数を別ノードで参照する