S_WarpBubble Warps the source clip by a smooth noise function. This can be used to create heat diffusion or under water types of effects. The Shift Speed parameters cause the noise pattern to automatically translate over time. Adjust the Amplitude and Frequency parameters to give different types of distortions. 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.25,  Range: any.
Scales the amount of warping distortion. Increase for more severe distortion.

Frequency:   Default: 16,  Range: 0.01 or greater.
The frequency of the noise pattern. Increase for more and smaller bubbles, decrease for fewer and larger bubbles.

Frequency Rel X:   Default: 1,  Range: 0.01 or greater.
The relative horizontal frequency of the bubble pattern. Increase for taller bubbles, decrease for wider ones.

Octaves:   Integer,  Default: 1,  Range: 1 to 10.
The number of summed layers of noise. Each octave is twice the frequency and half the amplitude of the previous. A single octave gives a smooth texture. Adding octaves makes the result approach a fractal (1/f) noise texture.

Seed:   Default: 0.23,  Range: 0 or greater.
Used to initialize the random number generator. The actual seed value is not significant, but different seeds give different results and the same value should give a repeatable result.

Rotate Warp Dir:   Default: 0,  Range: any.
Rotation angle of the warping directions in counter-clockwise degrees.

Shift Start:   X & Y,   Default: [0 0],  Range: any.
The translation of the bubble pattern.

Shift Speed:   X & Y,   Default: [0.1 0],  Range: any.
If non-zero, the bubble pattern is automatically animated to shift at this speed. The result of animated Speed values may not be intuitive, so for variable speed motion it is usually best to set this to 0 and animate the Shift Start values instead.

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.

See Also:

DissolveBubble WipeBubble

Sapphire Plug-ins Introduction

© 2009, GenArts, Inc. All rights reserved.