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 |
The m0 value or an array (1d or 2d) containing the 16 values. |
|
|
m1 |
The m1 value. |
|
|
m2 |
The m2 value. |
|
|
m3 |
The m3 value. |
|
|
m4 |
The m4 value. |
|
|
m5 |
The m5 value. |
|
|
m6 |
The m6 value. |
|
|
m7 |
The m7 value. |
|
|
m8 |
The m8 value. |
|
|
m9 |
The m9 value. |
|
|
m10 |
The m10 value. |
|
|
m11 |
The m11 value. |
|
|
m12 |
The m12 value. |
|
|
m13 |
The m13 value. |
|
|
m14 |
The m14 value. |
|
|
m15 |
The m15 value. |
Return Value
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)
SOFTIMAGE|XSI v6.01