get_inverse


Description:

public Bool get_inverse (out Matrix inverse)

Gets the inverse transform of a given matrix and uses it to initialize a new Matrix.

<note>Although the first parameter is annotated as const to indicate that the transform it represents isn't modified this function may technically save a copy of the inverse transform within the given Matrix so that subsequent requests for the inverse transform may avoid costly inversion calculations.</note>

Parameters:

this

A 4x4 transformation matrix

inverse

The destination for a 4x4 inverse transformation matrix

Returns:

true if the inverse was successfully calculated or false for degenerate transformations that can't be inverted (in this case the inverse matrix will simply be initialized with the identity matrix)