You are here: Start » Function Reference » Computer Vision » Template Matching » LocateSingleObject_NCC_Deprecated
![](../../img/icon/LocateSingleObject.png)
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.
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.