## SIMatrix4.Invert

### Description

Inverts the matrix m and stores the result in this matrix: this = m^-1

### C# Syntax

    Int32 SIMatrix4.Invert( SIMatrix4 in_pMatrix );

### Scripting Syntax

    oBoolean = SIMatrix4.Invert( m );

### Return Value

Boolean True if the matrix m has been inverted (m is not singular); otherwise False.

### Parameters

Parameter | Type | Description
--- | --- | ---
m | SIMatrix4 | Matrix operand

### Examples

#### VBScript Example

    '

    ' This example demonstrates how to set up a 4x4 matrix,

    ' invert it and then trap whether the inversion was

    ' successful

    '

    ' Create 4x4 matrices

    dim m1 : set m1 = XSIMath.CreateMatrix4(_

    	2.0, 3.0, 0.0, 0.0, _

    	1.0, 4.0, 0.0, 0.0, _

    	0.0, 0.0, 1.0, 0.0, _

    	0.0, 0.0, 0.0, 1.0)

    dim m2 : set m2 = XSIMath.CreateMatrix4

    ' Make the second matrix the inversion of the first

    if m2.Invert(m1) then

    	Application.LogMessage "Success :-D"

    else

    	Application.LogMessage "Failure :-("

    end if

    ' Expected result:

    ' INFO : Success :-D

### See Also

SIMatrix4.InvertInPlace SIVector3 SIMatrix3 SIMatrix4 SIRotation SITransformation SIQuaternion