Back to Aurora Vision Library website

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

LocateMultipleObjects_NCC_Deprecated


Header: AVL.h
Namespace: avl
Module: MatchingBasic

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

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

Syntax

void avl::LocateMultipleObjects_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,
	float inMinDistance,
	atl::Optional<float> inMaxBrightnessRatio,
	atl::Optional<float> inMaxContrastRatio,
	atl::Array<avl::Object2D>& outObjects,
	atl::Optional<int&> outPyramidHeight = atl::NIL,
	atl::Array<avl::Image>& diagImagePyramid = atl::Dummy<atl::Array<avl::Image>>(),
	atl::Array<avl::Image>& diagMatchPyramid = atl::Dummy<atl::Array<avl::Image>>(),
	atl::Array<atl::Array<float>>& diagScores = atl::Dummy<atl::Array<atl::Array<float>>>()
)

Parameters

Name Type Range Default Description
Input value inImage const Image& Image on which model occurrences will be searched
Input value inSearchRegion Optional<const Region&> NIL Range of possible object centers
Input value inGrayModel const GrayModel& Model of objects to be searched
Input value inMinPyramidLevel int 0 - 12 0 Defines the lowest pyramid level at which object position is still refined
Input value inMaxPyramidLevel Optional<int> 0 - 12 3 Defines the total number of reduced resolution levels that can be used to speed up computations
Input value inIgnoreBoundaryObjects bool False Flag indicating whether objects crossing image boundary should be ignored or not
Input value inMinScore float -1.0 - 1.0 0.7f Minimum score of object candidates accepted at each pyramid level
Input value inMinDistance float 0.0 - 10.0f Minimum distance between two found objects
Input value 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
Input value 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
Output value outObjects Array<Object2D>& Found objects
Output value outPyramidHeight Optional<int&> NIL Highest pyramid level used to speed up computations
Diagnostic input diagImagePyramid Array<Image>& Pyramid of iteratively downsampled input image
Diagnostic input diagMatchPyramid Array<Image>& Candidate object locations found at each pyramid level
Diagnostic input diagScores Array<Array<float>>& Scores of the found objects at each pyramid level

Optional Outputs

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

Read more about Optional Outputs.

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.