You are here: Start » Function Reference » Computer Vision » Image Analysis » CheckPresence_EdgeAmount_Deprecated

CheckPresence_EdgeAmount_Deprecated

Header:	AVL.h
Namespace:	avl
Module:	FoundationPro

Verifies object presence by analysing the amount of edges in the specified region.

Applications: Quick and easy presence verification, e.g. for missing caps, screws, labels.

Syntax

void avl::CheckPresence_EdgeAmount_Deprecated
(
	const avl::Image& inImage,
	const avl::ShapeRegionDeprecated& inRoi,
	atl::Optional<const avl::CoordinateSystem2D&> inRoiAlignment,
	avl::GradientMaskOperator::Type inEdgeOperator,
	avl::MagnitudeMeasure::Type inEdgeMeasure,
	const int inEdgeScale,
	int inMinStrength,
	float inMinAmount,
	float inMaxAmount,
	bool& outIsPresent,
	atl::Optional<float&> outAmount = atl::NIL,
	atl::Optional<avl::Region&> outForeground = atl::NIL,
	atl::Optional<avl::ShapeRegionDeprecated&> outAlignedRoi = atl::NIL
)

Parameters

Name	Type	Range	Default	Description
inImage	const Image&			Input image
inRoi	const ShapeRegionDeprecated&			Location at which object presence is being checked
inRoiAlignment	Optional<const CoordinateSystem2D&>		NIL	Adjusts the region of interest to the position of the inspected object
inEdgeOperator	GradientMaskOperator::Type			Selected gradient operator
inEdgeMeasure	MagnitudeMeasure::Type		Sum	Selected method of gradient magnitude computation
inEdgeScale	const int	1 - 16	1	Scales the resulting gradient magnitudes
inMinStrength	int	0 - 255	15	Lowest acceptable edge magnitude
inMinAmount	float	0.0 - 1.0	0.2f	Lowest acceptable fraction of pixels meeting the criteria
inMaxAmount	float	0.0 - 1.0	1.0f	Highest acceptable fraction of pixels meeting the criteria
outIsPresent	bool&			Flag indicating whether the object is present or not
outAmount	Optional<float&>		NIL	Fraction of pixels from meeting the criteria
outForeground	Optional<Region&>		NIL	Region of pixels meeting the criteria
outAlignedRoi	Optional<ShapeRegionDeprecated&>		NIL	Input ROI after transformation (in the image coordinates)

Optional Outputs

The computation of following outputs can be switched off by passing value atl::NIL to these parameters: outAmount, outForeground, outAlignedRoi.