You are here: Start » AVL.NET » Function Reference » Computer Vision » Template Matching » AVL.LocateSingleObject_Edges2

AVL.LocateSingleObject_Edges2

Finds a single occurrence of a predefined template on an image by comparing object edges.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void LocateSingleObject_Edges2
(
	AvlNet.Image inImage,
	NullableRef<AvlNet.ShapeRegion> inSearchRegion,
	AvlNet.CoordinateSystem2D? inSearchRegionAlignment,
	AvlNet.EdgeModel2 inEdgeModel,
	int inMinPyramidLevel,
	int? inMaxPyramidLevel,
	float inEdgeThreshold,
	AvlNet.EdgePolarityMode inEdgePolarityMode,
	AvlNet.EdgeNoiseLevel inEdgeNoiseLevel,
	bool inIgnoreBoundaryObjects,
	float inMinScore,
	INullable<AvlNet.Object2D> outObject,
	NullableRef<NullableRef<SafeList<AvlNet.Path>>> outObjectEdges,
	NullableValue<int> outPyramidHeight,
	NullableRef<AvlNet.ShapeRegion> outAlignedSearchRegion
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageImage on which object occurrence will be searched.
inSearchRegionAvlNet.NullableRef<AvlNet.ShapeRegion>Region of possible object centers. Default value: atl::NIL.
inSearchRegionAlignmentAvlNet.CoordinateSystem2D?Adjusts the region of interest to the position of the inspected object. Default value: atl::NIL.
inEdgeModelAvlNet.EdgeModel2Model of objects to be searched.
inMinPyramidLevelint<0, 12>0Defines the lowest pyramid level at which object position is still refined. Default value: 0.
inMaxPyramidLevelint?<0, 12>3Defines the total number of reduced resolution levels that can be used to speed up computations. Default value: 3.
inEdgeThresholdfloat<0.01f, INF>10.0fMinimum strength of edges used for matching with the model. Default value: 10.0f.
inEdgePolarityModeAvlNet.EdgePolarityModeMatchStrictlyDefines how edges with reversed polarity will contribute to the object score. Default value: MatchStrictly.
inEdgeNoiseLevelAvlNet.EdgeNoiseLevelHighDefines how much noise the object edges have. Default value: High.
inIgnoreBoundaryObjectsboolFalseFlag indicating whether objects crossing image boundary should be ignored or not. Default value: False.
inMinScorefloat<0.0f, 1.0f>0.7fMinimum score of object candidates accepted at each pyramid level. Default value: 0.7f.
outObjectAvlNet.INullable<AvlNet.Object2D>Found object. This parameter cannot be null.
outObjectEdgesAvlNet.NullableRef<AvlNet.NullableRef<AvlNet.SafeList<AvlNet.Path>>>Model edges of the found object. Can be null to skip this parameter calculation.
outPyramidHeightAvlNet.NullableValue<int>Highest pyramid level used to speed up computations. Can be null to skip this parameter calculation.
outAlignedSearchRegionAvlNet.NullableRef<AvlNet.ShapeRegion>Transformed input shape region. Can be null to skip this parameter calculation.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Hardware acceleration settings may be manipulated with Settings class.

Function Overrides

See also