Synopsis

PDX_MSGT mth_MatrixLocalToGlobalSys(long option, MTH_3DVEC x_vec, MTH_3DVEC y_vec, MTH_3DVEC z_vec, MTH_3DPNT origin, double *matrix)

Purpose

Find the transformation matrix from a local to the global system

Description

Find the transformation matrix from a local to the global coordinate system. The local system is represented by three vectors that should follow the right hand rule, and a point that is the origin. The vectors do not have to be unit ones.

The matrix can be used to transform any object in the local coordinate system into the global system.

The matrix can be in either Homogeneous format (4x4) or GDX_MATRIX format (3x4) by choosing different option.

Input

option

MTH_HOMOGENEOUS

The matrix will be in Homogeneous format (4x4); otherwise, in GDX_MATRIX format (3x4).

x_vec

The vector of x axis

y_vec

The vector of y axis

z_vec

The vector of z axis

origin

The origin of the local coordinate system

Output

matrix

The transformation matrix [12 or 16]

Return

      MTH_NOERR
      Low level error return
      .fi