F_VN_MatchContoursExp
Compare contours using the Hu moment invariants (and optionally further aspects). In case of multiple contours in each container, the best matches are found and the average dissimilarity over all matched contours is returned. (expert function)
Syntax
Definition:
FUNCTION F_VN_MatchContoursExp : HRESULT
VAR_INPUT
ipContour1 : ITcVnContainer;
ipContour2 : ITcVnContainer;
eComparisonMethod : ETcVnContoursMatchComparisonMethod;
END_VAR
VAR_IN_OUT
fDissimilarity : LREAL;
END_VAR
VAR_INPUT
fAreaFactor : LREAL;
fAbsPositionFactor : LREAL;
fRelPositionFactor : LREAL;
fNumDiffFactor : LREAL;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipContour1 |
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 |
Second contour (same type as ipContour1) | |
|
eComparisonMethod |
Method used for comparing the Hu moment invariants of the contours | |
|
fAreaFactor |
LREAL |
If > 0, the relative area difference between contours is scaled by this factor and added to the computed dissimilarity |
|
fAbsPositionFactor |
LREAL |
If > 0, the absolute position difference between contours (i.e. the coordinates of the geometric contour centers) is scaled by this factor and added to the computed dissimilarity |
|
fRelPositionFactor |
LREAL |
If > 0, the relative position difference between contours is scaled by this factor and added to the computed dissimilarity (only used if matching multiple contours) |
|
fNumDiffFactor |
LREAL |
If > 0, the difference between the number of contours in both containers is scaled by this factor and added to the computed dissimilarity (only used if matching multiple contours) |
|
hrPrev |
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 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 |