You are here: Start » AVL.NET » AVS.LocateMultipleObjects_Edges2 Method

AVS.LocateMultipleObjects_Edges2 Method

Finds all occurrences of a predefined template on an image by comparing object edges.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

public static void LocateMultipleObjects_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,
	int inMaxDeformation,
	float inMinScore,
	float inMinDistance,
	IList<AvlNet.Object2D> outObjects,
	NullableRef<SafeList<SafeList<AvlNet.Path>>> outObjectEdges,
	NullableValue<int> outPyramidHeight,
	NullableRef<AvlNet.ShapeRegion> outAlignedSearchRegion,
	IList<AvlNet.Image> diagEdgePyramid,
	IList<AvlNet.Image> diagMatchPyramid,
	IList<List<float>> diagScores
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageImage on which object occurrences 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 objects edges have. Default value: High.
inIgnoreBoundaryObjectsboolFalseFlag indicating whether objects crossing image boundary should be ignored or not. Default value: False.
inMaxDeformationint<0, INF>0Maximal distance in pixels between model edge and an edge visible in the input image. Default value: 0.
inMinScorefloat<0.0f, 1.0f>0.7fMinimum score of object candidates accepted at each pyramid level. Default value: 0.7f.
inMinDistancefloat<0.0f, INF>10.0fMinimum distance between two found objects. Default value: 10.0f.
outObjectsSystem.Collections.Generic.IList<AvlNet.Object2D>Found objects.
outObjectEdgesAvlNet.NullableRef<AvlNet.SafeList<AvlNet.SafeList<AvlNet.Path>>>Model edges of the found objects. 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.
diagEdgePyramidSystem.Collections.Generic.IList<AvlNet.Image>Image edges used for matching at each pyramid level.
diagMatchPyramidSystem.Collections.Generic.IList<AvlNet.Image>Candidate object locations found at each pyramid level.
diagScoresSystem.Collections.Generic.IList<System.Collections.Generic.List<float>>Scores of the found objects at each pyramid level.

Function Overrides

See also