Thresholding

Detailed Description

Thresholds an input image and produces an output Boolean image.

In VX_THRESHOLD_TYPE_BINARY, the output is determined by [R00117]:

\[ dst(x,y) = \begin{cases} true\ value & \text{if } src(x,y) > threshold \cr false\ value & \text{otherwise } \end{cases} \]

In VX_THRESHOLD_TYPE_RANGE, the output is determined by [R00118]:

\[ dst(x,y) = \begin{cases} false\ value & \text{if } src(x,y) > upper \cr false\ value & \text{if } src(x,y) < lower \cr true\ value & \text{otherwise } \end{cases} \]

Where 'false value' is the value indicated by the VX_THRESHOLD_FALSE_VALUE attribute of the thresh parameter, and the 'true value' is the value indicated by the VX_THRESHOLD_TRUE_VALUE attribute of the thresh parameter [R00119].

Functions
vx_node VX_API_CALL	vxThresholdNode (vx_graph graph, vx_image input, vx_threshold thresh, vx_image output)
	[Graph] Creates a Threshold node. More...

Function Documentation

vxThresholdNode()

vx_node VX_API_CALL vxThresholdNode	(	vx_graph	graph,
		vx_image	input,
		vx_threshold	thresh,
		vx_image	output
	)

[Graph] Creates a Threshold node.

Parameters

[in]	graph	The reference to the graph [R00212].
[in]	input	The input image. VX_DF_IMAGE_U8 is supported [R00213].
[in]	thresh	The thresholding object that defines the parameters of the operation [R00214]. The VX_THRESHOLD_TRUE_VALUE and VX_THRESHOLD_FALSE_VALUE are taken into account.
[out]	output	The output Boolean image with values either VX_THRESHOLD_TRUE_VALUE or VX_THRESHOLD_FALSE_VALUE from the thresh parameter [R00215].

Returns

vx_node [R00216].

Return values

vx_node

A node reference. Any possible errors preventing a successful creation should be checked using vxGetStatus