You are here: Reference Guide > Ocula 3.0 Nodes > O_DisparityViewer

O_DisparityViewer

The O_DisparityViewer plug-in lets you visualise the disparity vectors in your node tree, display a histogram detailing positive and negative parallax, or overlay the Viewer with parallax violations.

NOTE: All three O_DisparityViewer modes are baked into your render if the node is enabled when you write your sequence out. This allows you to render the output alongside disparity for review.

Inputs and Controls

Connection Type	Connection Name	Function
Input	Source	This can be any node in the node tree with a disparity field in the disparity channels.

Control (UI)	Knob (Scripting)	Default Value	Function
O_DisparityViewer Tab
Views to Use	viewPair	Dependent on Source	Sets the two views you want to use when visualising the disparity vectors. These views will be mapped for the left and right eye.
Display	display	Disparity Vectors	Sets the display mode from the dropdown menu: • Disparity Vectors - overlays the disparity vectors for the current view. • Parallax Histogram - displays a parallax by pixel histogram. • Parallax Violation - overlays negative and positive parallax areas.
Vectors
disparityR rgba	disparityRColour	1,0,0,0.5	Sets the colour of the arrows used for displaying left-to-right disparity. You may want to change this, for example, if the colour of the arrows is very close to the colours in your input image, or if you want to compare the vectors from multiple O_DisparityViewers in the same Viewer.
disparityL rgba	disparityLColour	0,1,0,0.5	Sets the colour of the arrows used for displaying right-to-left disparity. You may want to change this, for example, if the colour of the arrows is very close to the colours in your input image, or if you want to compare the vectors from multiple O_DisparityViewers in the same Viewer.
Show Both Directions	showBoth Directions	disabled	When enabled, show the disparity vectors for both views rather than just the current view.
Vector Spacing	spacing	30	Sets how often a disparity vector will be drawn. If necessary, you can increase this value to make the display less cluttered. You may want to do so, for example, if the disparities are large and you don’t want neighbouring vectors to overlap one another.
Histogram
Histogram Range	histogramRange	User Defined	Sets the histogram range: • Automatic - the range is scaled to fit the range of disparity. • User Defined - the range is defined using the Histogram Min and Max controls as a percentage of screen width.
Histogram Min	histogramRange MinPct	-2.5	Controls the lower and upper limits of the histogram as a percentage of screen width, that is, the left-most and right-most points on the x axis. NOTE: These controls are only active when Histogram Range is set to User Defined.
Histogram Max	histogramRange MaxPct	4
Parallax
Negative Limit	negativeParallax LimitInPct	-1	Sets the amount of negative parallax allowed as a percentage of screen width. Areas outside this negative limit are marked by the overlay in the colour specified in the Negative Violation control.
Pixels	negativeParallax LimitInPixels	-20	Displays the number of pixels allowed by negative parallax. After adjusting the Negative Limit, you can use this corresponding value in the O_DisparityGenerator Parallax Limits > Negative control.
Positive Limit	positiveParallax LimitInPct	2	Sets the amount of positive parallax allowed as a percentage of screen width. Areas outside this positive limit are marked by the overlay in the colour specified in the Positive Violation control.
Pixels	positiveParallax LimitInPixels	41	Displays the number of pixels allowed by positive parallax. After adjusting the Positive Limit, you can use this corresponding value in the O_DisparityGenerator Parallax Limits > Positive control.
Negative Violation rgba	negativeViolation Colour	1,0,0,0.5	Sets the overlay colour for pixels outside the specified Negative Limit value.
Positive Violation rgba	positiveViolation Colour	0,1,0,0.5	Sets the overlay colour for pixels outside the specified Positive Limit value.