## 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 |

### C# Syntax

    SIMatrix3 XSIMath.CreateMatrix3( 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 );

### 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