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

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