How events and data travel through a composition

Abstract

Events are what make things happen in a composition

Events are what make things happen in a composition. As you get to know Vuo, you’ll be able to look at a composition and imagine how an event comes out of a trigger port, flows through a cable into a node’s input port, and either gets blocked or flows through the node’s output ports and into the next cables. The previous section gave an overview of how that works. This section describes the process in detail.

Where events come from

Each event is fired from a trigger port, a special kind of output port on a node.

Some trigger ports fire events in response to things happening in the world outside your composition. For example, the Receive Mouse Moves node’s trigger port fires an event each time the mouse is moved. The Play Movie node’s trigger port fires a rapid series of events (for example, 30 per second), so that you can display images in rapid sequence as a movie. Similarly, the Fire on Display Refresh node’s Refreshed at Time trigger port fires a rapid series of events, so that you can use these events to display graphics in rapid sequence as an animation.

Other trigger ports fire events in response to things happening within the composition. For example, the Fire on Start node’s trigger port fires an event when the composition starts. The Fire Periodically node’s trigger port fires events at a steady rate while the composition is running. A node’s trigger port can even fire in response to an event received by the node, as happens with the Spin Off Event node. (However, this is a different event than the one that was received by the node. For more information, see the section Run slow parts of the composition in the background.)

Some nodes block events until a certain condition is met. The node Became True, for example, only lets an event through when the condition changes from false to true. These nodes are not trigger nodes, since they don’t create events, but they control when events are output.