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.

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.

See Nuke 14 Release Notes for more information on the GPUs Nuke supports.

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.