F_VN_MatchTemplate

F_VN_MatchTemplate 1:

Match a template image with every location in the source image (using the TCVN_TMM_CCORR_NORMED method) and save the comparison results.
Can return partial results when canceled by Watchdog.

Syntax

Definition:

FUNCTION F_VN_MatchTemplate : HRESULT
VAR_INPUT
    ipSrcImage      : ITcVnImage;
    ipTemplateImage : ITcVnImage;
    ipResultImage   : Reference To ITcVnImage;
    hrPrev          : HRESULT;
END_VAR

F_VN_MatchTemplate 2: Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

Source image (USINT or REAL, 1 or 3 channels)

ipTemplateImage

ITcVnImage

Template image (same type as ipSrcImage, smaller width and height)

ipResultImage

Reference To ITcVnImage

Returns the result image (REAL, normalized to [0..1], 1 channel, dimensions: (ipSrcImage.width - ipTemplateImage.width + 1) x (ipSrcImage.height - ipTemplateImage.height + 1). The best match is the global maximum. The position in ipResultImage is the top-left corner of ipTemplateImage position in ipSrcImage)

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

F_VN_MatchTemplate 3: Return value

HRESULT

Required License

TC3 Vision Matching

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1. 4024.44 or later

PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision