S_WarpPerspective Transforms the source clip onto a 3D plane with perspective. Adjust the Latitude, Swing, and Roll parameters to rotate the image on various axes, and adjust Shift and Z Dist to translate and zoom. Turn off the Wrap options to give a single non-repeated copy of the image. 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:

Latitude:   Default: 35,  Range: -89 to 89.
Tilts the image up or down in 3D. Positive latitude tilts the image down and negative tilts it up.

Swing:   Default: 0,  Range: any.
Rotation of the image in degrees in its initial frame.

Roll:   Default: 0,  Range: any.
Tilts the result from side to side, in counter-clockwise degrees.

Z Dist:   Default: 3,  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.

Tele Lens Width:   Default: 1,  Range: 0.2 to 3.
The amount of lens telescoping. Increase to zoom in with less perspective, decrease for a wider viewing angle with more perspective.

Shift Orig:   X & Y,   Default: [0 0],  Range: any.
Translates the image in its initial frame.

Wrap:   X & Y,  Popup menu,  Default: [Tile Tile].
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.

Wrap Above Horizon:   Check-box,  Default: off.
When the image is sufficiently tilted using the Latitude parameter, a horizon can be seen. When Wrap Above Horizon is check, the image is repeated on both sides of the horizon.

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.

See Also:

CloudsPerspective Sapphire Plug-ins Introduction

© 2009, GenArts, Inc. All rights reserved.