SITransformation.Matrix4

Introduced

v5.1

Description

Sets or returns the SIMatrix4 representation of the values of this transformation (the matrix is created automatically).

C# Syntax

// get accessor

SIMatrix4 rtn = ISITransformation.Matrix4;

// set accessor

ISITransformation.Matrix4 = SIMatrix4;

Examples

JScript Example

/*

	This example demonstrates how to use the Matrix4 property to return the matrix representation 

	of the transformation as an SIMatrix4 (without having to explicitly create it first) as well as 

	how to set new values for the transformation using a 4x4 matrix.

*/

var t1 = XSIMath.CreateTransform();

// The Matrix4 property takes care of creating oMat4 as an SIMatrix4 of the transformation

var oMat4 = t1.Matrix4;

// Now set some values on the matrix and then save it back onto the transformation

oMat4.Set(4.0, 0.0, 0.0, 0.0, 0.0, 3.0, 0.0, 0.0, 0.0, 0.0, 2.0, 0.0, 0.0, 0.0, 0.0, 1.0);

t1.Matrix4 = oMat4;

// Get a new matrix

var oMat4Dest = t1.Matrix4;

vbArr = new VBArray( oMat4Dest.Get2() );

jsArr = vbArr.toArray();

// Display Matrix

var lineSize = 4;

Application.LogMessage( "The 16 matrix values" );

for ( i=0; i<lineSize; i++ ) {

	var mgsString  = "";

	for ( j=0; j<lineSize; j++ ) {

		mgsString += "m" + i + "" + j + " " + jsArr[ i*lineSize + j ] + "  ";

	}

	Application.LogMessage ( mgsString );

}

// Expected results:

//INFO : The 16 matrix values

//INFO : m00 4  m01 0  m02 0  m03 0  

//INFO : m10 0  m11 3  m12 0  m13 0  

//INFO : m20 0  m21 0  m22 2  m23 0  

//INFO : m30 0  m31 0  m32 0  m33 1

See Also

SITransformation.GetMatrix4 SITransformation.SetMatrix4