S_WarpTransform

Warps the source clip by a combination of linear transformations including scale, shear, zoom, rotation, and translation.

In the Sapphire Distort effects submenu.


Inputs:

Source:  The input clip to be warped.

Mask:  Optional.   If provided, the amplitude of warping is scaled by the values of this input clip. Gray values internally scale the warping amplitude rather than simply cross-fading between the effect and the original source to allow more continuous results at the mask edges and more detailed control over the warping amounts. This input can be affected using the Blur Mask, Invert Mask, or Mask Use parameters.
        

Parameters:

Scale:   X & Y,   Default: [1 1],  Range: any.
Scales the relative horizontal or vertical size of the source image.

Shift:   X & Y,   Default: [0 0],  Range: any.
Translates the source image. This parameter can be adjusted using the Shift Widget.

Z Dist:   Default: 1,  Range: 0.001 or greater.
Scales the 'distance' of the image. Values greater than 1.0 move it farther away and make it smaller. Values less then 1.0 move the image closer and enlarge it. Note that Scale X and Y also scale the size of the image, but in an inverse way and on each axis.

Rotate:   Default: 0,  Range: any.
Rotates the source image by the specified angle in counter-clockwise degrees.

Swivel:   Default: 0,  Range: any.
Rotates the image left or right in 3D about the vertical axis.

Tilt:   Default: 0,  Range: any.
Rotates the image up or down in 3D about the horizontal axis. You can use Swivel and Tilt together to rotate about arbitrary diagonal axes.

Perspective Amount:   Default: 1,  Range: 0.25 to 4.
Controls the amount of lens telescoping while applying Swivel and Tilt. Increase for more 3D perspective.

Shear:   X & Y,   Default: [0 0],  Range: any.
Shears the source image horizontally or vertically.

Wrap:   X & Y,  Popup menu,  Default: [No No].
Determines the method for accessing outside the borders of the source image.
No:  gives black beyond the borders.
Tile:  repeats a copy of the image.
Reflect:  repeats a mirrored copy. Edges are often less visible with this method.

Filter:   Check-box,  Default: on.
If enabled, the image is adaptively filtered when it is resampled. This gives a better quality result when parts of the image are warped smaller.

Blur Mask:   Default: 0,  Range: 0 or greater.
Blurs the Mask input by this amount before using. This can provide a smoother transition between the masked and unmasked areas. It has no effect unless the Mask input is provided.

Invert Mask:   Check-box,  Default: off.
If on, inverts the mask input so the effect is applied to areas where the Mask is black instead of white. This has no effect unless the Mask input is provided.

Mask Use:   Popup menu,  Default: Luma.
Determines how the Mask input channels are used to make a monochrome mask.
Luma:  the luminance of the RGB channels is used.
Alpha:  only the Alpha channel is used.

Crop Input Parameters:   Default: 0,  Range: 0 or greater.
These 4 parameters, Crop Top, Crop Bottom, Crop Left, and Crop Right, allow selecting a rectangular subsection of the input image to be processed. If the Wrap parameters are set to "No" the exposed borders will be transparent. If the Wrap is "Tile" or "Reflect" the source image is wrapped on the new cropped borders to fill the frame. This can make it easier to avoid artifacts due to distorting an image with bad edges.

Show Shift: Check-box, Default: on.
Turns on or off the screen user interface for adjusting the Shift parameter.


See Also:

Shake
Sapphire Plug-ins Introduction


© 2009, GenArts, Inc. All rights reserved.