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 current layer.   The input clip to be warped. Matte:  Defaults to None.   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 matte edges and more detailed control over the warping amounts. This input can be affected using the Blur Matte, Invert Matte, or Matte 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 degrees.

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

Shift Speed:   X & Y,   Default: [36 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 Matte:   Default: 0,  Range: 0 or greater.
Blurs the Matte input by this amount before using. This can provide a smoother transition between the matted and unmatted areas. It has no effect unless the Matte input is provided.

Invert Matte:   Check-box,  Default: off.
If on, inverts the Matte input so the effect is applied to areas where the Matte is black instead of white. This has no effect unless the Matte input is provided.

Matte Use:   Popup menu,  Default: Luma.
Determines how the Matte input channels are used to make a monochrome matte.

Luma:  the luminance of the RGB channels is used.

Alpha:  only the Alpha channel is used.

Opacity:   Popup menu,  Default: Normal.
Determines the method used for dealing with opacity/transparency.

All Opaque:  Use this option to render slightly faster when the input image is fully opaque with no transparency (alpha=1).

Normal:  Process opacity normally.

As Premult:  Process as if the image is already in premultiplied form (colors have been scaled by opacity). This option also renders slightly faster than Normal mode, but the results will also be in premultiplied form, which is sometimes less correct. If your image has sharp color changes where the matte channel also has sharp edges, you may get better results with Normal mode.

See Also:

WarpTransform WarpVortex WarpPerspective WarpWaves WarpWaves2 WarpPuddle WarpBubble2 WarpFishEye WarpPuff WarpPolar WarpRepeat WarpChroma

DissolveBubble WipeBubble Sapphire Plug-ins Introduction

© 2007, GenArts, Inc. All rights reserved.