DirBlur

This node applies three types of directional blur to the input image: zoom, radial, and linear.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The image sequence to receive the blur effect.

mask

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

At first, the mask input appears as triangle on the right side of the node, but when you drag it, it turns into an arrow labeled mask. If you cannot see the mask input, ensure that the mask control is disabled or set to none.

Control (UI)

Knob (Scripting)

Default Value

Function

DirBlurWrapper Tab

channels

channels

all

The blur effect is only applied to these channels. You should leave this set to all and select the channels you want to blur using BlurLayer.

BlurType

BlurType

zoom

Select the blur type to apply:

zoom - smears pixels in all directions from a center point. You can use this to simulate light rays, or to transition between one clip and another.

radial - smears pixels around a center point. You can use this to simulate motion blur on a rotating object.

linear - smears pixels in a given direction. You can use this to simulate motion blur on a moving object.

BlurLayer

BlurLayer

rgb

The blur effect is only applied to these channels. This control works together with the channels control. For a channel to be blurred, it needs to be selected from both the channels and the BlurLayer dropdown menu.

You can use the checkboxes on the right to select individual channels.

Holdout Channel

N/A

disabled

Enables the associated holdout channel to the right. Disabling this checkbox is the same as setting the channel to none.

This control only has an effect when BlurType is set to zoom.

holdout

none

Pixels corresponding to non-black pixels in the holdout channel are NOT averaged into the final pixel value.

This control only has an effect when BlurType is set to zoom.

BlurCenter xy

BlurCenter

320, 240

Sets the blur origin or center on the xy axes, or drag the BlurCenter handle in the Viewer.

When using linear blur, BlurCenter only has an effect if UseTarget is enabled.

BlurLength

BlurLength

5

The length (in pixels) of the blur applied.

When using zoom blur, negative values reverse the blur direction.

BlurAngle

BlurAngle

45

Determines the direction of linear blur when UseTarget is disabled.

Linear Target xy

target

480, 240

When using linear blur with UseTarget enabled, a vector is created between this and BlurCenter. This vector then determines the direction of linear blur.

You can also adjust Linear Target by dragging the target handle in the Viewer.

UseTarget

UseTarget

disabled

When enabled, the direction of linear blur is determined by a vector between BlurCenter and Blur Target.

If this is disabled, the direction of linear blur is determined by Blur Angle.

Samples

Samples

1

The number of samples. You can increase this value for smoother blur, but note that it takes much longer to render.

PixelAspect

PixelAspect

1

Pixel aspect ratio. If you’re working on non-square pixel or anamorphic footage, you need to set this value correctly to avoid unwanted distortions.

Quality

Quality

1

The scaling factor of the blur. The minimum value is 1 and produces the highest quality.

Pixel Offset

pixeloffset

0

When BlurType is set to zoom, lets you offset pixels along the direction of the blur.

mask

N/A

disabled

Enables the associated mask channel to the right. Disabling this checkbox is the same as setting the channel to none.

maskChannelInput

none

The channel to use as a mask. By default, the blur is limited to the non-black areas of this channel.

inject

inject

disabled

Copies the mask input to the predefined mask.a channel. Injecting the mask allows you to use the same mask further downstream.

invert

invert_mask

disabled

Inverts the use of the mask channel so that the blur is limited to the non-white areas of the mask.

fringe

fringe

disabled

When enabled, only apply the effect to the edge of the mask.

When disabled, the effect is applied to the entire mask.

mix

mix

1

Dissolves between the original image at 0 and the full blur effect at 1.