Gate UI and Drop Gates			Pick List
Chapter 5, Getting Familiar with Your Workspace

The Pick List, Tools, and Views tabs display all the available tools you can add to compositions, as well as the views you can display. Tools and views are stored in their respective folders. When you click a tool category folder, the tools are displayed in the lower portion of the panel.

1. Middle-click or press the tilde (~) key to display the Gate UI.

2. Swipe through the east gate and select one of the tabs.

• In the Tools or Views tab, select an item from the lower portion of the panel, and drag it into a view. If you drag a tool into the Schematic view, you can drop it onto any connection to insert it in the dependency graph.

There are two types of tools: normal tools and super tools.

Super Tools

A super tool is a tool that is composed of a set of tools. Super tools include Reaction, Garbage Mask, 2D Compositor, Image Import, Keyer, Macro, Tracker, and Paint. Super tools are indicated by a sphere icon.

The Macro super tool lets you design your own tool. You can drag tools from the Tools tab directly into the Macro super tool in order to customize it for your composition.

1. Do one of the following:

   • Middle-click or press the tilde key (~) on your mouse to open the Gate UI. Swipe to the east to open the Tools tab. From the Tools tab, select the Macro super tool or select a Macro super tool preset, if you have previously created one. Drag the Macro super tool into the Schematic view.

   • Or, from the Schematic view, select the nodes that you want to include in the Macro super tool, right-click and then select Create Macro.

   

2. Click the Macro super tool to display the Macro tab in the Tool UI. Notice that most of the tab is empty. You'll customize the tab with the tool inputs that you add to the Macro super tool.

   

On the left side of the tab, the Customize UI button allows you to customize the Tool UI. The Customize UI button is enabled once you are in edit mode.

Just above the Customize UI button, there are six more buttons. Once you have added tools to the Macro super tool, you can assign each of these buttons to a tool. Select a tool in the Schematic and then click a button while holding down the Ctrl key to assign it to a tool.

Note: When the Customize UI button is pressed, these buttons are disabled.

In order to customize the Macro super tool, you must be in edit mode. Right-click on the Macro super tool and select Edit or double-click on it. This allows you to enter the Macro super tool.

Once inside the Macro super tool, what you see will depend on whether you connected the tool to a dependency graph or not. If the Macro super tool is not connected to a dependency graph, you will see an input and an output image, which are simply placeholders that represent the Macro's potential connections outside of edit mode. If the Macro super tool is connected to a dependency graph, then the two nodes that it is connected to will be displayed instead of the input and output images.

Next, you can decide what tools you want to add to the Macro super tool. Open the Gate UI and swipe to the east to open the Tools tab. Now you can drag tools from the Tools tab directly into the Macro super tool.

You'll notice that when you click on any of the tools you've added to the Macro super tool, the tab corresponding to the tool in the Tool UI will specify that it is part of the Macro super tool.

1. Once you have added tools to the Macro super tool, click the Customize UI button.

2. Open a Composition view. Middle-click or press the tilde (~) key on your mouse to open the Gate UI. Then swipe east.

3. Click the View tab. From the View tab, drag a Composition view into a viewport. Once the Composition view is open, you will see a Macro sub-menu.

4. Click the Macro sub-menu to reveal the tools that you added to the Macro super tool.

   

5. Now you can open each tool individually and load the tool inputs that you want into the Tool UI of the Macro super tool.

   

   You can do that by dragging and dropping tool inputs from the Macro sub-menu of the Composition view into the Tool UI of the Macro super tool. As you drag tool inputs into the Tool UI, either a green arrow or a red x will appear, indicating whether it is possible to drag the input into the Too UI or not.

   

   Note: Animation data and other nodes cannot be dragged into the Tool UI.

   

   You can add as many inputs as you like, however if there are too many inputs, some of them will be hidden at the bottom of the pane.

   

   You can remove an input at any time by right-clicking it and selecting Remove.

   

   You can rename an item by double-clicking its name and entering a new name in the field.

   

6. Once you have determined which inputs you want to include in the Macro super tool, you can save it as a preset by clicking the Save button in the Tool options area. You will be required to give the preset a name.

   

   

You can access this preset through the Tools menu. Middle-click or press the tilde key (~) on your mouse to open the Gate UI, then swipe to the east to open the Tools tab. Select the Macro super tool. In the lower menu, right-click the Macro super tool and select Presets.

To use a preset in a composition, click it and drag it into the Schematic view.

Note: Adding a preset to a composition does not prevent you from modifying it. You can continue to add or remove tool inputs from the Macro preset and modify its UI. However, these changes will not be reflected in the composition that the preset has been added to since there is no direct link between the preset and the composition that it is added to.