You are here: Start » Function Reference » Image » Image Thresholding » ThresholdToRegion_Relative_DarkBright

ThresholdToRegion_Relative_DarkBright

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

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

Syntax

void avl::ThresholdToRegion_Relative_DarkBright
(
	const avl::Image& inImage,
	atl::Optional<const avl::Region&> inRoi,
	const avl::Image& inBaseImage,
	float inDarkThreshold,
	float inBrightThreshold,
	float inHysteresis,
	avl::Region& outDarkRegion,
	avl::Region& outBrightRegion
)

Parameters

	Name	Type	Range	Default	Description
	inImage	const Image&			Input image
	inRoi	Optional<const Region&>		NIL	Region of interest
	inBaseImage	const Image&			Pixels of this image are subtracted from inImage before thresholding
	inDarkThreshold	float		64.0f	Maximum relative value of a pixel that is considered DarkRegion
	inBrightThreshold	float		192.0f	Minimum relative value of a pixel that is considered BrightRegion
	inHysteresis	float	0.0 -	0.0f	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

Hardware Acceleration

Errors