O_OcclusionDetector

O_OcclusionDetector generates a mask for the occluded pixels in each view: that is, pixels visible in one view but not the other.

Inputs and Controls

Connection Type

Connection Name

Function

Input

Source

A stereo pair of images. If disparity channels aren’t embedded in the images, you should add an O_Solver and an O_DisparityGenerator node after the image sequence.

Control (UI)

Knob (Scripting) Default Value Description

O_OcclusionDetector Tab

Local GPU

gpuName

N/A

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.

Use GPU if available

useGPUIfAvailable

enabled

When enabled, rendering occurs on the Local GPU specified, if available, rather than the CPU. The output between the GPU and CPU is identical on NVIDIA GPUs, 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 that does have a GPU available.
You should also select this if you wish to render from the command line with the --gpu option.

Nuke also supports AMD GPUs on any Mac Pro running Mac OS X Mavericks (10.9.3 ), or later, mid 2015 MacBook Pros onward, and late 2017 iMac Pros. Bit-wise equality between GPU and CPU holds in most cases, but for some operations there are limitations to the accuracy possible with this configuration.

Warning:  Although AMD GPUs are enabled on Mac Pros manufactured prior to the late 2013 model, they are not officially supported and are used at your own risk.

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

Views to Use

viewPair

Dependent on source

Sets the two views you want to use to generate an occlusion mask. These views will be mapped for the left and right eye.

Gradient Threshold

gradientThreshold

1

Sets the gradient of the change in depth from horizontal disparity. You can use the Gradient Threshold control to define where occlusions occur at depth changes. The lower the gradient threshold, the greater the number of occluded regions.

Consistency Threshold

consistencyThreshold

1

Restricts occlusions where the left and right disparities are not consistent. A low Consistency Threshold value detects more inconsistencies and creates more occlusions.

Dilate Occlusions

dilateOcclusions

5

Expands the occluded regions by a specified number of pixels. The maximum you can dilate the occlusions by is 20 pixels.