F_VN_MatchContours

Compare contours using the Hu moment invariants. In case of multiple contours in each container, the best matches are found and the average dissimilarity over all matched contours is returned.

Syntax

Definition:

FUNCTION F_VN_MatchContours : HRESULT
VAR_INPUT
    ipContour1        : ITcVnContainer;
    ipContour2        : ITcVnContainer;
    eComparisonMethod : ETcVnContoursMatchComparisonMethod;
END_VAR
VAR_IN_OUT
    fDissimilarity    : LREAL;
END_VAR
VAR_INPUT
    hrPrev            : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipContour1	ITcVnContainer	First contour (ContainerType_Vector_TcVnPoint2_DINT or ContainerType_Vector_TcVnPoint2_REAL; The elements of this container are the points of the contour) or collection of multiple contours (ContainerType_Vector_Vector_TcVnPoint2_DINT)
ipContour2	ITcVnContainer	Second contour (same type as ipContour1)
eComparisonMethod	ETcVnContoursMatchComparisonMethod	Method used for comparing the Hu moment invariants of the contours
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

In/Outputs

Name	Type	Description
fDissimilarity	LREAL	Returns the dissimilarity of the contours depending on the chosen comparison method

Return value

HRESULT

Samples

Related functions

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