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.44 or later

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

Tc3_Vision