S_WarpPuddle

Warps the source clip by a pattern of concentric waves. The Phase Speed parameter causes the waves to automatically move outwards from the center over time. Adjust the Inner and Outer Radius parameters to limit the area where the waves appear. Increase the Inner and Outer softness for smoother transitions between where the waves appear and do not appear.

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:

Amplitude:   Default: 0.1,  Range: any.
Scales the amount of warping distortion. Increase for more severe distortion.

Frequency:   Default: 8,  Range: 0.01 or greater.
The frequency of the waves. Increase for more waves, decrease for fewer. This parameter can be adjusted using the Frequency Widget.

Rel Height:   Default: 0.75,  Range: 0.01 or greater.
The relative height of the concentric wave pattern.

Rotate Puddle:   Default: 0,  Range: any.
Rotates the puddle pattern by this many counter-clockwise degrees after the Rel Height stretching has been applied. This has no effect when Rel Height is 1. This parameter can be adjusted using the Rotate Puddle Widget.

Center:   X & Y,   Default: [360 243],  Range: any.
The center of the puddle, in screen coordinates relative to the center of the frame. This parameter can be adjusted using the Center Widget.

Phase Start:   Default: 0,  Range: any.
The phase shift of the waves.

Phase Speed:   Default: 1,  Range: any.
The speed of the waves. If this is positive the waves automatically travel outwards from the center at this rate.

Inner Radius:   Default: 0,  Range: any.
The distance from the puddle center where the wave distortion is phased in. No waves are generated inside this radius. This parameter can be adjusted using the Inner Radius Widget.

Inner Softness:   Default: 0.1,  Range: 0.0056 or greater.
The width of the region at the Inner Radius over which the wave distortion is phased in.

Outer Radius:   Default: 1.4,  Range: 0 or greater.
The distance from the puddle center where the wave distortion is phased out. No waves are generated outside this radius. This parameter can be adjusted using the Outer Radius Widget.

Outer Softness:   Default: 0.42,  Range: 0.0056 or greater.
The width of the region at the Outer Radius over which the wave distortion is phased out.

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. Zooming in slightly can sometimes be used to hide edge artifacts.

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 Frequency: Check-box, Default: on.
Turns on or off the screen user interface for adjusting the Frequency parameter.

Show Inner Radius: Check-box, Default: on.
Turns on or off the screen interface parameter for adjusting the Inner Radius. The value of the Inner Radius parameter must first be positive for this widget to be visible.

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

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

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


See Also:

DissolvePuddle
Sapphire Plug-ins Introduction


© 2009, GenArts, Inc. All rights reserved.