ImageBlur

Adds blur to an image or matte using Box, Triangle, Gaussian, Bell, BSpline, or Mitchell filter algorithms. The blur value is calculated for image pixels by examining their neighbors within the constraints of the xAmount and yAmount controls, and applying the selected algorithms.

Connection Type

Connection Name

Function

Input

input

The image sequence you want to blur.

out_mask

An optional image to use as a mask. By default, the blur effect is limited to the non-black areas of the mask.

 

Control (UI)

Default Value

Function

[2D node controls]

N/A

Set the controls for the stereo view.

For more information, refer to the Common 2D Nodes Widget Type in Common Parameter Widgets.

ImageBlur parameters continued

xAmount

0

Sets the horizontal radius (in pixels) within which pixels are compared to calculate the blur. Higher values widen the compare area, producing more blur.

yAmount

xAmount

Sets the vertical radius (in pixels) within which pixels are compared to calculate the blur. Higher values widen the compare area, producing more blur.

By default, this value is the same as xAmount.

filter

Gaussian

Select the filtering algorithm to use:

• Box

• Triangle

• Gaussian

• Bell

• BSpline

• Mitchell

borderExtend

Clamp

Select the border extend method for pixels required beyond the image borders:

• Mirror

• Clamp

• Background

useOverscan

globals.compDefaults.useOverscan

Sets whether to use upstream overscan (if available) during the border extension process. If overscan is available (and of usable quality), this typically yields superior results around frame edges.

However, if you are unsure of this procedure or the integrity of overscanned areas is unknown, it's safer to leave this disabled.

Overscan refers to image pixel data outside of the displayWindow and can be inspected using options in the Monitor.

For information on explicitly manipulating these regions, see the ImageCrop node.

channelAmounts

red

1

Applies a multiplier to the blur amount for the red channel.

green

1

Applies a multiplier to the blur amount for the green channel.

blue

1

Applies a multiplier to the blur amount for the blue channel.

alpha

1

Applies a multiplier to the blur amount for the alpha channel.