You are here: Start » Function Reference » Computer Vision » Template Matching » LocateSingleObject_NCC_Deprecated

LocateSingleObject_NCC_Deprecated

Header:	AVL.h
Namespace:	avl
Module:	MatchingBasic

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

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

Syntax

void avl::LocateSingleObject_NCC_Deprecated
(
	const avl::Image& inImage,
	atl::Optional<const avl::Region&> inSearchRegion,
	const avl::GrayModel& inGrayModel,
	int inMinPyramidLevel,
	atl::Optional<int> inMaxPyramidLevel,
	bool inIgnoreBoundaryObjects,
	float inMinScore,
	atl::Optional<float> inMaxBrightnessRatio,
	atl::Optional<float> inMaxContrastRatio,
	atl::Conditional<avl::Object2D>& outObject,
	atl::Optional<int&> outPyramidHeight = atl::NIL,
	atl::Array<avl::Image>& diagImagePyramid,
	atl::Array<avl::Image>& diagMatchPyramid,
	atl::Conditional<atl::Array<float> >& diagScores
)

Parameters

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

Optional Outputs

The computation of following outputs can be switched off by passing value atl::NIL to these parameters: outPyramidHeight.

Hardware Acceleration

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.