F_VN_ContourConvexity

F_VN_ContourConvexity 1:

Computes the convexity of a contour as the ratio between the contour's area and the area of the convex hull (1.0: convex shapes (i.e. rectangle, circle, ..., etc.), 0.0: zero area (i.e. a line or an empty contour)).

Syntax

Definition:

FUNCTION F_VN_ContourConvexity : HRESULT
VAR_INPUT
    ipContour  : ITcVnContainer;
END_VAR
VAR_IN_OUT
    fConvexity : LREAL;
END_VAR
VAR_INPUT
    hrPrev     : HRESULT;
END_VAR

F_VN_ContourConvexity 2: Inputs

Name

Type

Description

ipContour

ITcVnContainer

Single contour (ContainerType_Vector_TcVnPoint2_DINT or ContainerType_Vector_TcVnPoint2_REAL; The elements of this container are the points of the contour.)

hrPrev

HRESULT

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

F_VN_ContourConvexity 3: In/Outputs

Name

Type

Description

fConvexity

LREAL

Returns the convexity of the contour [0..1]

F_VN_ContourConvexity 4: Return value

HRESULT

Required License

TC3 Vision Base

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