How to set up control nodes to make widget properties available to a control app

Control nodes expose widgets in a composition to a control application or the Singular APIs so that you can dynamically update them without having to go into the composition itself.

In this guide, you'll learn how to create control nodes in the data interface and control panel and in the node link browser. The examples show a control node being made for a text widget, but you can also create control nodes for various other types of widgets.

To follow this guide, you'll need a composition. If you don't have one, first learn how to build a composition or extract a composition from a Singular template.

How to create a control node in the data interface and control panel

1. Open a composition in Composer.

2. Navigate to the data interface and control panel and select Text from the drop-down menu.

3. Name the control node in Field name.

   

   Creating and naming a control node
4. In the composition tree, select a widget to connect to the control node. (You might need to click into a group or sub-composition to find the widget.)

   

   Selecting a widget to connect to the control node
5. In the property panel, select the text tab and click Text just under it. The link browser will appear.

6. In the link browser, select the name of the control node you just created.

   

   Linking a widget to a control node
7. Back in the data interface and control panel, you can change the text for the control node.

   

   Finding a new control node in the data interface and control panel

How to create a control node with the node link browser

1. Open a composition in Composer.

2. Navigate to the composition tree and select a text widget. (You might need to click into a sub-composition or group to see the widgets.)

   

   Selecting a text widget from the composition tree
3. In the property panel, select the text tab and click Text just under it. The link browser will appear.

4. In the link browser, name the control node in the text field and select Add.

   

   Naming a control node
5. Navigate to the data interface and control panel and find the control node that you just created.

6. In the text field to the right of the control node name, you can change the text.

   

   Finding a new control node in the data interface and control panel