F_VN_DecomposeAffineTransformationExp

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:

FUNCTION F_VN_DecomposeAffineTransformationExp : HRESULT
VAR_IN_OUT
    aAffineTransform   : TcVnMatrix2x3_LREAL;
    fRotationAngle     : LREAL;
    aTranslationVector : TcVnVector2_LREAL;
    aScaleVector       : TcVnVector2_LREAL;
    aSkewVector        : TcVnVector2_LREAL;
END_VAR
VAR_INPUT
    hrPrev             : HRESULT;
END_VAR

Inputs

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

In/Outputs

Name	Type	Description
aAffineTransform	TcVnMatrix2x3_LREAL	Affine transformation matrix
fRotationAngle	LREAL	Rotation angle (radian) in the clockwise direction. The rotation center is the origin point (0,0)
aTranslationVector	TcVnVector2_LREAL	2D translation vector. The values are in pixels
aScaleVector	TcVnVector2_LREAL	2D scale vector
aSkewVector	TcVnVector2_LREAL	2D skew vector. The values are the skew angles in x and y directions in radian

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