TransformCoordinatesImageToWorld (Point)

Transform 2D image point coordinate to 3D world coordinate (using intrinsic + extrinsic calibration results).

Syntax

Definition:

HRESULT TransformCoordinatesImageToWorld(
    HRESULT              hrPrev,
    TcVnPoint2_LREAL&    aSrcPoint,
    TcVnPoint3_LREAL&    aDestPoint,
    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.)

aSrcPoint

TcVnPoint2_LREAL&

Point in the image coordinate system

aDestPoint

TcVnPoint3_LREAL&

Returns the point 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 transformed points (0 would be at (toplevel) calibration pattern)

TransformCoordinatesImageToWorld (Point) 1: Return value

HRESULT

Required License

TC3 Vision Metrology 2D

System Requirements