DecomposeAffineTransformation

Decompose an affine transformation matrix and return the rotation angle (clockwise) in radian, translation vector (pixels), scale, and skew vectors (angle in radian). The decomposition method assumes the following order of transformation: Translation, Rotation, Scale, and Skew.

Syntax

Definition:

HRESULT DecomposeAffineTransformation(
    HRESULT              hrPrev,
    TcVnMatrix2x3_LREAL& aAffineTransform,
    double&              fRotationAngle,
    TcVnVector2_LREAL&   aTranslationVector = {0, 0},
    TcVnVector2_LREAL&   aScaleVector = {0, 0},
    TcVnVector2_LREAL&   aSkewVector = {0, 0}
)

Parameters

Name

Type

Default

Description

hrPrev

HRESULT

 

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

aAffineTransform

TcVnMatrix2x3_LREAL&

 

Affine transformation matrix

fRotationAngle

double&

 

Rotation angle (radian) in the clockwise direction. The rotation center is the origin point (0,0)

aTranslationVector

TcVnVector2_LREAL&

{0, 0}

2D translation vector. The values are in pixels

aScaleVector

TcVnVector2_LREAL&

{0, 0}

2D scale vector

aSkewVector

TcVnVector2_LREAL&

{0, 0}

2D skew vector. The values are the skew angles in x and y directions in radian

DecomposeAffineTransformation 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