Convolve

The filter image. This image is used as the convolution matrix.

Note that you don’t necessarily need to crop the filter image to a smaller size, as Fast Fourier Transforms are used to speed up convolutions with large filter images.

The image sequence to receive the convolution filter effect.

Displays the GPU used for rendering when Use GPU if available is enabled. Local GPU displays Not available when:

• Use CPU is selected as the GPU Device in the Preferences.

• no suitable GPU was found on your system.

• it was not possible to create a context for processing on the selected GPU, such as when there is not enough free memory available on the GPU.

You can select a different GPU Device, if available, by navigating to the Preferences and selecting an alternative from the GPU Device dropdown.

NOTE:   Selecting a different GPU requires you to restart Nuke before the change takes effect.

When enabled, rendering occurs on the Local GPU specified, if available, rather than the CPU. The output between the GPU and CPU is identical, but using the GPU can significantly improve processing performance.

NOTE:  Enabling this option with no local GPU allows the script to run on the GPU whenever the script is opened on a machine which does have a GPU available.
You should also select this if you wish to render from the command line with the --gpu option.

The GPU processing also requires certain NVIDIA GPUs and CUDA drivers. For more information on the minimum requirements, please refer to the Nuke Release Notes available in Help > Release Notes.

The filter effect is only applied to these channels.

If you set this to something other than all or none, you can use the checkboxes on the right to select individual channels.

The channel to use as the convolution matrix from the filter input.

This control is only available if use input channels is disabled.

When enabled, Convolve uses the same channels from the filter input as the image input (that is, whatever channels is set to).

Sets what to use as the filter bounds:

• shape - The filter input’s bounding box. In this case, Convolve only uses the bounding box area, and the center of the filter is the center of the bounding box. This is the default value, and you may want to use it if your filter input is a roto shape with a small bounding box that doesn’t fill the entire format area, for example.

• format - The filter input’s format. In this case, Convolve uses the entire format area, allowing you to offset the filter image within the format.

When enabled, the filter input is divided by the sum of all the pixels in it before using it. This ensures that the convolution doesn’t change the overall brightness.

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

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

For example, you can use a depth channel here to simulate depth-of-field blurring.

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

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

Blurs the edges of the mask.