F_VN_CalibrateCameraPlanarExp
Calibrate camera using a planar calibration pattern comprised of four circles marking the corners of a rectangle. (expert function)
Can use available TwinCAT Job Tasks for executing parallel code regions.
Syntax
Definition:
FUNCTION F_VN_CalibrateCameraPlanarExp : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
END_VAR
VAR_IN_OUT
aMarkerPositions : TcVnArray4_Point2_REAL;
aTransformationMatrix : TcVnMatrix3x3_LREAL;
aMarkerImagePositions : TcVnArray4_Point2_REAL;
END_VAR
VAR_INPUT
nMinMarkerArea : UDINT;
nMaxMarkerArea : UDINT;
fMaxMarkerEccentricity : LREAL;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Binary source image (background zero, markers non-zero) | |
|
nMinMarkerArea |
UDINT |
Minimum area for the detection of markers (Smaller markers are ignored.) |
|
nMaxMarkerArea |
UDINT |
Maximum area for the detection of markers (Larger markers are ignored.) |
|
fMaxMarkerEccentricity |
LREAL |
Maximum eccenticity for the detection of markers (The eccentricity measures deviations from a round shape (eccentricity = 0: round object; eccentricity = 1.0: linear object).) |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
aMarkerPositions |
Marker positions within their plane using world units (right-handed coordinate system) | |
|
aTransformationMatrix |
Returns a 3-by-3 matrix for the transformation from image coordinates into the reference coordinate system | |
|
aMarkerImagePositions |
Returns the marker positions in image coordinates (left-handed coordinate system) |
Return valueRequired License
TC3 Vision Base