You are here: Start » FIL.NET » Invoke.LocateSingleObject_Edges1
Invoke.LocateSingleObject_Edges1
Finds a single occurrence of a predefined template on an image by comparing object edges.
| Namespace: | Fil |
|---|---|
| Assembly: | FilNet.dll |
Syntax
C++
C#
public static void LocateSingleObject_Edges1 ( Fil.Image inImage, Optional<Fil.ShapeRegion> inSearchRegion, Optional<Fil.CoordinateSystem2D> inSearchRegionAlignment, Fil.EdgeModel inEdgeModel, int inMinPyramidLevel, Optional<int> inMaxPyramidLevel, float inEdgeThreshold, Fil.EdgePolarityMode inEdgePolarityMode, Fil.EdgeNoiseLevel inEdgeNoiseLevel, bool inIgnoreBoundaryObjects, float inMinScore, Conditional<Fil.Object2D> outObject, Optional<Conditional<List<Fil.Path>>> outObjectEdges, Optional<int> outPyramidHeight, Optional<Fil.ShapeRegion> outAlignedSearchRegion, Diagnostic<List<Fil.Image>> diagEdgePyramid, Diagnostic<List<Fil.Image>> diagMatchPyramid, Diagnostic<Conditional<List<float>>> diagScores )
Parameters
| Name | Type | Range | Default | Description | |
|---|---|---|---|---|---|
 | inImage | Fil.Image | Image on which object occurrence will be searched. | ||
| inSearchRegion | Ftl.Optional<Fil.ShapeRegion> | Region of possible object centers. Default value: ftl::NIL. | ||
| inSearchRegionAlignment | Ftl.Optional<Fil.CoordinateSystem2D> | Adjusts the region of interest to the position of the inspected object. Default value: ftl::NIL. | ||
| inEdgeModel | Fil.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 | Ftl.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 | Fil.EdgePolarityMode | MatchStrictly | Defines how edges with reversed polarity will contribute to the object score. Default value: MatchStrictly. | |
| inEdgeNoiseLevel | Fil.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 | Ftl.Conditional<Fil.Object2D> | Found object. | ||
| outObjectEdges | Ftl.Optional<Ftl.Conditional<System.Collections.Generic.List<Fil.Path>>> | Model edges of the found object. | ||
| outPyramidHeight | Ftl.Optional<int> | Highest pyramid level used to speed up computations. | ||
| outAlignedSearchRegion | Ftl.Optional<Fil.ShapeRegion> | Transformed input shape region. | ||
 | diagEdgePyramid | Fil.Diagnostic<System.Collections.Generic.List<Fil.Image>> | Image edges used for matching at each pyramid level. | ||
| diagMatchPyramid | Fil.Diagnostic<System.Collections.Generic.List<Fil.Image>> | Candidate object locations found at each pyramid level. | ||
| diagScores | Fil.Diagnostic<Ftl.Conditional<System.Collections.Generic.List<float>>> | Scores of the found object at each pyramid level. |
