CompensateLensDistortion (Exp2)

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

Syntax

Definition:

HRESULT CompensateLensDistortion(
    HRESULT              hrPrev,
    ITcVnImage*          ipSrcImage,
    ITcVnImage*&         ipDestImage,
    TcVnMatrix3x3_LREAL& aCameraMatrix,
    TcVnArray8_LREAL&    aDistortionCoefficients,
    TcVnMatrix3x3_LREAL& aNewCameraMatrix
)

Parameters

Name

Type

Description

hrPrev

HRESULT

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

ipSrcImage

ITcVnImage*

Source image

ipDestImage

ITcVnImage*&

Destination image (An appropriate destination image will be created if required.)

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

CompensateLensDistortion (Exp2) 1: 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