You are here: Start » AVL.NET » Function Reference » Image » Image Thresholding » AVL.ThresholdToRegion_Color

AVL.ThresholdToRegion_Color

Creates a region containing image pixels with values close to the given color.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void ThresholdToRegion_Color
(
	AvlNet.Image inImage,
	NullableRef<AvlNet.Region> inRoi,
	AvlNet.Pixel inRgbColor,
	float inChromaAmount,
	float inMaxDifference,
	float inHysteresis,
	AvlNet.Region outRegion
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inRoiAvlNet.NullableRef<AvlNet.Region>Region of interest. Default value: atl::NIL.
inRgbColorAvlNet.PixelColor to compare the image to.
inChromaAmountfloat<0.0f, 1.0f>0.7fProportion of chromatic information in distance computation. Default value: 0.7f.
inMaxDifferencefloat<0.0f, INF>5.0fMaximum difference between image pixel and model color. Default value: 5.0f.
inHysteresisfloat<0.0f, INF>0.0fDefines how much the difference criterium is lowered for pixels neighboring with other foreground pixels. Default value: 0.0f.
outRegionAvlNet.RegionOutput region.

Examples

ThresholdToRegion_Color performed on a sample image with inRgbColor = (192, 34, 22), inChromaAmount = 1.0, inMaxDifference = 48.

Hardware Acceleration

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

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

This operation supports automatic parallelization for multicore and multiprocessor systems.

Hardware acceleration settings may be manipulated with Settings class.

Errors

List of possible exceptions:

Error type Description
DomainError Region exceeds an input image in ThresholdToRegion_Color.
DomainError Not supported inImage pixel format in ThresholdToRegion_Color. Supported formats: 1xUInt8, 2xUInt8, 3xUInt8, 4xUInt8.

Function Overrides

See also