List Unpack

Overview

Splits a list into individual output ports (the reverse of list_create). Use it to separate list elements into different wires and send each one through different processing or previews.

Usage tips

• Its main use is distribution where each element has a different role, such as splitting a four-color palette into four wires and assigning each color to a different part.
• If every element gets the same processing, use list_map; there is no need to split the list. Unpack only when the processing differs by element.
• The slot count (the count parameter) is at most 16. Elements beyond that are not output, so use list_slice first if you need to select a range.

Related nodes

• list_create — reverse direction (individual values → list)
• list_get — when one element is enough
• channel_split — a similar operation for image channels
• palette_get — a more direct choice for one color from a palette

Technical details

• item_type links the type of the list input and each item_n output.
• count is the number of visible output slots, separate from the actual list length.
• The count output returns the number of elements in the list that arrived.
• A Palette can be unpacked as List<Color>.
• Any can unpack mixed lists, but downstream nodes may warn about type mismatches.

Examples

• Split a List<Image> into outputs for multiple previews or branches.
• Unpack a color palette and send each color to a separate node.
• Use the count output so another node can read the current number of valid candidates.