Crop

The Crop node lets you cut out the unwanted portions of the image area. You can fill the cropped portion with black or adjust the image output format to match the cropped image.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The image sequence to crop.

Control (UI)

Knob (Scripting)

Default Value

Function

Crop Tab

box x, y, r, t

(or x, y, w, h)

box

N/A

The area of the input image you want to keep. Anything outside this box is cropped.

You can adjust the following:

x - the distance (in pixels) between the left edge of the original image and the left side of the crop box.

y - the distance (in pixels) between the bottom edge of the original image and the bottom edge of the crop box.

r - the distance (in pixels) between the left edge of the original image and the right side of the crop box.

t - the distance (in pixels) between the bottom edge of the original image and the top edge of the crop box.

w - the width of the crop box. This is only available if you click the wh button.

h - the height of the crop box. This is only available if you click the wh button.

You can also adjust the crop box in the Viewer by dragging its edges.

softness

softness

0

Allows you to to vignette the edges of the cropped portion. The larger the value, the more of the area around the edges is faded to black.

A value of 0 produces no vignetting.

reformat

reformat

disabled

When enabled, the image output format is changed to match the cropped image.

When disabled, the original image output format is used.

intersect

intersect

disabled

When enabled, the output bounding box is an intersection of the crop bounding box and the incoming bounding box.

When disabled, the output bounding box matches the crop bounding box and can extend outside the incoming bounding box.

black outside

crop

enabled

This renders as black pixels outside the image boundary, making it easier to layer the element over another. If you uncheck this control, the outside area is filled with the outermost pixels of the image sequence.

In most cases, you should keep black outside checked. However, you may want to turn this off for camera shake, or if you want to texture-map or intersect the output with a similar shape.

Note:  Enabling black outside also adds a solid alpha covering the input image area if no alpha is present.

Step-by-Step Guides

Cropping Elements