11.3. Running a composition

After you’ve built your composition (or while you’re building it), you can run it to see it in action.

11.3.1. Starting and stopping a composition

You can run a composition by clicking the Run button. (Or go to Run > Run.)

You can stop a composition by clicking the Stop button. (Or go to Run > Stop.)

If you start a composition that was created using New Composition with Protocol, then extra functionality will be added to the composition to help you preview it. Its protocol published input ports will receive data and events, and its protocol published output ports will send their data and events to a preview window. For example, if you run a composition with the Image Filter protocol, then image and time data will be fed into the composition, and the composition’s image output will be rendered to a window.

11.3.2. Firing an event manually

As you’re editing your running composition, you may want to fire extra events so that your changes become immediately visible, rather than waiting for the next time a trigger port happens to fire.

You can cause a trigger port to fire an event by right-clicking on the trigger port to pop up a menu, then choosing Fire Event. Or you can hold down while left-clicking on the trigger port. If the trigger port carries data, it outputs its most recent data along with the event.

You can also fire an event directly into an input port (as if it had an incoming cable from an invisible trigger port). To do this, you can right-click on the input port and choose Fire Event, or you can hold down and left-click on the input port.

If you’ve already manually fired an event, you can fire another event through the same port by going to Run > Re-fire Event. This fires an event through the trigger port or input port that most recently had an event manually fired.

11.3.3. Understanding and troubleshooting a running composition

The Vuo Editor has several helpful tools, such as the Show Events mode and Port popovers to help you understand in more depth what is happening in your composition. These features can help you see exactly what events and data are flowing through your composition. For more information on troubleshooting steps see the section on Troubleshooting.