Histogram

Detailed Description

Generates a distribution from an image.

This kernel counts the number of occurrences of each pixel value within the window size of a pre-calculated number of bins. A pixel with intensity 'I' will result in incrementing histogram bin 'i' where

\[ i = (I - offset)*numBins/range for I >= offset \]

and

\[ I < offset + range. \]

Pixels with intensities that don't meet these conditions will have no effect on the histogram. Here offset, range and numBins are values of histogram attributes (see VX_DISTRIBUTION_OFFSET, VX_DISTRIBUTION_RANGE, VX_DISTRIBUTION_BINS).

Functions
vx_node VX_API_CALL	vxHistogramNode (vx_graph graph, vx_image input, vx_distribution distribution)
	[Graph] Creates a Histogram node. More...
vx_status VX_API_CALL	vxuHistogram (vx_context context, vx_image input, vx_distribution distribution)
	[Immediate] Generates a distribution from an image. More...

Function Documentation

vx_node VX_API_CALL vxHistogramNode	(	vx_graph	graph,
		vx_image	input,
		vx_distribution	distribution
	)

[Graph] Creates a Histogram node.

Parameters

[in]	graph	The reference to the graph.
[in]	input	The input image in VX_DF_IMAGE_U8.
[out]	distribution	The output distribution.

Returns

vx_node.

Return values

vx_node

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

vx_status VX_API_CALL vxuHistogram	(	vx_context	context,
		vx_image	input,
		vx_distribution	distribution
	)

[Immediate] Generates a distribution from an image.

Parameters

[in]	context	The reference to the overall context.
[in]	input	The input image in VX_DF_IMAGE_U8
[out]	distribution	The output distribution.

Returns

A vx_status_e enumeration.

Return values

VX_SUCCESS	Success
*	An error occurred. See vx_status_e.