S_WarpMagnify Magnifies an elliptical region of the source to create a glass lens refraction effect. 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:

Magnify Amount:   Default: 2,  Range: any.
Amount to scale the image within the magnified region. Use values below 1.0 to shrink the image instead within the lens.

Magnify Rel:   X & Y,   Default: [1 1],  Range: 0 or greater.
The relative horizontal and vertical magnification.

Lens Center:   X & Y,   Default: [360 240],  Range: any.
The center of the lens shape. This parameter can be adjusted using the Lens Center Widget.

Lens Radius:   Default: 0.4,  Range: 0 or greater.
Radius of the inner part of the lens. Within this region, the source is scaled by the full magnify amount. This parameter can be adjusted using the Edge Width Widget.

Lens Edge Width:   Default: 0.5,  Range: 0 or greater.
The width of the lens edge, as a fraction of the inner radius. In the edge area of the lens, magnification tapers off from the full magnify amount to no magnification. This parameter can be adjusted using the Edge Width Widget.

Lens Rel Height:   Default: 1,  Range: 0.1 or greater.
The relative vertical size of the lens. Increase for a taller ellipse, decrease for a wider one.

Lens Rel Width:   Default: 1,  Range: 0.1 or greater.
The relative horizontal size of the lens. Increase for a wider ellipse, decrease for a taller one.

Lens Rotate:   Default: 0,  Range: any.
Rotation in degrees of the lens. Note that rotation will have no effect when Rel Width and Rel Height are equal and the shape is a perfect circle. This parameter can be adjusted using the Lens Rotate Widget.

Lens Edge Shape:   Default: 1,  Range: -1 to 1.
Determines the curve of the magnification amount within the edge of the lens. If set to zero, magnification tapers off linearly. If set to one, magnification tapers off in a smoother curve, which can reduce the visual perception of the border of the lens. Other values interpolate between the two.

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.

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

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

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

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

See Also:

Distort WarpFishEye

Sapphire Plug-ins Introduction

© 2009, GenArts, Inc. All rights reserved.