O_DisparityGenerator

A stereo pair of images. If you intend to use the Alignment control, O_DisparityGenerator requires an O_Solver node as one of its inputs. Alignment defaults to 0, but increasing it forces the disparity map to match the camera geometry to remove noise on the vertical component of disparity.

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.

Use the Preset dropdown to automatically make adjustments to the disparity results by changing the appropriate refinement controls:

• Custom - Automatically selected when you adjust the controls manually,

• Normal - The default value for all controls.

• Strong - Increases match Strength between images at the expense of Stabilisation.

You can use Strong when picture building is poor using O_NewView, O_ColourMatcher, and O_FocusMatcher.

• Aggressive - Increases the Strength used to reconstruct images as close as possible to the source, but reduces Stabilisation in favour of accuracy.

This option gives the best result in O_NewView to reproduce the appearance of one view from another and is useful for colour or focus matching.

NOTE:  Aggressive calculation can produce poor stability, which makes it unsuitable for copying fixes from one view to the other.

• Smooth - Reduces match Strength between images and concentrates on Stabilisation.

This option produces smoother, temporally stable vectors. Use Smooth to generate clean depth maps and to prevent flicker when copying a fix from one view to the other.

NOTE:  Smooth vectors are cleaner and stable from one frame to the next, but the image may not reconstruct well with O_NewView.

• Aligned - This option enables the Alignment control, which requires an O_Solver upstream.

• Fast - This option disables the Stabilisation control, reducing processing time.

An optional mask that specifies areas to exclude from the disparity calculation. You can use this input to prevent distortions at occlusions or to calculate disparity for a background layer by ignoring all foreground elements.

Note that masks should exist in both views, and O_DisparityGenerator treats the alpha values of 1 as foreground and blurs to the 0 value using nearby disparity to recreate object boundaries, rather than image data. When you create a mask using Roto or RotoPaint, you can use the feather control to extend the calculation. For example, the disparity map may have a sharper transition at depth edges with a binary mask, but applying feather on the mask can help smooth the resulting image.

• None - Use the entire image area.

• Source Alpha - Use the alpha channel of the Source clip as an ignore mask.

• Source Inverted Alpha - Use the inverted alpha channel of the Source clip as an ignore mask.

• Mask Luminance - Use the luminance of the Mask input as an ignore mask.

• Mask Inverted Luminance - Use the inverted luminance of the Mask input as an ignore mask.

• Mask Alpha - Use the alpha channel of the Mask input as an ignore mask.

• Mask Inverted Alpha - Use the inverted alpha channel of the Mask input as an ignore mask.

Adjusts the density of the calculated disparity vectors. Higher detail picks up finer disparity changes, but takes longer to calculate.

Sets the strength applied when matching pixels between the left and right views. Higher values allow you to accurately match similar pixels in one image to another, concentrating on detail matching even if the resulting disparity map is jagged. Lower values may miss local detail, but are less likely to provide you with the odd spurious vector, producing smoother results.

Often, it is necessary to trade one of these qualities off against the other. You may want to increase Strength to force the views to match where fine details are missed, or decrease it to smooth out the disparity map.

Sets how accurately the same points in the left and right views are mapped to each other. Increase the value to encourage the left and right disparity vectors to match.

Controls how image edges are used as clues for sharp transitions in depth in the scene. The higher the value, the smoother the transition between depths at edges in the image.

Sets how much to constrain the disparities to match the vertical alignment defined by an upstream O_Solver node. Increasing the value forces the disparities to be aligned and requires at least one keyframe match.

NOTE:  The default Alignment value of 0 calculates the disparity using unconstrained motion estimation, and therefore, does not require O_Solver data.

Using O_DisparityGenerator in conjunction with O_Solver alignment data allows you to constrain the resulting disparity vectors to match global plate alignment. You might want to do this if your plates don't contain much detail, such as bluescreen images with markers in the background or plates with a lot of featureless areas like sky.

NOTE:  Using the O_Solver alignment data can reduce changes in vertical disparity with depth that are required for Local alignment in O_VerticalAligner and cause a vertical shift in O_NewView, where disparity doesn't pick up the local vertical shift required to match the images.