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 fil::ThresholdToRegion_Relative_DarkBright
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inRoi,
	const fil::Image& inBaseImage,
	float inDarkThreshold,
	float inBrightThreshold,
	float inHysteresis,
	fil::Region& outDarkRegion,
	fil::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