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