RegionOrientation

Calculate the orientation of a region based on a binary image that contains a non zero value for every pixel in that region.

Syntax

Definition:

HRESULT RegionOrientation(
    HRESULT                hrPrev,
    ITcVnImage*            ipSrcImage,
    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.)

ipSrcImage

ITcVnImage*

 

Source image (1 channel, binary)

stOrientation

TcVnRotatedRectangle&

 

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

eMethod

ETcVnOrientationMethod

OM_PCA

Method for calculating the orientation.

RegionOrientation 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