S_BlurDirectional

Blurs the source clip in a given direction using a gaussian, triangle, or box filter. It can also blur each channel by different amounts.

In the Sapphire Blur+Sharpen effects submenu.


Inputs:

Source:  The clip to be processed.

Mask:  Optional.   If provided, the blur is only performed on regions of the source clip specified by the bright areas of this input. Pixels outside this mask are not blurred, and do not contribute to the resulting blurred pixels within it. This input can be affected using the Invert Mask, or Mask Use parameters.
        

Parameters:

Blur Amount:   Default: 0.1,  Range: 0 or greater.
Scales the width of the blur. This parameter can be adjusted using the Blur Amount Widget.

Angle:   Default: 45,  Range: any.
The direction of the blur. An angle of 0 produces a horizontal blur, and an angle of 90 produces a vertical blur. This parameter can be adjusted using the Angle Widget.

Shift:   Default: 0,  Range: any.
Shifts the image in the direction of the blur. A negative shift amount shifts the image in the opposite direction.

Bias:   Default: 0.5,  Range: 0 to 1.
Varies the weight of the pixels along the path of the blur, which gives the appearance of trails or streaks in a single direction. A value of 0.5 weights all pixels evenly. A value of 1 causes the weight to increase toward the direction of the blur, while a value of 0 has the opposite effect.

Blur Red:   Default: 1,  Range: 0 or greater.
The blur width of the red channel, relative to Blur Amount.

Blur Green:   Default: 1,  Range: 0 or greater.
The blur width of the green channel, relative to Blur Amount.

Blur Blue:   Default: 1,  Range: 0 or greater.
The blur width of the blue channel, relative to Blur Amount.

Shift Red:   Default: 0,  Range: -1 or greater.
Additional amount to shift the red color channel.

Shift Green:   Default: 0,  Range: -1 or greater.
Additional amount to shift the green color channel.

Shift Blue:   Default: 0,  Range: -1 or greater.
Additional amount to shift the blue color channel.

Brightness:   Default: 1,  Range: 0 or greater.
Scales the brightness of the result.

Offset Darks:   Default: 0,  Range: -8 to 2.
Adds this gray value to the darker regions of the result. This can be negative to increase contrast.

Mix With Source:   Default: 0,  Range: 0 to 1.
Interpolates between the blurred result (0) and the original source (1). 0.1 can give a nice misty effect since it mixes only a little of the source in.

Filter:   Popup menu,  Default: Box.
The type of convolution filter to blur with.
Box:  uses a rectangular shaped filter.
Triangle:  smoother, uses a pyramid shaped filter.
Gauss:  smoothest, uses a gaussian shaped filter.

Edge Mode:   Popup menu,  Default: Reflect.
Determines the behavior when accessing areas outside the source image.
Transparent:  Areas outside the source image are treated as transparent, which can produce transparency around the edges of the image. Select this for fastest rendering.
Repeat:  Repeats the last pixel outside the border of the image.
Reflect:  Reflects the image outside the border.

Soft Borders:   Check-box,  Default: off.
If enabled, transparent borders are added to the input image before processing. This allows the result to include soft edges beyond the original image size. When off, the effect only occurs within the frame and the result will retain an edge at the borders. This parameter does not appear in FCP or DF because those applications don't support image expansion.

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.

Show Blur Amount: Check-box, Default: on.
Turns on or off the screen user interface for adjusting the blur amount parameters.

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


See Also:

Blur
BlurChannels
BlurChroma
RackDefocus
DefocusPrism
EdgeBlur
BandPass
BlurMotion
Sapphire Plug-ins Introduction


© 2009, GenArts, Inc. All rights reserved.