List (vuo.list)

Nodes for creating, rearranging, and selecting items from lists.

Lists keep their items in a specific order. For example, in this list of texts…

• pumpkin
• apple
• rhubarb

… item 1 is pumpkin, item 2 is apple, and item 3 is rhubarb. As the list is sent through a composition, the items stay in that order.

Example compositions:

• Add Effect to Instant Replay: Toggles between a live video feed from your iSight camera and an instant replay. Some color effects are added to the instant replay.
• Cycle Seasons: With each click of the mouse, shows the next item in a list.
• Display Grid Of Images: Displays a set of images as layers arranged in a grid.
• Display Rainbow Ovals: Displays a grid of randomly colored ovals.
• Insert Square: Inserts a square into a row of circles at the position where the mouse is.
• Reorder Ranges of Items: Displays two rows of rectangles, one derived from the other by swapping the first few and last few items.
• Replace Colors in Gradient: Every one second, replaces one of the colors in the gradient with a randomly chosen color.
• Reverse Gradient: Reverses the order of colors in the gradient each time the mouse is clicked.
• Select Layer from List: Allows you to use the keyboard to select one image, out of a group of images, to display specially.
• Shift Squares: Repeatedly shifts the squares to the left, moving the leftmost square to the rightmost slot.
• Shuffle Letters: Gradually unscrambles a sequence of letters to reveal words.
• Splice Squares: Takes some squares from the right side of the row, and then adds squares one at a time from the left side and puts them together in the bottom row.
• String Alternating Beads: Displays two rows of spheres, with colors alternating in a pattern across each row.
• String Repeating Beads: Displays a row of spheres with different colors for the left third, middle third, and right third of the row.
• Successively Posterize Image: Displays posterized versions of an image with increasing numbers of colors. Image by Ashim D’Silva on Unsplash.
• Wobble Eggs: Displays a row of ovals, with each rotating back and forth at its own randomly chosen pace.

Nodes:

• Add to List (vuo.list.add): Places an item either before the first or after the last item in a list.
• Append Lists (vuo.list.append): Combines the items from the input lists into a single output list.
• Build List (vuo.list.build): Fires multiple events, and collects the results into a list.
• Change Item in List (vuo.list.change): Replaces an item in a list.
• Comb List (vuo.list.comb): Selects alternating items from a list.
• Copy List Item Groups (vuo.list.spread.group): Duplicates groups of sequential items in a list.
• Copy List Items (vuo.list.spread): Duplicates each item in a list.
• Count Items in List (vuo.list.count): Gives the number of items in the list.
• Cut List (vuo.list.cut): Outputs part of the input list.
• Cycle through List (vuo.list.cycle2): Steps forward or backward through a list and outputs the current list item.
• Deinterleave Lists (vuo.list.deinterleave): Splits the items from the input list into two output lists, alternating between the two lists.
• Enqueue (vuo.list.enqueue): Keeps track of a list of items.
• Get First Item in List (vuo.list.get.first): Outputs the first item in the list.
• Get Item Ranges from List (vuo.list.get.range): Selects items that fall within specified ranges in a list.
• Get Item from List (vuo.list.get): Selects one item from a list.
• Get Items from List (vuo.list.get.multiple): Selects multiple items from a list.
• Get Last Item in List (vuo.list.get.last): Outputs the last item in the list.
• Get Random Item from List (vuo.list.get.random): Randomly selects an item from the list to output.
• Insert in List (vuo.list.insert): Adds an item to a list.
• Interleave List Item Groups (vuo.list.interleave.group): Combines the items from the input lists into a single output list, alternating between the two lists in groups.
• Interleave Lists (vuo.list.interleave): Combines the items from the input lists into a single output list, alternating between the two lists.
• Is List Populated (vuo.list.populated): Outputs true if the list contains at least one item.
• Process List (vuo.list.process): Fires an event for each item in the input list, and collects the results into a new list.
• Remove Duplicates (vuo.list.removeDuplicates): Ensures each item is unique within the list by removing duplicate items.
• Reverse List (vuo.list.reverse): Reverses the order of the items in the list.
• Shuffle List (vuo.list.shuffle): Randomly reorders the items in a list.
• Sort List (vuo.list.sort): Sorts a list by its items' values.
• Summarize List Items (vuo.list.summarize): Outputs a short text description of each item in the list, separated by linebreaks.
• Take from List (vuo.list.take): Removes either the first or last item from a list.
• Wrap List (vuo.list.wrap): Shifts the starting point of a list, wrapping the values from the end back to the beginning.