Overview
Takes one element at position N from a list. It is an exit point for list-based workflows, selecting one candidate (image, number, color, and so on) from a bundle.
Usage tips
- Promote
indexto an input pin 📌 and connect an integer that changes over time to cycle through the list (frame-by-frame animation or color cycling). - This is also a common conversion point for taking one value from a list produced
by
variant_rangeand returning to ordinary wiring. - For a small set of manually arranged candidates,
value_selectis more direct because it does not require a list.
Related nodes
list_create— create the source listvalue_select— N-way selection without a listint_input— external control for the indexlist_slice/list_filter— when you need a subsequence rather than one element
Read this first
List Getselects exactly one candidate.- Indices are zero-based: the first element is
0, the second is1.
Start with this example
Suppose the input list is:
[10, 20, 30]
Example 1: index = 1
item = 20
Example 2: index = 0
item = 10
Example 3: index = 99
An out-of-range index does not produce an error; it is clamped to the last element.
item = 30
When to use it
- When you want to take exactly one item from a set of candidates
- When you want to use only one image from a group assembled with
List Create - When you want to drive the index with an
Intnode or animation to switch the selection
Notes
- The upper limit of the Inspector's
indexslider adjusts automatically to the list length. - An empty list produces no output, so no value flows downstream.
- A
Palettecan be treated asList<Color>.