F_VN_CompensateLensDistortionExp2

F_VN_CompensateLensDistortionExp2 1:

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

F_VN_CompensateLensDistortionExp2 2: 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.)

F_VN_CompensateLensDistortionExp2 3: 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

F_VN_CompensateLensDistortionExp2 4: Return value

HRESULT

Required License

TC3 Vision Metrology 2D

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