S_WarpPolar Warps the source clip into a rounded disk shape. The vertical direction of the source image is mapped between the Inner Radius and Outer Radius, and the horizontal direction is rotated about the center based on the number of Angle Repeats and offset by Angle. 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:

Angle:   Default: 0,  Range: any.
Rotation of the result, in counter-clockwise degrees. This parameter can be adjusted using the Angle Widget.

Angle Repeats:   Default: 1,  Range: 0.01 or greater.
The number of copies of the source image to wrap around. This should be an integer to avoid a seam where the first copy connects to the last.

Center:   X & Y,   Default: [360 243],  Range: any.
The center of the disk, in screen coordinates relative to the center of the frame.

Stretch:   X & Y,   Default: [1 1],  Range: 0.01 or greater.
Scales the horizontal or vertical size of the disk shape. This parameter can be adjusted using the Inner Radius Widget.

Inner Radius:   Default: 0.028,  Range: any.
The distance from the center where the bottom edge of the source clip is mapped. This parameter can be adjusted using the Inner Radius Widget.

Outer Radius:   Default: 0.83,  Range: any.
The distance from the center where the top edge of the input clip is mapped. This parameter can be adjusted using the Outer Radius Widget.

Wrap:   X & Y,  Popup menu,  Default: [Tile 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 Angle: Check-box, Default: on.
Turns on or off the screen user interface for adjusting the Angle parameter.

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

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

See Also:

KaleidoPolar Sapphire Plug-ins Introduction

© 2009, GenArts, Inc. All rights reserved.