SMC_Matrix3_RotDist (FUN)

 

FUNCTION SMC_Matrix3_RotDist : LREAL

Returns the distance between two orthonormal matrices with determi­nant 1 (i.e. matrices representing rotations).

The distance is the absolute angle between the two rotations, i.e. the absolute angle of the shortest rotation transforming from one rotation to the other.

The angle is measured in radian and is in the range [0, SMC_PI].

Note: the behavior is undefined unless both matrices are rotation matrices.

InOut:

Scope

Name

Type

Inout Const

r1

SMC_Matrix3

r2

SMC_Matrix3

Return

SMC_Matrix3_RotDist

LREAL