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