F_VN_MatchTemplateExp
Match a template image with every location in the source image and save the comparison results. (expert function)
Can return partial results when canceled by Watchdog.
Syntax
Definition:
FUNCTION F_VN_MatchTemplateExp : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipTemplateImage : ITcVnImage;
ipResultImage : Reference To ITcVnImage;
eMatchMethod : ETcVnTemplateMatchMethod;
ipTemplateMask : ITcVnImage;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (USINT or REAL, 1 or 3 channels) | |
|
ipTemplateImage |
Template image (same type as ipSrcImage, smaller width and height) | |
|
ipResultImage |
Reference To ITcVnImage |
Returns the result image (REAL, 1 channel, dimensions: (ipSrcImage.width - ipTemplateImage.width + 1) x (ipSrcImage.height - ipTemplateImage.height + 1). The best match is the global minimum (SQDIFF(_NORMED)) or maximum (CCORR(_NORMED), CCOEFF(_NORMED)). The position in ipResultImage is the top-left corner of ipTemplateImage position in ipSrcImage) |
|
eMatchMethod |
Specifies the template match method | |
|
ipTemplateMask |
Optional mask for ipTemplateImage (same type and size as ipTemplateImage) | |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueRequired License
TC3 Vision Matching
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4024.54 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |