Kernel: Threshold

Functions
VX_API_ENTRY vx_node VX_API_CALL	vxThresholdNode (vx_graph graph, vx_image input, vx_threshold thresh, vx_image output)
	[Graph] Creates a Threshold node and returns a reference to it.
VX_API_ENTRY vx_status VX_API_CALL	vxuThreshold (vx_context context, vx_image input, vx_threshold thresh, vx_image output)
	[Immediate] Threshold's an input image and produces a VX_DF_IMAGE_U8 boolean image.

Detailed Description

Function Documentation

vxThresholdNode()

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

#include <vx_nodes.h>

[Graph] Creates a Threshold node and returns a reference to it.

Parameters

[in]	graph	The reference to the graph in which the node is created.
[in]	input	The input image. Only images with format VX_DF_IMAGE_U8 and VX_DF_IMAGE_S16 are supported.
[in]	thresh	The thresholding object that defines the parameters of the operation. The VX_THRESHOLD_INPUT_FORMAT must be the same as the input image format and the VX_THRESHOLD_OUTPUT_FORMAT must be the same as the output image format.
[out]	output	The output image, that will contain as pixel value true and false values defined by thresh. Images with format VX_DF_IMAGE_U8 or VX_DF_IMAGE_U1 are supported. The dimensions are the same as the input image.

Returns

vx_node.

Return values

vx_node

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

Examples

bubble_pop.cpp, and skinToneDetector.cpp.

vxuThreshold()

VX_API_ENTRY vx_status VX_API_CALL vxuThreshold	(	vx_context	context,
		vx_image	input,
		vx_threshold	thresh,
		vx_image	output )

#include <vxu.h>

[Immediate] Threshold's an input image and produces a VX_DF_IMAGE_U8 boolean image.

Parameters

[in]	context	The reference to the overall context.
[in]	input	The input image. Only images with format VX_DF_IMAGE_U8 and VX_DF_IMAGE_S16 are supported.
[in]	thresh	The thresholding object that defines the parameters of the operation. The VX_THRESHOLD_INPUT_FORMAT must be the same as the input image format and the VX_THRESHOLD_OUTPUT_FORMAT must be the same as the output image format.
[out]	output	The output image, that will contain as pixel values true and false values defined by thresh. Only images with format VX_DF_IMAGE_U8 or VX_DF_IMAGE_U1 are supported. Must be of the same size as the input image.

Returns

A vx_status_e enumeration.

Return values

VX_SUCCESS	Success
*	An error occurred. See vx_status_e.