F_VN_CompensateLensDistortionExp2

Transforms an image to compensate the lens distortion. (expert function)
Can use available TwinCAT Job Tasks for executing parallel code regions.

Syntax

Definition:

FUNCTION F_VN_CompensateLensDistortionExp2 : HRESULT
VAR_INPUT
    ipSrcImage              : ITcVnImage;
    ipDestImage             : Reference To  ITcVnImage;
END_VAR
VAR_IN_OUT
    aCameraMatrix           : TcVnMatrix3x3_LREAL;
    aDistortionCoefficients : TcVnArray8_LREAL;
    aNewCameraMatrix        : TcVnMatrix3x3_LREAL;
END_VAR
VAR_INPUT
    hrPrev                  : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSrcImage	ITcVnImage	Source image
ipDestImage	Reference To ITcVnImage	Destination image (An appropriate destination image will be created if required.)
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

In/Outputs

Name	Type	Description
aCameraMatrix	TcVnMatrix3x3_LREAL	Camera matrix containing the intrinsic parameters
aDistortionCoefficients	TcVnArray8_LREAL	Lens distortion coefficients [k1, k2, p1, p2, k3, k4, k5, k6]
aNewCameraMatrix	TcVnMatrix3x3_LREAL	Allows additional scaling and shifting of the result image

Return value

HRESULT

Required License

TC3 Vision Metrology 2D

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1.4024.54 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision