Overview & Purpose
The Spiral Save tool allows you to take a spiral animation created with the main Spiral tool and apply its path and rotation characteristics to a different image or element. This is useful for performance (avoiding recalculating the spiral) or for applying a consistent spiral motion to multiple objects.
It retrieves data (center point X/Y, spin angle) that was previously saved within a specified Spiral tool. When applying this data, the tool also accounts for the image dimensions of both the original source image (from the Spiral tool) and the new target image (input to Spiral Save) to offer both exact pixel-matched positioning and size-relative positioning.
Parameters
| Parameter | Description | Default |
|---|---|---|
| Source Spiral (Text Field) | The name of the Spiral tool in your composition from which to retrieve the saved data. | SpiralAnim |
Tool Actions
| Action Button | Description |
|---|---|
| Get Spiral Data | Retrieves the last saved spiral data from the Spiral tool specified in Source Spiral. This includes per-frame values for center X/Y position and spin angle. It also stores the width and height of the image used in the original Spiral tool for accurate scaling. The source Spiral tool must have had its Save Spiral Data button pressed previously. A notification will confirm success or failure. |
| Apply Data as Expressions: (Creates dynamic links. Motion blur on driven parameters may not work as expected.) | |
| Set Exact Position Expression | Applies the saved X/Y positional data as an expression to this node's Center control. This method uses the stored original image dimensions and the current input image dimensions to ensure the new image follows the exact same pixel path as the original, regardless of differences in image size. |
| Set Relative Position Expression | Applies the saved X/Y positional data as an expression to this node's Center control. This method maps the original spiral's normalized path (0-1 space) directly to the new image, meaning the shape of the spiral will be relative to the new image's dimensions. |
| Set Rotation Expression | Applies the saved spin angle data as an expression to this node's Angle control. |
| Apply Data as Keyframes: (Creates keyframes on every frame. Supports motion blur.) | |
| Set Exact Position Keys | Applies the saved X/Y positional data as keyframes, maintaining the exact pixel path as the original. Reset the control to default first if an expression was previously applied. |
| Set Relative Position Keys | Applies the saved X/Y positional data as keyframes, making the spiral path relative to the new image's dimensions. Reset first if needed. |
| Set Rotation Keys | Applies the saved spin angle data as keyframes to this node's Angle control. Reset first if needed. |
The Spiral Save tool is based on a Transform node and also inherits its standard common controls (Motion Blur, Quality, etc.), which can be accessed via the Inspector.
Usage Guide
- Ensure you have a Spiral tool in your composition with a configured animation, and that you have pressed its Save Spiral Data button.
- Add a Spiral Save tool to your flow and connect the new image you want to animate to its input.
- In the Spiral Save tool's Inspector:
- Verify the Source Spiral field correctly names your main Spiral tool.
- Click the Get Spiral Data button. A confirmation message will appear.
- Choose how to apply the data using the appropriate action buttons:
- Positioning: Choose either Set Exact Position (to match original pixel path) or Set Relative Position (to scale path to new image size). Apply as Expression or Keys.
- Rotation: Use Set Rotation Expression or Set Rotation Keys.
- If applying keyframes after an expression, remember to first reset the parameter (right-click > Remove Expression or Reset to Default).
Examples & Tips
- Replicating Motion: Set Exact Position is ideal if you want multiple objects of different sizes to follow the identical screen-space path defined by the original Spiral tool.
- Scaled Motion: Set Relative Position is useful if you want the shape of the spiral to be similar but scaled to fit the proportions of different sized objects.
- Performance: For complex spirals, using Spiral Save with keyframes can improve performance by avoiding recalculation of the original spiral animation.
- Motion Blur: For accurate motion blur on the saved animation, always use the Set ... Keys actions.