You are here: Start » AVL.NET » Invoke.LocateSingleObject_SAD

Invoke.LocateSingleObject_SAD

Finds a single occurrence of a predefined template on an image by analysing the Square Average Difference between pixel values.

Namespace:Avl
Assembly:AvlNet.dll

Syntax

C++
C#
 
public static void LocateSingleObject_SAD
(
	Avl.Image inImage,
	Optional<Avl.ShapeRegion> inSearchRegion,
	Optional<Avl.CoordinateSystem2D> inSearchRegionAlignment,
	Avl.GrayModel inGrayModel,
	int inMinPyramidLevel,
	Optional<int> inMaxPyramidLevel,
	bool inIgnoreBoundaryObjects,
	float inMaxDifference,
	Conditional<Avl.Object2D> outObject,
	Optional<int> outPyramidHeight,
	Optional<Avl.ShapeRegion> outAlignedSearchRegion,
	Diagnostic<List<Avl.Image>> diagImagePyramid,
	Diagnostic<List<Avl.Image>> diagMatchPyramid,
	Diagnostic<Conditional<List<float>>> diagScores
)

Parameters

Name Type Range Default Description
inImageAvl.ImageImage on which model occurrence will be searched.
inSearchRegionAtl.Optional<Avl.ShapeRegion>Possible centers of the object occurrence. Default value: atl::NIL.
inSearchRegionAlignmentAtl.Optional<Avl.CoordinateSystem2D>Adjusts the region of interest to the position of the inspected object. Default value: atl::NIL.
inGrayModelAvl.GrayModelModel which will be sought.
inMinPyramidLevelint<0, 12>0Defines the highest resolution level. Default value: 0.
inMaxPyramidLevelAtl.Optional<int><0, 12>3Defines the number of reduced resolution levels that can be used to speed up computations. Default value: 3.
inIgnoreBoundaryObjectsboolFalseFlag indicating whether objects crossing image boundary should be ignored or not. Default value: False.
inMaxDifferencefloat<0.0f, INF>0.0fMaximum accepted average difference between pixel values. Default value: 0.0f.
outObjectAtl.Conditional<Avl.Object2D>Found object.
outPyramidHeightAtl.Optional<int>Highest pyramid level used to speed up computations.
outAlignedSearchRegionAtl.Optional<Avl.ShapeRegion>Transformed input shape region.
diagImagePyramidAvl.Diagnostic<System.Collections.Generic.List<Avl.Image>>Pyramid of iteratively downsampled input image.
diagMatchPyramidAvl.Diagnostic<System.Collections.Generic.List<Avl.Image>>Locations found on each pyramid level.
diagScoresAvl.Diagnostic<Atl.Conditional<System.Collections.Generic.List<float>>>Scores of found match on each pyramid level.

See also