F_VN_ImagePointsWorldDistance
Computes the distance in the world coordinate system between two points (in the same world coordinate z layer) given in image coordinates.
Syntax
Definition:
FUNCTION F_VN_ImagePointsWorldDistance : HRESULT
VAR_IN_OUT
aImagePoint1 : TcVnPoint2_REAL;
aImagePoint2 : TcVnPoint2_REAL;
fWorldDistance : LREAL;
aCameraMatrix : TcVnMatrix3x3_LREAL;
aDistortionCoefficients : TcVnArray8_LREAL;
aRotationMatrix : TcVnMatrix3x3_LREAL;
aTranslationVector : TcVnVector3_LREAL;
END_VAR
VAR_INPUT
fZ : LREAL;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
fZ |
LREAL |
z coordinate (world coordinate system) of the given points (0 would be at (toplevel) calibration pattern) |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
aImagePoint1 |
First point in the image coordinate system | |
|
aImagePoint2 |
Second point in the image coordinate system | |
|
fWorldDistance |
LREAL |
Returns the distance between aImagePoint1 and aImagePoint2 in the world coordinate system |
|
aCameraMatrix |
3x3 camera matrix containing the intrinsic parameters | |
|
aDistortionCoefficients |
Lens distortion coefficients [k1, k2, p1, p2, k3, k4, k5, k6] | |
|
aRotationMatrix |
3x3 rotation matrix | |
|
aTranslationVector |
Translation vector |
Return valueRequired License
TC3 Vision Metrology 2D