TransformMasked node
This documentation is for version 1.0 of TransformMasked (net.sf.openfx.TransformMaskedPlugin).
Description
Translate / Rotate / Scale a 2D image, with optional masking.
This plugin concatenates transforms upstream.
Inputs
Input |
Description |
Optional |
---|---|---|
Source |
No |
|
Mask |
Yes |
Controls
Parameter / script name |
Type |
Default |
Function |
---|---|---|---|
Translate / |
Double |
x: 0 y: 0 |
Translation along the x and y axes in pixels. Can also be adjusted by clicking and dragging the center handle in the Viewer. |
Rotate / |
Double |
0 |
Rotation angle in degrees around the Center. Can also be adjusted by clicking and dragging the rotation bar in the Viewer. |
Scale / |
Double |
x: 1 y: 1 |
Scale factor along the x and y axes. Can also be adjusted by clicking and dragging the outer circle or the diameter handles in the Viewer. |
Uniform / |
Boolean |
Off |
Use the X scale for both directions |
Skew X / |
Double |
0 |
Skew along the x axis. Can also be adjusted by clicking and dragging the skew bar in the Viewer. |
Skew Y / |
Double |
0 |
Skew along the y axis. |
Skew Order / |
Choice |
XY |
The order in which skew transforms are applied: X then Y, or Y then X.
XY
YX
|
Amount / |
Double |
1 |
Amount of transform to apply. 0 means the transform is identity, 1 means to apply the full transform. |
Center / |
Double |
x: 0.5 y: 0.5 |
Center of rotation and scale. |
Reset Center / |
Button |
Reset the position of the center to the center of the input region of definition |
|
Interactive Update / |
Boolean |
On |
If checked, update the parameter values during interaction with the image viewer, else update the values when pen is released. |
HiDPI / |
Boolean |
Off |
Should be checked when the display area is High-DPI (a.k.a Retina). Draws OpenGL overlays twice larger. |
Invert / |
Boolean |
Off |
Invert the transform. |
Filter / |
Choice |
Cubic |
Filtering algorithm - some filters may produce values outside of the initial range (*) or modify the values even if there is no movement (+).
Impulse (impulse): (nearest neighbor / box) Use original values.
Box (box): Integrate the source image over the bounding box of the back-transformed pixel.
Bilinear (bilinear): (tent / triangle) Bilinear interpolation between original values.
Cubic (cubic): (cubic spline) Some smoothing.
Keys (keys): (Catmull-Rom / Hermite spline) Some smoothing, plus minor sharpening (*).
Simon (simon): Some smoothing, plus medium sharpening (*).
Rifman (rifman): Some smoothing, plus significant sharpening (*).
Mitchell (mitchell): Some smoothing, plus blurring to hide pixelation (*)(+).
Parzen (parzen): (cubic B-spline) Greatest smoothing of all filters (+).
Notch (notch): Flat smoothing (which tends to hide moire’ patterns) (+).
|
Clamp / |
Boolean |
Off |
Clamp filter output within the original range - useful to avoid negative values in mattes |
Black outside / |
Boolean |
On |
Fill the area outside the source image with black |
Motion Blur / |
Double |
0 |
Quality of motion blur rendering. 0 disables motion blur, 1 is a good value. Increasing this slows down rendering. |
Directional Blur Mode / |
Boolean |
Off |
Motion blur is computed from the original image to the transformed image, each parameter being interpolated linearly. The motionBlur parameter must be set to a nonzero value, and the blackOutside parameter may have an important effect on the result. |
Shutter / |
Double |
0.5 |
Controls how long (in frames) the shutter should remain open. |
Shutter Offset / |
Choice |
Start |
Controls when the shutter should be open/closed. Ignored if there is no motion blur (i.e. shutter=0 or motionBlur=0).
Centered (centered): Centers the shutter around the frame (from t-shutter/2 to t+shutter/2)
Start (start): Open the shutter at the frame (from t to t+shutter)
End (end): Close the shutter at the frame (from t-shutter to t)
Custom (custom): Open the shutter at t+shuttercustomoffset (from t+shuttercustomoffset to t+shuttercustomoffset+shutter)
|
Custom Offset / |
Double |
0 |
When custom is selected, the shutter is open at current time plus this offset (in frames). Ignored if there is no motion blur (i.e. shutter=0 or motionBlur=0). |
Invert Mask / |
Boolean |
Off |
When checked, the effect is fully applied where the mask is 0. |
Mix / |
Double |
1 |
Mix factor between the original and the transformed image. |