CreateMatrix4 (XSIMath)

CreateMatrix4 (XSIMath)

Description

Returns a SIMatrix4 object, the values of this matrix4 can be set at creation time from an array (1d or 2d) or by 16 values.

| m0 m1 m2 m3 |

| m4 m5 m6 m7 |

| m8 m9 m10 m11 |

| m12 m13 m14 m15 |

Scripting Syntax

XSIMath.CreateMatrix4( [m0], [m1], [m2], [m3], [m4], [m5], [m6], [m7], [m8], [m9], [m10], [m11], [m12], [m13], [m14], [m15] )

C# Syntax

SIMatrix4 XSIMath.CreateMatrix4( Object in_d0, Object in_d1, Object in_d2, Object in_d3, Object in_d4, Object in_d5, Object in_d6, Object in_d7, Object in_d8, Object in_d9, Object in_d10, Object in_d11, Object in_d12, Object in_d13, Object in_d14, Object in_d15 );

Parameters

Parameter	Type	Description
m0	Double or Array	The m0 value or an array (1d or 2d) containing the 16 values.
m1	Double	The m1 value.
m2	Double	The m2 value.
m3	Double	The m3 value.
m4	Double	The m4 value.
m5	Double	The m5 value.
m6	Double	The m6 value.
m7	Double	The m7 value.
m8	Double	The m8 value.
m9	Double	The m9 value.
m10	Double	The m10 value.
m11	Double	The m11 value.
m12	Double	The m12 value.
m13	Double	The m13 value.
m14	Double	The m14 value.
m15	Double	The m15 value.

Return Value

SIMatrix4

Examples

1. JScript Example

/* Set and display the values of a matrix4
*/
var arrayInit = new Array (16)
arrayInit[0]  = 1.1;
arrayInit[1]  = 2.31;
arrayInit[2]  = 3.7;
arrayInit[3]  = 4;
arrayInit[4]  = 1.2;
arrayInit[5]  = 2.28;
arrayInit[6]  = 5.3;
arrayInit[7]  = 2;
arrayInit[8]  = 1.2;
arrayInit[9]  = 2.88;
arrayInit[10] = 3.4;
arrayInit[11] = 9;
arrayInit[12] = 1.9;
arrayInit[13] = 2.89;
arrayInit[14] = 3.5;
arrayInit[15] = 5;

var oMat4 = XSIMath.CreateMatrix4 (arrayInit);
vbArr = new VBArray( oMat4.Get2() );
array = vbArr.toArray();

//Display Matrix
var lineSize = 4;
Application.LogMessage( "The 16 matrix values" );
var mgsString = "";
for (i =0; i < lineSize; i++ )
{
for (j = 0; j < lineSize; j++ )
mgsString += "m" + i + "" + j + " " + array[ i*lineSize + j ] + "  ";
Application.LogMessage ( mgsString );
mgsString = "";
}
       //Expected output:
//INFO : The 16 matrix values
//INFO : m00 1.1  m01 2.31  m02 3.7  m03 4  
//INFO : m10 1.2  m11 2.28  m12 5.3  m13 2  
//INFO : m20 1.2  m21 2.88  m22 3.4  m23 9  
//INFO : m30 1.9  m31 2.89  m32 3.5  m33 5

2. VBScript Example

set oMatrix4 = XSIMath.CreateMatrix4
Application.LogMessage TypeName(oMatrix4)

Autodesk Softimage v7.5