Build List (vuo.list.build)

Fires multiple events, and collects the results into a list.

This node is useful for creating a list of items in which each item is built using the same (or similar) sequence of steps. For example, you could use this node to create a list of ovals, with each oval built using the same sequence of nodes, but each oval having a different color. This is simpler and more flexible than copying and pasting the same sequence of nodes multiple times into your composition — you can easily change the number of iterations and the sequence of steps performed for each iteration.

If the Fire port’s value is not greater than 0 when it receives an event, no events are fired from Build Item. Instead, Built List immediately fires a event with an empty list.

If the Fire port receives an event while the node is still building the list for the previous Fire event, then the later Fire event is ignored (dropped). To avoid having events ignored, you can modify your composition to limit the rate at which events hit this node.

Keywords: bang, cycle, each, events, fire, foreach, iterate, loop, many, multiple, repeat, trigger, while


Example compositions:


Back to vuo.list node set documentation.