XSIMath.CreateMatrix3

Description

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

| m0 m1 m2 |

| m3 m4 m5 |

| m6 m7 m8 |

Scripting Syntax

oReturn = XSIMath.CreateMatrix3( [m0_or_Array], [m1], [m2], [m3], [m4], [m5], [m6], [m7], [m8] );

Return Value

SIMatrix3

Parameters

Parameter Type Description
m0_or_Array Double or Array The m0 value or an array (1d or 2d) containing the 9 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.

Examples

1. JScript Example

/* Set and display the values of a matrix3
*/
var oMat3 = XSIMath.CreateMatrix3 (4.0, 0.0, 0.0, 0.0, 3.0, 0.0, 0.0, 0.0, 2.0);
vbArr = new VBArray( oMat3.Get2() );
array = vbArr.toArray();
var lineSize = 3;
//Display Matrix
Application.LogMessage( "The 9 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 9 matrix values
//INFO : m00 4  m01 0  m02 0  
//INFO : m10 0  m11 3  m12 0  
//INFO : m20 0  m21 0  m22 2

2. VBScript Example

'test 2d matrix
dim aValues2d( 3, 3)
aValues2d(0,0) = 1.1
aValues2d(0,1) = 2
aValues2d(0,2) = 3
aValues2d(1,0) = 4.2
aValues2d(1,1) = 5
aValues2d(1,2) = 6
aValues2d(2,0) = 7.1
aValues2d(2,1) = 8
aValues2d(2,2) = 9
set oMatArray2d = XSIMath.CreateMatrix3(aValues2d)
lineSize = 3
Application.LogMessage "The 9 matrix values"
dim mgsString
for i = 0 to lineSize - 1
for j = 0 to lineSize - 1
mgsString = mgsString + " m" & i & j & " " & oMatArray2d(i, j)
next
Application.LogMessage mgsString
mgsString = ""
next
'Expected output:
'INFO : The 9 matrix values
'INFO :  m00 1.1 m01 2 m02 3
'INFO :  m10 4.2 m11 5 m12 6
'INFO :  m20 7.1 m21 8 m22 9