SIMatrix3.TransposeInverse

Description

Sets this matrix to the transpose of the inverse of the input matrix m (if not singular): this = Transpose(m^-1)

C# Syntax

Int32 SIMatrix3.TransposeInverse( SIMatrix3 in_pMatrix );

Scripting Syntax

oBoolean = SIMatrix3.TransposeInverse( m );

Return Value

Boolean True if the matrix m has been inverted (not singular); otherwise False.

Parameters

Parameter Type Description
m SIMatrix3 Matrix operand

Examples

1. VBScript Example

dim m1, m2
' Create 3x3 matrices.
set m1 = XSIMath.CreateMatrix3(2.0, 3.0, 0.0, 1.0, 4.0, 0.0, 0.0, 0.0, 1.0)
set m2 = XSIMath.CreateMatrix3
if m2.TransposeInverse( m1 ) then
'do something
else
'do another thing
end if

2. JScript Example

NewScene (null, false);
var oRoot = Application.ActiveProject.ActiveScene.Root
// Create two cubes, the first one is rotated by 45 degrees and second
// is the transpose inverse of the first one="SIMatrix4.TransposeInverseInPlace
var oCube = oRoot.AddGeometry("Cube","MeshSurface", "CubeParent")	
var oCube2 = oRoot.AddGeometry("Cube","MeshSurface", "CubeParent")	
var oTrans = oCube.Kinematics.Local.Transform
var oTrans2 = oCube2.Kinematics.Local.Transform
var oMat3 = XSIMath.CreateMatrix3()
oTrans2.GetRotationMatrix3 ( oMat3 );
// Modify the matrix to scale and rotate around z
oMat3.value(0,0) = 2 * Math.cos (45);
oMat3.value(0,1) = -2 * Math.sin (45);
oMat3.value(1,1) = 2 * Math.cos (45);
oMat3.value(1,0) = 2 * Math.sin (45);
oTrans.SetRotationFromMatrix3 ( oMat3 );	
oCube.Kinematics.Local.Transform = oTrans;
var vbArr = new VBArray( oMat3.Get2() );
var array = vbArr.toArray();
Application.LogMessage( "SIMatrix3 before transpose " +
	" m00:" + array[0] + " m01:" + array[1] + " m02:" + array[2] + 
	" m10:" + array[3] + " m11:" + array[4] + " m12:" + array[5] + 
	" m20:" + array[6] + " m21:" + array[7] + " m22:" + array[8] );
var oMat3Trans = XSIMath.CreateMatrix3()
oMat3Trans.TransposeInverse(oMat3)
oTrans2.SetRotationFromMatrix3 ( oMat3Trans );
var vbArr = new VBArray( oMat3Trans.Get2() );
var array = vbArr.toArray();
Application.LogMessage( "SIMatrix3 after transpose " +
	" m00:" + array[0] + " m01:" + array[1] + " m02:" + array[2] + 
	" m10:" + array[3] + " m11:" + array[4] + " m12:" + array[5] + 
	" m20:" + array[6] + " m21:" + array[7] + " m22:" + array[8] );
oCube2.Kinematics.Local.Transform = oTrans2;
// Expected results:
//INFO : SIMatrix3 before transpose  
//			m00:1.0506439776354594	m01:-1.7018070490682368 m02:0 
//			m10:1.7018070490682368	m11:1.0506439776354594	m12:0 
//			m20:0                   m21:0                   m22:1
//INFO : SIMatrix3 after transpose  
//			m00:0.26266099440886486 m01:-0.4254517622670592 m02:0 
//			m10:0.4254517622670592	m11:0.26266099440886486 m12:0 
//			m20:0                   m21:0                   m22:1

See Also

SIMatrix3.TransposeInverseInPlace SIVector3 SIMatrix3 SIMatrix4 SIRotation SITransformation SIQuaternion