Home

Introduction

NukeCGDenoiser is a plugin for Foundry's Nuke written in C++. It allows denoising CG renders using Intel's OpenImageDenoise library.

Installing OpenImageDenoise library

This plugin requires OpenImageDenoise library installed in your system in order to run.

Windows:

1. Download the latest version of the library from the Releases page.
2. Extract the binaries from the downloaded oidn-<VERSION>.x64.windows.zip into some location (i.e. C:\oidn-<VERSION>-x64-windows)
3. Go to Start, Edit environment variables for your account.
4. Create (or edit existing one) a new variable called Path. Set the value to the location where you extracted the library, i.e. C:\oidn-<VERSION>-x64-windows\bin

$PATH environment variable on Windows needs to specifically point to the bin directory, where the OpenImageDenoise.dll library resides.

Linux:

1. Download the latest version of the OIDN library from the releases page.
2. Extract the binaries into some location.
3. Edit your .bashrc or .zshrc, add the path to the library to the $PATH:

export PATH="/path/to/oidn/bin:$PATH"

MacOS

On MacOS, the easiest way to install OIDN is by using Homebrew.

Use the following command to download the precompiled binaries to your machine:

brew install open-image-denoise

Installing the plugin

1. Go to the Releases page of the plugin's repository.
2. Download the binary package for your system (i.e. Linux)
3. Extract content of the package into ~/.nuke/nuke-denoiser folder.
4. Open ~/.nuke/init.py in a text editor (create the file, if it doesn't exist). Place the following line at the end:

nuke.pluginAddPath('nuke-denoiser')

5. Save the file, launch Nuke.
6. You should be able to create the node by hitting Tab key and typing Denoiser or using the dedicated menu.

How to use the plugin?

Denoiser node has three inputs for each of the AOVs that can be processed by the filter:

• beauty (default)
• albedo (optional)
• normals (optional)

Albedo and normals input are not required, but the denoised image should improve in quality if you decide to use all three AOVs.

Available Knobs

Denoiser node has the following knobs available to tweak:

• Device Type - allows to select which device the denoising filter will be executed on. You can toggle between Auto, CPU, SYCL, CUDA and HIP. Not all platforms support every device type, it depends on your operating system and GPU drivers.
• HDR - use if the beauty input image is high-dynamic range
• Enable thread affinity - enables thread affinitization
• Memory limit (MB) - approximate maximum scratch memory to use in megabytes
• Number of runs - number of times the denoise filter is executed on the image