Using the Interpolation Grid Script

1. To make the coordinate setup easier, from the Node Library view, import a Grid node to your Node view and connect it behind the elements.

2. To easily remember your frames, you can use Timeline markers to indicate the poses you intend to use in the master controllers.

3. Add the Scripting toolbar to your workspace by doing one of the following:
   • In the top menu, select Windows > Toolbars > Scripting.
   • Right-click on any existing toolbar and select Scripting.

4. Follow these steps to add the Interpolation Grid script to the Scripting toolbar:
1. In the Scripting toolbar, click on the Manage Script button.

The Scripts Manager dialog appears.



2. In the Files list of the Scripts Manager, select TB_Interpolation_Grid.js.



3. In the Functions list, select TB_Interpolation_Grid.



4. Click on the Add script to toolbar button.

The TB_Interpolation_Grid function of the TB_Interpolation_Grid.js script is added to the In Toolbar list.



5. Click OK.
6. A button for the TB_Interpolation_Grid script is added to the Scripting toolbar.

5. In the Node view, select the layers or group the master controllers will control.



TIP: It is recommended to keep your character rig inside a single group to make its selection easier.

6. In the Scripting toolbar, click on the TB_Interpolation_Grid script button.

The Interpolation Grid dialog appears, with the Grid Parameters dialog just over it.

7. In the Keyframe count field of the Grid Parameters dialog, set the horizontal (X) and vertical (Y) size of the grid to match the amount of vertical and horizontal poses you created for your character.

8. If the grid is too low or too high in relation to the character or where the affect zone is, you can adjust the centre position of the grid.

9. You can also change the cell size to be bigger or smaller based on your artwork and poses.

10. From the Preset drop-down menu, you can select a preset grid if you want to reuse a provided or custom grid.

11. Click Done.

12. In the Visual Grid area, double click on the grid points to set the frame number corresponding to this point's pose.

13. In the State Properties section, you can type a custom Identifier for the pose. For example, if the selected frame has the character looking up towards the left, you could label the pose Look-Up-Left. You can also adjust the frame number of the pose, as well as the X and Y position the 2D point widget must be positioned to obtain this pose.

14. Once your grid is completed, if you want to save it as a reusable preset for later setup or adjustments to the current one, click the Save Preset button. You will be prompted to give a name to your preset.

15. To avoid affecting unnecessary functions, such as pieces or deformers points that are not moving in the given poses, in the Monitored Attributes section, press Filter Attributes to only retain the modified attributes. The option is only available when all frames in the grid are set.

16. In the Output section, in the Name field, enter the name of the Master Controller node that will be created.

17. In the Interpolation Grid interface, press Create.

18. You will be prompted to select a destination for the .tbstate file which will contain the interpolation grid data. It is highly recommended to save this file in the scripts subfolder of your scene's folder, so that it can easily be bundled with the Master Controller's script.

    At this point, a new Master Controller node containing your interpolation grid will be added to the Node View, and the controller for the Master Controller widget will appear as a blue dot in the Camera view.

19. In the Timeline view, move the playhead to a frame that does not contain one of your interpolation grid's poses, so that you can test the Master Controller without affecting your poses.

20. Move the widget in the screen to test the positions and the interpolation.