## SITransformation.Matrix4

### Introduced

v5.1

### Description

Sets or returns the SIMatrix4 representation of the values of this transformation (the matrix is created automatically).

### C# Syntax

    // get accessor
    SIMatrix4 rtn = ISITransformation.Matrix4;
    // set accessor
    ISITransformation.Matrix4 = SIMatrix4;

### Examples

#### JScript Example

    /*
            This example demonstrates how to use the Matrix4 property to return the matrix representation
            of the transformation as an SIMatrix4 (without having to explicitly create it first) as well as
            how to set new values for the transformation using a 4x4 matrix.
    */
    var t1 = XSIMath.CreateTransform();
    // The Matrix4 property takes care of creating oMat4 as an SIMatrix4 of the transformation
    var oMat4 = t1.Matrix4;
    // Now set some values on the matrix and then save it back onto the transformation
    oMat4.Set(4.0, 0.0, 0.0, 0.0, 0.0, 3.0, 0.0, 0.0, 0.0, 0.0, 2.0, 0.0, 0.0, 0.0, 0.0, 1.0);
    t1.Matrix4 = oMat4;
    // Get a new matrix
    var oMat4Dest = t1.Matrix4;
    vbArr = new VBArray( oMat4Dest.Get2() );
    jsArr = vbArr.toArray();
    // Display Matrix
    var lineSize = 4;
    Application.LogMessage( "The 16 matrix values" );
    for ( i=0; i<lineSize; i++ ) {
            var mgsString  = "";
            for ( j=0; j<lineSize; j++ ) {
                    mgsString += "m" + i + "" + j + " " + jsArr[ i*lineSize + j ] + "  ";
            }
            Application.LogMessage ( mgsString );
    }
    // Expected results:
    //INFO : The 16 matrix values
    //INFO : m00 4  m01 0  m02 0  m03 0
    //INFO : m10 0  m11 3  m12 0  m13 0
    //INFO : m20 0  m21 0  m22 2  m23 0
    //INFO : m30 0  m31 0  m32 0  m33 1

### See Also

SITransformation.GetMatrix4 SITransformation.SetMatrix4