You are here: Start » FIL.NET » Invoke.LocateMultipleObjects_NCC

Invoke.LocateMultipleObjects_NCC

Finds all occurrences of a predefined template on an image by analysing the normalized correlation between pixel values.

Namespace:Fil
Assembly:FilNet.dll

Syntax

C++
C#
 
public static void LocateMultipleObjects_NCC
(
	Fil.Image inImage,
	Optional<Fil.ShapeRegion> inSearchRegion,
	Optional<Fil.CoordinateSystem2D> inSearchRegionAlignment,
	Fil.GrayModel inGrayModel,
	int inMinPyramidLevel,
	Optional<int> inMaxPyramidLevel,
	bool inIgnoreBoundaryObjects,
	float inMinScore,
	float inMinDistance,
	Optional<float> inMaxBrightnessRatio,
	Optional<float> inMaxContrastRatio,
	List<Fil.Object2D> outObjects,
	Optional<int> outPyramidHeight,
	Optional<Fil.ShapeRegion> outAlignedSearchRegion,
	Diagnostic<List<Fil.Image>> diagImagePyramid,
	Diagnostic<List<Fil.Image>> diagMatchPyramid,
	Diagnostic<List<List<float>>> diagScores
)

Parameters

Name Type Range Default Description
inImageFil.ImageImage on which model occurrences will be searched.
inSearchRegionFtl.Optional<Fil.ShapeRegion>Range of possible object centers. Default value: ftl::NIL.
inSearchRegionAlignmentFtl.Optional<Fil.CoordinateSystem2D>Adjusts the region of interest to the position of the inspected object. Default value: ftl::NIL.
inGrayModelFil.GrayModelModel of objects to be searched.
inMinPyramidLevelint<0, 12>0Defines the lowest pyramid level at which object position is still refined. Default value: 0.
inMaxPyramidLevelFtl.Optional<int><0, 12>3Defines the total 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.
inMinScorefloat<-1.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.
inMaxBrightnessRatioFtl.Optional<float><1.0f, INF>Defines the maximal deviation of the mean brightness of the model object and the object present in the image. Default value: ftl::NIL.
inMaxContrastRatioFtl.Optional<float><1.0f, INF>Defines the maximal deviation of the brightness standard deviation of the model object and the object present in the image. Default value: ftl::NIL.
outObjectsSystem.Collections.Generic.List<Fil.Object2D>Found objects.
outPyramidHeightFtl.Optional<int>Highest pyramid level used to speed up computations.
outAlignedSearchRegionFtl.Optional<Fil.ShapeRegion>Transformed input shape region.
diagImagePyramidFil.Diagnostic<System.Collections.Generic.List<Fil.Image>>Pyramid of iteratively downsampled input image.
diagMatchPyramidFil.Diagnostic<System.Collections.Generic.List<Fil.Image>>Candidate object locations found at each pyramid level.
diagScoresFil.Diagnostic<System.Collections.Generic.List<System.Collections.Generic.List<float>>>Scores of the found objects at each pyramid level.

See also