ThresholdToRegion_Relative_DarkBright

Module:	FoundationBasic

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

This filter can replace two instances of ThresholdToRegion_Relative which may slightly improve performance.

Name	Type	Range	Description
inImage	Image		Input image
inRoi	Region *		Region of interest
inBaseImage	Image		Pixels of this image are subtracted from inImage before thresholding
inDarkThreshold	Real		Maximum relative value of a pixel that is considered DarkRegion
inBrightThreshold	Real		Minimum relative value of a pixel that is considered BrightRegion
inHysteresis	Real	0.0 -	Defines how much the threshold criteria are lowered for pixels neighboring with other foreground pixels
outDarkRegion	Region		Region of pixels equal or lower than inDarkThreshold
outBrightRegion	Region		Region of pixels equal or greater than inBrightThreshold

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

This operation supports automatic parallelization for multicore and multiprocessor systems.

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

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.

This filter is available on Expert Complexity Level.

This filter is member of ThresholdToRegion filter group.