F_VN_FindReferenceKeyPointsInImageAKAZE

F_VN_FindReferenceKeyPointsInImageAKAZE 1:

Searches a reference image, represented by its AKAZE keypoints and corresponding descriptors, in a given source image (uses the default TcVnParamsAKAZE parameters).
Can use available TwinCAT Job Tasks for executing parallel code regions.

Syntax

Definition:

FUNCTION F_VN_FindReferenceKeyPointsInImageAKAZE : HRESULT
VAR_INPUT
    ipSrcImage            : ITcVnImage;
    ipRefKeyPoints        : ITcVnContainer;
    ipRefDescriptors      : ITcVnImage;
    nRefImageWidth        : UDINT;
    nRefImageHeight       : UDINT;
    ipEdgePoints          : Reference To ITcVnContainer;
    fMaxDist              : REAL;
    fMaxKnnRatio          : REAL;
    hrPrev                : HRESULT;
END_VAR
VAR_OUTPUT
    aPerspectiveTransform : TcVnMatrix3x3_LREAL;
    nNumberOfGoodMatches  : UDINT;
    nNumberOfInliers      : UDINT;
END_VAR

F_VN_FindReferenceKeyPointsInImageAKAZE 2: Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

Source image

ipRefKeyPoints

ITcVnContainer

KeyPoints of the reference image, e.g. computed with F_VN_KeyPointsAndDescriptorsAKAZE (ContainerType_Vector_TcVnKeyPoint)

ipRefDescriptors

ITcVnImage

Descriptors of the reference image KeyPoints, e.g. computed with F_VN_KeyPointsAndDescriptorsAKAZE

nRefImageWidth

UDINT

Width of the reference image in pixels

nRefImageHeight

UDINT

Height of the reference image in pixels

ipEdgePoints

Reference To ITcVnContainer

Returns a container with the 4 edge points of the reference image transformed into ipSrcImage coordinates (ContainerType_Vector_TcVnPoint2_REAL)

fMaxDist

REAL

Maximum allowed descriptor distance (-1 disables this filter criterion)

fMaxKnnRatio

REAL

Maximum allowed distance ratio between first and second best match ([0..1], -1 disables this filter criterion)

hrPrev

HRESULT

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

F_VN_FindReferenceKeyPointsInImageAKAZE 3: Outputs

Name

Type

Description

aPerspectiveTransform

TcVnMatrix3x3_LREAL

Returns the perspective transformation matrix, which transforms the reference points to the source points

nNumberOfGoodMatches

UDINT

Return the number of good matches

nNumberOfInliers

UDINT

Return the number of inlier matches

F_VN_FindReferenceKeyPointsInImageAKAZE 4: Return value

HRESULT

Required 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