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	Function
O_OcclusionDetector Tab
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.
Depth Occlusions	disparityError	0.1	Sets the threshold for marking occlusions at depth changes (that is, where there is a sharp change in disparity). Increase this value to flag more areas as occluded. Try using a value of 0.3 or 0.5 where there are extreme occlusions in the image.
Colour Threshold	colourError	0.05	Sets the threshold for marking occlusions at colour differences between views (that is, where the image content is different between the views). Decrease this value to flag more areas as occluded. Try using a value of 0.02 to pick up more occlusions if the colour variation in the image is flat. Try increasing the value to 0.1 if there are a lot of highly textured regions, such as foliage.
Refinement Options
Occlusion Size	occlusionSize	Small	Selects a preset for different occlusions sizes. Selecting the size of the regions that are visible in one view but not the other sets the Occlusion Dilate, Occlusion Fill, and Occlusion Blur controls accordingly. The default is Small, but if there is a lot of parallax in the images, there can be a lot of image content occluded or revealed between views so you can switch to Large or Extreme to create larger occlusion regions.
Occlusion Dilate	occlusionDilate	1	Sets the amount (in pixels) to expand the regions that are considered occluded.
Occlusion Fill	occlusionFill	4	Sets the size (in pixels) of holes to fill inside occluded regions. Increase this value to fill larger holes. Holes can appear and disappear, causing flicker when using O_ColourMatcher or O_FocusMatcher.
Occlusion Blur	occlusionBlur	8	Sets the amount (in pixels) to blur occlusion boundaries. Increase this value to smooth out transitions at occluded regions when using O_ColourMatcher or O_FocusMatcher.