You are here: Start » AVL.NET » AVL.ThresholdToRegion(AvlNet.Image, AvlNet.Region, float?, float?, float, AvlNet.Region)

AVL.ThresholdToRegion(AvlNet.Image, AvlNet.Region, float?, float?, float, AvlNet.Region)

Creates a region containing image pixels with values within the specified range.

Namespace:	AvlNet
Assembly:	AVL.NET.dll

Syntax


public static void ThresholdToRegion(
	AvlNet.Image inImage,
	AvlNet.Region inRoi,
	float? inMinValue,
	float? inMaxValue,
	float inHysteresis,
	out AvlNet.Region outRegion
)

Parameters

inImage: Type: AvlNet.Image
Input image
inRoi: Type: AvlNet.Region
Region of interest, or null.
inMinValue: Type: System.Nullable<System.Single>
Minimum value of a pixel that is considered foreground (Auto = -INF), or null.
inMaxValue: Type: System.Nullable<System.Single>
Maximum value of a pixel that is considered foreground (Auto = +INF), or null.
inHysteresis: Type: System.Single
Defines how much the threshold criteria are lowered for pixels neighboring with other foreground pixels
outRegion: Type: AvlNet.Region
Output region

Description

The operation is a cousin of ThresholdImage yet computes a region instead of an image. The resulting region contains those pixels of the input image that meet one of the following conditions:

Pixel value is in range [inMinValue, inMaxValue].
Pixel value is in range [inMinValue-inHysteresis, inMinValue) or in range (inMaxValue, inMaxValue+inHysteresis] and in the processed image there is a path of consecutive pixels of value in range [inMinValue-inHysteresis, inMaxValue+inHysteresis] that connects the pixel being considered and any pixel with value in range [inMinValue, inMaxValue].

If any of the parameters inMinValue, inMaxValue is not set, it is assumed to be, accordingly, -infinity or infinity.

In the multichannel images the operation uses an average of channel values in each pixel.

Examples

ThresholdToRegion performed on the sample image with inMinValue = 80.0, inMaxValue = auto.

Hardware Acceleration

This operation is optimized for SSE2 technology for pixels of types: 1xUINT8, 3xUINT8.

This operation supports automatic parallelization for multicore and multiprocessor systems.