Greg Gunn

PuppetTools User Guide

 

PuppetTools 3 User Guide

Hello, friend. And welcome to the PuppetTools 3 User Guide. I'm going to walk you through each feature and setting of this script so that you will become a pro at using it. If you haven't already, watch the tutorial videos. They cover most of what you need to know.

 
 Puppet Tools Settings expanded view

Puppet Tools Settings expanded view

Settings

Let's start by going over the settings for the script. Click the "Settings" button to expand the list of settings. You may need to drag the bottom of the panel down to see everything.

 

 

This section is still in progress!

Controller Type

This dictates the type of controller the script will make—Null, Square Shape Layer, Circle Shape Layer or a Solid. They're automatically created as guide layers so that they won't render.

 

Control Color

The default is white, but you can enter your own Hex color in the box. Or click the "Pick Color" button to open a color picker window. All controllers are set to 50% opacity so that you can see behind them.

 

Parent Chain Order

This dictates the type of controller the script will make—null, square, circle or a solid. They're created as guide layers so that they won't render.

Controller Size

The size, in pixels, of the generated controller. I find that 150px is a comfortable size when working at 1920x1080. But this let's you try difference sizes for different needs.

 

Naming Style

This setting lets you customize how your controllers are named.

 

 

Master Controller Position

This dictates the type of controller the script will make—null, square, circle or a solid. They're created as guide layers so that they won't render.

 
 
 

Create Controllers

This feature is designed to automate the process of making and connecting custom controllers for your layers.

How To Use:

Start by either selecting a Shape Layer/Mask path or a layer with puppet pins placed on it. Then, click the "Create Controllers" button.

The script will do it's thing and create, place and link a controller to each vertex on the path or each puppet pin on the selected layer.

If you'd like to use this on a path, make sure you're running After Effects CC 2018 (version 15.0) or newer. You'll get a warning if you aren't. And when selecting your path, make sure you select the path property, not the path name. e.g. Path 1 > Path.

You can also selectively add controllers to a layer by directly selecting the puppet pins you'd like to make controllers for. This feature isn't available for path vertices just yet—waiting on Adobe to provide access to vertex selection.

If no path was selected and there aren't any puppet pins, the script will create a single controller at the anchor point of the selected layer.