F_VN_CalibrateCameraPlanar

Calibrate camera using a planar calibration pattern comprised of four circles marking the corners of a rectangle.
Can use available TwinCAT Job Tasks for executing parallel code regions.

Syntax

Definition:

FUNCTION F_VN_CalibrateCameraPlanar : HRESULT
VAR_INPUT
    ipSrcImage            : ITcVnImage;
END_VAR
VAR_IN_OUT
    aMarkerPositions      : TcVnArray4_Point2_REAL;
    aTransformationMatrix : TcVnMatrix3x3_LREAL;
END_VAR
VAR_INPUT
    hrPrev                : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSrcImage	ITcVnImage	Binary source image (background zero, markers non-zero)
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

In/Outputs

Name	Type	Description
aMarkerPositions	TcVnArray4_Point2_REAL	Marker positions within their plane using world units (right-handed coordinate system)
aTransformationMatrix	TcVnMatrix3x3_LREAL	Returns a 3-by-3 matrix for the transformation from image coordinates into the reference coordinate system

Return value

HRESULT

Required License

TC3 Vision Base

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