F_VN_FindReferenceKeyPointsInImageORB

F_VN_FindReferenceKeyPointsInImageORB 1:

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

Syntax

Definition:

FUNCTION F_VN_FindReferenceKeyPointsInImageORB : 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_FindReferenceKeyPointsInImageORB 2: Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

Source image

ipRefKeyPoints

ITcVnContainer

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

ipRefDescriptors

ITcVnImage

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

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_FindReferenceKeyPointsInImageORB 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_FindReferenceKeyPointsInImageORB 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