Match template

VisionConfigured target requiredvision.match-template

Find the best location of one immutable template image inside an explicit source image.

Example use

Find the best button-template match in an image and inspect its score and center.

Node preview

Right-drag to pan and scroll to zoom. Expand inputs and edit parameters to see how ports change. This preview does not run the node; reopening the page restores the example.

Loading node preview…

Data inputs 4

Source imageimageImage: Image to search; connect Capture Window or bind an Image BlobRef.
RequiredDefault: None
Template imagetemplateImage: Exact immutable template variant used for this workflow.
RequiredDefault: None
Search regionregionRegion: Ratio or pixel rectangle inside the source image.
Default availableDefault: {"height":1,"unit":"ratio","width":1,"x":0,"y":0}
Value format examples
{"height":0.5,"unit":"ratio","width":0.5,"x":0.25,"y":0.25}
Match thresholdthresholdNumber: Minimum normalized score from 0 to 1 considered matched.
Default availableDefault: 0.8

Data outputs 4

MatchedmatchedBoolean: True when the best score reaches the threshold.
ScorescoreNumber: Best normalized correlation score.
CentercenterPoint: Pixel center of the best candidate.
Value format examples
{"unit":"ratio","x":0.5,"y":0.5}
{"unit":"px","x":640,"y":360}
BoundsboundsRegion: Pixel bounds of the best candidate.
Value format examples
{"height":0.5,"unit":"ratio","width":0.5,"x":0.25,"y":0.25}

Version and node identity

Version 1.0.0

sha256:047d0cb0964e73acef2dfb0e81d9a6cbf205319bf0550805e7878f58722f86b1