Search Tips

Search is based on keyword.

`Ex: "Procedures"`

Do not search with natural language

`Ex: "How do I write a new procedure?"`

Give Feedback Support Portal

# O_FocusMatcher Controls

### Use GPU

Open the O_FocusMatcher controls. O_FocusMatcher renders using the Local GPU specified, if available, rather than the CPU. The GPU may significantly improve processing performance.

If there is no suitable GPU, or the required NVIDIA CUDA drivers are unavailable, O_FocusMatcher defaults to using the CPU. You can select a different GPU Device, if available, by opening Nuke's Preferences and selecting an alternative card from the GPU Device dropdown.

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

### Views to Use

From the views that exist in your project settings, select the two views you want to use to generate an occlusion mask. These views are mapped for the left and right eye.

### Match

The Match control allows you specify the direction in which to perform the focus match in.

Left to Right | Deblur or rebuild the left view to match the right.
Right to Left | Deblur or rebuild the right view to match the left.

### Mode

You can use two different modes to perform a focus match:

Match Edges | The Match Edges mode matches the appearance of the edges from one view to the other. If you want to preserve the original image structure, it is recommended to use this mode. If the blurring in your input images is subtle, the Match Edges mode may produce the best possible result.
Reconstruct Edges | The Reconstruct Edges mode rebuilds the edges in one view from scratch using the pixels from the other. If you want to rebuild focus exactly, or if the blurring in your image is heavy or varying, it is recommended that you use this mode. The result of this mode depends on the accuracy of the existing disparity vectors.

### Mask

If there are areas in the image that you want to ignore when calculating the focus calculation, you can use the Mask control to supply a mask. In the O_FocusMatcher controls, set Mask to the component you want to use as the mask. The following Mask settings are available:

None | Use the entire image area.
Source Alpha | Use the alpha channel of the Source clip as a mask.
Source Inverted Alpha | Use the inverted alpha channel of the Source clip as a mask.
Mask Luminance | Use the luminance of the Mask input as a mask.
Mask Inverted Luminance | Use the inverted luminance of the Mask input as a mask.
Mask Alpha | Use the alpha channel of the Mask input as a mask.
Mask Inverted Alpha | Use the inverted alpha channel of the Mask input as a mask.

Note: You can also use the alpha channel of the Source input to supply a mask.

### Local Matching

#### Edge Scale

This allows you to scale the edges where focus matching is performed. To restrict matching to sharp edges, use a small scale value. To match wider edges in the image, increase the scale value.

#### Strength

You can use the Strength control to set the amount of focus correction to apply. Set this to 0 for no correction, or 1 for complete correction.

#### Noise

Note: This option is only available when the Reconstruct Edges mode is selected.

The Noise control allows you to preserve the noise of the original image when using the Reconstruct Edges mode. To ignore noise, set this control to a low value. This matches the focus of fine details and can reconstruct noise from the other view. To retain as much of the original noise as possible, use higher values. This ensures that noise is not coherent between views, but may not match the focus at fine details in the image.

### Occlusions

#### Output occlusions to alpha

Select the Output occlusions to alpha checkbox to output the corrected area to the alpha channel.The corrected area can consist of the occlusion mask and the disparity edge mask set using the Adjust Edges control, depending on what the Correction control is set to (Occlusions, Occlusions and Edges, or None).

#### Correction

Defines which areas receive the focus correction when local focus matching is not valid.

Occlusions | Fill occluded pixels only, where color is missing from the other view.
Occlusions and Edges | Fill occluded pixels, where color is missing from the other view, and compensate for disparity changes at edges where matching can fail.
None | Apply no occlusion or edge correction.

#### Adjust Edges

The Adjust Edges control allows you to set the threshold for treating image edges as occlusions to reduce haloing and edge flicker. The higher the value, the more image edges are considered occlusions, even if they aren’t marked as such in the upstream occlusion mask.

#### Colour Tolerance

The Colour Tolerance control allows you to set the amount of blurring across edges in the focus match at occluded regions. Decrease this to restrict the color correction in occluded regions to similar colors. Increase the value to blur the focus correction.

#### Support Size

Use the Support Size control to set the size of the region (in pixels) of unoccluded pixels used to calculate the focus correction at a corrected pixel.

#### Stabilise occlusions

Enabling this control can reduce flicker in occluded areas by using data from multiple frames.