You are here: Start » AVL.NET » AVL.ImageHistogram Method

AVL.ImageHistogram Method

Computes the histogram of the image pixel values.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

public static void ImageHistogram(
	AvlNet.Image inImage,
	AvlNet.Region inRoi,
	int inChannelIndex,
	float inBinSize,
	float inDomainBegin,
	float inDomainEnd,
	out AvlNet.Histogram outHistogram
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inRoiAvlNet.RegionRange of pixels to be processed. Default value: atl::NIL, or null.
inChannelIndexint<0, 3>Selects a channel of the input image.
inBinSizefloat<0.0f, INF>1.0fWidth of a single histogram bin. Default value: 1.0f.
inDomainBeginfloat0.0fThe lowest value that will be considered in the output histogram. Default value: 0.0f.
inDomainEndfloat256.0fThe upper-bound for values that will be considered in the output histogram. Default value: 256.0f.
outHistogramAvlNet.HistogramOutput histogram.

Description

Histogram in Adaptive Vision Studio is a graphical representation of data contained in image. That is, the resulting histogram contains number of pixel values from specified channel with selected inBinSize (interval).

Examples

ImageHistogram performed on the Lena image with inChannelIndex = 0, inBinSize = 1.

Errors

Error type Description
DomainError Selected channel index is out of range in ImageHistogram.
DomainError Selected bin size equals zero in ImageHistogram.
DomainError Selected domain has zero or negative size inImageHistogram.

See also