boofcv.alg.feature.detect.template

Interface TemplateMatchingIntensity<T extends ImageBase>

All Known Implementing Classes:

BaseTemplateIntensity, TemplateDiffSquared, TemplateDiffSquared.F32, TemplateDiffSquared.U8, TemplateNCC, TemplateNCC.F32, TemplateNCC.U8

public interface TemplateMatchingIntensity<T extends ImageBase>

Moves an image template over the image and for each pixel computes a metric for how similar that region is to template. An intensity image is thus computed for the entire image. Better matches always have a more positive value. If a metric inheritally has a small value for better matches then its sign will be adjusted so that poor matches have a negative value.

A pixel in the intensity image is the result of evaluating the template with its center over that pixel. Given pixel (x,y) in the intensity image the template's top left corner (x',y') can be found at: x' = x - getOffsetX() and y' = y - getOffsetY().

IMAGE BORDER: If the image border is processed or not depends on the implementation. If the border is processed then partial templates are considered. If the border is not processed then the value of the intensity along the border is not defined and should not be processed.

Author:

Peter Abeles

Method Summary

Methods

Modifier and Type	Method and Description
ImageFloat32	getIntensity() Contains results of template matching.
int	getOffsetX() Offset from template's top left corner x-coordinate
int	getOffsetY() Offset from template's top left corner y-coordinate
boolean	isBorderProcessed() Does this algorithm process the image's border.
void	process(T image, T template) Matches the template to the image and computes an intensity image.

Method Detail

process

void process(T image,
           T template)

Matches the template to the image and computes an intensity image.

Parameters:

image - Input image. Not modified.

template - Template image. Must be equal to or smaller than the input image. Not modified.

getIntensity

ImageFloat32 getIntensity()

Contains results of template matching. Higher intensity values correspond to a better match. Local matches can be found using NonMaxSuppression. See comment about processing the image border.

Returns:

Feature intensity

isBorderProcessed

boolean isBorderProcessed()

Does this algorithm process the image's border. If it does not process the border

Returns:

true if the border is processed and false otherwise.

getOffsetX

int getOffsetX()

Offset from template's top left corner x-coordinate

Returns:

Offset in pixels

getOffsetY

int getOffsetY()

Offset from template's top left corner y-coordinate

Returns:

Offset in pixels