You are here: Start » AVL.NET » Invoke.LocateSingleObject_Edges1
Invoke.LocateSingleObject_Edges1
Finds a single occurrence of a predefined template on an image by comparing object edges.
| Namespace: | Avl |
|---|---|
| Assembly: | AvlNet.dll |
Syntax
C++
C#
public static void LocateSingleObject_Edges1 ( Avl.Image inImage, Optional<Avl.ShapeRegion> inSearchRegion, Optional<Avl.CoordinateSystem2D> inSearchRegionAlignment, Avl.EdgeModel inEdgeModel, int inMinPyramidLevel, Optional<int> inMaxPyramidLevel, float inEdgeThreshold, Avl.EdgePolarityMode inEdgePolarityMode, Avl.EdgeNoiseLevel inEdgeNoiseLevel, bool inIgnoreBoundaryObjects, float inMinScore, Conditional<Avl.Object2D> outObject, Optional<Conditional<List<Avl.Path>>> outObjectEdges, Optional<int> outPyramidHeight, Optional<Avl.ShapeRegion> outAlignedSearchRegion, Diagnostic<List<Avl.Image>> diagEdgePyramid, Diagnostic<List<Avl.Image>> diagMatchPyramid, Diagnostic<Conditional<List<float>>> diagScores )
Parameters
| Name | Type | Range | Default | Description | |
|---|---|---|---|---|---|
 | inImage | Avl.Image | Image on which object occurrence will be searched. | ||
| inSearchRegion | Atl.Optional<Avl.ShapeRegion> | Region of possible object centers. Default value: atl::NIL. | ||
| inSearchRegionAlignment | Atl.Optional<Avl.CoordinateSystem2D> | Adjusts the region of interest to the position of the inspected object. Default value: atl::NIL. | ||
| inEdgeModel | Avl.EdgeModel | Model of objects to be searched. | ||
| inMinPyramidLevel | int | <0, 12> | 0 | Defines the lowest pyramid level at which object position is still refined. Default value: 0. |
| inMaxPyramidLevel | Atl.Optional<int> | <0, 12> | 3 | Defines the total number of reduced resolution levels that can be used to speed up computations. Default value: 3. |
| inEdgeThreshold | float | <0.01f, INF> | 10.0f | Minimum strength of edges used for matching with the model. Default value: 10.0f. |
| inEdgePolarityMode | Avl.EdgePolarityMode | MatchStrictly | Defines how edges with reversed polarity will contribute to the object score. Default value: MatchStrictly. | |
| inEdgeNoiseLevel | Avl.EdgeNoiseLevel | High | Defines how much noise the object edges have. Default value: High. | |
| inIgnoreBoundaryObjects | bool | False | Flag indicating whether objects crossing image boundary should be ignored or not. Default value: False. | |
| inMinScore | float | <0.0f, 1.0f> | 0.7f | Minimum score of object candidates accepted at each pyramid level. Default value: 0.7f. |
 | outObject | Atl.Conditional<Avl.Object2D> | Found object. | ||
| outObjectEdges | Atl.Optional<Atl.Conditional<System.Collections.Generic.List<Avl.Path>>> | Model edges of the found object. | ||
| outPyramidHeight | Atl.Optional<int> | Highest pyramid level used to speed up computations. | ||
| outAlignedSearchRegion | Atl.Optional<Avl.ShapeRegion> | Transformed input shape region. | ||
 | diagEdgePyramid | Avl.Diagnostic<System.Collections.Generic.List<Avl.Image>> | Image edges used for matching at each pyramid level. | ||
| diagMatchPyramid | Avl.Diagnostic<System.Collections.Generic.List<Avl.Image>> | Candidate object locations found at each pyramid level. | ||
| diagScores | Avl.Diagnostic<Atl.Conditional<System.Collections.Generic.List<float>>> | Scores of the found object at each pyramid level. |
