This node lets you translate, rotate, scale, or skew an image in 2D in the same way as the Transform node, but it also offers controls for assigning a mask to protect certain areas of the frame from transforms.
Connection Type |
Connection Name |
Function |
Input |
unnamed |
The input you want to translate, rotate, scale, or skew. |
mask |
An optional image to use as a mask. By default, the transform is limited to the non-black areas of the mask. At first, the mask input appears as triangle on the right side of the node, but when you drag it, it turns into an arrow labeled mask. If you cannot see the mask input, ensure that the mask control is disabled or set to none. |
Control (UI) |
Knob (Scripting) |
Default Value |
Function |
Transform Tab |
|||
channels |
channels |
all |
The transform is only applied to these channels. If you set this to something other than all or none, you can use the checkboxes on the right to select individual channels. |
translate xy |
translate |
0, 0 |
Translates the input on the x and y axes. |
rotate |
rotate |
0 |
Rotates the input by degrees. Negative values produce anti-clockwise rotation. |
scale |
scale |
1 |
Scales the input. Scale width and height are ganged by default. |
skew X |
skewX |
0 |
Skews the input on the x axis. |
skew Y |
skewY |
0 |
Skews the input on the y axis. |
skew order |
skew_order |
XY |
Sets the order in which skew transforms are applied to the input: • XY • YX |
center xy |
center |
N/A |
The center of rotation and scaling. You can also move it using Ctrl/Cmd+drag. |
invert |
invert_matrix |
disabled |
When enabled, any transform you applied using the translate xy, rotate, scale, skew, or center xy controls is inverted. |
filter |
filter |
Cubic |
Select the filtering algorithm to use when remapping pixels from their original positions to new positions. This allows you to avoid problems with image quality, particularly in high contrast areas of the frame (where highly aliased, or jaggy, edges may appear if pixels are not filtered and retain their original values). • Impulse - remapped pixels carry their original values. • Cubic - remapped pixels receive some smoothing. • Keys - remapped pixels receive some smoothing, plus minor sharpening (as shown by the negative -y portions of the curve). • Simon - remapped pixels receive some smoothing, plus medium sharpening (as shown by the negative -y portions of the curve). • Rifman - remapped pixels receive some smoothing, plus significant sharpening (as shown by the negative -y portions of the curve). • Mitchell - remapped pixels receive some smoothing, plus blurring to hide pixelation. • Parzen - remapped pixels receive the greatest smoothing of all filters. • Notch - remapped pixels receive flat smoothing (which tends to hide moire patterns). • Lanczos4, Lanczos6, and Sinc4 - remapped pixels receive sharpening which can be useful for scaling down. Lanczos4 provides the least sharpening and Sinc4 the most. |
clamp |
clamp |
disabled |
When using filters that employ sharpening, such as Rifman and Lanczos, you may see a haloing effect. If necessary, check clamp to correct this problem. |
black outside |
black_outside |
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. |
motionblur |
motionblur |
0 |
Sets the number of motion blur samples. A motionblur value of 1 should produce reasonable results for most sequences. Increase the motionblur value to produce more samples for higher quality, decrease it to shorten the processing time. |
shutter |
shutter |
0.5 |
How long the shutter remains open (measured in frames) to produce motion blurring. The default value sets the shutter open for half a frame. |
shutter offset |
shutteroffset |
start |
This value controls how the shutter behaves with respect to the current frame value. It has four options: • centred - center the shutter around the current frame. For example, if you set the shutter value to 1 and your current frame is 30, the shutter stays open from frame 29,5 to 30,5. • start - open the shutter at the current frame. For example, if you set the shutter value to 1 and your current frame is 30, the shutter stays open from frame 30 to 31. • end - close the shutter at the current frame. For example, if you set the shutter value to 1 and your current frame is 30, the shutter stays open from frame 29 to 30. • custom - open the shutter at the time you specify. In the field next to the dropdown menu, enter a value (in frames) you want to add to the current frame. To open the shutter before the current frame, enter a negative value. For example, a value of - 0.5 would open the shutter half a frame before the current frame. |
shuttercustomoffset |
0 |
If the shutter offset control is set to custom, this field is used to set the time that the shutter opens by adding it to the current frame. Values are in frames, so -0.5 would open the shutter half a frame before the current frame. |
|
mask |
N/A |
disabled |
Enables the associated mask channel to the right. Disabling this checkbox is the same as setting the channel to none. |
maskChannelInput |
none |
The channel to use as a matte. By default, he transform is limited to the non-black areas of this channel. |
|
inject |
inject |
disabled |
Copies the mask input to the predefined mask.a channel. Injecting the mask allows you to use the same mask further downstream. |
invert |
invert_mask |
disabled |
Inverts the use of the mask channel, so that the transform is limited to the non-white areas of the mask. |
fringe |
fringe |
disabled |
Blurs the edges of the mask. |
mix |
mix |
1 |
Dissolves between the original image at 0 and the full effect at 1. |