You are here: Start » FIL.NET » Function Reference » Image » Image Thresholding » FIL.ThresholdToRegion_Relative_DarkBright

FIL.ThresholdToRegion_Relative_DarkBright

Thresholds an image using two relative thresholds and produces two regions (Dark and Bright) in a single image pass.

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

C++
C#
 
public static void ThresholdToRegion_Relative_DarkBright
(
	FilNet.Image inImage,
	FilNet.Image inBaseImage,
	float inDarkThreshold,
	float inBrightThreshold,
	float inHysteresis,
	FilNet.Region outDarkRegion,
	FilNet.Region outBrightRegion
)

Parameters

Name Type Range Default Description
inImageFilNet.ImageInput image.
inBaseImageFilNet.ImagePixels of this image are subtracted from inImage before thresholding.
inDarkThresholdfloat64.0fMaximum relative value of a pixel that is considered DarkRegion. Default value: 64.0f.
inBrightThresholdfloat192.0fMinimum relative value of a pixel that is considered BrightRegion. Default value: 192.0f.
inHysteresisfloat<0.0f, INF>0.0fDefines how much the threshold criteria are lowered for pixels neighboring with other foreground pixels. Default value: 0.0f.
outDarkRegionFilNet.RegionRegion of pixels equal or lower than inDarkThreshold.
outBrightRegionFilNet.RegionRegion of pixels equal or greater than inBrightThreshold.

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 Image formats are not the same in ThresholdToRegion_Relative_DarkBright.
DomainError Image sizes are not equal in ThresholdToRegion_Relative_DarkBright.
DomainError Region exceeds an input image in ThresholdToRegion_Relative_DarkBright.

Function Overrides

See also