mkht / templatematching

PowerShell cmdlet for Template matching

TemplateMatching

Powershell cmdlet for template matching.
You can find out where the template image is in the target image.

Install

You can install from PowerShell Gallery.

Install-Module -Name TemplateMatching

Cmdlet

• Invoke-TemplateMatching

Parameter

Target

(Type = string, Mandatory = True, Positional = False)
Specifies the image file in which you expect to find a match to the template image.

Template

(Type = string, Mandatory = True, Positional = False)
Specifies the patch image which will be compared to the target image.
The image must be smaller than the target image.

Threshold

(Type = double, Mandatory = False, Positional = False)
Specifies similarity threshold for image matching.
This cmdlet returns all matched points that has more similar than the threshold.
You can specifies threshold between 0.1 to 1.0 (greater is best match)
The default threshold is 0.95

Example

• Template image
  

• Target image
  

• Command

PS C:\> Invoke-TemplateMatching -Target ".\target.png" -Template ".\template.png"

Rect                             Similarity
----                             ----------
(x:720 y:101 width:74 height:66)  0.9999997

The template image found in the target image.
The coordinate of the image is (x=720, y=101).
Similarity is 0.9999997, it's nearly equal 1. that indicates perfect match.

---

License

TemplateMatching is released under the MIT License. See LICENSE.

This module includes these libraries.

• OpenCV
  Licensed under the BSD 3-Clause

• OpenCvSharp
  Licensed under the BSD 3-Clause

templatematching's Issues

Freeze when Threshold = 0.0

When I specify threshold=0.0. PowerShell console is not returned.

# this command will not return
Invoke-TemplateMatching -Target '.\target.png', -Template '.\template.png' -Threshold 0.0