S_DistortChroma Warps the chrominance of the source input by different amounts using the gradient of the Lens input clip. This can generate optical glass-like effects as if the source clip were being viewed through an arbitrarily shaped or textured prism. It is best demonstrated when the lens image contains just a few simple bold shapes. In the Sapphire Distort effects submenu. Inputs: Source:  The clip to be processed. Lens:  Optional.   Distorts the source using the brightness values of this input clip. Mask:  Optional.   If provided, the amount of lens distortion is scaled by this input, so the Source is unaffected where the Mask is black. This input can be affected using the Blur Mask, Invert Mask, or Mask Use parameters.

Parameters:

Amount:   Default: 1,  Range: any.
The severity of the lens distortions. Make negative to invert the direction of the distortions.

Blur Lens:   Default: 0.1,  Range: 0 or greater.
Smooths out the edges in the lens image by this amount before using it.

Rotate Warp Dir:   Default: 0,  Range: any.
Rotates the warping direction by this many degrees. If non-zero, this can add some unusual twisting effects to the lens distortion.

Warp Red:   Default: 0.5,  Range: any.
The magnitude of lens distortion for the red end of the spectrum. Make negative to invert the direction of the red distortions.

Warp Blue:   Default: 1,  Range: any.
The magnitude of lens distortion for the blue end of the spectrum. Make negative to invert the direction of the blue distortions.

Steps:   Integer,  Default: 8,  Range: 3 to 100.
The number of color samples along the spectrum to include. More steps give a smoother result, but require more time to process.

Color1:   Default rgb: [1 0 0].
The color at the 'red' end of the spectrum.

Color2:   Default rgb: [0 1 0].
The color in the middle of the spectrum.

Color3:   Default rgb: [0 0 1].
The color at the 'blue' end of the spectrum.

White Balance:   Check-box,  Default: off.
When enabled, the three colors are adjusted internally so they sum to white. In this case, the colors of unwarped regions are not affected and the average color of the result remains the same.

Amount Rel:   X & Y,   Default: [1 1],  Range: 0 or greater.
The relative amounts of horizontal and vertical distortion. This has no effect unless Amount is positive.

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:

Distort DistortBlur DistortRGB

EmbossGlass WarpChroma

Sapphire Plug-ins Introduction

© 2009, GenArts, Inc. All rights reserved.