TransformCoordinatesWorldToImage (Point)

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

Syntax

Definition:

HRESULT TransformCoordinatesWorldToImage(
    HRESULT              hrPrev,
    TcVnPoint3_LREAL&    aSrcPoint,
    TcVnPoint2_REAL&     aDestPoint,
    TcVnMatrix3x3_LREAL& aCameraMatrix,
    TcVnArray8_LREAL&    aDistortionCoefficients,
    TcVnMatrix3x3_LREAL& aRotationMatrix,
    TcVnVector3_LREAL&   aTranslationVector
)

Parameters

Name

Type

Description

hrPrev

HRESULT

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

aSrcPoint

TcVnPoint3_LREAL&

3D source point (world coordinate system)

aDestPoint

TcVnPoint2_REAL&

Returns the transformed 2D point (image 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

TransformCoordinatesWorldToImage (Point) 1: Return value

HRESULT

Required License

TC3 Vision Metrology 2D

System Requirements