F_VN_MatchDescriptorsKnnBF

Match descriptors (k nearest neighbors) using a brute force approach.
Can use available TwinCAT Job Tasks for executing parallel code regions.

Syntax

Definition:

FUNCTION F_VN_MatchDescriptorsKnnBF : HRESULT
VAR_INPUT
    ipQueryDescriptors : ITcVnImage;
    ipTrainDescriptors : ITcVnImage;
    ipMatches          : Reference To  ITcVnContainer;
    nK                 : UDINT;
    hrPrev             : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipQueryDescriptors	ITcVnImage	Query descriptors (i.e. descriptors of a reference/template image)
ipTrainDescriptors	ITcVnImage	Training descriptors (i.e. descriptors of a source/input image)
ipMatches	Reference To ITcVnContainer	Returns a container which is filled with the descriptor matches (ContainerType_Vector_Vector_TcVnDMatch; Non-zero interface pointers are reused.)
nK	UDINT	Number of required best train matches for each query descriptor (i.e. nk := 2)
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

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