ContourOrientation

Calculate the orientation of a contour or a set of points.

Syntax

Definition:

HRESULT ContourOrientation(
    HRESULT                hrPrev,
    ITcVnContainer*        ipContour,
    TcVnRotatedRectangle&  stOrientation,
    ETcVnOrientationMethod eMethod = OM_PCA
)

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*

 

Source point set (ContainerType_Vector_TcVnPoint2_DINT, ContainerType_Vector_TcVnPoint2_REAL, or ContainerType_Vector_TcVnPoint2_LREAL. The elements of this container are the individual points.)

stOrientation

TcVnRotatedRectangle&

 

Resulting rotated rectangle, containig center of mass, lenghts of axes, and rotation angle of the contour in clockwise direction.

eMethod

ETcVnOrientationMethod

OM_PCA

Method for calculating the orientation.

ContourOrientation 1: 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