S_WarpPuff Warps the source clip based on its gradient. By default, brighter areas are puffed out and darker areas are shrunk. This is similar to applying Distort effect to an image using itself as the lens. 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:

Direction:   Popup menu,  Default: Puff.
Determines which type of areas of the source clip are puffed.

Puff:  expands brighter areas and shrinks darker ones.

Shrivel:  shrinks brighter areas and expands darker ones.

Amount:   Default: 0.5,  Range: any.
Scales the amount of distortion. This can also be negative to turn puffs into shrivels and vice versa.

Smoothness:   Default: 0.1,  Range: 0 or greater.
Blurs the source clip by this amount before determining the warp directions and amounts.

Rotate Warp Dir:   Default: 0,  Range: any.
Rotates the direction of the warping. This can cause areas of similar brightness to be twisted instead of just expanded or shrunk.

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

See Also:

Distort Sapphire Plug-ins Introduction

© 2009, GenArts, Inc. All rights reserved.