Back to FabImage Library website

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

EnhanceMultipleObjectMatches


Header: FIL.h
Namespace: fil
Module: MatchingPro

Improves accuracy of multiple object matching by adding a subpixel-precise adjustment.

Applications: Usually used after an edge-based template matching tool.

Syntax

C++
C#
 
void fil::EnhanceMultipleObjectMatches
(
	const fil::Image& inImage,
	const ftl::Array<fil::Object2D>& inObjects,
	const ftl::Array<ftl::Array<fil::Path>>& inObjectEdges,
	bool inAllowScale,
	ftl::Array<fil::Object2D>& outObjects,
	ftl::Array<ftl::Array<fil::Path>>& outObjectEdges
)

Parameters

Name Type Default Description
Input value inImage const Image& Input image
Input value inObjects const Array<Object2D>& Input objects
Input value inObjectEdges const Array<Array<Path>>& Input objects edges
Input value inAllowScale bool Determines if the object scale can be adjusted
Output value outObjects Array<Object2D>& Objects with enhanced accuracy
Output value outObjectEdges Array<Array<Path>>& Edges of objects with enhanced accuracy

Hints

  • In order to use the filter to fine-tune the results of template matching, connect the outObjects and outObjectEdges outputs of the template matching filter to the inObjects and inObjectEdges inputs, and the same input image to the inImage input. By default, the outObjects and outObjectEdges outputs of the template matching filter are hidden, so one should use "Show/Hide Ports" option to make them visible.
  • When using template matching with EnhanceMultipleObjectMatches filter, you may try to speed up template matching by increasing its inMinPyramidLevel parameter. The potential loss of template matching precision should be mitigated by the EnhanceMultipleObjectMatches filter.

Hardware Acceleration

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

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

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

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

List of possible exceptions:

Error type Description
DomainError inObjects and inObjectEdges sizes differ

See Also