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:

HRESULT ImagePointsWorldDistance(
    HRESULT              hrPrev,
    TcVnPoint2_REAL&     aImagePoint1,
    TcVnPoint2_REAL&     aImagePoint2,
    double&              fWorldDistance,
    TcVnMatrix3x3_LREAL& aCameraMatrix,
    TcVnArray8_LREAL&    aDistortionCoefficients,
    TcVnMatrix3x3_LREAL& aRotationMatrix,
    TcVnVector3_LREAL&   aTranslationVector,
    double               fZ
)

Parameters

Name

Type

Description

hrPrev

HRESULT

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

aImagePoint1

TcVnPoint2_REAL&

First point in the image coordinate system

aImagePoint2

TcVnPoint2_REAL&

Second point in the image coordinate system

fWorldDistance

double&

Returns the distance between aImagePoint1 and aImagePoint2 in the world coordinate system

aCameraMatrix

TcVnMatrix3x3_LREAL&

3x3 camera matrix containing the intrinsic parameters

aDistortionCoefficients

TcVnArray8_LREAL&

Lens distortion coefficients [k1, k2, p1, p2, k3, k4, k5, k6]

aRotationMatrix

TcVnMatrix3x3_LREAL&

3x3 rotation matrix

aTranslationVector

TcVnVector3_LREAL&

Translation vector

fZ

double

z coordinate (world coordinate system) of the given points (0 would be at (toplevel) calibration pattern)

ImagePointsWorldDistance 1: Return value

HRESULT

Required License

TC3 Vision Metrology 2D

System Requirements