LocateSingleObject_NCC_Deprecated

Module:	MatchingBasic

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

Detection of an object with blurred or unclear edges. Often one of the first filters in a program.

Name	Type	Range	Description
inImage	Image		Image on which object occurrence will be searched
inSearchRegion	Region *		Range of possible object centers
inGrayModel	GrayModel		Model of objects to be searched
inMinPyramidLevel	Integer	0 - 12	Defines the lowest pyramid level at which object position is still refined
inMaxPyramidLevel	Integer *	0 - 12	Defines the total number of reduced resolution levels that can be used to speed up computations
inIgnoreBoundaryObjects	Bool		Flag indicating whether objects crossing image boundary should be ignored or not
inMinScore	Real	-1.0 - 1.0	Minimum score of object candidates accepted at each pyramid level
inMaxBrightnessRatio	Real *	1.0 -	Defines the maximal deviation of the mean brightness of the model object and the object present in the image
inMaxContrastRatio	Real *	1.0 -	Defines the maximal deviation of the brightness standard deviation of the model object and the object present in the image
outObject	Object2D ?		Found object
outPyramidHeight	Integer		Highest pyramid level used to speed up computations
diagImagePyramid	Image Array		Pyramid of iteratively downsampled input image
diagMatchPyramid	Image Array		Candidate object locations found at each pyramid level
diagScores	Real Array ?		Scores of the found object at each pyramid level

This operation is optimized for SSE2 technology for pixels of type: UINT8.

This operation is optimized for AVX2 technology for pixels of type: UINT8.

This operation supports automatic parallelization for multicore and multiprocessor systems.

This filter is available on Basic Complexity Level.