List Get

list_get

Selects a single element from a list by index. Out-of-range indices are clamped.

Draft

Guide available

The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

Name	Type	Description
リスト list	List<Number> Required	要素を選ぶ対象のリストです

Output Ports

Name	Type	Description
要素 item	Number	選ばれた要素です

Parameters

Name Type Default Range Description / Options

Name	Type	Default	Range	Description / Options
要素の型 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 のリストです Any（上級者向け）`Any` 上級者向けです。どの型でも混ぜられますが、取り出した値の型が下流ノードの期待と合わないと実行時エラーになります。
インデックス index	Int	0	0–1024	取得する要素の番号です（0始まり）。📌 で入力ピン化して動的に切り替えられます。

要素の型

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 のリストです
Any（上級者向け）Any
上級者向けです。どの型でも混ぜられますが、取り出した値の型が下流ノードの期待と合わないと実行時エラーになります。

インデックス

index

Int

0–1024

取得する要素の番号です（0始まり）。📌 で入力ピン化して動的に切り替えられます。

まず大事なこと

ListGet は、候補の中から 1 件だけ選ぶ ノードです
0 始まりなので、1 件目は 0、2 件目は 1 です

まずはこの例

入力リストがこうだとします。

[10, 20, 30]

例1: `index = 1`

item = 20

例2: `index = 0`

item = 10

例3: `index = 99`

範囲外でもエラーにはならず、末尾にクランプされます。

item = 30

どういう時に使うか

候補を 1 つだけ抜き出したい時
List Create でまとめた画像の中から 1 枚だけ使いたい時
Int ノードやアニメーションで index を動かして選択を切り替えたい時

注意

リスト長に応じて Inspector の index スライダー上限が自動調整されます
空リストが来た場合は出力せず、下流に値を流しません
Palette は List<Color> として扱えます

Back to Node List