ContourCircularity

Computes the circularity of a contour (1.0: ideal circle, 0.0: straight line).

Syntax

Definition:

HRESULT ContourCircularity(
    HRESULT                           hrPrev,
    ITcVnContainer*                   ipContour,
    double&                           fCircularity,
    ETcVnCircularityCalculationMethod eMethod = CCM_DEFAULT
)

Parameters

Name

Type

Default

Description

hrPrev

HRESULT

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

ipContour

ITcVnContainer*

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

fCircularity

double&

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

eMethod

ETcVnCircularityCalculationMethod

CCM_DEFAULT

Method used for computing the circularity

ContourCircularity 1: Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.59 or later

PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision