Auto-Crop

Intro

Crop Shapes based on their bounding box.

UI

Common Attributes +

Mask Shape - Determine the shape of the mask:

• Rectangle - Use a rectangular mask.
• Ellipse - Use an elliptical mask.

Align X - Set the horizontal position along a Shape's bounding box that the crop starts between -1 (the left edge) and +1 (the right edge).

Align Y - Set the vertical position along a Shape's bounding box that the crop starts between -1 (the top edge) and +1 (the bottom edge).

Progress Mode -

• Percentage - Set the size of the crop as a percentage of the overall width.
• Size - Set the size of crop in pixels.

Percentage - When Progress Mode is set to Percentage, increase/decrease the amount the Shape is cropped as a percentage of its width/height.

Size - When Progress Mode is set to Size, increase/decrease the amount the Shape is cropped in pixels.

Example

1. Create a Text Shape.
2. In the Attribute Editor, click the + on the Deformers row and choose Auto-Crop from the list.
3. Set Align X to -1.
4. Set keyframes for Percentage W of:
   • Frame 0 = 100
   • Frame 25 = 0
5. Press Play.

The text will be revealed from left to right over the 25 frames. Because the crop's width is automatically set based on the Text's width, it will automatically update if the Text's String changes.

Image Shader

When using Auto-Crop with Shapes connected to an Image Shader, the Image Shader's Scale Mode should be set to None to avoid any rescaling/tiling of the image.